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' : tâche : UiPathPack@3 entrées : versionType : AutoVersion 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' - tâche : UiPathPack@3 entrées : versionType : ManualVersion version : '$(Build.BuildNumber)' projectJsonPath : '$(projectFolder)/project.json' OutputPath : '$(Build.artefact.StagingDirectory)\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' : tâche : UiPathPack@3 entrées : versionType : CurrentVersion
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é.
Fractionner la sortie en bibliothèques de conception et d’exécution	Sélectionnez cette option pour diviser la sortie en bibliothèques de conception et de runtime. Par défaut, cette option n'est pas activée.
Désactiver les flux NuGet intégrés	Sélectionnez cette option pour désactiver les flux NuGet intégrés. Par défaut, il est défini sur false.
Informations sur la version du code source et URL de l’idée Automation Hub	Sélectionnez cette option pour activer les métadonnées du package, y compris les informations de version du code source et l’URL de l’idée Automation Hub. Lorsqu’il est activé, vous pouvez spécifier les détails du référentiel et l’URL du projet.
Le chemin d’accès complet à project.json dans le référentiel distant	Spécifiez le chemin d’accès complet à project.json dans le référentiel distant. Disponible lorsque les métadonnées du package sont activées.
L’ID de validation	Spécifiez l'ID de validation de votre système de contrôle de version. Disponible lorsque les métadonnées du package sont activées. Exemple : $(Build.SourceVersion)
La branche du référentiel	Spécifiez le nom de la branche du référentiel. Disponible lorsque les métadonnées du package sont activées. Exemple : $(Build.SourceBranchName)
Le type de référentiel	Spécifiez le type de référentiel (par exemple, git). Disponible lorsque les métadonnées du package sont activées.
URL de l’idée Automation Hub	Spécifiez l’ URL de l’idée Automation Hub pour lier le package à une idée d’automatisation spécifique. Disponible lorsque les métadonnées du package sont activées.
Notes de publication	Spécifiez les notes de publication du package. Disponible lorsque les métadonnées du package sont activées.
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	Spécifiez le chemin d’accès aux stratégies de gouvernance contenant les règles de l’analyseur de workflow. Les politiques peuvent être téléchargées à partir d’Automation Ops ou extraites du fichier zip compressé exporté depuis Studio. Disponible lorsque l'analyse du workflow est activée.
Chemin d’accès au certificat	Spécifiez le chemin d'accès au fichier de certificat au format .pfx utilisé pour signer le package. Une fois fourni, le package sera signé numériquement avec le certificat. Exemple : $(Build.SourcesDirectory)\certificates\signing-cert.pfx
MotDePasseCertificat	Spécifiez le mot de passe du certificat. Il est recommandé de stocker cette valeur en tant que variable secrète dans Azure DevOps. Exemple : $(CertificatePassword)
URL du serveur d’horodatage	Spécifiez l’URL du serveur d’horodatage à utiliser lors de la signature du package. L’horodatage garantit que la signature reste valide même après l’expiration du certificat. Exemple : 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.

Exemple : Création de packages de base

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

Exemple : Package avec signature

- 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'

Exemple : Package avec analyse et signature de workflow

- 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 :

Lorsque vous utilisez la signature de packages, enregistrez votre mot de passe de certificat en tant que variable secrète dans Azure DevOps. Accédez à Pipelines > Bibliothèque > Groupes de variables ou définissez-le dans vos variables de pipeline avec l'icône de verrouillage activée pour la sécuriser.