Wie bisslang, kann für die einzeln Komponenten von fn2Web die Anzeige der einzelnen Links im Navigationsmenü über Parameter in der web.xml Datei der jeweiligen Komponente über die Parameter NAV_CONFIG und NAV_ROLE_CONFIG angepasst werden. Mit dem Umstieg auf Angular wurde diese Funktion leicht angepasst.

Bisslang konnte entweder der Parameter NAV_CONFIG oder der Parameter NAV_ROLE_CONFIG verwendet werden, jedoch nicht beide zugleich. Für Komponenten unter Angular ist dies nun möglich.

Hierbei handelt es sich im Prinzip um eine Whitelist d.h. es wird definiert, welche Menüpunkte für bestimmte Rollen angezeig werden. Der Parameter-Wert muss folgendermaßen aufgebaut sein:

[RolleId]:[MenuPunkt],…,[MenuPunkt];[RolleId]:[MenuPunkt],…,[MenuPunkt];…;[RolleId]:[MenuPunkt],…,[MenuPunkt]

Falls der Parameter nicht in der web.xml hinterlegt wurde, können alle Rollen alle Menüpunkte sehen.

Hierbei handelt es sich im Prinzip um eine Blacklist d.h. es wird definiert, welche Menüpunkte (unabhängig von der Rolle) nicht angezeigt werden. Der Parameter-Wert muss folgendermaßen aufgebaut sein:

[MenuPunkt];…;[MenuPunkt]

Falls der Parameter nicht in der web.xml hinterlegt wurde, können alle Rollen alle Menüpunkte sehen.

Falls beide Parameter gesetzt werden gilt folgende Regel:

Es werden für bestimmte Rollen nur deren, über NAV_ROLE_CONFIG zugewiesene Menüpunkte angezeigt falls diese nicht im Parameter NAV_CONFIG gesetzt wurden. Der Parameter NAV_CONFIG kann somit die Regeln für NAV_ROLE_CONFIG überschreiben.

• Der Menüpunkt home wird immer angezeit. Hier werden ein Begrüßungs- und ein Infotext angezeigt. Zudem werden hier ggf. die WWW-Meldungen angezeigt.
• Der Menüpunkt logout wird immer angezeigt.
• Der Menüpunkt application wird immer angezeigt wenn der angemeldete Benutzer auf mehrere Komponenten von fn2Web Zugriff hat. Dieser Link führt zurück zur Auswahl.
• Der Menüpunkt orgeinheit wird immer angezeigt wenn der angemeldete Benutzer Zugriff auf mehrere Orgeinheiten hat und diese für die aktuelle fn2Web-Komponente relevant sind.

Bestimmte Menüpunkte werden in Untermenüs zusammengefasst. Hier gilt folgende Regel: Solange mindestens ein Eintrag eines Untermenüs für den Benutzer freigegeben ist wird das Untermenü angezeigt. Um ein Untermenü auszublenden müssen alle Einträge ausgeblendet werden.

Die folgenden drei Init-Parameter müssen jeweils in der zur Webapp dazugehörigen web.xml eingetragen werden. Die beiden Fotos repräsentieren die jeweilige Standard-Reihenfolgen der Navigation in den Angular-Komponenten.

Standardreihenfolge RBAC:

Standardreihenfolge FN2PA:

Ab dem Update 2024-09.050 und 2025-05.003 gibt es neue Möglichkeiten, die Navigation in den FN2-Angular-Komponenten anzupassen:

<init-param>
 <description>Mit diesem optionalen Parameter kann angegeben werden, 
              ob in der Angular-Anwendung  beim Starten der Anwendung die Untermenüs 
              automatisch aufgeklappt werden. </description>
 <param-name>SUBMENU_EXPANDED_ANGULAR</param-name>
 <param-value>true</param-value>
</init-param>

Bei folgendem Parameter werden die gleichen Parameter wie in der NAV_CONFIG bzw NAV_ROLE_CONFIG verwendet.

<init-param>
 <description>Mit diesem optionalen Parameter kann die Startseite 
              der Angular-Anwendung ausgewählt werden. Wenn der Parameter 
              nicht gesetzt wird, wird die Option 'home' verwendet.
              Falls ein Parameter angegeben wird, der nicht sichtbar ist, 
              wird home verwendet.</description>
 <param-name>STARTSEITE_ANGULAR</param-name>
 <param-value></param-value>
</init-param>

<init-param>
 <description> Mit diesem Parameter kann die Sortierung der Menüpunkte in 
               Angular angepasst werden. Das Format ist folgendermaßen:
	       Mit einem Komma werden die einzelnen Obermenüpunkte voneinander abgetrennt. 
               Bei einem Menüpunkt mit Untermenüpunkten werden diese jeweils 
               mit Semikolon abgegrenzt</description>
 <param-name>MENU_ITEMS_ORDERED_ANGULAR</param-name>
 <param-value></param-value>
</init-param>

Folgende Parameter sind derzeit gültig:

FN2PA: home - Studentendaten - import;Import_OrgEinheiten;Import_LVs;Import_Prfangs - verteilen - abschluesse;ab_alumni;ab_jahrbuch;ab_statistik - zeugnisse;zd;komp_zeugnis - wwwM - passwortAendern

FN2RBAC: home - person;person_new;person_edit;student_import - session;active_sessions - ldap;ldap_update

FN2LM: home - prf_teilnehmer

Wenn nur die Oberpunkte sortiert werden sollen, reicht es aus, die Oberpunkte zu nennen (z.B. home,Studentendaten, zeugnisse). Wenn die Unterpunkte sortiert werden sollen, müssen die Unterpunkte, die weiter vorne stehen sollen, genannt werden (z.B. home,person;person_edit → Dadurch würde der Oberpunkt person an 2. Stelle auftauchen und person_edit dessen erster Unterpunkt). Da bei der Sortierung von Unterpunkten der Oberpunkt nicht explizit genannt werden muss, könnte auch folgende Schreibweise benutzt werden: home,person_edit.

Wenn ein Menüpunkt (egal ob Ober- oder Unterpunkt) doppelt genannt wird, wird die Sortierung verworfen und die Standard-Reihenfolge verwendet.

Nicht genannte Elemente werden in der Standardreihenfolge hinter den genannten Elementen geordnet. Dies gilt sowohl für Ober- als auch Unterpunkte.