Aller au contenu principal

Dictionnaire

Le dictionnaire définit une seule fois chaque donnée : son libellé, son format, sa règle (booléen, liste de valeurs, lookup, séquence…), sa valeur par défaut et ses traductions. Une colonne de requête qui renvoie à une entrée hérite de cette définition : la même donnée se lit donc de la même façon sur tous les écrans, graphiques et tableaux de bord.

Il se modifie dans Liberty Next → Construire → Dictionnaire, qui regroupe cinq types d'éléments :

OngletContenu
EntréesLes données : libellé, format, règle, valeur par défaut, traductions.
ÉnumérationsDes listes fixes de codes et de libellés, pour la règle ENUM.
LookupsDes requêtes qui remplacent un code par son libellé, pour la règle LOOKUP.
SéquencesDes requêtes qui renvoient le numéro suivant, pour la règle SEQUENCE.
FrameworkLes surcharges des listes proposées par les éditeurs (formats, règles, types de source…).

Vue d'ensemble​

Portée :Partagésales+Scan a tableExporterAbandonnerEnregistrerEntréesÉnumérationsLookupsSéquencesFramework+ Ajouter une entréefiltre 4…CUSTOMER_STATUSStatut clientDUE_DATEDate d'échéanceINVOICE_AMOUNTMontant factureIS_ACTIVEActifoverrideCUSTOMER_STATUSFind usagesRenommerClonerGeneralRuleTranslationsAdvancedRulesLOOKUP ▾Rules valuesCUSTOMER_STATUSES ▾False valueDefaultAJustify— ▾SizeLookup paramsTYPE = CUSTOMERPortéepartagée ou par connecteurCinq ongletsentrées, énumérations…Clés des entréeslibellé affiché dessousBarre d'outilsanalyse, export, enregistrementOnglet Rulerègle, sa valeur, défautLookup paramsvaleurs des :params

Portées​

Les pastilles Portée en haut de l'écran choisissent la partie du dictionnaire affichée :

  • Partagé — les entrées utilisables par tous les connecteurs ;
  • une portée par connecteur — des entrées, énumérations, lookups et séquences visibles des seules requêtes de ce connecteur. Le bouton + ajoute la portée d'un connecteur existant.

Une requête du connecteur sales cherche d'abord l'entrée dans la portée sales, puis dans la portée partagée. Deux applications peuvent ainsi définir différemment la même clé (STATUS) sans conflit. L'onglet Framework n'existe qu'en portée partagée.


Lien entre une colonne et une entrée​

Une colonne de requête reprend l'entrée dont la clé correspond à son nom (CUSTOMER_STATUS), ou l'entrée indiquée dans son champ dd quand les noms diffèrent (un dd vide désactive le lien). Un libellé ou un format défini sur la colonne elle-même prime sur celui de l'entrée. Voir Connecteurs → Découverte de schéma et indices de colonnes.

Sur un écran, une colonne peut aussi neutraliser la règle héritée avec la règle DISABLED — voir Règles.


Entrées​

La liste de gauche affiche la clé de chaque entrée, son libellé en dessous, et un champ de filtre. Les clés s'écrivent en majuscules. Le formulaire de droite est réparti en onglets :

OngletChampEffet
GeneralLabelLe libellé par défaut, utilisé quand aucune traduction ne correspond à la langue de l'utilisateur.
GeneralFormatLa façon d'afficher et de saisir la valeur — voir Formats.
RuleRulesLa règle appliquée à la donnée — voir Règles.
RuleRules valuesL'argument de la règle : la valeur « vrai » pour BOOLEAN, l'énumération pour ENUM, le lookup pour LOOKUP, la séquence pour SEQUENCE. La liste proposée suit la règle choisie.
RuleFalse valuePour BOOLEAN uniquement : la valeur écrite quand la case est décochée. Vide, elle se déduit de la valeur « vrai » (Y → N, 1 → 0, true → false) ; pour toute autre valeur, NULL est écrit.
RuleDefaultLa valeur initiale d'une nouvelle ligne.
RuleJustifyPour les colonnes caractères de longueur fixe : right_blank (cadrage à droite, complété par des espaces) ou right_zero (cadrage à droite, complété par des zéros). Appliqué aux valeurs écrites et aux clés de la clause WHERE. Vide = cadrage à gauche.
RuleSizeLa longueur de stockage de la donnée, utilisée avec Justify quand la colonne physique est plus large.
RuleDecimalsPour jdenumber, le nombre de décimales implicites de l'entier stocké ; pour les autres formats numériques, le nombre de décimales affichées (0 à 9).
RuleLookup paramsDes valeurs fixes pour les :params de la requête du lookup (par exemple TYPE = CUSTOMER). Les clés proposées sont les paramètres déclarés par le lookup.
Translationsune ligne par langueLe libellé dans cette langue.
AdvancedOverrideMarque l'entrée comme personnalisation locale : un package de mise à jour ne l'écrase pas.

La barre de l'élément propose Find usages, Renommer, Cloner et Supprimer. Renommer une entrée, un lookup ou une séquence met à jour ses références dans les autres fichiers de configuration (écrans, connecteurs, dictionnaire) puis recharge la configuration ; les modifications en attente doivent d'abord être enregistrées.

Formats​

FormatAffichage
text, textareaDu texte, sur une ou plusieurs lignes.
number, integer, decimal, currencyUn nombre.
date, datetime, timestampUne date, avec ou sans l'heure. Le formulaire, la saisie en masse et les filtres proposent le sélecteur de date de l'application : un champ où la date reste saisissable (un jour impossible rétablit la valeur précédente) et un calendrier mensuel avec Aujourd'hui et Effacer, dont le titre ouvre le choix du mois et de l'année. Un champ datetime ou timestamp y ajoute un champ d'heure (hh:mm ou hh:mm:ss). Une valeur qui porte son fuseau horaire (un timestamptz PostgreSQL) s'affiche à l'heure locale du navigateur ; une valeur sans fuseau (DATE Oracle, dates JD Edwards) s'affiche telle qu'elle est stockée.
jdedate, jdetimeUne date (CYYDDD) ou une heure (HHMMSS) JD Edwards, affichée comme une date ou une heure ordinaire.
jdenumberUn montant JD Edwards stocké sans sa virgule : avec Decimals à 2, la valeur stockée 12345 se lit et se saisit 123,45, puis s'écrit de nouveau 12345. Les filtres se saisissent en unités réelles ; les totaux et les lignes de détail de l'explorateur de données sont ramenés à la même échelle. L'analyse d'une table JD Edwards renseigne les décimales d'après le dictionnaire de données.
booleanUne coche ou une croix.
passwordUne valeur masquée.
urlUn lien qui s'ouvre dans un nouvel onglet ; dans le formulaire, un bouton à côté du champ l'ouvre. Seules les adresses http(s) deviennent des liens (www.… reçoit https://).
emailUn lien mailto: ; dans le formulaire, un bouton à côté du champ l'ouvre. Seule une valeur ayant la forme d'une adresse devient un lien.
colorLe code, accompagné d'une pastille de couleur ; dans le formulaire, la pastille ouvre le sélecteur de couleur du système. Codes hexadécimaux et rgb() uniquement.

Pour url, email et color, toute autre valeur reste du texte simple, et le tri, le filtrage et l'export conservent la valeur brute.

L'onglet Framework permet d'ajouter des valeurs à cette liste.

Règles​

RègleEffet
BOOLEANLa valeur s'affiche par une coche ou une croix, et le formulaire présente une case à cocher. Rules values donne la valeur « vrai » (Y, 1, 01, true, T) ; False value, l'autre.
ENUMLe code s'affiche avec son libellé tiré de l'énumération indiquée dans Rules values ; le formulaire propose les valeurs de l'énumération.
LOOKUPLe code s'affiche avec son libellé tiré du lookup indiqué dans Rules values ; le formulaire propose les lignes du lookup dans une liste avec recherche.
SEQUENCEÀ l'insertion, le serveur renseigne la colonne avec le numéro suivant de la séquence indiquée dans Rules values, dans la même transaction.
LOGINÀ chaque insertion ou mise à jour, le serveur écrit le nom de l'utilisateur connecté, en majuscules, quelle que soit la valeur envoyée. À l'ajout d'une ligne, le formulaire l'affiche déjà renseigné.
SYSDATEÀ l'insertion ou à la mise à jour, le serveur écrit la date et l'heure courantes (heure locale du serveur) si aucune valeur n'est envoyée. À l'ajout d'une ligne, le formulaire affiche la date du jour.
PASSWORDÀ l'écriture, le serveur chiffre la valeur avec la clé maître (ENC:…) afin de pouvoir la déchiffrer à l'usage — pour les mots de passe de connexion stockés dans une table. Un mot de passe laissé vide en mise à jour conserve la valeur enregistrée. À associer au format password pour masquer le champ.
DEFAULTÀ l'insertion ou à la mise à jour, la valeur Default est écrite quand la colonne arrive vide.
DISABLEDSur une colonne d'écran : annule, pour cet écran, la règle héritée de l'entrée (par exemple un écran d'import dont les lignes portent déjà leurs dates).

Les règles appliquées par le serveur (SEQUENCE, LOGIN, SYSDATE, PASSWORD, DEFAULT) valent pour toute écriture passant par la requête — formulaire, saisie dans la grille, API — et pas seulement pour le formulaire. Une requête d'écriture peut aussi horodater explicitement avec des jetons comme {{LOGIN}} ou {{SYSDATE}} — voir Liaison des paramètres.

Colonnes d'audit​

Une règle s'applique à toute écriture dont la requête lie la colonne :

ColonneRègleCondition
UPDATED_BYLOGIN—
UPDATED_ATSYSDATELa colonne doit arriver vide : la laisser hors du dialogue.
CREATED_BY, CREATED_ATLOGIN, SYSDATESeulement si la requête de mise à jour ne les écrit pas — sinon chaque mise à jour les remplacerait.
IDSEQUENCEQuand la base ne numérote pas elle-même les lignes.

Les jetons {{LOGIN}} / {{SYSTIMESTAMP}} écrits dans les requêtes d'insertion et de mise à jour sont le moyen le plus simple de renseigner ces colonnes — voir Piste d'audit.

---|---| | CREATED_BY, UPDATED_BY | LOGIN | | CREATED_AT, UPDATED_AT | SYSDATE | | ID | SEQUENCE (quand la base ne numérote pas elle-même les lignes) |

Ces colonnes n'ont pas à figurer dans le formulaire : le serveur les renseigne à chaque écriture, et le navigateur ne peut pas modifier le nom de l'utilisateur.


Énumérations​

Une énumération est une liste fixe de codes, pour des valeurs connues à l'avance (L / M / H pour une priorité).

ChampEffet
LabelLe nom de la liste.
ValuesUne ligne par code : Value (le code stocké), Label (le texte affiché) et les Translations du libellé.
OverrideComme pour les entrées.

Une entrée l'utilise avec Rules = ENUM et Rules values = l'identifiant de l'énumération.


Lookups​

Un lookup est une requête dont les lignes remplacent un code par un libellé — pour des valeurs tenues dans une table (statuts, pays, utilisateurs).

ChampEffet
DescriptionCe que renvoie le lookup.
ConnectorLe connecteur de la requête. Vide : le connecteur de la colonne qui y renvoie.
QueryLa requête qui renvoie codes et libellés. Les boutons voisins modifient la requête, la clonent, en créent une ou la génèrent à partir d'une table.
ValueLa colonne de résultat qui porte le code.
LabelLa colonne de résultat affichée à la place du code.
Union sourcesD'autres requêtes, éventuellement sur d'autres connecteurs ou d'autres bases, dont les lignes s'ajoutent à la liste. Chacune doit renvoyer les mêmes colonnes que la requête principale.
Key columnsLes colonnes qui rendent le code unique quand un même code porte des libellés différents (un code par société, par exemple) : la grille les rapproche des colonnes de même nom de la ligne.
Return paramsLes colonnes qu'une colonne d'écran peut recopier dans d'autres champs du formulaire au choix d'une ligne.
Display fieldsDes colonnes supplémentaires affichées à côté du code et du libellé, pour distinguer des lignes proches.
Filter fieldsLes colonnes affichées qui reçoivent des pastilles de filtre en haut de la liste.
OverrideComme pour les entrées.

La requête du lookup déclare ses propres :params ; leurs valeurs viennent du champ Lookup params de l'entrée, ou de la colonne d'écran. Les listes en cascade se construisent sur l'écran — voir Séquences et lookups.


Séquences​

Une séquence est une requête qui renvoie le numéro suivant, typiquement SELECT COALESCE(MAX(id), 0) + 1 FROM invoices.

ChampEffet
DescriptionCe que numérote la séquence.
ConnectorLe connecteur de la requête. Vide : le connecteur qui la déclenche.
QueryLa requête qui renvoie le numéro suivant. Ses :params prennent leurs valeurs dans la ligne en cours d'insertion.
Dd idDéclenche la séquence pour toute colonne dont l'entrée porte cette clé, même sans la règle SEQUENCE. Vide : seules les entrées qui y renvoient la déclenchent.
ParamsLes paramètres attendus par la requête — à titre d'information.
OverrideComme pour les entrées.

La séquence ne se déclenche qu'à l'insertion, dans la transaction de l'insertion.


Framework​

Les listes déroulantes des éditeurs (formats, règles, types de source, méthodes HTTP, alignements de colonne…) proviennent de listes livrées avec le framework. Surcharger un enum framework en copie une ici pour la modifier : la copie remplace la liste livrée. Retirer la surcharge rétablit les valeurs d'origine.


Analyser une table​

Le bouton Scan a table crée des entrées à partir d'une table réelle, au lieu de les saisir une à une. La fenêtre Generate dictionary items demande :

  • Connector — le connecteur à lire ;
  • Store under (app) — la portée qui reçoit les entrées (celle du connecteur par défaut) ;
  • Table to scan — la table à analyser ;
  • JD Edwards connector — retire le préfixe de table de deux caractères pour retrouver la donnée partagée, et lit le dictionnaire de données JD Edwards.

Scan affiche une ligne par colonne. Les colonnes qui ont déjà une entrée sont grisées et marquées (exists) ; elles ne sont jamais écrasées. Les colonnes manquantes sont cochées. Chaque ligne peut être ajustée avant l'ajout :

ColonneContenu
LabelRepris du dictionnaire de données JD Edwards sur un connecteur JD Edwards ; vide sinon.
FormatDéduit du type SQL de la colonne.
Rule / Rule valueUne règle facultative et son argument.
Lookup paramsLes valeurs des paramètres d'un lookup (TYPE=CUSTOMER).
DefaultUne valeur par défaut.
SourceL'origine de la proposition.

Add N item(s) écrit les entrées cochées dans la portée choisie et recharge la configuration. L'Assistant de création d'écran effectue la même analyse à son étape Dictionnaire.


Export​

Exporter télécharge dictionary_entries.xlsx : une ligne par entrée, toutes portées confondues, avec sa portée, sa clé, son libellé, son format, sa règle, l'argument de la règle, la valeur « faux » et la valeur par défaut — pratique pour comparer avec le dictionnaire de données de l'application source.


Enregistrement​

Enregistrer vérifie chaque entrée, énumération, lookup et séquence, écrit le fichier et recharge la configuration : les écrans affichent les nouveaux libellés à leur prochain rafraîchissement. Abandonner annule les modifications non enregistrées. Les Paramètres sont réservés aux superutilisateurs.

Les libellés traduits suivent la langue de l'utilisateur ; le choix de cette langue est décrit dans Traductions.


Pour aller plus loin​