הפונקציות Launch ו- Param

2024-03-22

חל על: אפליקציות קנבס

מפעילה דף אינטרנט או יישום בד ציור ומספקת גישה להפעלת פרמטרים.

הפעל

מפעילה דף אינטרנט או יישום בד ציור. הפונקציה תומכת ב:

כתובת (חובה), כתובת האתר של דף האינטרנט של אפליקציית הקנבס.
פרמטרים (אופציונלי), ערכים בעלי שם להעברה לדף האינטרנט או לאפליקציית הקנבס. ביישום בד ציור, ניתן לקרוא פרמטרים עם הפונקציה Param.
יעד (אופציונלי), לשונית הדפדפן שבה ניתן להפעיל את דף האינטרנט או אפליקציית הקנבס.

ניתן להשתמש בהשקה רק ב נוסחאות התנהגות.

הערה

אם משתמשים בנוסחת ההפעלה לפתיחת Power Apps והאפליקציה אינה גלויה למשתמש הקצה, מומלץ לבדוק אם האפליקציה חסומה על ידי חוסם חלונות דפדפן או שהדפדפן ממתין תגובת המשתמש לתיבת דו-שיח ששואלת אם הוא רוצה לנווט למסך חדש.

כתובת

דפי אינטרנט מופעלים באמצעות כתובת URL. לדוגמה:

Launch( "https://bing.com" )

ניתן להפעיל יישומי בד ציור בעזרת קישור אינטרנט או URI של אפליקציה (מזהה יישום עם הקידומת /providers/Microsoft.PowerApps/apps/). כדי למצוא ערכים אלה עבור יישום:

עבור אל Power Apps.
בחר יישומים מחלונית הניווט השמאלית.
בחר את היישום שלך.
בחר פרטים מהתפריט העליון.
באפשרותך גם לבחור ... (פקודות נוספות) ולאחר מכן לבחור פרטים מתוך התפריט הנפתח.
העתקת קישור האינטרנט.

ניתן להשתמש באפשרות קישור אינטרנט בכל דף אינטרנט והיא תפעיל את יישום בד הציור. ניתן גם להשתמש בה עם הפונקציה Launch. לדוגמה:

Launch( "https://apps.powerapps.com/e/{environment id}/a/{app id}?tenantId={tenantId}" )

לא ניתן להפעיל באופן ישיר במכשיר יישומים מקוריים. עשויות להיות אפשרויות עקיפות הזמינות בפלטפורמות מסוימות, כגון יישום מקורי המתקין סכימת כתובת URL מותאמת אישית או מבצע רישום עם דפדפן האינטרנט כדי להציע אפשרות עבור אתרי אינטרנט ספציפיים.

פרמטרים

הפעלה יכול להעביר פרמטרים לדף האינטרנט או לאפליקציית הקנבס. ניתן לספק פרמטרים בשתי דרכים:

רשימת ארגומנטים של זוגות של שמות וערכים. לדוגמה:
```
Launch( "https://bing.com/search", "q", "Power Apps", "count", 1 )
```
רשומה של ערכי שדה. לדוגמה:
```
Launch( "https://bing.com/search", { q: "Power Apps", count: 1 } )
```
טופס זה עשוי להיות קל יותר לעבודה משום שהוא הופך את השיוך בין השם לערך לברור יותר. זה הטופס היחיד התומך בארגומנט LaunchTarget האופציונלי.

הכתובת והפרמטרים הם בעלי קידוד של כתובת URL לפני שהם מועברים כדי להחליף תווים מסוימים שאינם אלפנומריים ב- % ומספר הקסדצימאלי באופן שבו הפונקציה EncodeUrl שימשה בכל אחד מהם.

בעת הפעלת דף אינטרנט, ניתן לכלול מחרוזת שאילתה של פרמטרים בסוף כתובת ה- URL. כל פרמטר נוסף שסופק ל- Launch יתווסף בסוף מחרוזת השאילתה. מחרוזות שאילתה אינן פועלות בעת הפעלת יישום בד ציור.

בעת הפעלת אפליקציה במכשיר נייד שבו אותה אפליקציה כבר פועלת, הפרמטרים לא יעברו רענון באפליקציה הפועלת. נדרשת טעינה מחדש של האפליקציה כדי לרענן פרמטרים.

יעד

השתמש בארגומנט LaunchTarget כדי לציין את חלון הדפדפן המהווה יעד שבו יש לפתוח את דף האינטרנט או את היישום. השתמש באחד מערכי הספירה של LaunchTarget הבאים או ספק שם חלון מותאם אישית.

LaunchTarget enum	תיאור
חָדָשׁ	דף האינטרנט או היישום נפתחים בחלון או בכרטיסיה חדשים.
לְהַחלִיף	דף האינטרנט או היישום מחליפים את החלון או את הכרטיסיה הנוכחיים.
שֵׁם	במקום ערך ספירה, השתמש במחרוזת טקסט משלך כדי לתת שם לחלון או לכרטיסיה. Self הוא שם פנימי בלבד המשמש את הפונקציה Launch. אין לו השפעה והוא לא יתאים לכותרת החלון שהמשתמשים שלך יראו. אם חלון או כרטיסיה עם השם הנתון כבר קיימים, התוכן שלהם יוחלף. אחרת, ייווצרו חלון או כרטיסיה חדשים. שם לא יכול להתחיל עם הקו התחתון "_".

חדש הוא המספר המוגדר כברירת מחדל כאשר פועל בדפדפן אינטרנט עם החלף ו שם כאפשרויות זמינות. בנגן נייד, חדש הוא ברירת המחדל עבור דפי אינטרנט עם שם כפעולה זמינה1 בעוד שיישום בד הציור הנוכחי יוחלף תמיד על-ידי יישום בד ציור אחר.

הערה

שימוש ב- LaunchTarget עם ערך אחר שאינו חדש בתרחישים מוטבעים (לדוגמה, Power BI או SharePoint) אינו נתמך ועשוי לגרום לאופן פעולה בלתי צפוי. בעתיד אופן פעולה זה עשוי להשתנות, או עשוי לגרום לשגיאה.

Param

הפונקציה Param מאחזרת פרמטר שעבר ליישום כאשר הוא הופעל. אם הפרמטר בעל השם לא עבר, הפונקציה Param מחזירה ריק.

בעת הפעלת יישום בד ציור מיישום בד ציור אחר, השתמש בארגומנטים של Parameter לפונקציה Launch. שמות וערכים של פרמטר יקודדו אוטומטית באמצעות כתובת URL.
בעת הפעלת יישום בד ציור מדף אינטרנט, הוסף פרמטרים אל מחרוזת השאילתה של קישור האינטרנט של יישום בד הציור. הדבר כרוך בהוספת &parametername=parametervalue המניח שמחרוזת השאילתה כבר הופעלה עבור tenantId. לדוגמה, הוספת &First%20Name=Vicki&category=3 תעביר שני פרמטרים: First Name עם ערך של "Vicki" ו- category עם ערך של "3" (סוג הערך הוא טקסט). השם והערך של הפרמטר מוכרחים להיות מקודדים באמצעות כתובת URL אם הם מכילים רווחים או תווים מיוחדים, בדומה לשימוש בפונקציה EncodeURL.
שמות פרמטרים הם תלויי רישיות.
שמות וערכים של פרמטרים יפוענחו אוטומטית באמצעות כתובת URL לשימוש ביישום שלך.
ערכי הפרמטרים אינם משתנים אלא אם האפליקציה נטענת מחדש. שימוש בפקודה הפעל במכשיר נייד שבו האפליקציה כבר פועלת אינו מרענן את הפרמטרים.
גם אם הפרמטר מכיל מספר, הסוג שהוחזר על-ידי Param יהיה תמיד מחרוזת טקסט. המרה לסוגים אחרים תתרחש אוטומטית או תשתמש בהמרות מפורשות כגון הפונקציה Value כדי להמיר באופן מפורש למספר.

הערה

עבור דפים מותאמים אישית, הפרמטרים היחידים שיכולים להיות בדף הם: recordId ו-entityName.

תחביר

הפעל( כתובת [, ParameterName1, ParameterValue1 , ... ] )

כתובת - חובה. הכתובת של דף אינטרנט או המזהה של יישום להפעלה.
ParameterNames – אופציונלי. שם פרמטר.
ParameterValues – אופציונלי. ערכי פרמטר מתאימים להעברה לאפליקציה או לדף האינטרנט.

הפעל( כתובת, { [ ParameterName1: ParameterValue1, ... ] } [, LaunchTarget ] )

כתובת - חובה. הכתובת של דף אינטרנט או המזהה של יישום להפעלה.
ParameterNames – אופציונלי. שם פרמטר.
ParameterValues – אופציונלי. ערכי פרמטר מתאימים להעברה לאפליקציה או לדף האינטרנט.
LaunchTarget – אופציונלי. ערך ספירה של LaunchTarget או שם מותאם אישית.

Param( ParameterName )

ParameterName - חובה. שם הפרמטר שעבר ליישום.

פרמטרים שמורים

מילות המפתח הבאות שמורות (ללא קשר למקרה) לשימוש פנימי, ואין להשתמש בהן כפרמטר מותאם אישית בפונקציה Param():

amp%3Bauthmode
amp%3Benableonbehalfof
amp%3Bhidenavbar
amp%3Blocale
appmetadataversion
authmode
channeltype
cordovapath
correlationid
איתור באגים
delegatelaunchurl
delegatelaunchurl
disablepreviewredirect
embedderorigin
enableonbehalfof
groupid
hideappsplash
hidenavbar
רמז
hostclienttype
hostmode
iframecontainerid
isfullscreen
ispreviewmode
מטעין
loaderType
אזור
מיקום
packagekind
packageproperties
playerresourcespath
playersessionid
powerappslanguage
screencolor
sdkversion
אתר
skipappmetadata
skipiframecreation
skiplaunchappcache
מקור
sourcetime
standaloneconsent
teamid
teamtype
tenantId
ערכת נושא
uselocalpackagehostresources
userteamrole

דוגמאות

הפעלה פשוטה

מיישום בד ציור לדף אינטרנט:

נוסחה	Description
Launch( "http://bing.com/search", "q", "Power Apps", "ספירה", 1 )	פותח את דף האינטרנט https://bing.com/search?q=Power%20Apps&count=1. חלון או כרטיסיה חדשים נפתחים.
Launch( "http://bing.com/search", { q: "Power Apps", ספירה: 1 } )	זהה לדוגמאות הקודמות המשתמשות בסימון הרשומה המקביל. חלון או כרטיסיה חדשים נפתחים.
Launch( "http://bing.com/search", { q: "Power Apps", ספירה: 1 }, LaunchTarget.Replace )	זהה לדוגמאות הקודמות, החלפת החלון או הכרטיסיה הנוכחיים בתוצאה אם פועל בדפדפן אינטרנט.
Launch( "http://bing.com/search", { q: "Power Apps", ספירה: 1 }, "תוצאות חיפוש" )	זהה לדוגמה הקודמת, יצירה או החלפה של תוכן החלון או הכרטיסיה בשם תוצאות חיפוש.

מיישום בד ציור ליישום בד ציור

עדכן את מזהה היישום, שם המסך ומספר הרשומה בהתאם לצורך.

Launch( "/providers/Microsoft.PowerApps/apps/YOUR-APP-ID",
        { Navigate: "Second Screen", Record: 34 }
)

מדף אינטרנט ליישום בד ציור

עדכן את מזהה היישום, מזהה הדייר, שם המסך ומספר הרשומה בהתאם לצורך.

<html>
  <body>
    <a
      href="https://apps.powerapps.com/play/e/YOUR-APP-ENVIRONMENT-ID/a/YOUR-APP-ID?tenantId=YOUR-TENANT-ID&Navigate=Second%20Screen&Record=34"
    >
      Launch canvas app
    </a>
  </body>
</html>

פרמטר פשוט

דוגמאות הפעלה פשוטה לעיל להפעלת יישום בד ציור מדף אינטרנט או מיישום בד ציור אחר מציגות דוגמאות פשוטות עבור הפונקציה Param:

נוסחה	תיאור	תוצאה
Param( "נווט")	הפרמטר Navigate סופק כאשר היישום הופעל והוחזר.	"מסך שני"
Param( "Record")	הפרמטר Record סופק כאשר היישום הופעל והוחזר. למרות שהוא הועבר כמספר לפונקציה Launch, התוצאה מ- Param תהיה מחרוזת טקסט שניתן להמיר באופן מפורש או מרומז לסוגים אחרים.	"34"
Param( "משתמש")	הפרמטר User לא סופק. ערך ריק מוחזר שניתן לבדוק בעזרת הפונקציה IsBlank.	רֵיק

דוגמאות שלב אחר שלב עבור Launch ו- Param

פריסת ה- Tablet הצגת מוצר שימשה עבור הדוגמאות הבאות. ליצירת יישום בעזרת תבנית זו, פעל בהתאם לשלבים מהמאמר יצירת יישום ובחר את התבנית הצגת מוצר. באפשרותך גם להשתמש ביישום משלך.

דוגמה - Launch

עבור אל Power Apps.
בחר יישומים מחלונית הניווט השמאלית.
בחר את היישום שלך, ולאחר מכן בחר ערוך.
בחר הוסף מהתפריט ולאחר מכן בחר תווית.
העבר את התווית לחלק הימני התחתון של המסך.
מתוך חלונית המאפיינים בצד ימין, בחר צבע כלבן והגדר את עובי גבול כ- 1.
בחר את המאפיין Text‎ מצד ימין והזן טקסט כמו מחשבי Tablet מסוג Surface בחדשות.
מרשימת המאפיינים בחלק השמאלי העליון, בחר OnSelect.
הזן נוסחה כ- Launch("https://www.bing.com/news/search","q","Microsoft Surface tablets"). באפשרותך גם להתמש בכתובת URL, פרמטר ומילות מפתח אחרים לבחירתך.
שמור ופרסם את היישום.
הפעל את היישום.
בחר את התווית מחשבי Tablet מסוג Surface בחדשות כדי להפעיל חיפוש בחדשות בעזרת מילות המפתח Microsoft Surface tablets.

טיפ

עבור מדרגיות, באפשרותך להחליף את מילות המפתח שהוזנו ידנית בפונקציה Launch במשתנים.

דוגמה - Param

עבור אל Power Apps.
בחר יישומים מחלונית הניווט השמאלית.
בחר את היישום שלך, ולאחר מכן בחר ערוך.
בחר הוסף מהתפריט ולאחר מכן בחר תווית.
העבר את התווית לחלק הימני התחתון של המסך.
בחר את המאפיין Text‎ עבור התווית מהחלק השמאלי העליון.
הזן נוסחה כ- Param("browser"). באפשרותך גם להשתמש בפרמטר אחר לבחירתך.
שמור ופרסם את היישום.
העתק את קישור האינטרנט עבור היישום שלך מ- Power Apps.
פתח דפדפן חדש.
הדבק את קישור האינטרנט של היישום בדפדפן וצרף את &browser=Microsoft%20Edge בסוף.
כאשר היישום שלך מופעל, התווית מציגה את ערך הפרמטר שעבר.
סגור את שכבת היישום וערוך את היישום.
בחר יישום מתצוגת העץ בניווט השמאלי.
בחר במאפיין StartScreen למעלה מימין.
הזן את הנוסחה כ- If( Param("screen") = "techspecs", TechSpecs ).

אם הפונקציה ב StartScreen הנכס בודקת אם הפרמטר שווה לערך מסוים, במקרה זה הערך techspecs. ואם הוא תואם, הוא מחזיר את בקרת המסך TechSpecs למאפיין StartScreen.

הערה

החלף את שם בקרת המסך TechSpecs בפונקציה If בשם של בקרת מסך באפליקציה שלך אם אינך משתמש בתבנית האפליקציה הצגת מוצר.
שמור ופרסם את היישום.
פתח דפדפן חדש.
הדבק את קישור האינטרנט של היישום בדפדפן וצרף את &screen=techspecs בסוף.
האפליקציה מופעלת ישירות עם TechSpecs כמסך התחל.