自訂實體表單
發行︰ 2017年1月
適用於： Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2016、Dynamics CRM Online
表單提供用來建立、檢視或編輯實體記錄的使用者介面 (UI)。 使用在自訂工具中的表單設計工具，可建立及編輯實體表單。其他資訊：TechNet：建立及設定表單，取得與使用應用程式表單相關的工作的資訊。
本主題將提供以程式設計方式建立或編輯表單的必要資訊。
本主題內容
存取表單定義
表單屬性
建立以及編輯表單
存取表單定義
實體表單，以及儀表板與視覺效果，在 SystemForm 實體中儲存。 有兩種方法可以檢查實體的表單定義：
將實體包含在未受管理的解決方案中和匯出解決方案。
查詢 SystemForm 實體
從已匯出的實體檢視 FormXML
只有已自訂系統實體表單的定義會包含在匯出的受管理解決方案中。 若要檢視系統實體表單的定義，必須以某些方式變更，或是透過以新名稱儲存現有的表單來建立新的表單。
在匯入解決方案之後，即可解壓縮內容，然後檢視 customizations.xml 檔案。 可在 ImportExportXml > Entities > Entity > FormXml 中找到表單的定義。 在 <FormXml> (FormXml) 節點，您將發現各類表單類型會群組在 <forms> (FormXml) 元素中，並以 type 屬性指定表單類型。
表單屬性
下表描述主要 SystemForm 實體屬性以及隨解決方案匯出的 XML 元素中包含的對應資料。
SystemForm 屬性 |
FormXML 元素 |
描述 |
|---|---|---|
AncestorFormId |
上層表單的唯一識別碼。 這是當您使用現有表單的 [另存新檔] 或利用 CopySystemFormRequest 建立新表單時設定的。 |
|
CanBeDeleted |
指定此元件是否可刪除的資訊。只在表單是透過匯入受管理的解決方案建立時，才適用此受管理屬性。 |
|
Description |
Description 是字串，並 <Descriptions> (FormXml) 包含表單描述的所有當地語系化標籤。 使用 RetrieveLocLabelsRequest，可取得當地語系化標籤。 |
|
FormActivationState |
指定表單的狀態。 只能停用的表單類型「主要」。 有效值：
|
|
FormId |
表單的唯一識別碼 |
|
FormPresentation |
指定這個表單是否位於 Microsoft Dynamics 365 (線上和內部部署) 中已更新的 UI 版面配置內。 |
|
FormXml |
表單配置的 XML 表示。 如需表單結構的詳細資訊，請參閱 <form> (FormXml)。 |
|
IntroducedVersion |
新增表單的解決方案版本。 |
|
IsAIRMerged |
N/A |
指定這個表單是否與 Microsoft Dynamics 365 (線上和內部部署) 中已更新的 UI 版面配置合併。 |
IsCustomizable |
指定是否可自訂此元件的資訊。 只在表單是透過匯入受管理的解決方案建立時，才適用此受管理屬性。 |
|
IsDefault |
N/A |
指示表單或儀表板是否為系統預設值的資訊。 |
Name |
Name 是字串，並 <Descriptions> (FormXml) 包含表單名稱的所有當地語系化標籤。 使用 RetrieveLocLabelsRequest，可取得當地語系化標籤。 |
|
ObjectTypeCode |
表單是 Entity 元素的子系元素。 |
ObjectTypeCode 值是實體邏輯名稱。 |
Type |
<forms> (FormXml) 元素 type 屬性 |
表單的有效值是：
|
建立以及編輯表單
您只能為 EntityMetadata.CanCreateForms 允許的實體建立新表單。
使用 CreateRequest 或 CopySystemFormRequest，您可以建立新的表單。 使用 CopySystemFormRequest 或在表單編輯器上使用 [另存新檔] 時，請注意未在表單之間繼承。 因此，基準表單的變更並不會自動套用至從它建立的表單。
編輯已匯出的受管理解決方案的表單定義，然後重新匯入解決方案是編輯實體表單的支援方法。 當手動編輯表單時強烈建議您使用允結構描述驗證的 XML 編輯器。其他資訊：使用結構描述驗證編輯自訂 XML 檔案
另請參閱
自訂 Microsoft Dynamics 365 應用程式
TechNet：建立以及編輯表單
SystemForm (系統儀表板) 實體訊息和方法
建立或編輯商務規則啟始的方式
Form XML reference
Form XML schema
Microsoft Dynamics 365
© 2017 Microsoft. 著作權所有，並保留一切權利。 著作權