Eine der häufigsten Anpassungen der Startseite des Web Client ist das Hinzufügen zusätzlicher Links zu anderen Bereichen des Systems und zu externen Seiten. Zum Beispiel könnten Sie Folgendes tun wollen:
- Fügen Sie unter „Suchen nach“ Links zu anderen wichtigen Suchformularen und externen Suchmaschinen hinzu.
- Fügen Sie Links zu bestimmten wichtigen Kontaktlisten hinzu, wie z. B. Top-Kunden und potenzielle Neukunden.
- Fügen Sie „Schnellsuche“-Links zu Teilmengen der Kontaktlisten der Organisation hinzu, z. B. zu Mitarbeitern in einem bestimmten Büro.
- Fügen Sie Links zu weiteren Hilfethemen oder zu Prozessanweisungen in Ihrem Intranet hinzu.
Startseite mit neuen Links angepasst
[A] Benutzerdefinierter Link, der zum „Suchen nach...“-Bereich hinzugefügt wurde. Dieser Link öffnet das Suchformular für Mandanten.
[B] Dies sind neue Bereiche, die auf der Seite hinzugefügt wurden, um weitere benutzerdefinierte Links bereitzustellen.
Die Standard-Startseite enthält mehrere vordefinierte Linklisten (Suchen nach, Neu hinzufügen, Message Center usw.) sowie eine zusätzliche Liste, die angezeigt wird, wenn Ihre Organisation eines der zugehörigen Module lizenziert hat.
Jede dieser Listen wird mit dem formatSearchList.jsp-Bereich auf der Seite platziert, der eine Reihe von Links anzeigen kann, die in einer separaten Suchlistendeklaration definiert sind. Wie Sie die Links auf der Seite ändern, hängt also genau davon ab, was Sie ändern möchten:
-
Wenn Sie nur neue Links zu einer der Standardlisten hinzufügen möchten, bearbeiten Sie die entsprechende Suchlistendeklaration.
Im obigen Beispiel wurde so das neue Element für Mandanten zur Liste „Suchen nach“ hinzugefügt.
-
Wenn Sie einen komplett neuen Block mit Links hinzufügen möchten, müssen Sie die Seitendeklaration bearbeiten, um eine neue Instanz des formatSearchList.jsp-Bereichs hinzuzufügen, und dann auch eine neue Suchlistendeklaration anlegen, um die Links zu definieren.
Im obigen Beispiel ist der Bereich Weitere Ressourcen eine komplett neue Instanz des formatSearchList.jsp-Bereichs, die der Seite hinzugefügt wurde.
Weitere Informationen zum Hinzufügen neuer Bereiche auf der Startseite finden Sie unter Layout und Bereiche auf der Startseite ändern.
Die folgende Tabelle beschreibt die Standard-Suchlistendeklarationen, die auf der Startseite verwendet werden:
| Bereich der Seite | Links | Suchlistendeklaration |
|---|---|---|
| Suchen nach... |
Diese Links öffnen die entsprechenden Suchformulare auf der Kontakt-Suchseite. |
home-search |
| Neu hinzufügen... |
Eine Änderung dieser Suchliste wird nicht empfohlen. |
home-add |
| Message Center | Dynamische Links, abhängig vom Status der Kontakte des Benutzers. Eine Änderung dieser Suchliste wird nicht empfohlen. | home-message |
| Zugehörige Module |
Zeigt einen Link zu den Datenqualitäts-Suchen für die zugehörigen Module an (InterAction Opportunities, InterAction Engagements und InterAction Matters). Der Link erscheint nur, wenn Ihre Organisation eines der Module lizenziert hat und Sie als Benutzer mit Berechtigung für die Suchen angemeldet sind. |
home-related-modules |
| Anzeigen... |
Links zum Anzeigen von Erinnerungen (falls aktiviert). Eine Änderung dieser Suchliste wird nicht empfohlen. |
home-view |
| Schnellreferenz |
Diese Links öffnen Themen im Hilfesystem des InterAction Web Client. |
home-how |
Diese Suchlistendeklarationen werden in der Konfigurationsdatei searchLists.xml gespeichert, die im etc-Verzeichnis des Application Server installiert ist.
Bevor Sie eine dieser Deklarationen bearbeiten, sollten Sie sie in die Datei localSearchLists.xml im lokalen Verzeichnis des Application Server kopieren. In einer typischen Installation befindet sich das lokale Verzeichnis unter C:\Program Files\LexisNexis\InterAction\AppServer\iahome\etc\local.
Eine vollständige Liste der XML-Tags, die in einer Suchlistendeklaration verwendet werden können, finden Sie unter XML-Referenz für Suchlistendeklarationen. Die folgenden Abschnitte zeigen, wie die Tags in den Standard-Suchlistendeklarationen der Startseite verwendet werden:
- Tags, die eine Suchliste beginnen
- Suchlisteneinträge (Überschriften und Links) für die Startseite definieren
- Beispiel-URLs für Links auf der Startseite
- Verlinkung zu Web Client Hilfethemen
- Kopie der Standard-Suchliste zum Bearbeiten erstellen
Tags, die eine Suchliste beginnen
Alle Suchlistendeklarationen in einer XML-Konfigurationsdatei müssen innerhalb des searchListDeclarations Tag-Tags verschachtelt sein. Nach diesem Tag beginnt jede Suchliste mit dem searchList Tag-Tag. Ein Wert für das id-Attribut benennt die Liste, sodass sie von anderen Deklarationen referenziert werden kann. Dies startet im Wesentlichen eine neue Liste. Nach dem ersten searchList Tag-Tag definieren die folgenden Tags Überschriften und Links. Siehe searchList Tag.
Im folgenden Codebeispiel ist das id-Attribut des ersten searchList Tag-Tags auf home-search gesetzt. Damit wird eine neue Suchliste mit dieser ID gestartet. Die nachfolgenden Instanzen des searchList Tag-Tags setzen das ID-Attribut nicht, sondern definieren neue Einträge in der Liste. Die Seitenmethode für die Startseite (home in der Datei pages.xml) verweist auf die home-search-ID, wenn der formatSearchList.jsp-Bereich auf der Seite platziert wird.
Eine Suchliste beginnen und Einträge definieren — XML-Beispiele
<!-- Diese Zeile startet die Deklaration der home-search-Suchliste. Sie definiert die Links, die unter der Überschrift „Suchen nach...“ auf der Startseite erscheinen. Das id-Attribut gibt den Namen der Suchliste an, auf die von anderen Deklarationen verwiesen werden kann. -->
<searchList id="home-search" template="searchList.xsl">
<searchList>
...<!-- Tags für das erste Element der Liste erscheinen hier -->
</searchList>
... <!-- Weitere Listeneinträge erscheinen hier vor dem schließenden Tag, der die gesamte home-search-Liste beendet. -->
</searchList>
Suchlisteneinträge (Überschriften und Links) für die Startseite definieren
Sie definieren Suchlisteneinträge mit dem searchList Tag-Tag. Details finden Sie unter searchList Tag.
Das searchList Tag-Tag legt Folgendes fest:
- Den Text, der auf der Seite angezeigt wird. Dies legen Sie mit dem
label Tag-Tag fest. - Die Ziel-URL für den Link. Dies legen Sie mit dem
url Tag-Tag fest.
Das folgende Beispiel für die home-search-Deklaration erstellt den Link zum Suchformular für Personen:
Suchlisteneinträge definieren
<!-- Diese Zeile erstellt einen Link zum Suchformular für Personen. Normalerweise erscheint dies verschachtelt innerhalb des searchList Tag-Tags, das die Suchlistendeklaration startet. -->
<searchList>
<!-- Das label Tag-Tag gibt den Text an, der für den Link angezeigt wird -->
<label>Personen</label>
<!-- Das url Tag-Tag gibt die Zielseite für den Link an. -->
<url>$(PAGE_SERVER)/advanced-searches?defaultItemId=item5001&
usePersistence=false&proxyAccount=$(proxyAccount)</url>
</searchList> <!-- dies beendet diesen Suchlisteneintrag. -->
Sowohl Beschriftungen als auch Ziele für Links können Variablen des Application Server enthalten. Wenn der Web Client den Text anzeigt, werden diese Variablen durch ihre tatsächlichen Werte ersetzt. Da die Startseite keinen kontaktspezifischen Kontext hat, können Sie hier im Wesentlichen nur umgebungsbezogene Variablen wie userName verwenden.
Sie können Variablen sowohl im Namen der Beschriftung als auch im Ziel der URL verwenden. Details zur Verwendung von Variablen finden Sie unter Variablen für InterAction-Informationen verwenden.
Die Link-URL festlegen
Das Ziel eines Links, das mit dem url Tag-Tag angegeben wird, kann die Adresse einer anderen Web Client-Seite oder einer beliebigen anderen Webseite sein, die per Standard-HTTP-Anfrage erreichbar ist.
Wenn Sie auf eine Web Client-Seite verlinken, können Sie die Variable PAGE_SERVER anstelle des vollständigen Namens Ihres Application Server verwenden. Sie können auch Parameter an die Seite übergeben. Das folgende Beispiel ruft die Seite advanced-searches auf und übergibt drei Parameter:
defaultItemId=item5001
usePersistence=false
proxyAccount=$(proxyAccount)
Link-URL
$(PAGE_SERVER)/advanced-searches?defaultItemId=item5001&usePersistence=false&proxyAccount=$(proxyAccount)
Die Parameter sorgen dafür, dass die Kontakt-Suchseite direkt zur Personensuche wechselt. Details zur Ermittlung der URL einer Web Client-Seite finden Sie unter Web Client Seiten-URLs. Siehe auch Beispiel-URLs für Links auf der Startseite.
Beispiel-URLs für Links auf der Startseite
Die meisten Links, die Sie auf der Startseite hinzufügen, fallen in eine der folgenden fünf Kategorien.
Nicht-InterAction-Seiten
Sie können auf jede beliebige Internet- oder interne Intranet-Seite verlinken. Das Format der URL entnehmen Sie der Seite, auf die Sie verlinken möchten.
Web Client Suchformulare
Verwenden Sie das gleiche Format wie bei den Standardlinks im „Suchen nach“-Bereich, ersetzen Sie jedoch die ID durch die ID des Formulars, das Sie öffnen möchten:
$(PAGE_SERVER)/advanced-searches?defaultItemId=item5001&
usePersistence=false&proxyAccount=$(proxyAccount)
Ändern Sie zum Beispiel item5001 in item10013, damit der Link das Suchformular für Top-Kunden öffnet. Die ID eines Suchformulars finden Sie im Windows Client im Dialogfeld „Web Client Suchformulare verwalten“. Beachten Sie, dass ein Link nur Suchformulare öffnen kann, die in der oberen Navigation erscheinen.
Kontaktart-Listen
Jede Kontaktart in Ihrer Umgebung ist über die Seite „Kontaktarten-Liste“ verfügbar. Es kann jedoch sinnvoll sein, besonders wichtige Listen direkt auf der Startseite zu verlinken. Die folgende URL zeigt eine Liste von Kontakten an, denen die Kontaktart mit der ID 10 (die Standard-Kontaktart „Top-Kunden“) zugewiesen ist.
$(PAGE_SERVER)/InterAction/contact-search-results?isProfile=true&
searchDescription=Top Clients&profileId=10005&contactTypeId=10
Beachten Sie, dass der Teil profileId=8 ein Profil (das Mandantenprofil) angibt, das für den Übersichtsbereich verwendet wird. Die ID eines Profils finden Sie im Windows Client im Dialogfeld „Web Client Profile verwalten“.
Marketinglisten
Das Verlinken zu Marketinglisten-Seiten funktioniert ähnlich wie bei Kontaktarten. Die folgende URL zeigt eine Liste von Kontakten in der Holiday Card-Liste an. Sie müssen die ID des Ordners angeben.
$(PAGE_SERVER)/mailing-list-membership?searchDescription=Holiday+Card&
folderId=2/-10017&proxyAccount=
Teilbereiche von Listen
Suchformulare ermöglichen es Benutzern, eine Teilmenge von Kontakten innerhalb einer Liste zu finden, z. B. nur Mandanten, die bestimmte Kriterien erfüllen. Einige dieser Teilmengen sind möglicherweise so wichtig, dass sie als Link auf der Startseite erscheinen sollten. So sparen sich Benutzer die Eingabe der Suchkriterien. Beispielsweise könnten Sie einen Link einrichten, der die Liste der Mitarbeiter in einem bestimmten Büro anzeigt.
Der einfachste Weg, diese Art von URL zu bestimmen, besteht darin, die Suche im Web Client durchzuführen, dann die resultierende URL aus dem Browser zu kopieren und sie nach Bedarf anzupassen. Ein Beispiel finden Sie unter Abkürzung zum Bestimmen der URL für eine Web Client-Seite.
Web Client-Hilfethemen
Wenn es bestimmte Web Client-Hilfethemen gibt, die für Fachleute in Ihrer Organisation nützlich wären, können Sie Links dazu auf der Startseite hinzufügen. Einzelheiten zum Bestimmen der URL für ein Thema finden Sie unter Verlinken von Web Client-Hilfethemen.
Verlinken von Web Client-Hilfethemen
Der Web Client bietet ein Online-Hilfesystem, das häufige Fragen und Aufgaben behandelt. Die Startseite enthält eine Reihe von Links zu bestimmten Themen innerhalb des Hilfesystems.
Sie können Links zu weiteren Themen hinzufügen. Geben Sie für das url Tag folgende URL an (alles in einer Zeile):
Verlinken von Web Client-Hilfethemen
javascript:var remoteWin = IA_openWindow('$(HELP_URL)/TopicFilename.htm', '', 'height=550, width=700, location=no, menubar=no, resizable=yes, scrollbars=yes, status=no, titlebar=no, toolbar=no');
Ersetzen Sie TopicFilename.htm durch den tatsächlichen Dateinamen des Themas, auf das Sie verlinken möchten. Der übrige Code in der URL dient dazu, das Thema in einem Pop-up-Fenster anzuzeigen. Geben Sie die URL unbedingt genau wie gezeigt ein – am einfachsten ist es, die URL eines bestehenden Hilfethemen-Links zu kopieren.
Gehen Sie wie folgt vor, um den Dateinamen für ein bestimmtes Hilfethema zu ermitteln:
- Öffnen Sie die Hilfe und navigieren Sie zu dem Thema, auf das Sie verlinken möchten. Sie können den Hilfe-Link im Web Client-Seitenrahmen verwenden, um die Hilfe zu öffnen.
-
Wenn das gewünschte Thema im rechten Bereich des Hilfefensters angezeigt wird, klicken Sie mit der rechten Maustaste in das Thema und wählen Sie Eigenschaften.
-
Notieren Sie die Adresse (URL), die im Eigenschaften-Dialogfeld angezeigt wird. Sie sehen etwas wie das Folgende:
http://bailey/IA_HELP/ad1015791.htm
- Der Dateiname des Themas ist der Teil mit *.htm. Im obigen Beispiel lautet der Dateiname dieses Themas ad1015791.htm. Beachten Sie, dass nach dem Dateinamen ein Rautenzeichen (#) oder anderer zusätzlicher Text stehen kann; das können Sie ignorieren.
Eine Kopie der Standard-Suchergebnisliste zum Bearbeiten erstellen
Beachten Sie, dass Sie dieses Verfahren nur einmal durchführen müssen, bevor Sie irgendwelche Änderungen an einer bestimmten Suchliste vornehmen.
-
Suchen Sie auf Ihrem InterAction Application Server-Rechner das etc-Verzeichnis. Bei einer typischen Installation befindet sich dieses normalerweise hier:
C:\Program Files\LexisNexis\InterAction\AppServer\iahome\etc
- Öffnen Sie die Datei searchLists.xml in einem XML-Editor.
-
Suchen Sie die Zeilen, die die Deklaration der Suchliste beginnen, die Sie bearbeiten möchten. Eine Liste der verfügbaren Suchlisten finden Sie unter Startseiten-Suchdeklarationen. Der Name der Suchliste erscheint wie folgt:
<searchList id="home-search" template="searchList.xsl">
- Kopieren Sie den gesamten Block des XML-Codes für die Suchliste. Die Deklaration endet mit dem Tag <\searchList>. Beachten Sie, dass die Deklaration mehrere verschachtelte <searchList>-Tags enthalten kann. Achten Sie darauf, die gesamte Deklaration zu kopieren.
- Öffnen Sie die Datei localSearchLists.xml und fügen Sie die Menüdeklaration an einer beliebigen Stelle nach dem öffnenden
searchListDeclarations Tagein. - Aktualisieren Sie diese kopierte Version der Suchlistendeklaration mit Ihren Änderungen.