SFTP - 自定义字段操作指南

目录

• SFTP - 自定义字段操作指南
  • 自定义字段响应文件处理逻辑
  • 文件格式与命名规范
  • 上传频率与计划安排
  • 自定义字段文件格式

本主题为您提供一些实用信息，帮助您顺利完成文件上传。

如需了解 SFTP 的通用操作规范和相关信息，请参见 SFTP - 设置说明。

自定义字段响应文件处理逻辑

每次上传文件时，Spotnana 支持上传部分或全部自定义字段响应数据。文件名用于标识本次上传对应的自定义字段及其响应选项列表。每个自定义字段及其响应选项需分别单独上传（具体命名规范见下文）。系统会按如下逻辑处理您的 CSV 文件内容：

• 如果该行的 ACTION 列被设置为 CREATE，则会为响应选项列表新增一个响应选项。

• 如果该行的 ACTION 列被设置为 UPDATE ，且该响应选项已存在，则会更新该响应选项的描述信息。

如果该行的 ACTION 列被设置为 DELETE ，则会删除该响应选项。如果 Spotnana 数据库中没有对应的响应选项，则会跳过该行，不做任何操作。

文件格式与命名规范

每个 .CSV 自定义字段文件的文件名需采用以下格式：

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

具体说明如下：

• [customFieldID] 为每个字段对应的变量。该 ID 可在 第 2 步 的 SFTP 导入说明 对话框中找到，该对话框属于 SFTP 目录导入操作指引的一部分。 

• [optionGroupID] 为每个响应选项列表对应的变量。该 ID 也可在 第 2 步 的 SFTP 导入说明 对话框中找到，该对话框属于 SFTP 目录导入操作指引的一部分。  

• * 号（通配符）可以用来补充任意您需要添加的字符。 

• [optionGroupID] 后面的“.”和“csv”前的“.”都必须保留。 文件名大小写不敏感。建议您在文件名中加入日期和时间，方便后续排查。例如： 

CUSTOM_FIELD_V3_OPTIONS.[customFieldID].[optionGroupID].spotnana_integration_

<DateTime>.csv.CSV 文件还需符合特定格式。各列名称必须与规定格式完全一致（详见下方

自定义字段格式 部分）。 上传频率与计划安排 

建议您

每天 上传一次文件，以便及时将新增、更新或删除的内容同步到 Spotnana（如果您的自定义字段变动较频繁，建议采用每日更新）。这样做可以确保： 新添加的响应选项会在旅客下单时立即可选。 

• 已停用的响应选项将从选项列表中移除，旅客无法再选择。 

• 不过，已停用的响应选项仍会在报表中显示。 

自定义字段文件格式

请参考以下信息，确保您上传的自定义字段数据格式正确、内容准备无误。

列名