Gerenciamento de requisitos de pacote

Visão geral

Uma jornada de RPA começa no Studio, o reino dos fluxos de trabalho e atividades. Ao projetar fluxos de trabalho, os desenvolvedores podem usar vários objetos, que normalmente são gerenciados centralmente do Orchestrator usando pastas, permitindo, assim, que você mantenha um controle refinado sobre suas automações e objetos associados.

Esses objetos são essenciais para uma execução de processo bem-sucedida. A falta de qualquer um dos objetos indicados impede o processo de ser executado com sucesso.

A aba Requisitos de pacote permite que você identifique objetos ausentes e adicione-os manualmente no nível do processo. Isso ajuda na:

educação de usuários sobre dependências de processos,
redução da depuração manual de fluxos de trabalho,
identificação de objetos ausentes sem a necessidade de alternar entre a interface gráfica do Studio e a do Orchestrator.

Observação: essa funcionalidade é compatível com processos que foram criados usando a versão do Studio 2021.10 e posterior, em conjunto com pacotes de atividades versão 2021.10 e posterior.

Como funcionam os requisitos de pacote

Ao criar um processo, o Orchestrator inspeciona o pacote subjacente com todos os seus arquivos de componente .xaml e agrega seus objetos intrínsecos, tais como:

Dependendo de se os respectivos objetos forem detectados ou não, há dois comportamentos da aba de Requisitos de pacote:

A aba fica vermelha — o fluxo de trabalho tem algumas dependências que não estão presentes no Orchestrator e, portanto, é preciso adicioná-las.
A aba está vazia, exibindo que “Esta versão de pacote não contém requisitos.” — tão simples quanto parece, o pacote carregado não tem nenhum requisito. Siga adiante.

Observação: não detectamos automaticamente os requisitos para pacotes armazenados em feeds externos.

Status de requisitos de pacote

Há quatro tipos de status para requisitos de pacote:

Disponível — o objeto está presente no Orchestrator. Não é necessária nenhuma ação adicional.
Ausente — o objeto não está presente na pasta atual no Orchestrator. Você pode importá-lo ou adicioná-lo na pasta correspondente do Orchestrator, desde que tenha as permissões adequadas.
Pasta não encontrada — o objeto supostamente existe em uma pasta do Orchestrator que foi referenciada no Caminho de pasta de uma atividade, porém:
- a pasta não existe no Orchestrator. Você deve adicionar a pasta no Orchestrator, usar o mesmo nome que o indicado na coluna Caminho de pasta e atribuir usuários a ela.
- você não tem acesso a essa pasta. Você deve solicitar acesso à pasta do Orchestrator indicada na coluna Caminho de pasta.
Desconhecido — o nome do objeto não pôde ser determinado. Não há nenhuma ação disponível para ser executada. Há vários cenários que podem resultar em um status Desconhecido:
- o nome do objeto está definido como uma expressão que é avaliada no runtime;
- você não tem as permissões corretas definidas para esse tipo de objeto;
- uma atividade de fluxo de trabalho referencia um item de fila, por exemplo, que não pode ser vinculado a essa fila.
  
  Observação: o status desconhecido de um objeto não impede que o processo seja executado com sucesso.

Permissões

Para gerenciar requisitos de pacote, você precisa das seguintes permissões:

Quero ...	Preciso de ...	O acesso de pasta de que preciso ...
... consultar os pacotes disponíveis	Permissões de Exibir em Pacotes (nível de tenant)	Não aplicável, pois as permissões de Pacotes são definidas no nível de tenant.
... carregar um pacote	Permissões de Criar em Pacotes (nível de tenant)	Não aplicável, pois as permissões de Pacotes são definidas no nível de tenant.
... consultar os objetos disponíveis	Permissões de Exibir num objeto específico	Obtenha acesso às pastas que contêm o objeto.
... adicionar um objeto	Permissões de Criar num tipo de objeto específico	Obtenha acesso às pastas às quais deseja adicionar o objeto.
... importar um objeto de uma pasta diferente	Permissões de Criar e Exibir num tipo de objeto específico	Obtenha acesso a: a(s) pasta(s) da(s) qual/quais você está importando e as pastas para as quais você está importando o objeto.

Gerenciamento de objetos ausentes

Para cada objeto ausente, exceto catálogos de ações e conexões, você pode adicioná-lo ou importá-lo na pasta atual, desde que tenha as permissões necessárias.

Observação: não é possível adicionar catálogos de ações e conexões a partir da guia Requisitos do pacote no Orchestrator, somente a partir do Action Center e do Integration Service, respectivamente.

Como adicionar um objeto ausente

Pré-requisitos: certifique-se de ter permissões de Criar no objeto específico e acesso à pasta à qual deseja adicionar o objeto.

Para adicionar um objeto ausente, clique no botão Adicionar correspondente. A página Criar [objeto] será aberta.
Configure o objeto conforme necessário.

Observação: o campo Nome já vem preenchido com o nome do objeto ausente e não pode ser editado. Essa restrição se aplica para respeitar o nome do objeto usado no fluxo de trabalho.

Como importar um objeto ausente

Se suspeitar que o objeto ausente exista no tenant atual, mas em uma pasta diferente, você pode importá-lo para a pasta atual.

Pré-requisitos: certifique-se de ter as permissões de Exibir e Criar no objeto específico, acesso a ambas as pastas das quais você está importando e acesso à pasta à qual você está importando.

Para importar um objeto de uma pasta diferente, clique no botão Importar correspondente. A página Vincular [objetos] de outras pastas será aberta, exibindo duas abas:
Se o objeto existir em outras pastas, ele aparece na aba Selecionar [objeto]. Selecione-o.
Clique em Continuar para navegar até a aba Validação de pasta.

Após selecionar o objeto, a aba Validação de pasta exibe as pastas de origem das quais você pode importar.
Se o objeto existir em várias pastas e você tiver selecionado todas as cópias na etapa anterior, você será solicitado a manter apenas uma pasta de origem.
Remova as cópias de objeto associadas às pastas das quais você não precisa importar.
Clique em Vincular para importar o objeto para a pasta indicada na coluna Caminho de pasta.
Após adicionar ou importar um objeto, você será redirecionado para a aba Requisitos de pacote para continuar adicionando ou importando objetos ausentes. Note que os status foram alterados para os objetos que foram adicionados ou importados.

Importante:

No caso de dependências de processos multicamada, o Orchestrator detecta e mostra apenas a dependência de primeiro nível para um determinado processo.

Por exemplo, o processo A precisa do processo B para ser iniciado, e o processo B precisa do processo C para ser iniciado. A hierarquia de dependências é A > B > C. Nesse caso, ao verificar os requisitos de pacote para o processo A, o Orchestrator detecta e exibe o primeiro nível de dependência para ele, ou seja, o processo B. Se o processo B estiver ausente, você pode adicioná-lo na aba Requisitos de pacote, mas se o processo C estiver ausente, você precisará identificar isso sozinho e adicioná-lo manualmente.

Adicionando objetos não orquestradores

Catálogos de Ações

O Orchestrator detecta os catálogos de ações necessários para executar o processo, mas não pode adicionar os que estejam faltando da aba Requisitos de pacote, pois os catálogos de ações são objetos configuráveis através do Action Center.

Pré-requisitos: certifique-se de ter permissões de Criar no objeto específico e acesso à pasta à qual deseja adicionar o objeto.

Continue com os seguintes passos:

Acesse a instância do Action Center correspondente.
Acesse a página Configurações de administrador.
Selecione a pasta do processo.
Clique em Adicionar novo catálogo. Certifique-se de usar o nome detectado como ausente na aba Requisitos de pacote.
Clique em Criar.

Conexões

O Orchestrator detecta as conexões necessárias para executar o processo, mas você não pode adicionar as que estejam faltando a partir da aba Requisitos de pacote, pois as conexões são objetos configuráveis via Integration Service.

Existem algumas maneiras de adicionar a conexão ausente:

Criando a conexão no Integration Service

Abra a guia Conectores.
Selecione o conector necessário. A página Conexões é aberta.
Clique em Adicionar conexão para configurar a conexão necessária.

Criando a conexão usando o UiPath Assistant

Abra o UiPath Assistant.
Na guia Início , selecione o processo que contém o requisito de conexão.
No painel do lado direito, a conexão necessária é exibida. Clique no menu de configurações.
Selecione Adicionar nova conexão. Isso redireciona você para o Integration Service.
Adicione a conexão ausente.