> 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/data-operations/string-merge.md).

# String Merge

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

## 📥 المدخلات

`String` — أحد المدخلات النصية التي سيتم دمجها. البلوك يقبل عدة مدخلات من النوع `String`؛ التخطيط الافتراضي يوفر مدخلين.

## 📤 المخرجات

`String` — الناتج المدمج الناتج عن ربط جميع المدخلات الموفرة من اليسار إلى اليمين.

## 🕹️ الضوابط

`Input size` — اختر عدد المدخلات النصية التي يعرضها البلوك. زيادة هذه القيمة تضيف مزيدًا من مداخل `String`؛ وتقليلها يزيلها.

## ⚙️ آلية التشغيل

* في كل مرة يتم تشغيل البلوك، يقرأ جميع مداخل `String` المتاحة (بالترتيب الظاهر) ويقوم بربطها في قيمة نصية واحدة.
* الناتج المربوط يُرسل إلى مقبس الإخراج `String` للاستخدام في البلوكات التالية.
* إذا كان مدخل فارغًا أو غير موصول، فإنه لا يساهم بأي أحرف في النتيجة النهائية (يُعامل كسلسلة فارغة).

## 🎯 الميزات

* تغيير عدد المدخلات ديناميكياً عبر ضابط `Input size` — وكِّن عدد المدخلات النصية بحسب حاجتك.
* عملية ربط بسيطة وحتمية — ترتيب الأجزاء المتوقع يسهل بناء أسماء ومنسقات محددة.
* خفيف الوزن ومناسب لتجميع النص على مستوى واجهة المستخدم (أسماء ملفات، تسميات، سطور سجل).

## 📝 نصائح الاستخدام

* رتب أجزاء النص من اليسار إلى اليمين بالترتيب الذي تريد دمجها به.
* استخدم مدخلات نصية وصفية (مثل: prefix، separator، counter، timestamp) لبناء أسماء واضحة أو معرفات.

## 💡 نصائح وحيل

* ادمجه مع `String Input` للسماح بالإدخال اليدوي للأجزاء، ثم اجمعها لتشكيل التسمية النهائية أو اسم الملف.
* استخدم `Number Input` مع `String Merge` عندما تحتاج أرقام عدّاد متزايدة في أسماء الملفات.
* أضف طابع زمني بدمج `Date-Time` (أو قيم من `Date-Time List`) لإنشاء أسماء ملفات فريدة وقابلة للتتبع.
* أنشئ سجلات تصدير منظمة بدمج الحقول ثم تمرير النتيجة إلى `Data to JSON` أو `CSV Export` للتسجيل.
* ابني أسماء ملفات صور ديناميكية (prefix + timestamp + index) باستخدام `String Merge` واستخدم الناتج مع `Image Logger` أو `Image Write` لحفظ الصور بأسماء ذات معنى.
* ادمجه مع `Choose Folder` أو `File/Folder Operations` لتجميع مسارات كاملة لعمليات الملفات.

## 🛠️ استكشاف الأخطاء

* إذا بدا أن المخرجات المدمجة تفتقد أجزاءً، فتفقد عدد مداخل `String` النشطة عبر ضابط `Input size` وتأكد أن كل مدخل موصول أو يحتوي نصًا.
* إذا كانت الفواصل مفقودة، أضف مدخلات فاصل صريحة (مثل شرطة أو underscore) بين الأجزاء قبل الدمج.