Warehouse Task Mapping
仓储任务异常怎么定位：WMS、WCS、库位与三维设备映射
仓储任务显示“卡住”时，先分别核对 WMS 中的业务任务、WCS 中的执行反馈，以及库位和设备的对应关系。三维场景负责定位这些对象，页面应同时保留状态来源、任务标识和更新时间。订单未完成、设备空闲与通信中断可能同时出现，不能合成一个红绿状态。已有 WMS、WCS 的企业可先用一条出库链路，确认页面要帮助谁查哪一种异常，再确定开发范围。
阅读目录7 个章节
订单、任务与设备反馈为什么要分开
一张业务订单可能拆成多个仓储作业；同一作业也可能产生分段执行、取消或重试记录。具体层级由现有系统决定。对接前应与 WMS、WCS 负责人核对：哪一个编号表示业务请求，哪一个表示本次作业，哪一个表示设备执行，以及它们是一对一还是一对多。
例如，Microsoft Dynamics 365 的作业明细分别保存状态、物料、库位、数量、装载和发运标识，作业模板也支持按条件拆分作业。这说明采购时需要核对作业层级与关联字段；其他系统应使用各自的数据字典，不照搬产品字段。参考 Microsoft 作业明细说明与作业模板与库位指令说明。
WMS、WCS 和设备平台提供经授权的业务状态与执行反馈；可视化层按约定呈现来源、差异和定位入口。若需求包含下发或取消指令，应另行明确原系统接口、权限和执行确认，不能仅凭页面按钮认定已经取得设备控制能力。
任务怎样对应库位和三维设备
先记录原系统编码，再记录页面对象。模型中的节点名可以变化，业务关联应依赖维护中的对应表；同一台设备换模型后，也要能回到原设备档案。以下字段是整理资料的建议，不是任何厂家的 API 规范。
左右滚动表格，查看来源与对应内容。
| 对象 | 需要保留 | 与谁对应 | 页面如何使用 |
|---|---|---|---|
| 业务单据 | 来源系统、单据号、行号 | 一条或多条仓储作业 | 查看业务进度及受影响明细 |
| 仓储作业 | 任务标识、类型、业务状态 | 单据、起终点库位、执行记录 | 从待处理任务进入异常详情 |
| 执行记录 | 执行标识、关联任务、来源反馈 | 设备、分段或重试关系 | 区分本次执行与历史尝试 |
| 库位 | 仓库、库区、库位原编码 | 业务地址、场景中的位置对象 | 定位起点、终点及关联任务 |
| 设备 | 设备编码、状态来源、更新时间 | 执行记录、设备档案、模型节点 | 从任务定位堆垛机或输送设备 |
先用原编码完成关联核对，再增加名称、颜色和三维高亮。若某任务没有设备编号，页面可以显示“设备关联待补”并继续查看业务记录；不应按相似名称猜一台设备。可沿用对象、资产、点位与页面映射表，补充仓储任务与执行关系。
虚构样例：取消后重试，页面如何查看
教学示例：以下 O-01、T-01、E-01、E-02、A-01、B-01 和 S-01 均为虚构标识，事件顺序只用于讨论页面行为，不是客户生产记录，也不表示所有 WMS/WCS 都支持相同流程。
假设订单 O-01 关联作业 T-01，需要从库位 A-01 移到 B-01，由设备 S-01 执行。原系统为首次执行分配 E-01；取消得到确认后，再创建 E-02。先约定“取消请求”和“取消确认”的区别，再对照以下查看过程。
- 创建作业：WMS 提供 T-01 的业务状态，页面显示起终点库位；没有执行反馈时，执行栏保留“待反馈”。
- 首次执行：收到关联到 T-01 的 E-01 反馈后，可从任务详情定位 S-01，同时查看该设备的状态时间。
- 请求取消：保留 E-01 的取消请求与后续确认记录。确认尚未取得时，不将任务显示为“取消完成”。
- 重新执行：原系统创建 E-02 后，当前执行入口指向 E-02，E-01 保留在历史记录中；不能只按 T-01 覆盖全部执行历史。
- 核对完成：如果 E-02 显示执行完成，而 WMS 尚未更新，页面并列显示两侧状态与时间，并提示业务状态待核对。
图上高亮 S-01 只回答“查看哪台设备”。本次搬运是否成功、库存是否回写、任务是否关闭，应分别查看有权确认该事实的原系统记录。跨系统事件没有明确关联或顺序时，先保留冲突，不由页面自动补齐业务结论。
旧反馈到达时，怎样保留状态与时间
页面最近收到一条消息，不代表设备刚发生变化。需要区分源事件时间、平台接收时间和最近成功更新时间；迟到的 E-01 反馈也不能仅因最后到达，就覆盖 E-02 的当前状态。应核对执行标识、事件序号或版本，以及系统约定的排序和补传规则。
若链路采用 OPC UA，OPC Foundation 的 DataValue 定义分别提供值、StatusCode、源时间戳和服务器时间戳。StatusCode 说明数据提供状态，不等于“任务完成”或“设备运行”。实际项目采用什么协议、质量字段与时间规则，应按接口资料确认。
超过约定的新鲜度范围时，可以保留最后一次已知状态，但同时显示“数据待更新”、来源时间和缺失原因。不能把旧的“运行”继续标成当前正常，也不能用零值替代缺失任务数量。阈值由作业节奏与现场条件确定，页面刷新动画不作为数据有效性的依据。
先验证四种任务异常
原型阶段可用脱敏样例确认信息组织；接入阶段再用授权的接口与测试记录核对实际行为。以下检查针对页面和关联关系，设备调度与控制测试由相应负责人按约定执行。
左右滚动表格，查看异常与验证依据。
| 异常样例 | 页面应怎样表达 | 核对依据 |
|---|---|---|
| 任务拆分或重试 | 保留作业与多个执行记录的关系，区分当前与历史。 | 关联字段、原系统记录、执行版本或序号。 |
| 取消未确认 | 显示请求与确认的不同阶段，保留来源状态。 | 取消请求、确认/拒绝反馈及对应时间。 |
| 设备或库位未匹配 | 明确缺少哪一项关联，业务明细仍可查看。 | 库位台账、设备编码与模型对象对应表。 |
| 延迟、断线与补传 | 标明过期与历史反馈，恢复后核对当前记录。 | 原始时间、接收日志、补传规则和恢复结果。 |
点位、时间戳、断线恢复与授权范围的完整检查，可继续查看工业实时数据接入与验收指南。
公开仓储案例能对照哪些内容
智慧工厂仓储数字孪生真实案例已公开说明项目交付了项目原文件、代码和三维模型。客户可据此查看页面组织与交付范围；具体 WMS/WCS、引擎、接口行为和设备控制条件，应按拟建项目的资料单独评估。
开发前整理资料与交付范围
先提供一条脱敏入库或出库作业、现有 WMS/WCS 字段与状态说明、库位台账、设备清单、库区图或现有模型，以及目标终端。资料暂不完整时，列明缺少哪种关联、由谁补充，先确认能覆盖的任务链路。
首期可约定任务列表与详情设计、三维对象定位、确认范围内的接口适配、状态和时间展示，以及异常样例对照。交付清单分别列出页面、接口对应表、模型范围、部署维护资料及各自验证方式；需要项目原文件、代码和模型时，在项目范围中逐项确认。
可以先查看仓储物流可视化方案，再用接口与样例准备清单整理输入，与泓珊科技沟通仓储任务定位与页面开发范围。