SFTP – Veiledning for egendefinerte felt

INNHOLDSFORTEGNELSE

• SFTP – Veiledning for egendefinerte felt
  • Behandlingslogikk for svarfiler med egendefinerte felt
  • Filformat og navngivningsregler
  • Hyppighet og tidsplan
  • Filformat for egendefinerte felt

Denne artikkelen gir deg nyttig informasjon slik at filopplastingene dine blir vellykket.

For generelle retningslinjer og informasjon om SFTP, se SFTP – Oppsettveiledning.

Behandlingslogikk for svarfiler med egendefinerte felt

Spotnana lar deg laste opp enten et delvis eller komplett datasett for egendefinerte feltsvar hver gang du laster opp en fil. Filnavnet angir hvilket egendefinert felt og hvilken svarliste svarene gjelder for. Hvert egendefinert felt og tilhørende svar må sendes i en egen fil (se mer om navngivningsregler nedenfor). Når innholdet i CSV-filen behandles, brukes følgende logikk:

• Hvis ACTION -kolonnen for raden er satt til CREATE, vil svaralternativet bli opprettet i svarlisten.

• Hvis ACTION -kolonnen for raden er satt til UPDATE og svaralternativet allerede finnes, vil beskrivelsen for dette svaret bli oppdatert.

Hvis ACTION -kolonnen for raden er satt til DELETE , vil svaralternativet bli slettet. Dersom det ikke finnes noen tilsvarende post i Spotnana-databasen, vil raden bli hoppet over uten at det gjøres noen endringer.

Filformat og navngivningsregler

Hvert .CSV-filnavn for egendefinerte felt må følge dette formatet:

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

hvor:

• [customFieldID] er en variabel som er forskjellig for hvert felt. Denne ID-en finner du i filnavnet som vises i steg 2 i SFTP-importveiledningen som er en del av veiledningen for Import fra SFTP-mappe. 

• [optionGroupID] er en variabel som endres for hver svarliste. Denne ID-en finner du i filnavnet som vises i steg 2 i SFTP-importveiledningen som er en del av veiledningen for Import fra SFTP-mappe.  

• * (jokertegn) kan være hvilke som helst tegn du ønsker å legge til i navnet. 

• Punktumet etter [optionGroupID] og punktumet før “csv” må være med. 

Filnavnet skiller ikke mellom store og små bokstaver. Vi anbefaler å inkludere dato og klokkeslett i filnavnet (det gjør det enklere å feilsøke senere). For eksempel:

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

.CSV-filen må også følge et bestemt format. Kolonnenavnene må være nøyaktig som angitt (se Format for egendefinerte felt under). 

Hyppighet og tidsplan

Vi anbefaler at du laster opp en fil daglig for å sikre at Spotnana får beskjed om eventuelle nye, oppdaterte eller slettede svaralternativer (hvis egendefinerte felt endres ofte, kan daglige oppdateringer være lurt). Hvis du følger denne praksisen: 

• nye svaralternativer blir umiddelbart tilgjengelige for reisende ved bestilling. 

• utgåtte svaralternativer blir fjernet og kan ikke lenger velges av reisende. 

Utgåtte svaralternativer vil fortsatt vises i rapporter.

Filformat for egendefinerte felt

Bruk denne informasjonen for å sikre at dataene i opplastingen din er riktig formatert og klare til bruk.