Paquete de soluciones de UiPath

La tarea Paquete de soluciones de UiPath empaqueta un archivo archivado de una solución de UiPath existente en un paquete desplegable que puede cargarse en Gestión de soluciones en Orchestrator.

Nota:

Actualmente, las soluciones solo son compatibles con Automation Cloud. El soporte para Automation Suite está previsto para una versión futura. On-premises (MSI) Orchestrator no es compatible con Solutions.

Nota:

Esta tarea solo es compatible con UiPath.CLI.Windows o UiPath.CLI.Linux al menos la versión 25.10 o superior.

Configuración

Utiliza la siguiente tabla para configurar las entradas del paquete de soluciones de UiPath.

Parámetro	Descripción
Ruta de la solución (obligatorio)	La ruta local de la solución. Puede ser una ruta directa a un archivo solución.uipx o un directorio de soluciones.
Versión (requerido)	Especificar la versión del paquete de soluciones ofrece la posibilidad de realizar un seguimiento de los paquetes creados y su control de versiones de origen de forma más eficiente. Por ejemplo, el patrón de ensamblado de Microsoft puede utilizarse para crear la versión del paquete NuGet: [Major].[Minor].[BuildNumber].[RevisionNumber]
Ruta de salida (obligatoria)	Ruta de acceso a la carpeta donde se debe colocar el paquete creado.Predeterminado: $(Build.ArtifactStagingDirectory)\Output
Deshabilitar fuentes NuGet integradas	Deshabilitar fuentes NuGet integradas. Predeterminado: false
Información de la versión del código fuente y URL de la idea de Automation Hub	Habilite los metadatos del paquete, incluida la información de la versión del código fuente y la URL de la idea de Automation Hub. Predeterminado: false
La ruta completa a project.json dentro del repositorio remoto	La ruta completa a project.json dentro del repositorio remoto. Solo visible cuando los metadatos del paquete están habilitados.
El ID de confirmación	El ID de confirmación para el seguimiento del código fuente. Solo visible cuando los metadatos del paquete están habilitados.
La rama del repositorio	La rama del repositorio para el seguimiento del código fuente. Solo visible cuando los metadatos del paquete están habilitados.
El tipo de repositorio (por ejemplo: git)	El tipo de repositorio (por ejemplo: git). Solo visible cuando los metadatos del paquete están habilitados.
URL de la idea de Automation Hub	URL de la idea de Automation Hub para vincular a la idea de automatización original. Solo visible cuando los metadatos del paquete están habilitados.
Notas relacionadas	Notas de la versión del paquete. Solo visible cuando los metadatos del paquete están habilitados.
Conexión de Orchestrator	Una conexión de servicio a una instancia de Orchestrator que tiene en su fuente dependencias de los proyectos que se van a empaquetar. Normalmente se utiliza para empaquetar bibliotecas. Orchestrator debe ser 20.4 o superior.
Ejecutar análisis del flujo de trabajo	Ejecute el análisis del flujo de trabajo antes de empaquetar y de que se produzcan fallos en caso de error. Predeterminado: false
Ruta del archivo de control	Pasar políticas de control que contengan las reglas del Analizador de flujo de trabajo. Las políticas pueden descargarse desde Automation Ops o extraerse del archivo zip comprimido exportado desde Studio. Para obtener más información, consulta la documentación. Solo visible cuando el análisis de flujo de trabajo está habilitado.
Nivel de seguimiento	El nivel de registro de seguimiento. Predeterminado: Error. Opciones: None, Critical, Error, Warning, Information, Verbose

Notas

• Empaquetado de soluciones: esta tarea crea paquetes implementables a partir de soluciones de UiPath que pueden cargarse en Gestión de soluciones en Orchestrator.
• Requisito de versión: a diferencia de los proyectos independientes, las soluciones requieren una especificación de versión explícita mediante el control de versiones semántico.
• Dependencias de Orchestrator: al empaquetar bibliotecas o proyectos con dependencias de fuentes de Orchestrator, configura el parámetro de conexión de Orchestrator.
• Análisis de flujo de trabajo: habilita el análisis de flujo de trabajo para validar tu solución frente a las políticas de gobernanza antes de empaquetar.
• Seguimiento de metadatos: habilita los metadatos del paquete para incluir información del código fuente y enlaces a ideas de Automation Hub para una mejor trazabilidad.
• Formato de salida: la tarea crea un archivo de solución empaquetada en el directorio de salida especificado con el patrón de nomenclatura: {SolutionName}.{Version}.zip.
• Compatibilidad de CLI: esta tarea utiliza UiPath CLI internamente y requiere una instalación adecuada de CLI en el agente de compilación.
• Versión mínima de CLI: requiere la versión 25.10 o superior de UiPath CLI para una compatibilidad total.

Ejemplos de proceso

Empaquetado de soluciones básicas

- task: UiPathSolutionPack@6
  displayName: 'Pack Solution'
  inputs:
    solutionPath: '$(Build.SourcesDirectory)/MySolution'
    version: '1.0.$(Build.BuildId)'
    outputPath: '$(Build.ArtifactStagingDirectory)/Output'
    traceLevel: 'Information'

Con conexión de Orchestrator

- task: UiPathSolutionPack@6
  displayName: 'Pack Solution with Orchestrator Dependencies'
  inputs:
    solutionPath: '$(Build.SourcesDirectory)/MyLibrarySolution'
    version: '2.1.$(Build.BuildNumber)'
    outputPath: '$(Build.ArtifactStagingDirectory)/Packages'
    orchestratorConnection: 'UiPath-Orchestrator-Connection'
    runWorkflowAnalysis: true
    governanceFilePath: '$(Build.SourcesDirectory)/governance/policies.json'
    traceLevel: 'Verbose'

Proceso completo con metadatos y gobernanza

variables:
  solutionVersion: '1.$(Date:yyyy).$(DayOfYear)$(Rev:.r)'

steps:
- task: UiPathSolutionPack@6
  displayName: 'Pack Solution with Full Metadata'
  inputs:
    solutionPath: '$(Build.SourcesDirectory)/MyBusinessSolution'
    version: '$(solutionVersion)'
    outputPath: '$(Build.ArtifactStagingDirectory)'
    disableBuiltInNugetFeeds: false
    enablePackageMetadata: true
    repositoryUrl: '$(Build.Repository.Uri)/$(Build.SourcesDirectory)/MyBusinessSolution/project.json'
    repositoryCommit: '$(Build.SourceVersion)'
    repositoryBranch: '$(Build.SourceBranchName)'
    repositoryType: 'git'
    projectUrl: 'https://cloud.uipath.com/automationhub/idea/12345'
    releaseNotes: 'Automated build $(Build.BuildNumber) - Added new features and bug fixes'
    orchestratorConnection: 'Production-Orchestrator'
    runWorkflowAnalysis: true
    governanceFilePath: '$(Build.SourcesDirectory)/governance/workflow-analyzer-rules.json'
    traceLevel: 'Information'

- task: PublishBuildArtifacts@1
  displayName: 'Publish Solution Package'
  inputs:
    pathToPublish: '$(Build.ArtifactStagingDirectory)'
    artifactName: 'SolutionPackage'