A propos des tables d'historique de la boîte à outils

A chaque version, Esri modifie des outils existants et intègre de nouveaux outils. Ces modifications apportent des solutions à des problèmes qui étaient difficiles à résoudre dans les versions précédentes, tout en optimisant les outils et en simplifiant leur utilisation. La documentation concernant toutes les boîtes à outils standard d'ArcGIS contient une rubrique d'historique des boîtes à outils qui répertorie les modifications apportées aux outils à chaque version. Vous trouverez ci-dessous des informations sur les modalités d'utilisation et d'interprétation de ces rubriques d'historique des boîtes à outils.

Pour consulter un exemple de rubrique d'historique des boîtes à outils, reportez-vous à Historique de la boîte à outils d'analyse.

Esri s'efforce d'assurer la rétrocompatibilité. Cela n'est toutefois pas toujours possible en raison des nouvelles fonctionnalités qui sont intégrées. Voici les cas où la rétrocompatibilité risque de ne pas être assurée :

  • Si un paramètre a été supprimé, les anciens workflows qui utilisaient le paramètre ne fonctionneront plus.
  • Si une option de paramètre a été supprimée, les anciens workflows qui utilisaient l'option risquent de ne plus fonctionner. Dans de nombreux cas, l'option qui a été supprimée est remplacée par une autre option et l'outil connaît le comportement à adopter si l'option précédente a été spécifiée.
  • Si un paramètre disposait d'un type de données supprimé et que votre ancien workflow utilisait des entrées de ce type de données, l'ancien workflow ne fonctionnera pas dans la nouvelle version.
  • Un changement de licence peut affecter votre workflow. La plupart des changements de licence sont descendants (de Desktop Advanced vers Desktop Standard, par exemple), ce qui n'affecte pas la rétrocompatibilité.
  • Un changement d'extension peut affecter votre workflow. Les changements d'extension qui affectent les workflows existants sont rares.
  • Si la valeur par défaut d'un paramètre a changé, votre workflow peut être affecté. Vous devez dans ce cas examiner vos workflows existants pour déterminer l'effet du changement de la valeur par défaut.
  • Si l'ordre des paramètres a changé, les scripts qui utilisent des arguments de position peuvent s'interrompre.

Vous trouverez ci-dessous plus d'informations sur les changements consignés dans les tables d'historique.

Nouveautés de la version

La dernière ligne de chaque table contient toujours la version dans laquelle l'outil a été intégré dans la boîte à outils.

Transféré/Non transféré vers ArcGIS Pro

Si vous passez d'ArcMap à ArcGIS Pro, il peut être intéressant de savoir si un outil dans ArcMap est également disponible dans ArcGIS Pro. La majorité des outils présents dans la version 10.3 ont été transférés dans (c'est-à-dire répliqués et rendus disponibles dans) ArcGIS Pro version 1.0. La première ligne de la table indique généralement si l'outil a été transféré d'ArcMap vers la plateforme ArcGIS Pro. Vous pouvez maintenant utiliser l'outil Analyser les outils pour Pro pour savoir si vos modèles et scripts ArcMap s'exécuteront dans ArcGIS Pro.

Remarque :

Les informations concernant le transfert des outils d'ArcMap vers ArcGIS Pro sont disponibles uniquement pour ArcMap version 10.3 et 10.3.1. Par exemple, si un outil a été transféré d'ArcMap 10.4 vers ArcGIS Pro, ou a été transféré d'ArcGIS Pro vers ArcMap 10.4, ces informations ne sont pas consignées dans les tables d'historique.

Options de paramètre

Une option de paramètre (également connue sous le nom d'énumérateur) est une chaîne qui affecte l'exécution de l'outil. Par exemple, le paramètre join_attributes de l'outil Intersecter possède trois options : ALL, NO_FID et FID_ONLY. De nouvelles options apparaissent de temps en temps d'une version à une autre et certaines options peuvent être supprimées. Une option intégrée dans une version ultérieure (par exemple, 10.4) ne peut pas être utilisée dans une version antérieure (par exemple, 10.3).

Il peut arriver qu'une option soit supprimée et remplacée par une option très similaire, par exemple Euclidean distance remplacée par EUCLIDEAN_DISTANCE. Dans ce cas, l'outil est programmé pour accepter les deux options et la rétrocompatibilité est assurée.

Paramètres nouveaux et supprimés

Les nouveaux paramètres sont presque toujours ajoutés en dernier afin que la rétrocompatibilité soit assurée dans les scripts. Toutefois, il peut arriver que le nouveau paramètre doive être inséré entre des paramètres existants et la compatibilité dans les scripts risque de ne pas être assurée. Vous devez peut-être alors modifier votre script pour l'exécuter dans la dernière version. Si un nouveau paramètre est inséré entre des paramètres existants, le changement d'ordre des paramètres est indiqué.

Les paramètres supprimés sont rares. Les scripts qui utilisent le paramètre supprimé doivent être modifiés, mais les modèles doivent continuer à s'exécuter.

Changement de valeur par défaut des paramètres

Les paramètres facultatifs ont une valeur par défaut : la valeur qui va être utilisée si vous ne la modifiez pas. Si la valeur par défaut d'un paramètre est modifiée, vos modèles et scripts existants peuvent être affectés.

Changement du type de données des paramètres

Un type de données définit les valeurs autorisées d'un paramètre, par exemple le type de jeux de données (entités, tables, réseaux, etc.). Si un type de données est supprimé dans une version, cela signifie que le paramètre n'accepte plus le jeu de données en entrée ou en sortie. Vous pouvez être amené à modifier vos modèles et vos scripts s'ils utilisent le type de données supprimé.

Ordre des paramètres

Les nouveaux paramètres sont presque toujours ajoutés en dernier et n'affectent pas l'ordre des paramètres existants. Dans de rares cas, l'ordre des paramètres existants peut changer et les scripts qui utilisent des arguments de position peuvent s'interrompre. Au lieu d'utiliser des arguments de position, vous pouvez utiliser des arguments de mots-clés comme illustré ci-dessous. Les modèles continueront à s'exécuter, car ils ne dépendent pas de l'ordre des paramètres.


# Positional arguments - skipping optional arguments using empty strings is dependent on 
#  the order of the optional parameters
#
arcpy.AddField_management("schools", "school_id", "LONG", "", "", "", "", "NON_NULLABLE")
# Keyword arguments - position doesn't matter
#
arcpy.AddField_management("schools", "school_id", "LONG", field_is_nullable="NON_NULLABLE")

Casse du nom des paramètres

La casse du nom d'un paramètre peut changer, par exemple de In_Features en in_features. Ce changement affecte uniquement les scripts qui utilisent des arguments de mots-clés. Dans Python, les arguments de mots-clés sont sensibles à la casse.

Type de paramètre

Un type de paramètre peut passer d'obligatoire à facultatif ou de facultatif à obligatoire. Le changement de facultatif à obligatoire peut affecter les workflows existants.

Extension et licence des outils

Un changement d'extension ou de licence peut affecter les workflows existants.

Modifications apportées à l'environnement

A partir d'ArcGIS Pro 1.3, les tables d'historique effectuent le suivi des modifications apportées aux paramètres d'environnement de géotraitement respectés par chaque outil.

Outil déconseillé

Reportez-vous à la rubrique Qu'est-ce qu'un outil déconseillé ? pour plus d'informations.