הערה
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות להיכנס או לשנות מדריכי כתובות.
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות לשנות מדריכי כתובות.
חל על:
יישומי בד ציור יישומים מונחי דגמים
האובייקט מארח ב- Power Apps מספק מידע על המארח הנוכחי שמפעיל את האפליקציה.
Description
האובייקט המארח מספק מידע על המכשיר המארח, מערכת ההפעלה והנגן שמפעיל אפליקציה. מארח דומה ל ה אפליקציה object ולכל אפליקציה יש גישה למידע זה.
אחד השימושים הטובים ביותר במארח הוא ניפוי באגים באפליקציה שאינה פועלת כהלכה במכשיר ספציפי או עם דפדפן ספציפי. השתמש במאפייני הטקסט של אובייקט זה כדי להציג מידע בממשק המשתמש של האפליקציה עם פקד תווית טקסט או רישום המידע לטבלת מסד נתונים או ל- 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
מאפיין גירסה
המאפיין גירסה מספק את הזיהוי ומספר הגירסה של נגן Power Apps. בדומה ל- BrowserUserAgent, ניתן להחזיר יותר ממספר גירסה אחד, כשהמספרים מופרדים ברווחים.
הערה
המאפיין גירסה הוא תמיד מחרוזת ריקה כאשר עובדים ב- 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
דוגמאות
- צור יישום בד ציור חדש.
- הוסף פקד תווית טקסט והגדר את המאפיין
Textשיהיה"Host.BrowserUserAgent: " & Host.BrowserUserAgent. - הוסף פקד תווית טקסט והגדר את המאפיין
Textשיהיה"Host.OSType: " & Host.OSType. - הוסף פקד תווית טקסט והגדר את המאפיין
Textשיהיה"Host.SessionID: " & Host.SessionID. - הוסף פקד תווית טקסט והגדר את המאפיין
Textשיהיה"Host.TenantID: " & Host.TenantID. - הוסף פקד תווית טקסט והגדר את המאפיין
Textשיהיה"Host.Version: " & Host.Version. - הוסף פקד תווית טקסט והגדר את המאפיין
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)