File/Folder Operations

توفّر هذه الدالة مكانًا واحدًا لأداء العديد من المهام الشائعة على الملفات والمجلدات (list، read، write، move، delete، join paths، إلخ). اختر العملية المطلوبة من القائمة المنسدلة وسيعرض البلوك المداخل والمخارج المناسبة لتلك العملية.

📥 المداخل

يقدّم هذا البلوك مداخل ديناميكية تتغير حسب العملية المحددة. أسماء المداخل الشائعة التي قد تراها:

• Folder Path مسار المجلد عند إجراء عمليات القائمة أو إنشاء دلائل

• Path المسار الكامل للملف عند القراءة أو الحذف أو التحقق من الوجود

• File Name أو Names مكوّنات تُستخدم لضم المسارات أو بناء أسماء الملفات

• Content محتوى نصي للحفظ أو الإضافة إلى ملف

• Source Path و Destination Path المسارات المستخدمة لعمليات النسخ/النقل

• (Generic) قد تظهر مداخل خاصة بعمليات معيّنة حسب الاختيار

ملاحظة: تظهر المداخل وتختفي لتطابق العملية المحددة. قم بتوصيل المآخذ الظاهرة فقط بعد اختيار العملية.

📤 المخارج

تتغير المخارج أيضًا حسب العملية المختارة. أسماء المخرجات الشائعة:

• Files قائمة بالملفات الموجودة في دليل

• Folders قائمة بالمجلدات الفرعية في دليل

• Image Files / Video Files قوائم بملفات الوسائط في مجلد

• Name / Extension أجزاء من مسار الملف عند التفكيك

• Content النص الموجود في الملف عند قراءته

• Exists قيمة منطقية تشير إلى وجود المسار أم لا

• Lines محتوى الملف كقائمة من الأسطر

• (Generic) قد تظهر نتائج أخرى خاصة بالعملية المختارة

عندما تُرجع العملية مخرجات متعددة، ستُضاف مآخذ منفصلة حتى تتمكن من استخدام كل نتيجة بشكل مستقل.

🕹️ Controls

Choose Operation قائمة منسدلة تعرض عمليات الملفات والمجلدات المتاحة. عند اختيار عملية، تتحدّث مآخذ الدخل والخرج المتاحة.

Run (ضمني) ينفّذ البلوك العملية المختارة عند تشغيل السيناريو ويعرض المخرجات على المآخذ المطابقة.

ملاحظة: تغيير قيمة Choose Operation يؤدي إلى تحديث المآخذ. إذا غيّرت العملية، أعد التحقق من الاتصالات للمآخذ المحدثة.

🎯 Key Features

• مآخذ ديناميكية: المداخل والمخارج تتغير لتطابق العملية المختارة بحيث ترى فقط المآخذ ذات الصلة.

• مجموعة واسعة من العمليات: قوائم المجلدات، قوائم الصور/الفيديو، قراءة وكتابة الملفات، الإضافة، إنشاء/حذف الدلائل، النسخ/النقل، تفكيك المسارات، ضم أجزاء المسار والمزيد.

• مخرجات مفصّلة: العديد من العمليات تعطي مخرجات متعددة (مثلاً، القوائم ترجع ملفات ومجلدات منفصلة).

• مصمّم لتدفقات بصرية: معدّ ليُوصل مع بلوكات أخرى لبناء تدفقات معالجة ملفات دون كتابة شيفرة.

📝 How to use

1. اختر العملية المطلوبة من قائمة Choose Operation.

2. سيحدّث البلوك مآخذ الدخل والخرج ليتناسب مع العملية.

3. وصل المداخل المطلوبة (مثلاً Folder Path أو Path) من بلوكات أخرى مثل Choose Folder أو String Input.

4. شغّل السيناريو. ستظهر النتائج على مآخذ الخرج (مثل Files، Content أو Exists).

5. إذا غيّرت العملية، راجع وأعد توصيل أي مآخذ تغيرت أو تحرّكت.

💡 Tips and Tricks

• لاختيار مجلد بصريًا قبل تنفيذ عمليات الملفات، اقترن هذا البلوك مع Choose Folder.

• لمعالجة الصور الموجودة في مجلد، استخدم العملية List Images هنا ومرّر النتائج إلى Load Image From Path أو Load Image.

• استخدم عملية Join Path مع بلوك Mux لبناء مسارات ملفات كاملة من أجزاء.

• عند حفظ أو تسجيل العديد من الصور، اجمعه مع Image Logger أو Image Write أو Multi Image Write لحفظ النتائج.

• لتصدير بيانات منظمة، أرسل المخرجات إلى CSV Export أو Data Write Local / Data Write Global.

• استخدم String Input أو String Merge لتحضير نص قبل الحفظ بعملية الحفظ/الإضافة.

• لمعاينة الملفات أو الصور الناتجة عن عمليات القائمة، وصلها إلى Show Image أو Load Image From Path ثم Show Image.

• إذا احتجت لتغيير حجم الصور قبل الحفظ، اجمعه مع Image Resizer.

• للتدفقات الشرطية (مثلاً الحفظ فقط عندما لا يكون الملف موجودًا)، استخدم عملية Check Existence مع بلوكات منطقية مثل Logic Input و And/Or.

🛠️ Troubleshooting

• إذا لم تظهر مخرجات بعد التشغيل، تحقق من أنك اخترت العملية الصحيحة وربطت المداخل المطلوبة التي تظهر على البلوك.

• لأخطاء الأذونات أو فشل كتابة الملفات، تأكد أن مسار المجلد الهدف صالح وأن للتطبيق صلاحية الكتابة في ذلك المكان.

• عندما تحتوي المسارات على فواصل غير متوقعة، استخدم عملية Join Path للبلوك (أو زود مسارات مُطبعنة من بلوكات سابقة) لتجنّب مسارات خاطئة.

• إذا أعادت عملية القائمة نتائج فارغة، تأكد أن المجلد فعلاً يحتوي على الملفات المطابقة (جرّب List Folder Contents أولًا).

• بعد تغيير اختيار Choose Operation، أعد التحقق من الاتصالات: مواضع وعدد المآخذ قد تكون تغيّرت.