Agendar uma tarefa de notebook

Você pode criar tarefas para agendar a execução automatizada de um notebook. Cada vez que o notebook é executado de acordo com a programação que você definiu, o site abre um novo contêiner e executa o notebook sem que você precise abrir o notebook. Você pode ter no máximo 10 tarefas ativas em todos os seus notebooks.

No painel Tarefas no editor do notebook, você pode criar uma ou múltiplas tarefas agendadas para executar o notebook. Você pode agendá-lo para ser executado uma vez no futuro ou de forma recorrente—de uma vez a cada 15 minutos a uma vez a cada 6 meses.

Se você estiver preparando um notebook para execução automatizada, como de forma recorrente, considere o seguinte:

• A frequência máxima que uma tarefa agendada pode ser executada é a cada 15 minutos.
• Você pode criar apenas tarefas para itens do notebook de sua propriedade. Isso se aplica a todos os tipos de usuários, incluindo administradores.
• Os administradores podem visualizar e editar tarefas para todos os itens do notebook na organização.
• Se um notebook com tarefas agendadas for excluído ou enviado para a lixeira, as tarefas serão excluídas permanentemente e não poderão ser restauradas.

Preparar o notebook

Você pode configurar parâmetros de entrada e saída para um notebook. Os parâmetros de entrada correspondem a variáveis ​​de entrada em um notebook que você deseja externalizar para uma tarefa agendada. Quando uma tarefa agendada é executada, os parâmetros de entrada são inseridos no notebook na parte superior do notebook, semelhantes às variáveis ​​globais. Isso permite criar notebooks genéricos e modificar os valores das variáveis ​​de entrada em tempo de execução.

Os parâmetros da tarefa são injetados por padrão em uma célula no início de um notebook. Como alternativa, clique em Exibir > Ativar Paleta de Comandos no menu e, procura e abra Editar Metadados do Notebook, o que permite editar metadados de células e notebooks para criar uma tag para uma célula denominada injected-parameters. Os parâmetros da tarefa são inseridos na célula que segue a tag injected-parameters.

Considerações para conteúdo

Diferente da célula de parâmetros que ela pode inserir, o agendamento de um notebook não suporta interação de usuário com notebooks. Evite adicionar qualquer conteúdo que exija interação do usuário enquanto o notebook é executado, como clicar em um ponto do mapa.

Quaisquer credenciais ou novas variáveis ​​que você desejar adicionadas no momento de uma execução automatizada deverão ser inseridas na célula de parâmetros, conforme indicado acima. Certifique-se que o notebook não tenha nenhum conteúdo que impedirá o notebook de concluir.

Anotação:

Ao criar notebooks, use caminhos completos para diretórios e arquivos no diretório da área de trabalho.

Por exemplo, use /arcgis/home/test.gdb em vez de home/test.gdb.

Criar uma tarefa

Quando o notebook estiver pronto, você poderá criar uma tarefa para agendar sua execução. Com a utilização do painel Tarefas no editor do notebook, você pode criar uma ou múltiplas tarefas para automatizar a execução do notebook e especificar o horário da tarefa.

Para criar uma tarefa, complete as seguintes etapas:

1. Verifique se você está registrado com privilégios para criar e agendar notebooks.
2. Salve o notebook com um título, se você ainda não tiver feito isto.

   O botão Tarefas torna-se disponível na barra de formatação superior do editor do notebook.

3. Na barra de formatação superior do editor de notebook, clique em Tarefas.
4. Clique em Criar tarefa para abrir a caixa de diálogo.

   Anotação:

   Você também pode criar tarefas na guia Tarefas da página de itens do notebook.

5. Forneça um título na caixa de texto Título para descrever o horário da tarefa, como Execução da limpeza de dados semanal.
6. Se você não configurou parâmetros para o notebook e houver parâmetros que deseja adicionar ao notebook quando ele for executado pela tarefa, forneça-os na seção Parâmetros e clique em Adicionar para incluir o parâmetro no fluxo de trabalho.
7. Forneça uma chave na configuração Chave e seu valor pareado na configuração Valor para cada parâmetro.
8. Clique em Avançar.
9. Na página Definir detalhes do agendamento de tarefas, especifique o horário da tarefa.

   A programação especificada é armazenada com base no fuso horário local do seu navegador.

   Dica:

   Quando você muda o valor para Tipo de repetição, as opções abaixo mudam para ajustar a esta denominação. Por exemplo, se você selecionar Mês, uma caixa Dia do mês será exibida, permitindo que você especifique um dia do mês ou um intervalo de dias para a tarefa ser executada.

10. Opcionalmente, expanda a seção Avançado para fazer qualquer um dos seguintes:
    • Insira o número máximo de minutos que a tarefa pode ser executada.
    • Ative o botão de alternar Usar área de trabalho se o notebook que você deseja agendar ler ou criar arquivos no diretório da área de trabalho (/arcgis/home).

      Anotação:

      Com a botão de alternar Usar área de trabalho desativado para uma tarefa do notebook, você ainda pode gravar arquivos durante a execução da tarefa. No entanto, os arquivos gravados serão retidos apenas em um local temporário durante a execução e serão removidos quando a execução for concluída.

    • Se você adicionou parâmetros, ative o botão de alternar Salvar parâmetros no notebook para salvar a célula inserida com os novos parâmetros no notebook quando ele for executado.
    • Ative o botão de alternar Atualizar notebook ao concluir para atualizar o notebook com os resultados de cada execução.
11. Quando você estiver satisfeito com o título, parâmetros opcionais e horário da tarefa, clique em Criar Tarefa.

    A tarefa fica ativa e executa o notebook de acordo com o horário que você definiu.

Para vários agendamentos, você pode criar mais tarefas para o notebook usando o mesmo fluxo de trabalho. Você pode ter no máximo 10 tarefas ativas em todos os seus notebooks. Pause ou exclua tarefas ativas se você tiver 10 tarefas ativas e deseja agendar mais.

Trabalhar com tarefas existentes

Após você criar uma tarefa para um notebook, você poderá visualizar os detalhes da tarefa e editar ou exclui-la à qualquer momento. Você pode fazer alterações nas tarefas no painel Tarefas do editor do notebook ou da guia Tarefas da página de item do notebook. Em ambos os locais, você pode visualizar todas as tarefas do notebook com a hora em que cada tarefa foi criada, quando foi modificada pela última vez e seu status atual.

Para trabalhar com tarefas existentes, complete as seguintes etapas:

1. Verifique se você está registrado com privilégios para criar notebooks.
2. Na barra de formatação superior do editor de notebook, clique em Tarefas.
3. Na seção Tarefas Agendadas, encontre a tarefa com a qual deseja trabalhar.
4. Clique em Ações ao lado da tarefa e faça o seguinte:
   • Clique em Detalhes para visualizar os detalhes e o status de cada execução da tarefa. Para visualizar os resultados da execução, clique no botãoResultados . O status de uma tarefa pode ser um dos seguintes:
     • Bem sucedida—A tarefa foi concluída com sucesso.
     • Executando—A tarefa está executando atualmente.
     • Falhou—A tarefa falhou em executar com sucesso. Se uma tarefa falhar cinco vezes, será completamente parada.
     • Ignorada—A tarefa foi ignorada, pois uma execução anterior ainda estava em execução.
   • Clique em Editar para alterar o título, parâmetros ou horário da tarefa.
   • Clique em Pausar para pausar uma tarefa ativa e clique em Retomar para retomar a tarefa.
   • Clique em Excluir para remover a tarefa.

     Anotação:

     A exclusão de uma tarefa também exclui o histórico de execução da tarefa. Para preservar o histórico de uma tarefa ativa, considere pausar a tarefa para interromper outras execuções.

Alterar a propriedade de um notebook também altera a propriedade das tarefas desse notebook. As tarefas são transferidas para o novo usuário em um estado inativo. O novo proprietário pode ativar as tarefas no painel Tarefas do editor de notebook ou a partir da guia Tarefas da página de item do notebook.