Web 工具属性高级设置

以下 web 工具属性为高级设置,无法使用 ArcGIS Server Manager 进行设置;它们实际上是 web 工具引用的地理处理服务,只能使用联合 ArcGIS Server Administrator REST API 进行设置。 仅需针对具有不同需求的特定 web 工具来修改这些设置。

更改堆大小

堆大小设置可控制由客户端提供的最大文件大小。 可将其设置为两种级别:ArcGIS Server 或服务。

在服务级别更改堆大小比在 Server 级别更改堆大小的性能更佳。 自 ArcGIS Server 10.7 起,可在服务级别设置堆大小。 每个服务的默认大小为 64 MB。 如果输入文件或要素类大于默认大小,请按照以下步骤更改服务堆大小:

  1. 在 web 浏览器中,浏览至 https://machine.domain.com/webadaptor/admin/login
  2. 使用管理员帐户登录到 ArcGIS Server Administrator Directory。
  3. 单击 Resources: Services 链接以查看显示所有已发布服务的新页面。
  4. 单击要修改堆大小的服务,然后启动包含所有服务属性的页面。
  5. 在包含服务属性的页面中,单击 frameworkProperties 链接以查看具有采用 JSON 格式的可编辑服务属性的页面。
    采用 JSON 格式的服务属性的示例
  6. 如果 javaHeapSize 未在服务属性中列出,则以 JSON 格式添加属性 {"javaHeapSize":"128"}。 如果包含 javaHeapSize,则将值增加至适当的大小。
  7. 单击保存编辑内容进行保存并结束编辑。

要在 Server 级别更改堆大小,请按以下详述步骤进行操作: 默认情况下,SOC 最大堆大小设置为 64 MB。 将属性的默认值增加至适当的大小。

  1. 在 web 浏览器中,浏览至 https://machine.domain.com/webadaptor/admin/login
  2. 使用管理员帐户登录到 ArcGIS Server Administrator Directory。
  3. 单击计算机
  4. 单击 <服务器名称>.<域>.com 链接。

    例如,链接可能像这样 server1.esri.com

  5. 服务器计算机属性页面上,单击编辑链接。
  6. 增大 SOC 最大堆大小(以 MB 为单位)的值。
  7. 单击保存编辑内容以结束编辑。

上传大小

上传大小设置控制了客户端可上传的文件大小,这些客户端通过一个 REST 端点连接至服务。 这些客户端通常通过自定义的 Web 应用程序使用服务的 Web 客户端。 默认情况下,极限值被设置为 2 GB。 使用此设置可以提供一个适当的默认值,避免为您的服务上传过大文件。

  1. 打开 web 浏览器,然后浏览至 https://machine.domain.com/webadaptor/admin/login
  2. 使用管理员帐户登录到 ArcGIS Server Administrator Directory。
  3. 单击服务
  4. 单击服务名称。
  5. 支持的操作下的页面底部单击编辑链接。
  6. 服务(JSON 格式):* 文本框中,找到 maxUploadFileSize 标签并在冒号 (:) 后设置最大文件大小。

    一条完整的条目看起来会类似于 "maxUploadFileSize": 100,

  7. 单击保存编辑
注:

发布 web 工具时,请确保共享为 Web 工具配置面板中的上传复选框已选中。 或者,可通过服务的功能设置页面上的 ArcGIS Server Manager 在现有服务上启用此设置。

上传类型

只有特定文件才可上传至 web 工具。 这些文件受各自的扩展名类型的限制(扩展名类型在服务级别设定)。

  1. 打开 web 浏览器,然后浏览至 https://machine.domain.com/webadaptor/admin/login
  2. 使用管理员帐户登录到 ArcGIS Server Administrator Directory。
  3. 单击服务
  4. 单击服务名称。
  5. 支持的操作下的页面底部单击编辑链接。
  6. 服务(JSON 格式):* 文本框中,找到 allowedUploadFileTypes 标签并在冒号 (:) 后添加您想要允许的文件扩展名(扩展名以双引号括起)。

    一条完整的条目看起来会类似于 "allowedUploadFileTypes": ".kml,.gpx"

  7. 单击保存编辑
注:

发布 web 工具时,请确保共享为 Web 工具配置面板中的上传复选框已选中。 或者,可通过服务的功能设置页面上的 ArcGIS Server Manager 在现有服务上启用此设置。

更改最大属性域计数

最大属性域代码计数设置用于控制与服务响应一同返回的属性域的数量。 与代码匹配的属性域描述与要素输出响应一同返回。 该设置的默认值为 1000。 如果输出要素的参与属性域数量超过 1000,则不会返回任何属性域信息。 返回的属性域信息可能会增加响应大小。 如果不需要属性域,可将该值设定为 0 或小于服务中属性域数量的值。

  1. 打开 web 浏览器,然后浏览至 https://machine.domain.com/webadaptor/admin/login
  2. 使用管理员帐户登录到 ArcGIS Server Administrator Directory。
  3. 单击服务
  4. 单击服务名称。
  5. 支持的操作下的页面底部单击编辑链接。
  6. 服务(JSON 格式):* 文本框中,找到 maxDomainCodeCount 标签并在冒号 (:) 后设置最大限制。

    一条完整的条目看起来会类似于 “最大属性域代码计数”:25,

  7. 单击保存编辑

本地临时文件夹

当服务器参与拥有超过一台计算机的集群时,或使用 UNC 路径引用目录时,本地 temp 文件夹是可供 ArcGIS Server 写入中间输出的目录。 这样可避免将中间数据写入 UNC 路径临时地理数据库或临时文件夹,从而可以提高服务性能。 执行完成后,结果将从本地临时文件夹复制到作业目录,该目录可以为 UNC 路径。

将作业目录重用于同步服务

如果 web 工具基于同步地理处理服务,可通过应用 "reusejobdir": "true" 重用作业目录,以提高性能。 通常,每次执行同步地理处理服务时,都会在服务器计算机的 arcgisjobs 文件夹中创建作业文件夹。 完成时,ArcGIS Server 将删除该作业文件夹。 通过将 reusejobdir 属性设置为 true,即使在作业完成执行后也会保留作业文件夹。 这可以省去了为下一次执行创建临时 GDB 和临时文件夹的时间,因此会在一定程度下提高性能。 (可选)如果将此属性重新设置为 "false",或移除此属性,请联系管理员删除此服务的任何现有作业文件夹。

要设置此属性,请联系系统管理员在 Administrator API 中编辑服务属性。

显示 reusejobdir 属性的简化 JSON。 已隐藏其他属性以高亮显示与此功能有关的更改。

{
    "serviceName": "sample",
    "type": "GPServer",
    "manyotherkeys": "manyothervalues",
    "properties": {
        "manyotherkeys": "manyothervalues",
        "reusejobdir": true,
        "executionType": "Synchronous"
    },
    "portalProperties": {},
    "extensions": []
}

将消息写入 ArcGIS Server 日志

如果将 web 工具发布到 ArcGIS Server 11.3 或更高版本,则可以在 ArcGIS Server 日志中包含来自 web 工具的消息副本。 ArcGIS Server 日志消息级别将与 web 工具消息级别相匹配。 对于 web 工具消息,将存在 3 个级别:错误、警告或信息,这些级别与 ArcGIS Server 中的严重、警告或信息相匹配。 可以使用脚本工具消息手动设置 web 工具消息。 许多地理处理工具还包含自己的预设消息。 为了确保在 ArcGIS Server 中正确记录消息,请相应地指定服务器日志设置

要设置此属性,请联系系统管理员以在 Administrator REST API编辑服务属性。

显示 logGPMessages 属性的简化 JSON。 已隐藏其他属性以高亮显示与此功能有关的更改。

{
    "serviceName": "sample",
    "type": "GPServer",
    "manyotherkeys": "manyothervalues",
    "properties": {
        "manyotherkeys": "manyothervalues",
        "logGPMessages": true,
        "executionType": "Asynchronous"
    },
    "portalProperties": {},
    "extensions": []
}