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

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

Pamatnes programmas varat integrēt arī pakalpojumā SharePoint Online, neizmantojot iframe. Papildinformācija: Pakalpojuma Power Apps tīmekļa daļas lietoš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

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] — nodrošina ID programmai, kuru darbināt.
• tenantid — neobligāts parametrs, lai atbalstītu viesa piekļuvi, un nosaka, no kura nomnieka šo programmu atvērt.
• screenColor — tiek izmantots, lai jūsu lietotājiem sniegtu labāku programmas ielādes funkcionalitāti. Šis parametrs ir formātā RGBA (sarkanā vērtība, zaļā vērtība, zilā vērtība, alfa), un tas regulē ekrāna krāsas, kamēr programma ielādējas. Vislabāk to iestatīt uz to pašu krāsu, kādā ir jūsu programmas ikona.
• source — neietekmē programmu, bet iesakām pievienot aprakstošu nosaukumu, lai norādītu uz iegulšanas avotu.
• Visbeidzot varat pievienot jebkuru pielāgotu parametru, kādu vēlaties, izmantot funkciju Param(), un jūsu programma šīs vērtības var patērēt. Tās tiek pievienotas 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. Vietnes powerapps.com cilnē Programmas noklikšķiniet uz daudzpunktes pogas ( . . . ) un pēc uz Detalizēti vai pieskarieties šiem vienumiem.

   

2. Nokopējiet Programmas ID.

   

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

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

Jums var būt nepieciešams pārlūkprogrammā atļaut uznirstošos elementus, kad iegulstat programmu sava vietnē, kas izmanto funkciju Launch(), lai tīmekļa vietni palaistu programmā.

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 vērtības iframe platumam un augstumam un aizstājiet savas programmas ID vērtībai [AppID].

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

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.