Panel Studio
Panel Studio est l’éditeur des applications Panel dans PlaidCloud. Il affiche les fichiers de l’application à côté d’un éditeur, génère un aperçu privé que vous pouvez ouvrir et publie l’application lorsque vous êtes prêt. Vous n’avez pas besoin d’un dépôt git pour commencer.
Ouvrir Panel Studio
Section intitulée « Ouvrir Panel Studio »- Sur le tableau Accueil d’un projet, choisissez Ouvrir dans Studio sur une application Panel.
- Dans Applications, choisissez Studio sur la ligne d’une application.
Pour démarrer une nouvelle application, choisissez Nouvelle application > Studio. Cette option figure aussi dans la ligne Applications Studio de la carte Applications et image de marque de l’onglet Accueil d’un projet. Pour créer une application à partir d’une table, sélectionnez-la dans l’onglet Tables du projet et choisissez Créer une application Panel.
Créer une application
Section intitulée « Créer une application »La boîte de dialogue Nouvelle application Studio vous propose cinq points de départ :
| Partir de | Vous obtenez |
|---|---|
| Application vierge | Une application minimale avec un fichier app.py et un fichier requirements.txt. |
| À partir d’une table | Une application construite sur la table que vous choisissez. |
| À partir d’une vue | La même chose, construite sur une vue du projet. |
| À partir d’une autre application Studio | Une copie de l’une de vos applications Studio. |
| À partir de la galerie | Une copie d’une application que votre espace de travail a listée dans la galerie d’applications. |
Nommez l’application, choisissez son Projet, puis choisissez Créer. Studio ouvre la nouvelle application avec ses fichiers listés à gauche. Pour une table ou une vue, l’invite Weave destinée à générer la première page de l’application est prête à être envoyée. Consultez Créer une application Panel.
Où se trouve votre application
Section intitulée « Où se trouve votre application »Une application Studio est un dossier portant le nom de l’application (<app-slug>/) dans le dépôt apps de votre espace de travail, au sein de PlaidCloud Git, le même dépôt que celui de vos autres applications Panel. Studio ne crée pas de dépôt distinct pour l’application : vous pouvez donc retrouver et modifier son code source dans apps, à côté de vos autres applications.
- Branche de brouillon. Le travail qui n’est pas encore en ligne est conservé sur une branche nommée
studio-<app-slug>. Publier copie le dossier de l’application depuis cette branche vers la branche principale. - Régénérations. Un push vers
appsne régénère une application que si le dossier de cette application, ou le fichierrequirements.txtà la racine du dépôt, a changé. - Applications existantes. Une application Studio qui se trouvait dans son propre dépôt est déplacée automatiquement dans son dossier. L’ancien dépôt est archivé : il est conservé, en lecture seule, et n’est jamais supprimé.
Modifier
Section intitulée « Modifier »Choisissez un fichier dans la liste pour le modifier dans l’éditeur. Listez vos dépendances Python dans requirements.txt, un paquet par ligne. Elles sont installées lors de la génération de l’application.
Choisissez Demander à Weave pour que Weave écrive ou modifie l’application à votre place. Consultez Créer des applications Panel avec Weave.
Enregistrer, prévisualiser et publier
Section intitulée « Enregistrer, prévisualiser et publier »Enregistrer
Section intitulée « Enregistrer »Enregistrer stocke vos modifications sous forme de brouillon. L’application en ligne ne change pas, et personne d’autre ne voit le brouillon.
Aperçu génère votre brouillon enregistré sous forme de copie privée et l’ouvre. Seuls les éditeurs de l’application peuvent ouvrir un aperçu.
- Un aperçu est supprimé après 24 heures sans enregistrement.
- Un espace de travail peut avoir jusqu’à 10 aperçus à la fois.
- Enregistrez de nouveau et choisissez Aperçu pour voir vos dernières modifications.
Publier remplace l’application en ligne par votre brouillon enregistré. Cette action exige l’autorisation de modification sur le projet de l’application, et Studio vous demande d’abord de confirmer.
Si quelqu’un d’autre a publié une modification après que vous avez ouvert l’application, Studio signale un conflit au lieu d’écraser son travail. Rechargez l’application, reportez-y vos modifications, puis publiez de nouveau.
État de la génération et erreurs
Section intitulée « État de la génération et erreurs »L’onglet Créer affiche l’état de la dernière génération et se met à jour pendant son déroulement. Lorsqu’une génération échoue, l’onglet liste chaque erreur avec son fichier et son numéro de ligne, ce qui vous permet d’aller directement à la ligne concernée. Les problèmes de dépendances dans requirements.txt s’accompagnent d’une indication pour les corriger.
Les erreurs et les avertissements sont aussi signalés sur leurs lignes dans l’éditeur : vous voyez donc le problème là où il se trouve.
Pour connaître la signification de chaque état une fois l’application publiée, consultez Utiliser une application Panel.
Historique et restauration
Section intitulée « Historique et restauration »L’onglet Historique liste toutes les versions publiées de l’application, de la plus récente à la plus ancienne, avec leur état de génération. Choisissez Charger plus pour voir les versions plus anciennes.
Pour revenir à une version antérieure, choisissez Restaurer sur cette version et confirmez. La version restaurée devient l’application en ligne et est régénérée. Votre brouillon non enregistré n’est pas perdu : il reste dans le brouillon et passe en ligne par-dessus la version restaurée à la prochaine publication. Si l’application correspond déjà à cette version, Studio l’indique et ne change rien. Si quelqu’un a publié pendant que vous restauriez, Studio ne restaure rien et vous demande de réessayer.
Analyses
Section intitulée « Analyses »L’onglet Analyses montre comment les utilisateurs se servent de l’application et sa rapidité de réponse. Choisissez les 7, 14 ou 30 derniers jours.
| Section | Affiche |
|---|---|
| Vues par jour | Le nombre de fois où l’application a été ouverte chaque jour. |
| Chargement de page | Le temps de chargement médian, et le temps que 95 % des chargements ne dépassent pas, d’après les chargements de page de la période. |
| Requêtes les plus lentes | Les requêtes qui ont pris le plus de temps, avec leur fréquence d’exécution et leurs temps médian, élevé et maximal. |
| Erreurs | Ce qui s’est mal passé pendant la période, par type d’erreur et par endroit de l’application où elle s’est produite. |
Lorsqu’une période contient plus d’activité que ce que les analyses peuvent lire, elles indiquent que les chiffres sont partiels. Lorsque les chargements de page dépassent le budget de performance de l’application, les analyses vous avertissent du nombre de chargements concernés et des requêtes qui étaient lentes. Les analyses n’affichent jamais les données renvoyées par une requête ni les noms des personnes qui ont ouvert l’application.
Les onglets Historique et Analyses exigent que l’application soit affectée à un projet ; une application non affectée affiche une invite pour l’affecter.
Alertes et synthèses
Section intitulée « Alertes et synthèses »Choisissez Alertes et synthèses pour configurer des notifications qui surveillent un chiffre dans les données de l’application et vous avertissent lorsqu’il franchit une limite, ou qui envoient un récapitulatif selon une planification. Consultez Alertes et synthèses.
Lister une application dans la galerie
Section intitulée « Lister une application dans la galerie »Choisissez Galerie… dans Studio. Choisissez Lister dans la galerie pour lister l’application comme modèle à partir duquel toute personne pouvant consulter son projet peut créer sa propre application, ou Retirer de la galerie pour la retirer. Le bouton est disponible pour les applications qui appartiennent à un projet. Vous devez disposer de l’accès en modification au projet. Consultez La galerie d’applications.
Épingler à l’accueil
Section intitulée « Épingler à l’accueil »Choisissez Épingler à l’accueil pour ajouter l’application au tableau Accueil du projet, et Détacher de l’accueil pour la retirer.
Supprimer une application
Section intitulée « Supprimer une application »La suppression d’une application Panel demande d’abord une confirmation. Dans Applications, utilisez l’icône moins sur la ligne de l’application. L’annulation de la publication demande également une confirmation.
Étapes suivantes
Section intitulée « Étapes suivantes »- Créer des applications Panel avec Weave : décrivez l’application et approuvez la modification exacte.
- Le kit d’applications Panel : les composants que les points de départ Studio à partir d’une table ou d’une vue utilisent.
- Alertes et synthèses : avertissez les utilisateurs lorsqu’un chiffre franchit une limite, ou selon une planification.
- La galerie d’applications : partagez une application comme point de départ pour les autres.
- Utiliser une application Panel : journaux, utilisation et régénérations après la publication.