Tareas de trabajo

Información general

Tu proceso está compuesto de diferentes etapas, que a su vez, pueden dividirse en trabajos. Para cada trabajo, configura los pasos para incluir tareas de UiPath, incluidas con la integración de UiPath para Azure DevOps.

Importante: a partir de abril de 2023y 2023.4, las nuevas ejecuciones se bloquearán en las carpetas clásicas. Para las tareas que incluyen una carpeta clásica en su configuración, se muestra un mensaje Folder not found y la tarea no se realiza. Obtenga más información sobre la eliminación de carpetas clásicas aquí.

Requisitos previos

Para preparar tu entorno, consulta los requisitos previos de extensión de Azure DevOps.

Consideraciones

Antes de comenzar a ejecutar tareas en tu proceso, considera lo siguiente:

• Debes ejecutar tareas de UiPath solo en los agentes de construcción basados en Windows.
• Configurar conexión de servicio de UiPath Orchestrator.
• Las características de prueba requieren Orchestrator versión 2020.4 o superior.
• Si utilizas una versión local de Orchestrator con HTTPS, importa el certificado SSL para asegurarte de que las llamadas HTTPS a Orchestrator son de confianza.

Interfaz de línea de comandos

La extensión de Azure DevOps viene con una CLI (interfaz de línea de comandos) integrada que es específica de UiPath.

Almacenamiento de la CLI en caché

Cuando ejecutas el agente de compilación, la CLI se comunica con Orchestrator y te permite ejecutar tus tareas.

De forma predeterminada, la CLI está preempaquetada dentro de la extensión AzureDevOps y se almacena dentro de Agent.ToolsDirectory (caché de Azure) cuando se ejecuta por primera vez.

Cuando se ejecuta una tarea de trabajo sobre el agente de compilación, el sistema comprueba la CLI que debería estar dentro de Agent.ToolsDirectorypara finalizar la ejecución.

Si la CLI no se encuentra dentro de Agent.ToolsDirectory (caché de Azure), el sistema la descarga automáticamente de la fuente pública NuGet. Un requisito para esto es que la fuente pública de NuGet no esté bloqueada por un firewall y se pueda acceder a ella desde tu agente de compilación.

Si no puedes abrir el firewall desde tu agente de compilación, puedes descargar manualmente la CLI (correspondiente a la versión de compilación utilizada para tu complemento actual) y colocarla manualmente dentro de la Agent.ToolsDirectory, utilizando la tarea Instalar plataforma.

Añadir tareas de UiPath a la agrupación de agentes de proceso

Para definir un procedimiento de automatización en tu proceso, debes añadir y configurar tareas individuales en la agrupación de agentes.

1. En Azure DevOps, ve a Pipelines.
2. Crea un nuevo proceso o edita uno existente.
3. Añade un trabajo a la agrupación de agentes.
4. Busca una de las siguientes tareas:
   1. UiPath Run Job
   2. UiPath Manage Assets
   3. Plataforma de instalación de Uipath
   4. UiPath Pack
   5. UiPath Deploy
   6. Prueba de UiPath
5. Haz clic en Añadir y configura la tarea.
6. Reorganiza las tareas en la agrupación de agentes si es necesario y guarda el proceso.

UiPath Run Job

Puedes utilizar esta tarea para ejecutar un proceso que ya se ha implementado en una instancia de Orchestrator. Para obtener más información, consulta Procesos y Trabajos.

Configuración

Utiliza la tabla siguiente para configurar las entradas de Ejecutar trabajo de UiPath.

Entrada	Descripción
Nombre de visualización (requerido)	Introduce un nombre para tu tarea.
Conexión de Orchestrator (requerido)	Configura la conexión de servicio para acceder a los servicios de UiPath Orchestrator. Puedes configurar una conexión solo para este paso o utilizar una conexión global existente. Para obtener más información, consulta Configuración de la conexión de servicio de UiPath Orchestrator.
Proceso (requerido)	El proceso es la versión del paquete que está vinculada a un tipo de carpeta en particular. Debes configurar esta entrada en función del tipo de carpeta en la que se implementa el proceso. Para las carpetas modernas, la entrada es el nombre del proceso que aparece en la pestaña Procesos . Para averiguar el nombre del proceso, puedes abrir Orchestrator, abrir tu carpeta y navegar a Automatizaciones > Procesos. Para las carpetas clásicas (obsoletas), la entrada es el nombre del proceso, seguido de un guion bajo, y luego el nombre del entorno , donde se alojan los Robots. Como ejemplo de esta convención de nomenclatura, considera las siguientes variables: El nombre del proceso esTestAutomation. El nombre del entorno es Production. El nombre de su proceso para esta entrada es TestAutomation_Production.
Parámetros de entrada	Especifica la ruta de acceso de archivo a un archivo de entrada JSON, como Input\jobParameters.json. Ejemplo de formato de archivo JSON: { "StringArgument_In": "MyConfigurationValue", "IntArgument_In": 1, "DictionaryArgument_In": { "Key1": "Value1", "Key2": "Value2" } }
Prioridad	Selecciona la prioridad de la ejecución de trabajo si deseas establecer un orden específico en el nivel de proceso. Por defecto, este parámetro está establecido como Normal.
Carpeta de Orchestrator (requerido)	Especifica la carpeta en la que se está implementando el proceso. Para las carpetas clásicas, puedes utilizar nombres de robots específicos. Para carpetas modernas, puedes utilizar nombres de usuario y máquina específicos. Para introducir subcarpetas, asegúrate de introducir tanto el nombre de la carpeta principal como el nombre de la subcarpeta. Por ejemplo, utiliza AccountingTeam\TeamJohn.
Estrategia	Especifica la estrategia de ejecución para la asignación dinámica o específica del robot. Para los trabajos asignados dinámicamente, el proceso se ejecuta bajo la cuenta y máquina que está disponible. Como alternativa, puedes elegir trabajos específicos de robot.
Tipo de trabajo	Solo disponible en las carpetas modernas. Elige el modelo de licencia del runtime en el que se ejecutará el trabajo. Para obtener más información, consulta Licencias de UiPath Robot.
N.º de trabajos	Disponible solo para estrategia de asignación dinámica Especifique el número de veces que desea ejecutar esta tarea. De forma predeterminada, esta entrada está establecida en 1.
Usuario	Solo disponible en las carpetas modernas junto a una estrategia de asignación dinámica. Añade el nombre de usuario de la máquina. Por ejemplo, un usuario local para esta entrada es MachineName\UserName.
Máquina	Solo disponible en las carpetas modernas junto a una estrategia de asignación dinámica. El nombre de la máquina que realiza la ejecución.
Salida	Los resultados se recopilan en un archivo JSON. Debes especificar la ruta de los resultados de trabajo (por ejemplo, Output\testResults.json). Si dejas esta entrada en blanco, la salida por defecto se envía al directorio intermedio de artefacto bajo el siguiente nombre UiPathResults.json.
Tiempo de espera	Especifica el número de segundos a esperar antes de que se agote el tiempo de la solicitud.
La tarea falla cuando el trabajo falla	Selecciona esta entrada si deseas establecer la tarea como fallida cuando al menos falló un trabajo. Esta opción está seleccionada de forma predeterminada.
Esperar a que finalice el trabajo	Espera a que finalice la ejecución del trabajo. Esta opción está seleccionada de forma predeterminada.
Nivel de seguimiento	Selecciona el nivel de registro en la lista desplegable.
robotsIds	Lista separada por comas de nombres de robots específicos.

Proceso de YAML

Puedes previsualizar un documento de YAML totalmente analizado para Ejecutar trabajo de UiPath.

- task: UiPathRunJob@2
  displayName: 'Start ProcessProject'
  inputs:
    #orchestratorConnection: 'service-connection-name' # Service connection to UiPath Orchestrator
    #processName: 'ProccessProject_CI-Pipeline' # The name of the process
    #parametersFilePath: 'Input\\jobParameters.json' # json file with input values if the process requires them
    #priority: 'Low' # Options 'Low', 'Normal', 'High'
    #folderName: 'MyFolder' # Specify the folder to deploy to. For clasic folders, you can use specific robot names. For modern folders, you can use specific user and machine names.
    #strategy: 'Dynamically' # Options 'Specific', 'Dynamically'
    #jobCount: 1 # The number of job runs. (default 1) - used if strategy is 'Dynamically'
    #user: 'MyUser'
    #machine: 'machine'
    #robotsIds: 'robot1, robot2'
    #resultFilePath: 'Output\\testResults.json'
    #timeout: 3600
    #failWhenJobFails: false
    #waitForJobCompletion: false,
    #traceLevel: 'None' # Options: Critical, Error, Warning, Information, Verbose, None

UiPath Manage Assets

Puedes usar esta tarea para implementar, actualizar o eliminar activos en tu instancia de Orchestrator.

Los tipos de activo siguientes son compatibles:

• Text - solo almacena cadenas (no es necesario añadir comillas)
• Boolean - admite valores verdaderos o falsos
• Integer - solo almacena los números enteros
• Credential - contiene nombres de usuario y contraseñas que UiPath Robot requiere para ejecutar procesos particulares. Para este tipo de activo, debes codificar el nombre de usuario y la contraseña mediante el uso de :: para separar los dos campos.

Para implementar activos, debes añadirlos en un archivo CSV codificado en UTF-8 como en el siguiente ejemplo:

name,type,value, description asset_1_name,text,asset_value, asset_2_name,integer,123,asset_3_name,boolean,false, this is an asset description asset_4_name,credential,"username::password",

Para obtener más información, consulta Activos de Orchestrator.

Configuración

Usa la tabla siguiente para configurar las entradas de Gestionar activos de UiPath.

Argumento	Descripción
Nombre de visualización (requerido)	Introduce un nombre para tu tarea.
Conexión de Orchestrator (requerido)	Configura la conexión de servicio para acceder a los servicios de UiPath Orchestrator. Puedes configurar una conexión solo para este paso o utilizar una conexión global existente. Para obtener más información, consulta Configuración de la conexión de servicio de UiPath Orchestrator.
Carpeta de Orchestrator (requerido)	Especifica la carpeta en la que se está implementando el proceso. Para las carpetas clásicas, puedes utilizar nombres de robots específicos. Para carpetas modernas, puedes utilizar nombres de usuario y máquina específicos. Para introducir subcarpetas, asegúrate de introducir tanto el nombre de la carpeta principal como el nombre de la subcarpeta. Por ejemplo, utiliza AccountingTeam\TeamJohn.
Elige una acción de activo (requerido)	Selecciona una opción en la lista desplegable.
Archivo CSV de activos (requerido)	Añade la ruta de archivo CSV. Puedes utilizar el mismo archivo para Implementar y Actualizar las acciones del activo. Consideraciones: Se permite el uso de comillas dentro de valores (por ejemplo, ""A new version of RPA REPORT – AM Email Quote to Agent is available"") Se admiten valores JSON (p. Ej. "{""MaxRetryNumber"":3,""Name"":My Test Process}") No se admiten comentarios (p. Ej. asset_1_name,credential,""username::password"" # asset_1_description comment) Para las acciones Eliminar activo, utiliza solo la columna de nombre y deja vacías el resto de columnas. (opcional) Puedes establecer una descripción para cada activo utilizando la siguiente sintaxis: type, value ,description
Nivel de seguimiento	Selecciona el nivel de registro en la lista desplegable.

Proceso de YAML

Puedes previsualizar un documento de YAML totalmente analizado para Gestionar activos de UiPath.

- task: UiPathAssets@2
  displayName: 'Deploy/Update assets'
  inputs:
    #orchestratorConnection: 'service-connection-name' # Service connection to UiPath Orchestrator
    #assetActionType: 'Deploy' # Options: Deploy, Delete
    #csvFile: 'assets_deploy.csv' # the path to the csv file containing the assets description,
    #traceLevel: 'None' # Options: Critical, Error, Warning, Information, Verbose, None

UiPath Pack

La tarea UiPathPack te permite empaquetar un proyecto de UiPath existente en un paquete de NuGet.

Configuración

Usa la tabla siguiente para configurar las entradas de UiPath Pack.

Argumento	Descripción
Nombre de visualización (requerido)	Introduce un nombre para tu tarea.
Elegir el método de control de versiones (requerido)	Puedes seleccionar una versión generada automáticamente, utilizar la versión del proyecto o definir una nueva versión. Para obtener más información, consulta Versiones de paquete.
Versión (requerido)	Solo disponible en las carpetas modernas junto a una estrategia de asignación dinámica. Especificar la versión del paquete proporciona la posibilidad de rastrear los paquetes creados y sus versiones de origen de forma más eficiente. Por ejemplo, el patrón de ensamblado de Microsoft se puede utilizar para crear la versión del paquete NuGet: [Major].[Minor].[BuildNumber].[RevisionNumber] Las opciones disponibles son: Versión automática: esta opción actualiza automáticamente la versión al siguiente número secuencial. Puedes utilizar el siguiente ejemplo de configuración de tareas: - task: UiPathPack@3 inputs: versionType: AutoVersion projectJsonPath: '$(projectFolder)/project.json' outputPath: '$(Build.ArtifactStagingDirectory)\artifact-manifests' VersiónDeManual: con esta opción, puedes especificar tu propio número de versión. Puedes utilizar el siguiente ejemplo de configuración de tareas: - task: UiPathPack@3 inputs: versionType: ManualVersion version: '$(Build.BuildNumber)' projectJsonPath: '$(projectFolder)/project.json' outputPath: '$(Build.ArtifactStagingDirectory)\artifact-manifests' VersiónActual: esta opción mantiene la versión igual a la especificada en el archivo project.json . Puedes utilizar el siguiente ejemplo de configuración de tareas: - task: UiPathPack@3 inputs: versionType: CurrentVersion projectJsonPath: '$(projectFolder)/project.json' outputPath: '$(Build.ArtifactStagingDirectory)\artifact-manifests'
Ruta de proyecto(s) (requerido)	Selecciona la ubicación del proyecto que se va a empaquetar. Puede ser una ruta de acceso directa a un archivo project.json o un directorio con uno o varios proyectos. En este último caso, cada proyecto de nivel uno se empaqueta individualmente.
Elegir tipo de salida (solo se requiere para las versiones manuales)	Establezca un tipo de proyecto para el proyecto que se va a empaquetar. Si configuras None, el tipo de proyecto se extraerá del archivo JSON del proyecto. Se admiten los siguientes tipos de proyecto: 'Proceso', 'Librería', 'Pruebas', 'Objetos', 'Ninguno'.
Conexión de Orchestrator (requerido)	Configura la conexión de servicio para acceder a los servicios de UiPath Orchestrator. Puedes configurar una conexión solo para este paso o utilizar una conexión global existente. Para obtener más información, consulta Configuración de la conexión de servicio de UiPath Orchestrator.
Ruta de salida (obligatoria)	Establece una ruta de carpeta en la que se colocará el paquete.
Ejecutar análisis de flujo de trabajo	Selecciona esta opción para ejecutar reglas de análisis de flujo de trabajo en tu proyecto de automatización (por ejemplo, trabajos de error en caso de errores). Por defecto, esta opción no está seleccionada. Para obtener más información, consulta Reglas de analizador de flujo de trabajo de prueba.
Nivel de seguimiento	Selecciona el nivel de registro en la lista desplegable.

Proceso de YAML

Puedes previsualizar un documento de YAML totalmente analizado para Empaquetar de UiPath.

- task: UiPathPack@2
  inputs:
    #versionType: AutoVersion # Options: AutoVersion, CurrentVersion, ManualVersion 
    #version: '1.0.0' # Required when versionType == ManualVersion
    #projectJsonPath: '$(Build.SourcesDirectory)\MyFirstProcess'
    #outputPath: '$(Build.ArtifactStagingDirectory)\Packages\MyFirstProcess'
    #outputType: 'None' # Options: Process, Library, Tests, Objects, None
    #runWorkflowAnalysis: 'False'
    #orchestratorConnection: 'service-connection-name' # Service connection to UiPath Orchestrator,
    #traceLevel: 'None' # Options: Critical, Error, Warning, Information, Verbose, None

UiPath Deploy

La tarea UiPathDeploy te permite implementar un paquete de UiPath NuGet en UiPath Orchestrator.

Importante:

Asegúrate de que tu red permite acceder al siguiente feed de paquete de NuGet:

• https://api.nuget.org/v3/index.json
• https://uipath.pkgs.visualstudio.com/_packaging/nuget-packages/nuget/v3/index.json
• https://uipath.pkgs.visualstudio.com/Public.Feeds/_packaging/UiPath-Internal/nuget/v3/index.json
• https://www.myget.org/F/workflow
• http://www.myget.org/F/uipath
• https://www.myget.org/F/uipath-dev/api/v3/index.json

Configuración

Usa la tabla siguiente para configurar las entradas de Implementar de UiPath.

Argumento	Descripción
Nombre de visualización (requerido)	Introduce un nombre para tu tarea.
Conexión de Orchestrator (requerido)	Configura la conexión de servicio para acceder a los servicios de UiPath Orchestrator. Puedes configurar una conexión solo para este paso o utilizar una conexión global existente. Para obtener más información, consulta Configuración de la conexión de servicio de UiPath Orchestrator.
Paquete(s) (requerido)	Define el feed para tus paquetes de UiPath NuGet.
Crear un proceso automáticamente	Seleccione esta opción si desea implementar un paquete sin crear un proceso. La opción está seleccionada de forma predeterminada. Si se selecciona, debe configurar el parámetro Ruta del punto de entrada.
Carpeta de Orchestrator (requerido)	Especifica la carpeta en la que se está implementando el proceso. Para carpetas clásicas (obsoletas), puedes utilizar nombres específicos de UiPath Robot. Para carpetas modernas, puedes utilizar nombres de usuario y máquina específicos. Para introducir subcarpetas, asegúrate de introducir tanto el nombre de la carpeta principal como el nombre de la subcarpeta. Por ejemplo, AccountingTeam\TeamJohnusa .
Entorno	(Opcional) Si utilizas carpetas clásicas (obsoletas), debes definir el entorno en el que se implementarán los paquetes. Puedes utilizar este campo para crear o actualizar paquetes. Puedes utilizar el ejemplo siguiente para añadir tus entornos a este campo, separados por una coma: testingEnvironment,productionEnvironment.
Rutas de punto de entrada (obligatorio)	Especifique rutas de puntos de entrada para crear o actualizar un proceso. La ruta del punto de entrada especifica la ruta del archivo a partir de la raíz del proyecto. Antes de configurar las rutas del punto de entrada, considere lo siguiente: Los puntos de entrada están disponibles para la versión 21.4 o superior de Orchestrator (p. Ej. 21.4.UiPathDeploy.entryPoints). Para las versiones de Orchestrator inferiores a 21.4, debe introducir cualquier valor, ya que el campo no debe permanecer vacío. El punto de entrada predeterminado está establecido en Main.xaml. Se pueden especificar múltiples puntos de entrada como 'Main.xaml, InputPoint2.xaml '. Para las carpetas clásicas (obsoletas), puede especificar solo un punto de entrada para cada entorno. Para las carpetas anidadas, debes especificar la ruta del archivo, de la siguiente manera:Folder01/Folder02/Main.xaml o Folder01/Folder02/Entrypoint.xamlPara obtener más información, consulta Puntos de entrada de Orchestrator.
Nivel de seguimiento	Selecciona el nivel de registro en la lista desplegable.

Proceso de YAML

Puedes previsualizar un documento de YAML totalmente analizado para Implementar de UiPath.

- task: UiPathDeploy@2
  inputs:
    #orchestratorConnection: # Service connection to UiPath Orchestrator
    #packagesPath: '$(Build.ArtifactStagingDirectory)\Packages\ITAutomationProcess'
    #folderName: 'ITAutomation'
    #environments: 'AutomationRobots' # Optional,
    #traceLevel: 'None' # Options: Critical, Error, Warning, Information, Verbose, None

Prueba de UiPath

Normalmente, la tarea Probar de UiPath ejecuta un conjunto de pruebas existente en Orchestrator. Además, puedes usarlo para empaquetar, implementar y ejecutar casos de prueba especificando la ruta al proyecto de prueba de UiPath. Esta última opción aparece en Orchestrator como un conjunto de pruebas transitorio.

Después de que la tarea se haya terminado de ejecutar, los resultados de la prueba se cargan en la pestaña Test en Azure DevOps. Puedes especificar la ruta de salida de resultados de prueba en un formato JUnit.

Según el resultado, la compilación se marcará como exitosa (se han aprobado todos los casos de prueba) o como fallida (al menos un caso de prueba ha fallado).

Configuración

Utiliza la tabla siguiente para configurar las entradas de Probar de UiPath.

Argumento	Descripción
Nombre de visualización (requerido)	Introduce un nombre para tu tarea.
Elija un método de ejecución de prueba	Elige la prueba que deseas ejecutar: Ejecutar el conjunto de pruebas: Especifica y ejecuta un conjunto de pruebas existente en Orchestrator. Ejecutar pruebas en proyecto: especifica un proyecto, implementa el paquete y ejecuta los casos de prueba como parte de un conjunto de pruebas transitorio.
Conexión de Orchestrator (requerido)	Configura la conexión de servicio para acceder a los servicios de UiPath Orchestrator. Puedes configurar una conexión solo para este paso o utilizar una conexión global existente. Para obtener más información, consulta Configuración de la conexión de servicio de UiPath Orchestrator.
Parámetros de entrada	Especifica la ruta de acceso a un archivo de entrada JSON, como Input\jobParameters.json. Especifica el argumento type si estás creando nuevos argumentos de entrada en el nivel de Conjunto de prueba. De lo contrario, puedes utilizar name y value.
Conjunto de pruebas (requerido para el método Ejecutar conjunto de pruebas)	El nombre mostrado para el conjunto de pruebas que deseas ejecutar. Asegúrate de que el conjunto de pruebas incluye la versión más reciente de los casos de prueba. Si el conjunto de pruebas no está en la carpeta predeterminada, asegúrate de incluir el nombre de la carpeta relevante antes. Por ejemplo, AccountingTeam\TestSetusa .
Ruta de proyecto de prueba (requerido para ejecutar pruebas en el método de proyecto)	Especifica la ubicación del proyecto de prueba que se ejecutará como parte de un conjunto de pruebas transitorio.
Entorno (requerido para ejecutar pruebas en el método de proyecto)	Si utilizas carpetas clásicas (obsoletas), debes definir el entorno en el que se implementarán los paquetes. Puedes utilizar este campo para crear o actualizar paquetes. Puedes utilizar el ejemplo siguiente para añadir tus entornos a este campo, separados por una coma: testingEnvironment, productionEnvironment.
Carpeta de Orchestrator (requerido)	Especifica la carpeta en la que se está implementando el proceso. Para carpetas clásicas (obsoletas), puedes utilizar nombres específicos de UiPath Robot. Para carpetas modernas, puedes utilizar nombres de usuario y máquina específicos. Para introducir subcarpetas, asegúrate de introducir tanto el nombre de la carpeta principal como el nombre de la subcarpeta. Por ejemplo, AccountingTeam\TeamJohnusa .
Ruta de salida de los resultados de las pruebas	Especifica la ruta de salida de los resultados de prueba en el formato JUnit (por ejemplo, Output\testResults.json).
Tiempo de espera	Especifica el número de segundos a esperar antes de que se agote el tiempo de la solicitud.
Nivel de seguimiento	Selecciona el nivel de registro en la lista desplegable.
Adjuntar registros de robots	Selecciona esta opción para conectar registros de nivel INFO del UiPath Robot que se ejecuta. De forma predeterminada, esta opción no está seleccionada. Para obtener más información, consulta Registro de UiPath Robot.

Proceso de YAML

Puedes previsualizar un documento de YAML totalmente analizado para Probar de UiPath.

-- task: UiPathTest@2
  inputs:
    #testTarget: TestProject # Options: TestProject, TestSet
    #orchestratorConnection: # Service connection to UiPath Orchestrator
    #testProjectPath: '$(Build.SourcesDirectory)\MobileAutomationTests' # Required only when testTarget = TestProject
    #testSet: 'MobileAutomationTests' # Required only when testTarget = TestSet
    #folderName: 'MobileAutomationTesting'
    #environment: 'TestingRobots' # Required only when testTarget = TestProject and the folder is a classic folder
    #testReportDestination: '$(Build.ArtifactStagingDirectory)\report.xml' # Optional
    #timeout: 200 # Optional, default = 3600s,
    #traceLevel: 'None' # Options: Critical, Error, Warning, Information, Verbose, None task: UiPathTest@2