Kongsi melalui


Mengehoskan objek dalam Power Apps

Digunakan pada: Aplikasi kanvas Apl berpandukan model

Objek Hos dalam Power Apps menyediakan maklumat tentang hos semasa yang menjalankan aplikasi.

Description

Objek Hos menyediakan maklumat tentang peranti hos, sistem pengendalian dan pemain yang menjalankan apl. Hos serupa dengan objek Aplikasi dan setiap apl mempunyai akses kepada maklumat ini.

Salah satu kegunaan Hos yang terbaik ialah menyahpepijat apl yang tidak berfungsi dengan betul pada peranti tertentu atau dengan penyemak imbas tertentu. Gunakan sifat teks objek ini untuk memaparkan maklumat dalam UI aplikasi dengan kawalan label Teks atau log maklumat ke jadual pangkalan data atau kepada Application Insights.

Ia menggoda untuk menggunakan Hos untuk menyesuaikan aplikasi ke peranti atau penyemak imbas tertentu. Ini berbahaya seperti Power Apps yang direka untuk dijalankan pada spektrum platform perkakasan dan perisian yang luas dan logik berasaskan Hos anda mungkin tidak mengambil kira mereka semua dan mereka akan berubah dari semasa ke semasa. Pendekatan yang lebih baik adalah menggunakan maklumat yang lebih abstrak dan tidak terikat dengan perkakasan dan perisian tertentu. Contohnya, gunakan sifat Saiz kawalan Skrin untuk menyesuaikan skrin untuk menunjukkan kurang atau menyusun semula maklumat apabila berjalan pada peranti yang lebih kecil seperti telefon.

Untuk mencapai objek Hos dalam Power Apps Studio, kembangkan objek Aplikasi di bahagian atas anak tetingkap pandangan Pohon kemudian pilih Hos. Dalam contoh ini, objek Hos tidak mempunyai sebarang sifat yang menerima formula.

Objek Hos dalam anak tetingkap pandangan Pohon.

Nota

Objek hos pada masa ini hanya tersedia dalam halaman tersuai dan aplikasi kanvas.

Hartanah BrowserUserAgent

Sifat teks BrowserUserAgent mengandungi rentetan ejen pengguna lengkap yang pelayar gunakan untuk mengenal pasti dirinya semasa menjalankan aplikasi.

Contohnya, rentetan ejen pengguna pelayar mungkin:

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

Nota

Jika anda menjalankan Power Apps dalam aplikasi asli atau menggunakan ciri Balut dalam Power Apps, aplikasi dipersembahkan melalui kawalan penyemak imbas, yang membekalkan rentetan ejen pengguna.

Hartanah OSType

Hartanah OSType menyediakan nama sistem pengendalian tempat aplikasi sedang berjalan. OSType ditentukan daripada rentetan ejen pengguna yang dihantar oleh pelayar ke Power Apps. Berikut ialah contoh nilai umum untuk OSType:

Nilai
Tetingkap
Mac OS
iOS
Android
Linux
...

Nota

Jangan gunakan OSType untuk mengubah pengalaman atau kefungsian apl anda berdasarkan sistem pengendalian yang dilaporkan.

Teks OSType boleh digunakan dalam sebarang formula, seperti menunjukkannya dalam sifat teks label:

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

Hartanah SessionID

Sifat SessionID mengembalikan GUID yang mengenal pasti sesi semasa. Sertakan maklumat ini semasa melaporkan masalah kepada pentadbir anda.

Nota

Dalam senario terbenam seperti Power Apps dalam Power BI, sifat SessionID mengembalikan ID sesi dasar Power Apps , bukan Power BI ID sesi.

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

Hartanah TenantID

Hartanah TenantID menyediakan Pengecam Unik Global (GUID) yang menentukan penyewa yang Microsoft Entra berkaitan dengan pengguna yang disahkan sekarang.

Nota

Sama seperti SessionID, dalam senario tertanam seperti Power Apps dalam Power BI, ID penyewa ialah penyewa yang digunakan untuk Power Apps pengesahan sesi.

Label1.Text: Host.TenantID

Sifat versi

Hartanah Versi menyediakan nombor Power Apps pengenalan dan versi pemain. Sama seperti BrowserUserAgent, lebih daripada satu nombor versi boleh dikembalikan, dipisahkan oleh ruang.

Nota

Sifat Versi sentiasa merupakan rentetan kosong apabila bekerja Power Apps Studio.

Label1.Text: Host.Version

Hartanah Didayakan luar talian

Hartanah Luar Talian menyediakan mod masa jalan apl dalam pemain Power Apps . Untuk apl yang tidak didayakan untuk luar talian, penginapan ini sentiasa palsu. Untuk apl yang didayakan untuk luar talian , hartanah adalah palsu di web, tetapi benar pada iOS, Android, dan Windows.

Nota

Walaupun apl kanvas tidak berfungsi tanpa kesambungan rangkaian, sifat OfflineEnabled kekal benar untuk Power Apps Studio apl kanvas yang telah didayakan untuk kegunaan luar talian.

Label1.Text: Host.OfflineEnabled

Contoh

  1. Buat aplikasi Kanvas baharu.
  2. Tambah kawalan label Teks dan setkan sifat Text kepada "Host.BrowserUserAgent: " & Host.BrowserUserAgent.
  3. Tambah kawalan label Teks dan setkan sifat Text kepada "Host.OSType: " & Host.OSType.
  4. Tambah kawalan label Teks dan setkan sifat Text kepada "Host.SessionID: " & Host.SessionID.
  5. Tambah kawalan label Teks dan setkan sifat Text kepada "Host.TenantID: " & Host.TenantID.
  6. Tambah kawalan label Teks dan setkan sifat Text kepada "Host.Version: " & Host.Version.
  7. Tambah kawalan label Teks dan setkan sifat Text kepada "Host.OfflineEnabled: " & Host.OfflineEnabled.

Jalankan apl anda pada peranti yang berbeza dan dengan penyemak imbas yang berbeza dan anda akan melihat hasil yang serupa dengan yang di bawah.

Power Apps Studio pada Windows dengan pelayar Edge

Host.Version sentiasa kosong semasa 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 pemain mudah alih asli pada 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 pemain web pada Windows dengan Firefox penyemak imbas

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 pemain web dihidupkan iOS dengan pelayar 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)