Hosti objekt Power Apps

Kehtib: Lõuendirakendused

Objekt Host annab Power Apps teavet praeguse rakendust käitava hosti kohta.

Kirjeldus

Objekt Host pakub teavet rakendust käitava hostiseadme, operatsioonisüsteemi ja pleieri kohta. Host sarnaneb rakenduse objektiga ja igal rakendusel on sellele teabele juurdepääs.

Üks hosti parimaid kasutusviise on siluda rakendus, mis ei tööta korralikult konkreetses seadmes või konkreetse brauseriga. Kasutage selle objekti tekstiatribuute rakenduse kasutajaliideses teabe kuvamiseks tekstisildi juhtelemendiga või logige teave andmebaasitabelisse või asukohta . Application Insights

On ahvatlev kasutada hosti rakenduse kohandamiseks konkreetsele seadmele või brauserile. See on ohtlik, kuna Power Apps see on mõeldud käitamiseks paljudel riist- ja tarkvaraplatvormidel ning teie hostipõhine loogika ei pruugi neid kõiki arvestada ja need muutuvad aja jooksul. Parem lähenemisviis on kasutada teavet, mis on abstraktsem ega ole seotud konkreetse riist- ja tarkvaraga. Näiteks kasutage ekraani juhtelemendi atribuuti Suurus , et kohandada ekraani nii, et see näitaks vähem teavet, või korraldage teave ümber, kui see töötab väiksemas seadmes, näiteks telefonis.

Objektile Host avamiseks laiendage Power Apps Studio puuvaatepaani ülaosas olevat rakenduseobjekti ja seejärel valige Host. Selles näites pole objektil Host valemeid aktsepteerivaid atribuute.

Märkus.

Hostiobjekt on praegu saadaval ainult kohandatud lehtedel ja lõuendirakendustes.

Atribuut BrowserUserAgent

Tekstiatribuut BrowserUserAgent sisaldab täielikku kasutaja agent stringi, mida brauser kasutab rakenduse käivitamisel enda tuvastamiseks.

Näiteks võib brauseri kasutaja agent string olla:

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

Märkus.

Kui kasutate Power Apps omarakendust või kasutate funktsiooni Pakendamine Power Apps funktsiooni, esitatakse rakendus brauseri juhtelemendi kaudu, mis varustab kasutajat stringiga agent.

OSType’i vara

Atribuut OSType pakub selle operatsioonisüsteemi nime, kus rakendus töötab. OSType määratakse kasutaja agent stringi põhjal, mille Power Apps brauser on saatnud. OSType’i ühiste väärtuste näited on järgmised:

Väärtus
Aknad
Mac OS
iOS
Android
Linux
...

Märkus.

Ärge kasutage OSType’i rakenduse kasutuskogemuse või funktsionaalsuse muutmiseks teatatud operatsioonisüsteemi põhjal.

OSType’i teksti saab kasutada mis tahes valemis, näiteks sildi tekstiatribuudis.

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

Atribuut SessionID

Atribuut SessionID tagastab GUID, mis tuvastab praeguse seansi. Lisage see teave administraatorile probleemidest teatamisel.

Märkus.

Manustatud stsenaariumide korral, näiteks Power Apps sees Power BI, tagastab atribuut SessionID aluseks oleva Power Apps seansi ID, mitte Power BI seansi ID.

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

Rentniku ID atribuut

Rentniku ID atribuut pakub globaalset kordumatut identifikaatorit (GUID), mis määrab Microsoft Entra praegu autenditud kasutajaga seotud rentniku.

Märkus.

Sarnaselt SessionID-ga on kaasatud stsenaariumides (nt Power Apps in Power BI) rentniku ID rentniku ID, mida kasutatakse seansi autentimiseks Power Apps .

Label1.Text: Host.TenantID

Atribuut Versioon

Atribuut Versioon annab mängija identifitseerimis- ja versiooninumbri Power Apps . Sarnaselt BrowserUserAgentiga võidakse tagastada rohkem kui üks versiooninumber, eraldatuna tühikutega.

Märkus.

Atribuut Versioon on sissetöötamisel Power Apps Studio alati tühi string.

Label1.Text: Host.Version

Atribuut OfflineEnabled

Atribuut OfflineEnabled pakub pleieris Power Apps rakenduse käitusaja režiimi. Rakenduste puhul, mis pole ühenduseta režiimis lubatud, on atribuut alati väär. Rakenduste puhul, mille jaoks on võrguühenduseta töötamine lubatud, on atribuut veebis vale, kuid Windowsis iOS Android tõene.

Märkus.

Isegi kui lõuendirakendus ei tööta ilma võrguühenduseta, jääb atribuut OfflineEnabled kehtima ka nende lõuendirakenduste puhul, Power Apps Studio mis on võrguühenduseta kasutamiseks lubatud.

Label1.Text: Host.OfflineEnabled

Näited

1. Looge uus lõuendirakendus.
2. Lisage tekstisildi juhtelement ja seadke Text atribuudi väärtuseks "Host.BrowserUserAgent: " & Host.BrowserUserAgent.
3. Lisage tekstisildi juhtelement ja seadke Text atribuudi väärtuseks "Host.OSType: " & Host.OSType.
4. Lisage tekstisildi juhtelement ja seadke Text atribuudi väärtuseks "Host.SessionID: " & Host.SessionID.
5. Lisage tekstisildi juhtelement ja seadke Text atribuudi väärtuseks "Host.TenantID: " & Host.TenantID.
6. Lisage tekstisildi juhtelement ja seadke Text atribuudi väärtuseks "Host.Version: " & Host.Version.
7. Lisage tekstisildi juhtelement ja seadke Text atribuudi väärtuseks "Host.OfflineEnabled: " & Host.OfflineEnabled.

Käivitage oma rakendus erinevates seadmetes ja erinevate brauseritega ning näete allpool kirjeldatud tulemusi.

Power Apps Studio Windowsis Edge’i brauseriga

Host.Version on sissetöötamisel Power Apps Studio alati tühi.

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: aaaabbbb-0000-cccc-1111-dddd2222eeee
Host.Version: 

Power Apps Native Mobile Player on sisse lülitatud 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: aaaabbbb-0000-cccc-1111-dddd2222eeee
Host.Version: PowerApps-Native/3.23084.8(iOS)

Power Apps veebipleier Windowsis brauseriga Firefox

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: aaaabbbb-0000-cccc-1111-dddd2222eeee
Host.Version: PowerApps-Web/3.23084.6(Windows)

Power Apps veebimängija on sisse lülitatud iOS Safari brauseriga

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: aaaabbbb-0000-cccc-1111-dddd2222eeee
Host.Version: PowerApps-Web/3.23084.6(iOS)