Recursos web de página web (HTML)
Use los recursos web de la página web (HTML) para crear los elementos de la interfaz de usuario para las extensiones de cliente.
Capacidades de los recursos web de HTML
Puesto que un recurso web HTML solo se transmite en secuencias al explorador del usuario, puede incluir cualquier contenido que se represente en el explorador del usuario.
Limitaciones de los recursos web de HTML
Un recurso web HTML no puede contener ningún código que se deba ejecutar en el servidor. Las páginas ASP.NET no se pueden cargar como recursos web HTML.
Los recursos web HTML solo pueden aceptar un número limitado de parámetros de cadena de consulta. Pasar los parámetros a recursos web HTML
Por razones de rendimiento, el entorno de tiempo de ejecución de un formulario puede recargar los recursos web HTML incrustados como controles en el formulario. Por ejemplo, el entorno de tiempo de ejecución del formulario puede destruir y reinicializar el control durante la navegación por pestañas.
Use el editor de texto de los recursos web HTML
El editor de texto proporcionado en el formulario de recursos web se usa con la edición HTML, muy sencilla. Para obtener documentos HTML más sofisticados, debe modificar el código en un editor externo y usar el botón Examinar para cargar los contenidos del archivo.
Por ejemplo, una página HTML más compleja que requiere que el script represente el contenido de la página empezará como el siguiente ejemplo.
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<title></title>
<script src="Script/Script.js" type="text/javascript"></script>
<link href="CSS/Styles.css" rel="stylesheet" type="text/css" />
</head>
<body onload="SDK.ImportWebResources.showData()">
<div id="results" />
</body>
</html>
Cuando el documento se abra y se guarde en el editor de texto, el HTML se cambiará y pasará a esto.
<HTML><HEAD><TITLE></TITLE>
<META charset=utf-8></HEAD>
<BODY contentEditable=true onload=SDK.ImportWebResources.showData()>
<SCRIPT type=text/javascript src="Script/Script.js"></SCRIPT>
<LINK rel=stylesheet type=text/css href="CSS/Styles.css">
<DIV id=results></DIV></BODY></HTML>
Evitar la edición de recursos web de soluciones administradas
Debido a la característica HTML en recursos web que permite las modificaciones mediante el editor de texto, se recomienda que se usen propiedades administradas para establecer recursos web HTML complejos como no personalizables para soluciones administradas. Para ver los recursos web en la ventana de soluciones, abra el cuadro de diálogo Propiedades administradas para establecer la propiedad Personalizable en false.
Hacer referencia a otros recursos web desde un recurso web HTML
Puede crear un conjunto de archivos relacionados fuera de aplicaciones basadas en modelos que use los tipos de archivo de recursos web. Si siempre usa rutas de acceso relativas e importa cada recurso web con una convención de nomenclatura coherente que refleje la estructura de carpetas del sitio web, verá que el recurso web HTML mantiene los vínculos con CSS, XML, JScript, imágenes y archivos de Silverlight relacionados que se han importado como recursos web.
Por ejemplo, si crea un proyecto de aplicación web que usa la siguiente estructura de [carpeta]/archivo:
page.htm
[Estilos]
- style.css
[Scripts]
- script.js
Al importar estos archivos como recursos web, puede poner un nombre en el que el prefijo de personalización del editor de soluciones sea "new", de la siguiente manera:
new_/page.htmnew_/Styles/style.cssnew_/Scripts/script.js
Si sigue este patrón, el recurso web new_/page.htm HTML puede hacer referencia a los otros archivos de la manera más habitual, utilizando rutas relativas, como se muestra en el ejemplo siguiente.
<script src="Scripts/script.js" type="text/javascript"></script>
<link href="Styles/style.css" rel="stylesheet" type="text/css" />
El prefijo de personalización del editor de soluciones se convierte en una carpeta raíz virtual para todos los recursos web de la solución. Si cambia el prefijo de personalización, las rutas relativas en los recursos web HTML no se cambiarán.
Nota
- Un recurso web HTML agregado a un formulario no puede usar objetos globales definidos por la biblioteca JavaScript cargada en el formulario. Un recurso web HTML pueden interactuar con los objetos
Xrm.PageoXrm.Utilitydentro del formulario medianteparent.Xrm.Pageoparent.Xrm.Utility, pero los objetos globales definidos por scripts del formulario no serán accesibles utilizando el elemento principal. Debe cargar todas las bibliotecas que un recurso web HTML necesite dentro del un recurso web HTML de modo que no dependa de los scripts cargados en el formulario. - Las referencias incluidas en código entre los recursos web no se siguen como dependencias de solución.
Dado que también se descargan recursos web para usuarios de Dynamics 365 for Microsoft Office Outlook con acceso sin conexión, los usuarios tendrán acceso al contenido del recurso web mientras están desconectados.
Pasar los parámetros a recursos web HTML
Un recurso web HTML solo puede aceptar los parámetros de la tabla siguiente.
| Parámetro | Nombre | Descripción |
|---|---|---|
| typename | Nombre de tabla | Nombre de la tabla. |
| tipo | Código e tipo de tabla | Un entero que identifica de forma única la tabla en una organización específica. |
| id. | GUID de objeto | GUID que representa un registro. |
| orgname | Nombre de la organización | Nombre único de la organización. |
| userlcid | Código de idioma de usuario | Identificador del código de idioma que usa el usuario actual. |
| orglcid | Código de idioma de la organización | Identificador del código de idioma que representa el idioma base de la organización. |
| Datos de | Parámetros de datos opcionales | Valor opcional que se puede pasar. |
| formid | Identificador del formulario | GUID que representa un Id. de formulario. |
| entrypoint | Punto de entrada | Un valor de cadena. Este parámetro está diseñado para pasarse como valor opcional a recursos web abiertos como contenido de ayuda personalizado para una tabla. Cuando está habilitada, la dirección URL de ayuda personalizada incluirá un valor de "formulario" o "hierarchychart". |
| pagemode | Solo para uso interno. | |
| seguridad | Solo para uso interno. | |
| tabSet | Solo para uso interno. |
Si varios valores se pasan en el parámetro de datos, se codificarán automáticamente. La lógica se debe incluir también para descodificar los varios parámetros con el script en el recurso de web HTML. El tema Ejemplo: Pasar varios valores a un recurso web mediante el parámetro de datos muestra un enfoque para transferir varios valores de parámetro.
Nota
Todos los caracteres incluidos en la cadena de consulta pasan por validación para garantizar la validez de los parámetros pasados. Si se encuentra que algún parámetro no es válido, se producirá un error en la solicitud. Por ejemplo, pasar valores de texto entre corchetes angulares se considera un tipo de parámetro no válido.
Consulte también
Recursos web
Crear recursos web accesibles
Uso de recursos web de hojas de estilo (CSS)
Usar recursos web de JavaScript
Usar recursos web de datos (XML)
Uso de recursos web de imagen (JPG, PNG, GIF)
Usar recursos web de hoja de estilo (XSL)
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).