Optionale Schnittstellen

Zusammenfassung

Dieser Artikel enthält Informationen über zusätzliche optionale Schnittstellen die verwendet werden können. Es ist nicht immer erforderlich, eine davon zu verwenden, aber in vielen Fällen ist es sinnvoll.

Dokumentation zu einzelnen FactFinder-Modulen (wie dem Campaign Manager, oder dem Recommendation Engine) ist in einzelnen Artikeln zu finden.

Stellen Sie sicher, dass der Benutzer, den Sie für Authentifizierungszwecke beim Senden von Anfragen an diese Schnittstelle verwenden, die entsprechenden Rechte besitzt. Andernfalls erhalten Sie eine Fehlermeldung.

Ändern, Löschen und Hinzufügen von Datensätzen / Delta-Updates

Diese Schnittstelle erlaubt es, einzelne oder mehrere Datensätze in der Suchdatenbank zu aktualisieren, zu löschen oder hinzuzufügen.

Es ist jedoch zu beachten, dass Änderungen verloren gehen können, wenn ein Datenimport über diese Schnittstelle durchgeführt wird.

Als Grundlage des Imports dient immer der Produktdatenexport, den ein Shopsystem bereitstellt. Verwenden Sie diese Schnittstelle daher nur vorübergehend, um eine schnelle Korrektur eines Datensatzes vorzunehmen.

Alle Änderungen sind sofort in der Suche verfügbar. Durch Speichern der Datenbank werden die vorgenommenen Änderungen auf die Festplatte geschrieben, sodass die Änderungen auch nach einem Neustart verfügbar sind. Der Speichervorgang benötigt jedoch Rechenleistung, daher sollte er nicht bei jedem Änderungsaufruf durchgeführt werden.

wichtig

• Senden Sie nur Datenänderungen an FactFinder. Senden Sie keine Updates für Werte, bei denen keine Änderung stattgefunden hat.

• Warten Sie Updates auf und senden Sie mehrere Updates in einer Anfrage. Massenaktualisierungen werden gegenüber mehreren kleineren Aktualisierungen bevorzugt.

• Verwenden Sie Delta-Updates (also: Datensätze ändern, löschen und hinzufügen), um inkrementelle Änderungen an den bei FactFinder gespeicherten Daten vorzunehmen. Es wird empfohlen, zusätzlich einen täglichen csv Import bereitzustellen.

Datenbanken aktualisieren

In den meisten Fällen verarbeitet FactFinder Datenaktualisierungen selbst. Je nach Definition des Aktualisierungsprozesses wird der Import jedoch nicht von FactFinder selbst initiiert, sondern über die Import-Schnittstelle. Dies ist besonders sinnvoll, wenn die Daten mittels Push-Methode bereitgestellt werden.

Wenn in der FactFinder-Suchkonfiguration eine URL hinterlegt ist, aus der die Exportdaten gezogen werden können, ist es möglich, diese vor dem Import herunterzuladen, sodass sie geladen werden können.

REST-Schnittstelle

Die technische Dokumentation der REST-API befindet sich in der Suchanwendung selbst und kann über [Ihr NG-Server]/fact-finder/swagger-ui.html aufgerufen werden. Sie ist außerdem über die folgende URL erreichbar:

Swagger-Link: https://ng-demo.fact-finder.de/fact-finder/swagger-ui.html

Methoden sind unter records dokumentiert. Zusätzlich zum Anzeigen der Parameterdokumentation können Sie auch eine Abfrage testen und die Ergebnisse anzeigen. Die Dokumentation wurde mit Swagger erstellt, sodass Sie Swagger Codegen verwenden können, um einen Client für die Nutzung in Ihrem Code zu generieren.