- Notas de Versão
- Introdução
- Governança
- Controle de origem
- Pipelines de CI/CD
- Gerenciamento de feeds
- Geração de logs
Executando Tarefas
Executar tarefas dentro do UiPath CLI projetado para dispositivos Windows (UiPath.CLI.Windows) requer várias tarefas.
As principais diferenças entre os procedimentos para o UiPath.CLI.Windows e os procedimentos para o UiPath.CLI (UiPath CLI projetado para dispositivos Linux) consistem em argumentos adicionais que você pode passar com algumas tarefas específicas para o tipo de dispositivo que você está correndo.
The action could not be performed because the project is already opened in another Studio instance. Please close it and try again.
A tabela a seguir mostra os escopos de aplicativos de acesso à API do Orchestrator necessários para executar qualquer tarefa da CLI.
Escopo do aplicativo |
Description |
---|---|
OU. Ativos |
Acesso de leitura e gravação de ativos no Orchestrator. |
OR.BackgroundTasks |
Acesso de leitura e gravação de BackgroundTasks no Orchestrator. |
OU. Execução |
Acesso de leitura e gravação de execução no Orchestrator. |
OU.Pastas |
Acesso de leitura e gravação de pastas no Orchestrator. |
OU.Empregos |
Acesso de leitura e gravação de trabalhos no Orchestrator. |
OR.Machines.Read |
Acesso de leitura de máquinas no Orchestrator. |
OU.Monitoramento |
Acesso de leitura e gravação de monitoramento no Orchestrator. |
OU.Robôs.Leitura |
Acesso de leitura de robôs no Orchestrator. |
OU.Configurações.Ler |
Acesso de leitura de configurações no Orchestrator. |
OR.TestSets |
Acesso de leitura e gravação de TestSets no Orchestrator. |
OR.TestSetExecutions |
Acesso de leitura e gravação de TestSetExecutions no Orchestrator. |
OR.TestSetSchedules |
Acesso de leitura e gravação de TestSetSchedules no Orchestrator. |
OU.Usuários.Leitura |
Acesso de leitura de usuários no Orchestrator. |
Além dos escopos listados na tabela, um escopo importante a ser destacado é o OR.Default. O escopo OR.Default funciona como um curinga. Ele oferece acesso refinado e específico por função, nos níveis da organização e da pasta. Isso oferece a flexibilidade de ter controle preciso sobre permissões de aplicativos, além dos escopos predefinidos para toda a organização. Para obter mais detalhes, consulte Declaração de escopos.
Para registrar um aplicativo externo, de forma que ele possa usar o OAuth para acessar seus recursos da UiPath:
Pré-requisitos: Para usar o UiPath CLI for Windows e executar tarefas, instale o .NET 6.0.7, que deve incluir o .NET 6.0.7 Desktop Runtime, que vem com o SDK 6.0.302.
uipcli.exe
incluindo os parâmetros correspondentes. Para executar subtarefas, o comando precisa ter o seguinte formato: uipcli.exe <task name> <sub-task name>
. Para executar a CLI:
- Abra um prompt de comando e navegue até a pasta extraída do arquivo NUPKG.
- Digite
uipcli.exe
e selecione a tecla Enter .
Pré-requisitos: Para usar o UiPath CLI para plataforma cruzada e executar tarefas de trabalho, instale o .NET 6.0.7, que vem com o SDK 6.0.302.
uipcli.exe
incluindo os parâmetros correspondentes. Para executar subtarefas, o comando precisa ter o seguinte formato: dotnet uipcli.dll <task name> <sub-task name>
. Para executar a CLI:
- Abra um prompt de comando e navegue até a pasta extraída do arquivo NUPKG.
- Digite
dotnet uipcli.dll
e selecione a chave Enter.
Pré-requisitos:
- Crie ativos no Orchestrator.
- Crie um arquivo CSV que contenha os ativos que você deseja excluir. O arquivo CSV deve ter as três colunas a seguir:
name
,type
evalue
. As células de dados nas colunastype
evalue
podem permanecer vazias. - Execute o arquivo CLI
exe
(para Windows) oudll
(para Linux). - Adicione os escopos de aplicativos de acesso à API do Orchestrator necessários.
Para mais informações sobre o arquivo CSV, confira os exemplos na tabela abaixo:
name |
Tipo |
Value |
---|---|---|
asset1_name | N/A | N/A |
asset2_name |
Bool |
|
asset3_name |
Número inteiro | N/A |
asset4_name |
Credencial |
username:password |
Para excluir ativos do Orchestrator, siga as seguintes etapas:
Uso:
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>]
Exemplos mínimos de comando:
Excluir ativo do uipcli “C:\userprofile\assets.csv” “https://orch-23-10-paas.cloudapp.azure.com/” "TenantName" -u "orchestratorUsername" -p "********" -o "FolderName" --traceLevel "Information"
Excluir ativo do uipcli “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 "FolderName" --traceLevel "Information"
Excluir ativo do uipcli “C:\userprofile\assets.csv” "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"
Excluir ativo do uipcli “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"
Pré-requisitos:
- Crie um arquivo CSV que contenha os ativos que você deseja implantar no Orchestrator.
O arquivo CSV deve ter as três colunas a seguir:
name
,type
,value
edescription
. - Execute o arquivo CLI
exe
(para Windows) oudll
(para Linux). - Adicione os escopos de aplicativos de acesso à API do Orchestrator necessários.
Para obter mais informações sobre o arquivo CSV, verifique o exemplo abaixo.
name |
Tipo |
Value |
Descrição |
---|---|---|---|
asset_1_name |
text |
"tenho um comentário" |
asset_1_description |
asset_2_name |
Número inteiro |
|
asset_2_description |
asset_3_name |
Bool |
|
asset_3_description |
asset_4_name |
Credencial |
username:password |
asset_4_description |
Para implantar ativos no Orchestrator, execute as seguintes etapas:
Uso:
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>]
Exemplos mínimos de comandos:
Implantação de ativo do uipcli “C:\userprofile\assets.csv” “https://orch-23-10-paas.cloudapp.azure.com/” "TenantName" -u "orchestratorUsername" -p "********" -o "FolderName" --traceLevel "Information"
Implantação de ativo do uipcli “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 "FolderName" --traceLevel "Information"
Implantação de ativo do uipcli “C:\userprofile\assets.csv” "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
Implantação de ativo do uipcli “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"
- Criar um processo no Orchestrator.
- Execute o arquivo CLI
exe
(para Windows) oudll
(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:
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>]
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"
Pré-requisitos:
- Criar um projeto
- Execute o arquivo CLI
exe
(para Windows) oudll
(para Linux). - Adicione os escopos de aplicativos de acesso à API do Orchestrator necessários.
Para analisar um projeto, siga as seguintes etapas:
A validação do projeto não é executada pelas tarefas Pacote ou Analisar do UiPath CLI.
Parâmetro |
Description |
---|---|
|
Escolha quais tipos de mensagens enviar após a análise:
|
|
O trabalho falha quando alguma regra é violada. |
|
Trate os avisos como erros. |
|
O caminho completo para um arquivo JSON no qual você deseja armazenar os resultados. Se você não adicionar isso como um argumento, os resultados serão impressos apenas no console padrão. |
|
Aprovar políticas de governança que contenham as regras do Analisador de Fluxo de Trabalho. As políticas podem ser baixadas da Governança do Automation Ops ou extraídas do arquivo zip compactado exportado do Studio. Observação:
A tarefa falha se você especificar o uso de uma política, mas o arquivo da política não estiver no caminho mencionado. |
|
Uma lista de regras que você deseja ignorar durante a análise, separadas por vírgulas. |
-u , --orchestratorUsername (*)
(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 , --orchestratorPassword (*)
(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 , -orchestratorAuthToken (*)
(Obrigatório se você usar a autenticação baseada em token) |
O token de atualização OAuth2 usado para autenticação no Orchestrator. Você deve emparelhá-lo com o nome da conta e o ID do cliente. |
-a , --orchestratorAccountName (*)
(Obrigatório se você usar a autenticação baseada em token) |
O nome da conta do Orchestrator CloudRPA. Você deve emparelhá-lo com o token de atualização OAuth2 e o Client ID. |
-A , --orchestratorAccountForApp (*)
|
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 , --orchestratorApplicationId (*)
(Necessário se você usar a autenticação do aplicativo externo) |
A ID do aplicativo externo. Você deve combiná-lo com a **Conta do aplicativo, Segredo do aplicativo e Escopo do aplicativo. |
-S , --orchestratorApplicationSecret (*)
(Necessário se você usar a autenticação do aplicativo externo) |
O Segredo do aplicativo externo. Você deve combiná-lo com a Conta do aplicativo, ID do aplicativo e Escopo do aplicativo. |
--orchestratorApplicationScope (*)
(Necessário se você usar a autenticação do aplicativo externo) |
A lista de escopos do aplicativo, separada por espaços únicos. Você deve combiná-lo com a Conta do aplicativo, ID do aplicativo e Segredo do aplicativo para um aplicativo externo. |
--orchestratorFolder (*)
|
O nome da pasta de destino do Orchestrator. Para inserir subpastas, certifique-se de inserir o nome da pasta pai e o nome da subpasta. Por exemplo, use
AccountingTeam\TeamJohn .
|
--orchestratorUrl (*)
|
O URL da instância do Orchestrator. |
--orchestratorTenant (*)
|
O locatário da instância do Orchestrator em que você deseja excluir uma máquina. |
-l , --language |
A linguagem do Orchestrator. |
|
Exibir o rastreamento dos eventos. |
-identityUrl (Necessário apenas para implantações do PaaS)
| A URL do seu servidor de identidade. |
|
Desabilitar feeds integrados do NuGet. |
Project(s) Path (pos.0) (Necessário)
| O caminho para o arquivo project.json ou o caminho para a pasta que contém vários arquivos project.json .
|
Uso:
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]
Exemplos mínimos de comandos:
-
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"
Pré-requisitos:
- Crie um pacote.
- Execute o arquivo CLI
exe
(para Windows) oudll
(para Linux). - Adicione os escopos de aplicativos de acesso à API do Orchestrator necessários.
Para implantar um pacote no Orchestrator, execute as seguintes etapas:
uipcli
cria um processo com um ponto de default
entrada se você não especificar um. Se o ponto de entrada for especificado, um processo com esse ponto de entrada será criado e _{entryPoint}
será anexado ao nome do processo. Além disso, todos os processos associados a ele package.Id
são atualizados para a versão mais recente, independentemente de o processo ter sido criado manualmente ou a partir de um pipeline.
Uso:
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>]
Exemplos mínimos de comando:
-
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"
Pré-requisitos:
- Criar projetos.
- Execute o arquivo CLI
exe
(para Windows) oudll
(para Linux). - Adicione os escopos de aplicativos de acesso à API do Orchestrator necessários.
Para empacotar um projeto em um pacote, siga as seguintes etapas:
A validação do projeto não é executada pelas tarefas Pacote ou Analisar do UiPath CLI.
Legenda: (*) - Opcional, útil apenas quando você possui dependências de uma biblioteca no Orchestrator.
Parâmetro |
Description |
---|---|
-o ou --output (Necessário)
|
A pasta do Orchestrator de destino, onde você deseja empacotar os projetos. |
-v ou --version |
Defina a versão do pacote. |
|
Gera automaticamente uma versão do pacote. |
|
Força a saída a ser de um tipo específico. |
|
Habilita a saída dividida para runtime e bibliotecas de design. |
|
A URL do repositório onde o projeto é versionado. |
|
A confirmação do repositório de onde o projeto foi criado. |
|
A ramificação do repositório de onde o projeto foi criado. |
|
Tipo de repositório do sistema VCS. |
|
URL da ideia do Automation Hub. |
|
Adicione notas da versão. |
-u , --libraryOrchestratorUsername (*)
(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. Isso é necessário se o seu pacote fizer referência a bibliotecas do feed do orquestrador |
-p , --libraryOrchestratorPassword (*)
(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. Isso é necessário se o seu pacote fizer referência a bibliotecas do feed do orquestrador |
-t , --libraryOrchestratorAuthToken (*)
(Obrigatório se você usar a autenticação baseada em token) |
O token de atualização OAuth2 usado para autenticação no Orchestrator. Você deve emparelhá-lo com o nome da conta e o ID do cliente. Isso é necessário se o seu pacote fizer referência a bibliotecas do feed do orquestrador |
-a , --libraryOrchestratorAccountName (*)
(Obrigatório se você usar a autenticação baseada em token) |
O nome da conta do Orchestrator CloudRPA. Você deve emparelhá-lo com o token de atualização OAuth2 e o Client ID. Isso é necessário se o seu pacote fizer referência a bibliotecas do feed do orquestrador |
-A , --libraryOrchestratorAccountForApp (*)
|
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 Isso é necessário se o seu pacote faz referência a bibliotecas do feed do Orchestrator. |
-I ,--libraryOrchestratorApplicationId (*)
(Necessário se você usar a autenticação do aplicativo externo) | A ID do aplicativo externo. Você deve combiná-lo com a Conta do aplicativo, Segredo do aplicativo e Escopo do aplicativo.
Isso é necessário se o seu pacote faz referência a bibliotecas do feed do Orchestrator. |
-S , --libraryOrchestratorApplicationSecret (*)
(Necessário se você usar a autenticação do aplicativo externo) |
O Segredo do aplicativo externo. Você deve combiná-lo com a Conta do aplicativo, ID do aplicativo e Escopo do aplicativo. Isso é necessário se o seu pacote faz referência a bibliotecas do feed do Orchestrator. |
--libraryOrchestratorApplicationScope (*)
(Necessário se você usar a autenticação do aplicativo externo) |
A lista de escopos do aplicativo, separada por espaços únicos. Você deve combiná-lo com a Conta do aplicativo, ID do aplicativo e Segredo do aplicativo para um aplicativo externo. Isso é necessário se o seu pacote faz referência a bibliotecas do feed do Orchestrator. |
--libraryOrchestratorFolder (*)
|
O nome da pasta de destino do Orchestrator. Para inserir subpastas, certifique-se de inserir o nome da pasta pai e o nome da subpasta. Por exemplo, use
AccountingTeam\TeamJohn .
|
--libraryOrchestratorUrl (*)
|
O URL da instância do Orchestrator. |
--libraryOrchestratorTenant (*)
|
O locatário da instância do Orchestrator em que você deseja excluir uma máquina. |
--libraryIdentityUrl (Necessário apenas para implantações do PaaS )
| A URL do seu servidor de identidade. |
|
Exibir o rastreamento dos eventos. |
-l ou --language |
O idioma usado na interface do usuário do Orchestrator. |
|
Desabilite os feeds de nuget integrados. |
Project(s) Path (pos. 0) (Necessário)
| O caminho para um arquivo project.json ou para uma pasta que contém project.json arquivos.
|
Uso:
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>]
Exemplos:
-
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"
Pré-requisitos:
- Crie um pacote ou um conjunto de testes.
- Execute o arquivo CLI
exe
(para Windows) oudll
(para Linux). - Adicione os escopos de aplicativos de acesso à API do Orchestrator necessários.
Para testar um pacote, siga as seguintes etapas:
Uso:
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>]
Exemplos:
-
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"
- Escopos de aplicativos de acesso à API
- Adição de um aplicativo externo
- Running UiPath.CLI.Windows
- Executando UiPath.CLI
- Exibindo a versão CLI
- Deleting assets from Orchestrator
- Deploying assets to Orchestrator
- Executando um trabalho dentro do Orchestrator
- Analyzing a project
- Deploying a package to Orchestrator
- Packing projects into a package
- Teste de um pacote ou execução de um conjunto de testes