你在这里：

过敏原链接

您的 V5 集成指南！

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

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

目录

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

1. 默认过敏原组

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

 

此端点不适用于创建商品，创建商品应始终通过“商品”端点完成。

2.API链接

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

过敏原链接 

过敏原

3. AllergenLink 现场指南

3.1. 主键

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

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

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

3.2. 附加字段

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

Allergen_TextColor – 允许输入 RGB 数值，为过敏原组指定颜色。请注意，同一过敏原组内的所有商品应使用相同的颜色。另请注意，使用此方法导入颜色时，RGB 数值之间无需用逗号分隔（例如，输入 219 125 33，而不是 219, 125, 33）。

4.示例数据集

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

 

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

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

5。 方法论

5.1. JSON – 导入

'AllergenLink' 导入端点/URI –

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

端点描述

示例：

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

 

此示例 JSON 文件可在此处下载。

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

  

5.2. CSV – 导入

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

标题/列定义文件名：“allergenLink.csvh”

已完成的头文件应放置在：“<安装目录>\SG 控制中心\gateway\import\column_defs”

导入 CSV 文件名：“allergenLink-datetime.csv”

用于导入的 CSV 文件应放置在：“<安装目录>\SG 控制中心\gateway\import” 目录下。

示例：

头文件：

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

 

有关我们如何组织这些文件的更多信息，请参阅主集成页面。此示例头文件可在此处下载。

CSV 导入文件：

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

 

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

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

 

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

  

此页面有用吗？
是没有