قائمة Salesforce Apex List هي بنية بيانات تساعد على تحميل المزيد من البيانات في وقت واحد في قاعدة بيانات Salesforce. في هذه المقالة ، سنناقش مجموعة 'List' في لغة برمجة Apex وطرقها. بصرف النظر عن ذلك ، سنناقش أيضًا كيفية إدراج البيانات في كائنات Salesforce باستخدام القائمة في قسم التطبيقات باستخدام عبارة insert DML.
تقديم Salesforce
كما نعلم ، فإن Salesforce هي شركة قائمة على الويب ومنصة OneCRM تقدم البرامج كخدمة. يومًا بعد يوم ، تزيد Salesforce إنتاجيتها من خلال الحفاظ على العلاقات مع العملاء. يمكننا أن نطلق على Salesforce سحابة تخزن البيانات فيها وتزودنا بالتلاعب بطريقة أفضل. مثل الأنظمة الأساسية السحابية الأخرى ، تقدم لنا Salesforce أيضًا لغة تتواصل بسهولة مع العملاء وفريق المبيعات والتي تُعرف باسم 'Apex'. دعونا نناقش حول Apex أولا.
ذروة
Apex هي لغة البرمجة التي يتم كتابتها بقوة وتدعم المفاهيم الموجهة للكائنات. بناء الجملة الخاص به أقرب إلى Java ويدعم العبارات الشرطية وهياكل التحكم والمتغيرات وأنواع البيانات الأخرى التي تشبه Java. يحتفظ Apex أيضًا بإجراءات مخزنة مثل SQL. وهو يدعم ثلاث مجموعات - 'قائمة' و 'خريطة' و 'تعيين'.
القائمة والطرق
في الأساس ، 'List' عبارة عن مجموعة تشبه المصفوفة في لغات البرمجة الأخرى التي تخزن العناصر / العناصر بطريقة متسلسلة. يمكنه أيضًا تخزين كائنات Salesforce (sObjects) مثل 'الحساب' و 'جهة الاتصال' و 'الفرصة' وكائنات 'أخرى مخصصة'. من الممكن أن تتكرر القوائم والعناصر المتداخلة في القائمة.
قبل البدء بـ 'قائمة' ، نحتاج إلى بيئة رمز حتى يتم تنفيذ أكوادنا.
للقيام بذلك ، دعنا نسجل الدخول إلى حساب Salesforce عن طريق كتابة عنوان URL التالي في متصفحك: https://login.salesforce.com/ . (إذا لم يكن لديك حساب يمكنك التسجيل بفتح نفس الرابط)
خطوات:
1. انتقل إلى اليمين بجوار ملف التعريف الخاص بك. انقر فوق رمز الترس.
2. انقر على 'Developer Console' أسفل 'إعداد الخدمة'. على الفور ، يتم فتح نافذة جديدة يمكن أن نشير إليها باسم 'وحدة التحكم'.
3. انقر فوق 'تصحيح' واختر 'فتح نافذة تنفيذ مجهول'.
4. سيتم فتح محرر يستخدم لتنفيذ فئات وبيانات Apex الفورية.
5. بعد كتابة الكود ، يمكننا تحديد عبارات Apex التي نريد تنفيذها والنقر على زر 'تنفيذ التمييز'. إذا كنت تريد تنفيذ التعليمات البرمجية بالكامل ، فما عليك سوى النقر فوق 'تنفيذ'.
6. تأكد من تحديد خانة الاختيار 'فتح السجل' لفتح السجل. لا يمكنك رؤية السجل إلا عن طريق اختياره.
لنعرض رسالة 'مرحبًا' باستخدام الأمر التالي:
system.debug ('Hello Linuxhint') ؛7. أخيرًا ، تحقق من 'تصحيح الأخطاء فقط' لرؤية إخراج الكود الحالي فقط.
إنشاء القائمة
من خلال تحديد نوع البيانات مع اسم الكائن ، يمكن إنشاء 'القائمة'. هنا ، يتم استخدام كلمة رئيسية جديدة لإنشائها. يمكن أن يكون الأمر اختياريًا لتمرير العناصر أثناء الإنشاء.
بناء الجملة:
قائمة1. List.add ()
باستخدام هذه الطريقة ، يمكننا إضافة عنصر مباشرةً في المرة الواحدة إلى كائن القائمة.
يمكن أيضًا إضافة عنصر في موضع فهرس معين عن طريق تحديد الفهرس كمعامل أول وعنصر لإضافته كمعامل ثاني.
بناء الجملة:
list_object.add (عنصر)list_object.add (index_position، element)
مثال:
لنقم بإنشاء قائمة مكونة من 3 عناصر وإضافة بعض العناصر واحدًا تلو الآخر باستخدام طريقة add ().
// إنشاء قائمة - أثاث يحتوي على 3 عناصر.قائمة
system.debug ('العناصر الفعلية:') ؛
system.debug (أثاث) ؛
// أضف 3 عناصر واحدًا تلو الآخر باستخدام طريقة add ().
furniture.add ('خشب') ؛
furniture.add (2 ، 'لوحات') ؛
furniture.add (2 ، 'سرير') ؛
system.debug ('العناصر النهائية:') ؛
system.debug (أثاث) ؛
انتاج:
أولا نضيف 'خشب'. ثم نضيف 'لوحات' في موضع الفهرس الثاني. نضيف أيضًا 'سرير' في الموضع الثاني. أخيرًا ، تحتوي القائمة على العناصر بالترتيب التالي: [طاولة ، كراسي ، أسرّة ، أطباق ، أخرى ، خشب].
2. List.addAll ()
تضيف الطريقة السابقة عنصرًا واحدًا فقط في كل مرة إلى كائن القائمة. باستخدام هذه الطريقة ، يمكننا إضافة عناصر متعددة من قائمة واحدة إلى القائمة الجديدة. يمكن أيضًا إضافة عنصر في موضع فهرس معين عن طريق تحديد الفهرس كمعامل أول وإضافة عنصر كمعامل ثاني. تأكد من أن كلتا القائمتين من نفس النوع.
بناء الجملة:
list_object.addAll (list_object_another)هنا ، list_object هي قائمتنا الفعلية و list_object_another هي القائمة التي ستحتوي على بعض العناصر التي سيتم إضافتها إلى list_object.
مثال:
على غرار المثال الأول ، قم بإنشاء قائمة أخرى وهي 'furniture2' وقم بتمرير القائمة الأولى وهي 'furniture1'.
// إنشاء قائمة - أثاث 1 مع 3 عناصر.قائمة
system.debug ('List-1:') ؛
system.debug (furniture1) ؛
// إنشاء قائمة فارغة - أثاث 2.
قائمة
system.debug ('القائمة الفعلية 2:') ؛
system.debug (furniture2) ؛
// أضف عناصر من furniture1 إلى furniture2 باستخدام addAll ().
furniture2.addAll (أثاث 1) ؛
system.debug ('Final List-2:') ؛
system.debug (furniture2) ؛
انتاج:
تحتوي القائمة الأولى (أثاث 1) على ثلاثة عناصر بينما القائمة الثانية (أثاث 2) فارغة. نضيف جميع العناصر من 'furniture1' إلى 'furniture2'. أخيرًا ، تحتوي القائمة 2 (furniture2) على 3 عناصر مماثلة لـ 'furniture1'.
3. List.size ()
في بعض السيناريوهات ، نحتاج إلى معرفة إجمالي العناصر الموجودة في قائمة Apex. الحجم () هو الطريقة التي تُرجع إجمالي العناصر الموجودة في القائمة. المعلمات ليست ضرورية لهذه الطريقة.
بناء الجملة:
list_object.size ()مثال:
قم بإنشاء قائمة Apex مع بعض كميات الطلبات وأعد الحجم.
// إنشاء قائمة - سعر 5 كميات.قائمة
system.debug ('List:') ؛
system.debug (أوامر) ؛
// إرجاع حجم القائمة.
system.debug ('إجمالي الطلبات:') ؛
system.debug (orders.size ()) ؛
انتاج:
هناك 5 طلبات في قائمتنا.
4. List.get ()
الوصول إلى العناصر من القائمة مهم للغاية. للقيام بذلك ، تدعم قائمة Apex طريقة get () التي تُرجع العنصر بناءً على موضع الفهرس. تبدأ الفهرسة من 0. إذا لم يكن الفهرس موجودًا ، فسيؤدي ذلك إلى ظهور الخطأ التالي:
بناء الجملة:
list_object.get (index_position)مثال:
قم بإنشاء قائمة Apex مع بعض كميات الطلبات وأعد بعض العناصر.
// إنشاء قائمة - سعر 5 كميات.قائمة
system.debug ('List:') ؛
system.debug (أوامر) ؛
// get () طريقة
system.debug ('First Order:' + orders.get (0)) ؛
system.debug ('الترتيب الرابع:' + orders.get (3)) ؛
انتاج:
هناك 5 طلبات في قائمتنا. أولاً ، نصل إلى العنصر الموجود في الفهرس 0 ، أي 900. ثم نصل إلى العنصر الموجود في الفهرس 3 ، أي 600.
5. List.isEmpty ()
يمكننا التحقق مما إذا كانت القائمة فارغة أم لا باستخدام طريقة isEmpty (). يتم إرجاع True إذا كانت قائمة Apex فارغة. خلاف ذلك ، يتم إرجاع خطأ. على غرار طريقة size () ، لن يستغرق الأمر أي معلمة.
بناء الجملة:
list_object.is فارغة ()مثال:
تحقق مما إذا كانت القائمة فارغة أم لا عن طريق إنشاء قائمة فارغة.
// إنشاء قائمة - سعر 5 كميات.قائمة أوامر
// طريقة () isEmpty
system.debug ('هل القائمة فارغة:' + orders.isEmpty ()) ؛
انتاج:
يتم إرجاع True لأن القائمة فارغة.
6. List.clear ()
يمكن حذف جميع العناصر الموجودة في قائمة Apex في وقت واحد باستخدام طريقة clear (). لن يتطلب الأمر أي معلمات.
بناء الجملة:
list_object.clear ()مثال:
قم بإزالة جميع العناصر من القائمة التي تحتوي على 5 أسماء طلاب.
// إنشاء قائمة - الطلابقائمة
system.debug ('القائمة:' + الطلاب) ؛
// clear () طريقة
الطلاب. واضح () ؛
system.debug ('القائمة:' + الطلاب) ؛
انتاج:
بعد تطبيق طريقة clear () ، تكون قائمة 'الطلاب' فارغة.
قائمة التطبيقات
1. sObject
يمكننا إدخال البيانات في كائنات Salesforce القياسية مثل 'الحساب' و 'جهة الاتصال' وما إلى ذلك. في هذا السيناريو ، نحتاج إلى توفير اسم sObject بدلاً من نوع بيانات القائمة.
دعونا نلقي نظرة على هذا المثال: هنا ، نقوم بإنشاء قائمة بنوع sObject كـ 'Account'. نضيف الاسم إليه ونضيفه إلى القائمة.
2. عملية DML
يمكننا استخدام القوائم لتخزين السجلات التي تم إدراجها في بيانات Salesforce. باستخدام عبارات الإدراج ، يمكننا إدراج السجل / السجلات في قاعدة بيانات Salesforce.
انظر إلى الكود التالي. نضيف فقط بيان إدراج هنا:
دعونا نتحقق مما إذا تم إنشاء السجل أم لا.
- انتقل إلى 'مشغل التطبيقات' وابحث عن 'الحسابات'.
- سيتم فتح صفحة تفاصيل 'سجل الحساب'. الآن ، ابحث عن حساب 'Linuxhint'.
- انقر فوق 'اسم الحساب'. يمكنك رؤية التفاصيل هنا.
خاتمة
وصلنا الآن إلى نهاية دليلنا. كجزء من هذا الدليل ، ناقشنا منصة Salesforce و Apex. القائمة هي إحدى المجموعات التي تدعمها لغة برمجة Apex. بعد ذلك ، تعلمنا الطرق التي يدعمها 'List' جنبًا إلى جنب مع الأمثلة وبناء الجملة. انتهينا من هذا الدليل من خلال مناقشة تطبيقات مجموعة 'القائمة' مع أمثلة.