您可以组合一些变量来获得更复杂的结果。请参见按复杂性和用例组织的不同场景中使用变量的示例。

在本文中：

• 快速参考
• 基本变量用法
  • 如何添加包含变量的表？
  • 如何为空白变量显示默认值？
• 特定于文档的示例
  • 支付申请
    • 如何从支付申请中移除空行项目？
    • 如何在支付申请中仅显示计划条目的成本，而不显示小计金额？
    • 如何配置预算支付申请电子表格以按类型拆分变更单？
    • 如何在成本支付申请电子表格中添加一个没有小计的新选项卡？
    • 如何将分组的 COR 选项卡添加到预算支付申请电子表格？
  • 变更单
    • 如何将注释部分的内容添加到变更单文档？
    • 如何按主合同 SOV 组织上游变更单？
    • 如何为成本条目添加工作条目小计和加价小计？
    • 按类型拆分变更单时，如何显示关联的 COR 和 OCO 编号？
  • 合同
    • 如何在合同 SOV 中仅显示计划条目的成本，而不显示小计金额？
    • 如何在合同文档模板中引用预算代码和名称？
• 高级方法
  • 过滤和条件逻辑
    • 如何在生成文档时使用过滤器功能？
    • 如何在生成的文档中隐藏应急费用？
  • 数据聚合
    • 使用 sumBy 进行数据聚合

快速参考

常见变量模式及其用例：

模式	用例	示例
{#variable}...{/variable}	遍历条目	{#markups}{name}{/markups}
{#!variable}...{/}	当变量为空时显示	{#!amount}$0.00{/}
{#variable}...{/}{#!variable}...{/}	显示值或默认值	{#previousAmount}{previousAmount}{/}{#!previousAmount}0{/}
{variable | filter:"field":"value"}	过滤数据	{items | filter:"type":"SOV"}
{variable | sumBy:"field"}	计算总数	{items | sumBy:"approved"}
{#condition}...{/}	条件显示	{#amount!="0.00"}{amount}{/}
{variable | groupItemsByXCO: 'type'}	按变更单类型分组	{items | groupItemsByXCO: 'COR'}

基本变量用法

如果您是新接触在文档模板中使用变量，请从这里开始。这些示例涵盖了适用于所有文档类型的基本概念。

如何添加包含变量的表？

您可以使用变量，并以表的形式（包含列和标题）显示数据。下面是一个语法示例：

使用打开部分变量（以 # 开头，例如 {#markups}）和结束部分变量（以 / 结束，例如 {/markups}）。

错误用法：

正确用法：

在打开和关闭变量之间，您可以列出所有必需的数据，如 {name} 或 {description}。

生成的文档中的结果：

如何为空白变量显示默认值？

场景：您在文档模板中使用了 {previousAmount} 和 {materialsStored} 之类的变量，但在生成文档时，某些列显示空白，而不是显示“$0”值。

若要在变量为空或空白时显示默认值，请使用具有以下模式的条件表达式：

{#variableName} {variableName} {/}{#!variableName}default_value{/}

例如，若要在 {previousAmount} 为空白时显示“0”：

{#previousAmount} {previousAmount} {/}{#!previousAmount}0{/}

此条件表达式的工作原理如下：

• {#previousAmount} - 如果 previousAmount 有值，则显示该值
• {previousAmount} - 实际变量值
• {/} - 关闭第一个条件
• {#!previousAmount} - 如果 previousAmount 没有值（为空白/空）
• 0 - 将“0”显示为默认值
• {/} - 关闭第二个条件

您可以将此模式应用于要显示默认值而不是空白单元格的任何变量，例如：

• {#materialsStored} {materialsStored} {/}{#!materialsStored}$0.00{/}
• {#currentAmount} {currentAmount} {/}{#!currentAmount}0{/}

特定于文档的示例

这些示例按文档类型进行组织，以帮助您找到特定用例的相关解决方案。

支付申请

自定义支付申请文档和电子表格的示例。

如何从支付申请中移除空行项目？

若要从支付申请中移除空行项目，请在表开头使用条件表达式 {#amount!="0.00"}，并在行末尾使用 {/}。例如：

如何在支付申请中仅显示计划条目的成本，而不显示小计金额？

若要消除支付申请或合同中的小计，您可以采用 {#children.length===0}{xxx}{/} 格式输入付款行项目。例如：

如何配置预算支付申请电子表格以按类型拆分变更单？

场景：您已创建一个名为“留量转移”的变更单类型。

并且希望在 Excel 电子表格中看到这些留量的批准的业主变更。如何做到这一点？

1. 为 Excel 电子表格中的列列出“业主变更单”。

   

2. 将新类型应用于 OCO。

   

3. 将名称与 Excel 电子表格中的类型匹配。

   

如何在成本支付申请电子表格中添加一个没有小计的新选项卡？

场景：您要在默认成本支付申请电子表格模板中创建一个新选项卡，该选项卡仅显示计划条目，而不显示小计金额。

若要在成本支付申请电子表格模板中添加一个不带小计的新选项卡，请使用以下变量模式：

{#children.length===0}{xxx}{/}

此条件表达式可确保在生成的电子表格选项卡中仅显示没有小计的行项目。{xxx} 表示要为每个行项目包含的特定数据字段。

用例：当您希望为分包商提供一个包含各个工作条目而没有复杂的小计计算的干净视图时，该选项卡特别有用。

如何将分组的 COR 选项卡添加到预算支付申请电子表格？

场景：您要在默认预算支付申请电子表格模板中创建新选项卡，该选项卡按 COR（变更单请求）对条目进行分组，而不显示各个成本条目详细信息。

例如，要将一个名为“按 COR 分组的可选详细信息”的新选项卡添加到预算支付申请电子表格模板，请使用以下变量模式：

{#payment.lineView.rootItems|groupItemsByXCO: 'COR'}{number}{/payment.lineView.rootItems|groupItemsByXCO: 'COR'}

此变量按付款行项目的关联 COR 对它们进行分组，并且仅显示 COR 编号，而不显示基础成本条目详细信息。

主要特点：

• 按 COR 对条目进行分组以便更好地进行组织
• 排除详细的成本条目信息，以使视图更加清晰
• 对高级预算跟踪和报告非常有用
• 帮助项目经理快速识别 COR 相关的成本

变更单

自定义变更单文档（包括 RFQ、COR 和 OCO）的示例。

如何将注释部分的内容添加到变更单文档？

场景：您想要创建一个文档，使其包含在变更单的整个生命周期内添加的注释。

该示例将 {#rfq.comments} 显示为变量的打开标记，将 {/rfq.comments} 显示为关闭标记。其他相关变量必须介于这两个变量之间。

例如，包含以下注释部分的 RFQ：

使用以下方法将表添加到 Word 文档：

结果：

在文档模板中只需填写表的一行。软件将根据 Cost Management 中的数据构建包含指定信息的表。

如何按主合同 SOV 组织上游变更单？

按文档模板中主合同的价格一览表组织 COR 或 OCO。对于 COR，请使用以下模式：

对于 OCO，将 rco 替换为 oco。

如何为成本条目添加工作条目小计和加价小计？

场景：您正在创建一个变更单文档（例如 OCO），并且希望其中有两个单独的表。一个用于带小计的常规成本项目，另一个用于加价成本项目。您还想要添加总变更单定价。如何做到这一点？下面是文档中所用变量的示例：

按类型拆分变更单时，如何显示关联的 COR 和 OCO 编号？

若要显示关联的 COR 和 OCO 编号，请使用以下变量：

• COR：{this.costItem.corNumber}
• OCO：{this.costItem.ocoNumber}

结果：

合同

自定义合同文档和价格一览表显示的示例。

如何在合同 SOV 中仅显示计划条目的成本，而不显示小计金额？

场景：您想要创建一份合同，使其仅显示 SOV 子项的小计。您不希望父项对分包商可见。为此，请使用文档模板中的以下变量：

此外，您也不希望将“单位成本”和“金额”值显示为 $0。您可以将 $0 替换为“Included”一词。如何做到这一点？丰富已使用的变量：

生成的合同中的结果将如下所示：

如何在合同文档模板中引用预算代码和名称？

若要在文档模板中引用预算代码和名称，请使用以下公式：

例如，当合同的价格一览表如下所示时：

显示的公式将生成以下结果：

高级方法

这些示例演示了满足复杂文档自定义要求的复杂变量用法。

过滤和条件逻辑

用于在文档中显示或隐藏特定数据的高级过滤方法。

如何在生成文档时使用过滤器功能？

您可以在生成文档时使用过滤器功能。例如，若要仅显示风险应急费用条目，请使用 {#payment.columnView.rootItems | filter:"name":"Risk Contingency"} 变量：

结果：

成员还可以将含有所有已获批 SCO 的原始价格一览表分成两个单独的工作表。

若要生成仅包含原始 SOV 的工作表，请使用以下变量：

{#payment.lineView.rootItems | filter:"associationType":"SOV"} {/payment.lineView.rootItems | filter:"associationType":"SOV"}

若要生成仅包含已获批 SCO 的工作表，请使用以下变量：

{#payment.lineView.rootItems | filter:"number":"Change Orders"} {/payment.lineView.rootItems | filter:"number":"Change Orders"}

如何在生成的文档中隐藏应急费用？

如果管理员不希望在生成的文档中显示应急费用，可以使用以下过滤器：

结果：

数据聚合

用于在文档中计算总数和执行数据聚合的高级方法。

使用 sumBy 进行数据聚合

sumBy 函数有助于聚合数据集中的值。

示例 1：计算每个 PCO 的常规成本条目已批准值的小计。

{#oco.pco}{regular | sumBy:'approved'}{/oco.pco}

示例 2：计算每个 PCO 的所有成本条目已批准值的总计。

{#oco.pco}{this | getAll: "costItems" | sumBy: "approved"}{/oco.pco}