Ouvrir une application React personnalisée
Objectif
Ouvrir, depuis la page d’accueil du Shell de la plateforme, une application React personnalisée qui a été inscrite dans un environnement.
Prérequis
- Vous êtes connecté au Shell de la plateforme.
- Vous avez accès à l’environnement dans lequel l’application React personnalisée est installée.
- L’application React personnalisée a été inscrite dans cet environnement (voir Inscrire une application React personnalisée).
Étapes
- Dans le Shell de la plateforme, utilisez le sélecteur d’environnement pour choisir l’environnement dans lequel l’application React personnalisée est installée.
- Allez sur la page d’accueil du Shell. L’application React personnalisée y figure à côté des applications pilotées par modèle intégrées, sous le nom d’affichage avec lequel elle a été inscrite.
- Sélectionnez l’application React personnalisée. Le Shell la charge et elle s’ouvre sur place.
Ce qui se passe en coulisses
Avant de charger l’application, le Shell de la plateforme demande un jeton d’accès restreint et de courte durée, limité à cette seule application et à cet environnement, puis charge le code distant de l’application et l’affiche directement — l’application partage l’unique runtime React du Shell au lieu de s’exécuter dans un cadre isolé. L’application n’accède aux données et à la journalisation de la plateforme que par le Runtime SDK fourni par le Shell ; elle agit donc toujours avec les autorisations de l’utilisateur connecté dans l’environnement courant. Une application dont le code est servi depuis une origine absente de la liste d’autorisation de l’environnement est refusée avant même d’être chargée.
Dépannage
- L’application n’apparaît pas sur la page d’accueil. — vérifiez que vous êtes dans l’environnement où l’application a été inscrite ; une application React personnalisée installée dans un environnement n’apparaît pas dans un autre tant que sa solution n’y a pas été importée.
- « This app's code is served from a blocked origin. » — l’URL remoteEntry de l’application ne figure pas dans la liste d’autorisation de l’environnement. Un administrateur doit ajouter l’origine pour que le Shell accepte de la charger.
Scénarios associés
- Inscrire une application React personnalisée.