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 gerenciados centralmente do Orchestrator usando pastas, que permitem 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:

• Armazenar buckets
• Ativos
• Filas
• outros processos
• Catálogos de Ações
• Conexões

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.” - o pacote carregado não tem nenhum requisito.

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

Status de requisitos de pacote

Estados gerais

• 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 vinculá-lo ou adicioná-lo na pasta correspondente do Orchestrator, desde que você 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.

• Filtros inválidos - os filtros de uma conexão não estão configurados.

Observação: o status desconhecido de um objeto não impede que o processo seja executado com sucesso.

Acionar status

Além dos status gerais, os gatilhos exibem os seguintes status:

• Criação pendente - a adição de um gatilho requer associá-lo a um processo existente. Enquanto o processo é criado, o gatilho reside na memória do Orchestrator e se torna ativo após a criação do processo. Você pode editar gatilhos na guia Requisitos dos pacotes enquanto eles têm esse status. Posteriormente, você tem a opção de editá-los na página Gatilhos.

• Configuração inválida - o runtime selecionado não está disponível.

• Nome duplicado - o nome do acionador é duplicado.

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ê tem a opção de adicioná-lo ou importá-lo na pasta atual, desde que você 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 para Criar no objeto específico e acesso à pasta à qual você quer adicionar o objeto.

1. Para adicionar um objeto ausente, clique no botão Adicionar correspondente. A página Criar [objeto] será aberta.
2. Configure o objeto conforme necessário.
   O campo Nome é preenchido previamente 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 para Visualizar e Criar no objeto específico e acesso tanto à pasta da qual você está importando e à pasta para a qual você está importando o objeto.

1. 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:
2. Se o objeto existir em outras pastas, ele aparece na aba Selecionar [objeto]. Selecione-o.
3. 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.

4. 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.
5. Remova as cópias de objeto associadas às pastas das quais você não precisa importar.
6. Clique em Vincular para importar o objeto para a pasta indicada na coluna Caminho de pasta.
7. 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 do 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 guia Requisitos dos pacotes, mas se o processo C estiver ausente, você mesmo precisará identificar isso e adicioná-lo manualmente.

Como adicionar 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 para Criar no objeto específico e acesso à pasta à qual você quer adicionar o objeto.

Continue com os seguintes passos:

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

Adicionando gatilhos de tempo e fila

A adição de um gatilho preenche previamente a página Criar gatilho com os valores definidos pelo RPA Developer na atividade Trigger associada, durante o período de design. Você pode editar esses valores enquanto o gatilho tiver o status Criação pendente ou, posteriormente, na página Editar gatilho. O status Criação pendente significa que o gatilho ficará armazenado em uma memória temporária até que o processo do qual ele necessita seja criado.

1. Vá para Automações > Processos e clique em Adicionar processo.
2. Selecione o pacote que contém a atividade do acionador de tempo.
3. Insira os argumentos de tempo de execução necessários e clique em Avançar.
4. A página de requisitos do pacote exibe o acionador de tempo com o status Ausente . Clique no botão Adicionar acionador para configurar o acionador de tempo.
5. Configure as propriedades do acionador conforme instruído na página Criando acionadores de tempo/Criando acionadores de fila . O status do acionador de tempo/fila muda para Criação pendente.
6. Clique em Avançar para continuar configurando o processo e clique em Criar.
   Depois que o processo é criado, o acionador de tempo/fila aparece na grade Acionadores de tempo/fila no Orchestrator.
   Adicionando filas da página de criação do acionador de fila

   Você tem a opção de adicionar uma fila durante a criação de um gatilho de fila ausente. Esteja ciente de que fazer isso impede você de adicionar SLAs à fila até que o gatilho seja criado.

   
   

   

   
   

Adicionando gatilhos de evento

1. Vá para Automações > Processos e clique em Adicionar processo.
2. Selecione o pacote que contém a atividade do acionador de evento.
3. Insira os argumentos de tempo de execução necessários e clique em Avançar.
4. A página Requisitos de pacotes exibe a conexão do evento identificado no pacote. Selecione uma conexão ou adicione uma nova. Consulte Configuração de conexões para obter mais detalhes.
5. O acionador do evento aparece na conexão correspondente, com o status de criação Pendente . Clique no ícone de lápis para editar o acionador do evento.
   A página Editar acionador de evento é aberta. Esta etapa é opcional. As seleções padrão se aplicam se forem ignoradas.
6. Configure as propriedades do gatilho conforme instruído na página Criação de um gatilho de evento.
   

Depois que o processo é criado, o gatilho de evento aparece na grade Gatilhos de eventos no Orchestrator e na lista Gatilhos no Integration Service.

Configuração de conexões

Observação: essa funcionalidade está disponível apenas em espaços de trabalho pessoais.

O Orchestrator permite especificar a conta usada em uma conexão ao criar um processo ou editar um já existente.

Como administrador, você pode configurar a conexão para seus usuários em seu próprio espaço de trabalho pessoal, desde que tenha o seguinte conjunto de permissões:

• Exibir permissões em Conexões

• Exibir, editar permissões em espaços de trabalho pessoais

• Exibir, editar permissões em substituições de recursos

1. Acesse Automações > Processos em seu espaço de trabalho pessoal. A página Processos será exibida.
2. Clique em Mais ações > Editar ao lado de um processo para editá-lo. A janela Editar processo será exibida.
3. Na aba Configuração de processo, configure os detalhes gerais do processo conforme necessário.
4. Acesse a guia Requisitos de Pacotes para ver os objetos usados pelo projeto de automação subjacente. Aqui você deve ver todas as conexões que foram adicionadas no projeto de automação em tempo de design. Uma conexão agrupa todas as atividades que foram configuradas para utilizá-la. Uma das seguintes opções é exibida:
   Figura 1.

   Opção de conexão	Comportamento	Observações
   Uma conexão existente	A atividade é executada para a conexão compartilhada selecionada.	As conexões disponíveis são organizadas em suas pastas de contêiner.
   Configurável pelos usuários	Permite que os usuários selecionem sua própria conexão em tempo de execução no UiPath Assistant.	Não selecione esta opção para tempos de execução não assistidos.
   Sem permissões ou conexão ausente	Verifique as permissões de exibição na pasta que contém a conexão necessária.	Você pode adicionar conexões ausentes na pasta atual clicando no ícone de engrenagem > Adicionar conexão. Clicar no ícone de engrenagem > Gerenciar conexões redireciona você para a interface do Integration Service, onde você pode criar novos conectores e conexões.

5. Clique no botão de roda dentada para gerenciar suas conexões ou adicionar novas por meio do Integration Service.
   
   

   

   
   

   A opção Configurável pelos usuários

   A opção Configurável pelos usuários é exibida por padrão nas seguintes situações:

   • O pacote é publicado em um espaço de trabalho pessoal

   • A conexão não é compartilhada (ela reside em uma pasta que você não pode acessar)

   • A conexão não existe

   • Permissões insuficientes

   Se você definir manualmente a opção Configurável pelos usuários , permitirá que seus usuários selecionem sua própria conexão em tempo de execução, no UiPath Assistant.

   Filtros de atividades do Integration Service

   Uma atividade do Integration Service pode conter filtros. Os valores do filtro dependem da conexão usada e podem ser substituídos no runtime no UiPath Assistant. Somente as atividades com filtros que podem ser substituídos são exibidas como requisitos de pacote. Se a conexão for definida como Configurável pelos usuários, nenhum filtro será exibido.

   Observação:

   Alterar uma conexão existente para Configurável pelos usuários redefine os filtros de atividade. Desta forma, os usuários podem configurar seus próprios filtros.

   Usar outra conexão que não a existente redefine os filtros de atividade. Dessa forma, você pode definir novos filtros para a nova conexão.

   Para executar automações autônomas, uma conexão para uma conta de serviço deve ser definida. Você não deve definir a opção Configurável por usuários .

Personalização das configurações do usuário

Quando um gatilho de evento tiver a opção Configurável pelos usuários selecionada, seus usuários poderão definir suas próprias conexões no runtime, no UiPath Assistant.

A página Configurações personalizadas do usuário lista as configurações de gatilhos de eventos definidas por seus usuários.

Como administrador de pastas, você pode substituir as configurações existentes dos usuários ou adicionar novas no processo ou no nível do gatilho.

Exploração do espaço de trabalho pessoal de um usuário

• Definir uma configuração para seus usuários implica explorar o espaço de trabalho pessoal do usuário selecionado.

• Para adicionar conexões em nome de seus usuários, você precisa ver as conexões pessoais deles, que residem na pasta Espaço de trabalho pessoal deles.

• Os usuários recebem um alerta sempre que você começar ou terminar de explorar o espaço de trabalho pessoal deles.

Status de configurações dos usuários

Esses status ajudam você a identificar quais usuários têm uma configuração defeituosa:

Configurada - o usuário tem uma configuração em funcionamento.

Parcialmente configurada - o usuário tem uma configuração defeituosa, o que pode implicar conexões ausentes.

Acesso à página Configurações personalizadas do usuário

Você pode acessar a página Configurações personalizadas do usuário a partir das páginas Processos e Gatilhos de eventos.

1. Na pasta selecionada, acesse:

   Opção	Description
   Automações > Gatilhos > Gatilhos de eventos	Uma lista de todos os gatilhos de eventos disponíveis é exibida.
   Automações > Processos	Uma lista de todos os processos disponíveis é exibida.

2. Para o gatilho do processo/evento desejado, clique no botão Mais ações e, em seguida, selecione Configurações personalizadas do usuário. Isso redireciona você para a página Configurações personalizadas do usuário.

Adição de uma nova configuração de e-mail

1. Para o gatilho do processo ou evento desejado, acesse a página Configurações do usuário do cliente.
2. Na seção Configurações de requisitos de pacote por conta de usuário, clique em Adicionar configuração de usuário. O assistente Configurar requisitos do processo para a conta do usuário é aberto.
   Observação:

   • No nível do gatilho do evento, essa operação requer permissões para Editar nas Substituições de recursos e Visualizar nos Gatilhos.

   • No nível do processo, essa operação requer permissões para Editar nas Substituições de recursos, Visualizar e Editar nos Processos.

3. No menu suspenso Conta do usuário, selecione o usuário para o qual você deseja configurar o gatilho do processo ou evento e, em seguida, clique em Adicionar usuário.
   Observação:

   • O usuário selecionado deve estar na mesma pasta do gatilho do processo/evento. Caso contrário, será solicitado que você atribua o usuário na pasta.

   • Se, enquanto isso, você remover usuários da pasta, a configuração do usuário deles continuará a aparecer na lista.

   • Uma mensagem pop-up informa a você sobre a necessidade de explorar o espaço de trabalho pessoal do usuário selecionado.

4. Forneça os detalhes necessários, como conexões ou filtros de atividades.
5. Salvar a configuração.

Substituição de uma configuração de usuário existente

1. Para o gatilho do processo ou evento desejado, acesse a página Configurações do usuário do cliente.
2. Para a conta de usuário desejada, clique em Editar configuração.
   Observação:

   • No nível do gatilho do evento, essa operação requer permissões para Editar nas Substituições de recursos e Visualizar nos Gatilhos.

   • No nível do processo, essa operação requer permissões para Editar nas Substituições de recursos, Visualizar e Editar nos Processos.

3. Modifique os detalhes necessários, como conexões ou filtros de dados.
4. Atualize a configuração clicando em Salvar.

   No UiPath Assistant, os usuários com permissões de Substituição de recursos adequadas sempre podem atualizar as definições que você configurou.

Remoção da configuração de gatilho de evento de um usuário

Para remover as configurações de gatilhos de eventos de seus usuários:

1. Para o gatilho do processo ou evento desejado, acesse a página Configurações do usuário do cliente.
2. Para a conta de usuário desejada, clique em Apagar configuração.
   Observação:

   • No nível do gatilho do evento, essa operação requer permissões para Editar nas Substituições de recursos e Visualizar nos Gatilhos.

   • No nível do processo, essa operação requer permissões para Editar nas Substituições de recursos, Visualizar e Editar nos Processos.

   • Essa operação apaga as configurações do usuário selecionado. Se um usuário tiver suas configurações removidas, o processo pode não ser executado como esperado.