この記事の変数をドキュメント テンプレートに含めて、システム内の支払い請求から値を設定します。たとえば、支払い請求の番号、説明、または当初契約値を追加できます。
この記事の内容:
詳細情報:
完全な変数参照に入る前に、最も一般的なシナリオの実用的な例を次に示します。
支払い請求ドキュメントの業務用ヘッダーを作成します。
PAYMENT APPLICATION #{payment.number}
Contractor: {payment.supplier}
Project: {payment.name}
Billing Period: {payment.startDate | date: "%B %d, %Y"} to {payment.endDate | date: "%B %d, %Y"}
監査要件について、誰がいつ何を承認したかを追跡します:
APPROVAL HISTORY:
{#approvalHistories}
• {stepName}: {action} by {operator.name}
{/approvalHistories}
主要な財務合計を一目でわかるように表示します:
Original Contract Amount: {payment.contractAmount | currency}
Total Change Orders: {payment.totalApprovedChangeOrders | currency}
Contract Sum to Date: {payment.contractSumToDate | currency}
Current Payment Due: {payment.currentPayment | currency}
Balance to Finish: {payment.balanceToFinish | currency}
完了した作業の詳細な行項目を生成します:
{#payment.columnView.items}
{number} | {name} | {originalAmount | currency} | {amount | currency} | {percentCompleted}%
{/payment.columnView.items}
TOTALS:
Work Completed: {payment.columnView.totalAmount | currency}
Materials Stored: {payment.columnView.totalMaterialsStored | currency}
Total Retention: {payment.columnView.totalRetainage | currency}
前回の支払い請求からの進捗状況を表示します:
Previous Payment #{previousPayment.number}: {payment.previousPayment | currency}
Current Period Work: {payment.currentPayment | currency}
Total Earned to Date: {payment.totalEarned | currency}
[請求済み資材]設定を有効にすると、現場に搬入された資材の追跡が可能になります。
Materials Delivered This Period: ${payment.lineView.materialsBilled | currency}
Materials Delivered Previously: ${payment.lineView.previousMaterialsBilled | currency}
Total Materials Delivered: ${payment.lineView.materials | currency}
Calculation: {payment.lineView.materials} = {payment.lineView.previousMaterialsBilled} + {payment.lineView.materialsBilled}
これにより、従来使用されていた totalMaterialsStored 変数を使用して手動で合計を計算する必要がなくなります。
正と負の増減管理を個別の列に分けます。
CHANGE ORDER SUMMARY
Additions Deductions
Previous Periods: {payment.approvedChangeOrderAdditionsInPreviousPeriod | currency} {payment.approvedChangeOrderDeductionsInPreviousPeriod | currency}
This Period: {payment.approvedChangeOrderAdditionsThisPeriod | currency} {payment.approvedChangeOrderDeductionsThisPeriod | currency}
TOTALS: {payment.totalApprovedChangeOrderAdditions | currency} {payment.totalApprovedChangeOrderDeductions | currency}
Net Change Orders: {payment.totalApprovedChangeOrders | currency}
サプライヤー固有の値
いずれかの支払請求の変数の前に contract.supplier. を付けて、サプライヤーに固有の値を戻すことができます。
例: {contract.supplier.payment.currentPayment}
スプレッドシートの互換性
スプレッドシートはリッチ テキスト変数をサポートしていません。スプレッドシートで変数を使用する場合は、「@」記号を削除します。
この代わりに: {@pco.scopeOfWork}
使用: {pco.scopeOfWork}
行モードと列モード
支払い請求で行モード(行項目として増減管理を表示)を使用している場合は、変数内の columnView を lineView に置き換えます。
列モード: {payment.columnView.totalAmount}
行モード: {payment.lineView.totalAmount}
増減管理の追加額/差し引き変数
これらの変数ではインライン モードをサポートしていないため、正確性を確保するには完全に承認された変更管理が必要です。
表の上部にある検索を使用して、結果を絞り込みます。変数は、ナビゲートしやすいようにカテゴリ別に整理されています。
| 変数 | 説明 | 型 |
| 基本情報 | ||
| {payment.number} | 支払い請求の番号を返します。 | 文字列 |
| {payment.name} | 支払い請求名を返します。 | 文字列 |
| {payment.description} | 支払い請求の説明を返します。 | 文字列 |
| {payment.supplier} | サプライヤーの会社を返します。 | 文字列 |
| {payment.owner} | 所有者の会社を返します。 | 文字列 |
| {payment.architect} | 建築設計者の会社を返します。 | 文字列 |
| {@payment.note} | 支払い申請時の注を返します。 | リッチテキスト |
| 承認ワークフロー | ||
| {#approvalHistories} および {/approvalHistories} | 実行したアクション、ワークフロー ステップ名、演算子名など、支払い請求の承認履歴の詳細を返します。 {#approvalHistories} と {/approvalHistories} を一緒に使用します。 |
配列 |
| {#approvalHistories.action} 例: {/approvalHistories} |
承認ワークフロー ステップで実行したアクションを返します。 | 文字列 |
| {#approvalHistories.stepName} 例: {/approvalHistories} |
承認履歴内のワークフロー ステップ名を返します。 | 文字列 |
| {#approvalHistories.operator.name} 例: {/approvalHistories} |
承認アクションを実行したユーザの名前を返します。 | 文字列 |
| 日付とタイムライン | ||
| {payment.startDate} | 支払い請求の請求期間の開始日を返します。 | 日付 |
| {payment.endDate} | 支払い請求の請求期間の終了日を返します。 | 日付 |
| {payment.createdAt} | 支払い請求が作成された日付を返します。 | 日付 |
| {payment.submittedAt} | 支払い請求が提出された日付を返します。 | 日付 |
| {payment.revisedAt} | 支払い請求が修正された日付を返します。 | 日付 |
| {payment.updatedAt} | 支払い請求が更新された日付を返します。 | 日付 |
| コア財務合計 | ||
| {payment.contractAmount} | 支払い請求の元の契約金額を返します。 | 番号 |
| {payment.contractSumToDate} | 契約の合計を最新に戻します。 | 番号 |
| {payment.totalCompletedAndStored} | 現在までに完了した作業および保存した資材の合計を返します。 | 番号 |
| {payment.totalEarned} | 留保額を除く合計所得を返します。 | 番号 |
| {payment.previousPayment} 例: {#payment.previousPayment == ""} {/} {#payment.previousPayment < 0} ({payment.previousPayment | multiply: -1}) {/} |
前回の支払い請求からの留保額を除く合計所得を返します。 | 番号 |
| {payment.currentPayment} | 現在の支払い期限を返します。 | 番号 |
| {payment.balanceToFinish} | 留保額を含む完了までの調整額を戻します。 | 番号 |
| 留保と留保額 | ||
| {payment.completedWorkRetentionPercent} | 現在までに完了した作業および保存した資材の合計をパーセンテージで返します。 | 番号 |
| {payment.completedWorkRetention} | 完了した作業の留保率を返します。 | 番号 |
| {payment.materialsOnStoreRetentionPercent} | 現場にある資材の留保率を返します。 | パーセント(Percent) |
| {payment.materialsOnStoreRetention} | 現場にある資材の数を返します。 | 番号 |
| {payment.allTotalRetainage} | 留保率の合計を返します。 | 番号 |
| {payment.previousCompletedWorkRetained} | 以前の支払い請求から完了した作業の留保額を返します。 | 番号 |
| {payment.previousMaterialsRetained} | 以前の支払い請求から保存された資材の留保額を返します。 | 番号 |
| {payment.currentCompletedWorkRetention} | 完了した作業の当期留保額を返します。 | 番号 |
| {payment.currentMaterialsRetention} | 保存された資材の当期留保額を返します。 | 番号 |
| {payment.thisPeriodRetainage} | 現在の支払の合計留保額から前の支払の留保額を差し引いた金額を返します。 | 番号 |
| 増減管理と変動数 | ||
| {payment.approvedInPreviousPeriod} | 前の期間内に承認された合計変動数を返します。 | 番号 |
| {payment.approvedThisPeriod} | この期間の合計変動数を返します。 | 番号 |
| {payment.totalApprovedChangeOrders} | 変更依頼によるネット変更額を返します。 | 番号 |
| {payment.approvedChangeOrderAdditionsInPreviousPeriod} | 前の期間からの承認済み増減管理の合計追加額を返します。 | 番号 |
| {payment.approvedChangeOrderDeductionsInPreviousPeriod} | 前の期間からの承認済み増減管理の合計差し引き額を返します。 | 番号 |
| {payment.approvedChangeOrderAdditionsThisPeriod} | この期間の承認済み増減管理の追加額を返します。 | 番号 |
| {payment.approvedChangeOrderDeductionsThisPeriod} | この期間の承認済み増減管理の差し引き額を返します。 | 番号 |
| {payment.totalApprovedChangeOrderAdditions} | すべての期間にわたる承認済み増減管理の合計追加額を返します。 | 番号 |
| {payment.totalApprovedChangeOrderDeductions} | すべての期間にわたる承認済み増減管理の合計差し引き額を返します。 | 番号 |
| 行項目の詳細 | ||
| {#payment.columnView.items}と{/payment.columnView.items} | OCO が列として表示されている場合、支払い請求項目の詳細を返します。 {#payment.columnView.items}と{/payment.columnView.items}を一緒に使用します。 |
配列 |
| {#payment.columnView.items.number} 例: {/payment.columnView.items} |
支払い請求のライン項目番号を返します。 | 文字列 |
| {#payment.columnView.items.name} 例: {/payment.columnView.items} |
支払い請求のライン項目名を返します。 | 文字列 |
| {#payment.columnView.items.originalQuantity} 例: {/payment.columnView.items} |
支払い請求の元の数量のライン項目を返します。 | 番号 |
| {#payment.columnView.items.unit} 例: {/payment.columnView.items} |
支払い請求の単位のライン項目を返します。 | 文字列 |
| {#payment.columnView.items.originalUnitPrice} 例: {/payment.columnView.items} |
支払い請求の元の単価のライン項目を返します。 | 番号 |
| {#payment.columnView.items.originalAmount} 例: {/payment.columnView.items} |
支払い請求の元の価格表のライン項目を返します。 | 番号 |
| {#payment.columnView.items.changeOrders} 例: {/payment.columnView.items} |
支払い請求の変更依頼の金額のライン項目を返します。 | 番号 |
| {#payment.columnView.changeOrderQuantity} | 増減管理の数量を返します。 | 番号 |
| {#payment.columnView.items.revisedQuantity} 例: {#payment.columnView.items}{revisedQuantity} {/payment.columnView.items} |
支払い請求の修正された数量の行項目を返します。 | 番号 |
| {#payment.columnView.items.revisedValue} 例: {/payment.columnView.items} |
支払い依頼の修正金額のライン項目を返します。 | 番号 |
| {#payment.columnView.items.previousQuantity} 例: {/payment.columnView.items} |
前の支払い請求の数量のライン項目を返します。 | 番号 |
| {#payment.columnView.items.previousAmount} 例: {/payment.columnView.items} |
前回の支払い請求の作業完了金額のライン項目を返します。 | 番号 |
| {#payment.columnView.items.quantity} 例: {/payment.columnView.items} |
現在の支払い請求の数量のライン項目を返します。 | 番号 |
| {#payment.columnView.items.amount} 例: {/payment.columnView.items} |
現在の支払い請求の作業完了金額のライン項目を返します。 | 番号 |
| {#payment.columnView.items.materialsOnStoreQuantity} 例: {/payment.columnView.items} |
支払い請求の調達資材の数量の行項目を返します。 | 番号 |
| {#payment.columnView.items.materialsOnStoreUnitPrice} 例: {/payment.columnView.items} |
支払い請求の調達資材の単価の行項目を返します。 | 番号 |
| {#payment.columnView.items.materialsStored} 例: {/payment.columnView.items} |
支払い請求の調達資材の金額の行項目を返します。 | 番号 |
| {#payment.columnView.items.completed} 例: {/payment.columnView.items} |
支払い請求の合計完了金額のライン項目を返します。これには、作業完了金額と現場にある資材の金額が含まれます。 | 番号 |
| {#payment.columnView.items.percentCompleted} 例: {/payment.columnView.items} |
支払い請求合計完了率のライン項目を返します。 | 番号 |
| {#payment.columnView.items.balanceToFinish} 例: {/payment.columnView.items} |
支払い請求の完了までの調整額のライン項目を返します。 | 番号 |
| {#payment.columnView.items.retainage} 例: {/payment.columnView.items} |
支払い請求の留保額のライン項目を返します。 | 番号 |
| {#payment.columnView.items.completedWorkRetentionPercent} 例: {/payment.columnView.items} |
支払い請求の完了した作業の留保額のパーセンテージのライン項目を返します。 | 番号 |
| {#payment.columnView.items.materialsOnStoreRetentionPercent} 例: {/payment.columnView.items} |
支払い請求の調達資材の留保額のパーセンテージの行項目を返します。 | 番号 |
| {#payment.columnView.items.completedWorkReleased} 例: {/payment.columnView.items} |
支払い請求の完了した作業のリリース済み留保額のライン項目を返します。 | 番号 |
| {#payment.columnView.items.materialsOnStoreReleased} 例: {/payment.columnView.items} |
支払い請求の調達資材のリリース済み留保額の行項目を返します。 | 番号 |
| {payment.columnView.totalOriginalAmount} | 契約金額、予算の振替え、増減管理を含む、支払い請求の元の価格表の合計を返します。 | 番号 |
| {approvedBudgetTransfers} | 承認済み予算振替え: 承認済み予算振替えの合計数。 | 番号 |
| {previousApprovedBudgetTransfers} | 以前の承認済み予算振替え: 前の期間までに承認されたすべての予算振替えの金額。 | 番号 |
| {approvedThisPeriodBudgetTransfers} | 当期間の承認済み予算振替え: この期間に追加された承認済み予算振替えの金額。 | 番号 |
| {totalBudgetTransfers} | 予算振替え合計: 予算振替えの合計数。 | 番号 |
| {budgetTransfers} | 予算振替え: 予算振替えの数。 | 番号 |
| {budgetTransfersQuantity} | 予算振替え数量: 予算振替えの数量。 | 番号 |
| {budgetTransfersUnit} | 予算振替え単位: 予算振替えの計測単位。 | 文字列 |
| {budgetTransfersUnitPrice} | 予算振替え単価: 予算振替えの単価。 | 番号 |
| {payment.columnView.totalChangeOrders} | 支払い請求の承認済み変更依頼の合計金額を返します。 | 番号 |
| {payment.columnView.totalRevisedValue} | 支払い請求の改訂された金額の合計を返します。 | 番号 |
| {payment.columnView.totalPreviousAmount} | 前回の支払い請求の作業完了金額の合計を返します。 | 番号 |
| {payment.columnView.totalAmount} | 現在の支払い請求の作業完了金額の合計を返します。 | 番号 |
| {payment.columnView.totalMaterialsStored} | 支払い請求の現場にある資材の合計金額を返します。 | 番号 |
| {previousMaterialsOnStore} | 過去のすべてのアプリケーションから、調達資材の量を返します。 | 番号 |
| {previousClaimedAmount} | 過去のアプリケーションから要求された量を返します。 | 番号 |
| {claimedAmount} | 今回の請求期間の作業完了要求額を返します。 | 番号 |
| {claimedWorkCompleted} | 作業完了要求額の合計を返します。 | 番号 |
| {payment.columnView.totalCompleted} | 調達資材の価格など支払い請求の合計終了金額を返します。 | 番号 |
| {payment.columnView.percentTotalCompleted} | 調達資材の金額など支払い請求の合計終了パーセンテージを返します。 | 番号 |
| {payment.columnView.totalBalanceToFinish} | 支払い請求の完了までの合計調整額を返します。 | 番号 |
| {payment.columnView.totalRetainage} | 支払い請求の合計留保金額を返します。 | 番号 |
| {payment.thisPeriodRetainage} | 現在の支払の合計留保額から前の支払の留保額を差し引いた金額を返します。 | 番号 |
| {#committedSubItems}{value}{/committedSubItems} | 支払関連項目のサブ項目の確定済み数量を返します。 | 番号 |
| {#committedSubItems}{unitPrice}{/committedSubItems} | 支払関連項目のサブ項目の確定済み単価を返します。 | 番号 |
| {latestComment.content} | 各行の最新のレビュー コメントを返します。 | 番号 |
| {this.costItem.corNumber} | 支払関連項目にリンクされている増減管理情報を返します。corNumber の代わりに、ocoNumber、scoNumber、scoType、corType、ocoType、corName、ocoName、または scoName を記述して、必要な情報を含めることもできます。 | 番号 |
| {materialsBilled} 例: {payment.columnView.materialsBilled} |
[請求済み資材]設定が有効になっている場合、変数は請求済み資材の量を返します。詳細については、「支払い請求の資材」を参照してください。 | 番号 |
| {previousMaterialsBilled} 例: {payment.columnView.previousMaterialsBilled} |
[請求済み資材]設定が有効になっている場合、変数は前の請求から請求済み資材の量を返します。詳細については、「支払い請求の資材」を参照してください。 | 番号 |
| {payment.lineView.materials} 例: {payment.lineView.materials} |
[請求済み資材]設定が有効になっている場合、この変数は previousMaterialsBilled + materialsBilled (この期間)として計算された、各行項目に対して請求済み資材の合計を返します。これにより、累積の資材請求額を取得するための単一の変数が提供されます。詳細については、「支払い請求の資材」を参照してください。 | 番号 |
| {previousAmount | add: previousMaterialsBilled} | [請求済み資材]設定が有効になっている場合、変数は完了した以前の作業と請求された資材の合計を返します。詳細については、「支払い請求の資材」を参照してください。 | 番号 |
| {payment.columnView.totalPreviousAmount | add:payment.columnView.previousMaterialsBilled} | [請求済み資材]設定が有効になっている場合、変数は完了した以前の作業と請求された資材の合計を提供します。詳細については、「支払い請求の資材」を参照してください。 | 番号 |
| {totalAdvanceAmount} | 全期間の前払い金の総額。 | 番号 |
| {totalAdvancePercent} | 全請求額の前払い金のパーセント。 | 番号 |
| {totalRecoupmentAmount} | 全期間の総回収額。 | 番号 |
| {totalRecoupmentPercentOfAdvance} | 今回の請求期間の回収率。 | 番号 |
| {advanceAmount} | 今回の請求期間の前払い金の金額。 | 番号 |
| {advancePercent} | 今回の請求期間の前払い金のパーセント。 | 番号 |
| {recoupmentAmount} | 今回の請求期間の回収額。 | 番号 |
| {recoupmentPercentOfCompletedWork} | 完了した作業の回収率。 | 番号 |
| {previousAdvanceAmount} | 今回の請求期間に完了した作業の回収のパーセンテージ。 | 番号 |
| {previousRecoupmentAmount} | 前回の回収額。 | 番号 |
| {previousAdvanceAmountForeignCurrency} | {previousAdvanceAmount}外貨の値。 | 番号 |
| {previousRecoupmentAmountForeignCurrency} | {previousRecoupmentAmount}外貨の値 | 番号 |
| {payment.columnView.totalOriginalAmount} | 契約金額、予算の振替え、増減管理を含む、支払い請求の元の価格表の合計を返します。 | 番号 |
| {approvedBudgetTransfers} | 承認済み予算振替えの合計数を返します。 | 番号 |
| {previousApprovedBudgetTransfers} | 前の期間までに承認されたすべての予算振替えの金額を返します。 | 番号 |
| {approvedThisPeriodBudgetTransfers} | この期間に追加された承認済み予算振替えの金額を返します。 | 番号 |
| {totalBudgetTransfers} | 予算振替えの合計数を返します。 | 番号 |
| {budgetTransfers} | 予算振替えの数を返します。 | 番号 |
| {budgetTransfersQuantity} | 予算振替えの数量を返します。 | 番号 |
| {budgetTransfersUnit} | 予算振替えの計測単位を返します。 | 文字列 |
| {budgetTransfersUnitPrice} | 予算振替えの単価を返します。 | 番号 |