Объект "Узел" в Power Apps
Применимо к:
приложениям на основе холста приложениям на основе модели
Объект Узел в Power Apps предоставляет информацию о текущем узле, на котором запущено приложение.
Объект Хост предоставляет информацию о хост-устройстве, операционной системе и проигрывателе, на котором запущено приложение. Хост аналогичен объекту Приложения , и каждое приложение имеет доступ к этой информации.
Одно из лучших применений Хоста — отладка приложения, которое не работает должным образом на определенном устройстве или в определенном браузере. Используйте текстовые свойства этого объекта для отображения информации в пользовательском интерфейсе приложения с помощью Текстовой метки или выводите информацию в таблицу в базе данных или в Application Insights.
Может возникнуть желание использовать Хост, чтобы адаптировать приложение к конкретному устройству или браузеру. Это опасно, так как Power Apps предназначен для работы на широком спектре аппаратных и программных платформ, а логика Хоста может не учитывать их все, и со временем они будут меняться. Лучше использовать более абстрактную информацию, не привязанную к конкретному аппаратному и программному обеспечению. Например, используйте свойство Размер элемента управления Экран, чтобы настроить экран так, чтобы он отображал меньше информации, или реорганизовать информацию при работе на меньшем устройстве, например на телефоне.
Для доступа к объекту Хост в Power Apps Studio разверните объект Приложение в верхней части панель Дерево , а затем выберите Хост. В этом примере объект Узел не имеет свойств, которые принимают формулы.
Примечание
В настоящее время объект "узел" доступен только на настраиваемых страницах и в приложениях на основе холста.
Текстовое свойство BrowserUserAgent содержит полную строку агента пользователя, которую браузер использует для идентификации себя при запуске приложения.
Например, строка агента пользователя браузера может быть такой:
- Mozilla/5.0 (Windows NT 10.0; Win64; x64)
- AppleWebKit/537.36 (KHTML, например Gecko)
- Chrome/109.0.0.0 Safari/537.36 Edg/109.0.1518.78
Примечание
Если Power Apps выполняется в собственном приложении или вы используете функцию упаковки в Power Apps, приложение представляется через элемент управления браузера, который предоставляет строку агента пользователя.
Свойство OSType задает имя операционной системы, в которой работает приложение. OSType определяется из строки агента пользователя, отправленной браузером в Power Apps. Ниже приведены примеры общих значений для OSType:
| Стоимость |
|---|
| Окна |
| Mac OS |
| iOS |
| Android |
| Linux |
| ... |
Примечание
Не используйте OSType для изменения интерфейса или функциональности вашего приложения в зависимости от указанной операционной системы.
Текст OSType можно использовать в любой формуле, например отображать его в текстовом свойстве подписи:
Label1.Text: "You're running " & Host.OSType
Свойство SessionID возвращает GUID, идентифицирующий текущий сеанс. Включите эту информацию, сообщая о проблемах своему администратору.
Примечание
Во встроенных сценариях, таких как Power Apps в Power BI, свойство SessionID возвращает ИД базового сеанса Power Apps, а не ИД сеанса Power BI.
Label1.Text: $"Provide session ID { Host.SessionID } to your administrator."
Свойство 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 обеспечивает режим выполнения приложения в проигрывателе Power Apps. Для приложений, которые не поддерживают автономный режим, свойство всегда имеет значение false. Для приложений, которые включены для работы в автономном режиме, это свойство имеет значение false в Интернете, но true в iOS, Android и Windows.
Примечание
Даже если приложение на основе холста не работает без подключения к сети, свойство OfflineEnabled остается true в Power Apps Studio для приложений на основе холста, для которых включено автономное использование.
Label1.Text: Host.OfflineEnabled
- Создание приложения на основе холста.
- Добавьте элемент управления Текстовая подпись и задайте для его свойства
Textзначение"Host.BrowserUserAgent: " & Host.BrowserUserAgent. - Добавьте элемент управления Текстовая подпись и задайте для его свойства
Textзначение"Host.OSType: " & Host.OSType. - Добавьте элемент управления Текстовая подпись и задайте для его свойства
Textзначение"Host.SessionID: " & Host.SessionID. - Добавьте элемент управления Текстовая подпись и задайте для его свойства
Textзначение"Host.TenantID: " & Host.TenantID. - Добавьте элемент управления Текстовая подпись и задайте для его свойства
Textзначение"Host.Version: " & Host.Version. - Добавьте элемент управления Текстовая подпись и задайте для его свойства
Textзначение"Host.OfflineEnabled: " & Host.OfflineEnabled.
Запустите свое приложение на разных устройствах и в разных браузерах, и вы увидите результаты, аналогичные приведенным ниже.
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:
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)
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)
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)