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

Étant donné qu’une ressource web HTML est en flux vers le navigateur de l’utilisateur, elle peut inclure n’importe quel contenu rendu par le navigateur.

Limites des ressources web HTML

  • Une ressource web HTML ne peut pas contenir de code qui doit s’exécuter sur le serveur. Vous ne pouvez pas charger ASP.NET pages en tant que ressources web HTML.
  • Les ressources web HTML peuvent accepter uniquement un nombre limité de paramètres de chaîne de requête. Transmettre les paramètres aux ressources Web HTML
  • Le runtime de formulaire peut recharger les ressources web HTML incorporées en tant que contrôles dans un formulaire pour améliorer les 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 dans le formulaire de ressource web est conçu pour une modification HTML simple. Pour des documents HTML plus complexes, modifiez le code dans un éditeur externe et utilisez le bouton Parcourir pour charger 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>

Par exemple, une page HTML plus complexe qui nécessite un script pour afficher le contenu de la page commence comme l’exemple précédent. Après avoir ouvert le document dans l’éditeur de texte et l’enregistrer, le code HTML passe à 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

Étant donné que tout le monde peut modifier le code HTML dans les ressources web à l’aide de l’éditeur de texte, utilisez des propriétés gérées pour définir des ressources web HTML complexes comme non personnalisables pour les solutions managées. Lorsque vous affichez des ressources web dans la fenêtre solutions, ouvrez la boîte de dialogue Propriétés gérées pour définir la propriété falsepersonnalisable sur .

Référencer d’autres ressources Web à partir d’une ressource Web HTML

Vous pouvez créer un ensemble de fichiers associés en dehors des applications basées sur des modèles qui utilisent l’un des types de fichiers de ressources web. Si vous veillez à toujours utiliser des chemins relatifs et à importer chaque ressource web avec une convention d’affectation de noms cohérente qui reflète la structure de dossiers de votre site web, la ressource web HTML gère les liens vers des fichiers CSS, XML, JScript et image associés que vous importez en tant que ressources web.

Par exemple, si vous créez un projet d’application web qui utilise le dossier et la structure de fichiers suivants :

  • page.htm

  • [Styles]

    • style.css

  • [Scripts]

    • script.js

Lorsque vous importez ces fichiers en tant que ressources web, vous pouvez nommer l’emplacement où votre préfixe de personnalisation de l’éditeur de solution est new de la manière suivante :

  • new_/page.htm
  • new_/Styles/style.css
  • new_/Scripts/script.js

Lorsque vous suivez ce modèle, votre new_/page.htm ressource web HTML peut référencer les autres fichiers de la manière la plus courante en utilisant des chemins 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.Utility ou les Xrm.Page objets du formulaire à l’aide parent.Xrm.Page ou parent.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.

Les applications clientes qui prennent en charge le fonctionnement hors connexion peuvent télécharger des ressources web.

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 vous passez plusieurs valeurs dans le paramètre de données, elles sont automatiquement encodées. Vous devez inclure une logique pour décoder les plusieurs paramètres à l’aide d’un script dans 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 le processus de validation trouve des paramètres qui ne sont pas valides, la requête échoue. Par exemple, le passage de valeurs de texte entre crochets angulaires est 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)

  • Last updated on