SFTP - Οδηγίες για προσαρμοσμένα πεδία

ΠΕΡΙΕΧΟΜΕΝΑ

• SFTP - Οδηγίες για προσαρμοσμένα πεδία
  • Λογική επεξεργασίας αρχείων απαντήσεων προσαρμοσμένων πεδίων
  • Μορφή αρχείου και κανόνες ονοματοδοσίας
  • Συχνότητα και προγραμματισμός αποστολών
  • Μορφή αρχείου για προσαρμοσμένα πεδία

Σε αυτό το θέμα θα βρείτε χρήσιμες πληροφορίες για να διασφαλίσετε ότι οι αποστολές των αρχείων σας θα ολοκληρώνονται με επιτυχία.

Για γενικές οδηγίες και πληροφορίες σχετικά με το SFTP, δείτε SFTP - Οδηγίες ρύθμισης.

Λογική επεξεργασίας αρχείων απαντήσεων προσαρμοσμένων πεδίων

Στο Spotnana μπορείτε να ανεβάζετε κάθε φορά είτε μέρος είτε το σύνολο των απαντήσεων για προσαρμοσμένα πεδία. Το όνομα του αρχείου δείχνει σε ποιο προσαρμοσμένο πεδίο και λίστα απαντήσεων αναφέρονται οι απαντήσεις που ανεβάζετε. Κάθε προσαρμοσμένο πεδίο και οι απαντήσεις του πρέπει να αποστέλλονται σε ξεχωριστό αρχείο (δείτε παρακάτω για λεπτομέρειες σχετικά με την ονοματοδοσία των αρχείων). Η επεξεργασία του αρχείου CSV γίνεται ως εξής:

• Αν η στήλη ACTION για τη συγκεκριμένη γραμμή έχει τιμή CREATE, τότε η επιλογή απάντησης θα προστεθεί στη σχετική λίστα απαντήσεων.

• Αν η στήλη ACTION για τη γραμμή έχει τιμή UPDATE και η επιλογή απάντησης υπάρχει ήδη, θα ενημερωθεί η περιγραφή αυτής της απάντησης.

Αν η στήλη ACTION για τη γραμμή έχει τιμή DELETE , τότε η επιλογή απάντησης θα διαγραφεί. Αν δεν βρεθεί αντίστοιχη εγγραφή στη βάση δεδομένων του Spotnana, η γραμμή θα παραλειφθεί και δεν θα γίνει καμία ενέργεια.

Μορφή αρχείου και κανόνες ονοματοδοσίας

Το όνομα κάθε αρχείου .CSV που περιέχει προσαρμοσμένα πεδία πρέπει να ακολουθεί το παρακάτω πρότυπο:

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

όπου:

• [customFieldID] είναι μια μεταβλητή που αλλάζει για κάθε πεδίο. Αυτό το αναγνωριστικό εμφανίζεται στο όνομα του αρχείου που φαίνεται στο βήμα 2 στις οδηγίες εισαγωγής μέσω SFTP στο παράθυρο διαλόγου που αποτελεί μέρος των οδηγιών Εισαγωγής από τον φάκελο SFTP. 

• [optionGroupID] είναι μια μεταβλητή που αλλάζει για κάθε λίστα απαντήσεων. Αυτό το αναγνωριστικό εμφανίζεται στο όνομα του αρχείου που φαίνεται στο βήμα 2 στις οδηγίες εισαγωγής μέσω SFTP στο παράθυρο διαλόγου που αποτελεί μέρος των οδηγιών Εισαγωγής από τον φάκελο SFTP.  

• το * (σύμβολο υποκατάστασης) μπορεί να είναι οποιοσδήποτε χαρακτήρας θέλετε να προσθέσετε στο όνομα. 

• η τελεία “.” μετά το [optionGroupID] και η τελεία “.” πριν το “csv” πρέπει να υπάρχουν οπωσδήποτε. 

Το όνομα του αρχείου δεν κάνει διάκριση πεζών-κεφαλαίων. Σας προτείνουμε να συμπεριλάβετε την ημερομηνία και ώρα στο όνομα του αρχείου (για να διευκολύνεται η επίλυση προβλημάτων στο μέλλον). Για παράδειγμα:

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

Το αρχείο .CSV πρέπει επίσης να έχει συγκεκριμένη μορφή. Τα ονόματα των στηλών πρέπει να ταιριάζουν ακριβώς με το καθορισμένο πρότυπο (δείτε την ενότητα Μορφή προσαρμοσμένου πεδίου παρακάτω). 

Συχνότητα και προγραμματισμός αποστολών

Συνιστούμε να ανεβάζετε αρχείο καθημερινά ώστε να ενημερώνεται το Spotnana για τυχόν προσθήκες, αλλαγές ή διαγραφές που μπορεί να έχουν γίνει (αν τα προσαρμοσμένα πεδία σας αλλάζουν συχνά, οι καθημερινές ενημερώσεις είναι προτιμότερες). Εφόσον ακολουθείτε αυτήν την πρακτική: 

• οι νέες απαντήσεις θα είναι άμεσα διαθέσιμες για επιλογή από τους ταξιδιώτες κατά τη διαδικασία κράτησης. 

• οι απαντήσεις που έχουν καταργηθεί θα αφαιρούνται και δεν θα είναι πλέον διαθέσιμες για επιλογή από τους ταξιδιώτες. 

Οι καταργημένες απαντήσεις θα εξακολουθούν να εμφανίζονται στις αναφορές.

Μορφή αρχείου για προσαρμοσμένα πεδία

Χρησιμοποιήστε τις παρακάτω πληροφορίες για να βεβαιωθείτε ότι τα δεδομένα που ανεβάζετε στα προσαρμοσμένα πεδία σας είναι σωστά διαμορφωμένα και έτοιμα προς χρήση.