Compression de projets dans un package

Prérequis

• Créer des projets
• 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.

Remarque :

Vous pouvez également créer le package localement sans avoir besoin d'étendues Orchestrator.

Pour compresser un projet dans un package, 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 pack . Le tableau suivant décrit les paramètres requis.

Remarque :

La validation du projet et l’analyseur de workflow s’exécutent tous deux par défaut dans le cadre de la tâche pack . Pour vous désinscrire, utilisez les indicateurs --skipValidate et --skipAnalyze .

Légende: (*) : Facultatif, utile uniquement lorsque vous avez des dépendances d'une bibliothèque dans Orchestrator.

Paramètre	Description
Project(s) Path (pos. 0) (Requis)	Chemin d'accès à un fichier project.json ou à un dossier contenant project.json fichiers.
-o, ou --output (Requis)	Chemin de dossier de destination.
-v, or --version	Définissez la version du package.
--autoVersion	Générer automatiquement la version du package
--outputType	Définissez la sortie sur un type spécifique.
--splitOutput	Permet de diviser la sortie en bibliothèques de runtime et de conception.
--repositoryUrl	L'URL du référentiel où le projet est versionné.
--repositoryCommit	La validation du référentiel à partir duquel le projet a été créé.
--repositoryBranch	La branche du référentiel à partir de laquelle le projet a été créé.
--repositoryType	Type de référentiel système VCS.
--projectUrl	URL de l'idée Automation Hub.
--releaseNotes	Ajouter des notes de publication.
--author	Auteur du paquet.
--nugetConfigFilePath	Chemin d'accès au fichier NuGet.Config utilisé lors de la restauration. À partir de la version 25.10.18, le fichier est respecté de bout en bout - <clear />, <packageSourceCredentials>, <packageSourceMapping> et <fallbackPackageFolders> tous prennent effet. Voir Gestion des flux NuGet. Sur les anciennes versions, seules les URL <packageSources> étaient appliquées.
--disableBuiltInNugetFeeds	Désactive les flux NuGet intégrés.
--excludeConfiguredSources	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 (*) (Requis si vous utilisez l'authentification de base, via un nom d'utilisateur et un mot de passe)	Le nom d'utilisateur utilisé pour l'authentification auprès d'Orchestrator. Vous devez l’associer au mot de passe correspondant. Ceci est requis si votre package fait référence aux bibliothèques du flux Orchestrator
-p, --libraryOrchestratorPassword (*) (Requis si vous utilisez l'authentification de base, via un nom d'utilisateur et un mot de passe)	Le mot de passe utilisé pour l'authentification auprès d'Orchestrator. Vous devez l'associer au nom d'utilisateur correspondant. Ceci est requis si votre package fait référence aux bibliothèques du flux Orchestrator
-t, --libraryOrchestratorAuthToken (*) (Requis si vous utilisez l'authentification basée sur jeton)	Le jeton d’actualisation OAuth2 utilisé pour l’authentification auprès d’Orchestrator. Vous devez l'associer au Nom du compte et à l' ID client. Ceci est requis si votre package fait référence aux bibliothèques du flux Orchestrator
-a, --libraryOrchestratorAccountName (*) (Requis si vous utilisez l'authentification basée sur jeton)	Le nom du compte Orchestrator CloudRPA. Vous devez l'associer au jeton d'actualisation OAuth2 et à l' ID client. Ceci est requis si votre package fait référence aux bibliothèques du flux Orchestrator
-A, --libraryOrchestratorAccountForApp (*)	Le nom du compte Orchestrator CloudRPA (nom de l’organisation). Vous devez l'associer à l ' ID d'application,à la clé secrète de l'application et à l' étendue de l'application pour une application externe Cela est requis si votre package fait référence aux bibliothèques du flux Orchestrator.
-I ,--libraryOrchestratorApplicationId (*) (Requis si vous utilisez l'authentification d'application externe)	ID d’application externe Vous devez l'associer au compte d'application, à l'ID d' application et à l'étendue de l'application. Ceci est requis si votre package fait référence aux bibliothèques du flux Orchestrator.
-S, --libraryOrchestratorApplicationSecret (*) (Requis si vous utilisez l'authentification d'application externe)	La clé secrète de l'application externe. Vous devez l'associer au compte d' application, à l'ID d'application ) et à l'étendue de l'application. Ceci est requis si votre package fait référence aux bibliothèques du flux Orchestrator.
--libraryOrchestratorApplicationScope (*) (Requis si vous utilisez l'authentification d'application externe)	La liste des étendues d'application, séparées par des espaces simples. Vous devez l’associer à l ’ID d’application, à la clé secrète de l’ application et à l’étendue de l’application pour l’application externe Ceci est requis si votre package fait référence aux bibliothèques du flux Orchestrator.
--libraryOrchestratorFolder (*)	Le nom du dossier Orchestrator cible. 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.
--libraryOrchestratorUrl (*)	Il s'agit de l'URL de votre Orchestrator.
--libraryOrchestratorTenant (*)	Locataire de l’instance 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	Afficher la trace des événements.
-l, or --language	La langue utilisée dans l'interface utilisateur d'Orchestrator.
--activitiesRootCategory	Le préfixe de catégorie racine appliqué à chaque activité exposée par la bibliothèque publiée. Effectue uniquement lors de la compression d’un projet de bibliothèque; ignoré pour les projets de processus, de test et d'objets. Lorsqu'il est omis, la valeur par défaut est le nom du projet de bibliothèque.
--skipAnalyze	Ignorez l’exécution de l’analyseur de workflow pendant l’étape de compression. Utilisez uniquement lorsque vous exécutez package analyze comme étape de pipeline distincte; les pipelines de version doivent laisser l'analyseur activé.
--skipValidate	Ignorez l'étape de validation du projet pendant l'étape de compression. Utilisez uniquement lorsque le projet a déjà été validé précédemment dans le pipeline.
--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.

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.

Remarque :

Lorsque vous utilisez l'authentification d'application externe sans spécifier le paramètre --applicationScope , 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

Utilisation

uipcli package pack <project_path> -o <destination_folder> [-v <version>] [--autoVersion] [--outputType <Process|Library|Tests|Objects>] [--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>] [--splitOutput] [--skipAnalyze] [--skipValidate] [--activitiesRootCategory <root_category>] [--repositoryUrl <repository_url>] [--repositoryCommit <repository_commit>] [--repositoryBranch <repository_branch>] [--repositoryType <repository_type>] [--projectUrl <automation_hub_idea_url>] [--releaseNotes <release_notes>] [--disableBuiltInNugetFeeds] [--excludeConfiguredSources]  [--traceLevel <None|Critical|Error|Warning|Information|Verbose>]

Exemples

• uipcli package pack "C:\userprofile\AutomationProject\project.json" --traceLevel Information -o "C:\userprofile\Packages\Output"
• uipcli package pack "C:\userprofile\AutomationProject\project.json" --traceLevel Information -o "C:\userprofile\Packages\Output" --libraryOrchestratorUrl "https://orch-23-10-paas.cloudapp.azure.com/" --libraryOrchestratorTenant "TenantName" -u "orchestratorUsername" -p "********" --orchestratorFolder "FolderName" --author ExampleAuthor
• uipcli package pack "C:\userprofile\AutomationProject\project.json" --traceLevel Information -o "C:\userprofile\Packages\Output" --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 pack "C:\userprofile\AutomationProject\project.json" --traceLevel Information -o "C:\userprofile\Packages\Output" --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 pack "C:\userprofile\AutomationProject\project.json" --traceLevel Information -o "C:\userprofile\Packages\Output" --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"

Pack de bibliothèque avec une catégorie racine d'activités personnalisées

• uipcli package pack "C:\userprofile\MyLibrary\project.json" --traceLevel Information -o "C:\userprofile\Packages\Output" --outputType Library --activitiesRootCategory "MyCompany.Finance.Invoicing"

Créer le package avec l’analyseur et la validation ignorés (Builds locaux plus rapides, étapes d’analyse distinctes du CI)

• uipcli package pack "C:\userprofile\AutomationProject\project.json" --traceLevel Information -o "C:\userprofile\Packages\Output" --skipAnalyze --skipValidate

Paquet rempli sur la machine: ignorer les sources NuGet utilisateur/machine sur l'agent de développement

• uipcli package pack "C:\userprofile\AutomationProject\project.json" --traceLevel Information -o "C:\userprofile\Packages\Output" --nugetConfigFilePath "C:\ci\nuget.config" --excludeConfiguredSources