> 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/input-output/outputs-exports/csv-export.md).

# CSV Export

## 📥 المدخلات <a href="#inputs" id="inputs"></a>

* `Folder Path` المجلد الذي سيُحفظ فيه ملف CSV (يستخدم المجلد الحالي إذا لم يتم تحديده)
* `File Name` اسم الملف المستخدم لتصدير CSV (افتراضيًا مع طابع زمني إذا لم يتم تحديده)
* `Start Logging` مشغل منطقي (Boolean) لبدء إضافة البيانات الواردة إلى المخزن المؤقت الداخلي
* `Export File` مشغل منطقي (Boolean) لكتابة بيانات السجل المتجمعة إلى ملف CSV
* `Data_1` ... `Data_10` أعمدة بيانات عامة سيتم تخزينها (يُسجل فقط الأعمدة المتصلة)

## 📤 المخرجات <a href="#outputs" id="outputs"></a>

* هذا البلوك لا ينتج أي مخرجات مباشرة.

## 🕹️ عناصر التحكم <a href="#controls" id="controls"></a>

* `Header fields` عشرة حقول نصية يمكنك وضع أسماء أعمدة مقروءة للإنسان تتطابق مع مداخل `Data_1` ... `Data_10`. اترك الحقول فارغة لاستخدام التسميات الافتراضية `Data_n`.
* مدخل `Start Logging` يُستخدم لتمكين تسجيل القيم الواردة داخل المخزن المؤقت الداخلي.
* مدخل `Export File` يُستخدم لتفريغ الصفوف المخزنة إلى ملف CSV على القرص.

## 🎯 الميزات <a href="#features" id="features"></a>

* إضافة طابع زمني تلقائي لكل صف (يُضاف الوقت كأول عمود).
* أعمدة مرنة: تُدرج فقط مداخل `Data_n` المتصلة في ملف CSV.
* إدارة رؤوس الأعمدة: عند تغيير `Header fields` يتم تحديث صف الرأس في CSV تلقائيًا إذا كان الملف موجودًا بالفعل.
* تسجيل مخزن مؤقت: تُخزن الصفوف داخليًا طالما أن `Start Logging` مفعل، وتُكتب إلى الملف فقط عند تشغيل `Export File`.
* سلوك كتابة آمن: تعرض الواجهة تحذيرات وأخطاء إذا كان الملف مفتوحًا في برنامج آخر أو فشلت عملية الكتابة.

## 📝 كيفية الاستخدام <a href="#usage" id="usage"></a>

1. عيّن الوجهة باستخدام مداخل `Folder Path` و`File Name` (اختياري).
2. ضع أسماء أعمدة مقروءة في `Header fields` لأي مداخل `Data_n` ستقوم بتوصيلها.
3. وصل مصادر البيانات إلى مداخل `Data_1` ... `Data_10` المقابلة (استخدم فقط المداخل التي تحتاجها).
4. قم بتشغيل `Start Logging` بواسطة إشارة منطقية (مثلاً عبر بلوك `Logic Input`) لبدء تجميع الصفوف في المخزن المؤقت.
5. عندما تكون جاهزًا، فعّل مدخل `Export File` لحفظ الصفوف المخزنة على القرص. سيضيف البلوك أو يحدث رأس CSV تلقائيًا.

## 📊 السلوك <a href="#evaluation" id="evaluation"></a>

* بينما يكون `Start Logging` مفعلًا، يلتقط البلوك الطابع الزمني الحالي وقيم جميع المداخل المتصلة ويخزنها في قائمة داخلية.
* عندما يصبح `Export File` صحيحًا، يكتب البلوك الصفوف المجمعة إلى ملف CSV في `Folder Path` + `File Name`. بعد التصدير الناجح يتم مسح المخزن المؤقت الداخلي.

## 💡 نصائح وحيل <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* استخدم بلوكات `Date-Time` أو `Date-Time List` لبناء أسماء ملفات ذات معنى أو لإضافة أعمدة زمنية إضافية إلى جانب الطابع الزمني التلقائي.
* استخدم `Logic Input` للتحكم اليدوي في `Start Logging` و`Export File` من واجهة المستخدم.
* عند تسجيل قياسات رقمية، استخدم `Number Input` أو بلوكات رياضية (مثل `Add`, `Subtract`) لتحضير القيم قبل توصيلها إلى مداخل `Data_n`.
* لتسميات نصية أو معرفات، استخدم `String Input` أو `String Merge` لدمج الحقول النصية قبل إرسالها إلى مدخل `Data_n`.
* لتصدير بيانات وصفية متعلقة بالصور (مثل عدد الإطارات، أرقام الاكتشاف)، وصل بلوكات التحليل المناسبة مثل `Object Detection`, `Mask Detection`, أو `Find Object` إلى مداخل `Data_n` العامة.
* إذا أردت حفظ الصور جنبًا إلى جنب مع السجلات الرقمية، استخدم `Image Logger` أو `Image Write` بالتوازي واترك CSV للبيانات الرقمية/النصية فقط.
* استخدم `CSV Export` مع `Scope` لعرض السلاسل الرقمية ثم احفظ البيانات بعد التحقق من الأحداث المهمة.

## 🛠️ استكشاف الأخطاء وإصلاحها <a href="#troubleshooting" id="troubleshooting"></a>

* الملف لم يُحفظ / خطأ صلاحية: تأكد من أن ملف CSV غير مفتوح في برنامج آخر وأن لديك صلاحية الكتابة للمجلد المحدد. شغّل التطبيق بصلاحيات كافية إذا لزم الأمر.
* لم يتم تصدير أي بيانات: تأكد من أنك فعّلت `Start Logging` مرة واحدة على الأقل حتى يحتوي المخزن المؤقت على صفوف قبل تشغيل `Export File`. سيعرض البلوك تحذيرًا إذا لم توجد بيانات مخزنة عند الطلب.
* أعمدة خاطئة في CSV: تحقق من المداخل المتصلة `Data_n` وعدّل حقول `Header fields`. البلوك يُدرج فقط المداخل المتصلة ويُحدث الرأس عند تغيير نص الرأس.