| Etiqueta | Explicación | Tipo de datos |
Entrada | La caja de herramientas de entrada (archivo .tbx o .atbx) que se analizará. 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 de compatibilidad de la caja de herramientas.
| String |
Archivo de salida (Opcional) | El archivo de texto que se creará y que contiene los problemas de compatibilidad identificados por los analizadores. | File |
Resumen
Analiza el contenido de una caja de herramientas e identifica problemas de compatibilidad con versiones anteriores del software de ArcGIS.
La herramienta evalúa una caja de herramientas (para las herramientas basadas en ModelBuilder y Python) y determina las herramientas de geoprocesamiento de ArcGIS Pro que contiene. A continuación, la herramienta identifica problemas de compatibilidad entre la versión del software que se está utilizando y una versión de destino especificada. Los problemas de compatibilidad se presentan como mensajes de advertencia y se pueden escribir opcionalmente en un archivo de texto.
Más información sobre cómo guardar una caja de herramientas en una versión anterior
Uso
La caja de herramientas de entrada no se modificará. Para actualizar la caja de herramientas, use la herramienta Guardar caja de herramientas en la versión.
Los analizadores de compatibilidad de la herramienta rastrean la lista de problemas de compatibilidad conocidos para cada herramienta de geoprocesamiento y para cada versión de destino.
Los problemas de compatibilidad solo se rastrean para las cajas de herramientas del sistema de ArcGIS Pro.
Los analizadores de la herramienta no rastrean la compatibilidad de las funciones de herramientas que no sean de geoprocesamiento en ArcPy. Los cambios en las funciones que no son de geoprocesamiento (por ejemplo, cambios en arcpy.da.SearchCursor) pueden causar problemas de compatibilidad.
El analizador de compatibilidad identifica los siguientes problemas de compatibilidad e informa sobre ellos:
- Herramientas de geoprocesamiento de las cajas de herramientas del sistema que no están presentes en la versión de destino. Por ejemplo, la herramienta De PDF a TIFF no estaba disponible en ArcGIS Pro antes de la versión 2.9.
- El tipo de datos de geoprocesamiento de una variable de modelo o parámetro de herramienta no está presente en la versión de destino (solo modelos). Por ejemplo, el tipo de datos de Capa de vóxel (GPVoxelLayer) solo se admite desde ArcGIS Pro 2.6.
- Parámetros de herramienta que no están presentes en la versión de destino. Por ejemplo, el parámetro Tablas de plantillas se agregó a la herramienta Agregar campos (varios) en ArcGIS Pro 2.6.
- Modificaciones de ciertas propiedades de un parámetro de herramienta. Los cambios en las siguientes propiedades de parámetro generarán advertencias de compatibilidad:
- Tipo de parámetro: un parámetro puede ser de tipo obligatorio, opcional o derivado.
- Dirección: un parámetro puede tener una dirección de entrada o salida.
- Valor: el valor predeterminado del parámetro.
- Varios valores: un parámetro puede admitir un solo valor o varios.
- Tipo de datos: el tipo de datos de un parámetro, por ejemplo, Clase de entidad (DEFeatureClass).
- Lista de filtros: las opciones y los filtros que limitan los valores que se consideran válidos para un parámetro.
- Tipo de filtro: el tipo de filtro asociado con el parámetro. Por ejemplo, un parámetro puede no tener filtro, una lista de valores o un rango de valores (por ejemplo, de 0 a 10). Normalmente, los cambios de tipo de filtro pasan de no tener filtro a tener filtro.
Nota:
ArcGIS Pro admite la compatibilidad con versiones anteriores de las herramientas de geoprocesamiento. Las versiones posteriores del software pueden utilizar los modelos y scripts creados con una versión anterior del software. Por ejemplo, un modelo creado en ArcGIS Pro 2.9 se puede utilizar en ArcGIS Pro 3.0. La finalidad de la herramienta Analizar caja de herramientas para una versión es identificar cualquier problema de compatibilidad que causará problemas al crear (o editar) una caja de herramientas en una versión posterior del software (por ejemplo, ArcGIS Pro 3.0) y, a continuación, se utiliza con una versión anterior del software (por ejemplo, ArcGIS Pro 2.9).
Parámetros
arcpy.management.AnalyzeToolboxForVersion(in_toolbox, version, {report})| Nombre | Explicación | Tipo de datos |
in_toolbox | La caja de herramientas de entrada (archivo .tbx o .atbx) que se analizará. 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 de compatibilidad de la caja de herramientas.
| String |
report (Opcional) | El archivo de texto que se creará y que contiene los problemas de compatibilidad identificados por los analizadores. | File |
Muestra de código
El siguiente script de la ventana de Python demuestra cómo utilizar la función AnalyzeToolboxForVersion de modo inmediato.
import arcpy
arcpy.management.AnalyzeToolboxForVersion(r"C:\toolboxes\MyTools.atbx", "2.7")Entornos
Esta herramienta no utiliza ningún entorno de geoprocesamiento.
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí