Gerenciar processos

Implantação de processos

Observação: você precisa de permissões de Exibir em Pacotes e Exibir e Criar em Processos para criar um processo.

1. Navegue até Automações > Processos na pasta onde deseja implantar o processo. A janela Processos é exibida.
2. Clique em Adicionar. A janela Adicionar Processo será exibida.
3. Selecione um pacote no menu suspenso Nome da origem do pacote ou clique na área de carregamento abaixo para carregar um novo pacote. A versão mais recente do pacote será selecionada automaticamente. Se o pacote tiver tags que ainda não foram aplicadas ao processo, uma janela de notificação Novas tags foram encontradas é exibida, informando você sobre o número de tags.
4. Na janela Novas tags foram encontradas, clique em Adicionar e continuar se quiser aplicar as tags do pacote ao processo ou clique em Não adicionar se não quiser aplicar as tags do pacote ao processo.
   
   

   

   
   
5. No menu suspenso Versão de Pacote, selecione a versão do pacote que você deseja usar. Se o pacote tiver argumentos de entrada e saída, eles serão exibidos na seção Argumentos de Runtime.
6. Selecione um ponto de entrada no menu suspenso Ponto de entrada. Por padrão, o .xaml definido como Studio principal é selecionado. A exibição dos argumentos é atualizada para exibir os argumentos no fluxo de trabalho selecionado. Saiba mais sobre argumentos de runtime.
   Observação:

   • Para pacotes publicados antes de Julho de 2020, o Orchestrator não pode determinar o ponto de entrada principal, portanto nenhum ponto de entrada é selecionado por padrão. Você precisa selecionar o ponto de entrada manualmente, a partir do menu suspenso.
   • Se o processo não suportar vários pontos de entrada, o Orchestrator exibe Default no menu suspenso Ponto de entrada e o campo será desabilitado.
7. Se o pacote tiver argumentos de entrada, você pode fornecer valores para eles na tabela de argumentos. Edite os argumentos clicando em Editar para a entrada correspondente.
8. Após a conclusão das alterações, clique em Avançar. A janela Requisitos do pacote será exibida.

   A aba Requisitos de pacote permite que você identifique objetos que foram usados no projeto do fluxo de trabalho subjacente e que são necessários para uma execução de trabalho bem-sucedida.

   Consulte Gerenciamento de requisitos de pacote para obter mais detalhes sobre como gerenciar requisitos de pacote.

9. Após lidar com os requisitos do pacote, clique em Avançar. A janela Configurações adicionais é exibida.
10. No campo Exibir Nome, adicione o nome a ser exibido em todas as páginas que mencionam, listam ou monitoram processos. Se deixado vazio, o nome do pacote será usado.
11. Digite uma Descrição para o processo. Recomendamos adicionar uma descrição, especialmente quando há muitos processos implantados no Orchestrator.
12. Na seção Tags, gerencie as tags do processo. Você pode ver as tags herdadas do pacote subjacente, caso haja alguma, e também adicionar novas tags ou remover as existentes, contanto que tenha as permissões necessárias. Consulte Organizando recursos com tags para obter mais detalhes.
13. Na seção Política de retenção, crie uma regra para quando um trabalho associado a esse processo for excluído. Consulte Política de retenção de dados do processo para obter detalhes.
14. No menu suspenso Prioridade de Trabalho, selecione a prioridade de execução do processo.
15. Ative a opção Ocultar processo para usuários Attended se desejar que esse processo seja retido do UiPath Assistant. Quando habilitado, a opção O processo não pode ser interrompido no UiPath Assistant fica inativa.
    Observação:

    Isso funciona apenas com as versões Assistant e UiPath Robot 2023.10+.

16. Ative a opção Processo não pode ser interrompido a partir do UiPath Assistant para restringir a interrupção do processo a partir do UiPath Assistant.
17. Ative a opção Iniciar Processo Automaticamente para definir esse processo para ser iniciado automaticamente quando o agente do robô for iniciado.
18. Ative a opção Gravação de Trabalho para que, caso ocorra uma falha de trabalho, a execução seja gravada e esteja disponível para download como mídia de execução.
    Observação:

    Se você não vir a opção Habilitar gravação:

    • Você atualizou recentemente para o licenciamento do Enterprise ou do Enterprise Trial; aguarde alguns dias para a migração, após esse período, a opção ficará disponível.
    • Certifique-se de que você tenha a permissão Mídia de execução - Visualização atribuída à sua conta.

    Configure as opções Dimensionamento, Frequência e Duração conforme necessário.

    Campo	Description
    Escala	Permite que você defina a escala das capturas de tela em percentual. O valor máximo é 100. Por padrão, este campo é definido em 100.
    Frequência	Permite que você configure o intervalo de tempo entre a capturas de tela, em milissegundos. O valor mínimo é 250. Por padrão, este campo é definido em 500.
    Duration	Permite que você configure o período de tempo antes da falha para iniciar a gravação, em segundos. O valor máximo é 120. Por padrão, esse campo é definido em 40.

19. (Opcional, disponível apenas para processos multiplataforma) Se você quiser executar esse processo usando o Cloud Robot - Serverless, selecione uma opção de tamanho de máquina a ser usada:

    Opção	Detalhes	Consumo de Robot Units (RU)
    Automático	Configuração padrão. Seleciona o tamanho da máquina ideal com base em dependências de processos de alto nível.	Depende do tamanho da máquina
    Pequeno	1 GB (~0.5 CPUs) Para a maioria dos processos autônomos.	1 RU/minuto
    Padrão	2 GB (~1 CPU) Para processos Unattended que usam a Automação de Interface Gráfica.	2 RUs/minuto
    Médio	4 GB (~2 CPUs) Para processos Unatended um pouco mais complexos, como a depuração remota.	4 RUs/minuto
    Grande	10 GB (~6 CPUs) Para processos pesados, como aqueles que incluem atividades.	10 RUs/minuto

    Importante: se o tamanho da máquina selecionado for pequeno demais, seu processo atingirá o tempo limite sem ser concluído, mas você ainda consumirá Robot Units para o tempo em que a máquina esteve operando.

Implantação de agentes

Observação: você precisa de permissões de Exibir em Pacotes e Exibir e Criar em Processos para criar um processo.

1. Navegue até Automações > Processos na pasta onde deseja implantar o processo. A janela Processos é exibida.
2. Clique em Adicionar. A janela Adicionar Processo será exibida.
3. Selecione um pacote no menu suspenso Nome da origem do pacote . Para exibir apenas pacotes de tipo de agente, use o filtro Tipos de filtro ao lado do menu suspenso e selecione Agente. Você também pode usar a área de upload para carregar um novo pacote. A versão mais recente do pacote será selecionada automaticamente.
4. Se o pacote tiver tags que ainda não foram aplicadas ao processo, uma janela de notificação Novas tags foram encontradas é exibida, informando você sobre o número de tags. Na janela Novas tags foram encontradas , selecione Adicionar e continuar se quiser aplicar as tags do pacote ao processo ou Não adicionar se não quiser aplicar as tags do pacote ao processo.
5. No menu suspenso Versão do Pacote, selecione a versão do pacote que deseja usar.
6. Se o pacote tiver argumentos de entrada e saída, eles serão exibidos na seção Argumentos de Runtime , nas abas Entrada e Saída . Edite os argumentos conforme necessário.
   Para alternar entre os argumentos e uma exibição do esquema JSON subjacente, selecione esquema JSON.
   

   

   
   
7. Quando as alterações forem concluídas, clique em Avançar. A página Requisitos do pacote será exibida.

   A página Requisitos dos pacotes permite que você identifique os recursos usados no projeto dos fluxos de trabalho subjacentes, que são necessários para uma execução de trabalho bem-sucedida.

   Observe que os conceitos dos agentes mapeiam os requisitos dos pacotes do Orchestrator da seguinte maneira:

   Conceito dos agentes	Requisito do pacote do Orchestrator
   Escalonamento	Aplicativo
   Ferramenta	Conexão ou processo
   Context	Índice

   Para alterar a associação padrão para qualquer um dos recursos incluídos nos requisitos do pacote, use o botão Substituir correspondente. A funcionalidade permite que você selecione recursos nas pastas, para os seguintes tipos de recursos:

   • Processo
   • Índice
   • Bucket
   • Fila
   • Aplicativo
   • Regra de Negócios

   Para obter informações gerais sobre como gerenciar os requisitos dos pacotes, consulte Gerenciamento dos requisitos dos pacotes.

8. Após configurar os requisitos do pacote, clique em Avançar. A janela Configurações adicionais é exibida.
9. No campo Exibir Nome, adicione o nome a ser exibido em todas as páginas que mencionam, listam ou monitoram processos. Se deixado vazio, o nome do pacote será usado.
10. Digite uma Descrição para o processo. Recomendamos adicionar uma descrição, especialmente quando há muitos processos implantados no Orchestrator.
11. Na seção Tags, gerencie as tags do processo. Você pode ver as tags herdadas do pacote subjacente, caso haja alguma, e também adicionar novas tags ou remover as existentes, contanto que tenha as permissões necessárias. Consulte Organizando recursos com tags para obter mais detalhes.
12. Na seção Política de retenção , defina políticas para exclusão e arquivamento de trabalhos concluídos e não concluídos associados ao processo. Consulte Política de retenção de dados do processo para obter detalhes.
13. Na seção Opções de Execução , habilite o botão de alternância Memória do Agente para permitir que o agente retenha informações, aprenda com interações anteriores e aplique o conhecimento adquirido em tarefas futuras.
    Observação: desabilitar a alternância quando você editar posteriormente o agente não limpará a memória do agente. Se você reabilitar a alternância em uma data posterior, a memória do agente adquirida antes de você desabilitá-la ficará disponível novamente.

Implantação de processos de agentes

Observação:

• Você precisa de permissões Exibir em Pacotes e Exibir e Criar em Processos para criar um processo.
• Antes de você implantar um processo de agente em uma pasta, recomendamos que você implante todas as dependências desse processo na mesma pasta.

1. Navegue até Automações > Processos na pasta onde deseja implantar o processo. A janela Processos é exibida.
2. Clique em Adicionar. A janela Adicionar Processo será exibida.
3. Selecione um pacote no menu suspenso Nome da origem do pacote . Para exibir apenas os pacotes de processos com agentes, use o filtro Tipos de filtro ao lado do menu suspenso e selecione Processo com agentes. Você também pode usar a área de upload para carregar um novo pacote. A versão mais recente do pacote será selecionada automaticamente.
4. Se o pacote tiver tags que ainda não foram aplicadas ao processo, uma janela de notificação Novas tags foram encontradas é exibida, informando você sobre o número de tags. Na janela Novas tags foram encontradas , selecione Adicionar e continuar se quiser aplicar as tags do pacote ao processo ou Não adicionar se não quiser aplicar as tags do pacote ao processo.
5. No menu suspenso Versão do Pacote, selecione a versão do pacote que deseja usar.
6. Na seção Argumentos de Runtime , selecione um ponto de entrada no menu suspenso. Para obter mais informações, consulte Pontos de entrada.
7. Se o pacote tiver argumentos de entrada e saída, eles serão exibidos na seção Argumentos de Runtime , nas abas Entrada e Saída . Edite os argumentos conforme necessário.
   Para alternar entre os argumentos e uma exibição do esquema JSON subjacente, selecione esquema JSON.
   

   

   
   
8. Após a conclusão das alterações, clique em Avançar. A janela Requisitos do pacote será exibida.

   A aba Requisitos de pacote permite que você identifique objetos que foram usados no projeto do fluxo de trabalho subjacente e que são necessários para uma execução de trabalho bem-sucedida.

   Para obter informações gerais sobre como gerenciar os requisitos de pacotes, consulte Como gerenciar os requisitos dos pacotes.

9. Após lidar com os requisitos do pacote, clique em Avançar. A janela Configurações adicionais é exibida.
10. No campo Exibir Nome, adicione o nome a ser exibido em todas as páginas que mencionam, listam ou monitoram processos. Se deixado vazio, o nome do pacote será usado.
11. Digite uma Descrição para o processo. Recomendamos adicionar uma descrição, especialmente quando há muitos processos implantados no Orchestrator.
12. Na seção Tags, gerencie as tags do processo. Você pode ver as tags herdadas do pacote subjacente, caso haja alguma, e também adicionar novas tags ou remover as existentes, contanto que tenha as permissões necessárias. Consulte Organizando recursos com tags para obter mais detalhes.
13. Na seção Política de retenção , defina políticas para exclusão e arquivamento de trabalhos concluídos e não concluídos associados ao processo. Consulte Política de retenção de dados do processo para obter detalhes.
14. Ative a opção Ocultar processo para usuários Attended se desejar que esse processo seja retido do UiPath Assistant. Quando essa opção é habilitada, a opção O processo não pode ser interrompido no UiPath Assistant fica inativa.
    Observação:

    Isso funciona apenas com as versões Assistant e UiPath Robot 2023.10+.

15. Ative a opção Processo não pode ser interrompido a partir do UiPath Assistant para restringir a interrupção do processo a partir do UiPath Assistant.
16. Ative a opção Iniciar Processo Automaticamente para definir esse processo para ser iniciado automaticamente quando o agente do robô for iniciado.

Editar configurações de processo

O nome da exibição, descrição, prioridade do trabalho, além das opções Habilitar Gravação, Iniciar Processo Automaticamente, Processo não pode ser interrompido a partir do UiPath Assistant podem ser alteradas após implantar um processo na janela Configurações do Processo.

1. Para o processo desejado, clique em Mais Ações > Configurações de Processo. A janela Configurações de Processo é exibida.
2. Altere a opção desejada e clique em Atualizar para salvar as alterações.
   Observação:

   • Por padrão, qualquer processo pode ser editado enquanto tiver trabalhos em execução ou pendentes associados. Leve em consideração o seguinte:
   • A execução de trabalhos associados a um processo modificado usa a versão inicial do processo.
   • Trabalhos recém-criados ou novos gatilhos do mesmo trabalho usam a nova versão.

   • Trabalhos pendentes associados a um processo modificado usam a versão atualizada.

     • O filtro Processo na página Automações > Logs pesquisa pelo nome mais recente dado ao processo. Logs gravados com nomes de processo antigos não podem mais ser filtrados.

Gerenciamento de versões de pacotes

Importante:

• Ao publicar um pacote pela primeira vez, o ponto de entrada principal definido no Studio também é definido como o ponto de entrada atual no Orchestrator.
• Após a publicação de uma nova versão do pacote, o ponto de entrada atual é preservado, desde que exista a nova versão, caso contrário, ele é padronizado para o ponto de entrada principal definido no Studio.
• Alterar para uma versão do pacote que não tem o ponto de entrada inicial será padronizado para o ponto de entrada principal definido no Studio. O ponto de entrada atual é mantido após a atualização se ele também existir na nova versão.
• A atualização de um processo carregando um pacote de um feed externo é possível por meio do ponto de extremidade /odata/Processes/UiPath.Server.Configuration.OData.SetArguments . É sua responsabilidade garantir que os argumentos do processo sejam iguais aos argumentos do novo pacote, pois o Orchestrator não executa nenhuma validação em pacotes de feeds externos.

O gerenciamento de versões de pacotes para um processo requer as permissões de Exibir e Editar em Processos, e as permissões de Exibir em Pacotes/Pacotes de Pasta.

Atualizando um Processo em uma Pasta

Se um processo tiver várias versões disponíveis, você poderá selecionar qual delas será usada a partir do menu suspenso Versão do Pacote ao criar ou editar um processo.

1. Clique em Mais ações > Editar. A janela Editar Processo é exibida.
2. No menu suspenso Versões de Pacote, selecione a versão específica que você deseja usar ou clique em Reverter para retornar para a versão usada anteriormente.
   
   

   

   
   

Para atualizar um processo para a versão mais recente facilmente sem acessar a janela Editar Processo, siga as etapas seguintes:

1. Clique em Mais ações > Atualizar para a versão mais recente para o processo desejado. O botão Atualizar para a versão mais recente é apenas para leitura para processos que já estejam usando a versão mais recente do pacote.

2. Clique em Confirmar na janela de confirmação exibida. Os processos selecionados são atualizados para a versão mais recente e os ícones serão atualizados de acordo. Se, por algum motivo, um processo não for atualizado, uma mensagem de erro será exibida.

   
   

   

   
   

Atualizando vários processos em uma pasta

Permite que você atualize vários processos em uma pasta para a versão mais recente disponível do pacote.

1. Na página Processos, selecione os processos que você deseja atualizar para a versão mais recente disponível do pacote.
2. Clique em Usar Mais Recente. O botão Usar Mais Recente será habilitado apenas se sua seleção tiver pelo menos um processo que não esteja usando a versão mais recente disponível do pacote. O botão estará desabilitado se sua seleção tiver processos que usem a versão mais recente disponível do pacote.
3. Clique em Confirmar na janela de confirmação exibida. Os processos selecionados são atualizados para a versão mais recente e os ícones serão atualizados de acordo. Se, por algum motivo, um processo não for atualizado, uma mensagem de erro será exibida.
   
   

   

   
   

Atualizando processos entre pastas

A atualização de processos em várias pastas/subpastas simultaneamente pode ser executada no nível do pacote. O Orchestrator pesquisa e exibe todos os processos associados aos pacotes selecionados, permitindo que você selecione qual deles deve ser atualizado para a versão mais recente disponível do pacote. A pesquisa será executada para cada feed, da seguinte maneira:

• Feed do tenant - O Orchestrator pesquisa todos os processos associados aos pacotes selecionados em todas as pastas/subpastas que usam o feed do tenant. Encontre-o na página Pacotes (contexto do Tenant > guia Pacotes)

• Feed de pasta - O Orchestrator pesquisa todos os processos associados aos pacotes selecionados nesse feed de pasta específico, inclusive subpastas. Encontre-o na página Pacotes de pastas (contexto da Pasta > guia Automações > guia Pacotes de pastas)

O processo de atualização é semelhante no nível de feed de tenant e no nível de feed de pasta. De acordo com o contexto no qual você estiver, navegue até o local descrito acima e depois:

1. Selecione os pacotes para atualização e clique em Atualizar processos disponíveis para versões mais recentes. A janela Atualizar vários processos será aberta exibindo uma lista com todos os processos que não estejam usando a versão mais recente de um pacote. As seguintes informações serão exibidas na janela Atualizar vários processos:
   1. O nome do pacote
   2. A versão mais recente do pacote
   3. O número de processos que não estão usando a versão mais recente do pacote
   4. Os nomes dos processos juntamente com a versão atual do pacote e o caminho da pasta/subpasta na qual eles residem.
   Upgrade de processos que usam pacotes que residem em um feed de pasta:
   

   

   
   

   Upgrade de processos que usam pacotes que residem no feed do tenant:
   

   

   
   
2. Para cada pacote, selecione os processos que você deseja atualizar. Quando terminar, clique em Atualizar. Os processos selecionados são atualizados em massa com a versão mais recente dos seus pacotes.

Gerenciando o Valor dos Argumentos de Entrada

Se um processo tiver um ou mais argumentos de entrada, você poderá editar seus valores no nível do processo:

1. Selecione Mais ações e, em seguida, Editar para um processo. A janela Editar Processo é exibida.
2. Na seção Argumentos de Runtime , em Entrada, insira os valores apropriados para os argumentos.
3. Repita o Passo 2 quantas vezes for necessário.
4. Selecione Atualizar. Os valores de todos os argumentos de entrada são salvos. Para obter mais informações sobre como inserir os valores, consulte Sobre argumentos de entrada e saída.

Monitorar um processo

Clique no botão Mais Ações > Monitorar Processo do processo desejado para ver a página Monitoramento associado a ele. Devido ao botão Monitorar Processo ser exibido na página Processos, você também precisa de Exibir em Processos para acessar a página de monitoramento a partir daqui.

Alternativamente, selecione-o no widget Visão Geral de Processos (Monitoramento > Trabalhos).

Observe que o monitoramento de um processo requer que seu usuário tenha permissões de Exibir em Trabalhos e em Monitoramento. Além disso, é necessário Editar no Monitoramento para desabilitar erros do Feed de erros na página Monitoramento > Trabalhos. Exibir em Ambientes é necessário para filtrar as páginas por ambiente.

Como adicionar tags aos processos

Observação:

Você precisa da permissão de Editar em Processos e Exibir em Tags para adicionar tags existentes aos processos.

Você precisa da permissão de Editar em Processos e Criar em Tags para adicionar novas tags aos processos. Se você não tiver a permissão de Criar em Tags, o Orchestrator permitirá adicionar novas tags mas não será possível salvá-las.

Observação:

• Cada processo pode ter no máximo um milhão de pares de chave/valor.
• Rótulos e propriedades de chave/valor tem um limite de 256 caracteres.
• Nomes de tags não podem conter estes caracteres: <, >, %, &, \, ?, /, :

É possível aplicar tags em um processo no momento de sua criação ou ao editar um já existente. Para adicionar tags a um processo ao editá-lo, siga estas etapas:

1. Na página Processos, clique em Mais ações > Editar ao lado do processo desejado. O processo será aberto para edição.
2. No campo Rótulos, comece a digitar o nome do rótulo. Você pode escolher um rótulo existente ou criar um novo.
3. No campo Propriedades (pares de chave-valor), clique em Adicionar novo.
4. Adicione novas chaves e valores. Você pode escolher chaves e/ou valores existentes, ou pode criar novos.
5. Quando finalizar, clique em Atualizar. Seu processo será atualizado e as tags recém-criadas, caso haja alguma, ficarão disponíveis para outros objetos.

Como remover tags de processos

Para remover tags de um processo, siga estas etapas:

1. Na página Processos, clique em Mais ações > Editar ao lado do processo desejado. O processo será aberto para edição.
2. No campo Rótulos, clique no X ao lado do nome do rótulo para removê-lo. O rótulo será removido.
3. No campo Propriedades (pares de chave-valor), clique no X ao lado das chaves e/ou valores para removê-los. As chaves e/ou valores serão removidos.
4. Para excluir um par de chave/valor, clique no ícone Remover correspondente a essa entrada. O par chave/valor será removido.
5. Quando finalizar, clique em Atualizar. Seus processos serão atualizados e as tags serão removidas.

Remoção de processos

Observe que a remoção de um processo requer que seu usuário tenha permissões Exibir e Excluir em Processos, além de permissões Exibir em Pacotes. Leia mais sobre Funções.

1. Na página Processos, selecione os processos que lhe interessam.
2. Clique no botão Remover. O processo é excluído da página Processos e do banco de dados. Observe que excluir um processo não irá excluir o pacote do Orchestrator, mas apenas sua associação com o ambiente/pasta.

Como alternativa, se você deseja excluir apenas um processo, clique no botão Remover correspondente.

Se você remover um processo que tenha gatilhos associados a ele, estes também são removidos, independentemente de eles estarem habilitados ou desabilitados.

Nota: Você não pode remover um processo se ele estiver associado a um trabalho ativo (tem um dos seguintes status: Pendente,Em execução,Parando e Terminando).