国家中心对接省分中心接口规范

公共电子阅览室系统接口规范公共电子阅览室系统接口规范 国家中心跟省分中心接口规范国家中心跟省分中心接口规范 1.0 版版 i 目录目录 公共电子阅览室系统接口规范1 国家中心跟省分中心接口规范1 目录 i 一. 前言.1 二.引言.2 三适用范围3 四. 规范性引用文件.3 五. 术语和定义.4 5.1 组件 component.4 5.2 接口 interface.4 5.3 文档对象模型 Document Object Model.4 5.4 TCP/IP.4 5.5 公共电子阅览室.5 5.6 公共电子阅览室管理信息系统.5 5.7 国家中心.5 5.8 省级分中心.5 5.9 地市级支中心.5 5.10 WebService.6 5.11 WSDL.6 5.12 SSL6 5.13 编码表.6 5.14 黑名单.6 5.15 推荐名单.6 5.16 白名单.7 六 安全机制7 七接口明细示意图8 八接口列表10 8.1 国家中心提供的接口10 8.2 省分中心提供的接口15 九接口提供方式16 9.1 提供 WebService 接口.16 十接口详细描述16 10.1 接口使用到的数据结构.16 10.2 接口详细描述和定义.53 十一接口调用示例75 11.1 C#调用示例.75 11.2 JAVA 调用示例76 1 一一. 前言前言 为了规范全国公共电子阅览室信息的收集和统计，明确系统的数据交换要求，特制定 公共电子阅览室管理信息系统接口规范 （以下简称“本规范”） 。公共电子阅览室管理信 息系统的数据交换接口要求是能保证各级之间的数据能安全、开放、独立、并行地交换。 在本规范中描述了公共电子阅览室管理信息系统数据交换接口的数据格式规范、连接 规范。 2 二二.引言引言 本规范旨在为全国文化信息资源共享工程各级公共电子阅览室管理信息系统制定一个 统一的数据交换接口，达到平台无关，语言无关，便于与其它异构系统的集成和数据交换。 地级市对接 县分中心接 口，详细接 口列表见 地级市对 接县分中心 接口规范 文档中的“接 口列表”章节。 当阅览室存 在现有异构 系统时遵循 该规范。 国家中心站点国家中心站点 443 端口(https) 国家中心对接省分中心接口，详细接口列表 见本文档中的“接口列表”章节。 省分中心对接地级市接口，详细接口 列表见省分中心对接地级市接口规 范文档中的“接口列表”章节。当市 县站点存在现有异构系统时遵循该规 范。 省分中心对接公共电子阅 览室接口，详细接口列表 见省分中心对接公共电 子阅览室接口规范文档 中的“接口列表”章节。当 阅览室存在现有异构系统 时遵循该规范。 地级市对接公共电子阅览室 接口，详细接口列表见地 级市对接公共电子阅览室接 口规范文档中的“接口列表” 章节。当阅览室存在现有异 构系统时遵循该规范。 省分中心站点省分中心站点 443 端口(https) https 市级站点市级站点 443 端口(https) https 公共电子阅览室 443 端口(https) https 公共电子阅览室 443 端口(https) https 县级站点县级站点 443 端口(https) https 公共电子阅览室 443 端口(https) https 县分中心对接公共电子阅览 室接口，详细接口列表见 县级对接公共电子阅览室 接口规范文档中的“接口列 表”章节。当阅览室存在现有 异构系统时遵循该规范。 省分中心对接县分中心接口， 详细接口列表见省分中心 对接县分中心接口规范文 档中的“接口列表”章节。当 阅览室存在现有异构系统时 遵循该规范。 3 图中“443 端口 HTTPS”表示开发的服务端口，双向箭头线表示接口连接。 国家中心站点需开放基于 HTTPS WebService 的接口服务给省分中心站点连接，省分 中心站点也需开放基于 HTTPS WebService 的接口服务给国家中心站点连接，详细接口列 表请参见下一章“接口列表”，接口列表分两部分：国家中心提供的接口列表和省分中心提 供的接口列表。 “接口详细描述”章节分两部分：1.接口使用的数据结构，说明了接口用到的字段、数 据类型、字段说明等。2.接口的调用原型，说明了调用接口时传入的参数和返回的数据结 构。 三适用范围三适用范围 本规范适用于中国文化共享工程国家中心跟省分中心系统间的数据交换。 四四. 规范性引用文件规范性引用文件 下列规范所包含的条文，通过在本规范中引用而构成为本规范的条文。使用本规范时 应考虑使用其最新版本的可能性。 GB/T2260-2007 中华人民共和国行政区划代码 GB/11643-1999 公民身份证号码 GB/T2659-2000 世界各国和地区名称代码 GB/T 4658-2006 学历代码 GB/T4762-1984 政治面貌代码 GB/T3304-1991中国各民族名称罗马字母拼写法和代码 GB/T10114-2003 县以下行政区划代码编码规则 GB/23l2-1980 信息交换用汉字编码字符集 基本集 WH/T16-2002 互联网上网服务营业场所计算机经营管理信息系统技术规范 GB/T7408-2005 数据和交换格式 信息交换 日期和时间表示法 4 GC-FG120368 全国文化信息资源共享工程公共电子阅览室管理信息系统软件开发 及系统集成项目 项目技术方案接口及标准 公共电子阅览室终端计算机配置标准和公共电子阅览室管理信息系统功能规范 五五. 术语和定义术语和定义 下列术语和定义适用于本规范。 5.1 组件组件 component 可复用的软件组成成分，可被用来构造其他软件。它可以是被封装的对象类、类树、 一些功能模块、软件框架（或体系结构） 、文档、分析件、设计模式等。 5.2 接口接口 interface 对象所提供的一系列操作（方法）和属性。 5.3 文档对象模型文档对象模型 Document Object Model DOM，W3C 制定的 XML 应用程序接口中。它将 XML 文档表示成一个树形的结构。 DOM 规定了一系列编程指令，允许应用程序多次访问并操作文档树的组件。 5.4 TCP/IP TCP/IP 是用于互连各种网络的一组通信协议的总称，是一个开放式的协议集，遍布世 界范围的 Internet 网络主要采用的就是该协议，它主要包括 TCP、IP、ARP、RARP、UDP 和 SMTP 等协议。 5 5.5 公共电子阅览室公共电子阅览室 为了满足人民群众基本的网络文化需求，各级文化部门以公益性、基本性、均等性、 便利性为原则，依托文化共享工程各级服务点、图书馆、文化馆，以及具备条件的工人文 化宫、少年宫、妇女儿童活动中心、乡镇（街道）文化站、社区文化中心（村文化室） 、学 校、工业（产业）园区等，提供集互联网信息查询、文化共享工程信息资源服务、数字图 书馆服务、培训、网络通讯、休闲娱乐等功能为一体的公共数字文化服务场所。 5.6 公共电子阅览室管理信息系统公共电子阅览室管理信息系统 为了规范公共电子阅览室用户上机行为、管理和监控公共电子阅览室网络信息、掌握 公共电子阅览室运行服务状况，采用信息技术手段实现各级业务需求的信息化管理系统。 5.7 国家中心国家中心 是全国公共电子阅览室资源建设、技术支持、管理服务的中心，其职责由文化部全国 文化信息资源建设。 5.8 省级分中心省级分中心 是本省公共电子阅览室技术支持、资源建设及调度、管理服务、人员培训的中心，其 职责由文化共享工程省级分中心承担。 6 5.9 地市级支中心地市级支中心 是本市公共电子阅览室技术支持、资源建设及调度、管理服务、人员培训的中心，其 职责由文化共享工程地市级支中心承担。 5.10 WebService Web Services 是由企业发布的完成其特定商务需求的在线应用服务,其他公司或应用软 件能够通过 Internet 来访问并使用这项在线服务。 5.11 WSDL Web Services Description Language 的缩写，是一个用来描述 Web 服务和说明如何与 Web 服务通信的 XML 语言。为用户提供详细的接口说明书。 5.12 SSL 安全套接层（Secure Sockets Layer，SSL）为 Netscape 所研发，采用公开密钥技术，保 证两个应用间通信的保密性和可靠性，使客户与服务器应用之间的通信不被攻击者窃听。 可在服务器和客户机两端同时实现支持，目前已成为互联网上保密通讯的工业标准，现行 Web 浏览器亦普遍将 Http 和 SSL 相结合，从而实现安全通信。 5.13 编码表编码表 存储终端类型、电子阅览室类型等编码信息。 7 5.14 黑名单黑名单 指根据国家法律法规所禁止或不适宜在公共电子阅览室中访问的网站或应用列表。 5.15 推荐名单推荐名单 指在公共电子阅览室中推荐用户访问的网站或应用列表。 5.16 白名单白名单 指在公共电子阅览室中仅允许访问的网站或应用列表。 六六 安全机制安全机制 IP 访问限制安全机制：节点信息包含下级节点的 IP 地址，上级节点只接收指定 IP 地 址的数据连接。 SSL 安全套接层：WebService 接口服务部署在使用 SSL 安全机制的 IIS 服务器上，保 证了数据的安全传输。 8 七接口明细示意图七接口明细示意图 9 国国 家家 中中 心心 省省 分分 中中 心心 基基 本本 信信 息息 资资 源源 导导 航航 控制命令控制命令 服服 务务 统统 计计 站点登录(PubERoom_StaLogin) 节点信息(PubERoom_StationUpload) 电子阅览室信息(PubERoom_ERoomUpload) 工作管理人员信息(PubERoom_AdminUpload) 电子阅览室上机规则(PubERoom_UseRuleUpload) 电子阅览室设备信息(PubERoom_DeviceUpload) 网址访问记录(PubERoom_RCNaviRecUpload) 即时通讯记录(PubERoom_IMRecUpload) 上传站点档案(PubERoom_StaArchivesUpload) 意见表(PubERoom_CommentUpload) 使用统计记录(PubERoom_StaUploadUseStat) 上下机记录(PubERoom_StaUploadRec) 开关机记录(PubERoom_DevOpenUpload) 推荐网站访问统计(PubERoom_RCNaviStatUpload) 报警信息统计(PubERoom_WarnStatUpload) 资源信息下载(PubERoom_ParaDownload) 资源信息上传(PubERoom_UploadRCNavi) 安安 全全 管管 理理 黑白名单下载(PubERoom_ParaDownload) 上传黑白名单(PubERoom_UploadBWURL) 编码表编码表 编码表下载(PubERoom_ParaDownload) 截屏/控制(PubERoom_RemoteCtrlReq) 站点登录(PubERoom_StaLogin) 报警信息(PubERoom_WarningUpload) 上传终端实时信息(开机，关机，登录，退出信息） (PubERoom_DevStartUpload,PubERoom_DevEndUpload, PubERoom_DevLoginUpload,PubERoom_DevLogoutUpload) 开关机统计(PubERoom_OpenStatUpload) 抽查命令、申请结果下载(PubERoom_ParaDownload) 上传站点档案(PubERoom_StaArchivesUpload) 抽样调查计划状态 (PubERoom_SpotCheckUpload) 上传申请报告(PubERoom_RequestNotesUpload) 上传申请报告(PubERoom_UploadBWProgram) 上传即时通统计信息(IMStatUpload) 远程控制命令应答(PubERoom_RemoteCtrlRes) 10 八接口列表八接口列表 根据所需要的功能和数据项，总体同步频率时间针对各个下级节点的数据传递要求做到可以自定义配置（可以设置同步时间如 每周、每日或每月的什么时间或者同步周期比如间隔 5 秒、1800 秒等） ，接口列表列出如下： 8.1 国家中心提供的接口国家中心提供的接口 国家中心需开放接口，被省分中心调用进行数据的传输。 接口名称接口标识接口说明每条大小频率 站点登录PubERoom_StaLogin可供省分中心登录认证约 50byte 连接时的第一个请求 命令 下载编码表、黑 白名单、抽查等 信息 PubERoom_ParaDownload 用于国家中心到省分中心增量下发网址黑白 名单，应用黑白名单，电子阅览室类别表， 设备类别表，意见回复，资源导航服务器信 息，抽查计划列表，意见回复列表，上级服 务器列表,申请回复列表,资源栏目和导航资 源信息等数据 约 2KB 定时(无新数据时传输 量微小) 11 节点信息PubERoom_StationUpload 用于省分中心到国家中心增量上传各级节点 信息 约 1KB定时 电子阅览室信息PubERoom_ERoomUpload 用于省分中心到国家中心增量上传各级电子 阅览室信息 约 1KB定时 工作管理人员信 息 PubERoom_AdminUpload 用于省分中心到国家中心增量上传工作管理 人员信息 约 2KB定时 电子阅览室上机 规则 PubERoom_UseRuleUploa d 用于省分中心到国家中心增量上传电子阅览 室上机规则约 1KB定时 电子阅览室设备 信息 PubERoom_DeviceUpload 用于省分中心到国家中心增量上传电子阅览 室设备信息 约 1KB实时 上传终端开机信 息 PubERoom_DevStartUploa d 用于省分中心到国家中心增量上传电子阅览 室终端开机信息 50B 实时 上传终端关机信 息 PubERoom_DevEndUpload 用于省分中心到国家中心增量上传电子阅览 室终端关机信息 50B 实时 上传终端登录信 息 PubERoom_DevLoginUplo ad 用于省分中心到国家中心增量上传电子阅览 室终端登录信息 200B 实时 12 上传终端退出信 息 PubERoom_DevLogoutUpl oad 用于省分中心到国家中心增量上传电子阅览 室终端退出信息 50B 实时 上传使用记录PubERoom_StaUploadRec用于省分中心到国家中心发送使用记录 200B 定时 上传开关机记录 PubERoom_DevOpenUploa d 用于省分中心到国家中心发送开关机记录约 80B定时 上传报警信息 PubERoom_WarningUploa d 用于省分中心到国家中心报警信息上传约 1KB定时 上传即时通讯记 录 PubERoom_IMRecUpload用于省分中心到国家中心发送即时通讯记录约 1K抽查 上传网址访问记 录 PubERoom_RCNaviRecUp load 用于省分中心到国家中心发送网址访问记录约 1K抽查 上传意见信息 PubERoom_CommentUplo ad 用于省分中心到国家中心发送意见表约 1K定时 上传抽查执行结 果 PubERoom_SpotCheckUpl oad 用于省分中心到国家中心发送抽查执行结果约 50B实时 上传网址黑白名 单 PubERoom_UploadBWUR L 用于省分中心到国家中心增量上传网址黑白 名单 约 2KB定时 13 上传程序黑白名 单 PubERoom_UploadBWPro gram 用于省分中心到国家中心增量上传程序黑白 名单 约 2KB定时 上传资源信息PubERoom_UploadRCNavi用于省分中心到国家中心上传资源信息约 1KB24 小时，可配置 上传站点档案 PubERoom_StaArchivesUp load 用于省分中心到国家中心发送站点档案约 1K定时 上传申请报告 PubERoom_RequestNotesU pload 用于省分中心到国家中心发送申请报告约 1K实时 上传使用统计记 录 PubERoom_StaUploadUse Stat 用于省分中心到国家中心发送使用统计约 80B定时 上传开关机统计 PubERoom_OpenStatUploa d 用于省分中心到国家中心发送开关机统计约 80B定时 上传报警信息统 计 PubERoom_WarnStatUploa d 用于省分中心到国家中心发送报警信息统计约 80B定时 上传推荐网站访 问统计 PubERoom_RCNaviStatUp load 用于省分中心到国家中心发送推荐网站访问 统计 约 1K定时 上传即时通统计 信息 PubERoom_ IMStatUpload 用于省分中心到国家中心发送即时通统计统 计 约 1K定时 14 回应截屏/控制 等命令 PubERoom_RemoteCtrlRes 用于省分中心到国家中心回应国家中心的截 屏/控制等命令，可跨级路由数据 约 100B 如果是截屏需 在加上图像文 件大小。 实时 断开连接Release用于断开接口连接，释放网络连接资源无实时 15 8.2 省分中心提供的接口省分中心提供的接口 省分中心需开放接口，被国家中心调用进行数据的传输。 接口名称接口标识接口说明每条大小频率 站点登录PubERoom_StaLogin可供国家中心登录认证约 50byte 连接时的第一个请求 命令 截屏/控制等命 令 PubERoom_RemoteCtrlReq 用于国家中心到省分中心发送截屏/控制等命 令，可跨级路由数据 约 100B实时 断开连接Release用于断开接口连接，释放网络连接资源无实时 16 九接口提供方式九接口提供方式 9.1 提供提供 WebService 接口接口 在 Web 服务器上开放一个 WebService 接口供第三方调用。附件 PubERoom.wsdl 为 WebService 的 WSDL 文件。 十接口详细描述十接口详细描述 WebService 服务接口使用的是标准 HTTPS 端口 443（TCP）或 HTTP 端口 80。 10.1 接口使用到的数据结构接口使用到的数据结构 在下列表中字段类型分两种 uint、string，uint 表示数值整型，string 表示字符串型。 在“是否可以为空”一列中“否”表示不允许空值， “是”表示值是可选填的类型，可以为空。 按照公共电子阅览室管理信息系统编码规范终端编码、公共电子阅览室编码编码、 各级站点编码包含了上级编码信息，比如：终端编码为 3308020011001，33 为浙江省 省级站点编码，3308 为衢州市级站点编码，330802 为柯城区站点编码，3308020011 表示终端所在的公共阅览室编码。 10.1.1 STALOGINREQ 下级节点登录上级节点请求包 10.1.2 STALOGINRES 下级节点登录上级节点返回包 字段名称字段类型是否可以为空描述 szStaSNstring否节点编号，由 6 位字符组成(公共电 子阅览室管理信息系统编码规范) szVersionstring否版本号当前版本为“1.0.20121218” szKeystring否给配给各级节点登录的密钥(扩展功 能) 17 10.1.3 UPSTATION 各级节点信息结构 字段名称字段类型是否可以为空描述 szSessionIDstring否SessionID 会话 ID，连接序列号 szMemostring否备注 字段名称字段类型是否可以 为空 描述 szStaSNstring否节点编号，由 6 位字符组成 (公共电子阅览室管理信息系 统编码规范) szStaNamestring否节点名称 szIPstring否站点服务器外网 IP 地址 dwStaLeveluint否站点级别 如： 国家中心 省分中心 地市级支中心 县级支中心 具体参见编码表 dwTypeuint否节点类型编码,具体参见编码 表 szLocationstring否站点地址 szPostCodestring否邮政编码 szWebSitestring否网址 dwStatusuint否站点状态 0：未安装 1：离线 18 2：在线 0x100：部署中 0x200：试运行 0x400：正式运行 0x800：已撤销 0x1000：已合并 szAdminDivstring否所属行政区划编码 szAdminDivNam e string否行政区划名称 szUpperStastring否上级节点编号 dwCreateDateuint否创建日期 dwDelDateuint否删除日期 dwOpenTimeuint否上班时间，HHMM dwCloseTimeuint否下班时间，HHMM szCoordinatestring否地理坐标(经纬度)如 “123.12312 , 456.789“ szServerCfgUPDEVICECONFI G 否服务器配置表(包含了 UPDEVICECONFIG 结构的列 表，可以含多条记录) szDBCfgUPDEVICECONFI G 否存储配置表(包含了 UPDEVICECONFIG 结构的列 表，可以含多条记录) szNetCfgUPDEVICECONFI G 否网络配置表(包含了 UPDEVICECONFIG 结构的列 表，可以含多条记录) szSoftCfgUPDEVICECONFI G 否软件配置表(包含了 UPDEVICECONFIG 结构 的列 表，可以含多条记录) szAccessModesstring否接入方式的文字描述 19 10.1.4 UPDEVICECONFIG 节点服务器、存储、网络、软件配置表 dwBandwidthuint否网络带宽(单位为 M) dwTestBandwidt h uint否实测网络带宽(单位为 M) dwDelFlaguint否删除标志 0：表示未删除 1：表示已删除 szMemostring否备注 字段名称字段 类型 是否可以为空描述 dwDevTypeSNuint否设备类型编码 szBrandstring否品牌 szModelstring否型号 szSpecificationstring否设备规格 szPurposestring否用途说明 szIndicatorsstring否主要指标说明 dwPurchaseDateuint否采购日期 YYYYMMDD dwStartUseDateuint否投入使用日期 YYYYMMDD dwDevLifeuint否设备使用年限 szCPUstring否CPU 规格型号 dwMemSizeuint否内存大小（M） dwDiskSizeuint否硬盘大小(G) dwOsVeruint否操作系统版本(主版本*1000000 + 次 版本*10000 + 产品类型*100 +系统 类型(32 位或 64 位) ) WindowsXP 32 位：5010032 Windows7 64 位：6010064 20 10.1.5 UPEROOM 各级电子阅览室信息结构 szMemostring否备注 dwDelFlaguint否删除标志 0：表示未删除 1：表示已删除 字段名称字段 类型 是否可以为空描述 szERoomSNstring否电子阅览室编号，由 10 位字符组成 (公共电子阅览室管理信息系统编码 规范) szERoomNamestring否电子阅览室名称 szIPstring否电子阅览室服务器外网 IP 地址 dwStaLeveluint否站点级别 如： 国家中心 省分中心 地市级支中心 县级支中心 具体参见编码表 dwTypeuint否站点类型 文化共享工程各级服务点：1 图书馆：2 文化馆：3 以及具备条件的工人文化宫：4 少年宫：5 妇女儿童活动中心：6 乡镇（街道）文化站：7 21 社区文化中心（村文化室）：8 学校：9 工业（产业）园区：10 具体参见编码表 szLocationstring否阅览室地址 szPostCodestring否联系人邮政编码 szWebSitestring否网址 dwStatusuint否站点状态 0：未安装 1：离线 2：在线 0x100：部署中 0x200：试运行 0x400：正式运行 0x800：已撤销 0x1000：已合并 szAdminDivstring否所属行政区划编码 szAdminDivNam e string否行政区划名称 szUpperStastring否上级节点编号 dwCreateDateuint否创建日期 dwDelDateuint否删除日期 dwOpenTimeuint否上班时间，HHMM dwCloseTimeuint否下班时间，HHMM szCoordinatestring否地理坐标(经纬度)比如 “123.456,72.1234” szAccessModesstring否接入方式 dwBandwidthuint否网络带宽( M 为单位) 两种测法，算两种的平均值。 22 10.1.6 DOWNLOADREQ 下载上级节点的各种信息参数 1.平时在上传数据时按 数据量比个 耗时算出平均网络带宽。 2.在晚上空闲时段(比如 00:00 左右） ， 在固定时间(比如 10 分钟)内发测试 数据（比如站点或设备信息）测出 网络带宽。 dwTestBandwidt h uint否实测网络带宽 dwERoomTypeuint否阅览室类型编码(公共电子阅览室管 理信息系统编码规范) 举例如 01 文化共享工程公共电子阅览室 02 文化系统内其他公共电子阅览室 03 其他行业公共电子阅览室 dwRoomAreauint否房间面积(平米) szDescriptionstring否电子阅览室信息描述 dwDelFlaguint否删除标志 0：表示未删除 1：表示已删除 szMemostring否备注 字段名称字段 类型 是否可以为 空 描述 dwChgFlaguint否本地保存的修改更新标志，此内容 值是上次上级节点返回的值，第一 次调用时使用 0. 23 10.1.7 DOWNLOADINFO 下载上级节点的各种信息 10.1.8 BWURL 网址黑白名单 字段名称字段 类型 是否可以为 空 描述 dwChgFlaguint否本地保存的修改更新标志 字段名称字段 类型 是否可以为 空 描述 dwSNuint否名单编号 dwTypeuint否名单类别编码， （预留，当前赋 0 值） szURLstring否URL(支持通配符)，长度 64 字节。 szNamestring否网站名称 dwForAgesuint否适用年龄段(格式 FFTT,举例 0713 表 示 7-13 周岁) dwResourseTypeuint否资源类别编码(公共电子阅览室管理 信息系统编码规范) szOwnerNamestring否资源所属者名称 dwOwnerNationuint否资源所属国家(标准编码) szIPstring否IP 地址 dwEffectiveDateuint否生效日期 YYYYMMDD szFromStaSNstring否名单的来源（站点编号）比如来自 浙江，则是 330000 dwStatusuint否状态 无效: 0（表示这条网址在名单中无 效） 未审查: 1（表示该条网址并未经过 24 10.1.9 BWPROGRAM 应用黑白名单 审查） 已审查: 2（表示经过审查） 向上级节点推荐: 0x10000 推荐名单未上传: 0x20000 用于各节点向上级推荐名单，作为 审核是否通过的状态标志 szAdminNamestring否添加管理员 dwDelFlaguint否删除标志 0：不删除 1：删除 szMemostring否备注(比如禁止原因) 字段名称字段 类型 是否可以为 空 描述 szProductNamestring否产品名称 dwResourseTypeuint否资源类别编码 szAgentstring否代理商 dwOwnerNationuint否所属国家编码 dwForAgesuint否适用年龄段(格式为 FFTT,举例 0713 表示 7-13 周岁) szExeNamestring否Exe 文件名 szVersionstring否程序版本字符串 szCompanystring否公司名称 szFromStaSNstring否表示名单的来源（节点编号） ，站点 编码由 6 位字符组成，公共阅览室 由 10 位字符组成 dwStatusuint否状态 25 10.1.10 CODINGTABLE 类型编码信息表 无效: 0（表示这条应用在名单中无 效） 未审查: 1（表示该条应用并未经过 审查） 已审查: 2（表示经过审查） 向上级节点推荐: 0x10000 推荐名单未上传: 0x20000 用于各节点向上级推荐名单，作为 审核是否通过的状态标志 dwDelFlaguint否删除标志 0：不删除 1：删除 szMemostring否备注 字段名称字段 类型 是否可以为 空 描述 dwCodeTypeuint否编码类别 上机用户类型： 1 上机用户证件类型：2 公共电子阅览室类型：3 公共电子阅览室设备在线状态：4 远程控制类型：5 报警类别：6 资源类别：7 站点级别：8 站点类型：9 意见类型：10 26 编码方案 网站类型：12 资源栏目类型：13 民族编码:14 国籍编码:15 政治面貌编码:16 学历编码:17 专业编码:18 计算机能力:19 聘用形式:20 职称编码:21 工作性质编码:22 网址黑名单类别编码:23 其他：999 dwCodeuint否编码值 szCodeNamestring否编码名称 szMemostring否备注 dwDelFlaguint否删除标示， 0：表示未删除 1：表示已删除 类型描述 上机用户类型： 1 0 成年人 1 未成年人 用户证件类型： 2 01 身份证 02 军官证 03 警官证 04 士兵证 05 户口簿 06 护照 07 台胞证 08 回乡证 27 09 学生证 99 其他证件 公共电子阅览室类 型：3 01 文化共享工程公共电子阅览室 02 文化系统内其他公共电子阅览室 03 其他行业公共电子阅览室 公共电子阅览室设 备在线状态：4 0 在线 1 不在线 远程控制类型：5 01 截屏 截取终端屏幕显示内容 02 重启 重新启动终端 03 关机 关闭终端 04 发送消息 报警类别：601 黑名单网站 02 黑名单应用 03 同一时段有同一身份的顾客在不同的客户端 登录 99 其它 资源类别：701 网站 0101 白名单网站 0102 黑名单网站 02 应用 0201 白名单应用 0202 黑名单应用 03 视频 04 音频 05 电子读物 06 网络应用（即时消息及语音类、电子邮件） 99 其他 站点级别：8国家中心：1 省分中心：2 地市级支中心：4 28 县级支中心：6 乡镇（街道）：8 社区、村 : 10 站点类型：9文化共享工程各级服务点：1 图书馆：2 文化馆：3 以及具备条件的工人文化宫：4 少年宫：5 妇女儿童活动中心：6 乡镇（街道）文化站：7 社区文化中心（村文化室）：8 学校：9 工业（产业）园区：10 意见类型：10预留 设备终端类型:11普通 PC：1 苹果电脑：2 平板电脑：3 无盘工作站：4 桌面云：5 WIFI 移动设备：6 网站类型：12预留 资源栏目类型：13图书: 1 期刊:2 视频:4 文化活动:8 网址导航:0x10 民族编码:14 GB/T3304-1991中国各民族名称罗马字母拼写 法和代码 29 10.1.11 UPCOMMENT 意见信息 国籍编码:15GB/T2659-2000 世界各国和地区名称代码 政治面貌编码:16GB/T4762-1984 政治面貌代码 学历编码:17GB/T 4658-2006 学历代码 专业编码:18中华人民共和国学科分类与代码国家标准 GB/T 13745-2009 计算机能力:19计算机一级:1 计算机二级:2 计算机三级:3 计算机四级:4 聘用形式:20合同制:1 临时工:2 职称编码:21高级:1 中级:2 初级:3 工作性质编码:22专职:1 兼职:2 网址黑名单类别编 码:23 预留 其他：999 30 10.1.12 RCNAVICLASS 资源导航栏目 字段名称字段 类型 是否可以为 空 描述 szStaSNstring否节点编号，站点编码由 6 位字符组 成，公共阅览室由 10 位字符组成 dwSIDuint否流水号，站点内自增序列号 dwAdminIDuint否管理员 ID szAdminNamestring否管理员姓名 dwStatusuint否意见状态 1: 等待回复 2: 已回复 dwOccurDateuint否发生日期 YYYYMMDD dwOccurTimeuint否发生时间 HHMMSS dwTypeuint是意见类型(预留) szToStaSNstring否向哪个节点提的意见 szAdviceTitlestring否意见标题 szAdviceInfostring否意见信息内容 szMemostring否备注 字段名称字段 类型 是否可以为 空 描述 dwSNuint否导航栏目编号 dwRCTypeuint否栏目类别 遵循编码规范 szNamestring否名称 dwOrderuint否栏目顺序 szFromStaSNstring否来自哪个节点的编号 31 10.1.13 RCNAVIINFO 资源信息 dwForAgesuint否适用年龄段(格式为 FFTT，举例 0713 表示 7-13 周岁) 在此年龄段范 围内的栏目自动生效 dwStatusuint否状态 无效:0 未审查:1 已审查:2 向上级节点推荐:0x10000 推荐名单未上传:0x20000 szAdminNamestring否负责人姓名 dwDelFlaguint否删除标志 0：不删除 1：删除 szMemostring否备注 字段名称字段 类型 是否可以为 空 描述 dwClassSNuint否导航栏目编号 dwResourseTypeuint否资源分类，遵循编码规范 dwIDuint否资源编号 dwKinduint否资源分类 1：重点推荐 2：推荐 4：最新上架 szRCNamestring否资源名称 szURLstring否URL(支持通配符) szDispNamestring否显示名称 32 10.1.14 UPWARNINGREC 报警信息 dwOrderuint否显示顺序 dwForAgesuint否适用年龄段(格式为 FFTT，举例 0713 表示 7-13 周岁) dwValidLeveluint否有效级别，预留，缺省为 0 dwStatusuint否状态 无效:0 未审查:1 已审查:2 向上级节点推荐:0x10000 推荐名单未上传:0x20000 dwCreateDateuint否创建日期 YYYYMMDD dwCreateTimeuint否创建时间 HHMMSS szAuthorstring否作者 szPublisherstring否出版社 dwPublishDateuint否出版日期 YYYYMMDD szBriefIntrostring否简介 szPicURLstring否图片地址 szFromStaSNstring否来自哪个节点的编号 szOwnerNamestring否所属者 dwOwnerNationuint否所属国家编码 szIPstring否IP 地址 dwDelFlaguint否删除标志 0：不删除 1：删除 szMemostring否备注 字段名称字段是否可以为描述 33 类型空 szPCSNstring否机器编号，由 13 位字符组成(公共电 子阅览室管理信息系统编码规范) dwSIDuint否流水号，站点内自增序列号 szIDCardstring否证件号 szTrueNamestring否姓名 dwCreTypestring否 证件类别 01 身份证 02 军官证 03 警官证 04 士兵证 05 户口簿 06 护照 07 台胞证 08 回乡证 09 学生证 99 其他证件 szCerOfficestring否发证机关 dwIdentuint否 用户类型 0：未成年人 1：成年人 dwBirthDateuint否出生日期 YYYYMMDD dwAgeuint否年龄（周岁） dwSexuint否 性别 0 未知的性别 1 男 2 女 9 未说明的性别 dwOccurDateuint否发生日期 YYYYMMDD dwOccurTimeuint否发生时间 HHMMSS dwAlaTypeuint否 报警类别编码 01 黑名单网站 02 黑名单应用 03 同一时段有同一身份的顾客在不 同的客户端登录 99 其他 详细见编码表 34 10.1.15 UPSTAFF 工作管理人员信息 字段名称字段类 型 是否可以为空说明 szStaSNstring否站点编号(公共电子阅览室管理信息 系统编码规范) dwManRoleuint否工作人员角色 2048:表示普通工作人员 2304:表示节点负责人员 2560:表示节点联系人员 szIDCardstring否证件号 szTrueNamestring否真实姓名 dwBirthDateuint否出生日期 YYYYMMDD dwSexuint否性别 0 未知的性别 1 男 2 女 9 未说明的性别 dwMZuint否民族编码（GB/T3304-1991中国各 民族名称罗马字母拼写法和代码 ） dwNationalityuint否国籍编码（GB/T2659-2000 世界各 国和地区名称代码） dwPoliticalStateuint否政治面貌编码(GB/T4762-1984 政治 面貌代码) dwEducationuint否学历编码（GB/T 4658-2006 学历代 码 ） dwMajoruint否专业（中华人民共和国学科分类与 代码国家标准 GB/T 13745-2009 ） szTelstring否电话 szHandPhonestring否手机 szEmailstring否邮箱 szAddressstring否地址 szQQstring否QQ szPostCodestring否邮政编码 szDepartmentstring否所属部门 dwComputerCa pacity string否计算机能力编码，详见编码表 szPostionstring否岗位名称 szWarningKeystring否报警详细内容 szViolationstring否违规内容 szDealInfostring否处理结果 35 szDutystring否职务名称 dwJobTitlestring否职称编码，详见编码表 dwFormsOfEm ployment string否聘用形式编码，详见编码表 dwJobTypeuint否工作性质 专职: 1 兼职: 2 ，详见编码表 szPostCertificat e string是上岗证，没有上岗证值为空。 dwPostCertifica teDate uint是上岗证取得时间 YYYYMMDD，没 有上岗证值为空。 szPostTrainingstring是上岗培训，没有上岗培训值为空。 dwPostTraining Date uint是上岗培训时间 YYYYMMDD，没有 上岗培训值为空。 dwEnrollDateuint否入职时间 YYYYMMDD dwLeaveDateuint否离职时间 YYYYMMDD szMemostring否备注 dwDelFlaguint否删除标志 0：不删除 1：删除 10.1.16 UPUSERULE 电子阅览室上机规则 字段名称字段 类型 是否可以为 空 描述 szERoomSNstring否站点编号(公共电子阅览室管理信息 系统编码规范) dwRuleIDuint否规则编号 szNamestring否名称 dwIdentuint否用户类型 dwForAgesuint否适用年龄段(格式为 FFTT，举例： 0713 表示 7-13 周岁) dwMaxThisMinutesuint否次限时(分钟) dwMaxDailyMinutesuint否日限时(分钟) dwMinIntervaluint否上机时间最新间隔(分钟) 36 10.1.17 REMOTECTRLREQ 截屏或控制命令请求包结构 10.1.18 REMOTECTRLRES 截屏或控制命令应答包结构 dwHolidayFlaguint否节假日标志(1 表示节假日有效)，0 表示节假日无效。用于上机规则区 分节假日。 dwMaxUseTimesuint否每日上机次数 dwDelFlaguint否状态 0:不删除 1:删除 szMemostring否备注 字段名称字段 类型 是否可以为 空 描述 szToPCSNstring否目的地机器(终端)编号(公共电子阅 览室管理信息系统编码规范) szFromStaSNstring否发出请求站点编号(公共电子阅览室 管理信息系统编码规范) dwConTypeuint否 控制类型 01 截屏 02 重启 03 关机 0x1000 发消息 szConParamstring否控制参数， 在发消息命令时此字段用于填写消 息内容。 szSessionInfostring否上级节点对此控制命令设置的一个 标识。下级节点在应答控制命令时 要在参数里原样返回此字段。 szMemostring否备注 37 10.1.19 UPRCNAVIREC 网址访问记录 字段名称字段 类型 是否可以为 空 描述 szToStaSNstring否目的地站点编号（请求包里的 szFromStaSN 值）(公共电子阅览室 管理信息系统编码规范) dwResultuint否执行结果,0 表示成功，非 0 失败 szRetInfostring否返回信息，执行失败时说明信息 szSessionInfostring否返回请求服务器设置的会话信息 szImagestring是截屏图像,由于 WebService 是文本协 议，需要把图像文件使用 Base64 编 码后传入此字段。 szMemostring否备注 字段名称字段 类型 是否可以为 空 描述 szPCSNstring否终端编号(公共电子阅览室管理信息 系统编码规范) dwSIDuint否流水号，站点内自增序列号 szIDCardstring否证件号 szTrueNamestring否姓名