SFTP－自訂欄位操作說明

目錄

• SFTP－自訂欄位操作說明
  • 自訂欄位回應檔案處理邏輯
  • 檔案格式與命名規則
  • 上傳頻率與排程建議
  • 自訂欄位檔案格式

本篇主題提供一些實用資訊，協助您順利完成檔案上傳。

如果需要一般 SFTP 使用說明，請參考 SFTP－設定說明。

自訂欄位回應檔案處理邏輯

每次上傳檔案時，Spotnana 支援您一次上傳部分或全部的自訂欄位回應資料。檔案名稱會標示本次上傳所屬的自訂欄位及回應清單名稱。每個自訂欄位及其回應都需分開存成不同檔案（詳細命名規則請見下方說明）。系統會依照以下邏輯處理您 CSV 檔案的內容：

• 如果該列的 ACTION 欄位設定為 CREATE，則會在回應清單中新增這個回應選項。

• 如果該列的 ACTION 欄位設定為 UPDATE ，且這個回應選項已存在，則會更新該回應的說明內容。

如果該列的 ACTION 欄位設定為 DELETE ，則會刪除這個回應選項。如果 Spotnana 資料庫中找不到對應的回應選項，該列會自動略過，不會有任何動作。

檔案格式與命名規則

每個 .CSV 自訂欄位檔案的檔名必須遵循以下格式：

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

說明如下：

• [customFieldID] 每個欄位都會有不同的變數 ID，這個 ID 可以在 步驟 2 的 SFTP 匯入說明 對話框中找到，這是 SFTP 目錄匯入說明的一部分。 

• [optionGroupID] 每個回應清單都會有不同的變數 ID，這個 ID 也會顯示在 步驟 2 的 SFTP 匯入說明 對話框中，這是 SFTP 目錄匯入說明的一部分。  

• *（萬用字元）代表您可以自行加入任何想補充的字串。 

• 在 [optionGroupID] 後面的「.」以及「csv」前的「.」都必須保留。 

檔名不區分大小寫。我們建議您在檔名中加上日期和時間，這樣日後如果需要查詢或排除問題會更方便。例如：

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

.CSV 檔案內容也必須符合特定格式。欄位名稱必須完全符合規定（請參考下方 自訂欄位格式 說明）。 

上傳頻率與排程建議

我們建議您 每天 都上傳一次檔案，這樣可以確保 Spotnana 能即時收到所有新增、更新或刪除的資訊（如果您的自訂欄位經常異動，建議每日更新）。這麼做的話： 

• 新回應選項會立即在旅客結帳時出現，可供選擇。 

• 已停用的回應選項會從選單移除，旅客將無法再選擇。 

不過，停用的回應選項在報表中仍然會顯示。

自訂欄位檔案格式

請參考下列資訊，確保您上傳的自訂欄位資料格式正確且已妥善準備。