Integrar aplicacions del llenç en llocs web i altres serveis

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.

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

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

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:

• [appID]: proporciona l'identificador de l'aplicació que s'executarà.
• tenantid: és un paràmetre opcional per admetre l'accés de convidat i determina des de quin inquilí obrir l'aplicació.
• screenColor: s'utilitza per oferir una millor experiència de càrrega de l'aplicació per als usuaris. Aquest paràmetre és en el format RGBA (valor vermell, valor verd, valor blau, alfa) i controla el color de la pantalla mentre l'aplicació es carrega. El millor és definir-lo en el mateix color que la icona de l'aplicació.
• source: no afecta l'aplicació, però es suggereix que afegiu un nom descriptiu per referir-se a l'origen de la incrustació.
• Finalment, podeu afegir els paràmetres personalitzats que vulgueu mitjançant la funció Param() i aquests valors poden consumir-se a l'aplicació. 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, feu clic o toqueu els punts suspensius ( . . . ) i Detalls.

   

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

   

3. Substituïu el valor [AppID] a 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
   

Pot ser que hàgiu de permetre les finestres emergents al navegador en incrustar una aplicació al lloc web que utilitzi 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"/>

Especifiqueu els valors per a l'amplada i l'alçada de l'iframe i substituïu l'identificador de l'aplicació amb [AppID].

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

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