Use o componente Tentar captura

  • Versão de lançamento: Australia
  • Atualizado 12 de mar. de 2026
  • 2 min. de leitura
  • Detecte um erro ou exceção que ocorre em um componente em uma automação e transferir o controle para os outros componentes dentro da automação .

    Antes de Iniciar

    Função necessária: nenhuma

    Por Que e Quando Desempenhar Esta Tarefa

    Para configurar as propriedades do componente Try catch, consulte Propriedades do componente Try catch .

    Para obter detalhes sobre os problemas relacionados ao componente Try catch, consulte artigo da base de conhecimento KB1123551 , artigo da base de conhecimento KB1123552 e. artigo da base de conhecimento KB1123556 .

    O componente Try catch permite definir quais componentes são executados no escopo de tratamento de exceções e quais são executados fora dele. Quando ocorre um erro em um componente no escopo de tentativa, o componente captura a exceção e interrompe a execução dos componentes restantes nesse caminho. Você pode conectar um fluxo alternativo à porta Em erro para lidar com a exceção. Os componentes que devem ser executados fora do escopo de tratamento de exceções podem ser conectados à porta finally.

    Você pode usar várias instâncias do componente Try Catch em uma automação para lidar com erros de outros componentes ao longo do mesmo caminho de execução. Se uma atividade que contém um componente Try catch chamar outra atividade que não inclui o componente Try catch, o componente Try catch na atividade de chamada ainda poderá detectar erros da atividade chamada.

    Procedimento

    1. No painel Caixa de ferramentas, navegue até Geral > Tente capturar.
    2. Arraste o componente Testar catch para a superfície de design.
    3. Conete as portas do componente Try Catch às portas correspondentes dos outros componentes ou atividades, conforme descrito na tabela a seguir.
      Tabela 1. Tente capturar parâmetros de porta do componente
      Tipo da porta Nome da porta Tipo de dados Finalidade da conexão Valor padrão Obrigatório?
      Saída de controle Saída de controle Não aplicável Quando não há erro, passa o controle para outro componente ou uma atividade. Não aplicável Sim
      Saída de controle Em caso de erro Não aplicável Passa o controle para outro componente ou atividade depois que o componente Try Catch detecta um erro.

      Use esta porta depois que o componente Try Catch detectar um erro ou exceção e você quiser executar outro componente na atividade atual ou em outra atividade.

      Não aplicável ... A conexão da porta é opcional.
      Saída de dados Mensagem de erro Cadeia de caracteres Retorna a mensagem de erro. Não aplicável ... A conexão da porta é opcional.
      Saída de dados Por fim Não aplicável Permite que você execute componente ou atividade após tentar e capturar, independentemente de ocorrer uma exceção ou não. Não aplicável ... A conexão da porta é opcional.
    4. Opcional: Para testar o componente, clique com o botão direito do mouse na barra de componentes e selecione Execute a partir daqui .
      Nota:
      O componente Try Catch pode não funcionar como esperado com o componente Paralelo.

    Processando erros ao processar um arquivo do Excel

    Uma automação usa um Tente capturar Ao ler dados do Excel. Se o componente readFromExcel falhar porque o caminho do arquivo está vazio, o. Tente capturar O componente captura o erro e exibe a mensagem de erro usando uma MessageBox. . Por fim em seguida, o caminho é executado e exibe a data e a hora atuais antes do término da automação.

    Exemplo de tratamento de exceções no Tente capturar bloco .