服务

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

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

• 服务注册
• 使用iPortal中的服务资源

服务注册

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

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

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

注：注册受保护的来源于 SuperMap iServer 的服务时，服务地址后面需带 Token，格式如“?token=xx”，生成 Token 的客户端标识类型需为“无客户端限制”。

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

注册步骤：

1. 在iPortal首页，点击“资源中心”>“服务”进入服务资源页面，右侧点击“注册服务”（需登录）进入注册页面；

2. 设置服务的基本信息：

   • 选择要注册服务的服务类型，输入服务地址，填写服务名称，点击“下一步“；
   • 若您注册的是 SuperMap REST 地图服务或三维服务，此时界面会列出该服务中的所有地图或场景；若您注册的是单个地图的服务，界面仅会列出当前的地图；此时，您可选择勾选这些地图或场景以添加到门户中，若不勾选仅会将此服务注册到门户，然后点击“下一步“；

3. 设置服务的元数据信息：

   iPortal 会自动解析该服务的元数据信息，如：标签、描述信息、服务参照系信息（坐标系和投影类型）、服务标识信息（覆盖区域）、服务范围信息、服务提供者的基本信息等。对于没有元信息或没有解析出元信息的选项您可以手动添加，也可以手动修改已解析出来的元信息。完成后，点击“下一步“；

4. 设置服务的共享方式：

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

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

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

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

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

注意：

• 同一个登录用户不能重复注册相同服务地址的服务。
• iPortal 不支持解析 WFS2.0.0及以上版本、WCS1.1.1及以上版本的元数据信息。
• iPortal 解析出来的元数据信息中，坐标系信息出现 -1000 等异常值时，表示该服务的坐标系是用户自定义的。

使用iPortal中的服务资源

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

• 在数据上图 Web App中：选择底图后，可通过搜索将“我的服务”中的REST 地图服务和数据服务作为图层添加到底图上；若添加的是REST 数据服务，可基于此图层继续制作您需要的专题图。

• 在数据洞察 Web App中：可将REST 地图服务或 REST 数据服务添加进来，基于这些服务结合您的需求，可使用地图或图表进行可视化表达，也可在地图视图中，使用分析功能更深层次地发掘数据蕴藏的规律与价值。

• 在三维地球 Web App中：您可将REST 三维服务以图层的形式添加到场景中，基于此场景添加点线面要素，或在场景中量算、查询功能，或执行分析等。

• 在地图大屏 Web App中，支持将公开的数据、我的数据、iServer REST 服务等作为可视化组件的数据源，详见：添加可视化组件。

• 在您开发的Web GIS系统中调用iPortal中的服务资源，详见：使用 iCient JavaScript 访问 iPortal 中的资源。