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 Delay e Retry Scope não são suportadas 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 novas tentativas for excedido, a execução do projeto é 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 novas tentativas – O número de vezes que a sequência deve ser repetida.
• Intervalo de nova tentativa – Especifica o intervalo entre cada nova tentativa.

Configuração multiplataforma

Painel do Designer

• ActivityBody – Adiciona atividades a serem re-executadas 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 novas tentativas for excedido, a execução do projeto é 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 novas tentativas – O número de vezes que a sequência deve ser repetida.
• Intervalo de nova tentativa – Especifica o intervalo entre cada nova tentativa.

Exemplo de uso da atividade Retry Scope em projetos do Windows.

A atividade Retry Scope é usada para capturar e tratar um erro, e é por isso que é 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:

• Se o valor da variável Random for diferente de zero três vezes seguidas, a mensagem "A janela do Bloco de Notas não conseguiu iniciar" é exibida toda vez e o fluxo de trabalho inteiro falha 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 Random for zero, o robô abre o Bloco de Notas e, como a condição desse loop é encontrar a janela do Bloco de Notas, o fluxo de trabalho é concluído com sucesso.

1. Crie uma nova sequência e adicione a atividade Retry Scope.
2. No painel de Propriedades, defina o valor 3 para o Número de novas tentativas e defina o valor 5 para Intervalo de nova tentativa. Isso significa que tentamos abrir a janela do Bloco de Notas três vezes e o intervalo entre 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 "Random".

   2. No campo Valor a salvar, 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 0:

       Random <> "0"

   2. Na seção Então da atividade If:
      • Adicione uma atividade de caixa de mensagem com o seguinte texto: "A janela do Bloco de Notas falhou ao iniciar".
      • Embaixo da 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 Senão da atividade If:

      • Adicione uma atividade Open Application e indique o aplicativo de Bloco de Notas na tela. Certifique-se de que o campo Nome do Arquivo 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.