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 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. Más información: Pasar los parámetros a recursos web HTML

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 Dynamics 365 Customer Engagement (on-premises) 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.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 Descripción
typename Nombre de entidad El nombre de la entidad.
tipo Código de tipo de entidad Entero que identifica de forma única la entidad 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 entidad. Cuando está habilitada, la dirección URL de ayuda personalizada incluirá un valor de "formulario" o "hierarchychart".
pagemode Solo para uso interno.
security Para uso interno.
tabSet Para uso interno.

Para pasar más de un valor en el parámetro de datos, debe codificar los parámetros en el valor del parámetro de datos y después incluir lógica para descodificar varios parámetros mediante el script en el recurso web HTML. El tema Ejemplo: Pasar varios valores a un recurso web a través de los datos parámetro muestra una solución para dirigirse pasando varios valores de parámetros.

Vea también

Recursos web para Dynamics 365 Customer Engagement (on-premises)
Crear recursos web accesibles
Uso de recursos web de hojas de estilo (CSS)
Usar recursos web de script (JScript)
Uso de recursos web de datos (XML)
Uso de recursos web de imagen (JPG, PNG, GIF)
Uso de recursos web de hoja de estilo (XSL)