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 necessários.

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
   -cou --createProcess	O valor padrão é true. Quando definido como true, ele cria um processo na pasta do Orchestrator que é passado no comando. 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.
   -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.
   -tou --token (obrigatório se você usar 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.
   -aou --accountName (obrigatório se você usar 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 (nome da organização). Você deve combiná-lo com a ID do aplicativo , Segredo do aplicativo e Escopo do aplicativo para um aplicativo externo
   -Iou --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.
   -Sou --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 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.
   --help	Exibe os parâmetros e exemplos para este comando.
   --version	Exibe informações da versão.
   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.

O uipclicria um processo com um ponto de defaultentrada 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.Idsão atualizados para a versão mais recente, independentemente de o processo ter sido criado manualmente ou a partir de um pipeline.

Uso:

package deploy <packages_path> <orchestrator_url> <orchestrator_tenant> [-u <orchestrator_user> -p <orchestrator_pass>] [-t <auth_token> -a <account_name>] [-A <account_for_app> -I <application_id> -S <application_secret> --applicationScope] [-o <folder_organization_unit>] [-c <create_process>] [-e <environment_list>] [-l <language>]

Exemplos:

• package deploy "C:\UiPath\Project 1" "https://uipath-orchestrator.myorg.com" default -u admin -p 123456

• package deploy "C:\UiPath\Project\Package.1.0.6820.22047.nupkg" "https://uipath-orchestrator.myorg.com" default -u admin -p 123456 -o OurOrganization

• 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\Package.1.0.6820.22047.nupkg" "https://uipath-orchestrator.myorg.com" default -t a7da29a2c93a717110a82 -a myAccount

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