Share via

Gostiteljski objekt v Power Apps

  • Članek

Velja za: Aplikacije Canvas Aplikacije, ki temeljijo na modelu

Objekt Host v Power Apps ponuja informacije o trenutnem gostitelju, ki izvaja aplikacijo.

Description

Objekt Host ponuja informacije o gostiteljski napravi, operacijskem sistemu in predvajalniku, ki izvaja aplikacijo. Gostitelj je podoben App predmetu in vsaka aplikacija ima dostop do teh informacij.

Eden najboljših načinov uporabe gostitelja je odpravljanje napak v aplikaciji, ki ne deluje pravilno v določeni napravi ali v določenem brskalniku. Uporabite lastnosti besedila tega predmeta za prikaz informacij v uporabniškem vmesniku aplikacije s kontrolnikom Besedilna oznaka ali zabeležite informacije v tabelo zbirke podatkov ali v Application Insights.

Mamljivo je uporabiti Host za prilagajanje aplikacije določeni napravi ali brskalniku. To je nevarno, saj je Power Apps zasnovan za delovanje na širokem spektru platform strojne in programske opreme in vaša logika gostitelja morda ne bo upoštevala vseh in se bodo sčasoma spremenili. Boljši pristop je uporaba informacij, ki so bolj abstraktne in niso vezane na specifično strojno in programsko opremo. Uporabite na primer lastnost Size kontrola Screen , da prilagodite zaslon tako, da prikazuje manj ali reorganizira informacije, ko deluje na manjši napravi, kot je telefon.

Za dostop do Host objekta v Power Apps Studio razširite App objekt na vrhu podokno Drevesni pogled in nato izberite Gostitelj. V tem primeru objekt Host nima lastnosti, ki bi sprejemale formule.

Objekt Host v podoknu drevesnega pogleda.

opomba,

Objekt gostitelja je trenutno na voljo samo na straneh po meri in v aplikacijah platna.

Lastnost BrowserUserAgent

Besedilna lastnost BrowserUserAgent vsebuje celoten niz uporabniškega agenta, ki ga brskalnik uporablja za identifikacijo pri zagonu aplikacije.

Na primer, niz uporabniškega posrednika brskalnika je lahko:

  • Mozilla/5.0 (Windows NT 10.0; Win64; x64)
  • AppleWebKit/537.36 (KHTML, kot Gecko)
  • Chrome/109.0.0.0 Safari/537.36 Edg/109.0.1518.78

opomba,

Če uporabljate Power Apps v izvirni aplikaciji ali uporabljate funkcijo ovijanja v Power Apps, je aplikacija predstavljena prek kontrolnik brskalnika, ki posreduje niz uporabniškega agenta.

Lastnost OSType

Lastnost OSType ponuja ime operacijskega sistema, v katerem se izvaja aplikacija. Vrsta OST se določi iz niza uporabniškega agenta, ki ga pošlje brskalnik Power Apps. Sledijo primeri običajnih vrednosti za OSType:

Vrednost
Okna
Mac OS
iOS
Android
Linux
...

opomba,

Ne uporabljajte OSType za spreminjanje izkušnje ali funkcionalnosti vaše aplikacije na podlagi poročanega operacijskega sistema.

Besedilo OSType je mogoče uporabiti v kateri koli formuli, na primer prikazati v lastnosti besedila oznake:

Label1.Text: "You're running " & Host.OSType

Lastnost SessionID

Lastnost SessionID vrne GUID, ki identificira trenutno sejo. Vključite te informacije, ko poročate o težavah skrbniku.

opomba,

V vdelanih scenarijih, kot je Power Apps in Power BI, lastnost ID seje vrne temeljni ID seje Power Apps in ne ID-ja Power BI seje.

Label1.Text: $"Provide session ID { Host.SessionID } to your administrator."

Lastnost TenantID

Lastnost TenantID zagotavlja globalno edinstveni identifikator (GUID), ki določa Microsoft Entra najemnika, povezanega s trenutno overjenim uporabnikom.

opomba,

Podobno kot SessionID je v vdelanih scenarijih, kot je Power Apps in Power BI, ID najemnika najemnik, uporabljen za Power Apps avtentikacija seje.

Label1.Text: Host.TenantID

Lastnost različice

Lastnost Različica zagotavlja identifikacijo in številko različice Power Apps predvajalnika. Podobno kot BrowserUserAgent je lahko vrnjenih več kot ena številka različice, ločena s presledki.

opomba,

Lastnost Version je pri delu v Power Apps Studio vedno prazen niz.

Label1.Text: Host.Version

Lastnost OfflineEnabled

Lastnost OfflineEnabled zagotavlja način izvajanja aplikacije v Power Apps predvajalniku. Za aplikacije, ki niso omogočene za način brez povezave, je lastnost vedno napačna. Za aplikacije, ki so omogočene za način brez povezave je lastnost napačna v spletu, vendar je resnična v iOS, Android in Windows.

opomba,

Tudi če aplikacija platna ne deluje brez omrežne povezave, lastnost OfflineEnabled ostane veljavna v Power Apps Studio za aplikacije platna, ki so omogočene za uporabo brez povezave.

Label1.Text: Host.OfflineEnabled

Primeri

  1. Ustvarite novo aplikacijo Canvas.
  2. Dodajte kontrolnik Besedilna oznaka in nastavite lastnost Text na "Host.BrowserUserAgent: " & Host.BrowserUserAgent.
  3. Dodajte kontrolnik Besedilna oznaka in nastavite lastnost Text na "Host.OSType: " & Host.OSType.
  4. Dodajte kontrolnik Besedilna oznaka in nastavite lastnost Text na "Host.SessionID: " & Host.SessionID.
  5. Dodajte kontrolnik Besedilna oznaka in nastavite lastnost Text na "Host.TenantID: " & Host.TenantID.
  6. Dodajte kontrolnik Besedilna oznaka in nastavite lastnost Text na "Host.Version: " & Host.Version.
  7. Dodajte kontrolnik Besedilna oznaka in nastavite lastnost Text na "Host.OfflineEnabled: " & Host.OfflineEnabled.

Zaženite svojo aplikacijo v različnih napravah in z različnimi brskalniki in videli boste rezultate, podobne spodnjim.

Power Apps Studio v sistemu Windows z brskalnikom Edge

Host.Version je pri delu v Power Apps Studio vedno prazen.

Host.BrowserUserAgent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/116.0.0.0 Safari/537.36 Edg/116.0.1938.76
Host.OSType: Windows
Host.SessionID: ee2eed1a-8455-4e68-a433-a709302d0c71
Host.TenantID: 5da56e5c-97b6-468f-a448-a6e432c48269
Host.Version:

Power Apps izvorni mobilni predvajalnik vklopljen iOS

Host.BrowserUserAgent: Mozilla/5.0 (iPhone; CPU iPhone OS 16_6_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148 PowerApps/e1c23ff9-4822-4e75-a003-01c91407a4d2
Host.OSType: Windows
Host.SessionID: 3ebec22f-ee2e-412a-b3eb-45d97db34863
Host.TenantID: 5da56e5c-97b6-468f-a448-a6e432c48269
Host.Version: PowerApps-Native/3.23084.8(iOS)

Power Apps spletni predvajalnik v sistemu Windows z Firefox brskalnikom

Host.BrowserUserAgent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:109.0) Gecko/20100101 Firefox/117.0
Host.OSType: Windows
Host.SessionID: 283309a4-d88b-4b2a-88de-73b47d1b62d0
Host.TenantID: 5da56e5c-97b6-468f-a448-a6e432c48269
Host.Version: PowerApps-Web/3.23084.6(Windows)

Power Apps spletni predvajalnik iOS z brskalnikom Safari

Host.BrowserUserAgent: Mozilla/5.0 (iPhone; CPU iPhone OS 16_6_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.6 Mobile/15E148 Safari/604.1
Host.OSType: iOS
Host.SessionID: a09a946d-ce71-4c1f-bd35-519c79849c8d
Host.TenantID: 5da56e5c-97b6-468f-a448-a6e432c48269
Host.Version: PowerApps-Web/3.23084.6(iOS)