Definiert entweder eine neue Suchliste oder ein neues Element in einer Suchliste. Wenn ein Wert für das Attribut id angegeben wird, erhält die Liste einen Namen, auf den in anderen Deklarationen verwiesen werden kann.
Im folgenden Codebeispiel ist das id-Attribut des ersten <searchList>-Tags auf home-search gesetzt. Damit wird eine neue Suchliste mit dieser ID gestartet. Die nachfolgenden <searchList>-Tags setzen das id-Attribut nicht, sie definieren also neue Einträge in der Liste.
Eine Suchliste starten und Einträge definieren – XML-Beispiel
<!-- Diese Zeile startet die Deklaration der Suchliste „home-search“. Damit wird die Gruppe von Links definiert, die unter der Überschrift „Suchen nach...“ auf der Startseite angezeigt werden. Das id-Attribut gibt den Namen der Suchliste an, auf die in anderen Deklarationen verwiesen werden kann. -->
<searchList id="home-search" template="searchList.xsl">
<!-- Dieses Tag definiert das erste Element der Liste – einen Link zum Suchformular für Personen. -->
<searchList>
<label labelClass="squarebullettext"><li> Personen</label>
<url>$(PAGE_SERVER)/advanced-searches?defaultItemId=item5001&
usePersistence=false&proxyAccount=$(proxyAccount)</url>
</searchList>
... <!-- Weitere Suchlisteneinträge würden hier vor dem schließenden Tag stehen, das die gesamte home-search-Liste beendet. -->
</searchList>
Dieses Element kann die folgenden Elemente enthalten:
| Element | Beschreibung |
|---|---|
| column-Tag | Definiert eine Spalte, die Suchlisteneinträge enthält. Eine Suchliste kann Links in mehreren Spalten anzeigen. |
| label-Tag | Legt den Text fest, der im Suchlisteneintrag angezeigt wird. Steuert außerdem die Anzeigeeigenschaften über die in den Web Client-Stylesheets definierten CSS-Klassen. |
| description-Tag | Gibt eine Beschreibung des Suchlisteneintrags an. |
| url-Tag | Legt das Ziel des Links im Suchlisteneintrag fest. Wenn für einen Suchlisteneintrag keine URL angegeben ist, wird er als Textlabel und nicht als Link angezeigt. |
| searchList-Tag | Definiert ein Element innerhalb der Suchliste. Dieses Element kann entweder Links oder Überschriften erzeugen. |
Attribute
Das <searchList>-Element hat die folgenden Attribute:
Attribute für <searchList>
| Attribut | Beschreibung | Mögliche Werte |
|---|---|---|
| id | Definiert einen Namen für die Suchliste. Wenn dieses Attribut für das Element angegeben ist, kann auf die Liste in anderen Deklarationen verwiesen werden. | Beliebiger Textname. Keine Leerzeichen im Namen verwenden. |
| template | ||
| show | Legt fest, ob der Suchlisteneintrag angezeigt werden soll oder nicht. In der Regel wird hierfür eine Variable verwendet, die auf True oder False aufgelöst wird.
| True – das Element wird angezeigt. False – das Element wird nicht angezeigt. |