Integrare aplicații pânză în site-uri web și alte servicii

Aplicațiile pe care le construiți sunt adesea cel mai utile atunci când sunt disponibile chiar acolo unde oamenii muncesc. Prin încorporarea aplicațiilor pânză într-un iframe, puteți integra aceste aplicații în site-uri web și în alte servicii, cum ar fi Power BI sau SharePoint.

În acest subiect, vă vom arăta cum să setați parametrii pentru încorporarea aplicațiilor; apoi vom încorpora aplicația noastră de comandă a activelor într-un site web.

Notă

• Numai utilizatorii Power Apps din aceeași entitate găzduită pot accesa aplicația încorporată.
• Încorporarea aplicațiilor proiectate pe pânză într-o aplicație desktop nativă nu este acceptată. Aceasta exclude integrările primare, cum Power Apps ar fi în Teams).

Puteți integra, de asemenea, aplicațiile pânză în SharePoint Online fără a utiliza un iframe. Informații suplimentare: Utilizarea părții Power Apps web.

Setați parametrii URI pentru aplicația dvs

Dacă aveți o aplicație pe care doriți să o încorporați, primul pas este să setați parametrii pentru identificatorul uniform de resursă (URI), astfel încât iframe-ul să știe unde să găsească aplicația. URI este în următorul formular:

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

Pentru utilizatori GCC

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

Important

Din august 2019, formatul URI s-a schimbat de la https://web.powerapps.com/webplayer la https://apps.powerapps.com/play. Actualizați orice iframe încorporate pentru a utiliza noul format URI. Referințele la formatul anterior vor fi redirecționate către noul URI pentru a asigura compatibilitatea.

Formatul anterior:

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

Singurul lucru pe care trebuie să-l faceți este să înlocuiți ID-ul aplicației dvs. cu [AppID] în URI (inclusiv '[' & ']'). Vă vom arăta cum puteți obține această valoare în scurt timp, dar mai întâi iată toți parametrii disponibili în URI:

• [appID] - Furnizează ID-ul aplicației pentru a rula.
• tenantid - este un parametru opțional pentru a sprijini accesul oaspeților și stabilește din ce entitate găzduită să se deschidă aplicația.
• screenColor - este utilizat pentru a oferi o mai bună experiență de încărcare a aplicațiilor pentru utilizatorii dvs. Acest parametru este în format RGBA (valoare roșie, valoare verde, valoare albastră, alfa) și controlează culoarea ecranului în timp ce aplicația se încarcă. Cel mai bine este să o setați pe aceeași culoare cu pictograma aplicației.
• sursă - nu afectează aplicația, dar vă sugerăm să adăugați un nume descriptiv pentru a face referire la sursa încorporării.
• În cele din urmă, puteți adăuga orice parametri personalizați doriți folosind Funcția Param() și aceste valori pot fi consumate de aplicația dvs. Acestea sunt adăugate la sfârșitul URI, cum ar fi [AppID]?source=iframe&param1=value1&param2=value2. Acești parametri sunt citiți doar în timpul lansării aplicației. Dacă trebuie să îi schimbați, trebuie să relansați aplicația. Rețineți că numai primul element după [appid] ar trebui să aibă un "?”; după aceea folosiți "&” așa cum este ilustrat aici.

Obțineți ID aplicație

ID-ul aplicației este disponibil pe powerapps.com. Pentru aplicația pe care doriți să o încorporați:

1. În powerapps.com, pe fila Aplicații, faceți clic sau atingeți elipsele ( . . . ), apoi Detalii.

   

2. Copiați ID Aplicație.

   

3. Înlocuiți valoarea [AppID] în URI. Pentru aplicația noastră de comandă a activelor, URI arată astfel:

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

Este posibil să fie nevoie să permiteți ferestrele de tip pop-up în browser când încorporați o aplicație pe site-ul dvs. web care utilizează funcția Launch() pentru lansarea unei pagini web sau a unei aplicații.

Încorporați aplicația într-un site web

Încorporarea aplicației dvs. este acum la fel de simplă precum adăugarea iframe la codul HTML pentru site-ul dvs. (sau orice alt serviciu care acceptă iframes, cum ar fi Power BI sau 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"/>

Specificați valorile pentru lățimea și înălțimea iframe și înlocuiți ID-ul aplicației dvs. pentru [AppID].

Notă

Includeți allow="geolocation; microphone; camera" în codul dvs. HTML iframe pentru a permite aplicațiilor dvs. să utilizeze aceste funcții pe Google Chrome.

Următoarea imagine arată aplicația de comandă a activelor încorporată într-un site web Contoso.

Rețineți următoarele puncte pentru autentificarea utilizatorilor aplicației dvs.:

• Dacă site-ul web utilizează Microsoft Entra autentificarea bazată pe ID, nu este necesară conectarea suplimentară.
• Dacă site-ul dvs. web folosește orice alt mecanism de conectare sau nu este autentificat, utilizatorii dvs. văd o solicitare de conectare pe iframe. După ce s-au conectat, vor putea rula aplicația atât timp cât autorul aplicației a partajat-o cu ei.

După cum puteți vedea, încorporarea aplicațiilor este simplă și puternică. Încorporarea vă permite să aduceți aplicațiile direct în locurile în care lucrați dvs. și clienții dvs. - site-uri web, tablouri de bord Power BI, pagini SharePoint și multe altele.

Notă

Ne puteți spune care preferințele dvs. lingvistice pentru documentație? Răspundeți la un chestionar scurt. (rețineți că acest chestionar este în limba engleză)

Chestionarul va dura aproximativ șapte minute. Nu sunt colectate date personale (angajament de respectare a confidențialității).