Partajați prin

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

  • Articol

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.

Tablou de bord Power BI cu aplicație încorporată.

Notă

  • Numai utilizatorii Power Apps din aceeași entitate găzduită pot accesa aplicația încorporată.
  • Încorporarea aplicațiilor canvas în orice aplicație desktop nativă nu este acceptată, care include Andrioid și iOS. Acest lucru exclude integrările primare, cum ar fi Power Apps în Teams.

Puteți integra, de asemenea, aplicațiile pânză în SharePoint Online fără a utiliza un iframe. Mai multe informații: Utilizați Power Apps partea 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

Începând cu 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 de rulat.
  • tenantid - este un parametru opțional pentru a accepta accesul oaspeților și determină de la ce locatar să deschidă aplicația.
  • screenColor - este folosit pentru a oferi utilizatorilor o experiență mai bună de încărcare a aplicației. 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 încorporarii.
  • În cele din urmă, puteți adăuga orice parametri personalizați doriți folosind funcția Param(), iar acele valori pot fi consumate de aplicația dvs. Acestea sunt adăugate la sfârșitul URI-ului, 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, în fila Aplicații , faceți clic sau atingeți punctele de suspensie ( . . . . . . . . ), apoi Detail

    Accesați pagina de detalii.

  2. Copiați ID aplicației.

    Copiați ID-ul aplicației din detalii.

  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 necesar să permiteți ferestrele pop-up în browser atunci când încorporați o aplicație în site-ul dvs. web care utilizează funcția Launch() pentru a lansa o pagină web sau o aplicație.

Î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 valori pentru lățimea și înălțimea iframe-ului și înlocuiți ID-ul aplicației cu [AppID].

Notă

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

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

Site web Contoso cu aplicație încorporată.

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

  • Dacă site-ul dvs. web folosește autentificarea bazată pe Microsoft Entra 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.