Guia de início rápido

Esse guia de início rápido ajuda você a embarcar na jornada de trabalho com automações codificadas. Você aprenderá como criar automações codificadas seguindo um tutorial que demonstra como criar um fluxo de trabalho codificado que gera números aleatórios entre 1 e 100 e realiza operações de adição ou subtração com base na paridade dos números.

O que são automações codificadas?

Coded automations are automations created using code, instead of drag-and-drop activities. When developing coded automations, you can use UiPath^® services (equal to activity packages), APIs (similar to activities), external .NET NuGet packages, and your custom C# classes in UiPath Studio. This makes it easy to integrate with external systems, databases, APIs, and other services. Coded automations can be of three types:

1. Fluxos de trabalho codificados — usados para projetar fluxos de trabalho no código.
2. Casos de teste codificados — usados para criar casos de teste.
3. Arquivos de código fonte — usados para criar código que você pode chamar posteriormente em outros tipos de arquivos codificados.

Acesse a Introdução para automações codificadas para saber mais.

Cenário

Neste tutorial, usamos a API RandomNumber para gerar números decimais aleatórios dentro do intervalo especificado. Em seguida, verificamos se os números gerados são pares, usando um método personalizado chamado IsEven, e realizamos adição ou subtração com base nessa condição.

Crie o fluxo de trabalho codificado

Crie o fluxo de trabalho codificado dentro do seu projeto do Studio e instale as dependências necessárias.

1. Instale Testing.Activities 23.10, pois o cenário envolve o uso da API RandomNumber do serviço de teste.
2. Crie um fluxo de trabalho codificado selecionando Novo e, em seguida, Fluxo de trabalho codificado no grupo Arquivo.
   Automações codificadas são estruturadas com namespaces, classes auxiliares e métodos de Entry Point. A classe base, CodedWorkflow, é usada para fluxos de trabalho codificados e casos de teste, e fornece acesso a interfaces e serviços necessários. O método de Entry Point, chamado Execute(), é crucial para executar essas automações e pode ser personalizado com argumentos de entrada e saída.
   
   

   

   
   

Projete o fluxo de trabalho codificado

Escreva o código no IDE do Studio que consiste em um editor de código dedicado, guias de arquivos e trilhas de navegação para facilitar a navegação.

1. No fluxo de trabalho codificado, mas fora do método Execute(), crie um método personalizado chamado IsEven.
   Esse método retorna um valor boolean, que representa se a variável decimal inserida é um número par ou não.
   Confira o exemplo de código abaixo:

   private bool IsEven(decimal number)
           {
              // Check if a decimal number is even
           return (number % 2 == 0);
           }

   Dica: se você não quiser criar um método personalizado em um arquivo de código fonte separado, poderá criá-lo dentro do fluxo de trabalho codificado ou caso de teste codificado, mas fora do método Execute().
2. Dentro do método Executar, use a API RandomNumber para criar duas variáveis decimal com um valor aleatório e imprima-as no console usando Console.WriteLine.
   Confira o exemplo de código abaixo:

   // Generate random numbers within a specified range (e.g., 1 to 100)
           decimal num1 = testing.RandomNumber(1, 100);
           decimal num2 = testing.RandomNumber(1, 100);
               
           Console.WriteLine($"Generated numbers: {num1} and {num2}");

   Observação: você escreve automações codificadas da mesma forma que escreveria código, utilizando APIs disponíveis por meio dos serviços da UiPath, bem como outras classes C# personalizadas ou bibliotecas de classes .NET disponíveis no feed nuget.org. Em automações codificadas, os serviços são equivalentes a pacotes de atividades usados em automações de pouco código. Esses serviços, como System.Activities, UiAutomation.Activities e Testing.Activities, vêm com APIs que podem ser usadas para criar automações codificadas.
3. Crie uma instrução If, com a condição de que, se ambos os números forem iguais, a automação deverá adicioná-los. A cláusula Else deve subtrair os números se pelo menos um deles for ímpar. Ambos os resultados devem ser impressos no console usando Console.WriteLine.
   Confira o exemplo de código abaixo:

   if (IsEven(num1) && IsEven(num2))
           {
               // Both numbers are even, so add them together
               decimal sum = num1 + num2;
               Console.WriteLine($"Both numbers are even. Sum: {sum}");
           }
           else
           {
               // At least one number is odd, so subtract them
               decimal difference = num1 - num2;
               Console.WriteLine($"At least one number is odd. Difference: {difference}");
           }

Gerencie o processo de fluxo de trabalho codificado

Depois de criar e projetar um fluxo de trabalho codificado, você pode validá-lo usando o Analisador de Fluxo de Trabalho, depurá-lo, executá-lo e publicá-lo no Orchestrator.

1. Na faixa de opções de Design, clique em Analisar arquivo e, em seguida, Validar arquivo para verificar o arquivo de fluxo de trabalho codificado para erros de compilador C#.
   
   

   

   
   
   Acesse Sobre o Analisador de Fluxo de Trabalho para ler sobre o Analisador de Fluxo de Trabalho.
2. Na faixa de Depuração, clique em Depurar arquivo para depurar o arquivo de fluxo de trabalho codificado e verificar inconsistências no runtime.
   
   

   

   
   
3. Na faixa de opções de Depuração ou Design, clique em Depurar arquivo e em Executar arquivo para executar o arquivo de fluxo de trabalho codificado que você criou.
4. Selecione Publicar na faixa de opções de Design.
   A caixa de diálogo de Publicar Processo é exibida.
5. Na guia Opções de Publicação, selecione onde publicar o projeto. As opções disponíveis dependem do tipo de projeto que você está publicando.
   Para Processos:

   • Feed de processos de tenant do Orchestrator, feed de espaço de trabalho pessoal do Orchestrator
   • Assistente (Padrões do Robô) - o local padrão do pacote para o Robô e o Assistente, C:\ProgramData\UiPath\Packages. Os projetos publicados aqui aparecem automaticamente no Assistente. A opção não fica disponível se o Studio estiver conectado ao Orchestrator.Essas opções ficam disponíveis se o Studio está conectado ao Orchestrator.
   • Personalizado - seja a URL de um feed personalizado do NuGet ou uma pasta local. Adicionar uma Chave de API é opcional.
6. Clique em Publicar.
   Um arquivo NUPKG é criado e carregado no Orchestrator, no feed personalizado do NuGet ou salvo no diretório local.

Projeto de amostra

Para seguir as etapas deste tutorial e experimentar por conta própria, você pode baixar o seguinte projeto de exemplo: Primeiro fluxo de trabalho codificado.

Próximas Etapas

Acesse os recursos abaixo para aprimorar seu conhecimento sobre automações codificadas:

• Studio IDE
• Trabalhando com argumentos de entrada e saída
• Melhores práticas
• Trabalhando com automações codificadas
• Tutoriais