标注 | 说明 | 数据类型 |
输入 | 将要分析的输入工具箱(.tbx 或 .atbx 文件)。 不支持将 Python 工具箱格式(.pyt 文件)作为输入。 | Toolbox |
目标版本 | 指定将用于工具箱兼容性分析的软件版本。
| String |
输出文件 (可选) | 将创建的文本文件,其中包含分析程序识别的兼容性问题。 | File |
摘要
分析工具箱的内容并识别与 ArcGIS 软件先前版本的兼容性问题。
此工具可评估工具箱(适用于基于 模型构建器 和 Python 的工具)并确定其中包含的 ArcGIS AllSource 地理处理工具。 然后,工具会识别正在使用的软件版本与指定目标版本之间的兼容性问题。 兼容性问题显示为警告消息,并且您可以选择将其写入文本文件。
使用情况
不会修改输入工具箱。 要更新工具箱,请使用将工具箱保存到版本工具。
此工具的兼容性分析程序可追踪每个地理处理工具与每个目标版本的已知兼容性问题的列表。
仅针对 ArcGIS AllSource 系统工具箱追踪兼容性问题。
此工具的分析程序不追踪 ArcPy 中的非地理处理工具函数。 对非地理处理函数的更改(例如,对 arcpy.da.SearchCursor 的更改)可能导致兼容性问题。
兼容性分析程序可识别并报告以下兼容性问题:
- 目标版本中不存在的系统工具箱中的地理处理工具。 例如,PDF 转 TIFF 工具在 ArcGIS AllSource 2.9 版本之前不可用。
- 模型变量或工具参数的地理处理数据类型在目标版本中不存在(仅限模型)。 例如,自 ArcGIS AllSource 2.6 开始才支持体素图层 (GPVoxelLayer) 的数据类型。
- 目标版本中不存在的工具参数。 例如,模板表参数在 ArcGIS AllSource 2.6 中添加到添加字段(多个)工具。
- 对工具参数某些属性的修改。 对以下参数属性的修改将生成兼容性警告:
- 参数类型 - 参数类型可以是必需、可选或派生。
- 方向 - 参数的方向可以是输入或输出。
- 值 - 参数的默认值。
- 多值 - 参数可以支持单个或多个值。
- 数据类型 - 参数的数据类型,例如要素类 (DEFeatureClass)。
- 过滤器列表 - 限制哪些值可视为有效参数值的选项和过滤器。
- 过滤器类型 - 与参数关联的过滤器类型。 例如,参数可以没有过滤器、值列表或值范围(例如,0 到 10)。 通常,过滤器类型的变化是从没有过滤器到有过滤器。
注:
ArcGIS AllSource 支持地理处理工具的向后兼容性。 使用较早版本的软件创建的模型和脚本可供更高版本的软件使用。 例如,在 ArcGIS AllSource 2.9 创建的模型可以在 ArcGIS AllSource 3.0 中使用。 分析工具箱的版本工具旨在识别在软件的更高版本(例如 ArcGIS AllSource 3.0)中创建(或编辑)工具箱后续用于较早版本的软件(例如,ArcGIS AllSource 2.9)时存在的兼容性问题。
参数
arcpy.management.AnalyzeToolboxForVersion(in_toolbox, version, {report})
名称 | 说明 | 数据类型 |
in_toolbox | 将要分析的输入工具箱(.tbx 或 .atbx 文件)。 不支持将 Python 工具箱格式(.pyt 文件)作为输入。 | Toolbox |
version | 指定将用于工具箱兼容性分析的软件版本。
| String |
report (可选) | 将创建的文本文件,其中包含分析程序识别的兼容性问题。 | File |
代码示例
以下 Python 窗口脚本演示了如何在即时模式下使用 AnalyzeToolboxForVersion 函数。
import arcpy
arcpy.management.AnalyzeToolboxForVersion(r"C:\toolboxes\MyTools.atbx", "2.7")