Kopīgot, izmantojot

Pamatnes programmu integrēšana tīmekļa vietnēs un citos pakalpojumos

  • Raksts

Jūsu veidotās programmas bieži vien visvairāk noder tad, ja tās ir pieejamas tieši vietā, kur lietotāji strādā. Pamatnes programmas iegulstot iekš iframe, šīs programmas varat integrēt tīmekļa vietnēs un citos pakalpojumos, piemēram, Power BI vai SharePoint.

Šajā tēmā mēs parādīsim, kā iestatīt parametrus programmas iegulšanai; un pēc tam savu programmu Asset Ordering mēs iegulsim kādā tīmekļa vietnē.

Power BI informācijas panelis ar iegultu programmu.

Piezīmes

  • Iegultajai programmai var piekļūt tikai Power Apps lietotāji, kas atrodas tajā pašā nomniekā.
  • Audekla programmu iegulšana jebkurā vietējā datora lietojumprogrammā netiek atbalstīta, tostarp Andrioid un iOS. Tas izslēdz pirmās puses integrāciju, piemēram, Power Apps teams.

Pamatnes programmas varat integrēt arī pakalpojumā SharePoint Online, neizmantojot iframe. PapildinformācijaTīmekļa Power Apps daļas izmantošana.

URI parametru iestatīšana savai programmai

Ja jums ir programma, kuru vēlaties iegult, vispirms ir jāiestata parametri vienotajam resursu identifikatoram jeb URI (Uniform Resource Identifier), lai iframe zinātu, kur šo programmu atrast. URI ir šādā formā:

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

GCC lietotājiem

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

Svarīgi

No 2019. gada augusta URI formāts ir mainījies no https://web.powerapps.com/webplayer uz https://apps.powerapps.com/play. Lūdzu, atjauniniet visus iegultos iframe, lai izmantotu jauno URI formātu. Lai nodrošinātu saderību, atsauces uz iepriekšējo formātu tiks pārvirzītas uz jauno URI.

Iepriekšējais formāts:

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

Jums ir tikai jāaizstāj savas programmas ID vērtībai [AppID] šajā URI (tostarp '[' & ']'). To, kā šo vērtību iegūt, mēs jums drīz parādīsim, bet vispirms apskatiet visus parametrus, kas ir pieejami šajā URI:

  • [appID] - Tas nodrošina palaistās lietotnes ID.
  • tenantid - ir neobligāts parametrs, kas atbalsta viesu piekļuvi un nosaka, no kura nomnieka atvērt programmu.
  • screenColor - tiek izmantots, lai nodrošinātu labāku lietotņu ielādes pieredzi jūsu lietotājiem. Šis parametrs ir RGBA formātā (sarkana vērtība, zaļa vērtība, zila vērtība, alfa) un kontrolē ekrāna krāsu, kamēr programma tiek ielādēta. Vislabāk to iestatīt uz to pašu krāsu, kādā ir jūsu programmas ikona.
  • avots - neietekmē lietotni, taču mēs iesakām pievienot aprakstošu nosaukumu, lai atsauktos uz iegulšanas avotu.
  • Visbeidzot, izmantojot funkciju Param(), varat pievienot jebkādus pielāgotusparametrus, un šīs vērtības var patērēt jūsu lietotne. Tie tiek pievienoti URI beigās, piemēram [AppID]?source=iframe&param1=value1&param2=value2. Programmas palaišanas laikā šie parametri ir tikai lasāmi. Ja tos ir nepieciešams mainīt, programma ir jāpalaiž vēlreiz. Ņemiet vērā, ka tikai pirmajam vienumam aiz [appid] ir nepieciešams “?”; pēc tam ir jāizmanto “&”, kā parādīts šeit.

Programmas ID iegūšana

Programmas ID ir pieejams vietnē powerapps.com. Programmai, kuru vēlaties iegult:

  1. Sadaļā powerapps.com cilnē Programmas noklikšķiniet uz daudzpunktes ( . . . ), pēc tam pieskarieties vienumam Detalizēti.

    Dodieties uz programmas informāciju.

  2. Kopējiet lietotnes ID.

    Programmas ID kopēšana no detalizēta informācija.

  3. Aizstājiet [AppID] vērtību URI. Mūsu programmai Asset Ordering URI izskatās šādi:

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

Iespējams, pārlūkprogrammā būs jāatļauj uznirstošie logi, kad savā tīmekļa vietnē iegulstat lietojumprogrammu, kas izmanto palaišanas () funkciju, lai palaistu tīmekļa lapu vai lietojumprogrammu.

Savas programmas iegulšana tīmekļa vietnē

Programmu iegult tagad ir tik pat vienkārši, kā pievienot iframe jūsu vietnes HTML kodam (vai jebkuram citam pakalpojumam, kas atbalsta iframe, piemēram, Power BI vai 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"/>

Norādiet iframe platuma un augstuma vērtības un aizstājiet tās [AppID] ID.

Piezīmes

Iekļaujiet allow="geolocation; microphone; camera" savā iframe HTML kodā, lai ļautu lietotnēm izmantot šīs iespējas pārlūkā Google Chrome.

Nākamajā attēlā ir redzama Contoso tīmekļa vietnes piemērā iegulta programma Asset Ordering.

Contoso tīmekļa vietne ar iegultu programmu.

Saistībā ar savas programmas lietotāju autentificēšanu ir jāņem vērā tālāk aprakstītie norādījumi.

  • Ja jūsu vietnē tiek izmantota Microsoft Entra uz ID balstīta autentifikācija, papildu pierakstīšanās nav nepieciešama.
  • Ja jūsu tīmekļa vietne izmanto kādu citu pierakstīšanās mehānismu vai netiek autentificēta, jūsu lietotāji šajā iframe redz pierakstīšanās uzvedni. Pēc pierakstīšanās viņi varēs palaist programmu, ja vien programmas autors to ir kopīgojis ar viņiem.

Kā redzat, programmu iegulšana ir vienkārša un efektīva. Izmantojot iegulšanu, savas programmas varat nogādāt tieši uz vietām, kur jūs un jūsu klienti strādā — tīmekļa vietnēm, Power BI informācijas paneļiem, SharePoint lapām un citur.