Exécuter une tâche dans Orchestrator

• Créez un processus dans Orchestrator.
• Exécutez le fichier CLI exe (pour Windows) ou dll (pour Linux).
• Ajoutez les étendues d'application d'accès à l'API Orchestrator requises.

1. Exécutez la tâche job à l'aide de uipcli job. Vous pouvez maintenant voir une liste des sous-tâches disponibles.
2. Spécifiez les paramètres requis et exécutez la sous-tâche run .
   Voir la liste des paramètres ci-dessous.

   Paramètre	Description
   -i ou --input_path (requis uniquement si le point d'entrée du workflow a des paramètres d'entrée)	Le chemin d'accès complet au fichier d'entrée JSON correspondant au processus que vous souhaitez exécuter. Exemple de format de fichier JSON : { "StringArgument_In": "MyConfigurationValue", "IntArgument_In": 1, "DictionaryArgument_In": { "Key1": "Value1", "Key2": "Value2" } }
   -P ou --priority	La priorité avec laquelle vous souhaitez exécuter la tâche :- Faible.- Normal (par défaut).- Élevé.
   -r ou --robots	Une liste de noms de robots spécifiques, séparés par des virgules.
   -j ou --jobscount	Le nombre de fois que vous souhaitez exécuter le processus. Le nombre d'exécutions par défaut du processus est de un.
   -U ou --user	Le nom de l’utilisateur. Il doit s’agir d’un utilisateur de machine, et non d’un utilisateur Orchestrator. Pour les utilisateurs locaux, le format doit être MachineName\UserName.
   -M ou --machine	Le nom de la machine sur laquelle vous souhaitez exécuter le processus.
   -R ou --result_path	Chemin d'accès complet à un fichier JSON ou à un dossier dans lequel vous souhaitez stocker les résultats de la tâche. Les résultats sont renvoyés sous forme de fichiers JSON.
   -W ou --timeout	Délai d’expiration des exécutions de tâches (secondes). La valeur par défaut est de 1 800 secondes.
   -f ou --fail_when_job_fails	La commande échoue lorsqu'une tâche échoue. La valeur par défaut est True.
   -w ou --wait	La commande attend que la tâche soit terminée. La valeur par défaut est True.
   -b ou --job_type (pour les dossiers modernes uniquement)	Type de runtime de la tâche. Vous pouvez choisir :- Unattended - NonProduction .
   -u ou --username (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 ou --password (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 ou --token (requis si vous utilisez l'authentification par jeton)	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 ou --accountName (requis si vous utilisez l'authentification par jeton)	Le nom du compte Orchestrator CloudRPA. Vous devez l'associer au jeton d'actualisation OAuth2 et à l' ID client.
   -A ou --accountForApp	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 l'application externe.
   -I ou --applicationId (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.
   -S ou --applicationSecret (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.
   --applicationScope (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
   -o ou --organizationUnit	Le nom du dossier Orchestrator (unité d'organisation). 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.
   -l, --language	La langue d'Orchestrator.
   -y, --disableTelemetry	Désactiver les données de télémétrie
   --traceLevel	Afficher la trace des événements.
   --identityUrl (requis uniquement pour les déploiements PaaS)	L'URL de votre serveur d'identité.
   --help	Affiche les paramètres et des exemples de cette commande.
   --version	Affiche les informations de version.
   Process Name (pos.0) (requis)	Le nom du processus que vous souhaitez exécuter.
   Orchestrator URL (pos.1) (requis)	Il s'agit de l'URL de votre Orchestrator.
   Orchestrator Tenant (pos.2) (Obligatoire) pour les déploiements SaaP. (Facultatif) pour les déploiements PaaS.	Le locataire de l'instance d'Orchestrator, où vous souhaitez exécuter des processus.

Utilisation :

 job run <process_name> <orchestrator_url> <orchestrator_tenant> [-i <input_path>] [-j <jobscount>] [-R <result_path>] [-P <priority>] [-r <robots>] [-f <do_not_fail_when_job_fails>] [-W <timeout>] [-w <do_not_wait>] [-u <orchestrator_user> -p <orchestrator_pass>] [-t <auth_token> -a <account_name>] [-A <account_for_app> -I <application_id> -S <application_secret> --applicationScope] [-o <folder_organization_unit>] [-l <language>]

Exemples :

• job run ProcessName "https://uipath-orchestrator.myorg.com" default -u admin -p 123456

• job run ProcessName "https://uipath-orchestrator.myorg.com" default -u admin -p 123456 -P Low

• job run ProcessName "https://uipath-orchestrator.myorg.com" default -u admin -p 123456 -P Normal -o MyFolder

• tâche run ProcessName "https://uipath-orchestrator.myorg.com" par défaut -u admin -p 123456 -P Élevé -o MonDossier

• job run ProcessName "https://uipath-orchestrator.myorg.com" default -t a7da29a2c93a717110a82 -a myAccount -f false -W 0

• tâche run ProcessName "https://uipath-orchestrator.myorg.com" par défaut -t a7da29a2c93a717110a82 -a monCompte -P Élevé -j 3 -w faux

• job run ProcessName "https://uipath-orchestrator.myorg.com" default -t a7da29a2c93a717110a82 -a myAccount -P Low -r robotName -R C:\Temp

• tâche run ProcessName "https://uipath-orchestrator.myorg.com" par défaut -t a7da29a2c93a717110a82 -a monCompte -r NomRobot -RC:\Temp\status.json

• job run ProcessName "https://uipath-orchestrator.myorg.com" default -A accountForExternalApp -I myExternalAppId -S myExternalAppSecret --applicationScope "OR.Folders.Read OR.Settings.Read" -r robotName -R C:\Temp\status.json

Ajout d'une application externe

Pour enregistrer une application externe afin qu'elle puisse accéder à vos ressources UiPath à l'aide d'OAuth :

1. Connectez-vous au locataire en tant qu'administrateur.
2. Accédez à Locataire (Tenant) > Gérer l'accès (Manage access ) > Attribuer des rôles (Attribuer des rôles) et cliquez sur Gérer les comptes et les groupes ( Manage Accounts & Groups).

   Le niveau du locataire s'ouvre.

3. Sur la gauche, sélectionnez Applications externes.

   La page Applications externes ( External Applications ) s'ouvre, répertoriant toutes les applications externes existantes enregistrées pour le locataire actuel :

   
   

   

   
   
4. Au-dessus du tableau, à droite, cliquez sur Ajouter une application (Add Application).
5. Remplissez le champ Nom de l'application (Application Name).
6. Sélectionnez une option pour Type d'application (Application Type).
   

   Si vous sélectionnez Application confidentielle (Confidential application), vous recevez une clé secrète d'application à la fin ; assurez-vous donc que votre application peut le stocker en toute sécurité. Si ce n'est pas le cas, sélectionnez Application non confidentielle (Non-confidential application).

7. Sous Ressources (Resources), cliquez sur Ajouter des étendues (Add Scopes).
   

   Le panneau Modifier la ressource (Edit Resource) s'ouvre sur la droite, où vous pouvez sélectionner les ressources auxquelles l'application doit avoir accès.

8. Dans la liste déroulante Ressource (Resource), sélectionnez l'API UiPath que l'application peut utiliser.
   Remarque : Vous ne pouvez ajouter une étendue que pour une seule ressource à la fois. Si vous souhaitez autoriser l'accès à plusieurs ressources, répétez ce processus pour ajouter une étendue pour chaque ressource.
9. Dans l'onglet Étendue(s) des utilisateurs (User Scope(s)), cochez les cases des autorisations d'API logiques que vous souhaitez accorder, selon vos besoins.

   L'octroi d'autorisations sous l'étendue de l'utilisateur signifie que l'application externe peut accéder à ces ressources dans un contexte utilisateur et qu'un utilisateur disposant des autorisations appropriées doit être connecté.

10. S'il s'agit d'une application confidentielle, vous pouvez basculer vers l'onglet Étendue(s) de l'application (Application Scope(s)) pour accorder également des autorisations au niveau de l'application pour la ressource sélectionnée, si nécessaire.

    Avec des autorisations sous l'étendue de l'application, l'application externe a accès aux données à l'échelle de l'application pour les étendues sélectionnées sans avoir besoin d'interaction de l'utilisateur.

    Les applications non confidentielles ne peuvent pas accéder à l'étendue de l'application.

11. Cliquez sur Enregistrer (Save).

    Le panneau se ferme et la ressource et les étendues sélectionnées sont ajoutées au tableau Ressources (Resources) du formulaire.

12. Si l'application externe le permet, vous pouvez ajouter une URL dans le champ Rediriger l’URL (Redirect URL) ; la réponse d'autorisation y sera envoyée. L'application peut ensuite l'utiliser pour accéder aux ressources UiPath.
13. Cliquez sur Ajouter (Add) pour créer l'enregistrement.

    Un message de confirmation s'ouvre. Pour les applications confidentielles, le message de confirmation inclut la clé secrète de l'application que l'application externe enregistrée peut utiliser pour demander une autorisation. Assurez-vous de l'enregistrer dans un emplacement sécurisé, car vous ne pourrez plus la consulter.