一些提供的变量带有允许指定输出格式的格式设置选项。

日期

日期格式选项可用于指定日期的输出形式。

{variable | date:'format'}

其中，variable 是上述变量之一，format 指定日期格式。例如：

{rfq.createdAt | date:'MM DD, YYYY'}

有关其他日期格式，请参阅 Moment.js。

布尔运算

布尔格式选项让您可以使用布尔运算符来输出自定义文字。

{variable | bool:'true value': 'false value': 'N/A value'}

其中 variable 是变量之一，例如：

{rfq.properties['is approved'] | bool:'Y': 'N'}
{rfq.properties['is approved'] | bool:'GOOD': 'BAD': 'NA'}

为自定义属性创建复选框示例：

{rco.properties["checkbox3-1"] | bool: “☒”:”☐”}

数字

数字格式选项让您可以指定数字形式的输出。

{variable | number:'decimal points': 'group separator': 'fraction separator'}

其中，variable 是变量之一，decimal points 指定小数分隔符后的小数点位数，group separator 指定用于组分隔符的符号，fraction separator 指定用于小数分隔符的符号。例如：

{rco.approved | number:'2': ',': '.'}

将返回一个数字，例如 10,050.89。

您可以使用格式 writtenCurrency:'USD' 将写入的货币添加到数字格式变量。例如：

{contract.awarded | writtenCurrency:'USD'}

您可以将 USD 替换为中标合同的实际货币。

数学函数

数学函数和舍入可应用于文档上的变量。相加、相减、相乘和相除都受支持。

示例：

{rfq.approved | add: 1}

{rfq.approved | minus: 2} 

{rfq.approved | multiply: 1.13} 

{rfq.approved | divide: 1.1}

数学和舍入示例：

{rfq.approved | divide: 1.5 | rounding: '0.1': 'half-up'}

您还可以创建更高级的数学变量，这在使用支付申请的文档模板时可能会很有帮助。例如：

变量	说明
{previousQuantity | add: quantity | rounding: '0.01': 'half-up'}	返回支付申请的“截至当前总数量”
{previousAmount | add: amount | rounding: '0.01': 'half-up'}	返回支付申请的“截至当前总金额”
{payment.lineView.totalPreviousAmount | add: payment.lineView.totalAmount | rounding: '0.01': 'half-up'}	返回支付申请的“总金额”

文字

文字格式选项让您可以控制变量输出的字词大小写。

{variable | case}

其中，variable 是变量之一，case 表示以下内容之一：

• uppercase
• lowercase
• capitalize
• titlecase

例如：

{owner.name | uppercase}

以全部大写形式返回业主公司名称。

富文本

若要将富文本格式（例如，粗体、斜体）提取到 Word 文档模板中，您需要向自定义变量添加“@”符号。

例如：

如果您有一个 note 变量 {rco.note}，则添加“@”符号后将如下所示：{@rco.note}。此更改将确保包含变更单注释中的富文本格式。

修剪

可以删除生成的文档的文件扩展名。例如，如果您使用的是变量 {{{-w contract.exhibits}{targetName}{/contract.exhibits}}}，它可以在生成的文档中包含文件扩展名 .docx 或 .pdf。

如果所有文件都采用的是 .docx 格式，可以使用 trimEnd 函数删除扩展名：

{targetName | trimEnd:'.docx'}

如果您既有 .docx 文件又有 .pdf 文件，并且想要删除这两个扩展名，可以链接 trimEnd 函数，如下所示：

{targetName | trimEnd:'.docx' | trimEnd:'.pdf'}

复合

复合格式选项让您可以组合其他两种格式。

{variable | format1 | format2}

其中，variable 是变量之一，format1 和 format2 表示上述两个不同的格式选项。

例如：

{rco.approved | written | uppercase}

分割

使用 split 函数，您可以基于特定字符或字符集（也称为分隔符）将字符串分隔成不同的部分。

示例如下：

{ number | split:'-' | get:'1' }

此命令将在每个 - 处拆分存储在 number 变量中的字符串，然后获取拆分字符串的第二部分（因为计数从 0 开始）。

假设您的 number 变量包含字符串“1.1-001-ABC 01-CD EF 00FF-1.9G”。以下是每个 get 命令将返回的内容：

• get:'0'：1.1
• get:'1'：001
• get:'2'：ABC 01
• get:'3'：CD EF 00FF
• get:'4'：1.9G

或者，您也可以使用 slice 函数或 last 命令提取字符串的各个部分：

• 若要从 SCO 编号的完整字符串获取 SCONo，请使用 {sco.number | slice':-3'}。
• 或者，您也可以使用 {sco.number | split:'-' | last} 获取拆分字符串的最后一部分。

排序

如果有数据列表或集合，您可以按数字对其进行升序 (asc) 或降序 (desc) 排序。

请使用以下格式：

{#variable | sortBy:'number':'order'}{/variable | sortBy:'number':'order'}

例如：

{#oco.pco | sortBy:'number':'asc'}{/oco.pco | sortBy:'number':'asc'}