在将工具共享为 web 工具或地理处理服务时,属性设置可定义客户端应用程序使用它们的方式。 可以在共享时设置最常见且频繁更改的工具参数。 共享该工具之后,可在 ArcGIS Server Manager 中更改不太常见的设置。 一些高级设置只能在 ArcGIS Server Administrator REST API 上进行设置。
设置
以下小节描述了共享 web 工具或地理处理服务时的可用设置。
常规
以下常规参数设置可用:
参数 | 描述 |
---|---|
名称 | 将共享到门户的 Web 工具或地理处理服务的名称。 此名称在门户中必须是唯一的,且不能包含空格或特殊字符。 此参数可继承自工具元数据。 |
摘要 | 帮助描述文档并使 web 工具可搜索的摘要和标签。 这些参数继承自工具元数据。 可以使用标签下拉菜单以选择现有标签。 最大限制为 128 个标签。 |
标签 | |
类别 | Web 工具项目的类别。 发布到独立 ArcGIS Server 的地理处理服务无法使用该设置。 |
版本 | 工具将共享到的 ArcGIS Enterprise 或 ArcGIS Server 版本。 仅当保存 Web 工具的离线服务定义时,才会启用此参数。 |
数据 | 指定数据将会发生什么。
|
位置 | 指定将创建 Web 工具项目或地理处理服务的位置。 对于发布到 ArcGIS Enterprise 的 web 工具项目,选项如下:
对于发布到独立 ArcGIS Server 的地理处理服务,选项如下:
|
共享给 | 仅可用于发布到 ArcGIS Enterprise 的 Web 工具,指定 web 工具将共享到的用户和群组。 web 工具将始终共享到我的内容。 将 web 工具共享给所有人会使项目变为公开状态;拥有门户网站访问权限的任何人都可以找到并使用您的项目,并且群组的所有者也可以将您的项目包含在其群组内容中。 将 Web 工具共享到 ArcGIS Enterprise 会将 Web 工具与门户中所有有权访问项目的成员共享。 可共享到您所属的任何组。 |
配置
配置服务功能和参数选项卡中提供以下参数设置:
参数 | 描述 |
---|---|
上传 | 控制客户端是否可以将文件上传到服务器以供 web 工具用作输入。 上传操作通常由 web 客户端使用,这些客户端需要一种方式将文件发送至服务器以供处理。 上传操作会在上传完成后返回该文件的唯一 ID,web 应用程序会将此唯一 ID 传递给 web 工具。 此选项默认关闭。 允许向您的服务进行上传可能会造成安全风险。 仅在需要时将其打开。 |
执行模式 | 指定客户端(使用 web 工具的应用程序)如何与 web 工具进行交互以及如何获取输出。 当 Web 工具设置为同步时,客户端将等待任务完成。 通常,同步服务会快速运行完成(几秒钟内)。 如果设置为异步,则运行服务通常需要较长的时间,并且客户端必须定期检查服务器以确定服务是否已完成,如果已完成,则获取结果。 使用异步任务的 Web 应用程序必须已实施逻辑,才能在运行完成后检查任务状态并处理结果。 默认设置为异步。 |
查看地图图像图层中的输出 | 发布 web 工具或地理处理服务时,可以以地图图像形式来查看输出。 地图图像在服务器上创建,并以图像形式(带有样式信息的 .tiff 文件)传输回客户端。 地图图像的符号系统、标注、透明度和其他属性与最初发布时的 ArcGIS Pro 会话中的输出图层完全相同。 使用此参数时应考虑以下问题:
默认情况下取消选中该项。 |
消息级别 | 按如下步骤将以下级别的信息返回给运行 Web 工具的客户端:
警告:任何消息,无论级别如何,都可能包含数据集路径和名称,这可能会带来安全风险。 信息级别会更加详细且通常包含数据集路径和名称的参考。 一般情况下,在开发和测试环境中返回信息或警告级别的消息,在生产环境中使用无或错误级别的消息。 默认设置为无。 |
返回的最大记录数 | 服务可以返回给客户端的最大结果数。 将此值设成一个较大数值意味着 GIS 服务器可处理发送大量的个人记录或要素给客户端。 如果不返回任何要素,请将此值设为 0(零)。 当选中添加可选输出要素服务参数参数时,此属性不会产生效果。 默认值为 1000。 |
可在配置池化选项卡上访问以下参数设置。 有关指定这些设置时的更多注意事项,请参阅调整和配置服务。
参数 | 描述 |
---|---|
实例数 | 任何时刻可以在 ArcGIS Enterprise 的每台服务器计算机或 ArcGIS Enterprise on Kubernetes 的 gp-server-sync Pod 上运行的地理处理服务实例的最小和最大数量。 |
服务超时 - 最长使用时间 | 一个服务能被使用的最长时间(以秒计)。 对于长时间运行的地理处理任务,可能需要将默认值增加 600 秒(10 分钟)。 或者,可以减少此时间,以确保客户端不会滥用您的服务。 |
服务超时 - 最长等待时间 | 客户端在超时之前将等待连接到实例的最长时间(以秒为单位)。 当所有实例都在忙于处理请求时,随后的请求将排队。 如果在实例变为可用状态之前等待时间已用尽,则任务会失败。 默认值为 60 秒(1 分钟)。 |
服务超时 - 最长空闲时间 | 实例在池收缩之前将继续处于活动状态的最长时间(以秒为单位)。 对于所有超出最小实例数且未被使用的实例,一旦达到最长空闲时间,即会被关闭。 |
共享 web 工具之后,可在 ArcGIS Server Manager 中修改上述参数(不包括摘要和标签)。 可在门户的共享 web 工具的项目页面中更新此描述信息。
内容
下述设置只能在发布 web 工具或地理处理服务时进行修改。
添加工具
要将工具从地理处理历史记录添加至现有 web 工具或地理处理服务,请单击内容选项卡上的添加工具按钮 。 要移除工具,请单击工具名称并选择移除。
配置工具属性
要配置工具属性,请单击工具名称旁的编辑按钮 。
属性 | 描述 |
---|---|
名称 | 工具的名称。 默认值基于工具元数据。 |
描述 | 工具的描述。 描述无法从工具元数据继承。 如果描述为空白,请提供描述,每次从历史共享时描述都将保留。 |
可以为每个参数配置以下属性:
属性 | 描述 |
---|---|
名称 | 参数的名称和描述。 两个属性分别继承自工具元数据的参数名称和描述。 修改这些属性不会影响原始工具的元数据。 |
描述 | |
类型 | 参数类型定义了客户端是否必须给出一个值以使工具成功运行。 在内容选项卡中,只能将可选参数改为必要参数。 为了将必要参数改为可选参数,请退出共享窗格,编辑工具属性,然后再次运行工具以创建新结果。 |
保持数据类型为复合 | 仅当参数为复合数据类型时,此属性才可用。 用于指定参数是否将发布为复合数据类型(选中)。 默认情况下取消选中该项。 |
输入模式 | 指定客户端将向任务输入要素的方式。 有关 GUI 设计和用法,请参阅输入模式。
|
将数据类型转换为字符串 | 此属性仅适用于面积单位数据类型。 用于指定面积单位是否将转换为字符串数据类型(选中)或者发布为面积单位(未选中)。 默认情况下取消选中该项。 |
移除默认值 | 自 ArcGIS Pro 3.3 起,如果选中该项,则将在发布过程中移除在运行该工具时使用的默认值。 默认情况下取消选中该项。 |
默认值 | 工具的默认值由工具运行时指定的参数值决定。 要添加或更改参数的默认值,请使用相应的参数再次运行该工具。 |
仅使用默认图层 | 此属性仅适用于选择列表输入模式。 用于指定是否仅在此复选框下的列表视图中选中运行该工具时使用的选项(已选中)。 默认情况下取消选中该项。 |
几何类型 | 此属性仅适用于要素。 几何类型来自用于创建结果的输入和输出要素。 无法在内容选项卡上进行修改。 使用指定几何类型的要素重新运行该工具,并共享该操作所创建的结果。 |
方案 | 此属性仅适用于要素和表。 方案是构造作为工具输入的要素时客户端必须提供的字段(属性)列表。 该字段列表与用作结果创建工具的输入或输出的图层或数据集相同。 |
以下配置参数适用于整个工具:
参数 | 描述 |
---|---|
添加可选输出要素服务参数 | 可选输入参数,用于指定当使用 web 工具时,是否可将所有要素输出另存为托管要素服务。 仅当以异步执行模式的发布为 web 工具发布到 ArcGIS Enterprise 时,才支持此参数。 否则,此参数不适用于配置。 此参数默认处于选中状态。 |
“添加可选输出影像服务”参数 | 可选输入参数,用于指定当使用 web 工具或地理处理服务时,是否可将所有栅格输出另存为影像服务。 |
移除所有默认值 | 自 ArcGIS Pro 3.3 起,如果选中该项,则将移除在运行该工具时使用的所有默认值,并且将自动选中以上工具参数配置中的移除默认值复选框。 默认取消选中该项 |
ArcGIS Server Manager 设置
只能在 ArcGIS Server Manager 中修改以下各小节中的参数设置,不包括用于 ArcGIS Enterprise on Kubernetes 的 ArcGIS Enterprise Manager。 发布服务后,还可以在 ArcGIS Server Manager 中修改上述的大多数配置设置。
注:
修改以下任何设置将导致服务重启。
参数
可用的参数设置如下:
参数 | 描述 |
---|---|
集群 | 服务运行的集群。 仅当 ArcGIS Server 参与集群时,才能修改此设置。 |
目录 | 当运行该工具时,服务器用于写入文件的目录。 |
功能
可用的功能参数设置如下:
参数 | 描述 |
---|---|
WPS | 对地理处理服务启用 WPS 功能,使其他客户端能够通过 OGC 标准协议连接并使用工具。 |
进程
可用的进程参数设置如下:
参数 | 描述 |
---|---|
回收 | 控制回收服务的频率和时间。 从午夜开始,默认频率为每 24 小时一次。 与在低隔离或高隔离环境中都可运行的其他服务类型不同,地理处理服务只在高隔离环境中运行。 |