SL/T 798-2020
水利信息产品服务总则 1范围 本标准规定了水利信息产品服务的类型、注册参数、访问接口和注册流程。
本标准适用于水利信息产品服务的设计、开发和注册。
2规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本标准必不可少的条款。
其中，注日期的引用文 件，仅该日期对应的版本适用于本标准：不注日期的引用文件，其最新版本（包括的修改单）适 用于本标准 GB/T20258.3-2019基础地理信息要素数据字典第3部分：1：250001：500001： 100000 比例尺 GB/T20258.4-2019基础地理信息要素数据字典第4部分：112500001： 1000000比例尺 SL252-2017水利水电工程等级划分及洪水标准 SL473水利信息核心元数据 SL478水利信息数据库表结构及标识符编制规范 SL729水利空间要素数据字典 CH/Z9011-2011地理信息公共服务平台电子地图数据规范 3术语 下列术语和定义适用于本标准。
3.1 水利信息产品water information product 水事活动中利用相关数据加工提炼形成的，能够为其他水事或涉水活动再利用，描述某个或某类 对象特征的表格、图示和地图等数据成果。
3.2 产品服务productservice 可供业务应用调用的特定信息产品的在线或离线服务。
3.3 产品服务注册中心product service registration center 统一管理产品服务的环境，为各产品服务的注册、协议转换、路由、同步等提供基础支撑，将已 注册产品服务更新通知发送给产品服务消费者。
3. 4 产品服务注册product service registration 产品服务提供方将该产品服务元数据注册到产品服务注册中心的行为， 3.5 产品服务监控product service monitoring 产品服务注册中心对已注册产品服务的运行状态进行监视和运行进程进行控制的行为。
SL/T 798-2020
4水利信息产品服务 4.1产品服务分类 4.1.1水利信息产品服务应划分为通用信息产品服务和地理信息产品服务两类。
4.1.2通用信息产品服务应遵守SOAP、REST或流媒体产品服务协议标准。
4.1.3地理信息产品服务应分成地图产品服务和功能产品服务两类。
a）地图产品服务应遵守OGC标准，包括WMTS、WMS、WFS、WPS四类产品服务，对于 OGC标准不支持的多时相瓦片等产品服务，应遵循REST标准： b）功能产品服务应遵守SOAP协议标准。
4.2产品数据格式 4.2.1通用信息产品服务的数据格式应按结构化数据、半结构化和非结构化数据划分。
4.2.2地理信息产品服务的数据格式宜包括地图切片、TIF影像和空间要素SHP/E00文件。
4.3产品服务命名规则 4.3.1水利信息产品服务命名应符合以下要求： a）产品服务名称适合计算机和数据库技术的管理要求，产品提供者应按产品特征和要索内容， 编写中文名称和英文名称，名称中无空格： b）同一水事活动产生的产品服务，在命名上具有唯一性： 4.3.2通用信息产品服务命名应符合GB/T20258.3与GB/T20258.4的要求。
对于未列入其中的 内容可参照标准要求做出相应的补充规定，具体应遵循以下规则： a）产品服务中文名称包括产品服务内容描述，名称长度不超过60个汉字； b）产品服务英文名称包括产品服务内容描述，各单词首字母大写，名称长度不超过256个字母： c）产品服务内容描述中含有的标点符号等，采用半角符“”代替。
4.3.3地理信息产品服务命名除应满足通用信息产品服务命名规则外，各产品服务命名中要索描述 应符合SL.729的规定。
水利空间要素根据显示要求进行整合分级时，参照SI.252-2017的分级标准 与CH/Z9011-2011中的地图显示分级标准，在原名称上添加级别后缴。
示例： 为SLG_RV_1.在第2级才显示的河流，命名为SLG_RV_2.余类推。
5水利信息产品服务功能与接口 5.1一般规定 水利信息产品服务应通过产品服务接口提供权限检查、运行监控、日志记录等功能， 5.2产品服务功能 5.2.1权限检查 产品服务被调用时，应首先对产品服务调用者的访间权限进行检查，包括产品服务调用权限和产 品服务数据访问权限： 检查（是否已注册授权）； b）产品服务数据访问权限检查应根据授权规则检查产品服务涉及的数据类型和访间范围。
2
SL/T 798-2020
5.2.2运行监控 产品服务被调用运行过程中，应采取适当方式提供产品服务的运行状态，并接受对产品服务运行 进程进行控制的指令。
产品服务注册中心通过管理平台应能监视产品服务当前运行状态，并对产品服 务进行暂停运行、重启运行和停止运行等操作。
5.2.3日志记录 产品服务日志应记录产品服务运行的异常信息、状态信息、性能指标及操作日志。
产品服务日志记录内容应包括产品服务名称、产品服务类型、产品服务位置、产品服务状态、响 应时间、实施操作的用户、操作时间、IP地址、操作内容等。
日志级别及日志记录格式见附录A。
5.3产品服务接口 5.3.1权限检查接口 产品服务权限检查接口应符合表1的要求。
表1产品服务权限检查接口说明表 阶段参数是否必需述
srvInvkAdd是要访问的产品服务地址 Request targetID是产品服务的注册 ID
grantKey是产品服务授权码 responseCode是响应编码，包括：NORMAL（1）、ERROR（1）、 Response WARNING (1),INFO (2) info是具体信息
5.3.2注册信息查询接口 产品服务注册信息查询接口应符合表2的要求。
表2产品服务注册信息查询接口说明表 阶段参数是否必需描述
resName否资源的关键词 resTypeD否资源的类型ID（产品服务、数据、硬件、应用） Request reslD否资深ID
resDsteStart否资源的注册时间 gs资深的当前状态 resID是资源ID resName 是资源名称 Response resTypeID是资源类型ID
od.1,sa是资源类型名称 resDete是资源注册时间 resState是资渐状态
3
SL/T
表2产品服务注册信息查询接口说明表（续） 阶段数是否必需
resUseState是资测可用性状态 resWiunName是资源提供单位名称 Response resPersName是资测提供单位联系人名称 responseCode是响应编码.包括：NORMAL（1）、ERROR（1）、
WARNING (1), INFO (2) info是具体信息 5.3.3运行状态查询接口 产品服务运行状态查询接口应符合表3的要求。
表3产品服务运行状态查询接口说明表 阶段参数是否必需描述 Request reslD是资编码
resRunStst是资源运行状态：停止（0）、运行（1） responseCode是响应编码。
包括，NORMA1（1）、ERROR（1）、 Response WARNING (I), INFO (2) info是具体信息 5.3.4性能数据监控接口 产品服务性能数据监控接口应符合表4的要求，请求信息对象应符合表5的要求。
表4产品服务性能数据监控接口说明表 阶段参数是否必需述
serviceI是请求产品服务的注册 ID) Request timeStart否查询起始时间
timeEnd否查询终止时间标准 serviceName是产品服务注册名称 serviceI是产品服务注册 II serviceType是产品服务注册类型 gostAddres是与日志相关产品服务的宿主产品服务器地址（1P或
者城名） Response totalRequest是产品服务总请求量
normalRequest是产品服务的正常次数 responseTirse是产品服务平均响应时间 respomseMaxTime是产品服务最大响应时间 respomseMinTime是产品服务最小响应时间
SL/T 798-2020 表4产品服务性能数据监控接口说明表（续） 阶段参数是否必需述
requestInfoList是产品服务监控过程详情列表（嵌套对象，见表5re-
questInfoList对象表说明） Response responseCode是响应编码，包括：NORMAL（1）、ERROR（1）、
WARNING (1),INFO (2) info是具体信息
表5请求信息对象说明表 对象参数是否必需描述
startTime是产品服务请水开始时间 requestInfoList endTime 是产品服务请求结束时间
serviceStatus是产品服务状态，包括成功、异常
5.3.5运行状态监控接口 产品服务运行状态监控接口说明应符合表6的要求。
表6产品服务运行状态监控接口说明表 阶段参数是否必需描述
hostAddress是与日志相关产品服务的宿主产品服务器地址（IP或
者域名） Request
adosqoo否监控指标类里，为空查询全部指标包括：CPU（1）、
内存（2）、存储空网（3） host.Name是产品服务器注册名称 hostAddress是与日志相关产品服务的宿主产品服务器地址（IP或
者域名） cpuState是CPU信息 memoryState是内存信息 Response storeStste是硬盘存储信息
netStste是网络状杰信息 servicesList否产品服务器上部著的产品服务列表 responseCode是响应编码，包括：NORMA1.（1）、ERROR（1）、
WARNING (1)、INFO (2) info是具体信息
5.3.6日志访问接口 产品服务监控系统提供WebService的日志查询接口供被监控产品服务调用。
被监控产品服务应 按照规范要求的日志格式调用接口写人日志内容，供系统监控和分析，日志写人接口应符合表7的要 求，日志查询接口应符合表8的要求。
...
