把一张图框的属性键列表与属性值列表按位置配对，封装成可交给 CAD 图框生成流程的单项属性数据。
功能概览
该组件是 CAD 图框工作流的第二步，用于描述“一张图框应填写哪些属性，以及每个属性写入什么内容”。Keys 和 Values 按列表索引一一对应：第一个 Key 使用第一个 Value，第二个 Key 使用第二个 Value。两边数量必须完全一致，否则不会输出结果。
每个 Key 在配对前会去除首尾空白，空 Key 会报错。Key 的重复检查不区分大小写，因此“PROJECT”和“project”会被视为同一个属性，不允许同时出现。Value 可以是空文本；空值仍然是该 Key 的明确值。组件只负责组织属性数据，不会在此步骤检查这些 Key 是否真实存在于某份 DWG 模板中；最终导出只会写入模板实际具有的属性，因此建议从已读取图框中取得或核对 Key。
适用场景
- 为每张待导出的图纸准备图号、项目名、修订号等图框属性。
- 把来自表格或数据树分支的两列文本整理成一张图框的属性集合。
- 在批量生成图框前检查空 Key、重复 Key 和键值数量错误。
- 为不同图框分别建立属性项，再交给支持多图框的最终导出步骤。
工作流程
- 先从标准图框或项目规范中确认模板真实存在的属性 Key 及准确拼写。
- 建立 Keys 列表，并按希望写入的属性顺序排列；避免空项和仅大小写不同的重复项。
- 建立等长的 Values 列表，让每个值与同位置的 Key 对应；需要清空字段时可提供空文本。
- 连接两组列表。组件完成数量、空 Key 和重复 Key 检查后，输出一项图框属性数据。
- 将输出作为一张图框的属性输入，继续连接到最终图框生成和 CAD 导出流程。
输入
| 端口 | 是否必需 | 数据与结构 | 默认、匹配与误接说明 |
|---|---|---|---|
| 属性Keys（K） | 必需 | 文本列表；每项是一个图框属性名称。 | 按列表位置与 Values 匹配。Key 会去除首尾空白，之后不得为空。重复判断不区分大小写。组件不提供默认 Key，也不自动从模板补全。 |
| 属性Values（V） | 必需 | 文本列表；每项是对应 Key 要写入的内容。 | 数量必须与 Keys 完全一致。空项会作为空文本保留。该端口不会按 Key 名自动查找或重新排序，因此错位列表会得到错位配对。 |
输出
| 端口 | 结果与结构 | 典型下游 |
|---|---|---|
| 图框属性（A） | 单项属性数据，内部保持已验证的键值顺序，代表一张 CAD 图框要填写的一组属性。 | 生成图框并导出 CAD；批量流程中可为每张图框分别建立一项，再组成与图框数量对应的列表。 |
实际示例
某标准图框真实包含三个属性：“DRAWING_NO”“PROJECT”“REVISION”。将这三个文本按顺序接入 Keys，并把“A-023”“装配车间”“B”接入 Values。组件输出一项包含三对内容的图框属性数据；在后续生成图框时，这一项可用于填写一张图纸。如果把第二个 Key 改成“drawing_no”，它会与第一个 Key 在不区分大小写的规则下重复，组件报告错误且不输出。如果将“REVISION”的 Value 留为空文本，数据仍然有效，表示该字段应使用空内容，而不是缺少配对。
配合使用
- 上游先用“01获取CAD图框”读取模板，再通过图框分解结果核对实际属性 Keys。
- Keys 可使用一个稳定的模板字段列表；Values 可来自项目表格、文本面板或每张图纸的数据分支。
- 批量处理时，每张图框分别运行一次配对，使每个输出项代表一张图框，而不是把多张图框的字段混在同一列表中。
- 将输出连接到最终生成与导出组件；模板不存在的 Key 不会因为在这里打包成功而被创造出来。
常见问题与限制
- 为什么提示 Keys 与 Values 数量不一致？
- 两组列表采用严格的一一对应关系。为缺少内容的字段补一个空文本值，或删除多余项，使两边长度相同。
- 为什么两个看起来不同的 Key 被判定重复？
- 重复检查不区分大小写；例如“PROJECT”和“project”属于同一个 Key。首尾空白也会先被去除。
- Value 可以为空吗？
- 可以。空 Value 表示该 Key 对应空文本；空 Key 则无效，因为无法确定要写入哪个属性。
- 为什么导出后某个属性没有写入？
- 本组件只验证键值集合本身，不证明 Key 存在于模板。最终流程只向 DWG 图框真实具有的属性写值，请核对模板属性拼写。
- 组件会按名称自动对齐两组列表吗？
- 不会。配对只依据索引位置，使用者必须在连接前保证 Keys 和 Values 顺序一致。