共用方式為


為複合屬性撰寫指令碼

 

發行︰ 2017年1月

適用於: Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2016、Dynamics CRM Online

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

本主題內容

複合屬性

Web 應用程式中的複合屬性

平板電腦用 Dynamics 365 中的複合屬性

消除差異

複合屬性

下表列出複合屬性:

實體

顯示名稱

邏輯名稱

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")。

平板電腦用 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.entity 屬性 (用戶端參考)

Microsoft Dynamics 365

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