- Notas relacionadas
- Primeros pasos
- Instalación y configuración
- Proyectos de automatización
- Acerca de la publicación de proyectos de automatización
- Diseñar automatizaciones
- Gestionar paquetes de actividades
- Configuración de los Ajustes del Proyecto de Actividades
- Firma de paquetes
- Control
- Importar entidades
- Experiencia de diseño moderna
- Vincular un proyecto a una idea en Automation Hub
- Usar Data Manager
- Dependencias
- Tipos de flujos de trabajo
- Flujo de control
- Comparación de archivos
- Mejores prácticas de automatización
- Integración del control de código fuente
- Depuración
- Registro
- La herramienta de diagnóstico
- Analizador de flujo de trabajo
- Acerca del analizador de flujo de trabajo
- ST-NMG-001: convención sobre nombres de variables
- ST-NMG-002: convención de nombres de argumentos
- ST-NMG-004: duplicación de nombres de visualización
- ST-NMG-005: anulación de variables
- ST-NMG-006: argumentos de anulación de variables
- ST-NMG-008: longitud variable excedida
- ST-NMG-009: variables de datos prefijados
- ST-NMG-011: argumentos de prefijo Datatable
- ST-NMG-012: valores predeterminados de los argumentos
- ST-NMG-016: longitud del argumento excedida
- ST-NMG-017: el nombre de la clase coincide con el espacio de nombres predeterminado
- ST-DBP-002: recuento de Argumentos elevado
- ST-DBP-003: bloque de Catch vacío
- ST-DBP-007: múltiples capas de diagramas de flujo
- ST-DPB-010: varias instancias de [flujo de trabajo] o [caso de prueba]
- ST-DBP-020: propiedades de salida no definidas
- ST-DBP-021: tiempo de espera codificado
- ST-DBP-023: flujo de trabajo vacío
- ST-DBP-024: comprobación de actividad de persistencia
- ST-DBP-025: requisito previo para la serialización de variables
- ST-DBP-026: retraso en el uso de la actividad
- ST-DBP-027: mejor práctica de persistencia
- ST-DBP-028: requisito de serialización de argumentos
- ST-USG-005: argumentos de actividad codificados
- ST-USG-009: variables no utilizadas
- ST-USG-010: dependencias sin utilizar
- ST-USG-014: restricciones de los paquetes
- ST-USG-020: mensajes de registro mínimos
- ST-USG-024: guardado sin usar para más adelante
- ST-USG-025: uso incorrecto de los valores guardados
- ST-USG-026: restricciones de actividad
- ST-USG-027: paquetes necesarios
- ST-USG-028: Restringir la invocación de plantillas de archivo
- ST-USG-032 - Etiquetas obligatorias
- ST-USG-034 - URL Automation Hub
- Variables
- Argumentos
- Espacios de nombres importados
- Automatizaciones codificadas
- Introducción
- Registrar servicios personalizados
- Contextos Antes y Después
- Generando código
- Generar casos de prueba codificados a partir de casos de prueba manuales
- Automatización atendida basada en desencadenadores
- Grabación
- Elementos de la IU
- Selectores
- Repo. de objetos
- Extracción de datos
- Automatización de imágenes y texto
- Acerca de la automatización de imágenes y texto
- Actividades con el ratón y el teclado
- Ejemplo de uso de la automatización de ratón y teclado
- Actividades de texto
- Ejemplo de uso de la automatización de texto
- Actividades de OCR
- Actividades de imagen
- Ejemplo de uso de la automatización de OCR y la automatización de imágenes
- Citrix Technologies Automation
- Automatización RDP
- Automatización de VMware Horizon
- Automatización de Salesforce
- Automatización SAP
- Automatización de IU de macOS
- La herramienta ScreenScrapeJavaSupport
- El protocolo WebDriver
- Extensiones
- Acerca de las extensiones
- Herramienta SetupExtensions
- UiPathRemoteRuntime.exe no se está ejecutando en la sesión remota
- UiPath Remote Runtime impide que la sesión de Citrix pueda cerrarse
- UiPath Remote Runtime provoca una fuga de memoria
- UiPath.UIAutomation.Activities package and UiPath Remote Runtime versions mismatch
- La extensión de UiPath necesaria no está instalada en la máquina remota
- Configuración de la resolución de la pantalla
- Group Policies
- No se puede comunicar con el navegador
- La extensión de Chrome se elimina automáticamente
- Es posible que la extensión se haya dañado
- Comprueba si la extensión para Chrome está instalada y habilitada
- Check if ChromeNativeMessaging.exe is running
- Check if ComSpec variable is defined correctly
- Habilitar el acceso a las URL de archivos y el modo de incógnito
- Multiple browser profiles
- Group Policy conflict
- Known issues specific to MV3 extensions
- Lista de extensiones para Chrome
- Extensión de Chrome en Mac
- Group Policies
- No se puede comunicar con el navegador
- La extensión de Edge se elimina automáticamente
- Es posible que la extensión se haya dañado
- Check if the Extension for Microsoft Edge is installed and enabled
- Check if ChromeNativeMessaging.exe is running
- Check if ComSpec variable is defined correctly
- Enable access to file URLs and InPrivate mode
- Multiple browser profiles
- Group Policy conflict
- Known issues specific to MV3 extensions
- Lista de extensiones para Edge
- Extensión para Safari
- Extensión para VMware Horizon
- Extensión para Amazon WorkSpaces
- Complemento SAP Solution Manager
- Add-in de Excel
- Conjunto de pruebas - Estudio
- Solución de problemas
- Acerca de la resolución de problemas
- Compatibilidad y limitaciones de Microsoft App-V
- Solución de problemas de Internet Explorer x64
- Problemas de Microsoft Office
- Identificación de elementos de la interfaz de usuario en PDF con opciones de accesibilidad
- Reparar Soporte Active Accessibility
- Validation of large Windows-legacy projects takes longer than expected
Introducción
Las automatizaciones codificadas te permiten crear automatizaciones utilizando código en lugar de actividades de arrastrar y soltar, lo que permite el trabajo colaborativo en proyectos complejos. En los flujos de trabajo codificados y casos de prueba, puedes utilizar los servicios de UiPath (iguales a los paquetes de actividades), las API (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.
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.
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.
Estas son algunas de las ventajas de utilizar automatizaciones codificadas:
- 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.
- 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.
- 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.
- 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.
- 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.
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.
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».
CodedWorkflow
parciales 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.
Flujo de trabajo codificado
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.
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.
CodedWorkflow
hereda la clase CodedWorkflowBase
.
CodedWorkflowBase
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.
CodedWorkflowBase
.
CodedWorkflowBase
en la siguiente tabla:
Método | Descripción |
---|---|
ICodedWorkflowServices services Nota: te recomendamos utilizar los métodos
Log , BuildClient y RunWorkflow a través de la clase services y sus servicios correspondientes, en lugar de utilizarlos como métodos independientes y fácilmente disponibles.
| Proporciona acceso a los servicios disponibles para flujos de trabajo codificados, como:
|
serviceContainer(ICodedWorkflowServiceContainer) Nota: esto ha sido reemplazado por
ICodedWorkflowServices services . Si sigues utilizando esta sintaxis, obtienes una advertencia que te indica que utilices la nueva sintaxis services.Container .
| 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
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
.
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.
Execute()
.
Compatibilidad de proyectos
Puedes utilizar las automatizaciones codificadas solo en los proyectos Windows y Multiplataforma.
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 y posterior |
Testing.Activities | 23.10 y posterior |
MobileAutomation.Activities | 23.12 vista previa y superior |
Mail.Activities | 1.22.1 y posteriores |
Excel.Activities | 2.23.2: vista previa y superior |
Para utilizar paquetes de actividades en las automatizaciones codificadas, realiza los siguientes pasos:
- 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.
- 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
. - 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 comoString
a la API:system.GetAsset("Email Address")
.