Data Read Global

Ce bloc de fonction lit une valeur stockée dans le stockage de données global de la scène du projet en cours. Utilisez-le lorsque vous devez récupérer des données enregistrées ailleurs et les partager entre différentes parties de votre scénario.

📥 Entrées

Ce bloc de fonction ne possède aucune prise d'entrée.

📤 Sorties

• Generic — À l'exécution, cette sortie fournit la valeur associée à la clé globale demandée. Si la clé est introuvable, un avertissement est émis et une valeur de remplacement peut être renvoyée (voir Résolution des problèmes).

🕹️ Contrôles

• Data Key — Saisissez le nom exact de la clé de données globale que vous souhaitez lire.

🎯 Fonctionnalités

• Lecture depuis un stockage global accessible par d'autres blocs et scènes.

• Complétion automatique (autocomplete) pour les clés globales existantes afin de réduire les erreurs de frappe.

• Émet une seule sortie Generic pouvant contenir n'importe quel type de donnée pris en charge.

📊 Évaluation

Lorsque le scénario s'exécute, le bloc recherche la Data Key fournie dans le stockage global et renvoie la valeur stockée sur la sortie Generic. Si la clé est absente, un avertissement est généré et une valeur substitutive est retournée.

📝 Instructions d'utilisation

1. Indiquez exactement le nom de la clé dans le contrôle Data Key.

2. Placez ce bloc à l'endroit du scénario où vous devez consommer la donnée globale.

3. Utilisez la sortie Generic comme entrée du bloc qui a besoin de la donnée.

💡 Conseils et astuces

• Pour enregistrer des valeurs à récupérer plus tard, utilisez le bloc Data Write Global en combinaison avec ce bloc.

• Si vous avez besoin d'un stockage temporaire ou local à une boucle, préférez Data Read Local et Data Write Local pour un flux de données plus isolé.

• Combinez avec Is None ou Replace None lorsque la clé peut être manquante, afin de fournir des valeurs par défaut.

• Utilisez Data Memory si vous souhaitez figer une valeur en mémoire jusqu'à mise à jour explicite.

• Pour déboguer, dirigez la sortie vers Debug Input pour inspecter les valeurs récupérées dans le journal.

• Pour exporter les valeurs récupérées de façon structurée, associez à Data to JSON ou CSV Export.

🛠️ Résolution des problèmes

• No value returned — Vérifiez que la Data Key correspond exactement à la clé utilisée lors de l'écriture des données. Les fautes de frappe sont la cause la plus fréquente.

• Key not found — Si un avertissement indique une clé manquante, assurez-vous que le bloc qui a écrit la donnée s'est exécuté plus tôt dans le scénario. Envisagez d'utiliser Data Write Global pour créer la clé avant la lecture.

• Unexpected data type — Si les blocs consommateurs attendent un type spécifique, validez la valeur récupérée avec Data Type Converter ou gérez les types manquants/incorrects avec Replace None.

✅ Bonnes pratiques

• Utilisez des noms de clés clairs et descriptifs pour éviter les collisions (par exemple, préfixez par le nom de la scène ou le sous-système).

• Dans les boucles ou flux parallèles, favorisez le stockage local lorsque c'est possible pour éviter les conditions de concurrence ; n'utilisez le stockage global que lorsque le partage inter-scope est volontaire.

• Protégez les lectures avec des vérifications comme Is None pour rendre vos flux robustes face aux données manquantes.