Trabajos

Plataforma de instalación de Uipath

Puede usar la tarea UiPathInstallPlatform cuando:

• Desea descargar una versión diferente de la CLI para poder, por ejemplo, empaquetar proyectos de Windows y multiplataforma.

• Los agentes de compilación no tienen acceso a la fuente NuGet de UiPath.

  Debe ejecutar la tarea UiPathInstallPlatform antes que cualquier otra tarea en el complemento. La tarea de InstalarPlataforma de UiPath descarga la CLI de la fuente pública de NuGet solo si la versión compatible no está disponible en la caché.

  
  

  

  
  

Selector de versión de CLI

Selecciona la versión de la CLI que quieres usar con tu extensión de Azure DevOps en el menú desplegable Elegir una versión de la CLI .

Las opciones de la lista desplegable incluyen:

• Las últimas versiones disponibles de la CLI.
• Los requisitos del entorno para ser compatible con la versión de la CLI que elijas.
  
  

  

  
  

Ruta al nupkg de la CLI

Si su proceso no puede acceder a la fuente pública de UiPath y no puede descargar la versión CLI que eligió de la lista desplegable, siga los pasos a continuación:

1. Descargue la versión CLI deseada de la fuente pública de UiPath.
2. Coloca el archivo NUPKG descargado dentro del directorio del espacio de trabajo del agente de tu agente de compilación. Recuerda la ruta del archivo NUPKG dentro del directorio del espacio de trabajo del agente. Por ejemplo, ${WORKSPACE}\nupkg\UiPath.CLI.xx.xx.xx.nupkg

   Usa la tarea InstalarPlataforma e introduce la ruta utilizada en el paso 2 dentro de la Ruta al campo nupkg de la CLI .

UiPath Run Job

El paso posterior a la compilación UiPath Run Job inicia un proceso que ya se ha implementado en una instancia de Orchestrator. En la versión 2020.10 de Orchestrator, puedes encontrar los procesos que ejecuta esta tarea en la pestaña Procesos. En las versiones de Orchestrator 2021.10 y posteriores, puedes encontrar los procesos que ejecuta esta tarea en Automatizaciones, en Procesos.

Configuración

Parámetro de trabajo	Descripción
Proceso (requerido)	Nombre del proceso. Puede tomar el nombre del proceso de la interfaz de usuario de Orchestrator. Si el proceso se implementa en una carpeta moderna, este argumento debe ser el nombre del proceso en la pestaña Procesos . Si el proceso se implementa en una carpeta clásica, el argumento debe estar formado por el Nombre del proceso y el Entorno (por ejemplo: NAME: ProcessA ENVIRONMENT: Production ProcessName: ProcessA_Production).
Parámetros	La ruta completa a un archivo de entrada JSON. Se utiliza cuando el proceso requiere entrada. Ejemplo de formato de archivo JSON: { "StringArgument_In": "MyConfigurationValue", "IntArgument_In": 1, "DictionaryArgument_In": { "Key1": "Value1", "Key2": "Value2" } }
Prioridad	La prioridad de ejecución del trabajo
Estrategia	Especifique la estrategia de ejecución de trabajos, los trabajos asignados dinámicamente o los trabajos específicos del robot. Elige una de las siguientes opciones: Asignar dinámicamente Robots específicos
Tipo de trabajo (disponible solo para carpetas modernas)	Elija el modelo de licencia del tiempo de ejecución en el que se ejecutará el trabajo.
Dirección de Orchestrator	La dirección de la instancia de Orchestrator donde ejecutará el proceso.
Tenant de Orchestrator	Especifique el tenant de Orchestrator.
Carpeta de Orchestrator	Especifique la carpeta donde se implementó el proceso especificado. Para introducir subcarpetas, asegúrate de introducir tanto el nombre de la carpeta principal como el nombre de la subcarpeta. Por ejemplo, AccountingTeam\TeamJohnusa .
Autenticación	Para la autenticación hacia Orchestrator, debe crear credenciales en Jenkins por adelantado. Hay cuatro opciones para autenticarse: (1) Autentícate en un Orchestrator local utilizando el nombre de usuario y contraseña. (2) Autenticarse en un Cloud Orchestrator utilizando un token de actualización (clave API). (3) Autentíquese en un Cloud Orchestrator mediante la autenticación de aplicación externa. (4) Autentícate en un Orchestrator local utilizando la autenticación de una aplicación externa.
Ruta de salida de los resultados del trabajo	Especifique la ruta de salida de los resultados del trabajo (por ejemplo, testResults.json). Los resultados se generan en formato JSON. Si no se especifica, los resultados se enviarán al directorio de clasificación de artefactos como UiPathResults.json. La salida está en formato json.
Tiempo de espera	Especifique el tiempo de espera de ejecución del trabajo en segundos.
Falla cuando el trabajo falla	La tarea falla cuando se produce un error al menos en un trabajo. El valor predeterminado es Verdadero.
Esperar a que finalice el trabajo	Esperar a que finalice la ejecución de trabajo/s. El valor predeterminado es Verdadero.
Nivel de registro de seguimiento	Configuración utilizada para habilitar el registro de seguimiento en uno de los siguientes niveles: Ninguno Critical Error Advertencia Information Detallado. (El valor predeterminado está establecido en Ninguno). Útil para fines de depuración.
N.º de trabajos	El número de ejecuciones de trabajos El valor predeterminado es 1.
Usuario (disponible solo para carpetas modernas)	El nombre del usuario. Debe ser un usuario de la máquina, no un usuario de Orchestrator. Para los usuarios locales, el formato debe ser MachineName \ UserName.
Máquina (disponible solo para carpetas modernas)	El nombre de la máquina.
Nombres del robot	Lista separada por comas de nombres de robots específicos.

Ejemplo de proceso

pipeline {
  agent any
  environment {
      MAJOR = '1'
      MINOR = '0'
  }
  stages {
    stage ('Build') {
        UiPathRunJob(
          credentials: UserPass('825c83c9-9a14-44eb-883a-af54f8078af0'),
          failWhenJobFails: true,
          folderName: 'A_Classic',
          orchestratorAddress: 'https://testorchestrator.some-domain.com',
          orchestratorTenant: 'Default',
          parametersFilePath: '',
          priority: 'Low',
          processName: 'ProcessA_EnvB',
          resultFilePath: 'output.json',
          strategy: Dynamically(jobsCount: 1, machine: 'TestMachine', user: 'TestUser'), timeout: 3600, waitForJobCompletion: true, traceLoggingLevel: 'None'
        )
        UiPathRunJob(
          credentials: UserPass('825c83c9-9a14-44eb-883a-af54f8078af0'),
          failWhenJobFails: true,
          folderName: 'A_Classic',
          orchestratorAddress: 'https://testorchestrator.some-domain.com',
          orchestratorTenant: 'Default',
          parametersFilePath: '',
          priority: 'Low',
          processName: 'ProcessA_EnvB',
          resultFilePath: 'output.json',
          strategy: Robot('robot1,robot2'),
          timeout: 1800,
          waitForJobCompletion: false,
          traceLoggingLevel: 'None'
        )
    }
  }
}

Archivo de entrada JSON

Para configurar la tarea Ejecutar trabajo , introduce un archivo JSON que contenga los parámetros necesarios para ejecutar el proceso en Orchestrator. Orchestrator solo valida valores primitivos. A continuación se muestra una descripción general de los formatos necesarios para los parámetros de entrada que se pueden pasar a Orchestrator:

Parámetro	Formato requerido	Ejemplo
Cadena	Escriba el valor entre comillas.	'string value'
Int32	Proporcione el valor como lo haría con cualquier número entero.	11
Booleano	Proporcione el valor como true o false.	true
Double	Proporcione un valor de punto flotante.	3.5
Datetime	Proporcione una representación JSON válida.	"2012-04-23T18:25:43.511Z"
Matriz	Proporciona valores como JSON válido.	[1,1,2,3,5,8] o ["firstString", "secondString"]

Ejemplo de esquema JSON

A continuación se muestra un esquema JSON de ejemplo que muestra cómo introducir los parámetros necesarios en un archivo JSON. Asegúrese de que los argumentos pasados en el archivo JSON existan en el proyecto de Studio utilizado para publicar el proceso en Orchestrator.

{
    'in_JenkinsBaseUrl': 'http://localhost:8080/jenkins/',
    'in_JenkinsBuildName': '02_UiPathApplicationDemo'
}

UiPath Manage Assets

El paso Administrar activos de UiPath le permite implementar, actualizar o eliminar activos en una instancia de Orchestrator. Para implementar activos, debes describirlos en un archivo CSV como el del siguiente ejemplo codificado en uft-8.

name,type,value,description
asset_1_name,text,asset_value,this is an test description   # we can have comments
asset_2_name,integer,123
asset_3_name,boolean,false
asset_4_name,credential,"username::password"

Hay cuatro tipos de activos:

• Texto
• Entero
• Booleano
• Credencial. Para la Credencial debes codificar el nombre y la contraseña utilizando :: para separar los dos campos.
  
  

  

  
  

Configuración

Parámetro de trabajo	Descripción
Acción	Qué hacer con los activos proporcionados: implementar o eliminar. Si existe un activo implementado, se actualizará.
Dirección de Orchestrator	La dirección de la instancia de Orchestrator donde implementará o actualizará los activos.
Tenant de Orchestrator	Especifique el tenant de Orchestrator en el que se implementarán o actualizarán los activos.
Carpeta de Orchestrator	Especifique la carpeta donde se implementarán o actualizarán los activos. Para introducir subcarpetas, asegúrate de introducir tanto el nombre de la carpeta principal como el nombre de la subcarpeta. Por ejemplo, AccountingTeam\TeamJohnusa .
Autenticación	Para la autenticación hacia Orchestrator, debe crear credenciales en Jenkins por adelantado. Hay cuatro opciones para autenticarse: (1) Autentícate en un Orchestrator local utilizando el nombre de usuario y contraseña. (2) Autenticarse en un Cloud Orchestrator utilizando un token de actualización (clave API). (3) Autentíquese en un Cloud Orchestrator mediante la autenticación de aplicación externa. (4) Autentícate en un Orchestrator local utilizando la autenticación de una aplicación externa.
Ruta del archivo CSV	La ruta al archivo CSV que contiene los detalles del activo. Se puede usar el mismo archivo para implementar o actualizar los activos, aunque el tipo no es necesario para las actualizaciones. El campo type también puede estar vacío, pero la columna debe estar presente. Para eliminar, solo se utiliza la columna name , por lo que las otras columnas pueden estar vacías, pero deben estar presentes. Puedes establecer una descripción opcional para cada activo (por ejemplo: type, value, description). Asegúrate de eliminar cualquier salto de línea, ya que cada línea se interpreta como un nuevo activo.
Nivel de registro de seguimiento	Configuración utilizada para habilitar el registro de seguimiento en uno de los siguientes niveles: Ninguno Critical Error Advertencia Information Detallado. (El valor predeterminado está establecido en Ninguno). Útil para fines de depuración.

Ejemplo de proceso

pipeline {
  agent any
  environment {
      MAJOR = '1'
      MINOR = '0'
  }
  stages {
    stage ('Build') {
        UiPathAssets (
            assetsAction: DeployAssets(), 
            credentials: Token(accountName: '', credentialsId: ''), 
            filePath: '${WORKSPACE}/test.csv', 
            folderName: 'Default', 
            orchestratorAddress: 'https://test-orchestrator.somedomain.com', 
            orchestratorTenant: 'Default',
            traceLoggingLevel: 'None'
        )
        UiPathAssets(
            assetsAction: DeleteAssets(),
            credentials: UserPass('825c83c9-9a14-44eb-883a-af54f8078af0'),
            filePath: '${WORKSPACE}/test.csv',
            folderName: 'Default',
            orchestratorAddress: 'https://test-orchestrator.somedomain.com',
            orchestratorTenant: 'Default',
            traceLoggingLevel: 'None'
        )
    }
  }
}

UiPath Pack

Aplicación: RPA

Tipo: tarea de creación

UiPath Pack está disponible en trabajos y procesos estándar, y te permite empaquetar un proyecto de UiPath existente en un paquete NuGet.

Configuración

Parámetro de trabajo	Descripción
Elija el método de control de versiones	Los paquetes de UiPath están versionados. Con el paquete de UiPath puede elegir entre 3 opciones diferentes: (1) Generar automáticamente (2) Definir versión personalizada (3) Utilice la versión actual establecida en el proyecto.
Ruta de proyecto/s	La ubicación de los proyectos que se van 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.
CarpetaDeSalida	Ruta a la carpeta donde desea crear el paquete.
Tipo de salida	El tipo de salida de los proyectos. Hay 5 opciones para el tipo de proyecto: (1) Tipo de salida del proyecto (2) Empaquetar un proyecto de proceso (3) Empaquetar un proyecto de biblioteca (4) Empaquetar un proyecto de pruebas (5) Empaquetar un proyecto de objetos.
Ejecutar análisis del flujo de trabajo	Ejecuta el análisis del flujo de trabajo antes de empaquetar, comprobando el proyecto mediante reglas predefinidas en busca de infracciones. Fallar el trabajo en caso de errores. De forma predeterminada, el análisis no se ejecuta.
Nivel de registro de seguimiento	Configuración utilizada para habilitar el registro de seguimiento en uno de los siguientes niveles: Ninguno Critical Error Advertencia Information Detallado. (El valor predeterminado está establecido en Ninguno). Útil para fines de depuración.
Usar Orchestrator	Utilice la fuente de Orchestrator al empaquetar bibliotecas. La versión de Orchestrator debe ser 20.4 o superior. La fuente de la biblioteca debe permitir la autenticación de clave de API en Tenant > Configuración > Implementación.
Dirección de Orchestrator	La dirección de la instancia de Orchestrator desde la que se deben restaurar las dependencias de la librería.
Tenant de Orchestrator	El tenant de Orchestrator desde el que se deben restaurar las dependencias de la biblioteca.
Autenticación	Para la autenticación hacia Orchestrator, debe crear credenciales en Jenkins por adelantado. Hay cuatro opciones para autenticarse: (1) Autentícate en un Orchestrator local utilizando el nombre de usuario y contraseña. (2) Autenticarse en un Cloud Orchestrator utilizando un token de actualización (clave API). (3) Autentíquese en un Cloud Orchestrator mediante la autenticación de aplicación externa. (4) Autentícate en un Orchestrator local utilizando la autenticación de una aplicación externa.

Ejemplo de proceso

ipeline {
  agent any
  environment {
      MAJOR = '1'
      MINOR = '0'
  }
  stages {
    stage ('Build') {
      steps {
        UiPathPack (
          outputPath: "Output\)\)\)\)${env.BUILD_NUMBER}",
          projectJsonPath: "UiBank\)\)\)\)project.json",
          version: [$class: 'ManualVersionEntry', version: "${MAJOR}.${MINOR}.${env.BUILD_NUMBER}"]
          useOrchestrator: true,
          traceLoggingLevel: "None",
          orchestratorAddress: "OrchestratorUrl",
          orchestratorTenant: "tenant name",
          credentials: [$class: 'UserPassAuthenticationEntry', credentialsId: “credentialsId”]
        )
      }
    }
  }
}

UiPath Deploy

Aplicación: RPA

Tipo: tarea posterior a la creación

UiPath Deploy está disponible en trabajos y procesos estándar, y te permite implementar un paquete NuGet de UiPath en UiPath Orchestrator.

Configuración

Parámetro de trabajo	Descripción
Ruta de paquete/s	La carpeta que contiene sus paquetes nuget de UiPath.
Dirección de Orchestrator	La dirección de la instancia de Orchestrator en la que se implementarán los paquetes.
Tenant de Orchestrator	El tenant de Orchestrator en el que se implementarán los paquetes.
Carpeta de Orchestrator	La carpeta en la que se va a implementar. Si se trata de una carpeta Clásica, también deberás establecer el environmentscampo .Para carpetas Modernas, no es necesario establecer el campo environments. Para introducir subcarpetas, asegúrate de introducir tanto el nombre de la carpeta principal como el nombre de la subcarpeta. Por ejemplo, AccountingTeam\TeamJohnusa .
Entornos (requerido para las carpetas clásicas)	El entorno en el que se implementará el paquete como proceso. Para el proyecto y el entorno con los procesos existentes, los procesos se actualizarán para usar la versión más reciente del proyecto. Especifique el entorno en el que se implementará el paquete como proceso. Para el proyecto y el entorno con los procesos existentes, los procesos se actualizarán para usar la versión más reciente del proyecto.
Puntos de entrada	Especifica puntos de entrada para crear o actualizar un proceso. El punto de entrada especifica el filePath comenzando desde la raíz del proyecto. Condiciones: Hay puntos de entrada disponibles para la versión 21.4 de Orchestrator o superior (por ejemplo, 21.4.UiPathDeploy.entryPoints). Para las versiones de Orchestrator inferiores a la 21.4, debes introducir cualquier valor, ya que el campo no debe permanecer vacío. Punto de entrada predeterminado establecido en Main.xaml. Para las carpetas clásicas (obsoletas) solo se puede especificar un punto de entrada para cada entorno. Para obtener más información, consulta Puntos de entrada de Orchestrator.
Autenticación	Para la autenticación hacia Orchestrator, debe crear credenciales en Jenkins por adelantado. Hay cuatro opciones para autenticarse: (1) Autentícate en un Orchestrator local utilizando el nombre de usuario y contraseña. (2) Autenticarse en un Cloud Orchestrator utilizando un token de actualización (clave API). (3) Autentíquese en un Cloud Orchestrator mediante la autenticación de aplicación externa. (4) Autentícate en un Orchestrator local utilizando la autenticación de una aplicación externa.
Nivel de registro de seguimiento	Configuración utilizada para habilitar el registro de seguimiento en uno de los siguientes niveles: Ninguno Critical Error Advertencia Information Detallado. (El valor predeterminado está establecido en Ninguno). Útil para fines de depuración.

Nota:

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

Ejemplo de proceso

pipeline {
  agent any
  environment {
      MAJOR = '1'
      MINOR = '0'
  }
  stages {
    stage ('PostBuild') {
      steps {
        UiPathDeploy (
          packagePath: "path\)\)\)    o\)\)NuGetpackage",
          orchestratorAddress: "OrchestratorUrl",
          orchestratorTenant: "tenant name",
          folderName: "folder name",
          environments: "environment",
          credentials: [$class: 'UserPassAuthenticationEntry', credentialsId: “credentialsId”],
          traceLoggingLevel: 'None'
        )
      }
    }
  }
}

Pruebas de ejecución de UiPath

Aplicación: Pruebas

Tipo: tarea posterior a la creación

Las pruebas de UiPath Run está disponible en trabajos y procesos estándar, y le permite:

• Ejecutar un conjunto de prueba existente en Orchestrator.
• Empaquete, implemente y ejecute casos de prueba especificando la ruta a un proyecto de prueba de UiPath.

Una vez finalizada la ejecución de prueba, la pestaña Resultado de la prueba se publica en la compilación de Jenkins y muestra los resultados detallados. Además, se crea un archivo de resultados de prueba JUnit en la ruta de salida de resultados de la prueba, cuando se especifica, o en la raíz del espacio de trabajo si no se especifica.

En función del resultado, la compilación se marcará como satisfactoria (se han aprobado todos los casos de prueba) o como inestable (ha fallado al menos un caso de prueba).

Configuración

Parámetro de trabajo	Descripción
Destino	Especifique un conjunto de pruebas existente en UiPath Orchestrator (para ejecutar el conjunto de pruebas). Proporcione la ruta project.json de un proyecto de prueba de UiPath (para ejecutar el proyecto de prueba).
Ruta de salida del resultado de la prueba	El conjunto de pruebas ejecutadas devuelve el resultado de la prueba como junit.xml. Especifica la ruta de acceso donde se debe almacenar el resultado, en relación con el directorio del espacio de trabajo de Jenkins (por ejemplo, result.xml).
Parámetros de entrada	Define los argumentos personalizados para tus casos de prueba para anular los valores predeterminados a nivel del conjunto de pruebas. Mediante los argumentos podrás establecer los parámetros para probar los casos en el runtime. Para definir los argumentos, debes publicar un paquete con argumentos.
Dirección de Orchestrator	La dirección de la instancia de Orchestrator en la que se implementarán los paquetes.
Tenant de Orchestrator	El tenant de Orchestrator en el que se implementarán los paquetes.
Carpeta de Orchestrator	La carpeta en la que se va a implementar. Si la carpeta es Clásica, también deberá establecer el campo environments. Para las carpetas modernas, configurando environments. no es obligatorio. Para introducir subcarpetas, asegúrate de introducir tanto el nombre de la carpeta principal como el nombre de la subcarpeta. Por ejemplo, AccountingTeam\TeamJohnusa .
Entornos (requerido para las carpetas clásicas)	El entorno en el que se implementará el paquete como proceso. Para el proyecto y el entorno con los procesos existentes, los procesos se actualizarán para usar la versión más reciente del proyecto. Especifique el entorno en el que se implementará el paquete como proceso. Para el proyecto y el entorno con los procesos existentes, los procesos se actualizarán para usar la versión más reciente del proyecto.
Autenticación	Para la autenticación hacia Orchestrator, debe crear credenciales en Jenkins por adelantado. Hay cuatro opciones para autenticarse: (1) Autentícate en un Orchestrator local utilizando el nombre de usuario y contraseña. (2) Autenticarse en un Cloud Orchestrator utilizando un token de actualización (clave API). (3) Autentíquese en un Cloud Orchestrator mediante la autenticación de aplicación externa. (4) Autentícate en un Orchestrator local utilizando la autenticación de una aplicación externa.
Tiempo de espera (segundos)	El tiempo de espera de ejecución de prueba. El valor predeterminado es 7200 segundos. Si el tiempo de espera se supera antes de que la ejecución en Orchestrator finalice y devuelva el resultado, lo creado se cancelará y se marcará como fallido.
Nivel de registro de seguimiento	Configuración utilizada para habilitar el registro de seguimiento en uno de los siguientes niveles: Ninguno Critical Error Advertencia Information Detallado. (El valor predeterminado está establecido en Ninguno). Útil para fines de depuración.

Ejemplo de proceso

pipeline {
  agent any
  environment {
    MAJOR = '1'
    MINOR = '0'
  }
  stages {
    stage ('PostBuild') {
      steps {
        UiPathTest (
          testTarget: [$class: 'TestSetEntry', testSet: "My Test Set"],
          orchestratorAddress: "OrchestratorUrl",
          orchestratorTenant: "tenant name",
          folderName: "folder name",
          timeout: "10000",
          traceLoggingLevel: 'None',
          testResultsOutputPath: "result.xml",
          credentials: [$class: 'UserPassAuthenticationEntry', credentialsId: "credentialsId"]
        )
      }
    }
  }
}