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 Loop package 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 actions 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 Data Table Repete o conjunto de actions 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 actions 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 Dictionary Repete o conjunto de actions 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 action de Loop que contém uma action Dicionário > Colocar, o bot apenas itera no número original de itens de um dicionário; ele ignora itens inseridos usando a action Colocar.
Para cada valor no Dictionary Repete o conjunto de actions 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, Número, Booliano e assim por diante), se você criar com rapidez uma variável enquanto configura a ação, a variável é de tipo Qualquer um.
Nota: Quando um bot executa uma action de Loop que contém uma action Dicionário > Colocar, o bot somente itera no número original de itens de um dicionário; ele ignora itens inseridos usando a action Colocar.
Para cada e-mail na caixa de entrada Repete o conjunto de actions 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 basic ou Excel advanced) Repete o conjunto de actions 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 basic ou Excel advanced. Especifique se deve repetir as actions 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 advanced, 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%.

    Recomendação: 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 Excel advanced package não está disponível com esta opção.

Solução alternativa: Use a action Obter várias células e salve os dados em uma variável de tabela de dados e, em seguida, use o package Loop com a opção Tabela de dados selecionada.
Para cada linha na tabela da planilha

(Apple Numbers)
  • Use uma das seguintes opções para fornecer o nome da sessão:
    • Nome da sessão: Insira o nome da sessão usada para abrir a planilha com a Abriraction.
    • Variable (Variável): Informe a variável de sessão que você adicionou na action Abrir.
  • Especifique o nome da tabela para recuperar os valores.
  • Selecione uma das seguintes opções para fazer o loop:
    • Toda a linha: selecione essa opção para extrair todos os dados da tabela inteira, incluindo todas as linhas e colunas dessa tabela.
    • Linhas específicas: selecione essa opção para extrair dados somente da linha especificada na tabela. Preencha os seguintes campos:
      • Da linha: especifique o número da linha da qual deseja que o valor seja recuperado. Por exemplo, 10
      • Até a linha: especifique o número da linha até o qual você deseja que o valor seja recuperado. Por exemplo, 40
    • Intervalo de células: Selecione essa opção para extrair dados de um bloco retangular especificado de células definido por uma célula inicial e uma célula final (por exemplo, de B2 a D5). Preencha os seguintes campos:
      • Da célula: Especifique o endereço da célula da qual você deseja que o valor seja recuperado. Por exemplo, A1
      • Até a célula: Especifique o endereço da célula até o qual você deseja que o valor seja recuperado. Por exemplo, C20
  • Escolha na opção Tipo de valor para ler o texto visível ou o valor da célula:
    • Texto visível
    • Valor da célula

    Por exemplo, se a célula tiver 70% como conteúdo da célula, a opção Valor da célula lerá o valor como 70 ignorando o formato %, enquanto a opção Texto visível lerá o conteúdo como 70%.

  • No campo Atribuir o valor atual a esta variável, selecione uma variável de registro ou crie uma para manter a saída. Além disso, você pode armazenar a saída em várias variáveis, informando a chave e a variável para a qual a chave é mapeada.
Para cada arquivo na pasta Repete o conjunto de actions 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 actions 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 actions para cada item na lista especificada e atribui o item atual a uma variável. Especifique se deve repetir a action 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 action, a variável é de Qualquer tipo.
Nota: O índice em uma lista começa em zero. Por exemplo, para repetir a action 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 actions 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 actions 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, Número, Booliano e assim por diante), se você criar com rapidez uma variável enquanto configura a ação, a variável é de tipo Qualquer um.
Para cada reunião do calendário Use essa opção para repetir o conjunto de actions 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 actions 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 actions para todas as linhas ou linhas específicas.
  • Você pode atribuir os valores na linha atual a uma variável de registro.
Para cada e-mail na caixa de entrada (Apple Mail) Consulte Como usar o iterador Para cada e-mail na caixa de entrada para o Apple Mail
Para cada e-mail na caixa de entrada (Microsoft 365 Outlook) Repete o conjunto de actions para cada e-mail na caixa de entrada Microsoft 365 Outlook.
  • Informe o nome da sessão que você usou na action Conectar.
  • Especifique o status do e-mail que deseja usar no iterador. Por exemplo, para usá-lo em e-mails que você ainda não leu, selecione Não lidos.
  • Defina a ordem em que você deseja que os e-mails sejam classificados selecionando uma das seguintes opções no campo Classificar e-mail:
    • O último primeiro: Quando a versão Microsoft 365 Outlook package for atualizada para 1.6.1 ou posterior, as automações existentes e novas terão essa configuração ativada, e todos os e-mails na caixa de entrada serão classificados pelo método LIFO por padrão.
    • O mais antigo primeiro: Esta configuração habilita o método FIFO para ordenar os e-mails na caixa de entrada. Esta configuração é aplicável para todos os Microsoft 365 Outlook actions que podem ser realizados usando iteradores de loop, tais como:
      • Alterar status
      • Excluir
      • Encaminhar
      • Responder
      • Salvar anexos
      • Salvar e-mail
  • Defina o formato da mensagem para HTML ou texto sem formatação.
  • Selecione um fuso horário específico.
Microsoft Outlook (macOS) — para cada e-mail na caixa de correio Consulte Como usar o iterador de loop para Microsoft Outlook (macOS).
Para cada chat do usuário (Microsoft Teams) Consulte Using the For each chat of the user iterator
Para cada canal em uma equipe (Microsoft Teams) Consulte Using the For each channel in a team iterator
Para cada mensagem em um canal (Microsoft Teams) Consulte Using the For each message in a channel iterator
Para cada mensagem em um chat (Microsoft Teams) Consulte Como usar o iterador Para cada mensagem em um chat
Para cada equipe (Microsoft Teams) Consulte Using the For each team iterator
Para cada item de trabalho na fila (Workload) Repete o conjunto de actions para cada item de trabalho em uma fila e atribui os itens de trabalho em Registrar variável. Registrar variável retorna três valores de 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 actions 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.