地理处理模型和脚本工具库无论对于初学者还是对于专家都是一种重要资源。通过向此库提交地理处理工作流和工具，您将帮助成千上万的用户解决日常工作流程。我们听过很多关于用户下载了其中的某些条目从而节省大量时间的事情。

如果您正在考虑向库中提交内容，请花几分钟时间来阅读以下指导原则。遵循这些原则能够大大提高找到、下载并成功使用您所提交内容的几率。

我们有一个配套的一览表，可帮助您提交。

要向模型和脚本工具库中添加条目，请转至该库并单击“添加条目”。稍后系统会提示您提供其他内容：

  • 版本
  • 描述
  • 标签
  • Zip 文件

下文的原则针对以下内容：

  • zip 文件的结构和内容
  • 选择正确的版本
  • 描述的内容
  • 提交的标题
  • 工具箱的名称
  • 提交使用的标签

Zip 文件的结果与内容

根文件夹

根文件夹包含工具箱以及工具所使用的全部支持资源，如脚本、数据和地图文档。所有资源必须都存放在根文件夹或其子文件夹中，如下图所示。

下面列出了子文件夹的内容。有关详细信息，请参阅 Desktop 帮助主题共享工具的结构。

  • ToolData：包含工具所使用的所有数据（如要素类）。通常包含文件地理数据库、栅格数据和图层文件 (.lyr)。
  • Scripts：包含所提交的全部脚本工具的脚本（如 .py 文件）。请注意，在 ArcGIS 10.0 中，您可以使用工具嵌入脚本代码，所以可能不需要这个子文件夹。
  • Scratch：该子文件夹可用于编写模型中的中间数据以及脚本中的临时数据。它通常包含一个名为 scratch 的文件地理数据库。一般情况下不需要此文件夹。
  • Doc：包含可以帮助工具的使用者了解工具的全部文件，如 .pdf、.docx、.chm 和 .pptx 文件。也包含在模型图中使用的所有图像。

在创建 zip 文件时，要包含根文件夹，而不是根文件夹中的各项内容，如下图所示。

设置相对路径

如果提交的内容包含数据，则必须按照 Desktop 帮助主题路径解释：绝对、相对、UNC 和 URL 所介绍的方法在地图文档和工具中设置相对路径。

测试 zip 文件

将 zip 文件上传到库之前，您可以把它交给同事，让他们将文件解压缩到自己的计算机，然后对工具进行查看和测试。

选择正确的版本

如果要通过 10.0 资源中心提交工具，请确保将 10.0 版本复选框选中。如果工具是在 9.3 或 9.3.1 版本中创建的，则需选中 9.3 旁边的复选框。由于在 9.3 中创建的工具也适用于 10.0，所以从理论上讲，在提交 9.3 工具箱时，您可以同时选中 9.3 和 10.0。但是，我们建议您只选中一个复选框。

如果工具是在 10.0 版本中创建的，则需选中 10.0 复选框，并确保 9.3 复选框未选中。这一点尤为重要，因为在 9.3 版本中无法打开 10.0 版本的工具箱。您肯定不希望 9.3 版本的用户下载完 10.0 版本的工具箱后却发现无法打开。

描述

如果工具需要特殊的许可（产品/扩展模块）或第三方软件，请确保在描述中说明，以便库访问者决定是否下载这些条目。您需要避免在某位用户下载完后出现由于许可问题而无法使用的情况。

基于提交类别的标题和标签

为帮助库访问者了解将要下载的内容，您需要为提交提供一个描述性的标题以及一些适当的标签。多年来，我们已经确定了提交的三个基本类别：案例研究、通用工具和服务示例。通过将提交类别纳入标题和标签，只需几句话您就可以提供有关提交内容的大量信息。

案例研究

案例研究使用数据来说明工作流。案例研究提交包含模型和脚本所使用的数据（如要素类和栅格）。通常还应包括地图文档，用于显示数据。与通用工具（如下所示）不同，下载提交内容的库访问者通常会研究模型与脚本，也可能使用您所添加的数据多次运行它们，然后修改模型并替换他们自己的数据。案例研究是最常用的提交类型。

这种提交类型中出现的模型和脚本工具通常对数据变量定义了默认值。例如，在下面的模型中，所有输入数据参数都已包含值，该模型已经可以运行了。为了运行此模型，提交内容中必须包含所有数据，否则模型将无法验证或运行。

通用工具

通用工具提交的是包含与 Esri 系统工具外观类似的工具。即输入与输出数据参数为空，用户需要先输入所有参数值，然后才可以执行工具。与案例研究类型的工具不同，下载提交内容的库访问者希望能够无需修改模型或脚本就可以在工具中使用自己的数据。下面是通用模型，因为用户将提供所有数据参数值。有关创建通用工具的详细信息，请参阅 Desktop 帮助主题使用模型构建器创建工具快速浏览。

服务示例

这种类型提交的是包含可以发布为 ArcGIS Server 地理处理服务的工具。这些提交在许多方面类似于案例研究，因为它们都包含数据和地图文档。区别在于其模型和脚本遵守地理处理服务的要求，即仅使用某些特定的输入与输出数据类型，并且数据将写入 ArcGIS Server 所提供的临时工作空间。与案例研究类似，用户会研究模型和脚本并在发布到 ArcGIS Server 之前替换自己的数据。有关示例，请参阅 Desktop 帮助中的地理处理服务示例指南。

基于提交类别命名工具箱和条目

为了向模型和脚本工具库的访问者提供更好的帮助，用提交类别标注条目，例如“生物多样性工具 - 案例研究”。同样应该以类似的方式标注工具箱，如下图所示：

为工具箱指定别名

工具箱的别名可用于唯一标识工具箱及其中的工具，还可以在 Python 窗口或脚本中运行工具时使用。有关别名的详细信息，请参阅 Desktop 帮助主题重命名工具箱：名称、标注和别名。

使用提交类别标记条目

在向模型和脚本工具库中添加条目时，可以将一个或多个标签添加到条目。将下列标签之一添加到条目：

  • 案例研究
  • 通用工具
  • 服务示例

如果提交的内容包括多个类别怎么办？

既包含通用工具又包含案例研究的提交是很常见的情况。例如，使用一些实测数据（很可能为模型）来展示如何使用通用工具。我们建议您只生成一种提交，并在标题中使用通用工具。这样，库访问者就会知道他们获取的是可以使用自己的数据的通用工具。在描述中，您可以注明也包含案例研究。如果可能，提交的内容应该有两个工具箱，一个包含通用工具，另一个包含案例研究，并且每个工具箱都相应地标注清楚。对于标签，您可以同时添加两个提交类别。

Filed under: