工具箱历史记录主题

每次发布时，Esri 会引入一些新工具并增强现有工具。 这些更改提供解决方案以解决在之前版本中难以解决的问题，同时改进工具，提高其易用性。

ArcGIS 中每个工具箱的对应文档均包含工具箱历史记录主题，其中详述了在每个版本中对工具所做的更改。 有关示例，请参阅分析工具箱历史记录。 针对每个工具提供了一个表，用于介绍有关工具历史发展的信息。 下面包含有关在历史记录主题中编目的更改类型的信息。

• 工具来源
  • 此版本的新功能 - 每个工具表的最后一行通常包含首次引用工具的版本。
  • 从 ArcMap 移植 - 如果要从 ArcMap 过渡到 ArcGIS Pro，您可能需要了解 ArcMap 中的工具在 ArcGIS Pro 中是否也可用。 ArcMap 10.3 中提供的大多数工具在 ArcGIS Pro 1.0 中可用。如果工具源自 ArcMap，此信息通常位于表的最后一行。

• 参数信息
  • 新参数和已移除参数 - 新参数几何总是添加到工具参数的末尾，以确保在脚本中保持向后兼容性。

    很少会移除参数。 将需要更新使用已移除参数的脚本，但是模型应继续运行。

  • 选项 - 参数选项为影响工具工作原理的字符串关键字。 例如，相交工具的 join_attributes 参数有三个选项：ALL、NO_FID 和 FID_ONLY。 在版本切换的过程中，有时会出现新选项，有时也可能已移除了某些选项。 较新版本（例如 10.4）引入的选项不能用于较早版本（例如 10.3）中。

    在极少数情况下，将移除关键字并替换为类似选项，例如 Euclidean distance 替换为 EUCLIDEAN_DISTANCE。 在这种情况下，工具已设置为接受任一选项，且向后兼容性未损坏。

  • 默认值更改 - 可选参数通常具有默认值 - 未对其进行更改时将使用的值。 如果对参数的默认值进行了更改，则可能会影响现有模型或脚本。
  • 类型更改 - 参数的数据类型定义了参数将接受的允许值，例如数据集类型（要素、表、网络等）。 如果从一个版本中移除某个数据类型，则表示参数将不再接受该数据类型。 如果模型或脚本使用已移除的数据类型，则您可能需要对其进行更改。
  • 顺序 - 新参数几乎总是作为最后一个参数进行添加，因此不会影响现有参数的顺序。 在极少数情况下，现有参数的顺序可能会发生更改，使用位置参数的脚本可能会中断。 您可以使用如下所示的关键字参数，而不使用位置参数。 由于模型不依赖于参数顺序，所以模型仍可运行。
    # 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")

  • 名称大小写 - 参数名称可以更改大小写，例如，从 In_Features 更改为 in_features。 此变更仅会影响使用关键字参数的脚本。 在 Python 中，关键字参数区分大小写。
  • 类型 - 参数类型可从必填更改为可选，也可从可选更改为必填。 从可选项更改为必选项可能会对现有工作流产生影响。
• 许可和扩展模块
  • 工具许可和扩展 - 许可或扩展更改可能会对现有工作流产生影响。
• 弃用
  • 弃用 - 弃用地理处理工具是已被其他工具替代的工具。 工具仍在 ArcGIS Pro 中，但不再对其执行进一步开发。

    详细了解已弃用工具

兼容性

Esri 始终力求维护向后兼容性。 即在大多数情况下，应能够继续使用在先前版本中创建的模型和脚本。 在极少数情况下，兼容性可能因引入的新功能发生变化。 下面介绍了可能无法实现向后兼容性的案例：

• 如果某个参数已移除，则使用该参数的工作流将不再有效。
• 如果某个参数选项已移除，则使用该选项的工作流将不再有效。 在许多情况下，被移除的选项会被另一个选项所替换，而且如果已指定之前的选项，工具会知道如何进行操作。
• 如果已移除参数的某个数据类型，且您的工作流使用的输入为该数据类型，则此旧工作流将无法在新版本中运行。
• 许可更改可能会影响工作流。 大多数许可更改是向下的（例如，从 Desktop Advanced 到 Desktop StandardStandard），不会对向后兼容性产生影响。
• 扩展要求更改可能会影响工作流。 扩展更改很少会影响现有的工作流。
• 如果更改了参数的默认值，则可能会影响您的工作流。 您需要检查现有工作流以确定默认值更改带来的影响。
• 如果参数顺序发生了更改，则使用位置参数的脚本可能会中断。