> For the complete documentation index, see [llms.txt](https://docs.augelab.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.augelab.com/arabic/alblwkat-alwzyfyh/blocks-reference/data-logic/flow-control/debatch.md).
# Debatch
هذا البلوك يقوم بإيقاف معالجة الدُفعات (batch) للمتغير الحالي ويفكك (demultiplex / demux) مدخلًا من نوع قائمة/دفعة إلى مخارج منفصلة، بحيث تستقبل البلوكات التالية عناصر فردية بدلًا من مجموعة.
## 📥 المدخلات
`Batch`\
تقبل هذه المقبس قائمة أو دفعة من القيم (مثل: قائمة صور، أرقام، أشكال أو عناصر عامة). يتوقع البلوك أن يتم توصيل الدفعة هنا.
## 📤 المخرجات
`Output 1`\
`Output 2`
توفر هذه المخارج العناصر الفردية المستخرجة من الدفعة الواردة بترتيبها التسلسلي. إذا كانت الدفعة تحتوي عناصر أقل من عدد المخرجات المتاح، فستبقى المخرجات المتبقية بالقيم الافتراضية/الفارغة. وإذا كانت الدفعة أكبر من عدد المخرجات، فسيتم إرسال العناصر الأولى إلى المخرجات بحسب الترتيب.
## 🕹️ عناصر التحكم
هذا البلوك لا يحتوي على عناصر تحكم تفاعلية أو أدوات واجهة للمستخدم.
## ⚙️ آلية التشغيل
* عندما يتم توصيل دفعة صالحة (قائمة) إلى مدخل `Batch`، يقوم البلوك بتقسيم الدفعة وإخراج العناصر عبر مآخذ الخرج بالترتيب.
* إذا كان المدخل مفقودًا أو غير صالح، سيعرض البلوك حالة خطأ/غير صالحة في واجهة المستخدم ويوفر مخارج افتراضية للدلالة على عدم وجود بيانات صالحة.
* استخدم هذا البلوك عندما تحتاج إلى تحويل مجموعة من العناصر المجمعة إلى تدفقات فردية حتى تتمكن البلوكات الأخرى من معالجة كل عنصر بشكل مستقل.
## 🎯 الميزات
* فصل بسيط لبيانات الدُفعة/القائمة إلى مخرجات منفصلة.
* يعمل مع أي نوع بيانات عام (صور، أرقام، أشكال، إلخ).
* سلوك آمن للرجوع إلى قيمة افتراضية عندما لا يكون المدخل متصلاً أو غير صالح.
## 📝 تعليمات الاستخدام
1. قدّم دفعة أو قائمة عناصر إلى مدخل `Batch`.
2. وصل البلوكات التالية إلى `Output 1` و/أو `Output 2` لتستقبل العناصر الفردية.
3. إذا كنت تتوقع أحجام دفعات متغيرة، أضف بلوكات منطقية أو فحوصات لاحقة للتعامل بسلاسة مع العناصر المفقودة أو الزائدة.
## 💡 نصائح وحيل
* اجمعه مع `Batch Processing` للتبديل بين المعالجة على شكل دفعات والمعالجة عنصرًا عنصرًا: أنتج دفعة باستخدام `Batch Processing` ثم استخدم هذا البلوك لمعالجة العناصر فرديًا.
* استخدم `Get Batch Size` أو `Get Element` قبل أو بعد هذا البلوك لفحص طول الدفعة أو للوصول إلى عنصر محدد.
* أعد تجميع العناصر المعالجة باستخدام `Batch Concatenation` أو `Mux` عندما تحتاج إلى إنشاء دفعة/قائمة مرة أخرى.
* اقترانه ببلوكات مخصصة للصور: أدخل دفعة صور إلى هذا البلوك، ثم وصل كل مخرج إلى بلوكات مثل `Show Image`, `Image Logger`, `Find Object`, `Object Detection`, أو `Mask Detection` لتحليل أو حفظ كل صورة على حدة.
* عند العمل بقيم اختيارية، استخدم `Exclude Nones` بعد هذا البلوك لإزالة العناصر الفارغة قبل المتابعة.
* إذا احتجت لتقييد أو تحويل تدفق العناصر، استخدمه مع `Get Element` وبلوكات منطقية (مثل: تصفية، عدادات) للتحكم في العناصر التي يتم تمريرها.
## 🛠️ استكشاف المشكلات وإصلاحها
* لا تتحدث المخرجات: تحقق من أن مدخل `Batch` متصل ويحتوي على قائمة من العناصر.
* مخرجات فارغة غير متوقعة: افحص حجم الدفعة؛ إذا كانت تحتوي على عناصر أقل من عدد المخرجات فبعض المخرجات ستكون فارغة حسب التصميم. استخدم `Get Batch Size` للتأكد من طول الدفعة الواردة.
* أخطاء في البلوكات اللاحقة: تأكد من أن البلوكات التالية تقبل نوع العنصر المحدد (صورة، رقم، شكل، إلخ) الذي ينتجه هذا البلوك. استخدم بلوكات تحويل النوع أو التحقق إذا لزم الأمر.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.augelab.com/arabic/alblwkat-alwzyfyh/blocks-reference/data-logic/flow-control/debatch.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.