合約變數及主合約變數
使用文件樣板和您選擇的變數以建立包含必要資訊的合約，例如：
- 合約代碼或類型、
- 合約總值、
- 合約的核准日期。
可用於引入合約資訊的變數，將拆解為以下幾節的表格：
- 合約變數—選取此變數可用來建立自訂合約，並可隨時傳送給分包商。若要進一步瞭解合約，請參閱〈合約〉一文。
- 變更命令的合約變數—可用於產生下游變更命令的一系列變數。若要進一步瞭解，請參閱〈變更命令狀態〉一文。
- 主合約變數—選取此變數可用來建立自訂主合約，並可隨時傳送給擁有者。若要進一步瞭解如何使用主合約，請參閱〈主合約〉一文。
- 變更命令的主合約變數—選取此變數可用於產生上游變更命令。
合約變數
使用表格中的變數來建立合約樣板。您可以使用表格頂部的搜尋來縮小表格中的結果範圍。
| 變數 | 描述 |
| {contract.name} | 傳回合約的名稱 |
| {contract.description} | 傳回合約的描述 |
| {contract.code} | 傳回合約的代碼 |
| {contract.type} | 傳回合約的類型 |
| {@contract.note} | 傳回合約上的註記 |
| {contract.awarded} 例如：{contract.awarded | written} |
傳回合約授予金額。您可以加入支付合約金額所要使用的貨幣。例如：{contract.awarded | writtenCurrency:'USD'}。 |
| {#contract.therouses} 和 {/contract.exhibits} | 傳回合約展示來源檔的名稱和目標名稱。 #contract.thermouses 和 /contract.exhibits 必須一起使用。 將傳回任何介於 #contract.theromes 與 /contract.exhibits 之間的合約展示變數。 請參閱小節上的 mustache.github.io 說明，以進一步瞭解此變數的語法。 秘訣: 為 #contract.therouses 和 /contract.exhibits 之間的變數後端加入傳回字元，以在獨立的行上顯示它們。 |
| {#contract.exhibits.name} 例如： {#contract.exhibits}{name} {/contract.exhibits} |
傳回合約展示來源檔的原始檔名和副檔名 |
| {#contract.exhibits.targetName} 例如： {#contract.exhibits}{targetName} {/contract.exhibits} |
傳回已產生套件中合約展示的新名稱 |
| {contract.originalBudget} | 傳回原始合約的預算值 |
| {contract.internalAdjustment} | 傳回合約調整後的值 |
| {contract.approvedOwnerChanges} | 傳回已核准擁有者變更的值 |
| {contract.revised} | 傳回已連結至合約的預算修訂金額的值 |
| {contract.pendingOwnerChanges} | 傳回待決擁有者變更的值 |
| {contract.projectedBudget} | 傳回預估合約預算的值 |
| {contract.projectedCost} | 傳回預估合約成本的值 |
| {(contract.awarded | toNumber) + (contract.approvedChangeOrders | toNumber)} | 傳回合約總值 |
| {contract.approvedChangeOrders} | 傳回合約的已核准變更命令的值 |
| {contract.pendingChangeOrders} | 傳回合約的待決變更命令的值 |
| {contract.reserves} | 傳回合約保留值 |
| {contract.forecastFinalCost} | 傳回合約的預測最終成本的值 |
| {contract.awardedAt | date:'MM DD, YYYY'} | 傳回合約的授與日期 |
| {contract.StatusChangedAt | date:'MM DD, YYYY'} | 傳回最後變更合約狀態的日期 |
| {contract.sentAt | date:'MM DD, YYYY'} | 傳回合約的傳送日期 |
| {contract.responseDue | date:'MM DD, YYYY'} | 傳回合約的回應日期 |
| {contract.onsiteAt | date:'MM DD, YYYY'} | 傳回合約的現場日期 |
| {contract.procuredAt | date:'MM DD, YYYY'} | 傳回合約的採購日期 |
| {contract.approvedAt | date:'MM DD, YYYY'} | 傳回合約的核准日期 |
| {contract.executedAt | date:'MM DD, YYYY'} | 傳回合約的執行日期 |
| {contract.returnedAt | date:'MM DD, YYYY'} | 傳回合約的傳回日期 |
| {contract.varianceTotal} | 傳回合約的差異值 |
| {contract.retentionCap} | 傳回合約迄今的承諾總和百分比 |
| {contract.completedWorkRetentionPercent || contract.retention.completedWorkRetentionPercent} | 傳回已完成工作總數的保留百分比 |
| {contract.materialsRetentionPercent || contract.retention.materialsRetentionPercent} | 傳回現場材料的保留百分比 |
| {@contract.scopeOfWork} | 傳回合約的工作範圍。此變數所在的行不得有其他文字。 |
| {contract.properties["Attachment N"] || "N/A"} 或者 {contract.properties["Attachment N"] | bool: "Yes":"No":"N/A"} |
傳回附件 N 的值，或傳回「N/A」(如果附件 N 為空) |
| {sco.contract.properties[“Custom Attribute Name defined on Contract”]} | 從 SCO 的已連結子合約傳回自訂屬性 |
| {#scheduleOfValues} 和 {/scheduleOfValues} | 傳回合約計價進度表表格中的所有行項。 #scheduleOfValues 和 /scheduleOfValues 必須一起使用。 將傳回任何介於 #scheduleOfValues 與 /scheduleOfValues 之間的計價進度表變數。 請參閱小節上的 mustache.github.io 說明，以進一步瞭解此變數的語法。 |
| {#scheduleOfValues.code} 例如： {#scheduleOfValues}{code}{/scheduleOfValues} |
傳回計價進度表中的合約代碼 |
| {#scheduleOfValues.name} 例如： {#scheduleOfValues}{name}{/scheduleOfValues} |
傳回計價進度表中的合約名稱 |
| {#scheduleOfValues.quantity} 例如： {#scheduleOfValues}{quantity}{/scheduleOfValues} |
傳回計價進度表中的數量 |
| {#scheduleOfValues.unit} 例如： {#scheduleOfValues}{unit}{/scheduleOfValues} |
傳回計價進度表中的單位 |
| {#scheduleOfValues.unitPrice} 例如： {#scheduleOfValues}{unitPrice}{/scheduleOfValues} |
傳回計價進度表中的單價 |
| {#scheduleOfValues.amount} 例如： {#scheduleOfValues}{amount}{/scheduleOfValues} |
傳回計價進度表中的總量 |
| {#scheduleOfValues.bulkUnitPrice} 例如： {#scheduleOfValues}{bulkUnitPrice}{/scheduleOfValues} |
僅限合約變數。傳回計價進度表中的批量單價。 |
| {#scheduleOfValues.quantityPerBulk} 例如： {#scheduleOfValues}{quantityPerBulk}{/scheduleOfValues} |
僅限合約變數。傳回計價進度表中的顯示數量。 |
| {#amount > 0.0} {amount} {/} {#amount == 0.0} Included {/} | 針對保留為 0 的任何金額值，請傳回「已包含」。 |
| {#unitPrice > 0.0} {unitPrice} {/} {#unitPrice == 0.0} Included {/} | 針對保留為 0 的任何單位價格值，請傳回「已包含」。 |
注意事項:
合約文件樣板也可以透過在變數前加上字首 contract.，來使用「主合約變數」。例如，contract.mainContract.plannedCompletionDate 將輸出主合約的計畫完成日期。
變更命令的合約變數
建立下游變更命令時，使用選取的合約變數來產生文件。您可以使用表格頂部的搜尋來縮小表格中的結果範圍。
| 變數 | 描述 | PCO | RFQ | COR | OCO | SCO |
| {contractOriginal} | [E]，相關合約的原始承諾 |  |
 |
|
|
|
| {previousContractApproved} | [F]，產生 SCO 文件的過程中，在目前的 SCO 之前建立的所有相關合約的已核准 SCO | |
|
|
|
|
| {previousContractPending} | 產生 SCO 文件的過程中，在目前的 SCO 之前建立的所有相關合約的未核准 SCO | |
|
|
|
|
| {previousContractAmount} | [G]，其中 [G] = [E] + [F] | |
|
|
|
|
| {revisedContractAmount} | [H]，其中 [H] = [G] + 此 OCO 下包括標記在內，已核准的成本項目值的總和 | |
|
|
|
|
| {generalContractAmount} | 傳回合約的原始淨價 | |
|
|
|
|
| {generalContractTaxAmount} | 傳回原始合約的總稅金 | |
|
|
|
|
| {generalContractGrandAmount} | 傳回原始合約的總價格 (包括稅金) | |
|
|
|
|
| {previousGeneralContractAmount} | 傳回已修訂的合約淨價 (包括已核准的 OCO) | |
|
|
|
|
| {previousGeneralContractTaxTotalAmount} | 傳回已修訂的合約總稅金 (包括已核准的 OCO) | |
|
|
|
|
| {previousGeneralContractGrandTotalAmount} | 傳回已修訂的合約總價格 (包括稅金和已核准的 OCO) | |
|
|
|
|
主合約變數
使用選取的變數來建立主合約的樣板。您可以使用表格頂部的搜尋來縮小表格中的結果範圍。
| 變數 | 描述 | |
| {mainContract.code} | 傳回主合約的代碼 | |
| {mainContract.description} | 傳回主合約的描述 | |
| {mainContract.name} | 傳回主合約的名稱 | |
| {mainContract.status} | 傳回主合約的狀態 | |
| {mainContract.amount} | 傳回主合約的金額 | |
| {mainContract.paymentDue | date:'MM DD, YYYY'} | 傳回主合約的到期日 | |
| {mainContract.type} | 傳回主合約的類型 | |
| {@mainContract.note} | 傳回主合約的註記 | |
| {mainContract.createdAt | date:'MM DD, YYYY'} | 傳回主合約的建立日期 | |
| {@mainContract.scopeOfWork} | 傳回主合約的工作範圍。此變數所在的行不得有其他文字。 | |
| {#scheduleOfValues} 和 {/scheduleOfValues} | 傳回主合約的計價進度表清單 | |
| {#scheduleOfValues.code} 例如： {#scheduleOfValues}{code}{/scheduleOfValues} |
傳回計價進度表中的主合約代碼 | |
| {#scheduleOfValues.quantity} 例如： {#scheduleOfValues}{quantity}{/scheduleOfValues} |
傳回計價進度表中的數量 | |
| {#scheduleOfValues.unit} 例如： {#scheduleOfValues}{unit}{/scheduleOfValues} |
傳回計價進度表中的單位 | |
| {#scheduleOfValues.unitPrice} 例如： {#scheduleOfValues}{unitPrice}{/scheduleOfValues} |
傳回計價進度表中的單價 | |
| {#scheduleOfValues.amount} 例如： {#scheduleOfValues}{amount}{/scheduleOfValues} |
傳回計價進度表中的總量 | |
| {mainContract.executedDate | date:'MM DD, YYYY'} | 傳回主合約的執行日期 | |
| {mainContract.startDate | date:'MM DD, YYYY'} | 傳回主合約的開始日期 | |
| {mainContract.plannedCompletionDate | date:'MM DD, YYYY'} | 傳回主合約的計畫完成日期 | |
| {mainContract.actualCompletionDate | date:'MM DD, YYYY'} | 傳回主合約的完成日期 | |
| {contract.mainContract.createdAt | date:'MM DD, YYYY'} | 傳回主合約的建立日期 | |
| {mainContract.closeDate | date:'MM DD, YYYY'} | 傳回主合約的結束日期 | |
| {mainContract.plannedCompletionDate} | 傳回計劃完成日期 | 日期 |
| {mainContract.revisedCompletionDate} | 傳回修訂完成日期 | 日期 |
| {mainContract.scheduleChange} | 傳回進度表變更 | 數量 |
| {oco.proposedRevisedCompletionDate} | 傳回建議或修訂完成日期 | 日期 |
| {mainContract.owner} | 從圖示列面板傳回擁有者 | |
| {mainContract.owner.phone} | 傳回擁有者的公司電話號碼 | |
| {mainContract.architect} | 從圖示列面板傳回建築師的公司 | |
| {mainContract.taxes.TaxTotal.amount} | 傳回原始合約的總稅金 | |
| {mainContract.taxes.GrandTotal.amount} | 傳回原始合約的總價格 (包括稅金) | |
| {mainContract.taxesWithApprovedOCOs.TaxTotal.amount} | 傳回原始合約的總稅金 | |
| {mainContract.taxesWithApprovedOCOs.GrandTotal.amount} | 傳回已修訂的合約總價格 (包括稅金) |
變更命令的主合約變數
建立上游變更命令時，使用選取的主合約變數來產生文件。您可以使用表格頂部的搜尋來縮小表格中的結果範圍。
| 變數 | 描述 |
| {mainContract.code} | 傳回主合約的代碼 |
| {mainContract.description} | 傳回主合約的描述 |
| {mainContract.name} | 傳回主合約的名稱 |
| {mainContract.status} | 傳回主合約的狀態 |
| {mainContract.amount} | 傳回主合約的金額 |
| {mainContract.type} | 傳回主合約的類型 |
| {@mainContract.note} | 傳回主合約的註記 |
| {mainContract.createdAt | date:'MM DD, YYYY'} | 傳回主合約的建立日期 |
| {@mainContract.scopeOfWork} | 傳回主合約的工作範圍。此變數所在的行不得有其他文字。 |
| {mainContract.executedDate | date:'MM DD, YYYY'} | 傳回主合約的執行日期 |
| {mainContract.startDate | date:'MM DD, YYYY'} | 傳回主合約的開始日期 |
| {mainContract.plannedCompletionDate | date:'MM DD, YYYY'} | 傳回主合約的計畫完成日期 |
| {mainContract.actualCompletionDate | date:'MM DD, YYYY'} | 傳回主合約的完成日期 |
| {contract.mainContract.createdAt | date:'MM DD, YYYY'} | 傳回主合約的建立日期 |
| {mainContract.closeDate | date:'MM DD, YYYY'} | 傳回主合約的結束日期 |
| {generalContractTaxAmount} | 傳回原始合約的總稅金 |
| {generalContractGrandAmount} | 傳回原始合約的總價格 (包括稅金) |
秘訣:
合約文件樣板和變更命令文件樣板也可以使用主合約變數。將以下其中一項加入至特定主合約變數：
- 合約。
- pco。
- rfq。
- rco。
- oco。
- sco。
例如，在 SCO 文件樣板中加入
sco.mainContract.startDate將輸出主合約的開始日期。工作表無法支援 Rich Text 變數。在工作表中使用變數時，請從變數中移除「@」。例如，請用 {pco.scopeOfWork} 而非 {@pco.scopeOfWork} 。
相關文章
若要進一步瞭解在不同情境下的變數使用方式，請參閱〈使用變數範例〉一文。