Analyser un projet

Prérequis

• Créer un projet
• 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 analyser un projet, 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 analyze . Le tableau suivant décrit les paramètres requis.

Remarque :

La validation du projet s’exécute dans le cadre de la tâche analyze et ne peut pas être ignorée. Les messages de validation apparaissent avec les messages de l'analyseur de workflow dans la sortie de l'analyseur.

Légende: (*) : facultative, recommandée lors de l’utilisation de flux de package supplémentaires.

Paramètre	Description
Project(s) Path (pos. 0) ( Requis )	Le chemin d'accès au fichier project.json ou le chemin d'accès au dossier qui contient plusieurs fichiers project.json .
--analyzerTraceLevel	Choisissez les types de messages à générer après l'analyse : Off = don't show any message Erreur -Avertissement - Info - Détaillé .
-stopOnRuleViolation	La tâche échoue lorsqu'une règle n'est pas respectée.
--treatWarningsAsErrors	Traitez les avertissements comme des erreurs.
--resultPath	Chemin d'accès complet à un fichier JSON dans lequel vous souhaitez stocker les résultats. Si vous n'ajoutez pas this comme argument, les résultats ne s'imprimeront que dans la console standard.
--governanceFilePath	Ignorez les politiques de gouvernance contenant les règles de l’analyseur de workflow. Les politiques peuvent être téléchargées à partir de , ou extraites du fichier zip compressé exporté depuis Studio . Remarque : La tâche échoue si vous spécifiez d'utiliser une stratégie, mais que le fichier de stratégie ne se trouve pas dans le chemin mentionné.
--ignoredRules	Une liste de règles que vous souhaitez ignorer lors de l'analyse, séparées par des virgules.
-u , --orchestratorUsername (*) (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.
-p , --orchestratorPassword (*) (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.
-t , -orchestratorAuthToken (*) (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 .
-a , --orchestratorAccountName (*) (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 .
-A , --orchestratorAccountForApp (*)	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.
-I , --orchestratorApplicationId (*) ( Requis si vous utilisez l'authentification d'application externe )	ID d’application externe Vous devez l'associer au compte d'application, au secret d'application et à l'étendue de l'application.
-S , --orchestratorApplicationSecret (*) ( 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.
--orchestratorApplicationScope (*) ( Facultatif pour l'authentification d'application externe )	La liste des étendues d'application, séparées par des espaces simples. Facultatif lors de l'utilisation de l'authentification d'application externe, les étendues par défaut sont automatiquement appliquées. 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
--orchestratorFolder (*)	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.
--orchestratorUrl (*)	Il s'agit de l'URL de votre Orchestrator.
--orchestratorTenant (*)	Locataire de l’instance d’Orchestrator.
-l , --language	La langue d'Orchestrator.
--traceLevel	Afficher la trace des événements.
--identityUrl	L'URL de votre Identity Server. Requis lorsque 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.
--nugetConfigFilePath	Path to the NuGet.Config file used during restore. From 25.10.18 onwards the file is honored end-to-end — <clear />, <packageSourceCredentials>, <packageSourceMapping>, and <fallbackPackageFolders> all take effect. See Managing NuGet feeds for details. On older builds, only <packageSources> URLs were applied.
--disableBuiltInNugetFeeds	Désactivez 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.
--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 : Étendues d'application par défaut

Lorsque vous utilisez l'authentification d'application externe sans spécifier le paramètre --orchestratorApplicationScope , 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 analyze <project_path> [--analyzerTraceLevel <analyzer_trace_level>] [--stopOnRuleViolation] [--treatWarningsAsErrors] [--resultPath <result_path>] [--governanceFilePath <governance_file_path>] [--ignoredRules <rule_id_1,rule_id_2>] [--orchestratorUrl <orchestrator_url> --orchestratorTenant <orchestrator_tenant>] [-u <orchestrator_user> -p <orchestrator_pass>] [-t <auth_token> -a <account_name>] [-A <organization_name> -I <application_id> -S <application_secret> --orchestratorApplicationScope <application_scope>] [--orchestratorFolder <folder_name>] [-l <language>] [--traceLevel <None|Critical|Error|Warning|Information|Verbose>] [--identityUrl <identityUrl>] [--disableBuiltInNugetFeeds] [--excludeConfiguredSources]

Exemples de commande minimum

• uipcli package analyze "C:\userprofile\AutomationProject\project.json" --traceLevel Information --resultPath "C:\userprofile\result.json"
• uipcli package analyze "C:\userprofile\AutomationProject\project.json" --traceLevel Information --resultPath "C:\userprofile\result.json" --orchestratorUrl "https://orch-23-10-paas.cloudapp.azure.com/" --orchestratorTenant "TenantName" -u "orchestratorUsername" -p "********" --orchestratorFolder "FolderName"
• uipcli package analyze "C:\userprofile\AutomationProject\project.json" --traceLevel Information --resultPath "C:\userprofile\result.json" --orchestratorUrl "https://orch-23-10-paas.cloudapp.azure.com/" --orchestratorTenant "TenantName" -A "organizationName" -I "76000552-3e4f-4590-9317-cdb420001f1d" -S '********' --orchestratorApplicationScope "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" --orchestratorFolder "FolderName" --identityUrl "https://orch-23-10-paas.cloudapp.azure.com/identity"
• uipcli package analyze "C:\userprofile\AutomationProject\project.json" --traceLevel Information --resultPath "C:\userprofile\result.json" --orchestratorUrl "https://automation-suite.base.url.com/" --orchestratorTenant "TenantName" -A "organizationName" -I "3f6239b9-e0e8-465e-a429-d9ffd1d9e57a" -S '********' --orchestratorApplicationScope "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" --orchestratorFolder "FolderName"
• uipcli package analyze "C:\userprofile\AutomationProject\project.json" --traceLevel Information --resultPath "C:\userprofile\result.json" --orchestratorUrl "https://cloud.uipath.com/" --orchestratorTenant "TenantName" -A "organizationName" -I "becc663c-8f1e-409a-a75f-c00330d80bc8" -S '********' --orchestratorApplicationScope "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" --orchestratorFolder "FolderName"