Об’єкт host у 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 Сафарі/537.36 Edg/109.0.1518.78

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

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

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

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

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

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

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

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

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

Label1.Text: Host.TenantID

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

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

Label1.Text: Host.Version

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

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

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: aaaabbbb-0000-cccc-1111-dddd2222eeee
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: aaaabbbb-0000-cccc-1111-dddd2222eeee
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: aaaabbbb-0000-cccc-1111-dddd2222eeee
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: aaaabbbb-0000-cccc-1111-dddd2222eeee
Host.Version: PowerApps-Web/3.23084.6(iOS)