Condições relacionadas ao iterador

Um iterador de loop é uma variável que rastreia a iteração atual dentro de um loop. Ele é usado para controlar o número de vezes que o loop é executado e para acessar elementos em uma lista ou matriz durante cada iteração.

Por exemplo, se você estiver percorrendo uma lista de itens, o iterador de loop ajudará você a acessar cada item um por um até que o loop seja concluído. O pacote Loop fornece diversas condições de iterador para controlar a iteração de loops.
Tabela 1. Iteradores de loop
Iterador Descrição
Para cada linha no CSV/TXT Repete o conjunto de ações para cada linha no arquivo CSV ou de texto especificado e atribui os valores na linha atual a uma variável de registro. Consulte Como usar o iterador Para cada linha em CSV/TXT.
Para cada linha no Tabela de dados Repete o conjunto de ações para cada linha na tabela especificada e atribui os valores na linha atual a uma variável de registro. Consulte Como usar o iterador Para cada linha da tabela.
Para cada linha em um conjunto de dados de consulta SQL Repete o conjunto de ações para cada linha no conjunto de dados SQL especificado e atribui os valores na linha atual a uma variável de registro. Informe o nome da sessão que você usou para estabelecer uma conexão com o banco de dados.
Para cada chave no Dicionário Repete o conjunto de ações para cada chave na variável dicionário especificada e atribui o nome da chave atual a uma variável.
Nota: Quando um bot executa uma ação Loop que contém uma ação Dicionário > Colocar, o bot somente itera no número original de itens de um dicionário, ignorando itens inseridos usando a ação Colocar.
Para cada valor no Dicionário Repete o conjunto de ações para cada valor na variável Dicionário especificada e atribui o valor atual a uma variável. Como esse tipo de variável pode conter vários subtipos (String, Number, Boolean e assim por diante), se você criar rapidamente uma variável enquanto configura a ação, a variável será de tipo Any.
Nota: Quando um bot executa uma ação Loop que contém uma ação Dicionário > Colocar, o bot somente itera no número original de itens de um dicionário, ignorando itens inseridos usando a ação Colocar.
Para cada e-mail na caixa de entrada Repete o conjunto de ações para cada e-mail na caixa de entrada especificada. Consulte Como usar o iterador Para cada e-mail na caixa de correio.
Para cada linha da planilha (Excel básico ou Excel avançado) Repete o conjunto de ações para cada linha que contém dados em uma planilha e atribui os valores na linha atual a uma variável de registro. Informe o nome da sessão que você usou para abrir a planilha Excel básico ou Excel avançado. Especifique se deve repetir as ações para todas as linhas, linhas especificadas ou um intervalo especificado de células. Selecione uma variável de registro na lista Assign the current row to this variable (Atribuir a linha atual a esta variável) ou crie uma nova. Consulte Registrar variável.
Esse iterador recupera valores de célula como tipos de dados de string. É compatível com formatos de célula do Excel, incluindo Número, Porcentagem, Moeda, Científico e Data. Por exemplo, um valor de uma célula de formatação de Moeda retém o símbolo de moeda quando passado para uma tabela ou variável de registro.
  • Você deve converter os valores para executar operações não string.
  • No Excel avançado, ao escolher o iterador de loop como Para cada linha na planilha, você tem uma opção Ler para ler o texto visível ou o valor da célula.

    Por exemplo, se a célula tiver 70% como conteúdo da célula, a opção Read cell value (Ler valor da célula) lerá o valor como 70 ignorando o formato % enquanto a opção Read visible text (Ler texto visível)lerá o conteúdo como 70%.

    Recommendation: Use a opção Read cell value (Ler valor da célula) como o valor de leitura de uma célula para um melhor desempenho do que ler o texto visível.

O uso da opção Sessão global para compartilhar uma sessão do Microsoft Excel usando o pacote Excel avançado não está disponível com esta opção.

Solução alternativa: Use a ação Obter várias células e salve os dados em uma variável de tabela de dados e, então, use o pacote Loop com a opção Tabela de dados selecionada.
Para cada arquivo na pasta Repete o conjunto de ações para cada arquivo na pasta especificada e atribui as propriedades do arquivo atual a uma variável dicionário que contém duas chaves: a chave name contém o nome do arquivo e a chave extension mantém a extensão do arquivo.

Para abrir arquivos com diferentes extensões, use a opção variável para atribuir o caminho da pasta, nome do arquivo e extensão do arquivo . Primeiro, crie uma variável para o caminho da pasta, $sFolder$. Em seguida, para os arquivos no caminho da pasta, crie duas variáveis, uma para o nome do arquivo $name$ e outra para extensão de arquivo $extension$. Para abrir um arquivo, combine as variáveis como uma string, tais como $sFolder$\$name$.$extension$. Para que a extensão funcione com diferentes tipos de arquivos e diferentes opções abertas, você pode adicionar lógica condicional.

Para cada pasta na pasta Repete o conjunto de ações para cada pasta na pasta especificada e atribui o nome da pasta atual a uma variável string.

Use a opção Incluir todas as subpastas para iterar recursivamente em cada subpasta de uma pasta, incluindo pastas ocultas.
Para cada item da lista Repete o conjunto de ações para cada item na lista especificada e atribui o item atual a uma variável. Especifique se deve repetir a ação para todos os itens na lista ou apenas para o intervalo de itens na lista. Como esse tipo de variável pode conter vários subtipos (String, Número, Booleano e assim por diante), se você criar rapidamente uma variável enquanto configura a ação, a variável é de Qualquer tipo.
Nota: O índice em uma lista começa em zero. Por exemplo, para repetir a ação para itens da terceira posição para a sexta posição da lista, especifique 2 e 5 nos campos apropriados.
Por n vezes Repete as ações no contêiner pelo número especificado de vezes. Você pode atribuir a contagem de iterações a uma variável numérica.
Para cada valor no registro Repete as ações para cada valor no registro especificado e atribui o valor atual a uma variável. Como esse tipo de variável pode conter vários subtipos (String, Number, Boolean e assim por diante), se você criar rapidamente uma variável enquanto configura a ação, a variável será de tipo Any.
Para cada reunião do calendário Use essa opção para repetir o conjunto de ações para cada reunião especificada no calendário. Consulte Uso de ações Microsoft 365 Calendar em um loop.
Para cada linha da planilha (Microsoft 365 Excel) Repete o conjunto de ações para cada linha que contém dados em uma planilha.
  • Informe o nome da sessão que você usou para abrir a planilha.
  • Especifique se deve repetir as ações para todas as linhas ou linhas específicas.
  • Você pode atribuir os valores na linha atual a uma variável de registro.
Para cada item de trabalho na fila (Carga de trabalho) Repete o conjunto de ações para cada item de trabalho em uma fila e atribui os itens de trabalho a Registrar variável. Registrar variável retorna três valores-chave fixos, a saber: workitemId, workitemValues e workitemMetadata. Consulte Usando o iterador Para cada item de trabalho na fila
Para cada nó em um conjunto de dados XML Repete o conjunto de ações para cada nó em um conjunto de dados XML e atribui o nó atual à variável string. Informe o nome da sessão que você usou para abrir o arquivo XML.