QAD Adaptive ERP 集成指南：使用 SkyPlanner APS 进行生产排程

QAD 为外部排程系统提供三种接入方式：

1. QAD QXtend Inbound (QXI)。QAD 将其描述为 “a Web services-based, SOAP-compliant, XML framework, enabling complete platform-independent access to QAD Enterprise Applications business functionality.”（基于 Web 服务、符合 SOAP 标准的 XML 框架，可不受平台限制地完整访问 QAD Enterprise Applications 的业务功能。）每个请求都是一个 QDoc，用于运行 QAD 程序，执行与界面操作相同的校验，并返回一个响应 QDoc。已发布的 QDoc 包括 maintainItemMaster、maintainRouting 和 maintainPurchaseOrder。对于尚无已发布 QDoc 的程序，可通过 QAD 的 QGen 工具映射菜单程序：”QGen is used to map custom programs or QAD Enterprise Applications programs that do not have released QDoc schemas and events files.”（QGen 用于映射尚无已发布 QDoc 架构和事件文件的自定义程序或 QAD Enterprise Applications 程序。）QAD 自身也采用这种方式：”QAD Production Scheduler uses QAD QXtend to update work orders.”（QAD Production Scheduler 使用 QAD QXtend 更新工单。）（QXtend 指南）
2. QAD QXtend Outbound (QXO)。QXO “exports user-configurable business objects as XML QDocs out of QAD products.”（将用户可配置的业务对象以 XML QDoc 形式从 QAD 产品中导出。）标准业务对象包括 Item、Product Structure、Routing、Work Center、Department、Inventory Transaction 和 Inventory Status。
3. 业务单据 REST API。从 Adaptive ERP 2022.1 开始，”Query REST APIs are now available for business documents,”（业务单据现已支持查询 REST API），提供筛选、排序、分页和部分数据返回功能，相关文档可在您的实例中通过 Swagger 查看（版本说明）。

QXtend 负责写入。QXO 和 REST 查询 API 负责读取。

QXtend Outbound 是 QAD 的数据变更机制。”A change occurs to watched data in QAD Enterprise Applications. Change notifications are written out to the qxevents database.”（QAD Enterprise Applications 中受监控的数据发生变更后，变更通知会写入 qxevents 数据库。）随后，QXO 生成 QDoc，并将其发送 “to a directory location where the subscriber polls for and picks up new QDocs,”（至一个目录，由订阅方轮询并获取新的 QDoc），或发送至在某个 URL 上监听的 Web 服务。

SkyPlanner 以 Web 服务的形式订阅 QXO 发布的数据；对于 QXO 未覆盖的数据，则通过 REST 查询 API 轮询获取。Work Order 并非 QXO 的标准业务对象，因此集成时需在工单表（wo_mstr、wr_route）上添加 QXO 业务对象，或每隔几分钟通过 REST 查询 API 轮询工单。

状态或排程发生变化时，SkyPlanner 会发送 webhook，因此回写采用事件驱动方式。

1. 首次加载主数据。通过 QXO 或 REST 查询 API 读取物料、产品结构、工艺路线、工作中心和日历。需仔细确定工作中心的映射方式：包含四台机器的工作中心，可以映射为一个工作中心组，也可以映射为四个工作中心。Production Line Maintenance 中的重复生产线也可以映射为工作中心。

2. 同步工单。读取处于确认计划状态和已下达状态的工单及其工艺路线、组件，同时读取未结采购订单。SkyPlanner 将已订购的物料视为在采购订单交货日期可用，并在采购订单标记为 Delivered 时更新库存。

排程对象是工单，而不是 MRP 计划订单。计划订单需先在 QAD 中转为已确认计划或已下达的工单。

3. 回写排程。引擎安排订单或调整其时间时，SkyPlanner webhook 会触发针对 Work Order Maintenance (16.1) 的 QXtend Inbound QDoc，将下达日期设为首道已排程工序的日期，将到期日期设为最后一道工序的日期。QXtend 运行程序时会执行 QAD 自身的校验，并返回响应 QDoc，由集成程序检查。

每台机器上的工序顺序保留在 SkyPlanner 中，并通过 Mobile Confirmations 传达给操作人员。这样，集成就不会受到 QAD 对已下达订单冻结工艺路线的限制。

4. 车间报工。操作人员使用 SkyPlanner Mobile Confirmations 或 Production Timer 记录作业，工时记录用于及时更新排程。您可以选择是否将实际工时回传至 QAD。如果回传，则将各工序的准备时间和加工时间写入 Labor Feedback by Work Order，将完工数量写入 Work Order Receipt；如果不回传，则仍按原有方式在 QAD 中录入工时。

5. 数据归属与冲突处理规则。上线前应以书面形式明确以下规则：

工单日期只能由一个系统写入。SkyPlanner 不依赖 QAD 排程模块，因此，对于由它排程的订单，日期将由 SkyPlanner 写入，不再由排程工作台或其他排程系统写入。

• 重新运行 CRP。CRP 会重新安排所选工单的所有未完工工序。QAD 仅在满足以下条件时才会保留手动设置的日期：”you also adjusted the work order release and due date to match,”（您也相应调整了工单的下达日期和到期日期），这正是 SkyPlanner 写回的内容。请在写回后运行 CRP，或排除由 SkyPlanner 排程的订单。
• 已下达工单的工艺路线不可更改。“Once the work order status is Exploded, Allocated, or Released, no more changes can be made to the routing.”（一旦工单状态为 Exploded、Allocated 或 Released，就不能再修改工艺路线。）请在工单下达时读取工艺路线，仅对计划或确认计划状态的订单修改工艺路线。
• 工艺路线的时间单位。准备时间和运行时间计入负荷，而 “queue, wait, and move times are excluded from load calculations.”（排队、等待和搬运时间不计入负荷计算。）请在 SkyPlanner 中将排队、等待和搬运建模为仅计时的步骤，并确认运行时间是按单位产品还是按订单计算。
• QXtend 吞吐量。QAD 提醒：”UI API adapter performance may be unacceptable when processing high volumes of data or real-time transactions.”（处理大量数据或实时事务时，UI API 适配器的性能可能无法满足要求。）请仅分批发送有变更的订单，并在有原生 QDocs 时使用原生 QDocs。
• 域与站点。在多域 QAD 环境中，工作中心和工单按域和站点分别管理。请将集成范围内的每个站点映射到各自的工作中心组。
• 重复制造与离散制造混合生产。Advanced Repetitive 产线使用重复生产计划，而非工单。请在范围评估阶段确定由 SkyPlanner 为哪些产线排程。