تخطى إلى المحتوى
Home » المقالات » دليل المبتدئين لـ Salesforce Apex: الـ Conditional Statements

دليل المبتدئين لـ Salesforce Apex: الـ Conditional Statements

أهلاً يا مستكشفين Apex! النهارده هنتكلم عن الـ conditional statements في Apex، وهي نوع أساسي من الـ control flow statements. لو لسه بادئين، متقلقوش، هخلي رحلتنا مع if وelse if وswitch والـ ternary operator بسيطة وسهلة. وخليكم متابعين: النوع الكبير التاني، الـ loops، هنتكلم عنه في بوست جاي. يلا ندخل على عالم الـ conditional statements ونبدأ!

تخيّل مسارات القرار: فهم الـ Conditional Logic في Apex بالـ Flowcharts

بصوا على الـ flowchart اللي تحت. دي أول خطوة عشان نتخيل إزاي Apex بياخد القرارات. الرسمة بتوضح عملية بسيطة:

  • الكود بتاعكم بيسأل سؤال (Condition)،
  • وعلى حسب الإجابة ‘أيوه’ أو ‘لأ’ (true أو false)، بيقرر يمشي في أنهي طريق.

وده بالظبط نفس الطريقة اللي بنتعامل بيها مع الـ conditional statements في البوست ده: بتساعد الكود ياخد قرارات، زي ما إحنا بناخد قرارات كل يوم.

مثال على flowchart بسيط
مثال على Flowchart بسيط
Flowchart فيه اتنين conditions
Flowchart فيه اتنين conditions

فهم الـ Conditions والـ Logical Operators

قبل ما ندخل في تفاصيل الـ conditional statements زي if وelse if وswitch، مهم نفهم أساسيات الـ conditions والـ logical operators في Apex.

الـ Conditions: أساس اتخاذ القرار

في Apex، الـ condition هو expression بسيط نتيجته يا true يا false. الـ conditions دي هي العمود الفقري للـ conditional statements، لأنها بتحدد الكود هيمشي في أنهي طريق.

مثال على Condition بسيط:

Boolean isSunny = true;  // A basic condition set to true

الـ Logical Operators: إزاي نجمع الـ Conditions

الـ logical operators بتخليكم تجمعوا الـ conditions البسيطة دي عشان تعملوا conditions أعقد. فيه اتنين logical operators أساسيين هتستخدموهم:

AND (&&)OR (||)
بنستخدمه لما نكون عايزين كل الـ conditions تبقى true عشان النتيجة النهائية تبقى true.بنستخدمه لما نكون عايزين أي condition واحدة بس تبقى true عشان النتيجة النهائية تبقى true.
الـ Logical Operators

مثال على الـ Logical Operators:

Boolean isWeekend = true;
Boolean isHoliday = false;

// Using AND (&&)
Boolean isRelaxingDay = isWeekend && isHoliday; // Evaluates to false

// Using OR (||)
Boolean isTimeOff = isWeekend || isHoliday; // Evaluates to true

//print result
System.debug('isRelaxingDay: '+isRelaxingDay);
System.debug('isTimeOff: '+isTimeOff);
صورة بتوضح استخدام AND (&&) وOR (||) في Apex مع Boolean variables ونتيجتهم في الـ Salesforce Developer Console
صورة بتوضح استخدام AND (&&) وOR (||) في Apex مع Boolean variables ونتيجتهم في الـ Salesforce Developer Console

أهمية الأقواس في الـ Logical Expressions

بعد ما ترتاحوا مع الـ conditions والـ logical operators، مهم جداً تفهموا إزاي الأقواس ممكن تغير الـ logic بتاع الـ expressions في Apex.

ليه الأقواس مهمة؟

الأقواس في الـ logical expressions بتحدد ترتيب العمليات، زي بالظبط في الحساب. وهي أساسية في الـ conditions المعقدة اللي فيها أكتر من logical operator، عشان تضمن إن الـ expression يتحسب زي ما إنتو عايزين.

من غير أقواسبالأقواس
في Apex، الـ AND (&&) ليه أولوية أعلى من الـ OR (||). من غير أقواس، الـ conditions ممكن متتحسبش بالترتيب اللي إنتو متوقعينه.بالأقواس، تقدروا تحددوا بوضوح ترتيب حساب الـ conditions، فالـ logic يبقى أوضح وتتجنبوا نتايج مش مقصودة.
شرح فايدة استخدام الأقواس

مثال بيوضح استخدام الأقواس

Boolean condition1 = true; 
Boolean condition2 = true; 
Boolean condition3 = false; 

//Testing output without parantheses
/* Without parentheses, the condition is evaluated as follows:
   1. condition2(true) && condition3(false) first resulting in false
   2. condition1(true) || false resulting true value
*/
if (condition1 || condition2 && condition3) { 
	System.debug('Check 1 Condition is true.'); 
} else { 
	System.debug('Check 1 Condition is false.'); 
}

//Testing output with parantheses
/* With parentheses, the condition is evaluated as follows:
   1. condition1(true) && condition2(true) first resulting in true
   2. true && condition3(false) resulting false value
*/
if ((condition1 || condition2) && condition3) { 
	System.debug('Check 2 Condition is true.'); 
} else { 
	System.debug('Check 2 Condition is false.'); 
}
نتيجة استخدام الأقواس في الـ conditions في الـ Salesforce Developer Console
صورة بتوضح تأثير الأقواس على الـ condition ونتيجتها في الـ Salesforce Developer Console

افتكروا، فهم الـ conditions والـ operators دي هو المفتاح عشان تتقنوا الـ conditional statements في Apex، لأنها أساس اتخاذ القرار في الكود. ودلوقتي بعد ما عرفنا ده، يلا نرجع لموضوعنا الأساسي: الـ conditional statements.

1. فهم الـ “if” Statements

الـ if statement هي الأساس في اتخاذ القرار في Apex. بتخلي الكود يمشي في طرق مختلفة حسب conditions معينة.

الـ if statements مفيدة جداً لما تحتاجوا تتأكدوا من صحة الداتا (validation).

الـ Syntax

if (condition) { 
    // Code to execute if condition is true
}

مثال 1:

Integer score = 60;

//In this example, if the score is greater than 50, Apex prints 'You passed!'.
if (score > 50) {
    System.debug('You passed!');
}
نتيجة الـ if statement في الـ Salesforce Developer Console
صورة لنتيجة الـ If Statement في الـ Salesforce Developer Console

مثال 2:

Integer inputScore=200; // if you choose value between 0 and 100 you will get valid value

if (inputScore >= 0 && inputScore <= 100) {
    // Process the score
    System.debug('Valid Value');
} else { 
    // Show an error message
    System.debug('Invalid Value');
}
نتيجة الـ if else statement في الـ Salesforce Developer Console
صورة لنتيجة الـ If Statement في الـ Salesforce Developer Console

2. مرونة الـ “else if” والـ “else”

لما يبقى عندكم أكتر من condition عايزين تشيكوا عليه، هنا بييجي دور الـ else if. تقدروا تحطوا كذا else if ورا بعض بعد الـ if. ولو مفيش ولا condition اتحقق، الـ else بتمسك أي حالة تانية.

الـ “else if” مفيدة جداً لما يبقى عندكم مجموعة conditions عايزين تشيكوا عليها.

الـ Syntax

if (condition1) {
    // Code for condition1
} else if (condition2) {
    // Code for condition2
} else {
    // Code if none of the conditions are met
}

مثال 1

Integer temperature=40;

if (temperature < 20) {
    System.debug('It’s cold!');
} else if (temperature < 30) {
    System.debug('Nice weather!');
} else {
    System.debug('It’s hot!');
}
نتيجة الـ if-else if statement في الـ Salesforce Developer Console
صورة لنتيجة الـ If-else if Statement في الـ Salesforce Developer Console

مثال 2

String userRole='Tester';

if (userRole == 'Admin') {
    System.debug('Weclome Admin');
} else if (userRole == 'User') {
    System.debug('Weclome User');
} else {
    System.debug('Hello Guest User');
}
نتيجة الـ if-else if statement مع userRole في الـ Salesforce Developer Console
صورة لنتيجة الـ If-else if Statement في الـ Salesforce Developer Console

3. الـ “switch” Statement: بديل منظم

الـ switch statement طريقة منظمة ونضيفة عشان تتعاملوا مع conditions كتير، خصوصاً لما تكونوا بتتعاملوا مع قيم معروفة زي الـ Enums أو الـ String.

الـ Syntax

switch on expression { 
    when value1 {
        // Code for value1
    }
    when value2 {
        // Code for value2
    }
    when else { // default block, optional
        // Code if none of the values are matched
    }
}

ملاحظات:

  1. الـ expression ممكن يكون من الأنواع دي:
  2. قيمة الـ when:
    • ممكن تبقى قيمة واحدة أو كذا قيمة (بينهم فاصلة زي المثال اللي تحت)
    • كل قيمة ‘when’ في الكود لازم تبقى مميزة. يعني مثلاً لو استخدمتوا قيمة زي ‘x’، لازم تظهر في ‘when’ block واحد بس. والـ ‘when’ block هيتطابق مع الـ condition مرة واحدة بالكتير.
    • القيمة ممكن تبقى null: when null {….}
  3. الـ ‘when else’
    • اختيارية.
    • لو ضفتوها، لازم تبقى آخر block في الـ switch statement.

مثال

String dayOfWeek='Thursday';

switch on dayOfWeek {
    when 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday' {
        System.debug('Weekday');
    }
    when 'Saturday', 'Sunday' {
        System.debug('Weekend!');
    }
    when else {
        System.debug('Invalid day');
    }
}
نتيجة الـ switch statement في الـ Salesforce Developer Console
صورة لنتيجة الـ Switch Statement في الـ Salesforce Developer Console

4. كلمتين سريعين عن الـ Ternary Operator

رغم إننا هنشرح الـ ternary operator في بوست تاني، دي لمحة سريعة: هو اختصار للـ if-else، وممتاز للـ conditions البسيطة.

الشكل

(condition) ? value_if_true : value_if_false

مثال:

Integer score = 49;
String result = (score > 50) ? 'Pass' : 'Fail'; 
System.debug('result: '+result);
نتيجة الـ ternary operator في الـ Salesforce Developer Console
صورة لنتيجة الـ ternary operator في الـ Salesforce Developer Console

المثال اللي فوق بالـ ternary operator هو نسخة مختصرة من الـ logic ده لو كتبناه بـ if-else statement:

Integer score = 49;
String result;

if (score > 50) {
    result = 'Pass';
} else {
    result = 'Fail';
}

System.debug('result: ' + result);

زي ما إنتو شايفين، الـ ternary operator في المثال البسيط ده مش بس أقصر، كمان أسهل في القراية، فالكود بيبقى أنضف وأسهل في الصيانة.

امتى نستخدم كل نوع؟

تمام، كده عدينا على الـ conditional statements المختلفة في Apex. وعشان نسهل الموضوع، ده جدول مفيد بيوضح امتى تستخدموا كل نوع. اعتبروه دليل سريع لمغامراتكم مع كود Apex!

الـ Conditional Statementامتى نستخدمهاأهم مميزاتها
ifعندكم condition واحد عايزين تشيكوا عليه.بسيطة ومباشرة؛ بتشوف الـ condition يا true يا false.
else ifعندكم كذا condition، بس واحد بس اللي هيتحقق.بتيجي بعد الـ if؛ بتشيك على conditions إضافية.
elseعشان تتعاملوا مع الحالة اللي مفيهاش ولا condition من الـ if أو الـ else if اتحقق.بتدي طريق default لما مفيش ولا condition يبقى true.
switchالتعامل مع كذا قيمة معروفة بطريقة منظمة.ممتازة مع الـ Enums أو الحالات المحددة؛ أنضف من كذا if–else ورا بعض.
Ternaryمحتاجين تدوا قيمة على أساس condition بسرعة وببساطة.بديل مختصر للـ if–else؛ الشكل: condition ? value_if_true : value_if_false.
اختيار الـ Conditional Statement المناسبة في Apex

وبس كده! لما تفهموا الأقواس وتستخدموها صح، هتتحكموا أكتر في الـ logic بتاع البرنامج، وهيشتغل بالظبط زي ما إنتو عايزين. وافتكروا إن الـ conditional statements أساسية عشان توجّهوا الكود في الطريق الصح حسب الـ conditions المختلفة. ومع التمرين المستمر، هتبقوا بتتنقلوا في Apex زي المحترفين. خليكم متحمسين لمعلومات أكتر عن Apex، وزي دايماً، happy coding!

مصادر مفيدة (Resources)

  1. Conditional (if-else) statements
  2. Switch Statements

Join the conversation

لن يتم نشر عنوان بريدك الإلكتروني. الحقول الإلزامية مشار إليها بـ *