服务

发送反馈


作为 GIS 门户软件平台,SuperMap iPortal 支持通过注册的方式整合多源异构 Server 服务器中的服务,从而对这些服务进行统一的管理,对外提供统一的访问出口。此外,iPortal中托管数据发布的服务(即托管服务)也会自动注册到门户中。注意:若管理员开启了服务审核功能,新添加到门户中的服务审核通过后,才能在门户中搜索与使用。

注册到 iPortal 中的服务可供各内置 Web Apps 使用或供其他 Web GIS 应用系统调用。下面详细介绍服务注册功能以及 iPortal 中服务资源的使用。

 

服务注册

在 iPortal 中注册服务要求用户是“创建者”类型且拥有注册服务权限的角色,如 PORTAL_USER、DATA_CENTER(iPortal的用户类型及权限划分,详见:角色、用户类型和权限)。

为了对注册到门户中的多源服务进行统一的管理、对外提供统一的服务访问地址,同时也出于保护原始服务地址的考虑,iPortal 提供了服务代理功能(默认启用内置的服务代理,您也可以选择独立部署的服务代理)。iPortal 默认使用 http 协议启用服务代理,若注册的原始服务采用 https 协议,代理后的地址将以 http 协议启用。使用 https 协议启用服务代理,参见:配置服务代理以 HTTPS 协议启用

支持的服务类型

iPortal 支持将 SuperMap REST 服务、ArcGIS REST 服务、OGC 服务注册到门户中。关于支持注册的服务类型及注册地址格式详见表1。

表1 SuperMap iPortal 支持注册的服务类型及注册地址格式

服务类型 服务地址格式
SuperMap REST 服务 REST 地图服务 http://<server>:<port>/iserver/services/map-china400/rest
http://<server>:<port>/iserver/services/map-china400/rest/maps
或注册到单个地图级别:
http://<server>:<port>/iserver/services/map-china400/rest/maps/China
 
也支持注册不限格式的请求,但其响应须与以上任一服务地址返回的响应格式一致。
REST 矢量瓦片服务 http://<server>:<port>/iserver/services/map-china400/restjsr
http://<server>:<port>/iserver/services/map-china400/restjsr/v1/vectortile
或注册到单个地图级别:
http://<server>:<port>/iserver/services/map-china400/restjsr/v1/vectortile/maps/China
 
也支持注册不限格式的请求,但其响应须与以上任一服务地址返回的响应格式一致。
REST 影像服务 http://<server>:<port>/iserver/services/imageservice-ChinaImage/restjsr
REST 数据服务 http://<server>:<port>/iserver/services/data-world/rest
或注册到数据源中的单个数据集级别:
http://<server>:<port>/iserver/services/data-world/rest/data/datasources/World/datasets/LandCover
 
也支持注册不限格式的请求,但其响应须与以上任一服务地址返回的响应格式一致。
REST 三维服务 http://<server>:<port>/iserver/services/3D-CBD/rest
或注册到三维数据源中的单个数据集级别:
http://<server>:<port>/iserver/services/3D-CBD/rest/realspace/datas/Ground_2@CBD
或注册到单个三维场景级别:
http://<server>:<port>/iserver/services/3D-CBD/rest/realspace/scenes/CBD
其他 REST 类型服务 http://<server>:<port>/iserver/services/serviceName/rest(jsr)
ArcGIS REST 服务 http://<server>:<port>/arcgis/rest/services/ServiceRequest/MapServer
 OGC WMS 服务(版本:1.1.1、1.3.0) http://<server>:<port>/iserver/services/map-china400/wms130
或注册到单个地图级别:
http://<server>:<port>/iserver/services/map-china400/wms130/China
OGC WFS 服务(版本:1.0.0、2.0.0) http://<server>:<port>/iserver/services/data-china400/wfs100
OGC WMTS 服务(版本:1.0.0) http://<server>:<port>/iserver/services/map-china400/wmts100
OGC WCS 服务(版本:1.1.1、1.1.2) http://<server>:<port>/iserver/services/data-china400/wcs111
OGC WPS 服务(版本:1.0.0) http://<server>:<port>/iserver/services/traffictransferanalyst-sample/wps100
其他服务 http://<server>:<port>/...

 

 

注册步骤

 

登录 iPortal,点击“资源中心”>“服务”进入服务资源页面,点击右侧的“注册服务”进入注册页面,执行以下操作;

  1. 选择服务类型
  2. 填写服务地址,参见:SuperMap iPortal 支持注册的服务类型及注册地址格式
  3. 填写服务名称
  4. 若注册受保护的服务,需勾选“指定凭据”,并在下拉列表中选择与受保护服务匹配的凭据。若未创建凭据,点击下拉列表底部的“添加凭据”,完成凭据的创建
  5. 指定服务的存放目录(可选):

    如果管理员已经在门户中开启并配置了服务资源的自定义目录,您可以将注册的服务添加到自定义目录中。需要注意的是,同一个服务支持被添加到不同的目录结构树中,但一个目录结构树中,同一个服务只能被添加一次。

  6. 设置服务的元数据信息:

    iPortal 会自动解析该服务的元数据信息,如:标签、描述信息、服务参照系信息(坐标系和投影类型)、服务标识信息(覆盖区域)、服务范围信息、服务提供者的基本信息等。对于没有元信息或没有解析出的元信息项您可以手动添加,也可以手动修改已解析出来的元信息,如您可以设置服务的自定义预览地址,设置后可通过该地址查看服务。完成后,点击“下一步“;
  7. 设置服务的共享方式:

    默认的共享方式为公开可检索,即iPortal 的所有用户(包含匿名用户)都可以检索到该服务。您也可以将服务设置为公开可见,分享给 iPortal 的所有用户(包含匿名用户)可访问;或设置为私有,除本人外所有用户都无法查询或访问;或分享给指定部门(默认未开启),指定部门内的成员都可以查询和访问该服务;也可分享给指定的群组,组内的成员都可以查询和访问该服务;或分享给指定的部分用户,除本人外只有这些用户可以查询和访问该服务。设置详情,参见:共享服务

  8. 点击“注册”按钮完成服务注册。

 

注册服务时,会检测服务是否真实可用,若服务不可用,即不支持注册。唯一不同的是,注册“其他”类型的服务时,可禁用服务在线检测,也允许用户自定义设置需要检测的服务地址。

注册完成后的服务项会显示在“资源中心”>“服务”>“我的服务”页面。在”我的服务“页面,您可查看到该服务的可访问状态(iPortal对注册进来的服务支持动态在线/离线校验,默认更新时间为30分钟。管理员可根据需要修改此项配置,详见:服务动态更新时间设置。),也可以查看/编辑详情、修改共享设置删除此资源,还可以更新服务的地址与元信息。

iPortal 也为管理员提供了批量注册 SuperMap iServer 服务的功能,详见:批量注册

此外,若 iPortal 管理员开启了服务审核功能(默认未开启),注册到 iPortal 中的这些服务(包括托管数据发布后自动注册的服务)会进入“待审核”状态,需要管理员审核通过才能注册成功。对未审核通过的服务设置共享不会生效。

 

注意:

使用iPortal中的服务资源

iPortal 中的服务资源(含注册服务和托管服务)可供用户进行预览查看,可作为各内置 Web Apps 中的数据来源,也可供用户开发的 Web GIS 系统调用。具体来说: