自定义字段链接

您的 V5 集成指南!

'CustomFieldLink'导入端点可用于快速将自定义标签信息分配给商品(通常是成品配方),这些信息可以根据每个产品打印在产品标签上。

您可以找到更多关于其工作原理以及自定义字段使用的不同示例的信息 开始.

本指南将重点介绍如何使用此端点,通过 CSV 导入和通过 V5 API 使用 JSON。

目录

1. 控制中心布局

至于如何将自定义字段详细信息与控制中心中看到的内容关联起来,我们将使用 V5 API 和网关来填充上方的“CustomField”面板以命名自定义字段并输入标签参数详细信息,以及下方的“CustomFieldLink”面板将商品分配给自定义字段并输入公式特定信息,然后可以将这些信息调用至上方面板中的标签参数集。

 
我们将使用“CustomFieldLink”端点填充这两个面板。

2.API链接

要了解有关此“CustomFieldLink”类的定义的更多信息,请参阅以下链接:

自定义字段链接 

3. CustomFieldLink 字段指南

3.1. 主键

对于通过“CustomFieldLink”端点导入,主键是:

字段名称 – 我们要添加或分配公式的自定义字段的唯一名称。我们可以在上面看到它是“分发者”。

商品代码 – 要分配给自定义字段组的商品/产品配方的唯一代码。

3.2. 必填字段

我们可以添加其他必要的数据来充实从'自定义字段'和'自定义字段链接' 数据库类。这些是:

 

来自 CustomField:

Field_Label参数如果创建新的自定义字段组,则此参数必不可少,这是标签上用于从此组中调用自定义数据的参数。在上面的控制中心示例中,我们可以看到这是“DIST”。

字段默认值使用标签参数时将调用的默认值,前提是下方“CustomFieldLink”面板中没有商品/配方特定值来覆盖此值。在上面的控制中心示例中,我们可以看到这是“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”端点,我们可以为上述添加的内容构建一个导入文件,如下所示:

 

因此请注意,由于我们正在创建“准备说明”组,因此我们需要在此导入中包含标签参数。对于“分发者”组,我们不需要这个,只需在导入中引用该组的名称即可。

可以下载此示例 JSON 文件 开始.

一旦我们将其发布到系统,我们就可以看到我们的示例公式已被添加到“分发者”组中,并且在下方面板的“数据”列中显示其唯一消息:

  

我们还可以看到,我们创建的新组对所有 3 个组都有相同的“准备说明”:

  

5.2. CSV – 导入

对于 CSV 导入,我们首先需要为导入构建一个头文件。

标题/列定义文件名: “customFieldLink.csvh”

完成的头文件应放置在: “ \SG 控制中心\网关\导入\column_defs”

导入 CSV 文件名: “customFieldLink-datetime.csv”

用于导入的 CSV 应放置在: “ \SG 控制中心\网关\导入”

 

示例:

头文件:

下面是一个示例头文件。在这里,我们将商品分配给定义的自定义字段组,并添加一个如上定义的新组:

 

有关我们如何构建这些文件的更多信息,请参阅 主集成页面。 可以下载此示例头文件 开始.

 

CSV 导入文件:

然后,我们可以使用标题中定义的数据点顺序来构造我们的导入文件。请注意,控制中心可以忽略第一行,因此在提交导入时可以将其保留在文件中。根据我们上述要求的示例导入如下所示:

 

可以下载此示例导入​​文件 开始.

与我们的 JSON 导入不同,由于 CSV 导入机制,在这种情况下我们需要为“分发者”组包含“DIST”标签参数。

然后,我们可以将此文件放入上面定义的导入文件夹中,导入完成后,我们可以看到自定义字段组已相应地更新/添加:

 

和:

  

此页面有用吗?
没有