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

# OPC UA Read

Ce bloc de fonction lit une valeur depuis une adresse d'un serveur OPC UA et renvoie la valeur courante pour une utilisation ailleurs dans votre scénario. Il est prévu pour des lectures simples et synchrones lorsque vous disposez déjà d'une connexion client active.

## 📥 Entrées

* `Client` — prise d'entrée qui accepte une connexion client OPC UA active.
* `Node Address` — prise d'entrée qui accepte l'adresse/identifiant de la variable à lire sur le serveur.

## 📤 Sorties

* `Value` — prise de sortie qui fournit la valeur actuelle lue depuis l'adresse OPC UA donnée.

## 🕹️ Contrôles

* Ce bloc n'expose pas de widgets supplémentaires sur le bloc. Les deux prises d'entrée (`Client` et `Node Address`) font office de contrôles : fournissez un client connecté et l'adresse à lire.

## 🎯 Fonctionnalités

* Lecture synchrone simple d'une adresse OPC UA unique lors de l'évaluation.
* Interface minimale : nécessite uniquement un client actif et une adresse de nœud.
* Renvoie la valeur récupérée directement via la sortie `Value` pour une exploitation en aval.
* Enregistre les erreurs pour aider au diagnostic des problèmes de connectivité ou d'adresse.

## ⚙️ Mécanisme d'exécution

Lorsque le bloc s'exécute, il attend un client OPC UA actif sur l'entrée `Client` et un identifiant de variable serveur valide sur l'entrée `Node Address`. Le bloc demande la valeur courante à cette adresse et la fournit sur la sortie `Value` afin que d'autres blocs puissent la consommer ou l'enregistrer.

## 💡 Astuces et conseils

* Pour obtenir un `Client` utilisable, utilisez d'abord le bloc `OPC UA Client` et connectez sa sortie `Client` à l'entrée `Client` de ce bloc.
* Pour inspecter ou déboguer les résultats de lecture, connectez la sortie `Value` de ce bloc à `Debug Input` ou à `CSV Export` pour enregistrer les valeurs dans le temps.
* Utilisez `Data Write Global` / `Data Read Global` pour partager les valeurs lues entre différentes parties de votre scénario.
* Transmettez les valeurs lues vers des systèmes externes en les connectant à des blocs tels que `MQTT Publish` ou `REST API - Post`.
* Si vous lisez régulièrement de nombreuses adresses, envisagez de regrouper ou séquencer les lectures avec des blocs logiques (par ex. blocs de contrôle de flux ou de batching) pour garder votre scénario organisé.

## 🛠️ Dépannage

* Aucune valeur renvoyée / erreur concernant le client : assurez-vous que l'entrée `Client` est un client OPC UA connecté (utilisez le bloc `OPC UA Client`).
* Adresse invalide ou valeur inattendue : vérifiez le format et l'identifiant exact de `Node Address` sur votre serveur OPC UA.
* Erreurs de permissions ou de sécurité : contrôlez les droits d'accès du serveur et les politiques de sécurité du client ; vérifiez les identifiants et les paramètres du serveur.
* Connectivité intermittente : des problèmes réseau ou la charge du serveur peuvent provoquer des échecs de lecture — surveillez les logs et réessayez si nécessaire.
* Pour plus de visibilité, connectez la sortie `Value` à `Debug Input` lors du développement pour voir les résultats bruts et faciliter le diagnostic.