Launchופונקציות Param

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

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

Launch

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

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

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

הערה

Launch אם הנוסחה משמשת לפתיחת Power Apps והיישום אינו גלוי למשתמש הקצה, מומלץ לבדוק אם האפליקציה נחסמה על-ידי חוסם פריטים מוקפצים של דפדפן או אם הדפדפן ממתין לתגובה של המשתמש לתיבת דו-שיח ה שואלת אם הוא מעוניין לנווט למסך חדש.
רק https: מזהי URI נתמכים בעת שימוש ב- Launch Power Apps Visual ב- PowerBI.

כתובת

דפי אינטרנט מופעלים באמצעות כתובת 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 יכול להעביר פרמטרים לדף האינטרנט או לאפליקציה של בד הציור. ניתן לספק פרמטרים בשתי דרכים:

רשימת ארגומנטים של זוגות של שמות וערכים. לדוגמה:
```
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	תיאור
חָדָשׁ	דף האינטרנט או היישום נפתחים בחלון או בכרטיסיה חדשים.
לְהַחלִיף	דף האינטרנט או היישום מחליפים את החלון או את הכרטיסיה הנוכחיים.
שֵׁם	במקום ערך enum, השתמש במחרוזת טקסט משלך כדי לבחור שם עבור החלון או הכרטיסיה. Self הוא שם פנימי בלבד המשמש את הפונקציה Launch בלבד. אין לו השפעה והוא לא יתאים לכותרת החלון שהמשתמשים שלך יראו. אם חלון או כרטיסיה עם השם הנתון כבר קיימים, התוכן שלהם יוחלף. אחרת, ייווצרו חלון או כרטיסיה חדשים. שם לא יכול להתחיל עם הקו התחתון "_".

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

הערה

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

Param

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

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

הערה

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

תחביר

Launch( Address [, ParameterName1, ParameterValue1, ... ] )

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

Launch( Address, { [ 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

דוגמאות

פשוט Launch

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

נוסחה	תיאור
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 :

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

דוגמאות שלב אחר שלב עבור LaunchParam

פריסת ה- 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 כמסך התחל.