A partir de la versión 10.8.1, 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 control del usuario.
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 por minuto hasta una vez cada cinco 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
El editor de notebooks tiene una nueva característica Parámetros que le permite 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 o una herramienta web. Cuando se ejecuta una tarea programada, los parámetros de entrada se insertarán 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.
Al crear un notebook, externalice y configure variables con la característica Parámetros. Consulte la sección Configurar parámetros de entrada del tema Publicar un notebook como una herramienta web para obtener más información sobre cómo configurar parámetros de entrada para su notebook.
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.
- 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.
- 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. - 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.
- 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.
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.
- Haga clic en Siguiente para pasar a la página Definir detalles de programación de tarea.
Aquí puede especificar la programación concreta de 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 el tipo de repetición Semana, aparecen casillas de verificación para cada día de la semana. - Opcionalmente, expanda la sección Opciones avanzadas para introducir la cantidad máxima de minutos en los que se puede ejecutar la tarea.
- 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.
- 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.
- 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, quizá con distintos parámetros insertados, puede crear más tareas para el notebook con el mismo flujo de trabajo.
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.
- En la cinta superior del editor de notebooks, haga clic en Tareas.
- En la sección Tareas programadas, busque la tarea con la que desee trabajar.
- Haga clic en Acciones
junto a la tarea y realice una de las siguientes acciones:- Haga clic en Detalles para revisar los resultados de cada ejecución individual de la tarea. Se almacena una vista previa del notebook con los detalles de cada ejecución de tarea.
Nota:
La vista previa del notebook no incluirá la representación en pantalla de los widgets de mapa que se encuentran en el notebook. Los widgets de mapa solo se representan en pantalla en el notebook y no se mostrarán en la vista previa estática incluida con el resultado de una tarea programada.
- 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.
- Haga clic en Detalles para revisar los resultados de cada ejecución individual de la tarea. Se almacena una vista previa del notebook con los detalles de cada ejecución de tarea.
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.