Loop pacote

Use o Loop pacote para executar uma sequência de ações repetidamente por um número específico de vezes ou até que uma condição específica seja alcançada.

O pacote Loop permite que você execute repetidamente ações específicas dentro de um bot. Por exemplo, repita o conjunto de ações que leem os dados de cada linha de um arquivo Microsoft Excel, renomeie todos os arquivos em uma pasta e salve cada e-mail em uma caixa de entrada. Você também pode usar a ação Se dentro da Loop ação para validar uma condição e, com base no resultado, ignorar a interação atual no loop ou mesmo partir o loop.

Para loops condicionais, diferentes ações são realizadas, dependendo se os parâmetros condicionais são atendidos. Para loops que têm um número especificado de iterações, o loop sai na última iteração e vai para a próxima etapa no bot.

Quando se executa uma sequência de ações repetidamente para um número específico de vezes dentro de um loop, a condição final dentro do loop é avaliada em cada iteração.

Por exemplo, quando se faz um loop por meio de uma Tabela de dados que tem 10 colunas, insira valores dinâmicos de contagem de colunas para a condição final no loop, use a ação Tabela de dados > Excluir coluna para excluir a coluna do índice 0 dentro do corpo do loop e, em seguida, execute o bot. O bot excluirá uma coluna em cada iteração. Portanto, ele reduz a contagem da iteração porque a condição final do loop é avaliada em cada iteração.

Nota: Você pode executar os bots com um número máximo de 97 loops aninhados.

Etiquetas do loop

Você pode usar o campo Etiqueta no ações do Loop pacote para rotular os loops usados em um bot. Ao rotular os loops, é possível quebrar ou continuar um loop específico de loops aninhados.
Nota: Para utilizar esta funcionalidade, certifique-se de construir a bots utilizando a versão Loop pacote (3.7.4) para utilizar esta funcionalidade. Este recurso não é compatível com versões anteriores.
Para adicionar etiquetas ao Loop, Continuar, ou Pausar ações, no campo Etiqueta, especifique uma etiqueta para o loop.
Nota:
  • Garanta que cada etiqueta de loop em uma bot específica é única.
  • O campo Etiqueta suporta apenas caracteres alfanuméricos.
O exemplo seguinte descreve como utilizar o campo Etiqueta para quebrar ou continuar um loop em um bot:
  • No campo Etiqueta do primeiro Loop ação, especifique uma etiqueta como outerloop.
  • No campo Etiqueta do segundo Loop ação, especifique uma etiqueta como innerloop.
  • No Loop > Continuar ação, no campo Etiqueta, selecione a etiqueta do loop que deseja continuar.
  • No Loop > Pausar ação, no campo Etiqueta, selecione a etiqueta do loop que deseja pausar.

Clique no vídeo para ver como funcionam os loops de etiquetagem.

Em uma bot, se você tiver vários loops aninhados com Loop > Continuar e Pausar ações dentro dos loops aninhados, e se você não tiver rotulado os loops, então em execução de bot, a bot pausa ou continua o loop mais próximo por padrão.

Por exemplo, você tem:
  • Um loop externo e um loop interno aninhados dentro do loop externo.
  • Um Loop > Continuar e Pausar ação dentro do loop interno.
Se você não tiver rotulado nenhum desses loops, quando você executar o bot, o bot irá pausar ou continuar o loop mais próximo (o loop interno).

Ações no Loop pacote

As seguintes ações Loop estão disponíveis:

Ação Descrição
Loop Consulte Como usar o Loop ação.
Continuar

Consulte Continuar ação.

Consulte Se pacote.
Interrupção

Consulte Ação de Romper.

Consulte Se pacote.

Condições relacionadas ao iterador dentro da Loop ação

Selecione a opção Iterador para especificar o número de vezes que o conjunto de ações será repetido como parte da Loop ação:

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, 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: 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 Excel avançadopacote não está disponível com esta opção.

Solução alternativa: Use a ação Obter múltiplas células e salve os dados em uma variável datável e, então, use o Looppacote 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 o 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, 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..
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 na planilha (Excel do Office 365) 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 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.

Enquanto as condições relacionadas na Loop ação

Você pode configurar várias condições dentro de uma única ação Loop:
  1. Clique em Adicionar condição.
  2. Selecione uma das seguintes opções:
    • E: Ambas as condições devem ser atendidas para o ações a ser executado.
    • Ou: Qualquer uma das condições deve ser atendida para o ações a ser executado.
  3. Selecione as condições na lista suspensa.
Selecione a opção Enquanto para usar as seguintes condições:
Enquanto Descrição
Aplicativo Use a condição O aplicativo não está sendo executado ou O aplicativo está sendo executado para executar ações conforme um aplicativo esteja sendo executado ou não.

Insira o caminho do aplicativo ou especifique o caminho por meio de uma variável juntamente com o tempo a esperar (em segundos) para que a condição seja verdadeira.

Nota: As condições Aplicativo está em execução e o Aplicativo não está em execução não são aplicáveis para bots Internet Explorer porque seu processo iexplore.exe correspondente funciona em segundo plano quando Microsoft Edge é lançado em Modo IE.
Booliano Use esta condição para executar as ações com base no valor de uma variável Booliano. Use essa condição para comparar os valores de duas variáveis booleanas ou uma variável booleana com um valor booleano selecionado.
Tabela de dados Use a condição A tabela de dados está vazia para executar ações conforme a tabela especificada contenha valores.

Use as condições Número de linhas e Número de colunas para executar ações conforme o número de colunas ou linhas seja Igual a, Maior que ou Menor que o valor especificado.

Data/hora Use a condição Variável Data/hora para executar ações conforme o valor da variável data/hora de origem seja Igual a ou Diferente de, Maior que ou Igual a, ou Menor que ou Igual a o valor da variável data/hora de destino.
Dicionário Use essa condição para repetir o conjunto de ações com base em se a variável dicionário selecionada contém a chave especificada.
Nota: A comparação das chaves fará distinção entre maiúsculas e minúsculas.
Arquivo Use as seguintes condições para executar a ação:
  • Data do arquivo

    Use esta condição para verificar a data e hora em que o arquivo foi criado ou modificado. Especifique um intervalo de datas com as opções Em uma data Está dentro dos últimos, Está entre ou Está antes. Para a opção Em uma data especificar uma data para verificar se o arquivo foi criado ou modificado naquela data. Na opção Está dentro dos últimos, especifique o número de dias ou o tempo (em horas, minutos e segundos). Insira o tempo (em segundos) a esperar para que essa condição seja verdadeira.

  • O arquivo existe e O arquivo não existe

    Use estas condições para executar uma ação com base no fato de um arquivo existir ou não. Por exemplo, se houver um arquivo de dados, formate e faça upload do arquivo para um banco de dados.

  • Extensão do arquivo

    Use esta condição para verificar a extensão de um arquivo selecionado e depois execute ações com base nos resultados. Use o campo Caminho do arquivo para selecionar um arquivo.

  • Tamanho do arquivo

    Esta condição verifica se o arquivo especificado é maior, menor ou igual ao tamanho especificado.

    Insira o tempo (em segundos) a esperar para que essa condição seja verdadeira.

O Pasta existe ou não existe Use essas condições para repetir o conjunto de ações com base na existência ou não de uma pasta.
Reconhecimento de imagem Use estas condições para verificar se:
  • Arquivo de imagemencontrado no Arquivo de imagem ou não.
  • Arquivo de imagem encontrado na Janela ou não.
  • Janela encontrada no Arquivo de imagem ou não.
  • Janela encontrada na Janela ou não.
Para as condições de Janela, você pode usar a opção Redimensionar janela para especificar as dimensões da janela. Essa opção proporciona um bot confiável. Redimensiona a janela para as dimensões nas quais a tarefa foi registrada, o que aumenta a capacidade do bot de identificar o objeto alvo.
Nota: Essa opção só está disponível para janelas que podem ser redimensionadas. Não está disponível para as opções Desktop ou Barra de tarefas.

Para as condições de Janela, você pode usar a opção Visualizar para selecionar uma ocorrência específica capturada e posicionar seu local de clique em relação à imagem.

JavaScript Use a condição Script bem-sucedido ou Script malsucedido para executar ações com base no status do JavaScript especificado. Selecione o arquivo que contém o script e, opcionalmente, especifique os parâmetros selecionando uma variável de lista.
Automação de legado As condições de Automação de legado são usadas apenas em bots migrados, para garantir que sejam executadas perfeitamente no Automation 360. Não recomendamos o uso dessas condições para o desenvolvimento de novo bot. As seguintes condições para verificar o seguinte:
  • Se o Controle da web existe ou não.
  • Se o Controle de janelas existe ou não.
  • Se o Controle de janelas está ativo ou não.
  • Se o Script foi bem-sucedido ou não.
  • Se a Janela secundária existe ou não.

Para as condições de Controle da janela, você pode usar a opção Redimensionar janela para especificar as dimensões da janela. Essa opção proporciona um bot confiável. Redimensiona a janela para as dimensões nas quais a tarefa foi registrada, o que aumenta a capacidade do bot de identificar o objeto alvo.

Lista Use a condição Variável da lista para executar ações conforme a variável de lista especificada tenha um valor específico ou não. O valor pode ser um Número, uma String ou um tipo de dado Booleano.
Número Use a condição Variável numérica para executar ações conforme a variável numérica especificada seja Igual a ou Diferente de, ou Maior que ou Igual a, ou Menor que ou Igual a um determinado valor.
Ping Use a condição O Ping foi bem-sucedido ou O Ping foi malsucedido para verificar se uma máquina ou servidor está sendo executado e execute açãos com base no resultado. Insira o tempo (em segundos) a esperar para que a condição seja verdadeira.
Gravador
  • Use a condição O objeto existe para detectar um objeto em uma janela. Selecione uma janela ou variável para capturar o objeto. Insira o tempo em segundos para esperar que essa condição seja verdadeira, ou seja, para que o objeto seja detectado.
  • Use a condição O objeto não existe para verificar se um objeto específico existe em uma janela e, então, com base no resultado, executar ações. Insira o tempo (em segundos) a esperar para que essa condição seja verdadeira. Por exemplo, você pode usar a condição O objeto não existe dentro da condição Loop > Enquanto para se certificar de que o bot não executa a próxima ação até que o objeto no aplicativo de negócios seja carregado.
Nota: As condição do gravador O objeto existe e O objeto não existe suportam o modo baseado em Microsoft Edge Chromium com Internet Explorer.
Serviço Use a condição O serviço está em execução ou O serviço não está em execução para executar ações conforme um serviço esteja em execução ou não. Selecione Lista de serviços para escolher um serviço na lista de serviços disponíveis.
String Use a condição Variável de string para executar ações conforme o valor especificado da string de origem seja Igual a ou Não igual a ou Inclui ou Não inclui o valor-alvo.

Você pode selecionar a opção Diferenciar maiúsculas e minúsculas para executar apenas ações se as duas strings tiverem letras maiúsculas e minúsculas correspondentes.

Ao extrair texto de um aplicativo Microsoft, o texto extraído contém os caracteres especiais /r/n que indicam uma nova linha. Selecione a opção Ignorar código de fim de linha se desejar ignorar o caractere especial /r ao comparar o texto.

A fim de criar uma condição conforme uma string esteja vazia ou não, compare o valor de origem a um campo de destino vazio usando o operador Igual a.

Consulte Exemplo de como usar uma instrução condicional.

Task Bot Use a condição Tarefa bem-sucedida ou Tarefa malsucedida para executar ações com base no status do Task Bot especificado.
VBScript Use a condição Script bem-sucedido ou Script malsucedido para executar ações com base no status do script Visual Basic especificado. Selecione o arquivo que contém o script e, opcionalmente, especifique os parâmetros selecionando uma variável.
Janela Use a condição A janela existe ou A janela não existe para verificar se uma janela específica do aplicativo está aberta ao inserir o Título da janela ou usando uma variável. Insira o tempo (em segundos) a esperar para que a condição seja verdadeira. Essas condições são usadas quando o título da janela permanece constante e para verificar se a janela específica está aberta e executar outras ações com base na saída.

Use a condição Não existe janela com o mesmo título ou Existe janela com o mesmo título para verificar se existe uma janela com o mesmo título ou se o título da janela foi alterado. Digite o tempo em segundos para continuar verificando se a condição é verdadeira. Essas condições são usadas para títulos de janela dinâmicos. Por exemplo, quando você abre uma página da conta do Google, digite seu nome de usuário e senha para fazer login em sua conta, o título da janela muda. Se você deseja compor um novo e-mail como próxima ação você pode usar essas condições antes de executar o próxima ação para verificar se a janela com o mesmo título existe ou se o título foi alterado.

Condições do grupo

Verwenden Sie die Option Gruppe hinzufügen, um mehrere boolesche Bedingungen hinzuzufügen oder mehrere Bedingungen mit den Optionen und und oder innerhalb einer Gruppe zu kombinieren, wenn Sie möchten, dass der bot mehrere Bedingungen gleichzeitig prüft, bevor er eine Reihe von ações ausführt.

Sie können eine Gruppe auch innerhalb einer Gruppe hinzufügen.