SFTP – Anleitung für benutzerdefinierte Felder

Erstellt von Ashish Chaudhary, Geändert am Sa, 4 Okt um 12:59 VORMITTAGS von Ashish Chaudhary

SFTP – Anleitung für benutzerdefinierte Felder

INHALTSVERZEICHNIS

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.

SpaltePflichtfeld/FreiwilligHinweise
AktionPflichtfeld

Der Wert in diesem Feld gibt dem Online-Buchungstool (OBT) an, welche Aktion mit den bereitgestellten Informationen durchgeführt werden soll. 

  • CREATE – um eine neue Antwortoption hinzuzufügen.
  • UPDATE – um die Beschreibung einer bestehenden Antwortoption zu aktualisieren. 
  • DELETE – um eine bestehende Antwortoption zu entfernen. 

Antwortoption

Pflichtfeld

Der Name der Antwortoption im Online-Buchungstool (OBT).

Beschreibung

Freiwillig

Eine verständliche Beschreibung der Antwortoption für die Nutzer. 

War dieser Artikel hilfreich?

Das ist großartig!

Vielen Dank für das Feedback

Leider konnten wir nicht helfen

Vielen Dank für das Feedback

Wie können wir diesen Artikel verbessern?

Wählen Sie wenigstens einen der Gründe aus
CAPTCHA-Verifikation ist erforderlich.

Feedback gesendet

Wir wissen Ihre Bemühungen zu schätzen und werden versuchen, den Artikel zu korrigieren