通过

定义自定义操作以修改功能区

  • 项目

 

发布日期： 2017年1月

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

默认情况下，应用程序命令栏或功能区由 Microsoft Dynamics 365 元数据定义。 此默认数据无法更改，但是您可以包括将会替代默认功能区的特定操作的定义。

自定义操作的类型

针对功能区有两种类型的自定义操作：

自定义操作

自定义操作是对您想要如何更改默认功能区定义的一种陈述。 会在运行时对此类操作进行评估并将其应用到功能区。 若要设置自定义操作的上下文，您必须包括有关所要更改项的位置的信息。 使用 Location 属性指定您的更改应用的位置。

当添加新的功能区元素时，需要引用包含元素，例如现有的选项卡或组。 然后，包括后缀 ._children 以指示此自定义操作将向现有的项中添加内容。

当您更改现有项的定义时，Location 值将与该项的 ID 相符。

您还必须指定自定义操作的唯一标识符。 使用 Id 属性设置此值。 强烈建议您使用将保证唯一值的命名约定。 为保持一致性和可读性，建议您使用句号分隔一致的组件。 命名约定中的第一项应是与您的解决方案发布商或解决方案相关的内容，例如 Contoso.contact.form.CustomButton.CustomAction。

提示

以一致的方式应用您的 Id 属性命名命名约定，将大大提高您在编辑 RibbonDiffXml 时的工作效率。

根据您所提供的位置信息，Sequence 属性值会确定各项的呈现顺序。 如果想要自定义控件出现在两个现有的控件之间，则选择的顺序值必须位于这些现有项的顺序值之间。

隐藏自定义操作

<HideCustomAction> (RibbonDiffXml) 是在要删除现有的功能区元素以便其不会呈现时使用的语句。 这不会隐藏功能区元素，实际上是在运行时删除功能区元素，以便该元素不存在于功能区中。

备注

由于 HideCustomAction 元素会从功能区中删除指定的节点，因此以这种方式删除功能区元素可能并非在任何情况下都是最佳选项。

  • 如果要移除与特定权限关联的按钮，则应该调整实现中安全角色实体的权限。 这样将允许使用默认的功能区显示和启用规则，以便对没有执行这些操作必要权限的用户隐藏或禁用功能区元素。

  • 如果您要将现有的功能区元素替换为自定义功能区元素，则可以指定一个与现有元素完全相同的 CustomAction.Location 值，以覆盖该元素。

HideActionId 元素提供操作的唯一 ID。 为保持一致性和可读性，您应遵循针对 <CustomAction> 元素规定的相同命名约定。Location 属性必须与要删除的功能区元素的 ID 相符。

另请参阅

自定义命令和功能区
将 Microsoft Dynamics 365 数据作为参数从页面传递到功能区操作
定义功能区元素的缩放

Microsoft Dynamics 365

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