ICS 35.240.50 L 67 中华人民共和国国家标准 GB/T 36456.2—2018 面向工程领域的共享信息模型 第2部分：领域信息服务接口 Engineering domain oriented shared information model- Part 2:Domain information service interface 2019-01-01实施 2018-06-07发布 国家市场监督管理总局 发布 中国国家标准化管理委员会 GB/T 36456.2—2018 目 次 前言 I 1 范围 2 规范性引用文件 3 术语和定义 4 缩略语 5 约定 6 数据类型 7 接口函数 GB/T36456.2-—2018 前言 GB/T36456《面向工程领域的共享信息模型》分为三个部分： 第1部分：领域信息模型框架； 一一第2部分：领域信息服务接口； —第3部分：测试方法。 本部分为GB/T36456的第2部分。 本部分按照GB/T1.1一2009给出的规则起草 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。 本部分由全国信息技术标准化技术委员会（SAC/TC28）提出并归口。 本部分起草单位：清华大学、中国电子技术标准化研究院、中车信息技术有限公司 本部分主要起草人：孙家广、顾明、刘玉身、张荷花、高歌、余云涛、杨磊、李博。 Ⅲ GB/T36456.2—2018 面向工程领域的共享信息模型 第2部分：领域信息服务接口 1范围 GB/T36456的本部分规定了用以支持按GB/T36456.1描述的领域信息模型框架实现的共享信 息模型信息服务接口的数据类型和接口函数。 本部分适用于访问符合GB/T36456.1的共享信息模型的概念、属性、关系，也适用于支持共享信 息模型应用软件的开发， 2规范性引用文件 2 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文 件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。 GB/T36456.1面向工程领域的共享信息模型第1部分：领域信息模型框架 3 术语和定义 下列术语和定义适用于本文件。 3.1 概念服务 conceptservice 为共享工程领域信息而访问领域概念的操作。 3.2 语境 context 为共享工程领域信息而定义的特定工程领域的范畴。 3.3 属性服务 propertyservice 为共享工程领域信息而访问领域属性的操作。 3.4 关系服务 relationship service 为共享工程领域信息而访问概念间关系的操作。 4缩略语 下列缩略语适用于本文件 HTTP：超文本传输协议（HypertextTransferProtocol) JSON:JavaScript对象标记（JavaScriptObjectNotation) RESTful:表征状态转移（RepresentationalStateTransfer) URI：统一资源标识符（UniformResourceIdentifier) URL：统一资源定位符（UniformResourceLocator） 1 GB/T36456.2—2018 URN：统一资源名称（UniformResourceName) XML：可扩展标记语言（eXtensibleMarkupLanguage) 5约定 5.1# 数据类型约定 在描述特定的面向工程领域的信息模型接口时，可能使用到各种数据类型。本部分分别按简单、复 对于简单数据类型，采用类型名称、中文含义、默认值的方法定义； 现的次数）”以及“说明”来定义； 对于枚举数据类型，通过表格描述包含“基础类型”栏和与其他各行对应的“取值范围”栏来 定义。 对于多个单词组成的关键词，本部分采取驼峰命名法，即每个单词的首字母大写，其余字母小写。 5.2 2接口函数约定 本部分定义的接口函数基于HTTP标准与RESTful架构，用以支持访问按GB/T36456.1定义的 和“关系服务接口”分类描述各个接口。 每个接口函数由以下部分组成： “域名”十“/版本”十“路径”十“/语境”十“/标识符”。 示例：http：//cbims.org.cn/api/v1.0/EimConcept/crbim/BallastlessTrack 在RESTful架构中，由URI相对路径代表一项资源，所以路径一般由名词组成。 每个接口函数按以下形式描述： 标题中直接给出该接口函数的路径，用URI相对路径的形式给出； 本部分采用四种可用的HTTP方法，分别用GET、PUT、POST和DELETE代表，其中： ·GET：获取服务提供的资源，GET方法是幂等和安全的； ·PUT：在服务段通过替换的方式更新资源，PUT方法是幂等而不安全的； ·POST：在服务端创建新的资源，POST方法是不幂等也不安全的； ·DELETE：从服务端删除资源，DELETE方法是幂等而不安全的 每个接口函数的参数按表1的内容给出。未给出接口函数参数表格的接口函数，不要求接口 函数的参数。 表1接口函数参数的描述 名称 描述 类型 备注 概念的语境，以语境标识符表示 path 路径参数 ...... . .. "“名称”栏下面逐一列出该接口中包含的参数的英文单词或组合词表示的名称， b“描述”给出相应参数的定义或简要说明， ““类型”用英文单词给出的相应参数的传递形式。 d“备注”给出参数的进一步描述性信息 2 GB/T 36456.2—2018 每个接口函数的返回值使用无表头的列表给出，具体要求如表2所示。未给出返回值表格的 接口函数，对返回数据没有要求。 表 2 2接口函数返回值的描述 类型 内容 element:" xsd:anyURI application/xml media types:b .. 接口函数返回值的描述。 b接口函数返回值的格式，具有多个取值表示有允许多种返回值类型，如json格式与xml格式。 6 数据类型 6.1简单数据类型 6.1.1布尔型 xsd：boolean：布尔型，其取值可能是： true：表示真，或肯定； —false：表示假，或否定。 6.1.2字符型 xsd：string：字符串，默认值为空。 6.1.3 整数型 xsdinteger：整数型，默认值为0。 6.1.4浮点型 xsd：double：64位双精度浮点数，有符号数，默认值为0。 6.1.5 日期时间型 xsd：dateTime：日期时间型，格式为YYYY-MM-DDTHH：MM.SS，默认值为"1900-12-31T23：59： 59”。 6.1.6 统一资源标识符型 xsd：anyURI：代表一个URI的引用，包括URN和URL。 6.2复杂数据类型 6.2.1语境(EimContext) 语境数据类型表达特定工程领域的范畴，共享信息模型中的概念、属性、关系定义在特定的语境下。 的参数定义见表3。 3 GB/T36456.2—2018 表3 语境参数 序号 属性 属性名称 属性类型 基数 说明 语境的标识符，是语境完整URI的 1 GUID 标识符 xsd: string [1,1] 简化，由管理员在全局唯一地确 定，如"crbim” 2 Name 名称 xsd:string [0,*] 语境的名称 3 Description 描述 xsd;string [0,1] 语境的描述 Version 版本 xsd:string [0,1] 4 语境的版本 Publisher 5 发布者 xsd:string [0,1] 语境的发布者 版本日期 xsd:dateTime 6 VersionDate [0,1] 版本日期 语境的完整URI地址，如： Location 7 地址 xsd:anyURI [1.1] http://onto.crbim.com.cn 6.2.2 概念（EimConcept) 概念表示对特定工程领域的具有重要意义的特定信息主体，其定义见表4。 表4 4概念参数 序号 属性 属性名称 属性类型 基数 说明 概念的标识符，如 1 GUID 标识符 xsd: string [1,1] “BallastlessTrack" Name 2 名称 xsd:string [0, *] 概念的名称，如“无轨道” 概念的定义，如“采用混凝土、沥青 Definition 3 定义 xsd:string [0,1] 混合料等整体基础取代散粒碎石 道床的轨道结构。” Type 类型 4 xsd:string [0,1] 概念进一步的类型信息 概念完整地址，由语境的URI+概 念GUID表示，如 5 Location 地址 xsd:anyURI [0,1] http://onto.crbim.com.cn/ BallastlessTrack 6.2.3 属性（EimProperty） 属性表示工程领域概念的特征与描述性信息，如材质、物理特性、生产和工艺特征等信息，其具体参 数定义见表5。 4