您可将从 模型构建器 模型或 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
- 具有管理员角色或自定义角色(包括发布 Web 工具的权限)的 ArcGIS Enterprise 组织中的成员身份
- ArcGIS Enterprise 10.6 或更高版本
下载数据并打开工程
您需要访问 Web 浏览器才能下载工程数据。 请按照以下步骤操作:
- 转到 ArcGIS Online 上的共享 Web 工具概述页面。
- 单击下载。
- 在计算机上的 Downloads 文件夹中,双击 Share_a_web_tool.ppkx 以启动 ArcGIS Pro 并打开工程。
此工程将以新西兰的马尔堡地区的地图视图打开。 该模型工具分析了入侵草种与人们可能会遇到并传播它们的地点的接近程度。 内容窗格中存在代表入侵草种和接触位置的图层。
将地理处理模型作为工具运行
在将工具共享到 Web 之前,必须在 ArcGIS Pro 工程中运行它。 这样可以确保该工具可以访问其输入数据并成功运行。 要了解该工具的功能,您将在 模型构建器 视图中对其进行查看。
- 单击汇总入侵物种视图选项卡以查看模型。
作为输入,模型采用了诸如野营地或徒步路线之类的位置,人们可能会遇到入侵草种。 指定该位置周围的缓冲距离,并选择一种入侵草种。 该模型计算缓冲区(或多个缓冲区,如果有多个输入要素)中的入侵草种的数量,并使用结果创建输出要素类。
- 在模型中,将鼠标悬停在表示缓冲区工具的元素上以查看其参数。
缓冲区工具的输出是中间数据,仅用作范围内汇总工具的输入。 因此,它不会写入磁盘,而是写入内存工作空间。 这样可以提高工具性能,尤其是当您使用 模型构建器 编写 Web 工具时,这一点尤其重要。
- 通过单击其选项卡上的关闭 ,来关闭汇总入侵物种视图。
- 单击功能区上的视图选项卡。 在窗口组中,单击重置窗格 ,然后单击重置窗格以进行地理处理。
此操作可确保内容、目录和地理处理窗格处于开放状态,而其他窗格处于关闭状态。
- 激活目录窗格。 在工程选项卡上,展开工具箱,然后展开 Share_a_web_tool.tbx。
将显示“汇总入侵物种”模型工具。
注:
工具可以是内置工具 、模型工具 或脚本工具 。有关详细信息,请参阅地理处理词汇。
- 右键单击汇总入侵物种工具,然后单击打开。
随即在地理处理窗格中打开该工具。 在窗格顶部,参数选项卡处于选中状态。
- 单击人类接触位置下拉箭头,然后单击商业野营地。
- 对于缓冲距离,输入 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。
- 关闭表。
- 在内容窗格中,右键单击 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 工具将不接受其他几何类型。
将用于以交互方式创建的输入图层的表方案位于几何类型下方。 (这是 Commercial Campgrounds 图层的表方案。)
- 展开缓冲距离参数。
默认情况下,此参数的输入模式设置为用户定义值。 默认值为 1.5 千米,因为这是您运行该工具时使用的设置。 工具用户可以更改该值。
- 展开入侵物种参数。
默认输入模式是选择列表。 工具用户应该能够选择一种入侵草种进行分析,但是没有其他图层可供选择。 您在选择列表中选择的图层的数据将被复制到服务器。
- 在图层列表中,选中以下列出的四种入侵草种的复选框。 取消选中所有其他复选框。
- 白边夜颠茄范围
- 袋鼠草范围
- 智利针茅草范围
- 单花针茅属草范围(无法取消选中)
- 展开面积测量单位参数。
为了获得一致的报告,您的组织将使用公顷作为所有入侵草种分析的测量单位。 您不希望工具用户选择其他任何东西。
- 单击输入模式下拉箭头,然后单击常量值。
常量值会自动设置为公顷,这是您在运行工具时选择的测量单位。 用户将不会在 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 工具。
随即在地理处理窗格中打开该工具。 默认情况下设置缓冲距离和入侵物种参数。 可以更改设置,但是现在您将接受它们。 请注意,该工具不会显示测量单位或输出要素类的参数。 您可以选择创建输出要素服务(如果您具有发布者角色),但是在本教程中不会这样做。
对于人类接触位置参数,您可以通过多种方式提供输入数据。 您可以从当前地图中选择一个点图层、浏览到点数据集,或在新要素类中以交互方式创建要素。 出于您的工具的目的,以交互方式输入是最合适的方法。
- 在人类接触位置旁边,单击创建点 。
将在默认地理数据库中创建一个新的点要素类,然后将一个可编辑图层添加到内容窗格中。 构造工具条随即显示在地图上。 在添加要分析的位置之前,您将重命名图层并选择其他符号。
- 在内容窗格中,单击 Summarize_Invasive_Species_Human_Contact_Locations_Points 图层一次,以使其名称可编辑。 输入 Citizen Request,然后按 Enter 键。
- 在新图层名称下,单击其默认符号。
符号系统窗格将出现并显示点符号格式化选项。
- 确保已选中位于窗格顶部的图库选项卡。 在搜索框中输入 Esri Pin,然后按 Enter 键。
- 在结果列表中,单击中等大小的 Esri Pin 1 符号。
即会在内容窗格中更新此图层符号。
假设有一位葡萄园所有者与您联系,认为她在自己的住所附近见过单花针茅属草。
- 单击功能区上的地图选项卡。 在查询组中,单击定位 。
定位窗格随即显示。 在窗格中,选择定位选项卡。
- 在定位窗格中,单击选项 ,然后确认 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) 图层。
附近有建筑物(包括酒厂和餐馆)。 马尔堡地区以其葡萄酒而闻名。 它因单花针茅属草而闻名,但您可以在地图上看到一片或两片单花针茅属草。
注:
入侵草种要素并不代表一个区域的完全覆盖,而是代表已发现大量入侵草种的边界。 有些区域的虫害比其他区域更为密集。 缓冲区内入侵草种数量的计算结果为近似值。
- 激活地理处理窗格。人类接触位置参数设置为您刚刚以交互方式创建的图层。
- 单击运行 。
操作完成后,地理处理窗格底部将显示一条消息。 在内容窗格中,将名为 Invasive Grass Summary 的图层添加到地图。
- 在内容窗格中,右键单击 Invasive Grass Summary 图层并单击缩放至图层 。
地图缩放到 1.5 千米缓冲区的范围。
- 在内容窗格中,右键单击 Invasive Grass Summary 图层并单击属性表 。
在表中,Summarized area in HECTARES 字段显示缓冲区中约有 20 公顷的单花针茅属草。
- 关闭属性表。
注:
在运行 Web 工具之前,您可以交互方式创建多个输入要素。 每个要素都将被缓冲和汇总。 您还可以多次运行该工具,同时继续以交互方式添加要素。 每次运行该工具时,都会创建一个新的输出要素类。
停止交互式创建后,可以通过在 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 工具。