T∕PSC 4-2022 海洋环境安全保障平台数据共享接口规范

海洋环境安全保障平台数据共享接口规范Specificationsfordatasharinginterfaceofmarineenvironmentsecurityplatform2022-03-29发布2022-03-29实施ICS07.060CCSA45；A90团体标准T/PSC5-2022中国太平洋学会发布T/PSC5-2022I目次前言.................................................................................II引言................................................................................III1范围...............................................................................12规范性引用文件.....................................................................13术语和定义.........................................................................14设计原则...........................................................................1语言无关性.....................................................................1接口封装性.....................................................................1访问透明性.....................................................................1接口重用性.....................................................................15数据共享接口命名...................................................................1接口命名.......................................................................2接口参数.......................................................................26数据共享接口模型设计...............................................................3概述...........................................................................3数据信息元模型设计.............................................................3结构化数据元模型设计...........................................................4非结构化数据元模型设计.........................................................4附录A（资料性）数据共享接口示例.....................................................6参考文献.............................................................................36T/PSC5-2022II前言本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由国家海洋信息中心提出。本文件由中国太平洋学会归口。本文件起草单位：国家海洋信息中心、北京辰安科技股份有限公司。本文件主要起草人：韩璐遥、崔晓健、梁建峰、宋晓、张维、韦广昊、郑兵、李程、孙丽娥、耿姗姗。T/PSC5-2022III引言“海洋环境安全保障平台”是国家重点研发计划“海洋环境安全保障”专项的建设内容，是具有海洋环境安全信息综合集成与融合分析、海洋环境安全预警、风险管理和应急辅助决策等功能的大型综合信息系统，是国家安全平台的重要组成部分。本文件规定了海洋环境安全保障平台数据共享接口的设计规范，可指导海洋环境安全保障相关信息系统的数据共享接口的设计和调用，提升海洋环境安全保障平台的数据共享服务和数据获取能力。T/PSC5-20221海洋环境安全保障平台数据共享接口规范1范围本文件规定了海洋环境安全保障平台数据共享接口的设计原则，以及接口命名、参数命名和模型设计规范。本文件适用于海洋环境安全保障平台数据的交换、共享和服务。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T21062.3政务信息资源交换体系第3部分：数据接口规范3术语和定义下列术语和定义适用于本文件。3.1海洋环境安全marineenvironmentsecurity与海洋经济和人类活动相关的海洋自然环境、资源开发环境和权益保障环境处于良好状态，未遭受不可恢复的破坏或严重威胁。3.2海洋环境安全保障平台marineenvironmentsecurityplatform以公共安全科技为核心，以信息技术为支撑，以海洋环境安全管理过程为主线，为常态下的日常安全管理和非常态下的海上环境安全事件应对提供服务的技术保障系统。3.3数据共享接口datasharinginterface符合一定标准规范的，可供系统间实现数据传输和交换的通信通道。4设计原则语言无关性接口的设计与实现不依赖于某一特定编程语言，使用的编程语言应能够生成符合接口规范要求的可执行代码。接口封装性客户端应看不到数据对象的属性信息，访问数据对象的操作应通过接口实现。访问透明性客户端仅能通过一致的方式使用接口提供的服务。接口重用性一个接口可以通过重用另一个接口的功能为用户提供服务。5数据共享接口命名T/PSC5-20222接口命名接口采用英文字母与数字相结合的方式命名，由3部分组成。其中，第1部分为分类码，采用2位大写英文字母，表示数据分类；第2部分为场景码，采用不大于100位的小写英文字母，表示服务场景；第3部分为序号码，采用2位阿拉伯数字（00-99），同场景数据按命名先后依次排序。3部分之间以连接符“_”相连。海洋环境安全保障平台数据共享接口命名方法见图1。图1接口命名方法示例：海岛地名数据的接口可以命名为“JC_daoming_00。其中：“JC”为分类码，表示此共享接口所对应的数据分类为海洋环境安全基础数据。“daoming”为场景码，表示此共享接口的服务场景是调用海岛地名数据。“00”为序号码。接口参数参数采用英文字母命名，由3部分组成。其中，第1部分为分类码，采用2位大写英文字母，表示数据分类；第2部分为数据类型码，采用不大于10位的小写英文字母，表示数据类型；第3部分为内容码，采用不大于100位的小写英文字母，表示此类参数调用的数据内容。3部分之间以连接符“_”相连。海洋环境安全保障平台数据共享接口参数命名方法见图2。图2参数命名方法示例：海岛名称的参数可以命名为“JC_string_mingcheng”。其中：“JC”为分类码，表示此参数调用的数据分类为海洋环境安全基础数据。T/PSC5-20223“string”为数据类型码，表示此参数的数据类型是字符型。“mingcheng”为内容码，表示此参数调用的数据内容为海岛名。6数据共享接口模型设计概述数据接口模型由数据信息元模型、结构化数据元模型和非结构化数据元模型三部分组成。数据共享接口示例见附录A。数据信息元模型设计按照GB/T21062.3的规定，结合海洋环境安全保障平台数据的特点，数据信息元模型（见图3）应包含如下元素：a)信息资源标识（XML元素名称：Identifier）：必选元素，被交换数据内容的唯一标识符；b)信息资源显示名称（XML元素名称：DisplayName）：必选元素，被交换数据内容的常用名称，如海洋站信息等；c)说明性注释（XML元素名称：ExplanatoryComment）：可选元素，对被交换数据内容的解释性描述；d)数据项（XML元素名称：DataUnit）：必选元素，构成数据信息的最小数据单位，该元素至少出现一次，可以出现多次，包括：1)数据项标识（XML元素名称：IDName）：必选元素，数据项的唯一标识符；2)数据项名称（XML元素名称：Displayname）：必选元素，数据项在业务中的惯用名称，如海洋站分钟数据等；3)数据项定义（XML元素名称：Definition）：可选元素，对数据项的定义性描述；4)备注（XML元素名称：Comments）：可选元素，数据项的备注信息；5)数据类型（XML元素名称：Datatype）：必选元素，数据项值的类型，如字符型、数值型等；6)最大长度（XML元素名称：MaximumSize）：可选元素，数据项值的最大长度限制；7)最小长度（XML元素名称：MinimumSize）：可选元素，数据项值的最小长度限制；8)精度（XML元素名称：Scale）：可选元素，当数据类型为数值型时，小数点后的位数。e)数据项扩展属性（XML元素名称：ExtenAttribute）：可选元素，描述数据项的扩展信息，由扩展属性名称和扩展属性值两个元素组成。T/PSC5-20224图3数据信息元模型结构化数据元模型设计结构化数据元模型（见图4）应包含如下元素：a)数据记录（XML元素名称：RecordData）：必选元素，组成结构化数据的最小单位，表示一条记录。数据记录由一个或多个数据项组成；b)数据项（XML元素名称：UnitData）：必选元素，组成数据记录的最小单位，包括：1)数据项标识（XML元素名称：UnitIDName）：必选元素，数据项的唯一标识符；2)数据项名称（XML元素名称：UnitDisplayName）：必选元素，数据项在业务中的惯用名称，如航次号、站次号等；3)数据项值（XML元素名称：UnitValue）：可选元素，数据项的值。图4结构化数据元模型非结构化数据元模型设计非结构化数据元模型（见图5）应包含如下元素：a)对象标识（XML元素名称：IDName）：必选元素，非结构化数据的唯一标识；b)对象显示名称（XML元素名称：DisplayName）：必选元素，非结构化数据的常用名称，如温盐背景场图件等；T/PSC5-20225c)描述（XML元素名称：Description）：可选元素，对非结构化数据的解释性信息；d)类型（XML元素名称：TypeDescription）：可选元素，描述非结构化数据的类型，如文本数据、多媒体数据等；e)对象内容（XML元素名称：Content）：必选元素，非结构化数据的内容，包括文件名称、URL、文件内容等。图5非结构化数据元模型T/PSC5-20226AA附录A（资料性）数据共享接口示例下面给出了溢油突发事件应急监测数据、风暴潮预报产品数据和生态灾害应急监测数据共享接口示例，见示例1~示例3。示例1：溢油突发事件应急监测数据共享接口?xmlversion=”1.0”encoding=”GB1803