> 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/file-folder-operations.md).

# 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`، أعد التحقق من الاتصالات: مواضع وعدد المآخذ قد تكون تغيّرت.