Consistency

Consistency permet la création de contrôle de cohérence personnalisé. Il se base sur une requête SQL validant le contrôle que l'on souhaite mettre en place, et un tooltip apparait sur la fiche de l'élément. Il est aussi possible d'afficher un indicateur de cohérence sur les listes des éléments. Consistency est fourni avec de multiples exemples dans le dossier xmlsample.

Présentation

Le Module consistency permet de créer vos propres règles de cohérence personnalisées à partir des informations contenues dans votre base de données. La création des alertes de cohérence se base sur des requêtes SQL.

Une fois la règle de cohérence crée et active, elle peut s'afficher comme une colonne supplémentaire au niveau de la liste des élements

La règle de cohérence s'affiche enfin sous la forme d'une alerte sur la page principale de l'élément associé

Consistency est livré avec plusieurs exemples de règles de cohérences présente dans le répertoire xmlsample desquels vous inspirer pour créer les votres.

Configuration des fonctionnalités du module

Il n'y a pas à proprement parlé de configuration à réaliser sur le module à part son activation.

Démarrage

Les fonctionnalités de consistency sont accessibles depuis l'onglet de menu principal Outils Patas. Votre menu secondaire présente alors les entrées de menu suivantes :

consistency : l'entrée principale consistency permet d’afficher toutes les règles définies dans votre environnement (même si celles-ci ne sont pas actives). En cliquant sur le titre de la règle, on peut visualiser et modifier celle-ci. Nouvelle règle de cohérence : cette entrée vous affichera la page de création d'une nouvelle regle de cohérence. Importer une règle : cette entrée affichera une page permettant de copier un fichier d'import d'une liste au format XML. (Voir "Import d'une règle" plus bas).

Liste des règles de cohérence

La liste des règles affiche les régles de cohérence présente dans votre environnement

Vous pouvez accéder aux règles présentes en cliquant sur l'icone en début de chaque ligne mais aussi créer une nouvelle règle en cliquant sur les boutons dédiés

Création d'une règle de cohérence

Ouvrez la page de création d'une règle depuis le lien de menu Outils Patas > consistency > Nouvelle règle :

Libellé	le libellé sera affiché en tant que titre sur la liste de l'élément, mais aussi le titre du message d'information
Titlelist	Le titre de la colonne associée à la règle de cohérence sur la liste de l'élément
Description	Le texte associé à la règle de cohérence affiché au niveau du message d'information
Element associé au contrôle	l'élément auquel le contrôle de cohérence est associé. La liste des éléments se trouve plus bas dans la documentation.
Niveau d'alerte	Permet d'indiquer le niveau d'alerte (la couleur du message d'information), d'informatif (en vert) à critique (en rouge).
nb ligne	le nombre d'enregistrements que la requete doit retourner pour déclencher la règle de cohérence.
Auteur	champs libre pour saisir l'auteur de la règle de gestion.
Liste active	Pour activer la règle au niveau de votre Dolibarr.
Requête du controle de cohérence	Il s'agit d'une requête SQL effectuant un contrôle dans les données, afin d'activer ou non la règle de cohérence. si le contrôle est positif, la requête retourne une ligne de données, si il est négatif il n't a pas de données. Pour bypasser la protection contre le SQL injection de dolibarr, il convient de remplacer le SELECT par #SEL#. L'indentifiant associé à l'élément est transmi à la requête via la balise #ID#

Trois boutons sont présent en bas de l'écran d'affichage :

• Modifier vous permettra d'entrer en édition de la règle pour en modifier la requête ou tout autre élément (menus d'accès, onglets d'affichage …
• Importation / Exportation de la page générera le fichier XML que vous pourrez modifier avant de le copier pour l'exporter
• Supprimer effacera la règle de votre base de données.

Autres fonctionnalités

Onglet dans l'élément

Il est possible d'afficher un myList comme un onglet d'un élément pour cela il faut utiliser dans la requete SQL un alias particulier pour la table associé à l'élément

prefix	Element
s	Tiers (société)
p	Produit
e	Stock (entrepot)
p	Projet
p	Propal
c	commande
f	Facture
t	ticket
pf	Demande de prix
cf	commande fournisseur
ff	Facture Fournisseur

Import d'une règle de cohérence

Il est possible de créer une règle de cohérence en important un fichier XML.

Des exemples de règles sont livrés avec le module consistency dans le dossier XMLsample

Depuis la page Outils Patas > Consistency > Importer une règle, collez le fichier XML dans la zone de saisie et cliquez sur le bouton Lancer l'importation. Activez la règle depuis sa fiche et elle sera prise en compte dans votre environnement.