שתף דרך

pac canvas

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

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

חשוב

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

פקודות

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

pac canvas create

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

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

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

דוגמאות

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

יצירת יישום בד ציור המבוסס על הגדרת 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 הפעיל הנוכחי שלך.

הערות

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

  • המחבר המותאם אישית שאליו מתבצעת הפניה באמצעות connector-display-name הפרמטרים connector-id או חייב להיות חלק מפתרון.
  • לאחר ייבוא היישום ל- Studio, לא יהיה שיוך למחבר המותאם אישית. על היוצר להוסיף באופן ידני הפניה למחבר המותאם אישית ממנו נוצר היישום כדי שתהיה אפשרות להפעיל את היישום. ראה הוספת חיבורי נתונים ליאפליקציות בד ציור לקבלת שלבים. עד כשתסיים זאת, ייתכן שתראה ביישום שגיאות נוסחה שייפתרו לאחר הוספת ההפניה למחבר. שם המחבר המותאם אישית שאתה מוסיף ליישום חייב להתאים לשם התצוגה של המחבר המותאם אישית שאליו מתבצעת הפניה בפקודה canvas create .
  • היישום יכיל מסך אחד עבור כל POST ופעולה GET שהחבר מגדיר.
    • פעלים אחרים הזמינים במחברים מותאמים אישית אינם נתמכים.
  • הפקדים שעובדו על המסך של כל פעולה נוצרים באופן דינאמי בהתבסס על האופן שבו מוגדרים סוגי הקלט והפלט של כל פעולה. סוגים מסוימים של קלט ופלט המוגדרים במחבר המותאם אישית אינם נתמכים על-ידי canvas create. הפקודה תפיק אזהרות במסוף כאשר הן יתקלו בהן. מקרים ספציפיים:
    • מערכים של אובייקטים ומערכים של מערכים אינם נתמכים כקלט
    • פקדים אינם נוצרים עבור אובייקטים או מערכים מקוננים מעבר לעומק של 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

דוגמה

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

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

--msapp

נתיב לקובץ .msapp

--sources

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

הערות

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

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

pac canvas unpack

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

דוגמה

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

pac canvas unpack --msapp HelloWorld.msapp

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

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

--msapp

נתיב לקובץ .msapp

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

--sources

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

הערות

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

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

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

מבנה תיקיה

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

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

      הערה

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

    • 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מסיק.

תבנית קובץ

הקבצים .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.jsמופעל
  • עבור התנגשויות בקבצים אלה, ניתן לקבל את הגירסה העדכנית ביותר:
    • \checksum.jsמופעל
  • אם קיימות התנגשויות מיזוג תחת נתיבים אלה, לא בטוח למזג. ספר לנו אם זה קורה לעתים קרובות; אנו פועלים לשחזור תבנית הקובץ כדי למנוע התנגשויות.
    • \חיבורי*
    • \DataSources*
    • \pkgs*
    • CanvasManifest.json

קוד פתוח

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

pac canvas validate

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

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

--directory -d

נתיב אל ספריית msapp שחולצה המכילה קבצי .pa.yaml לאימות

ראה גם

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

  • Last updated on