工作/生产订单
您的 V5 集成指南！
V5 Traceability 与客户 ERP 系统之间作业/生产订单的集成允许在 V5 Traceability 内安排批次和产品配方的工作订单。 这些详细信息将允许 V5 终端处理这些作业。
目录
1. 控制中心布局
关于如何将作业详细信息与我们在控制中心中看到的内容相关联，我们将主要使用 V5 API 填充上方的“作业”面板以导入和导出这些详细信息，并在下方的“作业行”面板中提供信息根据配方/配方设置自动填充。
使用 V5 网关，我们可以使用以下命令轻松填充此处的数据 ‘Job’ 端点。 然而，可以采取更先进的方法，利用 ‘PreBatch’ 端点。 我们将在下面考虑使用这两种方法。
2.API链接
3. 集成模板
可以下载作业/生产订单的集成模板 开始.
4. 作业/生产订单现场指南
4.1. 主键
主键是 V5 API 中每个表的唯一标识符。 为了 Job， 这些都是：
jobNumber – 作业的唯一识别代码。
formula.commodity.code – 要安排的配方的唯一识别代码。
对于 PreBatch，主键是：
jobLine.job.jobNumber – 如上所述，该作业的唯一识别代码。
BatchSeq – 该特定作业线的批次生产顺序。
4.2. 必填字段
SG 需要其他字段来填充控制中心中的有效作业行。 为了 Job， 这是：
products – 此作业的顶（作业）行每批次所需的产品数量（与配方的基本计量单位相关）。
对于 PreBatch， 这是：
products – 单个批次应生产的产品数量。
4.3. 首选字段
首选字段用于针对相关作业添加更多信息，虽然不是必需的，但在 V5 Traceability 中添加功能时非常有用。 为了 Job，这些可能包括：
batchesRequired – 作业所需的批次数。 如果不存在，则系统将使用产品数量（如上所述）和 基本尺寸 + 最小/最大产品 计算要生产的批次数。
status – 导入作业的状态（0 = 待处理、1 = 已计划、2 = 进行中、3 = 完成、4 = 测试、5 = 暂停），作业通常会以状态“1”导入，除非稍后要手动安排它们，因此可以以“0”状态导入。
这些领域也可以适用于 PreBatch 一旦我们遍历到 API 中的作业对象。
4.4. 附加字段
还可以包含其他字段 Job 端点，例如：
productionDate – 作业的制作日期。 如果不存在，则将导入为空白，从而允许终端始终看到作业。
对于 PreBatch, 我们可以遍历到同一个字段 jobLine.job.productionDate。 不过，我们也可以使用 jobLine.productionDate 字段影响单个作业线的生产日期，而不是整个作业本身，使我们能够更严格地控制生产过程。
5。 方法论
根据集成所使用的方法，我们可以使用以下端点来促进导入。 这可以是：
- ‘Job’ or ‘Prebatch’ JSON 集成的端点。
- ‘Job’ CSV 文件共享集成的端点。
出口可以通过多种方式处理，我们将在下面介绍所有这些方式。
5.1. JSON – 导入
职位：
我们可以利用 ‘Job’ 端点用于在 V5 Traceability 中创建新的生产作业。
‘Job’ 导入端点/URI –
http://host:port/V5-API/api/integrate/import/job
对于此示例导入，使用 ‘Job’ 端点，我们可以为单个作业构造一个基本导入文件，如下所示：
可以下载此示例 JSON 文件 开始.
使用 API 手册，我们可以在这里看到我们正在使用 ‘Job’ 类来构造此文件。 然而，为了正确回忆我们想要生成的公式代码，我们需要首先遍历到 ‘Formula’ 类，然后使用 ‘Commodity’ 类来定义 ‘Code’ 我们可以使用的数据点，然后将其适当地嵌套在 JSON 文件中，如上所示。
我们可以在下面看到这个数据流过程的摘要：
如果我们运行上面的 JSON 文件，我们将看到我们的作业现在在控制中心的“生产”选项卡中可见。
您会注意到这已在下部面板中自动创建作业行。 这 ‘Job’ 端点将根据以下内容自动执行此操作 公式结构.
预批：
我们可以看到上面我们可以使用 ‘Job’ 端点将简单作业输入到 V5 Traceability 中的生产计划中。 但是，如果我们想要更精确地控制我们的作业设置，我们可以利用 ‘PreBatch’ 取而代之的是 URI。 这使我们能够指定详细信息，例如单个批次大小/产品数量和生产地点。
‘PreBatch’ 导入端点/URI –
http://host:port/V5-API/api/integrate/import/pre_batch
对于此示例导入，使用 ‘PreBatch’ 端点，我们可以为具有多个批次的单个作业构建基本导入文件，如下所示
可以下载此示例 JSON 文件 开始.
因此，通过检查此文件，我们可以看到，我们正在创建一个新作业 (Job-111)，其中包含 2 批“基本面包面团”配方，其中一批 30 磅，将在制造 1 中制作，另一批 50 磅，将在制造 2. 如果我们查看 API 手册 ‘PreBatch’ 类，那么我们可以在这里看到类似的遍历方法来构造我们的文件。
如果我们运行上面的 JSON 文件，那么我们将看到创建的这个新作业，然后如果我们查看它的批次视图，我们将看到批次大小/生产位置的差异，以及我们预设的自定义批号。 如果需要，批量测序也可以包含在此处。
5.2. JSON – 导出
在从 V5 API 接收与作业相关的文件方面，我们可以使用 IntegrationExport 和 ExportTransaction 类中的一些不同选项，我们将在此处查看这些选项。
职位：
单个作业导出端点/URI –
http://host:port/V5-API/api/integrate/export/job/{jobNumber}
此端点将导出一个 JSON 文件，其中包含指定作业的所有相关信息。 如果我们使用刚刚导入的作业的作业编号运行此请求，我们将得到一个如下所示的文件：
可以下载此类型的示例 JSON 文件 开始.
所有职位：
所有作业导出端点/URI
http://host:port/V5-API/api/integrate/export/jobs
此端点将导出一个 JSON 文件，其中包含所有 要积极。 系统中的作业，定义为状态不是“已完成”或已从控制中心删除的作业。
如果我们运行此请求，我们将收到一个返回 JSON 文件，其结构与上述单个作业的导出非常相似，但如上所述将包括所有活动作业。
可以下载此类型的示例 JSON 文件 开始.
我们还可以利用 事务和日志端点 检索有关作业和生产订单的更多相关信息。
对于 系统日志 端点，这些是：
5.3. CSV – 导入
标题/列定义文件名： “job.csvh”
完成的头文件应放置在： “<installdir>\SG Control Center\gateway\import\column_defs”
导入 CSV 文件名： “job-datetime.csv”
用于导入的 CSV 应放置在： “<installdir>\SG Control Center\gateway\import”
头文件：
头文件通常会在 CSV 集成之前由 SG Systems 编译，但我们可以看到一个可用于作业的基本示例，使用之前定义的 类定义，下面：
有关我们如何构建这些文件的更多信息，请参阅 主集成页面。 可以下载此示例头文件 开始.
CSV 导入文件：
然后，我们可以使用标头中定义的数据点顺序来构建导入文件。 SG Systems 可以为此提供一个模板文件，列出每列的数据点，以便在填充列表时使事情变得更加清晰。 请注意，控制中心可以忽略第一行，因此在提交导入时可以将其保留在文件中。
作业的 csv 导入文件示例可能如下所示：
可以下载此示例导入文件 开始.
导入完成后，我们可以看到这些附加作业已与我们使用上面的 JSON 导入创建的作业一起添加到控制中心。
5.4. CSV – 导出
与 JSON 导出一样，我们这里有几个不同的选项。 我们可以从简单地导出系统内的作业列表开始：
工作/日程：
导出 CSV 文件名： “job.csvh”
完成的头文件应放置在： “<installdir>\SG Control Center\gateway\export/order”
导出 CSV 文件名： “job-datetime.csv”
用于导出的 CSV 将在以下位置生成： “<installdir>\SG Control Center\gateway\export”
我们可以使用之前定义的类定义来构建头文件来定义我们将返回哪些数据。
需要在控制中心的网关部分启用此导出。 我们可以在这里选择导出“Schedule”。
头文件：
在这种情况下，我们只使用上面用于导入的相同头文件：
CSV 导出文件：
我们将得到一个返回 CSV 文件，如下所示：
可以下载此文件类型的示例 开始。 请注意，如果指定文件夹中不存在标头文件，则将导出 CSV，其中包含标头文件中的所有数据点 ‘Job’ 类。
虽然此端点仅导出作业列表，但我们可以使用几个不同的端点来检索与消费和生产相关的更详细信息。
批量日志：
导出 CSV 文件名： “BatchLog-datetime.csv”
用于导出的 CSV 将在以下位置生成： “<installdir>\SG Control Center\gateway\export”
以 CSV 形式从 V5 Traceability 获取作业生产数据的最简单方法是简单地使用和处理“批处理日志”。
同样，还需要在控制中心的网关部分启用此导出。 我们可以在这里选择导出“批量日志”。
CSV 导出文件：
我们不需要在这里构建头文件，因为 V5 网关默认会填充一组数据点列表。 启用此导出后，系统将导出 ‘BatchLog’ 每次系统完成作业中的批次时都会归档。 下面显示了一个基本示例：
可以下载此文件类型的示例 开始.
系统日志：
如果我们想接收更多定制或详细的作业生产数据 (‘CONSUMED’/’PRODUCE’) 不过，从 V5 Traceability 回来，我们可以利用 ‘SystemLog’ 端点来执行此操作。
标题/列定义文件名： “SystemLog.csvh”
完成的头文件应放置在： “<installdir>\SG Control Center\gateway\export\order”
导出 CSV 文件名： “SystemLog-datetime.csv”
用于导出的 CSV 将在以下位置生成： “<installdir>\SG Control Center\gateway\export”
对于使用此端点的这种类型的导出，我们将使用以下结构我们的标头 ‘SystemLog’ 数据库类定义.
与上面的其他示例一样，需要在控制中心的网关部分启用此导出：
头文件：
从这里，我们可以根据我们想要接收回 ERP 的与作业相关的事务数据来构建标题。 出于我们的目的，这可能如下所示：
可以下载此示例头文件 开始.
CSV 导出文件：
如果我们随后运行一个简单的批处理，则系统日志导出将如下所示：
此示例导出可以下载 开始.
