参数化

图标

相关新闻和文章

• Revit。参数化。新策略、新函数、图元分组、预过滤器、快速启动选项板以及更多内容

使用方法

要使用插件，需要创建新的配置 或导入 之前创建的配置。

当前配置可以使用 复制、使用 导出，并使用 删除。使用 按钮可以修改配置的名称和分组。在同一窗口中还会显示配置分组列表以及每个分组中包含的配置数量。分组可以重命名和删除。

配置复制功能仅在插件完整版中可用。

每个配置都包含一组策略。不同策略采用不同的元素处理算法。点击 添加策略 按钮后，将打开一个对话框，其中包含可用策略列表及其简要说明：

对于每个策略，列表中会显示用户名称、系统名称以及已启用规则数量与策略中规则总数的比例。左侧的复选框用于启用或禁用策略。将鼠标悬停在策略上时，会显示复制 、更改背景颜色 和删除策略 的按钮。

策略复制功能仅在插件完整版中可用。

插件窗口左下角包含按钮，可用于选中当前配置中的所有策略 、取消全部选中 ，以及删除当前配置中的所有策略 。

当选中某个策略时，插件窗口右侧将显示其内容，包括策略的用户名称和说明、数据源、预过滤器、策略过滤器以及规则表：

每个策略由规则组成。规则定义了对待处理元素的过滤方式以及应用于这些元素的公式。元素过滤使用 按类别和参数的元素过滤器。根据策略不同，规则可能包含条件源元素的过滤器（例如：In Host 策略中的宿主元素、In Group 策略中的组、Solid Touch 策略中的接触元素等）。此外，根据策略不同，也可能不存在类别过滤器。

预过滤器会预先限制传递给策略进行处理的元素集合。后续处理中仅会使用符合指定预过滤器的元素。

应用预过滤器后，还会通过策略过滤器和规则过滤器进一步筛选元素。策略过滤器适用于所有未填写自身元素过滤器的规则。如果策略过滤器中仅填写了类别过滤器，而规则过滤器中仅填写了参数过滤器，则最终会使用包含指定类别和参数的组合过滤器。反之，也可以在策略过滤器中仅指定参数，而在规则过滤器中仅指定类别。如果规则中同时填写了类别过滤器和参数过滤器，则策略过滤器将被忽略。

可以为策略连接一个数据源，该数据源为指定 Excel 文件中的工作表。可通过相应按钮连接 或断开 文件，并从所选文件的工作表下拉列表中选择工作表。

要在表格中添加规则，请使用 。要删除所选规则，请使用 ；要复制所选规则，请使用 。

规则复制功能仅在插件完整版中可用。

当检测到规则设置中存在错误或不一致时，表格旁会显示一个带有警告数量的指示器。将鼠标悬停在该指示器上时，会显示检测到的问题及其对元素处理的影响。

当前策略的规则可以通过点击 导出，或通过点击 导入。支持两种导入/导出文件格式：XML 和 Excel。在将规则导入到空策略中，或导入并替换当前规则时，策略名称和说明也将一并导入。

当前策略的规则可以复制到剪贴板 ，并从剪贴板粘贴 到当前策略或其他策略中。可使用 按钮展开规则列表。

可以使用 选中策略中的所有规则，或使用 取消选中所有规则。还可以使用 按钮更改所选规则第一列单元格的背景颜色。

规则可以通过鼠标在列表中移动，也可以拖拽到其他策略中。移动规则后，可点击 按钮根据表格中的位置重新编号。

每条规则都可以通过取消对应表格单元格中的复选框而从处理中排除。

根据所选策略的不同，目标元素和条件源元素可能会提供附加的 分组 和 匹配 列。

分组 会打开单独的元素分组设置窗口。分组通过表达式进行定义。还可以设置组内元素的排序方式以及是否忽略大小写。

匹配 会打开单独的条件源元素与目标元素匹配设置窗口。根据指定表达式计算出的值相同的元素会被归入同一组。窗口中还提供排序设置和匹配预览。

双击 公式 或 公式属性 单元格将打开公式编辑器：

在公式编辑器顶部有一个链接，点击后可打开公式编辑器的详细说明：

公式由多个表达式组成，这使得可以对符合父规则过滤条件的元素执行多次计算。除表达式外，公式还包含以下属性：

• 容差 —— 设置用于比较数值的容差。例如，当容差设置为 0.1 时，条件 "10.05 = 10.06" 将被视为成立。
• 区分大小写 —— 设置字符串值比较时是否区分大小写。
• 写入空结果 —— 指定是否将表达式计算得到的空结果写入目标参数。对于字符串参数，空结果为空字符串；对于数值参数，空结果为 0。
• 取消关联 —— 在存在关联时，允许将目标参数与项目全局参数解除关联。

在公式编辑区域右侧提供了辅助按钮：

• 用于将目标元素的参数添加到公式中。参数列表在满足以下两个条件时可用：1）目标元素过滤器中至少指定了一个类别；2）模型中至少存在一个属于指定类别的元素实例。若两个条件均未满足，按钮将不可用。
• 用于将条件源元素的参数添加到公式中。参数列表在满足以下两个条件时可用：1）条件源元素过滤器中至少指定了一个类别；2）模型中至少存在一个属于指定类别的元素实例。若两个条件均未满足，按钮将不可用。如果父策略不包含条件源元素，则该按钮不会显示。
• 用于将项目信息中的参数添加到公式中。
• 用于将当前文档的全局参数添加到公式中。
• 用于向公式中添加函数。

在公式编辑器窗口右侧是 字段 区域，可用于通过键替换公式的部分内容。字段可以相互嵌套。

要添加新字段，可以点击窗口右侧的 按钮，或在编辑区域中选中公式的一部分，右键选择 创建字段。

当鼠标悬停在字段上时，可使用以下命令：复制字段 、删除字段 、将字段添加到收藏 或从收藏中移除 。通过窗口右侧的 按钮可打开编辑器，将选中的收藏字段（可使用 Ctrl 或 Shift 选择）插入到当前公式的字段列表中。该编辑器也可从插件设置窗口中打开，用于编辑现有收藏字段或添加新的收藏字段。收藏字段可用于其他规则的公式，并可通过 在所有配置的所有规则中更新字段值：

当鼠标悬停在 公式 单元格上时，会显示 按钮，用于在规则列表中显示或隐藏公式，

以及 按钮，用于打开 逐步计算：

逐步计算用于以单个元素为例检查公式的计算过程。为此，需要 选择 目标元素以及条件源元素（如需要），然后点击 执行。计算结果将显示在窗口中，但不会写入元素参数。

在根据当前配置启动参数化之前，需要指定元素的选择方式：

不同的选择方式在不同策略下具有各自的特点：

处理所选元素。如果存在 Types 策略，则只会处理选中元素的类型。如果存在处理元素内部元素的策略（如 In Room、In Solid、In Mass 等），则需要选择所有元素，而不仅是父元素。

处理当前视图中的元素。推荐选项！如果存在 Types 策略，则会处理当前视图中元素的类型。对于某些策略，当前视图非常重要。例如，In Room 策略在 3D 视图中无法工作，因为房间在 3D 视图中没有几何体。此外，还需注意当前视图的细节级别可能会影响与几何相关的策略（如 In Room、In Solid、Solid Touch 等）的结果。

处理选定视图中的元素。在弹出的窗口中，需要勾选包含待处理元素的视图。其行为类似于 处理当前视图中的元素。

处理文档中的元素。如果存在 Types 策略，则会处理文档中的所有类型。对于依赖元素几何体的策略（如 In Room、In Solid、Solid Touch 等），不建议使用该选项，因为获取的元素几何体不会考虑与其他元素的相互作用，可能导致结果不正确。

处理链接文件中的元素 选项允许在某些策略（如 In Room、In Mass、OneToMany 等）中使用位于链接文件中的元素。启用 选择关联文件 选项后，需要在弹出的窗口中勾选要搜索元素的文档；若未启用，则会处理所有链接文件。

要启动参数化，请点击 执行 按钮并等待处理结果。

在结果窗口中，将显示已执行的策略和规则数量、耗时以及处理的元素数量。下方列出已执行的策略，并显示每个策略处理的元素数量和耗时。展开列表后，可查看每条规则表达式处理的元素数量。

对于列表中选中的表达式，窗口右侧会显示已处理元素的 ID 列表，并可通过相应按钮选择或隔离所有元素。如果处理了来自链接文件的元素，其 ID 也会显示在列表中，但无法选中这些元素。

检查 按钮用于检查公式计算结果是否与当前参数值一致。例如，可以查找未填写值的参数。检查完成后，将显示一个与参数化结果窗口类似的检查结果窗口。

设置

可以使用窗口右上角的 打开插件的常规设置：

函数名称映射 —— 打开一个窗口，可在其中为公式编辑器中使用的函数设置自定义名称：

收藏字段 —— 打开用于管理收藏字段列表的窗口。

打开说明 —— 打开公式编辑器说明。

数值的小数分隔符 —— 设置数值使用的小数分隔符。

运行前询问是否与中心模型同步 —— 启用在运行参数化之前询问是否与中心模型同步。

部分设置会分别保存在每个配置中。其中包括几何处理设置以及：

文档更改提交 —— 用于确定更改在文档中提交的时机：在为每个元素设置每个参数值之后、在处理每条规则的所有表达式之后，或在处理每个策略的所有规则之后。所选提交方式会影响插件的运行时间：选择 设置参数值时 所需时间将多于 处理策略时。

几何处理

对于 In Room、In Space、In Mass、In Solid 策略，可以选择以下两种体积包含判定算法之一：

辅助射线

包含关系通过从目标元素体积形心在 XY 平面四个方向发射辅助射线来确定。如果四条射线全部与父元素的体积相交，则认为目标元素位于父元素内部：

对于 In Room 策略，四条射线中有三条相交即视为正向结果。

该算法运行速度快，但只能确定目标体积是否位于单个父体积内，且体积形心的位置非常重要。

布尔运算

包含关系通过 Revit API 提供的布尔运算来确定，本质上是判断体积之间的相交情况。例如，该算法会认为一根梁同时位于两堵墙内：

该算法运行速度较慢，但可以确定目标体积是否位于多个相交的父体积内。

对于上述两种算法，都会检查体积大小——父体积必须大于目标体积。

在 Solid Touch 策略中，仅通过元素体积的平行平面来判断接触关系。

参数化.面板

插件可以在紧凑的面板模式下使用。可以通过主窗口右上角的按钮显示或隐藏面板。

面板顶部包含配置选择下拉列表，以及工作模式 执行 或 检查 的选择。

下方是当前配置的策略下拉列表。仅显示在插件主窗口中勾选启用的策略。所选策略决定下方显示的规则列表。

规则列表中仅显示所选策略中已勾选启用的规则。要运行单独一条规则，请点击其名称。策略列表右侧的按钮用于运行所选策略中所有已启用的规则。