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 leváltják az előző képzési terv korábbi webes ügyfélprogramokkal használható, irányított súgó funkciójá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 interaktív súgójának telepített változata eltér az előző képzési terv interaktív súgófunkciójá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.

Súgópanelek engedélyezése a környezethez

1. Jelentkezzen be a Power Platform felügyeleti központba itt: https://admin.powerplatform.microsoft.com.
2. A kiválasztott környezet Gépháza válassza a Termékjellemzők lehetőséget>.
3. A Súgó funkciói alatt kapcsolja be az Egyéni súgópanelek engedélyezése beállítást.

Fontos

Engedélyezheti az egyéni súgópaneleket vagy testreszabhatja a súgót, de a kettő egyszerre nem lehetséges. Győződjön meg arról, hogy a Súgó használata testreszabható entitásokhoz Nem értékre van állítva.

Szükséges jogosultságok

• A súgópanelek létrehozásához az alkalmazáskészítőknek globális létrehozásra, olvasásra, írásra, törlésre, hozzáfűzésre és hozzáfűzésre van szükségük a Súgólap táblában. 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 Látogató segítése biztonsági szerepkör rendelkezik ilyen engedéllyel. 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

Környezetfüggő egyéni súgó

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

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

Súgópanel navigációja

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-tartalom készítése

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árom pontot, 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 segítségével jeleníthető meg a tartalom a hivatkozásból. 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 oktatói jelölések meghatározott felhasználóifelület-elemekre mutatnak. 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.

Feljegyzé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ólap 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 létrehozása az egyéni súgóablakon kívüli táblákból és az irányított feladatok funkció nem támogatott.

Figyelje meg, hogy egyes alkalmazások, például a Dynamics 365 Sales és Dynamics 365 Service olyan első futtatási élményeket tartalmaznak, amelyeket a Környezetfüggő súgó felügyelt megoldás is tartalmaz. Az első futtatás során használt élmények létrehozásakor például a Súgó oldal (msdyn_helppage) és a Bemutató (msdyn_tour) táblázatok is használva vannak. 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. Megengedik az alapértelmezett alkalmazássúgó felülbírálását, és a szervezet felhasználóit egy másik URL-re irányítja segítségért. Ellenkező esetben felülírhatja a Súgót egy jobban testreszabott táblával, a munkafolyamat érthetőbb leírása érdekében.

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 képzési tervnek két típusa van: a súgópanelek és a szekvenciális súgóbuborékok. 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 exportálja a tartalmat a Képzési terv>tartalomtár>Exportálás>honosítása funkciójával. 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 lennie az első elemnek belül. <pphml>

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

• Merész, elemmel <strong>
• Dőlt, elemmel <em>
• Áthúzott, elemmel <del>
• Aláhúzás, elemmel <u>

Ezek a díszítések kombinálhatók. Például lehet a szöveg egy része félkövér és aláhúzott.

Felsorolásjellel ellátott lista

A súgóoldalon szereplő felsorolásjellel ellátott listát jeleníti meg.

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

Definíció és felhasználás

Az <ul> elem egy listajeles listát határoz meg.

Az elem és az <ul> elem együttes használatával <li> listajeles 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 címkét az elemmel <ol> együtt számozott listák létrehozásához használhatja <li> .

Összecsukható

A súgóoldalon szereplő összecsukható szakaszt jeleníti meg.

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

Csatolá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 meg, _self akkor a hivatkozás egy másik súgóoldalra mutat, és a súgóböngészőben nyílik 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 név iframe, akkor a hivatkozás abban az 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 selector elemet, amely megadja azt a HTML-elemet, amelyen az edzőjel megjelenik. Az attribútum kötelező.

Buborék

A súgóoldalon szereplő buborékot jeleníti meg.

<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 selector elemet, amely megadja 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.