Rubriques d’historique des boîtes à outils

À chaque version, Esri introduit de nouveaux outils et améliore les outils existants. Ces modifications apportent des solutions à des problèmes qui étaient difficiles à résoudre dans les versions précédentes, tout en améliorant les outils et en simplifiant l’utilisation.

La documentation de chaque boîte à outils d’ArcGIS inclut une rubrique d’historique des boîtes à outils qui répertorie les modifications apportées aux outils à chaque version. Pour un exemple, reportez-vous à la rubrique Historique de la boîte à outils d’analyse. Pour chaque outil, une table contenant des informations sur le développement historique de l’outil est fournie. Vous trouverez ci-après des informations sur les types de modifications consignées dans les rubriques d’historique.

• Origines de l’outil
  • Nouveauté de cette version : la ligne inférieure de chaque table d’outil contient généralement la version à laquelle l’outil a été introduit pour la première fois.
  • Transféré à partir de ArcMap : si vous passez de ArcMap à ArcGIS Pro, il peut être intéressant de savoir si un outil de ArcMap est également disponible dans ArcGIS Pro. La majorité des outils présents dans ArcMap 10.3 étaient disponibles dans ArcGIS Pro 1.0. Si l’outil est apparu dans ArcMap, ces informations sont généralement indiquées dans la ligne inférieure de la table.

• Informations sur les paramètres
  • Paramètres nouveaux et supprimés : un nouveau paramètre est presque toujours ajouté à la fin des paramètres d’un outil afin d’assurer la rétrocompatibilité dans les scripts.

    La suppression de paramètres est rare. Les scripts qui utilisent le paramètre supprimé doivent être mis à jour, mais les modèles doivent continuer de fonctionner.

  • Options : une option de paramètre est un mot-clé au format chaîne qui affecte le mode de fonctionnement d’un outil. Par exemple, le paramètre join_attributes de l’outil Intersect (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).

    Dans des cas assez rares, il peut arriver qu’un mot-clé soit supprimé et remplacé par une option similaire (par exemple, Euclidean distance remplacé par EUCLIDEAN_DISTANCE). Dans ce cas, l'outil est programmé pour accepter les deux options et la rétrocompatibilité est assurée.

  • Modifications de valeurs par défaut : les paramètres facultatifs possèdent souvent une valeur par défaut ; la valeur 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.
  • Modifications de types : le type de données d’un paramètre définit les valeurs acceptées par ce dernier, comme 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 ce type de données. Vous pouvez être amené à modifier vos modèles et vos scripts s'ils utilisent le type de données supprimé.
  • Ordre : 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 continuent de fonctionner 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.management.AddField("schools", "school_id", "LONG", "", "", "", "", "NON_NULLABLE")
    
    # Keyword arguments - position doesn't matter
    arcpy.management.AddField("schools", "school_id", "LONG", field_is_nullable="NON_NULLABLE")

  • Casse du nom : 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 des mots-clés sont sensibles à la casse.
  • Type : le type d’un paramètre peut passer d’obligatoire à facultatif ou de facultatif à obligatoire. Le changement de facultatif à obligatoire peut affecter les workflows existants.
• Licences et extensions
  • Licence et extension d’un outil : un changement d’extension ou de licence peut affecter les processus existants.
• Obsolescence
  • Obsolescence : un outil de géotraitement obsolète est un outil qui a été remplacé par d’autres. L’outil reste dans ArcGIS Pro, mais il ne fait l’objet d’aucun autre développement.

    En savoir plus sur les outils obsolètes

Compatibilité

Esri s’efforce d’assurer la rétrocompatibilité. À savoir, les modèles et scripts créés dans une version précédente doivent continuer de fonctionner dans la plupart des cas. Dans des cas assez rares, des changements de compatibilité peuvent survenir en raison des nouvelles fonctionnalités intégrées. Voici quelques cas où la rétrocompatibilité risque de ne pas être assurée :

• Si un paramètre a été supprimé, les processus qui l’utilisaient ne fonctionnent plus.
• Si une option de paramètre a été supprimée, les processus qui l’utilisaient 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 processus utilisait des entrées de ce type de données, l’ancien processus ne fonctionne 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 requise peut affecter votre processus. 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.