Restauration des dépendances de l'automatisation

Prérequis

• Créez une application externe.
• Exécutez le fichier CLI exe (pour l'héritage Windows) ou dll (pour Windows/Linux/macOS).
• Ajoutez les étendues d'application d'accès à l'API Orchestrator requises.

Pour restaurer les dépendances, procédez comme suit :

1. Exécutez la tâche package à l'aide de uipcli package. Vous pouvez remarquer une liste des sous-tâches disponibles.

2. Spécifiez les paramètres requis et exécutez la sous-tâche restore .

   Le tableau suivant décrit les paramètres requis :

   Paramètre	Description
   Project(s) Path (pos. 0)	Requis. Le chemin d'accès à un fichier project.json , ou à un dossier qui contient des fichiers project.json .
   --restoreFolder	Requis. Restaurez le chemin du dossier de destination.
   --nugetConfigFilePath	Facultatif. Chemin d'accès au fichier NuGet.Config contenant les flux. La balise <clear /> du fichier spécifié sera ignorée et seules les sources seront prises en compte.
   --disableBuiltInNugetFeeds	Désactive les flux NuGet intégrés.
   --excludeConfiguredSources	Facultatif. Exclut les flux intégrés et les sources NuGet configurées au niveau de l'utilisateur et de la machine sur l'hôte exécutant la CLI. La CLI résout les packages uniquement à partir des flux définis dans --nugetConfigFilePath. Voir Gestion des flux NuGet.
   -u, --libraryOrchestratorUsername	Facultatif, utile uniquement lorsque vous avez des dépendances provenant d’une bibliothèque dans Orchestrator. Le nom d'utilisateur Orchestrator utilisé pour l'authentification. Doit être utilisé avec le mot de passe.
   -p, --libraryOrchestratorPassword	Facultatif, utile uniquement lorsque vous avez des dépendances provenant d’une bibliothèque dans Orchestrator. Le mot de passe Orchestrator utilisé pour l'authentification. Doit être utilisé avec le nom d’utilisateur.
   -t, --libraryOrchestratorAuthToken	Facultatif, utile uniquement lorsque vous avez des dépendances provenant d’une bibliothèque dans Orchestrator. Le jeton d'actualisation Orchestrator utilisé pour l'authentification. Doit être utilisé avec le nom de l’organisation et l’ID client.
   -a, --libraryOrchestratorAccountName	Facultatif, utile uniquement lorsque vous avez des dépendances provenant d’une bibliothèque dans Orchestrator. Le nom de l'organisation Orchestrator. Doit être utilisé avec le jeton d’actualisation et l’ID client.
   -A, --libraryOrchestratorAccountForApp	Facultatif, utile uniquement lorsque vous avez des dépendances provenant d’une bibliothèque dans Orchestrator. Le nom de l'organisation Orchestrator. Doit être utilisé avec l’ID, la clé secrète et l’étendue pour l’application externe.
   -I, --libraryOrchestratorApplicationId	Facultatif, utile uniquement lorsque vous avez des dépendances provenant d’une bibliothèque dans Orchestrator. ID de l’application externe. Doit être utilisé avec le nom de l’organisation, la clé secrète et l’étendue ou les étendues pour l’application externe.
   -S, --libraryOrchestratorApplicationSecret	Facultatif, utile uniquement lorsque vous avez des dépendances provenant d’une bibliothèque dans Orchestrator. La clé secrète de l'application externe. Doit être utilisé avec le nom de l’organisation, l’ID et les étendues pour l’application externe.
   --libraryOrchestratorApplicationScope	Facultatif, utile uniquement lorsque vous avez des dépendances provenant d’une bibliothèque dans Orchestrator. La liste des étendues d'application séparées par des espaces. Doit être utilisé avec le nom, l’ID et le secret de l’organisation pour l’application externe.
   --libraryOrchestratorUrl	Facultatif, utile uniquement lorsque vous avez des dépendances provenant d’une bibliothèque dans Orchestrator. URL d’Orchestrator.
   --libraryOrchestratorTenant	Facultatif, utile uniquement lorsque vous avez des dépendances provenant d’une bibliothèque dans Orchestrator. Le locataire d'Orchestrator.
   --libraryIdentityUrl	L'URL de votre Identity Server. Requis lorsque la bibliothèque Orchestrator s'exécute sur UiPath Automation Suite ou sur la version autonome d'Orchestrator (MSI local). Non nécessaire pour Automation Cloud — la CLI résout le serveur d'identité à partir de l'URL du cloud.
   --traceLevel	Spécifie les types de messages de journal devant générer l'une des valeurs suivantes : Aucun, Critique, Erreur, Avertissement, Information, Détaillé. Valeur par défaut : Informations.
   -l, --language	Langue des journaux traduits.
   --ca-cert	Un ou plusieurs fichiers de certificat CA racine approuvés (PEM, DER ou PKCS#7) utilisés lors de la validation des certificats TLS Orchestrator et Identity Server. Répétez l'indicateur ou séparez plusieurs chemins par des virgules. Voir Approbation de certificats personnalisés pour plus de détails.
   --pinnedpubkey	Épingler la clé publique du certificat de feuille de serveur. Format: sha256//<base64>. Vérifié en plus de la validation standard du certificat. Voir Approbation de certificats personnalisés pour plus de détails.

Remarque :

Lorsque vous utilisez l'authentification d'application externe sans spécifier le paramètre --libraryOrchestratorApplicationScope , la CLI applique automatiquement les étendues Orchestrator suivantes par défaut :

OR.Assets OR.BackgroundTasks OR.Execution OR.Folders OR.Robots.Read OR.Machines.Read OR.Jobs OR.TestSets OR.TestSetExecutions OR.Monitoring OR.Settings.Read

Astuce :

Pour les instances Orchestrator signées par une autorité de certification privée (telle qu'UiPath Automation Suite), cette commande accepte également les paramètres --ca-cert et --pinnedpubkey . Voir Approbation de certificats personnalisés pour des scénarios et des exemples.

Utilisation

uipcli package restore <project_path> --restoreFolder <restore_directory> --nugetConfigFilePath <nuget_config_path> [--libraryOrchestratorUrl <orchestrator_url> --libraryOrchestratorTenant <orchestrator_tenant>] [--u <orchestrator_user> --p <orchestrator_pass>] [--t <auth_token> --a <account_name>] [-A <organization_name> -I <application_id> -S <application_secret> --libraryOrchestratorApplicationScope <application_scope>] [--libraryIdentityUrl <identity_url>] [--libraryOrchestratorFolder <folder_name>] [-l <language>] [--disableBuiltInNugetFeeds] [--excludeConfiguredSources] [--traceLevel <None|Critical|Error|Warning|Information|Verbose>]

Exemples de commande minimum

• uipcli package restore "C:\userprofile\AutomationProject" --traceLevel Information --restoreFolder ""C:\userprofile\DependencyPackages" --nugetConfigFilePath "C:\userprofile\Package\NuGet.Config"
• uipcli package restore "C:\userprofile\AutomationProject" --traceLevel Information --restoreFolder "C:\userprofile\DependencyPackages" --libraryOrchestratorUrl "https://orch-23-10-paas.cloudapp.azure.com/" --libraryOrchestratorTenant "TenantName" -u "orchestratorUsername" -p "********" --orchestratorFolder "FolderName"
• uipcli package restore "C:\userprofile\AutomationProject" --traceLevel Information --restoreFolder "C:\userprofile\DependencyPackages" --libraryOrchestratorUrl "https://orch-23-10-paas.cloudapp.azure.com/" --libraryOrchestratorTenant "TenantName" -A "organizationName" -I "76000552-3e4f-4590-9317-cdb420001f1d" -S '********' --libraryOrchestratorApplicationScope "OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR.TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring" --libraryOrchestratorFolder "FolderName" --libraryIdentityUrl "https://orch-23-10-paas.cloudapp.azure.com/identity"
• uipcli package restore "C:\userprofile\AutomationProject" --traceLevel Information --restoreFolder "C:\userprofile\DependencyPackages" --libraryOrchestratorUrl "https://automation-suite.base.url.com/" --libraryOrchestratorTenant "TenantName" -A "organizationName" -I "3f6239b9-e0e8-465e-a429-d9ffd1d9e57a" -S '********' --libraryOrchestratorApplicationScope "OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR.TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring" --libraryOrchestratorFolder "FolderName"
• uipcli package restore "C:\userprofile\AutomationProject" --traceLevel Information --restoreFolder "C:\userprofile\DependencyPackages" --libraryOrchestratorUrl "https://cloud.uipath.com/" --libraryOrchestratorTenant "TenantName" -A "organizationName" -I "becc663c-8f1e-409a-a75f-c00330d80bc8" -S '********' --libraryOrchestratorApplicationScope "OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR.TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring" --libraryOrchestratorFolder "FolderName"

Restauration Hermétique — résolvez les dépendances uniquement à partir du fichier nuget.config explicite

• uipcli package restore "C:\userprofile\AutomationProject" --traceLevel Information --restoreFolder "C:\userprofile\DependencyPackages" --nugetConfigFilePath "C:\ci\nuget.config" --excludeConfiguredSources