為複合屬性撰寫指令碼

 

發行︰ 2016年11月

適用於： Dynamics CRM 2015

某些新增至表單的欄位可能代表多個資料項目。 這些「複合屬性」(Composite Attribute) 在 Web 應用程式中顯示時，其行為與其他屬性不同，而且您必須撰寫不同的指令碼才能正確使用這些屬性。

本主題內容

複合屬性

Web 應用程式中的複合屬性

平板電腦用 CRM 中的複合屬性

消除差異

複合屬性

下表列出複合屬性：

實體	顯示名稱	邏輯名稱
Contact	完整名稱	fullname
	地址 1	address1_composite
	地址 2	address2_composite
Lead	完整名稱	fullname
	地址 1	address1_composite
	地址 2	address2_composite
User	完整名稱	fullname
	地址	address1_composite
	其他地址	address2_composite
Account	地址 1	address1_composite
	地址 2	address2_composite
Quote	帳單地址	billto_composite
	寄送地址	shipto_composite
Order	帳單地址	billto_composite
	寄送地址	shipto_composite
Invoice	帳單地址	billto_composite
	寄送地址	shipto_composite

Web 應用程式中的複合屬性

在主要表單中新增做為複合屬性的欄位時，Web 應用程式只會顯示複合屬性。 當某人編輯欄位時會出現彈出式視窗，其中會顯示組成複合屬性的個別屬性。 雖然在表單編輯器中不是以明確方式新增至表單，但是屬於該屬性的每個屬性都可供表單使用。 雖然您可以使用 getValue 讀取複合值的值，但是無法使用 setValue 直接變更複合屬性的值，您必須設定複合屬性參考的一個或多個屬性。

您可以存取彈出式視窗中依名稱顯示的個別構成控制項。 這些控制項會使用下列命名慣例：<composite control name>_compositionLinkControl_<constituent attribute name>。 若只要存取 address1_composite 控制項中的 address_line1 控制項，可使用：Xrm.Page.getControl("address1_composite_compositionLinkControl_address1_line1")。

平板電腦用 CRM 中的複合屬性

平板電腦專用 Microsoft Dynamics CRM 會使用與擁有複合屬性的實體相同的表單定義，但會以不同的方式解譯這些定義。 如果在表單定義中找到複合屬性，它會在表單的該區段中顯示屬於複合屬性的所有屬性。 此時不需要彈出式視窗，因為所有欄位都會顯示。 您可以撰寫指令碼讓表單存取每個屬性，就像屬性分別新增至表單中一樣。

不過，實際的複合控制項不會出現在 平板電腦適用的 CRM 頁面中。

消除差異

如果您想要存取 Contact、Lead 或 User 實體的 fullname 欄位，較簡單的方式是使用 Xrm.Page.data.entity.getPrimaryAttributeValue 方法直接取得此屬性的值，而不需參考該屬性。 此方法同時適用於 Web 應用程式和 平板電腦適用的 CRM。

如果您的程式碼需要讀取其中一個地址複合屬性的值，為了能在這兩種用戶端上運作，您需要使用 Xrm.Page.context.client.getClient 將程式碼分開，如下面的函數所示，在主 Web 應用程式或相同表單的 平板電腦適用的 CRM 版本中使用 Xrm.Utility.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 CRM 2015 表單的程式碼
使用表單和欄位事件
使用 Xrm.Page 物件模型
為平板電腦版本的 CRM 撰寫指令碼並偵錯
使用執行內容和表單事件準銷售案源
在表單使用 IFRAME 和 Web 資源控制
表單指令碼快速參考
用戶端程式設計參考
Xrm.Page.data.entity 屬性 (用戶端參考)

© 2017 Microsoft. 著作權所有，並保留一切權利。 著作權