Etiqueta | Explicación | Tipo 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.
| 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.
| 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.
| 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.
| Boolean |
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 AllSource 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
arcpy.management.SaveToolboxToVersion(in_toolbox, version, out_toolbox, {missing_tool}, {missing_param}, {invalid_param_value})
Nombre | Explicación | Tipo 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.
| 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.
| 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.
| 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.
| Boolean |
Muestra de código
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")