> 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-write-global.md).

# Data Write Global

Ce bloc fonction permet de stocker des données entrantes dans un stockage global accessible depuis tout le scénario. Utilisez-le pour partager des valeurs, des images ou des données structurées entre différentes parties de votre système ou pour créer un état global simple.

## 📥 Entrées <a href="#inputs" id="inputs"></a>

`Generic` — Prise d'entrée qui accepte n’importe quelle donnée à écrire dans le stockage global.

## 📤 Sorties <a href="#outputs" id="outputs"></a>

Ce bloc fonction n’a pas de sorties.

## 🕹️ Contrôles <a href="#controls" id="controls"></a>

`Data Key` — Champ texte où vous saisissez le nom de la clé utilisée pour stocker la donnée dans le stockage global. Le contrôle propose des suggestions basées sur les clés globales existantes afin que vous puissiez réutiliser ou écraser une clé.

## ⚙️ Mécanisme d'exécution <a href="#running-mechanism" id="running-mechanism"></a>

* Lorsque le bloc s’exécute, il lit la valeur fournie à l’entrée `Generic` et le texte dans `Data Key`.
* Si une valeur d’entrée est présente, le bloc écrit cette valeur dans le stockage global sous la `Data Key` choisie.
* Le stockage global est partagé dans tout le scénario. À cause de cette visibilité globale, l’utilisation de ce bloc peut créer des boucles implicites ou des interdépendances ; le bloc ne garantit pas un ordre strict dans le flux de données.

## 🎯 Fonctionnalités <a href="#features" id="features"></a>

* Partage de données persistant et disponible dans tout le scénario pour des valeurs, des images ou des données complexes.
* Autocomplétion des clés pour éviter les erreurs de saisie et encourager la réutilisation des clés.
* Moyens simples de transmettre des informations entre des parties éloignées d’un flux sans connexions directes.

## 📝 Instructions d'utilisation <a href="#usage" id="usage"></a>

1. Fournissez la valeur à stocker à la prise d’entrée `Generic`.
2. Saisissez ou sélectionnez un nom dans le contrôle `Data Key` pour identifier l’élément stocké.
3. Exécutez le scénario. La valeur sera disponible pour tout autre bloc qui lit depuis le stockage global en utilisant la même clé (par exemple via `Data Read Global`).

## 💡 Conseils et astuces <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* Récupérez la valeur stockée plus tard avec le bloc `Data Read Global`.
* Pour un partage de courte durée ou local à une boucle, préférez `Data Write Local` et `Data Read Local` plutôt que le stockage global.
* Pour éviter d’écrire des valeurs vides, combinez avec `Is None` ou `Replace None` avant l’écriture.
* Ajoutez des horodatages en combinant avec `Date-Time` ou `Date-Time List` si vous avez besoin d’enregistrements datés.
* Pour des workflows de journalisation ou d’export, associez avec `Data to JSON` et `CSV Export` pour sérialiser et sauvegarder les données.
* Pour les données image, envisagez d’utiliser aussi `Image Logger` ou `Image Write` afin de persister les images sur disque.
* Utilisez `Logic Input` pour contrôler quand l’écriture a lieu (écrire seulement sur un déclencheur) et utilisez `Debug Input` pour inspecter les valeurs pendant le développement.
* Si vous souhaitez geler une valeur qui ne doit pas être mise à jour à chaque exécution, utilisez `Data Memory` pour contrôler quand les mises à jour se produisent.

## ⚠️ Précautions <a href="#cautions" id="cautions"></a>

* Le stockage global peut créer des dépendances implicites. Évitez d’abuser des écritures globales pour des données mises à jour fréquemment dans des flux sensibles aux performances ou critiques en temps.
* Des collisions de noms peuvent survenir si plusieurs blocs utilisent involontairement la même clé. Utilisez des clés cohérentes et descriptives et fiez-vous à l’autocomplétion pour réduire les erreurs.
