Comparteix a través de

Integrar aplicacions del llenç en llocs web i altres serveis

  • Article

Les aplicacions que creeu sovint són més útils si estan disponibles directament on la gent fa la seva feina. En incrustar aplicacions del llenç en un iframe, podeu integrar aquestes aplicacions en llocs web i altres serveis, com ara el Power BI o el SharePoint.

En aquest tema, us mostrarem com definir paràmetres per a la incrustació d'aplicacions; a continuació, incrustarem la nostra aplicació d'ordenació d'actius en un lloc web.

Escriptori digital del Power BI amb una aplicació incrustada

Nota

  • Només els usuaris del Power Apps del mateix inquilí poden accedir a l'aplicació incrustada.
  • No s'admet la incrustació d'aplicacions de llenç en cap aplicació d'escriptori nativa, que inclou Andrioid i iOS. Això exclou les integracions pròpies, com ara Power Apps a Teams.

També podeu integrar les aplicacions del llenç al SharePoint Online sense utilitzar cap iframe. Més informació: Utilitzar l'element Power Apps web.

Definir paràmetres de l'URI per a l'aplicació

Si teniu una aplicació que voleu incrustar, el primer pas és definir paràmetres per a l'identificador de recurs uniforme (URI), de manera que l'iframe sàpiga on trobar l'aplicació. L'URI té el format següent:

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

Per als usuaris del GCC

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

Important

A partir d'agost de 2019, el format d'URI ha canviat de https://web.powerapps.com/webplayer a https://apps.powerapps.com/play. Si us plau, actualitzeu qualsevol iframe integrat per utilitzar el nou format d'URI. Les referències al format anterior redirigiran a l'URI nou per garantir la compatibilitat.

Format anterior:

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

L'única cosa que heu de fer és substituir l'identificador de l'aplicació per [AppID] a l'URI (incloent-hi "[" i "]"). Us mostrarem com obtenir aquest valor en breu, però primer us mostrarem tots els paràmetres disponibles a l'URI:

  • [identificador de l'aplicació] - Proporciona l'identificador de l'aplicació que s'ha d'executar.
  • tenantid - és un paràmetre opcional per admetre l'accés de convidats i determina des de quin inquilí obrir l'aplicació.
  • screenColor : s'utilitza per proporcionar una millor experiència de càrrega d'aplicacions per als usuaris. Aquest paràmetre té el format RGBA (valor vermell, valor verd, valor blau, alfa) i controla el color de la pantalla mentre es carrega l'aplicació. El millor és definir-lo en el mateix color que la icona de l'aplicació.
  • Font : no afecta l'aplicació, però us suggerim que afegiu un nom descriptiu per fer referència a la font de la inserció.
  • Finalment, podeu afegir els paràmetres personalitzats que vulgueu mitjançant la funció Param() i la vostra aplicació pot consumir aquests valors. S'afegeixen al final de l'URI, com ara [AppID]?source=iframe&param1=value1&param2=value2. Aquests paràmetres només es llegeixen durant l'engegada de l'aplicació. Si heu de canviar-los, heu de tornar a iniciar l'aplicació. Heu de tenir en compte que només el primer element després d'[appid] hauria de tenir un "?"; després utilitzeu "&" com s'il·lustra aquí.

Obtenir l'identificador de l'aplicació

L'identificador de l'aplicació està disponible a powerapps.com. Per a l'aplicació que voleu incrustar:

  1. A powerapps.com, a la pestanya Aplicacions , toqueu o feu clic als punts suspensius ( . . . ) i, a continuació , a Detalls.

    Anar als detalls de l'aplicació.

  2. Copieu l'identificador de l'aplicació.

    Copiar l'identificador d'aplicació des dels detalls.

  3. Substituïu el [AppID] valor de l'URI. Per a la nostra aplicació per a l'ordenació d'actius, l'URI té aquest aspecte:

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

És possible que hàgiu de permetre les finestres emergents al navegador quan inseriu una aplicació al vostre lloc web que utilitza la funció Launch() per iniciar una pàgina web o una aplicació.

Incrustar l'aplicació en un lloc web

La incrustació de l'aplicació és ara tan simple com afegir l'iframe al codi HTML del lloc (o qualsevol altre servei que admeti iframes, com ara el Power BI o el SharePoint):

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

Especifica valors per a l'amplada i l'alçada de l'iframe i substitueix l'identificador de l'aplicació [AppID].

Nota

Incloeu-lo allow="geolocation; microphone; camera" al codi HTML de l'iframe per permetre que les aplicacions utilitzin aquestes funcions a Google Chrome.

A la imatge següent es mostra l'aplicació d'ordenació d'actius incrustada en un lloc web d'exemple de Contoso.

Lloc web de Contoso amb l'aplicació incrustada.

Tingueu en compte els punts següents per autenticar els usuaris de l'aplicació:

  • Si el vostre lloc web utilitza Microsoft Entra l'autenticació basada en identificadors, no cal iniciar la sessió addicional.
  • Si el lloc web utilitza qualsevol altre mecanisme d'inici de sessió o no té autenticació, els usuaris veuen una sol·licitud d'inici de sessió a l'iframe. Després d'iniciar la sessió, podreu executar l'aplicació sempre que l'autor de l'aplicació l'hagi compartit.

Com podeu veure, la incrustació de les aplicacions és simple i potent. La incrustació us permet dur les aplicacions directament on treballeu vós i els vostres clients: llocs web, escriptoris digitals del Power BI, pàgines del SharePoint i altres.