Paramétrage des indicateurs

Back-Office > Administration > Indicateurs et alertes > Paramétrage

Des indicateurs standards (préfixe CEG) contenant des requêtes prédéfinies, sont fournis à chaque version de l’application.

Pour être sûr de visualiser tous les indicateurs standards disponibles, décochez la case Actif dans le multicritère.

Chaque utilisateur a la possibilité de créer ses propres indicateurs, à l’aide du bouton [Nouveau]. Il est néanmoins conseillé de créer un nouvel indicateur par duplication de l'indicateur le plus adapté, à l’aide du bouton [Dupliquer].

Il faudra ensuite renseigner les différentes propriétés de l’indicateur : requête SQL, condition de l’alerte, restitution, planification.

La requête SQL

Utilisez ce bouton pour afficher la fenêtre permettant de saisir la requête SQL. Cette dernière étant un élément assez compliqué à comprendre, elle ne doit pas être accessible à tous les utilisateurs. C’est pourquoi cette fonction est soumise à la gestion du droit d’accès Paramétrage de la requête SQL. Après avoir saisi le code du nouvel indicateur, vous pouvez accéder au paramétrage de la requête, la requête de l’indicateur dupliqué étant modifiable.

Contraintes de formalisme de la requête SQL

Utilisation des alias, autant que possible, pour simplifier la saisie de la condition d’alerte.
Alias sur 35 caractères. Si pas d’alias, champs sur 35 caractères maximum.
Pas de requête d’update, insert… mais uniquement des select (un contrôle est effectué avant exécution).
Pour appliquer les restrictions établissements, il faut que :
- Le premier champ de la requête soit le code établissement, et uniquement le code.
- Ce champ possède un alias ETABLISSEMENT, et que le AS et l’alias soient en majuscules.
  - Exemple : SELECT et_etablissement AS ETABLISSEMENT, (...)

La condition de l’alerte

Afin de déterminer que l’indicateur est une alerte, il faut renseigner la condition de l’alerte. Ceci se fait en 3 étapes :

Choix du champ à évaluer : ce sont tous les champs numériques de la requête SQL saisie.
Choix de l’opérateur : ce sont les opérateurs classiques de comparaison numérique.
Choix de la valeur d’évaluation : la valeur est choisie par l’utilisateur selon ses besoins.

Remarque sur le choix du champ

Il s’agit de la liste des champs pouvant servir à conditionner l’indicateur comme étant une alerte. Ce champ ne sera accessible qu’une fois la requête SQL saisie, et présentera alors tous les champs numériques du "select" de la requête, représentés par leur alias s’ils en ont un. Certains champs non numériques peuvent également être présents dans la liste de choix. Bien que sélectionnables, leur utilisation ne sera pas possible.

La restitution

Un indicateur défini par un utilisateur peut avoir 2 rôles :

Présenter une information destinée à être consultée et analysée par l’utilisateur. Cet indicateur n’aura pas de condition de déclenchement.
Déclencher une ou plusieurs alertes en fonction d’une condition, après analyse.

Les types de restitution possibles sont le mail, l’édition et l’affichage ; et pour chacune de ces restitutions, l’envoi d’alerte peut être paramétré ainsi :

Aucun : pas de message envoyé,
Alerte : envoi des lignes en alerte,
Détail : envoi de toutes les lignes du résultat.

Restitution par mail

Paramétrage préalable

Back-Office > Administration > Société > Paramètres société

Pour que l'application puisse envoyer des mails, il faut tout d'abord en effectuer le paramétrage. Ouvrez la branche Gestion commerciale > Envoi de mails, et renseignez les champs décrits ici.

Sélection des destinataires

L’adresse e-mail des utilisateurs destinataires des alertes doit impérativement être renseignée dans leur fiche, ainsi que leurs éventuelles restrictions. Le choix des destinataires peut ensuite se faire par utilisateur ou par regroupement. Les regroupements proposés sont les groupes d’utilisateurs ou les tables libres. Pour chaque destinataire des mails, la restriction sélectionnée s'applique au résultat de l'indicateur afin de limiter les informations envoyées au destinataire.

Notez que lors de la sélection des utilisateurs, si un ou plusieurs d’entre eux n’ont pas d’adresse e-mail renseignée un message vous en informe.

Constitution du message

La constitution de l'objet du message prend la forme suivante : "Indicateur - Date d’exécution"

Exemple : "DEMARQUE - 04/08/2011 17:32:00"

La constitution du corps du message prend la forme suivante : "Indicateur - Libellé - Nombre de lignes en alerte"

Exemple : "DEMARQUE - Taux de démarque par boutique/jour - Nombre de lignes en alerte : 5"

La constitution de la pièce jointe se fait au format PDF, contenant le résultat de l'exécution de l'indicateur.

Notez que le contenu du fichier de détail dépend également du choix de paramétrage effectué : alerte ou détail.

Restitution par édition

A la création de chaque indicateur, une édition unique lui est associée :

En cas de nouvel indicateur, l’état est calqué sur un modèle comportant le mécanisme de base nécessaire. Il suffit alors d’apposer les colonnes nécessaires dans l’état, en correspondance avec la requête de l’indicateur.
En cas de duplication, l’état de l’indicateur d’origine est dupliqué.

Si demandée, l’édition est déclenchée lors du traitement de l’indicateur.

Elle est également accessible par le bouton [Impression instantanée], qui imprimera le résultat de l’indicateur mais sans historiser le traitement, ni envoyer de mail.

Lors du traitement, l’état sous format .pdf est stocké dans la base de données. Ceci permet de le consulter à tout moment depuis le multicritère de consultation disponible dans le Back-Office > Administration > Indicateurs et alertes > Consultation.

Attention !

Les codes des modèles des indicateurs créés doivent impérativement être numériques. Lors du rattachement d'un modèle existant à un nouvel indicateur, le modèle doit être enregistré à la place du précédent et avec le même numéro.

Rappel ! Contraintes CBP – Générateur d’états pour l’affichage d’image dans les états

Il est possible d'intégrer des images dans les états lors du lancement d'un indicateur. Cependant, il faut respecter certaines contraintes pour permettre leur affichage :

Le composant Image doit toujours faire partie de la bande "Détail 1" de l'état pour être traité ;
Il doit toujours être attaché à un champ de la bande "Détail 1", et non d'une autre source de données comme la bande "Détail 2" ou un champ SQL ;
Le composant image n'accepte que des champs de type MEMO/BLOB ou chaîne String quand cela indique un nom de fichier avec répertoire.

Restitution par affichage

Ce mode de restitution permet, dès la connexion de l’utilisateur à l'application, d’afficher dans une fenêtre le résultat des alertes. Si ce mode de restitution est sélectionné, l’alerte sera obligatoirement soumise à visa (notez que l’option est automatiquement cochée). Ce mode de restitution n’est pas exclusif, il est possible d’avoir pour un même utilisateur une alerte envoyée par mail et affichée à la connexion.

Attention !

L’alerte sera affichée à la connexion de l’utilisateur à l'application, sous réserve que l’option "Affichage des indicateurs ou alertes à la connexion" soit cochée dans la fiche de l’utilisateur concerné.

Options de restitution

Visa : cette propriété est optionnelle (excepté pour le mode de restitution par affichage). Certaines alertes pourront être envoyées par mail, sans la nécessité d’être visées. D’autres pourront être affichées à l’écran lors de la connexion de l’utilisateur, sous réserve que le paramétrage de l’utilisateur le permette (voir paragraphe précédent concernant le mode de restitution par affichage). Un filtre par défaut permet d’afficher les alertes non encore visées.
Délai de conservation des résultats : permet d’indiquer un délai de conservation en nombre de jours. A chaque exécution de l’alerte, une épuration des résultats sera effectuée (uniquement les alertes visées ou non soumises à visa). 0 jour correspond à un stockage infini.
Restriction (fiche utilisateur) : permet de compléter le paramétrage par une restriction utilisateur. Celle-ci doit avoir été préalablement définie dans la fiche utilisateur (cf. Restrictions utilisateurs).

La planification

Ce bouton permet de planifier le traitement en choisissant la périodicité et le type de déclenchement souhaités (cf. Les tâches planifiées).

Actions connexes

Différentes actions sont possibles depuis le multicritère de paramétrage des indicateurs ou depuis la fiche de l’indicateur.

Dans la fiche multicritère

Création d’un nouvel indicateur.

Duplication de l’indicateur sélectionné.

Sélection de tous les indicateurs.

Lancement du traitement des indicateurs sélectionnés.

Lancement en tâche planifiée.

Dans la fiche de paramétrage de l’indicateur

Création d’un nouvel indicateur.

Suppression de l’indicateur.

Duplication de l’indicateur.

Paramétrage de la requête (bouton visible en fonction des droits d’accès).

Paramétrage de l’état.

Exécution de la requête : la requête de l’indicateur est exécutée mais aucun traitement n’est lancé.

Traitement de l’alerte : la requête est exécutée et le traitement démarré (envoi de mail, édition de l’état, etc.).

Impression instantanée : la requête est exécutée et l’état associé à l’indicateur est imprimé avec aperçu.

Il est également possible de n’afficher que les lignes en alerte, c'est-à-dire satisfaisant à la condition saisie.