مشاركة عبر

كائن المضيف بتنسيق Power Apps

  • مقالة

تنطبق على: تطبيقات اللوحة التطبيقات المستندة إلى النموذج

ال المضيف كائن في Power Apps يوفر معلومات حول المضيف الحالي الذي يقوم بتشغيل التطبيق.

الوصف

يوفر كائن المضيف معلومات حول جهاز المضيف، ونظام التشغيل، والعارض الذي يستخدم تطبيقا. المضيف مشابه لكائن ال التطبيق وكل تطبيق لديه حق الوصول إلى هذه المعلومات.

من أفضل استخدامات Host هو تصحيح تطبيق لا يعمل بشكل صحيح على جهاز معين أو مع مستعرض محدد. استخدم خصائص النص لهذا الكائن لعرض المعلومات في واجهة مستخدم التطبيق باستخدام تسمية النص التحكم في المعلومات أو تسجيلها في جدول قاعدة البيانات أو Application Insights.

من المغر استخدام Host لتكييف تطبيق مع جهاز أو مستعرض محدد. وهذا أمر خطير للغاية Power Apps كما هو مصمم لتشغيله على مجموعة كبيرة من الأجهزة و الأنظمة الأساسية للبرنامج وقد لا يقوم منطق المضيف المستند إلى حسابها جميعا وسيتغير بمرور الوقت. الطريقة الأفضل هي استخدام المعلومات التي تكون أكثر تلخيصا ولا ترتبط بأجهزة وبرامج معينة. على سبيل المثال، استخدم الحجم خاصية الشاشة التحكم لتخصيص شاشة لإظهار معلومات أقل أو إعادة تنظيمها عند التشغيل على جهاز أصغر مثل الهاتف.

للوصول إلى كائن المضيف في Power Apps Studio، قم بتوسيع كائن التطبيق من أعلى جزء طريقة عرض الشجرة ثم قم بتحديد المضيف. في هذا المثال، لا يوجد في كائن المضيف أية خصائص تقبل الصيغ.

كائن المضيف في جزء طريقة العرض الشجري.

‏‫ملاحظة‬

لا يتوفر كائن المضيف حاليا إلا في الصفحات المخصصة وتطبيقات اللوحة.

خاصية BrowserUserAgent

الخاصية النصية BrowserUserAgent تحتوي على سلسلة وكيل المستخدم الكاملة التي يستخدمها المستعرض لتعريف نفسه عند تشغيل التطبيق

على سبيل المثال، قد تكون سلسلة وكيل مستخدم المستعرض هي:

  • Mozilla/5.0 (Windows NT 10.0؛ Win64; x64)
  • AppleWebKit/537.36 (منذ ذلك الوقت، مثل Gهادو)
  • 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 المعرف الفريد العام (GUID) Microsoft Entra الذي يحدد (AAD) المستأجر المقترن بالمستخدم الذي تم مصادقة بياناته حاليا.

‏‫ملاحظة‬

بشكل مشابه ل SessionID، في السيناريوهات Power Apps Power BI المضمنة، كما في في، يكون مستأجر الم ID هو المستأجر المستخدم لمصادقة Power Apps جلسة العمل.

Label1.Text: Host.TenantID

خاصية الإصدار

توفر خاصية الإصدار تعريف المشغل وعدد إصداراته Power Apps . بشكل مشابه للمستعرض BrowserUserAgent، يمكن إرجاع أكثر من رقم إصدار واحد، مفصولة بواسطة المسافات.

‏‫ملاحظة‬

تكون خاصية الإصدار دائما سلسلة فارغة عند العمل. Power Apps Studio

Label1.Text: Host.Version

خاصية OfflineEnabled

توفر الخاصية OfflineEnabled وضع وقت التشغيل للتطبيق في مشغل Power Apps. بالنسبة للتطبيقات غير الممكنة للاستخدام دون اتصال، فإن الخاصية تكون دائمًا خاطئة. بالنسبة للتطبيقات التي تم تمكينها للاستخدام دون اتصال، فإن الخاصية خاطئة على الويب، ولكنها صحيحة في iOS وفي Android وفي Windows.

‏‫ملاحظة

حتى لو لم يعمل تطبيق اللوحة من دون اتصال الشبكة، فإن الخاصية OfflineEnabled تظل صحيحة في Power Apps Studio لتطبيقات اللوحة التي تم تمكينها للاستخدام دون اتصال.

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

المضيف.الإصدار يكون فارغا دائما عند العمل. 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 مشغل الويب على Windows مع المستعرض سفاري iOS 

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)