Get Value By Key

Get Value By Key te permite extraer el valor de un campo específico dentro de un objeto Data. Solo necesitas indicar el dato de entrada y la clave que deseas obtener. Si la clave incluye anidamientos, usa la notación con puntos (ejemplo: data.text).

¿Cómo funciona?

El componente recibe un objeto de datos (Data, Document o diccionario) y una clave. Internamente busca esa clave dentro del objeto, navegando a través de los niveles anidados si es necesario. Cuando la clave existe, devuelve únicamente el valor encontrado; si no existe, devuelve null o lanza un error según la configuración. No requiere llamadas a servicios externos y procesa los datos localmente dentro del flujo de Nappai.

Entradas

Campos de Entrada

• Input Data: Un solo objeto Data, Document o diccionario que contiene la información de la que quieres extraer un valor.
• Key: La clave que indica el valor a extraer. Usa la notación con puntos para acceder a valores anidados (por ejemplo, data.text).

Salidas

• Value: El valor extraído del objeto de entrada. El tipo de dato puede ser cualquier valor válido dentro del Data original (texto, número, objeto, etc.).

Ejemplo de Uso

Supongamos que tienes un objeto Data con la siguiente estructura: json { “id”: 123, “data”: { “text”: “Hola Mundo”, “author”: “Juan” } }

Para obtener el texto:

1. Conecta tu objeto Data al Input Data.
2. En el campo Key escribe data.text.
3. El componente devolverá Hola Mundo en la salida Value.

Este valor se puede usar en el siguiente paso de tu flujo, por ejemplo, para enviarlo a un chatbot, guardarlo en otra base de datos, etc.

Consejos y Mejores Prácticas

• Verifica la existencia de la clave antes de intentar extraerla para evitar errores inesperados.
• Usa nombres de claves descriptivos y consistentes con tu esquema de datos para facilitar el mantenimiento del flujo.
• Si necesitas usar el valor extraído en varios lugares, conecta la salida Value a otros componentes que lo requieran.