Partajați prin

Creați ajutor dirijat pentru aplicația dvs. Interfață unificată

  • Articol

Utilizați panouri de ajutor personalizate și sarcini ghidate pentru a oferi aplicației dvs. Interfață unificată o experiență de ajutor personalizată în produs, adaptată organizației dvs. Utilizați panouri de ajutor personalizate pentru a furniza ajutor și îndrumări specifice tabelului, formularului și limbii care includ text îmbogățit, linkuri de conținut, imagini și linkuri video.

Important

  • Panourile de ajutor particularizate înlocuiesc caracteristica de învățare ghidată din calea de învățare anterioară, folosită cu aplicațiile web client vechi.
  • Panourile de ajutor personalizate nu funcționează cu aplicațiile Interfață unificată care rulează pe un dispozitiv mobil, cum ar fi Android și iOS tabletele și smartphone-urile.

Panouri de ajutor personalizate și calea de învățare

Noua implementare de ajutor ghidată a panelor de ajutor personalizate diferă de caracteristica de ajutor ghidată a căii anterioare. Ambele funcții vă permit să creați ajutor personalizat pentru aplicația dvs. Cu toate acestea, panourile de ajutor personalizate sunt optimizate pentru cele mai comune scenarii de ajutor ghidate.

Panourile de ajutor personalizate oferă următoarele caracteristici cheie care nu sunt disponibile cu calea de învățare:

  • Text îmbogățit în formă liberă, inclusiv marcatori și numerotare.
  • Marcaje ale antrenorului vizibil legate și baloane de ajutor.
  • Mai multe opțiuni pentru surse video, inclusiv surse private.
  • Stocarea conținutului de ajutor în Microsoft Dataverse ca parte a soluției dvs.

Panourile de ajutor personalizate nu furnizează următoarele caracteristici cheie care nu sunt disponibile cu calea de învățare:

  • Baloane de ajutor secvențiale.
  • Pagini de ajutor pe rol.
  • Pagini de ajutor pentru dispozitivul factor de formă, cum ar fi smartphone-urile.

Cerințe preliminare

Pentru a utiliza caracteristica de panouri de ajutor particularizate, mediul dvs. are nevoie de următoarele:

Activați panouri particularizate de ajutor pentru mediul dvs.

  1. Deschideți o aplicație proiectată pe bază de model, apoi selectați pe bara de comandă Setări Setări. > Setări complexe.

  2. Accesați Setări > Sistem > Administrare.

  3. În pagina Administrare, selectați Setări sistem.

  4. Pe fila General, sub Setați adresa URL de ajutor personalizată, selectați Da pentru Activați panouri de ajutor personalizate și sarcini ghidate, apoi selectați OK.

    Activați panourile de ajutor personalizate.

Important

  • Aveți posibilitatea ori să activați panouri personalizate de ajutor, ori să personalizați Ajutorul, dar nu ambele în același timp. Confirmați că Utilizați ajutorul particularizat pentru tabele particularizabile și Adăugare parametri la URL sunt setate ambele la Nu.
  • Este posibil ca anumite medii să necesite setarea Activați calea de învățare la Da.

Privilegii necesare

  • Pentru a crea panouri de ajutor, persoanele care creează aplicații trebuie să creeze, să citească, să scrie, să șteargă, să anexeze și să adauge la privilegii pe tabloul Pagina de ajutor. În mod implicit, rolurile de securitate Administrator de sistem și Persoană care particularizează sistemul, au amândouă aceste privilegii.
  • Pentru a vizualiza panourile de ajutor într-o aplicație, utilizatorii au nevoie de privilegii de citire pentru tabelul Pagina de ajutor. Implicit, rolul de securitate Pagină de ajutor a consumatorului are acest privilegiu. În mod implicit, rolul de securitate Utilizator de bază nu are privilegii în tabelul Paginii de ajutor.

Mai multe informații: Roluri de securitate implicite și privilegii necesare

Ajutor personalizat sensibil la context

Fiecare panou de ajutor este unic pentru aceste contexte:

  • Aplicație
  • Tabel
  • Formular
  • Limbă

Navigare panou de ajutor

În mod implicit, un panou de ajutor rămâne deschis și pe conținutul de ajutor l-ați deschis mai întâi chiar și atunci când navigați la un alt formular. Aceasta permite ca conținutul de ajutor să rămână intact în timp ce direcționați utilizatorii către diferite părți ale aplicației.

Pentru a crea conținut de panou de ajutor

  1. Pentru a vizualiza panoul de ajutor, deschideți o aplicație bazată pe model, apoi selectați bara de comandă Ajutor.

    Ajutor.

  2. În panoul de ajutor, selectați elipsele verticale, apoi selectați Editați.

    Editați ajutorul.

    Panoul de ajutor este acum în mod editare și cursorul este poziționat pe titlul panoului de ajutor.

  3. Din panoul de editare puteți efectua următoarele activități:

    • Introduceți text tastând direct în zona panoului de ajutor.
    • Formatați textul prin capabilități de text îmbogățit și adăugați liste cu marcatori/numerotate, secțiuni, video-uri, imagini, linkuri, mărci de antrenor și ajutor balon.

  4. Pentru a vă salva modificările, selectați Salvare.

Text în formă liberă

Textul poate fi plasat oriunde în panoul de ajutor. Introduceți text în formă liberă înainte de secțiuni, în sau după secțiuni. Textul acceptă formate de caractere aldine, italice, subliniate și tăiate. Decupare, copiere și lipire pot fi utilizate, cât și anulare multi-nivel.

Marcatori și listele numerotate

Dacă selectați pictograma marcator sau număr, comutați linia curentă pentru a deveni marcată sau numerotată. Dacă ați selectat mai multe linii dintr-o listă, fiecare linie devine marcată sau numerotată. Deplasarea cu tabulatori și indentarea subnumerelor se aliniază cu lista.

Secțiuni

O secțiune este o casetă text care se poate restrânge. Puteți pune în ea link-uri sau text în formă liberă. Utilizați o secțiune pentru a grupa elemente similare. O secțiune poate fi deschisă sau restrânsă implicit.

Imagini video și statice

Puteți introduce videoclipuri și imagini statice în panoul de ajutor. Videoclipurile și imaginile sunt link-uri către conținut pe internet. Panourile de ajutor personalizate nu stochează fișierele video și imaginile în panoul de ajutor. Când se deschide panoul de ajutor, panourile de ajutor personalizate aduc conținutul din link pentru a-l afișa. Puteți utiliza un link către un video Microsoft Stream dacă doriți să faceți referință la conținut privat corporativ.

Sfat

Nu uitați să copiați adresa URL a linkului pentru videoclipul sau imaginea dorită, astfel încât să o puteți lipi în panoul de ajutor.

Panourile de ajutor personalizate acceptă următoarele surse video:

  • Microsoft Stream (Clasic) (utilizare pentru conținut privat)
  • YouTube
  • Facebook
  • Vimeo

Linkurile pot fi site-uri web și deschise în aceeași fereastră (implicit) sau deschise într-o fereastră separată. Posibilitatea de a conecta la o pagină de ajutor existentă nu este încă activată.

Baloane și marcaje ale antrenorului

Baloanele și marcajele antrenorului pot fi utilizate pentru a indica anumite elemente de UI. Un balon poate avea text în el.

Inserați un balon

Un semn de antrenor pur și simplu evidențiază un element cu un indicator de antrenor pentru a atrage atenția utilizatorului asupra acelui element al interfeței de utilizare.

Inserați elemente de antrenor

Autorul trebuie să definească ținta prin capacitatea de glisare și plasare în proprietățile baloanelor și marcajelor de antrenor. Autorul poate introduce textul pentru titlu și descriere pentru notele antrenorului.

Trageți și plasați

Notă

  • Baloanele și semnele de antrenor nu funcționează bine cu componentele particularizate. Această caracteristică se aplică numai componentelor implicite din interfața unificată UI.
  • Baloanele de ajutor secvențiale și marcajele de antrenare nu sunt încă acceptate.

Panou de ajutor cu soluții și conținut personalizat

Tot conținutul de ajutor este stocat într-o componentă a paginii de ajutor din Dataverse ca parte a soluției dvs. Când mutați soluția dintr-un mediu în altul, cum ar fi de la test la producție, puteți defini că rândurile dvs. de ajutor sunt exportate astfel încât să fie incluse în soluție. Acest lucru vă permite să păstrați conținutul de ajutor în sincronizare cu funcțiile din soluția dvs., pe măsură ce se deplasează în medii diferite. Ca parte a soluției dvs., panourile de ajutor personalizate acceptă toate caracteristicile standard de gestionare a ciclului de viață a aplicațiilor (ALM).

Mutarea conținutului prin soluții

În mod implicit, toate noile pagini de ajutor apar în soluția implicită. Dacă doriți să mutați conținutul într-un alt mediu, adăugați mai întâi paginile de ajutor existente într-o soluție negestionată înainte de a le exporta. Pentru a adăuga o pagină de ajutor la o soluție negestionată, urmați acești pași:

  1. Conectare la Power Apps.
  2. În panoul de navigare din stânga selectați Soluții. Dacă elementul nu se află în panoul lateral, selectați …Mai multe, apoi selectați elementul dorit.
  3. Deschideți soluția neadministrată pe care o doriți.
  4. Selectați Adăugați existent pe bara de comandă, apoi selectați Pagina de ajutor.
  5. Selectați Paginile de ajutor pe care doriți să le adăugați, apoi selectați Adăugați. Informații suplimentare: Exportare soluții

Automatizarea documentației din pagina de ajutor

S-ar putea să doriți să faceți o copie de rezervă sau să stocați conținutul într-un sistem de control al codului sursă. Ați putea dori, de asemenea, să utilizați instrumente de automatizare a documentațiilor, precum instrumente de traducere sau verificatoare, pentru conținutul panoului de ajutor. Datele din panoul de ajutor personalizat sunt stocate direct în Dataverse și poate fi exportat și importat în acest scop.

Panourile de ajutor personalizate acceptă un format XML personalizat. Acest format este documentat mai jos. Informații suplimentare: Definiție personalizată XML de ajutor

Când este exportată, fiecare pagină de ajutor este exportată ca fișier separat.

Despre soluția gestionată Ajutor contextual

Panourile de ajutor particularizate și caracteristica de activități ghidate constau în componentele de soluție din soluția gestionată Ajutor contextual. Personalizarea sau crearea de înregistrări folosind tabelele din afara panourilor de ajutor particularizate și a caracteristicii de activități ghidate nu este acceptată.

Rețineți că unele aplicații, cum ar fi Dynamics 365 Sales și Dynamics 365 Service, includ experiențe la prima rulare care sunt create prin utilizarea tabelelor incluse în soluția gestionată Ajutor contextual. De exemplu, cele două tabele Pagină de ajutor (msdyn_helppage) și Tur (msdyn_tour) sunt folosite la crearea acestor experiențe la prima rulare. În prezent, panourile de ajutor particularizate și caracteristica de activități ghidate nu acceptă crearea acestor experiențe la prima rulare.

Întrebări frecvente

Această secțiune discută întrebări frecvente despre paginile de ajutor personalizate.

Paginile de ajutor personalizate sunt la fel ca ajutorul personalizabil?

Panourile de ajutor personalizate și sarcinile ghidate sunt o opțiune în secțiunea Setați adresa URL de ajutor personalizată setărilor sistemului. Panourile de ajutor personalizate și activitățile ghidate permit un panou de ajutor personalizabil care apare chiar lângă formularul utilizatorului. Celelalte opțiuni din această secțiune a setărilor de ajutor de sistem setate personalizate cuprind caracteristicile de ajutor personalizabile. Acestea vă permit să înlocuiți ajutorul implicit al aplicațiilor și să direcționați utilizatorii din organizație la un alt URL pentru ajutor. Ca alternativă aveți posibilitatea să înlocuiți ajutorul cu un tabel foarte personalizat, astfel încât să puteți descrie mai bine fluxul dvs. de lucru.

Pentru informații suplimentare despre ajutor particularizabil, consultați Activați și utilizați ajutorul personalizabil.

Cum pot migra datele mele din calea de învățare către paginile de ajutor personalizate?

Calea de învățare are două tipuri de ajutor: panouri de ajutor și baloane de ajutor secvențiale. Locațiile secvențiale ale baloanelor de ajutor sunt profund integrate cu UI-ul clientului web vechi și nu sunt transferabile în noile panouri de ajutor personalizate.

În funcție de cât de mult text aveți în ajutorul dvs. ghidat, poate fi mai ușor să copiați pur și simplu informațiile direct din interfața de utilizator a căii de învățare în noua interfață de utilizator a panoului de ajutor personalizat. Cu toate acestea, puteți exporta și conținutul de ajutor al căii de învățare. Cel mai simplu mod de a face acest lucru este să exportați conținutul dvs. folosind caracteristica Calea de învățare > Biblioteca de conținut > Localizare > Export. Selectați rândurile dorite și apoi exportați-le. Se creează un fișier XLIFF pentru fiecare panou de ajutor și activitate ghidată. Apoi, utilizați un editor XLIFF disponibil public sau un convertor XLIFF în HTML pentru a prelua conținutul.

Definiția ajutorului particularizat XML

Această secțiune descrie definiția XML de ajutor personalizată.

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>

Definiție și utilizare

Elementul <pphml> spune browserului de ajutor că acesta este un document PPHML.

Elementul <pphml> reprezintă rădăcina unui document PPHML.

Elementul <pphml> este containerul pentru toate celelalte elemente PPHML.

Titlu

Prezintă un titlu într-o pagină de ajutor.

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

Definiție și Utilizare

Elementul <h1> definește titlul unei pagini de ajutor.

<h1> Acesta trebuie să fie primul element din interiorul <pphml>.

Imagine

Prezintă o imagine într-o pagină de ajutor.

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

Definiție și utilizare

Elementul <img> include o imagine într-o pagină de ajutor.

Atribute

  • src: Specifică adresa URL a unei imagini. Acest atribut este obligatoriu.

  • title: Specifică un titlu de afișat împreună cu imaginea, de obicei ca un sfat care trece cu mouse-ul pe deasupra.

  • alt: Specifică un text alternativ pentru o imagine. Acest text este utilizat de cititorii de ecran.

Video

Prezintă un videoclip într-o pagină de ajutor.

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

Definiție și utilizare

Elementul <video> încorporează un videoclip, cum ar fi un tutorial sau un film de instruire, într-o pagină de ajutor.

Surse acceptate
  • Microsoft Stream
  • YouTube
  • Facebook
  • Vimeo

Atribute

  • src: Specifică adresa URL a videoclipului. Acest atribut este obligatoriu.

  • allowFullScreen: Specifică dacă utilizatorul poate comuta videoclipul pe ecranul complet. Valorile posibile sunt „adevărat” sau „fals”. Acest atribut nu este acceptat pentru toate sursele video.

  • autoplay: Specifică faptul că videoclipul va începe redarea imediat ce se va încărca pagina de ajutor. Valorile posibile sunt „adevărat” sau „fals”. Acest atribut nu este acceptat pentru toate sursele video.

  • startTime: Specifică, în câteva secunde, din ce punct să începeți redarea videoclipului.

Paragraf

Prezintă un paragraf într-o pagină de ajutor.

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

Definiție și utilizare

Elementul <p> definește un paragraf.

Textul din interiorul unui paragraf poate fi decorat în următoarele moduri:

  • Aldin, cu element <strong>
  • Italic, cu element <em>
  • Tăiat cu o bară, cu element <del>
  • Subliniat, cu element <u>

Aceste decorațiuni pot fi combinate. De exemplu, creați un fragment de text care este atât aldin, cât și subliniat.

Listă cu marcatori

Prezintă o listă cu marcatori într-o pagină de ajutor.

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

Definiție și utilizare

Elementul <ul> definește o listă cu marcatori.

Utilizați elementul <ul> împreună cu elementul <li> pentru a crea liste cu marcatori.

Listă numerotată

Prezintă o listă numerotată într-o pagină de ajutor.

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

Definiție și utilizare

Elementul <ol> definește o listă ordonată (numerotată). Utilizați eticheta <ol> împreună cu elementul <li> pentru a crea liste numerotate.

Care poate fi restrâns

Prezintă o secțiune care poate fi restrânsă într-o pagină de ajutor.

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

Definiție și utilizare

Elementul <collapsible> definește o secțiune de conținut pe care utilizatorul o poate vizualiza sau ascunde la cerere.

Atribute

  • collapsed: Specifică dacă secțiunea este restrânsă sau extinsă inițial. Valori posibile sunt „adevărat” (restrâns) sau „fals” (extins).

Prezintă un link într-o pagină de ajutor.

Link către un site web care se deschide într-o fereastră nouă a browserului:

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

Link către o altă pagină de ajutor:

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

Definiție și utilizare

Eticheta <a> definește un link care permite utilizatorului să navigheze de la o pagină de ajutor la un site web sau la o altă pagină de ajutor.

Atribute

  • href: Specifică adresa URL a site-ului web sau a paginii de ajutor către care să navigați. Acest atribut este obligatoriu.
  • target: Specifică unde să deschideți adresa URL asociată.
    • Dacă nu este prezent sau _self, se presupune că linkul este către o altă pagină de ajutor și este deschis în browserul de ajutor.
    • Dacă _blank, linkul este deschis într-o fereastră nouă a browserului.
    • Dacă _top, linkul este deschis în fereastra actuală a browserului.
    • Dacă valoarea este numele unui iframe, link-ul este deschis în acel iframe.

Marcajul antrenorului

Prezintă un marcaj al antrenorului într-o pagină de ajutor.

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

Definiție și utilizare

O marcă de antrenor este un element interactiv care poate fi utilizat pentru a atrage atenția utilizatorului asupra unui punct specific din UI al aplicației care găzduiește browserul de ajutor.

Atribute

  • target: selector CSS care specifică elementul HTML peste care va fi afișat marcajul antrenorului. Acest atribut este obligatoriu.

Balon

Prezintă un balon într-o pagină de ajutor.

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

Definiție și utilizare

Un balon este un element interactiv care poate fi utilizat pentru a ajuta utilizatorul să realizeze o acțiune în UI al aplicației care găzduiește browserul de ajutor.

Atribute

  • target: selector CSS care specifică elementul HTML peste care va apărea linkul de balon. Acest atribut este obligatoriu.
  • title: Specifică titlul balonului.
  • details: Specifică conținutul de afișat în interiorul balonului.

Notă

Ne puteți spune care preferințele dvs. lingvistice pentru documentație? Răspundeți la un chestionar scurt. (rețineți că acest chestionar este în limba engleză)

Chestionarul va dura aproximativ șapte minute. Nu sunt colectate date personale (angajament de respectare a confidențialității).