Centro de suporte da Workiva

Um iterador pode repetir um comando ou grupo em um número exato de valores, como um total de páginas de saída de um comando anterior na cadeia.

Etapa 1. Configure uma variável para o valor numérico

Para indicar o número de iterações, crie uma variável de cadeia dinâmica:

1. Na cadeia, adiciona uma variável dinâmica para o número de iterações, como Contador, sem valor inicial.
   
2. Para definir o valor inicial da variável quando a cadeia for executada, após o comando que gera o número de iterações, adicione um evento Definir variável de cadeia dinâmica:
   
   
   • Selecione a variável dinâmica criada para o número de iterações.
   • Em Valor, e digite seu valor inicial, como 1.
     
     

Etapa 2. Adicionar um grupo de comandos

Para indicar os comandos a serem iterados e a regra de iteração, adicione um grupo de comandos:

1. Após o evento Definir variável de cadeia dinâmica, adicione Command group e arraste um link entre eles.
2. Selecione o grupo e clique em Editar.
3. Na guia Iterações repetir do grupo, ative Iterador repetir. 
   
4. Em Selecione o tipo de modificador, selecione Repeat until (Repetir até).
5. Clique em + Rule, selecione um tipo de dados de Float e especifique quando parar as iterações. Por exemplo, para iterar com base na saída Total records de um comando anterior, defina uma regra para interromper as iterações quando o valor da variável for maior que (>) a saída Total records.
6. Adicione os comandos de iteração ao grupo.
   
   

Etapa 3. Adicione um evento para incrementar o valor da variável

Para incrementar o valor da variável a cada iteração:

1. Como última etapa do grupo, adicione outro evento Definir variável de cadeia dinâmica:
   
   
   • Selecione a variável dinâmica criada para o número de iterações.
   • Em Valor, selecione a mesma variável.
2. Para transformar o valor, clique na variável em Valor e adicione uma transformação Parse Number.
   
3. Adicione uma transformação Adicionar com um valor de 1 e clique em Aceitar.

Se os valores ou o número exato de valores forem desconhecidos, você poderá iterar com base no cumprimento de condições específicas. Por exemplo, você pode repetir um comando enquanto ou até que os critérios especificados existam.

Etapa 1. Configure as variáveis para os valores condicionais

Para representar as condições que indicam os valores a serem iterados, crie variáveis de cadeia dinâmica. Por exemplo, se um comando fornecer uma saída de chave booleana para indicar se sua resposta contém páginas adicionais e um parâmetro de deslocamento inteiro para identificar cada página, crie variáveis para esses valores:

1. Na cadeia, adiciona uma variável dinâmica para cada condição, sem valor inicial.
   
2. Para definir os valores iniciais das variáveis quando a cadeia for executada, após o comando que gera os valores das condições, adicione um Definir variável dinâmica da cadeia evento, selecione as variáveis dinâmicas e insira seus valores iniciais.
   
   Por exemplo, digite o valor da chave booleana como True e o valor de deslocamento como 0.
   
   

Etapa 2. Adicionar um grupo de comandos

Para indicar os comandos a serem iterados e a regra de iteração, adicione um grupo de comandos:

1. Após o evento Definir variável de cadeia dinâmica, adicione Command group e arraste um link entre eles.
2. Selecione o grupo e clique em Editar.
3. Na guia Iterações repetir do grupo, ative Iterador repetir. 
   
4. Em Selecione o tipo de modificador, selecione Repeat until (Repetir até).
5. Clique em + Rule e especifique quando interromper as iterações, por exemplo, quando a chave booleana for False.
6. Adicione os comandos de iteração ao grupo.
   
   

Etapa 3. Defina os valores das variáveis a cada iteração

Como última etapa do grupo, adicione outro evento Definir variável de cadeia dinâmica para definir ou incrementar os valores das variáveis a cada iteração.

• Para definir os valores das variáveis, mapeie cada variável para suas respectivas saídas do comando anterior. Por exemplo, para a variável Boolean, selecione a saída de chave booleana; para a variável Offset, o parâmetro de deslocamento inteiro.
• Para incrementar uma variável, como Offset, clique em seu valor e, em seguida, aplique uma transformação Parse Number e uma transformação Adicionar com o valor a ser incrementado a cada iteração.