Obiect gazdă în Power Apps

Se aplică pentru: planșă de lucru apps Aplicații bazate pe model

Obiectul Gazdă din Power Apps oferă informații despre gazda curentă care rulează aplicația.

Descriere

Obiectul Gazdă oferă informații despre dispozitivul gazdă, sistemul de operare și playerul care rulează o aplicație. Gazda este similară cu aplicația obiectul și fiecare aplicație are acces la aceste informații.

Una dintre cele mai bune utilizări ale Host este depanarea unei aplicații care nu funcționează corect pe un anumit dispozitiv sau cu un anumit browser. Utilizați proprietățile text ale acestui obiect pentru a afișa informații în interfața de utilizare a aplicației cu o etichetă de text control sau înregistrați informațiile într-un tabel de bază de date sau pentru a Application Insights.

Este tentant să folosiți Host pentru a adapta o aplicație la un anumit dispozitiv sau browser. Acest lucru este periculos deoarece Power Apps este conceput pentru a fi rulat pe un spectru larg de platforme hardware și software, iar logica bazată pe gazdă s-ar putea să nu le țină seama pe toate și se vor schimba în timp. Cea mai bună abordare este să folosiți informații mai abstracte și care nu sunt legate de hardware și software specific. De exemplu, utilizați proprietatea Dimensiune a controlului Ecran pentru a personaliza un ecran pentru a afișa mai puține sau pentru a reorganiza informații atunci când rulează pe un dispozitiv mai mic, cum ar fi un telefon.

Pentru a accesa obiectul Gazdă în Power Apps Studio, extindeți obiectul Aplicație din partea de sus a panoul Afișare arborescent și apoi selectați Gazdă. În acest exemplu, obiectul Gazdă nu are nicio proprietate care acceptă formule.

Notă

Obiectul gazdă este disponibil momentan numai în pagini personalizate și în aplicațiile planșă de lucru.

Proprietate BrowserUserAgent

Proprietatea text BrowserUserAgent conține șirul complet de agent utilizator pe care browserul îl folosește pentru a se identifica atunci când rulează aplicația.

De exemplu, un șir de agent de utilizator al browserului poate fi:

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

Notă

Dacă rulați Power Apps într-o aplicație nativă sau utilizați funcția Încapsulare în Power Apps, aplicația este prezentată prin un control de browser, care furnizează un șir de agent de utilizator.

Proprietate OSType

Proprietatea OSType oferă numele sistemului de operare în care rulează aplicația. OSType este determinat din șirul de agent utilizator trimis de browser către Power Apps. Următoarele sunt exemple de valori comune pentru OSType:

Valoare
Ferestre
Mac OS
iOS
Android
Linux
...

Notă

Nu utilizați OSType pentru a schimba experiența sau funcționalitatea aplicației pe baza sistemului de operare raportat.

Textul OSType poate fi folosit în orice formulă, cum ar fi afișarea acestuia în proprietatea text a unei etichete:

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

Proprietate SessionID

Proprietatea SessionID returnează GUID-ul care identifică sesiunea curentă. Includeți aceste informații atunci când raportați probleme administratorului dvs.

Notă

În scenariile încorporate, cum ar fi Power Apps în Power BI, proprietatea SessionID returnează Power Apps ID-ul de sesiune de bază, nu Power BI ID-ul de sesiune.

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

Proprietatea TenantID

Proprietatea TenantID furnizează identificatorul unic global (GUID) care specifică Microsoft Entra chiriașul asociat cu utilizatorul autentificat în prezent.

Notă

Similar cu SessionID, în scenariile încorporate, cum ar fi Power Apps în Power BI, ID-ul locatarului este chiriașul folosit pentru Power Apps autentificarea sesiunii.

Label1.Text: Host.TenantID

Proprietatea versiunii

Proprietatea Version oferă identificarea și numărul versiunii Power Apps jucatorului. Similar cu BrowserUserAgent, pot fi returnate mai multe numere de versiune, separate prin spații.

Notă

Proprietatea Version este întotdeauna un șir gol atunci când se lucrează în Power Apps Studio.

Label1.Text: Host.Version

Proprietate Offline Enabled

Proprietatea OfflineEnabled oferă modul de rulare al aplicației în Power Apps player. Pentru aplicațiile care nu sunt activate pentru offline, proprietatea este întotdeauna falsă. Pentru aplicațiile care sunt activate pentru offline proprietatea este falsă pe web, dar adevărată pe iOS, Android și Windows.

Notă

Chiar dacă un aplicație creată pe planșă nu funcționează fără conexiune la rețea, proprietatea OfflineEnabled rămâne valabilă în Power Apps Studio pentru aplicațiile planșă de lucru care au fost activate pentru offline utilizare.

Label1.Text: Host.OfflineEnabled

Exemple

1. Creați un nou aplicație creată pe planșă.
2. Adăugați un control Etichetă text și setați proprietatea Text la "Host.BrowserUserAgent: " & Host.BrowserUserAgent.
3. Adăugați un control Etichetă text și setați proprietatea Text la "Host.OSType: " & Host.OSType.
4. Adăugați un control Etichetă text și setați proprietatea Text la "Host.SessionID: " & Host.SessionID.
5. Adăugați un control Etichetă text și setați proprietatea Text la "Host.TenantID: " & Host.TenantID.
6. Adăugați un control Etichetă text și setați proprietatea Text la "Host.Version: " & Host.Version.
7. Adăugați un control Etichetă text și setați proprietatea Text la "Host.OfflineEnabled: " & Host.OfflineEnabled.

Rulați aplicația pe diferite dispozitive și cu browsere diferite și veți vedea rezultate similare cu cele de mai jos.

Power Apps Studio pe Windows cu browser Edge

Versiunea gazdă este întotdeauna goală atunci când lucrați în 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 playerul mobil nativ activat 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 player web pe Windows cu 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 player web pe iOS cu 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)