> 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/spanish/function-blocks/blocks-reference/data-logic/referencing/data-read-local.md).

# Data Read Local

Lee un valor almacenado en el almacenamiento local del escenario y lo emite para que otros bloques lo utilicen. Útil cuando necesitas compartir valores dentro del mismo escenario (por ejemplo dentro de bucles o entre diferentes ramas) sin depender de conexiones directas.

## 📥 Entradas

Este bloque no tiene entradas.

## 📤 Salidas

`Generic`\
Este socket emite el valor recuperado del almacenamiento local para la clave indicada. Si la clave no se encuentra, se produce un valor por defecto seguro y se muestra una advertencia.

## 🕹️ Controles

`Data Key`\
Introduce la clave de texto utilizada para buscar el valor en el almacenamiento local. El campo ofrece sugerencias de autocompletado para claves locales existentes y así evitar errores de tipeo.

## ⚙️ Mecanismo de ejecución

* Cuando se ejecuta el escenario, el bloque usa el texto del control `Data Key` para buscar un valor en el almacenamiento local del escenario.
* Si existe una entrada coincidente, ese valor se envía a través del socket de salida `Generic`.
* Si no hay entrada coincidente, el bloque produce un valor por defecto seguro y muestra una advertencia para que sepas que la clave no se encontró.

## ✨ Features

* Acceso de lectura al almacenamiento local para compartir datos en todo el escenario sin conexiones directas.
* Autocompletado para el control `Data Key` para reducir errores tipográficos y acelerar la configuración.
* Comportamiento seguro por defecto y advertencia visible cuando falta una clave.

## 📝 Usage

1. Escribe el nombre del valor que quieres leer en el control `Data Key` (usa el autocompletado para seleccionar claves existentes).
2. Ejecuta el escenario. El bloque emitirá el valor almacenado al socket `Generic` cuando esté disponible.
3. Usa bloques aguas abajo para procesar, mostrar o exportar el valor.

Ejemplos de usos comunes:

* Leer contadores, flags o resultados intermedios que se almacenaron anteriormente en el escenario.
* Extraer valores de configuración colocados en el almacenamiento local por un paso de inicialización.

## 💡 Tips and Tricks

* Para guardar un valor que este bloque pueda leer, empáralo con el bloque `Data Write Local`. Escribe una vez, lee donde lo necesites en el mismo escenario.
* Si necesitas que los datos persistan entre ejecuciones o estén disponibles globalmente, usa `Data Write Global` y `Data Read Global` en su lugar.
* Usa `Is None` o `Replace None` después de este bloque para proporcionar valores de respaldo y evitar errores aguas abajo cuando falte una clave.
* Combínalo con `Debug Input` para inspeccionar rápidamente el valor recuperado en el log mientras construyes el escenario.
* Para registrar o exportar valores leídos, conecta la salida a `CSV Export` u otros bloques de exportación.
* Al construir subsistemas o bucles, `Data Read Local` junto con `Subsystem` o `Data Memory` puede ayudar a coordinar el estado sin cableado adicional.

## 🛠️ Troubleshooting

* No aparece ningún valor: verifica la ortografía exacta de la `Data Key`. Usa la lista de autocompletado del control para confirmar las claves existentes.
* Advertencia sobre clave faltante: indica que la clave no se encontró en el almacenamiento local. Considera crear la clave antes en el escenario con `Data Write Local` o manejar el valor faltante usando `Replace None`.
* Tipo de valor inesperado: recuerda que el bloque emite exactamente lo que se almacenó. Usa bloques de comprobación o conversión de tipos aguas abajo si necesitas un tipo específico.