Executando um trabalho dentro do Orchestrator

Prerequisites:

• Criar um processo no Orchestrator.
• Execute o arquivo CLI exe (para Windows) ou dll (para Linux).
• Adicione os escopos de aplicativos de acesso à API do Orchestrator necessários.

Para executar um trabalho dentro do Orchestrator, siga as seguintes etapas:

1. Execute a tarefa job , usando uipcli job. Agora, é possível ver uma lista das subtarefas disponível
2. Especifique os parâmetros necessários e execute a subtarefa run . A tabela a seguir descreve os parâmetros necessários.

Parâmetro	Description
-i ou --input_path ( obrigatório apenas se o ponto de entrada do fluxo de trabalho tiver parâmetros de entrada)	O caminho completo para o arquivo de entrada JSON correspondente ao processo que você deseja executar. Exemplo de formato de arquivo JSON: { "StringArgument_In": "MyConfigurationValue", "IntArgument_In": 1, "DictionaryArgument_In": { "Key1": "Value1", "Key2": "Value2" } }
-P , or --priority	A prioridade com a qual você deseja executar o trabalho:- Baixa.- Normal (padrão).- Alto.
-r , or --robots	Uma lista de nomes de robôs específicos, separados por vírgulas.
-j , or --jobscount	O número de vezes que você deseja executar o processo. O número padrão de vezes que o processo é executado é um.
-U , or --user	O nome do usuário. Deve ser um usuário de máquina, não um usuário do Orchestrator. Para usuários locais, o formato é MachineName\UserName.
-M , or --machine	O nome da máquina na qual você deseja executar o processo.
-R , or --result_path	O caminho completo para um arquivo JSON ou para uma pasta onde você deseja armazenar os resultados do trabalho. Os resultados retornam como arquivos JSON.
-W , or --timeout	O tempo limite para execuções de trabalho (segundos). O padrão é 1800 segundos.
-f , or --fail_when_job_fails	O comando falha quando um trabalho falha. O padrão para isso é True .
-w , or --wait	O comando aguarda a conclusão do trabalho. O padrão para isso é True .
-b ou --job_type (apenas para pastas modernas)	O tipo de runtime do trabalho. Você pode escolher:- Unattended - NonProduction .
-u ou --username ( necessário se você usar a Autenticação Básica , por meio de um nome de usuário e uma senha)	O nome de usuário usado para autenticação no Orchestrator. Você deve emparelhá-lo com a senha correspondente.
-p ou --password ( necessário se você usar a Autenticação Básica , por meio de um nome de usuário e uma senha)	A senha usada para autenticação ao Orchestrator. Você deve combiná-lo com o nome de usuário correspondente.
-t ou --token ( obrigatório se você usar autenticação baseada em token )	O token de atualização do OAuth2 usado para autenticação ao Orchestrator. Você deve combiná-lo com o Nome da conta e ID do cliente .
-a ou --accountName ( obrigatório se você usar autenticação baseada em token )	O nome da conta CloudRPA do Orchestrator. Você deve combiná-lo com o token de atualização do OAuth2 e o ID do cliente .
-A , or --accountForApp	O nome da conta do Orchestrator CloudRPA (nome da organização). Você deve combiná-lo com a ID do aplicativo, Segredo do aplicativo e Escopo do aplicativo para um aplicativo externo.
-I ou --applicationId ( obrigatório se você usar autenticação de aplicativo externo )	A ID do aplicativo externo. Você deve combiná-lo com a Conta do aplicativo, Segredo do aplicativo e Escopo do aplicativo.
-S ou --applicationSecret ( obrigatório se você usar autenticação de aplicativo externo )	O Segredo do aplicativo externo. Você deve combiná-lo com a Conta do aplicativo, ID do aplicativo e Escopo do aplicativo.
--applicationScope ( Necessário se você usar autenticação de aplicativo externo )	A lista de escopos do aplicativo, separada por espaços únicos. Opcional ao usar autenticação de aplicativo externo, pois os escopos padrão são aplicados automaticamente. Você deve combiná-lo com a Conta do aplicativo , ID do aplicativo e Segredo do aplicativo para um aplicativo externo.
-o , or --organizationUnit	O nome da pasta do Orchestrator (unidade organizacional). Para inserir subpastas, certifique-se de inserir o nome da pasta pai e o nome da subpasta. Por exemplo, use AccountingTeam\TeamJohn.
-l , --language	O idioma do Orchestrator.
-y , --disableTelemetry	Desabilitar dados de telemetria.
--traceLevel	Exibir o rastreamento dos eventos.
--identityUrl ( Necessário para implantações PaaS ou MSI )	A URL do seu servidor de identidade.
Process Name (pos.0) ( Necessário )	O nome do processo que você deseja executar.
Orchestrator URL (pos.1) ( Necessário )	O URL da instância do Orchestrator.
Orchestrator Tenant (pos.2) ( Obrigatório ) para implantações do SaaP. ( Opcional ) para implantações do PaaS.	O tenant da Instância do Orchestrator, onde você deseja executar processos.

Observação:

Ao usar a autenticação de aplicativos externos sem especificar o parâmetro --applicationScope , a CLI aplica automaticamente esses escopos do Orchestrator padrão:

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

Uso:

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

Exemplos mínimos de comandos:

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