Recursos web de imagen

  • Artículo

Use los recursos web de imagen para hacer que las imágenes estén disponibles para su uso en Dynamics 365 Customer Engagement (on-premises).

Hay cinco tipos de recursos web de imágenes:

  • Formato PNG
  • Formato JPG
  • Formato GIF
  • Formato ICO
  • Formato vectorial (SVG)

Nota

Los recursos web de Vector Format (SVG) se agregaron con las aplicaciones de Dynamics 365 for Customer Engagement, versión 9.0.

Capacidades de los recursos web de imagen

Con recursos web de imagen es posible agregar imágenes cuando las necesite. Los usos habituales incluyen:

  • Iconos de entidad personalizada
  • Iconos para controles de cinta personalizada y subáreas del SiteMap.
  • Gráficos decorativos para formularios de entidad y recursos web de páginas web.
  • Imágenes de fondo usadas por recursos web CSS.

Use los recursos web de formato de vector (SVG) para cualquier icono que se muestre en la aplicación. Las imágenes vectoriales se definen como Scalable Vector Graphics (SVG), un formato de imagen vectorial basado en XML. La ventaja de las imágenes vectoriales sobre otros recursos web de imagen es que son escalables. Puede definir una imagen vectorial y reutilizarla en lugar de proporcionar varios tamaños de imágenes. Usará estos con una nueva propiedad EntityMetadata.IconVectorName para definir el icono de una entidad personalizada en lugar de las propiedades IconLargeName, IconMediumName o IconSmallName.

Limitaciones de los recursos web de imagen

Como todos los recursos web, los recursos web de imagen usan el contexto de seguridad de Dynamics 365 Customer Engagement (on-premises). Sólo los usuarios con licencia de Dynamics 365 Customer Engagement (on-premises) con los privilegios necesarios pueden tener acceso a ellos.

Haga referencia a un recurso web de imagen desde un recurso web de página web

Todos los recursos web pueden usar direcciones URL relativas para hacer referencia unos a otros. En el siguiente ejemplo, para el recurso web de la página web (HTML) denominada "new_/content/contentpage.htm" que hace referencia al recurso web de imágenes denominado "new_/Images/image1.png", agregue la siguiente etiqueta de imagen HTML al recurso web de página web (HTML) denominado "new_/content/contentpage.htm":

<img src="../Images/image1.png" />

Haga referencia a un recurso web de imagen desde un formulario de Dynamics 365 Customer Engagement (on-premises)

Agregar una imagen a un formulario de entidad

  1. Navegue hasta el editor de formularios para una entidad.

  2. Seleccione donde desea agregar la imagen en el formulario.

  3. En la pestaña Insertar, haga clic en Recurso web.

  4. En la pestaña General, seleccione la imagen del recurso web que desea agregar.

  5. Escriba un nombre para el recurso web. También puede especificar una etiqueta y un texto alternativo.

  6. En la pestaña Formato, puede definir:

    • El número de columnas que las imágenes deben usar.

    • El número de filas que las imágenes deben usar el o si deben expandirse automáticamente para usar el espacio disponible.

    • El tamaño de la imagen con las siguientes opciones:

      • Acercar a la idoneidad

      • Estire a la idoneidad (mantener las relaciones de aspecto)

      • Original

      • Específico,

    • Si selecciona “Específico”, puede especificar el alto y ancho deseados en píxeles.

  7. Haga clic en Aceptar.

  8. Debe guardar los cambios y publicar el formulario antes de que los usuarios puedan ver la imagen en el formulario.

Haga referencia a un recurso web de imagen desde un elemento de la cinta de opciones o desde una subárea del mapa del sitio

Use la directiva de $webresource: para especificar una imagen del recurso web que desee utilizar como icono de la cinta de opciones o en la navegación de la aplicación mediante mapa del sitio. El siguiente ejemplo muestra cómo especificar los iconos para un botón de la cinta de opciones.

<Button Id="MyISV.opportunity.form.actions.FlyoutAnchor.Button.1" Image16by16="$webresource:new_/icons/oneIcon16.png" Image32by32="$webresource:new_/icons/oneIcon32.png"/>

Nota

Mediante la directiva de $webresource: se agrega una dependencia de la solución que impide eliminar los recursos web de imagen a los que se hace referencia mientras otro componente de la solución los esté usando.

Vea también

Recursos web para Dynamics 365 Customer Engagement (on-premises)
Uso de recursos web de página web (HTML)
Uso de recursos web de hojas de estilo (CSS)
Usar recursos web de script (JScript)
Uso de recursos web de datos (XML)
Usar recursos web Silverlight (XAP)
Usar recursos web de hoja de estilo (XSL)