Host-object in Power Apps

  • Artikel

Van toepassing op: Canvas-apps Modelgestuurde apps

Het Host-object in Power Apps biedt informatie over de huidige host die de app uitvoert.

Omschrijving

Het Host-object biedt informatie over het hostapparaat, het besturingssysteem en de speler waarop een app draait. Host is vergelijkbaar met het App-object, en elke app heeft toegang tot deze informatie.

Een van de beste toepassingen van Host is het debuggen van een app die niet goed werkt op een specifiek apparaat of met een specifieke browser. Gebruik de teksteigenschappen van dit object om informatie in de gebruikersinterface van de app weer te geven met een besturingselement Tekstlabel, of log de informatie in een databasetabel of naar Application Insights.

Het is verleidelijk om Host te gebruiken om een ​​app aan te passen aan een specifiek apparaat of browser. Dit brengt gevaren met zich mee, omdat Power Apps is ontworpen om te worden uitgevoerd op een breed spectrum aan hardware- en softwareplatforms, en uw, op Host gebaseerde logica kan ze misschien niet allemaal verklaren. Bovendien kunnen ze in de loop der tijd veranderen. De betere aanpak is om informatie te gebruiken die meer abstract is en niet gebonden aan specifieke hard- en software. Gebruik bijvoorbeeld de eigenschap Formaat van het besturingselement Scherm om een ​​scherm aan te passen om minder informatie weer te geven, of om informatie te reorganiseren wanneer u op een kleiner apparaat, zoals een telefoon, draait.

Om toegang te krijgen tot het object Host in Power Apps Studio, vouwt u het App-object bovenaan het deelvenster Structuurweergave uit en selecteert u vervolgens Host. In dit voorbeeld heeft het Host-object geen eigenschappen die formules accepteren.

Het Host-object in het deelvenster Structuurweergave.

Opmerking

Het Host-object is momenteel alleen beschikbaar in aangepaste pagina's en canvas-apps.

BrowserUserAgent-eigenschap

De teksteigenschap BrowserUserAgent bevat de volledige tekenreeks van de gebruikersagent die de browser gebruikt om zichzelf te identificeren bij het uitvoeren van de app.

Een tekenreeks van een browsergebruikersagent kan bijvoorbeeld zijn:

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

Opmerking

Als u Power Apps in een systeemeigen app uitvoert of de verpakkingsfunctie in Power Apps gebruikt, wordt de app gepresenteerd via een browserbesturingselement, dat een tekenreeks voor een gebruikersagent levert.

OSType-eigenschap

De OSType-eigenschap bevat de naam van het besturingssysteem waarop de app wordt uitgevoerd. OSType wordt bepaald op basis van de tekenreeks van de gebruikersagent die door de browser is verzonden naar Power Apps. Hieronder volgen voorbeelden van veelgebruikte waarden voor OSType:

Weergegeven als
Vensters
Mac OS
iOS
Android
Linux
...

Opmerking

Gebruik het OSType niet om de ervaring of functionaliteit van uw app te wijzigen op basis van het gerapporteerde besturingssysteem.

De OSType-tekst kan in elke formule worden gebruikt, bijvoorbeeld om deze weer te geven in de teksteigenschap van een label:

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

SessionID-eigenschap

De eigenschap SessionID retourneert de GUID die de huidige sessie aanduidt. Neem deze informatie op wanneer u problemen rapporteert aan uw systeembeheerder.

Opmerking

In ingesloten scenario's, zoals Power Apps in Power BI, retourneert de eigenschap SessionID de onderliggende sessie-ID van Power Apps, niet de sessie-ID van Power BI.

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

TenantID-eigenschap

De eigenschap TenantID bevat de GUID (Globally Unique Identifier) waarmee de Microsoft Entra-tenant wordt opgegeven die is gekoppeld aan de momenteel geverifieerde gebruiker.

Opmerking

Vergelijkbaar met SessionID, in ingesloten scenario's zoals in Power Apps in Power BI, is de tenant-id de tenant die wordt gebruikt voor de Power Apps-sessieverificatie.

Label1.Text: Host.TenantID

Versie-eigenschap

De eigenschap Versie geeft de identificatie en het versienummer van de Power Apps-speler weer. Net als bij BrowserUserAgent kan er meer dan één versienummer worden geretourneerd, gescheiden door spaties.

Opmerking

De eigenschap Versie is altijd een lege tekenreeks als er in Power Apps Studio wordt gewerkt.

Label1.Text: Host.Version

Eigenschap OfflineEnabled

De eigenschap OfflineEnabled biedt de runtimemodus van de app in de Power Apps-speler. Voor apps waarvoor offline niet is ingeschakeld, is de eigenschap altijd false. Voor apps die wel zijn ingeschakeld voor offline is de eigenschap false op internet, maar true in iOS, Android en Windows.

Opmerking

Zelfs als een canvas-app niet functioneert zonder netwerkconnectiviteit, blijft de eigenschap OfflineEnabled true in Power Apps Studio voor canvas-apps die zijn ingeschakeld voor offline gebruik.

Label1.Text: Host.OfflineEnabled

Voorbeelden

  1. Een nieuwe Canvas-app maken
  2. Voeg een besturingselement Tekstlabel toe en stel de eigenschap Text in op "Host.BrowserUserAgent: " & Host.BrowserUserAgent.
  3. Voeg een besturingselement Tekstlabel toe en stel de eigenschap Text in op "Host.OSType: " & Host.OSType.
  4. Voeg een besturingselement Tekstlabel toe en stel de eigenschap Text in op "Host.SessionID: " & Host.SessionID.
  5. Voeg een besturingselement Tekstlabel toe en stel de eigenschap Text in op "Host.TenantID: " & Host.TenantID.
  6. Voeg een besturingselement Tekstlabel toe en stel de eigenschap Text in op "Host.Version: " & Host.Version.
  7. Voeg een besturingselement Tekstlabel toe en stel de eigenschap Text in op "Host.OfflineEnabled: " & Host.OfflineEnabled.

Voer uw app uit op verschillende apparaten en met verschillende browsers, en u zult resultaten zien die vergelijkbaar zijn met de onderstaande resultaten.

Power Apps Studio op Windows met de Edge-browser

Host.Version is altijd leeg als u werkt in 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-native mobiele speler in 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-webplayer op Windows met 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-webplayer op Windows met iOS-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)