Oggetto Host in Power Apps

  • Articolo

Si applica a: App canvas App basate su modello

L'oggetto Host in Power Apps fornisce informazioni sull'host corrente che esegue l'app.

Description

L'oggetto Host fornisce informazioni sul dispositivo host, sul sistema operativo e sul lettore che esegue un'app. Host è simile all'oggetto App e ogni app ha accesso a tali informazioni.

Uno degli utilizzi migliori di Host è eseguire il debug di un'app che non funziona correttamente in un dispositivo specifico o con un browser specifico. Utilizza le proprietà del testo di questo oggetto per visualizzare le informazioni nell'interfaccia utente dell'app con un controllo Etichetta di testo o per registrare le informazioni in una tabella di database o in Application Insights.

È tentante usare Host per personalizzare un'app per un dispositivo o browser specifico. Ciò è rischioso in quanto Power Apps è progettato per essere eseguito su un ampio spettro di piattaforme hardware e software e la tua logica basata su Host potrebbe non tenere conto di tutte tali piattaforme, che cambieranno nel tempo. L'approccio migliore consiste nell'utilizzare informazioni più astratte e non legate a hardware e software specifici. Ad esempio, utilizza la proprietà Size del controllo Schermata per personalizzare una schermata in modo da mostrare meno o riorganizzare le informazioni durante l'esecuzione su un dispositivo più piccolo come un telefono.

Per accedere all'oggetto Host in Power Apps Studio, espandi l'oggetto App nella parte superiore del riquadro Visualizzazione ad albero e quindi seleziona Host. In questo esempio, l'oggetto Host non ha proprietà che accettano formule.

L'oggetto Host nel riquadro Visualizzazione ad albero.

Nota

L'oggetto host è attualmente disponibile solo nelle pagine personalizzate e nelle app canvas.

Proprietà BrowserUserAgent

La proprietà di testo BrowserUserAgent contiene la stringa completa dell'agente utente che il browser utilizza per identificarsi durante l'esecuzione dell'app.

Ad esempio, una stringa dell'agente utente del browser potrebbe essere:

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

Nota

Se esegui Power Apps in un'app nativa o utilizzi la funzione wrap in Power Apps, l'app viene presentata tramite un controllo del browser, che fornisce una stringa dell'agente utente.

Proprietà OSType

La proprietà OSTType fornisce il nome del sistema operativo in cui è in esecuzione l'app. La proprietà OSTType è determinata dalla stringa dell'agente utente inviata dal browser a Power Apps. I seguenti sono esempi di valori comuni per OSTType:

valore
Finestre
Mac OS
iOS
Android
Linux
...

Nota

Non utilizzare OSType per modificare esperienza o funzionalità della tua app in base al sistema operativo segnalato.

Il testo OSTType può essere utilizzato in qualsiasi formula, ad esempio mostrandolo nella proprietà di testo di un'etichetta:

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

Proprietà SessionID

La proprietà SessionID restituisce il GUID che identifica la sessione corrente. Includi queste informazioni quando segnali problemi al tuo amministratore.

Nota

In scenari incorporati come Power Apps in Power BI, la proprietà SessionID restituisce l'ID di sessione Power Apps sottostante, non l'ID di sessione Power BI.

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

Proprietà TenantID

La proprietà TenantID fornisce il GUID che specifica il tenant Microsoft Entra associato all'utente attualmente autenticato.

Nota

Come per SessionID in scenari incorporati come Power Apps in Power BI l'ID tenant è il tenant usato per l'autenticazione della sessione Power Apps.

Label1.Text: Host.TenantID

Proprietà Version

La proprietà Version fornisce l'identificazione e il numero di versione del lettore Power Apps. Come con BrowserUserAgent, può essere restituito più di un numero di versione, separato da spazi.

Nota

La proprietà Version è sempre una stringa vuota quando si lavora in Power Apps Studio.

Label1.Text: Host.Version

Proprietà OfflineEnabled

La proprietò OfflineAbilitato fornisce la modalità di runtime dell'app nel lettore Power Apps. Per le app non abilitate per la modalità offline, la proprietà è sempre false. Per le app che sono abilitate per offline la proprietà è false sul web, ma true su iOS, Android e Windows.

Nota

Anche se un'app canvas non funziona senza connettività di rete, la proprietà OfflineEnabled rimane vera in Power Apps Studio per le app canvas che sono state abilitate per l'utilizzo offline.

Label1.Text: Host.OfflineEnabled

Esempi

  1. Crea una nuova app canvas.
  2. Aggiungi un controllo Etichetta di testo e imposta la proprietà Text su "Host.BrowserUserAgent: " & Host.BrowserUserAgent.
  3. Aggiungi un controllo Etichetta di testo e imposta la proprietà Text su "Host.OSType: " & Host.OSType.
  4. Aggiungi un controllo Etichetta di testo e imposta la proprietà Text su "Host.SessionID: " & Host.SessionID.
  5. Aggiungi un controllo Etichetta di testo e imposta la proprietà Text su "Host.TenantID: " & Host.TenantID.
  6. Aggiungi un controllo Etichetta di testo e imposta la proprietà Text su "Host.Version: " & Host.Version.
  7. Aggiungi un controllo Etichetta di testo e imposta la proprietà Text su "Host.OfflineEnabled: " & Host.OfflineEnabled.

Esegui l'app su dispositivi differenti e con browser differenti e vedrai risultati simili a quanto segue.

Power Apps Studio su Windows con il browser Edge

Host.Version è sempre vuoto quando si lavora 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:

Lettore mobile nativo Power Apps 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)

Lettore Web Power Apps in Windows con il browser Firefox

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)

Lettore Web Power Apps in iOS con il browser Safari

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)