SFTP – Ohjeet mukautettujen kenttien käyttöön

SISÄLLYSLUETTELO

• SFTP – Ohjeet mukautettujen kenttien käyttöön
  • Mukautettujen kenttien vastaustiedoston käsittelylogiikka
  • Tiedostomuoto ja nimeämiskäytännöt
  • Lähetysaikataulu ja -tiheys
  • Mukautetun kentän tiedostomuoto

Tältä sivulta löydät hyödyllisiä ohjeita, joiden avulla varmistat, että tiedostosi latautuvat onnistuneesti.

Yleiset SFTP-ohjeet ja lisätietoja löydät kohdasta SFTP – Asennusohjeet.

Mukautettujen kenttien vastaustiedoston käsittelylogiikka

Spotnana hyväksyy sekä osittaiset että täydet mukautettujen kenttien vastauslistat aina, kun lataat uuden tiedoston. Tiedoston nimi kertoo, minkä mukautetun kentän ja vastauslistan vastauksia ollaan lataamassa. Jokainen kenttä ja sen vastausvaihtoehdot tulee lähettää omana tiedostonaan (tarkemmat tiedostonimeämisen ohjeet alla). CSV-tiedoston käsittely etenee seuraavasti:

• Mikäli ACTION sarakkeen arvo rivillä on CREATE, uusi vastausvaihtoehto lisätään kyseiseen vastauslistaan.

• Mikäli ACTION sarakkeen arvo rivillä on UPDATE ja vastausvaihtoehto on jo olemassa, kyseisen vaihtoehdon kuvausta päivitetään.

Mikäli ACTION sarakkeen arvo rivillä on DELETE , vastausvaihtoehto poistetaan. Jos Spotnanan tietokannasta ei löydy vastaavaa vaihtoehtoa, rivi ohitetaan eikä toimenpiteitä tehdä.

Tiedostomuoto ja nimeämiskäytännöt

Jokaisen .CSV-muotoisen mukautetun kentän tiedostonimen tulee olla seuraavassa muodossa:

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

jossa:

• [customFieldID] on muuttuva tunniste, joka vaihtelee kentittäin. Tämä tunniste löytyy tiedostonimestä, joka näkyy kohdassa vaihe 2 kohdassa SFTP-tuonnin ohjeet – tämä näkyy myös SFTP-hakemistosta tuonnin ohjeissa avautuvassa valintaikkunassa. 

• [optionGroupID] on muuttuva tunniste, joka vaihtelee vastauslistoittain. Tämä tunniste löytyy tiedostonimestä, joka näkyy kohdassa vaihe 2 kohdassa SFTP-tuonnin ohjeet – tämä näkyy myös SFTP-hakemistosta tuonnin ohjeissa avautuvassa valintaikkunassa.  

• * (jokerimerkki) voi olla mikä tahansa haluamasi merkkijono. 

• Piste (“.”) tulee olla sekä [optionGroupID] jälkeen että ennen “csv”-päätettä. 

Tiedostonimessä isot ja pienet kirjaimet eivät vaikuta. Suosittelemme lisäämään tiedostonimeen päivämäärän ja kellonajan, jotta mahdolliset ongelmatilanteet on helpompi selvittää myöhemmin. Esimerkiksi:

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

Myös .CSV-tiedoston sisällön tulee olla tietyssä muodossa. Sarakeotsikoiden tulee täsmätä tarkasti määriteltyyn muotoon (katso Mukautetun kentän tiedostomuoto -osio alta). 

Lähetysaikataulu ja -tiheys

Suosittelemme lataamaan tiedoston päivittäin jotta Spotnana saa tiedon kaikista mahdollisista lisäyksistä, muutoksista ja poistoista (jos mukautetut kentät muuttuvat usein, päivittäinen päivitys on suositeltavaa). Jos toimit näin: 

• uudet vastausvaihtoehdot ovat heti matkustajien valittavissa varauksen yhteydessä. 

• poistetut vaihtoehdot poistuvat valinnoista eivätkä enää näy matkustajille. 

Poistetut vaihtoehdot näkyvät kuitenkin edelleen raporteissa.

Mukautetun kentän tiedostomuoto

Näiden ohjeiden avulla varmistat, että mukautettujen kenttien tiedostosi on oikeassa muodossa ja valmis lataukseen.