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  

• * (wildcard) คืออักขระใด ๆ ที่ท่านต้องการเพิ่มในชื่อไฟล์ 

• จุด “.” หลัง [optionGroupID] และจุด “.” ก่อน “csv” จะต้องมีอยู่ในชื่อไฟล์ 

ชื่อไฟล์ไม่ต้องคำนึงถึงตัวพิมพ์เล็ก-ใหญ่ แนะนำให้ใส่วันที่และเวลาไว้ในชื่อไฟล์ด้วย เพื่อความสะดวกในการตรวจสอบย้อนหลัง ตัวอย่างเช่น

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

ไฟล์ฟีด .CSV จะต้องอยู่ในรูปแบบที่กำหนดไว้เท่านั้น โดยชื่อคอลัมน์ต้องตรงกับรูปแบบที่กำหนด (ดูรายละเอียดในหัวข้อ รูปแบบฟิลด์แบบกำหนดเอง ด้านล่างนี้) 

ความถี่และการตั้งเวลาการอัปโหลด

ขอแนะนำให้อัปโหลดไฟล์ เป็นประจำทุกวัน เพื่อให้ Spotnana ทราบการเพิ่ม แก้ไข หรือลบข้อมูลที่เกิดขึ้น (หากมีการเปลี่ยนแปลงฟิลด์บ่อย แนะนำให้อัปเดตทุกวัน) หากปฏิบัติตามแนวทางนี้ 

• ตัวเลือกคำตอบใหม่จะพร้อมให้ผู้เดินทางเลือกใช้ได้ทันทีในขั้นตอนจอง 

• ตัวเลือกคำตอบที่เลิกใช้แล้วจะถูกนำออกจากตัวเลือกและไม่สามารถเลือกได้อีก 

อย่างไรก็ตาม รายการคำตอบที่เลิกใช้แล้วจะยังคงแสดงในรายงานต่าง ๆ

รูปแบบไฟล์สำหรับฟิลด์แบบกำหนดเอง

โปรดใช้ข้อมูลนี้เพื่อช่วยตรวจสอบให้แน่ใจว่าไฟล์ที่ท่านจะอัปโหลดมีรูปแบบและข้อมูลถูกต้องครบถ้วน