> 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/tag-from.md).

# Tag From

هذا البلوك يعرّض قيمة تحت اسم وسم تحدده أنت بحيث يمكن الرجوع إليها في أجزاء أخرى من السيناريو. استخدم بلوكات `Tag To` لإرسال المتغيرات إلى أجزاء من التدفق أو بينها، و`Tag From` لعرضها أو قراءتها من التخطيط البصري.

## 📥 المدخلات

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

## 📤 المخرجات

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

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

`Tag Name` — حقل نصي تكتب فيه معرف الوسم. يقدم الحقل اقتراحات إكمال تلقائي لأسماء الوسوم الموجودة لتجنب الأخطاء الإملائية.

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

## 🎯 الميزات

* إدخال عام بسيط لربط أي بيانات باسم وسم.
* إكمال تلقائي للاسم لتسريع الإعداد وتقليل الأخطاء.
* تحقق مدمج لمنع تعريف وسوم مكررة أو تعارضات في الكتابة على الوسم.
* ملاحظات بصرية عندما يكون البلوك غير صحيح حتى تتمكن من العثور على مشاكل التكوين بسرعة.

## 📝 طريقة العمل

1. عرّف الوسم بكتابة اسم في حقل `Tag Name`.
2. وصل البيانات التي تريد عرضها إلى مدخل `Generic`.
3. سيقوم البلوك بالتحقق من اسم الوسم وإظهار أي تعارضات.
4. استخدم بلوكات `Tag To` والبلوكات المرجعية مثل `Data Read Local`، `Data Read Global`، إلخ، لتبادل أو قراءة القيمة في أماكن أخرى من السيناريو.

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

* لإرسال القيم من أجزاء أخرى من التدفق، استخدم `Tag To` مع هذا البلوك بحيث يُشارك نفس اسم الوسم بين المرسل والمستقبل.
* لمشاركة أو الحفاظ على قيمة الوسم خارج التدفق الفوري، اجمعه مع `Data Write Local` / `Data Read Local` أو `Data Write Global` / `Data Read Global`.
* استخدم `Debug Input` لفحص القيم المارة عبر مدخل `Generic` أثناء التطوير بسرعة.
* جمد أو خزّن القيم باستخدام `Data Memory` إذا أردت أن تبقى قيمة الوسم ثابتة حتى تقوم بتحديثها صراحةً.
* عند مشاركة بيانات مُهيكلة، اقترن مع `Data to JSON` لإنشاء حمولة JSON للتسجيل أو التصدير عبر `CSV Export` أو `Image Logger` عند الاقتضاء.

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

* خطأ وسم مكرر\
  إذا رأيت تحذيرًا بوجود وسم مكرر، غيّر الاسم في حقل `Tag Name` بحيث يكون لكل بلوك `Tag From` وسم فريد.
* تعارض في الكتابات\
  سيشير البلوك إلى خطأ إذا حاول بلوك `Tag To` الكتابة على نفس الوسم بطريقة تُحدث تعارضًا. تحقق من أسماء الوسوم وتدفق البيانات المقصود.
* لا توجد بيانات متاحة\
  إذا لم تظهر أي قيمة للوسم، تأكد من أن البلوك المصدر متصل بمدخل `Generic` ويُنتج قيمة. استخدم بلوكات `Is None` أو `Replace None` للحماية في المنطق اللاحق إذا كان من الممكن أن يكون الوسم فارغًا.
* الاقتراح التلقائي لا يعرض الأسماء المتوقعة\
  الاقتراح التلقائي يجلب أسماء الوسوم من السيناريو الحالي. إذا كان الاسم مفقودًا، تأكد أن الوسم المتوقع مُعرف في مكان آخر (مثلاً باستخدام `Tag To`) ومخزّن في السيناريو.

إذا احتجت لتمرير قيم بين أنظمة فرعية أو الحفاظ على قيم عبر تكرارات متعددة، فكر في إقران هذا البلوك مع بلوكات المرجعية والتخزين المذكورة أعلاه للحصول على تدفقات أكثر موثوقية وقابلية للصيانة.