Exclude Nones

تقوم هذه الدالة (function block) بإزالة الإدخالات التي قيمتها None من قائمة مُعطاة. استخدمها عندما تحتاج إلى قائمة نظيفة خالية من الخانات الفارغة قبل معالجة لاحقة أو تصدير.

📥 المدخلات

Data List — مقبس إدخال يستقبل قائمة من القيم. العناصر قد تكون من أي نوع وبعضها قد تكون قيمتها None.

📤 المخرجات

Filtered Data List — مقبس خرج يُرجع نفس ترتيب القائمة ولكن مع إزالة جميع العناصر التي قيمتها None.

🕹️ الضوابط

لا يحتوي هذا البلوك على عناصر تحكم قابلة للتعديل من قبل المستخدم. يعمل تلقائيًا عند توفر قائمة الإدخال.

🎯 الميزات

• إزالة سريعة وبسيطة لقيم None مع الحفاظ على ترتيب العناصر الأصلي.

• يعمل مع قوائم ذات أنواع مختلطة (أرقام، نصوص، صور، قواميس، إلخ).

• مفيد لتنظيف مخرجات دفعات أو قوائم قبل المعالجة اللاحقة أو التصدير.

⚙️ آلية التشغيل

عند التنفيذ يقرأ البلوك القيمة من مدخل Data List، يقوم بتصفية أي عناصر قيمتها None، ثم يصدر القائمة المنقحة إلى Filtered Data List. إذا كان الإدخال فارغًا أو يحتوي فقط على عناصر None، فسيكون الخرج قائمة فارغة.

💡 نصائح وحيل

• اجمعه مع Replace None عندما تفضل استبدال قيم افتراضية بدلاً من إزالة العناصر.

• استخدم Get Element أو List Operations بعد هذا البلوك للوصول أو التلاعب بالعناصر بأمان دون الحاجة للتحقق من None.

• استخدم Is None قبل هذا البلوك لتفريع المنطق (مثال: تخطي المعالجة عندما تكون العديد من العناصر None).

• في تدفقات العمل الدُفعية، قم بإقرانه مع Batch Processing, Debatch, أو Batch Concatenation للتعامل مع مدخلات ومخرجات القوائم/الدفعات بشكل نظيف.

• خزّن النتائج المنقحة باستخدام Data Memory إذا احتجت لتجميد القائمة المفلترة حتى يتم طلب تحديث.

• حضّر البيانات للتصدير عن طريق توجيه الخرج إلى Data to JSON, CSV Export, أو Image Logger (عندما تحتوي القائمة على صور).

• استخدم Debug Input لفحص القوائم الواردة إذا بدت النتائج غير متوقعة.

🛠️ استكشاف الأخطاء وإصلاحها

• إذا احتوى الخرج على None ما زال، فتأكد أن القيمة عند Data List هي فعلاً قائمة وليست نوع بيانات آخر.

• إذا لم يظهر شيء على المخرج، افحص البلوكات الأعلى باستخدام Debug Input للتأكد أنها تُنتج القائمة المتوقعة.