Guía de inicio rápido

Esta guía de inicio rápido te ayuda a embarcarte en el viaje de trabajar con automatizaciones codificadas. Aprenderás a crear automatizaciones codificadas siguiendo un tutorial que muestra cómo crear un flujo de trabajo codificado que genera números aleatorios entre 1 y 100 y realiza operaciones de suma o resta en función de si los números son pares o impares.

¿Qué son las automatizaciones codificadas?

Las automatizaciones codificadas son automatizaciones creadas mediante código, en lugar de actividades de arrastrar y soltar. Cuando desarrollas automatizaciones codificadas, puedes utilizar los servicios de UiPath (equivalentes a los paquetes de actividades), las API de automatización codificadas (similares a las actividades), los paquetes .NET NuGet externos y tus clases C# personalizadas en UiPath Studio. Esto facilita la integración con sistemas externos, bases de datos, API y otros servicios. Las automatizaciones codificadas pueden ser de tres tipos:

1. Flujos de trabajo codificados: se utilizan para diseñar flujos de trabajo en código.
2. Casos de prueba codificados: se utilizan para diseñar casos de prueba.
3. Archivos de código fuente: se utilizan para crear código que luego puedas llamar en otros tipos de archivos codificados.

Consulta la Introducción para las automatizaciones codificadas para obtener más información.

Escenario

En este tutorial utilizamos la API de automatización codificada RandomNumber para generar números decimales aleatorios dentro del rango especificado. A continuación, comprobamos si los números generados son pares, utilizando un método personalizado llamado IsEven, y realizamos la suma o la resta en función de esa condición.

Crear el flujo de trabajo codificado

Crea el flujo de trabajo codificado en tu proyecto de Studio e instala las dependencias necesarias.

1. Instala Testing.Activities 23.10 porque el escenario implica utilizar la API de automatización codificada RandomNumber desde el servicio de Testing.
2. Crea un flujo de trabajo codificado seleccionando Nuevo y luego Flujo de trabajo codificado en el grupo Archivo.

Las automatizaciones codificadas están estructuradas con espacios de nombres, clases de ayudantes y métodos de punto de entrada. La clase base, CodedWorkflow, se utiliza tanto para los flujos de trabajo codificados como para los casos de prueba y proporciona acceso a las interfaces y servicios necesarios. El método de punto de entrada, llamado Execute(), es crucial para ejecutar estas automatizaciones y se puede personalizar con los argumentos de entrada y salida.

Diseñar el flujo de trabajo codificado

Escribe el código en Studio IDE que consta de un editor de código dedicado, pestañas de archivo y rutas de navegación para facilitar la navegación.

1. En el flujo de trabajo codificado, pero fuera del método Execute(), crea un método personalizado llamado IsEven.

Este método devuelve un valor boolean, que representa si la variable decimal introducida es un número par o no.

Consulta el siguiente ejemplo de código:

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

Consejo:

Si no quieres crear un método personalizado en un archivo de código fuente independiente, puedes crearlo dentro del flujo de trabajo codificado o del caso de prueba codificado, pero fuera del método Execute().

2. Dentro del método Ejecutar utiliza la API de automatización codificada RandomNumber para crear dos variables decimal con un valor aleatorio e imprimirlas en la consola utilizando Console.WriteLine.

Consulta el siguiente ejemplo de código:

// 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}");

Nota:

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.

Consulta el siguiente ejemplo de código:

 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}");
        }

Gestionar el proceso de flujo de trabajo codificado

Después de crear y diseñar un flujo de trabajo codificado, puedes validarlo utilizando el Analizador de flujo de trabajo, depurarlo, ejecutarlo y luego publicarlo en 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 Procesos:

• Fuente de procesos de tenant de Orchestrator, fuente de espacio de trabajo personal de Orchestrator
• Asistente (Valores predeterminados del Robot): ubicación predeterminada del paquete para el Robot y el Asistente, C:\ProgramData\UiPath\Packages. Los proyectos publicados aquí se muestran automáticamente en el Asistente. La opción no está disponible si Studio está conectado a Orchestrator.Estas opciones están disponibles si Studio está conectado a Orchestrator.
• Personaliza una URL de la fuente de NuGet personalizada o una carpeta local. La adición de una Clave API es opcional.

6. Select Publish. A NUPKG file is created and uploaded to Orchestrator, the custom NuGet feed, or saved in the local directory.

Proyecto de ejemplo

Para seguir los pasos de este tutorial y probarlo tú mismo, puedes descargar el siguiente proyecto de ejemplo: Primer flujo de trabajo codificado.

Próximos pasos

Consulta los siguientes recursos para mejorar tu conocimiento sobre las automatizaciones codificadas:

• Studio IDE
• Trabajar con los argumentos de entrada y salida
• Mejores prácticas
• Trabajar con automatizaciones codificadas
• Tutoriales