> 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/input-output/communication/opc-ua-read.md).

# OPC UA Read

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

## 📥 المدخلات

* `Client` — مقبس الإدخال الذي يقبل اتصال عميل OPC UA نشط.
* `Node Address` — مقبس الإدخال الذي يقبل عنوان/معرّف المتغير المراد قراءته على الخادم.

## 📤 المخرجات

* `Value` — مقبس الإخراج الذي يوفر القيمة الحالية المقروءة من عنوان OPC UA المحدد.

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

* لا يعرض هذا البلوك عناصر واجهة إضافية داخل البلوك نفسه. يُعد مقبسا الإدخال (`Client` و `Node Address`) هما عناصر التحكم الفعلية: زوّد مقبس `Client` بعميل متصل وأدخل العنوان المطلوب قراءته في `Node Address`.

## 🎯 الميزات

* قراءة متزامنة بسيطة لقيمة واحدة من عنوان OPC UA عند التقييم.
* واجهة مختصرة: يتطلب فقط عميلًا نشطًا وعنوان عقدة.
* يعيد القيمة المسترجعة مباشرة عبر مخرج `Value` للمعالجة اللاحقة.
* يسجل الأخطاء لمساعدة تشخيص مشاكل الاتصال أو أخطاء العنوان.

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

عند تشغيل البلوك، يتوقع وجود عميل OPC UA نشط على مدخل `Client` ومعرّف متغير صالح على مدخل `Node Address`. يطلب البلوك القيمة الحالية من ذلك العنوان ويوصلها عبر مخرج `Value` حتى تتمكن البلوكات الأخرى من استهلاكها أو تسجيلها.

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

* للحصول على `Client` صالح، استخدم أولاً بلوك `OPC UA Client` وصل مخرجه `Client` بمدخل `Client` في هذا البلوك.
* لمعاينة أو تصحيح نتائج القراءة، وصل مخرج `Value` إلى `Debug Input` أو إلى `CSV Export` لتسجيل القيم مع مرور الوقت.
* استخدم `Data Write Global` / `Data Read Global` لمشاركة القيم المقروءة عبر أجزاء مختلفة من السيناريو.
* أرسل القيم المقروءة إلى أنظمة خارجية بالاتصال ببلوكس مثل `MQTT Publish` أو `REST API - Post`.
* إذا كنت تقرأ عناوين عديدة بانتظام، فكّر في تجميع القراءات أو ترتيبها بواسطة بلوكات منطقية (مثل بلوكات التحكم بالتدفق أو التجميع) للحفاظ على تنظيم السيناريو.

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

* عدم عودة قيمة / خطأ حول العميل: تأكد أن مدخل `Client` يحتوي على عميل OPC UA متصل (استخدم بلوك `OPC UA Client`).
* عنوان غير صالح أو قيمة غير متوقعة: تحقق من صيغة ومعرّف `Node Address` على خادم OPC UA لديك.
* أخطاء صلاحية أو أمان: تحقق من حقوق الوصول وإعدادات سياسات الأمان على الخادم؛ تأكد من صحة بيانات الاعتماد وإعدادات الخادم.
* اتصال متقطع: قد تتسبب مشاكل الشبكة أو حمل الخادم بفشل القراءات — راقب السجلات وأعد المحاولة عند الحاجة.
* للحصول على رؤية أفضل أثناء التطوير، وصل مخرج `Value` إلى `Debug Input` لرؤية النتائج الخام ومساعدة التشخيص.