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

تحديد 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 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

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

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

--app-id

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

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

--environment -env

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

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

قم برفع ونشر صفحة تم إنشاؤها على تطبيق يعتمد على النماذج.

المعلمات المطلوبة ل 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 مرجع سريع للمعلمة

Parameter	Required	Description
--app-id	Yes	المعرف الفريد العمومي للتطبيق أو اسم العرض. قم بتشغيل 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

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

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

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

pac model list-tables

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

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

--environment -env

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

--search -s

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

--type -t

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

See also

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