Ressources web des applications basées sur un modèle
Les ressources web sont des fichiers virtuels qui sont stockés dans la base de données Microsoft Dataverse et que vous pouvez récupérer en utilisant une adresse URL unique.
Note
Le contenu IFRAME qui se trouve derrière une limite d’authentification n’est pas pris en charge via les ressources web ou Power Apps component framework. Certains IFRAME intégrés peuvent fonctionner dans un client de navigateur si l’utilisateur se connecte directement au service externe, mais cela n’est pas pris en charge dans les applications mobiles ou pour tablettes. Le scénario spécifique d’intégration d’un formulaire dans un IFRAME intégré dans un autre formulaire n’est pas pris en charge. Nous recommandons l’utilisation de la forme en tant que composant pour de tels scénarios.
En général, l’utilisation de Power Apps component framework et des pages personnalisées est encouragée pour créer des intégrations externes configurables, réutilisables et plus strictes. Pour plus d’informations : Composant IFRAME
Fonctionnalités des ressources web
Les ressources web sont des fichiers permettant d’étendre l’application web Dataverse, 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 Dataverse.
Étant donné que les ressources web sont stockées dans Dataverse et qu’il s’agit de composants de solution, elles peuvent être facilement exportées et installées dans d’autres organisations Dataverse. Les ressources web sont également disponibles pour les utilisateurs de Dataverse pour Microsoft Office Outlook avec accès hors connexion lorsqu’elles sont 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.
É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 Dataverse.
Les ressources web sont uniquement disponibles lorsque le contexte de sécurité d’application web de Dataverse est utilisé. Seuls les utilisateurs des applications Dataverse autorisés disposant des privilèges nécessaires peuvent y accéder.
Limites de taille
La propriété Organization.MaxUploadFileSize détermine la taille maximale des fichiers pouvant être chargés. 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. En savoir plus sur les paramètres d’environnement et les limites de taille de fichier
Types de ressource web
Vous pouvez utiliser 10 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 de site ou dans les commandes du ruban établissent des dépendances. Les dépendances ne sont pas créées lorsque les ressources web se font référence mutuellement.
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, Dataverse crée ou met à jour les dépendances de la solution.
Xrm.Navigation.openwebResource
La fonction Xrm.Navigation.openwebResource ouvre une ressource web HTML dans une nouvelle fenêtre, avec les paramètres pour transmettre le nom de la ressource web, les données de chaîne de requête à transmettre 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 inclut le jeton GUID unique permettant de charger la ressource web mise en cache.
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:, utilisez une URL relative.
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 inclus comme préfixe au nom de la ressource web.
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 est 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 avec le dossier WebResources comme chemin d’accès racine de l’URL.
Par exemple, n’utilisez pas : /WebResources/<name of web resource>. Lorsqu’un utilisateur appartient à plusieurs organisations sur un serveur, ce chemin d’accès fait 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.
<Dataverse Environment URL>/WebResources/<name of web resource>
L’application traite cette URL et renvoie le fichier contenant la version la plus récente de la ressource web. Cette URL ressemble à ceci :
<Dataverse Environment 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 la directive $webresource (lorsque cela est possible), car la valeur de la version est 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 Dataverse, où MyOrganization est le nom de votre environnement Dataverse et new_/test/test.htm est le nom de la ressource web :
https://MyOrganization.crm.dynamics.com/WebResources/new_/test/test.htm
Note
L’inclusion du caractère « / » et d’une extension de nom de fichier au nom de la ressource web est une pratique recommandée facultative. Lorsque vous écrivez du code pour référencer une ressource web qui fonctionne pour Dataverse, vous devez utiliser la fonction getClientUrl.
Différences de disposition entre le client web hérité et Unified Interface
Un contrôle de ressource web configuré pour utiliser un certain nombre de lignes a des hauteurs différentes dans une application cliente unifiée par rapport à une application cliente web. En effet, il existe une différence de hauteur de ligne entre Unified Interface et le client web. Si un formulaire est nécessaire à la fois dans le client web et dans Unified Interface, vous pouvez utiliser différents formulaires dans l’application Unified Interface et l’application client web avec le contrôle configuré pour utiliser le nombre approprié de lignes dans chaque formulaire.
Outils de la communauté
Gestionnaire de ressources web est un outil que la communauté XrmToolbox a développé pour Dataverse. Consultez l’article Outils pour développeur pour obtenir des informations sur les outils développés par la communauté.
Note
Les outils de la communauté ne sont pas un produit de Dataverse et Microsoft n′étend 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
Créer des ressources web accessibles
Ressources web de page web (HTML)
Ressources web JavaScript
Ressources web d’images
Ressources web de feuille de style (XSL)
Ressources web de données (XML)
Ressources web de feuille de style (CSS)
Référence de table de ressource web
Exemple : Transmettre plusieurs valeurs à une ressource web via le paramètre de données
Exemple : Importer des fichiers en tant que ressources web
Rationaliser le développement de ressources web à l’aide de Fiddler Auto-Responder