Bagikan melalui

Host di Power Apps

  • Artikel

Berlaku untuk: Aplikasi kanvas Aplikasi berdasarkan model

Objek Host dalam memberikan Power Apps informasi tentang host saat ini yang menjalankan aplikasi.

Description

Objek Host memberikan informasi tentang perangkat host, sistem operasi, dan pemutar yang menjalankan aplikasi. Host mirip dengan objek App dan setiap aplikasi memiliki akses ke informasi ini.

Salah satu kegunaan terbaik Host adalah untuk men-debug aplikasi yang tidak berfungsi dengan baik pada perangkat tertentu atau dengan browser tertentu. Gunakan properti teks objek ini untuk menampilkan informasi di UI aplikasi dengan kontrol Label teks atau mencatat informasi ke tabel database atau ke. Application Insights

Sangat menggoda untuk menggunakan Host untuk menyesuaikan aplikasi dengan perangkat atau browser tertentu. Ini berbahaya karena Power Apps dirancang untuk dijalankan pada spektrum luas platform perangkat keras dan perangkat lunak dan logika berbasis Host Anda mungkin tidak memperhitungkan semuanya dan mereka akan berubah seiring waktu. Pendekatan yang lebih baik adalah menggunakan informasi yang lebih abstrak dan tidak terikat pada perangkat keras dan perangkat lunak tertentu. Misalnya, gunakan properti Ukuran kontrol Layar untuk menyesuaikan layar agar lebih sedikit menampilkan atau mengatur ulang informasi saat berjalan pada perangkat yang lebih kecil seperti ponsel.

Untuk mengakses objek Host, perluas objek Aplikasi di bagian atas panel Tampilan Power Apps Studiohierarkis, lalu pilih Host . Dalam contoh ini, objek Host tidak memiliki properti apa pun yang menerima rumus.

Objek Host di panel Tampilan hierarkis.

Catatan

Objek host saat ini hanya tersedia di halaman kustom dan aplikasi kanvas.

Properti BrowserUserAgent

Properti teks BrowserUserAgent berisi string agen pengguna lengkap yang digunakan browser untuk mengidentifikasi dirinya sendiri saat menjalankan aplikasi.

Misalnya, string agen pengguna browser mungkin:

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

Catatan

Jika Anda berjalan Power Apps di aplikasi asli atau menggunakan fitur theWrap Power Apps, aplikasi disajikan melalui kontrol browser, yang menyediakan string agen pengguna.

Properti OSType

Properti OSType menyediakan nama sistem operasi tempat aplikasi berjalan. OSType ditentukan dari string agen pengguna yang dikirim oleh browser ke. Power Apps Berikut ini adalah contoh nilai umum untuk OSType:

Nilai
Jendela
Mac OS
iOS
Android
Linux
...

Catatan

Jangan gunakan OSType untuk mengubah pengalaman atau fungsionalitas aplikasi Anda berdasarkan sistem operasi yang dilaporkan.

Teks OSType dapat digunakan dalam rumus apa pun, seperti menampilkannya dalam properti teks label:

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

Properti SessionID

Properti SessionID mengembalikan GUID yang mengidentifikasi sesi saat ini. Sertakan informasi ini saat melaporkan masalah kepada administrator.

Catatan

Dalam skenario yang disematkan seperti Power Apps in Power BI, properti SessionID mengembalikan ID sesi yang mendasarinya Power Apps , bukan Power BI ID sesi.

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

Properti TenantID

Properti TenantID menyediakan Pengidentifikasi Unik Global (GUID) yang menentukan penyewa yang Microsoft Entra terkait dengan pengguna yang saat ini diautentikasi.

Catatan

Mirip dengan SessionID, dalam skenario tersemat seperti Power Apps in Power BI, ID penyewa adalah penyewa yang digunakan untuk Power Apps autentikasi sesi.

Label1.Text: Host.TenantID

Properti versi

Properti Versi menyediakan identifikasi dan nomor versi pemain Power Apps . Mirip dengan BrowserUserAgent, lebih dari satu nomor versi dapat dikembalikan, dipisahkan oleh spasi.

Catatan

Properti Version selalu merupakan string kosong saat bekerja Power Apps Studio.

Label1.Text: Host.Version

Properti OfflineEnabled

Properti OfflineEnabled menyediakan mode runtime aplikasi di Power Apps pemutar. Untuk aplikasi yang tidak diaktifkan untuk offline, properti selalu false. Untuk aplikasi yang diaktifkan untuk offline , properti adalah false di web, tetapi benar di, iOS, Android dan Windows.

Catatan

Bahkan jika aplikasi kanvas tidak berfungsi tanpa konektivitas jaringan, properti OfflineEnabled tetap berlaku untuk Power Apps Studio aplikasi kanvas yang telah diaktifkan untuk penggunaan offline.

Label1.Text: Host.OfflineEnabled

Contoh

  1. Buat aplikasi Canvas baru.
  2. Tambahkan kontrol Label teks dan atur properti ke Text . "Host.BrowserUserAgent: " & Host.BrowserUserAgent
  3. Tambahkan kontrol Label teks dan atur properti ke Text . "Host.OSType: " & Host.OSType
  4. Tambahkan kontrol Label teks dan atur properti ke Text . "Host.SessionID: " & Host.SessionID
  5. Tambahkan kontrol Label teks dan atur properti ke Text . "Host.TenantID: " & Host.TenantID
  6. Tambahkan kontrol Label teks dan atur properti ke Text . "Host.Version: " & Host.Version
  7. Tambahkan kontrol Label teks dan atur properti ke Text . "Host.OfflineEnabled: " & Host.OfflineEnabled

Jalankan aplikasi Anda di perangkat yang berbeda dan dengan browser yang berbeda dan Anda akan melihat hasil yang mirip dengan di bawah ini.

Power Apps Studio di Windows dengan browser Edge

Host.Version selalu kosong saat bekerja 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 Pemutar seluler asli aktif 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 pemutar web di Windows dengan 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 pemutar web aktif iOS dengan 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)