pac model

أوامر للعمل مع التطبيقات المبنية على النماذج.

الأوامر

القيادة	الوصف
pac model create	ينشئ تطبيقا جديدا يعتمد على النماذج.
pac model genpage add	إرفاق صفحة إنشاء موجودة واحدة أو أكثر بخريطة موقع تطبيق يستند إلى نموذج (لا إعادة تحميل). استخدم 'pac model genpage upload' لإنشاء الصفحة نفسها أو تحديثها؛ استخدم هذا الفعل لإظهار صفحة تم تحميلها بالفعل في تطبيق آخر.
pac model genpage download	اسحب الصفحات المولدة من تطبيق يعتمد على النماذج.
pac model genpage generate-types	تولد تعريفات مخطط TypeScript لمصادر البيانات
pac model genpage list	سرد الصفحات التي تم إنشاؤها - env-wide بشكل افتراضي، أو لتطبيق واحد عند توفير --app-id. تمرير --تضمين-غير منشور لسرد صفحات المسودة أيضا.
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

تحديد Dataverse الهدف. قد تكون القيمة GUID أو مطلق https URL. عند عدم التحديد، سيتم استخدام المؤسسة النشطة المحددة لملف تعريف المصادقة الحالي.

--publish

انشر التطبيق بعد الإنشاء.

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

--solution

اسم فريد للحل لإضافة التطبيق إليه. الإعدادات الافتراضية إلى "افتراضي" إذا لم يتم تحديدها.

pac model create امثله

توضح الأمثلة التالية الطرق الشائعة pac model create لاستخدام الأمر.

• إنشاء تطبيق جديد يستند إلى النموذج في البيئة النشطة
• إنشاء تطبيق مع وصف وإضافته إلى حل، ثم النشر على الفور
• إنشاء تطبيق في بيئة معينة من خلال توفير عنوان URL للبيئة

إنشاء تطبيق جديد يستند إلى النموذج في البيئة النشطة

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 add

إرفاق صفحة إنشاء موجودة واحدة أو أكثر بخريطة موقع تطبيق يستند إلى نموذج (لا إعادة تحميل). استخدم 'pac model genpage upload' لإنشاء الصفحة نفسها أو تحديثها؛ استخدم هذا الفعل لإظهار صفحة تم تحميلها بالفعل في تطبيق آخر.

المعلمات المطلوبة ل model genpage add

--page-id

معرفات الصفحة التوليدية المفصولة بفواصل (GUIDs) لإضافتها إلى التطبيق.

معلمات اختيارية ل model genpage add

--app-id

معرف التطبيق المستند إلى النموذج (GUID). حصري بشكل متبادل مع --app-name.

--app-name

الاسم الفريد للتطبيق المستند إلى النموذج. حصري بشكل متبادل مع --app-id.

--area

معرف المنطقة الاختياري في خريطة الموقع لوضع الصفحة ضمنها. الإعدادات الافتراضية للمنطقة الأولى.

--environment -env

تحديد Dataverse الهدف. قد تكون القيمة GUID أو مطلق https URL. عند عدم التحديد، سيتم استخدام المؤسسة النشطة المحددة لملف تعريف المصادقة الحالي.

--group

معرف المجموعة الاختياري في خريطة الموقع لوضع الصفحة ضمنها. الإعدادات الافتراضية للمجموعة الأولى من المنطقة المختارة.

--language-code

رمز اللغة (LCID) لعنوان SubArea. الافتراضيات إلى 1033 (en-US).

--publish

انشر التطبيق المستند إلى النموذج بعد إضافة الصفحة (الصفحات).

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

--solution

اسم فريد لسياق حل Dataverse لتحديث خريطة الموقع. الإعدادات التلقائية على "الإعداد التلقائي".

pac model genpage download

اسحب الصفحات المولدة من تطبيق يعتمد على النماذج.

المعلمات المطلوبة ل model genpage download

--app-id

معرف التطبيق المستند إلى النموذج.

معلمات اختيارية ل model genpage download

--environment -env

تحديد Dataverse الهدف. قد تكون القيمة GUID أو مطلق https URL. عند عدم التحديد، سيتم استخدام المؤسسة النشطة المحددة لملف تعريف المصادقة الحالي.

--output-directory -o

دليل لحفظ الصفحات المسحوبة. الإعدادات الافتراضية للدليل الحالي.

--page-id

قائمة مفصولة بفواصل لمعرفات الصفحات المراد سحبها.

pac model genpage download امثله

توضح الأمثلة التالية الطرق الشائعة pac model genpage download لاستخدام الأمر.

• تنزيل صفحة إنشاء واحدة بواسطة معرف الصفحة الخاص بها إلى مجلد محلي للتحرير
• تنزيل جميع الصفحات التوليدية في تطبيق في وقت واحد
• إنشاء دليل فرعي يسمى باسم معرف الصفحة وكتابة الملفات التالية

تنزيل صفحة إنشاء واحدة بواسطة معرف الصفحة الخاص بها إلى مجلد محلي للتحرير

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

تحديد Dataverse الهدف. قد تكون القيمة GUID أو مطلق https URL. عند عدم التحديد، سيتم استخدام المؤسسة النشطة المحددة لملف تعريف المصادقة الحالي.

--output-file -o

مسار لحفظ ملف مخطط TypeScript الذي تم إنشاؤه (الإعدادات الافتراضية RuntimeTypes.ts)

pac model genpage generate-types امثله

توضح الأمثلة التالية الطرق الشائعة pac model genpage generate-types لاستخدام الأمر.

• إنشاء أنواع TypeScript
• إنشاء أنواع لجدول واحد في دليل إخراج معين

إنشاء أنواع 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

سرد الصفحات التي تم إنشاؤها - env-wide بشكل افتراضي، أو لتطبيق واحد عند توفير --app-id. تمرير --تضمين-غير منشور لسرد صفحات المسودة أيضا.

معلمات اختيارية ل model genpage list

--app-id

معرف التطبيق المستند إلى النموذج.

--environment -env

تحديد Dataverse الهدف. قد تكون القيمة GUID أو مطلق https URL. عند عدم التحديد، سيتم استخدام المؤسسة النشطة المحددة لملف تعريف المصادقة الحالي.

--include-unpublished

تضمين صفحات إنشاء غير منشورة في القائمة (افتراضي: منشور فقط).

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

pac model genpage list امثله

توضح الأمثلة التالية الطرق الشائعة pac model genpage list لاستخدام الأمر.

• سرد الصفحات باستخدام معرف التطبيق
• سرد الصفحات باستخدام اسم التطبيق

سرد الصفحات باستخدام معرف التطبيق

سرد جميع الصفحات التوليدية في تطبيق Contoso Sales Hub باستخدام معرف التطبيق الخاص به:

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

سرد الصفحات باستخدام اسم التطبيق

سرد الصفحات التوليدية حسب اسم التطبيق (يبحث 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 remove

فصل صفحات (صفحات) الذكاء الاصطناعي التوليدية الحالية من خريطة موقع التطبيق المستندة إلى النموذج. يتم الاحتفاظ بصف الصفحة في Dataverse (قد يستمر الرجوع إليه من تطبيقات أخرى).

المعلمات المطلوبة ل model genpage remove

--page-id

واحد أو أكثر من معرفات uxagentproject المراد إزالتها (مفصولة بفواصل).

معلمات اختيارية ل model genpage remove

--app-id

معرف التطبيق المستند إلى النموذج (uniqueid) لإزالة الصفحة (الصفحات) منها. حصري بشكل متبادل مع --app-name.

--app-name

اسم فريد للتطبيق يستند إلى النموذج لإزالة الصفحة (الصفحات) منه. حصري بشكل متبادل مع --app-id.

--environment -env

تحديد Dataverse الهدف. قد تكون القيمة GUID أو مطلق https URL. عند عدم التحديد، سيتم استخدام المؤسسة النشطة المحددة لملف تعريف المصادقة الحالي.

--publish

انشر التطبيق المستند إلى النموذج بعد تحرير خريطة الموقع بحيث تنتقل التغييرات مباشرة.

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

--solution

اسم فريد لحل Dataverse لتحديث خريطة الموقع. الإعدادات التلقائية على "الإعداد التلقائي".

pac model genpage transpile

يقوم بتحويل ملف TypeScript بأنواع وقت التشغيل للاختبار والتصحيح

المعلمات المطلوبة ل model genpage transpile

--code-file

المسار إلى الملف الذي يحتوي على رمز الصفحة.

معلمات اختيارية ل model genpage transpile

--data-sources

قائمة مفصولة بفاصلة لمصادر البيانات المستخدمة (على سبيل المثال، 'account,lead,contact').

--environment -env

تحديد Dataverse الهدف. قد تكون القيمة GUID أو مطلق https URL. عند عدم التحديد، سيتم استخدام المؤسسة النشطة المحددة لملف تعريف المصادقة الحالي.

--output-file

مسار لحفظ إخراج JavaScript الذي تم نقله (الافتراضيات إلى [ملف التعليمات البرمجية].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.

--data-sources

قائمة مفصولة بفاصلة لمصادر البيانات المستخدمة (على سبيل المثال، 'account,lead,contact').

--environment -env

تحديد Dataverse الهدف. قد تكون القيمة GUID أو مطلق https URL. عند عدم التحديد، سيتم استخدام المؤسسة النشطة المحددة لملف تعريف المصادقة الحالي.

--model

نموذج الذكاء الاصطناعي المستخدم لإنشاء الصفحة (على سبيل المثال، 'claude-3-5-sonnet-20241022').

--name -n

اسم الصفحة.

--page-id

معرف الصفحة المراد تحديثها. إذا لم يتم توفيرها، إنشاء صفحة جديدة.

--prompt

مطالبة المستخدم التي أنشأت هذه الصفحة.

--prompt-file

المسار إلى ملف يحتوي على مطالبة المستخدم التي أنشأت هذه الصفحة.

pac model genpage upload امثله

توضح الأمثلة التالية الطرق الشائعة pac model genpage upload لاستخدام الأمر.

• نشر صفحة إنشاء جديدة
• تحديث صفحة إنشاء موجودة
• نشر صفحة تستخدم بيانات وهمية

نشر صفحة إنشاء جديدة

نشر صفحة إنشاء جديدة إلى تطبيق 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

تحديث صفحة إنشاء موجودة

تحديث صفحة إنشاء موجودة عن طريق توفير معرف الصفحة الخاص بها (حذف --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 مرجع سريع للمعلمة

المعلمة	مطلوب	الوصف
--app-id	‏‏نعم‬	المعرف الفريد العمومي للتطبيق أو اسم العرض. قم بتشغيل 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

تحديد Dataverse الهدف. قد تكون القيمة GUID أو مطلق https URL. عند عدم التحديد، سيتم استخدام المؤسسة النشطة المحددة لملف تعريف المصادقة الحالي.

مثال لـ 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

تحديد Dataverse الهدف. قد تكون القيمة GUID أو مطلق https URL. عند عدم التحديد، سيتم استخدام المؤسسة النشطة المحددة لملف تعريف المصادقة الحالي.

pac model list-tables

قم بإدراج جداول Dataverse في البيئة المتصلة.

معلمات اختيارية ل model list-tables

--environment -env

تحديد Dataverse الهدف. قد تكون القيمة GUID أو مطلق https URL. عند عدم التحديد، سيتم استخدام المؤسسة النشطة المحددة لملف تعريف المصادقة الحالي.

--search -s

قائمة الأسماء المفصولة بفاصل للبحث عنها (تطابق الاسم المنطقي، اسم المخطط، أو اسم العرض).

--type -t

فلتر حسب نوع الجدول: 'مخصص'، 'قياسي'، أو 'كل' (افتراضي: الكل).

(راجع أيضًا)

Microsoft Power Platform مجموعات أوامر CLI
نظرة عامة على Microsoft Power Platform CLI