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:

• <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 365 application that may be passed as a parameter.More information: Pass Microsoft Dynamics 365 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

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