> 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/data-read-local.md).

# Data Read Local

Lit une valeur stockée dans le stockage local du scénario et la fournit en sortie pour que d'autres blocs puissent l'utiliser. Utile lorsque vous devez partager des valeurs à l'intérieur d'un même scénario (par exemple dans des boucles ou entre différentes branches) sans dépendre de connexions directes.

## 📥 Entrées

Ce bloc n'a aucune entrée.

## 📤 Sorties

`Generic`\
Ce socket renvoie la valeur récupérée du stockage local pour la clé spécifiée. Si la clé n'est pas trouvée, une valeur par défaut sûre est produite et un avertissement est affiché.

## 🕹️ Contrôles

`Data Key`\
Saisissez la clé texte utilisée pour rechercher la valeur dans le stockage local. Le champ propose l'auto-complétion pour les clés locales existantes afin d'éviter les erreurs de saisie.

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

* Lorsque le scénario s'exécute, le bloc utilise le texte du contrôle `Data Key` pour chercher une valeur dans le stockage local du scénario.
* Si une entrée correspondante existe, cette valeur est envoyée via la sortie `Generic`.
* S'il n'y a pas d'entrée correspondante, le bloc produit une valeur par défaut sûre et affiche un avertissement pour indiquer que la clé n'a pas été trouvée.

## ✨ Fonctionnalités

* Accès en lecture au stockage local pour partager des données dans le scénario sans liaisons directes.
* Auto-complétion pour le contrôle `Data Key` afin de réduire les fautes de frappe et accélérer la configuration.
* Comportement par défaut sûr et avertissement visible lorsqu'une clé est manquante.

## 📝 Utilisation

1. Tapez le nom de la valeur que vous souhaitez lire dans le contrôle `Data Key` (utilisez l'auto-complétion pour sélectionner une clé existante).
2. Exécutez le scénario. Le bloc renverra la valeur stockée sur le socket `Generic` lorsque disponible.
3. Utilisez des blocs en aval pour traiter, afficher ou exporter la valeur.

Exemples d'utilisation courants :

* Lire des compteurs, des drapeaux ou des résultats intermédiaires stockés précédemment dans le scénario.
* Récupérer des valeurs de configuration placées dans le stockage local par une étape d'initialisation.

## 💡 Conseils et astuces

* Pour enregistrer une valeur que ce bloc pourra lire, associez-le au bloc `Data Write Local`. Écrire une fois, lire où nécessaire dans le même scénario.
* Si vous avez besoin que les données persistent entre les exécutions ou soient disponibles globalement, utilisez `Data Write Global` et `Data Read Global`.
* Utilisez `Is None` ou `Replace None` après ce bloc pour fournir des valeurs de secours et éviter les erreurs en aval lorsqu'une clé est manquante.
* Combinez avec `Debug Input` pour inspecter rapidement la valeur récupérée dans les logs pendant la construction du scénario.
* Pour journaliser ou exporter les valeurs lues, connectez la sortie à `CSV Export` ou à d'autres blocs d'export.
* Lors de la création de sous-systèmes ou de boucles, `Data Read Local` avec `Subsystem` ou `Data Memory` peut aider à coordonner l'état sans câblage supplémentaire.

## 🛠️ Dépannage

* Aucune valeur n'apparaît : vérifiez l'orthographe exacte de la clé dans `Data Key`. Utilisez la liste d'auto-complétion pour confirmer les clés existantes.
* Avertissement de clé manquante : cela signifie que la clé n'a pas été trouvée dans le stockage local. Envisagez de créer la clé plus tôt dans le scénario avec `Data Write Local` ou gérez la valeur manquante avec `Replace None`.
* Type de valeur inattendu : rappelez-vous que le bloc renvoie exactement ce qui a été stocké. Utilisez des blocs de vérification de type ou de conversion en aval si vous avez besoin d'un type spécifique.