分析工具箱的版本 (数据管理)

摘要

分析工具箱的内容并识别与 ArcGIS 软件先前版本的兼容性问题。

此工具可评估工具箱(适用于基于 模型构建器Python 的工具)并确定其中包含的 ArcGIS Pro 地理处理工具。 然后,工具会识别正在使用的软件版本与指定目标版本之间的兼容性问题。 兼容性问题显示为警告消息,并且您可以选择将其写入文本文件。

了解有关将工具箱保存到先前版本的详细信息

使用情况

    注:

    ArcGIS Pro 支持地理处理工具的向后兼容性。 使用较早版本的软件创建的模型和脚本可供更高版本的软件使用。 例如,在 ArcGIS Pro 2.9 创建的模型可以在 ArcGIS Pro 3.0 中使用。 分析工具箱的版本工具旨在识别在软件的更高版本(例如 ArcGIS Pro 3.0)中创建(或编辑)工具箱后续用于较早版本的软件(例如,ArcGIS Pro 2.9)时存在的兼容性问题。

  • 不会修改输入工具箱。 要更新工具箱,请使用将工具箱保存到版本工具。

  • 此工具的兼容性分析程序可追踪每个地理处理工具与每个目标版本的已知兼容性问题的列表。

  • 仅针对 ArcGIS Pro 系统工具箱追踪兼容性问题。

  • 此工具的分析程序不追踪 ArcPy 中的非地理处理工具函数。 对非地理处理函数的更改(例如,对 arcpy.da.SearchCursor 的更改)可能导致兼容性问题。

  • 兼容性分析程序可识别并报告以下兼容性问题:

    • 目标版本中不存在的系统工具箱中的地理处理工具。 例如,PDF 转 TIFF 工具在 ArcGIS Pro 2.9 版本之前不可用。
    • 模型变量或工具参数的地理处理数据类型在目标版本中不存在(仅限模型)。 例如,自 ArcGIS Pro 2.6 开始才支持体素图层 (GPVoxelLayer) 的数据类型。
    • 目标版本中不存在的工具参数。 例如,模板表参数在 ArcGIS Pro 2.6 中添加到添加字段(多个)工具。
    • 对工具参数某些属性的修改。 对以下参数属性的修改将生成兼容性警告:
      • 参数类型 - 参数类型可以是必需、可选或派生。
      • 方向 - 参数的方向可以是输入或输出。
      • 值 - 参数的默认值。
      • 多值 - 参数可以支持单个或多个值。
      • 数据类型 - 参数的数据类型,例如要素类 (DEFeatureClass)。
      • 过滤器列表 - 限制哪些值可视为有效参数值的选项和过滤器。
      • 过滤器类型 - 与参数关联的过滤器类型。 例如,参数可以没有过滤器、值列表或值范围(例如,0 到 10)。 通常,过滤器类型的变化是从没有过滤器到有过滤器。

参数

标注说明数据类型
输入

将要分析的输入工具箱(.tbx.atbx 文件)。

不支持将 Python 工具箱格式(.pyt 文件)作为输入。

Toolbox
目标版本

指定将用于工具箱兼容性分析的软件版本。

  • ArcGIS Desktop 10.6.0ArcGIS Desktop 10.6.0 将用于工具箱兼容性问题分析。
  • ArcGIS Desktop 10.7.0ArcGIS Desktop 10.7.0 将用于工具箱兼容性问题分析。
  • ArcGIS Desktop 10.8.0ArcGIS Desktop 10.8.0 将用于工具箱兼容性问题分析。
  • ArcGIS Desktop 10.8.2ArcGIS Desktop 10.8.2 将用于工具箱兼容性问题分析。
  • ArcGIS Pro 2.2ArcGIS Pro 2.2 将用于工具箱兼容性问题分析。
  • ArcGIS Pro 2.3ArcGIS Pro 2.3 将用于工具箱兼容性问题分析。
  • ArcGIS Pro 2.4ArcGIS Pro 2.4 将用于工具箱兼容性问题分析。
  • ArcGIS Pro 2.5ArcGIS Pro 2.5 将用于工具箱兼容性问题分析。
  • ArcGIS Pro 2.6ArcGIS Pro 2.6 将用于工具箱兼容性问题分析。
  • ArcGIS Pro 2.7ArcGIS Pro 2.7 将用于工具箱兼容性问题分析。
  • ArcGIS Pro 2.8ArcGIS Pro 2.8 将用于工具箱兼容性问题分析。
  • ArcGIS Pro 2.9ArcGIS Pro 2.9 将用于工具箱兼容性问题分析。
  • ArcGIS Pro 3.0ArcGIS Pro 3.0 将用于工具箱兼容性问题分析。
  • 3.1ArcGIS Pro 3.1 将用于工具箱兼容性问题分析。
  • 3.2ArcGIS Pro 3.2 将用于工具箱兼容性问题分析。
String
输出文件
(可选)

将创建的文本文件,其中包含分析程序识别的兼容性问题。

File

arcpy.management.AnalyzeToolboxForVersion(in_toolbox, version, {report})
名称说明数据类型
in_toolbox

将要分析的输入工具箱(.tbx.atbx 文件)。

不支持将 Python 工具箱格式(.pyt 文件)作为输入。

Toolbox
version

指定将用于工具箱兼容性分析的软件版本。

  • 10.6.0ArcGIS Desktop 10.6.0 将用于工具箱兼容性问题分析。
  • 10.7.0ArcGIS Desktop 10.7.0 将用于工具箱兼容性问题分析。
  • 10.8.0ArcGIS Desktop 10.8.0 将用于工具箱兼容性问题分析。
  • 10.8.2ArcGIS Desktop 10.8.2 将用于工具箱兼容性问题分析。
  • 2.2ArcGIS Pro 2.2 将用于工具箱兼容性问题分析。
  • 2.3ArcGIS Pro 2.3 将用于工具箱兼容性问题分析。
  • 2.4ArcGIS Pro 2.4 将用于工具箱兼容性问题分析。
  • 2.5ArcGIS Pro 2.5 将用于工具箱兼容性问题分析。
  • 2.6ArcGIS Pro 2.6 将用于工具箱兼容性问题分析。
  • 2.7ArcGIS Pro 2.7 将用于工具箱兼容性问题分析。
  • 2.8ArcGIS Pro 2.8 将用于工具箱兼容性问题分析。
  • 2.9ArcGIS Pro 2.9 将用于工具箱兼容性问题分析。
  • 3.0ArcGIS Pro 3.0 将用于工具箱兼容性问题分析。
  • 3.1ArcGIS Pro 3.1 将用于工具箱兼容性问题分析。
  • 3.2ArcGIS Pro 3.2 将用于工具箱兼容性问题分析。
String
report
(可选)

将创建的文本文件,其中包含分析程序识别的兼容性问题。

File

代码示例

AnalyzeToolboxForVersion 示例 1(Python 窗口)

以下 Python 窗口脚本演示了如何在即时模式下使用 AnalyzeToolboxForVersion 函数。

import arcpy
arcpy.management.AnalyzeToolboxForVersion(r"C:\toolboxes\MyTools.atbx", "2.7")

环境

此工具不使用任何地理处理环境。

许可信息

  • Basic: 是
  • Standard: 是
  • Advanced: 是

相关主题