当事方和全球通讯簿

当事方和全球通讯簿是财务和运营应用程序中的概念。 当事方可以是组织或个人。 在全球范围内存储和管理当事方的属性（如姓名、语言、联系人和地址）非常方便。 然后，当某个属性值在一个地方更改时，更改将反映在涉及当事方的所有地方。

当事方

当事方是企业中涉及的个人或组织。 使用当事方概念时，个人或组织可以在企业中扮演多个角色（例如，工作人员、客户、供应商或联系人）。 该角色基于环境和目的。 下面是来自两个虚拟公司（Contoso 和 Fabrikam）的角色的一些示例：

• 工作人员 – 员工。 例如，Contoso 的员工。
• 供应商 – 为企业提供商品或服务的供应商组织或独立经营者。 例如，如果 Fabrikam 将供应品出售给 Contoso，Fabrikam 就是 Contoso 的供应商。
• 联系人 – 要联系的人员。 例如，如果 Contoso 从 Fabrikam 购买供应品，则 Contoso 的员工将与 Fabrikam 的联系人联系。
• 客户 – 从公司购买商品的个人或公司。 例如，如果 Contoso 从 Fabrikam 购买供应品，则 Contoso 是 Fabrikam 的客户。

当事方模型通常用于表示组织和个人之间中等到复杂的关系，特别是在当事方扮演多个角色时。 下面是一些常见示例：

• 当事方可以是客户，也可以是供应商。 例如，在北美，Fabrikam 向 Contoso 出售电线，并从 Contoso 购买装配后的扬声器。 在欧洲，Fabrikam 向 Contoso 出售零件，但没有从 Contoso 购买任何商品。
• 当事方可以是员工，也可以是客户。 例如，Contoso 的员工从 Contoso 购买电子产品供个人使用。
• 个人和组织之间可能存在多对多 (N:N) 关系。 例如，Fabrikam 向服务专家提供服务并雇用安置协调员。 安置协调员针对一些 Fabrikam 客户的工作请求匹配服务专家。 Contoso 是 Fabrikam 的客户之一。 当 Contoso 需要服务专家时，它与安置协调员联系，然后由协调员进行请求。 由于安置协调员处理所有客户的请求，因此涉及 N:N 关系。

下图显示了当事方的数据模型。

提示

当您尝试创建新的客户记录时，请使用当事方字段按名称搜索记录。 这样，如果找到记录，只需选择它。 系统然后将自动填充当事方的所有数据。 您不必手动设置所有必填字段。 可以在现成的客户、联系人和供应商页面上找到此行为。

双重写入不支持财务和运营应用的所有当事方角色。 有关当事方角色的完整列表，请参阅全球通讯簿概览。

全球通讯簿

全球通讯簿是参与企业的组织和个人的邮寄地址和电子地址的目录。

全球通讯簿根据需要存储和处理尽可能多的邮寄地址和电子地址。 例如，Fabrikam 在 50 个地点设有加油站。 每个地点都有不同的邮寄地址、电子邮件地址和电话号码。 所有企业采购都向主要加油站计费，但会直接运送到请求采购的特定加油站。 全球通讯簿将主要加油站存储为 Fabrikam 的帐单地址，将每个加油站存储为装运地址。 这些地址可以存储一次，然后可以在报价单和订单需要提供地址时对这些地址进行检索。

根据业务环境，个人或组织可能扮演多个角色，所有角色可能使用相同的邮寄地址和电子地址。 在这种情况下，一个角色的地址更改应该体现在所有其他角色中。 全球通讯簿在全球范围内存储和处理地址。

下图显示了全球通讯簿的数据模型。

联系人

在 Customer Engagement 应用中，联系人是个人。 但是，已重载联系人表以表示个人、门户用户、企业对消费者 (B2C) 客户或供应商。 该表示形式是隐式的，除非检查相关交易，否则无法分辨差异。 联系人表已限制为与客户表具有一对一 (1:1) 关系。 作为当事方和全球通讯簿模型的一部分，双重写入为分类引入显式属性，并且允许个人联系人和组织（客户实体或供应商实体）之间有 N:N 关系。

有两种类型的联系人行：

• 出售联系人 – 公司字段有必填值的联系人行。
• 非出售联系人 – 公司字段为空的联系人行。

联系人表可以存储以下类型的行。

行类型	说明
作为客户的个人（例如，可出售联系人或 B2C 客户）	公司字段不为空并且是客户字段设置为是的出售联系人记录。
作为供应商的个人（例如，诸如供应商的独立经营者）	公司字段不为空并且是供应商字段设置为是的出售联系人记录。
既是客户又是供应商的个人	公司字段不为空，是客户字段设置为是并且是供应商字段设置为是的出售联系人记录。 个人既可以是一个产品的生产者，也可以是另一个产品的消费者。 财务和运营应用和双重写入均支持此关系。
作为组织联系人的个人不能是客户或供应商	公司字段为空，是客户字段设置为否并且是供应商字段设置为否的非出售联系人记录。

当事方的联系人表

当事方的联系人表在客户行和联系人行之间存储和处理 N:N 关系。 它可以从非出售行中筛选出售联系人行，并仅将非出售联系人行与客户或供应商行关联。

例如，Natasha Jones 和 Miguel Reyes 是当地的兽医，负责照料农场。 Natasha 负责西雅图地区，而 Miguel 负责肯特地区。 在 Customer Engagement 应用中，农场表示为客户，而兽医则表示为联系人。 Natasha 的一个联系人记录将与 Natasha 合作的所有农场相关联。 同样，Miguel 的一个联系人记录将与 Miguel 合作的所有农场相关联。

这些关系存储在当事方的联系人表中。 您可以在现成的客户、联系人和供应商页面上找到此信息：

• 在客户页上，您可以使用关联的联系人选项卡将一个或多个联系人与客户行关联。 这样，您将为组织分配联系人。 然后，您可以选择一个联系人作为客户的主要联系人。 如果您使用快速创建页，则只能选择一个联系人。 此行为与使用供应商页时相同，记录类型为组织。

• 在联系人页上，当行是客户、供应商或两者（出售联系人）时，您可以使用关联的联系人选项卡关联一个或多个联系人。 这样，您将为 B2C 客户或供应商分配联系人。 然后，您可以选择一个联系人作为主要联系人。 如果您使用快速创建页，则只能选择一个联系人。

• 在联系人页上，当行是联系人（非出售联系人）时，您可以使用关联的组织选项卡关联一个或多个客户或供应商。 这样，您将为基础联系人分配客户或供应商。 客户或供应商可以是组织、个人或二者均可。 您一次只能在四个字段的其中一个字段中选择值：

  • 如果您在当事方 ID 字段中选择值，基础联系人将分配给所选当事方的所有角色。
  • 如果您在关联的联系人字段中选择值，您将选择属于个人类型的出售联系人。
  • 如果您在关联的客户或关联的供应商字段中选择值，您将选择组织。

  

  无论您的选择如何，将在当事方级别创建关联，此关联将应用于当事方的所有角色，存储在当事方的联系人实体中。

注释

客户互动应用中当事方的联系人表的显示名称是客户/供应商的联系人。

当您打开是客户字段和是供应商都设置为否的联系人行时，关联的组织选项卡将显示。 使用此选项卡可以将一个或多个客户或供应商组织与联系人关联。

当您打开是客户字段或是供应商字段设置为是的联系人行时，关联的联系人选项卡将显示。 使用此选项卡关联一个或多个联系人。

邮寄地址

已在客户、联系人和供应商页引入了新的地址选项卡。 此选项卡使用网格支持多个邮寄地址，如下图所示。

此网格包括以下列：

• 邮寄地址角色 – 邮寄地址的用途。
• 是主要 – 指示地址是否为主要地址的值。
• 地址编号 – 地址顺序。

您可以使用网格上方的新建地址按钮创建任意数量的邮寄地址。

在 Customer Engagement 应用中，当用户在帐户页面的摘要选项卡上输入地址时，地址 1 和地址 2 字段分别对应于交货和发票地址。 但是，当用户在财务和运营应用中创建邮政地址时，客户记录的前两个地址将显示在地址 1 和地址 2 字段中，并且用户可以选择将地址用途更改为交货和发票。

同样，联系人页的摘要选项卡上的地址 1、地址 2 和地址 3 字段分别对应于企业、交货和发票地址。

电子地址

已在客户、联系人和供应商页引入了新的电子地址选项卡。 此选项卡使用网格支持多个电子地址，如下图所示。

此网格包括以下列：

• 类型 – 电子地址的类型。
• 是主要指示地址是否为主要地址的值。
• 用途 – 电子地址的用途。

您可以使用网格上方的新建电子地址按钮创建任意数量的地址。

在潜在顾客资格授予期间，您可以同时提供业务电话号码和移动电话号码。 如果 IsMobile=No，则将业务电话号码视为主要电话号码，如果 IsMobile=Yes，这将移动电话号码视为主要电话号码。

提示

请使用帐户和联系人窗体上的地址和电子地址选项卡管理邮寄地址和电子地址。 这样可以确保将地址数据同步到财务和运营应用。

设置

1. 打开您的 Customer Engagement 应用环境。

2. 安装所有必备解决方案，如分隔的双重写入应用程序业务流程包中所述。

3. 安装双重写入当事方和全球通讯簿解决方案。

4. 打开 Finance and Operations 应用。 导航到数据管理模块并选择双写入选项卡。将打开双写入管理页面。

5. 使用应用解决方案功能应用在步骤 2 和 3 中安装的解决方案。

6. 停止以下映射，因为不再需要它们。 改为运行 Contacts V2 (msdyn_contactforparties) 映射。

   • CDS 联系人 V2 和联系人（指客户联系人）
   • CDS 联系人 V2 和联系人（指供应商联系人）

7. 针对当事方功能更新以下实体映射，因此必须将最新版本应用到这些映射。

   映射	更新到此版本	更改
   CDS Parties (msdyn_parties)	1.0.0.2	这是作为此版本的一部分添加的新映射。
   Contacts V2 (msdyn_contactforparties)	1.0.0.6	这是作为此版本的一部分添加的新映射。
   Customers V3 (accounts)	1.0.0.5	删除了 PartyNumber 和与其他当事方相关字段，如姓名、个人详细信息、邮寄地址字段和电子联系人地址。
   Customer V3 (contacts)	1.0.0.5	删除了 PartyNumber 和与其他当事方相关字段，如姓名、个人详细信息、邮寄地址字段和电子联系人地址。
   Vendors V2 (msdyn_vendors)	1.0.0.6	删除了 PartyNumber 和与其他当事方相关字段，如姓名、个人详细信息、邮寄地址字段和电子联系人地址。
   CDS Sales quotation headers (quotes)	1.0.0.7	已将联系人替换为 ContactforParty 引用。
   Sales invoice headers V2 (invoices)	1.0.0.4	已将联系人替换为 ContactforParty 引用。
   CDS Sales order headers (salesorders)	1.0.0.5	已将联系人替换为 ContactforParty 引用。
   CDS Party postal address locations (msdyn_partypostaladdresses)	1.0.0.1	这是作为此版本的一部分添加的新映射。
   CDS postal address history V2 (msdyn_postaladdresses)	1.0.0.2	这是作为此版本的一部分添加的新映射。
   CDS postal address locations (msdyn_postaladdresscollections)	1.0.0.0	这是作为此版本的一部分添加的新映射。
   Party Contacts V3 (msdyn_partyelectronicaddresses)	1.0.0.0	这是作为此版本的一部分添加的新映射。
   Complimentary Closings (msdyn_compliemntaryclosings)	1.0.0.0	这是作为此版本的一部分添加的新映射。
   Decision making roles (msdyn_decisionmakingroles)	1.0.0.0	这是作为此版本的一部分添加的新映射。
   Loyalty levels (msdyn_loyaltylevels)	1.0.0.0	这是作为此版本的一部分添加的新映射。
   Contact person titles (msdyn_salescontactpersontitles)	1.0.0.0	这是作为此版本的一部分添加的新映射。
   Personal character types (msdyn_personalcharactertypes)	1.0.0.0	这是作为此版本的一部分添加的新映射。
   Salutations (msdyn_salutations)	1.0.0.0	这是作为此版本的一部分添加的新映射。
   Employment job functions (msdyn_employmentjobfunctions)	1.0.0.0	这是作为此版本的一部分添加的新映射。
   CDS Address roles (msdyn_addressroles)	1.0.0.0	这是作为此版本的一部分添加的新映射。

8. 在运行上述映射之前，您必须按照以下步骤中的说明手动更新集成键。 然后选择保存。

   映射	键
   科目	accountnumber [客户编号] msdyn_company.cdm_companycode [公司（公司代码）]
   联系人	msdyn_contactpersonid [客户编号/联系人 ID] msdyn_company.cdm_companycode [公司（公司代码）]
   客户/供应商的联系人	msdyn_contactforpartynumber [当事方的联系人编号] msdyn_associatedcompanyid.cdm_companycode [关联的公司（公司代码）]
   供应商	msdyn_vendoraccountnumber [供应商帐号] msdyn_company.cdm_companycode [公司（公司代码）]

9. 在 Dataverse 中，重复检测规则的字符数限制已从 450 个增加到 700 个字符。 此限制让您可以将一个或多个键添加到重复检测规则中。 通过设置以下字段扩展客户表的重复检测规则。

   字段	值
   姓名	具有相同客户名称的客户。
   说明	检测在“客户名称”属性中具有相同值的客户记录。
   基本记录类型	科目
   匹配记录类型	科目
   客户名称（字段）	完全匹配
   公司（字段）	完全匹配
   关系类型（字段）	完全匹配
   当事方 ID（字段）	完全匹配
   选择（字段）	（空白）

   

10. 通过设置以下字段扩展联系人表的重复检测规则。

    字段	值
    姓名	具有相同名字和姓氏的联系人。
    说明	检测在“名字”和“姓氏”字段具有相同值的联系人记录。
    基本记录类型	联系人
    匹配记录类型	联系人
    名字（字段）	完全匹配
    姓氏（字段）	完全匹配
    公司（字段）	完全匹配
    当事方 ID（字段）	完全匹配
    选择（字段）	（空白）

    

11. 如果您是现有双重写入用户，请按照升级到当事方和全球通讯簿模型中的说明操作升级数据。 如果未完成此步骤，请勿继续执行步骤 12。 如果您是新的双重写入用户，请继续执行步骤 12。

12. 如果您是现有的双重写入用户，请完成步骤 11，然后可以按以下顺序运行地图。 如果您是新的双重写入客户，则可以直接继续。 如果收到错误消息，指示“项目验证失败。 缺少目标字段...”，请打开映射，选择刷新表，然后运行映射。

    财务和运营应用	Customer engagement 应用
    CDS 当事方	msdyn_parties
    CDS 邮政地址位置	msdyn_postaladdresscollections
    CDS 邮寄地址历史记录 V2	msdyn_postaladdresses
    CDS 当事方邮政地址位置	msdyn_partypostaladdresses
    当事方联系人 V3	msdyn_partyelectronicaddresses
    客户 V3	帐户
    客户 V3	联系人
    供应商 V2	msdyn_vendors
    联系人职务	msdyn_salescontactpersontitles
    结束语	msdyn_complimentaryclosings
    称呼	msdyn_salutations
    决策角色	msdyn_decisionmakingroles
    雇用工作职能	msdyn_employmentjobfunctions
    忠诚度级别	msdyn_loyaltylevels
    人员特点类型	msdyn_personalcharactertypes
    联系人 V2	msdyn_contactforparties
    CDS 销售报价标题	询价
    CDS 销售订单标题	salesorders
    销售账单抬头 V2	发票
    CDS 地址角色	msdyn_addressroles

注释

CDS Contacts V2 (contacts) 映射是您在步骤 1 中停止的映射。 当您尝试运行其他映射时，这 2 个映射可能会显示在依赖项列表中。 不要运行这些映射。

如果安装了当事方和全球通讯簿解决方案，则必须禁用名为 Microsoft.Dynamics.SCMExtended.Plugins.Plugins.LeadPrimaryContactPostCreate: QualifyLead of lead 的插件。 如果卸载当事方和全球通讯簿解决方案，则必须重新启用该插件。

客户、联系人和供应商表中包含的 msdyn_*partynumber 字段（单行文本字段）不应该继续使用。 为了清楚起见，标签名称带有 (Deprecated) 前缀。 而应改为使用 msdyn_partyid 字段。 此字段是对 msdyn_party 表的查找。

表名	旧字段	新字段
科目	msdyn_partynumber	msdyn_partyid
联系人	msdyn_partynumber	msdyn_partyid
msdyn_vendor	msdyn_vendorpartynumber	msdyn_partyid

模板

对于当事方和全球通讯簿交互，表映射集合协同工作，如下表中所示。

财务和运营应用	Customer engagement 应用	Description
联系人职务	msdyn_salescontactpersontitles
客户 V3	帐户
客户 V3	联系人
CDS 当事方	msdyn_parties
CDS 当事方邮政地址位置	msdyn_partypostaladdresses
CDS 邮寄地址历史记录 V2	msdyn_postaladdresses
CDS 邮政地址位置	msdyn_postaladdresscollections
CDS 销售报价标题	询价
CDS 销售订单标题	salesorders
结束语	msdyn_complimentaryclosings
联系人 V2	msdyn_contactforparties
决策角色	msdyn_decisionmakingroles
雇用工作职能	msdyn_employmentjobfunctions
忠诚度级别	msdyn_loyaltylevels
当事方联系人 V3	msdyn_partyelectronicaddresses
人员特点类型	msdyn_personalcharactertypes
销售账单抬头 V2	发票
称呼	msdyn_salutations
供应商 V2	msdyn_vendors
CDS 地址角色	msdyn_addressroles

有关更多信息，请参见双重写入映射参考。

作为多选下拉列表的地址角色

邮寄地址或电子地址可以用于多种用途。 例如，邮政地址既可以用作帐单邮寄地址，也可以用作送货地址。 在这些情况下，用户可以在下拉列表中同时选择发票和交货，如以下说明中所示。

已知问题和限制

• 在财务和运营应用中，当您创建客户以及地址并进行保存时，地址可能不会同步到地址表。 这是由于双重写入平台排序问题。 解决方法是，先创建客户并进行保存。 然后添加地址。

• 在财务和运营应用中，如果客户记录具有主要地址，当您为该客户创建新联系人时，联系人记录将从关联的客户记录继承主要地址。 供应商联系人也是如此。 Dataverse 目前不支持此行为。 如果启用了双重写入，从财务和运营应用通过主要地址继承的客户联系人将随其地址一起同步到 Dataverse。

• 在财务和运营应用中，您可以从添加联系人窗体创建联系人记录。 当您尝试从查看联系人窗体创建新联系人时，操作将失败。 这是一个已知问题。

  

• 初始同步不支持 ContactForParty 上的 Available From 和 Available To 时间字段，因为 DIXF 会将值转换为字符串而不是整数。 转换将触发错误 Cannot convert the literal '<say 08:00:00>' to the expected type edm.int32。

• 您不能使用具有双重写入功能的财务和运营应用输入将来的邮寄地址，因为 Dataverse 不支持日期有效期。 如果您使用财务和运营应用输入将来的邮寄地址，它将完全同步到 Dataverse，您会在用户界面立即看到该地址。 此记录的任何更新都将导致错误，因为它在财务和运营应用中是将来的日期，而不是当前日期。