Sämtliche Views einer Anwendung müssen beim Navigator registriert werden. Der Navigator ist Bestandteil eine virtuelle UI-Komponente (Virtual Component), die bereits standardmäßig in der MainUI vorhanden ist und
- verwaltet die registrierten Views in einer Liste
- weist jeder registrierten View eine eindeutige URI (Uniform Resource Identifier) zu, mit der zur Laufzeit der direkte Aufruf der View über die Suchleiste des Browsers möglich ist, sofern der Anwender die entsprechende Berechtigung dazu besitzt.
- ermöglicht den Aufruf der View mit der einfachen Methode navigateToMethode Navigation.to() ohne Angabe der URI
- nimmt aufgerufene Views zur Laufzeit in die Browser-History auf, und ruft diese bei Browser Vor- und Zurück-Aktionen automatisch auf
- zeigt legt fest, wo die View an der festgelegten Stelle an
Hinweis:
- Die MainView wird automatisch auf der Oberfläche angezeigt werden soll, direkt auf der MainUI, in einem Layout oder in einer UI-Komponente.
Für Authentifizierung und Autorisierung gibt es mit dem XdevAuthenticationNavigator bzw. XdevAuthorizationNavigator Navigatoren mit erweiterten Funktionen.
Properties:
Der Navigator lässt sich wie eine UI-Komponente in den Properties konfigurieren.
- Target - Hier kann die UI-Komponente gewählt werden, in der die Views angezeigt werden. Standardmäßig ist die MainUI eingestellt, es kann aber auch eine andere UI-Komponente wie z.B. ein Layout, ein Panel oder ein SplitPanel ausgewählt werden.
- Views - Liste der registrierten Views.
- LoginViewName - Hier kann die Loginview angegeben werden. Es stehen nur Views zur Auswahl, die unter Views registriert sind. Dieser Wert kann nur bei XdevAuthenticationNavigator und XdevAuthorizationNavigator gesetzt werden.
- RedirectViewName - Hier kann eine View angegeben werden, die bei erfolgreichem Login aufgerufen wird. Auch dieser Wert kann nur bei XdevAuthenticationNavigator und XdevAuthorizationNavigator gesetzt werden.
- PermissionDeniedViewName - Hier kann eine View angegeben werden, zu der navigiert wird, wenn die Rechte des aktuellen Benutzers die Navigation zu einer View nicht erlauben. Dieser Wert kann nur bei XdevAuthorizationNavigator gesetzt werden.
Hinweis:
...
- Standardmäßig wird die MainView als erste View in den Navigator eingetragen.
- Der Navigator lässt sich in den Properties konfigurieren.
- Beim Aufruf einer View mit navigateTomit Navigation.to() wird wird die View automatisch beim Navigator registriert.
- Views, die nicht via URI aufrufbar sein sollen, dürfen nicht im Navigator registriert werden.
Der Navigator ist ein wichtiger Bestandteil der MainUI. Er ermöglicht es zwischen den verschiedenen Views einer Anwendung zu navigieren und kümmert sich automatisch um den korrekten Aufruf von Views bei Browser Vor- und Zurück Aktionen. Dazu müssen Sie die einzelnen Views initial beim Navigator registrieren und festlegen, wo genau die Views angezeigt werden sollen, z.B. in einem Layout, in einer UI-Komponente oder direkt in der MainUI. Sämtliche Einstellungen lassen sich über Properties vornehmen. Anschließend lässt sich jede View mit der einfachen Methode navigateTo() aufrufen. Der Navigator ist keine UI-Komponenten, wird jedoch unter Structure angezeigt, um diesen selektieren und via Properties konfigurieren zu können.
- In der Preview ist die Browser-Zurück Funktion nicht möglich.
Views manuell registrieren
- Selektieren Sie den Navigator.
- Klicken Sie bei Properties > Views auf [Entries].
- Klicken Sie im folgenden Assistenten auf New.
- Klicken Sie in der neuen Zeile in die Spalte View Type.
- Geben Sie im folgenden Assistenten die View an, die Sie registrieren möchten, z.B. CustomerView.
- Klicken Sie auf OK.
- Geben Sie bei Path ein eindeutiges Pfad-Fragment an, über das die View im Browser aufgerufen werden kann, z.B. customer, und bestätigen Sie die Eingabe mit Enter.
- Klicken Sie auf OK.
Hinweis:
- Die erste View benötigt keinen Pfad.
- Die URI ist zur Laufzeit im Browser sichtbar, in der Preview jedoch nicht.