Ressources web pour Customer Engagement

Les ressources Web sont des fichiers virtuels qui sont stockés dans la base de données Dynamics 365 Customer Engagement (on-premises) et que vous pouvez récupérer en utilisant une adresse URL unique.

Fonctionnalités des ressources web

Les ressources Web sont des fichiers permettant d’étendre l’application Web Dynamics 365 Customer Engagement (on-premises), par exemple des fichiers HTML, JavaScript et CSS, ainsi que plusieurs formats d’image. Vous pouvez utiliser les ressources web dans les personnalisations de formulaire, dans le SiteMap, ou dans le ruban de l’application car elles peuvent être référencées à l’aide de la syntaxe d’URL.

La syntaxe de l’URL pour les ressources web autorise les références de chemin relatif. Avec vos outils de développement, vous pouvez créer un groupe de fichiers interdépendants sur un serveur de développement en utilisant des types de fichiers compatibles avec les ressources web. Ainsi, si vous utilisez une convention d’affectation de noms cohérente et des références de chemin relatif, le site web fonctionnera une fois que vous aurez téléchargé les fichiers dans Dynamics 365 Customer Engagement (on-premises).

Étant donné que les ressources web sont stockées dans Dynamics 365 Customer Engagement (on-premises) et qu’il s’agit de composants de solution, elles peuvent être facilement exportées et installées dans des déploiements locaux de Dynamics 365 Customer Engagement (on-premises) ou de Dynamics 365 for Customer Engagement. Les ressources web sont également à la disposition des utilisateurs de Dynamics 365 for Microsoft Office Outlook avec accès hors ligne en mode hors connexion, car elles sont synchronisées avec les données de l’utilisateur.

Vous pouvez utiliser l’éditeur de formulaires pour ajouter et configurer les ressources web de type formulaire dans vos formulaires d’entités.

Étant donné que les ressources web sont stockées sous forme d’enregistrements dans la base de données, elles peuvent être gérées par programme à l’aide des techniques standard de création, d’extraction et de mise à jour d’enregistrements. Les ressources web textuelles (JScript, CSS, XML, XSL, RESX et HTML) peuvent être modifiées et enregistrées dans l’application.

Limites des ressources web

Aucun type de ressource web ne prend en charge les fonctionnalités d’une page ASP.NET (.aspx) pour exécuter du code sur le serveur. Les ressources web sont limitées aux fichiers statiques ou aux fichiers traités dans le navigateur. Une ressource web peut contenir du code traité dans le navigateur pour exécuter des appels de service web afin d’interagir avec les données Dynamics 365 Customer Engagement (on-premises). Pour plus d’informations, voir Utiliser des données Customer Engagement à l’aide de ressources web.

Les ressources web sont uniquement disponibles lorsque le contexte de sécurité d’application web de Dynamics 365 Customer Engagement (on-premises) est utilisé. Seuls les utilisateurs des applications Dynamics 365 Customer Engagement (on-premises) autorisés disposant des privilèges nécessaires peuvent y accéder.

Limites de taille

La taille maximale des fichiers pouvant être chargée est déterminée par la propriété Organization.MaxUploadFileSize. Cette propriété est définie sous l’onglet Courrier électronique des Paramètres système de l’application Dynamics 365. Ce paramètre limite la taille des fichiers pouvant être joints à des messages électroniques, des notes et des ressources web. Le paramètre par défaut est 5 Mo.

Types de ressource web

Vous pouvez utiliser dix formats de fichier pour créer des ressources web. Le tableau suivant répertorie chaque format de fichier, les extensions de fichier autorisées, ainsi que la valeur de type utilisée pour chacun.

Fichier	Extensions de fichier	Type
Page web (HTML)	.htm, .html	1
Feuille de style (CSS)	.css	2
Script (JScript)	.js	3
Données (XML)	.xml	4
Image (PNG)	.png	5
Image (JPG)	.jpg	6
Image (GIF)	.gif	7
Silverlight (XAP)	.xap	8
Feuille de style (XSL)	.xsl, .xslt	9
Image (ICO)	.ico	10
Format vectoriel (SVG)	.svg	11
Chaîne (RESX)	.resx	12

Référencer des ressources web

Vous pouvez utiliser plusieurs méthodes pour référencer des ressources web.

Note

• Dans la mesure du possible, utilisez la directive $webresource. Seules les références utilisant la directive $webresource dans le plan du site ou dans les commandes du ruban établiront les dépendances. Les dépendances ne sont pas créées lorsque les ressources Web font référence les unes aux autres.
  • Pour afficher une ressource Web Silverlight en dehors d’un formulaire ou graphique d’entité, créez une ressource Web HTML pour qu’elle soit la page hôte de la ressource web Silverlight. Utilisez ensuite la directive $webresource: pour ouvrir la ressource Web HTML.

Directive $webresource

Vous devez toujours utiliser la directive $webresource lorsque vous référencez une ressource Web à partir d’un contrôle de ruban ou d’une zone secondaire d’un SiteMap. Utilisez la directive $webresource partout où le XML autorise une valeur URL. L’exemple suivant montre comment l’utiliser.

$webresource:<name of Web Resource>  

Note

Lorsque vous utilisez la directive $webresource, Dynamics 365 Customer Engagement (on-premises) crée ou met à jour les dépendances de solution.

Xrm.Navigation.openwebResource

La fonction Xrm.Navigation.openWebResource ouvre une ressource web HTML dans une nouvelle fenêtre, avec des paramètres permettant de passer le nom de la ressource web, toutes les données de chaîne de requête à passer dans le paramètre de données, ainsi que les informations sur la hauteur et la largeur de la fenêtre.

L’URL générée intègre le jeton GUID unique afin que la ressource web mise en cache soit chargée.

URL relative

Lorsque vous référencez une ressource web à partir de zones qui ne prennent pas en charge l’utilisation de la directive $webresource:, une URL relative peut être utilisée. Pour activer cette fonctionnalité, nous vous recommandons d’utiliser une convention d’affectation de noms cohérente pour les ressources web qui reflètent une structure de fichier virtuelle. Le préfixe de personnalisation de l’éditeur de solutions est toujours ajouté au nom en tant que préfixe lorsque la ressource web est créée. Cela peut représenter un dossier « racine » virtuel pour toutes les ressources web ajoutées à cet éditeur. Vous pouvez ensuite utiliser une barre oblique (/) pour simuler une structure de dossiers qui sera utilisée par le serveur web.

À partir d’une autre ressource web, vous devez toujours utiliser des URL relatives qui se référenceront mutuellement. Par exemple, pour que la ressource web de page web new_/content/contentpage.htm référence la ressource web CSS new_/Styles/styles.css, créez le lien comme suit :

<link rel="stylesheet" type="text/css" href="../styles/styles.css" />  

Par exemple, pour que la ressource web de page web new_/content/contentpage.htm ouvre la ressource web de page web isv_/foldername/dialogpage.htm, créez le lien comme suit :

<a href="../../isv_/foldername/dialogpage.htm">Dialog Page</a>  

Note

N’utilisez pas d’URL relative en utilisant le dossier WebResources comme chemin d’accès racine de l’URL. Par exemple, n’utilisez pas ceci : /WebResources/<name of web resource>. Lorsqu’un utilisateur appartient à plusieurs organisations sur un serveur, ce chemin d’accès fera toujours référence à l’organisation par défaut de l’utilisateur. Si l’utilisateur n’utilise pas son organisation par défaut et que la ressource web attendue ne fait pas partie de l’organisation par défaut de l’utilisateur, une erreur « Fichier introuvable » se produit, même si la ressource web fait partie de l’organisation dans laquelle l’utilisateur travaille actuellement.

URL complet

L’exemple suivant illustre le style d’URL que vous pouvez utiliser pour afficher les ressources web.

<Microsoft CRM URL>/WebResources/<name of web resource>  

L’application traitera cette URL et renverra le fichier qui contient la version la plus récente de la ressource web. Cette URL ressemblera à ceci :

<Microsoft CRM URL>/%7B<version value>%7D/WebResources/<name of web resource>  

La valeur de la version est mise à jour lorsque vous publiez des personnalisations. Elle garantit que le navigateur utilise la dernière version mise en cache de la ressource web. Pour cette raison, utilisez un chemin d’accès relatif à une ressource web, la fonction Xrm.Navigation.openWebResource ou $webresource Directive (lorsque cela est possible), car la valeur de version sera automatiquement incluse. Pour les ressources web volumineuses, les implications de performances peuvent être importantes si vous n’utilisez pas la version mise en cache du fichier.

L’exemple suivant illustre une URL pour Dynamics 365 for Customer Engagement, où MyOrganization est le nom de votre organisation et new_/test/test.htm le nom de la ressource web :

https://MyOrganization.crm.dynamics.com/WebResources/new_/test/test.htm  

Note

Il est vivement conseillé d’inclure le caractère « / » et une extension de nom de fichier au nom de la ressource web.

Cet exemple illustre une URL pour Dynamics 365 Customer Engagement (on-premises) local, où myServer est le nom du serveur :

https://myServer/MyOrganization/WebResources/new_/test/test.htm  

Lorsque vous écrivez du code pour référencer une ressource Web qui devra fonctionner pour Dynamics 365 for Customer Engagement ou Dynamics 365 Customer Engagement (on-premises) local, vous devez utiliser la fonction getClientUrl.

Outils de la communauté

Gestionnaire de ressources Web est un outil que la communauté XrmToolbox a développé pour Dynamics 365 Customer Engagement (on-premises). Consultez la rubrique Outils de développement pour obtenir des outils développés par la communauté.

Note

Les outils de la communauté ne sont pas un produit de Microsoft Dynamics et n’étendent pas le support aux outils de la communauté. Si vous avez des questions relatives à cet outil, contactez l’éditeur. Pour plus d’informations : XrmToolBox.

Voir aussi

Écrire des extensions d’application cliente pour Dynamics 365 Customer Engagement
Créer des ressources web accessibles
Ressources web de page web (HTML)
Ressources web (XAP) Silverlight
Ressources web de script (JScript)
Ressources web d’image
Ressources web de feuille de style (XSL)
Ressources web de données (XML)
Ressources web de feuille de style (CSS)
Messages et méthodes pour les ressources web
Exemple : Transmettre plusieurs valeurs à une ressource web via le paramètre de données
Exemple : utilitaire de ressources web
Exemple : Importer des fichiers en tant que ressources web
Utiliser des données de service WEB dans des ressources web
Rationaliser le développement de ressources web à l’aide de Fiddler AutoResponder