CSV Export

📥 المدخلات

• Folder Path المجلد الذي سيُحفظ فيه ملف CSV (يستخدم المجلد الحالي إذا لم يتم تحديده)

• File Name اسم الملف المستخدم لتصدير CSV (افتراضيًا مع طابع زمني إذا لم يتم تحديده)

• Start Logging مشغل منطقي (Boolean) لبدء إضافة البيانات الواردة إلى المخزن المؤقت الداخلي

• Export File مشغل منطقي (Boolean) لكتابة بيانات السجل المتجمعة إلى ملف CSV

• Data_1 ... Data_10 أعمدة بيانات عامة سيتم تخزينها (يُسجل فقط الأعمدة المتصلة)

📤 المخرجات

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

🕹️ عناصر التحكم

• Header fields عشرة حقول نصية يمكنك وضع أسماء أعمدة مقروءة للإنسان تتطابق مع مداخل Data_1 ... Data_10. اترك الحقول فارغة لاستخدام التسميات الافتراضية Data_n.

• مدخل Start Logging يُستخدم لتمكين تسجيل القيم الواردة داخل المخزن المؤقت الداخلي.

• مدخل Export File يُستخدم لتفريغ الصفوف المخزنة إلى ملف CSV على القرص.

🎯 الميزات

• إضافة طابع زمني تلقائي لكل صف (يُضاف الوقت كأول عمود).

• أعمدة مرنة: تُدرج فقط مداخل Data_n المتصلة في ملف CSV.

• إدارة رؤوس الأعمدة: عند تغيير Header fields يتم تحديث صف الرأس في CSV تلقائيًا إذا كان الملف موجودًا بالفعل.

• تسجيل مخزن مؤقت: تُخزن الصفوف داخليًا طالما أن Start Logging مفعل، وتُكتب إلى الملف فقط عند تشغيل Export File.

• سلوك كتابة آمن: تعرض الواجهة تحذيرات وأخطاء إذا كان الملف مفتوحًا في برنامج آخر أو فشلت عملية الكتابة.

📝 كيفية الاستخدام

1. عيّن الوجهة باستخدام مداخل Folder Path وFile Name (اختياري).

2. ضع أسماء أعمدة مقروءة في Header fields لأي مداخل Data_n ستقوم بتوصيلها.

3. وصل مصادر البيانات إلى مداخل Data_1 ... Data_10 المقابلة (استخدم فقط المداخل التي تحتاجها).

4. قم بتشغيل Start Logging بواسطة إشارة منطقية (مثلاً عبر بلوك Logic Input) لبدء تجميع الصفوف في المخزن المؤقت.

5. عندما تكون جاهزًا، فعّل مدخل Export File لحفظ الصفوف المخزنة على القرص. سيضيف البلوك أو يحدث رأس CSV تلقائيًا.

📊 السلوك

• بينما يكون Start Logging مفعلًا، يلتقط البلوك الطابع الزمني الحالي وقيم جميع المداخل المتصلة ويخزنها في قائمة داخلية.

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

💡 نصائح وحيل

• استخدم بلوكات 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 لعرض السلاسل الرقمية ثم احفظ البيانات بعد التحقق من الأحداث المهمة.

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

• الملف لم يُحفظ / خطأ صلاحية: تأكد من أن ملف CSV غير مفتوح في برنامج آخر وأن لديك صلاحية الكتابة للمجلد المحدد. شغّل التطبيق بصلاحيات كافية إذا لزم الأمر.

• لم يتم تصدير أي بيانات: تأكد من أنك فعّلت Start Logging مرة واحدة على الأقل حتى يحتوي المخزن المؤقت على صفوف قبل تشغيل Export File. سيعرض البلوك تحذيرًا إذا لم توجد بيانات مخزنة عند الطلب.

• أعمدة خاطئة في CSV: تحقق من المداخل المتصلة Data_n وعدّل حقول Header fields. البلوك يُدرج فقط المداخل المتصلة ويُحدث الرأس عند تغيير نص الرأس.