Partager via

Ressources Web Webpage (HTML)

  • Article

 

Date de publication : janvier 2017

S’applique à : Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Utilisez les ressources Web de la page Web (HTML) pour créer des éléments d’interface utilisateur pour des extensions clientes.

Contenu de la rubrique

Fonctionnalités des ressources web HTML

Limites des ressources web HTML

Utilisez l’éditeur de texte pour les ressources Web HTML

Empêcher la modification des ressources Web pour les solutions gérées

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

Transmettre les paramètres aux ressources Web HTML

Fonctionnalités des ressources web HTML

Comme une ressource Web HTML est juste diffusée en continu sur le navigateur de l’utilisateur, elle peut comporter un contenu qui s’affiche dans le navigateur de l’utilisateur.

Limites des ressources web HTML

  • Une ressource Web HTML ne peut contenir aucun code qui doit être exécuté sur le serveur. Les pagesASP.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.Pour plus d'informations :Transmettre les paramètres aux ressources Web HTML

Utilisez l’éditeur de texte pour les ressources Web HTML

L’éditeur de texte fourni dans le formulaire de ressource Web est conçu pour simplifier la modification HTML. Pour les documents HTML 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" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<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 va être modifié.

<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é pour le HTML dans les ressources Web à être modifié à l’aide de l’éditeur de texte, il est recommandé d’utiliser les propriétés gérées pour déterminer 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 de Microsoft Dynamics 365 qui utilise 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, vous verrez que la ressource Web HTML conservera des liens à CSS, XML, JScript, aux images et aux fichiers Silverlight qui ont été 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.htm

  • new_/Styles/style.css

  • new_/Scripts/script.js

Si vous suivez ce modèle, votre ressource Web HTMLnew_/page.htm pourra référencer les 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 seront pas modifiés.

Notes

  • 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.Page ou Xrm.Utility dans le formulaire à l'aide de parent.Xrm.Page ou de 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 toutes les bibliothèques dont une ressource Web HTML a besoin dans la ressource Web HTML de sorte qu'elles ne dépendent pas des scripts pas 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 Microsoft Dynamics 365 pour 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 l'entité

Nom de l'entité.

type

Code de type d’entité

Entier qui identifie de manière unique l’entité 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 passée.

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 entité. Une fois activée, l'URL de l'aide personnalisée contient une valeur « form » ou « hierarchychart ».Pour plus d'informations :Ajouter un contenu d'aide personnalisé

pagemode

Utilisation interne uniquement.

security

Utilisation interne uniquement.

tabSet

Utilisation interne uniquement.

Pour passer plusieurs valeurs dans le paramètre de données, vous devez encoder les paramètres dans la valeur du paramètre de données, puis inclure la logique pour décoder plusieurs paramètres dans le script de votre ressource Web HTML. La rubrique Exemple : Transmettre plusieurs valeurs à une ressource Web via le paramètre de données fournit une approche permettant d’adresser plusieurs valeurs de paramètre de transfert.

Voir aussi

Ressources Web pour Microsoft Dynamics 365
Créer des ressources Web accessibles
Ressources Web CSS
Ressources Web de script (JScript)
Ressources Web de données (XML)
Ressources Web image (JPG, PNG, GIF, ICO)
Ressources Web (XAP) Silverlight
Ressources Web de feuille de style (XSL)

Microsoft Dynamics 365

© 2017 Microsoft. Tous droits réservés. Copyright