UiPath Pack

La tâche UiPath Pack vous permet de compresser un projet UiPath existant dans un package NuGet.

Configuration

Utilisez la table suivante pour configurer les entrées UiPath Pack.

Argument	Description
Nom complet (Display name) (obligatoire)	Saisissez un nom pour votre tâche.
Choisir la méthode de contrôle de version (obligatoire)	Vous pouvez sélectionner une version générée automatiquement, utiliser la version du projet ou définir une nouvelle version. Pour plus d'informations, consultez Versions de package.
Version (obligatoire)	Disponible uniquement sur les dossiers modernes avec une stratégie d'allocation dynamique. Spécifier la version du package offre la possibilité de suivre plus efficacement les packages construits et leur versionnement source. Par exemple, le modèle d’assembly Microsoft peut être utilisé pour créer la version du package NuGet : [Major].[Minor].[BuildNumber].[RevisionNumber] Les options disponibles sont: VersionAutomatique : cette option met automatiquement à jour la version vers le prochain numéro séquentiel. Vous pouvez utiliser l’exemple de configuration de tâche suivant : Tâche - 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' Version Manuelle : avec cette option, vous pouvez spécifier votre propre numéro de version. Vous pouvez utiliser l’exemple de configuration de tâche suivant : Tâche - 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' CurrentVersion : cette option conserve la version identique à celle spécifiée dans le fichier project.json . Vous pouvez utiliser l’exemple de configuration de tâche suivant : Tâche - 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'
Chemin du ou des projets (obligatoire)	Sélectionnez l'emplacement du projet à compresser. Il peut s’agir d’un chemin direct vers un fichier project.json ou un répertoire contenant un ou plusieurs projets. Dans ce dernier cas, chaque projet de niveau un est compressé individuellement.
Choisir le type de sortie (obligatoire uniquement pour le contrôle de version manuel)	Définissez un type de projet pour le projet qui va être compressé. Si vous définissez None , le type de projet sera extrait du fichier JSON du projet. Les types de projets suivants sont pris en charge : « Processus », « Bibliothèque », « Tests », « Objets », « Aucune ».
Connexion Orchestrator (Orchestrator connection) (obligatoire)	Configurez la connexion au service pour accéder aux services UiPath Orchestrator. Vous pouvez configurer une connexion uniquement pour cette étape ou utiliser une connexion globale existante. Pour plus d'informations, consultez Configuration de la connexion au service UiPath Orchestrator.
Chemin de sortie (requis)	Définissez un chemin de dossier où le package sera placé.
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.
Désactiver les flux NuGet intégrés	Select this option to disable built-in NuGet feeds. By default, this is set to false.
Informations sur la version du code source et URL de l’idée 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.
Le chemin d’accès complet à project.json dans le référentiel distant	Specify the full path to project.json within the remote repository. Available when package metadata is enabled.
L’ID de validation	Specify the commit ID from your version control system. Available when package metadata is enabled. Example: $(Build.SourceVersion)
La branche du référentiel	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 l’idée Automation Hub	Specify the Automation Hub Idea URL to link the package to a specific automation idea. Available when package metadata is enabled.
Notes de publication	Specify release notes for the package. Available when package metadata is enabled.
Exécuter l’analyse du workflow	Sélectionnez cette option pour exécuter des règles d'analyse de workflow sur votre projet d'automatisation (par exemple, échec de tâches en cas d'erreurs). Par défaut, cette option n'est pas activée. Pour plus d'informations, consultez Règles de l'analyseur de workflow de test d'application.
Chemin du fichier de gouvernance	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
Niveau du traçage	Sélectionnez l'utilisateur dans la liste déroulante.

Pipeline YAML

Vous pouvez prévisualiser un document YAML entièrement analysé pour la tâche de compression 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'

Remarque :

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.