> 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/referencing/data-read-local.md).

# Data Read Local

اقرأ قيمة مخزّنة في التخزين المحلي للسيناريو وأخرجها حتى تتمكن الكتل الأخرى من استخدامها. مفيد عندما تحتاج لمشاركة قيم داخل نفس السيناريو (مثلاً داخل حلقات أو بين فروع مختلفة) دون الاعتماد على توصيلات مباشرة.

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

هذه الكتلة ليس لديها أي مدخلات.

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

`Generic` هذا المقبس يخرج القيمة المسترجعة من التخزين المحلي للمفتاح المحدد. إذا لم يتم العثور على المفتاح فسيتم إنتاج قيمة افتراضية وسيظهر تحذير.

## 🕹️ الضوابط <a href="#controls" id="controls"></a>

`Data Key` أدخل نص المفتاح المستخدم للبحث عن القيمة في التخزين المحلي. الحقل يوفر اقتراحات إكمال تلقائي للمفاتيح المحلية الموجودة لتقليل الأخطاء الإملائية.

## ⚙️ آلية التشغيل <a href="#running-mechanism" id="running-mechanism"></a>

* عند تشغيل السيناريو، تستخدم الكتلة النص من تحكم `Data Key` للبحث عن قيمة في التخزين المحلي للسيناريو.
* إذا وُجد إدخال مطابق، تُرسل تلك القيمة عبر مقبس الإخراج `Generic`.
* إذا لم يوجد إدخال مطابق، تنتج الكتلة قيمة افتراضية آمنة وتعرض تحذيراً لتعلمك أن المفتاح غير موجود.

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

* وصول قراءة للتخزين المحلي لمشاركة البيانات عبر السيناريو بدون توصيلات مباشرة.
* إكمال تلقائي لتحكم `Data Key` لتقليل الأخطاء وتسهيل الإعداد.
* سلوك افتراضي آمن وتحذير مرئي عند فقدان المفتاح.

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

1. اكتب اسم القيمة التي تريد قراءتها في تحكم `Data Key` (استخدم الإكمال التلقائي لاختيار المفاتيح الموجودة).
2. شغّل السيناريو. ستخرج الكتلة القيمة المخزنة إلى مقبس `Generic` عندما تكون متاحة.
3. استخدم الكتل التالية لمعالجة أو عرض أو تصدير القيمة.

أمثلة على الاستخدام الشائع:

* قراءة العدادات، الأعلام أو النتائج الوسيطة التي تم تخزينها سابقاً في السيناريو.
* سحب قيم التهيئة الموضوعة في التخزين المحلي بواسطة خطوة إعداد.

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

* لحفظ قيمة يمكن لهذه الكتلة قراءتها، اقترنها بكتلة `Data Write Local`. اكتب مرة، واقرأ في أي مكان داخل نفس السيناريو.
* إذا احتجت أن تبقى البيانات عبر مرات التشغيل أو تكون متاحة عالمياً، استخدم `Data Write Global` و `Data Read Global`.
* استخدم `Is None` أو `Replace None` بعد هذه الكتلة لتوفير قيم احتياطية وتجنب أخطاء في الكتل التالية عندما يكون المفتاح مفقوداً.
* دمج مع `Debug Input` لفحص القيمة المسترجعة بسرعة في السجل أثناء بناء السيناريو.
* لتسجيل أو تصدير القيم المقروءة، وصل الإخراج إلى `CSV Export` أو كتل التصدير الأخرى.
* عند بناء أنظمة فرعية أو حلقات، يمكن أن يساعد `Data Read Local` مع `Subsystem` أو `Data Memory` في تنسيق الحالة بدون أسلاك إضافية.

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

* لا تظهر أي قيمة: تحقق من التهجئة الدقيقة لـ `Data Key`. استخدم قائمة الإكمال التلقائي في الحقل لتأكيد المفاتيح الموجودة.
* تحذير بخصوص مفتاح مفقود: هذا يعني أن المفتاح لم يُعثر عليه في التخزين المحلي. فكر في إنشاء المفتاح سابقاً في السيناريو باستخدام `Data Write Local` أو تعامل مع القيمة المفقودة باستخدام `Replace None`.
* نوع قيمة غير متوقع: تذكّر أن الكتلة تخرج ما تم تخزينه بالضبط. استخدم كتل فحص النوع أو التحويل لاحقاً إذا احتجت إلى نوع محدد.