定义功能区操作

发布日期： 2016年11月

适用于： Dynamics CRM 2015

定义 <CommandDefinition> (RibbonDiffXml) 元素中的命令栏或功能区控件要执行的操作以及控制该控件是否在功能区中启用或可见的规则。

功能区控件可以执行两种类型的操作并可以包括多个操作：

JavaScript 函数：<JavaScriptFunction> (RibbonDiffXml) 元素引用脚本 Web 资源中定义的函数。
打开 URL：功能区使用 <Url> (RibbonDiffXml) 元素中的 Address 属性值打开 URL。其他参数可以传递有关传递哪些查询字符串参数和传递方式以及窗口打开模式的信息。

有多个选项可用于使用功能区向 URL 传递参数。详细信息：使用功能区将参数传递给 URL

向功能区操作传递参数

使用以下元素定义要传递给自定义操作的数据：

<BoolParameter> (RibbonDiffXml)
指定 Boolean 数据类型的值，该值可作为参数传递。
<CrmParameter> (RibbonDiffXml)
表示是从 Microsoft Dynamics CRM 应用程序中检索的数据，该数据可作为参数传递。详细信息：将 Microsoft Dynamics CRM 数据作为参数从页面传递到功能区操作
<DecimalParameter> (RibbonDiffXml)
指定 Decimal 数据类型的值，该值可作为参数传递。
<IntParameter> (RibbonDiffXml)
指定 Integer 数据类型的值，该值可作为参数传递。
<StringParameter> (RibbonDiffXml)
指定 String 数据类型的值，该值可作为参数传递。

在将参数传递给 <Url> (RibbonDiffXml) 元素时，将它们作为查询字符串传递。因此，它们必须包括名称值来表示查询字符串键/值对中的“键”。

传递给 <JavaScriptFunction> (RibbonDiffXml) 的参数不需要名称，但必须按函数期望的顺序包括它们并且它们具有正确的数据类型。