计量单位
您的 V5 集成指南！
V5 Traceability 与客户 ERP 系统之间的计量单位集成允许将 ERP/第三方系统使用的计量单位发送到 V5 Traceability。然后，这些单位可应用于 V5 Traceability 系统内的仓储和配方/生产。
V5 可追溯性系统的灵活性允许完全自定义单位设置，能够为大量物品（例如箱装和桶装）设置自定义单位换算，以及能够设置特定商品的换算率。特定换算率对于具有特定密度的物品特别有用，如下例所示。
我们将在这里查看的“WeightUnit”和“UnitCommodity”类仅支持导入；无法通过 JSON 或 CSV 方法进行导出。
有关 V5 可追溯性中计量单位如何运作的更多信息，请参阅我们的模块指南 开始.
目录
1. 控制中心布局
关于如何将单位和商品特定转换率与我们在控制中心看到的内容关联起来，我们可以看到这里的顶部面板用于输入我们的计量单位，底部面板用于输入顶部面板中选择的单位的商品特定转换率。
如果下方面板中没有针对特定商品的条目，则当商品与该单位一起使用时，系统将恢复到上方面板中设置的换算率。一旦下方面板中添加了商品并为其添加了换算率（“UnitCommodity”），则此换算率将覆盖上方面板中的换算率。
使用 V5 网关我们可以轻松填充两个面板。
2.API链接
3. 集成模板
4. 单位指南
4.1. 主键
主键是 V5 API 中每个表的唯一标识符。
对于 重量单位， 这是：
码 – 计量单位的唯一代码（例如 g、kg、lb、oz 等）
对于 单位商品，主键是：
单位代码 – 计量单位的唯一代码，如上所述。
和
商品编码 – 应用特定转换率的商品的唯一代码。
4.2. 必填字段
SG 在控制中心填充有效条目所需的其他字段包括：
对于 重量单位：
兑换率 – 此单位的转换率，与数据库中 ID 为 1 的单位相关。
对于 单位商品:
兑换率 – 特定商品的特定转化率。
4.3. 首选字段
首选字段用于向计量单位添加更多信息（重量单位)，虽然不是必需的，但在 V5 可追溯性功能方面很有用。
描述 – 单位描述（公斤、磅等）
4.4. 附加字段
还可以包括其他字段 重量单位，如：
笔记 – 任何针对该单位的附加说明
5。 方法论
鉴于此类相对简单的性质，我们可以使用 JSON 或 CSV 集成将单位导入 V5。我们将从进行初始导入的角度来看待这一点，以将任何缺失的单位带入系统 (weightUnit)，之后我们将使用系统中的单位 (UnitCommodity) 分配商品特定的转换。再次注意，任何端点/类均无法导出。
6. 重量单位
6.1. JSON – 导入
6.2. JSON – 导出
‘WeightUnit’类没有可用的 JSON 导出功能。
6.3. CSV – 导入
标题/列定义文件名： “重量单位.csvh”
完成的头文件应放置在： “ \SG 控制中心\网关\导入\column_defs”
导入 CSV 文件名： “weightUnit-日期时间.csv”
用于导入的 CSV 应放置在： “ \SG 控制中心\网关\导入”
示例：
头文件：
头文件通常会在 CSV 集成进行之前由 SG Systems 编译，但我们可以看到下面可用于单元的一个基本示例：
有关我们如何构建这些文件的更多信息，请参阅 主集成页面.
可以下载此示例头文件 开始.
CSV 导入文件：
然后，我们可以使用标头中定义的数据点顺序来构建导入文件。 SG Systems 可以为此提供一个模板文件，列出每列的数据点，以便在填充列表时使事情变得更加清晰。 请注意，控制中心可以忽略第一行，因此在提交导入时可以将其保留在文件中。
在这里我们可以看到，我们正在创建与上面的 JSON 示例中相同的新单位，但使用小写字母作为单位代码，以便在控制中心更清楚地显示。
可以下载此示例导入文件 开始.
导入完成后，我们可以看到这些新单元再次被创建。
6.4. CSV – 导出
与 JSON 导出一样，“WeightUnit”类不提供 CSV 导出。
7. 单位商品
7.1. JSON – 导入
‘UnitCommodity’ 导入端点/URI –
http://host:port/V5-API/api/integrate/import/unit_commodity
示例：
对于此示例导入，我们将使用“UnitCommodity”端点为牛奶升添加特定单位转换。我们在上面的控制中心看到，升通常以 1:1 的比例从升转换为千克，即 1 升水重 1 千克。然而，一升牛奶的重量会略重于此（1.035 千克），因此我们将在下面了解如何为 JSON 导入设置此单位。
因此，我们在这里告诉系统，当使用牛奶时，使用的转换率将是 1.035，覆盖 ltr 单位的默认转换率。
可以下载此示例 JSON 文件 开始.
使用上述文件，我们可以看到，我们针对牛奶的具体转换率已经添加到“升”的下方面板中。
7.2. JSON – 导出
“UnitCommodity”类没有可用的 JSON 导出。
7.3. CSV – 导入
标题/列定义文件名： “单位商品.csvh”
完成的头文件应放置在： “ \SG 控制中心\网关\导入\column_defs”
导入 CSV 文件名： “unitCommodity-日期时间.csv”
用于导入的 CSV 应放置在： “ \SG 控制中心\网关\导入”
示例：
头文件：
在进行 CSV 集成之前，SG Systems 通常会编译头文件，但我们可以在下面看到一个可用于商品特定单位转换的示例：
有关我们如何构建这些文件的更多信息，请参阅 主集成页面.
可以下载此示例头文件 开始.
CSV 导入文件：
然后，我们可以使用标头中定义的数据点顺序来构建导入文件。 SG Systems 可以为此提供一个模板文件，列出每列的数据点，以便在填充列表时使事情变得更加清晰。 请注意，控制中心可以忽略第一行，因此在提交导入时可以将其保留在文件中。
在这里我们可以看到，我们正在创建与上面的 JSON 示例中相同的商品特定单位转换。
可以下载此示例导入文件 开始.
导入完成后，我们可以看到再次创建了这个新的商品特定单位转换。
7.4. CSV – 导出
与 JSON 导出一样，“UnitCommodity”类不提供 CSV 导出。
