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

L'interface utilisateur de ligne de commande de mise à jour en masse des dépendances du projet (Project Dependencies Mass Update) peut être utilisée pour mettre à jour en masse les fichiers project.json appartenant à plusieurs projets d'automatisation. Il permet d'ajouter ou de supprimer des dépendances, de modifier les versions de packages 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. Par défaut, le chemin pour la version de Windows Installer (.msi) de Studio est C:\Program Files (x86)\UiPath\Studio\.

Le chemin par défaut de Studio installé à l'aide du programme d'installation de Community Edition (.exe) est le suivant : %LocalAppData%\UiPath\[Studio_version]\.

Certaines commandes peuvent ne pas être disponibles selon les systèmes de contrôle de code source auxquels Studio est connecté (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'Outil Mise à jour groupée des dépendances du projet (Project Dependencies Mass Update Tool) 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 la version applicable la plus ancienne et strict pour la version stricte . Si aucun de ces deux paramètres n'est mentionné, la 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.
  -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.
  -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.

  Remarque : actuellement, les extensions de certificat .pfx et .p12 sont acceptées pour la signature des projets. Pour plus d'informations, consultez la page Signature des paquets.

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.

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

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	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.
  -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 les dépendances n'ont donc pas été installées à l'intérieur, le processus de migration applique un pas-à-pas détaillé et installe les paquets par défaut, comme indiqué à 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.