Recursos web en aplicaciones basadas en modelos

  • Artículo

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

Nota

El contenido de IFRAMEing que está detrás de un límite de autenticación no es compatible a través de recursos web o Power Apps component framework. 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. Recomendamos usar un formulario como un componente para tales escenarios.

En general, el uso del Power Apps component framework y páginas personalizadas se recomienda para construir integraciones externas configurables, reutilizables y más ajustadas. Más información: Componente de IFRAME

Capacidades de los recursos web

Los recursos web representan los archivos que se pueden usar para ampliar la aplicación web de Dataverse, como los archivos html, JavaScript y CSS y diversos formatos de imagen. Puede usar recursos web en personalizaciones de formularios, el 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 Dataverse.

Puesto que los recursos web se almacenan en Dataverse y son componentes de la solución, se pueden exportar e instalar fácilmente en otras organizaciones de Dataverse. Los recursos web están también disponibles para los usuarios de Dataverse for Microsoft Office Outlook con acceso sin conexión cuando está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.

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, RESX y 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 Dataverse.

Los recursos web solo están disponibles 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

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 Escriba
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
Formato vectorial (SVG) .svg 11
Cadena (RESX) .resx 12

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, 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, Dataverse creará o actualizará las dependencias de la solución.

Xrm.Navigation.openWebResource

La función Xrm.Navigation.openWebResource abre una nueva ventana de recurso web HTML 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 URL 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 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 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 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 procesará esta URL y devolverá el archivo que contiene la versión más reciente del recurso web. Esta URL tendrá este aspecto:

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

El valor versión 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.Navigation.openWebResource o el $webresource Directive (cuando sea posible) porque el valor versión se incluirá automáticamente. Para recursos web grandes 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 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.
Cuando escriba código para hacer referencia a un recurso web que funciona para Dataverse, debe usar 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 tendrá alturas diferentes en una aplicación de cliente unificada en comparación con una aplicación de cliente web. Esto se debe a que existe una diferencia en la altura 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 ha desarrollada para Dataverse. Consulte el tema herramientas para desarrolladores para comunidad de herramientas desarrolladas.

Nota

Las herramientas de la comunidad no son un producto de Dataverse y no se incluyen en el soporte técnico. Si tiene alguna duda relacionada con la herramienta, póngase en contacto con el Editor. Más información: 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 AutoResponder

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