Jaa

Isäntäobjekti Power Appsissa

  • Artikkeli

Koskee seuraavia: pohjaan perustuvat sovellukset Mallipohjaiset sovellukset

Isäntä-objekti Power Appsissa sisältää tietoja nykyisestä sovellusta suorittavasta isännästä.

Description

Isäntä-objekti sisältää tietoja isäntälaitteesta, käyttöjärjestelmästä ja soittimesta, jossa sovellus suoritetaan. Host on samanlainen kuin App-objekti , ja jokaisella sovelluksella on pääsy näihin tietoihin.

Isäntää kannattaa käyttää erityisesti sellaisen sovelluksen virheenetsinnässä, joka ei toimi oikein tietyssä laitteessa tai selaimessa. Tämän objektin tekstiominaisuuksia voi käyttää sovelluksen käyttöliittymän ja Tekstiselite-ohjausobjektin tietojen näyttämisessä ja tietojen kirjaamisessa tietokantataulukkoon tai Application Insightsiin.

On houkuttelevaa käyttää isäntää sovelluksen räätälöimisessä tiettyä laitetta tai selainta varten. Tämä on vaarallista, koska Power Apps on suunniteltu suoritettavaksi erilaisissa laitteistoissa ja ohjelmistoympäristöissä. Isäntään perustuva logiikka ei ehkä ota kaikkia niitä huomioon, ja ne muuttuvat ajan kuluessa. Tätä parempi tapa on käyttää tietoja, jotka ovat tätä abstraktimpia, eivätkä ole sidottuja tiettyyn laitteistoon ja ohjelmistoon. Käytä esimerkiksi Size-ominaisuutta Näyttö-ohjausobjektissa, kun haluat räätälöidä näytön näyttämään aiempaa vähemmän tai järjestää tiedot uudelleen, kun niitä käytetään pienellä laitteella, kuten puhelimella.

Jos haluat käyttää Isäntä-objektia Power Apps Studiossa, laajenna Sovellus-objekti Puunäkymä-ruudun yläosassa ja valitse Isäntä. Tässä esimerkissä Isäntä-objektilla ei ole ominaisuuksia, jotka hyväksyvät kaavoja.

Isäntä-objekti Puunäkymä-ruudussa.

Muistiinpano

Isäntäobjekti on tällä hetkellä käytettävissä vain mukautetuissa sivuissa ja pohjaan perustuvissa sovelluksissa.

BrowserUserAgent-ominaisuus

TekstiominaisuusBrowserUserAgent sisältää täyden käyttäjäagentin merkkijonon, jota selain käyttää itsensä tunnistamiseen sovelluksen suorittamisen yhteydessä.

Selaimen käyttäjäagenttimerkkijono voi olla esimerkiksi:

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

Muistiinpano

Jos käytät Power Appsia alkuperäisessä sovelluksessa tai käytät paketointi-ominaisuutta Power Appsissa, sovellus näytetään selaimen ohjausobjektin kautta, joka toimittaa käyttäjäagenttimerkkijonon.

OSType-ominaisuus

OSType-ominaisuus toimittaa sen käyttöjärjestelmän nimen, jossa sovellus suoritetaan. OSType määritetään selaimen Power Appsiin lähettämän käyttäjäagenttimerkkijonon perusteella. Seuraavissa on esimerkkejä yleisistä OSType-arvoista:

Arvo
Ikkunat
Mac OS
iOS
Android
Linux
...

Muistiinpano

Älä käytä OSType-tekstiä muuttaaksesi kokemusta tai sovelluksen toimintoa raportoidun käyttöjärjestelmän perusteella.

OSType-tekstiä voi käyttää missä tahansa kaavassa, kuten selitteen tekstiominaisuudessa:

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

SessionID-ominaisuus

SessionID-ominaisuus palauttaa nykyisen istunnon yksilöivän GUID-tunnuksen. Sisällytä nämä tiedot, kun raportoit ongelmat järjestelmänvalvojalle.

Muistiinpano

Upotetuissa skenaarioissa, kuten Power Apps Power BI:ssä, SessionID-ominaisuus palauttaa taustalla olevan Power Apps -istunnon tunnuksen eikä Power BI -istunnon tunnusta.

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

TenantID-ominaisuus

TenantID-ominaisuus antaa GUID-tunnuksen, joka yksilöi todennettuna olevaan käyttäjään liittyvän Microsoft Entra -vuokraajan.

Muistiinpano

Samalla tavalla kuin SessionID upotetuissa skenaarioissa, kuten Power Apps Power BI:ssä, vuokraajatunnus on se vuokraaja, jotka käytetään Power Apps -istunnon todennukseen.

Label1.Text: Host.TenantID

Version-ominaisuus

Version-ominaisuus määrittää Power Apps -soittimen tunnisteen ja versionumeron. Kuten BrowserUserAgent-ominaisuuden kohdalla, versionumeroita saatetaan palauttaa useita välilyönneillä erotettuina.

Muistiinpano

Version-ominaisuus on aina tyhjä merkkijono, kun käytetään Power Apps Studiota.

Label1.Text: Host.Version

OfflineEnabled-ominaisuus

OfflineEnabled-ominaisuus mahdollistaa sovelluksen suorituspalvelutilan Power Apps -toistimessa. Jos offline-tila ei ole otettu käyttöön sovelluksessa, ominaisuuden arvo on aina epätosi. Sovelluksissa, joissaoffline-tila on otettu käyttöön, ominaisuuden arvo verkossa on epätosi mutta tosi iOS-, Android- ja Windows-ympäristöissä.

Muistiinpano

Vaikka pohjaan perustuva sovellus ei toimisi ilman verkkoyhteyttä, OfflineEnabled-ominaisuuden arvona säilyy tosi niiden pohjaan perustuvien sovellusten Power Apps Studiossa, joissa offline-käyttö on otettu käyttöön.

Label1.Text: Host.OfflineEnabled

Esimerkkejä

  1. Luo uusi pohjaan perustuva sovellus.
  2. Lisää Tekstiselite-ohjausobjekti ja määritä Text-ominaisuuden arvoksi "Host.BrowserUserAgent: " & Host.BrowserUserAgent.
  3. Lisää Tekstiselite-ohjausobjekti ja määritä Text-ominaisuuden arvoksi "Host.OSType: " & Host.OSType.
  4. Lisää Tekstiselite-ohjausobjekti ja määritä Text-ominaisuuden arvoksi "Host.SessionID: " & Host.SessionID.
  5. Lisää Tekstiselite-ohjausobjekti ja määritä Text-ominaisuuden arvoksi "Host.TenantID: " & Host.TenantID.
  6. Lisää Tekstiselite-ohjausobjekti ja määritä Text-ominaisuuden arvoksi "Host.Version: " & Host.Version.
  7. Lisää Tekstiselite-ohjausobjekti ja määritä Text-ominaisuuden arvoksi "Host.OfflineEnabled: " & Host.OfflineEnabled.

Suorita sovellus eri laitteissa ja selaimissa, ja näet tulokset, jotka muistuttavat alla olevia tuloksia.

Power Apps Studio Windowsin Edge-selaimessa

Host.Version on aina tyhjä, kun työskentelet Power Apps Studio.

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 Appsin alkuperäinen mobiililaitteen soitin iOS:ssa

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 Appsin verkkosoitin Windowsin Firefox-selaimessa

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 Appsin verkkosoitin iOS:n Safari-selaimessa

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)