Vászonalapú alkalmazások integrálása webhelyekbe és más szolgáltatásokba

A létrehozott alkalmazások gyakran akkor a leghasznosabbak, ha a felhasználók ott férhetnek hozzájuk, ahol dolgoznak. A vászonalapú alkalmazások iframe-be történő beágyazásával ezeket az alkalmazásokat integrálhatja webhelyekre és egyéb szolgáltatásokba, például a Power BI vagy SharePoint alkalmazásokba.

A témakörben azt mutatjuk be, hogyan állíthatja be az alkalmazásbeágyazás paramétereit, majd beágyazzuk a saját Asset Ordering (Eszközrendezés) alkalmazásunkat egy webhelyre.

Power BI-irányítópult beágyazott alkalmazással.

Megjegyzés

  • A beágyazott alkalmazáshoz csak az azonos bérlőben található Power Apps-felhasználók férhetnek hozzá.
  • A vászonalapú alkalmazások natív asztali alkalmazásokba való beágyazása nem támogatott. Ez kizárja a belső integrációkat, például Power Apps a Teamsben).

A vászonalapú alkalmazásokat a SharePoint Online-ba is integrálhatja iframe elemek használata nélkül. További információk: A Power Apps-kijelző használata.

Az alkalmazás URI-paramétereinek beállítása

A beágyazni kívánt alkalmazások esetében az első lépés a Uniform Resource Identifier (URI) paramétereinek beállítása, hogy az IFrame elem megtalálja az alkalmazást. Az URI-t a következő formátumban kell megadni:

https://apps.powerapps.com/play/[AppID]?source=iframe

GCC-felhasználóknak

https://apps.gov.powerapps.us/play/[AppID]?source=iframe

Fontos

  1. augusztusában az URI-formátum https://web.powerapps.com/webplayer értékről https://apps.powerapps.com/play értékre módosult. Frissítse a beágyazott iframe-elemeket az új URI formátum használatára. Az előző formátumra mutató hivatkozások az új URI azonosítóra lesznek átirányítva a kompatibilitás biztosítása érdekében.

Előző formátum:

https://web.powerapps.com/webplayer/iframeapp?source=iframe&appId=/providers/Microsoft.PowerApps/apps/[AppID]

Az egyetlen elvégzendő feladat a saját alkalmazás azonosítójának behelyettesítése az [AppID] helyére (beleértve a szögletes zárójeleket) az URI-ban. Hamarosan megtudhatja, hogyan tudhatja meg ezt az értéket, először azonban tekintsük át az URI összes elérhető paraméterét:

  • [appID] – A futtatandó alkalmazás azonosítóját határozza meg.
  • tenantid – Egy választható paraméter, amely támogatja a vendéghozzáférést, és azt határozza meg, hogy melyik bérlőből nyitja meg az alkalmazást.
  • screenColor – jobb alkalmazásbetöltési felületet biztosít a felhasználók számára. Ez a paraméter az RGBA (vörös érték, zöld érték, kék érték, alfa) formátumban szerepel, és az alkalmazás betöltésének ideje alatt megjelenő képernyő színét határozza meg. Célszerű az alkalmazás ikonjával megegyező színre állítani.
  • source – nincs hatással az alkalmazásra, de javasolt megadni egy leíró nevet, amellyel a beágyazás forrására hivatkozhat.
  • Végül, bármilyen egyéni paramétert hozzáadhat a Param() függvénnyel, ezeket az értékeket pedig az alkalmazás felhasználhatja. Ezek az URI végére kerülnek, például a következőképpen: [AppID]?source=iframe&param1=value1&param2=value2. Ezek a paraméterek csak az alkalmazás indítása során olvashatók be. Ha módosítania kell őket, újra kell indítania az alkalmazást. Ne feledkezzen meg arról, hogy az [appid] után csak az első elemnek kell a "?" szimbólummal rendelkeznie; ezt követően az itt bemutatottt "&" szimbólumot használja.

Alkalmazásazonosító beszerzése

Az alkalmazásazonosító a powerapps.com webhelyen érhető el. A beágyazni kívánt alkalmazás esetében:

  1. A powerapps.com webhely Alkalmazások lapján kattintson vagy koppintson a három pontra ( . . . ), majd a Részletek lehetőségre.

    Az alkalmazás részleteinek megnyitása.

  2. Másolja az alkalmazásazonosítót.

    Az alkalmazásazonosító másolása a Részletek képernyőről.

  3. Cserélje le rá az URI [AppID] értékét. Az Asset Ordering (Eszközrendezés) alkalmazás esetében az URI így néz ki:

    https://apps.powerapps.com/play/76897698-91a8-b2de-756e-fe2774f114f2?source=iframe
    

Előfordulhat, hogy a böngészőben az előugró ablakokat is engedélyeznie kell, amikor egy alkalmazést ágyaz be a webhelyén, amelye a Launch() függvényt használja egy weboldal vagy egy alkalmazás indításához.

Alkalmazás beágyazása egy webhelyre

Az alkalmazás beágyazásához innentől kezdve csupán be kell szúrni az IFrame elemet a webhely (vagy bármely más IFrame elemek használatát támogató szolgáltatás, például a Power BI vagy a SharePoint) HTML-kódjába:

<iframe width="[W]" height="[H]" src="https://apps.powerapps.com/play/[AppID]?source=website&screenColor=rgba(165,34,55,1)" allow="geolocation; microphone; camera"/>

Adja meg az IFrame szélességének és magasságának értékét, majd cserélje az [AppID] értéket az alkalmazásazonosítóra.

Megjegyzés

Az allow="geolocation; microphone; camera" érték az IFrame HTML-kódjában való használatával lehetővé teheti az alkalmazások számára, hogy használják ezeket a képességeket Google Chrome böngészőben.

Az alábbi képen az Asset Ordering (Eszközrendezés) alkalmazás látható egy Contoso-mintawebhelybe beágyazva.

A Contoso webhelye egy beágyazott alkalmazással.

Az alkalmazás felhasználóinak hitelesítésekor vegye figyelembe az alábbi megfontolásokat:

  • Ha webhelye azonosítóalapú hitelesítést használ Microsoft Entra , nincs szükség további bejelentkezésre.
  • Ha a webhely bármilyen másik bejelentkezési módszert alkalmaz, vagy nem használ hitelesítést, a felhasználóknak be kell jelentkezniük az IFrame felületén. A bejelentkezés után futtathatják az alkalmazást, amennyiben annak készítője azt megosztotta velük.

Mint láthatja, az alkalmazások beágyazása egyszerű és hatékony. A beágyazással elérhetővé tehet alkalmazásokat azokon a helyeken, ahol maga és a felhasználói munkát végeznek – webhelyeken, Power BI-irányítópultokon, SharePoint-oldalakon és egyéb helyeken.

Megjegyzés

Megosztja velünk a dokumentációja nyelvi preferenciáit? Rövid felmérés elvégzése. (ne feledje, hogy ez a felmérés angol nyelvű)

A felmérés elvégzése körülbelül hét percet vesz igénybe. Semmilyen személyes adatot nem gyűjtünk (adatvédelmi nyilatkozat).