Écrans — vue d'ensemble
Un écran dans Liberty est la page que voit l'utilisateur : un tableau de lignes, des filtres optionnels, un dialogue d'ajout/modification optionnel, des actions optionnelles, un menu contextuel ligne optionnel. Un écran = une requête <base>_get + (optionnellement) <base>_put / <base>_post / <base>_delete pour les écritures + un formulaire de dialogue par-dessus.
La page qui gère les écrans est Liberty Next → Construire → Écrans. Cette vue d'ensemble la cartographie ; les pages suivantes décrivent chaque tâche.
La page Écrans en un coup d'œil
Trois régions :
| Région | Contenu |
|---|---|
| Barre de portée en haut | Une puce par application (un connecteur disposant d'un menu). Cliquer sur une puce → ses écrans se chargent en dessous. Le bouton + Ajouter une portée enregistre un connecteur tout neuf dans l'espace de nommage Écrans. Annuler / Enregistrer à droite valident ou annulent les modifications de toute la page. |
| Barre de filtre | Un champ de recherche pour la liste d'écrans. Visible quand l'application sélectionnée comporte plus de quelques écrans. |
| Liste des écrans | Une carte par écran, défilement vertical. Chaque carte affiche l'identifiant, le libellé, la requête de lecture, le nombre d'onglets, le nombre de champs et les actions par carte : Renommer, Dupliquer, Supprimer. Cliquer sur une carte ouvre la boîte de dialogue modale du Concepteur d'écran. |
La boîte de dialogue modale du Concepteur d'écran
Cliquer sur une carte ouvre une boîte de dialogue modale quasi plein écran qui héberge le ScreenEditor. L'en-tête présente Agrandir / Restaurer (plein écran par défaut), Annuler et Enregistrer — Enregistrer valide uniquement les modifications de cet écran et ferme — dans screens.toml, seul cet écran est réécrit, sans ses valeurs par défaut et dans l'ordre des clés du fichier, les autres écrans restant inchangés ; Annuler demande confirmation en cas de modifications non enregistrées.
La fenêtre répartit l'ensemble en neuf onglets :
| Onglet | Contenu |
|---|---|
| Général | Identité, surcharge du connecteur, table d'audit, plafond de lignes, colonnes clés, indicateurs de comportement (chargement automatique, éditable, importable), regroupement, vue arborescente, graphique par défaut, comportement au clic sur une ligne. |
| Requêtes | Les quatre références de requêtes CRUD — lecture (obligatoire), mise à jour, insertion, suppression. Le sélecteur s'alimente depuis la liste des requêtes du connecteur. |
| Colonnes | Une ligne par indication de colonne — libellés, formats, valeurs par défaut, références au dictionnaire, filtrage, règles d'édition, conditions. Un clic sur une colonne ouvre son éditeur complet. |
| Vues | Les vues partagées de la grille — dispositions de colonnes, tris et filtres publiés pour tous les utilisateurs, dont éventuellement une vue par défaut. Voir Vues enregistrées. |
| Résumé | Les colonnes de regroupement de la vue Résumé et, en option, le détail des valeurs modifiées d'une ligne. |
| Dialogue | Le Constructeur visuel — un canevas à trois colonnes style Figma (Palette / Canevas / Inspecteur) où l'on glisse des champs sur des onglets. Optionnel — un écran sans dialogue fonctionne quand même comme un tableau en lecture seule ou en édition de grille. |
| Actions | Trois groupes : Hooks de dialogue (on_load / on_save / on_cancel), Barre d'outils (boutons au-dessus du tableau), Hooks de ligne (on_insert / on_update / on_delete). |
| Menu de ligne | Actions du menu contextuel ouvert par clic droit sur une ligne. |
| Export | Configuration d'export xlsx multi-feuilles — optionnel. |
Les pages suivantes de cette section décrivent chaque onglet comme une tâche distincte.
Ce que porte un écran
Les champs de premier niveau du schéma, regroupés par finalité :
| Groupe | Champs |
|---|---|
| Identité | id, label, description, connector (vide = le connecteur de l'application) |
| Requête de lecture | read_query (obligatoire), auto_load, max_rows, page_size (lignes par page de la grille ; vide = la valeur de l'application), key_columns |
| Requêtes d'écriture | update_query, insert_query, delete_query |
| Édition et affichage | columns, column_groups, editable, editable_when, read_only (un clic sur une ligne ouvre le dialogue en consultation — ni enregistrement, ni verrou —, ses onglets de détail se chargeant à partir de la ligne), disable_add, uploadable, initial_group_by, treeview, chart_id |
| Vues et résumé | views (vues partagées), summary, value_diff |
| Paquets de modifications | change_tracked, change_entity, post_apply — voir Paquets de modifications |
| Audit | audit_table (ex. AUD_USERS — duplique les écritures avec AUD_ACTION / AUD_USER / AUD_DATE) |
| Formulaire | dialog (optionnel — le formulaire posé sur le tableau) |
| Actions / hooks | actions (barre d'outils), row_menu (clic droit), on_insert / on_update / on_delete / on_duplicate (hooks de ligne) |
| Cible au clic sur une ligne | row_click_screen + row_click_connector + row_click_binds (ouvre un écran voisin comme dialogue) OU row_click_route (ouvre une route SPA) |
| Export | export (configuration du classeur xlsx) |
Mode lecture seule
Activez Lecture seule sur un écran (une case à cocher dans l'onglet Général) pour rendre toute la vue non modifiable. Cela masque les boutons Enregistrer, Supprimer et Dupliquer du dialogue, les boutons Ajouter et Supprimer la sélection de la grille, l'édition de cellule en ligne, le collage et l'import Excel — dans les éditeurs de tables imbriquées aussi. C'est plus fort que Désactiver l'ajout (qui ne bloque que les insertions) : c'est le bon réglage pour un écran de référence ou d'audit qui ne doit jamais être modifié depuis l'interface. Les permissions côté serveur s'appliquent en plus, indépendamment.
Types d'écrans — selon les champs renseignés
Il n'y a pas de discriminant kind ; les différentes formes d'écran proviennent des champs que l'on remplit :
| Champs renseignés | Comportement |
|---|---|
read_query seul | Grille en lecture seule. L'utilisateur voit les lignes ; pas d'édition, pas d'ajout. |
read_query + editable = true | Modification dans la grille — Modifier en lot : cellules modifiées sur place, lignes ajoutées, clonées, collées ou supprimées, le bouton Enregistrer de la grille écrivant l'ensemble. Nécessite update_query ou insert_query. |
read_query + dialog | Grille + dialogue. L'utilisateur ajoute/modifie les lignes via le formulaire. Nécessite les insert_query / update_query correspondantes. |
read_query + row_click_screen | Maître/détail. Cliquer sur une ligne ouvre le dialogue d'un écran voisin restreint à cette ligne. |
read_query + row_click_route | Maître/page. Cliquer sur une ligne navigue vers une route SPA — échappatoire pour les pages React écrites à la main (logs diffusés en direct, fusions multi-sources). |
Tout ce qui précède + treeview | Bascule en vue arborescente en complément des bascules Tableau / Graphique par défaut. Les colonnes parent/enfant construisent un arbre récursif. |
Un même écran peut superposer plusieurs : un écran avec dialog ET row_click_route ouvre la route au clic (la route gagne), et le dialogue n'est accessible que via le bouton + Ajouter de la barre d'outils.
Permissions — pilotées par la requête de lecture
L'écran lui-même n'a pas sa propre chaîne de permission. Un utilisateur peut voir un écran quand il a la permission d'exécuter sa requête de lecture :
sql:<connector>:<read_query>
Ainsi, un écran customers sur le connecteur crm avec read_query = customers_get est visible par toute personne disposant de sql:crm:customers_get. Accorder sql:crm:* ouvre toutes les requêtes du connecteur — et donc tous les écrans qui les utilisent.
La même logique s'applique aux écritures : le Enregistrer du dialogue et le Enregistrer de la grille n'aboutissent que si l'utilisateur a sql:<connector>:<update_query> / <insert_query> / <delete_query>. Un utilisateur avec la lecture mais sans permission d'écriture voit la grille mais pas de bouton + Ajouter et obtient un dialogue en lecture seule.
Enregistrement et rechargement
Le bouton Enregistrer de la page Écrans écrit l'intégralité de screens.toml (la table [screens] est remplacée intégralement) et déclenche un rechargement à chaud. La bannière de statut indique quelles applications ont été touchées.
Le rechargement à chaud signifie aucun redémarrage de processus — un nouvel écran est appelable immédiatement à /screen/<app>/<id>, et le menu le prend en compte si une entrée de menu pointe sur lui.
Ce que l'on fait concrètement — carte rapide
| Objectif | Lire |
|---|---|
Câbler un nouvel écran sur une requête _get et voir la grille. | Créer un écran à partir d'une requête. |
| Configurer les colonnes — libellés, formats, valeurs par défaut, filtrage. | Colonnes. |
| Construire le dialogue d'ajout/modification avec le concepteur visuel. | Constructeur de dialogue. |
| Faire apparaître / rendre obligatoires / verrouiller des champs sous conditions. | Champs conditionnels. |
| Ajouter des boutons de barre d'outils, des menus contextuels et des hooks de cycle de vie. | Actions et cycle de vie. |
| Intégrer un formulaire d'enregistrement enfant ou une grille de lignes liées dans un onglet. | Onglets imbriqués. |
Étapes suivantes
- Créer un écran à partir d'une requête — démarrer avec un
_get, voir la grille. - Concepts → Écrans — la référence approfondie derrière cette page.