Utilizar iteradores con comandos y grupos de comandos

Un iterador puede repetir un comando o grupo sobre un número exacto de valores, como un total de páginas de salida de un comando anterior en la cadena.

Etapa 1. Configure una variable para el valor numérico.

Para indicar el número de iteraciones, cree una variable de cadena dinámica:

1. En la cadena, agregue una variable dinámica para el número de iteraciones, como Contador, sin valor inicial.
   
2. Para establecer el valor inicial de la variable cuando se ejecuta la cadena, después del comando que da salida al número de iteraciones, agregue un evento Set dynamic chain variable:
   
   
   • Seleccione la variable dinámica creada para el número de iteraciones.
   • En Valor, e introduzca su valor inicial, por ejemplo 1.
     
     

Etapa 2. Agregar un grupo de comandos

Para indicar los comandos a iterar y la regla de iteración, agrega un grupo de comandos:

1. Después del evento Establecer variable de cadena dinámica, añade Grupo de comandos, y arrastra un enlace entre ellos.
2. Seleccione el grupo y haga clic en Editar.
3. En la pestaña Iteraciones repetir del grupo, habilite Iterador repetir.
   
4. En Seleccione el Tipo de modificador, seleccione Repetir hasta.
5. Haga clic en + Regla, seleccione un tipo de datos de Flotante, y especifique cuándo detener las iteraciones. Por ejemplo, para iterar basándose en la salida Total de registros de un comando anterior, establezca una regla para detener las iteraciones cuando el valor de la variable sea mayor que (>) la salida Total de registros.
6. Agregar los comandos para iterar al grupo.
   
   

Etapa 3. Agregar un evento para incrementar el valor de la variable

Para incrementar el valor de la variable con cada iteración:

1. Como último paso del grupo, agregue otro evento Establecer variable de cadena dinámica:
   
   
   • Seleccione la variable dinámica creada para el número de iteraciones.
   • En Valor, seleccione la misma variable.
2. Para transformar el valor, haga clic en la variable en Valor, y agregue una transformación Parse Number.
   
3. Agregar una transformación Agregar con un valor de 1, y haga clic en Aceptar.

Si se desconocen los valores o el número exacto de valores, puede iterar en función de si se cumplen determinadas condiciones. Por ejemplo, puede repetir un comando mientras o hasta que existan los criterios especificados.

Etapa 1. Configure las variables para los valores condicionales.

Para representar las condiciones que indican valores sobre los que iterar, cree variables de cadena dinámicas. Por ejemplo, si un comando proporciona una salida de clave booleana para indicar si su respuesta contiene páginas adicionales y un parámetro de desplazamiento entero para identificar cada página, cree variables para estos valores:

1. En la cadena, agrega una variable dinámica para cada condición, sin valor inicial.
   
2. Para establecer los valores iniciales de las variables cuando se ejecuta la cadena, después del comando que emite los valores de las condiciones, agregue un evento Establecer variable dinámica de la cadena , seleccione las variables dinámicas e introduzca sus valores iniciales.
   
   Por ejemplo, introduzca el valor de la clave booleana como True y el valor de offset como 0.
   
   

Etapa 2. Agregar un grupo de comandos

Para indicar los comandos a iterar y la regla de iteración, agrega un grupo de comandos:

1. Después del evento Establecer variable de cadena dinámica, añade Grupo de comandos, y arrastra un enlace entre ellos.
2. Seleccione el grupo y haga clic en Editar.
3. En la pestaña Iteraciones repetir del grupo, habilite Iterador repetir.
   
4. En Seleccione el Tipo de modificador, seleccione Repetir hasta.
5. Haga clic en + Regla, y especifique cuándo detener las iteraciones, por ejemplo, cuando la clave booleana sea False.
6. Agregar los comandos para iterar al grupo.
   
   

Etapa 3. Establezca los valores de las variables en cada iteración.

Como última etapa del grupo, agregue otro evento Set dynamic chain variable para establecer o incrementar los valores de las variables con cada iteración.

• Para establecer los valores de las variables, asigne cada variable a sus respectivas salidas del comando anterior. Por ejemplo, para la variable Boolean, seleccione la salida de clave booleana; para la variable Offset, el parámetro offset entero.
• Para incrementar una variable, como Offset, haga clic en su valor, y luego aplique una transformación Parse Number y una transformación Add con el valor a incrementar con cada iteración.