套裁数据
把分列的型材属性整理成线材套裁优化可以直接读取的成品数据
📖 功能概述
当成品信息分别来自 Excel 列、数据面板或其他组件时，套裁数据可将九列属性按行组合。每一行代表一种成品及其需求数量，输出可以直接连接到“线材套裁优化”的成品数据输入。
📥 九项输入
| 字段 | 要求 | 说明 |
|---|---|---|
| 模号 | 必填 | 决定成品行数；每项不能为空。 |
| 长度 | 必填 | 单位 mm；项数必须与模号一致，每项必须大于 0。 |
| 数量 | 必填 | 项数必须与模号一致，每项必须是正整数。 |
| 名称、色号、物料编码、工程属性、备注1、备注2 | 可选 | 整列不连接时自动留空；一旦连接，项数必须与模号一致。 |
不支持单值自动广播。例如有 12 个模号，只连接 1 个色号会被判定为长度不一致；请先把色号扩展为 12 项，或者保持整列不连接。
🎛️ 推荐用法
- 先连接模号、长度和数量，确认三列项数完全相同。
- 按需要接入其他属性列；每行必须对应同一件成品。
- 查看“是否有效”。为 True 时再把成品数据连接到线材套裁优化。
- 若为 False，优先阅读组件错误提示，它会指出缺失字段、实际项数或无效行。
📤 输出
| 输出 | 说明 |
|---|---|
| 成品数据 | 每个输入行生成一条完整记录；字段中含逗号、分号、换行或引号时会自动安全包裹，不需要手动处理。 |
| 是否有效 | 全部规则通过时为 True；失败时为 False，并且不会输出半成品记录。 |
⚠️ 常见问题
- 列表错位比空白字段更危险：请确保同一索引下的九项确实属于同一成品。
- 长度使用毫米；组件只检查数值有效性，不会替你转换其他单位。
- 可选字段允许空文本，但不能连接一条数量不同的列表。
- 此组件负责整理成品需求，不负责设置原材料规格、锯缝或优化策略。