pac model

פקודות לעבודה עם אפליקציות מונעות מודל.

Commands

Command Description
pac model create יוצר אפליקציה חדשה מונחית מודלים.
pac model genpage download משוך דפים שנוצרו מאפליקציה מונחית מודלים.
pac model genpage generate-types מייצר הגדרות סכמת TypeScript למקורות נתונים
pac model genpage list מפרט את כל הדפים שנוצרו באפליקציה המונחית מודל שצוינה.
pac model genpage transpile טרנספילם קובץ TypeScript עם סוגי ריצה לבדיקה וניפוי שגיאות
pac model genpage upload העלה ופרסם דף שנוצר לאפליקציה מונחית מודל.
pac model list מפרט את כל האפליקציות המונעות על ידי מודלים בסביבה.
pac model list-languages מפרטת שפות מופעלות בסביבת Dataverse.
pac model list-tables רשום טבלאות Dataverse בסביבה המחוברת.

pac model create

יוצר אפליקציה חדשה מונחית מודלים.

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

--name -n

שם התצוגה עבור היישום החדש המבוסס על מודלים.

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

--description -d

תיאור של האפליקציה החדשה המבוססת על מודלים.

--environment -env

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

--publish

פרסם את היישום לאחר היצירה.

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

--solution

שם ייחודי של פתרון להוספה של היישום. ברירות מחדל לפתרון הפעיל.

pac model create דוגמאות

הדוגמאות הבאות מציגות דרכים נפוצות לשימוש בפקודה pac model create .

יצירת יישום מונחה מודלים חדש בסביבה הפעילה

pac model create --name "Contoso Sales Hub"

צור יישום עם תיאור והוסף אותו לפתרון ולאחר מכן פרסם באופן מיידי

pac model create \
  --name "Contoso Sales Hub" \
  --description "Central hub for managing Contoso sales activities, accounts, and contacts." \
  --solution "ContosoSales" \
  --publish

יצירת יישום בסביבה ספציפית על-ידי אספקת כתובת ה- URL של הסביבה

pac model create \
  --name "Contoso Sales Hub" \
  --description "Central hub for managing Contoso sales activities, accounts, and contacts." \
  --environment "https://contoso.crm.dynamics.com" \
  --solution "ContosoSales" \
  --publish

Tip

השתמש pac model list כדי לוודא שהיישום נוצר ולאחזר את מזהה היישום שלו לשימוש עם פקודות אחרות, כגון pac model genpage upload.

pac model genpage download

משוך דפים שנוצרו מאפליקציה מונחית מודלים.

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

--app-id

המזהה של היישום מונחה המודל.

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

--environment -env

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

--output-directory -o

מדריך כתובות לשמירת דפים שעצרת. ברירות מחדל למדריך הכתובות הנוכחי.

--page-id

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

pac model genpage download דוגמאות

הדוגמאות הבאות מציגות דרכים נפוצות לשימוש בפקודה pac model genpage download .

הורד דף Generative יחיד באמצעות מזהה העמוד שלו לתיקיה מקומית לעריכה

pac model genpage download \
  --app-id "a1b2c3d4-1234-5678-abcd-000000000001" \
  --page-id "e5f6a7b8-abcd-ef01-2345-000000000010" \
  --output-directory ./pages/account-dashboard

הורדת כל הדפים הג'נטיביים באפליקציה בו-זמנית

pac model genpage download \
  --app-id "Contoso Sales Hub" \
  --output-directory ./pages

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

./pages/account-dashboard/
  e5f6a7b8-abcd-ef01-2345-000000000010/
    page.tsx          ← TypeScript source code
    page.js           ← Transpiled JavaScript
    RuntimeTypes.ts   ← Dataverse type definitions
    config.json       ← Page metadata
    prompt.txt        ← Original generation prompt

pac model genpage generate-types

מייצר הגדרות סכמת TypeScript למקורות נתונים

פרמטרים נדרשים עבור model genpage generate-types

--data-sources

רשימה מופרדת באמצעות פסיק של מקורות נתונים שנמצאים בשימוש (לדוגמה, 'account,lead,contact').

פרמטרים אופציונליים עבור model genpage generate-types

--environment -env

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

--output-file -o

נתיב לשמירת קובץ הסכימה של TypeScript שנוצר (ברירת המחדל היא RuntimeTypes.ts)

pac model genpage generate-types דוגמאות

הדוגמאות הבאות מציגות דרכים נפוצות לשימוש בפקודה pac model genpage generate-types .

צור סוגי TypeScript

צור סוגי TypeScript עבור הטבלאות account והטבלאות contact וכתוב אותם ב- ./src/RuntimeTypes.ts:

pac model genpage generate-types \
  --data-sources "account,contact" \
  --output-file ./src/RuntimeTypes.ts

יצירת סוגים עבור טבלה בודדת לתוך ספריית פלט ספציפית

pac model genpage generate-types \
  --data-sources "opportunity" \
  --output-file ./pages/opportunity/RuntimeTypes.ts

Note

הפעל תמיד לפני generate-types כתיבת קוד עמוד המציין שאילתות בטבלאות Dataverse. הקובץ שנוצר מכיל שמות עמודות קלידים חזקים, שדות מפתח זר וערכים של ספירה עבור כל טבלה. שימוש בסוגים שנוצרו מונע שגיאות זמן ריצה שנגרמו על-ידי שמות עמודות שאויתו באופן שגוי או לא קיימים.

pac model genpage list

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

פרמטרים נדרשים עבור model genpage list

--app-id

המזהה של היישום מונחה המודל.

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

--environment -env

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

pac model genpage list דוגמאות

הדוגמאות הבאות מציגות דרכים נפוצות לשימוש בפקודה pac model genpage list .

רשימת דפים המשתמשים במזהה יישום

פרט את כל הדפים הג'נירטיביים באפליקציה 'מרכז המכירות של Contoso ' באמצעות מזהה היישום שלו:

pac model genpage list --app-id "a1b2c3d4-1234-5678-abcd-000000000001"

רשימת דפים המשתמשים בשם היישום

פרט דפים generative לפי שם יישום (ה- CLI מחפש את מזהה היישום באופן אוטומטי):

pac model genpage list --app-id "Contoso Sales Hub"

pac model פלט לדוגמה של genpage

Found 2 generated page(s):

  Account Dashboard
    Page ID: e5f6a7b8-abcd-ef01-2345-000000000010
    Description: Created: 2026-01-15T10:22:00Z

  Opportunity Tracker
    Page ID: e5f6a7b8-abcd-ef01-2345-000000000011
    Description: Created: 2026-02-03T14:05:00Z

pac model genpage transpile

טרנספילם קובץ TypeScript עם סוגי ריצה לבדיקה וניפוי שגיאות

פרמטרים נדרשים עבור model genpage transpile

--code-file

נתיב לקובץ המכיל את קוד הדף.

פרמטרים אופציונליים עבור model genpage transpile

--data-sources

רשימה מופרדת באמצעות פסיק של מקורות נתונים שנמצאים בשימוש (לדוגמה, 'account,lead,contact').

--environment -env

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

--output-file

נתיב לשמירת פלט JavaScript משוכתב (ברירות מחדל ל- [code-file].compiled.js)

pac model genpage upload

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

פרמטרים נדרשים עבור model genpage upload

--app-id

המזהה של היישום מונחה המודל.

--code-file

נתיב לקובץ המכיל את קוד הדף.

פרמטרים אופציונליים עבור model genpage upload

--add-to-sitemap

הוסף את הדף לניווט של מפת האתר של היישום.

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

--agent-message

הודעת התגובה של הסוכן.

--agent-message-file

נתיב לקובץ המכיל את הודעת התגובה של הסוכן.

--compiled-code-file

נתיב לקובץ המכיל את קוד JavaScript הידור. אם לא צוין, TypeScript יתוקן באופן אוטומטי ל- JavaScript.

--data-sources

רשימה מופרדת באמצעות פסיק של מקורות נתונים שנמצאים בשימוש (לדוגמה, 'account,lead,contact').

--environment -env

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

--model

מודל הבינה המלאכותית ששימש ליצירת הדף (לדוגמה, 'קל-3-5-sonnet-20241022').

--name -n

שם הדף.

--page-id

מזהה הדף לעדכון. אם לא תינתן, ייווצר עמוד חדש.

--prompt

ההנחיה למשתמש שיצר דף זה.

--prompt-file

נתיב לקובץ המכיל את הבקשה של המשתמש שיצר דף זה.

pac model genpage upload דוגמאות

הדוגמאות הבאות מציגות דרכים נפוצות לשימוש בפקודה pac model genpage upload .

פרסום דף ג'נטיבי חדש

פרסם דף Generative חדש ביישום Contoso Sales Hub והוסף אותו למפת האתר של היישום:

pac model genpage upload \
  --app-id "a1b2c3d4-1234-5678-abcd-000000000001" \
  --code-file ./pages/account-dashboard.tsx \
  --name "Account Dashboard" \
  --data-sources "account,contact" \
  --prompt "A dashboard showing Account records as interactive cards with contact count and revenue metrics." \
  --model "claude-sonnet-4-6" \
  --agent-message "Created account dashboard with card grid, revenue chart, and contact list. Uses account and contact tables." \
  --add-to-sitemap

עדכון דף Generative קיים

עדכן דף Generative קיים על-ידי מתן מזהה הדף שלו ( --add-to-sitemap השמט כדי להימנע מיצירה של ערך מפת אתר כפול):

pac model genpage upload \
  --app-id "a1b2c3d4-1234-5678-abcd-000000000001" \
  --page-id "e5f6a7b8-abcd-ef01-2345-000000000010" \
  --code-file ./pages/account-dashboard.tsx \
  --data-sources "account,contact" \
  --prompt "A dashboard showing Account records as interactive cards with contact count and revenue metrics." \
  --model "claude-sonnet-4-6" \
  --agent-message "Updated card layout to use a two-column grid; added revenue sparkline chart."

פרסום דף המשתמש בנתונים מדומה

פרסם דף המשתמש בנתונים מדומה (ללא טבלאות Dataverse — השמט --data-sources):

pac model genpage upload \
  --app-id "Contoso Sales Hub" \
  --code-file ./pages/welcome-screen.tsx \
  --name "Welcome" \
  --prompt "A branded welcome screen with Contoso logo, quick-action tiles, and a news feed placeholder." \
  --model "claude-sonnet-4-6" \
  --agent-message "Welcome page with static mock data. No Dataverse queries." \
  --add-to-sitemap

Tip

הפרמטר --app-id מקבל את ה- GUID של היישום או את שם התצוגה שלו. אם אפליקציות מרובות משתפות את אותו שם תצוגה, השתמש ב- GUID כדי להימנע מ רב-משמעיות. הפעל pac model list כדי לחפש את זהות האפליקציות.

pac model genpage upload הפניה מהירה של פרמטר

Parameter Required Description
--app-id Yes GUID של יישום או שם תצוגה. רוץ pac model list למצוא אותו.
--code-file Yes נתיב לקובץ .tsx המקור לפריסה.
--name עמודים חדשים בלבד שם התצוגה מוצג במפת האתר של היישום.
--page-id Updates only ה- GUID של הדף הקיים להחלפה.
--data-sources Dataverse pages רשימה מופרדת באמצעות פסיקים של שמות לוגיים בטבלה Dataverse (לדוגמה, "account,contact").
--prompt Recommended סיכום שפה טבעית של הפעולות שהדף עושה. מאוחסן עבור הקשר יצירה מחדש.
--model Recommended מזהה מודל המשמש ליצירת הדף (לדוגמה, claude-sonnet-4-6).
--agent-message Recommended תיאור של הפריטים שנבנו או השתנו. מאוחסן כהיסטוריית שינויים.
--add-to-sitemap עמודים חדשים בלבד מוסיף את הדף לניווט באפליקציה באופן אוטומטי. השמט בעת עדכון.

pac model list

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

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

--environment -env

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

pac model list דוגמה

פרט את כל היישומים מונחי הדגמים בסביבה הפעילה כעת:

pac model list

Sample output:

Found 3 model-driven app(s):

  Contoso Sales Hub
    App ID: a1b2c3d4-1234-5678-abcd-000000000001
    Unique Name: contoso_SalesHub

  Contoso Field Service
    App ID: a1b2c3d4-1234-5678-abcd-000000000002
    Unique Name: contoso_FieldService

  Contoso Customer Portal
    App ID: a1b2c3d4-1234-5678-abcd-000000000003
    Unique Name: contoso_CustomerPortal

pac model list-languages

מפרטת שפות מופעלות בסביבת Dataverse.

פרמטרים אופציונליים עבור model list-languages

--environment -env

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

pac model list-tables

רשום טבלאות Dataverse בסביבה המחוברת.

פרמטרים אופציונליים עבור model list-tables

--environment -env

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

--search -s

רשימת שמות מופרדת בפסיקים לחיפוש (תואמת לשם לוגי, שם סכימה או שם תצוגה).

--type -t

סנן לפי סוג טבלה: 'מותאם אישית', 'סטנדרטית' או 'כולם' (ברירת מחדל: כולם).

See also

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

  • Last updated on