Поделиться через

Объект "Узел" в Power Apps

  • Статья

Применимо к: Приложениям Canvas Приложениям, управляемым моделями

Объект Узел в Power Apps предоставляет информацию о текущем узле, на котором запущено приложение.

Description

Объект Хост предоставляет информацию о хост-устройстве, операционной системе и проигрывателе, на котором запущено приложение. Хост аналогичен объекту Приложения , и каждое приложение имеет доступ к этой информации.

Одно из лучших применений Хоста — отладка приложения, которое не работает должным образом на определенном устройстве или в определенном браузере. Используйте текстовые свойства этого объекта для отображения информации в пользовательском интерфейсе приложения с помощью Текстовой метки или выводите информацию в таблицу в базе данных или в Application Insights.

Может возникнуть желание использовать Хост, чтобы адаптировать приложение к конкретному устройству или браузеру. Это опасно, так как Power Apps предназначен для работы на широком спектре аппаратных и программных платформ, а логика Хоста может не учитывать их все, и со временем они будут меняться. Лучше использовать более абстрактную информацию, не привязанную к конкретному аппаратному и программному обеспечению. Например, используйте свойство Размер элемента управления Экран, чтобы настроить экран так, чтобы он отображал меньше информации, или реорганизовать информацию при работе на меньшем устройстве, например на телефоне.

Для доступа к объекту Хост в Power Apps Studio разверните объект Приложение в верхней части панель Дерево , а затем выберите Хост. В этом примере объект Узел не имеет свойств, которые принимают формулы.

Объект

Заметка

В настоящее время объект "узел" доступен только на настраиваемых страницах и в приложениях на основе холста.

Свойство BrowserUserAgent

Текстовое свойство 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 задает имя операционной системы, в которой работает приложение. OSType определяется из строки агента пользователя, отправленной браузером в Power Apps. Ниже приведены примеры общих значений для OSType:

Стоимость
Окна
Mac OS
iOS
Android
Linux
...

Заметка

Не используйте OSType для изменения интерфейса или функциональности вашего приложения в зависимости от указанной операционной системы.

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

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

Свойство SessionID

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

Заметка

Во встроенных сценариях, таких как Power Apps в 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

Свойство Version предоставляет идентификатор и номер версии проигрывателя Power Apps. Подобно BrowserUserAgent, может быть возвращено более одного номера версии через пробелы.

Заметка

Свойство Version всегда представляет собой пустую строку при работе в Power Apps Studio.

Label1.Text: Host.Version

Свойство OfflineEnabled

Свойство OfflineEnabled обеспечивает режим выполнения приложения в проигрывателе Power Apps. Для приложений, которые не поддерживают автономный режим, свойство всегда имеет значение false. Для приложений, которые включены для работы в автономном режиме, это свойство имеет значение false в Интернете, но true в iOS, Android и Windows.

Заметка

Даже если приложение на основе холста не работает без подключения к сети, свойство OfflineEnabled остается true в Power Apps Studio для приложений на основе холста, для которых включено автономное использование.

Label1.Text: Host.OfflineEnabled

Примеры

  1. Создание приложения на основе холста.
  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)