Dijeli putem

Stvaranje vođene pomoći za vašu aplikaciju s objedinjenim sučeljem

  • Članak

Upotrijebite prilagođena okna za pomoć i vođene zadatke da biste svojoj aplikaciji s objedinjenim sučeljem dali prilagođeno iskustvo pomoći u proizvodu prilagođeno vašoj tvrtki ili ustanovi. Upotrebljavajte prilagođena okna pomoći za pružanje pomoći za dobivanje tablice, obrasca i smjernica specifičnih za jezik koji uključuju obogaćeni tekst, veze na sadržaj, slike i veze na video.

Važno

  • Prilagođena okna za pomoć zamjenjuju prethodnu značajku pomoći vođenog učenja koja se upotrebljava s naslijeđenim aplikacijama za web-klijente.
  • Prilagođena okna pomoći ne funkcioniraju s objedinjeno sučelje aplikacijama koje rade na mobilnom uređaju, kao Android iOS što su tableti i pametni telefoni.

Prilagođena okna za pomoć i vođeno učenje

Nova implementacija vođene pomoći putem prilagođenih okna za pomoć razlikuje se od prethodne značajke pomoći putem vođenog učenja. Obje značajke omogućuju vam stvaranje prilagođene pomoći za aplikaciju. No prilagođena okna za pomoć optimizirana su za najčešće scenarije vođene pomoći.

Prilagođena okna za pomoć pružaju sljedeće ključne značajke koje nisu dostupne u vođenom učenju:

  • Bogati tekst slobodnog oblika, uključujući popise s grafičkim oznakama i numeriranjem
  • Vidljivo povezane oznake za upućivanje i balone za pomoć
  • Više opcija za videoizvore, uključujući privatne izvore
  • Pohrana sadržaja pomoći u usluzi Microsoft Dataverse kao dio vašeg rješenja

Prilagođena okna za pomoć ne pružaju sljedeće ključne značajke koje su dostupne u vođenom učenju:

  • Sekvencijalni baloni za pomoć
  • Stranice pomoći po ulozi
  • Stranice pomoći za pojedine formate hardvera, npr. pametne telefone.

Preduvjeti

Da biste upotrebljavali prilagođenu značajku okna za pomoć, vašem je okruženju potrebno sljedeće:

Omogućivanje prilagođenih okna za pomoć za vaše okruženje

  1. Otvorite aplikaciju stvorenu prema modelu, a zatim na naredbenoj traci odaberite Postavke Postavke. > Napredne postavke.

  2. Idite na Postavke > Sustav > Administracija.

  3. Na stranici Administracija kliknite Postavke sustava.

  4. Na kartici Općenito u odjeljku Postavljanje prilagođenog URL-a za pomoć odaberite Da za mogućnost Omogući prilagođena okna za pomoć i vođene zadatke, a zatim odaberite U redu.

    Omogućite prilagođena okna za pomoć.

Važno

  • Možete omogućiti prilagođena okna za pomoć ili pomoć koja se može prilagoditi, ali ne oboje istodobno. Provjerite jesu li postavke Koristi prilagođenu pomoć za tablice koje se mogu prilagoditi i Dodavanje parametar u URL postavljene na Ne.
  • Za neka okruženja će možda biti potrebno da postavite i mogućnost Omogući vođeno učenje na Da.

Potrebne privilegije

  • Kako bi pomogli autorima okna za pomoć, proizvođači aplikacija trebaju imati globalno stvaranje, čitanje, pisanje, brisanje, dodavanje i dodavanje privilegija na tablici Stranica za pomoć. Prema zadanim postavkama tu privilegiju imaju sigurnosne uloge Administrator sustava i Osoba za prilagodbu sustava.
  • Za prikaz okna pomoći u aplikaciji korisnicima je potrebna privilegija čitanja na tablici Stranica za pomoć. Prema zadanim postavkama ovu privilegiju ima sigurnosna uloga potrošača stranice za pomoć. Prema zadanim postavkama, sigurnosna uloga osnovnog korisnika nema nikakve privilegije na tablici stranice pomoći.

Dodatne informacije: Sigurnosne uloge i privilegije

Kontekstna prilagođena pomoć

Svako okno za pomoć jedinstveno je za ove kontekste:

  • Aplikacija
  • Tablica
  • Obrazac
  • Jezik

Navigacija okna za pomoć

Prema zadanim postavkama okno pomoći ostaje otvoreno na sadržaju pomoći s kojim ste ga isprva otvorili čak i kada prijeđete na neki drugi obrazac. To omogućava da sadržaj pomoći ostane netaknut dok usmjeravate korisnike u različite dijelove aplikacije.

Oblikovanje sadržaja okna za pomoć

  1. Za prikaz okna za pomoć otvorite aplikaciju utemeljenu na modelu, a zatim na naredbenoj traci odaberite Pomoć.

    Pomoć.

  2. Na oknu za pomoć odaberite okomitu elipsu, a zatim odaberite Uredi.

    Uredite pomoć.

    Okno za pomoć sada je u načinu uređivanja, a pokazivač se nalazi na naslovu okna za pomoć.

  3. Iz okna za uređivanje možete izvesti sljedeće zadatke:

    • Unesite tekst upisivanjem izravno u područje okna za pomoć.
    • Formatirajte tekst pomoću mogućnosti obogaćenog teksta i dodajte popise grafičkih oznaka / numerirane popise, odjeljke, videozapise, slike, poveznice, oznake za upućivanje i pomoć u obliku balona.

  4. Za spremanje promjena odaberite Spremi.

Tekst u slobodom obliku

Tekst se može postaviti bilo gdje unutar okna za pomoć. Unesite tekst u slobodnom obliku prije odjeljka, u odjeljku ili nakon odjeljka. Tekst podržava podebljane, kurzivne, podcrtane i precrtane formate fontova. Može se koristiti izrezivanje, kopiranje i lijepljenje kao i višeslojno poništavanje.

Popisi s grafičkim oznakama i numerirani popisi

Odabirom ikone grafičke oznake ili broja trenutnom retku dodaje se grafička oznaka ili broj. Ako ste odabrali više redaka na popisu, svaki redak označava se grafičkom oznakom ili brojem. Dodavanjem tabulatora i uvlačenjem podbrojevi se poravnavaju na popisu.

Odjeljci

Odjeljak je tekstni okvir koji se može sažeti. U njega možete staviti veze ili tekst slobodnog oblika. Upotrijebite odjeljak za grupiranje sličnih stavki. Odjeljak prema zadanim postavkama može biti otvoren ili sažet.

Videozapisi i statičke slike

U okno za pomoć možete umetnuti videozapise i statičke slike. Videozapisi i slike veze su do sadržaja na internetu. Prilagođena okna za pomoć ne pohranjuju videozapise i slikovne datoteke u oknu za pomoć. Kada se otvori okno za pomoć, prilagođena okna za pomoć dovode sadržaj iz veze kako bi se prikazao. Možete koristiti vezu do videozapisa na usluzi Microsoft Stream ako želite uputiti na privatni korporativni sadržaj.

Savjet

Ne zaboravite kopirati URL veze za željeni videozapis ili sliku kako biste ga mogli zalijepiti u okno za pomoć.

Prilagođena okna za pomoć podržavaju sljedeće videoizvore:

  • Microsoft Stream (Klasično) (koristi se za privatni sadržaj)
  • YouTube
  • Facebook
  • Vimeo

Veze mogu voditi do web-mjesta i otvoriti se u istom prozoru (zadano) ili u zasebnom prozoru. Mogućnost povezivanja na postojeću stranicu pomoći još nije omogućena.

Baloni i oznake za upućivanje

Baloni i oznake za upućivanje mogu se koristiti za ukazivanje na određene elemente korisničkog sučelja. Balon može sadržavati tekst.

Umetanje balona

Oznaka za upućivanje jednostavno ističe element pomoću pokazivača uputnice kako bi skrenula pozornost korisnika na taj element korisničkog sučelja.

Umetanje oznaka za upućivanje

Autor treba definirati cilj pomoću mogućnosti povlačenja i ispuštanja u svojstvima balona i oznaka za upućivanje. Autor može unijeti tekst za naslov i opis za oznake za upućivanje.

Povuci i ispusti

Napomena

  • Baloni i oznake za upućivanje ne funkcioniraju dobro s prilagođenim komponentama. Ova se značajka odnosi samo na zadane objedinjeno sučelje komponenti korisničkog sučelja.
  • Sekvencijalni baloni pomoći i oznake za upućivanje još nisu podržani.

Rješenja i prilagođeni sadržaj okna za pomoć

Sav sadržaj pomoći pohranjuje se u komponenti stranice za pomoć u usluzi Dataverse kao dio vašeg rješenja. Kada premještate rješenje iz jednog okruženja u drugo, na primjer iz testiranja u proizvodnju, možete definirati da se redovi pomoći izvoze tako da budu uključeni u rješenje. To vam omogućuje da sadržaj pomoći sinkronizirate sa značajkama vašeg rješenja kada se premješta u različita okruženja. Kao dio vašeg rješenja, prilagođena okna za pomoć podržavaju sve značajke standardnog upravljanja životnim ciklusom aplikacija (ALM).

Premještanje sadržaja putem rješenja

Prema zadanim postavkama sve se nove stranice pomoći pojavljuju u zadanom rješenju. Ako želite premjestiti svoj sadržaj u neko drugo okruženje, prvo dodajte postojeće stranice pomoći u neupravljano rješenje prije nego što ih izvezete. Da biste dodali stranicu pomoći u neupravljano rješenje, slijedite ove korake:

  1. Prijava u Power Apps.
  2. U lijevom navigacijskom oknu odaberite Rješenja. Ako stavka nije u bočnom oknu, odaberite …Više a zatim odaberite željenu stavku.
  3. Otvorite željeno neupravljano rješenje.
  4. Odaberite Dodaj postojeće na naredbenoj traci, a zatim Stranica pomoći.
  5. Odaberite stranice pomoći koje želite dodati, a zatim Dodaj. Dodatne informacije: Izvoz rješenja

Automatizacija dokumentacije stranice pomoći

Možda želite sigurnosno kopirati ili pohraniti sadržaj u sustav za kontrolu izvornog koda. Možda biste također željeli koristiti alate za automatizaciju dokumentacije, kao što su prevodilački alati ili alati za provjeru, na sadržaju okna za pomoć. Podaci prilagođenog okna za pomoć pohranjuju se izravno u usluzi Dataverse te se u tu svrhu mogu izvoziti i uvoziti.

Prilagođena okna za pomoć podržavaju prilagođeni XML format. Taj je format dokumentiran u nastavku. Dodatne informacije: XML definicija prilagođene pomoći

Pri izvozu svaka se stranica pomoći izvozi kao zasebna datoteka.

O upravljanom rješenju kontekstualne pomoći

Prilagođena okna pomoći i značajka vođenih zadataka sastoje se od komponenti rješenja u upravljanom rješenju kontekstualne pomoći. Prilagodba ili stvaranje zapisa pomoću tablica izvan prilagođenih okna pomoći i značajke vođenih zadataka nije podržano.

Primijetite da neke aplikacije, kao što su Dynamics 365 Sales i Dynamics 365 Service, uključuju iskustva prvog pokretanja koja su izrađena upotrebom tablica uključenih u upravljano rješenje kontekstualne pomoći. Na primjer, i tablice stranice pomoći (msdyn_helppage) i obilaska (msdyn_tour) upotrebljavaju se u stvaranju ovih iskustava prvog pokretanja. Trenutačno prilagođena okna pomoći i značajka vođenih zadataka ne podržavaju stvaranje ovih iskustava prvog pokretanja.

Najčešća pitanja

Ovaj se odjeljak bavi najčešćim pitanjima o prilagođenim stranicama pomoći.

Jesu li prilagođene stranice pomoći isto što i pomoć koja se može prilagoditi?

Prilagođena okna za pomoć i vođeni zadaci opcija su u odjeljku Postavljanje URL-a prilagođene pomoći u postavkama sustava. Prilagođena okna za pomoć i vođeni zadaci omogućavaju okno za pomoć koje se može prilagoditi i koje se prikazuje odmah pored korisničkog obrasca. Ostale opcije u ovom skupu postavki sustava prilagođene pomoći čine značajke pomoći koje se mogu prilagoditi. One omogućuju zamjenu zadane pomoći za aplikaciju i korisnike vaše tvrtke ili ustanove usmjeravaju na drugi URL za pomoć. Možete i zaobići pomoć za izrazito prilagodljivu tablicu da biste bolje opisali tijek rada.

Dodatne informacije o pomoći koja se može prilagoditi potražite u članku Omogućivanje i upotreba pomoći koja se može prilagoditi

Kako mogu premjestiti podatke iz vođenog učenja na prilagođene stranice pomoći?

Vođeno učenje ima dvije vrste pomoći: okna za pomoć i slijed balona za pomoć. Lokacije slijeda balona za pomoć duboko su integrirane s naslijeđenim korisničkim sučeljem web-klijenta i ne mogu se prenijeti na nova prilagođena okna za pomoć.

Ovisno o tome koliko teksta imate u vođenoj pomoći, možda je najlakše jednostavno kopirati podatke izravno s korisničkog sučelja vođenog učenja na novo korisničko sučelje okna za pomoć. No možete i izvesti sadržaj pomoći vođenog učenja. Najjednostavniji način za to jest da izvezete sadržaj koristeći značajku izvoza dostupnu putem izbornika Vođeno učenje > Biblioteka sadržaja > Lokaliziraj > Izvezi. Odaberite retke koje želite i zatim ih izvezite. Time se stvara XLIFF datoteka za svako okno za pomoć i vođeni zadatak. Zatim upotrijebite javno dostupan XLIFF uređivač ili pretvornik XLIFF formata u HTML format da biste dohvatili svoj sadržaj.

XML definicija prilagođene pomoći

Ovaj odjeljak opisuje XML definiciju prilagođene pomoći.

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

<pphml> element pregledniku pomoći govori da je ovo PPHML dokument.

<pphml> element predstavlja korijen PPHML dokumenta.

<pphml> element je spremnik za sve ostale PPHML elemente.

naslov

Predstavlja naslov na stranici za pomoć.

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

Definicija i upotreba

<h1> element definira naslov stranice pomoći.

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

Slika

Predstavlja sliku na stranici pomoći.

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

Definicija i upotreba

<img> element ugrađuje sliku u stranicu pomoći.

Atributi

  • src: određuje URL slike. Taj je atribut obavezan.

  • title: određuje naslov koji će se prikazati zajedno sa slikom, obično kao opis koji se prikazuje pri zadržavanju pokazivača.

  • alt: određuje zamjenski tekst za sliku. Taj tekst koriste čitači zaslona.

Videozapis

Predstavlja videozapis na stranici pomoći.

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

Definicija i upotreba

<video> element ugrađuje videozapis, kao što je tutorial ili film za obuku, u stranicu pomoći.

Podržani izvori
  • Microsoft Stream
  • YouTube
  • Facebook
  • Vimeo

Atributi

  • src: određuje URL videozapisa. Taj je atribut obavezan.

  • allowFullScreen: određuje može li korisnik prebaciti videozapis na cijeli zaslon. Moguće vrijednosti su „true” ili „false”. Ovaj atribut nije podržan za sve videoizvore.

  • autoplay: određuje da će se videozapis početi reproducirati čim se učita stranica pomoći. Moguće vrijednosti su „true” ili „false”. Ovaj atribut nije podržan za sve videoizvore.

  • startTime: određuje, u sekundama, od koje točke treba započeti reprodukciju videozapisa.

Odlomak

Predstavlja odlomak na stranici pomoći.

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

Definicija i upotreba

<p> element definira odlomak.

Tekst unutar odlomka može se ukrasiti na sljedeće načine:

  • Podebljano, s elementom <strong>
  • Kurzivno, s elementom <em>
  • Precrtano, s elementom <del>
  • Podcrtano, s elementom <u>

Ovi ukrasi mogu se kombinirati. Na primjer, oblikujte ulomak teksta koji je i podebljan i podcrtan.

Popis s grafičkim oznakama

Predstavlja popis s grafičkim oznakama na stranici pomoći.

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

Definicija i upotreba

<ul> element definira popis s grafičkim oznakama.

Koristite <ul> element zajedno s <li> elementom za stvaranje popisa s grafičkim oznakama.

Numerirani popis

Predstavlja numerirani popis na stranici pomoći.

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

Definicija i upotreba

<ol> element definira poredani (numerirani) popis. Koristite <ol> oznaku zajedno s <li> elementom za stvaranje numeriranih popisa.

Sažimanje

Predstavlja odjeljak koji se može sažeti na stranici pomoći.

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

<collapsible> element definira odjeljak sadržaja koji korisnik može prikazati ili sakriti na zahtjev.

Atributi

  • collapsed: određuje je li odjeljak na početku sažet ili proširen. Moguće vrijednosti su „true” (sažet) ili „false” (proširen).

Predstavlja vezu na stranici pomoći.

Veza na web-mjesto koje se otvara u novom prozoru preglednika:

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

Veza na drugu stranicu pomoći:

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

Definicija i upotreba

Oznaka <a> definira vezu koja korisniku omogućuje kretanje sa stranice pomoći do web-mjesta ili do druge stranice pomoći.

Atributi

  • href: određuje URL web-mjesta ili stranice pomoći koja se otvara. Taj je atribut obavezan.
  • target: određuje mjesto otvaranja povezanog URL-a.
    • Ako nije prisutan ili je _self, pretpostavlja se da veza vodi na drugu stranicu pomoći i ona se otvara u pregledniku pomoći.
    • Ako je _blank, veza se otvara u novom prozoru preglednika.
    • Ako je _top, veza se otvara u postojećem prozoru preglednika.
    • Ako je vrijednost naziv za iframe, veza se otvara u tom iframeu.

Oznaka za upućivanje

Predstavlja oznaku za upućivanje na stranici pomoći.

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

Definicija i upotreba

Oznaka za upućivanje interaktivni je element koji se može upotrijebiti za skretanje korisnikove pozornosti na određenu točku na korisničkom sučelju aplikacije u kojoj se nalazi preglednik pomoći.

Atributi

  • target: CSS selektor koji određuje HTML element nad kojim će se prikazati oznaka za upućivanje. Taj je atribut obavezan.

Balon

Predstavlja balon na stranici pomoći.

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

Balon je interaktivni element koji se može upotrijebiti za pomoć korisniku u obavljanju radnje na korisničkom sučelju aplikacije u kojoj se nalazi preglednik pomoći.

Atributi

  • target: CSS selektor koji određuje HTML element nad kojim će se prikazati veza balona. Taj je atribut obavezan.
  • title: određuje naziv balona.
  • details: određuje sadržaj za prikaz u balonu.

Napomena

Možete li nam reći više o željenim jezicima za dokumentaciju? Ispunite kratki upitnik. (imajte na umu da je upitnik na engleskom jeziku)

Ispunjavanje upitnika će trajati otprilike sedam minuta. Osobni podaci se ne prikupljaju (izjava o zaštiti privatnosti).