automation-ops
latest
false
Important :
Veuillez noter que ce contenu a été localisé en partie à l’aide de la traduction automatique.
Guide de l'utilisateur Automation Ops
Automation CloudAutomation Cloud Public SectorAutomation Suite
Last updated 30 août 2024

Tâches

Vue d'ensemble (Overview)

Votre pipeline est composé de différentes étapes, qui à leur tour peuvent être décomposées en tâches. Pour chaque tâche, vous pouvez configurer les étapes pour inclure les tâches UiPath, incluses avec l'intégration UiPath pour Azure DevOps.

Attention : à partir d' avril 2023et 2023.4, les nouvelles exécutions seront bloquées dans les dossiers classiques. Pour les tâches qui incluent un dossier classique dans leur configuration, un message Folder not found s'affiche et la tâche n'est pas effectuée. En savoir plus sur la suppression des dossiers classiques ici.

Prérequis

Pour préparer votre environnement, consultez Prérequis pour l'extension Azure DevOps.

Considérations

Avant de commencer à exécuter des tâches dans votre pipeline, tenez compte des points suivants :

  • Vous devez exécuter des tâches UiPath uniquement sur des agents de développement basés sur Windows.
  • Configurez la connexion au service UiPath Orchestrator.
  • Les fonctionnalités de test nécessitent Orchestrator version 2020.4 ou ultérieure.
  • Si vous utilisez une version sur site d'Orchestrator avec HTTPS, importez le certificat SSL pour vous assurer que les appels HTTPS vers Orchestrator sont approuvés.

Interface de ligne de commande

L’extension Azure DevOps est livrée avec une CLI (interface de ligne de commande) intégrée spécifique à UiPath.

Mise en cache de la CLI

Lorsque vous exécutez l'agent de build, la CLI communique avec Orchestrator et vous permet d'exécuter vos tâches de tâche.

Par défaut, l'interface de ligne de commande est prépackagée dans l'extension AzureDevOps et est stockée dans le Agent.ToolsDirectory (cache Azure) lors de sa première exécution.
Lors de l'exécution d'une tâche sur l'agent de build, le système vérifie la CLI qui devrait se trouver à l'intérieur de Agent.ToolsDirectory , afin de terminer l'exécution.
Si l'interface de ligne de commande est introuvable dans Agent.ToolsDirectory (cache Azure), le système la télécharge automatiquement à partir du flux public NuGet. Une exigence est que le flux public NuGet ne soit pas bloqué par un pare-feu et soit accessible à partir de votre agent de build.
Si vous ne parvenez pas à ouvrir votre pare-feu à partir de votre agent de build, vous pouvez télécharger manuellement la CLI (correspondant à la version de build utilisée pour votre plug-in actuel) et la placer manuellement dans Agent.ToolsDirectory , à l'aide de la tâche Installer la plate-forme.

Ajouter des tâches UiPath au pool d'agents de pipeline

Pour définir une procédure d'automatisation dans votre pipeline, vous devez ajouter et configurer des tâches individuelles au pool d'agents.

  1. Accédez à Azure DevOps et allez à Pipelines.
  2. Créez un nouveau pipeline ou modifiez un pipeline existant.
  3. Ajoutez une tâche au pool d'agents.
  4. Recherchez l'une des tâches suivantes :
    1. UiPath Run Job
    2. UiPath Manage Assets
    3. Plate-forme d'installation UiPath
    4. UiPath Pack
    5. UiPath Deploy
    6. UiPath Test
  5. Cliquez sur Ajouter (Add) et configurez la tâche.
  6. Réorganisez les tâches dans le pool d'agents si nécessaire, puis enregistrez votre pipeline.
docs image

UiPath Run Job

Vous pouvez utiliser cette tâche pour exécuter un processus qui a déjà été déployé sur une instance Orchestrator. Pour plus d'informations, consultez Processus et Tâches.

Configuration

Utilisez la table suivante pour configurer les entrées de tâche d'exécution UiPath.

EntréeDescription
Nom complet (Display name) (obligatoire) Saisissez un nom pour votre tâche.
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.
Processus (Process) (obligatoire) Le processus est la version du package qui est liée à un type de dossier particulier. Vous devez configurer cette entrée en fonction du type de dossier sur lequel le processus est déployé. Pour les dossiers modernes, l'entrée est le nom du processus répertorié dans l'onglet Processus (Process). Pour connaître le nom du processus, vous pouvez ouvrir Orchestrator, ouvrir votre dossier et accéder à Automations (Automations) > Processus(Processes). Pour les dossiers classiques (obsolètes), l'entrée est le nom du processus, suivi d'un trait de soulignement, puis du nom de l'environnement , où les Robots sont hébergés.À titre d'exemple pour cette convention d'affectation de noms, considérons les variables suivantes : Le nom du processus estTestAutomation. Le nom de l'environnement est Production. Le nom de votre processus pour cette entrée est TestAutomation_Production.
Paramètres d’entréeSpécifiez le chemin du fichier d'entrée JSON, tel que Input\jobParameters.json.

Exemple de format de fichier JSON :

{
  "StringArgument_In": "MyConfigurationValue",
  "IntArgument_In": 1,
  "DictionaryArgument_In": {
    "Key1": "Value1",
    "Key2": "Value2"
  }
}{
  "StringArgument_In": "MyConfigurationValue",
  "IntArgument_In": 1,
  "DictionaryArgument_In": {
    "Key1": "Value1",
    "Key2": "Value2"
  }
}
Priorité (Priority)Sélectionnez la priorité d'exécution de tâche si vous souhaitez définir un ordre spécifique au niveau du processus. Par défaut, cette entrée est configurée sur Normal.
Dossier Orchestrator (obligatoire) Spécifiez le dossier dans lequel le processus est déployé. Pour les dossiers classiques, vous pouvez utiliser des noms de Robot spécifiques. Pour les dossiers modernes, vous pouvez utiliser des noms d’utilisateur et de machine spécifiques.

Pour saisir des sous-dossiers, assurez-vous de saisir à la fois le nom du dossier parent et le nom du sous-dossier. Par exemple, utilisez ÉquipeComptabilité\ÉquipeMichel (AccountingTeam\TeamJohn).

StrategySpécifiez la stratégie d'exécution pour l'allocation dynamique ou spécifique au Robot. Pour les tâches allouées dynamiquement, le processus est exécuté sous le compte et la machine disponibles. Vous pouvez également choisir des tâches spécifiques au Robot.
Type d'exécution Cette fonctionnalité est disponible uniquement pour les dossiers modernes. Choisissez le modèle de licence du runtime sous lequel la tâche doit être exécutée. Pour plus d'informations, consultez À propos des licences.
Nb de tâches Disponible uniquement pour la stratégie d'allocation dynamique. Spécifiez le nombre d'exécutions de cette tâche. Par défaut, cette entrée est définie sur 1 .
Utilisateur (User) Disponible uniquement pour les dossiers modernes avec une stratégie d'allocation dynamique. Par exemple, un utilisateur local pour cette entrée est MachineName\UserName.
Machine Disponible uniquement pour les dossiers modernes avec une stratégie d'allocation dynamique. Le nom de la machine qui lance l'exécution.
SortieLes résultats sont collectés dans un fichier JSON. Vous devez spécifier le chemin des résultats de tâche (par exemple, Output\testResults.json). Si vous laissez cette entrée vide, la sortie par défaut est envoyée au répertoire d'artefacts Staging sous le nom UiPathResults.json.
Délai d'attenteSpécifiez le nombre de secondes à attendre avant l'expiration de la demande.
Échec de la tâche globale en cas d’échec de tâcheSélectionnez cette entrée si vous souhaitez définir la tâche comme ayant échoué lorsqu'au moins une tâche a échoué. Cette entrée est sélectionnée par défaut.
Attendre l’achèvement de la tâcheAttendez l’achèvement de l'exécution de tâche. Cette entrée est sélectionnée par défaut.
Niveau du traçageSélectionnez l'utilisateur dans la liste déroulante.
IDRobots (robotsIds)Liste de noms de robot spécifiques séparés par une virgule.
docs image

Pipeline YAML

Vous pouvez prévisualiser un document YAML entièrement analysé pour la tâche d'exécution UiPath.
- task: UiPathRunJob@2
  displayName: 'Start ProcessProject'
  inputs:
    #orchestratorConnection: 'service-connection-name' # Service connection to UiPath Orchestrator
    #processName: 'ProccessProject_CI-Pipeline' # The name of the process
    #parametersFilePath: 'Input\\jobParameters.json' # json file with input values if the process requires them
    #priority: 'Low' # Options 'Low', 'Normal', 'High'
    #folderName: 'MyFolder' # Specify the folder to deploy to. For clasic folders, you can use specific robot names. For modern folders, you can use specific user and machine names.
    #strategy: 'Dynamically' # Options 'Specific', 'Dynamically'
    #jobCount: 1 # The number of job runs. (default 1) - used if strategy is 'Dynamically'
    #user: 'MyUser'
    #machine: 'machine'
    #robotsIds: 'robot1, robot2'
    #resultFilePath: 'Output\\testResults.json'
    #timeout: 3600
    #failWhenJobFails: false
    #waitForJobCompletion: false,
    #traceLevel: 'None' # Options: Critical, Error, Warning, Information, Verbose, None- task: UiPathRunJob@2
  displayName: 'Start ProcessProject'
  inputs:
    #orchestratorConnection: 'service-connection-name' # Service connection to UiPath Orchestrator
    #processName: 'ProccessProject_CI-Pipeline' # The name of the process
    #parametersFilePath: 'Input\\jobParameters.json' # json file with input values if the process requires them
    #priority: 'Low' # Options 'Low', 'Normal', 'High'
    #folderName: 'MyFolder' # Specify the folder to deploy to. For clasic folders, you can use specific robot names. For modern folders, you can use specific user and machine names.
    #strategy: 'Dynamically' # Options 'Specific', 'Dynamically'
    #jobCount: 1 # The number of job runs. (default 1) - used if strategy is 'Dynamically'
    #user: 'MyUser'
    #machine: 'machine'
    #robotsIds: 'robot1, robot2'
    #resultFilePath: 'Output\\testResults.json'
    #timeout: 3600
    #failWhenJobFails: false
    #waitForJobCompletion: false,
    #traceLevel: 'None' # Options: Critical, Error, Warning, Information, Verbose, None

UiPath Manage Assets

Vous pouvez utiliser cette tâche pour déployer, mettre à jour ou supprimer des ressources sur votre instance Orchestrator.

Les types de ressource suivants sont pris en charge :

  • Text : enregistre uniquement les chaînes (inutile d'ajouter des guillemets)
  • Boolean : prend en charge les valeurs Vrai (True) ou Faux (False)
  • Integer : enregistre uniquement les nombres entiers
  • Credential : contient les noms d'utilisateur et les mots de passe dont le Robot a besoin pour exécuter des processus particuliers. Pour ce type de ressource, vous devez coder le nom d'utilisateur et le mot de passe en utilisant :: pour séparer les deux champs.
Pour déployer des ressources, vous devez les ajouter à un fichier CSV encodé en UTF-8, comme dans l'exemple suivant :
name,type,value, description asset_1_name,text,asset_value, asset_2_name,integer,123,asset_3_name,boolean,false, this is an asset description asset_4_name,credential,"username::password",name,type,value, description asset_1_name,text,asset_value, asset_2_name,integer,123,asset_3_name,boolean,false, this is an asset description asset_4_name,credential,"username::password",

Pour plus d'informations, consultez Ressources Orchestrator.

Configuration

Utilisez la table suivante pour configurer les entrées de gestion des ressources UiPath.

ArgumentDescription
Nom complet (Display name) (obligatoire) Saisissez un nom pour votre tâche.
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.
Dossier Orchestrator (obligatoire) Spécifiez le dossier dans lequel le processus est déployé. Pour les dossiers classiques, vous pouvez utiliser des noms de Robot spécifiques. Pour les dossiers modernes, vous pouvez utiliser des noms d’utilisateur et de machine spécifiques.

Pour saisir des sous-dossiers, assurez-vous de saisir à la fois le nom du dossier parent et le nom du sous-dossier. Par exemple, utilisez ÉquipeComptabilité\ÉquipeMichel (AccountingTeam\TeamJohn).

Choisir une action de ressource (obligatoire) Sélectionnez une option dans la liste déroulante.
Fichier CSV de ressources (obligatoire) Ajoutez le chemin du fichier CSV. Vous pouvez utiliser le même fichier pour les actions de déploiement et de mise à jour de ressource. Considérations :
  • L'utilisation de guillemets dans les valeurs est autorisée (par exemple, ""A new version of RPA REPORT – AM Email Quote to Agent is available"" )
  • Les valeurs JSON sont prises en charge (par exemple "{""MaxRetryNumber"":3,""Name"":My Test Process}" )
  • Les commentaires ne sont pas pris en charge (par ex. asset_1_name,credential,""username::password"" # asset_1_description comment )
Pour les actions de suppression de ressource, vous pouvez utiliser uniquement la colonne de nom et laisser les autres colonnes vides.
(Facultatif) Vous pouvez définir une description pour chaque ressource à l'aide de la syntaxe suivante : type, value ,description.
Niveau du traçageSélectionnez l'utilisateur dans la liste déroulante.
docs image

Pipeline YAML

Vous pouvez prévisualiser un document YAML entièrement analysé pour la tâche de gestion des ressources UiPath.
- task: UiPathAssets@2
  displayName: 'Deploy/Update assets'
  inputs:
    #orchestratorConnection: 'service-connection-name' # Service connection to UiPath Orchestrator
    #assetActionType: 'Deploy' # Options: Deploy, Delete
    #csvFile: 'assets_deploy.csv' # the path to the csv file containing the assets description,
    #traceLevel: 'None' # Options: Critical, Error, Warning, Information, Verbose, None- task: UiPathAssets@2
  displayName: 'Deploy/Update assets'
  inputs:
    #orchestratorConnection: 'service-connection-name' # Service connection to UiPath Orchestrator
    #assetActionType: 'Deploy' # Options: Deploy, Delete
    #csvFile: 'assets_deploy.csv' # the path to the csv file containing the assets description,
    #traceLevel: 'None' # Options: Critical, Error, Warning, Information, Verbose, None

Plate-forme d'installation UiPath

Vous pouvez utiliser la tâche UiPathInstallPlatform lorsque les agents de build n'ont pas accès à UiPath NuGet Feed. Vous devez exécuter la tâche UiPathInstallPlatform avant toute autre tâche de l'extension. Cette tâche dispose d'un outil prêt à l'emploi que toutes les autres tâches UiPath utilisent. La tâche est facultative, mais son avantage est qu'elle réduit le temps d'exécution d'autres tâches.
docs image

Sélecteur de version CLI

Sélectionnez la version de l'interface de ligne de commande que vous souhaitez utiliser avec votre extension Azure DevOps dans la liste déroulante Choisir une version de l'interface de ligne de commande (obligatoire).

Les options de la liste déroulante incluent :

  • Les dernières versions disponibles de la CLI.
  • Les exigences d'environnement dont vous avez besoin pour être compatible avec la version CLI que vous choisissez.
docs image

Chemin d'accès au nupkg de la CLI

Si votre pipeline ne parvient pas à accéder au flux public UiPath et ne peut pas télécharger la version CLI que vous avez choisie dans la liste déroulante, suivez les étapes ci-dessous :

  1. Téléchargez la version CLI souhaitée à partir du flux public UiPath.
  2. Placez le fichier NUPKG téléchargé dans le répertoire Agent.Tools de votre agent de build. N'oubliez pas le chemin du fichier NUPKG dans le répertoire Agent.Tools . Par exemple, $(Agent.ToolsDirectory)\nupkg\UiPath.CLI.xx.xx.xx.nupkg
  3. Utilisez la tâche InstallPlatform et saisissez le chemin d'accès utilisé à l'étape 2 dans le champ Path to CLI's nupkg.
    docs image

Pipeline YAML

Vous pouvez prévisualiser un document YAML entièrement analysé pour la plate-forme d'installation UiPath, y compris le sélecteur de version CLI :

- task: UiPathInstallPlatform-preview@2
  displayName: 'UiPath Install Platform'
  inputs:
    cliVersion: 'WIN_22.10.8418.30339' or 'X_22.10.8418.30339' or '21.10.8319.10920
    cliNupkgPath:'$(Agent.ToolsDirectory)\nupkg\UiPath.CLI.X.22.10.8418.30339.nupkg'- task: UiPathInstallPlatform-preview@2
  displayName: 'UiPath Install Platform'
  inputs:
    cliVersion: 'WIN_22.10.8418.30339' or 'X_22.10.8418.30339' or '21.10.8319.10920
    cliNupkgPath:'$(Agent.ToolsDirectory)\nupkg\UiPath.CLI.X.22.10.8418.30339.nupkg'

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.

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

  • AutoVersion: cette option met à jour automatiquement la version au numéro séquentiel suivant. Vous pouvez utiliser l'exemple de configuration de tâche suivant :

    - 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'
  • VersionManuelle: avec cette option, vous pouvez spécifier votre propre numéro de version. Vous pouvez utiliser l'exemple de configuration de tâche suivant :

    - 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'
  • VersionActuelle: cette option conserve la même version que celle spécifiée dans le fichier project.json . Vous pouvez utiliser l'exemple de configuration de tâche suivant :
    - 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 empaqueté. 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 : 'Process', 'Library', 'Tests', 'Objects', 'None'.
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 (obligatoire) Définissez un chemin de dossier où le package sera placé.
Exécuter l’analyse du workflowSé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.
Niveau du traçageSélectionnez l'utilisateur dans la liste déroulante.
docs image

Pipeline YAML

Vous pouvez prévisualiser un document YAML entièrement analysé pour la tâche de compression UiPath.
- task: UiPathPack@2
  inputs:
    #versionType: AutoVersion # Options: AutoVersion, CurrentVersion, ManualVersion 
    #version: '1.0.0' # Required when versionType == ManualVersion
    #projectJsonPath: '$(Build.SourcesDirectory)\MyFirstProcess'
    #outputPath: '$(Build.ArtifactStagingDirectory)\Packages\MyFirstProcess'
    #outputType: 'None' # Options: Process, Library, Tests, Objects, None
    #runWorkflowAnalysis: 'False'
    #orchestratorConnection: 'service-connection-name' # Service connection to UiPath Orchestrator,
    #traceLevel: 'None' # Options: Critical, Error, Warning, Information, Verbose, None- task: UiPathPack@2
  inputs:
    #versionType: AutoVersion # Options: AutoVersion, CurrentVersion, ManualVersion 
    #version: '1.0.0' # Required when versionType == ManualVersion
    #projectJsonPath: '$(Build.SourcesDirectory)\MyFirstProcess'
    #outputPath: '$(Build.ArtifactStagingDirectory)\Packages\MyFirstProcess'
    #outputType: 'None' # Options: Process, Library, Tests, Objects, None
    #runWorkflowAnalysis: 'False'
    #orchestratorConnection: 'service-connection-name' # Service connection to UiPath Orchestrator,
    #traceLevel: 'None' # Options: Critical, Error, Warning, Information, Verbose, None

UiPath Deploy

La tâche de déploiement UiPath vous permet de déployer un package UiPath NuGet sur UiPath Orchestrator.

Configuration

Utilisez la table suivante pour configurer les entrées de déploiement UiPath.

ArgumentDescription
Nom complet (Display name) (obligatoire) Saisissez un nom pour votre tâche.
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.
Package(s) (obligatoire) Définissez le flux pour vos packages UiPath NuGet.
Créer automatiquement un processusSélectionnez cette option si vous souhaitez déployer un package sans créer de processus. L'option est sélectionnée par défaut. Si elle est sélectionnée, vous devez configurer le paramètre Chemin d'accès au point d'entrée.
Dossier Orchestrator (obligatoire) Spécifiez le dossier dans lequel le processus est déployé. Pour les dossiers classiques (obsolète), vous pouvez utiliser des noms de Robot spécifiques. Pour les dossiers modernes, vous pouvez utiliser des noms d’utilisateur et de machine spécifiques.
Pour saisir des sous-dossiers, assurez-vous de saisir à la fois le nom du dossier parent et le nom du sous-dossier. Par exemple, utilisez AccountingTeam\TeamJohn.
Environnement (Environment)(Facultatif) Si vous utilisez des dossiers classiques (obsolètes), vous devez définir l'environnement dans lequel les packages vont être déployés. Vous pouvez utiliser ce champ pour créer ou mettre à jour des packages. Vous pouvez utiliser l'exemple suivant pour ajouter vos environnements à ce champ, séparés par une virgule : testingEnvironment,productionEnvironment.
Chemin(s) du point d'entrée (obligatoire) Spécifiez les chemins des points d'entrée pour créer ou mettre à jour un processus. Le chemin du point d'entrée spécifie le chemin du fichier à partir de la racine du projet. Avant de configurer les chemins des points d'entrée, tenez compte des éléments suivants : Les points d'entrée sont disponibles pour la version 21.4 ou ultérieure d'Orchestrator (par ex. 21.4.UiPathDeploy.entryPoints ). Pour les versions d'Orchestrator antérieures à 21.4, vous devez saisir n'importe quelle valeur, car le champ ne doit pas rester vide. Le point d'entrée par défaut est défini sur Main.xaml . Plusieurs points d'entrée peuvent être spécifiés en tant que 'Main.xaml, PointEntrée2.xaml '. Pour les dossiers classiques (obsolètes), vous ne pouvez spécifier qu'un seul point d'entrée pour chaque environnement. Pour les dossiers imbriqués, vous devez spécifier le chemin d'accès au fichier, comme suit : Folder01/Folder02/Main.xaml ou Folder01/Folder02/Entrypoint.xaml Pour plus d'informations, consultez Points d'entrée Orchestrator.
Niveau du traçageSélectionnez l'utilisateur dans la liste déroulante.
docs image

Pipeline YAML

Vous pouvez prévisualiser un document YAML entièrement analysé pour la tâche de déploiement UiPath.
- task: UiPathDeploy@2
  inputs:
    #orchestratorConnection: # Service connection to UiPath Orchestrator
    #packagesPath: '$(Build.ArtifactStagingDirectory)\Packages\ITAutomationProcess'
    #folderName: 'ITAutomation'
    #environments: 'AutomationRobots' # Optional,
    #traceLevel: 'None' # Options: Critical, Error, Warning, Information, Verbose, None- task: UiPathDeploy@2
  inputs:
    #orchestratorConnection: # Service connection to UiPath Orchestrator
    #packagesPath: '$(Build.ArtifactStagingDirectory)\Packages\ITAutomationProcess'
    #folderName: 'ITAutomation'
    #environments: 'AutomationRobots' # Optional,
    #traceLevel: 'None' # Options: Critical, Error, Warning, Information, Verbose, None

UiPath Test

En règle générale, la tâche de test UiPath exécute un ensemble de test existant sur Orchestrator. De plus, vous pouvez l'utiliser pour compresser, déployer et exécuter des cas de test en spécifiant le chemin d'un projet de test UiPath. Cette dernière option s'affiche dans Orchestrator en tant qu'ensemble de test temporaire.

Une fois l'exécution de la tâche terminée, les résultats de test sont chargés dans l'onglet Test d'Azure DevOps. Vous pouvez spécifier le chemin de sortie des résultats des tests au format JUnit.

En fonction du résultat, le build sera soit marqué comme réussi (tous les cas de test sont réussis), soit comme échoué (au moins un cas de test a échoué).

Configuration

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

ArgumentDescription
Nom complet (Display name) (obligatoire) Saisissez un nom pour votre tâche.
Choisir une méthode d’exécution de testChoisissez le test que vous souhaitez exécuter : Exécuter l'ensemble de test (Execute test set) : spécifiez et exécutez un ensemble de test existant dans Orchestrator. Exécuter les tests du projet (Execute tests in project) : spécifiez un projet, déployez le package et exécutez les cas de test dans le cadre d'un ensemble de test temporaire.
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.
Paramètres d’entréeSpécifiez le chemin d'accès à un fichier d'entrée JSON, tel que Input\jobParameters.json . Spécifiez l'argument type si vous créez de nouveaux arguments d'entrée au niveau de l'ensemble de test. Sinon, vous pouvez utiliser name et value .
Ensemble de test (obligatoire pour la méthode Exécuter l’ensemble de test (Execute test set)) Le nom affiché pour l'ensemble de tests que vous souhaitez exécuter. Assurez-vous que l'ensemble de tests inclut la version la plus récente des cas de test.
Si l'ensemble de tests ne se trouve pas dans le dossier par défaut, assurez-vous d'inclure avant le nom du dossier pertinent. Par exemple, utilisez AccountingTeam\TestSet.
Chemin du projet de test (obligatoire pour la méthode Exécuter les tests du projet (Execute tests in project)) Spécifiez l'emplacement du projet de test qui va être exécuté dans le cadre d'un ensemble de test temporaire.
Environnement (Environment) (obligatoire pour la méthode Exécuter l’ensemble de test (Execute test set)) Si vous utilisez des dossiers classiques (obsolètes), vous devez définir l'environnement dans lequel les packages vont être déployés. Vous pouvez utiliser ce champ pour créer ou mettre à jour des packages. Vous pouvez utiliser l'exemple suivant pour ajouter vos environnements à ce champ, séparés par une virgule : testingEnvironment, productionEnvironment.
Dossier Orchestrator (obligatoire) Spécifiez le dossier dans lequel le processus est déployé. Pour les dossiers classiques (obsolète), vous pouvez utiliser des noms de Robot spécifiques. Pour les dossiers modernes, vous pouvez utiliser des noms d’utilisateur et de machine spécifiques.
Pour saisir des sous-dossiers, assurez-vous de saisir à la fois le nom du dossier parent et le nom du sous-dossier. Par exemple, utilisez AccountingTeam\TeamJohn.
Chemin de sortie des résultats de testSpécifiez le chemin de sortie des résultats de test au format JUnit (par exemple, Output\testResults.json).
Délai d'attenteSpécifiez le nombre de secondes à attendre avant l'expiration de la demande.
Niveau du traçageSélectionnez l'utilisateur dans la liste déroulante.
Joindre les journaux des événements du RobotSélectionnez cette option pour joindre les journaux de niveau INFO du Robot en cours d'exécution. Par défaut, cette option n'est pas sélectionnée. Pour plus d'informations, consultez Journaux des événements du Robot.
docs image

Pipeline YAML

Vous pouvez prévisualiser un document YAML entièrement analysé pour la tâche de test UiPath.
-- task: UiPathTest@2
  inputs:
    #testTarget: TestProject # Options: TestProject, TestSet
    #orchestratorConnection: # Service connection to UiPath Orchestrator
    #testProjectPath: '$(Build.SourcesDirectory)\MobileAutomationTests' # Required only when testTarget = TestProject
    #testSet: 'MobileAutomationTests' # Required only when testTarget = TestSet
    #folderName: 'MobileAutomationTesting'
    #environment: 'TestingRobots' # Required only when testTarget = TestProject and the folder is a classic folder
    #testReportDestination: '$(Build.ArtifactStagingDirectory)\report.xml' # Optional
    #timeout: 200 # Optional, default = 3600s,
    #traceLevel: 'None' # Options: Critical, Error, Warning, Information, Verbose, None task: UiPathTest@2-- task: UiPathTest@2
  inputs:
    #testTarget: TestProject # Options: TestProject, TestSet
    #orchestratorConnection: # Service connection to UiPath Orchestrator
    #testProjectPath: '$(Build.SourcesDirectory)\MobileAutomationTests' # Required only when testTarget = TestProject
    #testSet: 'MobileAutomationTests' # Required only when testTarget = TestSet
    #folderName: 'MobileAutomationTesting'
    #environment: 'TestingRobots' # Required only when testTarget = TestProject and the folder is a classic folder
    #testReportDestination: '$(Build.ArtifactStagingDirectory)\report.xml' # Optional
    #timeout: 200 # Optional, default = 3600s,
    #traceLevel: 'None' # Options: Critical, Error, Warning, Information, Verbose, None task: UiPathTest@2

Cette page vous a-t-elle été utile ?

Obtenez l'aide dont vous avez besoin
Formation RPA - Cours d'automatisation
Forum de la communauté UiPath
Uipath Logo White
Confiance et sécurité
© 2005-2024 UiPath Tous droits réservés.