Recursos web para Microsoft Dynamics 365

 

Publicado: enero de 2017

Se aplica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Los recursos web son archivos virtuales que se almacenan en la base de datos de Microsoft Dynamics 365 y que se pueden recuperar mediante una dirección URL única.

En este tema

Capacidades de los recursos web

Tipos de recursos web

Recursos web para referencias

Capacidades de los recursos web

Los recursos web representan los archivos que se pueden usar para ampliar la aplicación web de Microsoft Dynamics 365, como los archivos html, JavaScript y las aplicaciones de Silverlight. Puede usar recursos web en personalizaciones de formularios, SiteMap o la aplicación de cinta de opciones porque se les puede hacer referencia mediante sintaxis URL.

La sintaxis URL para los recursos web permite referencias de la ruta de acceso relativa. Con las herramientas de desarrollo, se puede crear un grupo de archivos interdependientes en un servidor de desarrollo mediante tipos de archivos compatibles con los recursos web. A continuación, si se usa la convención de nomenclatura coherente y referencias de la ruta de acceso relativa, el sitio web funcionará después de cargar todos los archivos en Microsoft Dynamics 365.

Puesto que los recursos web se almacenan en Microsoft Dynamics 365 y son componentes de la solución, se pueden exportar e instalar fácilmente en implementaciones locales de Microsoft Dynamics 365 o en Microsoft Dynamics 365 (online). Los recursos web están también disponibles para los usuarios de Microsoft Dynamics 365 para Microsoft Office Outlook con acceso sin conexión sin conexión porque se sincronizan con los datos de usuario.

Puede usar el editor de formularios para agregar y configurar recursos web habilitados por formulario en los formularios de entidad.

Puesto que los recursos web se almacenan como registros en la base de datos, se pueden administrar mediante programación usando técnicas estándar para crear, recuperar y actualizar registros. Los recursos web basados en texto (JScript, CSS, XML, XSL, and HTML) se pueden editar y guardar en la aplicación.

Limitaciones de los recursos web

No hay ningún tipo de recurso web que admita las capacidades de una página ASP.NET(.aspx) para ejecutar código en el servidor. Los recursos web se limitan a archivos estáticos o a archivos que se procesan en el explorador. Un recurso web puede contener un código que se procesa en el explorador para ejecutar las llamadas al servicio web para interactuar con los datos de Microsoft Dynamics 365. Para obtener más información, vea Trabajar con datos de Dynamics 365 utilizando recursos web.

Los recursos web solo están disponibles mediante el contexto de seguridad de la aplicación web de Microsoft Dynamics 365. Solo los usuarios con licencia de Microsoft Dynamics 365 con los privilegios necesarios tienen acceso a ellos.

Limitaciones de tamaño

El tamaño máximo de los archivos que se pueden cargar se determina mediante la propiedad Organization.MaxUploadFileSize. Esta propiedad se define en la pestaña Correo electrónico de Configuración del sistema en la aplicación Dynamics 365. Esta configuración limita el tamaño de los archivos que pueden adjuntarse a los mensajes de correo electrónico, notas y recursos web. La configuración predeterminada es 5 MB.

Tipos de recursos web

Puede usar diez formatos de archivo para crear recursos web. En la siguiente tabla se enumera cada formato de archivo, las extensiones de archivo permitidas y el valor de tipo que se usa con cada uno.

Archivo	Extensiones de archivo	Tipo
Página web (HTML)	.htm, .html	1
Hoja de estilos (CSS)	.css	2
Script (JScript)	.js	3
Datos (XML)	.xml	4
Imagen (PNG)	.png	5
Imagen (JPG)	.jpg	6
Imagen (GIF)	.gif	7
Silverlight (XAP)	.xap	8
Hoja de estilos (XSL)	.xsl, .xslt	9
Imagen (ICO)	.ico	10

Recursos web para referencias

Hay varios métodos que se pueden usar para hacer referencia a recursos web.

Nota

• Cuando sea posible, use la directiva $webresource. Solo las referencias que usan la directiva $webresource en los comandos del mapa del sitio o de la cinta de opciones establecerán dependencias. Las dependencias no se crean cuando los recursos web se hacen referencia mutuamente.

• Para mostrar un recurso web de Silverlight fuera de un formulario o gráfico de entidad, cree un recurso web HTML como página host para el recurso web de Silverlight. Después, use la directiva $webresource: para abrir el recurso web HTML.

Directiva $webresource

Debe usar siempre la directiva $webresource al hacer referencia a un recurso web de un control de la cinta de opciones o de una subárea de SiteMap. Use la directiva $webresource donde el XML permita un valor de dirección URL. En el siguiente ejemplo se muestra su uso.

$webresource:<name of Web Resource>

Nota

Cuando se usa la directiva $webresource, Microsoft Dynamics 365 creará o actualizará las dependencias de la solución.

Xrm.Utility.openWebResource

La función Xrm.Utility.openWebResource abrirá un recurso web HTML en una nueva ventana con los parámetros para pasar el nombre del recurso web, de los datos de cadena de consulta que se pasarán en el parámetro de datos, e información sobre el alto y ancho de la ventana.

La URL generada incluye el símbolo único GUID para que se cargue el recurso web almacenado en caché.

Dirección URL relativa

Al hacer referencia a un recurso web de las áreas que no son compatibles con la directiva $webresource:, se puede usar una URL relativa. Para habilitar esta opción, se recomienda usar una convención de nomenclatura coherente para los recursos web, que refleje una estructura de archivos virtual. El prefijo de personalización del editor de soluciones se incluirá siempre como prefijo del nombre del recurso web. Esto puede representar una carpeta "raíz" virtual para todos los recursos web agregados para ese editor. Puede usar posteriormente el carácter de barra diagonal (/) para simular una estructura de carpetas que se mantendrá en el servidor web.

Desde otro recurso web, debe usar siempre URLs relativas para que se hagan referencia mutuamente. Por ejemplo, para que el recurso web de página web new_/content/contentpage.htm haga referencia al recurso web CSSnew_/Styles/styles.css, establezca el vínculo de la siguiente manera:

<link rel="stylesheet" type="text/css" href="../styles/styles.css" />

Para que el recurso web de página web new_/content/contentpage.htm abra el recurso web de página web isv_/foldername/dialogpage.htm , establezca el vínculo de la siguiente manera:

<a href="../../isv_/foldername/dialogpage.htm">Dialog Page</a>

Nota

No use una URL relativa con la carpeta WebResources como la ruta raíz para la URL. Por ejemplo, no use esta opción: /WebResources/<name of web resource>. Cuando un usuario pertenece a más de una organización en un servidor, esta ruta se referirá siempre a la organización predeterminada. Si el usuario no está usando su organización predeterminada y el recurso web esperado no está incluido en la organización predeterminada del usuario, aparecerá el error "Archivo no encontrado" incluso si el recurso web aparece en la organización en la que está trabajando el usuario en ese momento.

URL completa

El siguiente ejemplo muestra el estilo de URL que puede usar para ver los recursos web.

<Microsoft CRM URL>/WebResources/<name of web resource>

La aplicación procesará esta URL y devolverá el archivo que contiene la versión más reciente del recurso web. Esta URL tendrá este aspecto:

<Microsoft CRM URL>/%7B<GUID value>%7D/WebResources/<name of web resource>

El valor GUID se actualiza cuando se publican personalizaciones y asegura que el explorador usa la versión más reciente almacenada en la memoria caché del recurso web. Por este motivo, use una ruta de acceso relativa a un recurso web, la función Xrm.Utility.openWebResource o Directiva $webresource (cuando sea posible) porque el valor GUID se incluirá automáticamente. Para recursos web grandes como son los recursos web de Silverlight, las consecuencias en el rendimiento serán significativas si no usa la versión almacenada en la memoria caché del archivo.

El siguiente ejemplo muestra una dirección URL para Microsoft Dynamics 365 (online), donde el nombre MyOrganization es el nombre de la organización y new_/test/test.htm es el nombre del recurso web:

https://MyOrganization.crm.dynamics.com/WebResources/new_/test/test.htm

Nota

Incluir el carácter "/" y la extensión de nombre de archivo en el nombre del recurso web es una práctica recomendada opcional.

El siguiente ejemplo muestra una URL para implementaciones locales Microsoft Dynamics 365, donde myServer es el nombre del servidor:

http://myServer/MyOrganization/WebResources/new_/test/test.htm

Cuando escriba código para hacer referencia a un recurso web que es necesario para Microsoft Dynamics 365 (online) o Microsoft Dynamics 365 local, debe usar la función getClientUrl.

Ver también

Amplíe Microsoft Dynamics 365 en el cliente
Bibliotecas de JavaScript para Microsoft Dynamics 365
Crear recursos web accesibles
Recursos web de página web (HTML)
Recursos web de Silverlight (XAP)
Recursos web de script (JScript)
Recursos web de imagen (JPG, PNG, GIF, ICO)
Recursos web de hoja de estilo (XSL)
Recursos web (XML) de datos
Recursos web CSS
Mensajes y métodos de la entidad WebResource
Ejemplo: pasar varios valores a un recurso web mediante el parámetro de datos
Ejemplo: utilidad de recurso web
Ejemplo: importar archivos como recursos web
Trabajar con datos de Dynamics 365 utilizando recursos web

Microsoft Dynamics 365

© 2017 Microsoft. Todos los derechos reservados. Copyright