Analyser la boîte à outils pour une version (Gestion des données)

Synthèse

Analyse le contenu d’une boîte à outils et identifie les problèmes de compatibilité avec les versions antérieures des logiciels ArcGIS.

Cet outil évalue une boîte à outils (pour les outils basés sur ModelBuilder et Python) et détermine les outils de géotraitement ArcGIS Pro qu’elle contient. Il identifie ensuite les problèmes de compatibilité entre la version du logiciel utilisée et une version cible spécifiée. Les problèmes de compatibilité sont présentés sous forme de messages d’avertissement et peuvent éventuellement être écrits dans un fichier texte.

En savoir plus sur l’enregistrement d’une boîte à outils dans une version antérieure

Utilisation

    Remarque :

    ArcGIS Pro prend en charge la rétrocompatibilité des outils de géotraitement. Les modèles et scripts créés avec une version antérieure du logiciel peuvent être utilisés par les versions ultérieures du logiciel. Par exemple, un modèle créé dans ArcGIS Pro 2.9 peut être utilisé dans ArcGIS Pro 3.0. L’outil Analyser la boîte à outils pour une version a pour objectif d’identifier les problèmes de compatibilité susceptibles de survenir lorsqu’une boîte à outils est créée (ou modifiée) dans une version ultérieure du logiciel (par exemple, ArcGIS Pro 3.0), puis utilisée avec une version antérieure du logiciel (par exemple, ArcGIS Pro 2.9).

  • La boîte à outils en entrée n’est pas modifiée. Pour la mettre à jour, utilisez l’outil Enregistrer la boîte à outils dans une version.

  • Les analyseurs de compatibilité de l’outil suivent la liste des problèmes de compatibilité connus de chaque outil de géotraitement avec chaque version cible.

  • Les problèmes de compatibilité ne sont suivis que pour les boîtes à outils système d’ArcGIS Pro.

  • Les analyseurs de l’outil ne suivent pas la compatibilité des fonctions des outils autres que les outils de géotraitement dans ArcPy. Les modifications apportées aux fonctions autres que les fonctions de géotraitement (par exemple, les modifications apportées à arcpy.da.SearchCursor) peuvent entraîner des problèmes de compatibilité.

  • L’analyseur de compatibilité identifie et signale les problèmes de compatibilité suivants :

    • Outils de géotraitement des boîtes à outils système non présents dans la version cible. Par exemple, l’outil PDF vers TIFF n’était pas disponible dans ArcGIS Pro avant la version 2.9.
    • Type de données de géotraitement d’une variable de modèle ou d’un paramètre d’outil non présent dans la version cible (modèles uniquement). Par exemple, le type de données Couche voxel (GPVoxelLayer) n’est pris en charge que depuis ArcGIS Pro 2.6.
    • Paramètres d’outil non présents dans la version cible. Par exemple, le paramètre Tables de modèle a été ajouté à l’outil Ajouter des champs (multiple) dans ArcGIS Pro 2.6.
    • Modifications apportées à certaines propriétés d’un paramètre d’outil. Les modifications apportées aux propriétés de paramètre suivantes génèrent des avertissements de compatibilité :
      • Type de paramètre : un paramètre peut posséder le type requis, facultatif ou dérivé.
      • Direction : un paramètre peut être en entrée ou en sortie.
      • Valeur : valeur par défaut du paramètre.
      • Valeurs multiples : un paramètre peut prendre en charge une ou plusieurs valeurs.
      • Type de données : type de données d’un paramètre, par exemple Classe d’entités (DEFeatureClass).
      • Liste de filtres : options et filtres qui restreignent les valeurs considérées comme valides pour un paramètre.
      • Type de filtre : type de filtre associé au paramètre. Par exemple, un paramètre peut ne pas avoir de filtre ou posséder une liste ou une plage de valeurs (par exemple, 0 à 10). Généralement, les modifications du type de filtre consistent à attribuer un filtre alors qu’il n’y en avait pas auparavant.

Paramètres

ÉtiquetteExplicationType de données
Entrée

Boîte à outils en entrée (.tbx ou .atbx) à analyser.

Le format de boîte à outils Python (.pyt) n’est pas pris en charge comme entrée.

Toolbox
Version cible

Spécifie la version du logiciel à utiliser pour l’analyse de compatibilité de la boîte à outils.

  • 10.6.0ArcGIS Desktop 10.6.0 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils.
  • 10.7.0ArcGIS Desktop 10.7.0 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils.
  • 10.8.0ArcGIS Desktop 10.8.0 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils.
  • 10.8.2ArcGIS Desktop 10.8.2 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils.
  • 2.2ArcGIS Pro 2.2 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils.
  • 2.3ArcGIS Pro 2.3 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils.
  • 2.4ArcGIS Pro 2.4 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils.
  • 2.5ArcGIS Pro 2.5 est utilisé pour l'analyse des problèmes de compatibilité de la boîte à outils.
  • 2.6ArcGIS Pro 2.6 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils.
  • 2.7ArcGIS Pro 2.7 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils.
  • 2.8ArcGIS Pro 2.8 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils.
  • 2.9ArcGIS Pro 2.9 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils.
String
Fichier en sortie
(Facultatif)

Fichier texte à créer et contenant les problèmes de compatibilité identifiés par les analyseurs.

File

arcpy.management.AnalyzeToolboxForVersion(in_toolbox, version, {report})
NomExplicationType de données
in_toolbox

Boîte à outils en entrée (.tbx ou .atbx) à analyser.

Le format de boîte à outils Python (.pyt) n’est pas pris en charge comme entrée.

Toolbox
version

Spécifie la version du logiciel à utiliser pour l’analyse de compatibilité de la boîte à outils.

  • 10.6.0ArcGIS Desktop 10.6.0 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils.
  • 10.7.0ArcGIS Desktop 10.7.0 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils.
  • 10.8.0ArcGIS Desktop 10.8.0 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils.
  • 10.8.2ArcGIS Desktop 10.8.2 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils.
  • 2.2ArcGIS Pro 2.2 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils.
  • 2.3ArcGIS Pro 2.3 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils.
  • 2.4ArcGIS Pro 2.4 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils.
  • 2.5ArcGIS Pro 2.5 est utilisé pour l'analyse des problèmes de compatibilité de la boîte à outils.
  • 2.6ArcGIS Pro 2.6 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils.
  • 2.7ArcGIS Pro 2.7 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils.
  • 2.8ArcGIS Pro 2.8 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils.
  • 2.9ArcGIS Pro 2.9 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils.
String
report
(Facultatif)

Fichier texte à créer et contenant les problèmes de compatibilité identifiés par les analyseurs.

File

Exemple de code

Exemple 1 d’utilisation de la fonction AnalyzeToolboxForVersion (fenêtre Python)

Le script ci-dessous pour la fenêtre Python illustre l’utilisation de la fonction AnalyzeToolboxForVersion en mode immédiat.

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

Environnements

Cet outil n’utilise pas d’environnement de géotraitement.

Informations de licence

  • Basic: Oui
  • Standard: Oui
  • Advanced: Oui

Rubriques connexes