地形生成服务

许可：

要使用该资源，需获得 ArcGIS GIS 服务器高级许可和 ArcGIS Topographic Mapping 服务器扩展模块许可。

地形生成服务是地图服务的服务器对象扩展模块 (SOE)。 它允许在地图服务上使用地形生成功能，例如根据行业标准地图产品规格生成地形图。

了解有关地形生成服务的详细信息

了解有关 REST SOE 的详细信息

了解有关 ArcGIS Server Services Directory 的详细信息

发布服务

ArcGIS Pro 中的 Topographic Mapping 扩展模块支持您发布地形生成服务。

ArcGIS Server 中的配置

在发布服务后，可在 ArcGIS Server Manager 中配置服务可执行的操作及其他属性。 这些设置会在您选中地形生成复选框或单击地形生成时出现，并且仅在选中该复选框时应用。

运算

SOE 支持以下资源和操作：

• addProduct - 将地图产品的定义添加到可用于生成地图的服务。

• calculateExtent - 计算给定产品和版本的自定义感兴趣区域 (AOI)。

• delete - 删除已运行或已取消的作业，使其不再出现在查询中或占用服务器空间。

• generateProduct - 根据现有的地图产品定义自动执行生成布局或地图过程。

• removeProduct - 从地形生产服务中移除地图产品。

• updateProduct - 更新现有地图产品的属性。

• products - 获取地形生产服务支持的地图产品。

  • product - 从地形生产服务支持的产品中获取单个地图产品。

• jobs - 包含涉及运行的作业的操作。

  • cancel - 取消通过 generateProduct 端点提交的作业。

  • job - 跟踪 generateProduct 端点运行的作业的状态。 返回作业的状态、开始日期、上次修改日期和消息。

  • query - 跟踪 generateProduct 端点运行的作业的状态。 返回一组作业的状态、开始日期、上次修改日期和消息。

• workflows - 包含涉及使用 ArcGIS Workflow Manager 的地形生成工作流的资源和操作。

  • taskGroups - 包含涉及 SOE 任务组的操作。

    • addTaskGroup - 将工作流定义与组织所需的具体要求结合为一个 SOE 任务组，以供 createTaskGroupJob 操作用于创建 SOE 作业。

    • createTaskGroupJob - 使用 SOE 任务组创建 SOE 任务组作业，以生成 Workflow Manager 父作业及其子作业。

    • getTaskGroups - 返回有关 SOE 任务组的详细信息。

    • insertTasks - 将一组任务插入到现有 SOE 任务组生成作业中。

    • removeTaskGroup - 移除 SOE 任务组。

    • updateTaskGroup - 更新 SOE 任务组。

  • tasks - 包含涉及任务组作业的操作。

    • updateTask - 更新任务组作业中任务的参数值。

    • executeTaskJob - 运行 createTaskGroupJob 操作创建的 SOE 任务组作业。

    • getTask - 返回有关 SOE 任务作业的详细信息

  • projects - 包含支持拓扑生成服务器与 Workflow Manager 基于服务的工作流集成的操作。

    • addProject - 单参数操作，接受定义工程及其所有阶段的 JSON 对象。

    • queryProject - 返回表示工程的 JSON 对象数组。

    • removeProject - 移除工程。

    • updateProject - 更新工程 JSON 中定义的属性。

地形生成数据库

地形生成服务使用地理数据库存储数据。 所用的地理数据库类型由空间数据库引擎 (SDE) 连接文件确定。 在 Server Manager 中，必须在地形生成数据库文本框中指定 SDE 连接文件的路径。 ArcGIS Server 帐户必须拥有 .sde 连接文件所在位置的读取权限。

提示：

当在 ArcGIS Pro 中发布地形生成服务时，也可以通过 tmserverDatabase 文本框指定该文件的路径。

了解有关在 ArcGIS Pro 中发布地形生成服务的详细信息

地形服务器地理数据库包含多个表。 TPS_Property 表包含了从 ArcGIS Pro 发布服务时定义的属性，并且可在发布服务后通过 ArcGIS Server Manager 访问该表。 该表还存储了启用拓扑生成 SOE 后发布的每个服务的属性。 在 ArcGIS Enterprise 11.2 中，该表包含以下属性：ObjectID、ServiceIdentifier、Name 和 Value。

注:

ServiceIdentifier 列包含服务的唯一 ID。 如果 ID 值为 -1，则该属性是应用于所有服务的全局属性。

TPS_Property 表中的每行都是一个属性。 下表描述了每个属性：

属性	描述
AdditionalOutputPaths	适用于 generateProduct 操作的其他输出文件路径。 文件路径必须使用分号分隔。 注意： 如果 ArcGIS Server 帐户没有对指定文件的读写权限，将输出复制到这些位置的操作将失败。 在 CleanupInterval 属性定义的清理过程中，将删除任意指定位置的数据和输出文件。
AdminGroupId	此全局属性允许一组用户取消或删除 ArcGIS Topographic Mapping 服务器扩展模块中随附的 Web 应用中的作业。 要赋予某个群组这些权限，更新 AdminGroupId 属性使其与为 Web 应用程序创建的群组对应的群组 ID 值相匹配。 在独立 ArcGIS Server 部署中，可通过提供具有 ArcGIS Server 管理员角色类型的用户角色名称值作为该属性值，向群组分配这些权限。 了解有关 ArcGIS Server Manager 中的角色的详细信息
AllowedSDEAuthMode	允许的 SDE 身份验证模式。 支持以下程序： 注意： 通过更新该值更改模式存在安全风险。 建议不要更改此设置。 OSA - 操作系统身份验证，由操作系统或网络属性域执行的身份验证。 这是默认设置。 DBMS - 数据库管理系统用于管理用户名和密码。 基础 - 简单的用户名和密码身份验证，登录凭据由 ArcGIS Server 或 SDE 配置存储和管理。
AllowedServices	联合环境之外、组织认定安全的服务列表。 该列表应仅包含公共服务，且可为逗号分隔值。 服务 URL 结构会影响允许的服务。 例如： https://sampleserver6.arcgisonline.com/arcgis/rest/services/Census/MapServer/3 - 仅允许适用于 states 的图层服务（3 为 states）。 https://sampleserver6.arcgisonline.com/arcgis/rest/services/Census/MapServer - 允许该地图服务器中的图层服务。 https://sampleserver6.arcgisonline.com/arcgis/ - 允许 sampleserver6.arcgisonline.com 域内的所有服务。
AutoUpdateProducts	指定在服务器重启时，对 .json 文件中的地图产品定义所做的更新是否会传播到地形服务器地理数据库中的地图产品定义。 True - 当服务重启时，系统会使用随 Enterprise 产品数据文件一起安装的 .json 文件中的地图产品定义自动更新数据库中的现有地图产品定义。 这是默认设置。 False - 当服务重启时，系统不会使用随 Enterprise 产品数据文件一起安装的 .json 文件中的地图产品定义自动更新现有地图产品定义。
CleanupInterval	在从服务器中删除用于生成地图产品的临时数据和输出地图产品之前经过的小时数。 默认值为 24。
DateTimeFormat	当在作业输出文件名中使用包含日期或时间的令牌时的日期和时间格式。
DistributedJobFolders	该属性保留以供未来发布时使用，目前不受支持。
DistributedProcessing	该属性保留以供未来发布时使用，目前不受支持。
ExtractionProgress	指定在提取作业数据时是否更新作业进度。 默认值为 False。 提示： 在使用高容量部署时，值 False 可以降低数据库流量。
extractionTimeout	数据提取在超时前可以运行的时间（秒）。
<file type>	注: 这是一个全局属性，将 ServiceIdentifier 值设置为 -1。 以下为受支持的文件类型： .aprx .dt2 .gdb .pagx .pdf .tiff .zip 以下令牌可用于定义作业输出文件名： [JobName] - generateProduct SOE 操作的 outputName 参数值或 MPS 应用程序中的导出名称。 [JobId] - 在使用 generateProduct SOE 操作或 MPS 应用程序导出地图产品时创建的全局唯一标识符 (GUID)。 [JobStartDate] - 采用本地 UTC 时间格式的作业开始日期。 [User] - 启动作业的用户。 [ProductName] - 作业的指定地图产品名称。 [ProductVersion] - 作业的指定地图产品版本。 [SheetIdentifier] - 所选索引的国家参考编号 (NRN) 值。 [MGRS:<MGRS 精度>] - 提供图幅位置的军事格网参考系 (MGRS)。 [MGRS] - 4Q [MGRS:100km] - 4QFJ [MGRS:10km] - 4QFJ16 [MGRS:1km] - 4QFJ1267 [MGRS:100m] - 4QFJ123678 [MGRS:10m] - 4QFJ12346789 [MGRS:1m]—4QFJ1234567890 [MGRS:ICM] - 1234 [AOI.] - AOI 索引属性表值。 注: 如果指定字段包含空值，该令牌会出现在名称中。 如果格式缺少文件类型扩展名，则系统会自动添加该扩展名。 注意： 包含 [JobId] 令牌和/或 [JobStartDate] 令牌，以避免文件名冲突。
jobHistory	与地图生成作业相关的数据在数据库中的存储天数。 默认值为 365。 数据库中的工作相关记录将在规定天数后永久删除。
LastCleanup	作业临时数据上次从服务器删除的日期和时间。
productType	服务支持的地图产品类型。 多个值必须用逗号分隔，例如：TM, JOG。 地图产品定义具有一个 type 属性，服务返回的地图产品具有与指定值一致的值。
resourceCheckInterval	检查的间隔时间，以确认是否达到为触发清理设置的资源阈值。 资源包括磁盘空间。 默认值为 300s（300 秒）。 重要信息： 这被视为软清理，意味着 TopographicProduction 文件夹下的临时作业文件已删除，TPS_JOB 表中的作业记录更新为值 cleaned，复制到其他目录的文件保持完整。
storageHighThreshold	从最早的作业开始触发强制清理的磁盘使用百分比。 默认值是 %90 （90%）。 重要信息： 这被视为软清理，意味着 TopographicProduction 文件夹下的临时作业文件已删除，TPS_JOB 表中的作业记录更新为值 cleaned，复制到其他目录的文件保持完整。
storageLowThreshold	要在强制性 SOE 清理因磁盘使用百分比过高而触发时达到的磁盘使用百分比。 默认值为 %80 (80%)。 重要信息： 这被视为软清理，意味着 TopographicProduction 文件夹下的临时作业文件已删除，TPS_JOB 表中的作业记录更新为值 cleaned，复制到其他目录的文件保持完整。
UseJobIdFolder	此全局属性用于指定作业的默认输出文件夹是否根据作业 ID 进行命名。 默认值为 True。 如果值设置为 False，则 jobStatus 响应中的输出 URL 将不包含任何作业 ID。
Version	地形服务器地理数据库的版本。 注: 从 ArcGIS Enterprise 12.1 开始，此值与当前版本的 Enterprise 保持一致。
WorkflowItemIdentifier	与拓扑生成工作流项目相关的 ID 字符串。
WorkflowLocalJobFolder	这是指向包含本地作业数据的文件夹位置的路径。