Enregistrer la boîte à outils dans une version (Outils de gestion des données)
Résumé
Analyse et enregistre une boîte à outils à utiliser avec une version antérieure spécifique du logiciel ArcGIS.
Les analyseurs vérifient divers problèmes de compatibilité des outils de géotraitement entre la version installée d’ArcGIS Pro et une version cible spécifiée. Pour obtenir une liste de problèmes de compatibilité, reportez-vous à l’outil [Analyser la boîte à outils pour une version], car il utilise la même logique d’analyseur.
Les analyseurs de l’outil signalent les problèmes de compatibilité avec les outils basés sur ModelBuilder et Python (uniquement pour les outils de script dont la source est un fichier Python). Les actions effectuées se distinguent comme suit :
Model tool—Certains types de problèmes de compatibilité sont résolus dans le cadre de l’opération.
Script tool—Aucune modification n’est apportée au fichier source de l’outil.
Utilisation
Cet outil crée une boîte à outils en sortie dans laquelle le résultat est écrit. La boîte à outils d’origine n'est pas modifiée. Il est conseillé de conserver la boîte à outils d'origine pour éviter toute perte de données.
Aucune action n’est nécessaire pour utiliser une boîte à outils dans une version ultérieure spécifique.
Les outils de la boîte à outils en sortie risquent de générer des résultats incohérents par rapport à ceux d’origine. Vérifiez la cohérence des outils de la boîte à outils en sortie.
Certaines fonctionnalités des modèles, en particulier celles liées aux filtres, domaines et listes d'options (listes déroulantes de valeurs), sont supprimées de la boîte à outils en sortie. Pour corriger cela, ajoutez et reconnectez les outils appropriés au processus du modèle.
Pour les outils de script, le chemin du fichier Python de l'outil n'est pas modifié dans la boîte à outils en sortie. Les outils de script dans la boîte à outils d’origine et celle en sortie utilisent le même fichier. Si des modifications sont nécessaires, créez une copie du fichier .py et mettez à jour l’une des deux propriétés Script file (Fichier de script) de l’outil de script pour utiliser le deuxième fichier .py. Cela ne s'applique pas aux outils de script avec un fichier de script imbriqué.
Certains problèmes de compatibilité ne peuvent pas être réparés par cet outil. Par exemple, les types de données non présents dans la version cible génèrent une erreur. Pour résoudre ce problème, créez une copie de la boîte à outils, supprimez manuellement les données problématiques et utilisez cette boîte à outils en entrée.
Boîte à outils en entrée (fichier .tbx ou .atbx) à analyser et enregistrer. Le fichier n'est pas modifié.
Le format de boîte à outils Python (fichier .pyt) n’est pas pris en charge en entrée.
Toolbox
Version cible
Spécifie la version de logiciel à utiliser pour l'analyse des problèmes de compatibilité de la boîte à outils.
ArcGIS Desktop 10.6.0—ArcGIS Desktop 10.6.0 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils. La boîte à outils en sortie est enregistrée dans cette version.
ArcGIS Desktop 10.7.0—ArcGIS Desktop 10.7.0 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils. La boîte à outils en sortie est enregistrée dans cette version.
ArcGIS Desktop 10.8.0—ArcGIS Desktop 10.8.0 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils. La boîte à outils en sortie est enregistrée dans cette version.
ArcGIS Desktop 10.8.2—ArcGIS Desktop 10.8.2 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils. La boîte à outils en sortie est enregistrée dans cette version.
ArcGIS Pro 2.2—ArcGIS Pro 2.2 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils. La boîte à outils en sortie est enregistrée dans cette version.
ArcGIS Pro 2.3—ArcGIS Pro 2.3 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils. La boîte à outils en sortie est enregistrée dans cette version.
ArcGIS Pro 2.4—ArcGIS Pro 2.4 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils. La boîte à outils en sortie est enregistrée dans cette version.
ArcGIS Pro 2.5—ArcGIS Pro 2.5 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils. La boîte à outils en sortie est enregistrée dans cette version.
ArcGIS Pro 2.6—ArcGIS Pro 2.6 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils. La boîte à outils en sortie est enregistrée dans cette version.
ArcGIS Pro 2.7—ArcGIS Pro 2.7 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils. La boîte à outils en sortie est enregistrée dans cette version.
ArcGIS Pro 2.8—ArcGIS Pro 2.8 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils. La boîte à outils en sortie est enregistrée dans cette version.
ArcGIS Pro 2.9—ArcGIS Pro 2.9 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils. La boîte à outils en sortie est enregistrée dans cette version.
ArcGIS Pro 3.0—ArcGIS Pro 3.0 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils. La boîte à outils en sortie est enregistrée dans cette version.
ArcGIS Pro 3.1—ArcGIS Pro 3.1 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils. La boîte à outils en sortie est enregistrée dans cette version.
ArcGIS Pro 3.2—ArcGIS Pro 3.2 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils. La boîte à outils en sortie est enregistrée dans cette version.
ArcGIS Pro 3.3—ArcGIS Pro 3.3 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils. La boîte à outils en sortie est enregistrée dans cette version.
ArcGIS Pro 3.4—ArcGIS Pro 3.4 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils. La boîte à outils en sortie est enregistrée dans cette version.
ArcGIS Pro 3.5—ArcGIS Pro 3.5 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils. La boîte à outils en sortie est enregistrée dans cette version.
ArcGIS Pro 3.6—ArcGIS Pro 3.6 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils. La boîte à outils en sortie est enregistrée dans cette version.
String
Boîte à outils en sortie
Boîte à outils créée pour être utilisée avec une version du logiciel ArcGIS correspondant à la valeur spécifiée dans le paramètre Target Version (Version cible).
Toolbox
Erreur sur l’outil manquant
(Facultatif)
Indique si une erreur est générée lorsqu’un outil qui n’est pas présent dans la version cible est détecté.
Activé—Une erreur est générée et la boîte à outils en sortie n’est pas créée. Il s’agit de l’option par défaut.
Décoché—Un message d’avertissement est généré et la boîte à outils en sortie est créée. Pour les outils de modèle, l'outil problématique est supprimé du modèle, ce qui requiert une modification manuelle.
Boolean
Erreur sur le paramètre requis manquant
(Facultatif)
Indique si une erreur est générée lorsqu’un paramètre non présent dans la version cible est détecté et que ce paramètre possède une valeur autre que la valeur par défaut.
Activé—Une erreur est générée et la boîte à outils en sortie n’est pas créée. Il s’agit de l’option par défaut.
Décoché—Un message d’avertissement est généré, le paramètre est supprimé du modèle et la boîte à outils en sortie est créée.
Boolean
Erreur sur la valeur de paramètre non valide
(Facultatif)
Indique si une erreur est générée lorsqu’une valeur de paramètre non présente dans son filtre de paramètres, dans la version cible, est détectée.
Activé—Une erreur est générée et la boîte à outils en sortie n’est pas créée. Il s’agit de l’option par défaut.
Décoché—Un message d’avertissement est généré et la boîte à outils en sortie est créée. La boîte à outils en sortie génère une erreur si une valeur ne se trouve pas dans le domaine ou qu'elle n'est pas valide.
Boîte à outils en entrée (fichier .tbx ou .atbx) à analyser et enregistrer. Le fichier n'est pas modifié.
Le format de boîte à outils Python (fichier .pyt) n’est pas pris en charge en entrée.
Toolbox
version
Spécifie la version de logiciel à utiliser pour l'analyse des problèmes de compatibilité de la boîte à outils.
10.6.0—ArcGIS Desktop 10.6.0 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils. La boîte à outils en sortie est enregistrée dans cette version.
10.7.0—ArcGIS Desktop 10.7.0 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils. La boîte à outils en sortie est enregistrée dans cette version.
10.8.0—ArcGIS Desktop 10.8.0 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils. La boîte à outils en sortie est enregistrée dans cette version.
10.8.2—ArcGIS Desktop 10.8.2 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils. La boîte à outils en sortie est enregistrée dans cette version.
2.2—ArcGIS Pro 2.2 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils. La boîte à outils en sortie est enregistrée dans cette version.
2.3—ArcGIS Pro 2.3 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils. La boîte à outils en sortie est enregistrée dans cette version.
2.4—ArcGIS Pro 2.4 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils. La boîte à outils en sortie est enregistrée dans cette version.
2.5—ArcGIS Pro 2.5 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils. La boîte à outils en sortie est enregistrée dans cette version.
2.6—ArcGIS Pro 2.6 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils. La boîte à outils en sortie est enregistrée dans cette version.
2.7—ArcGIS Pro 2.7 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils. La boîte à outils en sortie est enregistrée dans cette version.
2.8—ArcGIS Pro 2.8 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils. La boîte à outils en sortie est enregistrée dans cette version.
2.9—ArcGIS Pro 2.9 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils. La boîte à outils en sortie est enregistrée dans cette version.
3.0—ArcGIS Pro 3.0 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils. La boîte à outils en sortie est enregistrée dans cette version.
3.1—ArcGIS Pro 3.1 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils. La boîte à outils en sortie est enregistrée dans cette version.
3.2—ArcGIS Pro 3.2 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils. La boîte à outils en sortie est enregistrée dans cette version.
3.3—ArcGIS Pro 3.3 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils. La boîte à outils en sortie est enregistrée dans cette version.
3.4—ArcGIS Pro 3.4 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils. La boîte à outils en sortie est enregistrée dans cette version.
3.5—ArcGIS Pro 3.5 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils. La boîte à outils en sortie est enregistrée dans cette version.
3.6—ArcGIS Pro 3.6 est utilisé pour l’analyse des problèmes de compatibilité de la boîte à outils. La boîte à outils en sortie est enregistrée dans cette version.
String
out_toolbox
Boîte à outils créée pour être utilisée avec une version du logiciel ArcGIS correspondant à la valeur spécifiée dans le paramètre version.
Toolbox
missing_tool
(Facultatif)
Indique si une erreur est générée lorsqu’un outil qui n’est pas présent dans la version cible est détecté.
ERROR_ON_MISSING_TOOL—Une erreur est générée et la boîte à outils en sortie n’est pas créée. Il s’agit de l’option par défaut.
WARN_ON_MISSING_TOOL—Un message d’avertissement est généré et la boîte à outils en sortie est créée. Pour les outils de modèle, l'outil problématique est supprimé du modèle, ce qui requiert une modification manuelle.
Boolean
missing_param
(Facultatif)
Indique si une erreur est générée lorsqu’un paramètre non présent dans la version cible est détecté et que ce paramètre possède une valeur autre que la valeur par défaut.
ERROR_ON_MISSING_REQUIRED_PARAM—Une erreur est générée et la boîte à outils en sortie n’est pas créée. Il s’agit de l’option par défaut.
WARN_ON_MISSING_REQUIRED_PARAM—Un message d’avertissement est généré, le paramètre est supprimé du modèle et la boîte à outils en sortie est créée.
Boolean
invalid_param_value
(Facultatif)
Indique si une erreur est générée lorsqu’une valeur de paramètre non présente dans son filtre de paramètres, dans la version cible, est détectée.
ERROR_ON_INVALID_PARAM_VALUE—Une erreur est générée et la boîte à outils en sortie n’est pas créée. Il s’agit de l’option par défaut.
WARN_ON_INVALID_PARAM_VALUE—Un message d’avertissement est généré et la boîte à outils en sortie est créée. La boîte à outils en sortie génère une erreur si une valeur ne se trouve pas dans le domaine ou qu'elle n'est pas valide.
Boolean
Exemple de code
Exemple d'utilisation de SaveToolboxToVersion (fenêtre Python)
Le script de fenêtre Python ci-dessous illustre l’utilisation de la fonction SaveToolboxToVersion en mode immédiat.