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
• acionadores de fila, hora e evento
• outros processos
• Catálogos de Ações
• Conexões
• regras empresariais

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:

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

   
   

   

   
   

Configurando gatilhos de eventos conectados

1. No contexto da pasta, navegue até Automações, selecione Processos e, em seguida, Adicionar processo.
2. Selecione o pacote que contém a atividade do acionador de evento.
3. Selecione o ponto de entrada e insira os argumentos de runtime necessários e, em seguida, selecione Avançar.
4. A página Requisitos de pacotes exibe a conexão de eventos identificada no pacote.Selecione ou adicione uma conexão. Para obter detalhes, consulte Configurando conexões.
5. O gatilho de eventos aparece na conexão correspondente e tem o status Criação pendente. Para editar o gatilho de evento, selecionar o ícone de lápis. A página Editar gatilho de eventos é aberta.
   Observação: essa etapa é opcional. Se você pular, as seleções padrão se aplicam.
6. Insira um nome exclusivo para o seu gatilho no campo Nome. Se o nome do gatilho já existir, você recebe uma mensagem de erro e deve alterar o nome.
7. No menu suspenso Prioridade de trabalho, selecione a prioridade do trabalho.O valor padrão é Herdado, significando que a prioridade do trabalho é a mesma que foi definida para o processo selecionado.
8. No menu suspenso Tipo de runtime, selecione o runtime para executar os trabalhos que o gatilho inicia. Se você quiser usar um runtime unattended, recomendamos não definir a conexão como Configurável pelos usuários.
9. Na seção Destino de execução, para selecionar uma estratégia de encerramento de trabalhos, habilite a opção Agendar término da execução de trabalhos.
   Observação:

   A quantidade de tempo que você especifica decorre de acordo com as especificações, mesmo que o trabalho esteja em fila. Por exemplo, se você agendar um trabalho para ser executado às 13h e o definir para parar após 20 minutos, o trabalho será interrompido às 13h20, mesmo que tenha estado em uma fila até as 13h15 e depois tenha sido iniciado.

   Além disso, se você optar por interromper um trabalho pendente ou em execução após duas horas e encerrar o mesmo trabalho após três horas, o trabalho será encerrado após cinco horas. Isso acontece porque, primeiro, o Orchestrator recebe o sinal de que o trabalho foi interrompido após duas horas. Ao receber o sinal, o Orchestrator faz com que a ação de encerramento ocorra em três horas, resultando em um total de cinco horas.

   Você tem as seguintes opções:

   • Selecione Interromper no menu suspenso: essa opção inicia uma tentativa de encerrar de forma suave a execução do trabalho quando o trabalho esteve em um estado pendente ou em execução pelo tempo que você definir. Você pode definir um intervalo mínimo de um minuto e um intervalo máximo de 10 dias, 23 horas e 59 minutos.
   • Selecione Encerrar no menu suspenso: essa opção inicia uma tentativa de encerrar à força a execução do trabalho quando o trabalho esteve em um estado pendente ou em execução pelo tempo que você definir. Você pode definir um intervalo mínimo de um minuto e um intervalo máximo de 10 dias, 23 horas e 59 minutos.
   • Selecione Parar no menu suspenso e habilitar a opção Se o trabalho não parar, encerre-o. Essa opção inicia uma tentativa de encerrar de forma fluida a execução do trabalho quando o trabalho esteve em um estado pendente ou em execução pelo período que você definiu para a ação de interrupção.Se a tentativa resultar nos resultados do trabalho permanecendo em um estado de interrupção, o Orchestrator tenta encerrar o trabalho após o período que você definiu para a ação de encerramento.Você pode definir um intervalo mínimo de um minuto e um intervalo máximo de 10 dias, 23 horas e 59 minutos.
10. Para receber um alerta se um trabalho permaneceu em um estado pendente ou retomado por um determinado período, habilite o botão de alternância Gerar um alerta se o trabalho estiver preso no status pendente ou retomado e defina a duração aceitável para o trabalho permanecer em um estado pendente ou retomado.A duração mínima configurável é de um minuto e a duração máxima é de onze dias. Se o trabalho exceder a duração configurada, um pop-up de alerta de gravidade de erro aparece, com o seguinte texto: "N trabalhos para o #processo {process_number} estão pendentes ou retomados por mais de X horas e Y minutos", onde:
    • N é o número de trabalhos que dispararam o alerta.
    • {process_number} é o identificador do processo.
    • X é o número de horas configurado que o trabalho excedeu enquanto estava em um estado pendente ou retomado. Os dias são convertidos em horas.
    • Y é o número de minutos configurado que o trabalho excedeu enquanto estava em um estado pendente ou retomado.
11. Para receber um alerta se um trabalho não tiver sido concluído dentro de um intervalo definido, habilite o botão de alternância Gerar um alerta se o trabalho foi iniciado e não foi concluído e defina a duração aceitável para o trabalho ser concluído.A duração mínima configurável é de um minuto e a duração máxima é de onze dias. Se o trabalho exceder a duração configurada, um pop-up de alerta de gravidade de erro aparece, com o seguinte texto: "O trabalho para o #processo {process_number} está em execução há mais de X horas e Y minutos", onde:
    • {process_number} é o identificador do processo.
    • X é o número de horas configurado que o trabalho excedeu sem ser concluído. Os dias são convertidos em horas.
    • Y é o número de minutos configurado que o trabalho excedeu sem ser concluído.
12. Para manter o mesmo contexto conta-máquina configurado para iniciar o trabalho, selecione Manter a alocação de conta/máquina na retomada do trabalho. Selecionar essa opção otimiza sua licença e o uso de recursos.
13. Na seção Argumentos de runtime, selecione um ponto de entrada no menu suspenso e forneça valores apropriados para os argumentos de processo e, em seguida, selecione Atualizar para salvar a configuração do gatilho de eventos.
14. Para continuar a configurar o processo, selecione Avançar. Quando terminar, selecione Criar.

Observação:

A desabilitação de gatilhos baseada em execução aplica-se apenas a gatilhos de eventos publicados no Studio Web para espaços de trabalho pessoais.

Por padrão, os gatilhos são desabilitados após 5 execuções com falha consecutivas. Você pode atualizar a configuração editando as seguintes configurações de execução no nível do tenant:

• Gatilhos - Gatilhos conectados - Desabilitar quando houver falha na contagem na execução do trabalho

• Gatilhos - Gatilhos conectados - Período de tolerância quando a contagem continua falhando na execução do trabalho (dias)

Depois que o processo é criado, o gatilho de eventos aparece na grade Gatilhos de eventos, com o valor Conectado na coluna Tipo.

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.
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.
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. 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.
   Observação:

   Para fazer alterações na página Configurações do usuário do cliente, as seguintes permissões são necessárias:

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