Guardar caja de herramientas en la versión (Administración de datos)

Resumen

Analiza y guarda una caja de herramientas para su uso con una versión específica del software de ArcGIS.

Los analizadores buscan diversos problemas de compatibilidad de las herramientas de geoprocesamiento entre la versión instalada de ArcGIS Pro y una versión de destino especificada. Para obtener una lista de los problemas de compatibilidad, consulte la herramienta Analizar caja de herramientas para una versión, ya que utiliza la misma lógica de analizador.

Más información sobre cómo guardar una caja de herramientas en una versión anterior

Los analizadores de la herramienta informarán de problemas de compatibilidad con las herramientas basadas tanto en ModelBuilder como en Python (solo para herramientas de script con un archivo Python como origen de la herramienta). Las siguientes son distinciones sobre las acciones que se realizarán:

  • Herramienta de modelo: determinados tipos de problemas de compatibilidad se tratarán como parte de la operación.
  • Herramienta de script: no se realiza ningún cambio en el archivo fuente de la herramienta.

Uso

  • Esta herramienta crea una caja de herramientas de salida en la que se escribirá el resultado. La caja de herramientas original no se modificará. Se recomienda conservar la caja de herramientas original para evitar la pérdida de datos.

  • Las herramientas en la caja de herramientas de salida pueden producir resultados que no son coherentes con la original. Pruebe las herramientas de la caja de herramientas de salida para comprobar la coherencia.

  • Algunas funcionalidades de los modelos, especialmente en relación con filtros, dominios y listas de opciones (listas desplegables de valores), se eliminarán de la caja de herramientas de salida. Para solucionarlo, agregue y vuelva a conectar las herramientas relevantes al flujo de trabajo del modelo.

  • Para las herramientas de script, la ruta al archivo Python de la herramienta no se cambiará en la caja de herramientas de salida. Las herramientas de script de las cajas de herramientas original y de salida utilizarán el mismo archivo. Si se requieren modificaciones, haga una copia del archivo .py y actualice una de las dos propiedades Archivo de script de la herramienta de script para que señale al segundo archivo .py. No se aplica a las herramientas de script con un archivo de script integrado.

  • Esta herramienta no puede reparar ciertos problemas de compatibilidad. Por ejemplo, los tipos de datos que no estén presentes en la versión de destino producirán un error. Para solucionar esto, haga una copia de la caja de herramientas, quite manualmente los datos problemáticos y utilice esa caja de herramientas como entrada.

Parámetros

EtiquetaExplicaciónTipo de datos
Caja de herramientas de entrada

La caja de herramientas de entrada (archivo .tbx o .atbx) que se analizará y guardará. El archivo no se modificará.

El formato de la caja de herramientas de Python (archivo .pyt) no es compatible como entrada.

Toolbox
Versión de destino

Especifica la versión de software que se utilizará para el análisis problemas de compatibilidad de la caja de herramientas.

  • ArcGIS Desktop 10.6.0ArcGIS Desktop 10.6.0 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas. La caja de herramientas de salida se guardará en esta versión.
  • ArcGIS Desktop 10.7.0ArcGIS Desktop 10.7.0 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas. La caja de herramientas de salida se guardará en esta versión.
  • ArcGIS Desktop 10.8.0ArcGIS Desktop 10.8.0 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas. La caja de herramientas de salida se guardará en esta versión.
  • ArcGIS Desktop 10.8.2ArcGIS Desktop 10.8.2 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas. La caja de herramientas de salida se guardará en esta versión.
  • ArcGIS Pro 2.2ArcGIS Pro 2.2 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas. La caja de herramientas de salida se guardará en esta versión.
  • ArcGIS Pro 2.3ArcGIS Pro 2.3 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas. La caja de herramientas de salida se guardará en esta versión.
  • ArcGIS Pro 2.4ArcGIS Pro 2.4 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas. La caja de herramientas de salida se guardará en esta versión.
  • ArcGIS Pro 2.5ArcGIS Pro 2.5 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas. La caja de herramientas de salida se guardará en esta versión.
  • ArcGIS Pro 2.6ArcGIS Pro 2.6 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas. La caja de herramientas de salida se guardará en esta versión.
  • ArcGIS Pro 2.7ArcGIS Pro 2.7 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas. La caja de herramientas de salida se guardará en esta versión.
  • ArcGIS Pro 2.8ArcGIS Pro 2.8 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas. La caja de herramientas de salida se guardará en esta versión.
  • ArcGIS Pro 2.9ArcGIS Pro 2.9 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas. La caja de herramientas de salida se guardará en esta versión.
  • ArcGIS Pro 3.0ArcGIS Pro 3.0 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas. La caja de herramientas de salida se guardará en esta versión.
  • ArcGIS Pro 3.1ArcGIS Pro 3.1 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas. La caja de herramientas de salida se guardará en esta versión.
  • ArcGIS Pro 3.2ArcGIS Pro 3.2 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas. La caja de herramientas de salida se guardará en esta versión.
String
Caja de herramientas de salida

La caja de herramientas que se creará para utilizarla con el software de ArcGIS del valor especificado para el parámetro Versión de destino.

Toolbox
Error debido a que falta una herramienta
(Opcional)

Especifica si se producirá un error en caso de que se encuentre una herramienta que no está presente en la versión de destino.

  • Activado: se producirá un error y no se creará la caja de herramientas de salida. Esta es la opción predeterminada.
  • Desactivado: se generará un mensaje de advertencia y se creará la caja de herramientas de salida. Para las herramientas de modelo, la herramienta problemática se eliminará del modelo, lo que requerirá una edición manual.
Boolean
Error debido a que falta el parámetro requerido
(Opcional)

Especifica si se producirá un error en caso de que se encuentre un parámetro que no está presente en la versión de destino y ese parámetro tiene un valor que no es su valor predeterminado.

  • Activado: se producirá un error y no se creará la caja de herramientas de salida. Esta es la opción predeterminada.
  • Desactivado: se producirá un mensaje de advertencia, el parámetro se eliminará del modelo y se creará la caja de herramientas de salida.
Boolean
Error debido a que hay un valor de parámetro no válido
(Opcional)

Especifica si se producirá un error en caso de que se encuentre un valor de parámetro que no está presente en su filtro de parámetros en la versión de destino.

  • Activado: se producirá un error y no se creará la caja de herramientas de salida. Esta es la opción predeterminada.
  • Desactivado: se generará un mensaje de advertencia y se creará la caja de herramientas de salida. La caja de herramientas de salida producirá un error si tiene un valor que no está en el dominio o no es válido.
Boolean

arcpy.management.SaveToolboxToVersion(in_toolbox, version, out_toolbox, {missing_tool}, {missing_param}, {invalid_param_value})
NombreExplicaciónTipo de datos
in_toolbox

La caja de herramientas de entrada (archivo .tbx o .atbx) que se analizará y guardará. El archivo no se modificará.

El formato de la caja de herramientas de Python (archivo .pyt) no es compatible como entrada.

Toolbox
version

Especifica la versión de software que se utilizará para el análisis problemas de compatibilidad de la caja de herramientas.

  • 10.6.0ArcGIS Desktop 10.6.0 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas. La caja de herramientas de salida se guardará en esta versión.
  • 10.7.0ArcGIS Desktop 10.7.0 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas. La caja de herramientas de salida se guardará en esta versión.
  • 10.8.0ArcGIS Desktop 10.8.0 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas. La caja de herramientas de salida se guardará en esta versión.
  • 10.8.2ArcGIS Desktop 10.8.2 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas. La caja de herramientas de salida se guardará en esta versión.
  • 2.2ArcGIS Pro 2.2 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas. La caja de herramientas de salida se guardará en esta versión.
  • 2.3ArcGIS Pro 2.3 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas. La caja de herramientas de salida se guardará en esta versión.
  • 2.4ArcGIS Pro 2.4 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas. La caja de herramientas de salida se guardará en esta versión.
  • 2.5ArcGIS Pro 2.5 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas. La caja de herramientas de salida se guardará en esta versión.
  • 2.6ArcGIS Pro 2.6 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas. La caja de herramientas de salida se guardará en esta versión.
  • 2.7ArcGIS Pro 2.7 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas. La caja de herramientas de salida se guardará en esta versión.
  • 2.8ArcGIS Pro 2.8 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas. La caja de herramientas de salida se guardará en esta versión.
  • 2.9ArcGIS Pro 2.9 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas. La caja de herramientas de salida se guardará en esta versión.
  • 3.0ArcGIS Pro 3.0 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas. La caja de herramientas de salida se guardará en esta versión.
  • 3.1ArcGIS Pro 3.1 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas. La caja de herramientas de salida se guardará en esta versión.
  • 3.2ArcGIS Pro 3.2 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas. La caja de herramientas de salida se guardará en esta versión.
String
out_toolbox

La caja de herramientas que se creará para utilizarla con el software de ArcGIS del valor especificado para el parámetro version.

Toolbox
missing_tool
(Opcional)

Especifica si se producirá un error en caso de que se encuentre una herramienta que no está presente en la versión de destino.

  • ERROR_ON_MISSING_TOOLSe producirá un error y no se creará la caja de herramientas de salida. Esta es la opción predeterminada.
  • WARN_ON_MISSING_TOOLSe generará un mensaje de advertencia y se creará la caja de herramientas de salida. Para las herramientas de modelo, la herramienta problemática se eliminará del modelo, lo que requerirá una edición manual.
Boolean
missing_param
(Opcional)

Especifica si se producirá un error en caso de que se encuentre un parámetro que no está presente en la versión de destino y ese parámetro tiene un valor que no es su valor predeterminado.

  • ERROR_ON_MISSING_REQUIRED_PARAMSe producirá un error y no se creará la caja de herramientas de salida. Esta es la opción predeterminada.
  • WARN_ON_MISSING_REQUIRED_PARAMSe producirá un mensaje de advertencia, el parámetro se eliminará del modelo y se creará la caja de herramientas de salida.
Boolean
invalid_param_value
(Opcional)

Especifica si se producirá un error en caso de que se encuentre un valor de parámetro que no está presente en su filtro de parámetros en la versión de destino.

  • ERROR_ON_INVALID_PARAM_VALUESe producirá un error y no se creará la caja de herramientas de salida. Esta es la opción predeterminada.
  • WARN_ON_INVALID_PARAM_VALUESe generará un mensaje de advertencia y se creará la caja de herramientas de salida. La caja de herramientas de salida producirá un error con un valor que no esté en el dominio o no sea válido.
Boolean

Muestra de código

Ejemplo 1 de SaveToolboxToVersion (ventana de Python)

La siguiente secuencia de comandos de la ventana de Python muestra cómo utilizar la función SaveToolboxToVersion de modo inmediato.

import arcpy
arcpy.management.SaveToolboxToVersion(r"C:\toolboxes\MyTools.atbx", "2.7", "C:\toolboxes\MyTools_27.tbx")

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

  • Basic: Sí
  • Standard: Sí
  • Advanced: Sí

Temas relacionados