SkyPlanner 团队会在上线准备期间，根据您的 IFS Cloud 配置完成集成设置，并在上线后提供支持。本指南适用于希望参与集成，或自行基于 SkyPlanner REST API 进行开发的合作伙伴和开发人员。该 API 的文档见API 参考。
IFS Cloud 集成方式
OData 投影（RESTful API）。
IFS Cloud 通过 OData 投影公开业务逻辑。”Projections are exposed in the /ifsapplications/projection/ endpoint,”（投影通过 /ifsapplications/projection/ 端点公开），具体使用 main、int 还是 b2b 端点取决于投影类型。典型路径从 /main/ifsapplications/ 开始，经过投影版本，指向投影的 .svc 服务及其实体集。每个投影都会发布 OData 元数据，即 “a machine-readable description of the data model of the APIs.”（对 API 数据模型的机器可读描述）。（来源）
API Explorer。
IFS Cloud 网页客户端会列出当前环境中的所有投影，并提供相应的 API 文档和 OpenAPI 规范。集成应使用 Premium APIs 和 Entity Service APIs，而不是客户端页面背后的 UI 投影。Premium APIs 采用版本管理：”The old version of the projection will still be retained along with the new version till the next release.”（投影的旧版本会与新版本一同保留，直到下一个版本发布。）（来源）
IFS Connect。
集成代理负责将消息路由至 HTTP/REST、文件及其他地址。IFS 文档指出：”Modern integration use web services together with IFS Connect and/or 3rd party integration tools.”（现代集成将 Web 服务与 IFS Connect 和/或第三方集成工具结合使用。）（来源）IFS 文档也介绍了通过 Boomi 等中间件进行集成的方式。
文件。
Data Migration Manager、File Migration 和 Excel Migration 任务可用于批量加载数据。试用期间，普通的 Excel 导出文件即可满足需要。
身份验证
外部集成通过 IFS Identity and Access Manager（IAM），使用 OAuth 2.0 和 OpenID Connect 进行身份验证：
- 为 SkyPlanner 注册一个 IAM Client，并使用 Client Credentials 流程。该流程 “allows for a non-interactive authentication of a service account”（允许对服务账户进行非交互式身份验证），并且 “yields an access token associated with a service user.”（生成与服务用户关联的访问令牌）。
- 通过
POST https://<SYSTEM_URL>/auth/realms/<NAMESPACE>/protocol/openid-connect/token请求令牌。 - 仅为服务用户分配集成所需读写的投影权限集，不授予额外权限。
（来源）
SkyPlanner 端的 REST API 使用 API 令牌进行身份验证（SkyPlanner Settings > API），并提供 Swagger/OpenAPI 文档。集成教程会逐步指导您完成最初的 API 调用。
事件与变更检测
IFS Cloud 提供事件框架：”Events can be used to automate actions within IFS Cloud.”（事件可用于自动执行 IFS Cloud 内的操作。）创建、更新或删除实体时会触发自定义事件，相应操作通过 IFS Connect 执行。（来源）
出站消息由 REST Sender 处理：”Outbound messages can be sent either synchronously or asynchronously,”（出站消息既可同步发送，也可异步发送），路由在 IFS Connect 中配置。（来源）Workflow Manager 也可以调用 REST 端点。
可采用以下两种模式：
- 事件驱动。为车间订单及其工序的变更设置自定义事件，触发 REST Sender 向 SkyPlanner 的 REST API 发送消息。
- 轮询。SkyPlanner 每隔几分钟从投影读取未结车间订单，仅筛选发生变更的记录。
先采用轮询，再为变更最频繁的对象添加事件。状态或排程发生变化时，SkyPlanner 会发送 webhook，因此回写端采用事件驱动模式。
数据映射
投影名称因版本而异。请以您环境中 API Explorer 列出的确切名称为准。
| IFS Cloud 对象 | SkyPlanner 对象 | 方向 | 频率 |
|---|---|---|---|
| Inventory Part（站点级） | 产品和物料 | IFS → SkyPlanner | 首次加载，此后在变更时同步 |
| Product Structure（表头、替代方案、明细行） | 产品结构、子产品、各产品所需物料 | IFS → SkyPlanner | 首次加载，此后在变更时同步 |
| Routing、Routing Operations：准备时间、加工时间、转移时间、效率 | 工艺步骤及其持续时间、准备时间和拆卸时间 | IFS → SkyPlanner | 首次加载，此后在变更时同步 |
| Work Center、Work Center Resource：日历、利用率、效率 | 工作中心、工作中心组、效率 | IFS → SkyPlanner | 首次加载，此后很少更新 |
| Labor Class 人员；工序所需班组人数 | 人员及其班次；每项生产任务所需操作员人数 | IFS → SkyPlanner | 首次加载；班次仅在一个系统中维护 |
| Manufacturing Tool、工具组 | 作为有限共享资源的工具 | IFS → SkyPlanner | 首次加载 |
| Shop Order（Released、Reserved、Started）及其 Shop Order Operations 和物料：Need Date、Earliest Start Date、优先级 | 订单和生产任务及其交期与物料需求 | IFS → SkyPlanner | 事件触发或每隔几分钟轮询 |
| 库存物料可用量 | 库存结余 | IFS → SkyPlanner | 每小时或运行排程时轮询 |
| 采购订单行及其计划收货信息 | 采购订单及其预计交付日期；标记为 Delivered 时更新库存 | IFS → SkyPlanner | 每小时或运行排程时轮询 |
| Shop Order Operation：开始时间、完成时间、工作中心资源 | 每道工序的计划开始时间、计划结束时间及工作中心 | SkyPlanner → IFS | 排程变更时，通过 SkyPlanner webhook 同步 |
| 工序报工（机器工时、人工工时、数量） | 工时记录和操作员确认 | SkyPlanner → IFS | 若在范围评估中选定此项，则按每次确认或每个班次同步 |
| 在 SkyPlanner 中设置 | 准备时间矩阵、替代设备和人员 | 在 SkyPlanner 中维护 | 在上线准备期间设置 |
集成方式
1. 首次加载主数据。拉取库存物料、可制造的产品结构、工艺路线及其工序、工作中心及其资源、工种和工具。逐一确定每项工作中心资源与 SkyPlanner 工作中心的映射关系。对于包含三个资源的工作中心，需要决定将其映射为一个工作中心组，还是三个工作中心。
2. 同步车间订单。读取状态为 Released、Reserved 和 Started 的车间订单及其工序和物料。将 Planned 状态的车间订单留给 MRP 处理，因为每次运行计划时，这些订单都会变化。同时导入库存物料可用量和未结采购订单行，让排程同时检查现有库存和采购在途物料。SkyPlanner 将已订购物料视为在采购订单交付日期可用。
3. 回写排程。对于排程引擎安排或调整的每道工序，SkyPlanner 都会将计划开始时间、计划完成时间及工作中心资源写入车间订单工序。回写通过您环境中 API Explorer 列出的车间订单工序投影完成，因此会执行 IFS 自身的验证。数量、状态和成本仍由 IFS 管理。
4. 车间报工确认。每个站点只选择一种报工渠道。操作员可以继续在 Shop Floor Workbench 中报工，由 SkyPlanner 读取进度。也可以使用 SkyPlanner Mobile Confirmations 和 Production Timer 记录作业，再通过范围评估中约定的工序报工投影，将工时记录提交至 IFS。
5. 数据归属与冲突处理规则。上线前应以书面形式明确以下规则：
| 数据 | 负责管理的系统 |
|---|---|
| 库存物料、产品结构、工艺路线、数量、车间订单状态 | IFS Cloud |
| 工序顺序、开始和完成时间、资源分配 | SkyPlanner |
| 准备时间矩阵、工具和操作人员要求、替代资源 | SkyPlanner |
| 班次和缺勤 | 由一个系统管理，在范围评估时确定 |
| 工序报工和收货 | IFS Cloud，数据来自 Shop Floor Workbench 或 SkyPlanner 工时记录 |
冲突主要来自 IFS 内部的重新排程。如果计划员使用 Infinite Scheduler 重新安排了生产订单，应将其视为新版本，重新同步，再由 SkyPlanner 重新排程。启用 Autopilot 后，生产发生变化时，SkyPlanner 会自动重新排程。对于同时运行 MSO 的工厂，需要明确每个排程工具负责哪些工作中心。
典型项目步骤
实施通常在上线准备工作启动后数周内完成，大型企业也不例外。在此之前，您可以使用自己的数据进行 30 天免费试用：将 IFS Cloud 中的工作中心、工艺路线和未结生产订单导出为 Excel 文件，然后导入 SkyPlanner。
- 数据映射。确定映射表、数据归属规则、同步频率和报工渠道。
- IAM 与权限。注册 IAM 客户端，创建服务用户，并授予相应的投影权限集。先在沙箱环境中配置，再部署到生产环境。
- 初始数据加载。加载库存零件、产品结构、工艺路线、工作中心、工种和工具。
- 生产订单和采购订单同步。先采用轮询，变更量较大时再使用自定义事件。
- 在 SkyPlanner 中设置约束。配置准备时间矩阵、工具、操作员人数，以及可替代的设备或人员。
- 排程回写。将工序日期和资源回写到生产订单工序中。
- 并行测试。让 SkyPlanner 与现行计划并行运行，对比日期，修正主数据。
- 上线。数据核对一致后，启用回写。
IFS Cloud 集成需要提前考虑哪些问题
- 设备时间与人工时间。生产订单工序分别记录设备和人工的准备时间、运行时间，以及班组人数。必须明确各工作中心的工序时长以哪一种时间为准，否则每道工序的时长都会出错。
- 利用率和效率重复计算。在 IFS 中，工作中心利用率、工序效率和资源效率都会缩短可用时间。将它们映射到 SkyPlanner 的工作中心效率时，只计入一次。
- 产能数据过时。只有运行 Calculate Work Center Resource Capacity 后，才会生成资源产能数据。初始数据加载前，请检查日历和有效期。
- Preferred Resource 仅表示优先选择。实际可用的替代资源应在 SkyPlanner 中明确建模为替代工作中心。
- UI 投影会变化。应基于 Premium APIs 或 Entity Service APIs 构建集成，这些 API 会将上一版本保留到下次发布。每年发布两次，每次发布时都应重新测试。
- Shop Floor Workbench 投影用于界面流程。为 Shop Floor Workbench 助手构建的投影不适合直接用于事务集成。应在范围评估阶段选定报工投影。
由谁配置集成
配置工作包括与您的工艺路线、工作中心和 IFS 配置进行映射。还包括设置 SkyPlanner 在按实际产能排程时需要遵守的约束：准备时间矩阵、工具、操作员人数和替代资源。
- SkyPlanner 团队在上线准备阶段完成配置，并在上线后提供支持，范围涵盖 SkyPlanner 端及双方约定的 IFS 投影。每家工厂使用 IFS Cloud 的方式都不同，这些实际经验会体现在集成配置中。
- 您的 IFS 合作伙伴也可以参与。合作伙伴熟悉您的配置，可以与团队一起设置 IAM 客户端、权限集和事件。SkyPlanner 提供 REST API、Swagger/OpenAPI 文档和 webhook。
- 您自己的开发人员也可以在此基础上开发，使用 API 令牌调用同一套有文档说明的 REST API。只需一个 API 令牌即可开始，SkyPlanner 团队会在需要时提供协助。公开文档请参阅 SkyPlanner 集成文档。
SkyPlanner 每月 199 € 起，包含 5 个工作中心，按月计费。集成将根据您的流程和需求，与所选套餐一并提前报价，让您在开始前了解全部费用。要了解它与 IFS 自带排程功能的对比，请参阅 IFS Cloud 生产排程。集成概览见 IFS Cloud 页面，其他 ERP 的集成信息见 ERP 集成中心。
制造企业对 SkyPlanner 的评价
2 小时每周节省的时间
“SkyPlanner 让我们的生产计划从 Excel 电子表格转向了实时生产优化。”
Kalle Kalliomäki，供应链专员
UTU · 配电盘与开关设备
生产计划工作每周节省 2 小时，新的任务队列只需几秒就能下达到产线。
+90%生产效率提升
“生产效率提高了 90%。”
Abdul Rucyinga，IT 负责人
Laboratory & Allied · 制药
生产效率提高了 90%，为所有工作中心生成覆盖三个月的优化计划，用时不到 30 分钟。
99.2%准时交付率
“SkyPlanner 让生产瓶颈清晰可见，也让生产管理更加清楚有序。”
Toni Tuori，生产经理
Piristeel · 屋面安全设施与雨水系统
今年准时交付率达到 99.2%，每天在排程工作上最多可节省四小时。
减少因缺料导致的停工
“SkyPlanner 给我们带来的价值在于，它在日常工作中真正实用，尤其是在确定交期时。”
Tommi Männistö，生产计划经理
Eskomatic · 受托机械加工
自动负荷排程让交期更加准确，因物料短缺导致的停工也大幅减少。
常见问题
排程集成应使用哪个 IFS Cloud API？
使用 /ifsapplications/projection/ 下的 OData 投影，优先选择 API Explorer 中列出的 Premium 或 Entity Service API。这些 API 为每个环境提供 OpenAPI 规范，并将上一版本保留到下次发布。
由谁构建 IFS Cloud 集成？
SkyPlanner 团队会在导入阶段，根据您的 IFS 配置完成双向集成，并在上线后提供支持。您的 IFS 合作伙伴或内部开发人员也可以基于 SkyPlanner 有文档说明的 REST API 进行开发，只需一个 API 令牌即可开始。
集成使用哪种身份验证方式？
IFS 端使用采用 OAuth 2.0 Client Credentials 流程的 IFS IAM 客户端，并关联一个服务用户，该用户需拥有访问所需投影的权限集。SkyPlanner 自身的 API 使用 API 令牌。
IFS Cloud 能实时推送生产订单变更吗？
可以。通过实体变更的自定义事件和 REST Sender 实现，两者都在 IFS Connect 中配置。建议先每隔几分钟轮询一次，再为变更量大的环节添加事件。SkyPlanner 的 webhook 会在排程变化时即时推送。
这项集成需要 MSO 或 PSO 吗？
不需要。SkyPlanner 直接从 IFS 投影读取生产订单、工序和工作中心，自行生成符合实际产能约束的排程。您无需开通 MSO，也无需 PSO Cloud Service 或 IFS.ai Activation Pass，更不用规划令牌用量。每次发生变化时，Autopilot 都会自动重新排程。
