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

# Tag From

Ce bloc fonctionnel expose une valeur sous un nom de tag défini par l'utilisateur afin qu'elle puisse être référencée ailleurs dans le scénario. Utilisez les blocs `Tag To` pour envoyer des variables vers d'autres parties de votre flux et `Tag From` pour exposer ou lire ces valeurs depuis la mise en page visuelle.

## 📥 Entrées

`Generic`\
Connectez toute valeur ou donnée que vous souhaitez associer au tag (nombres, texte, images, listes, etc.).

## 📤 Sorties

Ce bloc fonctionnel ne fournit pas de sorties directes.

## 🕹️ Contrôles

`Tag Name`\
Un champ texte où vous saisissez l'identifiant du tag. Le champ propose des suggestions d'autocomplétion pour les noms de tags existants afin d'éviter les erreurs de frappe.

* Saisissez un nom court et descriptif que les autres blocs utiliseront pour référencer cette valeur.
* Le contrôle valide l'unicité du tag et affichera une erreur si un tag en double est présent.

## 🎯 Fonctionnalités

* Entrée générique simple pour associer n'importe quelle donnée à un nom de tag.
* Autocomplétion pour le `Tag Name` afin d'accélérer la configuration et réduire les erreurs.
* Validation intégrée pour éviter les définitions de tags en double et les écritures conflictuelles.
* Retour visuel lorsque le bloc est invalide pour repérer rapidement les problèmes de configuration.

## 📝 Comment ça marche

1. Définissez le tag en saisissant un nom dans le contrôle `Tag Name`.
2. Connectez la donnée que vous souhaitez exposer à l'entrée `Generic`.
3. Le bloc validera le nom du tag et indiquera tout conflit éventuel.
4. Utilisez les blocs `Tag To` et les blocs de lecture référencés (`Data Read Local`, `Data Read Global`, etc.) pour échanger ou lire la valeur ailleurs dans votre scénario.

## 💡 Astuces et conseils

* Pour envoyer des valeurs depuis d'autres parties du flux, utilisez `Tag To` conjointement avec ce bloc afin que l'émetteur et le récepteur partagent le même nom de tag.
* Pour conserver ou partager la valeur du tag en dehors du flux immédiat, combinez avec `Data Write Local` / `Data Read Local` ou `Data Write Global` / `Data Read Global`.
* Utilisez `Debug Input` pour inspecter rapidement les valeurs transmises à l'entrée `Generic` pendant le développement.
* Geler ou mettre en cache des valeurs avec `Data Memory` si vous souhaitez que la valeur du tag reste stable jusqu'à mise à jour explicite.
* Pour partager des données structurées, associez à `Data to JSON` pour créer une charge JSON destinée au logging ou à l'export via `CSV Export` ou `Image Logger` si besoin.

## 🛠️ Dépannage

* Erreur "Duplicate tag found"\
  Si vous voyez un avertissement de tag en double, changez le nom dans le champ `Tag Name` afin que chaque bloc `Tag From` ait un tag unique.
* Écritures conflictuelles\
  Le bloc signalera une erreur si un bloc `Tag To` tente d'écrire sur le même tag de manière conflictuelle. Vérifiez les noms de tags et le flux de données prévu.
* Aucune donnée disponible\
  Si aucune donnée n'est disponible pour le tag, assurez-vous que le bloc source est connecté à l'entrée `Generic` et produit bien une valeur. Utilisez `Is None` ou `Replace None` pour protéger la logique en aval si le tag peut être vide.
* Autocomplétion ne listant pas les noms attendus\
  L'autocomplétion suggère les noms de tags collectés dans le scénario courant. Si un nom manque, vérifiez que le tag attendu est bien défini ailleurs (par exemple avec `Tag To`) et enregistré dans le scénario.

Si vous devez transmettre des valeurs entre sous-systèmes ou conserver des valeurs entre itérations, associez ce bloc aux blocs de référence et de stockage cités ci‑dessus pour des flux robustes et faciles à maintenir.