SFTP - Instructies voor aangepaste velden

INHOUDSOPGAVE

• SFTP - Instructies voor aangepaste velden
  • Verwerkingslogica van het bestand met antwoorden op aangepaste velden
  • Bestandsformaat en naamgevingsregels
  • Frequentie en planning
  • Bestandsformaat voor aangepaste velden

In dit onderwerp vindt u handige tips om ervoor te zorgen dat uw bestandsuploads goed verlopen.

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

Verwerkingslogica van het bestand met antwoorden op aangepaste velden

Spotnana ondersteunt zowel gedeeltelijke als volledige gegevenssets voor aangepaste velden bij elke upload. De bestandsnaam geeft aan voor welk aangepast veld en welke antwoordlijst de antwoorden worden geüpload. Voor elk aangepast veld en de bijbehorende antwoorden moet u een apart bestand aanleveren (meer informatie over naamgevingsregels vindt u hieronder). Uw CSV-bestand wordt als volgt verwerkt:

• Als in de kolom ACTIONkolom voor de rij is ingesteld opCREATE is ingevuld, wordt de antwoordoptie toegevoegd aan de antwoordlijst.

• Als in de kolom ACTION...de kolom voor deze rij is ingesteld op...BIJWERKEN...en de antwoordoptie bestaat al, dan wordt de omschrijving van het antwoord bijgewerkt.

Als de...ACTIE...kolom voor deze rij is ingesteld op...VERWIJDEREN...dan wordt de antwoordoptie verwijderd. Als er geen overeenkomstig record in de Spotnana-database gevonden wordt, wordt deze rij overgeslagen en gebeurt er verder niets.

Bestandsindeling en naamgevingsregels

Elke .CSV-bestandsnaam voor aangepaste velden moet het volgende formaat hebben:

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

waarbij:

• [customFieldID] een variabele is die per veld verschilt. Deze ID staat in de bestandsnaam die wordt getoond in...stap 2...van het...SFTP-importinstructies...venster, dat onderdeel is van de instructies voor importeren vanuit de SFTP-map.

  • Om deze waarde te vinden, opent u het gewenste aangepaste veld in de OBT. Zoek een gebruikersantwoord met het type "Lijst met opties" en kies Antwoordenlijst bewerken in het menu aan het einde van de betreffende regel. 

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

  • Om deze waarde te vinden, opent u het gewenste aangepaste veld in de OBT. Zoek een gebruikersantwoord met het type "Lijst met opties" en kies Antwoordenlijst bewerken in het menu aan het einde van de betreffende regel.

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

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

De bestandsnaam is niet hoofdlettergevoelig. Wij raden aan 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_.csv

Het .CSV-feedbestand moet aan een specifiek format voldoen. De kolomnamen dienen exact overeen te komen met het voorgeschreven format (zie Format voor aangepaste velden onderstaand). 

Frequentie en planning

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

• nieuwe antwoorden zijn direct beschikbaar voor reizigers om te selecteren tijdens het boeken. 

• verouderde antwoorden worden automatisch verwijderd als optie en zijn niet langer te kiezen door reizigers. 

Verouderde antwoorden blijven wel zichtbaar in rapportages.

Bestandsformaat voor aangepaste velden

Gebruik deze informatie om te controleren of uw bestand met aangepaste velden juist is opgemaakt en klaar is voor uploaden.