pac model

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

פקודות

הפקודה תיאור
pac model create יוצר אפליקציה חדשה מונחית מודלים.
pac model genpage add צרף דף Generative קיים אחד או יותר למפת אתר של יישום מונחה מודלים (ללא העלאה מחדש). השתמש ב- 'pac model genpage upload' כדי ליצור או לעדכן את הדף עצמו; השתמש בפועל זה כדי לגרום לדף שכבר הועלה להופיע ביישום אחר.
pac model genpage download משוך דפים שנוצרו מאפליקציה מונחית מודלים.
pac model genpage generate-types מייצר הגדרות סכמת TypeScript למקורות נתונים
pac model genpage get-connector-schema קבלת סכימה של עמודת טבלת מחברים או סכימה של פעולת REST עבור דפים שנוצרו.
pac model genpage list רשימה שנוצרה של דפים - ברחבי העולם כברירת מחדל, או עבור יישום אחד כאשר --app-id מסופק. Pass --include-unpublished to also list draft pages.
pac model genpage list-connector-operations פירוט פעולות REST של מחבר עבור דפים שנוצרו.
pac model genpage list-connector-tables פירוט טבלאות מחבר עבור עמודים שנוצרו.
pac model genpage remove נתק דפי בינה מלאכותית ג'נטיביים קיימים ממפת אתר של יישום מונחה מודלים. שורת העמוד ב- Dataverse נשמרת (עדיין ניתן להפנות אליה מיישומים אחרים).
pac model genpage transpile טרנספילם קובץ TypeScript עם סוגי ריצה לבדיקה וניפוי שגיאות
pac model genpage upload העלה דף שנוצר ל- Dataverse ופרסם אותו. יצירת עמוד חדש כאשר --page-id מושמט; מעדכן את הדף הקיים כאשר --page-id מסופק. כדי לצרף דף שכבר קיים בסביבה למפת אתר של יישום אחר מבלי להעלות מחדש, השתמש במקום זאת ב- 'pac model genpage add'.
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

עצה

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

pac model genpage add

צרף דף Generative קיים אחד או יותר למפת אתר של יישום מונחה מודלים (ללא העלאה מחדש). השתמש ב- 'pac model genpage upload' כדי ליצור או לעדכן את הדף עצמו; השתמש בפועל זה כדי לגרום לדף שכבר הועלה להופיע ביישום אחר.

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

--page-id

מזהי עמודי Generative (GUID) המופרדים באמצעות פסיקים כדי להוסיף לאפליקציה.

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

--app-id

מזהה היישום (GUID) מונחה המודל. לא הדדית עם --app-name.

--app-name

השם הייחודי של היישום מונחה המודל. לא הדדית עם --app-id.

--area

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

--environment -env

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

--group

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

--language-code

קוד שפה (LCID) עבור כותרת אזור המשנה. ברירות מחדל ל- 1033 (en-US).

--publish

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

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

--solution

שם ייחודי של הקשר הפתרון Dataverse עבור עדכון מפת האתר. ברירות מחדל ל'ברירת מחדל'.

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

הערה

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

pac model genpage get-connector-schema

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

פרמטרים נדרשים עבור model genpage get-connector-schema

--connection-id

מזהה חיבור לשימוש לגילוי מטה-נתונים של מחבר.

--connector-id

מזהה API של מחבר (לדוגמה, /providers/Microsoft. PowerApps/apis/shared_sharepointonline).

פרמטרים אופציונליים עבור model genpage get-connector-schema

--dataset

מזהה ערכת נתונים עבור גילוי מחבר טבלאי (לדוגמה, SharePoint URL של אתר או שרת SQL/מסד נתונים). נדרש עם --table.

--environment -env

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

--operation

מזהה פעולת REST עבור מצב סכימה של פעולה. אין אפשרות להשתמש ב- --dataset או ב- --table.

--table

מזהה טבלה עבור מצב סכימה טבלאי. נדרש --ערכת נתונים ואין אפשרות להשתמש בה עם --operation.

pac model genpage list

רשימה שנוצרה של דפים - ברחבי העולם כברירת מחדל, או עבור יישום אחד כאשר --app-id מסופק. Pass --include-unpublished to also list draft pages.

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

--app-id

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

--environment -env

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

--include-unpublished

כלול ברשימה עמודים generative שלא פורסמו (ברירת מחדל: רק פורסם).

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

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 list-connector-operations

פירוט פעולות REST של מחבר עבור דפים שנוצרו.

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

--connection-id

מזהה חיבור לשימוש לגילוי מטה-נתונים של מחבר.

--connector-id

מזהה API של מחבר (לדוגמה, /providers/Microsoft. PowerApps/apis/shared_sharepointonline).

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

--environment -env

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

pac model genpage list-connector-tables

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

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

--connection-id

מזהה חיבור לשימוש לגילוי מטה-נתונים של מחבר.

--connector-id

מזהה API של מחבר (לדוגמה, /providers/Microsoft. PowerApps/apis/shared_sharepointonline).

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

--dataset

מזהה ערכת נתונים עבור גילוי מחבר טבלאי (לדוגמה, SharePoint URL של אתר או שרת SQL/מסד נתונים). נדרש עם --table.

--environment -env

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

pac model genpage remove

נתק דפי בינה מלאכותית ג'נטיביים קיימים ממפת אתר של יישום מונחה מודלים. שורת העמוד ב- Dataverse נשמרת (עדיין ניתן להפנות אליה מיישומים אחרים).

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

--page-id

מזהה uxagentproject אחד או יותר להסרה (מופרד באמצעות פסיקים).

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

--app-id

מזהה יישום מונחה-דגמים (מזהה ייחודי) ממנו יש להסיר את העמודים. לא הדדית עם --app-name.

--app-name

שם ייחודי של יישום מונחה-דגמים שמהם יש להסיר את העמודים. לא הדדית עם --app-id.

--environment -env

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

--publish

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

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

--solution

שם ייחודי של פתרון Dataverse עבור עדכון מפת האתר. ברירות מחדל ל'ברירת מחדל'.

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

העלה דף שנוצר ל- Dataverse ופרסם אותו. יצירת עמוד חדש כאשר --page-id מושמט; מעדכן את הדף הקיים כאשר --page-id מסופק. כדי לצרף דף שכבר קיים בסביבה למפת אתר של יישום אחר מבלי להעלות מחדש, השתמש במקום זאת ב- 'pac model genpage add'.

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

--app-id

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

--code-file

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

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

--add-to-sitemap

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

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

--agent-message

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

--agent-message-file

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

--compiled-code-file

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

--connectors

נתיב לקובץ JSON עם איגודי מחבר כך יתמדה בדף config.json.

--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

עצה

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

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

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

pac model list

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

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

--environment -env

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

pac model list דוגמה

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

pac model list

פלט לדוגמה:

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

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

‏‫ראו גם‬

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

  • Last updated on