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للتأكد أنها تُنتج القائمة المتوقعة.
آخر تحديث