过敏原链接

'AllergenLink' 导入端点可用于快速将商品分配给 过敏原 V5 可追溯性内的组。

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

1. 默认过敏原组
2. 接口链接
3. AllergenLink 现场指南
   1. 主键
   2. 附加字段
4. 示例数据集
5. 研究方法
   1. 1. JSON – 导入
      2. CSV – 导入

默认 V5 数据库包含许多最常见的过敏原组，但如果需要，可以使用此端点创建其他过敏原组。以下屏幕截图中可以看到包含的标准过敏原组：

此端点不适用于商品创建，这应始终通过'商品' 端点。

要了解有关此“AllergenLink”的定义以及相关数据库类的更多信息，请参阅以下链接：

过敏原链接 

过敏原

对于这两种导入方法，主键是：

过敏原_过敏原 – 过敏原组的名称（例如小麦、麸质等）。

商品代码 – 分配给过敏原组的商品唯一代码。

我们可以从“过敏原”数据库类中添加的其他选项包括：

Allergen_TextColor – 允许输入 RGB 数字来为过敏原组分配颜色。请注意，对于同一过敏原组内的所有商品，这应该是相同的。还请注意，使用此方法导入颜色时，RGB 数字不需要用逗号分隔（例如 219 125 33，而不是 219, 125, 33）。

在本文中，我们将查看一个简单的示例数据集，其中包含生产过程中可能使用的 5 种成分：

因此，我们将在此为这些商品分配以下默认过敏原组。对于 CSV 导入，我们还将同时分配文本颜色：

• 面粉 – 小麦（红色）和麸质（紫色）
• 起司 – 乳制品（黄色）
• 蛋类 – 鸡蛋（绿色）
• 大豆 – 大豆（蓝色）
• 杏仁 – 树坚果（橙色）

'AllergenLink' 导入端点/URI –

http://host:port/V5-API/api/integrate/import/allergen_link

端点描述

示例：

使用“AllergenLink”端点，我们可以为上述添加的内容构建一个导入文件，如下所示：

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

一旦我们将其发布到系统中，我们就可以看到我们所有的商品都已被分配到正确的过敏原组，在本例中是“树坚果”下的杏仁。

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

标题/列定义文件名： “过敏原链接.csvh”

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

导入 CSV 文件名： “过敏原链接-日期时间.csv”

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

示例：

头文件：

下面是一个示例头文件。在这里，我们将把商品分配到定义的过敏原组，并为这些组添加颜色：

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

CSV 导入文件：

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

再次注意，我们不需要通常用于分隔 RGB 值的逗号。此示例导入​​文件可以下载 开始.

然后，我们可以将此文件放入上面定义的导入文件夹中，导入完成后，我们就可以看到过敏原组文本颜色已更新：

如果我们检查每一组，我们会发现我们想要的过敏原已经被添加了：