一部の変数には、出力の書式を指定できる書式設定オプションがあります。
日付書式オプションを使用すると、日付の出力書式を指定できます。
{variable | date:'format'}ここで、variable は上記の変数の 1 つであり、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は変数の 1 つ、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 は変数の 1 つ、case は次のいずれかを表します。
uppercaselowercasecapitalizetitlecase例:
{owner.name | uppercase}すべて大文字で所有者の会社名を返します。
リッチ テキスト書式(太字、斜体など)を Word 文書テンプレートに取り込むには、カスタム変数に「@」記号を追加する必要があります。
例:
注記変数 {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'}複合書式オプションを使用すると、他の 2 つの書式を組み合わせることができます。
{variable | format1 | format2}ここで、variable は変数の 1 つ、format1 と format2 は上記の 2 つの異なる書式を表します。
例:
{rco.approved | written | uppercase}split 関数を使用すると、区切り文字とも呼ばれる特定の文字または文字のまとまりに基づいて、文字列を別々のパーツに分割できます。
次に例を示します。
{ number | split:'-' | get:'1' }このコマンドは、number 変数に保存されている文字列を各 - で分割し、分割された文字列の 2 番目の部分を取得します(カウントは 0 から始まるため)。
たとえば、number の変数に文字列 "1.1-001-ABC 01-CD EF 00FF-1.9G" が含まれているとします。各 get コマンドが返す内容は次のとおりです。
get:'0': 1.1get:'1': 001get:'2': ABC 01get:'3': CD EF 00FFget:'4': 1.9Gまたは、slice 関数や last コマンドを使用して、文字列の一部を抽出できます。
{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'}