> 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/data-type-converter.md).

# Data Type Converter

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

## 📥 المدخلات <a href="#inputs" id="inputs"></a>

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

## 📤 المخرجات <a href="#outputs" id="outputs"></a>

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

## 🕹️ عناصر التحكم <a href="#controls" id="controls"></a>

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

## 🎨 الميزات <a href="#features" id="features"></a>

* تحويل قيم منفردة بين الأنواع الشائعة (رقم، نص، boolean).
* إنشاء غلاف `List` أو `Batch` عندما تتطلب الكتل اللاحقة مجموعة.
* تحليل نص يشبه JSON إلى `Dictionary` عندما يكون الإدخال نص JSON صالحًا.
* سلوك وقائي: عند غياب الإدخال أو عدم التوافق، يوفر البلوك مخرجًا افتراضيًا آمنًا ويشير إلى وجود مشكلة.

## 📝 تعليمات الاستخدام <a href="#usage" id="usage"></a>

1. وصل مصدر البيانات إلى مدخل `Generic`.
2. اختر النوع الهدف المرغوب باستخدام القوائم المنسدلة `Convert to`.
3. استخدم مخرج البلوك `Generic` كمدخل للكتل التالية التي تتطلب النوع المختار.

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

* تحويل نص مدخل من المستخدم إلى رقم قبل تطبيق كتل رياضية.
* تحويل سلسلة JSON إلى `Dictionary` قبل التصدير أو استخراج حقول.
* تغليف عنصر واحد داخل `List` أو `Batch` لكي تتمكن الكتل المتوافقة مع القوائم من معالجته.

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

## 📊 التقييم <a href="#evaluation" id="evaluation"></a>

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

## 💡 نصائح وحيل <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* استخدم `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`.

## 🛠️ استكشاف الأخطاء وإصلاحها <a href="#troubleshooting" id="troubleshooting"></a>

* إذا فشل التحويل أو بدا المخرج دون تغيير، افحص قيمة الإدخال باستخدام `Debug Input` لتأكيد نوعها ومحتواها الحالي.
* إذا لم ينجح تحويل إلى `Dictionary`، تحقق أن الإدخال نص JSON صالح (علامات اقتباس صحيحة، فواصل، أقواس).
* عند العمل مع batches أو قوائم، تأكد أن الهدف المختار (`List` مقابل `Batch`) يتطابق مع ما تتوقعه الكتل التالية؛ استخدم `Get Batch Size` للتحقق من محتويات الـ batch.
* لتحويلات boolean غير المتوقعة، تأكد أن النص أو الرقم يتبع اتفاقية واضحة للصواب/الخطأ (مثال: `0`/`1` أو `true`/`false`).