Créer une application Studio
Objectif
Créer une application Studio — une application que vous dessinez, plutôt qu’une application construite à partir des champs d’une table.
Si c’est votre première, Construire votre première application Studio vous guide tout au long du parcours — une table, un écran, une liste issue de cette table, une barre d’outils et un tiroir qui réécrit un enregistrement — en une quarantaine de minutes.
Ce qu’est une application Studio
La plateforme propose trois choses que l’on dessine, et ce ne sont pas les mêmes.
- Un rapport, c’est du papier. Il a des pages, il s’imprime toujours de la même façon, et ce qu’il produit est l’image d’un document.
- Un tableau de bord, ce sont des chiffres. Vous dessinez les panneaux et indiquez où va chaque widget, et la plateforme remplit ces espaces avec ses propres graphiques et grilles en direct.
- Un écran, c’est l’application elle-même. Tout ce que vous dessinez devient une vraie partie de la page — son texte peut être sélectionné, ses boîtes sont de vraies boîtes, et plus tard ses zones de saisie accueilleront un curseur et ses boutons feront quelque chose.
Vous choisissez donc un écran quand ce que vous voulez n’est ni un formulaire sur une table ni une page de chiffres, mais un morceau de l’application disposé comme vous l’entendez.
Ce que vous dessinez s’exécute pour de vrai, et il y a deux façons d’y accéder. Elle apparaît seule dans la liste des applications du Shell, à côté de vos applications pilotées par modèle, avec pour seul entourage la barre supérieure de la plateforme — voir Exécuter une application Studio seule. Et elle peut être placée dans la navigation d’une application pilotée par modèle, ce qui permet de poser une page d’accueil conçue au-dessus d’une liste d’enregistrements — voir Ouvrir une application Studio depuis une application pilotée par modèle.
Prérequis
- Vous êtes connecté en tant que créateur, avec un environnement et une solution sélectionnés.
Étapes
- Ouvrez votre solution et choisissez Écrans.
- Appuyez sur Nouveau.
- Saisissez un nom d’affichage — ce que vous verrez dans cette liste. Le nom logique se remplit pendant que vous tapez ; il est préfixé par le préfixe de votre éditeur.
- Facultativement, décrivez à quoi sert l’écran. C’est ce que lit quelqu’un d’autre au moment de décider si c’est bien l’écran qu’il cherche.
- Choisissez ce qu’est cette application — voir les trois types ci-dessous. Laissez Application sauf si vous dessinez une page d’une application pilotée par modèle ou un portail.
- Facultativement, choisissez une icône. C’est l’image de la tuile de cette application dans la liste des applications, tirée du même jeu que toutes les icônes de la plateforme. Sans icône, la tuile affiche une fenêtre, ce qui représente une application dessinée partout ailleurs — mais une rangée de tuiles montrant toutes la même fenêtre est une rangée où l’on ne trouve rien : cela vaut bien dix secondes.
- Appuyez sur Enregistrer.
- L’écran étant sélectionné, appuyez sur Concevoir pour ouvrir le canevas — voir Dessiner une application Studio.
Les trois types d’application
Chaque application indique à quoi elle sert, et cela détermine où elle peut être utilisée. C’est la première chose à régler correctement, car les deux autres réglages en dépendent.
| Ce que c’est | Où elle apparaît | |
|---|---|---|
| Application | Quelque chose que les gens ouvrent. Le choix par défaut. | La liste des applications — et elle peut aussi être une page dans une application pilotée par modèle |
| Page d’une application | Un écran qui appartient à une application pilotée par modèle | La navigation de cette application, et nulle part ailleurs. Elle n’a pas de tuile à elle |
| Portail | Un écran publié à une adresse web pour des personnes non connectées | L’adresse de son portail, et nulle part ailleurs |
Un portail est le seul qui ne peut vraiment s’exécuter nulle part ailleurs, c’est pourquoi ce
choix est refusé plutôt que simplement déconseillé. Un écran de portail lit ses données au moyen
d’API personnalisées (api:…), ce qui est la façon dont lit un portail et que le Shell de la
plateforme n’autorise délibérément pas — un dessin de portail placé dans une application pilotée par
modèle serait donc une page qui échouerait chaque fois que quelqu’un l’ouvrirait. Choisissez
Portail et l’application cesse d’être proposée aux applications pilotées par modèle pour être
proposée sur la page Portails ; choisissez autre chose et aucun portail ne la publiera.
Changer ultérieurement le type d’une application est autorisé, et c’est vérifié par rapport à ce qui y fait déjà référence : vous ne pouvez pas transformer le dessin propre à un portail en application ordinaire tant que ce portail le publie.
Les deux cases à cocher
La boîte de dialogue Nouveau (et Modifier) comporte deux cases, dont les valeurs par défaut vont délibérément en sens opposés. Elles ne s’affichent que pour une Application : une page vit dans une application pilotée par modèle et un portail répond à sa propre adresse, si bien qu’aucun des deux n’a de tuile dans la liste des applications ni de barre de plateforme à masquer.
| Au départ | Ce qu’elle fait | |
|---|---|---|
| Partager les composants de cette application | désactivée | Toutes les autres applications de cet environnement peuvent placer les composants dessinés ici — voir Utiliser un composant dans une autre application |
| Afficher dans la liste des applications | activée | Les personnes qui utilisent cet environnement voient cette application dans la liste des applications du Shell de la plateforme |
La plupart des applications ne veulent modifier ni l’une ni l’autre : une application est quelque chose que l’on ouvre, et elle garde ses composants pour elle.
Partager des composants n’est pas l’un des types, délibérément : une application ordinaire peut
prêter ses éléments à une autre sans être une bibliothèque — l’exemple Studio — Shared Components
montre deux applications qui font exactement cela.
Inversez les deux et vous obtenez une bibliothèque de composants — une application dont le rôle
est de contenir les éléments à partir desquels sont construites vos autres applications, et dont
personne utilisant le produit ne devrait recevoir de tuile. L’exemple Studio — Component Library
est exactement cela.
Décocher Afficher dans la liste des applications masque la tuile, pas l’application. Elle est toujours là dans le portail des créateurs — c’est là que vous allez pour la réafficher — et tout ce qui renvoie à l’un de ses écrans l’ouvre encore : la navigation d’une application pilotée par modèle, un lien sur un autre écran, une adresse que quelqu’un a conservée. Ce qu’une personne a le droit d’ouvrir relève des autorisations, et ce n’est pas le cas ici.
Ce que vous ne pouvez pas modifier ensuite
Le nom logique. Tout ce qui accède à un écran le nomme : en renommer un casserait toutes ces références d’un coup, et sans le dire. Le nom d’affichage et la description peuvent être modifiés quand vous le souhaitez.
Où vit un écran
Un écran est un composant de votre solution, comme un formulaire ou une vue. Il est donc versionné, il voyage quand vous exportez la solution et l’importez dans un autre environnement, et il est de nouveau retiré si la solution gérée qui l’a apporté est désinstallée.
Il n’existe pas d’export vers un fichier pour un écran isolé, délibérément : un écran qui pourrait circuler hors d’une solution est un écran dont personne ne peut reproduire l’environnement.
Dépannage
- « …doit être en minuscules avec des traits de soulignement et commencer par le préfixe de l’éditeur. » — le nom logique doit commencer par le préfixe de votre éditeur et n’utiliser que des lettres minuscules, des chiffres et des traits de soulignement. Saisissez d’abord le nom d’affichage et laissez le nom logique se remplir.
- « Un écran nommé … existe déjà dans cet environnement. » — ce nom est pris. On accède aux écrans par leur nom : deux écrans ne peuvent donc pas le partager.
- Chaque écran indique « Dessin uniquement ». — c’est normal dans cette version. Voir la note ci-dessus.