地理处理历史记录

您所运行的地理处理工具将被记录下来，并随工程一起保存。 可查看有关每个已运行工具的详细信息，并重新打开具有之前所使用设置的工具。 地理处理历史记录将帮助您提高效率，并使您能够更好地了解在工程中创建数据和图层的流程。

运行任何地理处理工具时，会向历史记录窗格中的地理处理选项卡 下添加一个条目。 要访问地理处理工具的历史记录，请在分析功能区的地理处理组中，单击历史记录按钮 。

历史记录条目

每个历史记录条目保留有关工具的详细信息，其中包括以下内容：

• 工具输入、输出和其他参数设置。
• 任何自定义地理处理环境设置。
• 工具运行时间、工具完成时间以及工具完成花费的时间。
• 工具运行成功或失败。
• 所有信息、警告或错误消息。
• 输出报表或文件（例如 PDF 或 HTML 文档）的链接。 单击后，这些文件将在文件类型对应的默认系统应用程序中打开。

管理历史记录

如果您稍后打开工程继续进行工作，则之前在工程中运行的所有地理处理工具均可以查看地理处理历史记录。 通过在历史记录中双击条目或者右键单击并选择打开，即可重新打开和运行其中的任何工具。

您可以移除不希望保留在工程中的任何历史记录条目。 选择要移除的任何条目，然后右键单击并选择移除。 也可以使用位于历史记录条目列表顶部的移除按钮 移除单个或多个所选历史记录条目。

历史记录收藏夹

工程地理处理历史记录中的工具可标记为收藏，这会将工具固定在地理处理历史记录顶部的收藏夹部分。 右键单击工具，然后选择添加到历史记录收藏夹 ，将其添加到收藏夹部分。 标记为收藏的工具将在收藏夹部分中列出，并将根据所选的排序方法继续显示在主地理处理历史记录视图中。

要移除标记为收藏的工具，请在收藏夹部分中右键单击该工具，然后选择从历史记录收藏夹中移除 。

过滤历史记录

可以使用过滤器下拉菜单 对地理处理历史记录应用以下过滤器：

• 类型 - 本地、门户
• 状态 - 进行中、已完成、失败
• 输入图层 - 历史记录中被所有工具用作输入的图层列表

要过滤历史记录，请执行以下步骤：

1. 打开历史记录窗格并选择地理处理选项卡 。
2. 单击过滤器下拉菜单 。
3. 展开要指定的过滤器类型。
4. 选中或取消选中相应复选框，以使用过滤器在地理处理历史记录中显示或隐藏工具。

   可以使用过滤器菜单顶部的全选复选框以选中或取消选中所有过滤器。 取消选中所有过滤器后，选中类型、状态或输入图层，以查看符合该过滤器的地理处理历史记录条目。

使用历史记录自动进行地理处理

可以将从地理处理窗格中运行的地理处理工具作为起点，以自动完成 模型构建器 或 Python 的工作。

可以将地理处理历史记录条目拖到 模型构建器 视图上。 系统将在模型中添加和连接工具和所有参数设置。 也可以右键单击历史记录条目，然后选择添加到模型，系统即会将运行工具所需的工具和所有数据添加到打开的模型中。 如果未打开任何模型，则将在投影工具箱中创建模型。 您可以选择多个历史记录条目并将它们添加到模型中，以在模型中构建相互联系的流程链，其中一个工具的输出可以作为另一个工具的输入。

地理处理历史记录项目也可以转换为 Python。 右键单击一个或多个历史记录项目并选择以下选项之一：

• 复制 Python 命令 - 复制所选工具作为 Python 代码。
• 发送到 Python 窗口 - 将所选工具的 Python 代码发送到 Python 窗口。
• 发送到 Notebook 将所选工具的 Python 代码发送到 ArcGIS Notebooks。 如果 notebook 已打开，则会将 Python 代码复制到打开的 notebook。 如果 notebook 未打开，则会将 Python 代码复制到新 notebook。
• 另存为 Python 脚本 - 保存到 Python 脚本 (.py)。

您还可以选择多个历史记录项目并将其添加至 Python 窗口或 notebook。

如果在运行该工具时使用了任何地理处理环境，则该环境将包含在使用 arcpy.EnvManager 类的 Python 代码中。

了解有关在 Python 中运行地理处理工具的详细信息

共享分析

地理处理历史记录在您将分析共享为地理处理包或 web 工具时起到关键的作用。 您要共享的任何分析首先必须已成功运行并已记录到地理处理历史中。

了解有关共享分析的详细信息

地理处理日志记录选项

以下地理处理选项控制运行的地理处理工具在地理处理历史记录、外部 XML 日志和数据集元数据中的记录方式。

将地理处理操作写入地理处理历史记录

此选项控制是否将您运行的工具添加到当前工程的地理处理历史记录中。

• 选中 - 运行的每个工具都会记录在工程的地理处理历史记录中。 这是默认设置。
• 未选中 - 工具不会记录到地理处理历史记录中。

将地理处理操作写入 XML 日志文件

该选项可控制是否将您运行的所有地理处理工具的相关信息写入外部日志文件。

• 选中 - 将在 %AppData%\Esri\ArcGISPro\ArcToolbox\History 目录中创建 XML 日志文件。
• 未选中 - 不会创建 XML 日志文件。 这是默认设置。

将地理处理操作写入数据集元数据

该选项可控制是否更新地理处理工具输入和输出数据集元数据，以包括工具名称、参数、工具运行时间和其他信息。

• 选中 - 数据集元数据包含地理处理历史记录部分，记录用于该数据集的工具。 这是默认设置。
• 未选中 - 不更新数据集元数据。