Dokumentation
Anleitung

Medien suchen und Ergebnisse seitenweise lesen

Suchfelder, AND/OR, Wortsuche und Seitennavigation mit search und fastsearch verwenden.

Auf dieser Seite

Mit search finden Sie Medien im freigeschalteten Kontext. Der Befehl benötigt die Funktionsfreigabe search; für fastsearch ist eine eigene Freigabe erforderlich. Die Beispiele beschreiben den regulären Suchhandler, nicht kundenspezifische Erweiterungen.

Erste Suche

<search fields="titel,text,typ" limit="0,50">
  <condition field="text_fields" operator="AND">Wasser Kreislauf</condition>
</search>

fields enthält die gewünschten Ergebnisfelder ohne fn_-Präfix. text_fields durchsucht mehrere Textfelder; titel_fields umfasst Titel, Untertitel und Serientitel. Ein einzelnes Feld wie titel beschränkt die Suche entsprechend.

Schematische Antwort; Identifier und Inhalte sind erfunden:

<result>
  <r identifier="anbieter-12345">
    <f n="licence">2026-12-31</f>
    <f n="titel">Der Wasserkreislauf</f>
    <f n="text">Verdunstung und Niederschlag.</f>
    <f n="typ">55</f>
  </r>
</result>

Ein leeres <result/> ist eine gültige Antwort ohne Treffer. Nicht jedes angeforderte Feld wird ausgegeben: Leere Werte können fehlen. Zusätzlich können Felder wie licence vorkommen. Werten Sie Felder nach ihrem Namen aus, nicht nach Position.

Im regulären Suchhandler enthält licence das ermittelte Lizenzende, nicht den Kontext. Das Feld ersetzt keine aktuelle Prüfung der Abspielberechtigung.

Suchbegriffe verbinden

operator="AND" verlangt die Begriffe gemeinsam, operator="OR" erlaubt Alternativen innerhalb einer Bedingung. Ohne Operator verwendet der reguläre Handler OR. Setzen Sie ihn deshalb ausdrücklich.

Mehrere Bedingungen werden standardmäßig mit UND verbunden:

<search fields="titel,prodjahr" limit="0,50">
  <condition field="titel_fields" operator="OR">Wasser Klima</condition>
  <condition field="prodjahr" operator="AND">2024</condition>
</search>

Hier muss der Titelbereich „Wasser“ oder „Klima“ enthalten; zusätzlich muss das Produktionsjahr auf „2024“ passen. Ohne option arbeitet die normale Suche mit enthaltenen Zeichenfolgen. Sie ist damit keine typisierte Jahres- oder Zahlenprüfung.

Wörter und Wortanfänge

WORD und BEGIN verwenden Volltextsuche. Stimmen Sie die nutzbaren Suchfelder und Suchmodi mit uns ab. Eine Antwort mit dem Text SQL ERROR ist ein Fehler und darf nicht als leere Trefferliste verarbeitet werden.

Eine Anfrage mit WORD lautet beispielsweise:

<search fields="titel" limit="0,50">
  <condition field="text_fields" operator="AND" option="WORD">Wasser Kreislauf</condition>
</search>

WORD verwendet die Volltextsuche. BEGIN verwendet die Volltextsuche mit Wortanfängen, beispielsweise Wasser auch als Beginn eines längeren Wortes. Der reguläre Handler berücksichtigt in diesen beiden Modi nur Suchteile mit mehr als zwei Bytes. Weitere Grenzen entstehen durch den Datenbankindex, etwa Stoppwörter und Mindestwortlängen. Kurze Begriffe deshalb nicht als zuverlässigen Test der Wortsuche verwenden.

Die alte Dokumentation beschreibt Anführungszeichen als Phrasensuche. Im regulären Handler werden äußere Anführungszeichen jedoch vor dem Volltextaufruf entfernt. Eine exakte Wortfolge ist dadurch nicht verlässlich zugesichert. Übernehmen Sie dieses alte Beispiel nicht als Vertrag für eine exakte Phrasensuche.

Seitenweise lesen

Attributwert Bedeutung
limit="50" höchstens 50 Treffer ab Anfang
limit="0,50" erste 50 Treffer
limit="50,50" 50 überspringen, höchstens 50 liefern
limit="100,200" 100 überspringen, höchstens 200 liefern
nicht angegeben Standard 0,1000

Der reguläre search-Handler liefert kein resume-Attribut. Für eine einfache interne Suche lesen Sie weiter, bis eine Seite weniger als die angeforderte Anzahl Datensätze enthält. Ist die letzte Seite genau voll, folgt noch ein Abruf, der leer sein kann.

Die Standardsortierung erfolgt nach Titel. Gleiche Titel und Änderungen am Bestand können beim Blättern zu Wiederholungen oder Verschiebungen führen. Identifier zur Duplikaterkennung verwenden. Stimmen Sie für einen vollständigen Export eine stabile Sortierung und ein geeignetes Exportverfahren mit uns ab. Ein Suchdurchlauf ist kein Datenbanksnapshot.

Parameterübersicht

Attribut Verwendung
fields Ergebnisfelder, durch Komma getrennt; ausdrücklich setzen
fields="*" Felder nach Auswahlregeln des Handlers; kein stabiler öffentlicher Feldvertrag
limit nichtnegative Ganzzahlen für Offset und Anzahl
order nur mit uns vereinbarte Sortierung
role vereinbarte Rolle, Standard L
count="1" Trefferanzahl als Textzahl statt XML
remote und searchtext abgestimmte externe Suchquellen
intern="0" interne Suche abschalten; nur für entsprechend eingerichtete externe Suche

Bei Remote-Suchen ist die lokale Seitennavigation nicht automatisch auf die zusammengeführten Ergebnisse übertragbar. Interne Attribute für Tabellen, SQL, Debugging oder Ergebnisfunktionen gehören nicht in gewöhnliche Clientrequests.

fastsearch getrennt testen

<fastsearch fields="titel,text,typ" limit="0,50">
  <condition field="text_fields" operator="AND">Wasser Kreislauf</condition>
</fastsearch>

fastsearch verwendet ebenfalls result, r und f, besitzt aber eine eigene Implementierung. Ein Wechsel kann Treffer, Sortierung und Begrenzung verändern. Verwenden Sie den für Ihren Zugang vereinbarten Befehl; ersetzen Sie search nicht ungeprüft. Spezielle KI-Suchen und Relevanzfunktionen sind nicht Teil dieser Basisanleitung.

Hinweis zum Go-Client

Die Methode Search verwendet standardmäßig option="WORD". Sie ist damit nicht identisch mit dem Basisbeispiel ohne option. Die Methode enthält außerdem zusätzliche Suchvorgaben. Prüfen Sie deshalb die tatsächlich gesendete Anfrage, bevor Sie Ergebnisse des Go-Clients mit dem Basisbeispiel vergleichen.

Zur Übersicht: Einstieg in die ARIX-Schnittstelle