automation-ops
latest
false
Important :
Veuillez noter que ce contenu a été localisé en partie à l’aide de la traduction automatique. La localisation du contenu nouvellement publié peut prendre 1 à 2 semaines avant d’être disponible.
UiPath logo, featuring letters U and I in white

Guide de l'utilisateur Automation Ops

Automation CloudAutomation Cloud Public SectorAutomation Suite
Dernière mise à jour 20 déc. 2024

Exécution de tâches

L'exécution de tâches dans l'interface de ligne de commande UiPath conçue pour les appareils Windows (UiPath.CLI.Windows) nécessite plusieurs tâches.

Les principales différences entre les procédures de UiPath.CLI.Windows et les procédures de UiPath.CLI (interface de ligne de commande UiPath conçue pour les périphériques Linux) consistent en des arguments supplémentaires que vous pouvez transmettre avec certaines tâches spécifiques au type de périphérique que vous utilisez. en cours d'exécution.

Important :
Lorsque vous utilisez la CLI UiPath, veillez à ce que le projet soit fermé dans Studio. Dans le cas contraire, cela provoquera un conflit qui déclenchera le message d’erreur suivant dans la CLI : The action could not be performed because the project is already opened in another Studio instance. Please close it and try again.

Étendues d'application d'accès à l'API

Le tableau suivant répertorie les étendues d'application d'accès à l'API Orchestrator requises pour l'exécution de toute tâche CLI.

Étendue de l'application SAP

Description

OU.Assets

Accès en lecture et en écriture aux ressources dans Orchestrator.

OU.TâchesArrière-plan

BackgroundTasks accès en lecture et en écriture dans Orchestrator.

OU.Exécution

Accès en lecture et en écriture à l'exécution dans Orchestrator.

OU.Dossiers

Accès en lecture et en écriture à l'exécution dans Orchestrator.

OU.Job

Accès en lecture et en écriture à l'exécution dans Orchestrator.

OU.Machines.Lecture

Les utilisateurs accèdent en lecture dans Orchestrator.

OU.Monitoring

Accès en lecture et en écriture à l'exécution dans Orchestrator.

OU.Robots.Read

Accès en lecture aux Robots dans Orchestrator.

OR.Settings.Read

Les utilisateurs accèdent en lecture dans Orchestrator.

OR.TestSets

Accès en lecture et en écriture à l'exécution dans Orchestrator.

OR.TestSetExecutions

Accès en lecture et en écriture à l'exécution dans Orchestrator.

OU.TestSetSchedules

TestSetSchedules accès en lecture et en écriture dans Orchestrator.

OU.Users.Read

Les utilisateurs accèdent en lecture dans Orchestrator.

Outre les étendues répertoriées dans la table, une étendue importante à mettre en évidence est OR.Default. L'étendue OR.Default sert de caractère générique. Il offre un accès affiné et spécifique au rôle au niveau de l'organisation et du dossier. Cela vous donne la possibilité d'avoir un contrôle précis sur les autorisations des applications, au-delà des étendues prédéfinies à l'échelle de l'organisation. Pour plus de détails, consultez la section Déclaration des étendues ( Declaring scopes).

Ajouter une application externe

Pour enregistrer une application externe afin qu'elle puisse utiliser OAuth pour accéder à vos ressources UiPath :

  1. Accédez à Admin et sélectionnez l'organisation en haut du panneau de gauche.
  2. Sélectionnez Applications externes (External Applications).
  3. Cliquez sur Ajouter une application en haut à droite.
  4. Remplissez le champ Nom de l' application (Application Name )
  5. 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).

  6. 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.

  7. 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.
  8. 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é.

  9. 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.

  10. 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.

  11. Si l'application externe a été enregistrée avec des étendues d'utilisateurs, vous devez ajouter une URL de redirection où l'application externe doit recevoir la réponse d'autorisation.

    Si seules les étendues d'application sont sélectionnées, fournir une URL de redirection est facultatif.

  12. 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.

Running UiPath.CLI.Windows

Prérequis: pour utiliser l'interface de ligne de commande UiPath pour Windows et exécuter des tâches, installez .NET 6.0.7, qui doit inclure .NET 6.0.7 Desktop Runtime, fourni avec le SDK 6.0.302.

Vous pouvez exécuter des tâches en appelant uipcli.exe , y compris les paramètres correspondants. Pour exécuter des sous-tâches, la commande doit avoir le format suivant : uipcli.exe <task name> <sub-task name> . Pour exécuter l'interface de ligne de commande :
  1. Ouvrez une invite de commande et accédez au dossier extrait du fichier NUPKG.
  2. Tapez uipcli.exe et sélectionnez la touche Entrée .

Exécution de UiPath.CLI

Prérequis: pour utiliser l'interface de ligne de commande UiPath pour plusieurs plates-formes et exécuter des tâches, installez .NET 6.0.7, fourni avec le SDK 6.0.302.

Vous pouvez exécuter des tâches en appelant uipcli.exe , y compris les paramètres correspondants. Pour exécuter des sous-tâches, la commande doit avoir le format suivant : dotnet uipcli.dll <task name> <sub-task name> . Pour exécuter l'interface de ligne de commande :
  1. Ouvrez une invite de commande et accédez au dossier extrait du fichier NUPKG.
  2. Tapez dotnet uipcli.dll et sélectionnez la touche Entrée (Enter).

Affichage de la version CLI

Exécutez la commande uipcli --version.

Deleting assets from Orchestrator

Prérequis :

  • Créez des ressources dans Orchestrator.
  • Créez un fichier CSV contenant les ressources que vous souhaitez supprimer. Le fichier CSV doit comporter les trois colonnes suivantes : name , type et value . Les cellules de données sous les colonnes type et value peuvent rester vides.
  • Exécutez le fichier CLI exe (pour Windows) ou dll (pour Linux).
  • Ajoutez les étendues d'application d'accès à l'API Orchestrator requises.

Pour plus d'informations sur le fichier CSV, consultez les exemples dans le tableau ci-dessous :

name

Type

valeur

asset1_name

N/AN/A

asset2_name

Bool

true

asset3_name

Integer

N/A

asset4_name

InformationsIdentification

username:password

Pour supprimer des ressources d'Orchestrator, procédez comme suit :

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

    Voir la liste des paramètres ci-dessous.

    Paramètre

    Description

    -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 une 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 ou --language

    La langue utilisée dans l'interface utilisateur d'Orchestrator.

    -y ou --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.

    Assets File (pos. 0) (requis) Le nom du fichier CSV qui contient les ressources que vous souhaitez supprimer.
    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.
    Locataire de l'instance d'Orchestrator dans laquelle vous souhaitez gérer vos ressources.

Utilisation :

uipcli asset delete <assets_file> <orchestrator_url> <orchestrator_tenant> [-u <orchestrator_user> -p <orchestrator_pass>] [-t <auth_token> -a <account_name>] [-A <organization_name> -I <application_id> -S <application_secret> --applicationScope <application_scope>] [-o <folder_name>] [-l <language>] [--traceLevel <None|Critical|Error|Warning|Information|Verbose>] [--identityUrl <identity_url>] uipcli asset delete <assets_file> <orchestrator_url> <orchestrator_tenant> [-u <orchestrator_user> -p <orchestrator_pass>] [-t <auth_token> -a <account_name>] [-A <organization_name> -I <application_id> -S <application_secret> --applicationScope <application_scope>] [-o <folder_name>] [-l <language>] [--traceLevel <None|Critical|Error|Warning|Information|Verbose>] [--identityUrl <identity_url>]

Exemples de commandes minimales:

  • uipcli asset delete "C:\userprofile\assets.csv" « https://orch-23-10-paas.cloudapp.azure.com/ » "TenantName" -u "orchestratorUsername" -p "********" -o "FolderName" --traceLevel "Information"
  • uipcli asset delete "C:\userprofile\assets.csv" « https://orch-23-10-paas.cloudapp.azure.com/ » TenantName -I "76000552-3e4f-4590-9317-cdb420001f1d" -S "********" --applicationScope "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" --identityUrl "https://orch-23-10-paas.cloudapp.azure.com/ identité » -o "NomDossier" --traceLevel "Information"
  • uipcli asset delete "C:\userprofile\assets.csv" « https://automation-suite.base.url.com/ » TenantName -A "organizationName" -I "3f6239b9-e0e8-465e-a429-d9fd1d9e57a" -S "********" --applicationScope "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" -o "FolderName" --traceLevel "Information"
  • uipcli asset delete "C:\userprofile\assets.csv" « https://cloud.uipath.com/ » TenantName -A "organizationName" -I "becc663c-8f1e-409a-a75f-c00330d80bc8" -S "********" --applicationScope "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" -o "FolderName" --traceLevel "Information"

Deploying assets to Orchestrator

Prérequis :

  • Créez un fichier CSV qui contient les ressources que vous souhaitez déployer sur Orchestrator.
    Le fichier CSV doit comporter les trois colonnes suivantes : name , type , value et description .
  • Exécutez le fichier CLI exe (pour Windows) ou dll (pour Linux).
  • Ajoutez les étendues d'application d'accès à l'API Orchestrator requises.

Pour plus d'informations sur le fichier CSV, consultez l'exemple ci-dessous.

name

Type

valeur

Description

asset_1_name

text

"J'ai un commentaire"

asset_1_description

asset_2_name

Integer

1

asset_2_description

asset_3_name

Bool

false

asset_3_description

asset_4_name

InformationsIdentification

username:password

asset_4_description

Pour déployer des ressources sur Orchestrator, procédez comme suit :

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

    Voir la liste des paramètres ci-dessous.

    Paramètre

    Description

    -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 une 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 ou --language

    La langue utilisée dans l'interface utilisateur d'Orchestrator.

    --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.

    Assets File (pos. 0) (requis) Le nom du fichier CSV qui contient les ressources que vous souhaitez supprimer.
    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 :

uipcli asset deploy <assets_file> <orchestrator_url> <orchestrator_tenant> [-u <orchestrator_user> -p <orchestrator_pass>] [-t <auth_token> -a <account_name>] [-A <organization_name> -I <application_id> -S <application_secret> --applicationScope <application_scope>] [-o <folder_name>] [-l <language>] [--traceLevel <None|Critical|Error|Warning|Information|Verbose>] [--identityUrl <identity_url>]uipcli asset deploy <assets_file> <orchestrator_url> <orchestrator_tenant> [-u <orchestrator_user> -p <orchestrator_pass>] [-t <auth_token> -a <account_name>] [-A <organization_name> -I <application_id> -S <application_secret> --applicationScope <application_scope>] [-o <folder_name>] [-l <language>] [--traceLevel <None|Critical|Error|Warning|Information|Verbose>] [--identityUrl <identity_url>]

Exemples de commandes minimaux :

  • uipcli asset Deploy "C:\userprofile\assets.csv" « https://orch-23-10-paas.cloudapp.azure.com/ » "TenantName" -u "orchestratorUsername" -p "********" -o "FolderName" --traceLevel "Information"
  • uipcli asset Deploy "C:\userprofile\assets.csv" « https://orch-23-10-paas.cloudapp.azure.com/ » "TenantName" -I "76000552-3e4f-4590-9317-cdb420001f1d" -S "********" --applicationScope "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" --identityUrl "https://orch-23-10-paas.cloudapp.azure. com/identity" -o "NomDossier" --traceLevel "Information"
  • uipcli asset Deploy "C:\userprofile\assets.csv" « https://automation-suite.base.url.com/ » "TenantName" -A "organizationName" -I "3f6239b9-e0e8-465e-a429-d9fd1d9e57a" -S "********" --applicationScope "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" -o "FolderName" --traceLevel "Information
  • uipcli asset Deploy "C:\userprofile\assets.csv" « https://cloud.uipath.com/ » "TenantName" -A "organizationName" -I "becc663c-8f1e-409a-a75f-c00330d80bc8" -S "********" --applicationScope "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" -o "FolderName" --traceLevel "Information"

Exécuter une tâche dans Orchestrator

Prérequis :

Pour exécuter une tâche dans Orchestrator, procédez comme suit :

  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ètreDescription
    -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"
      }
    }{
      "StringArgument_In": "MyConfigurationValue",
      "IntArgument_In": 1,
      "DictionaryArgument_In": {
        "Key1": "Value1",
        "Key2": "Value2"
      }
    }
    -P ou --priorityLa priorité avec laquelle vous souhaitez exécuter la tâche :- Faible.- Normal (par défaut).- Élevé.
    -r ou --robotsUne liste de noms de robots spécifiques, séparés par des virgules.
    -j ou --jobscountLe 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 --userLe 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 --machineLe nom de la machine sur laquelle vous souhaitez exécuter le processus.
    -R ou --result_pathChemin 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 --timeoutDé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_failsLa commande échoue lorsqu'une tâche échoue. La valeur par défaut est True.
    -w ou --waitLa 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 --accountForAppLe 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 --organizationUnitLe 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é.

    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 :

uipcli job run <process_name> <orchestrator_url> <orchestrator_tenant> [-i <input_path>] [-j <jobscount>] [-R <result_path>] [-P <Low|Normal|High>] [-r <robots>] [-f <false|true>] [-W <timeout>] [-w <false|true>] [-u <orchestrator_user> -p <orchestrator_pass>] [-t <auth_token> -a <account_name>] [-A <organization_name> -I <application_id> -S <application_secret> --applicationScope <application_scope>] [-o <folder_name>] [-l <language>] [--user <machine_user> --machine <machine_host_name>] [--job_type <Unattended|NonProduction>] [--traceLevel <None|Critical|Error|Warning|Information|Verbose>] [--identityUrl <identityUrl>]uipcli job run <process_name> <orchestrator_url> <orchestrator_tenant> [-i <input_path>] [-j <jobscount>] [-R <result_path>] [-P <Low|Normal|High>] [-r <robots>] [-f <false|true>] [-W <timeout>] [-w <false|true>] [-u <orchestrator_user> -p <orchestrator_pass>] [-t <auth_token> -a <account_name>] [-A <organization_name> -I <application_id> -S <application_secret> --applicationScope <application_scope>] [-o <folder_name>] [-l <language>] [--user <machine_user> --machine <machine_host_name>] [--job_type <Unattended|NonProduction>] [--traceLevel <None|Critical|Error|Warning|Information|Verbose>] [--identityUrl <identityUrl>]

Exemples de commandes minimaux :

  • uipcli job run ProcessName "https://orch-23-10-paas.cloudapp.azure.com/" "TenantName" -u "orchestratorUsername" -p "********" -o "FolderName" --traceLevel "Information"

  • uipcli job run ProcessName "https://orch-23-10-paas.cloudapp.azure.com/" "TenantName" -I "76000552-3e4f-4590-9317-cdb420001f1d" -S "********" --applicationScope "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" --identityUrl "https://orch-23-10-paas.cloudapp.azure.com/identity" -o "FolderName" --traceLevel "Information"

  • uipcli job run ProcessName "https://automation-suite.base.url.com/" "TenantName" -A "organizationName" -I "3f6239b9-e0e8-465e-a429-d9ffd1d9e57a" -S "********" --applicationScope "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" -o "FolderName" --traceLevel "Information"

  • uipcli job run NomProcessus "https://cloud.uipath.com/" "TenantName" -A "organizationName" -I "becc663c-8f1e-409a-a75f-c00330d80bc8" -S "********" --applicationScope "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" -o "FolderName" --traceLevel "Information"

Analyzing a project

Prérequis :

Pour analyser un projet, procédez comme suit :

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

    Voir la liste des paramètres ci-dessous.

Remarque :

La validation du projet n’est pas effectuée par les tâches Pack ou Analyze de UiPath CLI.

Légende: (*) - Facultatif, recommandé lors de l'utilisation de flux de packages supplémentaires.

Paramètre

Description

--analyzerTraceLevel

Choisissez les types de messages à générer après l'analyse :

  • Désactivé = n'afficher aucun message
  • Erreur

    -Avertissement

    -Informations

    -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

Passer les politiques de gouvernance contenant les règles de l'analyseur de workflow. Les politiques peuvent être téléchargées à partir de Automation Ops Governance, 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)

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 (*)

(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

--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 dans laquelle vous souhaitez supprimer une machine.

-l, --language

La langue d'Orchestrator.

--traceLevel

Afficher la trace des événements.

-identityUrl (requis uniquement pour les déploiements PaaS) L'URL de votre serveur d'identité.

--disableBuiltInNugetFeeds

Désactivez les flux NuGet intégrés.

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 .

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] 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]

Exemples de commandes minimaux :

  • 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"

Deploying a package to Orchestrator

Prérequis :

Pour déployer un package sur Orchestrator, procédez comme suit :

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

    Voir la liste des paramètres ci-dessous.

    Paramètre

    Description

    -c ou --createProcess

    La valeur par défaut est true.

    Lorsqu'il est défini sur true, il crée un processus dans le dossier Orchestrator qui est transmis dans la commande.
    Lorsqu'il est défini sur false, il ne crée pas de processus dans le dossier Orchestrator. Par exemple, --createProcess false.

    --processNames

    Si vous le souhaitez, fournissez un fichier .csv avec des noms personnalisés pour les processus à créer/mettre à jour.

    Voici un exemple de la façon dont le fichier .csv doit ressembler à. Les noms/en-têtes de colonnes : NomPackage, EntryPointName et ProcessName sont obligatoires !

    PackageNameEntryPointNameProcessName

    Mon paquet

    Main.xaml

    Mes processus

    EncoreUnAutrePackage

    CustomEntryPoint.xaml

    Cependant, un autre processus

    --processName

    Vous pouvez éventuellement fournir un nom personnalisé pour le processus à mettre à jour/créer.

    --ignoreLibraryDeployConflict

    Ignorez le conflit lors du déploiement d'un package de bibliothèque avec la même version qu'un package existant. Par défaut, le déploiement échouera si une bibliothèque avec la même version existe déjà dans l'instance Orchestrator.

    -e ou --environments (pour les dossiers classiques)

    Une liste d'environnements dans lesquels vous souhaitez déployer le package, séparés par des virgules.

    Si l'environnement n'appartient pas au dossier par défaut (unité d'organisation), vous devez faire précéder le nom de l'environnement du nom du dossier. Par exemple, si l'environnement est TestEnvironmentet que le nom du dossier est AccountingTeam, écrivez l'environnement sous la forme AccountingTeam\TestEnvironment.

    -h ou --entryPointsPath

    Définissez les points d'entrée spécifiques pour créer ou mettre à jour un processus. Il s'agit du CheminFichier du point d'entrée à partir de la racine du projet.

    Pour les dossiers classiques, un seul point d'entrée peut être spécifié pour chaque environnement.

    -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, à laclé secrètede l' application et à l'étenduede 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 compted'application, à l'ID d' application et à l'étenduede 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 au compted'application , à l'ID d' application et à la clé secrète 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 ou --language

    La langue utilisée dans l'interface utilisateur d'Orchestrator.

    -y ou --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é.

    Package(s) Path (pos. 0) (requis) Le chemin d'accès à un fichier de package ou le chemin d'accès à un dossier contenant plusieurs packages.
    Orchestrator URL (pos. 1) (requis)
    Il s'agit de l'URL de votre Orchestrator.

    `Locataire Orchestrator (pos. 2)

    • (Obligatoire) pour les déploiements SaaP.
    • (Facultatif) pour les déploiements PaaS.
    Locataire de l'instance d'Orchestrator dans laquelle vous souhaitez supprimer une machine.
La uipcli créera un processus avec un point d’entrée default si vous n’en spécifiez pas. Si le point d’entrée est spécifié, un processus avec ce point d’entrée sera créé et _{entryPoint} sera ajouté au nom du processus. De plus, tous les processus associés au package.Id seront mis à jour vers la dernière version, que le processus ait été créé manuellement ou à partir d’un pipeline.

Utilisation :

uipcli package deploy <packages_path> <orchestrator_url> <orchestrator_tenant> [-u <orchestrator_user> -p <orchestrator_pass>] [-t <auth_token> -a <account_name>] [-A <organization_name> -I <application_id> -S <application_secret> --applicationScope <application_scope>] [-o <folder_name>] [-c <false|true>] [-e <environment_list>] [-l <language>] [--ignoreLibraryDeployConflict] [--entryPointsPath <entry_points_path_list>]  [--traceLevel <None|Critical|Error|Warning|Information|Verbose>] [--identityUrl <identityUrl>]uipcli package deploy <packages_path> <orchestrator_url> <orchestrator_tenant> [-u <orchestrator_user> -p <orchestrator_pass>] [-t <auth_token> -a <account_name>] [-A <organization_name> -I <application_id> -S <application_secret> --applicationScope <application_scope>] [-o <folder_name>] [-c <false|true>] [-e <environment_list>] [-l <language>] [--ignoreLibraryDeployConflict] [--entryPointsPath <entry_points_path_list>]  [--traceLevel <None|Critical|Error|Warning|Information|Verbose>] [--identityUrl <identityUrl>]

Exemples de commandes minimales:

  • uipcli package deploy "C:\userprofile\AutomationPackages" "https://orch-23-10-paas.cloudapp.azure.com/" "TenantName" -u "orchestratorUsername" -p "********" -o "FolderName" --traceLevel Information --entryPointsPath "Main.xaml"

  • uipcli package deploy "C:\userprofile\AutomationPackage.1.0.171447983.nupkg" "https://orch-23-10-paas.cloudapp.azure.com/" "TenantName" -I "76000552-3e4f-4590-9317-cdb420001f1d" -S "********" --applicationScope "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" --identityUrl "https://orch-23-10-paas.cloudapp.azure.com/identity" -o "FolderName" --traceLevel Information --entryPointsPath "Main.xaml"n

  • uipcli package deploy "C:\userprofile\AutomationPackage.1.0.171447983.nupkg" "https://automation-suite.base.url.com/" "TenantName" -A "organizationName" -I "3f6239b9-e0e8-465e-a429-d9ffd1d9e57a" -S "********" --applicationScope "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" -o "FolderName" --traceLevel Information --entryPointsPath "Main.xaml"

  • uipcli package deploy "C:\userprofile\AutomationPackage.1.0.171447983.nupkg" "https://cloud.uipath.com/" "TenantName" -A "organizationName" -I "becc663c-8f1e-409a-a75f-c00330d80bc8" -S "********" --applicationScope "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" -o "FolderName" --traceLevel Information --processNames "C:\userprofile\processNames.csv"

  • uipcli package deploy "C:\userprofile\AutomationPackage.1.0.171447983.nupkg" "https://cloud.uipath.com/" "TenantName" -A "organizationName" -I "becc663c-8f1e-409a-a75f-c00330d80bc8" -S "********" --applicationScope "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" -o "FolderName" --traceLevel Information --entryPointsPath "Main.xaml" --processName "MyProcessName"

Packing projects into a package

Prérequis :

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 voir une liste des sous-tâches disponibles.
  2. Spécifiez les paramètres requis et exécutez la sous-tâche pack .

    Voir la liste des paramètres ci-dessous.

Remarque :

La validation du projet n’est pas effectuée par les tâches Pack ou Analyze de UiPath CLI.

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

Paramètre

Description

-o, ou --output(Requis)

Le dossier Orchestrator de destination, dans lequel vous souhaitez compresser les projets.

-v ou --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.

-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 référence des bibliothèques à partir 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 référence des bibliothèques à partir du flux Orchestrator

-t, --libraryOrchestratorAuthToken (*)

(requis si vous utilisez l’authentification basée sur 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.

Ceci est requis si votre package référence des bibliothèques à partir 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 référence des bibliothèques à partir 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

Ceci est requis si votre package fait référence à des 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 à des 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 à des 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 à des 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 dans laquelle vous souhaitez supprimer une machine.

--libraryIdentityUrl(requis uniquement pour les déploiements PaaS )
L'URL de votre serveur d'identité.

--traceLevel

Afficher la trace des événements.

-l ou --language

La langue utilisée dans l'interface utilisateur d'Orchestrator.

--disableBuiltInNugetFeeds

Désactive les flux NuGet intégrés.

Project(s) Path (pos. 0) (Requis) Chemin d'accès à un fichier project.json ou à un dossier contenant project.json fichiers.

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] [--repositoryUrl <repository_url>] [--repositoryCommit <repository_commit>] [--repositoryBranch <repository_branch>] [--repositoryType <repository_type>] [--projectUrl <automation_hub_idea_url>] [--releaseNotes <release_notes>] [--disableBuiltInNugetFeeds]  [--traceLevel <None|Critical|Error|Warning|Information|Verbose>]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] [--repositoryUrl <repository_url>] [--repositoryCommit <repository_commit>] [--repositoryBranch <repository_branch>] [--repositoryType <repository_type>] [--projectUrl <automation_hub_idea_url>] [--releaseNotes <release_notes>] [--disableBuiltInNugetFeeds]  [--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"

  • 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"

Restauration des dépendances de l'automatisation

Prérequis :

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

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

    Voir la liste des paramètres ci-dessous.

    Paramètre

    Description

    --restoreFolder

    Requis. Restaurez le chemin du dossier de destination.

    --nugetConfigFilePath

    Facultatif. Chemin d'accès au fichier NuGet.Config contenant les flux.

    -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

    URL de votre serveur d'identité. Ceci est uniquement nécessaire pour les déploiements PaaS.

    --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.

    --disableBuiltInNugetFeeds

    Désactive les flux NuGet intégrés.

    Project(s) Path (pos. 0)

    Requis. Le chemin d'accès à un fichier project.json , ou à un dossier qui contient des fichiers project.json .

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] [--traceLevel <None|Critical|Error|Warning|Information|Verbose>]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] [--traceLevel <None|Critical|Error|Warning|Information|Verbose>]

Exemples de commandes minimales:

  • 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"

Tester un package ou exécuter un ensemble de test

Prérequis :

Pour tester un package, procédez comme suit :

  1. Exécutez la tâche test à l'aide de uipcli test . Vous pouvez 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

    -P ou --project-pathChemin d'accès au fichier du package de test que vous souhaitez tester.
    -s ou --testset

    Le nom affiché pour l'ensemble de tests que vous souhaitez exécuter. Assurez-vous que l'ensemble de tests inclut la version la plus récente des cas de test. Si l'ensemble de tests ne se trouve pas dans le dossier par défaut, assurez-vous d'inclure avant le nom du dossier pertinent. Par exemple, utilisez ÉquipeComptabilité\EnsembleTest.

    --outLe type du fichier des résultats <junit|uipath>.
    -r ou --result_pathLe chemin de destination du fichier dans lequel vous souhaitez stocker les résultats.
    -e ou --environment (requis pour les dossiers classiques) L'environnement dans lequel vous souhaitez déployer le package. Vous devez l'associer au project path .
    -w ou --timeoutDurée (en secondes) que vous souhaitez attendre pour l'exécution de l'ensemble de tests. La valeur par défaut est de 7 200 secondes.
    -i ou --input_path (requis si le workflow du point d'entrée a des paramètres d'entrée que vous souhaitez transmettre via la ligne de commande) Le chemin complet d’accès à un fichier d’entrée json.
    --attachRobotLogsAttache les journaux du robot pour chaque cas de test exécuté et un rapport de test JUnit.

    --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.

    --releaseNotesAjouter des notes de publication.
    --disableBuiltInNugetFeedsDésactivez les flux NuGet intégrés.

    --retryCount

    Nombre de nouvelles tentatives pour les cas de test ayant échoué (par défaut, aucune nouvelle tentative n’est définie).

    -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, --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 une 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 dossier Orchestrator dans lequel vous souhaitez exécuter les ensembles de tests.

    -l ou --language

    La langue utilisée dans l'interface utilisateur d'Orchestrator.

    --traceLevel

    Afficher la trace des événements.

    --identityURL (Requis pour les déploiements PaaS uniquement)

    L'URL de votre serveur d'identité.

    Orchestrator URL (pos. 0) (requis) Il s'agit de l'URL de votre Orchestrator.

    Orchestrator Tenant (pos. 1)

    • (Obligatoire) pour les déploiements SaaP.
    • (Facultatif) pour les déploiements PaaS.
    Locataire à l'intérieur duquel se trouve le package ou l'ensemble de test.

Utilisation :

uipcli test run <orchestrator_url> <orchestrator_tenant> [-i <input_path>] [-P <project_json_path>] [-s <testset_name>] [-u <orchestrator_user> -p <orchestrator_pass>] [-t <auth_token> -a <account_name>] [-A <organization_name> -I <application_id> -S <application_secret> --applicationScope <application_scope>] [-e <environment>] [-o <folder_name>] [-l <language>] [--out <junit|uipath>] [--result_path <result_path>] [--timeout <seconds>] [--attachRobotLogs true] repositoryUrl <repository_url>] [--repositoryCommit <repository_commit>] [--repositoryBranch <repository_branch>] [--repositoryType <repository_type>] [--projectUrl <automation_hub_idea_url>] [--releaseNotes <release_notes>] [--disableBuiltInNugetFeeds] [--retryCount <number>]  [--traceLevel <None|Critical|Error|Warning|Information|Verbose>] [--identityUrl <identityUrl>]uipcli test run <orchestrator_url> <orchestrator_tenant> [-i <input_path>] [-P <project_json_path>] [-s <testset_name>] [-u <orchestrator_user> -p <orchestrator_pass>] [-t <auth_token> -a <account_name>] [-A <organization_name> -I <application_id> -S <application_secret> --applicationScope <application_scope>] [-e <environment>] [-o <folder_name>] [-l <language>] [--out <junit|uipath>] [--result_path <result_path>] [--timeout <seconds>] [--attachRobotLogs true] repositoryUrl <repository_url>] [--repositoryCommit <repository_commit>] [--repositoryBranch <repository_branch>] [--repositoryType <repository_type>] [--projectUrl <automation_hub_idea_url>] [--releaseNotes <release_notes>] [--disableBuiltInNugetFeeds] [--retryCount <number>]  [--traceLevel <None|Critical|Error|Warning|Information|Verbose>] [--identityUrl <identityUrl>]

Exemples  :

  • uipcli test run "https://orch-23-10-paas.cloudapp.azure.com/" "TenantName" -u "orchestratorUsername" -p "********" -o "FolderName" --traceLevel Information -P "C:\userprofile\AutomationProjectWithTestCases\project.json" "C:\userprofile\AutomationProjectWithTestCases\project.json"

  • uipcli test run "https://orch-23-10-paas.cloudapp.azure.com/" "TenantName" -I "76000552-3e4f-4590-9317-cdb420001f1d" -S "********" --applicationScope "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" --identityUrl "https://orch-23-10-paas.cloudapp.azure.com/identity" -o "FolderName" --traceLevel Information -P "C:\userprofile\AutomationProjectWithTestCases\project.json"

  • uipcli test run "https://automation-suite.base.url.com/" "TenantName" -A "organizationName" -I "3f6239b9-e0e8-465e-a429-d9ffd1d9e57a" -S "********" --applicationScope "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" -o "FolderName" --traceLevel Information -P "C:\userprofile\AutomationProjectWithTestCases\project.json"

  • uipcli test run "https://cloud.uipath.com/" "TenantName" -A "organizationName" -I "becc663c-8f1e-409a-a75f-c00330d80bc8" -S "********" --applicationScope "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" -o "FolderName" --traceLevel Information -P "C:\userprofile\AutomationProjectWithTestCases\project.json"

Cette page vous a-t-elle été utile ?

Obtenez l'aide dont vous avez besoin
Formation RPA - Cours d'automatisation
Forum de la communauté UiPath
Uipath Logo White
Confiance et sécurité
© 2005-2024 UiPath Tous droits réservés.