Interaktív súgó létrehozása a modellvezérelt alkalmazáshoz

Az egyéni súgópanelek és irányított feladatok segítségével biztosíthat az egységesített felület alkalmazáshoz egyéni terméken belüli súgóélményt, amely illeszkedik szervezetéhez. Az egyéni súgópanelek segítségével biztosíthat táblázat-, űrlap- és nyelvfüggő súgót és útmutatást, amelyekben formázott szöveg, tartalmi hivatkozások, képek és videóhivatkozások is szerepelnek.

Fontos

• Az egyéni súgópanelek felváltják az örökölt webes ügyfélalkalmazásokban használt korábbi tanulási útvonal alapú irányított súgófunkciót.
• Az egyéni súgóablakok nem működnek a mobileszközön, például Android iOS táblagépeken és okostelefonokon futó egyesített felületi alkalmazásokkal.

Egyéni súgópanelek és képzési terv

Az egyéni súgópanelek új, irányított súgómegvalósítása eltér a korábbi tanulási útvonalhoz tartozó irányított súgófunkciótól. Mindkét funkció segítségével egyéni súgót hozhat létre az alkalmazáshoz. Az egyéni súgópaneleket azonban az interaktív súgó leggyakrabban használt eseteire optimalizálták.

Az egyéni súgópanelek a következő kulcsfontosságú funkciókat biztosítják, amelyek nem érhetők el a képzési tervben:

• Szabad formátumú formázott szöveg, beleértve a felsorolásjeleket és a számozást is.
• Láthatóan összekapcsolt oktatói jelölések és súgóbuborékok.
• További lehetőségek videóforrásokhoz, beleértve a saját forrásokat is.
• A súgótartalom tárolása a Microsoft Dataverse felületén a megoldás részeként.

Az egyéni súgópanelek nem biztosítják a következő kulcsfontosságú funkciókat, amelyek elérhetők a képzési tervben:

• Egymást követő súgóbuborékok.
• Súgóoldalak szerepkörönként.
• Súgóoldalak eszközönkénti mérethez, például okostelefonokhoz.

Előfeltételek

Az egyéni súgópanelek funkció használatához a környezetnek engedélyeznie kell az egyéni súgópanelek környezeti beállítását.

Engedélyezze az egyéni súgóablakokat a környezetében

1. Jelentkezzen be a Power Platform felügyeleti központba itt: https://admin.powerplatform.microsoft.com.
2. Válassza a Bal oldali panelEn a Kezelés lehetőséget, majd nyissa meg a kívánt környezetet.
3. Válassza a Beállítások lehetőséget a parancssávon, majd válassza a Termékfunkciók lehetőséget>.
4. A Súgó funkciói alatt állítsa az Egyéni súgópanelek engedélyezése beállítást Be értékre.

Fontos

Győződjön meg arról, hogy a testre szabható entitások egyéni súgójaNem értékre van állítva, ellenkező esetben nem kapcsolhatja be az Egyéni súgóablakok engedélyezése funkciót. Ennek az az oka, hogy nem használhatja egyszerre az egyéni súgópaneleket és a testre szabható súgókat.

Szükséges jogosultságok

• A súgóablakok létrehozásához az alkalmazáskészítőknek globális létrehozási, olvasási, írási, törlési és hozzáfűzési jogosultságra van szükségük a Súgóablakok tábláján. Alapértelmezett esetben mind a Rendszergazda, mind a Rendszertestreszabó biztonsági szerepkörök tartalmazzák ezt a jogosultságot.
• Az alkalmazás súgópaneljeinek megtekintéséhez a felhasználóknak olvasási jogosultságra van szükségük a Súgólap táblázatban. Alapértelmezés szerint a Súgóoldal felhasználója biztonsági szerepkör rendelkezik ezzel a jogosultsággal. Alapértelmezés szerint az Alapfelhasználó biztonsági szerepkör nem rendelkezik jogosultsággal a Súgóoldal tábláján.

További információ: Biztonsági szerepkörök és szükséges jogosultságok

Kontextusfüggő egyéni súgó

A súgó minden panelje egyedi a következő kontextusokban:

• Táblázat
• Űrlap
• irányítópult
• Nyelv
• Alkalmazás

Navigáció a súgópanelen

A súgópanel alapértelmezés szerint nyitva marad, és az először megnyitott súgótartalom is, még ha másik űrlapra navigál is. Ez lehetővé teszi, hogy a súgótartalom érintetlen maradjon, miközben az alkalmazás különböző részeire irányítja a felhasználókat.

Súgópanel tartalmának létrehozása

1. A súgó ablaktábla megtekintéséhez nyisson meg egy modellvezérelt alkalmazást, majd a parancssávon válassza a Súgó lehetőséget.

   

2. A Súgó panelen válassza ki a függőleges hárompontos ikont, majd válassza a Szerkesztés lehetőséget.

   

   A súgópanel most már szerkesztőmódban jelenik meg, és a kurzor a súgópanel címén helyezkedik el.

3. A szerkesztőpanelen a következő feladatokat végezheti el:

   • Írja be a szöveget a súgópanel területén közvetlen beírással.
   • Szövegformázás rich text lehetőségek segítségével, listajeles/számozott listák, szakaszok, videók, képek, oktatói jelölések és buboréksúgó hozzáadása.

4. A módosítások mentéséhez válassza a Mentés lehetőséget.

Szabad formátumú szöveg

A szöveg bárhol elhelyezhető a súgópanelen belül. Szabad formátumú szöveg megadása szakaszok előtt, szakaszokban vagy azok után. A szöveg félkövér, dőlt, aláhúzott és áthúzott betűtípust támogat. A kivágás, a másolás és a beillesztés egyaránt használható, valamint a többszintű visszavonás is.

Felsorolásjelek és számozott listák

Felsorolásjel vagy szám ikon kiválasztásával az aktuális sor felsorolásjeles vagy számozott lesz. Ha több sort jelölt ki egy listából, akkor minden sor felsorolásjeles vagy számozott lesz. Váltás a TAB billentyűvel és alszámok illesztése húzása a listán belül.

Szakaszok

A szakasz egy összecsukható szövegmező. Hivatkozásokat vagy szabad formátumú szöveget is elhelyezhet bennük. A hasonló elemek csoportosításához használjon szakaszt. A szakasz alapértelmezés szerint megnyitható vagy összecsukható lehet.

Videó és statikus képek

A súgópanelre videók és statikus képek is beszúrhatók. A videók és képek az interneten található tartalomra mutató hivatkozások. Az egyéni súgópanelek nem tárolják a súgópanelen lévő videó- és képfájlokat. A súgópanel megnyitásakor az egyéni súgópanelek a hivatkozásban megadott tartalmat jelenítik meg. Ha a vállalati tartalomra szeretne hivatkozni, használhat Microsoft Stream videó hivatkozást.

Tipp

Ne feledkezzen meg a kívánt videóhoz vagy képhez tartozó hivatkozás URL-címének másolásáról, hogy beilleszthesse azt a súgópanelre.

Az egyéni súgópanel a következő videóforrásokat támogatja:

• Microsoft Stream (Klasszikus) (privát tartalomhoz használható)
• YouTube
• Facebook
• Vimeo

Csatolások

A hivatkozások mutathatnak weboldalakra, és megnyithatók ugyanabban az ablakban (az alapértelmezettben), illetve külön ablakban is. A meglévő súgóoldalhoz való hivatkozás lehetősége még nem engedélyezett.

Buborékok és oktatói jelölések

A buborékok és az útmutató jelölések meghatározott felhasználói felület elemeire való rámutatáshoz használhatók. A buborék tartalmazhat szöveget.

Az oktatói jelölés egyszerűen kiemelt egy elemet az oktatói mutatóval, hogy felhívja a felhasználó figyelmét egy UI-elemre.

A célokat a szerzőnek a buborékok és a oktatói jelölések tulajdonságai között húzással kell meghatároznia. A szerző meg tudja adni az oktatói jelölés címének és leírásának szövegét.

Megjegyzés

• Az egyéni összetevőkkel nem működnek jól a buborékok és az oktatói jelölések. Ez a funkció csak az alapértelmezett egyesített felület felhasználóifelület-elemeire vonatkozik.
• A rendszer még nem támogatja a egymás után következő súgó buborékokat és oktatói jelöléseket.

Megoldások és az egyéni súgópanel tartalma

A teljes súgótartalom a Dataverse-ben lesz tárolva súgóoldal-összetevőként a megoldása részeként. Ha a megoldást egyik környezetből a másikba helyezi át, például a tesztekörnyezetből a működési környezetbe, megadhatja, hogy a rendszer exportálja a súgóban szereplő sorokat, így azok szerepelnek-e a megoldásban. Ez lehetővé teszi, hogy a súgó tartalmát szinkronban tartsa a megoldás funkcióival, miközben azt különböző környezetekre helyezi át. A megoldás részeként az egyéni súgópanelek támogatják az összes szabványos megoldásalkalmazás életcikluskezelés (ALM) funkcióit.

Tartalom áthelyezése megoldásokon keresztül

Alapértelmezés szerint az összes új súgóoldal megjelenik az alapértelmezett megoldásban. Ha a tartalmat másik környezetbe szeretné áthelyezni, akkor az exportálás előtt először vegye fel a meglévő súgóoldalakat egy nem felügyelt megoldásba. Ha egy nem felügyelt megoldáshoz szeretne hozzáadni egy súgóoldalt, hajtsa végre a következő lépéseket:

1. Jelentkezzen be Power Apps.
2. A bal oldali navigációs panelen válassza a Megoldások lehetőséget. Ha az elem nem szerepel az oldalsó panel paneljén, válassza a ... Tovább, majd válassza ki a kívánt elemet.
3. Nyissa meg a kívánt nem felügyelt megoldást.
4. Válassza a Meglévő hozzáadása lehetőséget a parancssávon, majd válassza a Súgóoldal lehetőséget.
5. Jelölje ki a hozzáadni kívánt súgólapokat, majd válassza a Hozzáadás lehetőséget. További információ: Megoldások exportálása

Súgóoldal dokumentációjának automatizálása

Előfordulhat, hogy egy forráskód-ellenőrzési rendszerbe szeretne biztonsági mentést készíteni a tartalomról, vagy ott tárolni azt. A súgópanel tartalmán is használhat dokumentációautomatizálási eszközöket, például fordítástámogató eszközöket vagy ellenőrzőket. Az egyéni súgópanel adatait a rendszer közvetlenül tárolja a Dataverse szolgáltatásban, és az adatok exportálhatók és importálhatók erre a célra.

Az egyéni súgópanel egyéni XML-formátumot támogat. Ez a formátum az alábbiakban van dokumentálva. További információ: Egyéni súgó XML-definíciója

Exportáláskor a rendszer minden egyes súgóoldalt külön fájlként exportál.

A Környezetfüggő súgó felügyelt megoldás

Az egyéni súgópanelek és az irányított feladatok szolgáltatás a Környezetfüggő súgó felügyelt megoldás megoldás-összetevőiből áll. A rekordok testreszabása vagy létrehozása a táblák használatával az egyéni súgóablakok és az irányított feladatok funkción kívül nem támogatott.

Vegye figyelembe, hogy egyes alkalmazások, például a Dynamics 365 Sales és a Dynamics 365 Service, olyan első indításkori felhasználói élményeket tartalmaznak, amelyek a Környezeti súgó felügyelt megoldásban található táblák felhasználásával készültek. Például a Súgóoldal (msdyn_helppage) és a Bemutató (msdyn_tour) táblákat is ezen első használati élmények létrehozásához használják. Jelenleg az egyéni súgópanelek és az irányított feladatok funkció nem támogatja ezeknek az első futtatási élményeknek a létrehozását.

Gyakori kérdések

Ez a rész az egyéni súgóoldalakkal kapcsolatban gyakran feltett kérdéseket ismerteti.

Az egyéni súgóoldalak megegyeznek a testreszabható súgóval?

Az egyéni súgópanelek és az irányított feladatok a rendszerbeállítások Egyéni súgó URL-cím beállítása szakaszában találhatók. Az egyéni súgópanelek és az irányított feladatok lehetővé tesznek testreszabható súgópanelt, amely közvetlenül a felhasználó űrlapja mellett jelenik meg. Ebben a rendszerbeállításban az egyéni súgószakasz egyéb beállításai testreszabható súgófunkciókat tartalmaznak. Lehetővé teszik az alkalmazások alapértelmezett súgójának felülbírálását, és a szervezet felhasználóit egy másik URL-re irányítják súgóért. Alternatívaként felülbírálhatja egy erősen testreszabott táblához tartozó súgót, hogy jobban leírhassa a munkafolyamatát.

További információ a testreszabható súgóról: Testreszabható súgó engedélyezése és használata.

Hogyan telepíthetők át az adatok a képzési tervből az egyéni súgóoldalakra?

A tanulási útvonal kétféle segítséget kínál: súgóablakokat és egymást követő súgóbuborékokat. A szekvenciális súgóbuborék alaposan integrált a régi webes ügyfélprogram felhasználói felületével, és nem vihető át az új egyéni súgópanelekhez.

Attól függően, hogy mennyi szöveggel rendelkezik az interaktív súgóban, a legkönnyebb lehet, ha egyszerűen átmásolja az információkat közvetlenül a képzési terv felhasználói felületéről az új egyéni súgópanel felhasználói felületére. Emellett a képzési terv súgójának tartalmát is exportálhatja. Ennek legegyszerűbb módja, ha a tartalmat a Tanulási útvonal>Tartalomtár>Honosítás>Exportálás funkció használatával exportálja. Jelöljük ki a kívánt sorokat, majd exportáljuk őket. Ezzel egy XLIFF-fájlt hoz létre minden súgópanelhez és irányított feladathoz. Ezután használjon nyilvánosan elérhető XLIFF-szerkesztőt vagy XLIFF–HTML-konvertálót a tartalom beolvasásához.

Egyéni súgó XML definíciója

Ez a szakasz az egyéni súgó XML-definícióját ismerteti.

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>

Definíció és felhasználás

Az <pphml> elem közli a súgóböngészővel, hogy ez egy PPHML dokumentum.

Az <pphml> elem a PPHML dokumentum gyökerét jelöli.

Az <pphml> elem az összes többi PPHML elem tárolója.

Cím

A súgóoldalon szereplő címet jeleníti meg.

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

Definíció és felhasználás

Az <h1> elem határozza meg a súgólap címét.

<h1> Ennek kell a <pphml> első elemének lennie.

Image

A súgóoldalon szereplő képet jeleníti meg.

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

Definíció és felhasználás

Az <img> elem beágyazza a képet egy súgóoldalba.

Attribútumok

• src: Megadja egy kép URL-címét. Az attribútum kötelező.

• title: Megadja a képpel együtt megjelenítendő címet, általában lebegő elemleírásként.

• alt: Megadja a kép alternatív szövegét. Ezt a szöveget képernyőolvasók használják.

Video

A súgóoldalon szereplő videót jeleníti meg.

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

Definíció és felhasználás

Az <video> elem beágyazik egy videót, például oktatóanyagot vagy oktatófilmet egy súgóoldalra.

Támogatott források

• Microsoft Stream
• YouTube
• Facebook
• Vimeo

Attribútumok

• src: Megadja a videó URL-címét. Az attribútum kötelező.

• allowFullScreen: Megadja, hogy a felhasználó átkapcsolhatja-e a videót teljes képernyőre. A lehetséges értékek: „igaz” vagy „hamis”. Ez az attribútum nem támogatott minden videóforrásnál.

• autoplay: Megadja, hogy a videó lejátszása a súgóoldal betöltése után azonnal elinduljon. A lehetséges értékek: „igaz” vagy „hamis”. Ez az attribútum nem támogatott minden videóforrásnál.

• startTime: Megadja másodpercben, hogy melyiktől kezdje el a videó lejátszását.

Bekezdés

A súgóoldalon szereplő bekezdést jeleníti meg.

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

Definíció és felhasználás

Az <p> elem egy bekezdést határoz meg.

A bekezdésen belüli szöveg az alábbi módokon díszíthető:

• Félkövér, <strong> elemmel
• Dőlt, <em> elemmel
• Áthúzott, <del> elemmel
• Aláhúzás, <u> elemmel

Ezek a díszítések kombinálhatók. Például hozzon létre egy olyan szövegrészletet, amely egyszerre félkövér és aláhúzott.

Listajeles felsorolás

Felsorolásjeles listát jelenít meg egy súgóoldalon.

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

Definíció és felhasználás

A(z) <ul> elem egy felsorolásjeles listát definiál.

A <ul> elem és a <li> elem együttes használatával felsorolásjeles listákat hozhat létre.

Számozott lista

A súgóoldalon szereplő számozott listát jeleníti meg.

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

Definíció és felhasználás

Az <ol> elem egy rendezett (számozott) listát határoz meg. A <ol> címkét a <li> elemmel együtt használja számozott listák létrehozásához.

Összecsukható

Egy összecsukható szakaszt jelenít meg a súgóoldalon.

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

Definíció és felhasználás

Az <collapsible> elem egy olyan tartalomszakaszt határoz meg, amelyet a felhasználó igény szerint megtekinthet vagy elrejthet.

Attribútumok

• collapsed: Megadja, hogy a szakasz kezdetben össze van-e csukva vagy ki van-e bontva. A lehetséges értékek: „igaz” (összecsukott) vagy „hamis” (kibontott).

Hivatkozás

A súgóoldalon szereplő hivatkozást jeleníti meg.

Az új böngészőablakban megnyíló webhelyre mutató hivatkozás:

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

Másik súgóoldalra mutató hivatkozás:

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

Definíció és felhasználás

A <a> címke egy hivatkozást határoz meg, amely lehetővé teszi a felhasználó számára, hogy egy súgóoldalról egy webhelyre vagy egy másik súgóoldalra navigáljon.

Attribútumok

• href: Megadja annak a webhelynek vagy súgóoldalnak az URL-címét, amelyre navigálni szeretne. Az attribútum kötelező.
• target: Megadja, hogy hol nyissa meg a csatolt URL-címet.
  • Ha nincs jelen, vagy _self, akkor feltételezzük, hogy a hivatkozás egy másik súgóoldalra mutat, és a súgóböngésző nyitja meg.
  • _blankHa a hivatkozás egy új böngészőablakban nyílik meg.
  • Ha _top a hivatkozás az aktuális böngészőablakban nyílik meg.
  • Ha az érték egy iframe neve, akkor a hivatkozás az adott iframe-ben nyílik meg.

Oktatói jelölés

A súgóoldalon szereplő oktatói jelölést jeleníti meg.

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

Definíció és felhasználás

Az oktatói jelölés egy olyan interaktív elem, amellyel a felhasználó figyelmét a súgóböngészőt működtető alkalmazás felhasználói felületének egy adott pontjára terelheti.

Attribútumok

• target: CSS-szelektor, amely meghatározza azt a HTML-elemet, amely felett megjelenik a coach mark. Az attribútum kötelező.

Buborék

Buborékot jelenít meg egy súgóoldalon.

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

Definíció és felhasználás

A buborék egy olyan interaktív elem, amely segíti a felhasználót műveletek elvégzésében a súgóböngészőt működtető alkalmazás felhasználói felületén.

Attribútumok

• target: CSS-szelektor, amely meghatározza azt a HTML-elemet, amely felett a buborékhivatkozás megjelenik. Az attribútum kötelező.
• title: A buborék címét adja meg.
• details: Megadja a buborékon belül megjelenítendő tartalmat.