pac package

أوامر للعمل مع مشاريع حزمة Dataverse.

الاوامر

الأمر	‏‏الوصف
pac package add-external-package	إضافة حزمة خارجية لنظام حل Dataverse إلى مشروع حزمة نشر الحزمة.
pac package add-reference	إضافة مرجع إلى مشروع حل Dataverse
pac package add-solution	إضافة ملف حل Dataverse تم إنشاؤه مسبقا إلى مشروع حزمة نشر الحزمة.
pac package compile	(معاينة) تجميع حزمة. باستخدام --package-type erp، يقوم بتجميع نماذج X++ باستخدام xppc.exe من SDK المثبتة وينتج ZIP قابلا للنشر لكل نموذج.
pac package db-sync	(معاينة) مزامنة قاعدة بيانات تطبيق Finance and Operations مع Dataverse.
pac package deploy	نشر الحزمة إلى Dataverse
pac package init	تهيئة دليل مع مشروع حزمة Dataverse جديد
pac package show	إظهار تفاصيل حزمة Dataverse

pac package add-external-package

إضافة حزمة خارجية لنظام حل Dataverse إلى مشروع حزمة نشر الحزمة.

المعلمات المطلوبة ل package add-external-package

--package-type -t

نوع الحزمة التي تتم إضافتها. على سبيل المثال: "xpp" لحزم FnO.

--path -p

المسار إلى الحزمة الخارجية

معلمات اختيارية ل package add-external-package

--import-order

رقم كامل يشير إلى ترتيب إدراج هذا العنصر في ملف ImportConfig.xml النهائي في وقت الإنشاء. يتم إدراج الأرقام السالبة قبل العناصر الموجودة. تتم إضافة الأرقام الموجبة بعد العناصر الموجودة.

--skip-validation -sv

إضافة العنصر إلى ملف المشروع حتى إذا لم يكن الملف موجودا أو يبدو غير صالح. ملاحظة: لا يؤثر استخدام هذا على أي تحقق من الصحة يتم إجراؤه بواسطة MSBuild.

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

pac package add-reference

إضافة مرجع إلى مشروع حل Dataverse

مثال

pac package add-reference --path c:\Users\Downloads\SampleSolution

المعلمات المطلوبة ل package add-reference

--path -p

المسار إلى مشروع حل Dataverse المشار إليه

معلمات اختيارية ل package add-reference

--dependency-overrides

قائمة محددة بفاصلة منقوطة من التجاوزات. تتجاوز هذه القيمة أي معلومات تبعية مشفرة في بيانات تعريف الحل. يجب أن يكون كل تجاوز بالتنسيق: <uniquename>:<minVersion>:<maxVersion>. حيث minVersion وmaxVersion اختياري ولكن يجب أن يكونا في بناء جملة تنسيق إصدار .NET.

ملاحظة: استخدم قائمة محددة بفاصلة منقوطة لتجاوزات التبعية الخاصة <بالتنسيق uniquename>:<minVersion>:<maxVersion>.

--import-mode

يحدد بشكل صريح الوضع المطلوب عند استيراد هذا الحل.

استخدم إحدى هذه القيم:

• sync
• async

--import-order

رقم كامل يشير إلى ترتيب إدراج هذا العنصر في ملف ImportConfig.xml النهائي في وقت الإنشاء. يتم إدراج الأرقام السالبة قبل العناصر الموجودة. تتم إضافة الأرقام الموجبة بعد العناصر الموجودة.

--missing-dependency-behavior

يحدد السلوك عند الاستيراد عندما تكون تبعية هذا الحل مفقودة من البيئة الهدف.

استخدم إحدى هذه القيم:

• skip
• fault

--overwrite-unmanaged-customizations

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

استخدم إحدى هذه القيم:

• true
• false

--publish-workflows-activate-plugins

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

استخدم إحدى هذه القيم:

• true
• false

pac package add-solution

إضافة ملف حل Dataverse تم إنشاؤه مسبقا إلى مشروع حزمة نشر الحزمة.

المعلمات المطلوبة ل package add-solution

--path -p

المسار إلى ملف حل Dataverse. يجب أن يكون الملف ملف ZIP مضغوط.

معلمات اختيارية ل package add-solution

--dependency-overrides

قائمة محددة بفاصلة منقوطة من التجاوزات. تتجاوز هذه القيمة أي معلومات تبعية مشفرة في بيانات تعريف الحل. يجب أن يكون كل تجاوز بالتنسيق: <uniquename>:<minVersion>:<maxVersion>. حيث minVersion وmaxVersion اختياري ولكن يجب أن يكونا في بناء جملة تنسيق إصدار .NET.

ملاحظة: استخدم قائمة محددة بفاصلة منقوطة لتجاوزات التبعية الخاصة <بالتنسيق uniquename>:<minVersion>:<maxVersion>.

--import-mode

يحدد بشكل صريح الوضع المطلوب عند استيراد هذا الحل.

استخدم إحدى هذه القيم:

• sync
• async

--import-order

رقم كامل يشير إلى ترتيب إدراج هذا العنصر في ملف ImportConfig.xml النهائي في وقت الإنشاء. يتم إدراج الأرقام السالبة قبل العناصر الموجودة. تتم إضافة الأرقام الموجبة بعد العناصر الموجودة.

--missing-dependency-behavior

يحدد السلوك عند الاستيراد عندما تكون تبعية هذا الحل مفقودة من البيئة الهدف.

استخدم إحدى هذه القيم:

• skip
• fault

--overwrite-unmanaged-customizations

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

استخدم إحدى هذه القيم:

• true
• false

--publish-workflows-activate-plugins

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

استخدم إحدى هذه القيم:

• true
• false

--skip-validation -sv

إضافة العنصر إلى ملف المشروع حتى إذا لم يكن الملف موجودا أو يبدو غير صالح. ملاحظة: لا يؤثر استخدام هذا على أي تحقق من الصحة يتم إجراؤه بواسطة MSBuild.

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

pac package compile

(معاينة) تجميع حزمة. باستخدام --package-type erp، يقوم بتجميع نماذج X++ باستخدام xppc.exe من SDK المثبتة وينتج ZIP قابلا للنشر لكل نموذج.

المعلمات المطلوبة ل package compile

--package-type -pt

النظام الأساسي المستهدف للتوزيع. القيم المسموح بها: dataverse، erp (معاينة). الافتراضي: dataverse.

معلمات اختيارية ل package compile

--app-version -av

إصدار تطبيق F&O المكون من أربعة أجزاء من SDK المراد التحويل البرمجي مقابله (على سبيل المثال، 10.0.2588.0). عند حذفها، يتم استخدام SDK المسجلة للبيئة النشطة.

--incremental

التحويل البرمجي للبيانات الاصطناعية التي تم تغييرها فقط (يمر -incremental إلى xppc).

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

--language -lang

قائمة لغة مفصولة بفواصل لتجميع التسميات ل (على سبيل المثال، en-US أو en-US،fr،de). عند حذفها، ينشئ LabelC كل الإعدادات المحلية الموجودة في المصدر — يطابق سلوك نماذج البناء الافتراضية Visual Studio. يؤثر فقط على مرحلة التسميات؛ xppc + أفضل الممارسات + تشغيل الحزمة مرة واحدة عبر الإخراج المدمج.

--license-file -lf

المسار إلى ملف ترخيص ISV لإدخاله في كل نموذج ZIP تم إنتاجه. مكتوب إلى <Model>/bin/<filename> داخل ZIP.

--model -m

اسم (أسماء) النموذج المراد تحويله برمجيا. يقبل اسما واحدا أو قائمة مفصولة بفواصل. عند حذفها، يتم تجميع جميع النماذج المدرجة في .erp/xpp.json.

--output

الدليل حيث سيتم كتابة ZIPs القابلة للنشر. الافتراضي: <repoRoot>/bin.

--outputDirectory -o

دليل الإخراج

--skip-bp

تخطي خطوة التحقق من أفضل الممارسات. بشكل افتراضي، تقوم البنية الأساسية لبرنامج ربط العمليات التجارية بالتحويل البرمجي بتشغيل التسميات -> X++ -> أفضل الممارسات.

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

--solution-root -sr

المجلد الجذر لحل X++ (يحتوي على .erp/xpp.json). يلعب الدليل الافتراضي الحالي.

pac package db-sync

(معاينة) مزامنة قاعدة بيانات تطبيق Finance and Operations مع Dataverse.

معلمات اختيارية ل package db-sync

--argument-file -af

(معاينة) المسار إلى ملف JSON يطابق عقد IncrementalSyncParameters (أو ModuleSyncParameters). مطلوب ل --db-sync Incremental.

--db-sync -ds

وضع مزامنة قاعدة البيانات. القيم المسموح بها: كاملة، وحدة نمطية، تزايدية. الافتراضي: كامل.

--environment -env

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

--modules -m

(معاينة) قائمة مفصولة بفواصل بأسماء الوحدات النمطية للمزامنة. مطلوب عندما تكون --db-sync هي الوحدة النمطية.

pac package deploy

نشر الحزمة إلى Dataverse

إشعار

يتوفر هذا الأمر فقط لإصدار .NET Full Framework من PAC CLI.

مثال

pac package deploy --logFile c:\samplelogdata --package c:\samplepackage

معلمات اختيارية ل package deploy

--argument-file -af

(معاينة) المسار إلى ملف JSON يطابق عقد IncrementalSyncParameters (أو ModuleSyncParameters). مطلوب ل --db-sync Incremental.

--build-type -bt

(معاينة) كيفية تطبيق الحزمة. القيم المسموح بها: كامل، تزايدي، حذف. الافتراضي: كامل. يستخدم مع --package-type erp.

--db-sync -ds

(معاينة) وضع مزامنة قاعدة البيانات للتشغيل بعد التوزيع. القيم المسموح بها: بلا، كامل، وحدة نمطية، تزايدي. الافتراضي: بلا. يستخدم مع --package-type erp.

--environment -env

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

--logConsole -c

سجل الإخراج إلى وحدة التحكم

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

--logFile -lf

مسار ملف السجل

--modules -m

(معاينة) قائمة مفصولة بفواصل بأسماء الوحدات النمطية للمزامنة. مطلوب عندما تكون --db-sync هي الوحدة النمطية.

--outputDirectory -o

(معاينة) وضع الحل فقط: المجلد الجذر الذي يحتوي على .erp/xpp.json. يلعب الدليل الافتراضي الحالي. عند حذف --package ضمن --package-type erp، يتم نشر جميع النماذج المدرجة في .erp/xpp.json بترتيب التبعية.

--package -p

المسار إلى حزمة dll أو ملف مضغوط مع حزمة.

--package-type -pt

النظام الأساسي المستهدف للتوزيع. القيم المسموح بها: dataverse، erp (معاينة). الافتراضي: dataverse.

--release-type -rt

(معاينة) تصنيف الحزمة. القيم المسموح بها: Dev، Release. الافتراضي: Dev. تفرض حزم الإصدار مزامنة كاملة لقاعدة البيانات على الخادم. يستخدم مع --package-type erp.

--settings -s

إعدادات حزمة وقت التشغيل التي يتم تمريرها إلى الحزمة التي يتم نشرها. يجب أن يكون key=value|key=valueتنسيق السلسلة .

ملاحظة: يجب أن يكون key=value|key=valueتنسيق السلسلة .

--solution -sz

المسار إلى ملف حل Dataverse. يجب أن يكون الملف ملف ZIP أو CAB مضغوطا.

--solution-root -sr

(معاينة) وضع الحل فقط: المجلد الجذر الذي يحتوي على .erp/xpp.json. يلعب الدليل الافتراضي الحالي. عند حذف --package ضمن --package-type erp، يتم نشر جميع النماذج المدرجة في .erp/xpp.json بترتيب التبعية.

--verbose -vdbg

إرسال سجلات مطولة إلى مخرجات السجل.

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

ملاحظات

يمكنك استخدام كل من logFile المعلمتين و logConsole معا، أو استخدام معلمة واحدة أو أخرى.

pac package init

تهيئة دليل مع مشروع حزمة Dataverse جديد

مثال

pac package init --outputdirectory c:\samplepackage

معلمات اختيارية ل package init

--layer -l

(معاينة) طبقة X++. القيم المسموح بها: USR، CUS، VAR، SL1، SL2، SL3، BUS، HFX، GLS، DIS، ISV. الافتراضي: ISV.

--model -m

(معاينة) اسم (أسماء) طراز (نماذج) X++ للتدعيم. يقبل اسما واحدا أو قائمة مفصولة بفواصل (على سبيل المثال ModelA،ModelB). مطلوب عندما يكون نوع الحزمة erp.

--outputDirectory -o

دليل الإخراج

--package-name

تعيين الاسم الافتراضي للحزمة. ينطبق على إنشاء ImportExtension.GetNameOfImport.

--package-type -pt

نوع مشروع الحزمة المراد دعمه. القيم المسموح بها: dataverse، erp (معاينة). الافتراضي: dataverse.

--publisher -pub

(معاينة) Publisher الاسم المكتوب في واصف النموذج. الافتراضي: Microsoft.

--source-root -sr

(معاينة) مسار جذر المصدر (بالنسبة إلى دليل الإخراج) حيث ستعيش النماذج. الافتراضي: ./src.

pac package show

إظهار تفاصيل حزمة Dataverse

إشعار

يتوفر هذا الأمر فقط لإصدار .NET Full Framework من PAC CLI.

مثال

pac package show c:\samplepackage.dll

المعلمات المطلوبة ل package show

--package -p

المسار إلى حزمة dll أو ملف مضغوط مع حزمة.

معلمات اختيارية ل package show

--environment -env

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

--logFile -lf

مسار ملف السجل

--verbose -vdbg

إرسال سجلات مطولة إلى مخرجات السجل.

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

(راجع أيضاً)

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