您可以使用服务器对象扩展模块 (SOE) 和服务器对象拦截器 (SOI) 扩展从 ArcGIS Pro 发布的地图和影像服务。 SOE 可用于创建服务操作以扩展基本服务功能,而 SOI 可用于拦截请求和服务内置操作的响应。
SOE 和 SOI 可以使用 ArcGIS Enterprise SDK 开发,两者均封装在 .soe 文件中。 可以将其添加到组织,并通过 ArcGIS Enterprise Manager 管理。 将 SOE 和 SOI 添加到组织后,从 ArcGIS Pro 发布地图和影像服务时可以启用它们,也可以从项目详细信息页面上为地图图像图层启用。
添加扩展模块
要将扩展模块添加到组织,需要扩展模块开发人员创建的 .soe 文件。 该文件中可以包含一个或多个扩展模块。
获得该文件后,请执行以下步骤:
-
以管理员身份登录到 ArcGIS Enterprise Manager。
注:
组织可以选择允许发布者部署扩展模块。 有关详细信息,请参阅更改地理处理服务和服务扩展发布权限。
- 在侧边栏中,单击扩展模块按钮。
扩展模块页面随即显示。
- 单击添加扩展模块。
- 单击选择文件,选择要添加到组织的 .soe 文件。
- 单击添加扩展模块。
.soe 文件即会添加到组织。
您已将扩展模块添加到组织,必须在所需的地图或影像服务上启用 SOE 或 SOI 功能。
启用 SOE
将 SOE 添加至组织后,可以在地图或影像服务上启用该功能。 可以通过项目详细信息页面为地图图像图层启用 SOE。
要从图层的项目详细信息页面中启用 SOE,请完成以下步骤:
- 以具有发布权限的项目所有者或管理员身份登录到组织。
- 打开地图图像图层的项目详细信息页面。
- 单击设置。
- 滚动至地图图像图层部分并展开扩展模块标题。
- 展开服务器对象扩展模块 (SOE) 标题。
随即显示已添加至组织的 SOE 列表。
- 打开要在服务上启用的 SOE 旁的切换按钮。
- 展开已启用的 SOE 的标题。
随即显示 SOE 的操作和属性。 这些内容可能由扩展模块开发人员创建,借助它们,您可以精细地控制用户可利用 SOE 执行的操作。
- 如果适用,选择要允许的操作。
- 如果适用,编辑可用属性。
- 单击保存应用更改。
现已在服务上启用 SOE。 要禁用功能,关闭 SOE 旁边的切换按钮,然后单击保存。
启用 SOI
将 SOI 添加至组织后,可以在地图或影像服务上启用该功能。 可以通过项目详细信息页面为地图图像图层启用 SOI。
启用多个 SOI 称为链接。 链接时,必须指定 SOI 在服务中的运行顺序。
要从图层的项目详细信息页面中启用 SOI,请完成以下步骤:
- 以具有发布权限的项目所有者或管理员身份登录到组织。
- 打开地图图像图层的项目详细信息页面。
- 单击设置。
- 滚动至地图图像图层部分并展开扩展模块标题。
- 展开服务器对象拦截器 (SOI) 标题。
随即显示已添加至组织的 SOI 列表。
- 打开要在服务上启用的 SOI 旁的切换按钮。
- 如果启用多个 SOI,请使用拖放功能指定 SOI 在链中的执行顺序。
将首先运行列表顶部的 SOI。
提示:
可随时返回此对话框以修改已启用 SOI 的列表并更改在链中的运行顺序。
- 展开已启用的每个 SOI 的标题。
随即显示 SOI 的操作和属性。 这些内容可能由扩展模块开发人员创建,借助它们,您可以精细地控制用户可利用 SOI 执行的操作。
- 如果适用,选择要允许的操作。
- 如果适用,编辑可用属性。
- 单击保存应用更改。
服务上现已启用 SOI。 要禁用功能,关闭 SOI 旁边的切换按钮,然后单击保存。
配置调试设置
为启用调试,您可使用 ArcGIS Enterprise Manager 更改扩展模块行为。 您可以选择暂停服务启动,这样在调用扩展模块初始化方法之前将调试程序附加到服务进程中。 您还可指定调试服务时使用的一系列端口。
要在 Enterprise Manager 中访问这些调试设置,请执行以下步骤:
- 以管理员身份登录到 ArcGIS Enterprise Manager。
- 在侧边栏中,单击服务按钮。
服务页面随即显示。
- 找到并单击已注册 SOE 的服务名称。
- 选择高级选项卡并启用调试模式。
启用调试模式后,将显示扩展模块调试设置。
- 或者,可启用暂停服务启动,然后指定服务启动应延迟的秒数。
- 另外,指定调试时使用的一系列端口。
- 单击保存。
删除扩展模块
当在 ArcGIS Enterprise Manager 中删除扩展模块时,将从您的组织中移除扩展模块。 如果扩展模块已注册到服务,则删除扩展模块也将取消注册。
要删除扩展模块,请执行以下步骤:
- 以管理员身份登录到 ArcGIS Enterprise Manager。
- 在侧边栏中,单击扩展模块按钮。
扩展模块页面随即显示。
- 单击要删除的扩展模块的更多选项按钮 ,并单击删除。
- 再次单击删除以确认。
将从服务中取消注册扩展模块并将其从组织中移除。
更新扩展模块
通过添加更新后的 .soe 文件,可以更新已添加到组织中的扩展模块。
要更新扩展模块,请执行以下步骤:
- 以管理员身份登录到 ArcGIS Enterprise Manager。
- 在侧边栏中,单击扩展模块按钮。
扩展模块页面随即显示。
- 单击要更新的扩展模块的更多选项按钮 ,并单击更新。
- 单击选择文件,选择更新版本的 .soe 文件。
文件名必须与原始 .soe 文件名匹配。
- 单击更新扩展模块。
扩展模块将使用新的 .soe 文件进行更新。