Leia e revise a documentação do Automation Anywhere

Automation Anywhere Automation 360

Fechar conteúdo

Contents (Conteúdo)

Abrir conteúdo

Loop package

  • Atualizado: 2021/11/09
    • Automation 360 v.x
    • Criar
    • Espaço de trabalho RPA

Loop package

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

O package Loop permite que você execute repetidamente actions específicas dentro de um bot. Por exemplo, repita o conjunto de actions 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 action 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 actions 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.

Actions no Loop package

As seguintes actions Loop estão disponíveis:

Ação Descrição
Loop Repete a action por um número específico de vezes com base na opção selecionada na lista Iterador ou até que a condição seja atendida com base na opção selecionada na lista Condição. Consulte Uso da Loop action.
Continuar Use a action Continuarjuntamente com a action Se para ignorar a iteração atual e continuar com a próxima iteração no loop com base na condição especificada na action Se. Consulte If package.
Interrupção Você pode usar a action Romper juntamente com a action Se para terminar o loop conforme a condição especificada na action Se. Ao encerrar o loop, os actions imediatamente após a action Loop são executados. Consulte If package.

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 actions será repetido como parte da Loop action:

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 Loop que contém uma action Dicionário > Colocar, o bot somente itera no número original de itens de um dicionário, ignorando 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, Booleano e assim por diante), se você criar rapidamente uma variável enquanto configura a action, a variável é de Qualquer tipo.
Nota: Quando um bot executa uma action Loop que contém uma action Dicionário > Colocar, o bot somente itera no número original de itens de um dicionário, ignorando 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%.

    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 advancedpackage não está disponível com esta opção.

Solução alternativa: Use a action Obter múltiplas células e salve os dados em uma variável datável e, então, use o Looppackage com a opção Tabela de dados selecionada.

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 nome contém o nome do arquivo e a chave extensão 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 outro para extensão de arquivo $extensão$. 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.
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 o 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, Booleano e assim por diante), se você criar rapidamente uma variável enquanto configura a action, a variável é de Qualquer tipo..
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 Como usar as ações do calendário do Office 365 em um loop.
Para cada linha na planilha (Excel do Office 365) 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 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.

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

Você pode configurar várias condições dentro de uma única action Loop:
  1. Clique em Adicionar condição.
  2. Selecione uma das seguintes opções:
    • E: Ambas as condições devem ser atendidas para o actions a ser executado.
    • Ou: Qualquer uma das condições deve ser atendida para o actions 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 actions 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.

Boolean Use esta condição para executar as actions com base no valor de uma variável Boolean. 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 actions conforme a tabela especificada contenha valores.

Use as condições Número de linhas e Número de colunas para executar actions 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 actions 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.
Dictionary Use essa condição para repetir o conjunto de actions 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.
File Use as seguintes condições para executar a action:
  • Data do arquivo

    Use esta condição para verificar a data e hora em que o arquivo especificado foi criado ou modificado. Especifique um intervalo de datas com as opções Está dentro dos últimos, Está entre ou Está antes. 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 action 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.

  • 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 Folder existe ou não existe Use essas condições para repetir o conjunto de actions 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 actions 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 actions 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 actions 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 actions com base no resultado. Insira o tempo (em segundos) a esperar para que essa 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 actions. 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 action até que o objeto no aplicativo de negócios seja carregado.
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 actions 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 actions 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 actions 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 actions com base no status do Task Bot especificado.
VBScript Use a condição Script bem-sucedido ou Script malsucedido para executar actions 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 essa condição seja verdadeira.

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.

Send Feedback (Enviar Feedback)