Værtsobjekt i Power Apps

  • Artikel

Gælder for: Lærredapps Modelbaserede apps

Værtsobjektet i Power Apps indeholder oplysninger om den aktuelle vært, der kører appen.

Beskrivelse

Objektet Vært indeholder oplysninger om den værtsenhed, det operativsystem og den afspiller, der kører en app. Vært svarer til objektet app, og alle apps har adgang til disse oplysninger.

En af de bedste måder at bruge Vært på er at fejlfinde en app, der ikke fungerer korrekt på en bestemt enhed eller med en bestemt browser. Brug tekstegenskaberne for dette objekt til at se oplysninger på appens brugergrænseflade med et Tekstnavn-kontrolelement eller til at logføre oplysningerne i en databasetabel eller til Application Insights.

Det er fristende at bruge Vært til at tilpasse en app til en bestemt enhed eller browser. Dette er farligt, da Power Apps er udviklet til at blive kørt på en lang række hardware- og softwareplatforme, og din værtsbaserede logik tager måske ikke højde for dem alle, og de vil blive ændret med tiden. Den bedste fremgangsmåde er at bruge oplysninger, der er mere abstrakte og ikke er knyttet til bestemt hardware og software. Du kan f.eks. bruge egenskaben Størrelse for kontrolelementet Skærm til at tilpasse et skærmbillede, så der vises færre oplysninger, eller omorganisere oplysninger, når du kører på en mindre enhed, f.eks. en telefon.

Hvis du vil have adgang til objektet Vært i Power Apps Studio, skal du udvide objektet App øverst i ruden Trævisning og derefter vælge Vært. I dette eksempel har værtsobjektet ingen egenskaber, der accepterer formler.

Værtsobjektet i ruden Trævisning.

Bemærk

Værtsobjektet er i øjeblikket kun tilgængeligt på brugerdefinerede sider og i lærredapps.

Egenskaben BrowserUserAgent

Tekstegenskaben BrowserUserAgent indeholder den komplette brugeragentstreng, som browseren bruger til at identificere sig selv, når appen køres.

Et eksempel på en browserbrugeragentstreng kan være:

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

Bemærk

Hvis du kører Power Apps i en indbygget app eller bruger indpakningsfunktionen i Power Apps, vises appen via et browserkontrolelement, som leverer en brugeragentstreng.

OSType-egenskab

Egenskaben OSType angiver navnet på det operativsystem, hvor appen kører. OSType bestemmes ud fra den brugeragentstreng, som browseren sender til Power Apps. Her følger nogle eksempler på almindelige værdier for OSType:

Værdi
Vinduer
Mac OS
iOS
Android
Linux
...

Bemærk

Brug ikke OSType til at ændre appens oplevelse eller funktionalitet baseret på det rapporterede operativsystem.

OSType-teksten kan bruges i alle formler, f.eks. hvis den vises i en etikets tekstegenskab:

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

Egenskaben SessionID

Egenskaben SessionID returnerer det GUID, der identificerer den aktuelle session. Medtag disse oplysninger, når du rapporterer problemer til din administrator.

Bemærk

I integrerede scenarier såsom Power Apps i Power BI returnerer egenskaben SessionID det underliggende Power Apps-sessions-id, ikke Power BI-sessions-id'et.

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

Egenskaben TenantID

Egenskaben TenantID indeholder GUID'et (Globally Unique Identifier), der angiver den Microsoft Entra-lejer, som er knyttet til den aktuelt godkendte bruger.

Bemærk

På samme måde som SessionID er lejer-id'et den lejer, der bruges til Power Apps-sessionsgodkendelse i integrerede scenarier som f.eks. Power Apps i Power BI.

Label1.Text: Host.TenantID

Egenskab for version

Egenskaben Version angiver spillerens identifikations- og versionsnummer i Power Apps. På samme måde som BrowserUserAgent kan der returneres mere end ét versionsnummer adskilt af mellemrum.

Bemærk

Egenskaben Version er altid en tom streng, når du arbejder i Power Apps Studio.

Label1.Text: Host.Version

Egenskaben OfflineEnabled

Egenskaben OfflineEnabled giver appens kørselstilstand i Power Apps spilleren. I forbindelse med apps, der ikke er aktiveret til offline, er egenskaben altid falsk. I forbindelse med apps, der er aktiveret til offline, er egenskaben falsk på internettet, men sand på iOS, Android og Windows.

Bemærk

Selvom en lærredsapp ikke fungerer uden netværksforbindelsen, forbliver egenskaben OfflineEnabled sand i Power Apps Studio for lærredsapps, der er aktiveret til offlinebrug.

Label1.Text: Host.OfflineEnabled

Eksempler

  1. Opret en ny lærredapp.
  2. Tilføj et kontrolelement af typen Tekstnavn, og angiv egenskaben Text til "Host.BrowserUserAgent: " & Host.BrowserUserAgent.
  3. Tilføj et kontrolelement af typen Tekstnavn, og angiv egenskaben Text til "Host.OSType: " & Host.OSType.
  4. Tilføj et kontrolelement af typen Tekstnavn, og angiv egenskaben Text til "Host.SessionID: " & Host.SessionID.
  5. Tilføj et kontrolelement af typen Tekstnavn, og angiv egenskaben Text til "Host.TenantID: " & Host.TenantID.
  6. Tilføj et kontrolelement af typen Tekstnavn, og angiv egenskaben Text til "Host.Version: " & Host.Version.
  7. Tilføj et kontrolelement af typen Tekstnavn, og angiv egenskaben Text til "Host.OfflineEnabled: " & Host.OfflineEnabled.

Kør din app på forskellige enheder og med forskellige browsere, så du kan se resultater i stil med nedenstående.

Power Apps Studio i Windows med Edge-browser

Host.Version er altid tom, når du arbejder 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-indbygget mobilafspiller 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-webafspiller i Windows med Firefox-browser

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-webafspiller i iOS med Safari-browser

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)