إدارة دورة حياة تطبيق شريط الأوامر

مكتمل

عندما تقوم بتخصيص شريط أوامر في تطبيق يستند إلى نموذج من Power Apps، تتعقب حلول Microsoft Dataverse تخصيصاتك. تمثل حلول Dataverse طريقة نقل تخصيصات شريط الأوامر والتطبيق ومكونات الحلول ذات الصلة من بيئة Power Platform إلى أخرى، مثل بين التطوير إلى الاختبار إلى الإنتاج.

عند إنشاء أول أمر لك من مصمم شريط الأوامر، ستختار نوع الأمر الذي سيحدد ما إذا كانت مكتبة المكونات مطلوبة أم لا. مكتبة المكونات ضرورية إذا كنت تستخدم منطق Power Fx للرؤية أو OnSelect للأمر. فيما يلي مربع الحوار الذي يسمح لك باختيار Power Fx أو JavaScript لمنطق الأوامر الخاص بك.

لقطة شاشة لاختيار نوع الأمر.

لا تحتاج إلى مكتبة مكونات إذا كنت تستخدم JavaScript فقط. ومع ذلك، وعن طريق تحديد تشغيل الصيغة أو إظهار بشرط من الصيغة في لوحة خصائص الأمر، يمكنك إنشاء مكتبة مكونات في أي وقت لاستخدام Power Fx. عند إجراء هذا التغيير، سترى مطالبة بإنشاء مكتبة المكونات.

عادةً ما يكون إنشاء حل مخصص لتطبيقك والأصول ذات الصلة هو الأفضل. إذا كان تطبيقك موجوداً في أحد حلول Dataverse المخصصة، فستكون مكتبة المكونات أيضاً في نفس الحل. بخلاف ذلك، سيكون تطبيقك ومكتبة المكونات في الحل الافتراضي من Common Data Services. سيستخدم اسم مكتبة المكون اسم التطبيق الخاص بك بالإضافة إلى DefaultCommandLibrary. يعرض ما يلي حلاً مع جدول وتطبيق ومكتبة مكونات.

لقطة شاشة لمكتبة المكونات في الحل.

إذا قمت بتخصيص شريط الأوامر في تطبيقات متعددة واستخدمته Power Fx، فسيكون لكل منها مكتبة مكونات مقابلة.

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

يمكنك التحقق من طبقات الحلول إذا كنت لا ترى أحدث التغييرات التي تم إجراؤها على أمر شريط الأوامر، وذلك لمعرفة ما إذا كان قد تم إجراء تغيير غير مُدار ويمنع ظهور أحدث إصدار لديك. لإنجاز ذلك، حدد مكتبة المكونات في مستكشف الحلول وحدد "متقدم > راجع طبقات الحلول". فيما يلي مثال لمكتبة مكونات حيث تم إجراء تحديث أعلى الحل المُدار.

لقطة شاشة لطبقات الحلول.

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

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

لقطة شاشة لخيار قائمة الخصائص المدارة.

يسمح لك إعداد الخاصية المدارة بتعطيل التخصيص لمكتبة المكونات.

لقطة شاشة لخاصية السماح بالتخصيصات.

يؤدي تعطيل التخصيصات إلى منع تخصيص الصيغ من أجل Visibility وOnSelect ولكنه لا يمنع التغييرات على خصائص الأوامر الأخرى مثل Display Label. عند التمكين، يصبح ساري المفعول فقط بعد تصدير الحل الخاص بك على أنه مدار واستيراده إلى بيئة أخرى. سيتم منعك وسترى الخطأ التالي إذا حاولت تعديله بعد استيراده على أنه مُدار.

لقطة شاشة لرسالة مكتبة المكونات التي فشلت في حفظها.

دعم الترجمة

قد ترغب في ترجمة تسمياتها إلى لغات أخرى بعد تخصيص شريط الأوامر لإضافة أوامر. اتبع الخطوات التالية لتوفير ترجمات للأوامر:

  • من مستكشف الحلول، حدد الترجمات > تصدير الترجمات.

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

  • استخراج ملف XML من ملف مضغوط (بصيغة .zip).

  • افتح ملف CrmTranslations.xml بتنسيق Excel.

  • حدد الورقة باسم Localized Labels.

في ورقة التسميات المترجمة، قم بالتمرير لأسفل إلى حيث يحتوي اسم "الكيان" على "appaction". قد يحتوي كل أمر في شريط الأوامر على أسطر متعددة تمثل كل خاصية من الخصائص مثل النص وتلميح الأدوات والوصف. لكل زر، قدم الترجمات كما هو موضح أدناه في عمود ورقة العمل 1034 (الإسبانية).

لقطة شاشة لملف الترجمة.

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

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