SFTP - Instructies voor aangepaste velden

INHOUDSOPGAVE

• SFTP - Instructies voor aangepaste velden
  • Werkwijze voor het verwerken van bestanden met antwoorden op aangepaste velden
  • Bestandsformaat en naamgevingsregels
  • Frequentie en planning
  • Bestandsformaat voor aangepaste velden

In dit onderdeel vindt u praktische informatie om ervoor te zorgen dat uw bestandsuploads goed verlopen.

Voor algemene richtlijnen en informatie over SFTP, zie SFTP - Installatie-instructies.

Werkwijze voor het verwerken van bestanden met antwoorden op aangepaste velden

Spotnana accepteert bij elke upload zowel een gedeeltelijke als een volledige set antwoordopties voor aangepaste velden. Aan de bestandsnaam kunt u zien voor welk aangepast veld en welke antwoordlijst de antwoorden worden geüpload. Voor elk aangepast veld en bijbehorende antwoorden moet u een apart bestand aanleveren (zie hieronder voor meer informatie over de naamgevingsregels). De verwerking van uw CSV-bestand verloopt als volgt:

• Als in de kolom ACTION voor de betreffende rij de waarde CREATEstaat, wordt de antwoordoptie toegevoegd aan de antwoordlijst.

• Als in de kolom ACTION voor de betreffende rij de waarde UPDATE staat en de antwoordoptie bestaat al, dan wordt de omschrijving van dat antwoord bijgewerkt.

Als in de kolom ACTION voor de betreffende rij de waarde DELETE staat, wordt de antwoordoptie verwijderd. Als er geen overeenkomstige registratie in de Spotnana-database wordt gevonden, wordt de rij overgeslagen en gebeurt er niets.

Bestandsformaat en naamgevingsregels

De naam van elk .CSV-bestand voor aangepaste velden moet als volgt zijn opgebouwd:

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

waarbij:

• [customFieldID] een variabele is die per veld verschilt. Deze ID vindt u terug in de bestandsnaam zoals getoond in stap 2 van de SFTP importinstructies dialoogvenster dat onderdeel is van de instructies voor importeren vanuit de SFTP-map. 

• [optionGroupID] een variabele is die per antwoordlijst verschilt. Deze ID vindt u terug in de bestandsnaam zoals getoond in stap 2 van de SFTP importinstructies dialoogvenster dat onderdeel is van de instructies voor importeren vanuit de SFTP-map.  

• de * (wildcard) staat voor willekeurige tekens die u aan de naam wilt toevoegen. 

• de “.” na de [optionGroupID] en de “.” vóór “csv” verplicht aanwezig moeten zijn. 

De bestandsnaam is hoofdletterongevoelig. Wij adviseren om de datum en tijd in de bestandsnaam op te nemen (dit maakt het later makkelijker om problemen op te sporen). Bijvoorbeeld:

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

Het .CSV-bestand moet daarnaast aan een specifiek formaat voldoen. De kolomnamen moeten exact overeenkomen met het voorgeschreven formaat (zie Formaat van aangepaste velden onderstaand onderdeel). 

Frequentie en planning

Wij raden aan om dagelijks een bestand te uploaden daily zodat Spotnana altijd op de hoogte is van eventuele toevoegingen, wijzigingen of verwijderingen (als uw aangepaste velden vaak veranderen, zijn dagelijkse updates aan te bevelen). Als u deze werkwijze volgt: 

• zijn nieuwe antwoordopties direct beschikbaar voor reizigers bij het afronden van hun boeking. 

• zullen verouderde antwoordopties niet langer als keuze worden getoond aan reizigers. 

Verouderde antwoordopties blijven wel zichtbaar in rapportages.

Bestandsformaat voor aangepaste velden

Gebruik onderstaande informatie om te controleren of de gegevens in uw upload voor aangepaste velden juist zijn opgemaakt en voorbereid.