标准规范方案
在标准规范制定方面,以《全军网络安全和信息化建设“十三五”规划》为基础,以各类军事信息化建设总体标准、系统工程标准、应用支撑标准、网络基础设施标准、信息安全标准以及管理标准为依据,针对空军军事人力资源大数据系统项目特色,补充建设空军军事人力资源工作数据元数据标准、空军军事人力资源工作数据分类及编码标准、空军军事人力资源工作数据质量管理标准、空军军事人力资源工作数据库设计标准、空军军事人力资源工作数据模型管理标准、空军军事、空军军事人力资源工作数据产品制作标准、空军军事人力资源工作数据访问服务接口标准以及空军军事人力资源工作数据推送技术接口规范等符合空军军事人力资源工作及数据平台建设的统一化标准规范。
0.0.1.1标准规范建设依据
标准类型 | 标准规范建设依据名称 |
总体标准 | 《全军网络安全和信息化建设“十三五”规划》(中央军委[2016]21号) |
《2018年全军战略规划工作安排》(军规[2018]9号) | |
《军队战略规划工作暂行规定》(军办发[2018]80号) | |
《全军网络信息体系融合工程项目立项计划》(军办发[2018]38号) | |
GB/T 1526-1989 信息处理 数据流程图、程序流程图、系统流程图、程序网络图和系统资源图的文件编制符号及约定 | |
GB/T 11457-2006 信息处理 软件工程术语 | |
GB/T 13502-1992 信息处理 程序构造及其表示的约定 | |
GB/T 14085-1993 信息处理 计算机系统配置力符号及约定 | |
GB/T 18234-2000 信息技术 CASE工具的评价与选择指南 | |
GB/T 18492-2001 信息技术 系统及软件完整性级别 | |
GB/T 18914-2002 信息技术 软件工程 CASE工具的采用指南 | |
GB/Z 19669-2005 XML在电子政务中的应用指南 | |
GB/T 19581-2004 信息技术会计核算软件数据接口 | |
GB/T 21064-2007电子政务系统总体设计要求 | |
GB/T 10112-1999 术语工作原则与方法 | |
系统工程标准 | 《全军信息系统强制标准规范集(1.0版)》(军装信[2017]19号) |
“810工程”确定的全军信息系统“资源、服务、应用”三层技术体系架构、核心技术体制和标准规范 | |
“509+工程”提出的总体技术标准、共性支持标准、办公通用标准、业务通用标准、管理保障标准、安全保密等标准规范 | |
应用支撑标准 | GB/T 18391.1-2002信息技术 数据元的规范与标准化 第1部分:数据元的规范与标准化框架 |
GB/T 18391.2-2003信息技术 数据元的规范与标准化 第2部分:数据元的分类 | |
GB/T 18391.3-2001信息技术 数据元的规范与标准化 第3部分:数据元的基本属性 | |
GB/T 18391.4-2001信息技术 数据元的规范与标准化 第4部分:数据定义的编写规则与指南 | |
GB/T 18391.5-2001信息技术 数据元的规范与标准化 第5部分:数据元的命名和标识原则 | |
GB/T 18391.6-2001信息技术 数据元的规范与标准化 第6部分:数据元的登记 | |
网络基础设施标准 | 《军队栅格化信息网入网用网通用要求》(参信[2015]90号); |
GB/T 12453-2008 信息处理 开放系统互连 运输服务定义 | |
GB/T 12500-2008 信息技术 开放系统互连 提供连接方式运输服务的协议 | |
GB/T 15126-2008 信息技术 开放系统互连 网络服务定义 | |
GB/T 16644-2008 信息技术 开放系统互连 公共管理信息服务 | |
GB/T 16645.1-2008信息技术 开放系统互连 公共管理信息协议 第1部分:规范 | |
GB/T 21061-2007 国家电子政务网络技术和运行管理规范 | |
YD/T 1148-2005 网络接入服务器技术要求-宽带网络接入服务器 | |
信息安全标准 | 《军队信息系统安全等级保护实施办法》(参发[2015]9号); |
《涉及国家秘密的信息系统分级保护管理办法》(国宝发[2005]16号) | |
《涉及国家秘密的信息系统分级保护技术要求》(BMB17-2006) | |
《涉及国家秘密的信息系统分级保护管理规范》(BMB20-2007) | |
《涉及国家秘密的信息系统分级保护测评指南》(BMB22-2007) | |
《涉及国家秘密的信息系统分级保护方案设计指南》(BMB23-2008) | |
GB/T 20274.1-2006信息安全技术 信息系统安全保障评估框架 第1部分:简介和一般模型 | |
GB/T 20274.2-2008信息安全技术 信息系统安全保障评估框架 第2部分:技术保障 | |
GB/T 20274.3-2008信息安全技术 信息系统安全保障评估框架 第3部分:管理保障 | |
GB/T 20274.4-2008信息安全技术 信息系统安全保障评估框架 第4部分:工程保障 | |
管理标准 | 《关于规范新体制下机要密码工作组织运行的通知》(军办发[2017]35号) |
GJB 9001B-2009 质量管理体系要求 | |
GJB 438B-2009 军用软件开发文档通用要求 | |
GJB 2786A-2009 军用软件开发通用要求 | |
GBT 11457-2006 信息技术软件工程术语 | |
GJB 439-1988 军用软件质量保证规范 | |
GJB 1091-1991 需求分析要求 | |
GJB 1268A-2004 军用软件验收要求 | |
GJB 2041-1994接口设计要求 | |
GJB 2115-1994 项目管理规程 | |
GJB 2255-1994 军用软件产品 | |
GJB 2434A-2004 军用软件产品评价 | |
GJB 2694-1996 军用软件支持环境 | |
GJB 3181-1998支持环境选用要求 | |
GJB 5234-2004军用软件研制和确认 | |
GJB 5235-2004 军用软件配置管理 | |
GJB 5236-2004 军用软件质量度量 | |
GJB 5852-2006装备研制风险分析要求 | |
GJB 5000A-2008 军用软件研制能力成熟度模型概述 | |
GJBZ 102-1997 软件可靠性和安全性设计准则 | |
GJBZ 115-1998 《武器系统软件开发》裁减指南 | |
GJBZ 141-2004 军用软件测试指南 | |
GJBZ 142-2004 军用软件安全分析指南 | |
SIS_203 验证和确认 | |
GBT1147-2006 信息技术 软件工程术语 | |
GJB 1267-1991 军用软件维护 | |
GJB 5716-2006 军用软件开发库、受控库和产品库通用要求 |
0.0.1.2制定方法及流程
标准规范建设是一项基础工作,需要根据项目建设的实际情况进行分步实施。标准规范建设的研究制定过程要经过体系规划、研究编制、宣传培训、实际应用、监督完善等阶段,每个阶段的工作都需要在统一的标准规范工作平台上完成。具体过程如下图所示:

图 21‑51 标准规范体系建设方法及流程
第一阶段:体系规划
空军人力资源工作数据标准规范主要在全军军事人力资源信息系统标准规范下,继承空军数据标准规范等内容,结合空军人力资源工作实际,规划空军人力资源工作数据需要遵循的标准规范、需要制定的标准规范。
第二阶段:研究编制
为安全、高效地采集、管理和运用空军人力资源工作数据,发挥人力资源工作数据的作用,研究制定九类人力资源工作数据标准规范,并进行标准规范之间的一致性协调。标准规范研究编制工作需在项目建设领导小组的统一领导下,由标准规范编制组进行相关标准的研究制定工作。项目建设领导小组由空军信息中心领导、各业务相关部门领导组成;标准规范编制组由空军人力资源部相关业务专家、行业专家以及我单位相关标准研究人员共同组成。
标准规范研究编制流程为:

图 21‑52 标准规范研究编制流程
序号 | 流程阶段 | 流程内容 |
工作方案制定 | 项目建设领导小组指导工作方案具体路线,标准规范编制组具体负责进行制定实施方案、进度计划设计,交由项目建设领导小组审核批准 | |
编制大纲起草 | 由标准规范编制组按照国家、军队、行业统一要求,初步编制各项标准规范的编制大纲,并由项目建设领导小组审核批准 | |
规范文件起草 | 由标准规范编制组依照编制大纲要求进行相关标准规范文件起草编制 | |
专家论证 | 聘请经验丰富的领域和技术专家,对规范草案进行深入沟通、多次论证,并给出修改意见 | |
修改完善 | 标准规范编制组根据专家意见,逐步完善 |
第三阶段:宣传培训
培训主要针对空军各层级的各个部门相关人员,经过标准相关内容和使用技巧的宣贯培训,确保标准使用人员能够更快捷的获取所需的标准,更准确的把握标准的使用程度。使得各项标准能够充分的应用。开展各项标准规范宣传培训。
第四阶段:实际应用
在空军各层级数据建设中应用标准规范,协助制定符合规范的技术方案,建设符合标准规范的服务应用系统。
第五阶段:监督完善
监督标准规范实施,并不断完善标准规范。根据数据实际发展建设过程的应用情况和技术发展情况不断完善标准规范,制定符合空军人力资源部应用的标准规范推广工作方案,在推广过程中建立标准规范落实的质量控制体系,保证标准规范的具体落实和不断改进。
0.0.1.3补充建设数据标准
人力资源工作数据标准规范建设如下所示:
表 21‑174 人力资源工作数据标准规范
序号 | 标准规范类别 | 包括内容 |
空军军事人力资源工作数据元数据标准 | 包括元数据描述方法、元数据框架、专用元数据选取与扩展、元数据规范及元数据扩展等。 | |
空军军事人力资源工作数据分类及编码标准 | 包括分类原则与方法、分类代码结构和编码方法等。 | |
空军军事人力资源工作数据质量管理标准 | 包括各类人力资源工作数据抽取、清洗、转换、整编等过程的质量管理审核。 | |
空军军事人力资源工作数据库设计标准 | 包括数据库表设计要求、命名要求、字段描述、数据类型设计、数据字典及数据版本控制等规范。 | |
空军军事人力资源工作数据模型管理标准 | 包括模型的结构、模型间关系、字段命名、引用的数据元和模型管理、使用等规范。 | |
空军军事人力资源工作数据产品制作标准 | 包括各类数据产品的内容、结构、约束以及需遵守的质量等。 | |
空军军事人力资源工作数据访问服务接口标准 | 包括数据服务方式、内容、范围,数据共享服务的接口协议、数据调用方法服务的安全性、可靠件、稳定性的规范。 | |
空军军事人力资源工作数据推送技术接口规范 | 包括对各类外部信息系统数据推送接口的相关技术。 |
0.0.1.4人力资源元数据标准
0.0.1.4.1范围
本规范规定了空军人力资源工作数据的元数据描述规范。
本规范适用于空军人力资源工作数据的元数据描述方法、元数据框架、专用元数据选取与扩展、元数据规范及元数据扩展等内容。
0.0.1.4.2规范性引用文件
下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件,仅所注日期的版本适用于本文件。凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。
GB/T 18391.1-2002信息技术 数据元的规范与标准化 第1部分:数据元的规范与标准化框架
GB/T 18391.2-2003信息技术 数据元的规范与标准化 第2部分:数据元的分类
GB/T 18391.3-2001信息技术 数据元的规范与标准化 第3部分:数据元的基本属性
GB/T 18391.4-2001信息技术 数据元的规范与标准化 第4部分:数据定义的编写规则与指南
GB/T 18391.5-2001信息技术 数据元的规范与标准化 第5部分:数据元的命名和标识原则
GB/T 18391.6-2001信息技术 数据元的规范与标准化 第6部分:数据元的登记
0.0.1.4.3术语和定义
下列术语和定义适用于本文件。
【元数据】定义和描述其他数据的数据。
[GB/T 18391.3-2009,定义3.2.18]
【属性】元数据的特征。
【必选】必须要求的。
【可选】允许但并非必要的。
0.0.1.4.4元数据规范与描述
空军人力资源工作数据元数据描述应该包括元数据标识符、中文名称、字段名称、字段说明、数据类型、数据格式、值域、密级、开放类型、共享类型、提供方式。
1.元数据描述
元数据按照名称、定义、约束、出现次数、数据类型进行描述。
表 21‑175 元数据描述
序号 | 类别 | 包括内容 |
名称 | 赋予元数据属性的标记,名称是唯一的 | |
定义 | 属性的描述,可使一种属性与其他属性清晰地区别开来。定义以字符串形式表示 | |
约束 | 显示一个属性是始终还是有时出现的描述符。该描述符可以有两个取值:必选或可选,前者表示该属性必须出现,后者表示该属性可以出现,也可以不出现 | |
出现次数 | 显示一个属性出现多少次的描述符。该描述符有以下四种情况:0:1(表示不出现或出现1次),0:n(表示不出现或出现n次),1:1(表示出现仅出现1次),1:n(表示出现1次或多次) | |
数据类型 | 描述属性的所有取值的类型。属性值的示例有:字符、数值、日期、时间、日期时间、二进制 | |
备注 | 属性有关的注释 |
2.字段中文名称
表 21‑176 字段中文名称
序号 | 类别 | 包括内容 |
定义 | 赋予元数据的单个或多个中文字词的指称 | |
约束 | 必选 | |
出现次数 | 1:1 | |
数据类型 | 字符串 | |
备注 | 元数据的中文名称 |
3.字段英文名称
表 21‑177 字段英文名称
序号 | 类别 | 包括内容 |
定义 | 在提供的数据中对应的字段名称 | |
约束 | 可选 | |
出现次数 | 1:1 | |
数据类型 | 字符串 | |
备注 | 需符合数据库设计规范中的字段命名规范 |
4.字段说明
表 21‑178 字段说明
序号 | 类别 | 包括内容 |
定义 | 对元数据进行简要说明 | |
约束 | 必选 | |
出现次数 | 1:1 | |
数据类型 | 数字 | |
备注 | 无 |
5.数据类型
表 21‑179 数据类型
序号 | 类别 | 包括内容 |
定义 | 表示元数据值的不同值的集合 | |
约束 | 可选 | |
出现次数 | 0:1 | |
数据类型 | 字符串 | |
备注 | 可能的实例,字符、数值、日期、时间、日期时间、二进制 |
6.元数据标识符
表 21‑180 元数据标识符
序号 | 类别 | 包括内容 |
定义 | 元数据唯一标识符 | |
约束 | 必选 | |
出现次数 | 1:1 | |
数据类型 | 数字 | |
备注 | 按照标识符编码结构对元数据进行编码 |
7.数据格式
定义:从应用的角度规定的元数据值的格式需求,包括所允许的最大或最小字符长度、元数据值的类型等;
约束:必选;
出现次数:0:1;
类型:字符串;
备注:数据格式的表示如下表所示:
表 21‑181 数据格式的表示
格式 | 示例 | 说明 |
c | c | 字符,应至少支持GB18030强制部分规定的字汇 |
c12 | 固定长度为12的字符串 | |
c..12 | 最大长度为12的字符串 | |
n | n | 数值型字符 |
n3 | 固定长度为3的数字字符 | |
n..3 | 最多为3位的数字字符 | |
n..9,n2 | 数值型,总长度最多位9位数字字符,小数点后保留2位数字 | |
an | an | 字母和数字字符 |
an3 | 笃定长度为3的字母数字字符 | |
an..3 | 最多为3位字母数字字符 | |
d | d8 | 日期型,按年月日顺序,格式位8位定长、全数字表示(YYYYMMDD) |
t | 时间型,按时分秒全数字表示,格式位6位定长(hhmmss) | |
dt | 日期时间型,按年月日时分秒顺序全数字表示,格式为14位定长、全数字表示(YYYYMMDDhhmmss) | |
b | b | 二进制类型,用来表示图形,图像,视频等非结构化数据 |
8.值域
表 21‑182 值域
序号 | 类别 | 包括内容 |
定义 | 元数据的取值范围 | |
约束 | 可选 | |
出现次数 | 0:1 | |
类型 | 字符串 | |
备注 | 无 |
9.密级
表 21‑183 密级
序号 | 类别 | 包括内容 |
定义 | 数据的密级 | |
约束 | 必选 | |
出现次数 | 1:1 | |
类型 | 字符 | |
备注 | 实例为内部,秘密,机密,绝密 |
10.共享类型
表 21‑184 共享类型
序号 | 类别 | 包括内容 |
定义 | 数据共享交换的类型 | |
约束 | 必选 | |
出现次数 | 1:1 | |
类型 | 字符 | |
备注 | 实例为“无条件共享”、“有条件共享”、“不予共享” |
11.开放类型
表 21‑185 开放类型
序号 | 类别 | 包括内容 |
定义 | 数据开放的类型 | |
约束 | 可选 | |
出现次数 | 0:1 | |
类型 | 字符 | |
备注 | 实例为“完全开放”、“依申请有条件开放”、“不予开放” |
12.提供部门
表 21‑186 提供部门
序号 | 类别 | 包括内容 |
定义 | 数据提供部门的中文名称全称 | |
约束 | 可选 | |
出现次数 | 1:1 | |
类型 | 字符 | |
备注 | 无 |
13.提供方式
表 21‑187 提供方式
序号 | 类别 | 包括内容 |
定义 | 数据提供的方式 | |
约束 | 可选 | |
出现次数 | 0:1 | |
类型 | 字符串 | |
备注 | 实例为“API获取”,“共享资源库”,“文件”,“网页链接” |
0.0.1.4.5元数据框架
1.元数据编码结构
元数据编码结构如下图所示:

图 21‑53 元数据编码结构
编码说明如下所述:
一级代码:由1位阿拉伯数字表示,1代表空军人力资源基本情况,2代表人力资源工作业务情况,3代表人力资源工作相关。
二级代码:在一级分类基础上,再划分子分类,如,基本情况基本大类下再划分人力资源工作、体制编制等核心元数据,用01标识人力资源工作核心元数据,02代表体制编制核心元数据。
三级代码:在二级分类基础上,在划分子分类,如,人力资源工作下的组织建设。
顺序码:用01,02等顺序表示元数据。
2.元数据目录
基于数据资源库设计,按照元数据编码规则对元数据进行编码,形成人力资源工作数据元数据目录。
0.0.1.4.6专用元数据选取与扩展
专用元数据是对一个或多个元数据基础标准扩展的集合,在适用的范围内,为完成一个特定的功能,需对基础标准的章、类选项和参数进行合理的取舍或增加。在满足用户需求的情况下,为维护专用元数据标准的一致性,对元数据标准的扩展要依据一定的原则。
扩展的元数据元素不应该改变现有元数据元素的名称、定义或数据类型;扩展的元数据可以定义为实体,可以包含扩展的和现有的元数据元素,作为其组成部分;允许对现有元数据元素施加比原标准要求更加严格的约束条件;允许对元数据元素的域施加比原标准更加严格的限制;允许对原标准认可的域值的使用加以限制;允许对代码表中值的数目进行扩展;不得扩展原标准不允许的内容。
0.0.1.4.7元数据扩展
在扩展元数据标准前,要对领域元数据标准进行全面分析,分析元数据实体/元素名称、定义、数据类型、约束条件、值域和最大出现次数等属性,满足要求则采用该现有元数据实体/元素,不满足需求的情况下,扩展元数据标准。
0.0.1.5人力资源数据分类及编码标准
0.0.1.5.1范围
本文档规定了空军人力资源工作数据分类及编码方法、编码结构、分类编码方法和分类代码等内容。
本文档适用于在空军人力资源工作数据建设与运维管理中,对数据进行分类,并用于分类信息的处理和交换,进行数据统计时的信息类型或者类别使用分类代码时需遵循本规范。
0.0.1.5.2规范性引用文件
下列文件中的条款通过本文档的引用而成为本部分的条款,凡是注日期的引用文件,其随后所有的修改单(不包括勘误的内容)或修订版均不适用于本文档。凡是不注日期的引用文件,其最新版本适用于本文档。
GB/T 7027-2002 《信息分类和编码的基本原则和方法》
GB/T 10113-2003 《分类与编码通用术语》
GJB/T 5402.1-2005 《军事信息资源分类法 第1部分:编制规则》
0.0.1.5.3分类原则及方法
唯一性:每一个编码对应仅对应有一个代码,一个代码只唯一表示一个编码对象。
可扩充性:留有适当的后备容量,以便适应不断扩充的需要。
简明性:代码结构尽量简单,长度尽量短,以便减少代码的差错率。
规范性:代码的类型,代码的结构以及代码的编写格式应当统一。
0.0.1.5.4数据分类编码结构
空军人力资源工作数据分类及编码结构如下图所示:

图 21‑54 人力资源工作数据分类及编码结构
0.0.1.5.5数据分类编码方法
参考“GB/T 5402.1-2005 《军事信息资源分类法 第1部分:编制规则》”、“GB/T 10113-2003 《分类与编码通用术语》”,采用线分类和层次编码法,将空军人力资源工作数据分类划分为基本大类、中类、小类和细类四级。
空军人力资源工作数据分为军队组织工作数据、军队干部工作数据、军队兵员工作数据、军队文职人员工作数据、军队保卫工作数据,依次用A、B、C、D、E顺次表示。
数据分类中的中类、小类、细类,根据需要设立带有“其他”字样的收容项。为了便于识别,原则上规定收容项的代码尾数为“9”。
字母后面每四位数字用“.”分隔。
0.0.1.6人力资源数据质量管理标准
0.0.1.6.1范围
本规范规定了空军人力资源工作数据抽取、清洗、转换、整编等过程的质量管理审核的规范。
本规范使用于空军人力资源工作数据在采集、治理、使用过程中的质量管理。
0.0.1.6.2术语和定义
下列术语和定义适用于本文件。
【数据质量】客观反映人力资源工作数据固有特性的程度。
【数据质量管理】对人力资源工作数据从数据抽取、清洗、转换、整编的全生命周期的每个阶段里可能引发的各类数据质量问题,进行识别、监控、预警、处理等一系列管理活动,并通过改善和提高管理水平使得数据质量获得进一步提高。
0.0.1.6.3数据质量管理内容
数据质量管理是运用相关技术来衡量、提高和确保数据质量的规划、实施与控制等一系列活动。
数据质量管理贯穿数据生命周期的全过程,覆盖人力资源工作数据(包括从指挥信息系统、人力资源信息系统、党员管理信息系统等相关系统引接及从空军人力资源工作部门采集数据)抽取、清洗、转换、整编等各个过程的质量管理审核。
数据质量管理内容包括:
制定、修订数据质量管理遵循的标准;
确立、修订数据质量管理工作流程、优化部门协同机制;
制定数据质量管理决策机制;
监督日常数据质量管理;
有序进行数据质量的核查。
0.0.1.6.4数据质量管理指标
通过开展数据质量管理工作,可以获得干净、结构清晰的数据,是后续人力资源部对数据应用、提供对外数据服务、发挥数据价值的必要前提。衡量数据质量的指标包括:
表 21‑188 衡量数据质量的指标
序号 | 指标 | 指标解释 |
完整性 | 数据是否缺失。数据是充分的,任何有关操作的数据都没有被遗漏。主要包括实体不缺失、属性不缺失、记录不缺失和字段值不缺失 | |
规范性 | 数据是否按照要求的规则存储 | |
一致性 | 数据的值是否存在信息含义上的冲突。描述数据结构、数据值和他们的相互关系符合逻辑规则的程度。如统一数据来源、统一存储和统一数据口径 | |
准确性 | 数据是否错误。数据必须真实准确的反映实际发生的业务,计量误差、度量单位等方面的精确度应符合业务需求 | |
唯一性 | 数据是否是重复的。数据值被约束成一组独特的条目,每个值都是唯一的。主要包括主键唯一和候选键唯一 | |
时效性 | 数据是否按照时间的要求进行上传 |
0.0.1.7人力资源数据库设计标准
能够构建人力资源工作数据库设计标准,该标准包括数据库表设计要求、命名要求、字段描述、数据类型设计、数据字典及数据版本控制等规范要求。
0.0.1.7.1范围
本文档规定了空军人力资源工作数据库设计标准,该标准包括数据库表设计要求、命名要求、字段描述、数据类型设计、数据字典及数据版本控制等内容。
本文档适用于指导空军人力资源工作数据库建设及运行过程中数据模型设计、数据库对象命名以及表、字段等数据库设计及版本管理。
0.0.1.7.2规范性引用文件
下列文件中的条款通过本文档的引用而成为本部分的条款,凡是注日期的引用文件,其随后所有的修改单(不包括勘误的内容)或修订版均不适用于本文档。凡是不注日期的引用文件,其最新版本适用于本文档。
GB/T 11457-2006 《信息技术 软件工程术语》
0.0.1.7.3术语和缩略语
1.术语
下列术语和定义适用于本文件。
表 21‑189 术语
序号 | 术语 |
【概念设计】用抽象观念表示现实世界的数据模型 | |
【数据库】为多个独立用户接收存储和提供所需数据的数据结构[GB/T 11457-2006 定义 2.390] | |
【表】数据元的有序集合[GB/T 5271.4-2000,定义04.08.01] | |
【主键】数据实体中一个或多个数据元的组合,其值可唯一标识一条记录。 | |
【视图】某一些模型的一种如下投影:从一定的透视或有利位置观看,且略去与此透视无关的实体。[GB/T 11457-2006 定义2.1833] | |
【外键】数据实体中,引入其他实体之间形成实体间关系的数据元 | |
【索引】(自然语言)字符串以及标示着其在文本或文本语料库中所处位置的标引与键值的列表[GB/T 17532-2005,定义 5.5] | |
【实体关系图】规定实际的实体集和它们之间的逻辑关系的图[GB/T 11457-2006 定义2.553] |
2.缩略语
E-R:实体关系图(Entity-Relationship Diagram)
UML:统一建模语言(Unified Modeling Language)
DBMS:数据库管理系统(Database Management System)
0.0.1.7.4总体要求
1.基本要求
数据库设计的描述应满足以下要求:
采用文字、表格、实体-关系图等形式进行数据库设计;
设计库设计必须遵循命名规范。
2.数据库范式要求
数据库要求达到第三范式的要求,根据实际情况,若达到第三范式确实有困难,不能低于第二范式。
表 21‑190 数据库范式
序号 | 类别 | 包括内容 |
第一范式 | 指在关系模型中,所有域都应该是原子性的,即数据库表的每一列都是不可分割的原子数据项,而不能是集合,数组,记录等非原子数据项,如果实体中的某个属性有多个值时,必须拆分为不同的属性 | |
第二范式 | 在第一范式的基础之上更进一层。第二范式需要确保数据库表中的每一列都和主键相关,而不能只与主键的某一部分相关(主要针对联合主键而言) | |
第三范式 | 在第二范式基础上,任何非主属性不依赖于其它非主属性 |
0.0.1.7.5数据类型设计
数据类型包括Text、Memo、Byte、Intege、Long、Single、Double、Currency等多种类型,数据类型及描述具体如下表所示:
表 21‑191 数据类型设计
数据类型 | 描述 | 存储 |
Text | 用于文本或文本与数字的组合。最多 255 个字符。 | |
Memo | Memo 用于更大数量的文本。最多存储65,536个字符。注释:无法对 memo 字段进行排序。不过它们是可搜索的。 | |
Byte | 允许 0 到 255 的数字。 | 1 字节 |
Integer | 允许介于-32,768 到 32,767 之间的数字。 | 2 字节 |
Long | 允许介于-2,147,483,648 与 2,147,483,647 之间的全部数字 | 4 字节 |
Single | 单精度浮点。处理大多数小数。 | 4 字节 |
Double | 双精度浮点。处理大多数小数。 | 8 字节 |
Currency | 用于货币。支持 15 位的元,外加 4 位小数。 提示:您可以选择使用哪个国家的货币。 | 8 字节 |
AutoNumber | AutoNumber 字段自动为每条记录分配数字,通常从 1 开始。 | 4 字节 |
Date/Time | 用于日期和时间 | 8 字节 |
Yes/No | 逻辑字段,可以显示为 Yes/No、True/False 或 On/Off。 | 1 比特 |
在代码中,使用常量 True 和 False(等价于 1 和 0) | ||
注释:Yes/No 字段中不允许 Null 值 | ||
Ole Object | 可以存储图片、音频、视频或其他 BLOBs(Binary Large OBjects) | 最多 1GB |
Hyperlink | 包含指向其他文件的链接,包括网页。 | |
Lookup Wizard | 允许你创建一个可从下列列表中进行选择的选项列表。 | 4 字节 |
0.0.1.7.6数据模型设计
1.概念设计
概念设计包括实体、实体关系,并进行必要的文字说明,实体-实体关系如下表所示的图元素进行表达。
表 21‑192 概念设计图元素
概念 | E-R图元素 | 说明 |
实体 | 实体常用于表示一个人、某件事物或某个事件等,实体用长方形框表示,实体的名称标识在框内。 | |
联系 | 联系标识一个或多个实体之间的关系,依赖于实体,用来表示实体之间一对一、一对多、多对多的关系,联系用一个菱形来表示,联系的名称一般为动词,联系的端点联系着橘色 | |
属性 | 属性为实体提供详细的描述信息,属性一般用椭圆形表示,并与描述的实体连接。 | |
标识符(键) | 属性名称加下划线表示可以唯一标识实体的一个键值。 |
2.逻辑设计
基本要求:逻辑设计用于描述信息的逻辑结构,采用实体-关系图、数据元-实体关系表、数据元取值影响说明表、复合属性代码表相结合的方式。
概念设计转化逻辑设计:将概念设计E-R图中的实体、实体属性和实体间的关联转换成数据表。
实体-关系图:在实体-关系中,应显示实体数据项的类型域,不显示实体数据项在具体数据库管理系统中的数据类型。
数据完整性:逻辑设计应达到实体完整性和引用完整性两个方面的要求。
3.物理设计要求
基本要求:物理设计应准确描述数据资源在具体的数据库管理系统中的物理结构,主要包括数据项名称、数据类型、数据长度、数据表定义、表间关系、主键、外键、完整性约束等,采用实体-关系图和实体数据项定义表相结合的方式描述。
实体关系图:实体关系图应包括所有的实体;实体中应包括所有数据项、标识出主键、外键;应准确描述实体与实体之间一对一、一对多、多对一和多对多等关联关系,以及数据完整性的约束;应显示实体中的数据项在具体数据库管理系统中的数据类型,不显示数据项的类型域。
实体数据项定义表:实体数据项定义应满足以下要求:数据库管理系统名称及版本:填写所采用的数据库管理系统名称,并填写具体版本号;序号:采用正整数,升序排列;
实体名称:应同与逻辑设计中数据元-实体关系表中对应的实体名称;
数据表名称:填写实体在数据库管理系统中对应的数据表名称;
数据元标识符:数据表中数据字段对应的数据元标识符;
数据元名称:填写数据元标识符对应的数据元名称或简称;
字段名称:填写数据项对应的数据表字段的名称;
数据类型:填写数据表字段的数据类型;
存储参数:填写字段的字符长度,或数值有效位数,精度;
备注:填写数据表字段需要说明的其他内容。
表 21‑193 实体数据项定义表
数据库管理系统名称及版本 | 定义说明 | |||||||
序号 | 实体名称 | 数据表名称 | 数据元标识符 | 数据元名称 | 字段名称 | 数据类型 | 存储参数 | 备注 |
0.0.1.7.7数据库分类与组织
1.数据库分类
按照数据库的功能、用途等特性,把一个系统或者一个项目所使用的数据库分为一到多个数据库,数据库再分为一到多个数据集,一个数据集再分为一到多个数据表。
2.数据库组织
数据库按照数据集、数据表的方式组织。
数据集:数据库中由内容完整一致性或相近或相互关系较紧密的一些列表组成。
数据表:数据的最小组织单位。

图 21‑55 数据库组织
0.0.1.7.8数据库对象命名规范
数据库命名:数据库命名由中文名称汉字的汉语拼音大写首字母组成。
数据集命名:数据集命名在数据库命名基础上,中间加下划线以及数据集汉语拼音大写首字母组成,数据集下可再分数据子集。数据集命名结构如下图所示:

图 21‑56 数据集命名规则
数据表命名:数据表命名在数据集命名基础上,中间加下划线以及数据表汉语拼音大写首字母组成。数据表命名规则如下图所示:

图 21‑57 数据表命名规则
字段命名:字段命名在数据表命名基础上,中间加下划线以及字段汉语拼音大写首字母组成。字段命名也可直接采用字段拼音首字母大写方式进行命名。字段命名规则如下图所示:

图 21‑58 字段命名规则
0.0.1.7.9数据库设计规范
数据库设计规范涵盖表设计规范、字段设计规范,具体如下表所示:
表 21‑194 数据库设计规范
序号 | 类别 | 包括内容 |
表设计规范 | 单表数据量三年内超过500万或容量超过2G,必须分区。表必须有中文注释。 | |
字段设计规范 | 1)每个表的字段数目不允许超过50个,同时,表中一条记录所有字段的长度不能超过数据库的db_block_size大小(缺省8K)。 2)字段必须定义合适的数据类型,以减少使用过程中的数据类型转换。例如:3)日期型禁止用varchar2,否则影响索引及排序效果。 4)不允许使用大对象类型字段(long,lob等),如果需要记录大数据,建议将5)数据保存到文件中,然后字段里记录文件的路径。 6)对于用户表示类型,状态,标志等意义的字段,需要在common中说明每个标志的含义,比如“业务类型:0无效1有效”,不允许把中文状态直接写到字段值中。 7)必须考虑给各字段加上适当的约束。 8)除非外键的父表没有或极少的delete,update操作,否则该外键必须建立索引。如未对外键建立索引,在对父表操作时,会对字表产生锁。 9)同一含义字段在不同的表中,必须使用相同的名字,类型,长度。 10)字段名不能与表名重复。 11)同一个字段名称在数据库中只能代表一个意思。 12)字段必须有中文注释。 | |
索引设计规范 | 1)为了提高查询效率,可以根据不同的数据特点,建立适当的索引,如B-TREE索引、位图索引、函数索引、降序索引、分区索引等。 2)表总数据量小于10000或者占用空间<2个block则不需要建索引。 3)创建索引需要选择查询频率高的SQL所涉及的表和字段建立索引。 4)需要选择数据区分度高的字段建立索引。 5)禁止为大数据类型创建索引,如果varchar2类型字段宽度超过200,不要建立索引。 6)组合索引字段的顺序,最常用的字段放在前面,同等常用的字段,再按区分度,区分度高的放在前面。 | |
视图设计规范 | 1)使用视图会增加数据库对视图的解析过程,会增加系统的开销,因此建议尽量少用视图。 2)创建视图时禁止使用“select * from 表名”语句,要求将用到的字段在视图语句中列明。 3)视图创建语句中禁止使用for update。 4)视图中禁止使用order by 子句,会影响到视图查询的效率。 5)视图名称宜使用大写英文字母。 6)经常使用的字段应放在视图中字段靠前位置。 7)避免使用嵌套视图,如果必须使用,本地嵌套视图不能超过1级。 | |
主外键设计规范 | 1)为关联字段创建外键。 2)所有的键都必须唯一。 3)尽可能避免使用复合键。 4)外键总是关联唯一的键字段。 5)尽可能使用系统生成(如序列SEQUENCE产生)的主键。 6)可选键有时可做主键。 7)一个表中组合主键的字段个数尽可能少。 | |
包设计规范 | 1)系统内通信或者系统间通信,尤其是大数据量复杂操作,建议使用package。所有的procedure或者function需要放在pkg中。 2)对于package中的procedure或者function,其大小不能超过3000行 3)系统间的package接口必须是一对一的,禁止一对多的情况出现。 4)提供给外关联系统调用的pkg不能有事务语句。 | |
触发器设计规范 | 1)由于触发器在后台运行,不易跟踪和监控,尽量少使用trigger。 2)对于Trigger中每个功能模块需要加上注释。 3)于Trigger中每个功能模块需要加上开关控制模块是否启用。 4)所有Trigger必须有错误控制,错误控制必须明确是异常位置。 |
0.0.1.7.10数据字典设计规范
数据字典是确保开发人员使用统一的数据定义,也是系统设计、系统实施与维护的重要依据。
数据字典是以数据库中数据基本单元为单位,按一定顺序排列,对其内容作详细说明。
数据字典对所有数据库结构进行描述。
数据字典定义应用程序中使用的所有数据元素和结构的含义、类型、数据大小、格式、度量单位、精度以及允许的取值范围。
0.0.1.7.11数据版本控制设计
数据版本控制的目标一是保留历史数据,二是有效的解决并发编辑操作。版本控制使用时,需要对数据库中的表新增一条版本号字段。
版本字段内数据的设计,采用两种方式,使用一条自增的数据或使用生效时间和失效时间。
0.0.1.8人力资源数据产品制作标准
能够构建人力资源工作数据产品制作标准,该标准包括各类数据产品(标准目录、转换工具等)的内容、结构、约束以及需遵守质量要求。
0.0.1.8.1范围
本文档规定了空军人力资源工作各类数据产品的内容、结构、约束以及需遵守的质量等内容。
本文档适用于空军人力资源工作数据产品的研制与生产,其他数据产品可参照本文档。
0.0.1.8.2术语和定义
下列术语和定义适用于本文件。
【数据产品】:数据产品是发挥数据价值辅助各级部门更优的做决策的一种产品形式。
0.0.1.8.3数据产品分类
空军人力资源工作数据产品类别可分为:数据服务类产品、数据分析类产品、数据检索类产品、数据挖掘类产品。
0.0.1.8.4数据覆盖范围
数据覆盖范围干部、兵员、文职人员、生长干部、预备役人员等基础人员信息、党团组织、法律战、舆论战、心理战、保卫、敌军和群众工作、宣传文化装备信息,兵力编组、调控计划、方案预案、文书、演训资料等。
0.0.1.8.5数据产品内容及结构
数据产品内容包括数据产品标识信息、数据产品内容、数据更新维护信息、数据产品更新频率、数据产品分发信息、数据产品密级共5部分内容,各类数据产品的具体内容如下表。
表 21‑195 各类数据产品内容
编号 | 数据产品结构 | 数据产品内容 |
数据产品标识信息 | 关于数据产品的创建信息 | |
1.1 | 数据产品名称 | 数据产品的名称 |
1.2 | 数据产品主题 | 数据产品的主题 |
1.3 | 数据产品简介 | 对数据产品的内容进行简短叙述性综述 |
1.4 | 数据产品目的 | 生成数据产品的用途的综述 |
1.5 | 版本 | 数据产品演化的版本信息 |
1.6 | 研制日期 | 数据产品制作研发的时间,精确到日期 |
1.7 | 责任方 | 数据产品的责任部门 |
1.8 | 语言 | 数据产品采用的语言 |
1.9 | 分发方式 | 数据产品分发给各部门的方式。分发方式包括订阅、下载、系统对接、介质 |
数据产品内容 | 关于数据产品的内容信息 | |
2.1 | 数据产品类别 | 数据产品的分类,分类包括数据服务类产品、数据分析类产品、数据检索类产品、数据挖掘类产品 |
2.2 | 数据覆盖范围 | 数据产品中数据覆盖范围,覆盖范围可以按级别、按业务进行划分 |
2.3 | 数据来源 | 数据产品来源的数据表 |
2.4 | 数据模型 | 数据产品采用的数据模型 |
2.5 | 统计提要指标 | 数据产品中展示的统计提要指标 |
2.6 | 数据展现方式 | 数据展现方式,包括可视化图形、图表 |
数据更新维护信息 | 关于数据产品中数据更新信息 | |
3.1 | 数据产品维护方 | 数据产品中数据维护单位 |
3.2 | 数据产品更新频率 | 数据产品更新频率 |
数据产品分发信息 | 关于数据产品分发给各部门的信息 | |
4.1 | 分发单位 | 数据产品分发的单位名称 |
4.2 | 分发方式 | 数据产品分发方式 |
4.3 | 分发版本 | 数据产品分发的版本 |
4.4 | 分发时间 | 数据产品分发开始时间 |
数据产品密级 | 关于数据产品的密级信息,按军队保密规定执行 |
数据产品约束:数据产品约束主要是用来确保数据产品的准确性和一致性。数据产品约束主要包括以下三类:数据源的准确性,对数据产品的数据源进行约束,包括数据范围、数据准确性;数据模型的精确性,数据产品精确性依赖于数据模型的训练精确性;统计提要指标的完整性,对业务中涉及的统计提要指标进行编制,保障统计提要指标的完整性。
0.0.1.9人力资源数据访问服务接口标准
0.0.1.9.1范围
本文档规定了空军人力资源工作数据访问服务接口的数据服务方式、内容、范围,数据共享服务的接口协议、数据调用方法服务的安全性、可靠件、稳定性等内容。
本文档适用于空军人力资源工作数据访问接口进行管理以及其他系统数据访问的调用。
0.0.1.9.2规范性引用文件
GB 18030-2005 信息技术 中文编码字符集
TR-REC-014 核心元数据标准
TR-REC-014 资源唯一标识符规范
0.0.1.9.3数据服务方式
基于可编程的应用程序Web Service方式提供。
应用之间通过Web Service进行集成,其中工作角色主要有服务提供者、服务消费者,如下图所示:

图 21‑59 数据接口交互过程
业务应用服务提供者负责开发、定义接口服务,并以Web Service形式发布,第三方业务应用服务消费者通过客户端调用服务提供者提供的服务,并通过服务提供者来执行服务。
0.0.1.9.4接口内容及范围
访问服务接口内容及接口描述如下表。
表 21‑196 访问服务接口内容及接口描述
序号 | 访问服务接口名称 | 访问服务接口描述 |
军队干部综合信息管理系统接口 | 从军队干部综合信息管理系统引接人力资源基础数据。 | |
兵员信息管理接口 | 从兵员信息管理系统引接人力资源基础数据。 | |
文职人员综合信息管理系统接口 | 从文职人员综合信息管理系统引接人力资源基础数据。 | |
军队党员管理信息系统接口 | 从军队党员管理信息系统引接人力资源基础数据。 | |
作战指挥信息系统接口 | 从作战指挥信息系统引接人力资源基础数据。 |
0.0.1.9.5数据共享服务接口协议
数据共享服务的接口协议采用HTTP1.1传输协议。
HTTP是一个客户端和服务器端请求和应答的标准(TCP)。客户端是终端用户,服务器端是网站。
0.0.1.9.6数据调用方法
1.数据调用方式
数据调用方式包括POST方法与GET方法。
POST方法:POST方法是必须实现的,被用于请求源服务器接受请求中的实体作为请求资源的一个新的从属物。
GET方法:GET方法为可选方式,是获取被请求URI(Request-URI)指定的信息(以实体的格式)。
2.数据调用安全
采用基于IP地址的身份验证方式。在服务调用的过程中,服务提供者获取调用者的IP地址,在本地保存的授权访问IP地址列表中查询,认证通过执行服务返回数据,不通过则拒绝服务。
0.0.1.9.7数据交换格式
1.XML数据格式交换要求
数据交换包由数据包头和数据包体两部分组成。
数据包头:由数据包标识、发送方标识、接收方标识、数据包生成日期及时间等属性组成。
数据包体:主要由若干数据项组成。
数据交换包组成见下图所示:

图 21‑60 数据交换包组成表 21‑197 数据交换包组成元素及属性
序号 | XML标签名 | 说明 | 约束 | 出现次数 | 数据格式 | 数据类型 |
DataPacketHeader 数据包头 | 标识数据包头的开始 | M | 1..1 | |||
DataPacketID 数据包标识 | 标识数据包基本信息的节点 | M | 1..1 | |||
NameOfDataPacketlD 标识名称 | 数据包的标识的名称 | M | 1..1 | an..70 | String | |
DataPacketVersion标识版本号 | 数据包标识的版本号信息 | O | 0..1 | an..9 | string | |
ControllingAgency 标识控制机构 | 给出该数据包标识的控制机构的名称或代码 | O | 0..1 | an..70 | string | |
DataPacketFunction 数据包功能 | 给出数据包的功能,例如请求、广播、应答及确认等 | M | 1..1 | an..35 | string | |
DataPacketRefID 数据包参考号 | 该数据包的唯一参考号 | M | 1..1 | an..35 | string | |
SenderlD 发送方标识 | 数据包发送方的唯一标识,由网络服务提供商分配 | M | 1..1 | an..70 | string | |
RecipientID 接收方标识 | 数据包接收方的唯一标识,由网络服务提供商分配 | M | 1..n | an..70 | string | |
DataPacketGenDate 数据包生成日期 | 该数据包生成的日期 | M | 1..1 | YYYY-MM-DD | date | |
DataPacketGenTirne 数据包生成时间 | 该数据包生成的时间 | M | 1..1 | hh:mm:ss | dateTime | |
DataEncID 数据加密标识 | 该数据包中数据是否有被加密 | O | 0..1 | true/false | boolean | |
DataEncMethod 数据加密方法 | 加密方法的名称 | O | 0..1 | an..16 | string | |
EncDataDesc 加密数据描述 | 该数据包中被加密数据的简要描述 | O | 0..1 | an..100 | string | |
ComDatalD 数据压缩标识 | 该数据包中数据是否有被压缩 | O | 0..1 | true/false | boolean | |
ConiDataMethod 数据压缩方法 | 数据压缩方法的名称 | O | 0..1 | an..16 | string | |
ComDataDesc 压缩数据描述 | 该数据包中被压缩的数据的简要描述 | O | 0..1 | an.,100 | string | |
ExProtocolVersionNum交换协议版本号 | 数据交换双方采用的标准协议版本编号 | M | 1..1 | an..70 | string | |
MessageSequeNum 数据包序列号 | 发送包的顺序序列号 | M | 1..1 | an..70 | string | |
DataPacketsAmount 数据包总数量 | 数据交换包的数量 | M | 1..1 | nl..9 | int | |
DataPacketBody 数据包体 | 数据包中涉及业务系统之间需要交换的数据的部分 | M | 1..1 | |||
Dataltem 数据项 | 标识每一条需要交换的数据 | M | 1..n |
2.JSON数据格式交换要求
JSON两种标识结构,对象和数组。
(1)对象
对象结构以“{”大括号开始,以“}”大括号结束,中间部分由0或多个以“,”分隔的“key(关键字)/value(值)”对构成,关键字和值之间以“:”分隔。
采用的语法结构如下所示。
{
Key1:value1,Key2:value2
…
}
(2)数组
数组结构以“[”开始,以“]”结束,中间部分由0或多个以“,”分隔的值列表组成,采用的语法结构如下所示。
[
{
Key1:value1,Key2:value2
},{
Key3:value3,Key4:value4
…
}
]
0.0.1.10人力资源数据推送技术接口标准
0.0.1.10.1范围
本文档规定了空军人力资源工作数据推送技术接口的技术要求。
本文档适用于空军人力资源工作数据推送数据到其他系统,以实现数据共享共用。
0.0.1.10.2术语和缩略语
1.术语
【推送服务器】推送服务器接收并处理从应用开发者发起的请求消息,向各目标系统发送推送内容。
2.缩略语
【UPS】Unified Push Service
【API】Application Program Interface
【SDK】Software Development Kit
0.0.1.10.3数据推送内容及描述
空军人力资源工作数据推送技术接口内容描述如下表。
表 21‑198 推送内容描述
序号 | 推送技术接口名称 | 推送内容描述 |
老版干部综合信息管理系统数据推送接口 | 各级将本单位人力资源基础数据导入老版干部综合信息管理系统中。 | |
兵员管理系统数据推送接口 | 各级将本单位人力资源基础数据导入兵员管理系统中。 | |
文职人员管理系统数据推送接口 | 各级将本单位人力资源基础数据导入文职人员管理系统中。 | |
老干部数据推送接口 | 各级将本单位人力资源基础数据导入老干部管理系统中。 | |
数据融合应用工程数据推送接口 | 提供战时政工资源编组方案、调控补充计划、应急补充方案等数据。 | |
指挥信息系统接口 | 依托指挥专网提供人力资源编组方案、调控补充计划、应急补充方案等数据。 |
0.0.1.10.4统一推送通道层接口
1.技术架构
本规范的技术原则为:
减轻SDK,尽可能只定义接口,将实现隐藏到服务侧;
屏蔽不同厂商(包括第三方推送)的底层技术差异;
基本行为一致性,保证不同的系统上有相同的基本行为,降低不必要的维护成本。
技术架构如下图所示:

图 21‑61 统一推送技术框架
2.标准技术接口
标准技术接口分为两部分:
L1接口:连接应用服务器和UPS服务器。主要用于应用进行推送请求的鉴权、提交推送请求。
L2接口:让应用系统业务部分可以通过UPS SDK/第三方接口层来使用推送模块,最终连接到推送服务系统,完成使用推送所需要的基础工作。
3.基础功能
(1)UPS服务器API功能
采用HTTPS或者socket形式的接口,支持HTTP2.0,避免大量推送时造成连接数压力,提高推送效率和稳定性。
支持指定单个Registration_token或一组Registration_token列表进行消息推送。
(2)UPS 服务功能
UPS SDK 提供初始化接口,传入所需的应用信息,实现设备注册,并返回Registration_token给各类应用,用于后续进行消息推送;
UPS服务可以独立完成通知消息展示
UPS SDK可以打开,关闭和注销推送通道的功能。
UPS SDK提供查询当前Registration_token的接口。
4.UPS服务器API接口(L1)
(1)基本功能接口
表 21‑199 基本功能接口
接口编号 | 接口描述 | 备注 |
L1 | App 服务端和推送服务端之间的 API 接口集 | |
L1/Auth | 推送鉴权 | 操作接口 |
L1/Send | 推送 | 操作接口 |
(2)推送鉴权(L1/Auth)
用于应用推送用户身份鉴定,通过后可获得auth_token用于后续请求身份校验。该auth_token具有一定的时效性,以保证安全性。
表 21‑200 本接口定义请求参数
属性 | 类型 | 是否必传 | 说明 |
grant_type | string | 是 | |
appKey | string | 是 | 用户申请推送业务时生成的AppID |
timestamp | string | 是 | 时间戳 |
appSecret | string | 是 | 用户申请推送业务时获得对应ID的秘钥 |
表 21‑201 响应数据
属性 | 类型 | 说明 |
result | string | 鉴权结果 |
desc | string | 结果描述 |
auth_tokens | string | 当鉴权成功时才会有该字段,权限令牌推送消息时,需要提供auth_tokens |
expires_in | int | registration_tokens 的有效期,以秒为单位 |
(3)信息推送(L1/ Send)
对应用系统中单个用户,单独推送消息。消息总长度不超过4K字节。
表 21‑202 请求数据
属性 | 类型 | 是否必传 | 说明 |
registration_tokens | String | 是 | 多个registration_token列表,建议最大值不超过1000 |
title | string | 是 | 通知标题(不超过128字节) |
content | string | 是 | 通知内容(不超过256字节) |
timeToLive | int | 否 | 消息保留时长(单位:秒,最长不超过14天) |
notificationChannel | String | 否 | 通知通道的特性(不超过64字节) |
originalSourceName | String | 是 | 推送消息的来源,品牌名称(英文或拼音)(不超过128字节) |
originalSourceIP | String | 是 | 如果消息由第三方代发,消息中要挟带消息原始来源的ip地址 |
表 21‑203 响应数据
属性 | 类型 | 说明 |
result | int | 推送结果 |
desc | string | 结果描述 |
messageId | string | 任务编号 |
表 21‑204 响应结果
result | 描述 |
系统未知 | |
0 | 成功 |
无效的app_key | |
无效的app_secret | |
>100 | 厂商预留错误码 |
5.接收端接口(L2)
(1)基本功能接口
表 21‑205 基本功能接口
接口编号 | 接口描述 | 备注 |
L2 | 类名:UPSService | |
L2/registerToken | 注册push服务,为设备申请Token作为唯一标识 | 操作接口 |
L2/onReceiveToken | 获得Token的回调接口 | 回调接口 |
L2/turnOnPush | 开启推送 | 操作接口 |
L2/turnOffPush | 关闭推送 | 操作接口 |
L2/onCommandResult | turnOn、turnOff接口回调结果 | 回调接口 |
L2/ UnRegister | 反注册 | 操作接口 |
L2/onUnRegister | 反注册的回调接口 | 回调接口 |
L2/getRegistrationToken | 获取RegistrationToken | 操作接口 |
L2/onReceiveRegistrationToken | 获得RegistrationToken的回调接口 | 回调接口 |
(2)注册服务
public void registerToken(Context context, String appID)
参数:
字段 | 说明 |
context | 应用的 Application Context |
appID | 创建应用时生成的唯一标识 |
返回:无
说明:注册UPS服务,获取设备上应用的registration_token,作为后续的消息推送目标,结果异步回调返回,建议在应用启动的时候调用。
(3)注册服务的回调
public void onReceiveToken(Context context, String registration_token)
参数:
字段 | 类型 | 说明 |
context | Context | 应用的 Application Context |
Registration_token | String | 返回给应用的UPS RegistrationToken,作为后续的消息推送目标 |
返回:无
说明:当UPS SDK注册成功后,通过该回调接口获取registration_token。
(4)开启推送服务
public void turnOnPush(Context context)
参数:
字段 | 类型 | 说明 |
context | Context | 应用的 Application Context |
返回:无
说明:开启Push推送,关闭状态则收不到推送。
(5)关闭推送服务
public void turnOffPush(Context context)
参数:
字段 | 类型 | 说明 |
context | Context | 应用的 Application Context |
返回:无
说明:关闭Push推送,关闭后则无法收到推送消息。
(6)开启/关闭推送的回调接口
public void onCommandResult(Context context, Bundle extras)
参数:
字段 | 类型 | 说明 |
context | Context | 应用的 Application Context |
extras | Bundle | 返回接口调用结果,可扩展 |
String | 1.“command" 调用turnOn接口,返回"ups.turnOn"调用turnOff接口,返回"ups.turnOff" | |
String | 2."resultCode" 接口调用结果,如果成功,返回ErrorCode.Sussess即0;否则返回错误类型值。 | |
String | 3.“reason” 表示调用命令失败的原因。如果失败,则返回失败原因,否则返回为null。 |
返回:无
说明:返回Push关闭的结。
(7)反注册服务
public void unRegister(Context context)
参数:
字段 | 类型 | 说明 |
context | Context | 应用的 Application Context |
返回:无
说明:进行反注册。
(8)反注册的回调接口
public void onUnRegister(Context context)
参数:
字段 | 类型 | 说明 |
context | Context | 应用的 Application Context |
返回:无
说明:返回反注册的结果。
(9)获取RegistrationToken
public void getRegistrationToken(Context context)
参数:
字段 | 类型 | 说明 |
context | Context | 应用的 Application Context |
返回:无
说明:获取设备上应用的token,作为后续的消息推送目标,结果异步回调返回。
(10)RegistrationToken回调接口
public void onReceiveRegistrationToken(Context context, String registration_token)
参数:
字段 | 类型 | 说明 |
context | Context | 应用的 Application Context |
registration_token | String | 返回给应用的UPS RegistrationToken,作为后续的消息推送目标 |
返回:无
说明:当UPS SDK初始化成功后,通过该回调接口获取RegistrationToken。