3.4المكررات والمجمعات والتحويلات
الأساسي في 30 ثانية
- المكرر (iterator) يبسط : يجوب قائمة وينفذ الأفعال التالية لكل عنصر (سطر لكل صنف).
- المجمع يجمّع : يدمج عناصر عدة في قيمة واحدة (مجموع أو ملخص أو نص مدمج).
- التحويلات تنظف : تنسيق تاريخ أو نص أو مبلغ لتصل البيانة نظيفة إلى التطبيق المستهدف.
حالة مصغرة متسلسلة — لينا توحد سطور الطلب
لينا، مسؤولة الرقمنة في وهران، تستقبل طلبات يحوي كل رد منها أصنافا عدة : سيناريوها كان يأخذ الأول فقط وينسى الباقي. تضيف مكررا يبسط القائمة (سطر لكل صنف)، وتحويلات تنظف (تواريخ منسقة ومبالغ مدورة وأسماء بأحرف كبيرة)، ثم مجمعا ينتج المجموع وملخصا نصيا يُرسَل في رسالة واحدة. البسط للمعالجة، والجمع للعرض.
هذه الحالة نفسها تعود في الدرس والمخطط والنص الجاهز وتحدي 48 ساعة.
1. المكرر والمجمع : البسط ثم الجمع
تصل البيانات الحقيقية غالبا بدفعات : طلب يحوي سطورا عدة، ورسالة مرفقات عدة، ورد API قائمة عناصر. « يبسط » المكرر قائمة وينفذ الأفعال لكل عنصر (إنشاء سطر لكل صنف مطلوب). ويفعل المجمع العكس : يجمّع عناصر عدة في قيمة واحدة (دمج سطور في ملخص، أو جمع، أو دمج نصوص).
والعلامة المنبِّهة : بيانة « جدول/array » أو « [ … ] » في النتائج. دون مكرر، لا يأخذ السيناريو غالبا إلا العنصر الأول ؛ وبثنائي المكرر ← المجمع، تعالج لينا كل صنف ثم تعرض نتيجة موحدة.
2. التحويلات : تسليم النظيف
وتضاف التحويلات : تنظيف البيانات وإعادة صياغتها أثناء المرور — تنسيق تاريخ، أو تكبير أحرف، أو استخراج جزء نص، أو تحويل صيغة، أو حساب. هذه الدوال، القريبة غالبا من جدول حساب، تضمن وصول البيانة نظيفة وقابلة للاستغلال إلى التطبيق المستهدف.
والمكررات والمجمعات والتحويلات هي ما يتيح معالجة حالات واقعية (لا مجرد حقل معزول)، ومن ثم بناء أتمتات متينة بمستوى عمليات المقاولة.
🔎 مثال ملموس — سطور طلب موحدة
تطبق لينا نمط المكرر ← المجمع.
المشغّل يرجع قائمة (أصناف)
المكرر : إنشاء سطر لكل صنف
التحويل : تدوير المبالغ وتنسيق التواريخ
المجمع : المجموع + ملخص نصي ← رسالة واحدة
القراءة : كل صنف معالَج، ثم كل شيء موحَّد.
الدرس : « [ … ] » في البيانات = حاجة إلى التكرار.
مفردات القسم
- المكرر
- وحدة تجوب قائمة وتنفذ الأفعال التالية لكل عنصر (واحدا واحدا).
مثال بسيط: تُنشئ لينا سطرا لكل صنف في الطلب.
ما ليس كذلك: وحدة تدمج كل شيء في قيمة واحدة.
رد فعل: إضافة مكرر حال رؤية [ … ].
- المجمع
- وحدة تجمّع عناصر ونتائج عدة في قيمة واحدة (دمج أو جمع أو دمج نصوص).
مثال بسيط: مجموع لينا وملخصها النصي في رسالة واحدة.
ما ليس كذلك: جولة عنصرا عنصرا.
رد فعل: الإنهاء بمجمع عندما نريد نتيجة وحيدة.
- التحويل
- عملية تعيد صياغة البيانة أثناء المرور (تنسيق تاريخ أو استخراج نص أو تحويل أو حساب).
مثال بسيط: تواريخ منسقة ومبالغ مدورة قبل الإرسال.
ما ليس كذلك: إرسال بيانات الأصل خاما.
رد فعل: التنظيف قبل الفعل الأخير، لا بعده أبدا.
- الجدول (array)
- قائمة بيانات (سطور طلب أو عناصر رد API) يبسطها المكرر.
مثال بسيط: قائمة الأصناف المستلمة في الطلب.
ما ليس كذلك: حقل وحيد معزول.
رد فعل: رصد القوسين [ … ] في النتائج.
- الحزمة / الرزمة
- عنصر مفرد يُنتَج في كل دورة تكرار، وتُطبَّق عليه الأفعال.
مثال بسيط: كل صنف تعالجه لينا واحدا واحدا.
ما ليس كذلك: القائمة كلها معالَجة كتلة واحدة.
رد فعل: مراقبة حزمة اختبار قبل التعميم.
في التطبيق — معالجة القوائم وتحويل البيانات
- انطلقوا من مشغّل يرجع قائمة (مثلا سطور طلب، أو سجلات عدة).
- أضيفوا مكررا لجوب القائمة وأنشئوا فعلا لكل عنصر (سطر لكل صنف).
- استعملوا مجمعا لإنتاج ملخص (مجموع أو نص مدمج) من هذه العناصر.
- أدخلوا تحويلات : نسّقوا التواريخ، ونظفوا النص، ودوّروا المبالغ قبل الفعل الأخير.
نص جاهز للقول — شرح المعالجة بالدفعات (30 ثانية)
« الطلب يصل قائمة : مكرري يبسط ويُنشئ سطرا لكل صنف، وتحويلاتي تنظف التواريخ والنصوص والمبالغ، ثم مجمعي ينتج المجموع والملخص في رسالة واحدة. لا نضيع أي صنف ونسلّم النظيف. »
يُقال في مراجعة الفريق ؛ وعرض طلب ب3 أصناف معالَج من البداية إلى النهاية.
نموذج للنسخ واللصق — بطاقة الدفعة مكرر ← مجمع
القائمة المصدر (حقل الجدول المرصود) : _______________
المكرر (فعل واحد لكل عنصر) : _______________
التحويلات (تواريخ / نص / مبالغ) : _______________
المجمع (مجموع + ملخص وحيد) : _______________
مقاولة صغيرة جدا / مستقل
حتى بحجم صغير : التكرار على المرفقات واحدا واحدا يتفادى النسيان.
مقاولة صغيرة ومتوسطة في وهران
توحد لينا طلبات اليوم في ملخص واحد يُرسَل إلى المحاسبة.
فريق رقمي
توحيد الصيغ (تواريخ ومبالغ) في التحويلات لقواعد نظيفة دائما.
مبتدئ
التدرب على قائمة ب3 أصناف : التكرار وتحويل حقل وتجميع مجموع.
✓ ممارسات جيدة
- التكرار حال وصول بيانة كقائمة (array).
- الجمع بين مكرر ← مجمع لتوحيد نتيجة.
- تنظيف البيانات وتنسيقها قبل الفعل الأخير.
✗ أخطاء شائعة
- معالجة قائمة ككتلة (أخذ العنصر 1 فقط).
- نسيان التنسيق (تواريخ ونص) قبل الفعل المستهدف.
- التكرار عندما لا يخص كل تنفيذ إلا شيئا واحدا (عديم الفائدة).
النقاط الأساسية
- المكرر يبسط قائمة وينفذ الأفعال لكل عنصر.
- المجمع يجمّع عناصر عدة في قيمة واحدة (دمج أو جمع أو دمج نصوص).
- التحويلات تعيد صياغة البيانة (تواريخ ونص وتحويلات وحسابات).
- هذه الوحدات تتيح معالجة حالات واقعية (قوائم ودفعات) لا حقلا معزولا.
تحدي 48 ساعة — طبّق غدا
ارصدوا قائمة واحدة في بياناتكم وأضيفوا مكررا + تحويلا واحدا (تاريخ أو مبلغ).
- أرصد جدولا [ … ] في النتائج.
- أعرف التكرار ثم تجميع نتيجة.
- أنظف التواريخ والمبالغ قبل الفعل الأخير.
أسئلة شائعة
متى أحتاج فعلا إلى مكرر ؟
حالما يرجع المشغّل (أو خطوة) عناصر عدة وتريدون التصرف على كل منها : أصناف عدة في طلب (إنشاء سطر لكل صنف)، أو مرفقات عدة (حفظها واحدا واحدا)، أو قائمة سجلات للمعالجة. دون مكرر، لا يأخذ السيناريو غالبا إلا العنصر الأول، أو يعالج القائمة ككتلة غير مفهومة. والعلامة المنبِّهة : رؤية بيانة « جدول/array » أو « [ … ] » في النتائج. فآن أوان التكرار. وعكسا، إذا لم يخص كل تنفيذ إلا شيئا واحدا، فالمكرر عديم الفائدة.
المكرر ثم المجمع : ما فائدة هذا المزيج ؟
نمط شائع جدا : نبسط قائمة لمعالجة وتحويل كل عنصر (المكرر)، ثم نجمّع النتائج في مخرج وحيد (المجمع). مثال : من سطور طلب، نحسب المجموع الفرعي لكل منها (تكرار)، ثم نجمعها ونولّد ملخصا نصيا (تجميع) لإرساله برسالة. « البسط للمعالجة، والجمع للعرض » : ثنائي المكرر ← المجمع هذا من أقوى الأنماط لتدبير بيانات الدفعات بنظافة، مع إنتاج نتيجة موحدة ومقروءة.
ما فائدة المكرر ؟