Data Read Global

هذه الدالة تقرأ قيمة مخزنة في التخزين العالمي (global data storage) لمشهد المشروع الحالي. استخدمها عندما تحتاج لاسترجاع بيانات تم حفظها في مكان آخر ومشاركتها عبر أجزاء مختلفة من السيناريو الخاص بك.

📥 المدخلات

لا يحتوي هذا Function Block على مقابس إدخال.

📤 المخرجات

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

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

Data Key أدخل اسم مفتاح البيانات العالمي الذي تريد قراءته.

🎯 الميزات

• القراءة من التخزين العالمي الذي يمكن الوصول إليه من كتل ومشاهد أخرى.

• دعم الإكمال التلقائي للمفاتيح العالمية الموجودة لتقليل أخطاء الكتابة.

• يصدر مخرجًا واحدًا Generic يمكن أن يحتوي أي نوع بيانات مدعوم.

📊 التقييم

عند تشغيل السيناريو، يبحث البلوك عن اسم الـ Data Key المقدم في التخزين العالمي ويعيد القيمة المخزنة عبر مخرج Generic. إذا كان المفتاح مفقودًا فسيتم إصدار تحذير وإرجاع قيمة نائب (placeholder).

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

1. أدخل اسم المفتاح بدقة في عنصر التحكم Data Key.

2. ضع هذا البلوك في المكان الذي تحتاج فيه لاستهلاك البيانات المخزنة عالميًا.

3. استخدم مخرج Generic كمدخل للبلوك الذي يحتاج إلى هذه البيانات.

💡 نصائح وحيل

• لتخزين القيم لاسترجاعها لاحقًا، استخدم البلوك Data Write Global مع هذا البلوك.

• إذا احتجت تخزينًا مؤقتًا أو محليًا داخل حلقة، ففكر باستخدام Data Read Local وData Write Local لتدفق بيانات أكثر عزلة.

• ادمج مع Is None أو Replace None عندما قد يكون المفتاح مفقودًا، حتى يوفر السيناريو قيمًا افتراضية.

• استخدم Data Memory عندما تريد تجميد قيمة في الذاكرة حتى يتم تحديثها صراحةً.

• لأغراض التصحيح، قم بتوجيه المخرج إلى Debug Input لفحص القيم المسترجعة في السجل.

• للتصدير المنظم للقيم المسترجعة، اجمعها مع Data to JSON أو CSV Export.

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

• No value returned تأكد من أن Data Key يطابق تمامًا المفتاح المستخدم عند كتابة البيانات. الأخطاء المطبعية هي سبب شائع.

• Key not found إذا رأيت تحذيرًا بشأن مفتاح مفقود، تحقق من أن البلوك الذي كتب البيانات قد تم تشغيله سابقًا في السيناريو، وفكر في استخدام Data Write Global لإنشاء المفتاح قبل القراءة.

• Unexpected data type إذا كانت الكتل المستهلكة تتوقع نوع بيانات محدد، فقم بالتحقق من القيمة المسترجعة باستخدام Data Type Converter أو تعامل مع الأنواع المفقودة/الخاطئة باستخدام Replace None.

✅ ممارسات موصى بها

• استخدم أسماء مفاتيح واضحة وواصفة لتجنب التعارضات (مثلاً أضف بادئات للمشهد أو للنظام الفرعي).

• عند تصميم حلقات أو تدفقات متوازية، فضل التخزين المحلي حيثما أمكن لتجنب حالات السباق؛ استخدم التخزين العالمي فقط عندما تحتاج مقصودًا للمشاركة عبر نطاقات متعددة.

• احمِ عمليات القراءة بالتحقق مثل Is None لجعل التدفقات أكثر متانة ضد البيانات المفقودة.