Compartir a través de

Recursos web de página web (HTML)

  • Artículo

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 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, 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 la muestra siguiente:

<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, use 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, 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.htm
  • new_/Styles/style.css
  • new_/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.Page o Xrm.Utility dentro del formulario mediante parent.Xrm.Page o parent.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. Description
typename Nombre de tabla Nombre de la tabla.
type 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.
data Parámetros de datos opcionales Valor opcional que se puede pasar.
formid Id. de 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 form o hierarchychart.
pagemode Para uso interno.
security Para uso interno.
tabSet 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 artículo 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
Usar recursos web de hojas de estilo (CSS)
Usar recursos web de JavaScript
Usar recursos web de datos (XML)
Usar recursos web de imagen (JPG, PNG, GIF)
Usar recursos web de hoja de estilo (XSL)