某些變數附有格式選項，可讓您指定輸出格式。

日期

日期格式選項可讓您指定輸出日期格式。

{variable | date:'format'}

其中 variable 是上述變數之一，format 則會指定日期格式。例如：

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

請參閱「Moment.js」以取得其他日期格式。

Boolean

Boolean 格式選項可讓您使用 Boolean 運算子來輸出自訂文字。

{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 文件樣板中，您需要在自訂變數中加入「@」符號。

例如：

如果您有註記變數 {rco.note}，則加入「@」符號將如下所示：{@rco.note}。此變更將確保包含變更命令註記中的豐富文字格式。

Trim (修剪)

您可以從產生的文件移除副檔名。例如，如果您使用變數 {{{-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 指令擷取字串的各部分：

• 若要從供應商變更命令編號的完整字串取得 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'}