GB/T 40778.2-2021 物联网 面向Web开放服务的系统实现 第2部分：物体描述方法（正式版）

ICS35.110GB/T40778.2—2021物联网面向Web开放服务的系统实现第2部分：物体描述方法Part2:Thingdescriptionmethod国家市场监督管理总局国家标准化管理委员会IGB/T40778.2—2021 Ⅲ 12规范性引用文件 1 1 15物体描述模型 26物体描述元数据 3附录A(资料性)UML符号说明 8附录B(资料性)物体描述方法示例 9B.1XML描述方法示例 9 ⅢGB/T40778.2—2021本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起草。本文件是GB/T40778《物联网面向Web开放服务的系统实现》的第2部分。GB/T40778已经发布了以下部分：——第1部分：参考架构；——第2部分：物体描述方法。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由全国信息技术标准化技术委员会(SAC/TC28)提出并归口。GB/T40778.2—2021为了解决物联网发展过程中信息碎片化，烟囱式发展等问题，需要在物联网与Web结合的领域，制定相关国家标准，为提高物联网应用系统之间协作功能、加速物联网全产业链贯通提供规范和指导。本文件给出一套面向Web开发服务的系统物联网物体描述方法，统一异构物联网物体的描述，降低异构物联网系统开发成本，提高系统间物体交互和互操作性。GB/T40778《物联网面向Web开放服务的系统实现》计划由两部分构成。——第1部分：参考架构。目的在于提供一套面向Web开放服务的物联网系统架构。——第2部分：物体描述方法。目的在于统一面向Web开放服务的异构物联网系统间物体描述。1GB/T40778.2—2021物联网面向Web开放服务的系统实现第2部分：物体描述方法本文件规定了面向Web开放服务的物联网系统的物体描述模型和物体描述元数据的要求。本文件适用于面向Web开放服务的物联网系统设计和开发，为物联网应用服务提供技术支撑。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文GB/T2260中华人民共和国行政区划代码GB/T2659世界各国和地区名称代码GB/T7408数据元和交换格式信息交换日期和时间表示法GB/T28174(所有部分)统一建模语言(UML)GB/T40778.1—2021物联网面向Web开放服务的系统实现第1部分：参考架构3术语和定义下列术语和定义适用于本文件。3.1描述物联网物体数据的数据。3.3元数据的基本单元。3.4一组说明数据相同特性的元数据元素。4缩略语下列缩略语适用于本文件。2GB/T40778.2—2021JSONJava脚本对象记法(JavaScriptObjecXML可扩展置标语言(ExtensibleMarkupLangua的说明见附录A。物体描述模型应符合GB/T40778.1—2021的第5章规定。基于UML的物体描述模型见图1所示。+1,1.1物体名称+1.1.2物体标识符+1.1.3物体类型+1.1.4关键字+1.2.2外观+1.2.3环境+1.2.4生产信息+1.2.4.1生产新名称+1.2.4.2型号+1.2.4,3生产时间+1.2.4.4有效期+1.2.4.5注释3.1接I+3.1.1接口名称+3,1.3接II方向+3.1.4接口参数+3.1.5接口返回值+3.1.4.2参数类型-3.1.5.2返叫作类型+3.1.4.3参数注得-3.1.5.3运四值注样+1.1标识+1,2特征+1.3扩展位12.1.1.1状态名称+2.1.1.2状态标识符+2.1.1.4催单位+2.1.1.6状态值+2.1.2.1状态名称+2.1.2.2状态标识符2.1工作+2.1.1使用状态.1.2错误状态+2.1.3资源消耗-2.2.1网络位置12.2位号+1.周性+2.状态+3.动作+4.能力11+2.2.1.2其他地圳.12.2.2.2省份-2.2.2.3城市-2.2.2.4详细地址：2.2.2.7高度1+3.1接口13.2按入+3,3扩展位助能14.3矿展位4.2数据+4.2.1数据名称+4.2.2数据标认符+4.2.3数据类型+1.2.4数据效果+4.2.5数据关联+4.1.2功能标识符+4.1.3功能效果+4.1.4功能关联3.2接入43.2.2管理+3.2.1.1通信链路+3.2.1.2通信协议+3.2,2.1管理者姓名+3.2.2.2管理者信息+3.2.2.3管旦者注释-1,1.4.2数据关联说明13GB/T40778.2—20216物体描述元数据物体描述元数据由元数据元素或元数据实体组成素或元数据实体在概念上相区别。d)数据类型：对元数据元素或元数据实体的有效值域的规定和允许对该值域内的值进行有效操e)约束/条件：说明一个元数据元素或元数据实体是否选取2)O:可选，元数据元素或元数据实体根据实际应用可以选择也可以不选择。如果一个可选元数据实体未被使用，则该实体所包含的元素(包括必选元素)也不选用。可选元数据实3)C:条件必选，当满足约束条件中所定义的条件时应选择。条件必选用于以下三种可能性之一：g)最大出现次数：说明元数据元素或元数据实体可以出现的最大次数。只出现一次的用“1”表面向Web开放服务的物联网系统物体描述元数据见表1,面向Web开放服务的物联网系统物体描述元数据的XML和JSON示例见附录B。表1物体描述元数据序号中文名称英文名称描述数据类型约束/条件值域最大出现次数1属性Attribute描述物体的基本信息、生产信息和重要特性ComplexM1标识Identification描述物体的标识信息ComplexM1物体名称ThingName物体的中文名称TextM自由文本1物体标识符ThingID物体在物联网中的唯一标识TextM自由文本l物体类型ThingType物体在物联网使用环境中的类型TextO自由文本1关键字Keywords物体在物联网中的关键字TextO自由文本4GB/T40778.2—2021序号中文名称英文名称描述数据类型约束/条件值域最大出现次数特征CharacteristicM1核心功能CoreFunction描述物体特征展示的功能M自由文本1外观Appearance物体的外观描述M自由文本1环境Environment物体的使用环境M自由文本1生产信息Production物体的生产厂商信息和出厂属性M1生产商名称ProducerName物体制造商名称M自由文本1型号Model物体的规格M自由文本1生产时间ProduceTime物体的生产时间DateTimeM按照GB/T7408中的规定执行，格式为CCYY-MM-DD1有效期Validtime物体的生产时间M按照GB/T7408中的规定执行，格式为CCYY-MM-DD1注释Note物体的其他信息O自由文本1扩展位Extension用于其他自定义扩展信息自定义自定义自定义2状态描述物体的状态和位置M—1工作Working包括物体的使用状态、错误状态和资源消耗M1使用状态UsingState描述物体在正常工作下的不同状态M状态名称物体工作时的状态名称M1状态标识符识别物体工作状态的唯一标识符M自由文本1默认值DefaultValue状态的初始值由系统进行定义M由系统进行定义1值单位ValueUnit状态值的单位由系统进行定义M由系统进行定义1值类型ValueType状态值的类型由系统进行定义M由系统进行定义1状态值Value由系统进行定义M由系统进行定义15表1物体描述元数据(续)序号中文名称英文名称描述数据类型约束/条件值域最大出现次数错误状态FaultState描述物体在非正常工作下的不同状态M状态名称FStateName物体非正常工作时的状态名称M自由文本1状态标识符FStateID标识物体非工作状态的唯一标识符M由系统进行定义1资源消耗Consuming描述物体在使用过程中的能源消耗状态M自由文本1位置描述物体的地理位置、网络位置、时间参考和空间参考等相关信息M1网络位置Network物体在网络中的位置M—1IP地址物体在网络中的IP地址C同时支持IPv6和IPv4格式的地址1其他地址OtherAddress除IP地址外的其他可得地址O自由文本1地理位置GeoLocatio物体的地理位置M1国家物体所处地理位置的在地球上的国家M按照GB/T2659中的规定执行1省份Province物体所处地址位置在国家中省份M按照GB/T2260中的规定执行1城市物体所处地理位置在省份中的城市及地区M按照GB/T2260中的规定执行1详细地址物体所处地理位置在城市及地区中具体地址M自由文本1经度Longitude物体所处地理位置的经度NumM实数值1纬度物体所处地理位置的维度NumM实数值1高度Altitude物体所处地理位置的高度NumM实数值1时间参考TimeReference位置信息所对应的时间参考系(时区)NumM整数值1扩展位Extension用于其他自定义扩展信息自定义自定义自定义3动作Action描述物体的感知操控信息，主要包括不同的接口函数信息、通信方式和接入管理等信息M16GB/T40778.2—2021表1物体描述元数据(续)序号中文名称英文名称描述数据类型约束/条件值域最大出现次数接口包括物体所用到的接口信息M1接口名称物体与其他设备或系统的接口M自由文本1接口标识符标识物体接口的唯一标识符M自由文本1接口方向Direction接口信息的流向M上行、下行、双向中的一种、两种或三种接口参数Parameter接口调用的参数M参数标识符ParameterID接口调用参数的标识符M自由文本1参数类型ParameterType接口调用参数的类型M由系统自行定义参数注释Parameter描述接口调用参数的作用M自由文本接口返回值接口的返回值由系统定义M返回值标识符接口返回值的标识M自由文本返回值类型ResultType接口返回值的类型M由系统自行定义返回值注释ResultComment接口返回值的作用M自由文本接入Accessibility包括物体的通信和接入信息M1通信Communication描述物体需要接入网络的通信类信息M—1通信链路ComMethod物体接入网络的通信方式M系统自行定义通信协议ComProtocol物体接入网络的通信协议M系统自行定义管理Administration物体的接入管理信息M1管理者姓名Contractor物体的管理者姓名M自由文本1管理者信息ContactInfo物体的管理者的联系方式M自由文本1管理者注释ContactCommen物体管理者对物体的接入管理相关说明M自由文本1合法性约束描述物体涉及的法规规章等信息M自由文本1安全性约束Constraint描述物体的安全性信息M自由文本1扩展位Extension用于自定义扩展信息自定义自定义自定义4能力Capability描述物体的能力属性M17表1物体描述元数据(续)序号中文名称英文名称描述数据类型约束/条件值域最大出现次数功能Function物体所具有的功能M1功能名称FuncName物体功能的名称M自由文本1功能标识符识别功能的唯一标识符M按照一定的编码规则由系统定义1功能效果FuncEffect物体功能的作用的详细说明M自由文本1功能关联FuncRelate物体功能对应的接口M1功能接口标识符FInterfacelD标识物体功能接口的唯一标识符M自由文本1功能关联说明FuncRelate描述物体功能对应的接口的操作方法M自由文本1数据物体所能被使用的数据信息M1数据名称DataName描述数据的名称M自由文本1数据标识符DataID识别数据的唯一标识符M按照一定的编码规则由系统定义1数据类型DataType描述数据的类型M由系统进行定义数据效果DataEffect描述数据的作用M自由文本1数据关联DataRelate获得或发送数据对应的接口M1数据接口标识符DInterfacelD标识物体数据接口的唯一标识符M自由文本1数据关联说明DataRelate获得或发送数据对应的接口说明M自由文本1扩展位Extension用于其他自定义扩展信息自定义自定义自定义8GB/T40778.2—2021(资料性)UML符号说明本文件中使用的UML符号说明如图A.1所示。表示元数据实体表示元数据实体表示实体间部分与整体的关系类2包含类1类2表示类2包食类1,一个类2仅包含一个类1类2.衣示类2包含类1,一个类2包含一个或多个类1类2表示类2包含类1,一个类2包含0个或多个类1类2表示类2包含类1,一个类2包含0个或1个类1类1类2表示类2和类1关联0.,N0..119(资料性)物体描述方法示例B.1XML描述方法示例以下代码是按照本文件中规定的内容，利用XML描述一个智能门锁例子。<?xmlversion="1.0"encoding="UTF-8"?>〈ThingID>smartlock20161209</ThingID〉〈ThingName)智能门锁</ThingName)〈ThingType)智能门锁</ThingType〉〈Keywords>远程开门</Keywords)〈CoreFunction>控制门开关</CoreFunction〉〈Appearance>好看</Appearance〉〈Evironment></Evironment〉(ProducerName>xx智能</ProducerName〉〈Model>smart-lock-001</Model)〈Environment>家庭</Environment></Characteristic)</Attribute〉<ResourceConsuming>小</ResourceConsuming>(NetworkLocation)(IPAddress)〈UserName)(/UserName〉(/IPAddress)(MacAddress)</MacAddress〉GB/T40778.2—2021〈OtherAddress>(/OtherAddress)(/NetworkLocation)〈Province>北京市</Province》(DetailLocation)>(/DetailLocation)〈Longitude></Longitude〉〈Community)创新院</Community〉〈TimeReference)</TimeReference>(/Location)(/State)(Action)〈InterfaceParameter)(ParameterID>value(/ParameterID〉〈ParameterType)enumstring</ParameterType〉<ParameterComment)开关的值</ParameterComment>(Value)ON,OFF</Value)<InterfaceName)开关控制</InterfaceName〉〈InterfaceDirection)down</InterfaceDirection)(/Interface)(Interface)(InterfaceParameter)(ParameterID>outtime</ParameterID>〈ParameterType)int</ParameterType>分钟</ValueComment>〈/InterfaceParameter)〈InterfaceParameter)(ParameterID>outcount</ParameterID)〈ParameterType)int</ParameterType><ParameterComment)失效次数(/ParameterComment>〈ValueComment)密码失效次数</ValueComment>GB/T40778.2—2021(/InterfaceParameter)〈InterfaceParameter)〈ParameterID>password</ParameterID)〈ParameterType>string</ParameterType)〈ParameterComment>密码</ParameterComment)(Value>0～0</Value》〈ValueComment>添加的数字6位密码</ValueComment)</InterfaceParameter)<InterfaceResult)(ResultID>result</ResultID〉(ResultType>enumstring</ResultType><value)</value)(valueComment)(/valueComment)<Value>success,fail</Value〉</InterfaceResult><InterfaceID)add(/InterfaceID)〈InterfaceName>添加密码</InterfaceName)〈InterfaceDirection>down-up</InterfaceDirection></Interface)<Interface〉<InterfaceResult)〈ResultID)result</ResultID〉〈ResultType>enumstring</ResultType)〈ResultComment>成功失败</ResultComment>〈value></value)(valueComment)</valueComment><Value>success,fail</Value〉〈ValueComment>success成功，fail失败</ValueComment)〈/InterfaceResult〉〈InterfaceID)del(/InterfaceID〉〈InterfaceName>删除密码</InterfaceName)<InterfaceDirection)down-up</InterfaceDirection></Interface)(Interface)(InterfaceResult)〈ResultID>outtime</ResultID〉〈ResultType>int(/ResultType)〈ResultComment>失效时间</Re(value)(/value)(valueComment)</valueComment)(Value>0～255</Value)〈valueComment></valueComment)(Value>0～0</Value〉〈ValueComment>返回6位数字密码</ValueComment><InterfaceID>get</InterfaceID〉(Accessibility〉〈ComMethod)Ethernet(/ComMethod)<ContactAddress></Co(Capability〉(Function)〈FunctionID)switch</FunctionID〉<InterfaceID)switch<〈FunctionID>add(/FunctionID〉<InterfaceID)add</InterfaceID〉〈FunctionID>del</FunctionID》(Function〉〈FunctionID>get</FunctionID>(DataID>〈/DatalD〉〈InterfaceID></Interfa</DataRelate》</Capability〉B.2JSON描述方法示例以下代码表达的内容同附录A,切换成JSON语言描述一个智能门锁；{GB/T40778.2—2021"ThingID":"smartlock20161209","ThingName":"智能门锁","ThingType":"智能门锁","Appearance":"好看","ResourceConsuming":"小""Country":"中国","Province":"北京市","City":"北京市","County":"海淀区","Community":"创新院"{"InterfaceParameter":[—"Interfa