A partir da versão 10.8.1, 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 controle do usuário.
A partir do painel Tarefas no editor do notebook, você pode criar uma ou múltiplas tarefas agendadas para executar o notebook. Você pode agendá-lo para executar uma vez no futuro, ou em uma base recorrente—uma vez por minuto para uma vez a cada cinco meses.
Se você estiver preparando um notebook para execução automatizada, como de forma recorrente, há algumas coisas a serem lembradas.
Prepare o notebook
O editor do notebook possui um recurso Parâmetros que permite 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 ou uma ferramenta da web. Quando uma tarefa agendada for executada, os parâmetros de entrada serã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.
Ao criar um notebook, externalize e configure variáveis usando o recurso Parâmetros. Consulte a seção Configurar parâmetros de entrada de Publicar um notebook como um tópico de ferramenta da web para obter informações sobre como configurar parâmetros de entrada para seu notebook.
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 usar a opção de célula Tags na barra de ferramentas, que permite criar e gerenciar tags para cada célula na área de trabalho do notebook, 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. Para habilitar tags, você pode alterar as opções da barra de ferramentas da célula clicando em Visualização, clicando em Barra de ferramentas da célula e clicando em Tags.
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.
- 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.
- Clique em Criar tarefa para abrir a caixa de diálogo.
Anotação:
Você também pode criar tarefas a partir da guia Tarefas da página de detalhes do item do notebook. - 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.
- 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.
Se você configurou parâmetros de entrada anteriormente usando a opção Parâmetros, esses parâmetros serão preenchidos automaticamente para a tarefa. Você pode adicionar, remover ou atualizar quaisquer parâmetros específicos para esta tarefa. Isso não alterará os parâmetros padrão do notebook configurado usando a opção de parâmetros.
- Clique em Avançar para mover para página Definir detalhes do horário da tarefa.
Aqui, você pode especificar o horário particular desta 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 o tipo de repetição Semana, caixas de seleção aparecerão para cada dia da semana. - Opcionalmente, expanda a seção Avançado para inserir a quantidade máxima de minutos que a tarefa pode ser executada.
- 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.
- 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.
- 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 você desejar ter horários múltiplos, talvez com parâmetros diferentes inseridos, você pode criar mais tarefas para o notebook com a utilização do mesmo fluxo de trabalho.
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 realizar alterações em tarefas no painel Tarefas do editor de notebook ou a partir da guia Tarefas da página de detalhes 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.
- Na barra de formatação superior do editor de notebook, clique em Tarefas.
- Na seção Tarefas Agendadas, encontre a tarefa com a qual deseja trabalhar.
- Clique em Ações
ao lado da tarefa e faça o seguinte:- Clique em Detalhes para revisar os resultados de cada execução individual da tarefa. Uma visualização do notebook é armazenada com os detalhes de cada tarefa executada.
Anotação:
A visualização do notebook não incluirá a renderização de widgets de mapa que estão no notebook. Os widgets de mapa são renderizados apenas no notebook e não serão renderizados na visualização estática incluída no resultado de uma tarefa agendada.
- 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.
- Clique em Detalhes para revisar os resultados de cada execução individual da tarefa. Uma visualização do notebook é armazenada com os detalhes de cada tarefa executada.
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 detalhes do item do notebook.