创作 Web 工具涉及创作和共享过程。创作过程以在 ArcGIS Pro 中创建模型或 Python 脚本工具开始。创作并成功运行工具后,您可以将其作为 web 工具分享到 ArcGIS Enterprise 门户。必须在创作和共享时考虑某些数据、工具参数以及共享权限。一些注意事项在本主题的以下示例及相关部分中进行了描述。以下工作流介绍了整个过程:
- 使用工具箱中的工具构建脚本或模型以构造工作流。
- 收集您的工具所需的数据集,并使其在地理数据库中可用或将其添加至工程中的地图。
- 执行工具以在地理处理历史中创建一个成功条目。
- 如有必要,可在地图中设置输出数据集的符号系统。
- 将历史记录项目共享为 Web 工具。在共享 Web 工具时,您可以为工具和服务设置工具属性。
例如:检查拟建管线对人口的影响
以下模型工具是检查可能受管线泄露影响的人数的工具集合。工作流会查找管线与河流之间的相交点并执行下游追踪以识别可能受影响的人数。该模型设置有工程数据和参数并发布为 Web 工具,这样一来,分析人员或公众就可以更改拟建管线路径来了解泄露是如何影响下游人口的。Web 工具结果显示了管线与河流的相交点以及受影响人口汇总。
工具设计
所有可用的工具都具有输入和输出参数。可以使用这些参数在每次运行该工具时提供不同的值,然后该工具会依次生成不同分析。除了输入和输出参数,该工具通常还有工程数据和中间数据。这些是运行工具的人员通常不能控制的数据集。在模型中,输入参数以 P 进行标记。当模型作为工具运行时,任何带 P 的输入都可以在工具对话框中使用以设置运行工具时要使用的值。从管线模型中,用户可以指定管线路径和缓冲距离来执行追踪下游。当有人使用该工具时,管线位置和缓冲区大小会改变以显示最终受管线影响的人数。本示例中的管线相交点和追踪线是模型工具在执行过程中生成的中间数据集。运行工具的人员不需要这些中间数据集,且这些数据集不会作为结果返回。当共享此模型时,强化 Web 工具的基础地理处理服务会处理写入中间数据的位置,并在不再需要时将其清空。
就像输入参数对于所有成功的工具来说都很重要一样,输出参数也同样重要。输出参数可以使工具将结果返回至运行工具的个人。在 ArcGIS Pro 中,输出参数非常重要,因为这些数据集会自动添加至地图。没有输出参数的工具会生成输出,但不会自动显示该信息。Web 工具的工作方式大致相同;需要一个或多个输出参数来将结果返回给最终用户。在管线模型中,存在两个输出参数:显示下游缓冲区位置的影响区域人口以及带有全部受影响人口汇总的人口汇总表。请注意,impact areas population 既是中间数据又是输出数据。此参数之所以是中间数据,是因为汇总统计数据工具需要该参数,但它已被定义为模型参数 (P),且当工具成功完成运行后,它会将此结果返回给客户。
编写工具的文档说明
如果您希望尽可能多的人发现、了解和使用工具,至关重要的一点是为 Web 工具编写良好的文档。良好文档的编写从初始工具开始。可以将相同类型的元数据作为系统工具提供至模型或脚本工具。
运行此工具
创作该工具后,需成功运行该工具。运行工具时会在地理处理历史中创建一个条目。无法共享失败的工具执行。
注:
在 ModelBuilder 中运行模型时不会在地理处理历史中生成条目。模型工具必须作为工具在地理处理窗格中运行。
共享 Web 工具
可以通过选择分析 > 历史记录以打开历史记录窗格来共享 web 工具。要共享,请右键单击要共享的项目,然后选择共享为。要共享为新的 web 工具,请选择共享 web 工具以打开共享为 web 工具窗格。要覆盖现有工具,请选择覆盖 web 工具以打开一个包含我的内容中所发布的所有现有 web 工具的窗格。
请确保选择正确的工具来覆盖并单击确定以打开覆盖 web 工具窗格。共享 Web 工具和覆盖 Web 工具的已预先发布的 web 工具配置的过程相同,如下所示。
或者,前往共享 > Web 工具 以选择共享 Web 工具或覆盖 Web 工具。如果您选择共享 Web 工具选项,请从包含所有已成功运行项目的工具共享窗格中选择一个项目。
如果您选择覆盖 Web 工具选项,请从包含我的内容中所发布的所有现有 web 工具的窗格中选择一个要覆盖的项目。然后从该窗格中选择一个项目,其中包含所有要用来覆盖的、已成功运行的项目。从分析 > 历史记录选项中进行选择时,此工作流中的覆盖步骤将被反转。
设置 Web 工具属性
泄露评估工具输出要素和表格。该工具生成和返回的数据量的大小有限制,因此,Web 工具将被设置为不带结果地图服务的异步服务。1000 条最大记录数这一默认设置就足够了。错误的消息级别将确保仅返回与可能的工具失败相关的消息。在 Web 工具执行成功的情况下,正常的处理消息不会返回给最终用户。
我的内容中将始终提供 Web 工具。您可以与您的组织、任何人或选定组共享工具。可将泄露评估工具共享至组织中需要执行管线分析的特定利益相关方,这对于他们来说是个很好的工具。选择相应的组可以使用户快速找到并使用工具。
复制或引用数据
所有 Web 工具都将数据作为输入或使用工程数据。当将泄露评估模型共享为 Web 工具时,它将会接受来自用户的数据,并针对模型中引用的工程数据对其进行处理。此时,在共享工具时,您需要决定是将数据复制到服务器并制作一份服务将用到的数据的静态副本,还是创建一个服务可以访问的参考。在这种特殊工作流中,工程数据包括静态的河流和人口数据集;也就是说,这些数据集不经常更新。在这种特殊情况下,就有必要将数据复制到服务器。该过程将收集数据并将其转换(如有必要)为文件地理数据库要素类,然后在服务器上提取并由服务使用。
还应考虑分析方法是否在用户不拟建管线的地方被稍作修改了。另一种管线方案是通过其他过程完成且由用户提供不同的工具输入。在这种情况下,拟建的管线就成了工程数据。因此,建议将此数据集放入企业级地理数据库中并使工具对其引用。在发布时,您将使用 ArcGIS Server 数据存储来设置数据的引用。发布过程会维护对数据库的参考而非创建静态副本。稍后,分析人员可以在企业级地理数据库中更新数据,然后 Web 工具就可以针对最新管线方案执行分析。
分析
共享 Web 工具的分析 过程可以确保您能够成功将工具发布至门户。此外,可能会出现关于数据的警告消息,如有必要您可以采取措施。泄露评估工具已安装了数据存储和记录了工具,并使用在 Web 工具中可用的受支持工具,因此不会再出现这样的警告或消息了。
发布
设置了 Web 工具属性并解决了所有分析错误后,将 Web 工具发布至您的门户。根据需要合并及发送至服务器的数据量,此过程可能需要几分钟。
使用 Web 工具
Web 工具可以从目录窗格的门户部分找到并打开。除了在 ArcGIS Pro 中运行工具之外,还可以在 Python 脚本或 Web 应用程序中使用强化其的地理处理服务 。