Integracija aplikacij delovnega območja v spletna mesta in druge storitve

  • Članek
  • 3 min za branje

Aplikacije, ki jih zgradite, so pogosto najbolj koristne, ko so na voljo prav tam, kjer ljudje delajo. Če platnene aplikacije vdelate v iframe, lahko te aplikacije integrirate v spletna mesta in druge storitve, kot sta Power BI ali SharePoint.

V tej temi vam bomo pokazali, kako nastavite parametre za vdelavo aplikacij; nato bomo vdelali aplikacijo za naročanje sredstev v spletno mesto.

Power BI nadzorna plošča z vdelano aplikacijo.

Upoštevajte naslednje omejitve:

  • Do vdelane aplikacije lahko dostopajo samo uporabniki Power Apps v istem najemniku.
  • Če želite dostopati do Power Apps z uporabo Internet Explorer 11, morate izklopiti pogled združljivosti.

V SharePoint Online lahko integrirate tudi platnene aplikacije brez uporabe iframe. Več informacij: Uporabite spletni gradnik Power Apps.

Nastavitev parametrov URI za vašo aplikacijo

Če imate aplikacijo, ki jo želite vdelati, je prvi korak nastavitev parametrov za URI (Uniform Resource Identifier), da element iframe ve, kjer poiskati aplikacijo. URI ima naslednjo obliko:

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

Za uporabnike licence GCC

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

Pomembno

Od avgusta 2019 je oblika zapisa URI spremenjena z https://web.powerapps.com/webplayer na https://apps.powerapps.com/play. Posodobite vse vdelane elemente iframes, da uporabljajo novo obliko zapisa URI. Sklici na prejšnjo obliko zapisa bodo preusmerjeni na novi URI, da se zagotovi združljivost.

Prejšnja oblika zapisa:

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

Edino, kar morate storiti, je, da nadomestite ID svoje aplikacije za [AppID] v URI-ju (vključno '[' & ']'). Kmalu vam bomo pokazali, kako pridobiti to vrednost, najprej pa navajamo vse parametre, ki so na voljo v URI-ju:

  • [appID] – zagotavlja ID aplikacije, ki se bo izvajala.
  • tenantid – je izbirni parameter za podporo dostopa za goste in določa, iz katerega najemnika se odpre aplikacija.
  • screenColor – se uporablja za zagotavljanje boljše izkušnje nalaganja aplikacije za vaše uporabnike. Ta parameter je v obliki zapisa RGBA (red value, green value, blue value, alpha) in nadzoruje barvo zaslona, ko se aplikacija nalaga. Najbolje ga je nastaviti na isto barvo kot ikono aplikacije.
  • source – ne vpliva na aplikacijo, predlagamo pa, da dodate opisno ime za sklic na vir vdelave.
  • Nazadnje lahko po želji dodate poljubne parametre po meri s funkcijo Param() function, vaša aplikacija pa bo uporabila te vrednosti. Dodajo se na konec URI-ja, kot je [AppID]?source=iframe&param1=value1&param2=value2. Ti parametri se preberejo samo med zagonom aplikacije. Če jih želite spremeniti, morate znova zagnati aplikacijo. Upoštevajte, da bi moral imeti samo prvi element po [appid] dodan »?«; po tem uporabite »&«, kot je prikazano tukaj.

Pridobivanje ID-ja aplikacije

ID aplikacije je na voljo na powerapps.com. Za aplikacijo, ki jo želite vdelati:

  1. Na spletnem mestu powerapps.com na zavihku Aplikacije kliknite ali tapnite tri pike ( . . . ), nato pa še Podrobnosti.

    Odprite podrobnosti aplikacije.

  2. Kopirajte ID aplikacije.

    Kopiranje ID-ja aplikacije iz podrobnosti.

  3. Nadomestite vrednost [AppID] v URI-ju. Za našo aplikacijo za naročanje sredstev je URI videti tako:

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

Morda boste morali dovoliti pojavna okna v brskalniku, ko vdelate aplikacijo na spletno mesto, ki uporablja funkcijo Launch() za zagon spletne strani ali aplikacije.

Vdelava aplikacije v spletno mesto

Vdelava vaše aplikacije je zdaj tako preprosta kot dodajanje iframe v kodo HTML za vaše spletno mesto (ali katero koli drugo storitev, ki podpira iframe, kot je Power BI ali 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"/>

Določite vrednosti za širino in višino elementa iframe ter nadomestite ID aplikacije za [AppID].

Opomba

Vključite allow="geolocation; microphone; camera" v vašo kodo HTML elementov iframe, da dovolite aplikacijam uporabo teh zmogljivosti v brskalniku Google Chrome.

Naslednja slika prikazuje aplikacijo za naročanje sredstev, vdelano v vzorčno spletno mesto Contoso.

Contoso spletno mesto z vdelano aplikacijo.

Upoštevajte naslednje točke pri preverjanju pristnosti uporabnikov vaše aplikacije:

  • Če vaše spletno mesto uporablja avtentikacijo na podlagi Azure Active Directory (AAD), dodatna prijava ni potrebna.
  • Če vaše spletno mesto uporablja kakršen koli drug mehanizem vpisa ali zanj ni omogočeno preverjanje pristnosti, vaši uporabniki vidijo poziv za vpis v elementu iframe. Ko se vpišejo, bodo lahko zagnali aplikacijo, če jo je avtor aplikacije dal v skupno rabo z njimi.

Kot lahko vidite, je vdelava aplikacij enostavna in zmogljiva. Vdelava vam omogoča, da pripeljete aplikacije na mesta, kjer delate vi in vaše stranke – na spletna mesta, Power BI nadzorne plošče, SharePoint strani in drugo.