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

注册到 iPortal 中的服务可供各内置 WebApps 使用或供其他 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
ArcGIS VectorTile 服务 http://<server>:<port>/arcgis/rest/services/{serviceName}/VectorTileServer
 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 不支持解析 WFS2.0.0 及以上版本、WCS1.1.1 及以上版本的元数据信息。
  • iPortal 解析出来的元数据信息中，坐标系信息出现 -1000 等异常值时，表示该服务的坐标系是用户自定义的。

查看服务中的地图

支持查看地图工作室 WebApp 地图。操作方式：进入地图服务详情页，切换至“地图列表”标签页，点击地图 URL，即可在新窗口中查看地图。

编辑服务中的地图

支持在线修改通过 restjsr 服务发布的矢量瓦片服务中地图的样式。操作方式如下：

  1. 在 iServer 中发布 restjsr 服务
  2. 在 [iServer安装目录]/webapps/iserver/WEB-INF 路径下的 iserver-service.xml 文件中配置<styleContentsStorageRoot>{保存表达式制图样式变更的目录}</styleContentsStorageRoot> 
  3. 在 iPortal 管理页面 > 服务 中，配置托管服务器 iServer
  4. 在 iPortal 资源中心 > 服务 中，注册托管服务器 iServer 的 restjsr 服务
  5. 进入矢量瓦片服务详情页，切换至“地图列表”标签页，点击地图右侧的“编辑地图”，即可进入地图工作室 WebApp 在线编辑矢量瓦片服务的地图样式。支持添加当前地图中已有的图层、删除图层，以及通过表达式制图修改图层样式，即按不同的级别、数据范围、数据条件进行制图。
  6. 编辑完成后，点击“保存”，会在当前矢量瓦片服务中保存该地图的编辑内容，点击“另存为”，则会将该地图保存为当前矢量瓦片服务中的一幅新地图。用户对服务中地图的编辑会保存至服务本身，而非保存为 iPortal 中的地图资源。

表达式制图

  1. 选择图层样式类型，点击图标，启用表达式制图，在弹窗中选择以下其中一种表达式类型：
  • 按级别：根据地图缩放级别设置不同样式，从而在不同缩放级别下实现地图样式的动态变化，例如：在缩放级别较小时突出城市主干道，放大后则清晰显示所有次干道和支路的样式。
    • 函数类型: 定义在不同缩放级别节点之间缩放时，图层样式的过渡方式。

      • 线性插值：样式属性值会随着缩放级别的变化而均匀、线性地改变。

      • 指数插值：通过基准值控制变化速率。基准值越接近 1，效果越接近线性插值。基准值大于 1，属性值会在缩放级别的后半段变化更快。值介于 0 到 1 之间，属性值则会在前半段变化更快。

      • 贝塞尔插值：通过定义四个控制点来生成一条平滑的贝塞尔曲线，从而精确控制属性值的变化节奏，用于实现高度定制化的、非线性的过渡效果。

      • 阶梯函数：根据缩放级别所在的区间直接跳变到对应的样式值，适用于需要清晰、离散样式变化的场景。

    • 节点: 配置地图缩放级别与图层样式的映射关系，由一系列 [缩放级别, 样式值] 对组成。地图缩放时，样式会在这些节点之间发生改变。
  • 按数据范围：根据数据字段范围设置样式渐变，适用于连续数据的可视化，例如：根据人口密度数值，区域颜色从浅到深渐变。
    • 数据字段: 选择用于驱动样式变化的数据字段。
    • 函数类型: 定义在数据字段值变化时，图层样式的过渡方式。与“按级别”驱动制图方式中的函数类型一致。
    • 节点: 配置数据字段值与图层样式的映射关系，由一系列 [数据值, 样式值] 对组成，定义了数据值到样式值的映射关系。
  • 按数据条件：根据数据条件匹配设置不同样式，适用于根据数据分类应用不同的样式，例如高速公路显示为红色，一般道路显示为灰色。
    • 数据字段: 选择用于条件判断的数据字段。
    • 条件: 配置数据条件与图层样式映射关系的逻辑表达式，由一系列 [条件,值,样式] 对组成。
    • 其他值: 为不满足任何条件的要素配置一个默认样式。

  1. 点击“添加节点”（或“添加条件”）会在当前分段中新增一个节点（或条件），实现更精细的样式变化控制。点击“清空”会将数据驱动样式重置为初始状态，需重新选择表达式类型。

  2. 数据驱动表达式支持嵌套（最多两级），点击条件右侧的，配置下一层级的表达式，配置方式与第一层级相同。例如，第一层级按级别设置不同样式，第二层级按数据条件匹配不同样式，即在缩放级别大于某一级别后，再根据道路分类来设置不同的颜色和宽度。

表达式制图支持在 UI 面板和 JSON 面板中编辑：

  • 当图层样式不符合 Mapbox 样式规范时，只能通过 UI 面板编辑，无法通过 JSON 面板修改图层样式
  • 当图层样式符合 Mapbox 样式规范且兼容 UI 面板的可视化规则时，则可随时切换 UI 面板和 JSON 面板进行编辑
  • 当图层样式符合 Mapbox 样式但样式逻辑较为复杂时，只能通过 JSON 面板编辑，无法通过 UI 面板修改图层样式

使用 iPortal 中的服务资源

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

  • 在数据上图 WebApp 中：选择底图后，可通过搜索将“我的服务”中的REST 地图服务和数据服务作为图层添加到底图上；若添加的是REST 数据服务，可基于此图层继续制作您需要的专题图。
  • 在地图工作室 WebApp 中：选择底图后，可将来自 Web 和门户中的 SuerMap REST 服务、OGC WMTS 服务、OGC WMS 服务作为图层添加到底图上；若添加的是 REST 数据服务，可基于此图层继续制作您需要的专题图。
  • 在数据洞察 WebApp 中：可将REST 地图服务或 REST 数据服务添加进来，基于这些服务结合您的需求，可使用地图或图表进行可视化表达，也可在地图视图中，使用分析功能更深层次地发掘数据蕴藏的规律与价值。
  • 在三维地球 WebApp 中：您可将REST 三维服务以图层的形式添加到场景中，基于此场景添加点线面要素，或在场景中量算、查询功能，或三维分析等。
  • 在地图大屏 WebApp 中，支持将公开的服务、我的服务、iServer REST 服务等作为可视化组件的数据源，详见：添加可视化组件。
  • 在应用构建器 WebApp 中，支持将公开的服务、我的服务、iServer REST 服务等作为可视化组件的数据源，详见：添加数据。
  • 在您开发的 Web GIS 系统中调用 iPortal 中的服务资源，详见：使用 iCient JavaScript 访问 iPortal 中的资源。