分析工具箱的版本 (数据管理工具)
汇总
用于分析工具箱的内容并识别与 ArcGIS 软件先前版本的兼容性问题。
此工具可评估工具箱(适用于基于 ModelBuilder 和 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 中添加到添加字段(多个) 工具。
对工具参数某些属性的修改。 对以下参数属性的修改将生成兼容性警告:
Parameter type—参数类型可以是必需、可选或派生。
Direction—参数的方向可以是输入或输出。
Value—参数的默认值。
Multivalue—参数可以支持单个值或多个值。
Data type—参数的数据类型,例如要素类 (DEFeatureClass)。
Filter list—限制哪些值可视为有效参数值的选项和过滤器。
Filter type—与参数关联的过滤器类型。 例如,参数可以没有过滤器、值列表或值范围(例如,0 到 10)。 通常,过滤器类型的变化是从没有过滤器到有过滤器。
参数
标注
说明
数据类型
输入
将要分析的输入工具箱(.tbx 或 .atbx 文件)。
不支持将 Python 工具箱格式(.pyt 文件)作为输入。
Toolbox
目标版本
指定将用于工具箱兼容性分析的软件版本。
ArcGIS Desktop 10.6.0 —ArcGIS Desktop 10.6.0 将用于工具箱兼容性问题分析。
ArcGIS Desktop 10.7.0 —ArcGIS Desktop 10.7.0 将用于工具箱兼容性问题分析。
ArcGIS Desktop 10.8.0 —ArcGIS Desktop 10.8.0 将用于工具箱兼容性问题分析。
ArcGIS Desktop 10.8.2 —ArcGIS Desktop 10.8.2 将用于工具箱兼容性问题分析。
ArcGIS Pro 2.2 —ArcGIS Pro 2.2 将用于工具箱兼容性问题分析。
ArcGIS Pro 2.3 —ArcGIS Pro 2.3 将用于工具箱兼容性问题分析。
ArcGIS Pro 2.4 —ArcGIS Pro 2.4 将用于工具箱兼容性问题分析。
ArcGIS Pro 2.5 —ArcGIS Pro 2.5 将用于工具箱兼容性问题分析。
ArcGIS Pro 2.6 —ArcGIS Pro 2.6 将用于工具箱兼容性问题分析。
ArcGIS Pro 2.7 —ArcGIS Pro 2.7 将用于工具箱兼容性问题分析。
ArcGIS Pro 2.8 —ArcGIS Pro 2.8 将用于工具箱兼容性问题分析。
ArcGIS Pro 2.9 —ArcGIS Pro 2.9 将用于工具箱兼容性问题分析。
ArcGIS Pro 3.0 —ArcGIS Pro 3.0 将用于工具箱兼容性问题分析。
ArcGIS Pro 3.1 —ArcGIS Pro 3.1 将用于工具箱兼容性问题分析。
ArcGIS Pro 3.2 —ArcGIS Pro 3.2 将用于工具箱兼容性问题分析。
ArcGIS Pro 3.3 —ArcGIS Pro 3.3 将用于工具箱兼容性问题分析。
ArcGIS Pro 3.4 —ArcGIS Pro 3.4 将用于工具箱兼容性问题分析。
ArcGIS Pro 3.5 —ArcGIS Pro 3.5 将用于工具箱兼容性问题分析。
ArcGIS Pro 3.6 —ArcGIS Pro 3.6 将用于工具箱兼容性问题分析。
String
输出文件
(可选)
将创建的文本文件,其中包含分析程序识别的兼容性问题。
File
arcpy.management.AnalyzeToolboxForVersion(in_toolbox, version, {report})
名称
说明
数据类型
in_toolbox
将要分析的输入工具箱(.tbx 或 .atbx 文件)。
不支持将 Python 工具箱格式(.pyt 文件)作为输入。
Toolbox
version
指定将用于工具箱兼容性分析的软件版本。
10.6.0 —ArcGIS Desktop 10.6.0 将用于工具箱兼容性问题分析。
10.7.0 —ArcGIS Desktop 10.7.0 将用于工具箱兼容性问题分析。
10.8.0 —ArcGIS Desktop 10.8.0 将用于工具箱兼容性问题分析。
10.8.2 —ArcGIS Desktop 10.8.2 将用于工具箱兼容性问题分析。
2.2 —ArcGIS Pro 2.2 将用于工具箱兼容性问题分析。
2.3 —ArcGIS Pro 2.3 将用于工具箱兼容性问题分析。
2.4 —ArcGIS Pro 2.4 将用于工具箱兼容性问题分析。
2.5 —ArcGIS Pro 2.5 将用于工具箱兼容性问题分析。
2.6 —ArcGIS Pro 2.6 将用于工具箱兼容性问题分析。
2.7 —ArcGIS Pro 2.7 将用于工具箱兼容性问题分析。
2.8 —ArcGIS Pro 2.8 将用于工具箱兼容性问题分析。
2.9 —ArcGIS Pro 2.9 将用于工具箱兼容性问题分析。
3.0 —ArcGIS Pro 3.0 将用于工具箱兼容性问题分析。
3.1 —ArcGIS Pro 3.1 将用于工具箱兼容性问题分析。
3.2 —ArcGIS Pro 3.2 将用于工具箱兼容性问题分析。
3.3 —ArcGIS Pro 3.3 将用于工具箱兼容性问题分析。
3.4 —ArcGIS Pro 3.4 将用于工具箱兼容性问题分析。
3.5 —ArcGIS Pro 3.5 将用于工具箱兼容性问题分析。
3.6 —ArcGIS Pro 3.6 将用于工具箱兼容性问题分析。
String
report
(可选)
将创建的文本文件,其中包含分析程序识别的兼容性问题。
File
代码示例
AnalyzeToolboxForVersion 示例(Python 窗口)
以下 Python 窗口脚本演示了如何在即时模式下使用 AnalyzeToolboxForVersion 函数。
import arcpy
arcpy.management.AnalyzeToolboxForVersion(r"C:\toolboxes\MyTools.atbx", "3.0")
环境
此工具不使用任何地理处理环境。
许可信息