ออบเจ็กต์โฮสต์ ใน Power Apps

ใช้กับ: แอปพื้นที่ทำงาน แอปแบบจำลอง

ออบเจ็กต์ โฮสต์ ใน Power Apps ให้ข้อมูลเกี่ยวกับโฮสต์ปัจจุบันที่ใช้งานแอป

คำอธิบาย

ออบเจ็กต์ โฮสต์ ให้ข้อมูลเกี่ยวกับอุปกรณ์โฮสต์ ระบบปฏิบัติการ และโปรแกรมเล่นที่กำลังเรียกใช้แอป โฮสต์ เหมือนกับ ออบเจ็กต์ แอป และทุกแอปสามารถเข้าถึงข้อมูลนี้ได้

หนึ่งในการใช้งานที่ดีที่สุดของ โฮสต์ คือการดีบักแอปที่ทำงานไม่ถูกต้องบนอุปกรณ์เฉพาะหรือกับเบราว์เซอร์เฉพาะ ใช้คุณสมบัติข้อความของออบเจ็กต์นี้เพื่อแสดงข้อมูลใน UI ของแอปด้วยตัวควบคุม ป้ายชื่อข้อความ หรือบันทึกข้อมูลลงในตารางฐานของข้อมูลหรือไปที่ 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 ในแอปเนทีฟหรือใช้คุณลักษณะ wrap ใน 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 จะส่งคืน ID เซสชัน Power Apps พื้นฐาน ไม่ใช่ ID เซสชัน Power BI

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

คุณสมบัติ TenantID

คุณสมบัติ TenantID มี Globally Unique Identifier (GUID) ที่ระบุผู้เช่า Microsoft Entra ที่เชื่อมโยงกับผู้ใช้ที่ได้รับการรับรองความถูกต้องในปัจจุบัน

หมายเหตุ

เช่นเดียวกับ SessionID ในสถานการณ์แบบฝังตัว เช่น Power Apps ใน Power BI ID ผู้เช่าคือผู้เช่าที่ใช้สำหรับการรับรองความถูกต้องเซสชัน Power Apps

Label1.Text: Host.TenantID

คุณสมบัติ Version

คุณสมบัติ Version ระบุการระบุตัวตนและหมายเลขเวอร์ชันของโปรแกรมเล่น Power Apps เช่นเดียวกับ BrowserUserAgent ระบบอาจส่งคืนหมายเลขเวอร์ชันมากกว่าหนึ่งรายการโดยคั่นด้วยช่องว่าง

หมายเหตุ

คุณสมบัติ Version จะเป็นสตริงว่างเสมอเมื่อทำงานใน Power Apps Studio

Label1.Text: Host.Version

คุณสมบัติ OfflineEnabled

คุณสมบัติ OfflineEnabled จัดเตรียมโหมดรันไทม์ของแอปในโปรแกรมเล่น Power Apps สำหรับแอปที่ไม่ได้เปิดใช้งานแบบออฟไลน์ คุณสมบัติจะเป็นเท็จเสมอ สำหรับแอปที่ เปิดใช้งานสำหรับออฟไลน์ คุณสมบัตินั้นเป็นเท็จบนเว็บ แต่เป็นจริงบน iOS, Android และ Windows

หมายเหตุ

แม้ว่าแอปพื้นที่ทำงานจะไม่ทำงานหากไม่มีการเชื่อมต่อเครือข่าย แต่คุณสมบัติ OfflineEnabled ยังคงเป็นจริงใน 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)