Ressources web d’images

Article
03/22/2023

Utilisez les ressources web d’images pour rendre les images disponibles pour être utilisées dans Dynamics 365 Customer Engagement (on-premises).

Il existe 5 types de ressources web d’image :

Format PNG
Format JPG
Format GIF
Format ICO
Format vectoriel (SVG)

Note

Des ressources web SVG ont été ajoutées avec les applications Dynamics 365 for Customer Engagement version 9.0.

Fonctionnalités des ressources Web d’images

Les ressources web d’images vous permettent d’ajouter des images là où vous en avez besoin. Les utilisations courantes sont notamment les suivantes :

Icônes d’entité personnalisée
Icônes pour les contrôles personnalisés du Ruban et les sous-zones SiteMap.
Graphiques décoratifs pour les formulaires d’entités et les ressources web de page web.
Images d’arrière-plan utilisées par les ressources web CSS.

Utilisez des ressources web au format vectoriel (SVG) pour toutes les icônes affichées dans l’application. Les images vectorielles sont définies au format SVG (Scalable Vector Graphics, graphique vectoriel évolutif), un format fondé sur XML. L’avantage des images vectorielles sur les autres ressources Web d’images est qu’elles peuvent être mises à l’échelle. Vous pouvez définir une image vectorielle et la réutiliser au lieu de fourni plusieurs tailles d’image. Vous allez les utiliser avec une nouvelle propriété EntityMetadata.IconVectorName pour définir l’icône pour une entité personnalisée plutôt que les propriétés IconLargeName, IconMediumName, ou IconSmallName.

Limitations des ressources web d’images

Comme toutes les ressources web, les ressources web d’images utilisent le contexte de sécurité Dynamics 365 Customer Engagement (on-premises). Seuls les utilisateurs Dynamics 365 Customer Engagement (on-premises) autorisés disposant des privilèges nécessaires peuvent y accéder.

Référencer une ressource web d’image à partir d’une ressource web de page web

Toutes les ressources web peuvent utiliser les URL relatives pour se référencer entre elles. Dans l’exemple suivant, pour que la ressource web de la page web nommée « new_/content/contentpage.htm » fasse référence à la ressource web d’image nommée « new_/Images/image1.png », ajoutez la balise d’image HTML suivante à la ressource web (HTML) de la page web nommée « new_/content/contentpage.htm » :

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

Référencer une ressource web d’image Dynamics 365 Customer Engagement (on-premises) dans un formulaire

Ajouter une image à un formulaire d’entité

Accédez à l’éditeur de formulaires pour une entité.
Sélectionnez où vous souhaitez ajouter l’image dans le formulaire.
Sous Insérer un onglet, cliquez sur Ressource web.
Sous l’onglet Général, sélectionnez l’image de ressource web à ajouter.
Indiquez un nom pour la ressource web. Vous pouvez spécifier une Étiquette et un texte de remplacement.
Sous l’onglet Mise en forme, vous pouvez définir :
- le nombre de colonnes que les images doivent utiliser ;
- le nombre de lignes que les images doivent utiliser, ou si elles doivent automatiquement s’ajuster pour utiliser l’espace disponible.
- La taille de l’image à l’aide des options suivantes :
  - Étirer pour ajuster
  - Étirer pour ajuster (conserver les proportions)
  - D’origine
  - Specific
- Si vous sélectionnez « Spécifique », vous pouvez entrer la hauteur et la largeur souhaitées en pixels.
Cliquez sur OK.
Vous devez enregistrer vos modifications et publier le formulaire avant que les utilisateurs puissent voir l’image dans le formulaire.

Référencer une ressource web d’image à partir d’un élément du Ruban ou de la sous-zone Plan du site

Utilisez la directive $webresource: pour spécifier une image de ressource web à utiliser comme icône dans le Ruban ou lors de la navigation dans l’application à l’aide du plan de site. Cet exemple explique comment spécifier les icônes pour un bouton dans le Ruban.

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

Note

À l’aide de la directive $webresource:, ajoutez une dépendance de solution qui empêche les ressources web d’images référencées d’être supprimée tant qu’elles sont utilisées par un autre composant de solution.

Voir aussi

Ressources web pour Dynamics 365 Customer Engagement (on-premises)
Utilisation des ressources web de page web (HTML)
Utilisation des ressources web de feuille de style (CSS)
Utilisation des ressources web de script (JScript)
Utilisation des ressources web de données (XML)
Utilisation des ressources web Silverlight (XAP)
Utilisation des ressources web de feuille de style (XSL)

Partager via