Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

Define ribbon actions

Applies To: CRM 2015 on-prem, CRM Online

Define the actions to be performed by a command bar or ribbon control in a <CommandDefinition> (RibbonDiffXml) element together with rules that control whether the control is enabled or visible in the ribbon.

A Ribbon control can perform two types actions and may include multiple actions:

  • JavaScript Functions: A <JavaScriptFunction> (RibbonDiffXml) element references a function defined in a Script Web resource.

  • Open a URL: The ribbon opens a URL using the value from an Address attribute in the <Url> (RibbonDiffXml) element. Additional parameters can pass information about how what querystring parameters are passed and the mode in which the window opens.

    You have several options to pass parameters to a URL using the ribbon. More information: Pass parameters to a URL by using the ribbon

Use the following elements to define data to pass to your custom action:

<BoolParameter> (RibbonDiffXml)
Specifies a value with a Boolean data type that may be passed as a parameter.

<CrmParameter> (RibbonDiffXml)
Represents data retrieved from the Microsoft Dynamics CRM application that may be passed as a parameter. More information: Pass Microsoft Dynamics CRM data from a page as a parameter to Ribbon Actions

<DecimalParameter> (RibbonDiffXml)
Specifies a value with a decimal data type that may be passed as a parameter.

<IntParameter> (RibbonDiffXml)
Specifies a value with an integer data type that may be passed as a parameter.

<StringParameter> (RibbonDiffXml)
Specifies a value with a string data type that may be passed as a parameter.

When parameters are passed to a <Url> (RibbonDiffXml) element they are passed as a query string. Therefore, they must include a name value to represent the ”key” in the query string key/value pair.

Parameters passed to a <JavaScriptFunction> (RibbonDiffXml) do not require a name but they must be included in the order expected by the function and be of the correct data type.

See Also

Microsoft Dynamics CRM 2015 and Microsoft Dynamics CRM Online
Send comments about this topic to Microsoft.
© 2015 Microsoft. All rights reserved.
Show:
© 2015 Microsoft