Aller au contenu principal

Séquences et lookups

Deux formes de requête reviennent assez souvent pour que Liberty fournisse un assistant pour chacune :

FormeRôleSQL typique
SéquenceCalculer le numéro suivant d'une colonne identifiant.SELECT COALESCE(MAX(<col>), 0) + 1 AS NEXT_ID FROM <table>
LookupFournir des couples code + libellé à la liste déroulante d'une colonne d'écran.SELECT <value>, <label> FROM <table> ORDER BY <label>

Les deux passent par l'assistant de génération : choix d'une table et de la ou des colonnes, aperçu du SQL en direct, enregistrement. L'enregistrement écrit deux fichiers d'un coup : la requête dans le connecteur et l'élément correspondant dans le dictionnaire.

Accès​

Liberty Next → Construire → Connecteurs → choix du connecteur → barre de modes : Séquences (ou Lookups) → ＋ Ajouter une séquence (ou ＋ Ajouter un lookup).

La fenêtre s'ouvre, lit le pool et liste les schémas et les tables.

Sans table

L'assistant part d'une table. Pour un lookup ou une séquence reposant sur une jointure ou sur un SELECT écrit à la main, créer l'élément dans Liberty Next → Construire → Dictionnaire (onglet Lookups ou Séquences) et créer sa requête depuis cet élément — une requête vide, ou Generate à partir d'une table en associant ses colonnes aux champs de l'élément.

Séquence — calculer le numéro suivant​

Dans Liberty, une séquence est une requête qui renvoie un nombre : le numéro à attribuer à une nouvelle ligne. Elle sert la règle SEQUENCE du dictionnaire : à l'insertion d'une ligne, le serveur exécute la requête de séquence dans la transaction de l'insertion et écrit le résultat dans la colonne.

Nouvelle séquence · [connectors.crm]Tablepublic.customers ▾Colonne clé(MAX retourne la suivante +1)customer_id ▾ · INT4WHERE facultatifex. region = :regionNom de la requêteget_customer_id_from_customers_getIdentifiantget_customer_id_from_customersDescriptionRécupérer customer_id depuis customersAPERÇU SQL EN DIRECT · modifiableSELECT COALESCE(MAX(customer_id), 0) + 1 AS NEXT_IDFROM public.customers

Champ par champ​

ChampRemarques
TableLa source. Le choix du schéma apparaît sur les pools à plusieurs schémas.
Colonne cléLa colonne dont MAX(...) + 1 donne la valeur suivante. La liste présente chaque colonne avec son type SQL.
Clause WHERE optionnelleLe corps d'une clause WHERE, sans le mot-clé. Des paramètres :nom permettent de faire varier le filtre à chaque appel — par exemple REGION = :REGION pour une numérotation par région.
Nom de la requêteProposé sous la forme get_<colonne>_from_<table>_get, modifiable. Le suffixe _get est une convention : une séquence est une requête de lecture.
IdentifiantLa clé de la séquence dans le dictionnaire. Proposé sous la forme get_<colonne>_from_<table>.
DescriptionAffichée dans les listes et les infobulles. Pré-remplie.
SQL généré — modifiableAperçu en direct. Une modification manuelle est conservée tant que la table, la colonne ou la clause WHERE ne changent pas ; un changement rétablit le SQL généré.

Ce qui est enregistré​

FichierContenu
ConnecteurLa requête, dans la section Séquences du connecteur.
Dictionnaire[connectors.<connecteur>.sequences.<id>] avec query = "<nom de la requête>", dd_id = "<colonne>" et la description.

Une entrée du dictionnaire (ou une colonne d'écran) dotée de la règle SEQUENCE et de Rules values = <id> reçoit son numéro de cette requête à chaque insertion. Avec dd_id renseigné, toute colonne dont l'entrée porte cette clé est numérotée elle aussi.

Accès concurrents​

SELECT MAX(...) + 1 n'est pas atomique : deux insertions simultanées peuvent lire le même maximum et produire un doublon. C'est acceptable quand :

  • les insertions passent par l'interface, un dialogue à la fois ;
  • la colonne porte une contrainte d'unicité en base, qui rejette le doublon (l'écran affiche l'erreur et l'opérateur recommence).

Sous forte concurrence, mieux vaut une séquence de la base (SEQUENCE Postgres ou Oracle, colonne Identity) et une requête de séquence qui renvoie nextval(...) : la base garantit l'unicité.

Lookup — alimenter une liste déroulante​

Dans Liberty, un lookup est une requête qui renvoie des couples (code, libellé) — la source de la liste déroulante d'une colonne. Il sert la règle LOOKUP du dictionnaire : une colonne dotée de la règle LOOKUP et de Rules values = <id> affiche le libellé à la place du code et propose les lignes du lookup dans une liste avec recherche.

Nouveau lookup · [connectors.crm]Tablepublic.regions ▾Colonne valeur(le code stocké sur la ligne)region_code ▾ · VARCHAR(8)Colonne libellé(la description montrée à l'utilisateur)region_name ▾ · VARCHAR(60)WHERE facultatifactive = 'Y'Nom de la requêteget_regions_getIdentifiantget_regionsAPERÇU SQL EN DIRECT · modifiableSELECT region_code, region_nameFROM public.regionsWHERE active = 'Y' ORDER BY region_name

Champ par champ​

ChampRemarques
TableLa source des lignes de la liste.
Colonne valeurLe code enregistré sur la ligne quand l'utilisateur choisit une option. Son type doit correspondre à celui de la colonne cible de l'écran.
Colonne libelléLe texte présenté à l'utilisateur. Identique à la colonne valeur convient quand le code est déjà lisible (un code pays affiché tel quel).
Clause WHERE optionnelleLe corps d'une clause WHERE, sans le mot-clé. Cas courants : ACTIVE = 'Y', DELETED_AT IS NULL. Des paramètres :nom permettent des listes en cascade (les régions du pays choisi, par exemple — voir Liaison de paramètres).
Nom de la requêteProposé sous la forme get_<table>_get.
IdentifiantLa clé du lookup dans le dictionnaire. Proposé sous la forme get_<table>.
DescriptionAffichée dans les listes et les infobulles.
SQL généré — modifiableAperçu en direct, modifiable. L'ORDER BY <libellé> est ajouté d'office ; à retirer si les lignes ont déjà un ordre propre.

Ce qui est enregistré​

FichierContenu
ConnecteurLa requête, dans la section Lookups du connecteur.
Dictionnaire[connectors.<connecteur>.lookups.<id>] avec query = "<nom de la requête>", value = "<colonne valeur>", label = "<colonne libellé>" et la description.

Listes en cascade​

Quand la liste dépend d'un autre champ de la même ligne — Rôle dépend d'Application —, la requête du lookup prend un paramètre et la colonne de l'écran le lie :

  • dans le dialogue et la saisie en grille, par le champ lookup_param_binds de la colonne — { param = "APP_ID", source = "APP_ID" } ;
  • dans le panneau de filtres de la grille, par le champ filter_from de la colonne, qui restreint les options du filtre selon la valeur d'un autre filtre.

Voir Liaison de paramètres et Colonnes.

SELECT ROLE_ID, ROLE_NAME
FROM   roles
WHERE  APP_ID = :APP_ID
ORDER BY ROLE_NAME

Pour aller plus loin​