Manuel · 8

Gérer les apps

Apps dans le menu principal liste toutes les apps avec leur adresse, leur accès et leur statut. Seuls les administrateurs créent et gèrent les apps.

Créer

Nouvelle app demande le nom et l’accès. IllusionDB déduit l’adresse du nom (« Entrepôt & Expédition » → /app/entrepot-expedition/) ; si elle est prise, un numéro est ajouté. Une nouvelle app a une page d’accueil vide et n’est pas encore publiée.

Modèles

Au lieu d’une page vide, une app peut partir d’un modèle. Vous choisissez une table, et IllusionDB construit l’app à partir de ses colonnes, avec des textes dans la langue actuelle de l’interface. Ensuite, c’est une app ordinaire que vous continuez d’adapter dans l’App-Builder.

Modèle Contenu
Vide une page d’accueil vide
Gestion des données liste avec recherche sur la colonne d’affichage, les plus récents d’abord ; Nouveau ouvre un dialogue de création, un clic sur une ligne un dialogue de modification (prérempli) avec Supprimer et confirmation
Formulaire un formulaire qui crée un enregistrement par envoi, avec un message de remerciement – adapté à une app publique
Vue d’ensemble nombre d’enregistrements, un graphique par colonne de sélection (format label) et les dix enregistrements les plus récents

Chaque colonne reçoit le contrôle adapté : oui/non devient une case à cocher, les dates un champ date, les nombres un champ numérique, les colonnes label et les clés étrangères une liste de sélection (remplie depuis la table cible, avec sa colonne d’affichage comme libellé), les textes longs un champ multiligne. Les colonnes calculées et les clés que la base remplit elle-même restent hors des formulaires. Gestion des données et Formulaire exigent une table avec exactement une clé primaire.

Paramètres

  • Le nom et la description apparaissent dans l’aperçu des apps sous /app/.
  • Adresse – lettres minuscules, chiffres et tirets. La modifier change aussi le lien (les apps installées doivent alors être réinstallées).
  • Icône – image propre pour l’app installée et l’onglet du navigateur (PNG, JPEG, GIF, WebP ; rognée au carré). Sans : l’initiale sur la couleur d’accent.
  • Accès – Avec connexion (administrateurs et utilisateurs et groupes autorisés) ou Publique (sans connexion).

Autoriser

Pour les apps avec connexion, Utilisateurs et groupes détermine qui peut ouvrir l’app. Les administrateurs le peuvent toujours. Vous pouvez autoriser des viewers et des utilisateurs d’apps ainsi que des groupes – les utilisateurs d’apps peuvent aussi être membres d’un groupe.

Brouillon et publication

Vous travaillez toujours sur le brouillon. Les utilisateurs voient la version publiée – seul Publier rend les modifications visibles. Le statut affiche « Modifications non publiées » tant que le brouillon diffère de la version en ligne.

  • Chaque publication crée une nouvelle version (v1, v2 …). Sous Versions, vous pouvez restaurer une version antérieure – elle devient le brouillon ; publiez ensuite pour la mettre en ligne.
  • Mettre hors ligne bloque l’app jusqu’à la prochaine publication. Le brouillon et les versions sont conservés.

Définition

En interne, une app est une définition au format JSON : les pages avec leurs éléments sur la grille, la barre de menus et les requêtes. Sous Définition, vous pouvez la modifier directement en JSON. Le serveur vérifie chaque modification (par exemple si un élément tient dans la grille de 12 colonnes) et n’enregistre que des définitions valides.

Exporter et importer

Exporter télécharge le brouillon sous <adresse>.app.json. Importer (dans l’aperçu) crée une nouvelle app non publiée à partir d’un tel fichier. Les autorisations ne sont pas exportées – les utilisateurs et groupes diffèrent d’une instance à l’autre.

L’aperçu des apps

Sous /app/, chaque compte connecté voit les apps publiées qu’il peut ouvrir, ainsi que les apps publiques. Pour les utilisateurs d’apps, c’est la page d’accueil : ils y arrivent toujours après la connexion.