Data Type Converter

منفذ بسيط لتغيير نوع البيانات للقيمة الواردة بحيث تستقبل الكتل التالية الصيغة المتوقعة. استخدم هذا عندما تحتاج إلى التأكد من أن قيمة تُعامل كـ رقم، نص، قائمة، قاموس، Batch، أو boolean لمزيد من المعالجة أو التصدير.

📥 المدخلات

Generic — أي نوع من البيانات الواردة (نص، رقم، قائمة، batch، إلخ). زود القيمة التي تريد تحويلها.

📤 المخرجات

Generic — القيمة المحوّلة إلى النوع الهدف المحدد. استخدم هذا المخرج لتغذية الكتل الأخرى التي تتوقع نوع بيانات محدد.

🕹️ عناصر التحكم

Convert to — قائمة منسدلة تختار منها النوع الهدف. الخيارات المتاحة تتضمن Integer, Boolean, String, Float, Batch, List, و Dictionary.

🎨 الميزات

• تحويل قيم منفردة بين الأنواع الشائعة (رقم، نص، boolean).

• إنشاء غلاف List أو Batch عندما تتطلب الكتل اللاحقة مجموعة.

• تحليل نص يشبه JSON إلى Dictionary عندما يكون الإدخال نص JSON صالحًا.

• سلوك وقائي: عند غياب الإدخال أو عدم التوافق، يوفر البلوك مخرجًا افتراضيًا آمنًا ويشير إلى وجود مشكلة.

📝 تعليمات الاستخدام

1. وصل مصدر البيانات إلى مدخل Generic.

2. اختر النوع الهدف المرغوب باستخدام القوائم المنسدلة Convert to.

3. استخدم مخرج البلوك Generic كمدخل للكتل التالية التي تتطلب النوع المختار.

سيناريوهات شائعة:

• تحويل نص مدخل من المستخدم إلى رقم قبل تطبيق كتل رياضية.

• تحويل سلسلة JSON إلى Dictionary قبل التصدير أو استخراج حقول.

• تغليف عنصر واحد داخل List أو Batch لكي تتمكن الكتل المتوافقة مع القوائم من معالجته.

(hint: استخدم كتل String Input أو Number Input كمصادر بسيطة عند اختبار التحويلات)

📊 التقييم

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

💡 نصائح وحيل

• استخدم Debug Input لفحص القيم الخام قبل التحويل لكي تختار النوع الهدف الصحيح.

• إذا كنت تتوقع قيم مفقودة، ضع Is None قبل هذا البلوك لاكتشافها وReplace None لإدخال قيمة بديلة.

• عند إعداد حمولات منظمة للتسجيل أو واجهات برمجة التطبيقات، اجمع String Merge أو Data to JSON مع هذا البلوك لإنتاج بيانات بالتنسيق السليم.

• لتدفقات العمل بالـ batch، زوج هذا البلوك مع Batch Concatenation, Get Batch Size, أو Debatch لفحص أو تسطيح محتويات الـ batch بعد التحويل.

• بعد التحويل إلى شكل قاموسي، خزّن أو شارك النتائج باستخدام Data Write Local, Data Write Global, أو صدرها عبر CSV Export.

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

• إذا فشل التحويل أو بدا المخرج دون تغيير، افحص قيمة الإدخال باستخدام Debug Input لتأكيد نوعها ومحتواها الحالي.

• إذا لم ينجح تحويل إلى Dictionary، تحقق أن الإدخال نص JSON صالح (علامات اقتباس صحيحة، فواصل، أقواس).

• عند العمل مع batches أو قوائم، تأكد أن الهدف المختار (List مقابل Batch) يتطابق مع ما تتوقعه الكتل التالية؛ استخدم Get Batch Size للتحقق من محتويات الـ batch.

• لتحويلات boolean غير المتوقعة، تأكد أن النص أو الرقم يتبع اتفاقية واضحة للصواب/الخطأ (مثال: 0/1 أو true/false).