Abrir aplicaciones, formularios, vistas, diálogos e informes con una dirección URL

Los elementos direccionables de dirección URL le permiten incluir vínculos a formularios, vistas, cuadro de diálogo e informes de aplicaciones en otras aplicaciones.

Nota

Las aplicaciones, los formularios, las vistas, los diálogos y los informes direccionables mediante dirección URL no pueden omitir la seguridad de . Solo los usuarios con licencia, en función de sus roles de seguridad, pueden acceder a los datos y los registros que ven.

Direcciones URL de la aplicación

Nota

No se admite la incorporación de una aplicación basada en modelos dentro de un IFrame en otra aplicación.

Puede abrir cualquier aplicación basada en modelos usando los valores AppModule.UniqueName o AppModule.AppModuleId.

Puede recuperar estos valores usando la API web con la siguiente consulta:

GET [Organization URI]/api/data/v9.1/appmodules?$select=appmoduleid,uniquename

Para obtener más información, consulte Consultar datos mediante la API web

Puede usar los parámetros de consulta appname o appid con los valores Nombre único o AppModuleId respectivamente, pero no puede usar ambos al mismo tiempo.

Usando un nombre único

Anexar el parámetro de consulta appname a la página main.aspx para abrir la aplicación usando el Nombre único.

https://myorg.crm.dynamics.com/main.aspx?appname={UniqueName}

Por ejemplo, si el Nombre único es msdyn_SolutionHealthHub, puede abrir esta aplicación usando esta URL:

https://myorg.crm.dynamics.com/main.aspx?appname=msdyn_SolutionHealthHub

Usando AppModuleId

Anexar el parámetro de consulta appid a la página main.aspx para abrir la aplicación usando el AppModuleId.

https://myorg.crm.dynamics.com/main.aspx?appid={AppModuleId}

Por ejemplo:

https://myorg.crm.dynamics.com/main.aspx?appid=12fd1cf3-e06e-e911-a95f-000d3a13c42a

Formularios y vistas direccionables mediante dirección URL

Todos los formularios y las vistas se muestran en la página main.aspx. Los parámetros de cadena de consulta pasados a esta página controlarán lo que se muestra. Por ejemplo:

Para abrir un formulario de registro de cuenta, donde el identificador es {91330924-802A-4B0D-A900-34FD9D790829}:

https://myorg.crm.dynamics.com/main.aspx?etn=account&pagetype=entityrecord&id=%7B91330924-802A-4B0D-A900-34FD9D790829%7D  

Para abrir la vista Oportunidades cerradas para:

https://myorg.crm.dynamics.com/main.aspx?etn=opportunity&pagetype=entitylist&viewid=%7b00000000-0000-0000-00AA-000010003006%7d&viewtype=1039  

Para abrir la vista Contactos activos sin la barra de navegación o la barra de comandos

https://myorg.crm.dynamics.com/main.aspx?etn=contact&pagetype=entitylist&viewid={00000000-0000-0000-00AA-000010001004}&viewtype=1039&navbar=off&cmdbar=false  

Nota

  • Use Xrm.Navigation.navigateTo o Xrm.Navigation.openForm cuando abra formularios mediante programación dentro de la aplicación mediante el uso de recursos web. No utilice window.open.
  • Fuera de la aplicación, donde las páginas no tienen acceso a la función Xrm.Navigation.openForm o Xrm.Navigation.navigateTo, use window.open o un enlace para abrir un registro específico o un formulario para un cuadro. Mostrar un formulario en un IFrame incrustado en otro formulario no se admite.

Normalmente usará el método getClientUrl para recuperar la dirección URL raíz de la organización para aplicaciones basadas en modelos.

Parámetros de cadena de consulta para la página Main.aspx

Sugerencia

Para obtener el valor del identificador de cualquier registro, use el botón Enviar un vínculo de la barra de comandos. A continuación tiene un ejemplo de lo que se abrirá en la aplicación de correo electrónico:

<https://mycrm/myOrg/main.aspx?etc=4&id=%7b899D4FCF-F4D3-E011-9D26-00155DBA3819%7d&pagetype=entityrecord>.

El parámetro de identificador pasado a la dirección URL es el valor de identificador codificado del registro. En este ejemplo, el valor de identificador es {899D4FCF-F4D3-E011-9D26-00155DBA3819}. La versión codificada del GUID sustituirá las llaves de apertura y cierre { y } con %7B y %7D, respectivamente,

A continuación se indican los parámetros de cadena de consulta que se usan con la página main.aspx para abrir formularios o vistas:

Parámetro Descripción
etn Nombre lógico de la tabla. Importante: no use el parámetro etc (código de tipo de tabla) que contiene un código entero para la tabla. El código entero varía para las tablas personalizadas de distintas organizaciones.
extraqs Opcional para formularios. Este parámetro contiene parámetros codificados en este parámetro.

Use este parámetro para transferir valores a un formulario. Para obtener más información, consulte Establecer los valores de columna mediante parámetros que se pasan a un formulario.

Cuando una tabla tiene más de un formulario definido, puede usar este parámetro para especificar qué formulario se debe abrir pasando el parámetro codificado formid con el valor igual al valor del identificador del formulario. Por ejemplo, para abrir un formulario con el identificado "6009c1fe-ae99-4a41-a59f-a6f1cf8b9daf", incluya este valor en el parámetro extraqs: formid%3D6009c1fe-ae99-4a41-a59f-a6f1cf8b9daf%0D%0A.
pagetype El tipo de página. Hay dos valores posibles:

- entityrecord
Muestra un formulario de registro.
- entitylist
Muestra una vista.
id Opcional para formularios. Utilícelo cuando abra un registro de tabla específico. Pase el identificador GUID codificado de la tabla. La versión codificada del GUID sustituirá las llaves de apertura y cierre “{“ y “}” por “%7B” y “%7D”, respectivamente, por ejemplo {91330924-802A-4B0D-A900-34FD9D790829} es %7B91330924-802A-4B0D-A900-34FD9D790829%7D.
viewid Necesario para vistas. Este es el identificador del registro de tabla savedquery o userquery que define la vista. La forma más fácil de obtener la dirección URL de una vista es copiarla. Para obtener más información, consulte Copiar la dirección URL de una vista.
viewtype Define el tipo de vista. Los valores posibles son los siguientes:

- 1039
Úselo para una vista de sistema. El parámetro viewid representa el identificador de un registro savedquery.
- 4230
Úselo para una vista personal. El parámetro viewid representa el identificador de un registro userquery.
navbar Controla si la barra de navegación se muestra y si la navegación por la aplicación está disponible mediante las áreas y subáreas definidas en el mapa del sitio.

- on
Se muestra la barra de navegación. Este es el comportamiento predeterminado si el parámetro navbar no se usa.
- off
No se muestra la barra de navegación. Los usuarios pueden navegar usando otros elementos de la interfaz de usuario o los botones adelante y atrás.
- entity
En un formulario de entidad, solo las opciones de navegación de tablas relacionadas están disponibles. Después de navegar a una tabla relacionada, se muestra un botón atrás en la barra de navegación para permitir volver al registro original.
cmdbar Controla si se muestra la barra de comandos. Nota: esta función admite los requisitos de la aplicación de Unified Service Desk. No se admite su uso para mostrar un formulario en un IFrame incrustado en otro formulario.

- true
Se muestra la barra de comandos. Esta es la configuración predeterminada.
- false
Se oculta la barra de comandos.

Copia de la dirección URL para una vista

Muchas vistas de aplicaciones basadas en modelos permiten a un usuario copiar la dirección URL de una vista determinada o enviar un correo electrónico con la dirección URL de una vista determinada incrustada en el mensaje. Esta característica facilita la comunicación entre usuarios, y expone una forma de obtener acceso a una dirección URL para una vista que los usuarios pueden incluir en otra aplicación, como un sitio de SharePoint.

Nota

No use esta dirección URL para incluir la vista en la navegación de la aplicación mediante el mapa del sitio. Para obtener más información, consulte Mostrar una vista en la navegación de la aplicación con el mapa del sitio.

La página mostrada por la dirección URL incluye la vista completa. Esto incluye la cinta de opciones, pero no la navegación de la aplicación.

Obtención de la dirección URL para una vista
  1. Abra la vista que desea usar.

  2. En la barra de comandos, haga clic en Acciones y, a continuación, haga clic en Envío de un vínculo por correo electrónico.

  3. Péguelo en el Bloc de notas y edítelo para extraer solo la parte de la dirección URL del texto que desee.

Nota

  • Las vistas que usan el contexto del usuario como un parámetro, como Mis cuentas, no se pueden copiar.
    • El GUID que representa vistas del sistema para las tablas del sistema será igual para todas las instalaciones. El GUID para las tablas y vistas personalizadas será único para cada instalación de aplicaciones.

Visualización de una vista en la navegación de la aplicación mediante el mapa del sitio

Al personalizar la navegación por la aplicación mediante el mapa del sitio, no use la dirección URL de la vista que copió de la aplicación con los pasos descritos en Copiar la dirección URL de una vista para establecerla como dirección URL. Esta dirección URL muestra una página que incluye la cinta de opciones y genera resultados indeseables si se usa en un parámetro de URL <SubArea>.

Para mostrar una lista de registros de tablas dentro de la aplicación para una subárea, establezca el valor de columna de tabla. Esto muestra la vista predeterminada para esa tabla y proporciona el título y el icono correctos.

Sin embargo, si desea tener un elemento SubArea que use una vista determinada predeterminada inicial específica, use el patrón de URL siguiente.

Url="/main.aspx?appid=e2bc1066-488f-eb11-b1ac-000d3a56ead9&pagetype=entitylist&etn=account&viewid=%7b<GUID value of view id>%7d"

Al usar esta dirección a URL, también debe especificar los valores adecuados para <Titles> y <Descriptions>, y especificar un icono para la tabla.

Nota

Si especifica la vista mediante la página /main.aspx, el selector de vista seguirá mostrándose. Si el usuario cambia la vista, la aplicación basada en modelos recuerda la selección más reciente y muestra la vista predeterminada inicial una vez que cierre y reinicie de nuevo el explorador.

Apertura de un proceso de diálogo mediante una dirección URL

Importante

Los diálogos han quedado obsoletos. Debe reemplazar los cuadros de diálogo con aplicaciones de lienzo o flujos de proceso de negocio. Más información: Sustituir diálogos por flujos de proceso de negocio o aplicaciones de lienzo

Una personalización común es permitir que un usuario abra un determinado proceso de diálogo en el contexto de un registro específico. Por ejemplo, es posible que desee agregar un botón personalizado a la cinta de opciones para una tabla específica usando el valor del identificador del registro actual como un parámetro de entrada del proceso de diálogo.

Para abrir un diálogo necesita lo siguiente:

  • El identificador único del diálogo.

  • El nombre lógico de la tabla para la que se crea el diálogo.

  • El identificador único del registro en el que desea que se ejecute el diálogo.

Sugerencia

Para obtener el identificador único del diálogo, vaya a Configuración, en la solución predeterminada seleccione Procesos. Seleccione un proceso y en las opciones Acciones de la barra de comandos, haga clic en Copiar un enlace. Esto copiará un vínculo para modificar el diálogo en el portapapeles, por ejemplo, [URL de la organización]/sfa/workflow/edit.aspx?id=%7b6A6E93C9-1FE6-4C07-91A9-E0E2A7C70976%7d.

El siguiente ejemplo muestra los parámetros de la dirección URL y la cadena de consulta para abrir un diálogo:

[organization url]/cs/dialog/rundialog.aspx?DialogId=[dialog unique identifier]&EntityName=[table logical name]&ObjectId=[unique identifier for the record]  

Por ejemplo, abra el diálogo con Id. ={6A6E93C9-1FE6-4C07-91A9-E0E2A7C70976} con el Id. de registro de cuenta = {40C9ADFD-90A8-DF11-840E-00155DBA380F}, use la dirección URL del siguiente ejemplo.

[organization url]/cs/dialog/rundialog.aspx?DialogId=%7b6A6E93C9-1FE6-4C07-91A9-E0E2A7C70976%7d&EntityName=account&ObjectId=%7b40C9ADFD-90A8-DF11-840E-00155DBA380F%7d  

Sugerencia

Si un proceso de diálogo se abre desde un vínculo, es posible que el botón Finalizar no funcione. Los datos se guardarán, pero el usuario deberá hacer clic en el botón Cerrar en la ventana para cerrarla. Esto se debe a que otros exploradores no proporcionan un método window.close si la ventana no se abre usando JavaScript desde otra ventana. Siempre que sea posible, use JavaScript y el método window.open para abrir procesos de diálogo en lugar de simplemente proporcionar vínculos.

Puede crear una función de JavaScript para abrir el diálogo como se muestra en el siguiente ejemplo:

function openDialogProcess(dialogId, entityName, objectId)  
{  
 var url = Xrm.Page.context.getClientUrl() +  
  "/cs/dialog/rundialog.aspx?DialogId=" +  
  dialogId + "&EntityName=" +  
  entityName + "&ObjectId=" +  
  objectId;  
 window.open(url);  
}  

Apertura de un informe mediante una dirección URL

Puede abrir un informe pasando valores de parámetros apropiados la siguiente dirección URL: [organization url]/crmreports/viewer/viewer.aspx.

Esta dirección URL acepta los siguientes parámetros:

acción
Dos valores posibles para este parámetro son run o filter. Si se utiliza run, el informe se mostrará usando los filtros predeterminados. Cuando se usa, filter el informe muestra un filtro que el usuario puede modificar antes de elegir el botón Ejecutar informe para ver el informe.

helpID
Este parámetro es opcional. Para los informes incluidos en las aplicaciones basadas en modelos el valor de este parámetro permite que el botón Ayuda muestre contenido apropiado sobre este informe cuando se selecciona Ayuda de esta página. El valor debe corresponder al valor FileName del informe.

id
Este parámetro es el valor ReportId del informe.

Los siguientes ejemplos muestran las direcciones URL que se pueden usar para abrir informes en aplicaciones basadas en modelos.

Abra el informe Casos sin atender mediante el filtro predeterminado:

[organization url]/crmreports/viewer/viewer.aspx?action=run&helpID=Neglected%20Cases.rdl&id=%7b8c9f3e6f-7839-e211-831e-00155db7d98f%7d  

Abra el informe Mejores artículos de Knowledge Base e indique al usuario que establezca valores de filtro:

[organization url]/crmreports/viewer/viewer.aspx?action=filter&helpID=Top%20Knowledge%20Base%20Articles.rdl&id=%7bd84ec390-7839-e211-831e-00155db7d98f%7d  

La función siguiente muestra cómo codificar valores correctamente en la dirección URL:

function getReportURL(action,fileName,id) {  
 var orgUrl = GetGlobalContext().getClientUrl();  
 var reportUrl = orgUrl +   
  "/crmreports/viewer/viewer.aspx?action=" +  
  encodeURIComponent(action) +  
  "&helpID=" +  
  encodeURIComponent(fileName) +  
  "&id=%7b" +  
  encodeURIComponent(id) +  
  "%7d";  
 return reportUrl;  
}  

Consultar también

Establecer valores de columna usando parámetros pasados a un formulario
Xrm.Navigation.openUrl
Configurar un formulario para aceptar parámetros querystring personalizados
Personalizar la cinta
Scripting del cliente con JavaScript
Recursos web
Cambiar navegación de la aplicación con el mapa del sitio

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