人员变量

本文中的变量用于引用项目中的不同人员，并自动使用在 Build 中输入的数据填写文档。

本文中提供了下面几个表：

若要为项目中的人员设置角色，请参见常规设置一文中的“公司设置”部分。

承包商和建筑师变量

使用下表中的变量来生成包含项目中人员的必要相关信息的文档。例如，您可以填写联系人的姓名或电话号码。

将 x 替换为要返回的人员类型，即以下几项之一：建筑师、承包商或公证员。

变量	描述	PCO	RFQ	COR	OCO	SCO
{x.name}	返回联系人的公司名称。
{x.contact.name}	返回联系人的联系人姓名。
{x.contact.phone}	从联系人的 Autodesk ID 个人资料返回此人的主要电话号码。
{x.contact.email}	从常规设置返回列出的联系人的电子邮件。
{x.contact.taxId}	返回联系人的税号。

使用下表中的变量在生成的文档中填充有关业主的信息。例如，您可以添加业主的姓名或电话号码。

变量	描述	PCO	RFQ	COR	OCO	SCO
{owner.name}	返回业主的公司名称。
{owner.contact.name}	返回业主的联系人姓名。
{owner.contact.phone}	从业主的 Autodesk ID 个人资料返回此人的主要电话号码。
{owner.erpId}	返回业主的 ERP ID。
{owner.taxId}	返回业主的税号。
{owner.trade}	返回业主的行业。
{owner.contact.email}	从常规设置返回业主的电子邮件地址。

注意：必须在 Project Admin 的“常规”选项卡下的“公司设置”部分中添加业主信息。

使用下表中的变量来生成包含接收者的相关信息的文档。

注意：对于主合同、预算支付申请、COR 和 OCO，以下变量将返回业主详细信息的联系人的数据。对于合同、成本支付申请、PCO、RFQ 和 SCO，这些变量将返回供应商详细信息的联系人的数据。

将 x 替换为以下几项之一：mainContract、contract、pco、rfq、cor、oco、sco 或 payment。

变量	描述
{x.recipient.name}	返回接收者的全名。
{x.recipient.firstName}	返回接收者的名字。
{x.recipient.lastName}	返回接收者的姓氏。
{x.recipient.email}	返回接收者的电子邮件地址。
{x.recipient.phone}	从接收者的 Autodesk ID 个人资料返回此人的主要电话号码。
{x.recipient.jobTitle}	返回变更单或合同的接收者的职位，该信息来自用户的 Autodesk ID 个人资料设置。
{x.recipient.taxId}	返回接收者的税号。

使用下表中的变量来生成包含项目中人员的相关信息的文档。例如，您可以填充接收变更单的公司的名称或合同接收方的完整名称。您可以使用表顶部的搜索功能来减少表中显示的结果。

将 x 替换为以下几项之一：mainContract、contract、pco、rfq、rco、oco、sco 或 payment。

将 y 替换为以下几项之一：recipient、creator、purchasedBy 或 supplier。

变量	描述	合同	PCO	RFQ	COR	OCO	SCO	成本支付申请
{x.y.email}	返回变更单、合同或成本支付申请的接收者的电子邮件地址。
{x.y.firstName}	返回变更单、合同或成本支付申请的接收者的名字。
{x.y.lastName}	返回变更单、合同或成本支付申请的接收者的姓氏。
{x.y.name}	返回变更单、合同或成本支付申请的接收者的全名。
{x.y.jobTitle}	返回变更单或合同的接收者的职位，该信息来自用户的 Autodesk ID 个人资料设置。
{x.y.company.address.*}	返回收到变更单或合同的公司的地址。
{x.y.company.name}	返回收到变更单、合同或成本支付申请的公司的名称。
{x.y.phone}	从接收者的 Autodesk ID 个人资料返回此人的第一个电话号码。
{x.y.company.erpId}	返回收到变更单或合同的公司的 ERP 合作伙伴公司 ID。
{x.y.company.taxId}	返回收到变更单或合同的公司的税号。
{x.y.company.phone}	返回收到变更单或合同的公司的电话号码。
{x.y.company.description}	返回收到变更单或合同的公司的描述。

使用下表中的变量在生成的文档中填充有关公证员的信息。例如，您可以添加接收变更单的公司的名称或合同接收方的完整名称。

使用下表中的变量来生成包含项目中其他协作者的相关信息的文档。这些变量可用于访问作为其他协作者添加到各种文档类型的公司和联系人的相关信息。

变量	描述	合同	PCO*	RFQ	COR	OCO	SCO	预算支付申请
{oco.additionalCollaborators}	返回变更单的其他协作者公司的数组。
{#oco.additionalCollaborators}{name}{/}	遍历变更单中的其他协作者公司并返回其名称。
{#oco.additionalCollaborators}{#contacts}{name}{/contacts}{/}	遍历其他协作者公司的联系人并返回其姓名。
{#oco.additionalCollaborators}{#contacts}{email}{/contacts}{/}	遍历其他协作者公司的联系人并返回其电子邮件地址。
{oco.additionalCollaborators[0].name}	返回第一个其他协作者公司的名称。
{oco.additionalCollaborators[0].contacts[0].name}	返回第一个其他协作者公司的第一个联系人的姓名。
{oco.additionalCollaborators[0].contacts[0].email}	返回第一个其他协作者公司的第一个联系人的电子邮件地址。

注意：在项目流程设置中启用了“将潜在变更单用于变更单请求”时，PCO 的其他协作者变量可用。

您可以遍历其他协作者及其联系人，以表格的格式显示其详细信息。请参见下面的示例：

公司名称	联系人姓名	联系人电子邮件地址
{#oco.additionalCollaborators}{name}
{#contacts}	{name}	{email}{/contacts}{/oco.additionalCollaborators}

本例将在表格中动态填充所有其他协作者及其联系人的姓名和电子邮件地址。

若要访问第一个其他协作者公司及其第一个联系人，您可以使用以下变量：

本例将检索第一个其他协作者公司的名称及其第一个联系人的姓名和电子邮件地址。