使用自定义 Web 工具

自定义 web 工具是在 ArcGIS Online 中发布和托管的地理处理工作流,例如模型或脚本。 可将自定义 web 工具添加到受支持的应用程序,例如 Map Viewer,然后在分析窗格中运行这些工具。

自定义 Web 工具的类型

自定义 web 工具包含以下项目类型:

  • 工具项目 工具
  • 地理处理服务项目 地理处理服务

打开并运行自定义 Web 工具

要在 Map Viewer 中访问和使用自定义 web 工具,请完成以下步骤:

  1. 设置(浅色)工具栏中,单击分析 分析
    注:

    如果您在 Map Viewer 中未看到分析按钮,请联系 ArcGIS 管理员。 您可能没有执行分析所需的权限或配额。

    了解有关空间分析许可要求的详细信息

  2. 单击工具 工具
  3. 单击窗格底部的浏览自定义 Web 工具

    浏览自定义 Web 工具窗口随即出现。 默认情况下,该窗口将显示我的内容中可用的自定义 web 工具。

  4. 或者,单击我的内容并从菜单中选择我的收藏夹我的群组我的组织Living AtlasArcGIS Online 以更改项目的源。
  5. 或者,可以使用搜索栏和排序依据菜单来减少项目数量或者对项目进行重新排序。
  6. 在所需项目上,单击选择任务,然后从菜单中选择一个任务。

    一个项目可能具有多个与其相关联的任务。

    您也可以单击该项目以在侧窗格中查看项目详细信息。

  7. 单击确认

    自定义 web 工具随即在分析窗格中打开。

  8. 更新工具参数。

    必填参数以红点标识。

    提示:

    单击参数旁的帮助图标可查看帮助(如果存在)。

  9. 单击环境设置查看并更新处理期间使用的环境。
  10. 单击运行

配额

ArcGIS Notebooks 中发布的自定义 web 工具将消耗配额。 配额的消耗基于运行自定义 web 工具所使用的时间,以及 notebook 中每个分析工具所需的配额数量。

有关详细信息,请参阅了解用于空间分析的配额

输出

自定义 web 工具输出因工具而异。 有关特定自定义 web 工具输出的信息,请参阅工具说明或者联系工具所有者。

某些自定义 web 工具将创建临时输出图层(例如要素集合)作为其工作流的一部分。 在关闭地图之前,临时图层仅在已创建图层的 web 地图中可用,除非保存图层以创建托管图层。 如果在未保存图层的情况下关闭 web 地图,则将被永久删除临时图层。 保存 web 地图将不会保存临时图层。

注:

无法将临时图层保存为图层组项目的一部分。 如果自定义 web 工具创建临时图层作为图层组的一部分,则可以执行以下操作之一:

  • 在保存图层组之前单独保存临时图层。 进行保存时,临时图层将替换为托管要素图层。
  • 取消图层组的分组或者将临时图层移出组并单独保存临时图层。 保存临时图层并将其替换为托管要素图层后,其将保留在 web 地图中。

图层窗格中,可以使用以下图标指示临时图层: 临时图层

保存临时图层

要保存临时图层,请完成以下步骤:

  1. 内容(深色)工具栏上,如果图层窗格未打开,请单击图层 图层
  2. 图层窗格中,单击要保存的图层旁边的选项 选项,然后单击另存为 另存为
    提示:
    您也可以通过单击属性 属性,展开信息部分并单击另存为 另存为 来保存图层。
  3. 为新项目提供以下信息:
    • 输入标题。
    • 我的内容中选择要保存图层的文件夹。
    • 如果您的组织已设置内容类别,请选择类别以帮助其他用户查找图层。
    • 输入用于描述该图层的标签和摘要。
  4. 单击保存

    当前图层属性将保存到我的内容中的新项目。 新项目成为地图中图层的源。

许可要求

自定义 web 工具需要以下许可和配置,才能在 Map Viewer 中运行:

  • CreatorProfessionalProfessional Plus 用户类型
  • 发布者、服务商或管理员角色,或等效的自定义角色

要运行从 Notebooks 中发布的自定义 web 工具,将需要运行 web 工具权限。

运行从 Notebooks 中发布的自定义 web 工具可能需要附加权限,具体取决于 notebook 中包含的分析工具。 有关运行分析工具所需权限的信息,请参阅各个工具帮助。

注:

Notebooks 中创建的自定义 web 工具将作为工具项目进行托管。

疑难解答

请使用以下部分来解决添加或运行自定义 web 工具时的潜在问题。

自定义 web 工具无法打开

在以下情况下,自定义 web 工具可能无法打开:

  • 如果自定义 web 工具无法从浏览自定义 Web 工具窗口中打开,则该工具可能暂时不可用。
  • 如果自定义 web 工具无法从工具历史记录中打开,则该工具项目可能已被删除,或者您不再拥有使用该工具的权限(例如,不再共享该项目)。 有关工具状态的信息,请联系工具所有者。

不受支持的参数类型

Map Viewer 中的自定义 web 工具目前不支持某些参数类型。 如果将不受支持的参数标记为必填并且未设置默认值,则该工具将无法运行。 目前不支持以下参数类型:

  • GPComposite
  • GPMultivalue:GPBoolean
  • GPMultivalue:GPDataFile
  • GPMultivalue:GPRasterDataLayer

不受支持的参数配置

使用 GPValueTable 参数类型的参数不支持空白或重复的参数名称。 如果使用空白名称或重复名称,则这些参数将在 web 工具中不可用。 要更新空白或重复的参数名称,请联系工具所有者。

不受支持的输出参数配置

嵌套在 GPValueTable 结果中的图层不受支持,并且将无法访问这些图层或者将其添加至地图。

无输入参数的自定义 web 工具

某些自定义 web 工具可能没有输入参数。 已将没有输入参数的自定义 web 工具配置为使用默认输入数据集以及无法进行配置的参数。 环境设置(例如处理范围)可用于自定义工具的输出。 有关工具输入和参数的信息,请查看项目详细信息页面上的说明或者联系项目所有者。

从历史记录中打开时不会重新填充的参数

可以从分析历史记录中重新打开工具运行。 如果自定义 web 工具自运行后已进行更新,则可能无法重新填充某些参数以与运行该工具时已使用的设置相匹配。 在以下情况下,将不会填充已更新的参数:

  • 添加参数
  • 删除参数
  • 更改参数名称
  • 更改参数类型

资源

请通过以下资源了解更多详细信息: