إتقان تطوير Salesforce باستخدام Salesforce CLI

إعداد بيئة التطوير

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

إذا كنت تريد تبسيط تعقيدات هذه العمليات حتى تركز على الابتكار بدلا من إدارة العمليات، فلدينا الحل المناسب لك! 

ابدأ مجانا - دون بطاقة ائتمان وكن من المختارين لاستخدام Tekunda Serpent لتحويل سير عملك!

تثبيت Salesforce CLI

أولا، تحتاج إلى تثبيت Salesforce CLI. هذه الأداة أساسية للتفاعل مع Salesforce orgs، وإنشاء scratch orgs، وإدارة metadata.

1. تنزيل وتثبيت SF CLI:

   نزّل المثبّت من صفحة Salesforce CLI. اتبع تعليمات التثبيت الخاصة بنظام التشغيل لديك.

2. المصادقة مع Salesforce:

   بعد تثبيت CLI، صادق على Salesforce org باستخدام الأمر التالي:

   sf login

3. إعداد مشروع Salesforce DX:

   أنشئ مشروع Salesforce DX جديدا أو انتقل إلى مجلد مشروعك الحالي. ابدأ المشروع باستخدام:

   sf project create --name YourProjectName

إنشاء Scratch Org

Scratch orgs هي بيئات مؤقتة يمكنك استخدامها للتطوير والاختبار. يمكن أن تكون namespaced أو non-namespaced حسب متطلباتك.

1. تعريف إعداد Scratch Org:

   أنشئ ملف config/project-scratch-def.json داخل مجلد مشروعك بالإعدادات المطلوبة. مثال:

   {
     "orgName": "Demo Company",
     "edition": "Developer",
     "features": ["Communities", "ServiceCloud"],
     "settings": {
       "orgPreferenceSettings": {
         "s1DesktopEnabled": true,
         "selfSetPasswordInApi": true
       }
     }
   }

2. إنشاء Scratch Org:

   استخدم الأمر التالي لإنشاء scratch org:

   sf org create scratch --definitionfile config/project-scratch-def.json --setdefaultusername --durationdays 7 --alias YourScratchOrgAlias

العمل مع Namespaced Orgs

إذا كنت تطور managed package، فقد تحتاج إلى namespaced scratch org. تعد namespaced orgs مفيدة جدا لتطوير واختبار managed packages لأنها تسمح لك باختبار الكود في بيئة تشبه بيئة الإنتاج لديك بدرجة كبيرة. فيما يلي بعض حالات الاستخدام الشائعة لـ namespaced orgs:

1. عزل الكود: تساعد namespaced orgs على عزل الكود عن packages والتخصيصات الأخرى في بيئة Salesforce لديك. يضمن هذا العزل عدم وجود تعارضات بين الكود الخاص بك والحزم الأخرى.
2. اختبار Managed Packages: عند تطوير managed packages، من الضروري اختبارها في namespaced org لضمان تطبيق namespace الخاصة بالحزمة بشكل صحيح وعدم تداخلها مع كود أو packages أخرى.
3. الاتساق مع الإنتاج: تحاكي scratch orgs ذات namespace سلوك بيئة الإنتاج لديك، ما يوفر أرضية اختبار متسقة. يساعد هذا الاتساق في تحديد المشكلات المحتملة التي قد تظهر في الإنتاج.
4. الامتثال والأمان: باستخدام namespaced orgs، يمكنك إدارة جوانب الامتثال والأمان بشكل أفضل، والتأكد من أن managed packages لديك تلتزم بإرشادات أمان Salesforce.

تأكد من أن Dev Hub لديك لديه namespace مسجل، وأدرج namespace في تعريف scratch org.

نشر Metadata والكود

عندما تصبح scratch org جاهزة، يمكنك نشر metadata والكود. تتضمن هذه العملية دفع المصدر المحلي إلى scratch org وإعداد أي بيانات اختبار وأذونات لازمة.

النشر إلى Scratch Org

1. دفع المصدر إلى Scratch Org:

   انشر المصدر المحلي إلى scratch org باستخدام:

   sf project deploy start

2. تعيين Permission Sets:

   عيّن permission sets اللازمة للمستخدم لديك:

   sf org assign permset --name YourPermsetName

3. تحميل بيانات الاختبار:

   إذا كانت لديك بيانات اختبار، فحمّلها باستخدام SOQL queries أو عبر استيراد ملفات بيانات:

   sf data import tree --plan data/sample-data-plan.json

4. تثبيت الاعتماديات:

   إذا كان مشروعك يعتمد على managed packages، فثبتها باستخدام:

   sf package install --package YourPackageAliasOrId --wait 10

إذا كنت تريد تبسيط تعقيدات هذه العمليات حتى تركز على الابتكار بدلا من إدارة العمليات، فلدينا الحل المناسب لك! 

ابدأ مجانا - دون بطاقة ائتمان وكن من المختارين لاستخدام Tekunda Serpent لتحويل سير عملك!

إدارة التحكم في المصدر

يعد التحكم الفعال في المصدر ضروريا لتعاون الفريق وسلامة المشروع. Git هو نظام التحكم في المصدر الأكثر استخداما في تطوير Salesforce.

استخدام Git للتحكم في المصدر

1. تهيئة مستودع Git:

   إذا لم يكن مشروعك ضمن source control بالفعل، فابدأ مستودع Git:

   git init

2. إضافة التغييرات وتثبيتها:

   أضف تغييراتك إلى المستودع وثبّتها:

   git add .
   git commit -m "Initial commit"

3. إنشاء فروع للميزات:

   استخدم Git Flow لإدارة الفروع. أنشئ feature branch جديدا للتطوير:

   git checkout -b feature/new-feature

4. جلب التغييرات ودمجها:

   اجلب وادمج التغييرات من الفرع الرئيسي بانتظام لإبقاء feature branch محدثا:

   git fetch origin
   git merge origin/main

5. تثبيت التغييرات ودفعها:

   بعد تطوير الميزة، ثبّت تغييراتك وادفعها:

   git commit -m "Developed new feature"
   git push origin feature/new-feature

6. إنشاء Pull Requests:

   افتح pull request لدمج feature branch في الفرع الرئيسي. تأكد من مراجعة الكود والموافقة عليه من فريقك.

إدارة الإصدارات

بعد اكتمال التطوير والاختبار، يحين وقت إدارة الإصدارات. يمكن أن تختلف هذه العملية حسب ما إذا كنت تعمل مع non-packaged org أو managed package.

الإصدار إلى Non-Packaged Org

1. النشر إلى الإنتاج:

   انشر تغييراتك إلى production org باستخدام Salesforce CLI:

   sf project deploy start --target-org YourProductionOrgAlias

2. تشغيل الاختبارات:

   تأكد من نجاح كل الاختبارات قبل إكمال النشر:

   sf apex run test --target-org YourProductionOrgAlias

3. مراقبة النشر:

   استخدم Salesforce CLI لمراقبة حالة النشر:

   sf project deploy report --target-org YourProductionOrgAlias --job-id <yourDeploymentJobId>

إصدار Managed Package

1. إنشاء Managed Package:

   أنشئ package version جديدا باستخدام Salesforce CLI:

   sf package version create --package YourPackageAlias --installation-key YourKey --wait 10 --code-coverage

2. ترقية Package Version:

   قم بترقية package version لجعله متاحا للتثبيت:

   sf package version promote --package "YourPackageVersionId"

3. التقديم إلى Security Review:

   إذا كانت الحزمة ستُدرج في AppExchange، فقدمها إلى security review. تضمن هذه العملية التزام الحزمة بمعايير أمان Salesforce.

4. تثبيت Package:

   ثبّت managed package في production org:

   sf package install --package YourPackageVersionId --target-org YourProductionOrgAlias --wait 10

الخلاصة

يتضمن تطوير Salesforce باستخدام Salesforce CLI عدة خطوات، من إعداد بيئة التطوير إلى إدارة الإصدارات. من خلال استخدام scratch orgs، ونشر metadata والكود، والتعامل مع التحكم في المصدر، وإدارة الإصدارات بكفاءة، يمكنك تبسيط عملية تطوير Salesforce.

سواء كنت تطور لـ non-packaged org أو تنشئ managed package، توفر Salesforce CLI أوامر قوية لأتمتة وتبسيط سير عملك. باتباع أفضل الممارسات والحفاظ على source control فعال، يمكنك التأكد من أن مشاريعك مُدارة جيدا وجاهزة للنشر.

إذا كنت تريد تبسيط تعقيدات هذه العمليات حتى تركز على الابتكار بدلا من إدارة العمليات، فلدينا الحل المناسب لك! 

ابدأ مجانا - دون بطاقة ائتمان وكن من المختارين لاستخدام Tekunda Serpent لتحويل سير عملك!