Interface Configurations zh CN

典型配置模式：从现场安排到接口记录

English · 学习指南

选择模式前先回答三个问题：本次计划的时间粒度是什么；哪些变化影响全部资源，哪些只影响特定设备；需要控制总量，还是必须控制具体发生时刻。以下模式可以组合，示意表只列本节有关字段，完整记录按字段参考填写。

1. 单班、双班与连续生产

以一天24个一小时时间单元为例，所有行scale=3600。下表按区间压缩展示，实际数据每小时一行。

现场安排	正常可用时段示例	其余时段
单班8小时	08:00–12:00、13:00–17:00	全局停产时设status=0
双班16小时	00:00–08:00、08:00–16:00	16:00–24:00停产
连续生产	00:00–24:00	按设备停机另记资源占用
工作日生产	周一至周五按相应班次	周末设为停产或经确认的可选期

这些时段仅用于演示。企业的休息、交接班、跨日班次和周历应按实际安排映射。若甲设备只上单班、乙设备上双班，统一时间轴应覆盖两者；局部停工写入各自capacity.used，避免将甲设备的停工设成全局停产。

可选加班可以用status=-1表达待选择状态。进入需要确定日历的运行前，应先确认采用哪些加班段并记录依据。

2. 一次维护如何影响产能

8小时聚合时间单元内，设备维护2小时：

表	关键字段
time_unit	id=1, offset=0, scale=28800, status=1
capacity	workcenter=11, time_unit=1, used=0.25

可用6小时。维护改为3小时，used=0.375，可用5小时。如果已有任务占2小时、维护也占2小时且重叠1小时，不可用总量为3小时，不能直接相加为4小时。

要求“10:00–12:00设备不可加工”时，可将对应两个小时的设备占用设为1，或采用支持明确停机时窗的排程配置。仅给出整班25%的占用，无法还原停机发生在班初、班中还是班末。

3. 候选设备与共用工装

同一工序可配置两条process_adaptor记录，分别指向设备11和13；两条记录可以拥有不同出件率、时长、批量与优先级。替代设备的存在需要保留在数据中，由本次能力选择策略处理。

若两台设备共用一套工装，将工装作为工作中心20：

shared_resource.binding	shared_resource.to
20	11
20	13

工装的可用时间单独记录为capacity(workcenter=20, time_unit=1, used=0.5)。两台设备各可用8小时，也不代表工装可同时服务16小时。目标资源是否连续占用工装、每件占用多久，应与具体能力配置相匹配。

4. 一次加工、多种产出

同一模具每循环产出A两件、B两件、C一件，相关适配记录使用相同共同加工组。执行10次后，分别得到20、20、10件。

需求分别为18、20、12件时，差异为A余2件、B刚好、C缺2件。是否加做两次，要结合新增A、B库存和C短缺代价决定。计算负荷时，共同循环只计一次占用；计算物料时按约定消耗基准归集，避免把共同加工时间重复相加。

5. 到料记录：累计值转成增量

来源系统给出截至两期的累计可用量80、120件，而输入链路按各期增量求和：

时期	来源累计量	写入就绪增量	运行时累计量
第1期	80	80	80
第2期	120	40	120

若直接写80、120再累加，就会把可用量错误放大到200。第二期收到的是“当前剩余库存”时，还需要区分前期已消耗、已承诺和冻结量，不能直接对两个库存快照相减。

物料被冻结或到货取消时，应重建后续可用曲线，按接入约定处理减少量；本教程的非负增量示例不接收未经解释的负记录。

6. 库存目标转成累计生产范围

期初20件，最低20件、最高100件，前两期分别出库80、40件：

时点	累计出库	累计生产下限	累计生产上限
第1期末	80	80	160
第2期末	120	120	200

这些值分别写入同一制品各期的累计上下限。它们是到各时点的界限，不能把80与120相加作为第二期下限。若出库发生在生产入库之前，还需要更细的时间表达。

7. 不同单位如何落到整数模板

连续工艺每件消耗0.2升涂料，当前ingredient.number为整数。可统一换为毫升，每件填200；物料供给、库存记录及结果说明同步使用毫升。例如40升供给应转换为40000毫升，可配套200件。

转换记录应包含来源单位、目标单位、换算系数和舍入策略。不要靠SQLite宽松存储把小数塞入整数列，再假定后续加载与求解会保留它。

8. 选择后的检查

把所选模式写成一张配置说明表：业务条件、接口记录、计算预期、模型采用方式、结果检查。先用小数量手算一个例子，再扩展到实际数据量。下一步可以使用贯穿案例运行结构校验和数据层读取。