自定义字段链接
您的 V5 集成指南！
'CustomFieldLink'导入端点可用于快速将自定义标签信息分配给商品（通常是成品配方），这些信息可以根据每个产品打印在产品标签上。
有关其工作原理和自定义字段使用示例的更多信息，请参见此处。
本指南将重点介绍如何使用此端点，通过 CSV 导入和通过 V5 API 使用 JSON。
目录
1. 控制中心布局
至于如何将自定义字段详细信息与控制中心中看到的内容关联起来，我们将使用 V5 API 和网关来填充上方的“CustomField”面板以命名自定义字段并输入标签参数详细信息，以及下方的“CustomFieldLink”面板将商品分配给自定义字段并输入公式特定信息，然后可以将这些信息调用至上方面板中的标签参数集。
2.API链接
要了解有关此“CustomFieldLink”类的定义的更多信息，请参阅以下链接：
3. CustomFieldLink 字段指南
3.1. 主键
对于通过“CustomFieldLink”端点导入，主键是：
字段名称– 自定义字段的唯一名称，用于指定我们要添加或分配公式的字段。如上所示，它显示为“分发方”。
Commodity_Code – 要分配给自定义字段组的商品/产品配方的唯一代码。
3.2. 必填字段
我们可以添加其他必要数据，以完善从“ CustomField ”和“ CustomFieldLink ”数据库类导入的数据。这些数据包括：
来自 CustomField：
Field_LabelParameter –创建新的自定义字段组时必需，此参数将用于标签，以便从该组中调用自定义数据。在上面的控制中心示例中，我们可以看到此参数为“DIST”。
Field_DefaultValue –当使用标签参数时将调用的默认值，前提是下方“自定义字段链接”面板中没有商品/配方特定的值来覆盖此值。在上面的控制中心示例中，我们可以看到此值为“SG Systems LLC”。
来自 CustomFieldLink：
数据– 当在标签上使用自定义字段组的标签参数时，要从标签上提取的特定商品/配方的信息。
4.示例数据集
在本部分中，我们将查看一个简单的示例数据集，其中包含 3 种不同的产品配方，我们可以将这些配方分配给已创建的“分发者”，并为每个配方提供唯一的分发消息。我们还将添加一个名为“准备说明”的新自定义字段组，其中包含“PREP”标签参数。
因此我们将向系统添加以下数据：
- P006：
- 分发者： ABC 分销。
- 准备说明： 使用前清洗.
- P007：
- 分发者： Dave 的经销商
- 准备说明： 使用前清洗.
- P008：
- 分发者： SGS 分销。
- 准备说明： 使用前清洗.
5。 方法论
5.1. JSON – 导入
‘CustomFieldLink’ 导入端点/URI –
http://host:port/V5-API/api/integrate/import/custom_field_link
示例：
使用“CustomFieldLink”端点，我们可以为上述添加的内容构建一个导入文件，如下所示：
因此请注意，由于我们正在创建“准备说明”组，因此我们需要在此导入中包含标签参数。对于“分发者”组，我们不需要这个，只需在导入中引用该组的名称即可。
一旦我们将其发布到系统，我们就可以看到我们的示例公式已被添加到“分发者”组中，并且在下方面板的“数据”列中显示其唯一消息：
我们还可以看到，我们创建的新组对所有 3 个组都有相同的“准备说明”：
5.2. CSV – 导入
对于 CSV 导入，我们首先需要为导入构建一个头文件。
表头/列定义文件名：“customFieldLink.csvh”
已完成的头文件应放置在：“<安装目录>\SG 控制中心\gateway\import\column_defs”
导入 CSV 文件名：“customFieldLink-datetime.csv”
用于导入的 CSV 文件应放置在：“<安装目录>\SG 控制中心\gateway\import” 目录下。
示例：
头文件：
下面是一个示例头文件。在这里，我们将商品分配给定义的自定义字段组，并添加一个如上定义的新组：
有关我们如何组织这些文件的更多信息，请参阅主集成页面。此示例头文件可在此处下载。
CSV 导入文件：
然后，我们可以使用标题中定义的数据点顺序来构造我们的导入文件。请注意，控制中心可以忽略第一行，因此在提交导入时可以将其保留在文件中。根据我们上述要求的示例导入如下所示：
与我们的 JSON 导入不同，由于 CSV 导入机制，在这种情况下我们需要为“分发者”组包含“DIST”标签参数。
然后，我们可以将此文件放入上面定义的导入文件夹中，导入完成后，我们可以看到自定义字段组已相应地更新/添加：
和：
