Ressources web des applications basées sur un modèle

  • Article

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.

Notes

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 navigateur client 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 de l’intégration d’un formulaire dans un IFRAME imbriqué dans un autre formulaire n’est pas prise en charge. Nous recommandons l’utilisation de la forme en tant que composant pour de tels scénarios.

En général, l’utilisation du Power Apps component framework et des pages personnalisées est encouragé 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 à la disposition des utilisateurs de Dataverse pour 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.

É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 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.

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, 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, Dataverse 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>

Notes

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.

<Dataverse Environment 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 :

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

Notes

Il est vivement conseillé d’inclure le caractère « / » et une extension de nom de fichier au nom de la ressource web.
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 aura des hauteurs différentes dans une application Unified Client par rapport à une application client 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 la rubrique Outils de développement pour obtenir des outils développés par la communauté.

Notes

Les outils de la communauté ne sont pas un produit de Dataverse 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

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 AutoResponder

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).