Tilføj brugerdefineret Hjælp-indhold

 

Udgivet: november 2016

Gælder for: Dynamics CRM 2015

Med Microsoft Dynamics CRM 2015 og opdatering til Microsoft Dynamics CRM Online 2015 kan administratorer konfigurere, hvilken side med Hjælp-indhold, der vises i hele organisationen eller for bestemte objekter. Organisationer, som har et yderst tilpasset system, især dem, der bruger brugerdefinerede objekter, vil opdage, at programmets Hjælp-indhold muligvis har begrænset anvendelighed. Administratorer kan konfigurere systemet, så det tilsidesætter standard-Hjælp-indhold, ved at angive, at en URL skal åbnes i stedet. Siden åbnes muligvis som en en statisk side på et SharePoint-websted, en webside på internettet eller et brugerdefineret Hjælp-program, der oprettes vha. webressourcer og leveres med en løsning.

Udviklere har brug at forstå de tilgængelige muligheder og hvilke kontekstuelle oplysninger som kan videregives med URL, så de kan oprette sider for at få vist relevant indhold. Du kan også finde flere oplysninger i emnet Tilpas dit CRM-system: Tilpasse Hjælp-oplevelsen.

Dette emne indeholder

Brugerdefinerede hjælp-indstillinger

Kontekstafhængige parametre for forespørgselsstreng

Bruge webressourcer til at levere Hjælp-indhold

Brugerdefinerede hjælp-indstillinger

Brugerdefineret hjælpefunktion afhænger af data, der er gemt i objektet Organization, samt EntityMetadata-definitionerne for hvert objekt, som beskrevet i følgende tabel.

System- eller objektindstilling	Data	Skriv	Beskrivelse
Systemindstilling: Brug brugerdefineret hjælp for objekter, der kan tilpasses	Organization.GlobalHelpUrlEnabled	Boolesk	Angiver, om brugerdefineret hjælp er aktiveret for organisationen.
Systemindstilling: URL-adresse til global hjælp	Organization.GlobalHelpUrl	Streng	URL-adresse til global hjælp for organisationen.
Systemindstilling: Føj parametre til URL-adresse	Organization.GlobalAppendUrlParametersEnabled	Boolesk	Angiver, om parametre for forespørgselsstrengen med kontekstafhængige oplysninger føjes til hjælp til URL.Flere oplysninger:Kontekstafhængige parametre for forespørgselsstreng
Objektindstilling: Brug brugerdefineret hjælp	EntityMetadata.EntityHelpUrlEnabled	Boolesk	Angiver, om brugerdefineret hjælp er aktiveret for objektet.
Objektindstilling: URL-adresse til Hjælp	EntityMetadata.EntityHelpUrl	Streng	Brugerdefineret Hjælp-side til at vise for dette objekt.

Den kombination af indstillinger, der anvendes, styrer, hvilket Hjælp-emne der vises. Mulighederne er beskrevet i den følgende tabel.

Organization.GlobalHelpUrlEnabled	Organization.GlobalHelpUrl	EntityMetadata.EntityHelpUrlEnabled	EntityMetadata.EntityHelpUrl	Funktionsmåde
false	I/T	I/T	I/T	Standard-Hjælp-siden åbnes
sand	Nej	false	I/T	Standard-Hjælp-siden åbnes
sand	Nej	sand	Nej	Standard-Hjælp-siden åbnes
sand	Nej	sand	Ja	Hjælp-siden for objektet åbnes
sand	Ja	sand	Ja	Hjælp-siden for objektet åbnes
sand	Ja	sand	Nej	Den globale URL-side åbnes.
sand	Ja	false	I/T	Den globale URL-side åbnes.

Bemærk

Når global hjælp er aktiveret, vises den brugerdefinerede side, hver gang en hjælp-knap i programmet anvendes, herunder sider, der ikke er relateret til et område, der kan tilpasses af programmet. Da dette skjuler indhold, der kan være værdifuldt for administratorer, skal brugerdefineret hjælp generelt anvendes pr. objekt.

Kontekstafhængige parametre for forespørgselsstreng

Hvis Organization.GlobalAppendUrlParametersEnabled er true, kan følgende værdier for parametre for forespørgselsstrenge føjes til den brugerdefinerede Hjælp URL.

Parameter	Beskrivelse
entrypoint	Den type side, som hjælpen blev åbnet fra. Mulige værdier er form og hierarchychart. Denne parameter er ikke inkluderet, hvis hjælpen åbnes fra en listevisning.
formid	GUID-værdien for den formular eller det hierarkidiagram, som hjælpen blev åbnet fra.
typename	Det logiske navn på det objekt, som hjælpen blev åbnet fra.
userlcid	Sprogkode-id, der bruges af den aktuelle bruger.Du kan finde gyldige landestandard-id'er på Oversigt over landestandard-id'er.

Adgang til forespørgselsstrengværdier

Følgende HTML er et eksempel, der viser, hvordan du kan få adgang til disse forespørgselsstrengværdier ved hjælp af JavaScript. Denne side viser en tabel, der angiver værdierne for disse parametre, hvis de overføres.

<!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>

Bruge webressourcer til at levere Hjælp-indhold

Brug af HTML-webressourcer som Hjælp-indhold har den fordel, at de kan indgå sammen i en løsning for ethvert brugerdefineret objekt, som de beskriver. Det er også muligt at bruge JavaScript på disse sider til at få adgang til Dynamics 365-data og -metadata for at levere dynamisk indhold, der kan afspejle de aktuelle felter i en formular, eller for at få oplysninger om de rettigheder, der er tildelt til brugeren.

Felterne Organization.GlobalHelpUrl og EntityMetadata.EntityHelpUrl er simple strengværdier uden formatering, som kræver en gyldig protokol. Det giver mulighed for at anvende beskrivelser af en relativ sti til den URL, der repræsenterer en webressource, så referencen til webressourcen kan fungere uden at blive ændret, når en løsning bruges til at flytte Hjælp-indholdet fra én organisation til en anden. Der kan henvises til en specifik webressource ved hjælp af en relativ URL som f.eks.:

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

Vigtigt

Når en bruger tilhører mere end én organisation på en server, vil denne sti altid henvise til brugerens standardorganisation. Hvis brugeren ikke benytter standardorganisationen og den forventede webressource ikke er inkluderet i brugerens standardorganisation, opstår fejlen "Filen blev ikke fundet", selvom webressourcen forekommer i den organisation, som brugeren aktuelt arbejder i. Hvis der findes en webressource med det samme navn i standardorganisationen, vises webressourcen for den pågældende organisation og er muligvis ikke korrekte for den aktuelle organisation.

Hvis dette forårsager problemer for brugerne i organisationen, kan URL-værdierne for indstillingerne opdateres, så den grundlæggende organisations URL føjes til foran den relative URL for webressourcen i organisationen.

Se også

EntityMetadata
Tilpas dit CRM-system: Tilpas Hjælp-oplevelsen
Udviklervejledning til tilpasning til Microsoft Dynamics CRM 2015
Webressourcer til Microsoft Dynamics CRM 2015
Webressourcer for webside (HTML)

© 2017 Microsoft. Alle rettigheder forbeholdes. Ophavsret