为复合属性编写脚本

发布日期： 2017年1月

适用于： Dynamics 365 (online),Dynamics 365 (on-premises),Dynamics CRM 2016,Dynamics CRM Online

添加到窗体的某些字段可以表示多个数据项。 这些复合属性在 Web 应用程序中显示时的行为与其他属性不同，您必须分别编写脚本才能正确使用它们。

本主题内容

复合属性

Web 应用程序中的复合属性

适用于平板电脑的 Dynamics 365 中的复合属性

减少区别

复合属性

下表列出复合属性：

Web 应用程序中的复合属性

当复合属性的字段添加到主窗体时，Web 应用程序将仅显示复合属性。 当某人编辑字段时，弹出项目会显示包含复合属性的个别属性。 尽管未显式添加到窗体编辑器中的窗体，但作为属性一部分的每个属性都可用于窗体。 虽然可以使用 getValue 读取复合值的值，但是不能使用 setValue 直接更改复合属性的值；必须设置复合属性引用的一个或多个属性。

可以访问浮出控件中显示名称的单个关系人控件。 这些控件使用下列命名约定：<composite control name>_compositionLinkControl_<constituent attribute name>。 要访问 address1_composite 控件中的 address_line1 控件，您可以使用：Xrm.Page.getControl("address1_composite_compositionLinkControl_address1_line1")。

适用于平板电脑的 Dynamics 365 中的复合属性

适用于平板电脑的 Microsoft Dynamics 365 使用用于具有复合属性的实体的相同窗体定义，但它分别解释它们。 如果在窗体定义中找到复合属性，它将在窗体的该部分中显示作为复合属性一部分的所有属性。 由于所有字段都可见，因此不需要弹出项目。 您可以编写访问每个单个属性的窗体的脚本，就像它们已分别添加到窗体一样。

但是，适用于平板电脑的 Dynamics 365 页中将不会提供实际复合控件。

减少区别

如果您要访问 Contact、Lead 或 User 实体的 fullname 字段，可以使用 **Xrm.Page.data.entity.**fbaf2e7a-db2f-448f-bd24-6b3ca1ccb28e#BKMK_getPrimaryAttributeValue 方法轻松获取此属性的值，而无需直接引用它。 此方法适用于 Web 应用程序和 适用于平板电脑的 Dynamics 365。

如果您的代码需要读取某个地址复合属性的值，为了同时用于两个客户端，您需要使用 Xrm.Page.context.client.getClient 分隔代码，如下面的函数所示，该函数在主 Web 应用程序中或相同窗体的 适用于平板电脑的 Dynamics 365 版本中使用 **Xrm.Utility.**72a66f93-92df-42b9-a8fd-b6125c7fe83b#BKMK_alertDialog 显示格式化的地址。

function showAddressDialog() {
 var address1_compositeValue;
 if (Xrm.Page.context.client.getClient() != "Mobile") {
  address1_compositeValue = Xrm.Page.getAttribute("address1_composite").getValue();
 }
 else {
  var address1_line1 = Xrm.Page.getAttribute("address1_line1").getValue();
  var address1_line2 = Xrm.Page.getAttribute("address1_line2").getValue();
  var address1_line3 = Xrm.Page.getAttribute("address1_line3").getValue();
  var address1_city = Xrm.Page.getAttribute("address1_city").getValue();
  var address1_stateorprovince = Xrm.Page.getAttribute("address1_stateorprovince").getValue();
  var address1_postalcode = Xrm.Page.getAttribute("address1_postalcode").getValue();
  var address1_country = Xrm.Page.getAttribute("address1_country").getValue();

  // Achieve equivalent formatting
  //address1_line1
  //address1_line2
  //address1_line3
  //address1_city, address1_stateorprovince address1_postalcode
  //address1_country

  var addressText = "";
  if (address1_line1 != null) {
   addressText += address1_line1 + "\n";
  }
  if (address1_line2 != null) {
   addressText += address1_line2 + "\n";
  }
  if (address1_line3 != null) {
   addressText += address1_line3 + "\n";
  }
  if (address1_city != null) {
   addressText += address1_city + ", ";
  }
  if (address1_stateorprovince != null) {
   addressText += address1_stateorprovince + " ";
  }
  if (address1_postalcode != null) {
   addressText += address1_postalcode + "\n";
  }
  addressText += address1_country;

  address1_compositeValue = addressText;
 }
 Xrm.Utility.alertDialog(address1_compositeValue);
}

另请参阅

为 Microsoft Dynamics 365 窗体编写代码
使用窗体和字段事件
使用 Xrm.Page 对象模型
编写和调试适用于手机和平板电脑的 Dynamics 365 的脚本
使用执行上下文和窗体事件管道
在窗体上使用 IFRAME 和 Web 资源控件
脚本即时引用的表单
客户端编程引用
Xrm.Page.data. 实体属性（客户端引用）

Microsoft Dynamics 365

© 2017 Microsoft。 保留所有权利。 版权