Del via

Vertsobjekt i Power Apps

  • Artikkel

Gjelder: Lerretsapper Modelldrevne apper

Vert-objektet i Power Apps gir informasjon om den gjeldende verten som kjører appen.

Bekrivelse

Vert-objektet inneholder informasjon om vertsenheten, operativsystemet og spilleren som kjører en app. Verten ligner på App-objektet, og hver app har tilgang til denne informasjonen.

Noe av det beste med Vert er å feilsøke en app som ikke fungerer på riktig måte på en bestemt enhet eller i en bestemt nettleser. Bruk tekstegenskapene for dette objektet til å vise informasjon i appens brukergrensesnitt med en Tekstetikett-kontroll, eller logg informasjonen i en databasetabell eller til Application Insights.

Det er fristende å bruke Vert til å skreddersy en app til en bestemt enhet eller nettleser. Dette er farlig fordi Power Apps er utformet for å kjøres på en rekke maskinvare- og programvareplattformer, og det kan hende at den Vert-baserte logikken ikke tar hensyn til alle, og de endres over tid. Den beste tilnærmingen er å bruke informasjon som er mer abstrakt og ikke er knyttet til bestemt maskinvare og programvare. Bruk for eksempel egenskapen Size for kontrollen Skjerm til å skreddersy en skjerm til å vise mindre eller omorganisere informasjon når du kjører på en mindre enhet, for eksempel en telefon.

Du får tilgang til Vert-objektet i Power Apps Studio ved å utvide App-objektet øverst i ruten Trevisning og deretter velge Vert. I dette eksemplet har ikke Vert-objektet noen egenskaper som godtar formler.

Vertsobjektet i Trevisning-ruten.

Merk

Vertsobjektet er for øyeblikket bare tilgjengelig på egendefinerte sider og i lerretsapper.

BrowserUserAgent-egenskap

Tekstegenskapen BrowserUserAgent inneholder den fullstendige brukeragentstrengen som nettleseren bruker til å identifisere seg selv når appen kjøres.

En brukeragentstreng for nettleseren kan for eksempel være følgende:

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

Merk

Hvis du kjører Power Apps i en innebygd app eller bruker pakkingsfunksjonen i Power Apps, presenteres appen via en nettleserkontroll, som leverer en brukeragentstreng.

OSType-egenskap

OSType-egenskapen angir navnet på operativsystemet der appen kjører. OSType fastsettes fra brukeragentstrengen som nettleseren sender til Power Apps. Følgende er eksempler på vanlige verdier for OSType:

Verdi
Vinduer
Mac OS
iOS
Android
Linux
...

Merk

Ikke bruk OSType å endre brukeropplevelsen eller funksjonaliteten til appen basert på det rapporterte operativsystemet.

OSType-teksten kan brukes i en hvilken som helst formel, for eksempel i tekstegenskapen for en etikett:

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

SessionID-egenskap

SessionID-egenskapen returnerer GUID-en som identifiserer gjeldende økt. Inkluder denne informasjonen når du rapporterer problemer til administrator.

Merk

I innebygde scenario, for eksempel Power Apps i Power BI, returnerer SessionID-egenskapen den underliggende økt-ID-en i Power Apps, ikke økt-ID-en i Power BI.

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

TenantID-egenskap

TenantID-egenskapen inneholder GUID-en (globalt unik identifikator) som angir Microsoft Entra-leieren som er tilknyttet den for øyeblikket godkjente brukeren.

Merk

På samme måte som SessionID, i innebygde scenarioer som Power Apps i Power BI, er leier-ID-en leieren som brukes for godkjenning av Power Apps-økten.

Label1.Text: Host.TenantID

Versjonsegenskap

Versjon-egenskapen angir identifikasjons- og versjonsnummeret til Power Apps-spilleren. På samme måte som BrowserUserAgent kan mer enn ett versjonsnummer returneres atskilt med mellomrom.

Merk

Version-egenskapen er alltid en tom streng når du arbeider i Power Apps Studio.

Label1.Text: Host.Version

OfflineEnabled-egenskap

Egenskapen OfflineEnabled angir kjøretidsmodusen for appen i Power Apps-spilleren. For apper som ikke er aktivert for frakoblet modus, er egenskapen alltid usann. For apper som er aktivert for frakoblet modus, er egenskapen usann på nettet, men sann på iOS, Android og Windows.

Merk

Selv om en lerretsapp ikke fungerer uten nettverkstilkobling, forblir egenskapen OfflineEnabled sann i Power Apps Studio for lerretsapper som er aktivert for frakoblet bruk.

Label1.Text: Host.OfflineEnabled

Eksempler

  1. Opprette en ny lerretsapp.
  2. Legg til en Tekstetikett-kontroll, og angi Text-egenskapen til "Host.BrowserUserAgent: " & Host.BrowserUserAgent.
  3. Legg til en Tekstetikett-kontroll, og angi Text-egenskapen til "Host.OSType: " & Host.OSType.
  4. Legg til en Tekstetikett-kontroll, og angi Text-egenskapen til "Host.SessionID: " & Host.SessionID.
  5. Legg til en Tekstetikett-kontroll, og angi Text-egenskapen til "Host.TenantID: " & Host.TenantID.
  6. Legg til en Tekstetikett-kontroll, og angi Text-egenskapen til "Host.Version: " & Host.Version.
  7. Legg til en Tekstetikett-kontroll, og angi Text-egenskapen til "Host.OfflineEnabled: " & Host.OfflineEnabled.

Kjør appen din på forskjellige enheter og i forskjellige nettlesere, og du vil se resultater som ligner på dem nedenfor.

Power Apps Studio i Windows med Edge-nettleser

Host.Version er alltid tom når du arbeider i 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 Apps opprinnelig mobilspiller på 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 webspiller i Windows med Firefox-nettleser

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 webspiller på iOS med Safari-nettleser

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)