Ressources Web pour Microsoft Dynamics CRM 2015
Date de publication : novembre 2016
S’applique à : Dynamics CRM 2015
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, JScript, 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 CRM Online. Les ressources Web sont également à la disposition des utilisateurs de Microsoft Dynamics CRM 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 du service Web dans les ressources Web (point de terminaison OData et SOAP d’applications modernes).
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 CRM. 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 CRM 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 CRM Online ou Microsoft Dynamics 365 local, vous devez utiliser la fonction d7d0b052-abca-4f81-9b86-0b9dc5e62a66#BKMK_getClientUrl.
Voir aussi
Écrire des extensions d’application cliente
Bibliothèques JavaScript pour Microsoft Dynamics CRM 2015
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 du service Web dans les ressources Web (point de terminaison OData et SOAP d’applications modernes)
© 2017 Microsoft. Tous droits réservés. Copyright