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:

Write coded automations using UiPath services, custom C# classes, and .NET libraries from nuget.org. In coded automations, services function like activity packages in low-code automations. Key services include System.Activities, UiAutomation.Activities, and Testing.Activities.

3. Create an If statement that adds the numbers if both are even, or subtracts them if at least one is odd. Print both results to the console using 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. In the Design ribbon, select Analyze File and then Validate File to check the coded workflow file for C# compiler errors.

   

Visit About Workflow Analyzer to read about the Workflow Analyzer. 2. In the Debug ribbon, select Debug File to debug the coded workflow file and check for inconsistencies at runtime.

3. Either in the Debug or Design ribbon, select Debug File then Run File, to run the coded workflow file that you created. 4. Select Publish in the Design ribbon. The Publish Process dialog appears. 5. In the Publish options tab, select where to publish the project. The available options depend on the type of project you are publishing.

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. Select Publish. A NUPKG file is created and uploaded to Orchestrator, the custom NuGet feed, or saved in the local directory.

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