pac canvas

פועל עם קבצי .msapp של Power Apps.

‏‫[מאמר זה הוא תיעוד קדם-הפצה והוא עשוי להשתנות.]‬

Important

• הפקודות pack ו unpack - הוצאה משימוש.
• כדי ליצור מקור של שליטה באפליקציית בד הציור שלך, השתמש ב - Power Platform Git Integration.
• הפקודה create זמינה בדרך כלל.

Commands

Command	Description
pac canvas create	יצירת יישום בד ציור ממחבר מותאם אישית
pac canvas download	הורד אפליקציית בד ציור כקובץ .msapp
pac canvas list	פרט אפליקציות בד ציור
pac canvas pack	(תצוגה מקדימה) אריזת מקורות לקובץ msapp
pac canvas unpack	(תצוגה מקדימה) חילוץ קובץ msapp למקורות

pac canvas create

יצירת יישום בד ציור ממחבר מותאם אישית

פקודה זו תפיק .msapp יישום בד ציור בהתבסס על הגדרת OpenAPI של מחבר מותאם אישית קיים. האפליקציה תכלול מסכים, פריסת פקדים וקוד Power Fx שנוצרו בהתבסס על האופן שבו הפעולות של המחבר המותאם אישית מוגדרות, עם מראה ותחושה מוגדרים מראש. ניתן להשתמש באפליקציה כדי לממש ישירות את הפעולות שהוגדרו במחבר המותאם אישית.

יצרנים יכולים לייבא את ה- .msapp Power Apps Studio שנוצר כדי להפעיל את האפליקציה, או לבצע פעולות עריכה ולבצע התאמות אישיות נוספות. ייבא את היישום שנוצר ל- Power Apps Studio על-ידי ניווט אל 'עיון בפתיחה>של קבצים>' בתוך Studio.

Examples

הדוגמאות הבאות מציגות את השימוש בפקודה pac canvas create .

• יצירת יישום בד ציור המבוסס על הגדרת OPEN API לפי שם תצוגה
• יצירת יישום בד ציור המבוסס על הגדרת Open API לפי מזהה

יצירת יישום בד ציור המבוסס על הגדרת OPEN API לפי שם תצוגה

דוגמה זו יוצרת יישום בד ציור (כקובץ *.msapp) המבוסס על הגדרת Open API באמצעות שם התצוגה של המחבר.

pac canvas create --msapp HelloWorld.msapp --connector-display-name "My Custom Connector"

יצירת יישום בד ציור המבוסס על הגדרת Open API לפי מזהה

דוגמה זו יוצרת יישום בד ציור (כקובץ *.msapp) המבוסס על הגדרת Open API באמצעות המזהה של המחבר.

pac canvas create --msapp HelloWorld.msapp --connector-id 00000000-0000-0000-0000-000000000000

נדרשים connector-display-nameconnector-id או נדרשים.

פרמטרים נדרשים עבור canvas create

--msapp

נתיב לקובץ .msapp שיש ליצור

פרמטרים אופציונליים עבור canvas create

--connector-display-name

שם התצוגה של המחבר ממנו יש ליצור את Power App.

--connector-id

המזהה של המחבר ממנו יש ליצור את Power App.

--environment

מזהה סביבת היעד או כתובת ה- URL. ערך ברירת המחדל הוא הסביבה של פרופיל Dataverse Auth הפעיל הנוכחי שלך.

Remarks

שיקולים ומגבלות:

• המחבר המותאם אישית שאליו מתבצעת הפניה באמצעות connector-display-name הפרמטרים connector-id או חייב להיות חלק מפתרון.
• לאחר ייבוא היישום ל- Studio, לא יהיה שיוך למחבר המותאם אישית. על היוצר להוסיף באופן ידני הפניה למחבר המותאם אישית ממנו נוצר היישום כדי שתהיה אפשרות להפעיל את היישום. ראה הוספת חיבורי נתונים ליאפליקציות בד ציור לקבלת שלבים. עד כשתסיים זאת, ייתכן שתראה ביישום שגיאות נוסחה שייפתרו לאחר הוספת ההפניה למחבר. שם המחבר המותאם אישית שאתה מוסיף ליישום חייב להתאים לשם התצוגה של המחבר המותאם אישית שאליו מתבצעת הפניה בפקודה canvas create .
• היישום יכיל מסך אחד עבור כל POST ופעולה GET שהחבר מגדיר.
  • פעלים אחרים הזמינים במחברים מותאמים אישית אינם נתמכים.
• הפקדים שעובדו על המסך של כל פעולה נוצרים באופן דינאמי בהתבסס על האופן שבו מוגדרים סוגי הקלט והפלט של כל פעולה. סוגים מסוימים של קלט ופלט המוגדרים במחבר המותאם אישית אינם נתמכים על-ידי canvas create. הפקודה תפיק אזהרות במסוף כאשר הן יתקלו בהן. Specific cases:
  • מערכים של אובייקטים ומערכים של מערכים אינם נתמכים כקלט
  • פקדים אינם נוצרים עבור אובייקטים או מערכים מקוננים מעבר לעומק של 20
  • סוגי "קובץ" ו"תבנית בינארית" אינם נתמכים עבור קלט או פלט.

pac canvas download

הורד אפליקציית בד ציור כקובץ .msapp

פרמטרים נדרשים עבור canvas download

--name -n

בדיוק, שם חלקי או מזהה יישום באפליקציה של Canvas

פרמטרים אופציונליים עבור canvas download

--environment -env

מציין את target Dataverse. הערך עשוי להיות GUID או כתובת URL מוחלטת של https. כאשר לא צוין, המערכת תשמש את הארגון הפעיל שנבחר עבור פרופיל האימות הנוכחי.

--extract-to-directory -d

שם מדריך כתובות לחילוץ אפליקציית בד ציור אל

--file-name -f

שם קובץ (בדרך כלל עם סיומת .msapp). אם הקובץ לא שסופק נשמר בספריה הנוכחית עם 'appname'.msapp

--overwrite -o

אפשר החלפת קובץ

לפרמטר זה אין כל ערך. זה מתג.

pac canvas list

פרט אפליקציות בד ציור

פרמטרים אופציונליים עבור canvas list

--environment -env

מציין את target Dataverse. הערך עשוי להיות GUID או כתובת URL מוחלטת של https. כאשר לא צוין, המערכת תשמש את הארגון הפעיל שנבחר עבור פרופיל האימות הנוכחי.

pac canvas pack

(תצוגה מקדימה) אריזת מקורות לקובץ msapp

Example

pac canvas pack --sources MyHelloWorldFiles --msapp HelloWorld.msapp

פרמטרים נדרשים עבור canvas pack

--sources

מדריך כתובות למקורות שיש לארוז

פרמטרים אופציונליים עבור canvas pack

--disable-load-from-yaml

כאשר צוין, זה מבטל את טעינת האפליקציה הארוזה מקבצי *.pa.yaml בתיקיית 'Src'. נתמך רק בפריסת 'קוד מקור'.

לפרמטר זה אין כל ערך. זה מתג.

--layout

הפריסה לשימוש בתיקיית המקורות. הערה: הפריסה 'ניסיונית' כבר לא קיימת ויוסר במהדורה עתידית. השתמש בפריסת 'SourceCode' לפריסה הנתמכת העדכנית ביותר.

השתמש באחד מהערכים הבאים:

• Experimental
• SourceCode

--msapp

נתיב לקובץ .msapp

--overwrite

אפשר החלפת קובץ

לפרמטר זה אין כל ערך. זה מתג.

Remarks

יצירת קובץ .msapp מקבצי המקור שהופקו קודם לכן. ניתן לפתוח את התוצאה ב- Power Apps Studio על-ידי ניווט אל עיון בפתיחת>>קבצים.

לאחר פריקה, ניתן לערוך ולנהל את קבצי המקור באמצעות כלים חיצוניים כגון Visual Studio Code ו- GitHub.

pac canvas unpack

(תצוגה מקדימה) חילוץ קובץ msapp למקורות

Example

pac canvas unpack --msapp HelloWorld.msapp --sources MyHelloWorldFiles

pac canvas unpack --msapp HelloWorld.msapp

פירוק אריזה למדריך הכתובות המוגדר HelloWorld_src כברירת מחדל.

פרמטרים נדרשים עבור canvas unpack

--msapp

נתיב לקובץ .msapp

פרמטרים אופציונליים עבור canvas unpack

--layout

הפריסה לשימוש בתיקיית המקורות. הערה: הפריסה 'ניסיונית' כבר לא קיימת ויוסר במהדורה עתידית. השתמש בפריסת 'SourceCode' לפריסה הנתמכת העדכנית ביותר.

השתמש באחד מהערכים הבאים:

• Experimental
• SourceCode

--overwrite

אפשר החלפת קובץ

לפרמטר זה אין כל ערך. זה מתג.

--sources

מדריך כתובות למקורות שיש לפרק

Remarks

פירוק אריזת .msapp קובץ המקור.

הורד את .msapp הקובץ מ- Power Apps Studio על-ידי ניווט אל שמירת>קבצים כמחשב>זה.

אם פרמטר המקורות לא צוין, נעשה .msapp_src שימוש בספריה עם שם ומיקום זהים לקובץ עם סיומת.

Folder structure

מאפיינים של פירוק אריזה ואריזה משתמשים במבנה התיקיות הבא:

• \src - קבצי בקרה ורכיבים. היא מכילה את המקורות.
  • *.fx.yaml - הנוסחאות שחולצו מהקובץ control.json .

    Note

    זהו המקום שבו תוכל לערוך את הנוסחאות שלך.

  • CanvasManifest.json - קובץ מניפסט המכיל את המידע הקיימים בדרך כלל בכותרת העליונה, במאפיינים וב- publishInfo.
  • *.json - הקובץ control.json הגולמי.
  • \EditorState*.editorstate.json - מידע המאוחסן במטמון כדי ש- Power Apps Studio ישתמש בו.
• \DataSources - כל מקורות הנתונים שבהם משתמש היישום.
• \Connections - מופעי חיבור שנשמרו עם היישום ומשמשים בעת טעינה מחדש ל- Power Apps Studio.
• \Assets - קבצי מדיה מוטבעים ביישום.
• \pkgs - עותק שהורד של הפניות חיצוניות, כגון תבניות, קבצי הגדרות API וספריות רכיבים. אלה דומים להפניות NuGet/NPM.
• \other - כל הקבצים השונים הדרושים כדי ליצור מחדש את .msapp.
  • entropy.json - רכיבים נדיפים (כגון חותמות זמן) מחולצים לקובץ זה. פעולה זו מסייעת בהפחתת הבדלים רועשים בקבצים אחרים ומבטיחה שנוכל עדיין לעבור הלוך ושוב.
  • מחזיק קבצים אחרים מ- msapp, כגון מה \rמסיק.

File format

הקבצים .fx.yaml משתמשים ב קבוצת משנה של YAML. בדומה ל- Excel, כל הביטויים אמורים להתחיל בסימן שוויון =. מידע נוסף: דקדוק נוסחת YAML של Power Fx

מיזוג שינויים באמצעות Power Apps Studio

בעת מיזוג שינויים המתבצעים בשתי הפעלות שונות של Power Apps Studio:

• ודא שכל שמות הפקדים ייחודיים. לדוגמה, הוספת לחצן בשתי הפעלות שונות עשויה לגרום לשני Button1 פקדים. מומלץ לבחור שם לפקדים מיד לאחר יצירתם. הכלי אינו מקבל שני פקדים בעלי שם זהה.
• עבור קבצים אלה, מזג אותם כרגיל:
  • \src*.fx.yaml
• אם קיימות התנגשויות או שגיאות, באפשרותך למחוק קבצים אלה:
  • \src\editorstate*.json - קבצים אלה מכילים מידע אופציונלי ב- Power Apps Studio.
  • \other\entropy.json
• עבור התנגשויות בקבצים אלה, ניתן לקבל את הגירסה העדכנית ביותר:
  • \checksum.json
• אם קיימות התנגשויות מיזוג תחת נתיבים אלה, לא בטוח למזג. ספר לנו אם זה קורה לעתים קרובות; אנו פועלים לשחזור תבנית הקובץ כדי למנוע התנגשויות.
  • \Connections*
  • \DataSources*
  • \pkgs*
  • CanvasManifest.json

Open source

פקודות בד הציור ב- Microsoft Power Platform CLI הן קוד פתוח. שוחח על שיפורים, קדם בעיות וגש לקוד מתוך מאגר כלי השפה של Power Apps.

See also

Microsoft Power Platform פקודות CLI
Microsoft Power Platform מבט כולל על CLI