Andrew Hanna

Andrew Hanna

الـUnmanaged Package في Salesforce: ما هي وكيف تنتقل منها

الـUnmanaged Package في Salesforce: ما هي وكيف تنتقل منها

باختصار: الـUnmanaged Package في Salesforce حزمة metadata من الجيل الأول تثبّتها مرة واحدة ثم تملكها بالكامل: كل مكوّن يصبح قابلًا للتعديل في الـorg المستهدف، ومن غير namespace ولا حماية للملكية الفكرية ولا مسار ترقية. هي الأداة الصحيحة للقوالب وتطبيقات الأمثلة وعمليات النقل لمرة واحدة. أما أي شيء تنوي صيانته، فانقله إلى Unlocked Package.

ما هي الـUnmanaged Package في Salesforce؟

الـUnmanaged Package وسيلة توزيع لمرة واحدة. تجمع مكونات مثل الـcustom objects والحقول وكلاسات Apex والـflows والـlayouts والتقارير، وترفعها من packaging org، ثم تشارك رابط تثبيت. وعند التثبيت تُفك المحتويات داخل الـorg المستهدف وتتصرف كأن الـadmin بناها هناك بنفسه.

ودي هي المعادلة كلها. اللي بيثبّت ياخد تحكم كامل، والناشر يتنازل عن أي طريقة لدفع إصلاحات لاحقًا. ولمقارنة النموذجين جنبًا إلى جنب، راجع الفرق بين الـManaged والـUnmanaged Packages في Salesforce.

متى تستخدم Unmanaged Package؟

  • القوالب وحزم البداية التي يُتوقع من المثبّت أن ينسخها ويعدّلها.
  • تطبيقات الأمثلة والتطبيقات مفتوحة المصدر، حيث يكون وضوح الكود هو الهدف.
  • النقل لمرة واحدة لمجموعة metadata بين orgs غير مرتبطة ببعض.
  • مسرّعات المشاريع الاستشارية، مثل كائنات وتقارير وpermission sets يكيّفها العميل على طريقة شغله.

لو كلمات زي إصدار أو ترقية أو subscriber موجودة في خطتك، فالـUnmanaged Package اختيار غلط.

كيف تنشئ وتثبّت Unmanaged Package؟

  1. في الـorg المصدر، افتح Setup وابحث عن Package Manager في Quick Find.
  2. أنشئ package جديدة باسم واضح، واتركها من غير namespace.
  3. أضف المكونات من تبويب Components. Salesforce يضيف كثيرًا من المكونات المعتمدة تلقائيًا، فراجع القائمة قبل الرفع.
  4. اضغط Upload. عند نجاح الرفع، يرسل لك Salesforce بريدًا فيه رابط التثبيت.
  5. افتح الرابط وأنت مسجّل الدخول في الـorg المستهدف (الـsandboxes تستخدم نطاق تسجيل الدخول الخاص بالاختبار)، واختر من يحصل على الوصول، ثم ثبّت.
  6. اختبر في sandbox أولًا. المكونات المثبّتة قد تتعارض مع metadata موجودة بنفس الاسم.

ما حدود الـUnmanaged Packages؟

  • لا ترقيات. لا يمكنك تثبيت إصدار جديد فوق القديم. الحل إلغاء التثبيت ثم التثبيت من جديد.
  • إلغاء التثبيت يحذف البيانات. إزالة الحزمة تزيل الـcustom objects والحقول الخاصة بها، ومعها السجلات اللي جواها.
  • لا حماية للملكية الفكرية. كل الـApex والمعادلات والمنطق ظاهر وقابل للتعديل في الـorg المثبّت.
  • لا namespace. المكونات تنزل في الـnamespace الافتراضي، فتعارض الأسماء مع الـmetadata الموجودة مسؤوليتك أنت.
  • حدود الـorg تنطبق. الـcustom objects والحقول والتبويبات المثبّتة تُحسب ضمن حدود إصدار الـorg المثبّت.
  • لا تتبّع للتغييرات. بعد التثبيت لا شيء يربط المكونات بإصدار، فالانحراف يبقى غير مرئي إلا لو تتبعته في نظام التحكم في الإصدارات.

قاعدة إلغاء التثبيت من أجل الترقية هي المكان الذي تخسر فيه الفرق بياناتها. قبل أن تزيل حزمة مثبّتة، احفظ حالة سليمة معروفة. في Serpent، واجهة Backups تفعل ذلك بالضبط، وتسترجع الـmetadata والسجلات المدعومة في الـorg، وتحتفظ بسجل Restore History. وهي مكمّلة للـrollback، والبيانات المحذوفة بالفعل يظل استرجاعها بنظافة أصعب، فاعمل backup الأول. الخطوات في دليل النسخ الاحتياطي والاستعادة.

كيف تنقل Unmanaged Package إلى Unlocked Package؟

ده الجزء اللي معظم الأدلة بتسيبه. لا يوجد تحويل مباشر في المكان، فأنت تعيد بناء الحزمة من الـsource:

  1. اجرد المكونات. اعمل قائمة بما ثبّتته الـUnmanaged Package وما تم تعديله بعد ذلك.
  2. استرجعها إلى الـsource. اكتب ملف package.xml لهذه المكونات وشغّل sf project retrieve start --manifest package.xml --target-org source. دليلنا لـSalesforce CLI يشرح الإعداد.
  3. اعمل commit في Git. من هنا يصبح نظام التحكم في الإصدارات هو مصدر الحقيقة.
  4. قسّم حسب الاعتماديات. لو الحزمة تخلط نموذج بيانات مشترك مع features، افصلهم في حزمة أساس وحزم features. القواعد موجودة في حل الاعتماديات بين الحزم.
  5. أنشئ الـUnlocked Package. شغّل sf package create --package-type Unlocked --path force-app على الـDev Hub، ثم أنشئ إصدارًا بـsf package version create --code-coverage. الـApex يحتاج تغطية 75% على الأقل قبل الترقية.
  6. جرّب في sandbox ببيانات واقعية قبل ما تلمس الإنتاج.

للخطوة 6، يملأ Serpent بيانات نموذجية أو مُقنّعة أثناء إعداد البيئات وفي الـrelease pipelines، فترجع الـscratch orgs والـsandboxes المحدّثة ومعها بيانات من غير script يدوي. ولو بتبني لـAppExchange، فالوجهة هي Managed 2GP Package؛ اقرأ أسرار الـSecond-Generation Managed Package قبل البدء.

Unmanaged أم Unlocked أم Managed: أيهم يناسبك؟

  • Unmanaged: نسخة لمرة واحدة، قابلة للتعديل، بلا ترقيات. للقوالب والأمثلة.
  • Unlocked (2GP): تُبنى من الـsource، مرقّمة بإصدارات، قابلة للترقية، والـnamespace اختياري. للتطبيقات الداخلية.
  • Managed (2GP): لها namespace، ومحمية الملكية الفكرية، وقابلة للترقية. لتطبيقات AppExchange التجارية.

دعم تطوير الحزم في Serpent يبني ويرقّم ويشحن حزم 1GP و2GP والـManaged على كل الخطط، ويرسم الاعتماديات حتى تظهر تعارضات الإصدارات قبل أن يراها الـorg المستهدف. ومزيد من الأدلة العملية تجده في SF Guides.

FAQ

هل يمكن ترقية Unmanaged Package؟

لا. يجب إلغاء تثبيت الإصدار القديم وتثبيت الجديد، وده بيحذف البيانات في الـcustom objects والحقول الخاصة بها.

هل للـUnmanaged Packages namespace؟

لا. المكونات تُثبّت في الـnamespace الافتراضي، ولهذا يمكن أن تتعارض الأسماء.

هل أقدر أعرض Unmanaged Package على AppExchange؟

لا. التوزيع التجاري على AppExchange يستخدم الـManaged Packages، التي تحمل namespace وتمر بمراجعة الأمان.

هل أقدر أحوّل Unmanaged Package إلى Unlocked Package؟

ليس في نفس المكان. استرجع الـmetadata إلى نظام التحكم في الإصدارات، ثم أنشئ منها Unlocked Package جديدة.

مقالات ذات صلة

هل تريد معرفة كيف يمكنكم الشحن أسرع قبل البدء؟ لنتحدث

بدون التزام.