Uso para cada tarea de bucle

En este instructivo, se muestra cómo usar la tarea Para cada bucle con la concatenación de strings. En este instructivo, crearás dos integraciones; una integración principal y una subintegración. Los bucles de integración principal recorren un array de strings y, para cada elemento del array, llama a la subintegración que realiza la concatenación. El resultado después de ejecutar la integración principal es una string concatenada.

Para completar este instructivo, realiza las siguientes tareas:

Crea la integración principal

Para crear una integración nueva, sigue estos pasos:

  1. Ve a la IU de Apigee y accede.
  2. Selecciona tu organización mediante el menú desplegable que se encuentra en la esquina superior izquierda de la IU.
  3. Haz clic en Desarrollar > Integraciones.
  4. Haz clic en Create new (Crear nueva).
  5. Ingresa un nombre y una descripción en el diálogo Crear integración.
  6. En la lista de regiones compatibles, selecciona Región para la integración.
  7. Haz clic en Crear para abrir el diseñador de integración.
  8. En el diseñador de integración, haz clic en + Agregar una tarea o un activador > Activador > Activador de API.
  9. Arrastra el elemento Activador de API al diseñador de integración.
  10. Haz clic en +Agregar una tarea o un activador > Tareas > Para cada bucle.
  11. Arrastra el elemento Para cada bucle al diseñador de integración.
  12. Agrega una conexión (perímetro) desde el elemento Activador de API al elemento Para cada bucle:
    1. Haz clic en el ícono Bifurcar junto al elemento Activador de API.
    2. Sin dejar de pulsar el puntero del mouse, arrástralo hasta una región dentro del elemento Para cada bucle.
    3. Libera el puntero del mouse.

Crea variables en la integración principal

Crea las siguientes variables en la integración principal:

  • WordArray: Un array de strings. Los valores del array se envían a la subintegración para la concatenación.
  • TempString: Una variable de string temporal
Para crear la función, realiza los siguientes pasos:
  1. En la integración principal, haz clic en VAR en la barra de menú.
  2. Haga clic en Agregar +.
  3. En el diálogo Crear Variable, configure las siguientes propiedades:
    • Nombre: Ingresa WordArray.
    • Tipo de datos: Selecciona String Array
    • Valor predeterminado: Ingresa Hello, World, Apigee, Integrations
  4. Haga clic en Crear.
  5. Haga clic en Agregar +.
  6. En el diálogo Crear Variable, configure las siguientes propiedades:
    • Nombre: Ingresa TempString.
    • Tipo de datos: Selecciona String
  7. Haga clic en Crear.
  8. Haz clic en Aceptar para cerrar el cuadro de diálogo Variables.

Crea la subintegración

Ahora, crea una subintegración (integración nueva) que concatene la string.

Para crear la integración, realiza los siguientes pasos:

  1. En la IU de Apigee, haz clic en Desarrollar > Integraciones.
  2. Haz clic en Create new (Crear nueva).
  3. Ingrese un nombre y una descripción para la integración y, luego, haga clic en Crear.
  4. En el diseñador de integración, haz clic en + Agregar una tarea o un activador > Activador > Activador de API.
  5. Arrastra el elemento Activador de API al diseñador de integración.
  6. Haz clic en +Agregar una tarea o un activador > Tareas > Asignación de datos.
  7. Arrastra el elemento Asignación de datos al diseñador de integración.
  8. Agrega una conexión (perímetro) desde el elemento activador de API al elemento de asignación de datos.

Crea variables en la subintegración

Crea las siguientes variables en la subintegración:

  • SubIntegrationInput: Es una variable de entrada de la integración. Cuando se ejecuta la subintegración, esta variable contiene un valor de la variable WordArray de la integración principal.
  • SubIntegrationOutput: Es una variable de salida de la integración. Cuando la subintegración completa una ejecución, esta variable tiene la string concatenada.
  • SubIntegrationAnteriorValue: Es una variable de entrada que contiene la string concatenada intermitente para cada bucle. Este valor para esta variable se pasa desde la integración principal.
Para crear un clúster, realiza los siguientes pasos:
  1. En la integración principal, haz clic en VAR en la barra de menú.
  2. Haga clic en Agregar +.
  3. En el diálogo Crear Variable, configure las siguientes propiedades:
    • Nombre: Ingresa VARIABLE_NAME.
    • Tipo de datos: Selecciona String
  4. Especifica si la variable es una variable de entrada o de salida:
    • Si creas la variable SubIntegrationInput o SubIntegrationPreviousValue, selecciona Usar como entrada de una integración.
    • Si creas la variable SubIntegrationOutput, selecciona Usar como salida de la integración.
  5. Haga clic en Crear.
Repite los pasos para crear cada variable en la subintegración.

Configura la subintegración

Para configurar la integración, realiza los siguientes pasos:
  1. Haz clic en el elemento de asignación de datos para ver el panel de configuración.
  2. Haz clic en .
  3. En el Editor de asignación de datos, haz lo siguiente:
    1. Arrastre la variable SubIntegrationPreviousValue a la columna Entrada.
    2. En la variable SubIntegrationPreviousValue, haz clic en Agregar función y selecciona CONCAT.
    3. Arrastra la variable SubIntegrationInput a la función CONCAT.
    4. Arrastra la variable SubIntegrationOutput a la columna Salida.
  4. Cierra el Editor de asignación de datos.
  5. Haz clic en Publish (Publicar).

Configura y ejecuta la integración principal

Ahora, regresa a la integración principal y configúrala para llamar a la subintegración.

Para configurar la integración principal, realiza los siguientes pasos:

  1. Abre la integración principal en el diseñador de integración.
  2. Haz clic en el elemento Para cada bucle a fin de ver el panel de configuración de la tarea.
  3. Establece las siguientes propiedades en el panel de configuración:
    • Lista para iterar: selecciona WordArray.
    • ID del activador de API: Ingresa el ID del activador de la subintegración. Puedes obtener el valor del ID de activador desde el elemento Activador de API de la subintegración.
    • Nombre de la integración: Ingresa el nombre de la subintegración.
    • Asignación de subintegración del elemento de iteración: selecciona SubIntegrationInput.
    • Asignación de anulación de parámetro de respuesta:
      • En el menú desplegable Subintegración de resultados desde el que se debe asignar, selecciona SubIntegrationOutput.
      • En el menú desplegable Integration variable para anular, selecciona TempString.
    • Asigna a entradas de subintegración adicionales:
      • En el menú desplegable Variable de integración para asignar desde, selecciona TempString.
      • En el menú desplegable Subintegración de asignación a la que se asignará, selecciona SubIntegrationPreviousValue.
  4. Haz clic en Publish (Publicar).

Si la integración principal y la secundaria se ejecutan correctamente, en el diálogo de resumen de ejecución, puedes ver la string concatenada HelloWorldApigeeIntegrations en la variable TempString.