定義自訂動作來修改功能區
發佈日期: 2016年11月
適用對象: Dynamics CRM 2015
預設的應用程式命令列或功能區是由 Microsoft Dynamics 365 中繼資料定義。 無法變更此預設資料,但是可以包括特定動作的定義,覆寫預設的功能區。
自訂動作類型
功能區的自訂動作有兩種類型:
<CustomAction> (RibbonDiffXml):定義要在功能區中新增或取代項目的動作。
<HideCustomAction> (RibbonDiffXml):從功能區處理中移除現有的功能區元素。
自訂動作
自訂動作是如何變更預設功能區定義的陳述式。 在執行階段會評估它和套用至功能區。 若要設定自訂動作的內容,必須包含要變更項目的位置資訊。 使用 Location 屬性指定何處套用變更。
當您新增功能區元素時,您參照包含元素,例如,現有的標籤或群組。 您接著包括尾碼 ._children,表示此自訂動作將新增項目至現有的項目。
如果變更現有的項目定義,Location 值將符合該項目識別碼。
您也必須指定自訂動作的唯一識別碼。 使用 Id 屬性設定此值。 強烈建議您使用將確保唯一值的命名慣例。 為了一致性和可讀性,建議您使用句點分隔一致的元件。 命名慣例的第一個項目應該是與您的解決方案發行者或解決方案相關的項目,例如,Contoso.contact.form.CustomButton.CustomAction。
提示
一致套用 Id 屬性命名慣例,將會在編輯 RibbonDiffXml 時提升生產力。
根據提供的位置資訊,Sequence 屬性值決定呈現項目的順序。 如果您要自訂控制顯示在兩個現有控制項之間,必須選擇介於現有項目順序值之間的順序值。
隱藏自訂動作
<HideCustomAction> (RibbonDiffXml) 這個陳述式是當您想移除現有的功能區元素,使其未呈現時使用。 這不隱藏功能區元素,實際上在執行階段移除功能區元素,使其不存在於功能區。
備註
因為 HideCustomAction 元素從功能區移除指定的節點,以這種方式移除功能區元素不是每種狀況的最佳選項。
-
若要移除與特定權限相關的按鈕,您應該調整實作中資訊安全角色的實體權限。 這允許預設的功能區顯示,並啟用規則,對沒有適當權限執行這些動作的使用者隱藏或停用功能區元素。
-
如果您要用自訂功能區元素取代現有的功能區元素,您可以指定與現有元素相同的 CustomAction.Location 值,覆寫該元素。
HideActionId 元素提供動作的唯一識別碼。 為了一致性和可讀性,應遵循 <CustomAction> 元素描述相同的命名慣例。Location 屬性必須符合要移除的功能區元素 Id。
另請參閱
自訂命令和功能區
將 Microsoft Dynamics CRM 資料以參數形式傳遞至功能區動作
定義功能區元素的縮放
© 2017 Microsoft. 著作權所有,並保留一切權利。 著作權