Get Data By Index

Get Data By Index es un componente sencillo que te permite extraer un valor específico de tus datos. Solo necesitas indicar la clave donde se encuentra la información y el índice del elemento que quieres obtener. Si la clave apunta a una lista, puedes usar índices negativos para acceder desde el final (por ejemplo, -1 devuelve el último elemento).

¿Cómo funciona?

El componente trabaja de forma local dentro del flujo de datos de Nappai. Cuando lo activas, revisa el objeto que le pasas en la entrada Data y busca la clave indicada en Key. Si la clave contiene puntos (.), el componente navega por los niveles anidados hasta encontrar la lista o el diccionario deseado. Luego, con el valor de Index, selecciona el elemento correspondiente. Si no se proporciona un índice, devuelve la posición numérica de cada elemento dentro de la lista (0, 1, 2, …). El resultado se entrega en la salida Data.

Entradas

• Data: Los datos que quieres procesar. Pueden ser cualquier estructura JSON (diccionario, lista, etc.) que provenga de un componente anterior.
• Key: La clave que identifica el valor que quieres extraer. Usa notación de punto para acceder a datos anidados, por ejemplo orders.items. Si la clave apunta a una lista, el componente buscará el elemento en la posición indicada por Index.
• Index: El número que indica la posición del elemento dentro de la lista. Soporta índices negativos (-1 = último, -2 = penúltimo, etc.). Si lo dejas vacío, el componente devuelve la posición de cada elemento en la lista.

Salidas

• Data: El valor extraído según la clave y el índice. Si la clave no existe o el índice está fuera de rango, la salida será null o un mensaje de error que puedes manejar con un componente de control de flujo.

Ejemplo de Uso

Supongamos que tienes una lista de pedidos en la entrada Data: json { “orders”: [ {“id”: 101, “total”: 250}, {“id”: 102, “total”: 175}, {“id”: 103, “total”: 300} ] }

1. Key: orders
2. Index: 1 (segundo pedido)

El componente devolverá: json {“id”: 102, “total”: 175}

Si quieres obtener el último pedido, cambia Index a -1 y obtendrás: json {“id”: 103, “total”: 300}

Componentes Relacionados

• Get Data By Key – Extrae un valor sin usar índice, ideal para diccionarios.
• Filter Data – Permite filtrar listas según condiciones.
• Map Data – Aplica una función a cada elemento de una lista.

Consejos y Mejores Prácticas

• Verifica la existencia de la clave antes de usar el componente para evitar errores de “clave no encontrada”.
• Usa índices negativos cuando necesites acceder a los últimos elementos sin conocer la longitud exacta de la lista.
• Combina con “Filter Data” si necesitas extraer un elemento que cumpla una condición específica antes de usar el índice.
• Maneja los casos de error con un componente de “Try/Catch” o “If/Else” para que el flujo continúe sin interrupciones.

Consideraciones de Seguridad

El componente procesa datos localmente dentro del entorno de Nappai y no realiza llamadas externas. Asegúrate de que los datos que ingresas no contengan información sensible que no deba ser expuesta en el flujo de trabajo. Si trabajas con datos confidenciales, considera encriptar o anonimizar la información antes de pasarla a este componente.