DELMIAWorks 集成指南：使用 SkyPlanner APS 进行生产排程
本指南面向合作伙伴和 IT 团队，介绍如何将 DELMIAWorks（原 IQMS）接入 SkyPlanner APS。SkyPlanner 通过 DELMIAWorks WebAPI 与 DELMIAWorks 实现双向集成：
- 导入工单、包含零件工序的制造清单、工作中心、工具和模具、库存物料、库存量及采购订单。
- 将计划开始日期、结束日期及分配的工作中心回写到工单。
- 良品数量可作为生产记录过账，准备时间和运行时间可作为任务工时过账到 Time & Attendance。
- 排程发生变化时，SkyPlanner webhook 会即时推送。
在实施导入期间，SkyPlanner 团队会根据您的 DELMIAWorks 配置，通过 REST API 配置集成，并在上线后继续提供支持。本指南面向希望参与集成的合作伙伴和开发人员，也适用于希望依据 SkyPlanner 的 REST API 文档（API 参考）自行开发的团队。
DELMIAWorks 集成接口
DELMIAWorks 文档说明：”WebAPI includes both the API SDK for GRAPHQL APIs and WebAPI SDK for REST APIs”（WebAPI 同时包含用于 GRAPHQL API 的 API SDK 和用于 REST API 的 WebAPI SDK）（WebAPI 资料表）。REST 接口按模块和控制器组织。排程集成会用到以下接口：
- Manufacturing WorkOrders: WorkOrder, WorkOrders, ScheduledWorkOrders, UnscheduledWorkOrders, CreateWorkOrder, UpdateWorkOrder, UpdateWorkOrderEx, WorkOrderReleases, InventoryItemsForWorkOrder, SalesOrdersForWorkOrder.
- Manufacturing Schedule: RunAutoLoad, RemoveFromSchedule, NextSetup, GetSetupTemplateChecklists.
- Manufacturing WorkCenters: WorkCenter, WorkCenters, WorkCenterDetails, RunningWorkOrder, PMEquipment.
- Manufacturing BOM: BillOfMaterials, BomLabor, PartOperations, StandardOperations, BOMComponents.
- Manufacturing Inventory: InventoryItems, AddProductionRecords, InventoryProductionReportsByWorkOrder.
- Manufacturing Realtime: GetWorkCenterSchedule, ActualCavity, GetSetupTime, RealTimeData.
- Manufacturing Downtime: AddDownTime, CloseDownTime.
- PO Receiving: POs, POLineItems, POReleaseItems, POReceipts.
- Time & Attendance: TimeClock (LogInOut, TaskClockLogin), Tasks (ClockInTATask, ClockOutTATask, UpdateGoodParts), EmployeeCalendar.
GraphQL SDK 适合批量读取，例如首次加载物料和 BOM。所有写入操作均通过 REST 控制器完成。
身份验证与许可
在 DELMIAWorks 端，创建专用的集成用户，并确认您的环境已获得 WebAPI 许可且已完成安装。Realtime 模块提供 AuthToken 控制器，使用集成用户的凭据即可建立 WebAPI 会话。具体版本所需的配置由您的 DELMIAWorks 合作伙伴确认。
在 SkyPlanner 端，每次调用都需在 Authorization-Token 请求头中携带 API 令牌。您可以在 SkyPlanner 的“设置 > API”下创建令牌。有了 API 令牌即可开始开发。
事件与轮询
每次排程变更时，SkyPlanner 都会发送 webhook，因此计划调整会随即回写到 DELMIAWorks。
要获取 DELMIAWorks 中的变更，请轮询 WebAPI。每隔几分钟读取 ScheduledWorkOrders 和 UnscheduledWorkOrders，采购订单和库存物料则以较长周期读取。在合作伙伴实施的项目中，DELMIAWorks 内置的警报与动作引擎 IQAlert 可根据事件触发动作。
数据映射
| DELMIAWorks 对象（接口） | SkyPlanner 对象 | 方向 | 频率 |
|---|---|---|---|
| 库存物料（InventoryItems） | 产品和物料 | DELMIAWorks → SkyPlanner | 首次加载，之后轮询 |
| 制造清单、BOM 组件（BillOfMaterials, BOMComponents） | 产品结构、各产品所需物料 | DELMIAWorks → SkyPlanner | 首次加载，之后在变更时同步 |
| 零件工序、标准工序、BOM 人工（PartOperations, BomLabor） | 工序及其时长、准备时间、操作人员数量 | DELMIAWorks → SkyPlanner | 首次加载，之后在变更时同步 |
| 工作中心：成型机、挤出机、生产单元（WorkCenters, WorkCenterDetails） | 工作中心、工作中心组、效率 | DELMIAWorks → SkyPlanner | 首次加载，之后很少同步 |
| 工具与模具、家族模具、型腔（BOM, ActualCavity） | 作为有限资源的工具、每周期产量 | DELMIAWorks → SkyPlanner | 首次加载，之后在变更时同步 |
| Shop Calendar、员工日历（EmployeeCalendar） | 班次、人员、缺勤 | DELMIAWorks → SkyPlanner | 每日同步，或在 SkyPlanner 中自行维护班次 |
| 工单及分批下达明细（WorkOrders, ScheduledWorkOrders, UnscheduledWorkOrders） | 订单和生产任务及其交期、物料需求 | DELMIAWorks → SkyPlanner | 每隔几分钟轮询 |
| 各物料的现有库存（InventoryItems） | 库存结余 | DELMIAWorks → SkyPlanner | 每小时或运行排程时轮询 |
| 采购订单及分批交货明细（POs, POReleaseItems） | 采购订单、按交货日期列出的待到货物料 | DELMIAWorks → SkyPlanner | 每小时或运行排程时轮询 |
| 工单开始日期、结束日期及工作中心（Manufacturing WorkOrders 控制器） | 计划开始和结束时间、分配的工作中心 | SkyPlanner → DELMIAWorks | 排程变更时，通过 SkyPlanner webhook 同步 |
| 生产记录：各工单的良品数量（AddProductionRecords） | 报工确认的完工数量 | SkyPlanner → DELMIAWorks | 如选择回写，则每次报工时同步 |
| 任务工时（ClockInTATask, ClockOutTATask） | 工时记录和操作人员报工 | SkyPlanner → DELMIAWorks | 如选择回写，则每次报工或每班次同步 |
| DELMIAWorks 中无对应数据 | 换型时间矩阵、备选成型机和人员 | 在 SkyPlanner 中维护 | 在实施导入期间设置 |
集成模式
1. 首次加载主数据。读取库存物料、BOM、零件工序、工作中心和模具。工作中心映射需仔细规划：每台成型机对应一个工作中心，适用相同模具尺寸的成型机组成一个工作中心组，可相互替代。
2. 工单同步。读取未结工单及其工序和物料，同时读取未结采购订单。SkyPlanner 将已订购的树脂和嵌件视为在采购订单交货日期可用，并在采购订单标记为 Delivered 时更新库存。
3. 排程回写。当引擎安排或调整工单时，SkyPlanner webhook 会触发 Manufacturing WorkOrders 控制器更新工单。更新内容包括计划开始日期、结束日期，以及 SkyPlanner 选定的工作中心。具体字段及 Finite Schedule 看板如何随之更新，会在实施导入的范围评估阶段确定。
4. 车间报工。操作人员通过 SkyPlanner Mobile Confirmations 或 Production Timer 记录生产作业，工时记录会让排程保持更新。您可以选择是否回写实际生产数据。如果回写，良品数量通过 AddProductionRecords 过账，工时则通过 Time & Attendance 的任务接口过账。如果不回写，RealTime 和 Shopworks 继续按原有方式报工，SkyPlanner 则从 DELMIAWorks 读取进度。
5. 数据归属与冲突处理规则。上线前需将这些规则形成书面记录：
| 数据 | 主管系统 |
|---|---|
| 物料、BOM、周期时间、型腔、工单数量和状态 | DELMIAWorks |
| 工单顺序、开始和结束时间、成型机分配 | SkyPlanner |
| 换型时间矩阵、模具和操作人员需求、备选成型机 | SkyPlanner |
| 班次和非工作日 | 由一个系统管理，在范围评估时选定 |
| 产量、报废、工时和领料 | DELMIAWorks：在该系统中报工，或从 SkyPlanner 工时记录过账 |
工单日期只能由一个系统写入。对于由 SkyPlanner 排程的工作中心，请关闭 Auto Load，并停用所有运行 Update Schedule 和 Auto Load 的 IQAlert 动作。这些工作中心的近期排程应使用 SkyPlanner 的 Running Time Lock 冻结，而不是使用 DELMIAWorks 的时间栏。
典型项目步骤
实施导入启动后，通常可在数周内完成实施。在此之前，可将 DELMIAWorks 中的工作中心、BOM 和未结工单导出为 CSV 或 Excel，在 30 天免费试用期间验证排程。
- 映射。确定映射表、数据归属规则、同步频率，以及是否回传生产和工时数据。
- DELMIAWorks 访问权限。创建集成用户，确认 WebAPI 许可。先在测试数据库中测试。
- 初始数据导入。导入物料、BOM、零件工序、工作中心、模具和日历。
- 工单和采购订单同步。通过轮询同步，配合筛选和重试机制。
- 在 SkyPlanner 中设置约束。配置准备时间矩阵，将模具设为工具，并设置每项生产任务所需的操作人员数量、可替代的成型机和人员。
- 排程回写。根据 SkyPlanner webhook 更新工单；如果选择回传生产和工时数据，也一并写入。
- 并行测试。让 SkyPlanner 与现有的 Finite Schedule 并行运行，对比日期并修正主数据。
- 上线。关闭由 SkyPlanner 排程的工作中心的 Auto Load，并启用回写。
DELMIAWorks 集成需要提前考虑哪些问题
- 异件模具。一副模具在一个周期内生产多种物料。将这次生产建模为一项产出所有相关物料的生产任务，这样只需占用一次模具。
- 型腔数。某个型腔被封堵时，实际型腔数可能与标准值不同。需要确定计算时长时，是使用标准值，还是使用 RealTime 中的 ActualCavity 值。
- 模具与成型机的适配。并非每台成型机都能安装所有模具。在 SkyPlanner 中，将每副模具可用的成型机设为备选资源，确保生产任务只会转移到适配的设备上。
- 换色和换料。在准备时间矩阵中，按各个切换方向填写实际的清料和换模时间。例如，从蓝色切换到红色可能需要 30 分钟，而从红色切换到蓝色则需要 60 分钟。
- Auto Load 和时间围栏。两个排程系统同时写入日期会产生冲突。上线前，应对由 SkyPlanner 排程的工作中心禁用这两项功能。
谁负责 DELMIAWorks 集成的配置和支持
- SkyPlanner 团队在导入实施阶段完成配置，并在上线后提供支持，范围涵盖双方约定的 WebAPI 控制器。各工厂使用 DELMIAWorks 的方式各不相同，配置时就需要运用这些实际经验。
- 您的 DELMIAWorks 合作伙伴也可以参与。合作伙伴了解您的版本、自定义字段和许可情况，可以与 SkyPlanner 团队一起配置集成用户和 WebAPI。
- 您自己的开发人员也可以在此基础上开发，调用 SkyPlanner 的 REST API，并在
Authorization-Token请求头中传入 API 令牌。SkyPlanner 团队会在需要时提供协助。集成文档请参阅 SkyPlanner 集成文档。
SkyPlanner 每月 199 € 起，包含 5 个工作中心，按月计费。集成费用将根据您的流程和需求，与所选方案一并提前报价。请参阅价格、DELMIAWorks 生产排程（考虑实际产能约束）、DELMIAWorks 页面和 ERP 集成中心。
制造企业对 SkyPlanner 的评价
2 小时每周节省的时间
“SkyPlanner 让我们的生产计划从依赖 Excel 表格，转向了实时生产优化。”
Kalle Kalliomäki，供应链专员
UTU · 配电盘和开关设备
每周用于生产计划的工作时间减少了 2 小时，新的任务队列只需几秒就能下达到产线。
+90%生产效率提升
“生产效率提高了 90%。”
Abdul Rucyinga，IT 负责人
Laboratory & Allied · 制药
生产效率提高了 90%，为所有工作中心制定覆盖三个月的优化计划，用时不到 30 分钟。
98%准时交付率，原为约 50%
“SkyPlanner 对保持我们的准时交付率起着决定性作用。”
Hannu Lahtinen，总经理
KJH-Comp · 钣金加工与合同制造
准时交付率从约 50% 升至最高 98%，排程工作也从原来需要两名主管，变为现在只需一名。
6 个月销售团队可提前查看可用产能
“SkyPlanner 为所有生产计划工作奠定了基础，并提供了可靠保障。”
Anu Järvinen，生产经理
Fredman Operations · 食品级包装纸
销售团队可以提前查看未来六个月的可用产能。过去需要一小时或更久才能答复的排程变更请求，现在几秒内就能得到回复。
常见问题
SkyPlanner 使用 DELMIAWorks 的哪个 API？
使用 DELMIAWorks WebAPI。SkyPlanner 通过 REST 控制器读取数据，也可以通过 GraphQL SDK 批量读取。回写则通过 REST 控制器完成：使用 WorkOrders 控制器更新工单，调用 AddProductionRecords 以及 Time & Attendance 的任务接口。
SkyPlanner 会向 DELMIAWorks 回写哪些数据？
每张工单的计划开始和结束日期，以及分配的工作中心。如果您选择启用，还可以将合格品数量写入生产记录，并将准备时间和运行时间写入任务工时。
这项集成适用于 IQMS EnterpriseIQ 吗？
DELMIAWorks 是 IQMS EnterpriseIQ 的现用名称。这项集成使用 WebAPI，因此关键在于您的版本是否已安装 WebAPI 并获得许可。合作伙伴会在范围评估时确认这一点。
如何处理模具和异件模具？
模具在 SkyPlanner 中作为数量受限的工具管理，因此同一副模具绝不会同时用于两台成型机。异件模具的一次生产被建模为一项生产任务，产出其所有物料。每副模具可用的成型机则设为备选资源。
Auto Load 应如何处理？
对于由 SkyPlanner 排程的工作中心，应关闭 Auto Load，包括会运行该功能的 IQAlert 操作。这些工作中心的工单日期将仅由 SkyPlanner 写入。
谁负责实施集成？
SkyPlanner 团队在导入实施阶段完成配置，并在上线后提供支持。您的 DELMIAWorks 合作伙伴或内部开发人员也可以使用 API 令牌，基于 SkyPlanner 的 REST API 进行开发。
