Implantação de ativos no Orchestrator

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, valuee description.
• Execute o arquivo CLI exe (para Windows) ou dll (para Linux).
• Adicione os escopos de aplicativos de acesso à API do Orchestrator abaixo:

  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.

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	1	asset_2_description
asset_3_name	Bool	false	asset_3_description
asset_4_name	Credencial	username:password	asset_4_description

Para implantar ativos no Orchestrator:

1. Execute a tarefa asset , usando uipcli asset. Você pode ver uma lista das subtarefas disponíveis.
2. Especifique os parâmetros necessários e execute a subtarefa deploy .

   Veja a lista de parâmetros abaixo.

   Parâmetro	Description
   Assets File (pos. 0) (necessário)	O nome do arquivo CSV que contém os recursos que você deseja excluir.
   Orchestrator URL (pos.1) (necessário)	O URL da instância do Orchestrator.
   Orchestrator Tenant (pos.2) (Obrigatório) para implantações SaaP. (Opcional) para implantações de PaaS.	O tenant da instância do Orchestrator, onde você deseja gerenciar seus ativos.
   -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(Necessá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, ou --accountName(Necessá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.
   -Aou --accountForApp	O nome da conta CloudRPA do Orchestrator. Você deve combiná-lo com a ID do aplicativo, Segredo do aplicativo e Escopo do aplicativo para um aplicativo externo.
   -I, ou --applicationID(Necessário se você usar a autenticação por 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(Necessário se você usar a autenticação por aplicativo externo)	O Segredo do aplicativo externo. Você deve combiná-lo com a Conta do aplicativo, ID do aplicativo e Escopo de aplicativo.
   --applicationScope (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.
   -oou --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.
   -lou --language	O idioma usado na interface do usuário do Orchestrator.
   -you --disableTelemetry	Desabilitar dados de telemetria.
   --traceLevel	Exibir o rastreamento dos eventos.
   --identityUrl (exigido apenas para implantações de PaaS )	A URL do seu servidor de identidade.

Exemplos:

• asset deploy assets_file.csv "https://uipath-orchestrator.myorg.com" default -u admin -p 123456 -l en-US.
• asset deploy assets_file.csv "https://uipath-orchestrator.myorg.com" default -u admin -p 123456 -o OurOrganization.
• asset deploy assets_file.csv "https://uipath-orchestrator.myorg.com" default -t a7da29a2c93a717110a82 -a myAccount.
• asset delete assets_file.csv "https://uipath-orchestrator.myorg.com" default -A accountForExternalApp -I myExternalAppId -S myExternalAppSecret --applicationScope "OR.Folders.Read OR.Settings.Read".

Adição de um aplicativo externo

Para registrar um aplicativo externo, de forma que ele possa acessar seus recursos da UiPath usando o OAuth:

1. Faça logon no tenant como um Administrador.
2. Acesse Tenant > Gerenciar acesso > Atribuir funções e clique em Gerenciar contas e grupos.

   O nível de tenant é aberto.

3. À esquerda, selecione Aplicativos externos.

   A página Aplicativos externos é aberta, listando todos os aplicativos externos existentes registrados para o tenant atual:

   
   

   

   
   
4. Acima da tabela, à direita, clique em Adicionar aplicativo.
5. Preencha o campo Application Name.
6. Selecione uma opção para o Tipo de aplicativo.

   Se você selecionar Aplicativo confidencial, receberá um segredo do aplicativo no final, portanto, certifique-se de que seu aplicativo pode armazená-lo com segurança. Se não for possível, selecione Aplicativo não confidencial.

7. Em Recursos, clique em Adicionar escopos.

   O painel Editar recurso será aberto à direita, no qual você pode selecionar os recursos que o aplicativo deve ter acesso.

8. Na lista suspensa Recurso, selecione a API do UiPath que o aplicativo pode usar.
   Nota: Você só pode adicionar escopo para um recurso por vez. Se você quiser permitir acesso a vários recursos, repita esse processo para adicionar escopo para cada recurso.
9. Na guia Escopo(s) do usuário, marque as caixas de seleção para as permissões de API lógica que você deseja conceder, conforme necessário.

   A concessão de permissões no escopo do usuário significa que o aplicativo externo pode acessar esses recursos dentro de um contexto de usuário e um usuário com as permissões adequadas deve estar logado.

10. Se esse for um aplicativo confidencial, você pode alternar para a guia Escopo(s) do aplicativo para também conceder permissões de nível de aplicativos para o recurso selecionado, conforme necessário.

    Com permissões sob o escopo do aplicativo, o aplicativo externo tem acesso aos dados de nível de aplicativo dos escopos selecionados sem a necessidade de interação do usuário.

    Os aplicativos não confidenciais não podem acessar o escopo do aplicativo.

11. Clique em Salvar.

    O painel será fechado e o recurso e os escopos selecionados serão adicionados à tabela Recursos no formulário.

12. Se o aplicativo externo puder aceitá-lo, você pode adicionar uma URL no campo Redirecionar URL e a resposta de autorização será enviada para ela. O aplicativo pode usá-la para acessar recursos da UiPath.
13. Clique em Adicionar para criar o registro.

    Uma mensagem de confirmação será aberta. Para aplicativos confidenciais, a mensagem de confirmação inclui o segredo do aplicativo que o aplicativo externo registrado pode usar para solicitar autorização. Certifique-se de salvá-lo em um local seguro porque não poderá exibi-lo novamente.