Parameter Catalog - 受控参数值

Parameter Catalog 让团队能够为模型定义参数目录和允许值。该工具有助于应用标准化的值、验证合规性，并在模型、本地缓存和 JSON 文件之间传输配置。

概述

该插件将模型参数整理到可编辑的目录中，允许用户关联允许值，然后将这些值应用于选定的图元。它还包含一个验证层，用于检测不符合已定义目录的图元。

主要功能

• 三个选项卡： 标准（构建目录）、执行（应用值）、验证（查找不合规图元）。
• 可编辑目录： 将模型参数添加到目录，然后定义其允许值（可一次粘贴多行）。
• 值的应用： 选择一个目录条目及其某个允许值，然后应用到选定的图元。
• 模型验证： 验证整个模型或仅验证当前选择；仅列出不合规的图元，并显示类别、图元、参数和当前值。
• 存储与传输： 将目录保存到模型（ExtensibleStorage）、本地文件或 JSON，当两者都存在时，模型数据始终优先于本地数据。
• 工作配置文件： 保存并重复使用完整的目录配置。

使用要求

• 应用值要求目标参数在选定图元上存在且可写。

使用步骤

构建目录（标准选项卡）

1. 从 Frata 功能区的 Model 面板打开 Parameter Catalog。
2. 在 模型参数 下，选择一个参数并按 添加到目录，为其创建一个 目录条目（或 移除 不再需要的条目）。
3. 选中某个条目后，添加其 允许值 — 可以一次粘贴多行以同时添加多个值。
4. 按 将目录保存到模型 以将目录存储在项目中，或将其保存为配置文件以便重复使用。

应用值（执行选项卡）

1. 选择一个 目录条目 和 要应用的值。
2. 在模型中选择图元并按 应用。
3. 查看结果 — 如果部分图元无法修改，按 查看详情 以查看具体是哪些图元及原因。

验证合规性（验证选项卡）

1. 按 验证模型 检查整个项目，或按 验证选择 仅检查当前选定的图元（如果未选择任何内容，Revit 会提示您选择图元）。
2. 仅列出不符合目录规则的图元，包含其类别、图元、参数和当前值。

备份与传输（配置 / 导入导出）

1. 打开 配置（或从标准选项卡打开 导入 / 导出），查看恢复、模型、本地和传输选项。
2. 使用 保存到模型 / 从模型加载 处理项目自身保存的目录，使用 本地保存 / 本地加载 处理本地缓存，或使用 导入 JSON… / 导出 JSON… 将目录以文件形式共享。
3. 请记住：模型中保存的目录始终优先 — 只有当模型没有自己保存的目录时，才会自动使用本地数据。

建议

• 在配置窗口中所做的更改会在操作过程中自动保存到本地缓存，无论您是否已按下"保存到模型" — 如需从该缓存恢复，请使用 从本地恢复。
• 当您希望将目录交给其他项目或同事，而不是依赖对方打开这个特定模型时，将目录导出为 JSON。
• 定期验证整个模型，而不仅仅是当前选择，以发现其他团队成员引入的偏差。

常见问题

我收到消息"该参数已在目录中。"这是为什么？ 您试图添加一个已经拥有目录条目的参数。请选择现有条目，而不是再次添加。

我收到消息"该值已存在于列表中。"这是为什么？ 您试图添加一个该条目已存在的允许值 — 不允许重复值。

应用值后，部分图元显示"无法修改"。这是为什么？ 目标参数在这些特定图元上很可能缺失或为只读。按查看详情可确切了解哪些图元失败及原因。

如果模型和我的本地文件都有已保存的目录，哪个优先？ 模型中保存的目录始终优先。只有当模型没有自己的目录时，才会自动使用本地数据 — 如果您想覆盖此行为，请显式使用"从模型加载"或"从本地恢复"。

我应该在应用值之前还是之后进行验证？ 两种方式都可以，但应用后再验证更有用 — 它可以确认您刚写入的值（以及在此工具之外设置的任何值）确实符合目录要求。