Excluir execuções de tarefas (tarefas de robôs) antigas automaticamente

Estão disponíveis três scripts Python/HCL que permitem automatizar o processo de excluir execuções de tarefas antigas no Robôs. Se você tem um ou mais robôs que são executados frequentemente, o número de execuções de tarefas salvas pode aumentar rapidamente. Para organizações que usam um Agente do Robôs local, o acúmulo de execuções de tarefas antigas com dados de resultados associados pode fazer seu servidor ficar sem espaço. Automatizar a exclusão de execuções de tarefas antigas elimina o trabalho da exclusão manual contínua, preserva espaço no servidor e mantém a interface do Robôs arrumada.

Requisito de conta do Diligent One

Os scripts pré-criados exigem um token de acesso da Diligent One como um dos parâmetros de entrada de script. Para excluir execuções de tarefas, a conta de usuário da Diligent One associada ao token precisa ter a função Proprietário ou Editor para o robô-alvo.

Para obter mais informações, consulte Criando e gerenciando tokens de acesso da Diligent One e Permissões do aplicativo Robôs.

Como funcionam os scripts de exclusão pré-criados

Você baixa um ou mais dos scripts de exclusão nos links fornecidos abaixo e, em seguida, carrega cada script no próprio robô HighBond dedicado. (Um script por robô.) No robô, você cria uma tarefa para configurar e agendar o script de exclusão. Parâmetros de script configuráveis permitem especificar quais execuções de tarefas devem ser excluídas.

Robôs de exclusão e robôs-alvo

Pense no robô que contém um script de exclusão como o robô de exclusão. A tarefa que você usa para configurar e programar o script de exclusão é a tarefa de exclusão. O robô de exclusão e a tarefa de exclusão são usados para excluir execuções de tarefas antigas em outro robô. Pense no outro robô como o robô-alvo. Se você restringir as exclusões para uma tarefa específica no robô-alvo, pense na tarefa como a tarefa-alvo.

Você pode criar quantos robôs de exclusão ou tarefas de exclusão precisar. O mais importante é entender que você configura um script de exclusão em um robô e o utiliza para excluir execuções de tarefas antigas em outro robô.

Os scripts de exclusão funcionam para qualquer tipo de robô

Apesar de serem escritos usando Python/HCL e de estarem contidos em robôs HighBond, você poderá usar os scripts de exclusão para excluir execuções de tarefas antigas de qualquer tipo de robô, incluindo robôs ACL. Não é necessário entender Python/HCL para usar os scripts de exclusão. Instruções passo a passo para configurar os scripts de exclusão são fornecidas abaixo.

Métodos da API do HighBond em HCL e a API do HighBond

Os scripts de exclusão usam métodos da API do HighBond em HCL e a API do HighBond para recuperar e excluir execuções de tarefas. Se você sabe Python/HCL, pode modificar o comportamento dos scripts de exclusão, se necessário. For more information, see Métodos do HCL para a API do HighBond and the HighBond API Reference.

Exclusão de dados de execução da tarefa

Se você excluir uma execução da tarefa, excluirá apenas os dados de resultados associados à execução:

• Tabelas de Resultados

• Arquivos de resultados

• Logs de resultados

As tabelas de dados do Analytics ou os arquivos de trabalho Python/HCL produzidos durante uma execução da tarefa não são excluídos. Essas tabelas e arquivos ficam preservados na guia Entrada/Saída (robôs ACL) ou na área Dados de trabalho (robôs HighBond ou de fluxo de trabalho). Se necessário, podem ser excluídos individualmente desses locais. Para obter mais informações, consulte Gerenciamento de dados de trabalho armazenados em um robô.

Excluir execuções de tarefas antigas automaticamente pela primeira vez

Tome cuidado ao excluir execuções de tarefas antigas pela primeira vez. Caso tenha um grande número de execuções de tarefas antigas, com grandes quantidades de dados de resultados associados, tentar excluir tudo de uma vez pode prejudicar o servidor. Use qualquer uma das estratégias descritas abaixo para excluir as execuções de tarefas antigas em lotes.

Descobrir a quantidade e o intervalo de datas de execuções de tarefas antigas

Use a exibição global das Execuções de tarefas para descobrir a quantidade e o intervalo de datas das execuções de tarefas antigas. Use essas informações ao decidir quais valores serão usados como parâmetros de entrada para scripts de exclusão.

Na exibição global Execuções de tarefas:

• Atualize o filtro Acionado(a) em para um período adequado. Inicialmente, o filtro usa os últimos 10 dias como padrão, criando um intervalo de datas que pode ser curto demais para suas necessidades.

• Use o filtro Nome do robô ou o filtro Nome da tarefa para isolar as execuções de tarefas para o robô-alvo ou a tarefa-alvo. O painel Execuções de tarefas por status exibe o número total de execuções de tarefas para o robô ou a tarefa.

• Na tabela Execuções de tarefas, ordene a coluna Concluída em para que a execução da tarefa mais antiga apareça no topo.

Para obter mais informações, consulte Exibir tarefas do robô e execuções de tarefas.

Executar a tarefa de exclusão manualmente

Não agende uma tarefa de exclusão inicialmente. Configure e execute a tarefa de modo manual para excluir execuções de tarefas antigas em lotes. Se você excluir execuções de tarefas manualmente em lotes, poderá dividir o processo de exclusão em segmentos de menor duração. Após excluir as antigas execuções de tarefas acumuladas, você poderá agendar para que a tarefa de exclusão seja executada automaticamente.

Excluir execuções de tarefas uma vez por mês

Caso esteja excluindo execuções de tarefas antigas com base na data, estabeleça a data da execução da tarefa inicial e configure uma data de exclusão um mês após a data inicial. Execute repetidamente a tarefa de exclusão de modo manual, avançando a data de exclusão em um mês a cada vez. Se excluir o equivalente a um mês de execuções de tarefas for relativamente rápido, tente excluir as execuções de tarefas em blocos de três ou seis meses.

Excluir 50 ou 100 execuções de tarefas por vez

Caso esteja excluindo execuções de tarefas antigas com base no número de execuções, estabeleça o total de execuções de tarefas e configure um número máximo de execuções de tarefas que tenha 50 ou 100 execuções a menos que o total. Execute repetidamente a tarefa de exclusão de modo manual, reduzindo o número máximo em 50 ou 100 por vez. Se excluir 50 ou 100 execuções de tarefas for relativamente rápido, tente excluir as execuções de tarefas em blocos maiores.

Excluir execuções de tarefas uma tarefa por vez

Caso tenha um ou mais robôs que contêm várias tarefas, exclua as execuções de tarefas uma tarefa por vez (não um robô inteiro por vez).

Configurar um script de exclusão

Siga este processo para configurar um script de exclusão e excluir execuções de tarefas antigas automaticamente:

1. Baixar um ou mais scripts de exclusão

2. Criar um robô de exclusão

3. Criar e agendar uma tarefa de exclusão no robô de exclusão

Localização da tarefa de exclusão

Você pode criar a tarefa de exclusão no modo de produção ou no modo de desenvolvimento. Os scripts de exclusão funcionam além dos limites que separam os dois modos. Portanto, você pode escolher localizar a tarefa e o script de exclusão em qualquer modo que ache adequado.

Se você criar a tarefa de exclusão no modo de produção, primeiro deverá ativar o script de exclusão do modo de desenvolvimento para o modo de produção. Para obter mais informações, consulte Ativar uma versão de script.

Dois dos scripts de exclusão excluem execuções de tarefas qualificadas do modo de produção e do modo de desenvolvimento:

• Robô HB: excluir trabalhos com mais de alguns dias de robot.json

• Robô HB: manter alguns dos trabalhos de robot.json

O terceiro script de exclusão exclui execuções de tarefas qualificadas do modo (produção ou desenvolvimento) em que a tarefa-alvo está localizada:

• Robô HB: excluir trabalhos com mais de alguns dias de task.json

No caso do terceiro script de exclusão, você não precisará localizar a tarefa de exclusão no mesmo modo que a tarefa-alvo. Porém, fazer isso pode ajudar a manter as tarefas de exclusão e as tarefas-alvo claramente organizadas.

Encontrar os identificadores únicos de robôs e tarefas

Todos os três scripts exigem o identificador único do robô-alvo como parâmetro de entrada. O script de exclusão no nível da tarefa também exige o identificador único da tarefa-alvo. No Robôs, navegue até o robô ou tarefa-alvo e recupere o identificador único da URL na barra de endereço do navegador.

Identificador único do robô

Na URL, o identificador único do robô segue imediatamente o segmento production ou development no caminho. Nos dois exemplos abaixo, o identificador único do robô é 63034.

https://vincicorp.robotics.highbond.com/production/63034/working-data

https://vincicorp.robotics.highbond.com/development/63034/task-runs

Identificador único da tarefa

Na URL, o identificador único da tarefa segue imediatamente o segmento tasks no caminho. Nos dois exemplos abaixo, o identificador único da tarefa é 57275 no primeiro exemplo e 54731 no segundo exemplo.

https://vincicorp.robotics.highbond.com/production/63034/tasks/57275

https://vincicorp.robotics.highbond.com/development/63034/tasks/54731

Baixar um ou mais scripts de exclusão

Baixe um ou mais dos scripts de exclusão vinculados abaixo. Escolha o script que mais combina com suas necessidades. Se necessário, você pode configurar vários scripts de exclusão com diferentes definições de configuração.

1. Clique com o botão direito em qualquer um dos links abaixo e selecione Salvar link como.

   Link do script	Descrição do script
   Robô HB: excluir trabalhos com mais de alguns dias de task.json	Exclui execuções de tarefas (trabalhos) anteriores a um número especificado de dias de uma tarefa. Exclui execuções de tarefas qualificadas do modo (produção ou desenvolvimento) em que a tarefa-alvo está localizada.
   Robô HB: excluir trabalhos com mais de alguns dias de robot.json	Exclui execuções de tarefas (trabalhos) anteriores a um número especificado de dias de todas as tarefas em um robô. Exclui execuções de tarefas qualificadas do modo de produção e do modo de desenvolvimento.
   Robô HB: manter alguns dos trabalhos de robot.json	Exclui execuções de tarefas (trabalhos) superiores a um número especificado de execuções de todas as tarefas em um robô. Começa com a execução da tarefa mais antiga. Exclui execuções de tarefas qualificadas do modo de produção e do modo de desenvolvimento.

2. Salve o script de exclusão na pasta Downloads ou em outra pasta no seu computador.

   O script de exclusão é baixado como um arquivo JSON (*.json).

Criar um robô de exclusão

Siga o processo padrão para criar um robô HighBond e carregar um único script de exclusão do seu computador no robô. Crie um robô HighBond adicional para cada script de exclusão adicional que você deseja usar.

Criar o robô

1. Na página inicial do Launchpad (www.highbond.com), selecione o aplicativo Robôs para abri-lo.

   Se já tiver entrado na Diligent One, você pode usar o menu de navegação à esquerda para mudar para o aplicativo Robôs.

2. No painel no Robôs, selecione a guia Robôs HighBond.
3. Se você quiser criar o robô em uma pasta, clique na pasta para abri-la.

   Para obter informações sobre como criar pastas, consulte Criação e gerenciamento de uma pasta de robôs.

4. Clique em Criar um robô HighBond.
5. Selecione um ícone e insira um nome para o robô.

   Dica

   Você pode usar ícones para organizar robôs em grupos facilmente identificáveis.

   Observação

   Não use símbolos de moeda em nenhum lugar no nome do robô, por exemplo: $, €.

6. Opcional. No campo Descrição, descreva o robô para que outros usuários entendam o que ele faz.
7. Clique em Criar um robô HighBond.

   O editor de scripts do Robôs aciona o processo de inicialização.

   Observação

   Se a mensagem Não é possível criar o robô aparecer, você precisa especificar outro nome para o robô. Já existe um robô com o mesmo nome.

   Se você não for um colaborador com permissões para o robô existente, o robô não estará visível para você.

8. No canto superior esquerdo do editor de scripts, clique no nome do robô e em Não confirmar.

   Você acessará a guia Versões de script do robô recém-criado no modo de desenvolvimento.

Carregar o script de exclusão

1. Na guia Versões de script no novo robô, clique em Carregar.

2. Na caixa de diálogo que aparece, selecione um script de exclusão do seu computador ou arraste-o para a área Script carregado.

   Cada script de exclusão está contido em um arquivo JSON (*.json).

3. Insira uma Mensagem de confirmação e clique em Carregar e confirmar.

   O script é adicionado como a versão mais recente na guia Versões de script. É exibida uma notificação que informa que o script foi confirmado.

   Também é exibida uma notificação em caso de falha no processo de carregar e confirmar. Tente fazer o upload novamente. Se o upload falhar outra vez, tente fazer o download de uma cópia nova do script de exclusão e carregue-a.

Criar e agendar uma tarefa de exclusão no robô de exclusão

Siga o processo padrão para criar e agendar uma tarefa do robô. Você pode criar a tarefa de exclusão no modo de produção ou no modo de desenvolvimento. Para obter mais informações, consulte Localização da tarefa de exclusão.

Escolher o modo para a tarefa de exclusão

Use os botões Produção e Desenvolvimento no canto superior direito do robô de exclusão para mudar para o modo que deseja usar.

Se você quiser criar a tarefa de exclusão no modo de produção, primeiro deverá ativar o script de exclusão do modo de desenvolvimento para o modo de produção. Para obter mais informações, consulte Ativar uma versão de script.

Criar uma tarefa e selecionar o script de exclusão

1. Na guia Tarefas, clique em Criar tarefa.

   O Designer de Tarefa abre e você pode começar a definir as configurações da tarefa.

2. Digite um nome para a tarefa e clique em Salvar.
3. Na página Selecione seus scripts, selecione Selecionar tudo.

   O script de exclusão é selecionado.

Inserir os valores dos parâmetros do script e um token de acesso da Diligent One

1. Clique na seta para baixo para expandir a seção de parâmetros e inserir os valores para o script.
2. Se quiser permitir que outros usuários executem, desativem ou ativem a tarefa de exclusão, clique em Compartilhar senhas.
   • Compartilhar senhas está ativo para qualquer usuário com acesso ao robô poderá executar, desativar ou ativar a tarefa
   • Compartilhar senhas está desativado, somente você pode executar, desabilitar ou habilitar a tarefa

   Independentemente da configuração, outros usuários com acesso ao robô podem editar a tarefa para inserir seus próprios tokens de acesso da Diligent One.

   Para obter mais informações, consulte Scripts com senhas.

3. Na parte inferior da página, clique em Continuar.

Agendar a tarefa

1. Na parte superior da página, selecione Colocar sua tarefa em um agendamento.
2. Especifique os detalhes da programação:
   • Frequência o intervalo em que a tarefa é executada repetidamente
   • Início às horário do início da execução da tarefa e o fuso horário a ser usado

     Use seu próprio fuso horário, a menos que deseje que a hora de início represente um fuso horário diferente.

   • Início em data de início da execução da tarefa
3. Na parte inferior da página, clique em Continuar.

Notificar os usuários se a tarefa não for executada

1. Selecione Enviar notificações de falha para notificar um ou mais usuários específicos se a tarefa não for executada.

   Se a opção estiver habilitada, uma notificação será enviada automaticamente caso a tarefa não seja executada por um destes motivos:

   • O script na tarefa falhou

   • A tarefa foi ignorada

   • A tarefa foi cancelada manualmente

2. Clique em um ou mais usuários na lista para selecioná-los.

   Somente usuários com permissões suficientes para o robô estão disponíveis para seleção.

3. Na parte inferior da página, clique em Continuar.

Revisar as configurações e finalizar a tarefa

1. Revise as configurações definidas para a tarefa.
2. Opcional. Para atualizar uma configuração, clique em e faça as alterações necessárias.
3. Quando estiver satisfeito com as configurações da tarefa, clique em Confirmar e criar tarefa.

   Resultado A tarefa é criada usando as configurações que você especificou. A tarefa começa a ser executada na primeira ocorrência agendada.