Pasar parámetros a una dirección URL con la cinta de opciones
Publicado: enero de 2017
Se aplica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Las acciones de la cinta de opciones se definen en el elemento de <Actions> (RibbonDiffXml) de un elemento de <CommandDefinition> (RibbonDiffXml) . Existen varias formas de pasar la información contextual de Microsoft Dynamics 365 como parámetros de cadena de consulta a una dirección URL con la cinta de opciones.
Use un elemento <Url> (RibbonDiffXml). En el elemento Url , use el atributo PassParams .
Use un elemento <Url> (RibbonDiffXml), así como un elemento <CrmParameter> (RibbonDiffXml) . Cuando se usa desde un elemento Url , debe establecerse el valor del atributo de nombre.
Use un elemento <JavaScriptFunction> (RibbonDiffXml), así como un elemento <CrmParameter> (RibbonDiffXml) .
Use el atributo PassParams para establecer valores dinámicos
El paso de parámetros a la dirección URL de destino mediante el atributo PassParams ofrece información a la aplicación de destino acerca del contexto del registro o el usuario. Todos los parámetros se pasan si el control de la cinta de opciones se configura mediante el atributo PassParams . En la tabla siguiente se muestran los parámetros admitidos.
Parámetro |
Nombre |
Descripción |
|---|---|---|
typename |
Nombre de entidad |
Nombre de la entidad. Para las entidades personalizadas, se incluye el prefijo de personalización, por ejemplo, new_entityname. |
type |
Código de tipo de entidad |
Entero que identifica de forma única la entidad de la organización actual. Nota Los valoresEntity Type Code están determinados por el orden en que se crea una entidad en una organización.Entity Type Codes para entidades personalizadas suelen ser distintas en distintas organizaciones. |
id |
GUID de objeto |
Identificador único global (GUID) que representa un registro. |
orgname |
Nombre de la organización |
Nombre único de la organización. |
userlcid |
Código de idioma de usuario |
Identificador del código de idioma que usa el usuario actual. |
orglcid |
Código de idioma de la organización |
Identificador de código de idioma que representa el idioma base de la organización. |
Los códigos de idioma son identificadores de configuración regional de cuatro o cinco dígitos. Los valores de identificadores de configuración regional válidos pueden encontrarse en la tabla de identificadores de configuración regional (LCID).
Nota
Se recomienda usar el nombre de la entidad en lugar del código de tipo de entidad porque el código de tipo de entidad puede variar entre las instalaciones de Microsoft Dynamics 365 .
Ejemplo
El siguiente ejemplo muestra la dirección URL sin parámetros:
http://myserver/mypage.aspx
El siguiente ejemplo muestra los parámetros incluidos cuando se muestra el control de la cinta de opciones para la entidad de cuenta, para una organización denominada "AdventureWorksCycle", cuando el idioma del usuario y el idioma base de la organización es el inglés, y el GUID para el registro de cuenta es DBD5DBFB-0666-DC11-A5D9-0003FF9CE217:
http://myserver/mypage.aspx?orgname=AdventureWorksCycle&userlcid=1033&orglcid=1033&type=1&typename=account&id=%7BDBD5DBFB-0666-DC11-A5D9-0003FF9CE217%7D
Use un parámetro Querystring en la dirección URL
Puede incluir un parámetro querystring en el atributo de la dirección URL. Puede ser muy útil si desea abrir un registro o una vista específicos de Microsoft Dynamics 365 mediante Abrir formularios, vistas, diálogos e informes con una dirección URL.
Nota
No se podrá importar la cinta de opciones si la dirección URL incluye el carácter de la y comercial (&) que se usa para separar los parámetros múltiples de querystring en la dirección URL. Este carácter hacer que el XML no sea válido. Debe escapar el carácter de la y comercial en el valor de atributo de la dirección URL con "&".
Leyendo parámetros pasados
Los parámetros pasados se leen normalmente en la página .aspx de destino mediante la propiedad HttpRequest.QueryString.Más información:Propiedad HttpRequest.QueryString
Nota
Si el destino de la dirección URL es un recurso web, puede aceptar solo los parámetros identificados en el tema Pasar los parámetros a recursos web HTML. La única oportunidad para pasar valores personalizados es incluyéndolos en el parámetro data . Se necesita un determinado control especial para incluir varios valores en un único parámetro.Más información:Ejemplo: pasar varios valores a un recurso web mediante el parámetro de datos
Ver también
Personalizar los comandos y la cinta de opciones
Abrir formularios, vistas, diálogos e informes con una dirección URL
<Url> (RibbonDiffXml)
Definir las reglas de visualización de la pestaña de la cinta de opciones
Ejemplo: exportar definiciones de cinta
Microsoft Dynamics 365
© 2017 Microsoft. Todos los derechos reservados. Copyright