Naar hoofdinhoud gaan

Een aangepaste React-app openen

Doel​

Een aangepaste React-app die in een omgeving is geregistreerd, openen vanaf de startpagina van de Platformshell.

Vereisten​

  • Je bent aangemeld bij de Platformshell.
  • Je hebt toegang tot de omgeving waarin de aangepaste React-app is geïnstalleerd.
  • De aangepaste React-app is in die omgeving geregistreerd (zie Een aangepaste React-app registreren).

Stappen​

  1. Gebruik in de Platformshell de omgevingskiezer om de omgeving te selecteren waarin de aangepaste React-app is geïnstalleerd.
  2. Ga naar de startpagina van de shell. De aangepaste React-app staat daar naast de ingebouwde modelgestuurde apps, onder de weergavenaam waarmee hij is geregistreerd.
  3. Selecteer de aangepaste React-app. De shell laadt hem en hij opent ter plekke.

Wat er achter de schermen gebeurt​

Voordat de app wordt geladen, vraagt de Platformshell een beperkt, kortlevend toegangstoken aan dat alleen voor die app en die omgeving geldt. Daarna laadt de shell de remote code van de app en rendert die rechtstreeks — de app deelt de ene React-runtime van de shell in plaats van in een geïsoleerd frame te draaien. De app bereikt platformgegevens en logboeken alleen via de Runtime SDK die de shell levert, dus hij handelt altijd met de machtigingen van de aangemelde gebruiker in de huidige omgeving. Een app waarvan de code wordt geleverd vanaf een oorsprong die niet op de allowlist van de omgeving staat, wordt geweigerd voordat hij laadt.

Problemen oplossen​

  • De app staat niet op de startpagina. — controleer of je in de omgeving zit waarin de app is geregistreerd; een aangepaste React-app die in de ene omgeving is geïnstalleerd, verschijnt pas in een andere als zijn oplossing daar is geïmporteerd.
  • "De code van deze app wordt geleverd vanaf een geblokkeerde oorsprong." — de remoteEntry-URL van de app staat niet op de allowlist van de omgeving. Een beheerder moet de oorsprong toevoegen voordat de shell de app wil laden.

Gerelateerde scenario's​

  • Een aangepaste React-app registreren.