SFTP - Petunjuk untuk kolom kustom

DAFTAR ISI

• SFTP - Petunjuk untuk kolom kustom
  • Logika pemrosesan file respons kolom kustom
  • Format file dan aturan penamaan
  • Frekuensi dan penjadwalan
  • Format file kolom kustom

Bagian ini berisi informasi yang dapat membantu Anda memastikan proses unggah file berjalan lancar.

Untuk panduan dan informasi umum mengenai SFTP, silakan lihat SFTP - Petunjuk pengaturan.

Logika pemrosesan file respons kolom kustom

Spotnana memungkinkan Anda mengunggah data respons kolom kustom secara penuh maupun sebagian setiap kali file diunggah. Nama file menunjukkan nama kolom kustom dan daftar respons yang akan dimasukkan. Setiap kolom kustom beserta responsnya harus dikirimkan dalam file terpisah (untuk detail aturan penamaan file, lihat penjelasan di bawah). Proses pemrosesan isi file CSV Anda dilakukan sebagai berikut:

• Jika kolom ACTION pada baris tersebut diatur ke CREATE, maka opsi respons akan dibuat untuk daftar respons tersebut.

• Jika kolom ACTION pada baris tersebut diatur ke UPDATE dan opsi respons sudah ada, maka deskripsi respons akan diperbarui.

Jika kolom ACTION pada baris tersebut diatur ke DELETE , maka opsi respons tersebut akan dihapus. Jika tidak ada data yang sesuai di database Spotnana, baris tersebut akan dilewati dan tidak ada tindakan yang dilakukan.

Format file dan aturan penamaan

Nama setiap file feed kolom kustom dengan ekstensi .CSV harus mengikuti format berikut:

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

dengan penjelasan:

• [customFieldID] adalah variabel yang berbeda untuk setiap kolom. ID ini terdapat pada nama file yang ditampilkan pada langkah 2 pada petunjuk impor SFTP jendela dialog yang merupakan bagian dari petunjuk Impor dari direktori SFTP. 

• [optionGroupID] adalah variabel yang berbeda untuk setiap daftar respons. ID ini terdapat pada nama file yang ditampilkan pada langkah 2 pada petunjuk impor SFTP jendela dialog yang merupakan bagian dari petunjuk Impor dari direktori SFTP..  

• * (wildcard) dapat diisi dengan karakter apa pun yang ingin Anda tambahkan pada nama file. 

• Titik “.” setelah [optionGroupID] dan titik “.” sebelum “csv” harus ada. 

Nama file tidak membedakan huruf besar dan kecil. Kami menyarankan untuk menambahkan tanggal dan waktu pada nama file (agar memudahkan penelusuran di kemudian hari). Contoh:

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

File feed .CSV juga harus menggunakan format tertentu. Nama kolom harus persis sesuai dengan format yang telah ditentukan (lihat Format kolom kustom di bagian berikut). 

Frekuensi dan penjadwalan

Kami menyarankan Anda mengunggah file setiap hari agar Spotnana selalu mendapatkan informasi terbaru mengenai penambahan, pembaruan, atau penghapusan data (jika kolom kustom Anda sering berubah, pembaruan harian sangat dianjurkan). Jika Anda menerapkan cara ini: 

• respons baru akan langsung tersedia untuk dipilih oleh pelancong saat proses pemesanan. 

• respons yang sudah tidak digunakan lagi akan dihapus dari pilihan dan tidak bisa lagi dipilih oleh pelancong. 

Respons yang sudah tidak digunakan tetap dapat dilihat pada laporan.

Format file kolom kustom

Gunakan informasi berikut untuk memastikan data pada unggahan kolom kustom Anda sudah disiapkan dan diformat dengan benar.