> 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/data-inputs/string-input.md).

# String Input

بلوك بسيط يتيح لك كتابة نص عادي وإخراجه. استخدمه كلما احتجت إلى قيمة نصية مدخلة يدويًا في السيناريو الخاص بك (مثل التسميات، المعرفات، الرسائل، حمولة API، أسماء الملفات، إلخ).

## 📥 المدخلات

هذا البلوك لا يحتوي على مدخلات.

## 📤 المخرجات

* `String` — هذا الإخراج يوفر النص المدخل حاليًا في عنصر التحكم.

## 🕹️ الضوابط

* `Text` — حقل قابل للتحرير بسطر واحد تكتب فيه النص. يعرض عنصر نائب عند الفراغ ويحدّث مخرج البلوك عند التقييم.

## 🎯 الميزات

* واجهة بسيطة ومركزة لإدخال نص حر أو معرفات.
* قابلية تغيير العرض أفقيًا لاستيعاب نصوص أطول.
* مصمم ليُستخدم مع بلوكات البيانات أو التصدير للاستخدام لاحقًا.

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

عند تشغيل السيناريو، يقرأ البلوك محتوى عنصر التحكم `Text` ويخرجه عبر المخرج `String`. إذا كان الحقل فارغًا، يقوم البلوك بإخراج سلسلة فارغة. يتم تحديث الإخراج عند كل عملية تقييم بحيث تتلقى البلوكات اللاحقة أحدث قيمة مدخلة.

## 📝 الاستخدام

1. اكتب النص المطلوب في حقل `Text`.
2. اربط مخرج `String` بأي بلوك يقبل نصًا.
3. شغّل السيناريو — سيتم توفير القيمة المكتوبة للأسفل في كل تقييم.

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

* استخدم `String` مع `String Merge` لبناء رسائل مُهيكلة (مثل دمج المعرفات، الطوابع الزمنية، أو التسميات).
* أرسل القيمة المكتوبة إلى `REST API - Post` أو `Send Mail` لنقل النص إلى خدمات ويب أو بريد إلكتروني.
* حوّل حقول نص متعددة إلى بيانات مُهيكلة عبر `Data to JSON` قبل التصدير باستخدام `CSV Export`.
* خزن مدخلات المستخدم بشكل دائم باستخدام `Data Write Local` أو `Data Write Global` واسترجعها لاحقًا عبر بلوكات القراءة المقابلة.
* استخدم `Data Memory` لتجميد نص تم إدخاله مسبقًا بحيث يبقى متاحًا حتى عند تغيّر المراحل العليا.

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

* إذا استلمت البلوكات التالية قيمًا فارغة غير متوقعة، تأكد من أن حقل `Text` ليس فارغًا.
* للنصوص الطويلة، استخدم تغيير العرض الأفقي لضمان رؤية المحتوى الكامل أثناء التحرير.
* عند إرسال النص إلى أنظمة خارجية، تحقق من أن البلوك المستلم يقبل التنسيق المتوقع (نص عادي مقابل JSON).