Transformer un connecteur en application
Liberty n'a aucune configuration Applications séparée. Ce que les utilisateurs appellent « une application » — ce qui apparaît dans le sélecteur en haut, ce qui porte un menu dans la navigation à gauche — c'est simplement un connecteur auquel un menu est attaché avec l'indicateur show_in_switcher actif.
Cette page détaille le câblage des deux côtés : l'indicateur sur le connecteur + la clé du menu.
Les trois pièces
| Pièce | Où se trouve-t-elle | Requise pour une application ? |
|---|---|---|
show_in_switcher | Sur le connecteur (Paramètres → Connecteurs → onglet Paramètres). | Oui — désactivé, le connecteur existe mais n'apparaît pas dans le sélecteur en haut. |
[menus.<connector>] | Le fichier de menus (Paramètres → Menus). | Oui — sans menu, le connecteur est traité comme une source de données, pas une application. |
home | Sur le connecteur (Paramètres → Connecteurs → onglet Paramètres). | Optionnel — définit l'élément d'accueil quand l'utilisateur choisit cette application dans le sélecteur. |
Deux effets distincts, déclenchés par des indicateurs différents :
| Effet | Déclenché par |
|---|---|
| La pastille du connecteur passe de Sources de données à Applications sur la page Connecteurs. | L'existence du menu seule — [menus.<connector>] est configuré. |
| Une tuile pour l'application apparaît dans le sélecteur en haut (le sélecteur d'applications côté utilisateur). | L'existence du menu et show_in_switcher = true. |
Configurer le menu d'abord ; activer show_in_switcher ensuite. Manquer la seconde étape laisse le connecteur classé comme « application » sur la page Connecteurs sans pour autant le faire apparaître dans le sélecteur côté utilisateur.
Où chaque indicateur est défini
Étape 1 — Sur le connecteur
Ouvrir Paramètres → Connecteurs, choisir le connecteur, basculer sur l'onglet Paramètres. Les champs pertinents pour « ceci est une application » :
| Champ | Notes |
|---|---|
show_in_switcher | Par défaut true. Activé, le connecteur apparaît dans le sélecteur d'applications en haut (à condition d'avoir un menu). Désactivé, le connecteur n'est accessible que par URL — utile pour les connecteurs cachés ou d'administration. |
home | Liste déroulante alimentée par les éléments de menu de ce connecteur. Choisit l'élément d'accueil quand l'utilisateur clique sur l'application dans le sélecteur. Vide → le premier élément visible de premier niveau. |
Enregistrer la page du connecteur — la modification s'applique immédiatement (rechargement à chaud).
Étape 2 — Sur le menu
Ouvrir Paramètres → Menus. Si le connecteur n'a pas encore de menu, le bouton ＋ Ajouter un menu pour un connecteur ouvre une boîte de dialogue qui liste tous les connecteurs sans menu — choisir le sien. La boîte de dialogue :
- Crée une nouvelle entrée
[menus.<connector>]sans éléments. - Sélectionne la pastille de la nouvelle application.
- Affiche l'arbre vide.
Si le connecteur a déjà un menu, sa pastille est dans la barre de portée — il suffit de cliquer dessus.
Ajouter des éléments via ＋ Dossier / ＋ Élément en haut du panneau de l'arbre. Voir Construire l'arbre pour la visite de l'éditeur.
Ce qui change après le câblage
Avant :
- Le connecteur apparaît sous Sources de données sur la page Connecteurs.
- Il n'apparaît pas dans le sélecteur en haut.
- Les écrans qui pointent vers ses requêtes ne sont accessibles que par URL.
Après :
- Le connecteur apparaît sous Applications sur la page Connecteurs.
- Il apparaît dans le sélecteur en haut sous forme de tuile.
- Cliquer la tuile amène l'utilisateur à l'élément
home(ou au premier élément visible de premier niveau). - La navigation à gauche affiche l'arbre du menu.
La page Connecteurs lit le fichier des menus pour décider du regroupement — il n'y a pas d'indicateur séparé « ceci est une application » au-delà de « a un menu + est dans le sélecteur ».
Dupliquer une application
La page Connecteurs propose une action Dupliquer (couverte dans Requêtes → Dupliquer une requête ou un connecteur) qui copie le connecteur + son recouvrement de dictionnaire + ses écrans + son menu + ses tableaux de bord + ses graphiques sous une nouvelle clé de connecteur. Le connecteur dupliqué hérite de show_in_switcher ; son menu est câblé automatiquement — l'application dupliquée apparaît dans le sélecteur en haut dès que la duplication se termine.
C'est le bon choix quand :
- Un déploiement parallèle est nécessaire (
nomasx1→nomasx1bpour des tests de non-régression). - Une instance par tenant est mise en place.
- L'application est forkée pour un refactor majeur en gardant l'originale en production.
Masquer une application temporairement
Deux façons de retirer une application du sélecteur sans la supprimer :
| Option | Effet |
|---|---|
Désactiver show_in_switcher sur le connecteur. | L'application disparaît du sélecteur. Ses écrans restent accessibles par URL ; les utilisateurs qui ont l'URL continuent de travailler. |
Supprimer l'entrée [menus.<connector>]. | Le connecteur retourne sous Sources de données. Les écrans résolvent encore, mais l'utilisateur n'a plus de navigation pour les trouver. |
La première est le bon choix pour les fenêtres de maintenance — entièrement réversible en un clic. La seconde sert à retirer définitivement l'UI de l'application.
Installations multi-applications
Une installation Liberty typique porte plusieurs applications :
| Connecteur | Rôle |
|---|---|
crm | CRM destiné aux clients. |
nomasx1 | Revue de sécurité. |
nomajde | Données de référence JD Edwards EnterpriseOne. |
nomaflow | Ordonnanceur de tâches (un produit à part entière). |
default | Le pool du framework lui-même — généralement sans menu, juste une source de données pour les requêtes partagées. |
Chacune obtient son propre bloc [menus.<name>], sa propre pastille sur la page Menus, sa propre tuile dans le sélecteur. Elles partagent le même processus du framework, la même authentification, le même dictionnaire (avec recouvrements par connecteur).
Un utilisateur qui se connecte ne voit que les applications pour lesquelles il a les permissions — GET /api/menus renvoie un arbre vide pour une application où l'utilisateur ne peut rien exécuter (et la tuile du sélecteur se masque en conséquence).
Pièges courants
| Erreur | Symptôme | Correction |
|---|---|---|
Connecteur avec show_in_switcher = true mais sans menu. | Le connecteur apparaît dans le groupe Sources de données de la page Connecteurs ; le sélecteur en haut ne le liste pas. | Ajouter un menu dans Paramètres → Menus. |
Connecteur avec un menu mais show_in_switcher = false. | Le menu existe mais le sélecteur masque la tuile. | Soit activer show_in_switcher, soit accepter que les utilisateurs n'atteindront l'application que par URL. |
home pointe vers un élément de menu qui n'existe plus. | Cliquer la tuile du sélecteur atterrit sur le premier élément visible de premier niveau, en ignorant le home périmé. | Choisir de nouveau un élément valide — la liste déroulante affiche les éléments de menu actifs. |
Ajouter [menus.<X>] où <X> n'est pas un connecteur. | La page rejette l'entrée à l'enregistrement — la clé du menu doit correspondre à un connecteur connu. | Créer d'abord le connecteur, puis attacher le menu. |
| Dupliquer une application mais le nouveau pool n'existe pas. | La boîte de dialogue de duplication refuse de soumettre. | Créer le pool dans Paramètres → Pools avant de dupliquer. |
La suite
- Construire l'arbre — dossiers, feuilles, glisser-déposer et réorganisation.
- Types d'éléments — choisir entre
query,endpoint,dashboard,page. - Requêtes → Dupliquer une requête ou un connecteur — le flux de duplication d'application complète.