- Notes de publication
- Introduction
- Gouvernance
- Contrôle de code source
- Pipelines CI/CD
- Gestion des flux
- Journalisation
Interface de ligne de commande UiPath
UiPath® propose une interface de ligne de commande (CLI) qui vous permet d'exécuter certaines tâches prédéfinies dans le cadre de la gestion et du test des packages RPA. Le but de la CLI UiPath est d'intégrer facilement ces fonctionnalités à des outils tiers tels que GitLab, Jenkins et bien d'autres, sans plug-in.
UiPath CLI peut être utilisé avec Orchestrator déployé via Automation Cloud™, Automation Suite ou version autonome.
Les cas d'utilisation courants de l'interface de ligne de commande UiPath impliquent :
- Emballage de projets Studio dans des packages NuGet.
- Déployer des packages NuGet sur Orchestrator.
- Exécution de tâches dans Orchestrator.
- Exécution d'ensembles de tests dans Orchestrator.
La CLI UiPath se compose de deux types :
-
UiPath.CLI.Windows
- Fonctionne uniquement sur les appareils Windows.
- Génère des projets Windows - Legacy,Windowset multiplateformes .
-
CheminUi.CLI
- Fonctionne uniquement sur les appareils Linux.
- Génère uniquement des projets multiplateformes .
-
CLI UiPath ne prend pas en charge la connexion via authentification unique.
-
CLI UiPath ne peut pas être utilisée pour créer des projets utilisant des déclencheurs locaux.
-
UiPath CLI ne dispose pas de la fonctionnalité permettant de signer un package, une fonctionnalité qui est disponible lorsque vous publiez le package à partir de Studio. Dans ce cas, la seule option consiste à signer le package après sa création à l'aide de la CLI UiPath. Pour plus de détails, consultez la commande sign. Cette option de signature fonctionne également pour Azure DevOps et Jenkins.
- Pour UiPath.CLI, installez .NET 6.0.7, fourni avec le SDK 6.0.302 ou toute version ultérieure.
- Pour UiPath.CLI.Windows, installez .NET 6.0.7ou supérieur. Vous devez également installer .NET Desktop Runtime, qui est également fourni avec le SDK .NET.
Vous pouvez télécharger n'importe quelle version de l'interface de ligne de commande UiPath à partir du flux public officiel UiPath. Pour trouver la bonne version pour votre projet, consultez la matrice de compatibilité ci-dessous.
uipcli.exe
(pour UiPath.CLI.Windows) ou uipcli.dll
(pour UiPath.CLI), situé dans le dossier tools
.
La version d'UiPath Studio que vous utilisez pour créer vos projets doit correspondre à la version de UiPath.CLI.Windows.
Légende: compatibles ; - non compatible.
Orchestrator |
Type de projet |
UiPath.CLI.Windows 23.10 |
UiPath.CLI.Windows 23.6 |
UiPath.CLI.Windows 22.10 |
---|---|---|---|---|
2023.10.x PaaS | Windows - Héritage |
|
|
|
2023.10.x PaaS | Windows |
|
|
|
2023.10.x PaaS | Multiplateforme |
|
|
|
2021.10.x On-Premises |
Windows - Héritage |
|
|
|
2021.10.x On-Premises |
Windows |
|
|
|
2021.10.x On-Premises |
Multiplateforme |
|
|
|
2021.10.x PaaS |
Windows - Héritage |
|
|
|
2021.10.x PaaS |
Windows |
|
|
|
2021.10.x PaaS |
Multiplateforme |
|
|
|
2022.4.x |
Windows - Héritage |
|
|
|
2022.4.x |
Windows |
|
|
|
2022.4.x |
Multiplateforme |
|
|
|
2022.10.x |
Windows - Héritage |
|
|
|
2022.10.x |
Windows |
|
|
|
2022.10.x |
Multiplateforme |
|
|
|
2023.4.x | Windows-héritage |
|
|
|
2023.4.x | Windows |
|
|
|
2023.4.x | Multiplateforme |
|
|
|
Cloud |
Windows - Héritage |
|
|
|
Cloud |
Windows |
|
|
|
Cloud |
Multiplateforme |
|
|
|
La version de UiPath Studio que vous utilisez pour créer vos projets doit correspondre à la version de UiPath.CLI. Par exemple, si vous créez des projets à l'aide d'UiPath Studio 2021.10, vous devez utiliser la version 21.10 de UiPath.CLI.
Légende: compatibles ; - non compatible.
Orchestrator | Type de projet | UiPath.CLI 23.10 | UiPath.CLI 23.6 | UiPath.CLI 22.10 | UiPath.CLI 22.4 | UiPath.CLI 21.10 |
---|---|---|---|---|---|---|
2023.10.x PaaS | Windows - Héritage |
|
|
|
|
|
2023.10.x PaaS | Windows |
|
|
|
|
|
2023.10.x PaaS | Multiplateforme |
|
|
|
|
|
2021.10.x On-Premises |
Windows - Héritage |
|
|
|
|
|
2021.10.x On-Premises |
Windows |
|
|
|
|
|
2021.10.x On-Premises |
Multiplateforme |
|
|
|
|
|
2021.10.x PaaS |
Windows - Héritage |
|
|
|
|
|
2021.10.x PaaS |
Windows |
|
|
|
|
|
2021.10.x PaaS |
Multiplateforme |
|
|
|
|
|
2022.4.x |
Windows - Héritage |
|
|
|
|
|
2022.4.x |
Windows |
|
|
|
|
|
2022.4.x |
Multiplateforme |
|
|
|
|
|
2022.10.x |
Windows - Héritage |
|
|
|
|
|
2022.10.x |
Windows |
|
|
|
|
|
2022.10.x |
Multiplateforme |
|
|
|
|
|
2023.4.x | Windows-héritage |
|
|
|
|
|
2023.4.x | Windows |
|
|
|
|
|
2023.4.x | Multiplateforme |
|
|
|
|
|
Cloud |
Windows - Héritage |
|
|
|
|
|
Cloud |
Windows |
|
|
|
|
|
Cloud |
Multiplateforme |
|
|
|
|
|
uipcli
recherche les dépendances dans les flux intégrés suivants :
-
C:\Program Files\Microsoft SDKs\NuGetPackages
(si ce chemin se trouve sur l'agent actuel) -
C:\Program Files (x86)\Microsoft SDKs\NuGetPackages
(si ce chemin se trouve sur l'agent actuel)
uipcli
pour ne pas utiliser les flux intégrés en définissant le paramètre --disableBuiltInNugetFeeds
. Ce paramètre peut être utilisé pour les tâches suivantes : analyze
, pack
et test run
.
uipcli
avec un fichier de configuration, définissez "disableBuiltInNugetFeeds": true
.
Vous pouvez utiliser des flux personnalisés lors de la mise en package d’une automatisation. Pour ce faire, vous devez :
-
Créez un fichier
nuget.config
personnalisé avec le format suivant :<?xml version="1.0" encoding="utf-8"?> <configuration> <packageSources> <add key="test custom feed" value="custom_feed_url" /> </packageSources> </configuration>
<?xml version="1.0" encoding="utf-8"?> <configuration> <packageSources> <add key="test custom feed" value="custom_feed_url" /> </packageSources> </configuration> -
Placez le fichier
nuget.config
personnalisé dans le dossier oùuipcli
est mis en cache :
Utilisation de nuget.config personnalisé dans Azure DevOps
nuget.config
vers $(Agent.ToolsDirectory)/uipcli
, après l’étape InstallPlatform
, comme illustré dans l’exemple suivant :
trigger:
- main
pool:
vmImage: ubuntu-latest
stages:
- stage: Demo
jobs:
- job: Demo
steps:
- task: UiPathInstallPlatform@4
inputs:
cliVersion: 'X_23.6.8581.19168'
- task: CopyFiles@2
inputs:
SourceFolder: '$(Build.SourcesDirectory)'
Contents: 'nuget.config'
TargetFolder: '$(Agent.ToolsDirectory)/uipcli'
- task: UiPathPack@4
inputs:
versionType: 'AutoVersion'
projectJsonPath: '$(Build.SourcesDirectory)/AutomationProjects/CrossPlatform/VB/ProjectWithCustomLibraryFromOrchestrator_CrossPlatform_VB/project.json'
outputPath: '$(Build.ArtifactStagingDirectory)/Output'
traceLevel: 'Information'
trigger:
- main
pool:
vmImage: ubuntu-latest
stages:
- stage: Demo
jobs:
- job: Demo
steps:
- task: UiPathInstallPlatform@4
inputs:
cliVersion: 'X_23.6.8581.19168'
- task: CopyFiles@2
inputs:
SourceFolder: '$(Build.SourcesDirectory)'
Contents: 'nuget.config'
TargetFolder: '$(Agent.ToolsDirectory)/uipcli'
- task: UiPathPack@4
inputs:
versionType: 'AutoVersion'
projectJsonPath: '$(Build.SourcesDirectory)/AutomationProjects/CrossPlatform/VB/ProjectWithCustomLibraryFromOrchestrator_CrossPlatform_VB/project.json'
outputPath: '$(Build.ArtifactStagingDirectory)/Output'
traceLevel: 'Information'
Utilisation de nuget.config personnalisé dans Jenkins
nuget.config
vers ${WORKSPACE}/CLI
, après l’étape InstallPlatform
, comme illustré dans l’exemple suivant :
pipeline {
agent {
label 'plugins-jenkins-lts-agent-01'
}
stages {
stage('Clone') {
steps {
git (
branch: 'main',
url: 'https://github.com/al3xandru-uipath-qa/CI-Plugins-Customer-Support.git'
)
}
}
stage('Install Platform') {
steps {
UiPathInstallPlatform (
traceLevel: 'Information'
)
}
}
stage('Copy nuget.config') {
steps {
bat 'copy nuget.config CLI\\nuget.config'
}
}
stage('Pack') {
steps {
UiPathPack (
outputPath: '${WORKSPACE}/Output',
projectJsonPath: '${WORKSPACE}/AutomationProjects/CrossPlatform/VB/ProjectWithCustomLibraryFromOrchestrator_CrossPlatform_VB/project.json',
traceLevel: 'Information',
version: AutoVersion()
)
}
}
}
}
pipeline {
agent {
label 'plugins-jenkins-lts-agent-01'
}
stages {
stage('Clone') {
steps {
git (
branch: 'main',
url: 'https://github.com/al3xandru-uipath-qa/CI-Plugins-Customer-Support.git'
)
}
}
stage('Install Platform') {
steps {
UiPathInstallPlatform (
traceLevel: 'Information'
)
}
}
stage('Copy nuget.config') {
steps {
bat 'copy nuget.config CLI\\nuget.config'
}
}
stage('Pack') {
steps {
UiPathPack (
outputPath: '${WORKSPACE}/Output',
projectJsonPath: '${WORKSPACE}/AutomationProjects/CrossPlatform/VB/ProjectWithCustomLibraryFromOrchestrator_CrossPlatform_VB/project.json',
traceLevel: 'Information',
version: AutoVersion()
)
}
}
}
}