In diesem Abschnitt werden XML-Konstrukte und Operationen behandelt, bei denen es im weitesten Sinne um das Thema "Katalogabgleich" geht. Es ist zu erwarten, dass hier in zukünftigen Versionen noch Ergänzungen vorgenommen werden.
Zur Volltextsuche über Artikelnummer und Artikelbezeichnung muss ein veloconnect-konformer Server die Transaktion TextSearch implementieren. Diese Transaktion kennt folgende Zustände:
und kennt zwei Operationen:
Die einzelnen Operationen sind wie folgt definiert:
Die Anfrage ist ein Element vom Typ vcc:CreateTextSearchRequest, das den Typ vct:RequestType um das Element vcc:SearchString vom Typ udt:TextType erweitert. Antwort ist ein Element vom Typ vcc:CreateTextSearchResponse, welches den Typ vct:TransactionResponseType, um das Element vcc:TotalCount vom Typ xsd:integer erweitert.
Regel: CreateTextSearch. Ein veloconnect-konformer Server erzeugt für jede Anfrage CreateTextSearch einen eigenen Transaktionskontext. Der in vcc:SearchString übergebene Text wird in Teilworte (Trennzeichen ist das Leerzeichen) zerlegt. Es werden alle Artikel ermittelt, bei denen jedes der Teilworte innerhalb von Artikelnummer oder Artikelbezeichnung oder - sofern vorhanden - EAN-Code vorkommt (als Teilzeichenkette). Insbesondere heisst dies, dass bei leerem SearchString alle Artikel ermittelt werden. Die Anzahl der gefundenen Artikel wird über das Element vcc:TotalCount mitgeteilt, die Liste der gefundenen Artikel im Transaktionskontext gespeichert. Falls diese Anzahl 0 ist, findet ein Übergang zum Endzustand 100 statt, ansonsten zum Zustand 2, und es wird jeweils die Antwort in vcc:CreateTextSearchResponse mit ResponseCode 200 zurückgeliefert.
Die Anfrage ist ein Element vom Typ vcc:SearchResultRequest, das den Typ vct:TransactionRequestType um die folgenden Elemente erweitert:
Tabelle 17. vcc:SearchResultRequest - Elemente
Name | Typ/Vorkommen | Beschreibung |
---|---|---|
StartIndex | xsd:integer | Index des ersten Artikels, der übertragen werden soll (0-basiert) |
Count | xsd:integer | Anzahl der Artikel |
ResultFormat | vcc:ResultFormatType | Format der Suchergebnisse |
DoNotClose | xsd:boolean? | Flag, um das automatische Beenden der Transaktion bei Rückgabe des letzten Artikels zu verhindern |
Die Antwort ist ein Element vcc:SearchResultResponse, welches den Typ vct:TransactionResponseType, wie folgt erweitert:
Tabelle 18. vcc:SearchResultResponse - Elemente
Name | Typ/Vorkommen | Beschreibung |
---|---|---|
StartIndex | xsd:integer | Index des ersten Artikels, der übermittelt wird (0-basiert) |
Count | xsd:integer | Anzahl der Artikel, die übermittelt werden |
ResultFormat | vcc:ResultFormatType | Format der Suchergebnisse |
cac:Item | * | Artikelstammdaten |
vco:ItemDetail | * | Artikelstammdaten und Verfügbarkeit |
cac:SellersItemIdentifcation | * | Artikelnummer |