Tentar Escopo Novamente

UiPath.Core.Activities.RetryScope

Description

Repete as atividades contidas desde que a condição não seja atendida ou que um erro seja gerado.

Importante:

• As atividades Retry Scope não são compatíveis e não funcionam corretamente quando usadas no fluxo de trabalho principal de um Processo de Orquestração. Em tais casos, elas devem ser colocadas dentro de uma atividade No Persistence Scope .

Compatibilidade do projeto

Windows - Legada | Windows | Multiplataforma

Windows - Legada, Configuração do Windows

Painel do Designer

• Ação - Adicione atividades a serem reexecutadas nesta seção.
• Condição - Adicione uma atividade de condição nesta seção.

  Por exemplo, para falhar e tentar novamente graciosamente ao indicar um elemento de interface gráfica, você pode usar a atividade Modern UI Automation Check App State ou é a sua contraparte Classic Element Exists como uma condição e tentar novamente abrir o aplicativo e encontrar o elemento de interface gráfica.

Painel de Propriedades

Comum

• Continuar com erro - Especifica se a automação deve continuar mesmo quando a atividade gera um erro. Este campo só aceita valores booleanos (True, False). O valor padrão é False. Como resultado, se o campo estiver em branco, um erro for gerado ou o número de repetições for excedido, a execução do projeto será interrompida. Se o valor for definido como True, a execução do projeto prosseguirá mesmo com erros.

  Observação: se essa atividade estiver incluída na atividade Try Catch e o valor da propriedade ContinuarComErro for True, nenhum erro será capturado quando o projeto for executado.

• NomeDeExibição - o nome de exibição da atividade.

Diversos

• Privado - Se selecionado, os valores de variáveis e argumentos não são mais registrados no nível Verbose.

Opções

• Número de repetições — o número de vezes que uma sequência deve ser repetida.
• IntervaloDeRepetição - Especifica a quantidade de tempo entre cada tentativa.

Configuração multiplataforma

Painel do Designer

• CorpoDaAtividade — adicione atividades a serem reexecutadas nesta seção.
• Condição - Adicione uma atividade de condição nesta seção.

  Por exemplo, para falhar e tentar novamente graciosamente ao indicar um elemento de interface gráfica, você pode usar a atividade Modern UI Automation Check App State como uma condição e tentar novamente abrir o aplicativo e encontrar o elemento de interface gráfica.

Propriedades adicionais

• Continuar com erro - Especifica se a automação deve continuar mesmo quando a atividade gera um erro. Este campo só aceita valores booleanos (True, False). O valor padrão é False. Como resultado, se o campo estiver em branco, um erro for gerado ou o número de repetições for excedido, a execução do projeto será interrompida. Se o valor for definido como True, a execução do projeto prosseguirá mesmo com erros.

  Observação: se essa atividade estiver incluída na atividade Try Catch e o valor da propriedade ContinuarComErro for True, nenhum erro será capturado quando o projeto for executado.

Opções

• Número de repetições — o número de vezes que uma sequência deve ser repetida.
• IntervaloDeRepetição - Especifica a quantidade de tempo entre cada tentativa.

Exemplo de uso da atividade Retry Scope em projetos do Windows

A atividade Retry Scope é usada para capturar e lidar com um erro, e é por isso que ela é semelhante à Try Catch .

O fluxo de trabalho a seguir tenta abrir a janela do Bloco de Notas 3 vezes e usa a condição definida na atividade Retry Scope para interromper o loop:

• Toda vez que o valor da variável Aleatório for diferente de zero três vezes consecutivas, a mensagem “Janela do Bloco de notas falhou ao iniciar” será exibida e todo o fluxo de trabalho falhará com o erro “Bloco de notas falhou ao iniciar”. A segunda mensagem é aquela que você adicionou na atividade Throw .

• Se o valor da variável Aleatória for zero, o Robô abrirá o Bloco de Notas e, como a condição desse loop é localizar a janela do Bloco de Notas, o fluxo de trabalho será concluído com sucesso.

1. Crie uma nova sequência e adicione a atividade Retry Scope.
2. No painel Propriedades , defina o valor 3 para o Número de repetições e defina o valor 5 para Intervalo de repetições . Isso significa que tentaremos abrir a janela do Bloco de notas três vezes e o intervalo entre as tentativas é de cinco segundos.
3. Na seção Ação , adicione uma atividade Assign :
   1. No campo Salvar em da atividade Assign , crie uma variável e nomeie-a "Aleatório".

   2. No campo Valor a ser salvo , escreva a seguinte expressão:

      (Now.Millisecond Mod 5).ToString()

      
4. Na seção Ação , adicione uma atividade If .
   1. No campo Condição , adicione a seguinte expressão, onde "Random" é a variável criada anteriormente. A expressão verifica se o valor da variável é diferente de zero:

      Random <> "0"

   2. Na seção Then da atividade If :
      • Adicione uma atividade Message box com o seguinte Texto: “Janela do Bloco de notas falhou ao iniciar”.
      • Na Caixa de mensagem, adicione uma atividade Throw e forneça a seguinte expressão no campo Exceção :

        New System.Exception(“Notepad failed to start”)

        Essas atividades são executadas quando a condição é verdadeira.

      

   3. Na seção Else da atividade If :

      • Adicione uma atividade Open Application e indique o aplicativo do Bloco de notas na tela. Certifique-se de que o campo NomeDeArquivo contenha o caminho completo para o arquivo executável do Bloco de Notas em seu dispositivo.

        Essa atividade é executada quando a condição é falsa.

      

5. Para sair do loop, na seção Condição da atividade Retry Scope , adicione uma atividade Check App State e indique a janela do Bloco de notas.