Integration der FACT-Finder Suche per Webservice / SOAP

Wir raten Ihnen von der Verwendung dieser Schnittstelle zur Abfrage von Suchergebnissen ab, da im eCommerce die Suchperformance, bzw. genauer gesagt die Zeit bis zum Ausspielen des Ergebnisses, eine wichtige Rolle spielt.

Bitte beachten Sie die entsprechenden Hinweise beim Vergleich der unterschiedlichen Integrationsvarianten.

End of Life

Bitte beachten Sie, dass die SOAP-Schnittstelle nicht mehr erweitert oder aktualisiert wird und mittelfristig entfällt. Wir empfehlen Kunden bei einer Neuintegration diese nicht und stattdessen die REST-API zu verwenden. Sollten Sie bisher die SOAP-Schittstelle verwendet haben, können Sie diese noch weiterhin nutzen, wir empfehlen aber auch hier die Integrationsschnittstelle zu ändern, um von den Vorteilen der anderen Schnittstellen, wie eine schnellere Übertragung und somit Geschwindigkeit, zu profitieren.

Der Endpunkt für die SOAP-Schnittstelle befindet sich unter

$stringEscapeUtils.escapeHtml($body)

Diese Dokumentation soll die Verwendung der Schnittstelle verdeutlichen. Es wird kein Beispielcode oder Implementierungsdetail vorgestellt, hierfür stellen wir Ihnen gerne neben den Beispielimplementierungen auch ein JavaDoc bereit.

Suchanfrage absetzen

Um ein Suchergebnis abzufragen, gibt es die Methoden getResult.

Diese Methoden haben als Parameter zum einen die Suchparameter als Params-Objekt und zum anderen ein AuthenticationToken-Objekt, mit dem Sie die Login-Daten übergeben müssen. Im AuthenticationToken-Objekt müssen der Benutzername, der Zeitstempel und das nach vorheriger Anleitung verschlüsselte Passwort gesetzt sein.

Im Params-Objekt werden alle Einstellungen für die Suchanfrage über einfache Setter-Methoden gesetzt. Bei den Filtern gibt es zu beachten, wenn eine Mehrfachauswahl in einem Feld realisiert werden soll, dass man zuerst mehrere FilterValue-Objekte in dem entsprechenden Filter-Objekt setzen und dieses dann den Parametern hinzufügen muss.

Sollten Sie spezielle Parameter an FACT-Finder übergeben wollen, durch die eine Sonderlösung realisiert werden soll, so setzen Sie bitte diese über die customParameters. Diese Fälle sollten aber mit einem Omikron Techniker im Detail besprochen werden.

Vergessen Sie bitte nicht, eine Session-ID in der TrackingInformation hinzuzufügen. Sollten Sie das Personalisierungsmodul verwenden ist dies zwingend nötig, ansonsten sind dadurch detailliertere Analysen und automatische Optimierungen möglich.

Rückgabe verarbeiten

Als Rückgabe der oben genannten Methoden erhalten Sie ein Result-Objekt. In diesem befinden sich alle Informationen des Suchergebnisses, die Sie für die Darstellung benötigen.

Die wichtigsten Daten sind zum einen die Statusinformationen des Suchergebnisses. Diese besagen, ob ein Suchergebnis gefunden wurde und ob eine Artikelnummernsuche durchgeführt wurde. Anhand dieser entscheiden Sie, welche Ergebnisseite Sie dem Benutzer anzeigen. Die Suchergebnisse vom Typ SearchRecord sind in einer Liste gespeichert und können dadurch dargestellt werden. Diese Objekte enthalten alle Felder, die in der FACT-Finder Datenbank gespeichert sind, diese können Sie über getRecord() abfragen.

Bitte entnehmen Sie eine detailliertere Beschreibung der Informationen der XML-Integrations-Beschreibung oder dem JavaDoc.

Auf dieser Seite