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 tener un máximo de cinco tareas activas en todos sus notebooks.

En 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, tenga en cuenta lo siguiente:

• La frecuencia máxima de ejecución de una tarea programada es de 15 minutos.
• Solo puede crear tareas para elementos de notebook de su propiedad. Esto se aplica a todos los tipos de usuarios, incluidos los administradores.
• Los administradores pueden ver y editar tareas correspondientes a todos los elementos de notebook de la organización.
• Si se elimina un notebook con tareas programadas o se envía a la papelera de reciclaje, las tareas se eliminan de forma permanente y no se pueden restaurar.

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 la 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 una 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 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 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 para guardar el parámetro.
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. Si el notebook que desea programar lee o crea archivos en el directorio del espacio de trabajo (/arcgis/home), active el botón de alternancia Usar espacio de trabajo para montar el directorio en cada ejecución de tarea. Si el notebook no necesita acceder al directorio del espacio de trabajo, desactive el botón de alternancia.

   Nota:

   Con el botón de alternancia Usar espacio de trabajo desactivado para una tarea de notebook, puede seguir escribiendo archivos durante la ejecución de una tarea. Sin embargo, los archivos escritos solo se conservarán en una ubicación temporal mientras dure la ejecución de la tarea y se eliminarán una vez que esta finalice.

10. Opcionalmente, expanda la sección Opciones avanzadas para introducir el número máximo de minutos en los que se puede ejecutar la tarea.
11. En la sección Opciones avanzadas aparecerá un botón de alternancia Guardar parámetros en notebook si ha agregado parámetros. También puede activarlo para guardar la celda insertada con los nuevos parámetros en el notebook cuando se ejecuta.
12. En la sección Opciones avanzadas, active el botón de alternancia Actualizar notebook al terminar si desea actualizar el notebook con los resultados de cada ejecución.
13. 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 tener un máximo de cinco tareas activas en todos sus notebooks. Ponga en pausa o elimine las tareas activas si ya tiene cinco tareas activas y desea programar más.

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 en el panel Tareas del editor de notebooks o desde la pestaña Tareas de la página 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 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 en el panel Tareas del editor de notebooks o desde la pestaña Tareas de la página del elemento del notebook.