DB51T3115-2023四川省政务服务评价数据汇聚规范.docx

ICS35.240CCSL 70DB51 四川省地方标准DB51/T 31152023四川省政务服务评价数据汇聚规范2023 - 10 - 11 发布2023 - 11 - 12 实施四川省市场监督管理局发 布目次前言II1 范围12 规范性引用文件13 术语和定义14 缩 略语15 总体架构26 汇聚要求37 数据安全保护要求5附录 A（规范性） 请求参数说明6附录 B（资料性） 接口请求示例10参考文献13前言本文件按照GB/T 1.12020标准化工作导则 第1部分：标准化文件的结构和起草规则的规定起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由四川省大数据中心提出、归口并解释。 本文件起草单位：四川省大数据中心、中国电信股份有限公司四川分公司、中通服创立信息科技有限责任公司、四川省标准化研究院。 本文件主要起草人：陈玲、赵启斌、唐为之、张军、周磊、张霞、解岩、苟斌、任墨海、刘陈、张文阳、匡先辉、覃子凌、王思航、鲍超、马宇飞、陈璟、姚刚、康友宏、乐益矣、文冠人、陈松柏、刘霖、黄康、陈涛、胥文娇、罗云、杨弋、姚晗、陈利、肖舒航、王孝文。 本文件为首次发布。 四川省政务服务评价数据汇聚规范1 范围本文件规定了四川省政务服务评价数据汇聚总体架构、汇聚要求、数据安全保护要求等内容。本文件适用于四川政务服务统一“好差评”平台对政务服务评价数据的汇聚。 2 规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件， 仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。 GB/T 37973-2019 信息安全技术 大数据安全管理指南 GB/T 39477 信息安全技术 政务信息共享 数据安全技术要求DB51/T 2943 四川省一体化政务服务平台系统接入规范 3 术语和定义下列术语和定义适用于本文件。 3.1政务服务 administrative service政府部门及其授权或委托的其他组织行使行政权力、履行公共服务职责过程中提供的服务。 来源：GB/T 397352020，3.1 注1：本文件所指的行政权力事项主要指依申请的行政许可、行政给付、行政裁决、行政确认、行政奖励和其他行政权力事项。 注2：本文件所指的公共服务事项包括但不限于教育、公共卫生和基本医疗、基本社会保障、公共就业服务等与企业发展、民生相关的事项。 3.2政务服务评价 evaluation of administrative service行政相对人对政务服务组织（包括但不限于政务服务中心、行政审批局、政务服务大厅、政务服务窗口、便民服务站点）提供服务的满意程度进行评价活动。 来源：GB/T 407622021，3.1，有修改 3.3评价事件 evaluation event可识别的政务服务评价内容，通过评价事件触发、推送和接收完成评价数据的生成和汇聚。 4 缩略语下列缩略语适用于本文件。 HTTP：超文本传输协议（Hyper Text Transfer Protocol） JSON：JavaScript对象标记（JavaScript Object Notation） UTF-8：Unicode的可变长度字符编码（8-bit Unicode Transformation Format） URL：统一资源定位符（Uniform Resource Locator） Web：全球广域网（World Wide Web） 5 总体架构5.1 概述四川政务服务统一“好差评”平台（简称：“好差评”平台）是以企业及群众办事体验为导向，依托四川省一体化政务服务平台建立的政务服务评价系统。“好差评”平台为各政务服务系统提供安全、便捷、可配置的政务服务评价功能及各类型的评价应用。各政务服务系统可通过接口、Web插件及评价URL等方式，实现 “好差评”平台评价服务的开箱即用。用户办理政务服务业务后，在评价页面上完成评价，评价数据汇聚至 “好差评”平台。数据汇聚总体架构见图1。 图1 总体架构图5.2 汇聚方式5.2.1 接口将政务服务评价能力封装成接口，开放给各业务系统调用。 5.2.2 Web 插件通过评价事项代码插入，在业务系统中嵌入评价页面。 5.2.3 评价 URL“好差评”平台提供评价页面访问URL生成规则，部门根据URL生成规则访问评价页面。 5.3 数据来源5.3.1 国家垂管业务系统国家政府部门统一建设部署，各级行业主管部门办理业务统一使用的系统。该系统可通过接口（数据汇聚接口）、Web插件、评价URL等方式，将评价数据汇聚至“好差评”平台。 5.3.2 省级统建业务系统省级政府部门统一建设部署，省级及以下各级行业主管部门办理业务统一使用的系统。该系统可通过接口（评价发起接口和评价事件接收接口）获取评价能力，也可通过Web插件、评价URL等方式，将评价数据汇聚至“好差评”平台。 5.3.3 非省级统建业务系统市（州）、区（县）政府部门建设使用的业务系统。该系统可通过Web插件、评价URL等方式，将评价数据汇聚至“好差评”平台。 5.4 评价方式各类业务系统向用户展示评价页面的方式，包括但不限于门户网站、移动客户端APP、二维码、评价仪、自助服务终端等。 6.1 通用要求6.1.1 “好差评”平台评价服务通讯采用 HTTP 协议方式提供，请求和响应的参数均采用 JSON 格式， 编码均为 UTF-8 格式。对接环境依托于电子政务外网。 6.1.2 “好差评”平台评价服务调用流程如下： a) 基础数据对接：各类业务系统申请接口调用，需进行基础数据对接，应按照 DB51/T 2943 接入要求对接统一部门基础信息、统一身份认证、统一事项对接、办件数据等内容； b) 评价服务申请：向四川省政务服务评价工作管理单位申请评价服务调用； c) 评价服务调用：服务申请审核通过后，获取接口调用地址，根据需求进行地址拼装； d) 评价数据汇聚：实时将评价数据汇聚至 “好差评”平台。 6.1.3 “好差评”平台评价服务调用流程见图 2。 6 汇聚要求图2 “好差评”平台服务调用流程图6.2 接口6.2.1 数据汇聚接口数据汇聚接口包括获取结构化测评接口、评价数据存储接口、评价数据修改接口。业务系统在提供评价数据前，先调用获取结构化测评接口，然后调用评价数据存储接口实现评价数据储存，如需修改数据调用评价数据修改接口。 接口请求参数详见附录A表A.1-表A.2，接口请求示例详见附录B表B.1-表B.3。 6.2.2 评价发起接口业务系统通过评价发起接口申请获取评价事件。 接口请求参数详见附录A表A.3。接口请求示例详见附录B表B.4。 6.2.3 评价事件接收接口业务系统通过评价事件接收接口接收 “好差评”平台推送的评价事件。接口请求参数详见附录A表A.4。接口请求示例详见附录B表B.5。 6.3 评价 URL6.3.1 通过唤起评价页面 URL，获取评价能力和信息。在评价页面 URL 上完成评价，生成评价数据汇聚至 “好差评”平台。 6.3.2 完整评价 URL 地址为 http:/ip:port/path?params。 6.3.3 固定评价 URL 根据办件数据是否实时推送，拼接网址分为以下两种情况： 办件编码 URL，http:/ip:port/path?affairCode=affairCode； 办件唯一标识传输 URL，http:/ip:port/path?uuid=uuid。 6.3.4 请求参数详见附录 A 表 A.5-表 A.6。 6.4 Web 插件各业务系统页面可通过安装Web插件实现评价数据生成和汇聚。Web插件安装流程见附录A图A.1。 7 数据安全保护要求数据安全要求应符合GB/T 37973-2019第8章和GB/T 39477的要求，并对数据汇聚过程进行有针对性保护，个人信息、敏感数据和重要数据应加强安全管控措施。 AA 附 录 A（规范性） 请求参数说明A.1 接口A.1.1 数据汇聚接口A.1.1.1 评价数据存储接口输入参数说明见表 A.1。表A.1 评价数据存储接口输入参数表参数代码 参数名称 参数类型 是否必填 注释说明 anonymous 是否匿名 String 是 areaCode 地区编码 String 否 12位行政区划代码 busiCode 评价对象业务编码 String 是 办件或者办事指南编码 evalCode 评价编码 String 否 peopleCode 评价人编码 String 是 个人身份证号码 法人社会统一信用代码 peopleName 评价人名称 String 是 peopleType 评价人身份类型 String 是 1：个人，2：法人 objId 评价对象id String 否 score 总满意度评分 String 是 instructions 评价内容说明 String 是 evalSource 评价来源 String 是 1：四川政务服务网,2：app, 3：厅局系统,4：运行平台,5：评价仪 evalChannel 评价渠道 String 是 1：四川政务服务网，2：app， 3：二维码，4：政务终端， 9：短信，5：其他终端， 6：热线，7：自动评价，8：评价仪 evalTime 评价时间 String 否 objCode 评价对象编码 String 是 code-001：办件评价， code-002：办事指南评价， code-003：一次一评 evalNum 评价次数 String 否 status 状态 String 否 0：草稿，10：审核， 20：监管， 21：无效评价，30：转部门整改， 31：整改完成，90：归档 checkTime 审核时间 String 否 replyContent 回复内容 String 否 replyId 回复人id String 否 replyName 回复人名称 String 否 publish 是否公开 String 是 0：否，1：是 A.1.2 评价发起接口评价发起接口输入参数说明见表A.3。 表A.3 评价发起接口输入参数表 A.1.3 评价事件接收接口评价事件接收接口输入参数说明见表A.4。 表 A.1 评价数据存储接口输入参数表（续）参数代码 参数名称 参数类型是否必填 注释说明 expands 拓展信息 Map 是 evaluationChildren 子项信息 List 否 objType 评价对象类型 String 是 0：全部，1：线上，2：线下 A.1.1.2 评价数据修改接口输入参数说明见表 A.2。表A.2 评价数据修改接口输入参数表参数代码 参数名称 参数类型 是否必填 注释说明 deprCode 部门code String 是 一体化的部门编码 id 评价主表id String 是 status 状态 String 是 0：草稿，10：审核， 20：监管，21：无效评价， 30：转部门整改，31：整改完成，90：归档 checkTime 审核时间 data 是 replyContent 回复内容 String 是 replyName 回复人名称 String 是 isAsse 是否纳入考核 String 是 0：否，1：是 isRect 是否整改 String 是 0：否，1：是 参数代码 参数名称 参数类型 是否必填 注释说明 uid 工作人员账号唯一标识 String 是 url 推送的url地址 String 是 通过评价地址，拼接对应的参数 areaCode 地区编号 String 是 12位行政区划代码 systemCode 系统编码 String 是 002：一体化，004：对接件，005：试点示范 shardKey 分片字段 String 是 表A.4 评价事件接收接口输入参数表参数代码 参数名称 参数类型 是否必填 注释说明 uid 评价的唯一标识符 String 是 为工作人员账号唯一标识 url 评价页面互联网地址 String 是 areaCode 地区编号 String 是 12位行政区划代码 idCard 身份证号码 String 是 zwwwUrl 政务外网地址 String 是 A.2 评价 URLA.2.1 评价URL请求参数说明见表A.5。 表A.5 办件编码二维码、评价仪URL 请求参数表参数代码 参数名称 参数类型 是否必填 注释说明 affairCode 办件编码 String 是 对接一体化平台办件后，一体化平台提供的办件编码 A.2.2 评价URL请求参数说明见表A.6。 A.3 Web 插件Web插件安装需要在评价页面上添加Javascript代码实现，具体操作步骤详见图A.1。 表A.6 办件唯一标识二维码、评价仪 URL 请求参数表参数代码 参数名称 参数类型 是否必填 注释说明 uuid 办件唯一标识 String 是 部门业务系统办件唯一标识 登录四川政务服务统一 好差评 平台（地址：http:/IP地址/hcp）新增网站填写注册信息粘贴代码至需添加插件的业务系统页面复制代码提供好差评页面嵌入位置Element ID赋值 获取办事指南评价代码a element ID 为单元标识符（element identifier）的缩写。 图A.1 Web 插件安装流程图BB 附 录 B（资料性） 接口请求示例B.1 数据汇聚接口B.1.1 获取结构化测评接口服务请求示例见表B.1 表B.1 获取结构化测评接口请求示例表接口地址 http:/IP:port/path 接口方式 HTTP 请求类型 POST 请求Header设置 Content-Type= application/json;charset=utf-8 请求Body格式（JSON格式） B.1.2 评价数据存储接口服务请求示例见表B.2。 表B.2 评价数据存储接口服务请求示例表接口地址 http:/IP:port/path 接口方式 HTTP 请求类型 POST 请求Header设置 Content-Type= application/json;charset=utf-8 请求Body格式（JSON格式） anonymous: 0, busiCode: 510000-20191024-000002, evalChannel: 1, evalSource: 1, instructions: 5, objCode: code-001, peopleCode: 511304*2616, peopleName: *, peopleType: 1, score: 5, objType:1, publish:1, evaluationChildren: childrenId: 509, childrenType: 1, score: 5 , B.1.3 评价数据修改接口服务请求示例见表B.3。 表B.3 评价数据修改接口服务请求示例表表 A.3 评价数据存储接口服务请求示例表（续） 请求Body格式（JSON格式）expands: contactName: *, appoveTimeLimit: 2, acceptTime: 2019-10-24 14:36:54, acceptDeptName: *厅/局, affairCode: 510000-20191024-000002, subcode: , endDateTime: 2019-10-24 14:36:54, ownerId: , contactIdCard: 513721*8397, affairName: （勿动）全程网办 20191024, eventCode: 511A0258000000-510000000000-000-008283-1-00, areaCode: 510000000000, performDeptCode: 00828313X, ownerName: sft_admin, areaName: 四川, busiStatus: 12, acceptDeptCode: 00828313X, eventName: （勿动）全程网办, applyDate: 2019-10-24 09:38:24, performDeptName: *厅/局 接口地址 http:/IP:port/path 接口方式 HTTP 请求类型 POST 请求Header设置 Content-Type= application/json;charset=utf-8 请求Body格式（JSON格式） deprCode: 11330000002482146U, id: 123456789, status: 90, isRect: 1 , checkTime: 2019-09-27 12:21:14 , replyContent: 确 认 , replyName: 管理员 , isAsse: 1 B.2 评价发起接口评价发起接口服务请求示例见表B.4。 表B.4 评价发起接口服务请求示例表接口地址 http:/IP:port/path 接口方式 HTTP 请求类型 POST 请求Header设置 Content-Type= application/json;charset=utf-8 请求Body格式（JSON格式） uid:1, url:, areaCode:510600000000, systemCode:3, shardKey:5100 B.3 评价事件接收接口评价事件接收接口服务请求示例见表B.5。 表B.5 评价事件接收接口服务请求示例表接口地址http:/IP:port/path 接口方式HTTP 请求类型POST 请求Body 格式（JS ON 格 式） uid: 1545, areaCode: 510600000000, idCard: 511215*655X, url: emCode=systemCode-002&shardKey=5113, zwwwUrl: http:/59.225.209.140:9000/appEval/index.html#/evalInstrument?affairCode=511300-20200717-010302&sy stemCode=systemCode-002&shardKey=5113 参 考 文 献1 GB/T 397352020 政务服务评价工作指南2 GB/T 407622021 政务服务满意度评价规范