Export (0) Print
Expand All
Expand Minimize

<Url> (RibbonDiffXml)

Applies To: Microsoft Dynamics CRM 2013, Microsoft Dynamics CRM Online

An action that opens a web page at a specified address.

<Url 
 Address="String"
 PassParams=["0" | "1" | "true" | "false"]
 WinMode="Integer"
 WinParams="String" 
>
 <BoolParameter/>
 <CrmParameter/>
 <DecimalParameter/>
 <IntParameter/>
 <StringParameter/>
</Url>

The following table lists the attributes, child elements, and parent elements.

Attributes

 

Attribute Description Type Usage

Address

The address of the page to open. This value must represent a Uniform Resource Identifier (URI). It can be an absolute or relative path to the page.

String

Required

PassParams

Specifies whether information about the record and language context are passed to the URL.

Boolean

Optional

WinMode

Specifies the window mode. See Remarks.

Valid values:

 

Value Description

0

Window [Default]

1

Modal Dialog

2

Modeless Dialog

Enumeration

Optional

WinParams

Specifies the parameters to be passed to the window. The format of this parameter is different depending on the value of the WinMode parameter.

String

Optional

Child Elements

 

Element Description

<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.

<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.

Parent Elements

 

Element Description

<Actions> (RibbonDiffXml)

Specifies the actions that a command will perform.

For WinMode = 0, the window.open method is used. For more information, see the open Method topic in the MSDN Library.

For WinMode = 1 (modal dialog), window.showModalDialog method is used. For more information, see the showModalDialog Method topic in the MSDN Library.

For WinMode = 2 (modeless dialog), the window.showModelessDialog method is used. For more information, see the showModelessDialog Method topic in the MSDN Library.

noteNote
Do not use this action to open entity forms. Use the <JavaScriptFunction> (RibbonDiffXml) with a function that uses Xrm.Utility.openEntityForm instead.

 

XPath

//RibbonDiffXml/CommandDefinitions/CommandDefinition/Actions/Url

Schema Name

UrlType

Validation File

RibbonTypes.xsd

Can be Empty

Yes

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