Pasar parámetros a una dirección URL con la cinta de opciones

  • Artículo

Nota

Este tema trata sobre comandos clásicos.

Hay una nueva forma de definir comandos. Consulte Información general de los comandos modernos (versión preliminar)

Las acciones de la cinta de opciones se definen en el elemento de <Actions> de un elemento de <CommandDefinition> . Existen varias formas de pasar la información contextual de aplicaciones orientadas a modelos como parámetros de cadena de consulta a una dirección URL con la cinta de opciones.

  • Use un elemento <Url>. En el elemento Url , use el parámetro PassParams .

  • Use un elemento <Url>, así como un elemento <CrmParameter> . Cuando se usa desde un elemento Url , debe establecerse el valor del parámetro de nombre.

  • Use un elemento <JavaScriptFunction>, así como un elemento <CrmParameter> .

Use el parámetro PassParams para establecer valores dinámicos

El paso de parámetros a la dirección URL de destino mediante el parámetro 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 PassParams . En la tabla siguiente se muestran los parámetros admitidos.

Parámetro Nombre Descripción
typename Nombre de tabla Nombre de la tabla. Para las tablas personalizadas, se incluye el prefijo de personalización, por ejemplo, new_tablename.
type Código de tipo de entidad Entero que identifica de forma única la tabla de la organización actual. Nota: Los valores de Entity Type Code están determinados por el orden en que se crea una tabla en una organización. Entity Type Codes para tablas 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 el gráfico de identificadores de configuración regional (LCID).

Nota

Se recomienda usar el nombre de la entidad en lugar del código de tipo de tabla porque el código de tipo de entidad puede variar entre las instalaciones de aplicaciones basadas en modelo.

Ejemplo

El siguiente ejemplo muestra la dirección URL sin parámetros:

https://myserver/mypage.aspx

El siguiente ejemplo muestra los parámetros incluidos cuando se muestra el control de la cinta de opciones para la tabla 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:

https://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 de la dirección URL. Esto puede ser muy útil si desea abrir un determinado registro o verlo mediante Abrir formularios, vistas, cuadros de diálogo 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 y comercial en el valor 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 de 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 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 de página web mediante el parámetro de datos

Consultar también

Personalizar comandos y la cinta de opciones
Abrir formularios y vistas con una dirección URL
Definir las reglas de visualización de la pestaña de la cinta de opciones
Ejemplo: exportar definiciones de cinta

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).