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: Tarea - task: UiPathPack@3 inputs: versionType: AutoVersion projectJsonPath: '$(projectFolder)/project.json' outputPath: '$(Build.ArtifactStagingDirectory)\artifact-manifests' - task: UiPathPack@3 inputs: versionType: AutoVersion projectJsonPath: '$(projectFolder)/project.json' outputPath: '$(Build.ArtifactStagingDirectory)\artifact-manifests' VersiónManual : con esta opción, puedes especificar tu propio número de versión. Puedes utilizar el siguiente ejemplo de configuración de tareas: Tarea - task: UiPathPack@3 inputs: versionType: ManualVersion version: '$(Build.BuildNumber)' projectJsonPath: '$(projectFolder)/project.json' outputPath: '$(Build.ArtifactStagingDirectory)\artifact-manifests' - 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: Tarea - task: UiPathPack@3 inputs: versionType: CurrentVersion projectJsonPath: '$(projectFolder)/project.json' outputPath: '$(Build.ArtifactStagingDirectory)\artifact-manifests' - 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)	Establece un tipo de proyecto para el proyecto que se va a empaquetar. Si estableces None , el tipo de proyecto se extraerá del archivo JSON del proyecto. Se admiten los siguientes tipos de proyecto: 'Proceso', 'Biblioteca', '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.
Split output into design and runtime libraries	Select this option to split the output into design and runtime libraries. By default, this option is not activated.
Deshabilitar fuentes NuGet integradas	Select this option to disable built-in NuGet feeds. By default, this is set to false.
Información de la versión del código fuente y URL de la idea de Automation Hub	Select this option to enable package metadata including source code version information and Automation Hub Idea URL. When enabled, you can specify repository details and project URL.
La ruta completa a project.json dentro del repositorio remoto	Specify the full path to project.json within the remote repository. Available when package metadata is enabled.
El ID de confirmación	Specify the commit ID from your version control system. Available when package metadata is enabled. Example: $(Build.SourceVersion)
La rama del repositorio	Specify the repository branch name. Available when package metadata is enabled. Example: $(Build.SourceBranchName)
The type of the repository	Specify the type of the repository (e.g., git). Available when package metadata is enabled.
URL de la idea de Automation Hub	Specify the Automation Hub Idea URL to link the package to a specific automation idea. Available when package metadata is enabled.
Notas relacionadas	Specify release notes for the package. Available when package metadata is enabled.
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.
Ruta del archivo de control	Specify the path to governance policies containing Workflow Analyzer rules. Policies can be downloaded from Automation Ops or extracted from the exported compressed zip file from Studio. Available when workflow analysis is enabled.
Certificate Path	Specify the path to the certificate file in .pfx format used to sign the package. When provided, the package will be digitally signed with the certificate. Example: $(Build.SourcesDirectory)\certificates\signing-cert.pfx
Certificate Password	Specify the password for the certificate. It is recommended to store this value as a secret variable in Azure DevOps. Example: $(CertificatePassword)
Timestamp Server URL	Specify the URL of the timestamp server to use when signing the package. Timestamping ensures the signature remains valid even after the certificate expires. Example: https://timestamp.digicert.com
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.

Example: Basic package creation

- task: UiPathPack@2
  inputs:
    versionType: AutoVersion
    projectJsonPath: '$(Build.SourcesDirectory)\MyFirstProcess'
    outputPath: '$(Build.ArtifactStagingDirectory)\Packages\MyFirstProcess'
    outputType: 'Process'
    orchestratorConnection: 'service-connection-name'
    traceLevel: 'Information'

Example: Package with signing

- task: UiPathPack@2
  displayName: 'Pack and Sign UiPath Project'
  inputs:
    versionType: 'ManualVersion'
    version: '1.0.$(Build.BuildId)'
    projectJsonPath: '$(Build.SourcesDirectory)\MyAutomationProject'
    outputPath: '$(Build.ArtifactStagingDirectory)\Packages'
    outputType: 'Process'
    orchestratorConnection: 'uipath-orchestrator-connection'
    certificatePath: '$(Build.SourcesDirectory)\certificates\signing-cert.pfx'
    certificatePassword: '$(SigningCertPassword)'
    timestampServerUrl: 'http://timestamp.digicert.com'
    traceLevel: 'Information'

Example: Package with workflow analysis and signing

- task: UiPathPack@2
  displayName: 'Pack, Analyze, and Sign Project'
  inputs:
    versionType: 'ManualVersion'
    version: '$(Major).$(Minor).$(Build.BuildId)'
    projectJsonPath: '$(Build.SourcesDirectory)\EnterpriseAutomation'
    outputPath: '$(Build.ArtifactStagingDirectory)\Packages'
    outputType: 'Process'
    orchestratorConnection: 'uipath-orchestrator-connection'
    runWorkflowAnalysis: true
    certificatePath: '$(Pipeline.Workspace)\secure-files\company-cert.pfx'
    certificatePassword: '$(CertPassword)'
    timestampServerUrl: 'http://timestamp.digicert.com'
    traceLevel: 'Verbose'

Nota:

When using package signing, store your certificate password as a secret variable in Azure DevOps. Navigate to Pipelines > Library > Variable groups or define it in your pipeline variables with the lock icon enabled to keep it secure.