Хост обект в Power Apps

Отнася се за: Приложения за платно Приложения, управлявани от модел

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

Описание

Обектът Host предоставя информация за хост устройството, операционната система и плейъра, който изпълнява приложение. Хостът е подобен на обекта на приложението и всяко приложение има достъп до тази информация.

Едно от най-добрите приложения на хоста е за отстраняване на грешки в приложение, което не работи правилно на конкретно устройство или с конкретен браузър. Използвайте текстовите свойства на този обект, за да покажете информация в потребителския интерфейс на приложението с контрола Текстов етикет или да регистрирате информацията в таблица на база данни или към Application Insights.

Изкушаващо е да използвате хост , за да приспособите приложение към конкретно устройство или браузър. Това е опасно, тъй като 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

Свойство на версията

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

Label1.Text: Host.Version

OfflineEnabled свойство

Свойството OfflineEnabled предоставя режима на изпълнение на приложението в плейъра Power Apps . За приложения, които не са разрешени за офлайн, свойството винаги е false. За приложения, които са разрешени за офлайн , свойството е 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)