扩展服务

您可以使用服务器对象扩展模块 (SOE) 和服务器对象拦截器 (SOI) 扩展从 ArcGIS Pro 发布的地图和影像服务。 SOE 可用于创建服务操作以扩展基本服务功能,而 SOI 可用于拦截请求和服务内置操作的响应。

SOE 和 SOI 可以使用 ArcGIS Enterprise SDK 开发,两者均封装在 .soe 文件中。 可以将其添加到组织,并通过 ArcGIS Enterprise Manager 管理。 将 SOE 和 SOI 添加到组织后,从 ArcGIS Pro 发布地图和影像服务时可以启用它们,也可以从项目详细信息页面上为地图图像图层启用。

添加扩展模块

要将扩展模块添加到组织,需要扩展模块开发人员创建的 .soe 文件。 该文件中可以包含一个或多个扩展模块。

获得该文件后,请执行以下步骤:

  1. 以管理员身份登录到 ArcGIS Enterprise Manager

    注:

    组织可以选择允许发布者部署扩展模块。 有关详细信息,请参阅更改地理处理服务和服务扩展发布权限

  2. 在侧边栏中,单击扩展模块按钮。

    扩展模块页面随即显示。

  3. 单击添加扩展模块
  4. 单击选择文件,选择要添加到组织的 .soe 文件。
  5. 单击添加扩展模块

    .soe 文件即会添加到组织。

您已将扩展模块添加到组织,必须在所需的地图或影像服务上启用 SOE 或 SOI 功能。

启用 SOE

将 SOE 添加至组织后,可以在地图或影像服务上启用该功能。 可以通过项目详细信息页面为地图图像图层启用 SOE。

要从图层的项目详细信息页面中启用 SOE,请完成以下步骤:

  1. 以具有发布权限的项目所有者或管理员身份登录到组织。
  2. 打开地图图像图层的项目详细信息页面
  3. 单击设置
  4. 滚动至地图图像图层部分并展开扩展模块标题。
  5. 展开服务器对象扩展模块 (SOE) 标题。

    随即显示已添加至组织的 SOE 列表。

  6. 打开要在服务上启用的 SOE 旁的切换按钮。
  7. 展开已启用的 SOE 的标题。

    随即显示 SOE 的操作和属性。 这些内容可能由扩展模块开发人员创建,借助它们,您可以精细地控制用户可利用 SOE 执行的操作。

  8. 如果适用,选择要允许的操作。
  9. 如果适用,编辑可用属性。
  10. 单击保存应用更改。

现已在服务上启用 SOE。 要禁用功能,关闭 SOE 旁边的切换按钮,然后单击保存

启用 SOI

将 SOI 添加至组织后,可以在地图或影像服务上启用该功能。 可以通过项目详细信息页面为地图图像图层启用 SOI。

启用多个 SOI 称为链接。 链接时,必须指定 SOI 在服务中的运行顺序。

要从图层的项目详细信息页面中启用 SOI,请完成以下步骤:

  1. 以具有发布权限的项目所有者或管理员身份登录到组织。
  2. 打开地图图像图层的项目详细信息页面
  3. 单击设置
  4. 滚动至地图图像图层部分并展开扩展模块标题。
  5. 展开服务器对象拦截器 (SOI) 标题。

    随即显示已添加至组织的 SOI 列表。

  6. 打开要在服务上启用的 SOI 旁的切换按钮。
  7. 如果启用多个 SOI,请使用拖放功能指定 SOI 在链中的执行顺序。

    将首先运行列表顶部的 SOI。

    提示:

    可随时返回此对话框以修改已启用 SOI 的列表并更改在链中的运行顺序。

  8. 展开已启用的每个 SOI 的标题。

    随即显示 SOI 的操作和属性。 这些内容可能由扩展模块开发人员创建,借助它们,您可以精细地控制用户可利用 SOI 执行的操作。

  9. 如果适用,选择要允许的操作。
  10. 如果适用,编辑可用属性。
  11. 单击保存应用更改。

服务上现已启用 SOI。 要禁用功能,关闭 SOI 旁边的切换按钮,然后单击保存

配置调试设置

为启用调试,您可使用 ArcGIS Enterprise Manager 更改扩展模块行为。 您可以选择暂停服务启动,这样在调用扩展模块初始化方法之前将调试程序附加到服务进程中。 您还可指定调试服务时使用的一系列端口。

要在 Enterprise Manager 中访问这些调试设置,请执行以下步骤:

  1. 以管理员身份登录到 ArcGIS Enterprise Manager
  2. 在侧边栏中,单击服务按钮。

    服务页面随即显示。

  3. 找到并单击已注册 SOE 的服务名称。
  4. 选择高级选项卡并启用调试模式。

    启用调试模式后,将显示扩展模块调试设置。

  5. 或者,可启用暂停服务启动,然后指定服务启动应延迟的秒数。
  6. 另外,指定调试时使用的一系列端口。
  7. 单击保存

删除扩展模块

当在 ArcGIS Enterprise Manager 中删除扩展模块时,将从您的组织中移除扩展模块。 如果扩展模块已注册到服务,则删除扩展模块也将取消注册。

要删除扩展模块,请执行以下步骤:

  1. 以管理员身份登录到 ArcGIS Enterprise Manager
  2. 在侧边栏中,单击扩展模块按钮。

    扩展模块页面随即显示。

  3. 单击要删除的扩展模块的更多选项按钮 ,并单击删除
  4. 再次单击删除以确认。

    将从服务中取消注册扩展模块并将其从组织中移除。

更新扩展模块

通过添加更新后的 .soe 文件,可以更新已添加到组织中的扩展模块。

要更新扩展模块,请执行以下步骤:

  1. 以管理员身份登录到 ArcGIS Enterprise Manager
  2. 在侧边栏中,单击扩展模块按钮。

    扩展模块页面随即显示。

  3. 单击要更新的扩展模块的更多选项按钮 ,并单击更新
  4. 单击选择文件,选择更新版本的 .soe 文件。

    文件名必须与原始 .soe 文件名匹配。

  5. 单击更新扩展模块

    扩展模块将使用新的 .soe 文件进行更新。