Dela via

Värdobjekt i Power Apps

  • Artikel

Gäller för: Arbetsyteappar Modellbaserade appar

Värd objekt i Power Apps information om den aktuella värddatorn som kör appen.

Beskrivning

Objektet Värd ger information om värdenheten, operativsystemet och spelaren som kör en app. Värden liknar appobjektet och alla appar har åtkomst till den här informationen .

En av de bästa sätten att använda Värd är att felsöka en app som inte fungerar på en viss enhet eller med en viss webbläsare. Använd objektets textegenskaper om du vill visa information i appens användargränssnitt med en Textetikett-kontroll eller logga informationen till en databastabell eller till Application Insights.

Det är frestande att använda Värd för att skräddarsy en app för en viss enhet eller webbläsare. Detta är farligt eftersom Power Apps är utformad för att köras på ett brett spektrum av hårdvaru- och mjukvaruplattformar och din Värd-baserade logik kanske inte står för dem alla och de kommer att förändras över tiden. Det bästa är att använda information som är mer sammanfattning och inte kopplad till specifik maskinvara och programvara. Du kan till exempel använda egenskapen Storlek för Skärm-kontrollen för att skräddarsy en skärm för att visa mindre eller ordna om information när den körs på en mindre enhet, till exempel en telefon.

För åtkomst till Värd-objekt i Power Apps Studio, expandera App-objekt längst upp på rutan Trädvy och väljer sedan Värd. I det här exemplet har Värd-objektet inga egenskaper som accepterar formeln.

Värdobjektet i trävyfönstret.

Kommentar

Värdobjektet är för närvarande endast tillgängligt i anpassade sidor och arbetsyteappar.

Egenskapen BrowserUserAgent

Textegenskapen BrowserUserAgent innehåller den fullständiga användaragentsträng som webbläsaren använder för att identifiera sig när appen körs.

En webbläsaragentssträng kan till exempel vara:

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

Kommentar

Om du kör i en Power Apps i inbyggd app eller använder funktionen omslutning i Power Apps presenteras appen via en webbläsarkontroll, som tillhandahåller en användaragentsträng.

Egenskapen OSType

Egenskapen OSType anger namnet på operativsystemet där appen körs. OSType avgörs av användarens agentsträng som skickats av webbläsaren till Power Apps. Följande är exempel på vanliga värden för OSType:

Värde
Fönster
Mac OS
iOS
Android
Linux
...

Kommentar

Använd inte OSType för att ändra upplevelsen eller funktionerna i appen baserat på det rapporterade operativsystemet.

OSType-texten kan användas i alla formeln, t.ex. visas i en etiketts textegenskap:

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

Egenskapen SessionID

Egenskapen SessionID returnerar GUID som identifierar den aktuella sessionen. Ta med den här informationen när du rapporterar problem till administratör.

Kommentar

I inbäddade scenarier, t.ex. Power Apps i Power BI returnerar egenskapen SessionID det underliggande Power Apps sessions-ID:t, inte sessions-ID för Power BI.

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

Egenskapen TenantID

Egenskapen TenantID ger GUID (Globally Unique Identifier) som anger den Microsoft Entra klientorganisation som är associerad med den för närvarande autentiserade användaren.

Kommentar

På samma sätt som med SessionID, i inbäddade scenarier som Power Apps i Power BI, är klientorganisations-ID:t den klientorganisation som används för Power Apps sessionsautentisering.

Label1.Text: Host.TenantID

Versionsegenskap

Egenskapen Version tillhandahåller identifikationen och versionsnumret för Power Apps-spelaren. Ungefär som BrowserUserAgent kan mer än ett versionsnummer returneras, avgränsat med blanksteg.

Kommentar

Egenskapen Version är alltid en tom sträng när du arbetar i Power Apps Studio.

Label1.Text: Host.Version

Egenskapen OfflineEnabled

Egenskapen OfflineEnabled tillhandahåller appens körningsläge i Power Apps-spelaren. För appar som inte är aktiverade för offline är egenskapen alltid falsk. För appar som är aktiverade för offline är egenskapen falsk på webben, men sant på iOS, Android och Windows.

Kommentar

Även om en arbetsyteapp inte fungerar utan nätverksanslutning, förblir egenskapen OfflineEnabled sann i Power Apps Studio för arbetsyteappar som har aktiverats för offlineanvändning.

Label1.Text: Host.OfflineEnabled

Exempel

  1. Skapa en ny arbetsyteapp.
  2. Lägg till en Textetikett-kontroll och ange egenskapen Text till "Host.BrowserUserAgent: " & Host.BrowserUserAgent.
  3. Lägg till en Textetikett-kontroll och ange egenskapen Text till "Host.OSType: " & Host.OSType.
  4. Lägg till en Textetikett-kontroll och ange egenskapen Text till "Host.SessionID: " & Host.SessionID.
  5. Lägg till en Textetikett-kontroll och ange egenskapen Text till "Host.TenantID: " & Host.TenantID.
  6. Lägg till en Textetikett-kontroll och ange egenskapen Text till "Host.Version: " & Host.Version.
  7. Lägg till en Textetikett-kontroll och ange egenskapen Text till "Host.OfflineEnabled: " & Host.OfflineEnabled.

Kör appen på olika enheter och med olika webbläsare så ser du resultat liknande som nedan.

Power Apps Studio på Windows med Edge-webbläsare

Host.Version är alltid tom när du arbetar 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 inbyggd mobilspelare 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 webbspelare på Windows med Firefox webbläsare

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 webbspelare på iOS med Safari-webbläsare

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)