Paramètres de la ligne de commande de la mise à jour groupée

L'interface utilisateur de ligne de commande Mise à jour groupée des dépendances du projet (Project Dependencies Mass Update) permet de mettre à jour en bloc les fichiers project.json appartenant à plusieurs projets d'automatisation. Elle permet d'ajouter ou de supprimer des dépendances, de modifier les versions de paquets et les règles de runtime, et de signer des processus ou des bibliothèques avant de les publier.

Notez que lorsque vous utilisez l'Outil Mise à jour groupée des dépendances du projet (Project Dependencies Mass Update Tool), vous acceptez implicitement les conditions de licence de chaque version de paquet à mettre à jour.

Remarque :

L'interface utilisateur de ligne de commande Mise à jour groupée des dépendances du projet (Project Dependencies Mass Update) est disponible pour l'édition Studio Enterprise à partir de Studio v2018.4.4.

UiPath.Studio.CommandLine.exe est disponible dans le dossier d'installation :

• Pour les installations par machine, le chemin par défaut est C:\Program Files\UiPath\Studio\.

• Pour les installations par utilisateur, le chemin par défaut est %localappdata%\Programs\UiPath\Studio.

  

Certaines commandes peuvent ne pas être disponibles selon les systèmes de contrôle de code source auxquels Studio est connecté (GIT, SVN ou TFS). Pour afficher les arguments spécifiques de chaque commande, utilisez simplement --help. Utilisez --version pour vérifier la version de UiPath.Studio.CommandLine.exe.

Vous pouvez utiliser des combinaisons de plusieurs commandes dans une seule ligne de commande. En outre, il n'est pas nécessaire de répéter certains arguments dans la même ligne de commande, par exemple r, --repository lorsqu'ils sont utilisés avec svn login et svn checkout.

Remarque :

Avant d'utiliser l'interface utilisateur de ligne de commande Mise à jour groupée des dépendances de projets (Project Dependencies Mass Update) avec TFS, assurez-vous que les projets à mettre à jour sont déconnectés de TFS pour l'utilisateur actuel.

Il est recommandé d'enregistrer et de fermer les projets de Studio, avant de les modifier en utilisant l'Outil Mise à jour groupée des dépendances du projet (Project Dependencies Mass Update Tool).

Commandes de mise à jour de fichiers locaux

• list : recherchez et affichez les chemins d'accès aux fichiers project.json dans un certain répertoire. Les projets provenant d'un lecteur réseau local peuvent être également répertoriés. Les arguments suivants doivent être utilisés avec la commande list :

  Argument	Description
  -d, --directory	Le répertoire qui stocke les fichiers à répertorier. Utilisez les arguments -u, --user et -p, --pass pour les répertoires distants protégés par mot de passe.

  Remarque :

  Si l'argument --directory n'est pas utilisé avec la commande list, les chemins d'accès à tous les fichiers project.json du répertoire de travail actuel s'affichent.

• manage : gérez le projet spécifié. Notez que vous pouvez ajouter ou supprimer plusieurs dépendances et règles, à condition qu'elles soient séparées par des espaces. Les arguments suivants doivent être utilisés avec la commande manage :

Argument	Description
-a, --add-ref	Ajoute ou met à jour la dépendance et la règle de runtime sur le fichier project.json. ”dependencyname|version|runtimerule” : ajoute ou met à jour la version de la dépendance et la règle de runtime. ”dependencyname|prereleaseversion|runtimerule” : ajoute la version préliminaire de la dépendance et la règle de runtime spécifiée.
r, --rem-ref	Supprime les dépendances spécifiées du fichier project.json. "dependencyname" : la dépendance à supprimer du projet, quelle que soit sa version. "dependencyname|version" : supprime la dépendance avec cette version spécifique, que ce soit une version préliminaire ou non.
-p, --project-path	Chemin d'accès au fichier project.json.

Remarque :

La syntaxe des règles de runtime est lowest pour Version applicable la plus ancienne (Lowest Applicable Version), et strict pour la version Strict (Strict). Si aucun de ces deux paramètres n'est mentionné, l'option Lowest Applicable Version (Version applicable la plus ancienne) est appliquée par défaut.

Par exemple, la commande manage --project-path "C:\Users\username\Documents\UiPath\BlankProcess\project.json" --add-ref "UiPath.Excel.Activities|2.6.2|lowest" suivante passe la version du paquet à 2.6.2 et la règle de runtime à la version applicable la plus ancienne.

• publish : publiez le projet avec les modifications dans les dépendances. Les arguments suivants doivent être utilisés avec la commande publish :

Argument	Description
-p, --project-path	Le chemin vers le project.json à publier. L’argument est obligatoire.
-g, --target	Où publier le projet : Custom - URL personnalisée ou dossier local. Définissez l'emplacement à l'aide de l'argument -f, --feed. Robot - Emplacement de publication par défaut du Robot, s’il n’est pas connecté à Orchestrator. Non disponible pour la publication de bibliothèques ou de modèles. OrchestratorTenant - Flux de processus de locataire Orchestrator (pour les processus et les cas de test) ou flux de bibliothèques Orchestrator (pour les bibliothèques et les modèles). OrchestratorPersonalFolder - Flux d’espace de travail personnel Orchestrator. Non disponible pour la publication de bibliothèques, de modèles ou de cas de test. OrchestratorFolderHierarchy - Si un dossier de premier niveau avec un flux de package distinct ou un de ses sous-dossiers est sélectionné dans le menu des dossiers de la barre de statut de Studio, le flux de cette hiérarchie de dossiers.Non disponible pour la publication de bibliothèques ou de modèles.
-f, --feed	L'URL personnalisée pour la publication du projet. Cela peut également être un répertoire local distant, semblable au chemin d'accès de l'onglet Options de publication (Publish options) dans Studio.
-a, --api-key	La clé API pour la publication du projet. Cet argument peut être utilisé pour une cible personnalisée.
-i, --icon	Chemin d'accès à l'icône personnalisée à utiliser pour le package.
-n, --notes	Notes de publication qui contiennent des modifications apportées au projet.
-v, --new-version	La nouvelle version du projet.
-t, --timeout	Spécifie la valeur du délai d'expiration pour la publication des projets. Le délai d'expiration par défaut est de 30 secondes. Ce paramètre s'applique uniquement au transfert de paquets vers une durée d'Orchestrator.
--cer-path	Chemin d'accès local au certificat pour la signature de paquets.
--cer-password	Mot de passe du certificat.
--timestamper-url	URL de l'horodateur.
--incl-all-feeds	Non requis.
--version-update-type	Spécifie comment la version du projet s'incrémente : IncrementOnly – La version du projet s'incrémente automatiquement. ForcePrerelease – La version du projet est incrémentée et marquée comme version préliminaire avec un suffixe spécifié, quelle que soit sa version actuelle. Si aucun suffixe n'est défini avec l'argument --prerelease-suffix, le suffixe par défaut est alpha. ForceRelease – La version du projet est incrémentée et marquée comme étant prête pour la publication, quelle que soit sa version actuelle.
--prerelease-suffix	Spécifie le suffixe à utiliser lorsque la valeur --version-update-type est définie sur ForcePrerelease.

Remarque :

Actuellement, les extensions de certificat .pfx et .p12 sont acceptées pour la signature de projets.Pour plus de détails, consultez la page Signature de packages.

En s'appuyant sur l'exemple ci-dessus, la commande suivante met à jour le pack UiPath.Excel.Activities à la version 2.6.2, passe la règle de runtime à la version applicable la plus ancienne, ajoute des notes de publication et une nouvelle version, et publie le projet à un emplacement personnalisé :

manage --project-path "C:\Users\username\Documents\UiPath\BlankProcess\project.json" --add-ref "UiPath.Excel.Activities|2.6.2|lowest" publish --project-path "C:\Users\username\Documents\UiPath\BlankProcess\project.json" --target Custom --feed "C:\Users\username\Desktop\myfeed" --notes "Changes were made to the Excel package" --new-version "1.0.2".

Commandes de l'analyseur de workflow

Vous pouvez utiliser les paramètres de ligne de commande pour analyser des fichiers ou des projets concernant un ensemble de règles.

• analyze : Analyse l'ensemble du projet. Requiert le chemin d'accès au fichier project.json.

• analyze-file : Analyse un fichier unique. Requiert le chemin d'accès au fichier .xaml.

  Argument	Description
  -p, --project-path	Pour analyser un fichier, indiquez le chemin d'accès à .xaml. Pour analyser l'ensemble du projet, indiquez le chemin d'accès au fichier project.json.
  -c, --config-path	Chemin d'accès au fichier RuleConfig.json. Spécifiez ce chemin uniquement si le fichier de configuration de règle ne se situe pas dans l'emplacement par défaut (%LocalAppData%\UiPath\Rules).

Lisez la page À propos de l'analyseur de workflow pour en savoir plus sur l'analyse des fichiers/projets et la configuration des règles à l'aide de paramètres de ligne de commande.

Commandes spécifiques de GIT

• git clone = Clonez un référentiel dans un nouveau répertoire.
  Remarque :

  Avant d’exécuter UiPath.Studio.CommandLine.exe git clone, assurez-vous que les informations d’identification du référentiel sont déjà stockées dans le gestionnaire des informations d’identification Windows. Dans le cas contraire, une erreur d’authentification se produit.

Les arguments suivants doivent être utilisés avec la commande git clone:

Argument	Description
r, --repository	L'adresse/URL du référentiel qui stocke les projets à modifier. Cet argument est obligatoire.
-d, --directory	Le répertoire de travail. S’il n’est pas spécifié, le répertoire d’environnement actuel est utilisé.

• git commit = Enregistre les modifications apportées au référentiel. Les arguments suivants doivent être utilisés avec la commande git commit:

  Argument	Description
  -m, --message	Écrivez un message de validation pour détailler les modifications apportées aux projets. Le message de validation est obligatoire.
  -p, --push	Téléchargez les modifications apportées au référentiel distant.
  -d, --directory	Le répertoire de travail. S’il n’est pas spécifié, le répertoire d’environnement actuel est utilisé.
  -f, --files	Chemins d'accès aux fichiers à modifier. Les chemins d'accès doivent être relatifs au répertoire de travail et séparés par des points-virgules.

Commandes spécifiques de SVN

• svn login = Utilisez les identifiants pour vous connecter à un certain répertoire SVN. Les arguments suivants doivent être utilisés avec la commande svn login :

  Argument	Description
  r, --repository	L'adresse/URL du référentiel qui stocke les projets à modifier. Cet argument est obligatoire.
  -p, --password	Mot de passe requis pour l'authentification au référentiel SVN.
  -s, --password-stdin	Lit le mot de passe d'authentification depuis STDIN (entrée standard). Vous êtes invité à entrer le mot de passe d'accès au référentiel souhaité.
  u, --user	Nom d'utilisateur nécessaire à l'authentification.

• svn checkout = Extrayez les projets d'un référentiel SVN. Les arguments suivants doivent être utilisés avec la commande svn checkout :

  Argument	Description
  -d, --directory	Dossier d'extraction de destination des fichiers. Cet argument est obligatoire.
  -r, --repository	Adresse du référentiel qui stocke les fichiers à archiver. Cet argument est obligatoire.

• svn edit = Déverrouillez un ou plusieurs projets et rendez-les accessibles pour l'édition. Les arguments suivants doivent être utilisés avec la commande svn edit :

  Argument	Description
  -f, --files	Chemins d'accès aux fichiers à modifier. Les chemins d'accès doivent être relatifs au répertoire de travail et séparés par des points-virgules. Cet argument est obligatoire.
  -d, --directory	Répertoire de travail qui contient les fichiers à modifier. Si un répertoire de travail n'est pas spécifié, le répertoire d'environnement actuel est utilisé.

• svn checkin = Archivez les modifications apportées aux projets d'automatisation. Les arguments suivants doivent être utilisés avec la commande svn checkin :

  Argument	Description
  -m, --message	Écrivez un message de validation pour détailler les modifications apportées aux projets. Le message de validation est obligatoire.
  -d, --directory	Le répertoire de travail dans lequel les projets sont archivés. Si un répertoire de travail n'est pas spécifié, le répertoire d'environnement actuel est utilisé.
  -f, --files	Chemins d'accès aux fichiers que vous avez modifiés. Les chemins d'accès doivent être relatifs au répertoire de travail et séparés par des points-virgules.

Commandes spécifiques de TFS

• tfs login = Utilisez les identifiants pour vous connecter à un certain répertoire TFS. Les arguments suivants doivent être utilisés avec la commande tfs login :

Argument	Description
-t, --type	La méthode de connexion au référentiel TFS : ntlm = authentification via le gestionnaire de réseau local NT sur un référentiel TFS local. token = authentification à l'aide d'un jeton d'accès personnel activé sur le référentiel TFS. basic = authentification de base sur un référentiel TFS sécurisé.
-p, --password	The password required for authentication to the TFS repository.
-s, --password-stdin	Lit le mot de passe d'authentification depuis STDIN (entrée standard). Vous êtes invité à entrer le mot de passe d'accès au référentiel souhaité.
u, --user	Nom d'utilisateur nécessaire à l'authentification.
-c, --collection	Se rapporte à l'URI de collection. Cet argument est obligatoire.

• tfs checkout = Extrait les projets d'un référentiel TFS. Les arguments suivants doivent être utilisés avec la commande tfs checkout :

  Argument	Description
  -c, --collection	Spécifiez l'URI de collection.
  -d, --directory	Dossier d'extraction de destination des fichiers. Cet argument est obligatoire.
  -r, --remotedir	Chemin d'accès au répertoire de projet, relatif à la racine de collection. Il commence par $/ et est précédé de l'URI de collection.

• tfs edit = Déverrouillez un ou plusieurs projets et rendez-les accessibles pour l'édition. Les arguments suivants doivent être utilisés avec la commande tfs edit :

  Argument	Description
  -f, --files	Chemins d'accès aux fichiers à modifier. Les chemins d'accès doivent être relatifs au répertoire de travail et séparés par des points-virgules.
  -d, --directory	Répertoire de travail qui contient les fichiers à modifier. Si un répertoire de travail n'est pas spécifié, le répertoire d'environnement actuel est utilisé.

• tfs checkin : archivez les modifications apportées aux projets d'automatisation. Les arguments suivants doivent être utilisés avec la commande tfs checkin :

  Argument	Description
  -m, --message	Écrivez un message de validation pour détailler les modifications apportées aux projets. Le message de validation est obligatoire.
  -d, --directory	Le répertoire de travail dans lequel les projets sont archivés. Si un répertoire de travail n'est pas spécifié, le répertoire d'environnement actuel est utilisé.
  -f, --files	Chemins d'accès aux fichiers que vous avez modifiés. Les chemins d'accès doivent être relatifs au répertoire de travail et séparés par des points-virgules.

Mise à jour des anciens projets d'automatisation

Lors de l'installation d'une dépendance à l'aide de l'interface utilisateur de ligne de commande dans des projets d'automatisation créés dans une version de Studio antérieure à v2018.3, prenez en compte les particularités suivantes :

• Si le projet n'a pas été publié et que, par conséquent, il n'a pas de dépendances installées, le processus de migration intervient et installe les packages par défaut détaillés sur la page Gestion des dépendances.
• Si le projet a été créé et publié avec la version de Studio antérieure à v2018.3, le paquet UiPath.Core.Activities est migré vers UiPath.System.Activities et vers UiPath.UIAutomation.Activities.