Centro de soporte de Workiva

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

Paso 1. Establecer una variable para el valor del número

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

1. En la cadena, añade 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 de la orden que da salida al número de iteraciones, añade un evento Establecer variable dinámica de la cadena:
   
   
   • Selecciona la variable dinámica creada para el número de iteraciones.
   • En Valor e introduce su valor inicial, por ejemplo 1.
     
     

Paso 2. Añadir un grupo de comandos

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

1. Después del evento Establecer variable de cadena dinámica, añade Grupo de comandos, y arrastra un Vinculo a entre ellos.
2. Selecciona el grupo y haz clic en Editar.
3. En la pestaña Iteraciones repetir del Grupo, activa Iterador repetir. 
   
4. En Selecciona el Tipo de modificador, selecciona Repetir hasta .
5. Haz clic en Regla, selecciona un tipo de datos de Flotante y especifica cuándo detener las iteraciones. Por ejemplo, para iterar basándote en la salida Total de registros de un comando anterior, establece una regla para detener las iteraciones cuando el valor de la variable sea mayor que (>) la salida Total de registros.
6. Añade los comandos para iterar al Grupo.
   
   

Etapa 3. Añadir un evento para incrementar el valor de la variable.

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

1. Como última etapa del grupo, añade otro evento Establecer variable de cadena dinámica:
   
   
   • Selecciona la variable dinámica creada para el número de iteraciones.
   • En Valor, selecciona la misma variable.
2. Para transformar el valor, haz clic en la variable en Valor, y añade una transformación Analizar número.
   
3. Añadir un Añadir transformación con un valor de 1, y hacer clic en Aceptar.

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

Paso 1. Establecer variables para los valores condicionales

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

1. En la cadena, añade 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 de la orden que da salida a los valores de las condiciones, añade un Establecer variable dinámica de la cadena evento, selecciona las variables dinámicas e introduce sus valores iniciales.
   
   Por ejemplo, introduce el valor de la clave boolean como Verdadero y el valor del desplazamiento como 0.
   
   

Paso 2. Añadir un grupo de comandos

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

1. Después del evento Establecer variable de cadena dinámica, añade Grupo de comandos, y arrastra un Vinculo a entre ellos.
2. Selecciona el grupo y haz clic en Editar.
3. En la pestaña Iteraciones repetir del Grupo, activa Iterador repetir. 
   
4. En Selecciona el Tipo de modificador, selecciona Repetir hasta .
5. Haz clic en Regla, y especifica cuándo detener las iteraciones, por ejemplo, cuando la clave booleana sea Falso.
6. Añade los comandos para iterar al Grupo.
   
   

Etapa 3. Establece los valores de las variables con cada iteración

Como último paso del grupo, añade otro evento Establecer variable de cadena dinámica para establecer o incrementar los valores de las variables con cada iteración.

• Para establecer los valores de las variables, asigna cada variable a sus respectivos resultados desde el comando anterior. Por ejemplo, para la variable Boolean, selecciona el resultado de la clave boolean; para la variable Desplazamiento, el parámetro de desplazamiento entero.
• Para incrementar una variable, como Desplazamiento, haz clic en su valor y, a continuación, aplica una transformación Parsear número y una transformación Añadir con el valor a incrementar con cada iteración.