حل pac

أوامر للعمل مع مشاريع حل Dataverse

الاوامر

الأمر	‏‏الوصف
ترخيص الوظيفة الإضافية لحل pac	إضافة معلومات الترخيص والتخطيط إلى الحل.
مرجع حل pac الإضافي	إضافة مرجع من المشروع في الدليل الحالي إلى المشروع في "المسار"
مكون الحل الإضافي لحل pac	إضافة مكون حل واحد أو أكثر إلى الحل غير المدار الهدف في Dataverse.
التحقق من حل pac	تحميل مشروع حل Dataverse لتشغيله مقابل خدمة Power Apps Checker.
استنساخ حل pac	إنشاء مشروع حل استنادا إلى حل موجود في مؤسستك.
إعدادات إنشاء حل pac	إنشاء ملف إعدادات من مضغوط الحل أو مجلد الحل.
حذف حل pac	حذف حل من Dataverse في البيئة الحالية.
تصدير حل pac	تصدير حل من Dataverse.
استيراد حل pac	استيراد الحل إلى Dataverse.
pac solution init	تهيئة دليل مع مشروع حل Dataverse جديد
قائمة حلول pac	سرد كافة الحلول من مؤسسة Dataverse الحالية
إصدار حل pac عبر الإنترنت	تعيين إصدار للحل الذي تم تحميله في Dataverse.
حزمة حلول pac	مكونات حل الحزمة على نظام الملفات المحلي في solution.zip (SolutionPackager).
نشر حل pac	نشر كافة التخصيصات
مزامنة حل pac	مزامنة مشروع حل Dataverse الحالي مع الحالة الحالية للحل في مؤسستك.
فك حزمة حل pac	استخراج مكونات الحل من solution.zip إلى نظام الملفات المحلي (SolutionPackager).
ترقية حل pac	تطبيق ترقية الحل
إصدار حل pac	تحديث إصدار أو مراجعة الحل.

ترخيص الوظيفة الإضافية لحل pac

إضافة معلومات الترخيص والتخطيط إلى الحل.

مثال

يوضح هذا المثال كيفية إضافة معلومات الترخيص إلى حل.

pac solution add-license --planDefinitionFile ../ISV_Plan_Definition.csv --planMappingFile ../ISV_Plan_Mapping.csv

ملف تعريف الخطة

ستجد أدناه مثالا لملف تعريف الخطة:

ServiceID,Display name,More info URL
test_isvconnect1599092224747.d365_isvconnect_prod_licensable.bronzeplan,Fabrikam Bronze Plan,http://www.microsoft.com
test_isvconnect1599092224747.d365_isvconnect_prod_licensable.silverplan,Fabrikam Silver Plan,http://www.microsoft.com
test_isvconnect1599092224747.d365_isvconnect_prod_licensable.goldplan,Fabrikam Gold Plan,http://www.microsoft.com

ملف تعيين الخطة

ستجد أدناه مثالا لملف تعيين الخطة:

Service ID,Component name
test_isvconnect1599092224747.d365_isvconnect_prod_licensable.bronzeplan,crf36_BronzeApp
test_isvconnect1599092224747.d365_isvconnect_prod_licensable.silverplan,crf36_BronzeApp
test_isvconnect1599092224747.d365_isvconnect_prod_licensable.silverplan,crf36_SilverApp
test_isvconnect1599092224747.d365_isvconnect_prod_licensable.goldplan,crf36_BronzeApp
test_isvconnect1599092224747.d365_isvconnect_prod_licensable.goldplan,crf36_SilverApp
test_isvconnect1599092224747.d365_isvconnect_prod_licensable.goldplan,crf36_GoldApp

المعلمات المطلوبة للحصول على ترخيص إضافي للحل

--planDefinitionFile -pd

ملف تعريف خطة الترخيص بتنسيق CSV؛ الأعمدة المتوقعة: معرف الخدمة واسم العرض وعنوان URL لمزيد من المعلومات.

--planMappingFile -pm

ملف تعيين خطة الترخيص بتنسيق CSV؛ الأعمدة المتوقعة: معرف الخدمة، اسم المكون

مرجع حل pac الإضافي

إضافة مرجع من المشروع في الدليل الحالي إلى المشروع في "المسار"

مثال

pac solution add-reference --path c:\Users\Downloads\SampleComponent

المعلمات المطلوبة لمرجع الحل الإضافي

--path -p

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

مكون الحل الإضافي لحل pac

إضافة مكون حل واحد أو أكثر إلى الحل غير المدار الهدف في Dataverse.

مثال

يوضح هذا المثال كيفية إضافة مكون حل إلى حل. في هذه الحالة، نقوم بإضافة جدول جهات الاتصال إلى الحل SampleSolution. الجدول هو نوع المكون 1.

pac solution add-solution-component --solutionUniqueName SampleSolution --component contact --componentType 1

المعلمات المطلوبة لمكون الحل الإضافي للحل

--component -c

اسم المخطط أو معرف المكون لإضافته إلى الحل الهدف.

--componentType -ct

القيمة التي تمثل مكون الحل الذي تضيفه.

--solutionUniqueName -sn

اسم الحل.

معلمات اختيارية لمكون الحل الإضافي للحل

--AddRequiredComponents -arc

يشير إلى ما إذا كان يجب أيضا إضافة مكونات الحل الأخرى المطلوبة من قبل مكون الحل الذي تضيفه إلى الحل غير المدار.

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

--async -a

استيراد الحل بشكل غير متزامن.

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

--environment -env

عنوان URL للبيئة أو معرف البيئة الهدف.

التحقق من حل pac

تحميل مشروع حل Dataverse لتشغيله مقابل خدمة Power Apps Checker.

مثال

pac solution check --path c:\Users\Documents\Solution.zip --outputDirectory c:\samplepackage --geo UnitedStates

معلمات اختيارية للتحقق من الحل

--clearCache -cc

مسح ذاكرة التخزين المؤقت لفرض مدقق الحلول، للمستأجر الخاص بك، لجميع السجلات المتعلقة بالنتائج السابقة للحلول الخاصة بك.

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

--customEndpoint -ce

حدد عنوان URL مخصصا كنقطة نهاية Power Apps Checker.

--environment -env

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

--excludedFiles -ef

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

--geo -g

المثيل الجغرافي لخدمة Power Apps Checker التي يجب استخدامها.

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

• PreviewUnitedStates
• UnitedStates
• Europe
• Asia
• Australia
• Japan
• India
• Canada
• SouthAmerica
• UnitedKingdom
• France
• SouthAfrica
• Germany
• UnitedArabEmirates
• Switzerland
• Norway
• Singapore
• Korea
• Sweden
• USGovernment
• USGovernmentL4
• USGovernmentL5DoD
• China

--outputDirectory -o

دليل الإخراج

--path -p

المسار حيث يوجد ملف حل واحد أو أكثر ليتم التحقق من وجوده. يمكن أن يحتوي المسار على أحرف glob/wildcard.

--ruleLevelOverride -rl

المسار إلى ملف يحتوي على قواعد ومستويات صفيف JSON لتجاوزها. القيم المقبولة لمستوى التجاوز هي: هامة، شديدة الأهمية، متوسطة الأهمية، منخفضة الأهمية، معلوماتية. مثال: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}]

--ruleSet -rs

حدد مجموعة قواعد يتم تنفيذها كجزء من هذا الإصدار. القيم: Guid صالح، "شهادة AppSource"، "مدقق الحلول" (افتراضي).

--saveResults -sav

يستخدم البيئة الحالية لتخزين نتائج تحليل الحل التي يمكن رؤيتها في تطبيق Solution Health Hub. بشكل افتراضي، يتم تعيين هذه الوسيطة إلى false.

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

--solutionUrl -u

SAS Uri يشير إلى solution.zip لتحليلها

استنساخ حل pac

إنشاء مشروع حل استنادا إلى حل موجود في مؤسستك.

الأمثلة

توضح الأمثلة التالية استخدام pac solution clone الأمر .

• نسخ أساسي
• النسخ مع تضمين إعدادات الترقيم العام والتعداد التلقائي

نسخ أساسي

ينسخ هذا المثال الحل sampleSolution إلى الدليل الحالي.

pac solution clone --name sampleSolution

النسخ مع تضمين إعدادات الترقيم العام والتعداد التلقائي

ينسخ هذا المثال الحل sampleSolution إلى الدليل الحالي مع تضمين إعدادات الترقيم العام والتعداد التلقائي.

pac solution clone --name sampleSolution --include general,autonumbering

المعلمات المطلوبة لاستنساخ الحل

--name -n

اسم الحل الذي سيتم تصديره.

معلمات اختيارية لاستنساخ الحل

--async -a

يصدر الحل بشكل غير متزامن.

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

--environment -env

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

--include -i

ما هي الإعدادات التي يجب تضمينها في الحل الذي يتم تصديره.

استخدم قيمة واحدة أو أكثر من هذه القيم مفصولة بفواصل:

• autonumbering
• calendar
• customization
• emailtracking
• externalapplications
• general
• isvconfig
• marketing
• outlooksynchronization
• relationshiproles
• sales

--localize -loc

استخراج أو دمج جميع موارد السلسلة في ملفات .resx.

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

--map -m

المسار الكامل إلى تعيين ملف xml لقراءة مجلدات المكونات لحزمها.

--max-async-wait-time -wt

الحد الأقصى لوقت الانتظار غير المتزامن بالدقائق. القيمة الافتراضية هي 60 دقيقة.

--outputDirectory -o

دليل الإخراج

--packagetype -p

تحديد نوع الاستخراج للحل. يمكن أن يكون: "غير مدار" أو "مدار" أو "كلاهما". القيمة الافتراضية هي: "كلاهما".

--targetversion -v

مهمل: يتم تجاهل هذه المعلمة.

إعدادات إنشاء حل pac

إنشاء ملف إعدادات من مضغوط الحل أو مجلد الحل.

مثال

pac solution create-settings --solution-zip C:\SampleSolution.zip --settings-file .\SampleDeploymentSettingsDev.json

معلمات اختيارية لإعدادات إنشاء الحل

--settings-file -s

ملف .json مع إعدادات النشر لمراجع الاتصال ومتغيرات البيئة.

--solution-folder -f

المسار إلى مجلد الحل المحلي غير المحزم: إما جذر ملف 'Other/Solution.xml' أو مجلد بملف .cdsproj.

--solution-zip -z

المسار إلى ملف مضغوط للحل.

حذف حل pac

حذف حل من Dataverse في البيئة الحالية.

مثال

pac solution delete --solution-name Samplesolution

المعلمات المطلوبة لحذف الحل

--solution-name -sn

اسم الحل.

المعلمات الاختيارية لحذف الحل

--environment -env

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

تصدير حل pac

تصدير حل من Dataverse.

مثال

pac solution export --path c:\Users\Documents\Solution.zip --name SampleComponentSolution --managed true --include general

المعلمات المطلوبة لتصدير الحل

--name -n

اسم الحل الذي سيتم تصديره.

معلمات اختيارية لتصدير الحل

--async -a

يصدر الحل بشكل غير متزامن.

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

--environment -env

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

--include -i

ما هي الإعدادات التي يجب تضمينها في الحل الذي يتم تصديره.

استخدم قيمة واحدة أو أكثر من هذه القيم مفصولة بفواصل:

• autonumbering
• calendar
• customization
• emailtracking
• externalapplications
• general
• isvconfig
• marketing
• outlooksynchronization
• relationshiproles
• sales

--managed -m

ما إذا كان يجب تصدير الحل كحل مدار.

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

--max-async-wait-time -wt

الحد الأقصى لوقت الانتظار غير المتزامن بالدقائق. القيمة الافتراضية هي 60 دقيقة.

--overwrite -ow

يمكن لملف الحل المصدر الكتابة فوق ملف مضغوط الحل على نظام الملفات المحلي.

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

--path -p

المسار حيث تتم كتابة ملف مضغوط للحل الذي تم تصديره.

--targetversion -v

مهمل: يتم تجاهل هذه المعلمة.

استيراد حل pac

استيراد الحل إلى Dataverse.

مثال

pac solution import --path c:\Users\Documents\Solution.zip

معلمات اختيارية لاستيراد الحل

--activate-plugins -ap

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

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

--async -a

استيراد الحل بشكل غير متزامن.

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

--environment -env

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

--force-overwrite -f

فرض الكتابة فوق التخصيصات غير المدارة

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

--import-as-holding -h

استيراد الحل كحل عقد.

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

--max-async-wait-time -wt

الحد الأقصى لوقت الانتظار غير المتزامن بالدقائق. القيمة الافتراضية هي 60 دقيقة.

--path -p

المسار إلى ملف مضغوط للحل. إذا لم يتم تحديده، يفترض أن المجلد الحالي هو مشروع cdsproj.

--publish-changes -pc

نشر التغييرات عند استيراد ناجح.

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

--settings-file

ملف .json مع إعدادات النشر لمراجع الاتصال ومتغيرات البيئة.

--skip-dependency-check -s

تخطي التحقق من التبعية مقابل التبعيات التي تم وضع علامة عليها كتحديث المنتج

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

--skip-lower-version -slv

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

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

--stage-and-upgrade -up

استيراد الحل وترقيته.

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

ملاحظات

تكون متصلا ببيئة باستخدام الأمر pac auth لاستخدام pac solution import.

استيراد حل pac

عندما Path لا يتم تحديد المعلمة، فإنها تفترض أن المجلد الحالي هو مشروع cdsproj. إذا تم تعيين الخاصية SolutionPackageType في ملف cdsproj إلى Both، يتم استخدام الحل المدار بشكل افتراضي.

pac solution init

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

مثال

pac solution init --publisher-name developer --publisher-prefix dev

المعلمات المطلوبة ل init للحل

--publisher-name -pn

اسم ناشر حل Dataverse

ملاحظة: يسمح فقط بالأحرف الموجودة ضمن النطاقات [A - Z]، أو [a - z]، أو [0 - 9]، أو _ . قد يكون الحرف الأول فقط في النطاقات [A - Z]، أو [a - z]، أو _.

--publisher-prefix -pp

قيمة بادئة التخصيص لناشر حل Dataverse

ملاحظة: يجب أن تتكون البادئة من حرفين إلى 8 أحرف، ويمكن أن تتكون فقط من أبجدية رقمية، ويجب أن تبدأ بحرف، ولا يمكن أن تبدأ ب 'mscrm'.

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

--outputDirectory -o

دليل الإخراج

قائمة حلول pac

سرد كافة الحلول من مؤسسة Dataverse الحالية

مثال

pac solution list

معلمات اختيارية لقائمة الحلول

--environment -env

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

--includeSystemSolutions

تضمين حلول النظام مثل تلك التي نشرتها Microsoft

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

--json

إرجاع إخراج الأمر كسلسلة بتنسيق JSON.

إصدار حل pac عبر الإنترنت

تعيين إصدار للحل الذي تم تحميله في Dataverse.

مثال

pac solution online-version --solution-name Samplesolution --solution-version 1.0.0.2

المعلمات المطلوبة للحل عبر الإنترنت

--solution-name -sn

اسم الحل.

--solution-version -sv

حدد رقم إصدار الحل.

معلمات اختيارية للحل عبر الإنترنت

--environment -env

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

حزمة حلول pac

مكونات حل الحزمة على نظام الملفات المحلي في solution.zip (SolutionPackager).

مثال

pac solution pack --zipfile C:\SampleSolution.zip --folder .\SampleSolutionUnpacked\.

المعلمات المطلوبة لحزمة الحل

--zipfile -z

المسار الكامل إلى ملف ZIP للحل

معلمات اختيارية لحزمة الحلول

--allowDelete -ad

إملاء ما إذا كانت عمليات الحذف قد تحدث. القيمة الافتراضية هي "false".

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

--allowWrite -aw

إملاء ما إذا كانت عمليات الكتابة قد تحدث. القيمة الافتراضية هي "false".

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

--clobber -c

تمكين إمكانية حذف الملفات التي تم وضع علامة للقراءة فقط عليها أو الكتابة فوقها. القيمة الافتراضية هي "false".

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

--disablePluginRemap -dpm

إعادة تعيين اسم نوع المكون الإضافي المؤهل بالكامل معطل. القيمة الافتراضية هي "false".

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

--errorlevel -e

الحد الأدنى لمستوى التسجيل لإخراج السجل [مطول|معلومات|تحذير|خطأ|إيقاف التشغيل]. القيمة الافتراضية هي "معلومات".

--folder -f

المسار إلى المجلد الجذر على نظام الملفات المحلي. عند فك الحزم أو الاستخراج، تتم كتابة هذا إلى. عند تعبئة هذا تتم القراءة منه.

--localize -loc

استخراج أو دمج جميع موارد السلسلة في ملفات .resx.

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

--log -l

المسار إلى ملف السجل.

--map -m

المسار الكامل إلى تعيين ملف xml لقراءة مجلدات المكونات لحزمها.

--packagetype -p

عند فك الحزم أو الاستخراج، استخدم لتحديد عملية مدارة مزدوجة وغير مدارة. عند التعبئة، استخدم لتحديد Managed أو Unmanaged من فك حزمة سابقة "كلاهما". يمكن أن يكون: "غير مدار" أو "مدار" أو "كلاهما". القيمة الافتراضية هي "غير مدار".

--singleComponent -sc

تنفيذ الإجراء فقط على نوع مكون واحد [WebResource|المكون الإضافي|سير العمل|بلا]. القيمة الافتراضية هي "بلا".

--sourceLoc -src

إنشاء ملف مورد قالب. صالح فقط عند الاستخراج. القيم المحتملة هي "تلقائي"، أو رمز اللغة للغة التي ترغب في تصديرها. يمكنك استخدام معرف رمز اللغة (LCID) أو تنسيقات التعليمات البرمجية للغة المنظمة الدولية للتوحيد القياسي (ISO). عند وجوده، يستخرج هذا موارد السلسلة من اللغة المحددة ك resx.محايد. إذا تم تحديد "auto" أو الشكل الطويل أو القصير فقط من مفتاح التبديل، يتم استخدام اللغة الأساسية للحل.

--useLcid -lcid

استخدم قيم معرف رمز اللغة (LCID) (1033) بدلا من رموز المنظمة الدولية للتوحيد القياسي (ISO) (en-US) لملفات اللغة.

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

--useUnmanagedFileForMissingManaged -same

استخدم نفس ملف مصدر XML عند العثور على حزمة لملف XML المدار وغير المدار فقط؛ ينطبق على AppModuleSiteMap وAppModuleMap وملفات FormXml.

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

نشر حل pac

نشر كافة التخصيصات

مثال

pac solution publish

معلمات اختيارية لنشر الحل

--async -a

نشر كافة التخصيصات بشكل غير متزامن

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

--environment -env

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

--max-async-wait-time -wt

الحد الأقصى لوقت الانتظار غير المتزامن بالدقائق. القيمة الافتراضية هي 60 دقيقة.

مزامنة حل pac

مزامنة مشروع حل Dataverse الحالي مع الحالة الحالية للحل في مؤسستك.

الأمثلة

توضح الأمثلة التالية استخدام pac solution sync الأمر .

المزامنة الأساسية

يقوم هذا المثال بمزامنة الحل إلى الدليل الحالي.

pac solution sync

معلمات اختيارية لمزامنة الحل

--async -a

يصدر الحل بشكل غير متزامن.

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

--environment -env

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

--include -i

ما هي الإعدادات التي يجب تضمينها في الحل الذي يتم تصديره.

استخدم قيمة واحدة أو أكثر من هذه القيم مفصولة بفواصل:

• autonumbering
• calendar
• customization
• emailtracking
• externalapplications
• general
• isvconfig
• marketing
• outlooksynchronization
• relationshiproles
• sales

--localize -loc

استخراج أو دمج جميع موارد السلسلة في ملفات .resx.

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

--map -m

المسار الكامل إلى تعيين ملف xml لقراءة مجلدات المكونات لحزمها.

--max-async-wait-time -wt

الحد الأقصى لوقت الانتظار غير المتزامن بالدقائق. القيمة الافتراضية هي 60 دقيقة.

--packagetype -p

عند فك الحزم أو الاستخراج، استخدم لتحديد عملية مدارة مزدوجة وغير مدارة. عند التعبئة، استخدم لتحديد Managed أو Unmanaged من فك حزمة سابقة "كلاهما". يمكن أن يكون: "غير مدار" أو "مدار" أو "كلاهما". القيمة الافتراضية هي: "كلاهما".

--solution-folder -f

المسار إلى مجلد الحل المحلي غير المحزم: إما جذر ملف 'Other/Solution.xml' أو مجلد بملف .cdsproj.

فك حزمة حل pac

استخراج مكونات الحل من solution.zip إلى نظام الملفات المحلي (SolutionPackager).

مثال

pac solution unpack --zipfile C:\SampleSolution.zip --folder .\SampleSolutionUnpacked\.

المعلمات المطلوبة لفك حزمة الحل

--zipfile -z

المسار الكامل إلى ملف ZIP للحل

إلغاء حزم المعلمات الاختيارية للحل

--allowDelete -ad

إملاء ما إذا كانت عمليات الحذف قد تحدث. القيمة الافتراضية هي "false".

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

--allowWrite -aw

إملاء ما إذا كانت عمليات الكتابة قد تحدث. القيمة الافتراضية هي "false".

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

--clobber -c

تمكين إمكانية حذف الملفات التي تم وضع علامة للقراءة فقط عليها أو الكتابة فوقها. القيمة الافتراضية هي "false".

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

--disablePluginRemap -dpm

إعادة تعيين اسم نوع المكون الإضافي المؤهل بالكامل معطل. القيمة الافتراضية هي "false".

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

--errorlevel -e

الحد الأدنى لمستوى التسجيل لإخراج السجل [مطول|معلومات|تحذير|خطأ|إيقاف التشغيل]. القيمة الافتراضية هي "معلومات".

--folder -f

المسار إلى المجلد الجذر على نظام الملفات المحلي. عند فك الحزم أو الاستخراج، تتم كتابة هذا إلى. عند تعبئة هذا تتم القراءة منه.

--localize -loc

استخراج أو دمج جميع موارد السلسلة في ملفات .resx.

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

--log -l

المسار إلى ملف السجل.

--map -m

المسار الكامل إلى تعيين ملف xml لقراءة مجلدات المكونات لحزمها.

--packagetype -p

عند فك الحزم أو الاستخراج، استخدم لتحديد عملية مدارة مزدوجة وغير مدارة. عند التعبئة، استخدم لتحديد Managed أو Unmanaged من فك حزمة سابقة "كلاهما". يمكن أن يكون: "غير مدار" أو "مدار" أو "كلاهما". القيمة الافتراضية هي "غير مدار".

--singleComponent -sc

تنفيذ الإجراء فقط على نوع مكون واحد [WebResource|المكون الإضافي|سير العمل|بلا]. القيمة الافتراضية هي "بلا".

--sourceLoc -src

إنشاء ملف مورد قالب. صالح فقط عند الاستخراج. القيم المحتملة هي "تلقائي"، أو رمز اللغة للغة التي ترغب في تصديرها. يمكنك استخدام معرف رمز اللغة (LCID) أو تنسيقات التعليمات البرمجية للغة المنظمة الدولية للتوحيد القياسي (ISO). عند وجوده، يستخرج هذا موارد السلسلة من اللغة المحددة ك resx.محايد. إذا تم تحديد "auto" أو الشكل الطويل أو القصير فقط من مفتاح التبديل، يتم استخدام اللغة الأساسية للحل.

--useLcid -lcid

استخدم قيم معرف رمز اللغة (LCID) (1033) بدلا من رموز المنظمة الدولية للتوحيد القياسي (ISO) (en-US) لملفات اللغة.

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

--useUnmanagedFileForMissingManaged -same

استخدم نفس ملف مصدر XML عند العثور على حزمة لملف XML المدار وغير المدار فقط؛ ينطبق على AppModuleSiteMap وAppModuleMap وملفات FormXml.

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

ترقية حل pac

تطبيق ترقية الحل

مثال

pac solution upgrade --solution-name SampleSolution --async --max-async-wait-time 60

المعلمات المطلوبة لترقية الحل

--solution-name -sn

اسم الحل.

معلمات اختيارية لترقية الحل

--async -a

ترقيات الحل بشكل غير متزامن

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

--environment -env

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

--max-async-wait-time -wt

الحد الأقصى لوقت الانتظار غير المتزامن بالدقائق. القيمة الافتراضية هي 60 دقيقة.

إصدار حل pac

تحديث إصدار أو مراجعة الحل.

مثال

pac solution version --patchversion 2

pac solution version --strategy gittags

معلمات اختيارية لإصدار الحل

--buildversion -bv

إنشاء إصدار للحل.

ملاحظة: يجب أن تكون القيمة عددا صحيحا بقيمة 0 كحد أدنى.

--filename -fn

اسم ملف Tracker CSV لاستخدامه عند استخدام filetracking كإستراتيجية. القيمة الافتراضية هي 'ControlsStateVersionInfo.csv'.

--patchversion -pv

مهمل: يتم تجاهل هذه المعلمة.

--revisionversion -rv

إصدار المراجعة للحل.

ملاحظة: يجب أن تكون القيمة عددا صحيحا بقيمة 0 كحد أدنى.

--solutionPath -sp

المسار إلى دليل حل Dataverse أو ملف Solution.xml.

--strategy -s

تحديث إصدار النسخة لملف 'Solution.xml' باستخدام استراتيجية محددة. إذا كنت تستخدم gittags، فقم بتعيين الرمز المميز للوصول الشخصي في متغير البيئة التالي "PacCli.PAT"

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

• None
• GitTags
• FileTracking
• Solution

الاختلافات بين استنساخ حل pac وتصديره

هناك حالات لا تكون فيها متأكدا من وقت الاستخدام pac solution clone أو pac solution export الأمر. يمكنك استخدام أحد الأوامر في السيناريوهات التالية:

• استخدم pac solution clone عندما تحتاج إلى إضافة مكونات جديدة إلى الحل.
• استخدم pac solution export عندما تريد تعديل المحتوى الموجود في ملف حل ولكن دون إضافة أي مكونات جديدة إلى الحل.

استنساخ حل pac

يبدو الحل المصدر مثل مشروع Visual Studio عند تصدير الحل باستخدام pac solution clone الأمر . بدلا من .csproj (كما في Visual Studio)، سترى ملفا cdsproj . يحتوي cdsproj الملف على جميع معلومات المكونات المطلوبة لإنشاء المشروع. إخراج البناء هو ملف مضغوط للحل، والذي يمكنك استيراده إلى بيئات مختلفة.

لا يتعين على المطور فك حزمة الحل المستنسخ لأنه يتم عرضه بتنسيق غير معبأة داخل المجلد src (المصدر).

الآن، إذا كنت ترغب في إقران مكون إضافي تم إنشاؤه حديثا بهذا الحل، مع فك حزمة الحل، يمكنك استخدام pac solution add-reference الأمر لتحديث .cdsproj الملف لإضافة المكون الإضافي الجديد. بعد ذلك، يمكنك إنشاء المشروع باستخدام إما dotnet build أو msbuild.

يوصى بإجراء استعادة بناء أولا قبل إنشاء المشروع. استعادة البنية (تقوم بنية dotnet بالاستعادة تلقائيا أولا) ستستعيد مكتبات .NET المطلوبة لإنشاء حل معبأة.

تصدير حل pac

عند تصدير الحل باستخدام pac solution export تشعر وكأنك تقوم بتصدير الحل باستخدام مدخل صانع، والإخراج الناتج هو ملف مضغوط للحل.

عند فك حزمة الملف المضغوط للحل (لا نوصي بفتح الرمز البريدي باستخدام أدوات قياسية واستخدام الأمر المناسب من CLI). بنية الدليل الناتجة مشابهة للبنية في pac solution clone. الفرق الوحيد هو أنه لا يمكنك إضافة مراجع إلى هذا الحل غير المحزم، لأنه لا يحتوي على .cdsproj ملف المشروع.

يمكنك تعديل مجموعة الملفات ذات الصلة التي تريد تحديثها ثم المتابعة مع حزمة الحل، والتي تنشئ ملف مضغوط الحل مرة أخرى لتسهيل استيراد الحل إلى البيئة المستهدفة. النتيجة من الإجراء هي ملف مضغوط للحل مع محتويات محدثة وطوابع زمنية محدثة.

(راجع أيضًا )

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