Data Write Local

Ce bloc de fonction enregistre les données entrantes dans un stockage local du scénario afin que d'autres blocs puissent les lire plus tard. Utilisez-le lorsque vous devez conserver une valeur (image, nombre, texte, liste, etc.) à travers différentes parties de votre scénario ou pour créer de simples boucles de rétroaction. Remarque : ce bloc permet la création de boucles mais ne garantit pas l'ordre d'exécution ni l'intégrité du flux de données — utilisez-le avec précaution.

📥 Entrées

Generic Cette prise accepte n'importe quel type de donnée à stocker.

📤 Sorties

Ce bloc de fonction ne produit pas de sorties.

🕹️ Contrôles

Data Key Saisissez une clé (chaîne) pour identifier la valeur que vous stockez. Utilisez des noms clairs et uniques afin que les autres blocs puissent lire la bonne donnée.

• L'autocomplétion aide à choisir des clés locales existantes quand elles sont disponibles.

• Les clés sont des libellés en texte simple ; la correspondance doit être exacte lors de la lecture.

⚙️ Fonctionnement

• Lorsque le bloc s'exécute, toute valeur présente sur l'entrée Generic est sauvegardée sous la clé choisie Data Key dans le stockage local du scénario.

• Si aucune donnée n'est fournie, rien n'est écrit.

• La valeur sauvegardée reste disponible pour d'autres blocs qui lisent la même clé jusqu'à ce qu'elle soit écrasée ou que le scénario se termine.

🎯 Fonctionnalités

• Stocke n'importe quel type de donnée (images, nombres, listes, texte).

• Stockage persistant simple à l'intérieur du scénario en cours d'exécution.

• Autocomplétion pour les clés locales existantes afin de réduire les fautes de frappe.

• Conçu pour partager rapidement des résultats intermédiaires et permettre des boucles locales.

📝 Utilisation

1. Tapez un nom descriptif dans Data Key (par exemple last_detection ou calibration_matrix).

2. Connectez un bloc producteur à l'entrée Generic afin qu'une valeur soit fournie à l'exécution.

3. Utilisez un bloc de lecture correspondant (par exemple Data Read Local) ailleurs dans le scénario pour récupérer la valeur avec la même clé.

💡 Conseils et astuces

• Utilisez des noms de clés explicites (par exemple inclure le type ou la source : camera1_frame, threshold_value) pour éviter les écrasements accidentels.

• Pour relire la valeur stockée dans le même scénario, utilisez Data Read Local. Pour partager des données entre scénarios, utilisez Data Write Global et Data Read Global.

• Combinez avec Data Memory si vous souhaitez qu'une valeur reste inchangée jusqu'à sa mise à jour explicite.

• Si vous voulez exporter des données structurées plus tard, convertissez-les en un format lisible avec Data to JSON puis sauvegardez avec CSV Export ou d'autres blocs d'export.

• Utilisez Debug Input pour inspecter rapidement ce qui est écrit sous une clé donnée pendant la construction du flux.

• Utilisez Replace None avant l'écriture si vous voulez garantir une valeur de secours lorsque l'entrée est vide.

✅ Bonnes pratiques

• Évitez de réutiliser la même clé pour des types de données non liés (par ex. image vs nombre) — préférez des clés distinctes.

• Gardez les clés lisibles par l'humain pour faciliter le débogage et la maintenance.

• Lorsque vous construisez des boucles de rétroaction, soyez explicite sur les blocs qui lisent et écrivent la même clé pour réduire l'ambiguïté.

🛠️ Dépannage

• Aucune valeur trouvée lors de la lecture : vérifiez l'orthographe exacte de la clé Data Key dans les blocs d'écriture et de lecture.

• Type de valeur inattendu : vérifiez quel bloc a écrit en dernier sur la même clé et assurez-vous d'une cohérence des types de données.

• Difficultés pour tracer les données : ajoutez Debug Input ou un Data Read Local temporaire connecté à une sortie visible pour inspecter les valeurs stockées.

• Conditions de concurrence / problèmes d'ordre : souvenez-vous que ce stockage local ne garantit pas l'ordre d'exécution — concevez le flux en conséquence ou réorganisez-le en utilisant des blocs de contrôle/flux plus explicites.