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).