Хост-об’єкт у Power Apps

Застосовується до: програм Canvas Програм на основі моделі

Об’єкт Host у Power Apps надає інформацію про поточний хост, на якому запущено програму.

Опис

Об’єкт «Хост» надає інформацію про хост-пристрій, операційну систему та програвач, на якому запущено програму. Host схожий на об’єкт App , і кожен додаток має доступ до цієї інформації.

Одним із найкращих способів використання Host є налагодження програми, яка не працює належним чином на певному пристрої або в певному браузері. Використовуйте текстові властивості цього об’єкта для відображення інформації в інтерфейсі користувача програми за допомогою елемента керування «Текстова мітка» або записуйте інформацію в таблицю бази даних або до Application Insights.

Існує спокуса використовувати Host , щоб адаптувати програму до певного пристрою або браузера. Це небезпечно, оскільки Power Apps призначене для роботи на широкому спектрі апаратних і програмних платформ, і ваша логіка на основі хоста може не враховувати їх усі, і вони змінюватимуться з часом. Кращим підходом є використання інформації, яка є більш абстрагованою та не прив’язаною до конкретного апаратного та програмного забезпечення. Наприклад, використовуйте властивість «Розмір» елемента керування «Екран», щоб налаштувати екран так, щоб відображати менше або реорганізувати інформацію під час роботи на меншому пристрої, наприклад телефоні.

Щоб отримати доступ до об’єкта «Хост Power Apps Studio», розгорніть об’єкт «Програма » у верхній частині панелі подання дерева, а потім виберіть «Хост». У цьому прикладі об’єкт Host не має властивостей, які приймають формули.

Нотатка

Хост-об’єкт наразі доступний лише на користувацьких сторінках і в програмах полотна.

Властивість BrowserUserAgent

Текстова властивість BrowserUserAgent містить повний рядок агента користувача, який браузер використовує для ідентифікації себе під час запуску програми.

Наприклад, рядок агента користувача браузера може бути таким:

• Mozilla/5.0 (Windows NT 10.0; Win64; х64)
• AppleWebKit/537.36 (KHTML, як Gecko)
• Chrome/109.0.0.0 Safari/537.36 Edg/109.0.1518.78

Нотатка

Якщо ви працюєте Power Apps в рідному додатку або використовуєтеУпакування Power Apps, додаток представлений за допомогою елемента керування браузера, який надає рядок агента користувача.

Властивість OSType

Властивість OSType надає ім’я операційної системи, в якій запущено програму. OSType визначається за рядком агента користувача, на Power Apps який надсилає браузер. Нижче наведено приклади загальних значень для OSType:

Значення
Вікна
Mac OS
iOS
Android
Linux
...

Нотатка

Не використовуйте OSType , щоб змінювати досвід або функціональність додатка залежно від повідомленої операційної системи.

Текст OSType можна використовувати в будь-якій формулі, наприклад, показувати його у властивості тексту мітки:

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

Властивість SessionID

Властивість SessionID повертає ідентифікатор GUID, який визначає поточний сеанс. Вказуйте цю інформацію, коли повідомляєте адміністратору про проблеми.

Нотатка

У вбудованих сценаріях, як-от Power Apps in Power BI, властивість SessionID повертає базовий Power Apps ідентифікатор сеансу, а не Power BI ідентифікатор сеансу.

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

Властивість TenantID

Властивість TenantID надає глобальний унікальний ідентифікатор (GUID), який визначає Microsoft Entra клієнта, пов’язаного з поточним автентифікованим користувачем.

Нотатка

Подібно до SessionID, у вбудованих сценаріях, наприклад Power Apps у, Power BI ідентифікатор клієнта – це клієнт, який використовується для автентифікації сеансу Power Apps .

Label1.Text: Host.TenantID

Властивість версії

Властивість Version надає ідентифікацію та номер Power Apps версії гравця. Подібно до BrowserUserAgent, може бути повернуто більше одного номера версії, розділених пробілами.

Нотатка

Властивість Version завжди є порожнім рядком під час роботи Power Apps Studio.

Label1.Text: Host.Version

Властивість OfflineEnabled

Властивість OfflineEnabled забезпечує режим виконання програми в Power Apps програвачі. Для програм, які не ввімкнено в автономному режимі, властивість завжди має значення false. Для програм, які увімкнено для автономного режиму , властивість є хибною в Інтернеті, але вірною для iOS, Android, та Windows.

Нотатка

Навіть якщо програма на полотні не працює без підключення до мережі, властивість OfflineEnabled залишається вірною для Power Apps Studio програм полотна, які було ввімкнуто для використання в автономному режимі.

Label1.Text: Host.OfflineEnabled

Приклади

1. Створіть нову програму Canvas.
2. Додайте елемент керування «Текстова мітка » та встановіть властивість Text на "Host.BrowserUserAgent: " & Host.BrowserUserAgent.
3. Додайте елемент керування «Текстова мітка » та встановіть властивість Text на "Host.OSType: " & Host.OSType.
4. Додайте елемент керування «Текстова мітка » та встановіть властивість Text на "Host.SessionID: " & Host.SessionID.
5. Додайте елемент керування «Текстова мітка » та встановіть властивість Text на "Host.TenantID: " & Host.TenantID.
6. Додайте елемент керування «Текстова мітка » та встановіть властивість Text на "Host.Version: " & Host.Version.
7. Додайте елемент керування «Текстова мітка » та встановіть властивість Text на "Host.OfflineEnabled: " & Host.OfflineEnabled.

Запустіть свою програму на різних пристроях і в різних браузерах, і ви побачите результати, подібні до наведених нижче.

Power Apps Studio у Windows із браузером Edge

Host.Version завжди порожній при роботі в. 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 Рідний мобільний плеєр увімкнено 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 веб-плеєр на Windows з браузером 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)

Power Apps веб-програвач увімкнено iOS в браузері 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)