Deli z drugimi prek

Ustvarjanje vodene pomoči za vašo aplikacijo poenotenega vmesnika

  • Članek

Uporabite podokna s pomočjo po meri in vodena opravila, da svoji aplikaciji poenotenega vmesnika omogočite izkušnjo pomoči v izdelku po meri, ki je prilagojena vaši organizaciji. Uporabite podokna za pomoč po meri, da zagotovite pomoč in smernice za tabelo, obrazec in jezik, ki vključujejo obogateno besedilo, vsebinske povezave, slike in video povezave.

Pomembno

  • Podokna s pomočjo po meri nadomestijo prejšnjo funkcijo vodenega učenja, ki se uporablja s podedovanimi aplikacijami spletnega odjemalca.
  • Podokna pomoči po meri ne delujejo z aplikacijami poenoteni vmesnik, ki se izvajajo v mobilni napravi, kot so Android in iOS tablični računalniki in pametni telefoni.

Podokna s pomočjo po meri in vodeno učenje

Nova uvedba vodene pomoči podoken s pomočjo po meri se razlikuje od prejšnje funkcije vodene pomoči pri vodenem učenju. Obe funkciji vam omogočata ustvarjanje pomoči po meri za vašo aplikacijo. Vendar so podokna s pomočjo po meri optimizirana za najpogostejše scenarije vodene pomoči.

Podokna s pomočjo po meri zagotavljajo naslednje ključne funkcije, ki niso na voljo za vodeno učenje:

  • Obogateno besedilo v prosti obliki, vključno z vrstičnimi oznakami in oštevilčenjem.
  • Vidno povezane oznake za usposabljanje in oblački s pomočjo.
  • Več možnosti za vire videoposnetkov, vključno z zasebnimi viri.
  • Shranjevanje vsebine pomoči v storitvi Microsoft Dataverse kot del vaše rešitve.

Podokna s pomočjo po meri ne zagotavljajo naslednjih ključnih funkcij, ki so na voljo za vodeno učenje:

  • Zaporedni baloni s pomočjo.
  • Strani s pomočjo glede na vlogo.
  • Strani s pomočjo za dimenzije naprav, kot so pametni telefoni.

Zahteve

Če želite uporabiti funkcijo podoken za pomoč po meri, mora imeti vaše okolje izpolnjene naslednje pogoje:

Omogočanje podoken s pomočjo po meri za lastno okolje

  1. Odprite aplikacijo, ki temelji na modelu, nato pa v ukazni vrstici izberite Nastavitve Nastavitve. > Napredne nastavitve.

  2. Odprite možnost Nastavitve > Sistem > Skrbništvo.

  3. Na strani Skrbništvo izberite Sistemske nastavitve.

  4. Na zavihku Splošno pod možnostjo Nastavi URL pomoči po meri izberite Da za Omogoči podokna s pomočjo po meri in vodena opravila in nato izberite V redu.

    Omogočanje podoken s pomočjo po meri.

Pomembno

  • Omogočite lahko podokna s pomočjo po meri ali prilagodljivo pomoč, toda ne obeh hkrati. Potrdite, da sta parametra Uporabi pomoč po meri za tabele po meri in Naslovu URL priloži parametre nastavljena na Ne.
  • Za nekatera okolja bo morda treba nastaviti možnost Omogoči vodeno učenje na Da.

Zahtevane pravice

  • Za ustvarjanje podoken za pomoč potrebujejo izdelovalci aplikacij globalna dovoljenja za ustvarjanje, branje, pisanje, brisanje, prilaganje in dodajanje v tabeli Stran s pomočjo. Privzeto imata to pravico varnostni vlogi »Skrbnik sistema« in »Prilagojevalec sistema«.
  • Za ogled podoken za pomoč v aplikaciji uporabniki potrebujejo dovoljenje za branje v tabeli Stran s pomočjo. Privzeto ima varnostna vloga uporabnika strani s pomočjo to pravico. Varnostna vloga osnovnega uporabnika privzeto nima nobenih pravic v tabeli strani s pomočjo.

Več informacij: Varnostne vloge in pravice

Pomoč po meri glede na kontekst

Vsako podokno s pomočjo je edinstveno za te kontekste:

  • Aplikacija
  • Tabela
  • Obrazec
  • Language

Krmarjenje po podoknu s pomočjo

Podokno s pomočjo privzeto ostane odprto in v vsebini s pomočjo, s katero ste ga prvič odprli, tudi ko se pomaknete v drug obrazec. To omogoča, da vsebina s pomočjo ostane nedotaknjena, ko uporabnike usmerite v različne dele aplikacije.

Ustvarjanje vsebine podokna s pomočjo

  1. Če si želite ogledati podokno s pomočjo, odprite aplikacijo, ki temelji na modelu, in nato v ukazni vrstici izberite Pomoč.

    Pomoč.

  2. V podoknu s pomočjo izberite navpične tri pike in nato izberite Uredi.

    Urejanje pomoči.

    Podokno s pomočjo je zdaj v načinu urejanja, kazalec pa je postavljen na naslov podokna s pomočjo.

  3. V podoknu za urejanje lahko izvedete naslednja opravila:

    • Vnos besedila z neposrednim tipkanjem v območje podokna s pomočjo.
    • Oblikujte besedilo z zmožnostmi obogatenega besedila in dodajte označene/oštevilčene sezname, odseke, videoposnetke, slike, povezave, oznake za usposabljanje in pomoč v oblačkih.

  4. Če želite shraniti spremembe, izberite Shrani.

Besedilo v prosti obliki

Besedilo je mogoče postaviti kamor koli znotraj podokna s pomočjo. Vnesite besedilo v prosti obliki pred, v ali za razdelki. Besedilo podpira krepke, ležeče, podčrtane in prečrtane oblike zapisa pisav. Uporabite lahko tako možnosti »Izreži«, »Kopiraj« in »Prilepi« kot tudi večstopenjsko razveljavitev.

Vrstične oznake in oštevilčeni seznami

Ko izberete ikono vrstične oznake ali številke, trenutna vrstica postane označena z vrstično oznako ali oštevilčena. Če ste na seznamu izbrali več vrstic, postane vsaka vrstica označena z vrstično oznako ali oštevilčena. Preklapljanje s tabulatorjem in zamikanje podštevilk se v seznamu poravnata.

Razdelki

Razdelek je strnljivo polje z besedilom. Vanj lahko vstavite povezave ali besedilo v prosti obliki. V razdelku lahko združite podobne elemente. Razdelek je lahko privzeto odprt ali strnjen.

Videoposnetek in statične slike

V podokno s pomočjo lahko vstavite videoposnetke in statične slike. Videoposnetki in slike so povezave do vsebin v internetu. Podokna s pomočjo po meri ne shranjujejo videodatotek in slikovnih datotek v podokno s pomočjo. Ko je podokno s pomočjo odprto, podokna s pomočjo po meri privedejo vsebino s povezave, da jo prikažejo. Uporabite lahko povezavo do videoposnetka Microsoft Stream, če se želite sklicevati na zasebno vsebino podjetja.

Nasvet

Ne pozabite kopirati URL povezave za želeni videoposnetek ali sliko, da ga/jo lahko prilepite v podokno s pomočjo.

Podokna s pomočjo po meri podpirajo naslednje vire videoposnetkov:

  • Microsoft Stream (Klasično) (uporabite za zasebno vsebino)
  • YouTube
  • Facebook
  • Vimeo

Povezave lahko vodijo do spletnih mest in se odprejo v istem oknu (privzeto) ali pa se odprejo v ločenem oknu. Možnost povezave do obstoječe strani s pomočjo še ni omogočena.

Oblački in oznake za usposabljanje

Oblačke in oznake za usposabljanje lahko uporabite za nakazovanje določenih elementov uporabniškega vmesnika. Oblaček lahko vsebuje besedilo.

Vstavi balon

Oznaka usposabljanja preprosto poudari element s puščico, da pritegne pozornost uporabnika na ta element uporabniškega vmesnika.

Vstavi oznako usposabljanja

Avtor mora definirati cilj z možnostjo povleci in spusti v lastnostih balonov in oznak usposabljanja. Avtor lahko vnese besedilo za naslov in opis za oznake usposabljanja.

Povleci in spusti

Opomba

  • Baloni in oznake usposabljanja ne delujejo dobro s komponentami po meri. Ta funkcija velja samo za privzete poenoteni vmesnik komponente uporabniškega vmesnika.
  • Oblački za zaporedno pomoč in oznake uspoabljanja še niso podprte.

Rešitve in vsebina podokna s pomočjo

Vsa vsebina s pomočjo je shranjena v komponenti strani s pomočjo v storitvi Dataverse kot del vaše rešitve. Ko svojo rešitev premaknete iz enega okolja v drugo, na primer iz preizkusne v proizvodno različico, lahko določite, da se vrstice za pomoč izvozijo, tako da so vključene v rešitev. To vam omogoča, da vsebino pomoči sinhronizirate s funkcijami v rešitvi, ko se premika v različna okolja. Kot del vaše rešitve podokna s pomočjo po meri podpirajo vse funkcije upravljanja življenjskega cikla aplikacij (ALM) standardnih rešitev.

Premikanje vsebine prek rešitev

Vse nove strani s pomočjo se privzeto prikažejo v privzeti rešitvi. Če želite premakniti vsebino v drugo okolje, najprej dodajte obstoječe strani s pomočjo v neupravljano rešitev, preden jih izvozite. Če želite stran s pomočjo dodati v neupravljano rešitev, upoštevajte naslednje korake:

  1. Vpišite se v Power Apps.
  2. V podoknu za krmarjenje na levi izberite Rešitve. Če elementa ni v podoknu leve plošče, izberite … Več in nato izberite želeni element.
  3. Odprite želeno neupravljano rešitev.
  4. V ukazni vrstici izberite Dodaj obstoječo in nato izberite Stran s pomočjo.
  5. Izberite strani s pomočjo, ki jih želite dodati, nato pa izberite Dodaj. Več informacij: Izvoz rešitev

Avtomatizacija dokumentacije na strani s pomočjo

Morda boste želeli varnostno kopirati ali shraniti svojo vsebino v sistemu za upravljanje izvorne kode. Za vsebino v podoknu s pomočjo boste morda želeli tudi uporabiti orodja za avtomatizacijo dokumentacije, na primer orodja za prevajanje ali preverjevalnike. Podatki podokna s pomočjo po meri se shranijo neposredno v storitev Dataverse in se lahko v ta namen izvozijo in uvozijo.

Podokna s pomočjo po meri podpirajo obliko zapisa XML po meri. Ta oblika zapisa je dokumentirana spodaj. Več informacij: Definicija oblike zapisa XML za pomoč po meri

Pri izvažanju se vsaka stran s pomočjo izvozi kot ločena datoteka.

O kontekstualni pomoči upravljane rešitve

Funkcija podoken pomoči po meri in vodenih opravil je sestavljena iz komponent rešitve v kontekstualni pomoči upravljane rešitve. Prilagajanje ali ustvarjanje zapisov z uporabo tabel zunaj podokna pomoči po meri in funkcije vodenih opravil ni podprto.

Upoštevajte, da nekatere aplikacije, kot sta Dynamics 365 Sales in Dynamics 365 Service, vključujejo izkušnje prvega zagona, ki so zgrajene z uporabo tabel, vključenih v kontekstualno pomoč upravljane rešitve. Na primer, pri ustvarjanju teh izkušenj prvega zagona sta uporabljeni tako tabeli strani pomoči (msdyn_helppage) kot tabele ogleda (msdyn_tour). Trenutno podokna pomoči po meri in funkcija vodenih opravil ne podpirajo ustvarjanja teh izkušenj prvega zagona.

Pogosto zastavljena vprašanja

Ta razdelek obravnava pogosto zastavljena vprašanja o straneh s pomočjo po meri.

Ali so strani s pomočjo po meri enake kot prilagodljiva pomoč?

Podokna s pomočjo po meri in vodena opravila so možnost v razdelku Nastavi URL pomoči po meri sistemskih nastavitev. Podokna s pomočjo po meri in vodena opravila omogočajo podokno s prilagodljivo pomočjo, ki se prikaže tik ob obrazcu uporabnika. Druge možnosti v tem razdelku s pomočjo po meri sistemskih nastavitev sestavljajo funkcije prilagodljive pomoči. Omogočajo preglasitev privzete pomoči za aplikacije in usmerjajo uporabnike v vaši organizaciji na drug URL za pomoč. Lahko pa preglasite pomoč za izredno prilagodljivo tabelo, da boste lahko bolje opisali potek dela.

Za več informacij o prilagodljivi pomoči glejte Omogočanje in uporaba prilagodljive pomoči.

Kako lahko preselim svoje podatke iz vodenega učenja na strani s pomočjo po meri?

Vodeno učenje vsebuje dve vrsti pomoči: podokna s pomočjo in zaporedne oblačke s pomočjo. Lokacije zaporednih oblačkov s pomočjo so globoko vgrajene v uporabniški vmesnik podedovanega spletnega odjemalca in jih ni mogoče prenesti v nova podokna s pomočjo po meri.

Glede na to, koliko besedila imate v vodeni pomoči, je najlažje preprosto kopirati podatke neposredno iz uporabniškega vmesnika vodenega učenja v nov uporabniški vmesnik podokna s pomočjo po meri. Lahko pa tudi izvozite vsebino pomoči za vodeno učenje. Najenostavnejši način za to je, da izvozite svojo vsebino s funkcijo Vodeno učenje > Knjižnica vsebin > Lokaliziraj > Izvozi. Izberite želene vrstice in jih nato izvozite. S tem ustvarite datoteko XLIFF za vsako podokno s pomočjo in vodeno opravilo. Nato za pridobivanje vsebine uporabite javno dostopni urejevalnik XLIFF ali pretvornik datotek XLIFF v HTML.

Definicija oblike zapisa XML za pomoč po meri

V tem razdelku je opisana definicija oblike zapisa XML za pomoč po meri.

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>

Definicija in uporaba

Element <pphml> pove brskalniku pomoči, da je to dokument PPHML.

Element <pphml> predstavlja koren dokumenta PPHML.

Element <pphml> je vsebnik za vse druge elemente PPHML.

Naslov

Predstavlja naslov na strani s pomočjo.

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

Definicija in uporaba

Element <h1> določa naslov strani s pomočjo.

<h1> To mora biti prvi element znotraj <pphml>.

Slika

Predstavlja sliko na strani s pomočjo.

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

Definicija in uporaba

Element <img> vdela sliko v stran s pomočjo.

Atributi

  • src: določa URL slike. Ta atribut je obvezen.

  • title: določa naslov, ki bo prikazan skupaj s sliko, običajno kot opis ob premiku kazalca nanjo.

  • alt: določa nadomestno besedilo za sliko. To besedilo uporabljajo bralniki zaslona.

Videoposnetek

Predstavlja videoposnetek na strani s pomočjo.

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

Definicija in uporaba

Element <video> vdela videoposnetek, kot je vadnica ali film za usposabljanje, v stran s pomočjo.

Podprti viri
  • Microsoft Stream
  • YouTube
  • Facebook
  • Vimeo

Atributi

  • src: določa URL videoposnetka. Ta atribut je obvezen.

  • allowFullScreen: določa, ali lahko uporabnik videoposnetek preklopi na celozaslonski način. Možni vrednosti sta parametra »true« ali »false«. Ta atribut ni podprt za vse vire videoposnetkov.

  • autoplay: določa, da se bo videoposnetek začel predvajati takoj, ko se naloži stran s pomočjo. Možni vrednosti sta parametra »true« ali »false«. Ta atribut ni podprt za vse vire videoposnetkov.

  • startTime: v nekaj sekundah določi, od katere točke se bo začel predvajati videoposnetek.

Odstavek

Predstavlja odstavek na strani s pomočjo.

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

Definicija in uporaba

Element <p> določa odstavek.

Besedilo v odstavku je mogoče okrasiti na naslednje načine:

  • Krepko, z elementom <strong>
  • Ležeče, z elementom <em>
  • Prečrtano, z elementom <del>
  • Podčrtano, z elementom <u>

Te okrasne elemente je mogoče kombinirati. Ustvarite lahko na primer fragment besedila, ki je krepek in podčrtan.

Označen seznam

Predstavlja označen seznam na strani s pomočjo.

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

Definicija in uporaba

Element <ul> določa označen seznam.

Element <ul> uporabite skupaj z elementom <li>, če želite ustvariti označene sezname.

Oštevilčen seznam

Predstavlja oštevilčen seznam na strani s pomočjo.

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

Definicija in uporaba

Element <ol> določa naročen (oštevilčen) seznam. Oznako <ol> uporabite skupaj z elementom <li>, če želite ustvariti oštevilčene sezname.

Strnljivo

Predstavlja strnljiv razdelek na strani s pomočjo.

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

Definicija in uporaba

Element <collapsible> določa razdelek z vsebino, ki si jo lahko uporabnik ogleda ali jo skrije na zahtevo.

Atributi

  • collapsed: določa, ali je razdelek sprva strnjen ali razširjen. Možni vrednosti sta parametra »true« (strnjeno) ali »false« (razširjeno).

Predstavlja povezavo na strani s pomočjo.

Povezava do spletnega mesta, ki se odpre v novem oknu brskalnika:

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

Povezava do druge strani s pomočjo:

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

Definicija in uporaba

Oznaka <a> določa povezavo, ki uporabniku omogoča, da se pomika s strani s pomočjo do spletnega mesta ali do druge strani s pomočjo.

Atributi

  • href: določa URL spletnega mesta ali strani s pomočjo, do katere naj se pomika. Ta atribut je obvezen.
  • target: določa, kje je treba odpreti URL povezave.
    • Če atribut ni prisoten ali je _self, se domneva, da gre pri povezavi za drugo stran s pomočjo, zato se odpre v brskalniku pomoči.
    • Če je atribut _blank, se povezava odpre v novem oknu brskalnika.
    • Če je atribut _top, se povezava odpre v trenutnem oknu brskalnika.
    • Če je vrednost ime atributa iframe, se povezava odpre v tem elementu iframe.

Oznaka za usposabljanje

Predstavlja oznako za usposabljanje na strani s pomočjo.

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

Definicija in uporaba

Oznaka za usposabljanje je interaktivni element, ki se lahko uporabi za pritegnitev uporabnikove pozornosti na določeno točko v uporabniškem vmesniku aplikacije, ki gosti brskalnik pomoči.

Atributi

  • target: izbirnik CSS, ki določa element HTML, nad katerim bo prikazana oznaka za usposabljanje. Ta atribut je obvezen.

Oblaček

Predstavlja oblaček na strani s pomočjo.

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

Definicija in uporaba

Oblaček je interaktivni element, ki se lahko uporabi, da uporabniku pomaga izvesti dejanje v uporabniškem vmesniku aplikacije, ki gosti brskalnik pomoči.

Atributi

  • target: izbirnik CSS, ki določa element HTML, nad katerim bo prikazana povezava v oblačku. Ta atribut je obvezen.
  • title: določa naslov oblačka.
  • details: določa vsebino, ki bo prikazana znotraj oblačka.

Opomba

Ali nam lahko poveste, kateri je vaš prednostni jezik za dokumentacijo? Izpolnite kratko anketo. (upoštevajte, da je v angleščini)

Z anketo boste porabili približno sedem minut. Ne zbiramo nobenih osebnih podatkov (izjava o zasebnosti).