Crear o editar recursos web para extender una aplicación

Este tema se aplica a Dynamics 365 Customer Engagement (on-premises). Para la versión de Power Apps de este tema, consulte: Crear o editar recursos web de aplicaciones controladas por modelos para ampliar una aplicación

Los programadores usan recursos web normalmente para extender la aplicación utilizando archivos que se usan en el desarrollo web. Los usuarios de la aplicación es posible que necesiten administrar los recursos web proporcionados por un programador o un diseñador.

¿Qué son los recursos web?

Los recursos web son archivos virtuales almacenados en el sistema. Cada recurso web tiene un nombre único que se pueda usar en una dirección URL para recuperar el archivo. Piense en ellos de esta manera: Si tuviera acceso al servidor web real que ejecuta la aplicación web, podría copiar los archivos a ese sitio web. Pero con la mayoría de los servicios online no puede hacerlo. En su lugar, puede usar recursos web para cargar archivos al sistema y luego hacer referencia a ellos por nombre como si los hubiera copiado como archivos en el servidor web.

Por ejemplo, si crea una página HTML como un recurso web llamado "new_myWebResource.htm", podría abrir esa página en un explorador que use una dirección URL como ésta:

<URL de Dynamics 365 Customer Engagement (on-premises)>/WebResources/new_myWebResource.htm

donde <URL de la aplicación> es la dirección URL que normalmente se usa para abrir la aplicación. Puesto que el recurso web son datos del sistema, sólo los usuarios con licencia de la organización pueden tener acceso a ellos de esta forma. Normalmente, recursos web se incluyen en formularios en lugar de hacer referencia a ellos directamente. El uso más común consiste en proporcionar bibliotecas de JavaScript para scripts de formularios.

Puesto que los recursos web son datos del sistema y son compatibles con las soluciones, puede moverlos a distintas organizaciones exportándolos como parte de una solución e importando la solución a otra organización.

Crear y editar recursos web

1. Abra el explorador de soluciones y seleccione Recursos web.

2. En Componentes, elija Recursos web.

3. Para crear un recurso web, seleccione Nuevo.

   Para editar un recurso web, haga doble clic en el recurso web que desea editar.

4. El formulario de recursos web tiene los siguientes campos y funciones:

   Etiqueta	Descripción
   Nombre	Requerido. Este es el nombre único para este recurso web. No se puede cambiar una vez guardado el recurso web. Este nombre solo puede incluir letras, números, puntos y caracteres de barra diagonal (“/”) no consecutivos. El prefijo de personalización del editor de soluciones se antepondrá al nombre del recurso web.
   Nombre para mostrar	El nombre que se muestra si ve una lista de recursos web.
   Descripción	Una descripción del recurso web.
   Tipo	Requerido. Este es el tipo de recurso web. No se puede cambiar una vez guardado el recurso web.
   Editor de texto	Cuando el tipo de recurso web representa un tipo de archivo de texto, seleccione este botón para abrir una página para modificar el contenido mediante el editor de texto.
   Idioma	Permite la selección de un idioma diferente. Esta opción sólo etiqueta el registro que almacena los datos del recurso web. No modifica el comportamiento del recurso web.
   Cargar archivo	Seleccione el botón Examinar... para elegir el archivo que se debe cargar como recurso web. Puede cargar un archivo al crear un nuevo recurso web o para sobrescribir un recurso web existente. La extensión del nombre de archivo debe coincidir con extensiones permitidas. De forma predeterminada el archivo de tamaño máximo que se puede cargar como recurso web es 5 MB. Este valor se pueden editar en Dynamics 365 Customer Engagement (on-premises) usando la opción Configuración del sistema>pestaña Correo electrónico >Establecer límite de tamaño para archivos adjuntos. Más información: Cuadro de diálogo Configuración del sistema: pestaña Correo electrónico
   URL	Una vez guardado el recurso web, se mostrará aquí la dirección URL del recurso web. Seleccione este vínculo para ver el recurso web en el explorador.

5. Después de haber agregado los cambios, elija Guardar y luego en Publicar.

Use el editor de texto adecuadamente

El editor de texto proporcionado en la aplicación para los recursos web se debe usar sólo para ediciones simples de archivos de texto. Puede usarlo para crear y modificar los recursos web HTML, pero solo deberá modificar recursos web HTML creados mediante el editor de texto. El editor de texto está diseñado para contenido HTML muy sencillo. Si el contenido de un recurso web HTML no se ha creado mediante el editor de texto, no use el editor de texto para editarlo.

El editor de texto usa un control que modifica el código fuente HTML de una forma que permite que sea editado. Estos cambios pueden hacer que la página se comporte de forma diferente en el explorador y hacer que código más sofisticado deje de funcionar. Al abrir un recurso web HTML con el editor de texto y guardarlo sin realizar ningún cambio pueden dañar algunos recursos web HTML.

Se recomienda usar un editor externo para editar archivos de texto y volver a guardarlos localmente antes de cargarlos con el botón Cargar archivo. De esta manera puede mantener una copia del recurso web si necesita volver a una versión anterior. Puede usar un editor simple como Bloc de notas, pero se recomienda encarecidamente un editor de texto con funciones más avanzadas. Visual Studio Express es gratuito y proporciona eficaces capacidades para editar los archivos que usan los recursos web basados en texto.

Crear y editar un recurso web en un formulario

Puede agregar o editar recursos web en un formulario para aumentar su atractivo o utilidad para los usuarios. Compruebe que tiene el rol de seguridad de Administrador del sistema o privilegios equivalentes.

1. Abra el explorador de soluciones.

2. En Componentes, expanda Entidades y, a continuación, expanda la entidad con la que desea trabajar.

3. Elija Formularios, en la lista localice un formulario de tipo Principal y, a continuación, haga doble clic o pulse en la entrada para abrir y editar el formulario.

4. Para agregar un recurso web, seleccione la pestaña (por ejemplo, General o Notas) en la que desea insertarlo y en la pestaña Insertar, seleccione Recurso web.
   -O bien-
   Para editar un recurso web, seleccione una pestaña de formulario y el recurso web que desee modificar y, a continuación, en la pestaña Inicio, seleccione Cambiar propiedades.

5. En el cuadro de diálogo Agregar recurso web o Propiedades de recurso web, en la pestaña General, introduzca la información adecuada en los campos requeridos. En especial, tenga en cuenta lo siguiente:

   • En el cuadro Recurso web, seleccione el recurso web de imagen, HTML o Silverlight que desee usar.

     Nota

     Después de especificar un recurso web, la sección Propiedades de recurso web aparece en la parte inferior de la pestaña, proporcionando opciones que varían en función del tipo de recurso web que está agregando. Estas opciones incluyen especificar parámetros personalizados, pasar código de tipo objeto de registro como parámetro, o especificar texto alternativo que describe el recurso o, para las imágenes, que hace que la imagen sea más accesible para todos los usuarios. He aquí algunas propiedades importantes. Para obtener una lista completa, consulte: Propiedades de los recursos web. - En el cuadro Nombre, escriba un nombre exclusivo para el campo. El nombre solo puede contener caracteres alfanuméricos y de subrayado.

   • El campo Etiqueta se completa automáticamente con una variación del nombre que especifique, pero asegúrese de que la etiqueta propuesta responde a sus necesidades o actualícela en consecuencia.

6. En la pestaña Formato, las opciones que se mostrarán varían en función del tipo de recurso web insertado. Estas opciones incluyen especificar el número de columnas y filas mostradas, si se muestra un borde y el comportamiento de desplazamiento.

7. Si la pestaña Dependencias se muestra en el cuadro de diálogo Agregar recurso web o Propiedades de recurso web, en la lista Campos disponibles, seleccione los campos requeridos por el recurso web, seleccione el botón Agregar registros seleccionados para mover los campos seleccionados a la lista Campos dependientes y, a continuación, seleccione Aceptar para cerrar el cuadro de diálogo.

8. Cuando haya terminado de modificar el formulario, en la pestaña Inicio, seleccione Guardar y cerrar para cerrar el formulario. Para obtener una vista previa de cómo aparecerá el formulario principal y cómo funcionarán los eventos:

   • En la ficha Inicio, seleccione Vista previa y, a continuación, seleccione Formulario de creación, Formulario de actualización o Formulario de sólo lectura.
   • Para cerrar el formulario Vista previa, en el menú Archivo, seleccione Cerrar.

9. Cuando haya completado las personalizaciones, publíquelas:

   • Para publicar las personalizaciones únicamente para el componente que está editando actualmente, en la barra de navegación o en el panel de navegación, elija la entidad en la que ha estado trabajando, y seleccione Publicar.
   • Para publicar personalizaciones de todos los componentes no publicados a la vez, en el Panel de navegación, seleccione Entidades y, en la barra de herramientas Acciones, seleccione Publicar todas las personalizaciones.

Agregar o editar un recurso web de imagen

Los recursos web son archivos virtuales en varios formatos, como archivos html y aplicaciones JavaScript y Silverlight, que se almacenan en el sistema y se pueden recuperar mediante una dirección URL única.

1. Abra el explorador de soluciones.

2. Para crear un nuevo recurso web, elija Componentes>Recursos web y en la barra de herramientas Acciones, elija Nuevo.

3. Escriba o modifique información en los cuadros de texto.

   • El nombre introducido en el cuadro de texto Nombre, más la extensión de archivo, se convertirá en el nombre del archivo.

   • El nombre especificado en el cuadro de texto Nombre para mostrar se mostrará en Nombre para mostrar.

   • En el cuadro desplegable Tipo, seleccione el tipo de archivo que desee.

4. Elija Examinar para seleccionar y cargar el archivo desde la máquina local.

   • Para obtener una vista previa de un recurso web de imagen cargado: Elija Recurso web>Vista previa.

   • Para editar un recurso web de texto: elija Editor de texto.

   • Para obtener una vista previa de un recurso web de texto: elija Recurso web>Vista previa.

5. Cuando esté listo para guardar los datos, elija Guardar y cerrar.

6. Publique la personalización.

   • Únicamente para el componente modificado: elija Guardar>Publicar en Inicio en Inicio.

   • Para todos los componentes no publicados a la vez, elija Publicar todas las personalizaciones.

Consulte también

Propiedades de recurso web
Crear y diseñar formularios
Introducción a la personalización
Recursos web para Customer Engagement