Programar herramientas de geoprocesamiento

Ejecute una herramienta de geoprocesamiento inmediatamente o programe su ejecución para más tarde o de forma recurrente. Programar una herramienta de geoprocesamiento le permite realizar lo siguiente:

  • Automatizar una herramienta para que se ejecute con regularidad.
  • Ejecutar un proceso de larga ejecución o que requiera una gran potencia de cómputo en un momento oportuno.
  • Ejecutar varias herramientas de geoprocesamiento simultáneamente con un script de Python independiente.

Nota:

Es posible programar una herramienta de geoprocesamiento en todos los niveles de licencia de ArcGIS Pro. Cuando utilice una licencia de usuario nominal, active la casilla de verificación Iniciar sesión automáticamente al iniciar sesión en la cuenta de usuario. Esto se necesita para que la herramienta programada se ejecute fuera de ArcGIS Pro en el proceso Python de herramientas programadas.

Programar la ejecución de una herramienta

Todas las herramientas de geoprocesamiento se pueden programar. Para programar una herramienta de geoprocesamiento, siga estos pasos:

  1. Busque la herramienta de geoprocesamiento y ábrala.
    Nota:

    Aunque todas las herramientas pueden programarse, el procesamiento de aquellas herramientas que actualizan las capas o los mapas, tales como Seleccionar capa por atributo, Seleccionar capa por ubicación o Crear capa de entidades, no tendrán efecto en el proyecto. Por ejemplo, al ejecutar la herramienta programada Seleccionar capa por atributo, la selección no se mostrará en el proyecto. El proceso Python independiente que ejecuta las herramientas programadas no realiza actualizaciones en las capas y mapas de un proyecto. No obstante, si esas herramientas forman parte de un proceso más amplio en una herramienta de modelo o herramienta de scripts programada, las herramientas se ejecutarán de la forma esperada, y su resultado se utilizará para posteriores procesamientos.

  2. Especifique los parámetros de la herramienta.

    Los valores de los parámetros especificados se usarán cada vez que la herramienta planificada se ejecute.

    Nota:

    Al programar una herramienta, utilice la ruta completa a un dataset en lugar de capas de un mapa. El uso de una ruta completa garantiza que la herramienta funcionará independientemente de la disponibilidad y el estado de una capa y un proyecto. El uso de una capa requiere que el proyecto se guarde y esté disponible en la ubicación en la que existía el proyecto cuando se programó la herramienta. De lo contrario, cuando la herramienta programada se ejecute, se producirá un error que indica que la entrada no existe.

    Lo mismo ocurre cuando se programa una herramienta que utiliza un mapa como entrada. Especifique un parámetro de mapa con una ruta completa al proyecto y al mapa, como C:\Projects\City.aprx\StreetMap. A continuación, guarde el proyecto antes de programarlo para que el contenido del mapa actual esté disponible para su uso en el proceso externo. Utilizar únicamente el nombre del mapa como entrada no funcionará y puede resultar en un error o en resultados inesperados.

  3. Si lo desea, especifique entornos de la herramienta.
  4. Haga clic en el menú dividido del botón Ejecutar Ejecutar y elija Programación Calendario.
  5. En la ventana Programación, especifique el nombre de la tarea, la fecha y hora de inicio, la recurrencia, la caducidad y otras opciones sobre cómo y cuándo se debe ejecutar la herramienta programada. Haga clic en Aceptar para finalizar y programar la herramienta.

    La herramienta programada se agrega a la sección Herramientas programadas de la pestaña Geoprocesamiento del panel Historial, se habilitará la programación de la herramienta y la herramienta se empezará a ejecutar en la fecha y hora especificadas.

Administrar herramientas programadas

La sección Herramientas programadas de la pestaña Geoprocesamiento del panel Historial mostrará todas las herramientas programadas para ejecutarse en el equipo con su cuenta de usuario, independientemente del proyecto desde el que se programaron dichas herramientas. Debe iniciar sesión en el equipo para que se ejecuten las herramientas programadas.

Cada una de las herramientas de la sección Herramientas programadas incluye una lista del historial de la herramienta. Siempre que se ejecute una herramienta programada, se agregará un nuevo elemento con marca de tiempo debajo de la entrada de la herramienta programada con un icono que indica si la herramienta se completó correctamente o no.

IconoEstado
Marca de verificación

La herramienta se completó correctamente.

Advertencia

La herramienta se completó con advertencias. Haga clic en Ver detalles o sitúe el puntero en el icono de estado Advertencia para ver los mensajes de advertencia.

Error

La herramienta falló. Haga clic en Ver detalles o sitúe el puntero en el icono de estado Error para ver los mensajes de error.

Puede administrar herramientas de geoprocesamiento programadas de las siguientes maneras mediante el menú contextual de las herramientas programadas, así como mediante los comandos rápidos disponibles cuando desplaza el cursor sobre una herramienta programada:

  • Haga clic en Editar programación para cambiar opciones de programación tales como fecha y hora, recurrencia, caducidad y otras opciones.
  • Haga clic en Ejecutar para ejecutar de inmediato la herramienta programada. Esto resulta útil para probar procesos de ejecución rápida cuya ejecución haya programado para algún momento futuro, a fin de garantizar que la herramienta pueda finalizar su trabajo correctamente.
  • Haga clic en Pausar programación para detener las futuras ejecuciones de la herramienta programada. Cuando se pausa una herramienta programada, no se volverá a ejecutar en la programación hasta que haga clic en Reanudar programación.
  • Haga clic en Borrar registro de ejecuciones para borrar el historial de una herramienta programada. No tiene ningún efecto en futuras ejecuciones de la herramienta.
  • Haga clic en Eliminar programación para deshabilitar y quitar la herramienta programada, así como eliminar los scripts, archivos de registro y carpetas asociados. Detiene todas las ejecuciones programadas de la herramienta, borra el historial de la herramienta programada y elimina la herramienta de la sección Programadas.

Registrar herramientas programadas

Las opciones para registrar operaciones de geoprocesamiento se aplican a las herramientas programadas. Además de la sección Programadas , la capacidad de registro puede ser útil para realizar un seguimiento de las herramientas programadas. Si la opción Escribir las operaciones de geoprocesamiento en el archivo de registro XML está habilitada, las herramientas programadas crearán archivos de registro en el directorio %APPDATA%\ESRI\ArcGISPro\ArcToolbox\History. Si la opción Escribir las operaciones de geoprocesamiento en los metadatos del dataset está habilitada, las herramientas programadas actualizarán la sección Historial de geoprocesamiento de los metadatos del dataset con detalles sobre las herramientas programadas.

Ampliar el geoprocesamiento programado

Al programar una herramienta de geoprocesamiento, se crea una carpeta y varios archivos, incluido un script de Python en el directorio del usuario %localappdata%\Esri\ArcGISPro\Geoprocessing\<your scheduled tool name>. Puede ampliar la operación programada para incluir varias herramientas de geoprocesamiento editando el script de Python en la carpeta de la herramienta programada y agregando más herramientas de geoprocesamiento al script.

Más información sobre cómo agregar herramientas de geoprocesamiento a un script de Python

Sobrescribir o crear datasets de salida

Al programar una herramienta de geoprocesamiento que crea un dataset de salida, debe decidir si desea que la herramienta programada sobrescriba el mismo dataset de salida siempre que se ejecute, o bien que cree un dataset de salida cada vez que se ejecute.

  • Para sobrescribir el mismo dataset de salida cada vez que se ejecute la herramienta programada, utilice una ruta de dataset estándar en el cuadro de texto del parámetro de salida, como C:\Data\MyOutput.gdb\Output.
  • Para crear un dataset de salida cada vez que se ejecute la herramienta programada, utilice la variable de marca de tiempo %t% en su ruta de dataset en el cuadro de texto del parámetro de salida para asignar automáticamente un nombre al dataset de salida en función de la hora a la que se ejecutó la herramienta.

    Por ejemplo, es posible especificar una ruta de dataset de salida como C:\Data\MyOutput.gdb\Output_%t% y, si la herramienta se ejecutó el 13 de marzo de 2020 a las 08:30:00 a.m., el dataset de salida se crearía como C:\Data\MyOutput.gdb\Output_03132020083000.

Fuentes de datos remotas

Los datos de entrada de fuentes de datos remotas, como geodatabases corporativas o servicios de entidades, se pueden utilizar en las herramientas de geoprocesamiento programadas. Puede buscar o especificar la ruta completa a estas fuentes de datos como entrada o utilizar capas de mapa que hagan referencia a ellas. Para utilizar fuentes de datos remotas que requieren permisos o credenciales en una herramienta programada, cuando realiza una conexión a la fuente de datos de servidor, portal o geodatabase corporativa, debe guardar sus credenciales de nombre de usuario y contraseña.

  • Para los servicios independientes que requieren credenciales, al establecer la conexión con el servidor o cuando se le pidan las credenciales, active la casilla de verificación Guardar nombre de usuario/contraseña.
  • Para las capas web de un portal, al conectarse al portal, active la casilla de verificación Iniciar sesión automáticamente.
  • Para los datos de una geodatabase corporativa, al conectarse a la base de datos, active la casilla de verificación Guardar usuario/contraseña.
Nota:

Utilice estas opciones para guardar las credenciales de acceso a datos remotos antes de programar una herramienta. De lo contrario, la herramienta programada podría fallar y provocar la aparición de un mensaje de error que indica que los datos no son válidos o que no existen.

Opciones de programación adicionales

La programación de herramientas de geoprocesamiento utiliza el Programador de tareas de Windows para ejecutar las herramientas seleccionadas en un momento especificado. Las herramientas de geoprocesamiento que haya programado desde ArcGIS Pro en el Programador de tareas de Windows bajo el nombre de la tarea que especificó en la ventana Programación. La configuración de programación que especificó en ArcGIS Pro se muestra en el Programador de tareas de Windows.

El Programador de tareas de Windows brinda opciones de programación adicionales que no están disponibles desde la ventana Programación de ArcGIS Pro.

Nota:

Para modificar opciones de programación adicionales en el Programador de tareas de Windows, debe iniciar sesión con una cuenta de usuario en el grupo de administrador local del equipo. Para utilizar la opción Ejecutar tanto si el usuario ha iniciado sesión como si no, la cuenta con la que especificó ejecutar la tarea debe estar en el grupo de administrador local del equipo. El equipo podría tener una política de grupo establecida por el administrador del sistema que impida que se ejecuten las herramientas programadas cuando su cuenta de usuario no ha iniciado sesión, debido a un riesgo de seguridad. Póngase en contacto con su administrador del sistema para obtener más información.

Entre las opciones adicionales se incluyen las siguientes:

  • Ejecutar tanto si el usuario ha iniciado sesión como si no.
  • Ejecutar con privilegios elevados o de administrador.
  • Detener la tarea si su ejecución dura más que un periodo de tiempo especificado.
  • Iniciar la tarea al iniciar sesión, al arrancar el equipo o en otros eventos.
  • Enviar un correo electrónico o mostrar un mensaje antes de que comience la tarea o después de que se complete (ambas opciones marcadas como obsoletas por Windows).
  • Ejecutar solo si el equipo está inactivo.
  • Reactivar el equipo para la ejecución.
  • Ejecutar solo con alimentación de CA.
  • Si la tarea no se realiza correctamente, reintentar tras un periodo de tiempo determinado.
  • Indica qué sucede si una tarea se sigue ejecutando cuando la tarea se programa para ejecutarse de nuevo.

Nota:

Si está permitido, considere ejecutar tareas críticas programadas con una cuenta de usuario genérica. Esto evitará vincular el proceso a una cuenta de usuario específica.

Herramientas de extensión

Cuando utilice una licencia de uso concurrente y una herramienta de extensión directamente o como parte de una herramienta de script o modelo, tenga en cuenta lo siguiente:

  • Si se programa una herramienta de extensión directamente, o bien una herramienta de modelo con una herramienta de extensión, no es necesario realizar otros pasos especiales.
  • Si se programa una herramienta de script con una herramienta de extensión, el script debe incluir llamadas de CheckOutExtension para hacer un check-out de las extensiones adecuadas.

Si utiliza una licencia de usuario nominal o uso único, las herramientas de extensión se pueden utilizar sin consideraciones especiales.