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

Los elementos direccionables de dirección URL permiten incluir vínculos a aplicaciones, formularios, vistas e informes controlados por modelos en otras aplicaciones.

Direcciones URL de la aplicación

Puede abrir cualquier aplicación controlada por modelos mediante 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.

Usar nombre único

Para abrir la aplicación mediante el nombre único, añada el parámetro de consulta appname a la página main.aspx.

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

Por ejemplo, si el nombre único es msdyn_SolutionHealthHub, puede abrir esta aplicación mediante esta dirección URL:

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

Usando AppModuleId

Para abrir la aplicación mediante AppModuleId, agregue el appid parámetro de consulta a la main.aspx página.

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

Por ejemplo:

https://myorg.crm.dynamics.com/main.aspx?appid=00001111-aaaa-2222-bbbb-3333cccc4444

Formularios y vistas direccionables mediante dirección URL

La main.aspx página muestra todos los formularios y vistas. Los parámetros de cadena de consulta que pasas a esta página controlan 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:

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  

Normalmente, se usa el método getClientUrl para recuperar la dirección URL raíz de la organización para las aplicaciones controladas por modelos.

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

En la tabla siguiente se enumeran los parámetros de cadena de consulta usados con la página main.aspx para abrir formularios o vistas:

Copia la dirección URL de una vista

Muchas vistas de aplicaciones controladas por modelos le permiten copiar la dirección URL de una vista determinada o enviar un correo electrónico con la dirección URL de una vista determinada insertada 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.

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

Obtener la dirección URL de una vista

1. Abra la vista que quiere utilizar.
2. En la barra de comandos, seleccione Acciones y, a continuación, seleccione Enviar 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.

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

Al personalizar la navegación de la aplicación mediante el mapa del sitio, no use la dirección URL de vista que copió de la aplicación mediante 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 tabla dentro de la aplicación para una subárea, establezca el valor de la columna. Este valor muestra la vista predeterminada de esa tabla y proporciona el título y el icono correctos.

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

Url="/main.aspx?appid=11112222-bbbb-3333-cccc-4444dddd5555&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.

Apertura de un informe mediante una dirección URL

Puede abrir un informe pasando valores de parámetros apropiados a 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. Cuando se usa run, el informe se muestra mediante los filtros predeterminados. Cuando se usa filter, el informe muestra un filtro que el usuario puede editar antes de elegir el botón Ejecutar informe para ver el informe.

helpID
Este parámetro es opcional. Para los informes que se incluyen con aplicaciones controladas por modelos, el valor de este parámetro permite que el botón Ayuda muestre el contenido adecuado sobre este informe cuando se elige Ayuda en esta página . El valor debe corresponder al valor FileName del informe.

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

En los ejemplos siguientes se muestran direcciones URL que puede usar para abrir informes en aplicaciones controladas por modelos.

Abra el informe Casos descuidados 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