SFTP – Anleitung für benutzerdefinierte Felder

INHALTSVERZEICHNIS

• SFTP – Anleitung für benutzerdefinierte Felder
  • Verarbeitungslogik für Antwortdateien benutzerdefinierter Felder
  • Dateiformat und Namenskonventionen
  • Häufigkeit und Zeitplanung
  • Dateiformat für benutzerdefinierte Felder

In diesem Abschnitt finden Sie hilfreiche Hinweise, damit Ihre Datei-Uploads problemlos funktionieren.

Allgemeine Hinweise und Informationen zu SFTP finden Sie unter SFTP – Einrichtungsanleitung.

Verarbeitungslogik für Antwortdateien benutzerdefinierter Felder

Spotnana ermöglicht es Ihnen, bei jedem Upload entweder einen vollständigen oder einen teilweisen Datensatz für benutzerdefinierte Feldantworten bereitzustellen. Am Dateinamen erkennen Sie, zu welchem benutzerdefinierten Feld und welcher Antwortliste die Antworten gehören. Für jedes benutzerdefinierte Feld und dessen Antworten muss eine eigene Datei hochgeladen werden (Details zu den Namenskonventionen finden Sie unten). Die Verarbeitung Ihrer CSV-Datei erfolgt nach folgendem Prinzip:

• Wenn in der ACTION Spalte für die Zeile CREATEsteht, wird die Antwortoption für die Antwortliste neu angelegt.

• Wenn in der ACTION Spalte für die Zeile UPDATE steht und die Antwortoption bereits existiert, wird die Beschreibung dieser Antwort aktualisiert.

Wenn in der ACTION Spalte für die Zeile DELETE steht, wird die Antwortoption gelöscht. Gibt es keinen passenden Eintrag in der Spotnana-Datenbank, wird die Zeile übersprungen und es passiert nichts.

Dateiformat und Namenskonventionen

Jede .CSV-Datei für benutzerdefinierte Felder muss folgendermaßen benannt werden:

CUSTOM_FIELD_V3_OPTIONS.[customFieldID].[optionGroupID].*.csv

wobei:

• [customFieldID] eine variable Kennung ist, die sich je nach Feld unterscheidet. Diese ID finden Sie im Dateinamen, der in Schritt 2 der SFTP-Importanleitung im Dialogfeld der Anleitung zum Importieren aus dem SFTP-Verzeichnis angezeigt wird. 

• [optionGroupID] eine variable Kennung ist, die sich je nach Antwortliste unterscheidet. Diese ID finden Sie im Dateinamen, der in Schritt 2 der SFTP-Importanleitung im Dialogfeld der Anleitung zum Importieren aus dem SFTP-Verzeichnis angezeigt wird.  

• Das * (Wildcard) steht für beliebige weitere Zeichen, die Sie im Namen ergänzen möchten. 

• Der Punkt „.“ nach der [optionGroupID] und der Punkt vor „csv“ müssen im Dateinamen enthalten sein. 

Die Groß- und Kleinschreibung im Dateinamen spielt keine Rolle. Wir empfehlen, das Datum und die Uhrzeit im Dateinamen zu ergänzen (das erleichtert die spätere Fehlersuche). Zum Beispiel:

CUSTOM_FIELD_V3_OPTIONS.[customFieldID].[optionGroupID].spotnana_integration_<DateTime>.csv

Auch das Format der .CSV-Datei muss genau eingehalten werden. Die Spaltenüberschriften müssen exakt mit dem vorgegebenen Format übereinstimmen (siehe Abschnitt Format benutzerdefinierter Felder weiter unten). 

Häufigkeit und Zeitplanung

Wir empfehlen, die Datei täglich hochzuladen, damit Spotnana stets über neue, geänderte oder gelöschte Einträge informiert ist (bei häufigen Änderungen ist ein täglicher Upload sinnvoll). Wenn Sie diese Vorgehensweise wählen: 

• Neue Antwortoptionen stehen Reisenden beim Checkout sofort zur Auswahl. 

• Nicht mehr gültige Antwortoptionen werden entfernt und können von Reisenden nicht mehr ausgewählt werden. 

Nicht mehr gültige Antwortoptionen bleiben in Berichten weiterhin sichtbar.

Dateiformat für benutzerdefinierte Felder

Nutzen Sie die folgenden Hinweise, um sicherzustellen, dass Ihre Datei für den Upload korrekt vorbereitet und formatiert ist.