ما هو Salesforce CLI؟ كيف يتم تثبيته على نظامي Mac و Windows؟

Salesforce CLI - مُحسِّن إنتاجية للمطورين

يعد Salesforce CLI أداة قوية للمسؤولين أيضًا ، وليست مفيدة للمطورين فقط. يمكنك استخدامه لإنشاء المؤسسات وإدارتها ، وإنشاء الحزم وتثبيتها ، ومزامنة المصادر من وإلى المؤسسات ، والمزيد.

هذه التفاصيل ليست كافية للتعرف على Salesforce CLI.

ستساعدك هذه المقالة في فهم Salesforce CLI ، وخطوات التثبيت على الأجهزة المختلفة ، وحالات استخدامها ، وكيفية استخدامها ، وغير ذلك الكثير.

ما هو Salesforce CLI؟

أثناء العمل مع Salesforce org (حاوية البيانات الكاملة لعملاء Salesforce) ، فإن واجهة سطر الأوامر التي تسهل التطوير والأتمتة الحرفية هي Salesforce CLI. يُعرف Salesforce CLI أيضًا بتسريع عملية التطوير للمسؤولين والمطورين. إنها أداة مجانية مفتوحة المصدر لتطبيق Salesforce تعمل على تسهيل المهام وأتمتتها عبر النظام الأساسي.

حسنًا ، قد يعرف خبير التكنولوجيا عن CLI ، لكن المستخدمين غير التقنيين سيجدونه محيرًا.

ببساطة ، واجهة سطر الأوامر هي واجهة نصية لتطوير برنامج.

يجب عليك إدخال الأوامر باستخدام محطة والتفاعل مع البرنامج لاستخدام CLI. على جهاز Mac ، ستكون Terminal ، وفي Windows ، ستكون مجرد Windows Terminal.

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

يسهل CLI أتمتة أي وظائف متكررة. على الرغم من أن منحنى التعلم لهذه الواجهة أكثر حدة لأن المطالبات المرئية غير موجودة.

قم بتثبيت Salesforce CLI

على حاسوبك؛ يمكنك تثبيت CLI باستخدام الأدوات الخاصة بنظام التشغيل.

يمكنك اختيار طريقة واحدة مذكورة أدناه على جهاز الكمبيوتر الخاص بك.

1. قم بتثبيت CLI على نظام macOS

يمكنك تثبيت Salesforce CLI على macOS باستخدام ملف .pkg.

الخطوات لمتابعة:

• قم بتنزيل ملف .pkg .
• قم بتشغيل ملف .pkg ، مثل النقر المزدوج عليه من Finder ، والرد على جميع المطالبات. (ينتهي التثبيت هنا.)
• بعد ذلك ، أعد تشغيل IDEs أو النوافذ الطرفية للتأكد من توفر ملفات Salesforce CLI التنفيذية الآن.

ملاحظة: يقوم مثبت macOS بتثبيت الملفين التنفيذيين sfdx و sf.

2. قم بتثبيت CLI على Windows

يمكنك تثبيت Salesforce CLI على Windows باستخدام ملف exe.

الخطوات لمتابعة:

• قم بتنزيل ملف exe .
• قم بتشغيل ملف exe. ، مثل النقر فوقه نقرًا مزدوجًا من مستكشف Windows ، والرد على جميع المطالبات. (ينتهي التثبيت هنا.)
• بعد ذلك ، أعد تشغيل نوافذ PowerShell أو موجهات الأوامر أو IDEs للتأكد من توفر ملفات Salesforce CLI التنفيذية الآن.

ملاحظة: يقوم مثبت Windows بتثبيت الملفين التنفيذيين sfdx و sf.

تحذير من Salesforce

يؤدي Salesforce CLI أفضل أداء في موجه أوامر Windows الأصلي (cmd.exe) و Microsoft Windows PowerShell. لا يُنصح باستخدام Salesforce CLI مع محاكي طرفي Linux ، مثل نظام Windows 10 الفرعي لنظام Linux أو MinGW أو Cygwin ، نظرًا لأن دعم الأخطاء محدود.

3. قم بتثبيت CLI باستخدام ملف TAR

يقدم Salesforce CLI ملفات TAR التي يمكن للمرء تثبيتها على جميع أنظمة التشغيل المدعومة. على نظام Linux ، يمكنك تثبيت Salesforce CLI بطريقة واحدة فقط ، باستخدام ملف TAR.

يمكنك استخدام الجدول أدناه للظهور باستخدام عناوين URL غير المحوَّلة لملف TAR (.tar.xz أو .tar.gz) لنظام التشغيل لديك. عندما تصدر Salesforce إصدارًا جديدًا من Salesforce CLI كل أسبوع ، فإنها تقوم أيضًا بتحديث عناوين URL هذه. بهذه الطريقة ، يكونون جاهزين دائمًا بأحدث إصدار.

تعد عناوين URL العامة هي الأفضل تحديدًا لحالات استخدام CLI.

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

4. قم بتثبيت CLI مع npm

يمكنك استخدام npm لتثبيت Salesforce CLI إذا كنت قد قمت بالفعل بتثبيت Node.js على جهاز الكمبيوتر الخاص بك. ستتيح لك هذه الطريقة تثبيت Salesforce CLI من سطر الأوامر ويمكن أن تكون مفيدة بشكل خاص لحالات استخدام التكامل المستمر (CI).

يمكنك اتباع هذه الطريقة لتثبيت CLI إذا:

• ليس لديك أذونات المسؤول على محطة العمل الخاصة بك أو
• يحظر نهج المجموعة تثبيت CLI والتحديثات.

لا يحتاج تثبيت CLI باستخدام npm إلى أذونات الجذر.

الخطوات لمتابعة

تأكد من تثبيت إصدار الدعم طويل المدى من Node.js (Active LTS) على جهاز الكمبيوتر الخاص بك.

• لتثبيت إصدار LTS ، انتقل إلى

Noderjs.Org تنزيل

• يجري:

العقدة - الإصدار (للتحقق من رقم الإصدار الخاص بك)

• يجري:

 npm install sfdx-cli --global (to install the sfdx executable)

• يجري:

 npm install @salesforce/cli --global (to install the sf executable)

عند تثبيت CLI باستخدام npm ، إذا تلقيت خطأ في الإذن ، يوصى بعدم استخدام sudu.

5. تثبيت الإصدارات الأقدم من Salesforce CLI

من المستحسن أن تتمكن من استخدام مرشح إصدار Salesforce CLI أو أحدث إصدار.

من الواضح أنك قد تحتاج أحيانًا إلى إصدار أقدم من CLI. لذلك ، من أجل ذلك ، تنشر Salesforce ملفات JSON التي تسرد عناوين URL للتنزيل لأحدث إصدارات المثبتات وملفات Tar لكل نظام تشغيل مدعوم.

كل أسبوع ، يضيف Salesforce إصدارًا تم إصداره مؤخرًا إلى القائمة ؛ يبقى الإصدار في القائمة لمدة 20 أسبوعًا تقريبًا. يحتفظون بملفات TAR والمثبت لمدة لا تقل عن 40 أسبوعًا.

ملاحظة: سيحتفظ Salesforce بكل إصدار قديم من حزمة sfdx-cli npm.

6. تحقق من التثبيت الخاص بك

للتحقق مما إذا كنت قد قمت بتثبيت تثبيت Salesforce CLI بشكل صحيح ، فأنت بحاجة إلى التحقق منه.

الخطوات لمتابعة

• قم بتشغيل الأمر أدناه للتحقق من الإصدار الذي قمت بتثبيته:

 sfdx --version sfdx-cli/7.144.0 darwin-x64 node-v16.14.2

• بعد ذلك ، قم بتشغيل الأمر أدناه لمعرفة المكونات الإضافية المثبتة وإصداراتها.

 sfdx plugins --core @oclif/plugin-autocomplete 0.3.0 (core) @oclif/plugin-commands 1.3.0 (core) @oclif/plugin-help 3.3.1 (core) @oclif/plugin-not-found 1.2.6 (core) @oclif/plugin-plugins 1.10.11 (core) @oclif/plugin-update 1.5.0 (core) @oclif/plugin-warn-if-update-available 2.0.4 (core) @oclif/plugin-which 1.0.4 (core) @salesforce/sfdx-plugin-lwc-test 0.1.7 (core) alias 1.2.1 (core) apex 0.11.0 (core) auth 1.8.1 (core) community 1.1.4 (core) config 1.3.23 (core) custom-metadata 1.0.12 (core) data 0.6.10 (core) generator 1.2.2 (core) info 1.3.1 (core) limits 1.3.0 (core) org 1.11.2 (core) salesforce-alm 54.0.2 (core) schema 1.1.0 (core) sfdx-cli 7.144.0 (core) source 1.9.0 (core) telemetry 1.4.0 (core) templates 54.3.0 (core) user 1.7.1 (core)

• قم بتشغيل الأمر أدناه لإظهار ملاحظات إصدار إصدار Salesforce CLI الحالي:

 sfdx whatsnew

استخدامات Salesforce CLI

يمكنك استخدام Salesforce CLI على النحو التالي:

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

3 طرق لاستخدام Salesforce CLI

دعنا نتحقق من بعض سيناريوهات الحياة الواقعية وحالات الاستخدام حيث يمكن للمرء استخدام CLI Salesforce لزيادة الكفاءة.

1. استرجاع ونشر البيانات الوصفية

لنأخذ سيناريو لفهمه بشكل أفضل.

افترض أنك مستشار Salesforce. لقد أنجزت مؤخرًا مشروعًا يتضمن إنشاء تدفق مرفق في شريط الأدوات. وكان الهدف هو تسهيل قيام المستخدمين النهائيين برفع القضايا وطلبات المساعدة بسرعة.

لقد أنجزت اختبار المستخدم ونشرته باستخدام مجموعات التغييرات من بيئة الاختبار إلى الإنتاج.

في وقت لاحق ، ظهر سيناريو مشابه في مشروع آخر بعد بضعة أسابيع مع بعض الاختلافات الدقيقة. على الرغم من إعادة تطوير نفس الميزة مرة أخرى ، فإنك تختار استخدام Salesforce CLI لتحفيز هذه الميزة من خلال نشر الحل المعروف الذي تم تجربته واختباره للمؤسسة السابقة قبل تغييره لتلبية متطلبات العميل المحددة.

2. استيراد وتصدير البيانات

في هذه الحالة ، لديك بيئة UAT تعمل على نسخة جزئية من sandbox.

لقد قمت بتطوير مجموعة مثالية من حسابات الاختبار والاتصال الذي تريد نقله من النسخة الجزئية إلى العديد من صناديق رمل التطوير الجديدة.

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

يمكنك تصدير البيانات ثم استيرادها إلى صناديق التطوير الخاصة بك. ولكن ، ستحتاج إلى الأداء باستخدام VLOOKUPS أو المعرفات الخارجية داخل Excel في كل مرة. إنها ليست قابلة للتطوير وليست سهلة أيضًا.

لذلك ، يمكنك استخدام Salesforce CLI لتسريع الأمور وجعلها قابلة للتطوير.

3. إنشاء Sandbox

يتضمن CLI ملف

 force:org:create command

يُستخدم لإنشاء مؤسسات خدش.

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

ملخص

نأمل أن تجد هذا المنشور مفيدًا للتعرف على Salesforce CLI واستخدامه لتبسيط وظائفك.

يمكنك التواصل مع مستشار Salesforce للحصول على مزيد من التفاصيل وتسريع عملية التطوير الخاصة بك.