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?

Automações codificadas são automações criadas usando código, em vez de atividades de arrastar e soltar. Ao desenvolver automações codificadas, você pode usar os serviços da UiPath (iguais aos pacotes de atividades), APIs de automação codificadas (semelhantes às atividades), pacotes .NET NuGet externos e suas classes C# personalizadas no UiPath Studio. Isso facilita a integração com sistemas externos, bancos de dados, APIs e outros serviços. As automações codificadas podem ser de três tipos:

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 de automação codificada 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, porque o cenário envolve o uso da API de automação codificada 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 origem de código separado, você pode 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 de automação codificada RandomNumber para criar duas variáveis decimal com um valor aleatório e imprimi-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 como se escrevesse código, usando APIs de automação codificadas disponíveis por meio dos serviços da UiPath e 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 de automação codificadas que você pode usar para criar automações codificadas.

3. Crie uma instrução If, com a condição de que, se ambos os números forem pares, 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 opções Debug, clique em Debug File para depurar o arquivo de fluxo de trabalho codificado e verificar se há 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