Falls erforderlich, können Sie die Links, die im linken Menü des Web Client-Frameworks angezeigt werden, ändern. Idealerweise sollten Sie Änderungen am Menü vermeiden und stattdessen Links zur Startseite hinzufügen, wie im Artikel Anpassen des Hauptmenüs im Web Client beschrieben.
Die folgenden Abschnitte erklären, wie die Hauptmenüs funktionieren, und bieten Anleitungen zum Hinzufügen neuer Links.
- Wie Web Client-Menüs definiert werden
- Starten der Hauptmenü-Deklaration
- Definieren von Menüeinträgen
- Link-Ziele
- Links zur Web Client-Startseite hinzufügen
Wie Web Client-Menüs definiert werden
Die Menüs für den Web Client werden mit Menü-Deklarationen definiert. Menü-Deklarationen werden in XML geschrieben und in Dateien auf dem Application Server gespeichert. Für jeden Menüeintrag gibt die Menü-Deklaration das Label an, das der Benutzer sieht, sowie das Ziel des Links, wenn der Benutzer den Eintrag auswählt.
Menü-Deklarationen werden sowohl für das Hauptmenü im Framework als auch für die Dropdown-Menüs auf den Web Client-Seiten verwendet. In der Regel müssen Sie nur das Hauptmenü anpassen.
Die XML-Menü-Deklaration für das Hauptmenü ist in der Datei menu.xml definiert. Diese Datei wird im etc-Verzeichnis des Application Servers installiert. Die Menü-Deklaration selbst heißt mainMenu.
In einer typischen Installation befindet sich das etc-Verzeichnis unter:
C:\Program Files\LexisNexis\InterAction\AppServer\iahome\etc.
Wenn Sie dieses Hauptmenü ändern möchten, sollten Sie zunächst die Deklaration kopieren und in eine separate Datei einfügen. Der InterAction Application Server installiert hierfür eine leere Menü-XML-Datei namens localMenus.xml. Diese Version verwenden Sie, um die Menüs anzupassen.
Die Datei localMenus.xml wird im local-Verzeichnis des Application Servers installiert.
In einer typischen Installation befindet sich das local-Verzeichnis unter:
C:\Program Files\LexisNexis\InterAction\AppServer\iahome\local.
Um das Hauptmenü zu konfigurieren, müssen Sie XML-Dateien bearbeiten. Bevor Sie die Anleitungen in diesem Abschnitt verwenden, um das Hauptmenü zu ändern, sollten Sie mit den Grundlagen von XML vertraut sein. Sie sollten die folgenden Begriffe und Konzepte kennen:
- Elemente und Tags
- Der Unterschied zwischen öffnenden und schließenden Tags
- Verschachtelung eines Tags innerhalb eines anderen Tags
- Attribute
- Werte zu Attributen zuweisen
- Ein XML-Dokument wohlgeformt machen
Wenn Sie mit diesen Konzepten nicht vertraut sind, lesen Sie den Artikel Überblick über das Bearbeiten von XML-Dateien. Beachten Sie, dass Sie sich mit der Arbeit mit XML auskennen sollten, um den InterAction Web Client zu konfigurieren.
Starten der Hauptmenü-Deklaration
Die Menü-Deklaration für das Hauptmenü des Web Clients beginnt mit einem <menuItem>-XML-Tag, ähnlich wie im folgenden Beispiel:
<menuItem id='mainMenu'>
Das <menuItem>-Tag startet einen neuen Menüeintrag; das id-Attribut weist ihm einen Namen zu. Alle Einträge im Menü werden zwischen dem öffnenden <menuItem>-Tag und einem schließenden Tag verschachtelt:
</menuItem>
Definieren von Menüeinträgen
Ein Menüeintrag wird mit einem XML-Block wie dem folgenden definiert:
Definieren eines Menüeintrags in XML
<menuItem>
<label>$(Contact Types)</label>
<methodName>contact-lists-home</methodName>
<url>
contact-lists-home?folderClass=1&searchDescription=$(Contact Types)
</url>
</menuItem>
Dieser XML-Block kann wie folgt interpretiert werden:
- Das <menuItem>-Tag startet den Eintrag. Es ist normalerweise innerhalb eines anderen <menuItem>-Tags verschachtelt, das das gesamte Menü startet.
- Das <label>-Tag gibt den Text an, der für den Menüeintrag angezeigt wird. Im obigen Beispiel wird eine Variable für das Label verwendet. Die Variable $(Contact Types) enthält den Begriff für Kontaktarten in Ihrer Umgebung.
- Das <methodName>-Tag ist der Name der Seitenmethode, die die anzuzeigende Seite definiert. Obwohl dies in mehreren der Standardseiten enthalten ist, ist es nicht erforderlich, wenn Sie das <url>-Tag angeben.
- Das <url>-Tag gibt die vollständige URL der anzuzeigenden Seite an, einschließlich aller Parameter, die an die Seite übergeben werden sollen.
Das Hauptmenü besteht aus mehreren dieser Blöcke, die alle unter dem <menuItem>-Tag verschachtelt sind, das das gesamte Menü startet.
Link-Ziele
Für jeden Menüeintrag, der als Link angezeigt wird, geben Sie mit dem <url>-Tag ein Link-Ziel an. Wenn Sie auf eine andere Web Client-Seite verlinken, geben Sie den Namen der Seite und alle erforderlichen Parameter in der URL an.
Beispielsweise sehen Sie hier die folgende URL für den Menüeintrag „Alumni“:
URL für den Menüeintrag „Alumni“
<menuItem>
<label>$(Contact Types)</label>
<methodName>contact-lists-home</methodName>
<url>
contact-lists-home?folderClass=1&searchDescription=$(Contact Types)
</url>
</menuItem>
Diese URL setzt sich wie folgt zusammen:
- contact-lists-home ist der Name einer Web Client-Seite, die eine „Liste von Listen“ anzeigt. Diese Seite akzeptiert mehrere Parameter, die festlegen, welche Arten von Listen angezeigt werden (Kontaktarten, Marketinglisten oder Arbeitslisten).
-
Die Elemente nach dem Fragezeichen (?) sind die Parameter, die an die Seite übergeben werden. Jeder Parameter wird mit folgendem Symbol getrennt:
&
Dies ist ein spezielles XML-Zeichen, das beim Anzeigen der Seite in ein kaufmännisches Und (&) umgewandelt wird.