Export (0) Print
Expand All

Passing Parameters to a URL using ISV.Config

banner art

[Applies to: Microsoft Dynamics CRM 4.0]

There are two ways to pass parameters to a URL using ISV.Config.

  • Use the PassParams attribute to set dynamic values.
  • Use a querystring parameter within the URL.

Use the PassParams attribute to set dynamic values

Passing parameters to the target URL using the PassParams attribute provides information to the target application about the context of the record or the user. All the parameters are passed if the Button element, the MenuItem element, or the NavBarItem element is configured by using the PassParams attribute.

You can indicate whether a Button, MenuItem, or NavBarItem passes the parameters listed in the following table.

ParameterNameDescription
typenameEntity NameThe name of the entity. For custom entities this includes the customization prefix, for example, new_entityname.
typeEntity Type CodeAn integer that uniquely identifies the entity.
idObject GUIDThe GUID that represents a record.
orgnameOrganization NameThe unique name of the organization.
userlcidUser Language CodeThe language code identifier that is used by the current user.
orglcidOrganization Language CodeThe language code identifier that represents the base language for the organization.

Language codes are four- or five-digit Locale IDs. Valid Locale ID values can be found at Locale ID (LCID) Chart.

Note    It is best to use the entity name instead of the entity type code because the entity type code may be different between Microsoft Dynamics CRM installations.

Example

Without parameters:

http://myserver/mypage.aspx

With parameters:

http://myserver/mypage.aspx?orgname=AdventureWorksCycle&userlcid=1033&orglcid=1033&type=1&typename=account&id=%7BDBD5DBFB-0666-DC11-A5D9-0003FF9CE217%7D

Use a querystring parameter within the URL

You can include a querystring parameter within the URL attribute. This can be particularly useful if you want the Button, MenuItem, or NavBarItem to open a specific Microsoft Dynamics CRM record or view using URL Addressable Forms and Views.

Note   You will not be able to import the ISV.Config if the URL includes the ampersand (&) character used to separate multiple querystring parameters in the URL. This character makes the XML invalid. You must escape the ampersand character in the URL attribute value with "&".

Reading Passed Parameters

Passed parameters are usually read in the target .aspx page by using the HttpRequest.QueryString property. For more information, see: msdn2.microsoft.com/en-us/library/system.web.httprequest.querystring.aspx.

See Also

Concepts


© 2010 Microsoft Corporation. All rights reserved.


Show:
© 2014 Microsoft