Analizar caja de herramientas para versión (Administración de datos)

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

    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).

  • 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.

Parámetros

EtiquetaExplicaciónTipo 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.

  • ArcGIS Desktop 10.6.0ArcGIS Desktop 10.6.0 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas.
  • ArcGIS Desktop 10.7.0ArcGIS Desktop 10.7.0 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas.
  • ArcGIS Desktop 10.8.0ArcGIS Desktop 10.8.0 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas.
  • ArcGIS Desktop 10.8.2ArcGIS Desktop 10.8.2 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas.
  • ArcGIS Pro 2.2ArcGIS Pro 2.2 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas.
  • ArcGIS Pro 2.3ArcGIS Pro 2.3 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas.
  • ArcGIS Pro 2.4ArcGIS Pro 2.4 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas.
  • ArcGIS Pro 2.5ArcGIS Pro 2.5 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas.
  • ArcGIS Pro 2.6ArcGIS Pro 2.6 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas.
  • ArcGIS Pro 2.7ArcGIS Pro 2.7 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas.
  • ArcGIS Pro 2.8ArcGIS Pro 2.8 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas.
  • ArcGIS Pro 2.9ArcGIS Pro 2.9 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas.
  • ArcGIS Pro 3.0ArcGIS Pro 3.0 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas.
  • 3.1ArcGIS Pro 3.1 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas.
  • 3.2ArcGIS Pro 3.2 se utilizará para el análisis de problemas 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

arcpy.management.AnalyzeToolboxForVersion(in_toolbox, version, {report})
NombreExplicaciónTipo 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.

  • 10.6.0ArcGIS Desktop 10.6.0 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas.
  • 10.7.0ArcGIS Desktop 10.7.0 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas.
  • 10.8.0ArcGIS Desktop 10.8.0 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas.
  • 10.8.2ArcGIS Desktop 10.8.2 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas.
  • 2.2ArcGIS Pro 2.2 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas.
  • 2.3ArcGIS Pro 2.3 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas.
  • 2.4ArcGIS Pro 2.4 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas.
  • 2.5ArcGIS Pro 2.5 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas.
  • 2.6ArcGIS Pro 2.6 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas.
  • 2.7ArcGIS Pro 2.7 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas.
  • 2.8ArcGIS Pro 2.8 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas.
  • 2.9ArcGIS Pro 2.9 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas.
  • 3.0ArcGIS Pro 3.0 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas.
  • 3.1ArcGIS Pro 3.1 se utilizará para el análisis de problemas de compatibilidad de la caja de herramientas.
  • 3.2ArcGIS Pro 3.2 se utilizará para el análisis de problemas 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

Ejemplo 1 de AnalyzeToolboxForVersion (ventana de Python)

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í

Temas relacionados