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 la caja 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 (.tbx o .atbx) que se analizará y guardará. El archivo no se modificará.

El formato de la caja de herramientas de Python (.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.

  • 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.
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 la operación producirá un error si se encuentra una herramienta que no está presente en la versión de destino.

  • Activado: si se encuentra una herramienta que no está presente en la versión de destino, la operación producirá un error y la caja de herramientas de salida no se creará. Esta es la opción predeterminada.
  • Desactivado: si se encuentra una herramienta que no está presente en la versión de destino, la operación generará un mensaje de advertencia y 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 la operación producirá un error si se encuentra 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: si se encuentra 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, la operación producirá un error y no se creará la caja de herramientas de salida. Esta es la opción predeterminada.
  • Desactivado: si se encuentra 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, la operación quitará el parámetro 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 la operación producirá un error si se encuentra un valor de parámetro que no está presente en su filtro de parámetros en la versión de destino.

  • Activado: si se encuentra un valor de parámetro que no está presente en su filtro de parámetros en la versión de destino, la operación producirá un error y la caja de herramientas de salida no se creará. Esta es la opción predeterminada.
  • Desactivado: si se encuentra un valor de parámetro que no está presente en su filtro de parámetros en la versión de destino, la operación continuará con advertencias 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 (.tbx o .atbx) que se analizará y guardará. El archivo no se modificará.

El formato de la caja de herramientas de Python (.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.
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 la operación producirá un error si se encuentra una herramienta que no está presente en la versión de destino.

  • ERROR_ON_MISSING_TOOLSi se encuentra una herramienta que no está presente en la versión de destino, la operación producirá un error y la caja de herramientas de salida no se creará. Esta es la opción predeterminada.
  • WARN_ON_MISSING_TOOLSi se encuentra una herramienta que no está presente en la versión de destino, la operación generará un mensaje de advertencia y 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 la operación producirá un error si se encuentra 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_PARAMSi se encuentra 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, la operación producirá un error y no se creará la caja de herramientas de salida. Esta es la opción predeterminada.
  • WARN_ON_MISSING_REQUIRED_PARAMSi se encuentra 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, la operación quitará el parámetro del modelo y se creará la caja de herramientas de salida.
Boolean
invalid_param_value
(Opcional)

Especifica si la operación producirá un error si se encuentra 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_VALUESi se encuentra un valor de parámetro que no está presente en su filtro de parámetros en la versión de destino, la operación producirá un error y la caja de herramientas de salida no se creará. Esta es la opción predeterminada.
  • WARN_ON_INVALID_PARAM_VALUESi se encuentra un valor de parámetro que no está presente en su filtro de parámetros en la versión de destino, la operación continuará con advertencias 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)

El siguiente script de la ventana de Python demuestra 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