enhancement
major
minor
major
minor
major
#29551
TL-Ansichten: Es dürfen nur registrierte Einstiegspunkte über eine URL auf oberster Ebene geladen werden
Betrifft 8.0.0-alpha8 (tl-layout-view). Entdeckt beim Erstellen einer Vertriebsanwendung, deren Arbeitsbereich ohne Anmeldung nicht zugänglich sein darf.
Jede Ansichtsdatei kann auf oberster Ebene gerendert werden
`ViewServlet.resolveViewPath` übernimmt alles, was auf den Fensterteil der URL folgt, und lädt, sofern es auf `.view.xml` endet, `/WEB-INF/views/<Rest> ` als Stammverzeichnis des Browser-Tabs. Es gibt keine Liste der Ansichten, die auf diese Weise aufgerufen werden können. ViewConfig kennt nur die Standardansicht (app.view.xml).
Daher ist jede View-Datei, die die Anwendung oder das Framework bereitstellt, ein Einstiegspunkt, obwohl fast alle davon Fragmente sind: die framework-eigenen „login.view.xml“, „user-menu.view.xml“, „change-password.view.xml“, otp.view.xml, mfa-enroll.view.xml, der „admin/ “-Baum sowie jeder Anwendungsdialog oder jedes Anwendungsfenster, das über ein <view-ref> oder ein <open-dialog> aufgerufen werden soll. Der Aufruf von /view/<window>/ida/pipeline.view.xml rendert diesen Bereich außerhalb der App-Shell, ohne Seitenleiste, ohne den Benachrichtigungsbereich, ohne die Eingabekanäle, die die umschließende Ansicht bindet, und außerhalb dessen, was die Root-Ansicht davor platziert.
Anforderung: Nur Ansichten, die als Einstiegspunkte der Anwendung registriert sind, dürfen auf oberster Ebene geladen werden. Eine Anwendung kann mehrere Einstiegspunkte deklarieren (z. B. eine öffentliche Landingpage neben dem Desk), muss diese jedoch explizit auflisten.
Lösung
- ViewConfig erhält eine Liste der Einstiegspunkte aus View-Dateien (Pfade relativ zu /WEB-INF/views/, sortiert nach dem Pfad, sodass die Konfigurationsdateien mehrerer Module zusammengeführt werden). Die Standardansicht (default-view) ist implizit ein Einstiegspunkt.
- Das ViewServlet löst eine .view.xml-URL ausschließlich anhand dieser Liste auf. Eine Anfrage, die eine nicht registrierte Ansicht nennt, wird mit 404 Not Found beantwortet: Die URL ist nicht Teil der Benutzeroberfläche der Anwendung. Eine Weiterleitung zur Standardansicht wäre keine Alternative, da es danach keinen Weg zurück zur angeforderten Ansicht gibt.
- Die framework-eigenen Fragmente (login.view.xml, user-menu.view.xml, der „admin/ “-Baum, die Self-Service-Dialoge, …) sind nicht registriert. Eine Anwendung, die beispielsweise die Einstellungsansicht als Lesezeichen-fähigen Eintrag nutzen möchte, registriert diese selbst.
Beispiel (<app>.config.xml): {{{#!xml <config config:interface="com.top_logic.layout.view.ViewConfig"> <entry-points> <entry-point view="landing.view.xml"/> </entry-points> </config> }}}
Nicht Gegenstand dieses Tickets: die Beschränkungvon Einstiegspunkten für anonyme Sitzungen. Jede Ansicht auf oberster Ebene ist selbst für die Behandlung des anonymen Falls verantwortlich (z. B. ein <switch> auf currentUser(), der die Anmeldeseite anstelle des Desks anzeigt); das Framework leitet anonyme Anfragen nicht an andere Stellen weiter.
Migration
Eine React-Anwendung, die andere Ansichten als ihre Standardansicht direkt über eine URL (/view/<window>/<path>.view.xml, Links, Lesezeichen) öffnet, muss diese als Einstiegspunkte registrieren; eine nicht registrierte Ansicht wird mit einem 404-Fehler („Kein solcher Einstiegspunkt.“) beantwortet. In <app>.config.xml:
{{{#!xml <config config:interface="com.top_logic.layout.view.ViewConfig"> <entry-points> <entry-point view="landing.view.xml"/> </entry-points> </config> }}}
Die Standardansicht ist implizit ein Einstiegspunkt. Ansichten, die nur über <view-ref>, <open-dialog> oder Routen erreicht werden, müssen nicht registriert werden.