Introducción

Coded automations allow you to create automations using code instead of drag-and-drop activities, allowing collaborative work on complex projects. In coded workflows and test cases, 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.

Los flujos de trabajo codificados se comportan como flujos de trabajo estándar, lo que significa que también pueden invocarse desde los flujos de trabajo estándar de UiPath y viceversa, utilizando la actividad Invocar archivo de flujo de trabajo.

Además, los tipos definidos en el código, como los enums, pueden utilizarse como entradas en los flujos de trabajo estándar de UiPath.

Las automatizaciones codificadas pueden ser de tres tipos:

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

Utilizar automatizaciones codificadas

Para crear automatizaciones codificadas en tu proyecto, normalmente tienes el paquete UiPath.CodedWorkflows preinstalado. El paquete viene con la base CodedWorkflowBase y la clase parcial CodedWorkflow.

El paquete se preinstala cuando:

• Se crea un nuevo proyecto con al menos la versión 23.10 de System.Activities, Testing.Activities o UIAutomation.Activities, o cualquier otro paquete de actividad que tenga soporte de flujo de trabajo codificado.
• Creas un nuevo Flujo de trabajo codificado, Caso de prueba codificado o Archivo de código fuente en tu proyecto.

Si no puedes utilizar automatizaciones codificadas en los escenarios indicados, descarga el paquete en el menú Gestionar paquetes.

Beneficios

Estas son algunas de las ventajas de utilizar automatizaciones codificadas:

1. Productividad mejorada: si estás familiarizado con la codificación o los scripts, puedes aprovechar tus habilidades y aumentar tu productividad. Trabajar en un entorno de codificación familiar te permite desarrollar automatizaciones más eficientes.
2. Gestión de la complejidad: las automatizaciones codificadas proporcionan una solución flexible para gestionar escenarios de automatización complejos. Al utilizar código, puedes implementar la lógica personalizada, gestionar excepciones y crear funciones reutilizables.
3. Automatización híbrida: puedes utilizar automatizaciones codificadas de forma intercambiable con automatizaciones de código bajo. Esto promueve la integración perfecta entre los dos enfoques, lo que te permite crear soluciones de automatización flexibles.
4. Rendimiento mejorado: las automatizaciones codificadas te permiten optimizar tus flujos de trabajo de automatización para mejorar el rendimiento. Al utilizar código, puedes implementar algoritmos específicos para que tus ejecuciones de automatización sean más rápidas.
5. Legibilidad: las automatizaciones codificadas te permiten crear código estructurado, lo que da como resultado la legibilidad del código. Si organizas tu código y lo documentas, puedes mantenerlo fácilmente y compartirlo con otros colaboradores.

Estructura

Las automatizaciones codificadas presentan un diseño estructurado con espacios de nombres, clases de ayudantes y métodos de punto de entrada. El marco de las automatizaciones codificadas te permite escribir las automatizaciones utilizando el lenguaje de programación C#.

Sigue la estructura detallada de una automatización codificada como se describe en las siguientes secciones.

Espacios de nombres

Al crear una automatización codificada, se genera automáticamente un espacio de nombres utilizando el nombre del proyecto de Studio. Por ejemplo, si tu proyecto de Studio se llama «Mi proyecto», el espacio de nombres de todas las automatizaciones codificadas será «Miproyecto».

Además, si creas una automatización codificada dentro de una carpeta en tu proyecto de Studio, el espacio de nombre será el nombre del proyecto y el nombre de la carpeta. Por ejemplo, si tu proyecto de Studio se llama «Mi proyecto», y la carpeta se llama «lugar», entonces el espacio de nombres será «Myproject.lugar».

Clase base

Tanto las automatizaciones del flujo de trabajo codificado como las de casos de prueba codificados utilizan las clases CodedWorkflowparciales del paquete UiPath.CodedWorkflows. Esta clase da a la automatización acceso a las interfaces necesarias para los servicios (iguales a los paquetes de actividades), en función de los paquetes de actividad instalados en tu proyecto.

Nota: el paquete UiPath.CodedWorkflows se incluye automáticamente al importar un paquete de actividades que admita automatizaciones codificadas, como UiPath.System.Activities 23.10 o posterior.

CodedWorkflow

Las automatizaciones codificadas heredan la clase parcial CodedWorkflow, creando una relación de tipo CodedAutomationExample : CodedWorkflow. Esto significa que la clase CodedAutomationExample hereda los atributos, métodos y funcionalidades de la clase CodedWorkflow. Esencialmente, puede acceder y utilizar las características definidas en la clase CodedWorkflow, lo que proporciona una base para la automatización codificada, facilitando la creación y personalización del comportamiento de la automatización.

La clase CodedWorkflow se declara como clase parcial, lo que te permite ampliar sus funcionalidades definiendo la misma clase parcial CodedWorkflow en un archivo de código fuente. De esta manera, puedes añadir nuevos campos y métodos para personalizar aún más el comportamiento de tus automatizaciones codificadas. Puedes utilizar este enfoque para implementar una interfaz Antes y Después, específicamente para los casos de prueba codificados.

Además, la clase parcial CodedWorkflow hereda la clase CodedWorkflowBase.

CodedWorkflowBase

La clase CodedWorkflowBase contiene las funcionalidades integradas que hereda una automatización codificada. Esta clase contiene métodos y propiedades específicas para gestionar las instancias de flujo de trabajo, el acceso en tiempo de ejecución, la gestión de contenedores de servicio y la configuración de contextos de entorno. La clase CodedWorkflowBase también ofrece otro método independiente para el registro que puedes personalizar tú mismo.

Nota: En la Configuración del editor de código, selecciona Habilitar descompilación de origen para ver la clase CodedWorkflowBase.

Consulta los métodos CodedWorkflowBase en la siguiente tabla:

Método	Descripción
serviceContainer(ICodedWorkflowServiceContainer)	Proporciona acceso al contenedor de inyección de dependencias que es específico para el flujo de trabajo codificado actual. Este contenedor, conocido como el contenedor de servicio, te permite recuperar las instancias de servicios que se hayan registrado en él.
GetRunningJobInformation()	Recupera información sobre el trabajo en ejecución actualmente dentro del contexto del flujo de trabajo codificado. El método accede a la propiedad RunningJobInformation del objeto executorRuntime que contiene información sobre el estado del trabajo, el progreso, los parámetros y las marcas de tiempo.
Log(string message, LogLevel level = LogLevel.Info, IDictionary<string, object>additionalLogFields = null)	Añade campos de registro adicionales para registrar los mensajes con los atributos especificados.
RunWorkflow(string workflowFilePath,IDictionary<string, object> inputArguments = null,TimeSpan? timeout = null, bool isolated = false, InvokeTargetSession targetSession = InvokeTargetSession.Current)	Proporciona una estructura para ejecutar un flujo de trabajo dentro del contexto del tiempo de ejecución del flujo de trabajo dado. Puede establecer parámetros, gestionar el posible aislamiento e iniciar la ejecución del flujo de trabajo. La tarea devuelta proporciona los resultados del flujo de trabajo ejecutado, incluidos sus argumentos de salida y entrada/salida.
RunWorkflowAsync(string workflowFilePath,IDictionary<string, object> inputArguments = null, TimeSpan?timeout = null, bool isolated = false, InvokeTargetSession targetSession = InvokeTargetSession.Current)	Proporciona una estructura para ejecutar un flujo de trabajo asíncrono dentro del contexto del tiempo de ejecución del flujo de trabajo dado. Puede establecer parámetros, gestionar el posible aislamiento e iniciar la ejecución del flujo de trabajo. La tarea devuelta proporciona los resultados del flujo de trabajo ejecutado, incluidos sus argumentos de salida y entrada/salida.
DelayAsync(TimeSpan time) y DelayAsync(int delayMs)	Suspende la ejecución durante un período de tiempo especificado de forma asíncrona.
Delay(TimeSpan time) y Delay(int delayMs)	Suspende la ejecución durante un período de tiempo especificado.
HttpClient BuildClient(string scope = "Orchestrator", bool force = true)	Crea un cliente HTTP con un ámbito y un token de acceso especificados.
RegisterServices(ICodedWorkflowsServiceLocator serviceLocator)	Registra los servicios (paquetes de actividades) en el localizador de servicios del flujo de trabajo codificado. Puedes anularlo cuando quieras inyectar servicios personalizados en el contenedor de inyección de dependencias. Aprende a crear y utilizar servicios personalizados (paquetes de actividades codificadas) aquí.

Artículos relacionados

• Registrar servicios personalizados
• Implementar las ejecuciones antes y después

Puntos de entrada

El método de punto de entrada tanto para los flujos de trabajo codificados como para los casos de prueba codificados se nombra Execute() y se atribuye como Workflow o TestCase. Puedes cambiar el nombre del método, siempre que lo atribuyas bien a Workflow o a TestCase.

Solo puedes utilizar un método Execute() ( [TestCase]o [Workflow]) dentro de un archivo, que hereda la clase Coded Workflow.

En este método, puedes añadir argumentos de entrada y/o salida, equivalentes a los argumentos In, Out o In/Out en las automatizaciones de código bajo. Consulta el tutorial Trabajar con argumentos de entrada y salida para aprender a utilizar argumentos en las automatizaciones codificadas.

Este método de punto de entrada sirve como punto de partida para ejecutar las automatizaciones. Esto hace que los flujos de trabajo codificados y los casos de prueba sean fáciles de identificar como puntos de entrada debido a su método Execute().

Compatibilidad de proyectos

Puedes utilizar las automatizaciones codificadas solo en los proyectos Windows y Multiplataforma.

Servicios

Para diseñar automatizaciones codificadas, puedes utilizar servicios que sean iguales a los paquetes de actividades. Por ejemplo, System.Activities no solo es un paquete de actividades en las automatizaciones de código bajo, sino también un servicio en las automatizaciones codificadas. De forma similar a las actividades dentro de un paquete de actividades, un servicio tiene API que puedes utilizar para crear automatizaciones codificadas.

Los servicios disponibles para utilizar dentro de las automatizaciones codificadas son los siguientes:

Servicio	Versión
System.Activities	23.10 y posterior
UiAutomation.Activities	23.10.7 y posterior
Testing.Activities	23.10 y posterior

Para utilizar paquetes de actividades en las automatizaciones codificadas, realiza los siguientes pasos:

1. Descarga el paquete de actividades, igual a un servicio, similar a como lo harías en las automatizaciones de código bajo. Esto te proporciona una colección de API para utilizar en tu código.
2. Llama a las API dentro de los servicios utilizando el formato: service.API. Por ejemplo, si quieres utilizar la API de GetAsset, la llamarías como system.GetAsset.
3. Las API tienen parámetros en lugar de propiedades. Después de llamar a una API, puedes configurar sus parámetros proporcionando valores entre paréntesis. Por ejemplo, si tienes un activo en la instancia de Orchestrator a la que estás conectado, llamado Email Address, entonces puedes pasar el nombre de este activo como String a la API: system.GetAsset("Email Address").

Consejo: dentro de las automatizaciones codificadas, también puedes utilizar cualquier biblioteca de clases .NET disponible para descargar desde la fuente nuget.org.