Ressources Web pour Microsoft Dynamics 365

 

Date de publication : janvier 2017

S’applique à : Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

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

Contenu de la rubrique

Fonctionnalités des ressources Web

Types de ressource Web

Référencer des ressources Web

Fonctionnalités des ressources Web

Les ressources Web sont des fichiers permettant d’étendre l’application Web Microsoft Dynamics 365, par exemple les fichiers HTML, JavaScript, et les applications Silverlight. 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 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 Microsoft Dynamics 365.

Étant donné que les ressources Web sont stockées dans Microsoft Dynamics 365 et qu’il s’agit de composants de solution, elles peuvent être facilement exportées et installées dans des déploiements locaux de Microsoft Dynamics 365 ou de Microsoft Dynamics 365 (Online). Les ressources Web sont également à la disposition des utilisateurs de Microsoft Dynamics 365 pour Microsoft Office Outlook avec accès hors connexion 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, and 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 Microsoft Dynamics 365. Pour plus d’informations, voir Utiliser des données Dynamics 365 à l'aide de ressources Web.

Les ressources Web sont uniquement disponibles lorsque le contexte de sécurité d’application Web de Microsoft Dynamics 365 est utilisé. Seuls les utilisateurs Microsoft Dynamics 365 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

Référencer des ressources Web

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

Notes

• 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>

Notes

Lorsque vous utilisez la directive $webresource, Microsoft Dynamics 365 crée ou met à jour les dépendances de solution.

Xrm.Utility.openWebResource

La fonction Xrm.Utility.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 URLs 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 CSSnew_/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>

Notes

N’utilisez pas d’URL relative à l’aide du dossier WebResources comme chemin d’accès pour 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 complète

L’exemple suivant illustre le style de 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<GUID value>%7D/WebResources/<name of web resource>

La valeur GUID 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.Utility.openWebResource ou Directive $Webresource (lorsque cela est possible), car la valeur GUID sera automatiquement incluse. Pour les ressources Web volumineuses, telles que les ressources Web Silverlight, 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 Microsoft Dynamics 365 (Online), 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

Notes

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 Microsoft Dynamics 365 local, où myServer est le nom du serveur :

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

Lorsque vous écrivez du code pour référencer une ressource Web qui devra fonctionner pour Microsoft Dynamics 365 (Online) ou Microsoft Dynamics 365 local, vous devez utiliser la fonction getClientUrl.

Voir aussi

Étendre Microsoft Dynamics 365 sur le client
Bibliothèques JavaScript pour Microsoft Dynamics 365
Créer des ressources Web accessibles
Ressources Web Webpage (HTML)
Ressources Web (XAP) Silverlight
Ressources Web de script (JScript)
Ressources Web image (JPG, PNG, GIF, ICO)
Ressources Web de feuille de style (XSL)
Ressources Web de données (XML)
Ressources Web CSS
Messages et méthodes de l’entité WebResource
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 Dynamics 365 à l'aide de ressources Web

Microsoft Dynamics 365

© 2017 Microsoft. Tous droits réservés. Copyright