Data Read Local

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

📥 المدخلات

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

📤 المخرجات

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

🕹️ الضوابط

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

⚙️ آلية التشغيل

• عند تشغيل السيناريو، تستخدم الكتلة النص من تحكم Data Key للبحث عن قيمة في التخزين المحلي للسيناريو.

• إذا وُجد إدخال مطابق، تُرسل تلك القيمة عبر مقبس الإخراج Generic.

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

✨ الميزات

• وصول قراءة للتخزين المحلي لمشاركة البيانات عبر السيناريو بدون توصيلات مباشرة.

• إكمال تلقائي لتحكم Data Key لتقليل الأخطاء وتسهيل الإعداد.

• سلوك افتراضي آمن وتحذير مرئي عند فقدان المفتاح.

📝 الاستخدام

1. اكتب اسم القيمة التي تريد قراءتها في تحكم Data Key (استخدم الإكمال التلقائي لاختيار المفاتيح الموجودة).

2. شغّل السيناريو. ستخرج الكتلة القيمة المخزنة إلى مقبس Generic عندما تكون متاحة.

3. استخدم الكتل التالية لمعالجة أو عرض أو تصدير القيمة.

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

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

• سحب قيم التهيئة الموضوعة في التخزين المحلي بواسطة خطوة إعداد.

💡 نصائح وحيل

• لحفظ قيمة يمكن لهذه الكتلة قراءتها، اقترنها بكتلة Data Write Local. اكتب مرة، واقرأ في أي مكان داخل نفس السيناريو.

• إذا احتجت أن تبقى البيانات عبر مرات التشغيل أو تكون متاحة عالمياً، استخدم Data Write Global و Data Read Global.

• استخدم Is None أو Replace None بعد هذه الكتلة لتوفير قيم احتياطية وتجنب أخطاء في الكتل التالية عندما يكون المفتاح مفقوداً.

• دمج مع Debug Input لفحص القيمة المسترجعة بسرعة في السجل أثناء بناء السيناريو.

• لتسجيل أو تصدير القيم المقروءة، وصل الإخراج إلى CSV Export أو كتل التصدير الأخرى.

• عند بناء أنظمة فرعية أو حلقات، يمكن أن يساعد Data Read Local مع Subsystem أو Data Memory في تنسيق الحالة بدون أسلاك إضافية.

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

• لا تظهر أي قيمة: تحقق من التهجئة الدقيقة لـ Data Key. استخدم قائمة الإكمال التلقائي في الحقل لتأكيد المفاتيح الموجودة.

• تحذير بخصوص مفتاح مفقود: هذا يعني أن المفتاح لم يُعثر عليه في التخزين المحلي. فكر في إنشاء المفتاح سابقاً في السيناريو باستخدام Data Write Local أو تعامل مع القيمة المفقودة باستخدام Replace None.

• نوع قيمة غير متوقع: تذكّر أن الكتلة تخرج ما تم تخزينه بالضبط. استخدم كتل فحص النوع أو التحويل لاحقاً إذا احتجت إلى نوع محدد.