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 cinco 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 é de 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, você pode clicar em Exibir > Ativar Paleta de Comandos no menu e procurar e abrir 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 injetados 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.

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 anteriormente 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. Forneça uma chave na configuração Chave e seu valor emparelhado na configuração Valor para cada parâmetro, e clique em Adicionar para salvar o parâmetro.
7. Clique em Avançar.
8. Na página Definir detalhes do agendamento de tarefas, especifique o horário da tarefa.

   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ê escolher Semana, as caixas de seleção aparecerão para cada dia da semana.

9. Se o notebook que você deseja agendar ler ou criar arquivos no diretório da área de trabalho (/arcgis/home), ative o botão de alternância Usar área de trabalho para montar o diretório para cada execução de tarefa. Se o notebook não exigir acesso ao diretório da área de trabalho, desative o botão de alternar.

   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.

10. Opcionalmente, expanda a seção Avançado para inserir o número máximo de minutos que a tarefa pode ser executada.
11. Na seção Avançado, um botão de alternância Salvar parâmetros no notebook aparecerá se você tiver adicionado parâmetros. Opcionalmente, você pode ativar isso para salvar a célula inserida com seus novos parâmetros no notebook quando ele for executado.
12. Na seção Avançado, ative o botão de alternância Atualizar notebook ao concluir se deseja atualizar o notebook com os resultados de cada execução.
13. Quando você estiver satisfeito com seu 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.

Se deseja ter vários agendamentos, você poderá criar mais tarefas para o notebook usando o mesmo fluxo de trabalho. Você pode ter no máximo cinco tarefas ativas em todos os seus notebooks. Pause ou exclua tarefas ativas se você já tiver cinco tarefas ativas e quiser 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 do 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.

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. Quando pausada, 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 do item do notebook.