| Étiquette | Explication | Type de données |
Entrée | Boîte à outils en entrée (fichier .tbx ou .atbx) à analyser. Le format de boîte à outils Python (fichier .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.
| String |
Fichier en sortie (Facultatif) | Fichier texte à créer et contenant les problèmes de compatibilité identifiés par les analyseurs. | File |
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
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.
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).
Paramètres
arcpy.management.AnalyzeToolboxForVersion(in_toolbox, version, {report})| Nom | Explication | Type de données |
in_toolbox | Boîte à outils en entrée (fichier .tbx ou .atbx) à analyser. Le format de boîte à outils Python (fichier .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.
| String |
report (Facultatif) | Fichier texte à créer et contenant les problèmes de compatibilité identifiés par les analyseurs. | File |
Exemple de code
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
Vous avez un commentaire à formuler concernant cette rubrique ?