Implantação de um pacote no Orchestrator

Pré-requisitos:

• Crie um pacote.
• 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.

1. Execute a tarefa package , usando uipcli package. 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
   Package(s) Path (pos. 0) (necessário)	O caminho para um arquivo de pacote ou o caminho para uma pasta contendo vários pacotes.
   Orchestrator URL (pos. 1) (necessário)	O URL da instância do Orchestrator.
   Tenant do Orchestrator (pos. 2) (Obrigatório) para implantações SaaP. (Opcional) para implantações do PaaS.`	O locatário da instância do Orchestrator em que você deseja excluir uma máquina.
   -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.
   -cou --createProcess	Quando definido como true, ele cria um processo na pasta do Orchestrator que é passado no comando. O valor padrão para essa opção é True. Quando definido como false, ele não cria um processo na pasta do Orchestrator. Por exemplo, --createProcess false.
   -eou --environments (para pastas clássicas)	Uma lista de ambientes nos quais você deseja implantar o pacote, separados por vírgulas. Se o ambiente não pertencer à pasta padrão (unidade organizacional), você deve prefixar o nome do ambiente com o nome da pasta. Por exemplo, se o ambiente for TestEnvironmente o nome da pasta for AccountingTeam, grave o ambiente como AccountingTeam\TestEnvironment.
   -hou --entryPointsPath	Define os pontos de entrada específicos para criar ou atualizar o processo. Esse é o caminho do arquivo do entry point, a partir da raiz do projeto. Para pastas clássicas, apenas um único ponto de entrada pode ser especificado para cada ambiente.
   -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.
   --help	Exibe os parâmetros e exemplos para este comando.

Exemplos:

• package deploy "C:\UiPath\Project\TestsPackage.1.0.6820.22047.nupkg" "https://uipath-orchestrator.myorg.com" default -u admin -p 123456 -e SAPEnvironment,ExcelAutomationEnvironment -l en-US.
• package deploy "C:\UiPath\Project\TestsPackage.1.0.6820.22047.nupkg" "https://uipath-orchestrator.myorg.com" default -A myAccountForExternalApp -I myExternalAppId -S myExternalAppSecret --applicationScope "OR.Folders.Read OR.Settings.Read".
• package deploy "C:\UiPath\Project\TestsPackage.1.0.6820.22047.nupkg" "https://uipath-orchestrator.myorg.com" default -u admin -p 123456 -e SAPEnvironment,ExcelAutomationEnvironment -l en-US -h EntryPoint1,EntryPoint2.

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.