Partager via

Ressources web des applications pilotées par modèle

Les ressources web sont des fichiers virtuels que vous stockez dans la base de données Microsoft Dataverse et récupèrent à l’aide d’une adresse URL unique.

Note

Les ressources web et l’infrastructure de composants Power Apps ne prennent pas en charge le contenu IFRAMEing qui se trouve derrière une limite d’authentification. 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. Utilisez le formulaire comme composant pour ces scénarios.

En général, utilisez l’infrastructure de composants Power Apps et les pages personnalisées pour créer des intégrations externes configurables, réutilisables et plus étroites. Pour plus d’informations : Composant IFRAME

Fonctionnalités des ressources web

Les ressources web représentent des fichiers que vous pouvez utiliser pour étendre l’application web Dataverse, comme les fichiers HTML, JavaScript, CSS et plusieurs formats d’image. Vous pouvez utiliser des ressources web dans les personnalisations de formulaire, le ruban de l’application SiteMapou le ruban de l’application, car vous pouvez les référencer à l’aide de la syntaxe d’URL.

La syntaxe de l’URL pour les ressources web autorise les références de chemin relatif. En utilisant vos outils de développement, vous pouvez créer un groupe de fichiers interdépendants sur un serveur de développement à l’aide de types de fichiers compatibles avec les ressources web. Ensuite, si vous utilisez une convention d’affectation de noms cohérente et des références de chemin d’accès relatifs, le site web fonctionne après avoir chargé tous les fichiers dans Dataverse.

Étant donné que Dataverse stocke les ressources web et qu’elles sont des composants de solution, vous pouvez facilement les exporter et les installer vers d’autres organisations Dataverse. Les utilisateurs de Dataverse pour Microsoft Office Outlook avec Offline Access peuvent utiliser des ressources web lorsqu’ils sont hors connexion, car ils se synchronisent avec les données de l’utilisateur.

Utilisez l’éditeur de formulaire pour ajouter et configurer des ressources web prenant en charge le formulaire dans vos formulaires.

Étant donné que Dataverse stocke les ressources web en tant qu’enregistrements dans la base de données, vous pouvez les gérer par programmation à l’aide des techniques standard pour créer, récupérer et mettre à jour des enregistrements. Vous pouvez modifier et enregistrer des ressources web basées sur du texte (JScript, CSS, XML, XSL, RESX et HTML) 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 que le navigateur traite. Une ressource web peut contenir du code que le navigateur traite pour exécuter des appels de service web pour interagir avec les données Dataverse.

Vous ne pouvez accéder aux ressources web qu’à l’aide du contexte de sécurité de l’application web Dataverse. 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 que vous pouvez charger. Définissez cette propriété sous l’onglet Courrier électronique des paramètres système dans l’application Dynamics 365. Ce paramètre limite la taille des fichiers que vous pouvez joindre aux messages électroniques, aux notes et aux ressources web. Le paramètre par défaut est 5 Mo. Pour plus d’informations, consultez 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.

File 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

Référencez les ressources web à l’aide de plusieurs méthodes.

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

Utilisez toujours la $webresource directive lors du référencement d’une ressource web à partir d’un contrôle de ruban ou d’une SiteMap sous-zone. 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 solution.

Xrm.Navigation.openWebResource

La fonction Xrm.Navigation.openWebResource ouvre une ressource web HTML dans une nouvelle fenêtre avec des paramètres pour transmettre le nom de la ressource web, toutes les données de chaîne de requête à transmettre dans le paramètre de données et des 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 approche, utilisez une convention d’affectation de noms cohérente pour les ressources web qui reflètent une structure de fichiers virtuels. Incluez le préfixe de personnalisation de l’éditeur de solution comme préfixe du nom de la ressource web. Ce préfixe peut représenter un dossier « racine » virtuel pour toutes les ressources web ajoutées par cet éditeur. Utilisez le caractère de barre oblique (/) pour simuler une structure de dossiers que le serveur web respecte.

À partir d'une autre ressource web, utilisez toujours des URL relatives pour se référer entre elles. 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 qui utilise le WebResources dossier comme chemin d’accès racine pour l’URL. Par exemple, n’utilisez pas : /WebResources/<name of web resource>. Lorsqu’un utilisateur appartient à plusieurs organisations sur un serveur, ce chemin 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 retourne le fichier qui contient la dernière version de la ressource web. Cette URL ressemble à ceci :

<Dataverse Environment URL>/%7B<version value>%7D/WebResources/<name of web resource>

La valeur de version est mise à jour lorsque vous publiez des personnalisations et 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, la non-utilisation de la version mise en cache du fichier peut avoir des implications significatives sur les performances.

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, utilisez 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. Cette différence existe, car il existe une différence dans la hauteur d’une ligne entre l’interface unifiée 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é

WebResources Manager est un outil que la communauté XrmToolbox a développée 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 ne prennent pas en charge les outils de la communauté. Si vous avez des questions sur l’outil, contactez l’éditeur. Pour plus d’informations, consultez 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

  • Last updated on