Partager via


Ajouter un contenu d'aide personnalisé

 

Date de publication : janvier 2017

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

Avec Microsoft Dynamics 365 (Online et local), les administrateurs peuvent configurer quelles pages de contenu de l'aide apparaissent dans toute l'organisation ou pour certaines entités. Les organisations qui ont un système hautement personnalisé, notamment celles qui utilisent les entités personnalisées, constateront que le contenu d'aide de l'application peut ne pas correspondre aux besoins de leurs utilisateurs. Les administrateurs peuvent configurer le système pour remplacer le contenu d'aide par défaut en spécifiant une URL à ouvrir à la place. La page à ouvrir peut être une page statique sur un site SharePoint, une page Web sur Internet ou une application d'aide personnalisée créée à l'aide des ressources Web et intégrée à une solution.

Les développeurs doivent maîtriser les options disponibles et savoir quelles informations contextuelles peuvent être transmises avec l'URL afin de pouvoir créer des pages et afficher le contenu approprié. Vous pouvez également obtenir des informations supplémentaires dans la rubrique Personnalisation de votre système CRM : Personnalisation de l'expérience de l'aide.

Contenu de la rubrique

Options d'aide personnalisées

Paramètres de chaîne de requête contextuelle

Utilisation des ressources Web pour fournir le contenu de l'aide

Options d'aide personnalisées

Le comportement de l'aide personnalisée dépend des données stockées dans l'entité Organization et des définitions de EntityMetadata pour chaque entité, comme le décrit le tableau suivant.

Paramètre système ou d'entité

Données

Type

Description

Paramètre système : Utilisation de l'aide personnalisée pour les entités personnalisables

Organization.GlobalHelpUrlEnabled

Booléen

Indique si l'aide personnalisée est activée pour l'organisation.

Paramètre système : URL d'aide personnalisée globale

Organization.GlobalHelpUrl

Chaîne

URL pour l'aide globale de l'organisation.

Paramètre système : Ajout de paramètres à l'URL

Organization.GlobalAppendUrlParametersEnabled

Booléen

Indique si les paramètres de chaîne de requête avec les informations de contexte sont ajoutés à l'URL de l'aide.Pour plus d'informations :Paramètres de chaîne de requête contextuelle

Paramètre d'entité : Utilisation de l'aide personnalisée

EntityMetadata.EntityHelpUrlEnabled

Booléen

Indique si l'aide personnalisée est activée pour l'entité.

Paramètre d'entité : URL d'aide

EntityMetadata.EntityHelpUrl

Chaîne

Page d'aide personnalisée à afficher pour cette entité.

La combinaison de paramètres appliqués contrôle quelle rubrique d'aide s'affiche. Les options sont décrites dans le tableau suivant.

Organization.GlobalHelpUrlEnabled

Organization.GlobalHelpUrl

EntityMetadata.EntityHelpUrlEnabled

EntityMetadata.EntityHelpUrl

Comportement

false

N/D

N/D

N/D

La page d'aide par défaut s'ouvre

vrai

Non

false

N/D

La page d'aide par défaut s'ouvre

vrai

Non

vrai

Non

La page d'aide par défaut s'ouvre

vrai

Non

vrai

Oui

La page d'aide d'entité s'ouvre

vrai

Oui

vrai

Oui

La page d'aide d'entité s'ouvre

vrai

Oui

vrai

Non

La page d'URL globale s'ouvre

vrai

Oui

false

N/D

La page d'URL globale s'ouvre

Notes

Lorsque l'aide globale est activée, la page personnalisée s'affiche lorsque n'importe quel bouton d'aide de l'application est utilisé, y compris les pages qui ne sont pas associées à une zone personnalisable de l'application. Du fait que cette opération masque le contenu susceptible d'être utile aux administrateurs, l'aide personnalisée doit généralement être appliquée entité par entité.

Paramètres de chaîne de requête contextuelle

Lorsque Organization.GlobalAppendUrlParametersEnabled est true, les valeurs suivantes de paramètre de chaîne de requête peuvent être ajoutées à l'URL d'aide personnalisée.

Paramètre

Description

entrypoint

Type de page à partir duquel l'aide a été ouverte. Les valeurs possibles sont form et hierarchychart. Ce paramètre n'est pas inclus si l'aide est ouverte à partir d'une vue sous forme de liste.

formid

Valeur GUID du graphique de formulaire ou de hiérarchie à partir duquel l'aide a été ouverte.

typename

Nom logique de l'entité à partir de laquelle le contenu de l'aide a été ouvert.

userlcid

Identificateur du code langue utilisé par l’utilisateur actuel.Les valeurs d'ID de paramètres régionaux valides sont disponibles sur la page Tableau des ID de paramètres régionaux (LCID).

Accès aux valeurs de chaîne de requête

Le fichier HTML suivant fournit un exemple illustrant sur la manière d'accéder à ces valeurs de chaîne de requête avec JavaScript. Cette page affiche un tableau indiquant les valeurs de ces paramètres si elles sont transmises.

<!DOCTYPE html>
<html>
<head>
 <title>Help topic</title>
 <style>
  body {
   font-family: 'Segoe UI';
  }
 </style>
 <script type="text/javascript">
  function getQueryStringParameter(parameter) {
   /// <summary>Parses query string values passed to the page and returns the value for the requested parameter or 'null'</summary>
   /// <param name="parameter" type="String">The parameter value to look for</param>
   /// <returns type="String" />
   var query = window.location.search.substring(1); 
   var params = query.split("&");
   for (var i = 0; i < params.length; i++) {
    var pair = params[i].split("=");
    if (pair[0] == parameter) {
     return pair[1];
    }
   }
   return "null";
  }


  document.onreadystatechange = function () {
   if (document.readyState == "complete") {

    var entrypointValue = getQueryStringParameter("entrypoint");
    var formidValue = getQueryStringParameter("formid");
    var typenameValue = getQueryStringParameter("typename");
    var userlcidValue = getQueryStringParameter("userlcid");

    if ((document.documentMode) && (document.documentMode <= 8))
    {
     //If page is being displayed in IE Compatibility mode
     document.getElementById("entrypointValue").innerText = entrypointValue;
     document.getElementById("formidValue").innerText = formidValue;
     document.getElementById("typenameValue").innerText = typenameValue;
     document.getElementById("userlcidValue").innerText = userlcidValue;
    }
    else
    {
     document.getElementById("entrypointValue").textContent = entrypointValue;
     document.getElementById("formidValue").textContent = formidValue;
     document.getElementById("typenameValue").textContent = typenameValue;
     document.getElementById("userlcidValue").textContent = userlcidValue;
    }


   }
  }

 </script>
</head>
<body>
 <p>This is a custom help topic that can accept query string parameters</p>
 <table>
  <thead><tr><th>Parameter</th><th>Value</th></tr></thead>
  <tbody>
   <tr><td>entrypoint</td><td id="entrypointValue">null</td></tr>
   <tr><td>formid</td><td id="formidValue">null</td></tr>
   <tr><td>typename</td><td id="typenameValue">null</td></tr>
   <tr><td>userlcid</td><td id="userlcidValue">null</td></tr>
  </tbody>
 </table>

</body>
</html>

Utilisation des ressources Web pour fournir le contenu de l'aide

L'utilisation des ressources Web HTML comme contenu de l'aide a pour avantage que celles-ci peuvent être incluses dans une solution pour toutes les entités personnalisées qu'elles décrivent. Il est également possible d'utiliser JavaScript dans ces pages pour accéder aux données et aux métadonnées de Dynamics 365 afin de fournir le contenu dynamique susceptible de refléter les champs existants dans un formulaire ou obtenir des informations sur les privilèges attribués à l'utilisateur.

Les champs Organization.GlobalHelpUrl et EntityMetadata.EntityHelpUrl sont des valeurs de chaîne simples sans qu'aucune mise en forme nécessite un protocole valide. Cela permet d'utiliser des descriptions de chemin d'accès relatif dans l'URL représentant une ressource Web de sorte que la référence à la ressource Web puisse fonctionner sans être modifiée lorsqu'une solution est utilisée pour déplacer le contenu de l'aide d'une organisation à l'autre. Une ressource Web spécifique peut être référencée avec une URL relative comme suit :

/WebResources/new_/help/content/account.htm

Important

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 l'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. Si une ressource Web portant le même nom existe dans l'organisation par défaut, la ressource Web pour cette organisation apparaît et peut ne pas être adaptée à l'organisation actuelle.

Si cela cause des problèmes pour les utilisateurs de l'organisation, les valeurs de l'URL concernant les paramètres peuvent être mises à jour afin d'ajouter l'URL de l'organisation de base au début de l'URL relative de la ressource Web dans l'organisation.

Voir aussi

EntityMetadata
Personnalisation de votre système CRM : Personnalisation de l'expérience de l'aide
Personnaliser les applications Microsoft Dynamics 365
Ressources Web pour Microsoft Dynamics 365
Ressources Web Webpage (HTML)

Microsoft Dynamics 365

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