您可将从 模型构建器 模型或 Python 脚本创建的自定义地理处理工具共享到 ArcGIS Enterprise 门户。 与和地理处理包共享的工具不同,Web 工具托管在您的门户服务器或与门户联合的服务器上并在其中运行。 您可以在 ArcGIS Pro 和 Map Viewer 中访问 Web 工具,也可以访问自定义 Web 应用程序,例如使用 ArcGIS Web AppBuilder 构建的应用程序。
在本教程中,您将模型工具共享为 Web 工具。 该工具已经创建。 首先,您将在 ArcGIS Pro 工程中以本地方式运行该工具以确保其成功运行。 然后,您会将其共享为 Web 工具,并在 ArcGIS Pro 的门户中运行它。
您将共享的模型工具与在创建地理处理模型快速入门教程中构建的模型工具基本相同。 完成该教程不是先决条件,但是如果您不熟悉地理处理模型,或者想要更好地了解该工具的工作原理,则很有用。
概览
- 视频长度:8:49
- 此视频是使用 ArcGIS Pro 2.8 创建的。
- 预计时间:45 分钟
- 软件要求:
- ArcGIS Pro Basic
- 具有管理员角色或自定义角色(包括发布 Web 工具的权限)的 ArcGIS Enterprise 组织中的成员身份
- ArcGIS Enterprise 10.6 或更高版本
注:
每次发布软件时都会更新快速入门教程。 为了获得最佳体验,使用与软件版本匹配的在线帮助版本。
下载数据并打开工程
您需要访问 Web 浏览器才能下载工程数据。 请按照以下步骤操作:
- 转到 ArcGIS Online 上的共享 Web 工具 v310 概述页面。
- 单击下载。
- 在计算机上的 Downloads 文件夹中,双击 Share_a_web_tool.ppkx 以启动 ArcGIS Pro 并打开工程。
此工程将以新西兰的马尔堡地区的地图视图打开。 该模型工具分析了入侵草种与人们可能会遇到并传播它们的地点的接近程度。 内容窗格中存在代表入侵草种和接触位置的图层。
将地理处理模型作为工具运行
在将工具共享到 Web 之前,必须在 ArcGIS Pro 工程中运行它。 这样可以确保该工具可以访问其输入数据并成功运行。 要了解该工具的功能,您将在 模型构建器 视图中对其进行查看。
- 单击功能区上的视图选项卡。 在窗口组中,单击重置窗格 ,然后单击重置窗格以进行地理处理。
此操作可确保内容、目录和地理处理窗格处于开放状态,而其他窗格处于关闭状态。
- 激活目录窗格。 在工程选项卡上,展开工具箱 ,然后展开 Share_a_web_tool 工具箱。 右键单击汇总入侵物种模型工具,然后单击编辑。
模型将在视图中打开。
作为输入,模型采用了诸如野营地或徒步路线之类的位置,人们可能会遇到入侵草种。 指定该位置周围的缓冲距离,并选择一种入侵草种。 该模型计算缓冲区(或多个缓冲区,如果有多个输入要素)中的入侵草种的数量,并使用结果创建输出要素类。
注:
工具可以是内置工具 、模型工具 或脚本工具 。有关详细信息,请参阅地理处理词汇。
- 在模型中,将鼠标悬停在表示成对缓冲工具的元素上以查看其参数。
成对缓冲工具的输出是中间数据,仅用作范围内汇总工具的输入。 因此,它不会写入磁盘,而是写入内存工作空间。 这样可以提高工具性能,尤其是当您使用 模型构建器 编写 Web 工具时,这一点尤其重要。
- 通过单击其选项卡上的关闭 ,来关闭汇总入侵物种视图。
- 在目录窗格中,右键单击汇总入侵物种,然后单击打开。
随即在地理处理窗格中打开该工具。 在窗格顶部,参数选项卡处于选中状态。
- 单击人类接触位置下拉箭头,然后单击商业野营地。
- 对于缓冲距离,输入 1.5。 将单位从“未知”更改为千米。
- 单击入侵物种下拉箭头,然后单击 Nassella Tussock Range。
- 单击面积测量单位下拉箭头,然后单击公顷。
- 在输出要素类框中,输入 Nassella_Tussock_Near_Campgrounds。
系统将在工程的默认地理数据库中创建输出要素类。
- 单击运行 。
工具完成运行后,地理处理窗格底部将显示一条完成消息,并将图层添加到内容窗格。
新的 Nassella_Tussock_Near_Campgrounds 图层将用黑色轮廓和空心填充符号化。 在当前地图比例下,这些要素可能会被 Commercial Campgrounds 符号遮挡。
- 在地图上放大以查看野营地周围的缓冲区要素。
- 在内容窗格中,右键单击 Nassella_Tussock_Near_Campgrounds 图层,然后单击属性表 。
该表包含每个野营地的记录。
- 在该表中,右键单击 Summarized area in HECTARES 字段标题,然后单击降序排序 。
四个野营地在 1.5 千米半径内包含单花针茅属草。
- 关闭表。
- 在内容窗格中,右键单击 Nassella_Tussock_Near_Campgrounds 图层,然后单击移除 。
- 激活目录窗格。 在工程选项卡上,展开数据库容器 并展开 model_output.gdb。
地理数据库包含名为 Nassella_Tussock_Near_Campgrounds 的要素类。 这是由该工具创建的输出数据。
注:
每个 ArcGIS Pro 工程都有一个默认的地理数据库,该数据库使用默认图标 进行标记。 除非另有说明,否则这是大多数地理处理输出写入的工作空间。 创建工程时,将使用与工程相同的名称创建默认地理数据库。 但是,您可以更改默认地理数据库。 在此工程中,model_output.gdb 是默认地理数据库。
- 在快速访问工具栏中,单击保存 保存工程。
配置 Web 工具
现在,该工具已成功运行,您可以将其配置为 Web 工具。 您将其与组织共享,以便您的同事可以从 ArcGIS Pro 和其他客户端应用程序访问它。 将 Web 工具托管在门户中可以使其在整个组织中随时可以访问。 它还使您可以增强输入数据和参数设置的一致性。
想象一下,您的组织计划与马尔堡大区的地区政府合作,以增加对入侵草种的监控。 相关居民可以提交地址或空间坐标,而您团队的分析人员可以快速确定附近的侵入草种数量。
- 单击功能区上的共享选项卡。 在共享为组中,单击 Web 工具下拉箭头,然后单击共享 Web 工具 。
注:
如果您当前未登录 ArcGIS Enterprise 门户,则此命令不可用。 您可能需要管理门户连接。
- 在选择要共享的工具窗口中,单击汇总入侵物种以进行选择。
- 单击确定。
将显示共享为 Web 工具窗格。
提示:
您也可以按照以下步骤打开该窗格:
- 在功能区上,单击分析选项卡。
- 在地理处理组中,单击历史记录 。
- 在历史记录窗格中,右键单击汇总入侵物种条目,单击共享为,然后单击共享 Web 工具 。
如果窗格顶部显示错误消息,则您的帐户可能没有共享 Web 工具的权限。 请于上方参阅本教程的软件要求。
在常规选项卡上的项目详细信息下,名称、摘要和标签框将填充先前为该工具创建的元数据。
- 将鼠标悬停在数据旁边的信息图标 上,然后读取显示的消息。
入侵草种数据集是必须与该工具一起使用的权威数据。 由于未注册此数据,因此当您共享 Web 工具时会将其复制到服务器。 您不需要更改默认数据选项,因为未注册的数据会自动复制。 显示帮助消息时,您可以按 F1 键以了解有关使用已注册数据的详细信息。
- 在位置下,接受默认设置。
该 Web 工具将共享到门户中我的内容 的根级别以及 ArcGIS Enterprise 门户的托管服务器。
- 在共享对象下,选中您的 ArcGIS Enterprise 组织名称旁的复选框。
组织中所有可以创建内容的成员都将能够运行 Web 工具。 了解有关 Web 工具常规设置的详细信息。
- 在窗格顶部,单击配置选项卡。
在本教程中,您将使用默认设置。 了解有关 Web 工具配置设置的详细信息。
- 单击内容选项卡。
- 在“汇总入侵物种”工具旁边,单击配置工具属性 。
- 在描述框中,输入(或复制并粘贴)以下文本:Finds and summarizes invasive species within a buffer zone of designated locations.
- 在参数下,展开人类接触位置。
参数描述来自地理处理工具元数据。
- 单击输入模式下拉箭头,然后单击用户定义的值。
在输入模式设置下,几何类型默认为点。
当 Web 工具用户以交互方式添加自己的位置进行分析时,如果他们单击交互式输入按钮 ,则将被限制为添加点要素。 但是,其他几何类型(线、面和多面体)可从下拉列表中访问。 如果用户选择上述类型之一,则会使用适当的方案创建交互式图层。
几何类型默认为“点”,这是因为在上一部分中运行该工具时,您使用了点图层(商业野营地)作为接触位置。 要了解有关 web 工具中的交互式要素输入与地理处理服务的详细信息。
也可以看到用于以交互方式创建的点图层的表方案。 这是 Commercial Campgrounds 图层的方案。
- 展开缓冲距离参数。
默认情况下,此参数的输入模式设置为用户定义值。 默认值为 1.5 千米,您运行该工具时使用的设置。 Web 工具用户可以更改该值。
- 展开入侵物种参数。
默认输入模式是选择列表。 Web 工具用户应该能够选择一种入侵草种进行分析,但是应该没有其他可用图层。 您在选择列表中选择的图层的数据将被复制到服务器。
- 在图层列表中,选中以下列出的四种入侵草种的复选框。 取消选中所有其他复选框。
- White Edged Nightshade Range
- Kangaroo Grass Range
- Chilean Needlegrass Range
- Nassella Tussock Range(无法取消选中)
- 展开面积测量单位参数。
为了获得一致的报告,您的组织将使用公顷作为所有入侵草种分析的测量单位。 您不希望工具用户选择其他任何东西。
- 单击输入模式下拉箭头,然后单击常量值。
常量值会自动设置为公顷,这是您在运行工具时选择的测量单位。 用户将不会在 Web 工具上看到此参数。
- 展开输出要素类参数。
在名称框中,用入侵草种摘要替换默认名称。
此参数将不会出现在 Web 工具上。 Web 工具用户无法更改输出要素类的名称或位置。 输出要素类将在服务器上进行创建,并返回到运行 Web 工具的客户端。 其将显示表模式(运行工具时输出要素类的方案)。
默认情况下,最后一个参数要素服务输出被选中。 选中后,此参数将显示在 Web 工具上。 它为 web 工具用户提供了将分析结果写入门户中的要素服务以及本地文件地理数据库的选项。 取消选中后,此参数将不会显示在 Web 工具上。 了解有关将 Web 工具与输出要素服务一起使用的详细信息。
注:
要素服务输出参数在 ArcGIS Pro 2.8 中引入。 在 ArcGIS Pro 的早期版本中,Web 工具始终提供创建要素服务的选项。
共享 Web 工具
您将分析该工具中的警告或错误,并将其共享到您的门户。
- 在共享为 Web 工具窗格顶部,单击返回 。
- 在该窗格底部的完成共享下,单击分析。
该窗格顶部的消息选项卡显示警告和错误。 有四个分组的警告。
- 展开组并将鼠标悬停在警告之一上。
该警告通知您数据源尚未注册,并将被复制到服务器。 (对于每种入侵草种类型,都会出现相同的警告。)对于大型数据集,将数据复制到服务器可能会减慢共享过程。 在这种情况下,数据集很小,您可以放心地忽略警告。
提示:
将鼠标悬停在警告或错误消息上时,请单击选项 以采取纠正措施或打开相关的帮助主题。 了解有关错误和警告的详细信息。
- 单击发布。
将该工具成功共享到门户后,窗格底部会显示一条消息。
注:
如果门户中已经存在具有相同名称的 Web 工具,则您将会获得发布错误。 在错误消息上单击确定。 在共享为 Web 工具窗格中,单击常规选项卡。 在名称框中,编辑工具名称(不包括空格)。 在窗格的底部,再次单击发布。
- 在成功消息上,单击管理 web 工具以将 web 浏览器打开到您的 ArcGIS Enterprise 门户。 如果出现提示,请登录。
随即显示 web 工具的项目页面。 您可以稍后再回来,以将更多的元数据和缩略图添加到项目页面。
- 在项目页面顶部,单击内容。
Web 工具将出现在您的内容项目列表中。
在下一部分中,您将从 ArcGIS Pro 中访问 Web 工具并在门户中运行它。 也可在 web 应用程序中使用 Web 工具。
使用 Web 工具
您将运行该 Web 工具来模拟您的预期用例:相关居民想要了解某个地点附近的入侵草种。
- 在 ArcGIS Pro 中,激活目录窗格。 单击窗格顶部的门户选项卡。
SummarizeInvasiveSpecies Web 工具项目出现在我的内容选项卡 上。
注:
对于您组织的其他成员,该工具将显示在我的组织选项卡 上。 也可以在 ArcGIS Enterprise 选项卡 上找到它。
- 双击 SummarizeInvasiveSpecies Web 工具项目,然后双击汇总入侵物种 Web 工具。
随即在地理处理窗格中打开该工具。 默认情况下设置缓冲距离和入侵物种参数。 可以更改设置,但是现在您将接受它们。 请注意,该工具不会显示测量单位或输出要素类的参数。 您可以选择创建输出要素服务(如果您具有发布者角色),但是在本教程中不会这样做。
对于人类接触位置参数,您可以通过多种方式提供输入数据。 您可以从当前地图中选择一个图层、浏览到数据集或 web 要素图层,或在新要素类中以交互方式创建要素。 出于您的工具的目的,以交互方式输入是最合适的方法。
- 在人类接触位置旁边,单击交互式输入按钮 。(单击按钮,而非下拉箭头。)
- 在内容窗格中,单击 Summarize_Invasive_Species_Human_Contact_Locations_Points 图层一次,以使其名称可编辑。 输入 Citizen Request,然后按 Enter 键。
- 在新图层名称下,单击其默认符号。
符号系统窗格将出现并显示点符号格式化选项。
- 确保已选中位于窗格顶部的图库选项卡。 在搜索框中输入 Esri Pin,然后按 Enter 键。
- 在结果列表中,单击中等大小的 Esri Pin 1 符号。
即会在内容窗格中更新此图层符号。
- 激活地理处理窗格。 在人类接触位置参数下,单击 Citizen Request 要素模板。
默认情况下会选择点工具 。
假设有一位葡萄园所有者与您联系,认为她在自己的住所附近见过单花针茅属草。
- 单击功能区上的地图选项卡。 在查询组中,单击定位 。
定位窗格随即显示。 在窗格中,选择定位选项卡。
- 在定位窗格中,单击选项 ,然后确认 ArcGIS World Geocoding Service 或另一个定位提供者可用并已启用。
如果唯一的提供者是 XY 提供者,则将在下一步中使用空间坐标而不是街道地址。
- 在搜索框中单击。 输入(或复制并粘贴)New Zealand State Highway 6 and Rapaura Road, Renwick, 7273,然后按 Enter 键。 或者,在搜索框中输入以下坐标:173.8170288°E 41.4865202°S。
地图会缩放到该位置,并在街道路口放置一个临时标记。
- 将鼠标悬停在位置上,然后单击以在 Citizen Inquiry 图层中创建点要素。
新要素将自动保存。
- 在功能区地图选项卡的导航组中,单击浏览工具 。
这将停止交互式要素输入过程。
- 在定位窗格的搜索框中,单击结果以移除临时标记。
- 在地图视图的底部,单击地图比例下拉箭头并单击 1:10,000。
如果该比例未出现在预定义比例列表中,则可以在比例框中输入。
- 在内容窗格中,打开 World Imagery (Clarity) 图层。
附近有建筑物,还有几簇单花针茅属草。
注:
入侵草种要素并不代表一个区域的完全覆盖,而是代表已发现大量入侵草种的边界。 有些区域的虫害比其他区域更为密集。 缓冲区内入侵草种数量的计算结果为近似值。
- 将地理处理窗格激活,并确认人类触点位置参数设置为 Citizen Request 图层。
- 单击运行 。
操作完成后,地理处理窗格底部将显示一条消息。 在内容窗格中,将名为 Invasive Grass Summary 的图层添加到地图。
- 在内容窗格中,右键单击 Invasive Grass Summary 图层并单击缩放至图层 。
地图缩放到 1.5 千米缓冲区的范围。
- 在内容窗格中,右键单击 Invasive Grass Summary 图层并单击属性表 。
在表中,Summarized area in HECTARES 字段显示缓冲区中约有 20 公顷的单花针茅属草。
- 关闭属性表。
注:
在运行 Web 工具之前,您可以交互方式创建多个输入要素。 每个要素都将被缓冲和汇总。 您还可以多次运行该工具,同时继续以交互方式添加要素。 每次运行该工具时,都会创建一个新的输出要素类。
运行工具后,您可以通过单击交互式输入按钮 添加更多要素。 但是,这将覆盖现有图层 (Citizen Request) 及其源数据集。 要继续编辑而不覆盖图层,可以在创建要素窗格中创建要素。
查看输出数据和地理处理历史记录
Citizen Request 和 Invasive Grass Summary 图层的源数据集位于默认地理数据库中。 分析结果存储在工程的地理处理历史记录中。
- 激活目录窗格。 在窗格的顶部,单击工程选项卡。
- 如有必要,请展开数据库容器 并展开 model_output 地理数据库。
地理数据库包含名为 feature_set<number> 的要素类。 这是入侵草种摘要图层的数据源。 其中也包含名为 Summarize_Invasive_Species_Human_Contact_Locations_Points 的要素类。 这是“公民请求”图层的数据源。
- 在功能区上,单击分析选项卡。 在地理处理组中,单击历史记录 。
随即显示历史记录窗格。 它包含两个成功的地理处理操作的条目:Web 工具 和桌面工具。 将鼠标悬停在条目上可以查看有关每个操作的详细信息。
- 在快速访问工具栏上,单击保存 保存工程。
Web 工具的工作方式就像它们所基于的自定义脚本或模型工具一样,并产生相同的结果。 它们可供组织中的用户随时使用,并且可以公开共享。 使用 ArcGIS Pro 2.6 或更高版本,可在需要修改 Web 工具时将其覆盖。
运行 Web 工具时,地理处理是在门户服务器而非计算机上完成的。 输出数据将从服务器返回并写入工程的默认地理数据库。
ArcGIS Pro 不是唯一可以运行 Web 工具的客户端应用程序;Map Viewer、ArcGIS Web AppBuilder 和自定义 Web 应用程序也可以运行 Web 工具。有关共享 Web 工具的其他简介,请参阅如何从 ArcGIS Pro 中发布 Web 工具。