Ressources web Webpage (HTML)
Utilisez les ressources Web de page Web (HTML) pour créer des éléments d’interface utilisateur pour des extensions clientes.
Fonctionnalités des ressources web HTML
Comme une ressource web HTML est diffusée en continu sur le navigateur de l’utilisateur, elle peut inclure tout contenu affiché sur le navigateur de l’utilisateur.
Limites des ressources web HTML
- Une ressource web HTML ne peut contenir aucun code devant être exécuté sur le serveur. Les pages ASP.NET ne peuvent pas être chargées en tant que ressources web HTML.
- Les ressources web HTML peuvent uniquement accepter un nombre limité de paramètres de chaîne de requête. Transmettre les paramètres aux ressources Web HTML
- Les ressources web HTML intégrées sous forme de contrôles dans un formulaire peuvent être rechargées par le runtime du formulaire pour des raisons de performances. Par exemple, le runtime du formulaire peut détruire et réinitialiser le contrôle lors de la navigation entre les onglets.
Utilisez l’éditeur de texte pour les ressources web HTML
L’éditeur de texte fourni dans le formulaire de ressources web est conçu pour être utilisé avec la modification HTML simple. Pour les documents HTML web plus sophistiqués, vous devez modifier le code dans un éditeur externe et utiliser le bouton Parcourir pour télécharger le contenu de votre fichier.
Par exemple, une page HTML plus complexe qui nécessite un script pour afficher le contenu de la page démarre comme dans l’exemple ci-après.
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<title></title>
<script src="Script/Script.js" type="text/javascript"></script>
<link href="CSS/Styles.css" rel="stylesheet" type="text/css" />
</head>
<body onload="SDK.ImportWebResources.showData()">
<div id="results" />
</body>
</html>
Une fois que le document est ouvert dans l’éditeur de texte et enregistré, le HTML sera modifié dans l’exemple suivant :
<HTML><HEAD><TITLE></TITLE>
<META charset=utf-8></HEAD>
<BODY contentEditable=true onload=SDK.ImportWebResources.showData()>
<SCRIPT type=text/javascript src="Script/Script.js"></SCRIPT>
<LINK rel=stylesheet type=text/css href="CSS/Styles.css">
<DIV id=results></DIV></BODY></HTML>
Empêcher la modification des ressources web pour les solutions gérées
En raison de la capacité du HTML des ressources web à être modifié à l’aide de l’éditeur de texte, utilisez les propriétés gérées pour définir les ressources web HTML complexes comme non personnalisables pour les solutions gérées. Lorsque vous affichez les ressources web dans la fenêtre de solutions, ouvrez la boîte de dialogue Propriétés gérées pour définir la propriété Personnalisable à false.
Référencer d’autres ressources Web à partir d’une ressource Web HTML
Vous pouvez créer un ensemble de fichiers associés à partir des applications pilotées par modèle qui utilisent l’un des types de fichier ressource Web. Si vous veillez toujours à utiliser les chemins d’accès relatifs et à importer chaque ressource web avec une convention d’affectation de noms qui reflète l’arborescence de votre site web, la ressource web HTML maintient des liens aux fichiers CSS, XML, JScript, image et Silverlight importés en tant que ressources web.
Par exemple, si vous créez un projet d’application web qui utilise la structure [dossier]/fichier suivante :
page.htm
[Styles]
- style.css
[Scripts]
- script.js
Lorsque vous importez ces fichiers en tant que ressources web, vous pouvez désigner l’emplacement du préfixe de personnalisation de l’éditeur de solutions comme étant « nouveau » de la façon suivante :
new_/page.htmnew_/Styles/style.cssnew_/Scripts/script.js
Si vous suivez ce modèle, votre ressource web HTML new_/page.htm pourra faire référence aux autres fichiers de la manière la plus courante à l’aide des chemins d’accès relatifs comme illustré dans l’exemple suivant.
<script src="Scripts/script.js" type="text/javascript"></script>
<link href="Styles/style.css" rel="stylesheet" type="text/css" />
Le préfixe de personnalisation de l’éditeur de solutions devient un dossier racine virtuel pour toutes les ressources web de votre solution. Si vous modifiez le préfixe de personnalisation, les chemins d’accès relatifs dans vos ressources web HTML ne sont pas modifiés.
Note
- Une ressource web HTML ajoutée à un formulaire ne peut pas utiliser les objets globaux définis par la bibliothèque JavaScript chargée dans le formulaire. Une ressource web HTML peut interagir avec les objets
Xrm.PageouXrm.Utilitydans le formulaire à l’aide deparent.Xrm.Pageou deparent.Xrm.Utility, mais les objets globaux définis par les scripts de formulaire ne sont pas accessibles à l’aide du parent. Vous devez charger dans la ressource web HTML toutes les bibliothèques dont elle a besoin, de sorte qu’elle ne dépende pas des scripts chargés dans le formulaire. - Les références incluses dans le code entre les ressources web ne sont pas suivies en tant que dépendances de solution.
Comme les ressources web sont également téléchargées pour les utilisateurs de Dynamics 365 for Microsoft Office Outlook avec accès hors connexion, ces derniers ont accès au contenu des ressources web lorsqu’ils travaillent hors connexion.
Transmettre les paramètres aux ressources web HTML
Une ressource web HTML peut accepter uniquement les paramètres du tableau suivant.
| Paramètre | Nom | Description |
|---|---|---|
typename |
Nom de table | Nom de la table. |
type |
Code de type de table | Entier qui identifie de manière unique la table dans une organisation spécifique. |
id |
GUID de l’objet | GUID qui représente un enregistrement. |
orgname |
Nom de l’organisation | Nom unique de l’organisation. |
userlcid |
Code de langue de l’utilisateur | Identificateur du code de langue utilisé par l’utilisateur actuel. |
orglcid |
Code de langue de l’organisation | Identificateur du code de langue représentant la langue de base de l’organisation. |
data |
Paramètre de données facultatif | Valeur facultative pouvant être transmise. |
formid |
ID de formulaire | GUID qui représente un ID de formulaire. |
entrypoint |
Point d’entrée | Valeur de chaîne. Ce paramètre est conçu pour être transmis en guise de valeur facultative aux ressources web ouvertes en tant que contenu de l’aide personnalisée pour une table. Une fois activée, l’URL de l’aide personnalisée contient une valeur form ou hierarchychart. |
pagemode |
Réservé exclusivement à un usage interne. | |
security |
Réservé exclusivement à un usage interne. | |
tabSet |
Réservé exclusivement à un usage interne. |
Si plusieurs valeurs sont transférées dans le paramètre de données, elles sont automatiquement codées. La logique doit également être intégrée pour décoder les paramètres multiples en utilisant le script de votre ressource Web HTML. L’article Exemple : Transmettre plusieurs valeurs à une ressource web via le paramètre de données montre une manière de réaliser la transmission de plusieurs valeurs de paramètre.
Note
Tous les caractères inclus dans la chaîne de requête passent par la validation pour garantir la validité des paramètres passés. Si certains paramètres ne sont pas valides, la requête échouera. Par exemple, la transmission de valeurs de texte entre crochets angulaires est considérée comme un type de paramètre non valide.
Voir aussi
Ressources Web
Créer des ressources web accessibles
Utilisation des ressources web de feuille de style (CSS)
Utilisation des ressources web JavaScript
Utilisation des ressources web de données (XML)
Utilisation des ressources web d’image (JPG, PNG, GIF)
Utilisation de ressources web de feuille de style (XSL)