添加和配置“运行 GP 服务”

“运行 GP 服务”步骤用于运行已配置的地理处理服务。 可使用该步骤运行已作为服务发布至 ArcGIS 组织的地理处理工具、Python 脚本工具和 模型构建器 模型。

运行步骤时,作业磁贴上将显示正在启动图标 Starting。 启动服务时,将显示正在运行图标 Running,表示地理处理服务正在运行。

如果使用 ArcGIS Arcade 表达式配置了任意步骤参数,则在地理处理服务开始运行之前,这些参数将转换为相应的值。

如果启用了可见选项,则可通过该步骤先定义参数值,然后再启动地理处理服务。 如果为参数配置了默认值,则这些值将在运行步骤时显示并且可以覆盖。 必需参数以红色高亮显示。

如果步骤运行成功,将显示步骤完成图标 Step Complete。 如果步骤失败,将显示 GP 步骤失败图标 Step Failed

注:

如果从 ArcGIS Arcade 表达式获取的参数值与地理处理服务不兼容,则步骤将失败。

运行该步骤时,可以执行以下操作:

  • 如果已启用可见选项,则可以提供参数值,然后可通过单击继续运行步骤。
  • 通过单击取消步骤 Cancel Step,可以取消该步骤。
    注:

    在步骤开始运行后,您可能无法取消该步骤。

  • 可通过单击完成步骤 Complete Step 完成步骤。

配置步骤

要配置步骤,请执行以下操作:

  1. 创建编辑工作流示意图,以访问步骤库面板。
  2. 运行 GP 服务步骤库面板拖至工作流画布上步骤的连接箭头。

    步骤详细信息面板随即出现。

  3. 步骤名称文本框中提供步骤的名称。
  4. GP 服务 URL 文本框中提供地理处理服务的 URL。
  5. (可选)如果地理处理服务不受保护并且不需要在请求中提供令牌,则取消选中安全复选框。
  6. 参数部分中,单击编辑

    随即显示步骤参数对话框。

  7. 根据需要在参数值文本框中配置参数值。

    要为参数值使用 ArcGIS Arcade 表达式,请单击更改输入类型下拉箭头,然后为关联的参数值文本框选择输入类型。 此选项不适用于字符串值。

    提示:

    单击此输入支持 Arcade 表达式 This input supports Arcade expressions,然后选择 Arcade 表达式以将其添加至其关联文本框。

  8. (可选)选中参数旁的可见复选框以允许在 ArcGIS Pro 中运行步骤时设置参数值。
  9. 根据需要更新返回值。
  10. 单击选项选项卡。
  11. 根据需要配置步骤选项
    • 手动 - 手动运行步骤。
      • 可选 - 允许完成步骤而无需运行。
    • 自动 - 步骤被激活后立即执行。
      注:

      如果工作流示意图配置为自动运行一系列步骤,其中包括“运行 GP 服务”步骤,则在用户令牌到期后,尝试自动运行的步骤将失败。 ArcGIS Workflow Manager Advanced 组织扩展模块需要在没有人工干预的情况下运行额外的自动步骤。

    • 按计划运行 - 根据您设置的计划运行步骤。

      了解有关计划工具的详细信息

  12. (可选)选择以下选项之一配置步骤中的帮助:
    • - 配置不含步骤帮助的步骤。
    • 文本 - 在文本文本框中配置步骤的帮助文本。

      可以使用 ArcGIS Arcade 表达式为步骤帮助提供动态值。 如果步骤帮助包含纯文本和 Arcade 表达式,请将文本格式设置如下:

      
      'For further assistance, please contact' + JobCreator($Job) + '.'

    • URL - 在 URL 文本框中为步骤配置指向帮助资源的链接。
      注:

      在 Web 应用程序中运行的步骤仅支持 HTTP 和 HTTPS URL 格式。 在 ArcGIS Pro 中运行的步骤支持 HTTP、HTTPS 和文件格式。

      还可以使用 Arcade 表达式提供动态值。 如果 URL 包含纯文本和 Arcade 表达式,请将文本格式设置如下:

      
      'https://pro.arcgis.com/en/pro-app/latest/tool-reference/' + JobExtendedProperty($Job, 'tools', 'toolbox') + '/' + jobExtendedProperty($job, 'tools', 'alias') + '.htm'

      配置自动编码 Arcade 结果复选框如下:

      • 如果 Arcade 表达式返回了在转换为 URL 时必须进行转义的特殊字符(例如空格或正斜线),请确保已选中自动编码 Arcade 结果复选框。
      • 如果使用 Arcade 表达式构建基础 URL,则请取消选中自动编码 Arcade 结果复选框。

  13. 或者,单击样式选项卡以更改步骤的形状和颜色。
  14. 或者,单击关于选项卡并在步骤描述文本框中提供该步骤的描述。
    提示:

    关于选项卡还包含步骤 ID,可与动态作业属性配合使用以获取步骤的输出。 单击复制步骤 ID Copy Step ID 将步骤 ID 复制到剪贴板。

返回值

当该步骤完成时,将存储返回值以指示该步骤的结果。 可以使用路径立即评估返回值,以确定工作流中的后续步骤。 您还可以使用 ArcGIS Arcade 表达式在整个工作流中检索已完成步骤的返回值。 下表列出了该步骤的返回值:

返回值描述

S000001

该步骤成功完成。

F000001

该步骤未能成功完成。

输出值

该步骤完成后,其输出值将被存储,可用于确定工作流所遵循的路径,或者可用作整个工作流中其他步骤的输入。 下表列出了该步骤的输出值:

输出值名称描述

<GeoprocessingServiceOutput>

返回从地理处理服务接收的所有输出值。

相关主题