IWS/Dokumentation/Syntax für Suche

Aus ITscope GmbH - Wissensbasis

1 Einführung

Die ITscope Suchfunktion basiert auf mehreren leistungsfähigen Indizes und einer intelligenten Anfrageanalyse. In jeder Suchanfrage können unterschiedlichste Kriterien einfach miteinander kombiniert werden. Ein Suchtext kann dabei durch die Suchanalyse automatisch auf die verschiedenen Indizes verteilt werden. Alternativ - insbesondere bei der Verwendung des Such-Web-Services - kann jedem Suchwort ein Präfix vorangestellt werden, das den Suchindex festlegt. Bei einigen Präfixes ist anstelle eines Wortes die ID direkt anzugeben (dies wird in Zukunft erweitert).

Folgende Suchmöglichkeiten bestehen:

¹ Hinweis: Der Hst.Nr.-Index kann auch Teile des Produktbezeichners enthalten.

2 Besonderheiten

Eine Suchanfrage besteht aus mehreren durch Leerzeichen getrennten Termen. Falls innerhalb des Suchterms Leerzeichen verwendet werden sollen muß dieser in Anführungszeichen eingeschlossen (einfache oder doppelte möglich) oder - anhand nachfolgend beschriebener Syntax - in Klammern gesetzt werden.

Die Suche nach den durch Leerzeichen getrennten Termen wird dann als "UND" - Suche ausgeführt: Es werden nur Produkte zurückgeliefert, die im Index jedes Terms gefunden werden. Terme, die auf kein Produkt in der Datenbank zutreffen, werden vom Suchsystem ignoriert.

"ODER"-Suchen sind durch Klammerung möglich und gelten als Term einer UND-Suche: (acer,asus) notebook 17".

Suchtexte, die Zahlen und Buchstaben enthalten, durchlaufen eine spezielle Optimierung, sodass Hersteller-Artikelnummern u.ä. Bezeichner schnellstmöglich gefunden werden. Des Weiteren werden bei solchen Suchtexten auch beliebige Wortbestandteile gefunden.

Beispiel: Eine Suche nach 47b001 findet sowohl 1147B001AA als auch 1247B001AA

Hingegen findet eine Suche nach Befestigung nur Produkte in denen das Wort vollständig enthalten ist, Befestigung* findet auch Befestigungskit, -platte uvm.

Die Reihenfolge der Suchwörter wird nur beachtet, wenn diese in Anführungszeichen eingeschlossen sind: "Digital Ixus 65" findet nur exakte Treffer (Digitalkameras), Digital Ixus 65 auch ähnliche oder Zubehörprodukte.

3 Reihenfolge der Auto-Erkennung

Der Suchtext wird per Standardeinstellung automatisch erkannt. Dies geschieht nach folgender Reihenfolge:

• ITscope PUID: einzelne Zahl, die einer gültigen PUID entspricht, d.h. eine Zahl mit mindestens 9 Stellen. Werden Zahlen mit weniger als 9 Stellen gesucht, muss der Zusatz "puid:" vor die Nummer gestellt werden.
• EAN: einzelne Zahl ab 11 Stellen
• HST-Erkennung: nur ausgewählte unzweideutige Hersteller. Beispiel: die Suche nach "Microsoft Windows Vista"; Im Volltextmodus werden auch Notebooks etc. zurückgeliefert. Bei der automatischen Erkennung nur die Produkte von Microsoft.
• SET-Erkennung: nur ausgewählte Sets.
• Herstellernummern / Distributor-Artikelnummern: Suchbegriffe, die Zahlen enthalten und nur aus einem einzigen Wort ohne Leerzeichen bestehen, werden zunächst ausschließlich im Hersteller/Distributionsnummern-Index gesucht. Nur wenn dort nichts gefunden wird, wird eine Volltextsuche durchgeführt
• Volltextsuche: Durchsucht zusätzlich zum Herstellernummern-Index sämtliche Beschreibungen aller Distributoren.

4 Ausschluss-Suche (BETA)

Seit Juni 2011 besteht die Möglichkeit, Suchterme bei der Suche explizit auszuschließen, sodass entsprechende Produkte aus dem Suchergebnis entfernt werden. Das Feature ist derzeit noch experimentell / in der BETA-Phase und wird GUI-seitig (d.h. im MarketViewer) nicht gesondert unterstützt.

4.1 Syntax

• Jedem Suchterm kann ein '-' vorangestellt werden
• Die Ergebnisse sämtlicher Ausschlußterme einer Suche werden in einer ODER Verknüpfung gesammelt, und anschließend vom Endergebnis abgezogen
• Innerhalb eines Suchterms ist keine Kombination von Ausschluß- und Einschlußtermen möglich (Beispiel: vt:abcd,-efgh ist nicht erlaubt/unsinnig)
• Bei Verwendung von Präfixen ist das '-' vor dem Präfix zu verwenden (z.B. -hstid:23 statt hstid:-23)

4.2 Beispiele

• Finde alle Cherry Cordless Desktop außer den Serien evolution/Pure

 cherry cordless desktop -evolution,pure

• Find alle Cordless Desktops mit Ausnahme des Herstellers Cherry

 cordless desktop -hstid:210

• Alle Transcend Flash Disks ab 8 GB

 pgid:449641 hstid:1201 -ek114010200:(0-7516192768)

• Ausschluß einzelner Produkte aus einem Suchergebnis

 ipod nano 16gb -puid:1723860000,1251900000

5 Suchsteuerung durch Flags

Einige Präfixe dienen als Flag, um Suchfeatures zu steuern:

• modus:<Zahl> - Suchmodus (analog zur MarketViewer-Einstellung)
  • 1: Eingabe automatisch erkennen
  • 2:Volltextsuche
  • 3:Nur Hersteller-Artikelnummern
  • 4:Nur Lieferanten-Artikelnummern
  • 5:Nur EAN/UPC suchen

• old:1 - auch alte Produkte suchen

6 Beispiele

Suche alle Produkte des Hersteller Sanyo (1018)

SOAP

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://www.itscope.de/IWS/2006-04-20">
   <soapenv:Header/>
   <soapenv:Body>
      <ns:catalogueRequest resultsPerPage="700" maxResults="1000" page="1">
         <ns:requestHeader>
           <ns:customerAuthentication>
               <ns:iwsKey><IhrWebserviceKey></ns:iwsKey>
           </ns:customerAuthentication>
         </ns:requestHeader>
         <ns:extendedResult>false</ns:extendedResult>
         <ns:qual>0 1 2 3</ns:qual>
 	 <ns:searchRequest>
            <ns:search>
              <ns:scope>1</ns:scope>
              <ns:keywords>hstid:1018</ns:keywords>
              <ns:searchMode>1</ns:searchMode>
            </ns:search>
            <ns:command>execute</ns:command>
         </ns:searchRequest>
         <ns:profileId>XMLFIND_ONLY4DEMO</ns:profileId>
         <ns:sendFilterNodes>false</ns:sendFilterNodes>
      </ns:catalogueRequest>
   </soapenv:Body>
</soapenv:Envelope>

REST

http://iws.itscope.de/rest/productLookup?iwsKey=<IhrWebserviceKey>&profileId=XMLFIND_ONLY4DEMO&resultsPerPage=100&maxResults=200&page=1&keywords=hstid:1018&qual=0,1,2,3

Suche nach dem Produkt des Hersteller Sanyo (1018) mit Hersteller Artikelnummer PLC-XR201

SOAP

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://www.itscope.de/IWS/2006-04-20">
   <soapenv:Header/>
   <soapenv:Body>
      <ns:catalogueRequest>
         <ns:requestHeader>
           <ns:customerAuthentication>
               <ns:iwsKey><IhrWebserviceKey></ns:iwsKey>
           </ns:customerAuthentication>
         </ns:requestHeader>
         <ns:extendedResult>false</ns:extendedResult>
         <ns:qual>0 1 2 3</ns:qual>
 	 <ns:searchRequest>
            <ns:search>
              <ns:scope>1</ns:scope>
              <ns:keywords>hstid:1018 hpid:PLC-XR201</ns:keywords>
              <ns:searchMode>1</ns:searchMode>
            </ns:search>
            <ns:command>execute</ns:command>
         </ns:searchRequest>
         <ns:profileId>XMLFIND_ONLY4DEMO</ns:profileId>
         <ns:sendFilterNodes>false</ns:sendFilterNodes>
      </ns:catalogueRequest>
   </soapenv:Body>
</soapenv:Envelope>

REST

http://iws.itscope.de/rest/productLookup?iwsKey=<IhrWebserviceKey>&profileId=XMLFIND_ONLY4DEMO&resultsPerPage=100&maxResults=200&page=1&keywords=hstid:1018 hpid:PLC-XR201&qual=0,1,2,3

7 Verwendung

• Im MarketViewer
• In den ITscope Webservice Funktionen
  • productSearch SOAP (IWS2)
  • productLookup REST (IWS3)
• ITscope Profisuche. Einsatz der Such-API - insbesondere für das Filtern von Produkten nach technischen Merkmalen - für Web-Shops.