Skip To Content

Agendar uma tarefa de notebook

A partir da versão 10.8.1, você pode criar tarefas para agendar a operação automatizada de um notebook. Cada vez que seu 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 programá-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 operação automatizada, como de forma recorrente, há algumas coisas a serem lembradas.

Prepare seu notebook

O Agendador fornece a opção para inserir parâmetros como uma nova célula no tempo de execução, como credenciais de conta ou variáveis para definir.

A operação utiliza a opção Tags da barra de ferramentas da célula, que permite criar e gerenciar tags para cada célula na área de trabalho do notebook. Você pode alterar as opções da barra de ferramentas da célula clicando em Visualizar e escolhendo Barra de Ferramentas da Célula.

Você pode designar o local no notebook onde esta nova célula é adicionada acrescentando a tag injected-parameters em uma célula em seu notebook. A nova célula é inserida após esta célula. Somente uma célula com a tag injected-parameters é reconhecida pela operação.

Considerações para seu conteúdo

Diferente da célula de parâmetros que ela pode inserir, o agendamento de um notebook não suporta qualquer interação de usuário com notebooks. Evite adicionar 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ê deseja adicionar no momento da operação automatizada devem ser inseridas na célula de parâmetros, conforme mostrado acima. Certifique-se de que seu notebook não contém nenhum conteúdo que o impeça 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 seu 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 operação do notebook e especificar o horário da tarefa.

  1. Salve seu notebook com um título, se você já não tiver feito isto.

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

  2. 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.

  3. Forneça um título na caixa de texto Título para descrever o horário da seu tarefa, como Execução da limpeza de dados semanal.
  4. Se houver parâmetros que você deseja adicionar no 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 Parâmetro para salvar o parâmetro.

    Após você adicionar pelo menos um parâmetro, a opção Salvar Parâmetros do Notebook aparece. Se esta opção estiver ativada, a célula inserida com seu novo parâmetro será salva no notebook quando for executada.

  5. 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 de Repetir A Cada, as opções abaixo mudam para ajustar a esta denominação. Por exemplo, se você escolher Repetir Todas as Semanas, as caixas de seleção aparecerão para cada dia da semana.

  6. Se você deseja atualizar o notebook com os resultados de cada execução realizada, mantenha a opção Atualizar Item na Conclusão selecionada. Se você não desejar que o notebook seja atualizado automaticamente, cancela a seleção desta opção.
  7. 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 seu notebook, você poderá visualizar os detalhes da tarefa e editar ou exclui-la em 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.

  1. Na barra de formatação superior do editor de notebook, clique em Tarefas.
  2. Na seção Tarefas Agendadas, encontre a tarefa com a qual deseja trabalhar.
  3. Clique em Ações 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.
    • 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 mais execuções de tarefas.

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 desativado. 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.