ICS 35.020 L60/69 中国指挥与控制学会团体标准 T/CICC 1 6002—2018 一体化指挥调度 业务资源 数据交换 技术要求 Integrated command and dispatch - Business resources -Technical requirements for data exchange 2018 - 07 - 02发布 2018 - 08 - 02实施 中国指挥与控制学会 发布 T/CICC 16002 —2018 I 目 次 前言 ................................ ................................ .................. II 1 范围 ................................ ................................ ................. 1 2 规范性引用文件 ................................ ................................ .......1 3 术语、定义和缩略语 ................................ ................................ ...1 3.1 术语和定义 ................................ ................................ .......1 3.2 缩略语 ................................ ................................ ........... 1 4 数据项属性 ................................ ................................ ........... 2 5 数据交换格式 ................................ ................................ ......... 2 6 数据服务接口访问路径格式 ................................ ............................. 2 7 数据操作要求 ................................ ................................ ......... 3 7.1 数据操作动作 ................................ ................................ .....3 7.2 数据操作返回状态 ................................ ................................ .3 T/CICC 16002 —2018 II 前 言 本标准按照 GB/T 1.1 -2009给出的规则起草。 本标准由中国指挥与控制学会提出并归口。 本标准起草单位：一体化指挥调度技术国家工程实验室 、博康智能信息技术有限公司 、中国电子科 技集团公司第二十八研究所、中国电子技术标准化研究院、中 国航天科工集团第四研究院指挥自动化技 术研发与应用中心、中国航空综合技术研究所 、北京大学 。 本标准主要起草人： 金贵霞、刘胜杰 、马文学 、王亮、张阳、李寒、高展、温晓萍，赵文涛、呼延 龙、代红、施媛、王嘉宇、刘宝辉、季光、李伟平、莫同、张荣、卢思远 。 T/CICC 16002 —2018 1 一体化指挥调度 业务资源 数据交换技术要求 1 范围 本标准规定了一体化指挥调度业务资源 轻量级数据交换的数据项属性、数据交换格式、数据服务接 口访问路径格式和数据操作要求。 本标准适用于一体化指挥调度应用系统的开发 建设。 2 规范性引用文件 下列文件对于本文件的应用是必不 可少的。 凡是注日期的引用文件， 仅注日期的版本适用于本文件。 凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。 GB/T 17295 国际贸易计量单位代码 SJ/T 11676 -2017 信息技术 元数据属性 3 术语、定义和缩略语 3.1 术语和定义 下列术语和定义适用于本文件。 3.1.1 一体化指挥调度业务资源 resources of integrated command and dispatch 支撑一体化指挥调度活动的 相关要素 。 3.1.2 表示状态转移 representational state trans fer 为分布式超媒体系统提供了架构约束与架构风格，从整体上一方面强调组件交互的可伸缩性、接口 的通用性、组件的独立部署性，另一方面强调中间组件要减少交互延迟、增强安全性和封装遗留系统。 3.1.3 JavaScript 对象标记 javascript object notation 基于 JavaScript Programming Language , Standard ECMA -262 3rd Edition - December 1999 的一个子 集，完全独立于程序语言的轻量级的数据交换格式。 3.2 缩略语 下列缩略 语适用于本文件。 API：应用程序编程接口 (Application Program Interface) T/CICC 16002 —2018 2 HTTP：超文本传输协议 (Hyper Text Transfer Protocol) HTTPS：基于安全套接字层的超文本传输协议 (Hyper Text Transfer Protocol over Secure socket layer) REST：表述性状态转移 (Representational State Transfer) JSON：JavaScript 对象标记 (JavaScrip t Object Notation) SQL：结构化查询语言 (Structured Query Language) URL：统一资源定位符 (Uniform Resource Locator) 4 数据项属性 一体化指挥调度业务资源 数据交换的数据项属性包括英文名称、数据类型、数据格式、值域和计量 单位，具体内容如表 1所示。其中，“名称”即数据项属性；“定义”是对数据项属性的解释；“ 约束” 即数据库字段的非空约束性特征；“数据类型”即数据值的集合。 表1 数据项属性 序号 名称 定义 约束 数据类型 备注 1 英文名称 数据条目名称 必选 字符串 名称长度不能大于 30个字符。 2 数据类型 用于表示数据条目的符 号、字符或其他表示类 型 必选 字符串 数据类型应符合 SJ/T 11676 -2017 表3中规定的数据类型可能的取 值，但不限于此表中所列。 3 数据格式 从业务角度规定的数据 条目值的格式需求，包 括所允许的最大和 /或 最小字符长度、数据条 目值的表示格式 必选 字符串 数据格式应符合 SJ/T 11676 -2017 表4中规定的数据格式。 4 值域 根据相应属性中所规定 的数据类型、数据格式 而确定的数据条目的允 许值的集合 可选 字符串 值域按SJ/T 11676 -2017，6.5.4 中第六段的规定。 5 计量单位 属于数值型的数据条目 值的计量单位 可选 字符串 见GB/T 17295 中的计量单位的名 称。 5 数据交换格式 一体化指挥调度应用系统所交换的业务资源数据 采用轻量级数据交换格式，如 JSON。 6 数据服务接口访问路径格式 一体化指挥调度业务资源数据交换的数据服务接口访问路径格式应符合以下要求： a) 数据服务提供方与数据操作方之间使用 HTTP作为通信协议，如果考虑数据传输安全，应使用 HTTPS作为保密通信协议； b) 数据传输采用 REST格式的 HTTP请求； T/CICC 16002 —2018 3 c) 每个路径代表一种资源，路径中不能有动词，只能有名词，并且所用的名词通常与数据库的表 名或视图名对应； d) 数据服务接口访问路径中的资源名称如果是英语时应使用复数； 示例： 某数据服务接口提供用户的信息，则它的访问路径应设计为： https://api.example.com/v1/users 。 e) 应将数据服务接口的版本号放入 URL中。 示例： 某URL为： https://api.exampl e.com/v1/ 。 7 数据操作要求 7.1 数据操作动作 一体化指挥调度业务资源数据交换的数据操作动作按 HTTP动词表示资源的具体操作类型来划分， 常用的数据操作动作如表 2所示。其中，中“ HTTP动词”即 HTTP操作命令；“ HTTP动词对应的 SQL 命令”即 HTTP操作命令对应的 SQL语句的命令；“ SQL命令释义”即 HTTP操作命令对应的 SQL