Del via

Oprette automatiseret hjælp til din Unified Interface-app

  • Artikel

Du kan bruge brugerdefinerede Hjælp-ruder og styrede opgaver til at indbygge brugerdefinerede hjælpeoplevelser, som er skræddersyet til din organisation, i din Unified Interface-applikation. Benyt brugerdefinerede hjælperuder for at få tabel-, formular- og sprogspecifik hjælp og vejledning, der omfatter RTF-tekst, indholdslinks, billeder og videolinks.

Vigtigt

  • Brugerdefinerede hjælpruder erstatter den tidligere funktion til styret hjælp i læringsforløbet, der bruges med ældre webklientapps.
  • Brugerdefinerede hjælperuder fungerer ikke sammen med Unified Interface-apps, der kører på en mobilenhed, f.eks. Android- og iOS-tablets og smartphones.

Brugerdefinerede Hjælp-ruder og læringsforløb

Den nye implementering af automatiseret hjælp i brugerdefinerede hjælperuder adskiller sig fra den tidligere funktion til automatiseret hjælp i læringsforløb. Begge funktioner giver dig mulighed for at oprette brugerdefineret hjælp til din applikation. Brugerdefinerede Hjælp-ruder er dog optimeret til de mest almindelige hjælpescenarier.

Brugerdefinerede Hjælp-ruder indeholder følgende nøglefunktioner, der ikke er tilgængelige i læringsforløb:

  • RTF-tekst som fritekst, herunder opstilling med punkttegn og tal eller bogstaver.
  • Tydeligt sammenkædede coachmærker og hjælpebobler.
  • Flere indstillinger for videokilder, herunder private kilder.
  • Opbevaring af Hjælp-indhold i Microsoft Dataverse som en del af løsningen.

Brugerdefinerede Hjælp-ruder indeholder følgende nøglefunktioner, som er tilgængelige i læringsforløb:

  • Sekventielle hjælpebobler.
  • Hjælp-sider pr. rolle.
  • Hjælp-sider til formfaktor pr. enhed, f.eks. smartphones.

Forudsætninger

Hvis du vil bruge funktionen til brugerdefinerede hjælpruder, skal dit miljø bruge følgende:

Aktivere brugerdefinerede Hjælp-ruder til dit miljø

  1. Åbn en modelbaseret app, og vælg derefter Indstillinger Indstillinger på kommandolinjen. > Avancerede indstillinger.

  2. Gå til Indstillinger > System > Administration.

  3. Vælg Systemindstillinger på siden Administration.

  4. Vælg Ja for Aktivér brugerdefinerede Hjælp-ruder og styrede opgaver under Angiv URL-adresse til brugerdefineret hjælp under fanen Generelt, og vælg derefter OK.

    Aktivér brugerdefinerede Hjælp-ruder.

Vigtigt

  • Du kan aktivere brugerdefinerede Hjælp-ruder eller Hjælp, der kan tilpasses, men ikke begge dele på samme tid. Bekræft, at Brug brugerdefineret hjælp til tabeller, der kan tilpasses og Føj parametre til URL-adresse begge er indstillet til Nej.
  • Visse miljøer kræver måske, at du indstiller Aktivér læringsforløb til Ja.

Påkrævede rettigheder

  • Hvis appudviklere skal oprette hjælpruder, skal de have rettigheder til at oprette, læse, skrive, slette, tilføje og vedhæfte filer i tabellen i Hjælp-siden. Sikkerhedsrollerne Systemadministrator og Systemtilpasser har begge denne rettighed.
  • Hvis brugerne vil have vist hjælpruder i en app, skal de have læserettigheder i tabellen i Hjælp-siden. Sikkerhedsrollen Hjælp-side har som standard denne rettighed. Grundlæggende brugersikkerhedsrolle har som sikkerhedsrolle ikke rettigheder til tabellen i Hjælp-siden.

Flere oplysninger: Standardsikkerhedsroller og rettigheder

Kontekstafhængig brugerdefineret hjælp

Hver enkelt Hjælp-rude er entydig i følgende sammenhænge:

  • Applikation
  • Tabel
  • Formular
  • Sprog

Navigation i Hjælp-rude

Som standard forbliver en Hjælp-rude åben med det Hjælp-indhold, som du første gang åbnede det med, selvom du navigerer til en anden formular. Det gør det muligt for Hjælp-indholdet at forblive intakt, når du omdirigerer brugere til forskellige dele af appen.

Sådan opretter du indhold til Hjælp-ruden

  1. Når du vil have vist Hjælp-ruden, skal du åbne en modelbaseret app og derefter vælge Hjælp på kommandolinjen.

    Hjælp.

  2. Vælg den lodrette ellipse i Hjælp-ruden, og vælg derefter Rediger.

    Hjælp til redigering.

    Hjælp-ruden er nu i redigeringstilstand, og markøren er placeret på Hjælp-rudens titel.

  3. I redigeringsruden kan du udføre følgende opgaver:

    • Indtaste tekst ved at skrive direkte i Hjælp-ruden.
    • Formatér tekst via funktioner til RTF, og tilføj punktlister/nummererede lister, sektioner, videoer, billeder, links, coachmarks og hjælpebobler.

  4. Vælg Gem for at gemme dine ændringer.

Fritekst

Tekst kan placeres overalt i Hjælp-ruden. Du kan skriv fritekst før, i eller efter sektioner. Teksten understøtter skrifttypeformater som fed, kursiv, understreget og gennemstreget. Klip, kopiér og sæt ind kan bruges, og du kan fortryde på flere niveauer.

Opstillinger med punkttegn og tal

Hvis du vælger ikonet for punkttegn eller tal/bogstaver, bliver den aktuelle linje opstillet som punkttegn eller nummereret. Hvis du har valgt flere linjer på en liste, bliver hver linje punkteret eller nummereret. Tabulering og indrykning af undernumre justeres inden for listen.

Sektioner

En sektion er et tekstfelt, der kan skjules. Du kan placere links eller fritekst i feltet. Brug en sektion til at gruppere elementer af samme art. En sektion kan enten være åben eller skjult som standard.

Video og statiske billeder

Du kan indsætte videoer og statiske billeder i Hjælp-ruden. Videoer og billeder er links til indhold på internettet. Ruder med brugerdefineret hjælp gemmer ikke video- og billedfilerne i din Hjælp-rude. Når Hjælp-ruden åbnes, henter brugerdefinerede Hjælp-ruder indholdet fra linket og viser det. Du kan bruge et link til en Microsoft Stream-video, hvis du vil referere til virksomhedens private materiale.

Tip

Husk at kopiere link-URL-adressen til den ønskede video eller det ønskede billede, så du kan indsætte den i Hjælp-ruden.

Brugerdefinerede Hjælp-ruder understøtter følgende videokilder:

  • Microsoft Stream (klassisk) (bruges til privat indhold)
  • YouTube
  • Facebook
  • Vimeo

Links kan være til websteder og åbnes i det samme vindue (standard) eller åbnes i et separat vindue. Det er endnu ikke muligt at oprette et link til en eksisterende Hjælp-side.

Bobler og coachmærker

Bobler og coachmarks kan bruges til at pege på bestemte elementer i brugergrænsefladen. En boble kan indeholde tekst.

Indsæt boble

Et coachmark fremhæver blot et element med en coachmarkør for at gøre brugeren opmærksom på elementet i brugergrænsefladen.

Indsæt coachmark

Forfatteren skal definere målet via træk og slip-funktionen i egenskaberne for bobler og coachmarks. Forfatteren kan angive titel- og beskrivelsesteksten for coachmarks.

Træk og slip

Bemærk

  • Bobler og coachmarks fungerer ikke godt med brugerdefinerede komponenter. Denne funktion gælder kun for standardkomponenter i Unified Interface-brugergrænsefladen.
  • Sekventielle hjælpebobler og coachmarks understøttes endnu ikke.

Løsninger og brugerdefineret indhold i Hjælp-ruden

Alt Hjælp-indhold gemmes i en komponent på Hjælp-siden i Dataverse som en del af løsningen. Når du flytter løsningen fra ét miljø til et andet, f.eks. fra test til produktion, kan du definere, at rækkerne i hjælp skal eksporteres, så de medtages i løsningen. Det giver dig mulighed for at holde indholdet i hjælpen synkroniseret med funktioner i din løsning, når det flyttes til forskellige miljøer. Som en del af din løsning understøtter brugerdefinerede Hjælp-ruder alle standardfunktioner til administration af programlivscyklus (ALM).

Flytning af indhold via løsninger

Som standard vises alle nye Hjælp-sider i standardløsningen. Hvis du vil flytte indholdet til et andet miljø, skal du først tilføje de eksisterende Hjælp-sider til en ikke-administreret løsning, før du eksporterer dem. Gør følgende for at føje en Hjælp-side til en ikke-administreret løsning:

  1. Log på Power Apps.
  2. Vælg Løsninger i venstre navigationsrude. Hvis elementet ikke findes i sidepanelruden, skal du vælge ...Flere og derefter vælge det ønskede element.
  3. Åbn den ønskede ikke-administrerede løsning.
  4. Vælg Tilføj eksisterende på kommandolinjen, og vælg derefter Hjælp-side.
  5. Vælg de hjælpesider, som du vil tilføje, og vælg derefter Tilføj. Flere oplysninger: Eksportere løsninger

Automatisering af dokumentation til Hjælp-side

Det kan være en god ide at sikkerhedskopiere eller gemme indholdet i et kildekodekontrolsystem. Du kan også bruge automatiseringsværktøjer til dokumentation, f.eks. oversættelsesværktøjer eller kontrolfunktioner, til indhold i Hjælp-ruden. De brugerdefinerede data i Hjælp-ruden gemmes direkte i Dataverse og kan eksporteres og importeres til dette formål.

Brugerdefinerede Hjælp-ruder understøtter et brugerdefineret XML-format. Dette format beskrives nedenfor. Flere oplysninger: Definition af brugerdefineret hjælp i XML-format

Når du eksporterer, eksporteres hver Hjælp-side som en separat fil.

Om den administrerede løsning Kontekstafhængig hjælp

De brugerdefinerede hjælperuder og funktionen til styrede opgaver består af løsningskomponenterne i den administrerede løsning Kontekstafhængig hjælp. Tilpasning eller oprettelse af poster ved hjælp af tabeller uden for de brugerdefinerede hjælperuder og styrede opgaver understøttes ikke.

Bemærk, at nogle apps, f.eks. Dynamics 365 Sales og Dynamics 365 Service inkluderer en første kørselsoplevelse, der er opbygget ved hjælp af tabeller, der er inkluderet i den administrerede løsning Kontekstafhængig hjælp. Både tabellen Hjælp-side (msdyn_helppage) og tabellen Præsentation (msdyn_tour) bruges f.eks. til at oprette disse første kørselsoplevelser. I øjeblikket understøtter de brugerdefinerede hjælperuder og funktionen til styrede opgaver ikke oprettelsen af disse første kørselsoplevelser.

Ofte stillede spørgsmål

I dette afsnit beskrives ofte stillede spørgsmål om brugerdefinerede Hjælp-sider.

Er brugerdefinerede Hjælp-sider det samme som hjælp, der kan tilpasses?

Brugerdefinerede Hjælp-ruder og styrede opgaver er en mulighed i sektionen Angiv URL-adresse til brugerdefineret hjælp i systemindstillingerne. Brugerdefinerede Hjælp-ruder og styrede opgaver aktiverer en Hjælp-rude, der kan tilpasses, som vises lige ved siden af brugerens formular. De andre indstillinger i denne sektion med brugerdefineret Hjælp i systemindstillingerne indeholder de Hjælp-funktioner, der kan tilpasses. De gør det muligt at tilsidesætte hjælpen i standardapps og henviser brugerne i din organisation til en anden URL-adresse, hvor de kan få hjælp. Eller du kan tilsidesætte hjælpen for en stærkt tilpasset tabel, så du bedre kan beskrive arbejdsprocessen.

Du kan finde flere oplysninger om hjælp, der kan tilpasses, i Aktivere og bruge hjælp, der kan tilpasses.

Hvordan overfører jeg mine data fra læringsforløb til brugerdefinerede Hjælp-sider?

Læringsforløb indeholder to typer hjælp: Hjælp-ruder og sekventielle hjælpebobler. De sekventielle hjælpebobles placeringer er dybt integreret med brugergrænsefladen i den gamle webklient, og de kan ikke overføres til de nye brugerdefinerede Hjælp-ruder.

Afhængigt af hvor meget tekst du har i din automatiserede hjælp, kan det være nemmest blot at kopiere oplysningerne direkte fra brugergrænsefladen i læringsforløbet til den nye brugergrænseflade i Hjælp-ruden. Men du kan også eksportere dit læringsforløbs Hjælp-indhold. Den nemmeste måde at gøre det på er at eksportere indholdet ved hjælp af Læringsforløb > Indholdsbibliotek > Oversæt > Eksporter-funktionen. Markér de ønskede rækker, og eksportér dem derefter. Derved oprettes en XLIFF-fil til hver Hjælp-rude og styret opgave. Brug derefter en offentligt tilgængelig XLIFF-editor eller XLIFF til HTML-konverteringsprogrammet til at hente dit indhold.

Definition af brugerdefineret hjælp i XML-format

I dette afsnit beskrives definitionen af brugerdefineret hjælp i XML-format.

PPHML

<pphml>
    <h1>FAQ</h1>
    <collapsible title="What is PPHML?">
        <p>PPHML is a domain specific language for help content. It is used to create help content that includes elements such as images, videos, balloons, coach marks, etc.</p>
    </collapsible>
    <collapsible title="What does PPHML stand for?">
        <p>PPHML stands for Power Platform Help Markup Language</p>
    </collapsible>
</pphml>

Definition og brug

Elementet <pphml> fortæller Hjælp-browseren, at dette er et PPHML-dokument.

<pphml>-elementet repræsenterer roden af et PPHML-dokument.

<pphml>-elementet er objektbeholderen for alle andre PPHML-elementer.

Titel

Viser en titel på en Hjælp-side.

<h1>This will be displayed at the top of the help page</h1>

Definition og brug

<h1>-elementet definerer titlen på en Hjælp-side.

<h1> Dette skal være det første element i <pphml>.

Billede

Viser et billede på en Hjælp-side.

<img src="smiley.gif" alt="Smiley face" title="Smiley face"/>

Definition og brug

<img>-elementet integrerer et billede på en Hjælp-side.

Attributter

  • src: Angiver URL-adressen til et billede. Denne attribut er påkrævet.

  • title: Angiver en titel, der skal vises sammen med billedet, typisk som et pegefølsomt værktøjstip.

  • alt: Angiver en alternativ tekst til et billede. Denne tekst bruges af skærmlæsere.

Video

Viser en video på en Hjælp-side.

<video src="https://www.youtube.com/watch?v=WSWmn7WM3i4" />

Definition og brug

<video>-elementet integrerer en video, f.eks. et selvstudium eller en oplæringsfilm, på en Hjælp-side.

Understøttede kilder
  • Microsoft Stream
  • YouTube
  • Facebook
  • Vimeo

Attributter

  • src: Angiver webadressen til videoen. Denne attribut er påkrævet.

  • allowFullScreen: Angiver, om brugeren kan få vist videoen i fuld skærmstørrelse. Mulige værdier er "true" eller "false". Denne attribut understøttes ikke til alle videokilder.

  • autoplay: Angiver, at afspilningen af videoen starter, så snart Hjælp-siden er indlæst. Mulige værdier er "true" eller "false". Denne attribut understøttes ikke til alle videokilder.

  • startTime: Angiver, i sekunder, hvorfra afspilningen af videoen skal begynde.

Afsnit

Viser et afsnit på en Hjælp-side.

<p>This is some text in a paragraph.</p>

Definition og brug

<p>-elementet definerer et afsnit.

Tekst i et afsnit kan tilpasses med følgende funktioner:

  • Fed, med elementet <strong>
  • Kursiv, med elementet <em>
  • Gennemstregning, med elementet <del>
  • Understregning, med elementet <u>

Disse tilpasninger kan kombineres. Du kan f.eks. oprette et tekstfragmenter, hvor du både bruger fed og understreget.

Opstilling med punkttegn

Viser en opstilling med punkttegn på en Hjælp-side.

<ul>
    <li>Coffee</li>
    <li>Tea</li>
    <li>Milk</li>
</ul>

Definition og brug

<ul>-elementet definerer en punktopstilling.

Brug <ul>-elementet sammen med <li>-elementet til at oprette opstillinger med punkttegn.

Nummereret liste

Viser en nummeret liste på en Hjælp-side.

<ol>
    <li>First step</li>
    <li>Second step</li>
    <li>Third step</li>
</ol>

Definition og brug

<ol>-elementet definerer en ordnet liste (nummereret). Brug <ol>-mærket sammen med <li>-elementet til at oprette nummererede lister.

Sektion, der kan skjules

Viser en sektion, der kan skjules, på en Hjælp-side.

<collapsible title="This is a Section">
    <p>This is a paragraph inside a section</p>
    <img src=smiley.gif" title="This is an image inside a section" />
</collapsible>

Definition og brug

<collapsible>-elementet defineres en sektion med indhold, som brugeren kan få vist eller skjule efter behov.

Attributter

  • collapsed: Angiver, om sektionen er skjult eller udvidet til at begynde med. Mulige værdier er "true" (skjult) og "false" (udvidet).

Viser et link på en Hjælp-side.

Link til et websted, der vises i et nyt browservindue:

<a href="https://www.microsoft.com" target="_blank">Microsoft Home Page</a>

Link til en anden Hjælp-side:

<a href="./LearnMore">Learn More</a>

Definition og brug

<a>-mærket definerer et link, som gør det muligt for brugeren at navigere fra en Hjælp-side til et websted eller til en anden Hjælp-side.

Attributter

  • href: Angiver URL-adressen til det websted eller den Hjælp-side, du vil navigere til. Denne attribut er påkrævet.
  • target: Angiver, hvor den sammenkædede URL-adresse skal åbnes.
    • Hvis linket ikke findes, eller der står _self, antages det at være til en anden Hjælp-side, og så åbnes det i Hjælp-browseren.
    • Hvis _blank, åbnes linket i et nyt browservindue.
    • Hvis _top, åbnes linket i det nuværende browservindue.
    • Hvis værdien er navnet på en iframe, åbnes linket i den pågældende iframe.

Coachmærke

Viser et coachmærke på en Hjælp-side.

<coachmark target="#my-html-button">Click to highlight the HTML element with id [my-html-button]</coachmark>

Definition og brug

Et coachmærke er et interaktivt element, der kan bruges til at rette brugerens opmærksomhed mod et bestemt punkt i brugergrænsefladen på det program, der er vært for Hjælp-browseren.

Attributter

  • target: CSS-vælger, der angiver det HTML-element, som coachmærket skal vises over. Denne attribut er påkrævet.

Boble

Viser en boble på en Hjælp-side.

<balloon target="#my-html-button" title="This button submits the form" details="Please click this button to continue and submit the form">Click to show a balloon over the HTML element with id [my-html-button]</balloon>

Definition og brug

En boble er et interaktivt element, der kan bruges til at hjælpe brugeren med at udføre en handling i brugergrænsefladen på det program, der er vært for Hjælp-browseren.

Attributter

  • target: CSS-vælger, der angiver det HTML-element, som boblelinket skal vises over. Denne attribut er påkrævet.
  • title: Angiver titlen på boblen.
  • details: Angiver det indhold, der skal vises i boblen.

Bemærk

Kan du fortælle os om dine sprogpræferencer for dokumentation? Tag en kort undersøgelse. (bemærk, at denne undersøgelse er på engelsk)

Undersøgelsen tager ca. syv minutter. Der indsamles ingen personlige data (erklæring om beskyttelse af personlige oplysninger).