Para cada

La actividad Para cada itera sobre las matrices y ejecuta un conjunto definido de pasos para cada elemento de la matriz. Utiliza la actividad Para cada para gestionar las respuestas de la API que contienen matrices de objetos, como listas de usuarios, pedidos o registros que requieren procesamiento individual.

Cómo agregar datos en una matriz

Un caso de uso común para la actividad Para cada es agregar datos de varias llamadas a la API en una matriz estructurada utilizando la actividad Script .

La actividad Para cada recopila automáticamente la salida de la última actividad dentro de su flujo de cuerpo y la compila en una matriz disponible en su propia salida.

Uso de la actividad Para cada

Para añadir una actividad Para cada a tu flujo de trabajo:

1. En el lienzo del diseñador de flujo de trabajo de la API, selecciona el icono más (+). Aparecerá el menú Añadir actividad .
2. Selecciona Bucle y, a continuación, ParaCada.
3. En el panel Propiedades , configura los siguientes campos:
   • En : utiliza el editor de expresiones para especificar la matriz para la iteración. Normalmente, esta matriz proviene de una respuesta API anterior.
   • Nombre del elemento : asigna un nombre de referencia para los elementos de la matriz (el valor predeterminado es currentItem). Utiliza esta referencia para acceder a cada elemento durante la iteración.
   • Acumular resultado : actívala para recopilar la salida de cada iteración en una única matriz de resultados, a la que puedes acceder más tarde en tu flujo de trabajo.
4. En el Cuerpo del bucle ParaCada , añade las actividades para procesar los elementos de la matriz.
5. Añade actividades a las ramas Then y Else según sea necesario.
6. Pruebe el flujo de trabajo para ejecutar la actividad y generar campos de salida para su uso posterior.

Ejemplo de actividad Para cada

El siguiente ejemplo itera sobre una matriz de objetos de empleado, combina el nombre y el apellido de cada empleado y devuelve los resultados agregados en una respuesta estructurada.

Abre la ventana de configuración Depurar , luego pega y guarda la siguiente sintaxis JSON:

{
    "employees": [
        {
            "first_name": "Bobbie",
            "last_name": "Draper",
            "position": "administration",
            "email": "[e-mail]"
        },
                {
            "first_name": "James",
            "last_name": "Holden",
            "position": "manager",
            "email": "[e-mail]"
        }
    ]
}

1. En el lienzo del diseñador de flujo de trabajo de la API, añade una actividad Para cada .
2. Configura los campos Para cada de la siguiente manera:
   • En—Usar el editor de expresiones para hacer referencia a la matriz employees desde la configuración de ejecución:

     $workflow.input.employees

   • Nombre del elemento : asigna un nombre de referencia para los elementos de la matriz (el valor predeterminado es currentItem). Utiliza esta referencia para acceder a cada elemento durante la iteración.
3. En el Cuerpo del bucle Para cada , añade una actividad Script .
4. Para la actividad Script , utiliza el editor de expresiones para crear un JSON que combine las propiedades first_name y last_name en un objeto:

   return {
       "name": $currentItem.first_name + " " + $currentItem.last_name
   }

5. Guarda la configuración.
6. Al final del flujo de trabajo, añade una actividad Respuesta .
7. Configura la respuesta de la siguiente manera:
   • Tipo : Correcto
   • Detalles : abre el editor de expresiones y escribe lo siguiente:

     $context.outputs.For_Each_2

   Este paso añade una validación al principio del flujo de trabajo para confirmar que existe una transacción válida antes del procesamiento.
8. Prueba el flujo de trabajo para ejecutar la actividad.
9. Consulta el panel de Salida para revisar la respuesta.