Über den Parameter #SEARCH .. #ENDSEARCH kann innerhalb eines Templates eine Suche spezifiziert werden. Innerhalb eines #SEARCH-Blockes werden zur Definition der Suche eine Anzahl Suchparameter verwendet.
Wichtig ist, jedem Suchblock ein eindeutige ID (search_id) zuzuweisen. Mit Hilfe dieser Such-ID kann dann die Liste der Suchergebnisse dargestellt werden.
Hinweis: Alternativ zu dieser Möglichkeit kann eine Suche auch über die Angabe der Suchparameter in der URL einer Seite direkt gestartet werden. Nachteil dabei ist jedoch, dass man innerhalb der dann ausgegebenen Seite nur eine Suchergebnisliste darstellen kann.
Die möglichen Suchparameter werden unterhalb dieses Textes aufgezählt und erläutert.
Beispiel 1:
Attribut | Wert | Beschreibung |
---|---|---|
search_id="[1]"
|
[1]:
Such-Id
|
Eindeutige Such-ID. |
search_varname[1]="[2]"
|
[1]:
fortlaufende Nummer
[2]: Variablenname |
Angabe des Variablennamens ohne #INSERT_EL_VAR_! bzw. #INSERT_OR_VAR_! |
search_vartyp[1]="[2]"
|
[1]:
fortlaufende Nummer
[2]: Typ der Variable |
Dieser Parameter beinhaltet den Typ der in search_varname#### festgelegten Variable. Die #### indizieren, um welche Suchvariable es sich handelt und müssen mit der Zahl in search_varname#### übereinstimmen. Sie werden mit 0001 beginnend, aufwärts zählend für jede weitere Suchvariable dieser Suche ersetzt. Der Parameter wird in einem numerischen Code erfaßt. Dabei stehen
Hinweis: Soll eine Liste von Ordner-Variablen nach einem Suchbegriff durchsucht werden, muß hier lediglich der Obertyp (100 oder 200) angegeben werden. |
search_varmin[1]="[2]"
|
[1]:
fortlaufende Nummer
[2]: Mindestwert |
An dieser Stelle gibt der Nutzer den Mindestwert für die zu suchende Ordner-Variable ein. Soll eine Textsuche erfolgen, so beinhaltet der Parameter den vom Nutzer eingegebenen Term. #### kennzeichnet die Suchvariable mit Hilfe der Ziffernfolge, die in search_varname#### festgelegt wurde (0001 für die erste Suchvariable, ganzzahlig aufsteigend für jede weitere Suchvariable). |
search_stop="[1]"
|
[1]:
ID
|
Dieser Parameter dient zur Angabe von Ordner-IDs, bei denen die Suche abgebrochen werden soll. Dieser Ordner sowie darunter befindliche Ordner bzw. Elemente werden nicht durchsucht. |
search_ordner="[1]"
|
[1]:
ID
|
Sie können an dieser Stelle festlegen, in welchem Ordner die Suche beginnen soll. Es werden alle Ordner bzw. Elemente durchsucht, die sich unter diesem Wurzelordner befinden. Dazu wird die ID des zu durchsuchenden Startordners übergeben. Fehlt in einer Suchanfrage die Angabe "search_ordner", beginnt die Suche beim Hauptordner (Ordner 1), d.h. alle Ordner bzw. Elemente werden durchsucht. |
search_use1st="[1]"
|
[1]:
ID
|
In diesem Parameter können Sie angeben, ob der in search_ordner spezifizierte Ordner in die Suche mit einbezogen werden soll. Dieser Parameter erlaubt die Angaben "0" und "1", wobei "1" für den Einbezug des angegebenen Wurzelordners steht. Bei der Eingabe des Wertes "0" startet die Suche eine Ebene unterhalb desentsprechenden Wurzelordners. Standardwert von search_use1st ist "1". Wenn die Suche im Ordner 1 startet und dieser ebenfalls durchsucht werden soll muss "search_use1st" mit dem Wert "1" angegeben werden. |
search_max="[1]"
|
[1]:
Zahl
|
Geben Sie die maximal zulässige Trefferzahl an. Wird search_max erreicht, so bricht die Suche automatisch ab und es werden keine weiteren Suchergebnisse gefunden. |
search_exact="[1]"
|
[1]:
1 | 0
|
Dieser Parameter spezifiziert, ob nur nach genauen Begriffsübereinstimmungen in den Elementen gesucht werden soll, oder ob auch unvollständige Suchbegriffe einen Treffer erzielen können. |
search_sortvar[1]="[2]"
|
[1]:
Sortierung nach Elementevariable
[2]: Variablenname |
Die Sortiervariablen 1 und 2 bestimmen die Variablen, nach denen sortiert werden soll. Dabei besitzt search_sortvar1 den Vorrang zu search_sortvar2. Soll nach Elementnamen sortiert werden, ist die Angabe "_na" erforderlich. Geben Sie den Variablennamen ohne #INSERT_EL_VAR_! an, z.B. "de_text". Verbinden Sie diese Angabe mit den Parametern der Sortierrichtung, search_sorttyp1 und search_sorttyp2, um die Suchergebnisliste übersichtlich darzustellen. |
search_grsortvar[1]="[2]"
|
[1]:
Sortierung nach Ordnervariable
[2]: Variablenname |
Die Sortiervariablen 1 und 2 bestimmen die Variablen, nach denen sortiert werden soll. Dabei besitzt search_sortvar1 den Vorrang zu search_sortvar2. Soll nach Elementnamen sortiert werden, ist die Angabe "_na" erforderlich. Geben Sie den Variablennamen ohne #INSERT_OR_VAR_! an, z.B. "de_text". Verbinden Sie diese Angabe mit den Parametern der Sortierrichtung, search_sorttyp1 und search_sorttyp2, um die Suchergebnisliste übersichtlich darzustellen. |
search_sorttyp[1]="[2]"
|
[1]:
Sortierrichtung für Elementevariable festlegen
[2]: 1 | 0 |
In Zusammenhang mit den Angaben zu den Variablen, nach denen ein Suchergebnis sortiert werden soll (search_sortvar1 und search_sortvar2), gibt dieser Parameter die Art der Sortierung an. Achten Sie darauf, das search_sorttyp1 search_sortvar1 zugeordnet ist bzw. search_sorttyp2 search_sortvar2 zugeordnet ist. |
search_grsorttyp[1]="[2]"
|
[1]:
Sortierrichtung für Ordnervariable festlegen
[2]: 1 | 0 |
In Zusammenhang mit den Angaben zu den Variablen, nach denen ein Suchergebnis sortiert werden soll (search_sortvar1 und search_sortvar2), gibt dieser Parameter die Art der Sortierung an. Achten Sie darauf, das search_sorttyp1 search_sortvar1 zugeordnet ist bzw. search_sorttyp2 search_sortvar2 zugeordnet ist. |
search_start="[1]"
|
[1]:
Zahl
|
Dieser Parameter dient zur Angabe des Elementes oder Ordners (Nummer des Suchergebnisses), mit dem die Suchergebnissliste beginnen sollen. In Verbindung mit dem Parameter search_block ist dies eine gute Möglichkeit die Anzahl der mit einmal anzuzeigenden Suchergebnisse zu beschränken bzw. ein "blättern" in den Suchergebnissen zu ermöglichen.. |
search_block="[1]"
|
[1]:
Zahl
|
Der Parameter search_block bestimmt die Anzahl der anzuzeigenden Suchergebnisse auf einer Seite. Er ist sehr wichtig, um die Übersichtlichkeit der Suchergebnisdarstellung zu wahren. |
search_hidden="[1]"
|
[1]:
|
Der Parameter search_hidden bestimmt, ob für das Internet nicht freigegebene Ordner durchsucht werden sollen. Im Standardfall werden versteckte Ordner, d.h. Ordner welche nicht im Internet veröffentlicht werden sollen, nicht durchsucht. In diesem Fall werden weder untergeordnete Ordner noch untergeordnete Elemente gefunden - auch wenn diese für das Internet freigegeben sind. |
search_grvarmax[1]="[2]"
|
[1]:
Maximalwert der Ordnersuche
[2]: |
An dieser Stelle gibt der Nutzer den Maximalwert der zu suchenden Ordner-Variable ein. #### kennzeichnet die Suchvariable mit Hilfe der Ziffernfolge, die in search_grvarname#### festgelegt wurde (0001 für die erste Suchvariable, ganzzahlig aufsteigend für jede weitere Suchvariable). Dieser Parameter dient in Verbindung mit search_grvarmin#### zur Suche nach Intergerwerten der Form von ... bis ... (siehe auch search_grvarmin#### für den Minimalwert). Bei einer Textsuche ist die Angabe dieses Parameters nicht nötig. |
search_grvarmin[1]="[2]"
|
[1]:
Minimalwert der Ordnersuche
[2]: |
An dieser Stelle gibt der Nutzer den Mindestwert für die zu suchende Ordner-Variable ein. Soll eine Textsuche erfolgen, so beinhaltet der Parameter den vom Nutzer eingegebenen Term. #### kennzeichnet die Suchvariable mit Hilfe der Ziffernfolge, die in search_grvarname#### festgelegt wurde (0001 für die erste Suchvariable, ganzzahlig aufsteigend für jede weitere Suchvariable). |
search_grvarmulti[1]="[2]"
|
[1]:
mehrere Begriffe gleichzeitig suchen
[2]: 0 | 1 | 2 |
In diesem Parameter legen Sie fest, ob nach mehreren Suchbegriffen gleichzeitig gesucht werden darf. Soll dies möglich sein, so besteht der Suchtext (search_grvarmin####) aus einer mit Komma getrennten Liste von Suchbegriffen. Ein Ordner wird gefunden, wenn er mindestens einen der Suchbegriffe enthält (Oder-Verknüpfung) bzw. alle Suchbegriffe enthält (UND-Verknüpfung).
Um die Suchvariable zu identifizieren, für die diese Angabe gelten soll, ist es notwendig die #### durch die entsprechenden Kennziffern der Suchvariable (0001, 0002, ...) zu ersetzen. |
search_grvarbegin[1]="[2]"
|
[1]:
Lage des Suchbegriffs im Wort
[2]: 0 | 1 |
An dieser Stelle wird über die Position des Suchbegriffes im Ordner-Eintrag entschieden. Sie können bestimmen, ob der Suchbegriff am Anfang des Ordner-Variableninhaltes stehen muß oder auch innerhalb des Ordner-Variableninhaltes auftreten kann.
Bitte ersetzen Sie die #### im Parameternamen mit der vierstelligen Nummer der Suchvariable, die in search_grvarname#### festgelegt wurde (aufsteigend eine Nummer für jede Suchvariable, beginnend mit 0001). |
search_grarexact[1]="[2]"
|
[1]:
nach exaktem Begriff suchen
[2]: |
Dieser Parameter entscheidet über eine exakte Suche in den Ordnern. Soll der Suchbegriff genau mit dem Datenbankeintrag übereinstimmen, geben Sie bitte den Wert "1" an. Ist auch ein unvollständiger Suchbegriff zulässig, so geben Sie bitte "0" an. |
search_grvarcsense[1]="[2]"
|
[1]:
Groß-/Kleinschreibung für Ordnervariable beachten
[2]: |
Sie können festlegen, ob die Groß-/Kleinschreibung für die Ordner-Variable beachtet werden soll:
Die #### sind Platzhalter für die anzugebende vierstellige Suchvariablennummer (beginnenend bei 0001), für dessen Suchvariable dieser Parameter gilt. |
search_grvarquantor[1]="[2]"
|
[1]:
Ein- oder Ausschluß des Suchparameters
[2]: 0 | 1 |
Wichtig für die Angabe, ob der Suchparameter in der Ordner-Variablen gefunden werden oder nicht vorhanden sein soll, ist dieser Parameter. Ersetzen Sie die #### durch die Nummer der entsprechenden Suchvariablen (beginnend mit 0001 für die erste Suchvariable, 0002 für die zweite, usw.) und geben Sie einen möglichen Wert (0|1) für diesen Parameter ein. Diese beiden Wertangaben bedeuten.
|
search_grvartyp[1]="[2]"
|
[1]:
Angabe des Typs der zu durchsuchenden Ordner-Variable
[2]: Wert |
Dieser Parameter beinhaltet den Typ der in search_grvarname#### festgelegten Variable. Die #### indizieren, um welche Suchvariable es sich handelt und müssen mit der Zahl in search_grvarname#### übereinstimmen. Sie werden mit 0001 beginnend, aufwärts zählend für jede weitere Suchvariable dieser Suche ersetzt. Der Parameter wird in einem numerischen Code erfaßt. Dabei stehen
Hinweis: Soll eine Liste von Ordner-Variablen nach einem Suchbegriff durchsucht werden, muß hier lediglich der Obertyp (100 oder 200) angegeben werden. |
search_grvarname[1]="[2]"
|
[1]:
zu durchsuchender Ordner-Variablenname
[2]: |
Geben Sie im value-Teil der Anweisung den zu durchsuchenden Ordner-Variablennamen oder eine mit Komma getrennte Liste von Ordner-Variablennamen an, welche nach dem Suchbegriff durchsucht werden sollen. Im letzten Fall muß der Suchbegriff lediglich in einer der Ordner-Variablen vorhanden sein. Wird nach Ordnern gesucht, so geben Sie value="_na" an. Die #### werden, beginnend mit 0001, aufsteigend durch Zahlen ersetzt, um verschiedene Suchvariablen innerhalb einer Suche mit ihren Eigenschaften voneinander abzugrenzen. Für jede neue Suchvariable, nach der gesucht werden soll, wird eine neue Nummer vergeben. Sie müssen bei allen Suchparametern, die zu einer Suchvariable gehören, deren Nummer an der Stelle der #### angegeben. |
search_grexact
|
Dieser Parameter spezifiziert, ob nur nach genauen Begriffsübereinstimmungen in den Ordnern gesucht werden soll, oder ob auch unvollständige Suchbegriffe einen Treffer erzielen können. |
|
search_grname="[1]"
|
[1]:
Name
|
Sie können in diesem Parameter den Ordner angeben, nach dem gesucht werden soll. Bei einer Angabe mit dem Paramater search_grvarname#### entspricht dies der Bezeichnung _na (z.B. search_grvarname####=_na). |
search_name="[1]"
|
[1]:
Name
|
Sie können in diesem Parameter den Namen eines Elementes angeben, nach dem gesucht werden soll. Bei einer Angabe mit dem Paramater search_varname#### entspricht dies der Bezeichnung _na (z.B. search_varname####=_na). |
search_varcsense[1]="[2]"
|
[1]:
Groß-/Kleinschreibung
[2]: 0 | 1 |
Sie können festlegen, ob die Groß-/Kleinschreibung für die Variable beachtet werden soll:
Die #### sind Platzhalter für die anzugebende vierstellige Suchvariablennummer (beginnenend bei 0001), für dessen Suchvariable dieser Parameter gilt. |
search_varmax[1]="[2]"
|
[1]:
Maximalwert
[2]: Wert |
An dieser Stelle gibt der Nutzer den Maximalwert der zu suchenden Variable ein. #### kennzeichnet die Suchvariable mit Hilfe der Ziffernfolge, die in search_varname#### festgelegt wurde (0001 für die erste Suchvariable, ganzzahlig aufsteigend für jede weitere Suchvariable). Dieser Parameter dient in Verbindung mit search_varmin#### zur Suche nach Intergerwerten der Form von ... bis ... (siehe auch search_varmin#### für den Minimalwert). Bei einer Textsuche ist die Angabe dieses Parameters nicht nötig. |
search_varmulti[1]="[2]"
|
[1]:
Suche nach mehreren Begriffen
[2]: 0 | 1 | 2 |
In diesem Parameter legen Sie fest, ob nach mehreren Suchbegriffen gleichzeitig gesucht werden darf. Soll dies möglich sein, so besteht der Suchtext (search_varmin####) aus einer mit Komma getrennten Liste von Suchbegriffen. Ein Element wird gefunden, wenn es mindestens einen der Suchbegriffe enthält (Oder-Verknüpfung) bzw. alle Suchbegriffe enthält (UND-Verknüpfung).
Um die Suchvariable zu identifizieren, für die diese Angabe gelten soll, ist es notwendig die #### durch die entsprechenden Kennziffern der Suchvariable (0001, 0002, ...) zu ersetzen. |
search_varbegin[1]="[2]"
|
[1]:
Lage des Suchbegriffs im Wort
[2]: |
An dieser Stelle wird über die Position des Suchbegriffes im Eintrag entschieden. Sie können bestimmen, ob der Suchbegriff am Anfang des Variableninhaltes stehen muß oder auch innerhalb des Variableninhaltes auftreten kann.
Bitte ersetzen Sie die #### im Parameternamen mit der vierstelligen Nummer der Suchvariable, die in search_varname#### festgelegt wurde (aufsteigend eine Nummer für jede Suchvariable, beginnend mit 0001). |
search_varexact[1]="[2]"
|
[1]:
exakte Suche
[2]: 0 | 1 |
Dieser Parameter entscheidet über eine exakte Suche. Soll der Suchbegriff genau mit dem Datenbankeintrag übereinstimmen, geben Sie bitte den Wert "1" an. Ist auch ein unvollständiger Suchbegriff zulässig, so geben Sie bitte "0" an. |
search_varquantor[1]="[2]"
|
[1]:
Ein- und Ausschluss des Suchparameters
[2]: 0 | 1 |
Wichtig für die Angabe, ob der Suchparameter in der Variablen gefunden werden oder nicht vorhanden sein soll, ist dieser Parameter. Ersetzen Sie die #### durch die Nummer der entsprechenden Suchvariablen (beginnend mit 0001 für die erste Suchvariable, 0002 für die zweite, usw.) und geben Sie einen möglichen Wert (0|1) für diesen Parameter ein. Diese beiden Wertangaben bedeuten.
|
Tipps & Tricks * Trends * Hilfen * Unterlagen * KnowHow * Vorlagen * Downloads * Neues