Define ribbon actions


Applies To: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics 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

Passing parameters to ribbon actions

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

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

Customize commands and the ribbon
Define ribbon display rules
Pass Microsoft Dynamics 365 data from a page as a parameter to Ribbon Actions

Microsoft Dynamics 365

© 2016 Microsoft. All rights reserved. Copyright