Power Apps의 호스트 개체

적용 대상: Canvas 앱 모델 기반 앱

Power Apps의 호스트 개체는 앱을 실행 중인 현재 호스트에 대한 정보를 제공합니다.

Description

호스트 개체는 앱을 실행하는 호스트 장치, 운영 체제 및 플레이어에 대한 정보를 제공합니다. 호스트 는 앱 객체 와 유사하며 모든 앱은 이 정보에 액세스할 수 있습니다.

호스트의 가장 좋은 용도 중 하나는 특정 장치나 특정 브라우저에서 제대로 작동하지 않는 앱을 ​​디버깅하는 것입니다. 이 개체의 텍스트 속성을 사용하여 텍스트 라벨 컨트롤을 사용하여 앱 UI에 정보를 표시하거나 정보를 데이터베이스 테이블 또는 Application Insights에 기록합니다.

호스트를 사용하여 앱을 특정 장치나 브라우저에 맞게 조정하고 싶은 경우가 있습니다. Power Apps는 광범위한 하드웨어 및 소프트웨어 플랫폼에서 실행되도록 설계되었으며 호스트 기반 논리가 이를 모두 설명하지 못하고 시간이 지남에 따라 변경되므로 이는 위험합니다. 더 나은 접근 방식은 보다 추상화되고 특정 하드웨어 및 소프트웨어에 얽매이지 않는 정보를 사용하는 것입니다. 예를 들어, 화면 컨트롤의 Size 속성을 사용하여 화면을 더 적게 표시하도록 조정하거나 휴대폰과 같은 소형 장치에서 실행할 때 정보를 재구성할 수 있습니다.

Power Apps Studio에서 호스트 개체에 액세스하려면 트리 보기 창 상단에서 앱 개체를 확장한 다음 호스트를 선택합니다. 이 예에서 호스트 개체에는 수식을 허용하는 속성이 없습니다.

BrowserUserAgent 속성

Text 속성 BrowserUserAgent에는 브라우저가 앱을 실행할 때 자신을 식별하는 데 사용하는 완전한 사용자 에이전트 문자열이 포함되어 있습니다.

예를 들어 브라우저 사용자 에이전트 문자열은 다음과 같을 수 있습니다.

• Mozilla/5.0 (Windows NT 10.0; Win64; x64)
• AppleWebKit/537.36(Gecko와 같은 KHTML)
• Chrome/109.0.0.0 Safari/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 속성은 현재 인증된 사용자와 연결된 Microsoft Entra 테넌트를 지정하는 GUID(Globally Unique Identifier)를 제공합니다.

Label1.Text: Host.TenantID

Version 속성

Version 속성은 Power Apps 플레이어의 식별 및 버전 번호를 제공합니다. BrowserUserAgent와 유사하게 둘 이상의 버전 번호가 공백으로 구분되어 반환될 수 있습니다.

Label1.Text: Host.Version

OfflineEnabled 속성

OfflineEnabled 속성은 Power Apps 플레이어에서 앱의 런타임 모드를 제공합니다. 오프라인이 활성화되지 않은 앱의 경우 속성은 항상 false입니다. 오프라인이 활성화된 앱의 경우 속성은 웹에서는 false이지만 iOS, Android 및 Windows에서는 true입니다.

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로 설정합니다.

다양한 장치와 다양한 브라우저에서 앱을 실행하면 아래와 비슷한 결과가 표시됩니다.

Edge 브라우저를 사용하는 Windows의 Power Apps Studio

에서 작업할 때 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: 

iOS의 Power Apps 기본 모바일 플레이어

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)

Firefox 브라우저를 사용하는 Windows의 Power Apps 웹 플레이어

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)

Safari 브라우저를 사용하는 iOS의 Power Apps 웹 플레이어

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)