Programar una tarea de notebook

Puede crear tareas para programar la ejecución automática de un notebook. Siempre que el notebook se ejecute según la programación que defina, el sitio abre un contenedor nuevo y ejecuta el notebook sin tener que abrir el notebook usted. Puede haber un máximo de cinco tareas en ejecución al mismo tiempo en todos los notebooks de su propiedad.

Desde el panel Tareas del editor de notebooks, puede crear una o varias tareas programadas para ejecutar el notebook. Puede programarlo para que se ejecute una vez en el futuro o de forma recurrente, desde una vez cada 15 minutos hasta una vez cada 6 meses.

Si va a preparar un notebook para la ejecución automática, por ejemplo de forma periódica, existen algunos aspectos que debe tener en cuenta.

Preparar el notebook

Puede configurar parámetros de entrada y salida para un notebook. Los parámetros de entrada corresponden a las variables de entrada de un notebook que desea externalizar para una tarea programada. Cuando se ejecuta una tarea programada, los parámetros de entrada se insertan en el notebook en la parte superior del notebook, de forma parecida a las variables globales. Esto le permite crear notebooks genéricos y modificar los valores de las variables de entrada en tiempo de ejecución.

Los parámetros de tarea se insertan de forma predeterminada en una celda al comienzo de un notebook. Como alternativa, puede utilizar la opción de celda Etiquetas de la barra de herramientas, que le permite crear y administrar etiquetas para cada celda en el espacio de trabajo del notebook, para crear una etiqueta para una celda llamada injected-parameters. Los parámetros de tarea se consultan en la celda que sigue a la etiqueta injected-parameters. Para habilitar las etiquetas, puede cambiar las opciones de la barra de herramientas de celda haciendo clic en Ver, en Barra de herramientas de celda y en Etiquetas.

Consideraciones sobre el contenido

Aparte de los parámetros de celda que puede insertar, la programación de un notebook no admite ninguna interacción de los usuarios con los notebooks. Evite agregar contenido que requiera la interacción del usuario mientras se ejecuta el notebook, como hacer clic en un punto de un mapa.

Cualquier credencial o variable nueva que quiera añadir durante la ejecución automática debe insertarse en la celda de parámetros, tal como se muestra arriba. Asegúrese de que el notebook no incluya contenido que impida que este se complete.

Nota:

Al crear notebooks, utilice rutas completas a directorios y archivos en el directorio del espacio de trabajo.

Por ejemplo, utilice /arcgis/home/test.gdb en lugar de home/test.gdb.

Crear una tarea

Cuando el notebook esté listo, puede crear una tarea para programar su ejecución. Con el panel Tareas del editor de notebooks, puede crear una o varias tareas para automatizar la ejecución del notebook, así como especificar la programación de la tarea.

  1. Compruebe que ha iniciado sesión con privilegios para crear y programar notebooks.
  2. Guarde el notebook con un título, si todavía no lo ha hecho.

    El botón Tareas pasa a estar disponible en la cinta superior del editor de notebooks.

  3. En la cinta superior del editor de notebooks, haga clic en Tareas.
  4. Haga clic en Crear tarea para abrir el cuadro de diálogo.

    Nota:
    También puede crear tareas desde la pestaña Tareas de la página de detalles del elemento del notebook.

  5. Proporcione un título en el cuadro de texto Título para describir el programa de tareas, como Ejecución de limpieza de datos semanal.
  6. Si no ha configurado anteriormente parámetros para el notebook y hay parámetros que desea agregar al notebook cuando lo ejecuta la tarea, proporciónelos en la sección Parámetros. Asigne una clave en el ajuste Clave y su valor vinculado en el ajuste Valor para cada parámetro y haga clic en Agregar parámetro para guardar el parámetro.

    Tras agregar al menos un parámetro, aparece la opción Guardar parámetros en el notebook. Si esta opción está activada, la celda insertada con el nuevo parámetro se guarda en el notebook cuando se ejecute.

    Si ya ha configurado parámetros de entrada con la opción Parámetros, esos parámetros se completarán automáticamente para la tarea. Puede agregar, quitar o actualizar cualquier parámetro específico para esta tarea. Si lo hace, no cambiará los parámetros predeterminados del notebook configurado con la opción de parámetros.

  7. Haga clic en Siguiente.
  8. En la página Definir detalles de programación de tarea, especifique el programa para la tarea.

    Sugerencia:
    Si cambia el valor de Tipo de repetición, las opciones que aparecen a continuación cambian para adaptarse a esa denominación. Por ejemplo, si elige Semana, aparecen casillas de verificación para cada día de la semana.

  9. Use el botón de alternancia de Actualizar notebook al terminar para elegir si guardar o no el notebook después de cada ejecución. Si desea actualizar el notebook con los resultados de cada ejecución, active el botón de alternancia. Si no desea que el notebook se actualice automáticamente, desactive el botón de alternancia.
  10. Opcionalmente, haga clic en Opciones avanzadas para introducir la cantidad máxima de minutos en los que se puede ejecutar la tarea.
  11. Cuando esté conforme con el título, los parámetros opcionales y la programación de la tarea, haga clic en Crear tarea.

    La tarea está activa y ejecuta el notebook según la programación que haya definido.

Si desea tener varias programaciones, puede crear más tareas para el notebook con el mismo flujo de trabajo. Puede haber un máximo de cinco tareas en ejecución al mismo tiempo en todos los notebooks de su propiedad. Las tareas programadas para iniciarse cuando ya hay cinco tareas en curso se marcan como fallidas.

Trabajar con tareas existentes

Una vez que ha creado una tarea para el notebook, puede ver sus detalles, editarla o eliminarla en cualquier momento. Puede hacer cambios en las tareas desde el panel Tareas del editor de notebooks o desde la pestaña Tareas de la página de detalles del elemento del notebook. En ambas ubicaciones puede ver todas las tareas del notebook con la hora de su creación y su última modificación, así como su estado actual.

  1. Compruebe que ha iniciado sesión con privilegios para crear notebooks.
  2. En la cinta superior del editor de notebooks, haga clic en Tareas.
  3. En la sección Tareas programadas, busque la tarea con la que desee trabajar.
  4. Haga clic en Acciones Acciones junto a la tarea y realice una de las siguientes acciones:
    • Haga clic en Detalles para ver los detalles y el estado de cada ejecución de la tarea. Para ver los resultados de la ejecución, haga clic en el botón Resultados. El estado de las tareas puede ser uno de los siguientes:
      • Correcta: la tarea se completó correctamente.
      • En ejecución: la tarea está actualmente en ejecución.
      • Fallida: la tarea no se pudo ejecutar correctamente. Si una tarea falla cinco veces, se detiene completamente.
      • Omitida: la tarea se omitió porque aún estaba en ejecución una ejecución anterior.
    • Haga clic en Editar para cambiar el título, los parámetros o la programación de la tarea.
    • Haga clic en Pausa para pausar una tarea activa. Cuando esté en pausa, haga clic en Reanudar para reanudar la tarea.
    • Haga clic en Eliminar para eliminar la tarea.
      Nota:

      Eliminar una tarea también elimina su historial de ejecución. Para conservar el historial de una tarea activa, plantéese poner en pausa la tarea para detener futuras ejecuciones.

Al cambiar la propiedad de un notebook, también se cambia la propiedad de las tareas de ese notebook. Las tareas se transfieren al nuevo usuario en un estado inactivo. El nuevo propietario puede habilitar las tareas desde en el panel Tareas del editor de notebooks o desde la pestaña Tareas de la página de detalles del elemento del notebook.