Recursos web en aplicaciones basadas en modelos

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

Nota

Los recursos web y el marco de componentes de Power Apps no admiten la inclusión de contenido mediante IFRAME que esté protegido por autenticación. Algunos IFRAME incrustados pueden funcionar en un cliente de navegador si el usuario inicia sesión directamente en el servicio externo, pero esto no es compatible con aplicaciones móviles o para tabletas. El escenario específico de incrustar un formulario en un IFRAME incrustado en otro formulario no se admite. Use el formulario como componente para estos escenarios.

En general, use el marco de componentes de Power Apps y las páginas personalizadas para crear integraciones externas configurables , reutilizables y más estrictas. Más información: Componente de IFRAME

Capacidades de los recursos web

Los recursos web representan archivos que puede usar para ampliar la aplicación web de Dataverse, como archivos HTML, JavaScript, CSS y varios formatos de imagen. Puede usar recursos web en personalizaciones de formularios, el SiteMap o la cinta de opciones de la aplicación, ya que puede hacer referencia a ellos mediante la sintaxis de dirección URL.

La sintaxis de URL para los recursos web permite referencias a rutas relativas. Mediante las herramientas de desarrollo, puede crear un grupo de archivos interdependientes en un servidor de desarrollo mediante tipos de archivo compatibles con los recursos web. A continuación, si usa una convención de nomenclatura coherente y referencias de ruta de acceso relativas, el sitio web funcionará correctamente después de cargar todos los archivos en el Dataverse.

Dado que Dataverse almacena recursos web y son componentes de la solución, puede exportarlos e instalarlos fácilmente en otras organizaciones de Dataverse. Los usuarios de Dataverse para Microsoft Office Outlook con Acceso sin conexión pueden usar recursos web cuando están sin conexión porque se sincronizan con los datos del usuario.

Use el editor de formularios para agregar y configurar recursos web habilitados para formularios en los formularios.

Dado que Dataverse almacena los recursos web como registros en la base de datos, puede administrarlos mediante programación mediante las técnicas estándar para crear, recuperar y actualizar registros. Puede editar y guardar recursos web basados en texto (JScript, CSS, XML, XSL, RESX y HTML) en la aplicación.

Limitaciones de los recursos web

Ningún tipo de recurso web admite las funcionalidades de una página de ASP.NET (.aspx) para ejecutar código en el servidor. Los recursos web se limitan a archivos o archivos estáticos que procesa el explorador. Un recurso web puede contener código que el explorador procesa para ejecutar llamadas de servicio web para interactuar con los datos de Dataverse.

Solo puede acceder a los recursos web mediante el contexto de seguridad de la aplicación web de Dataverse. Sólo los usuarios con licencia de aplicaciones Dataverse con los privilegios necesarios pueden tener acceso a ellos.

Limitaciones de tamaño

La propiedad Organization.MaxUploadFileSize determina el tamaño máximo de los archivos que puede cargar. Establezca esta propiedad en la pestaña Correo electrónico de la configuración del sistema en la aplicación Dynamics 365. Esta configuración limita el tamaño de los archivos que puede adjuntar a los mensajes de correo electrónico, las notas y los recursos web. La configuración predeterminada es 5 MB. Para obtener más información, consulte Configuración del entorno y límites de tamaño de archivo.

Tipos de recursos web

Puede usar 10 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	Escriba
Página web (HTML)	.htm, .html	1
Hoja de estilos (CSS)	.css	2
Script (JScript, un lenguaje de programación para aplicaciones web)	.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
Formato vectorial (SVG)	.svg	11
Cadena (RESX)	.resx	12

Recursos web para referencias

Haga referencia a los recursos web mediante varios métodos.

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 referencian entre sí.

Directiva $webresource

Use siempre la $webresource directiva al hacer referencia a un recurso web desde un control de cinta o desde un SiteMap subárea. 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, Dataverse creará o actualizará las dependencias de la solución.

Xrm.Navigation.openWebResource

La función Xrm.Navigation.openWebResource abre un recurso web HTML en una nueva ventana con parámetros para pasar el nombre del recurso web, los datos de cadena de consulta que se van a pasar en el parámetro de datos e información sobre el alto y el 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 referenciar un recurso web en áreas que no admiten la directiva $webresource:, use una URL relativa. Para habilitar este enfoque, use una convención de nomenclatura coherente para los recursos web que reflejen una estructura de archivos virtuales. Incluya el prefijo de personalización del publicador de la solución como prefijo para el nombre del recurso web. Este prefijo puede representar una carpeta "raíz" virtual para todos los recursos web agregados por ese publicador. Use el carácter de barra diagonal (/) para simular una estructura de carpetas que respeta el servidor web.

Desde otro recurso web, use siempre direcciones URL relativas para hacer referencia entre sí. Por ejemplo, para que el recurso web de página web new_/content/contentpage.htm haga referencia al recurso web CSS new_/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 de la página web new_/content/contentpage.htm abra el recurso de la página web isv_/foldername/dialogpage.htm, cree el enlace de la siguiente manera:

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

Nota

No use una URL relativa que emplee la carpeta WebResources como ruta de acceso 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 de acceso hace referencia a la organización predeterminada del usuario. 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 completo

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

<Dataverse Environment URL>/WebResources/<name of web resource>  

La aplicación procesa esta dirección URL y devuelve el archivo que contiene la versión más reciente del recurso web. Esta URL tiene el siguiente aspecto:

<Dataverse Environment URL>/%7B<version value>%7D/WebResources/<name of web resource>  

El valor de versión se actualiza al publicar personalizaciones y garantiza que el explorador use la versión almacenada en caché más reciente del recurso web. Por este motivo, use una ruta de acceso relativa a un recurso web, la función Xrm.Navigation.openWebResource o el $webresource Directive (cuando sea posible) porque el valor versión se incluirá automáticamente. En el caso de los recursos web de gran tamaño, no usar la versión almacenada en caché del archivo puede tener importantes implicaciones de rendimiento.

El siguiente ejemplo muestra una dirección URL para Dataverse, donde el nombre MyOrganization es el nombre del entorno de Dataverse 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. Al escribir código para hacer referencia a un recurso web que funciona para Dataverse, use la función getClientUrl .

Diferencias de diseño entre el cliente web heredado y la Interfaz unificada

Un control de recursos web configurado para usar un determinado número de filas tiene diferentes alturas en una aplicación cliente unificada en comparación con una aplicación cliente web. Esta diferencia existe porque hay una diferencia en el alto de una fila entre la interfaz unificada y el cliente web. Si se necesita un formulario tanto en el cliente web como en Interfaz unificada, puede usar diferentes formularios en la aplicación de Interfaz unificada y la aplicación de cliente web con el control configurado para usar el número apropiado de filas en cada formulario.

Herramientas de la Comunidad

WebResources Manager es una herramienta que la comunidad XrmToolbox desarrolló para Dataverse. Consulte el artículo de Herramientas para desarrolladores sobre las herramientas desarrolladas por la comunidad.

Nota

Las herramientas de la comunidad no son un producto de Dataverse y Microsoft no proporciona soporte técnico para las herramientas de la comunidad. Si tiene alguna pregunta sobre la herramienta, póngase en contacto con el publicador. Para obtener más información, vea XrmToolBox.

Consultar también

Crear recursos web accesibles
Recursos web de página web (HTML)
Recursos web de JavaScript
Recursos web de imagen
Recursos web de hoja de estilo (XSL)
Recursos web de datos (XML)
Recursos web de hoja de estilo (CSS)
Referencia de tabla de recurso web
Ejemplo: Pasar varios valores a un recurso web mediante el parámetro de datos
Ejemplo: Importación de archivos como recursos web
Agilice el desarrollo de recursos web con Fiddler Auto-Responder