> 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-write-global.md).

# Data Write Global

تخزّن هذه الكتلة الوظيفية البيانات الواردة في تخزين بيانات عام يمكن الوصول إليه عبر كامل السيناريو. استخدمها لمشاركة قيم، صور أو بيانات مُهيكلة بين أجزاء مختلفة من النظام أو لإنشاء حالة عامة بسيطة.

## 📥 المدخلات

`Generic` — مقبس إدخال يقبل أي نوع من البيانات ليُكتب في التخزين العام.

## 📤 المخرجات

لا توفر هذه الكتلة أي مخرجات.

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

`Data Key` — حقل نصي تكتب فيه اسم المفتاح المستخدم لتخزين البيانات في التخزين العام. يقدّم الحقل اقتراحات بناءً على المفاتيح العامة الموجودة لتتمكن من إعادة استخدامها أو الكتابة فوقها.

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

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

## 🎯 الميزات

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

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

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

## 💡 نصائح وحيل

* استرجع القيمة المخزنة لاحقًا باستخدام كتلة `Data Read Global`.
* للمشاركة قصيرة المدى أو المحلية للحلقات، فضّل استخدام `Data Write Local` و`Data Read Local` بدلاً من التخزين العام.
* لتجنّب كتابة قيم فارغة، اجمعها مع `Is None` أو `Replace None` قبل الكتابة.
* أضف طوابع زمنية بدمج مع `Date-Time` أو `Date-Time List` عندما تحتاج سجلات بالقيم.
* لعمليات التسجيل أو التصدير، قُم بإقرانها مع `Data to JSON` و`CSV Export` لتسلسل وحفظ البيانات.
* بالنسبة لبيانات الصور، فكّر باستخدام `Image Logger` أو `Image Write` بالإضافة إلى التخزين العام لحفظ الصور على القرص.
* استخدم `Logic Input` للتحكم في توقيت الكتابة (الكتابة فقط عند حدث) واستخدم `Debug Input` لفحص القيم أثناء التطوير.
* إذا أردت تجميد قيمة لا يجب أن تتحدّث في كل تشغيل، استخدم `Data Memory` للتحكم بموعد التحديثات.

## ⚠️ تحذيرات

* قد يخلق التخزين العام تبعيات ضمنية. تجنّب الإفراط في استخدام الكتابات العامة للبيانات التي تُحدَّث كثيرًا في تدفقات حساسة للأداء أو الوقت.
* قد تحدث تصادمات في التسمية إذا استخدمت عدة كتل نفس المفتاح عن غير قصد. استخدم مفاتيح وصفية ومتسقة واعتمد على الاقتراحات التلقائية لتقليل الأخطاء.