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) ومخزّن في السيناريو.

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