ICS35.240.01 L70 中华人民共和国国家标准 GB/T29191—2012 共 性服务信息描述规范 Specificationfordescriptionofcommonserviceinformation 2012-12-31发布 2013-06-01实施 中华人民共和国国家质量监督检验检疫总局 中国国家标准化管理委员会发布目 次 前言 Ⅰ ………………………………………………………………………………………………………… 引言 Ⅱ ………………………………………………………………………………………………………… 1 范围 1 ……………………………………………………………………………………………………… 2 规范性引用文件 1 ………………………………………………………………………………………… 3 术语和定义 1 ……………………………………………………………………………………………… 4 缩略语 1 …………………………………………………………………………………………………… 5 描述模型的基础 2 ………………………………………………………………………………………… 6 共性服务描述模型 4 ……………………………………………………………………………………… 7 共性服务信息描述扩展方式和规则 18 …………………………………………………………………… 附录A(规范性附录) CSDM的XMLSchema表示 19 ………………………………………………… 参考文献 26 ……………………………………………………………………………………………………GB/T29191—2012 前 言 本标准按照GB/T1.1—2009给出的规则起草。 本标准由全国电子业务标准化技术委员会(SAC/TC83)提出并归口。 本标准起草单位:中国标准化研究院、长风开放标准平台软件联盟、用友软件股份有限公司、中国科 学院计算技术研究所、神州数码(中国)有限公司、易达讯网络科技(北京)有限公司。 本标准主要起草人:刘颖、曾硝、杨冬菊、章建方、马胜男、隋媛、付东普、朱律玮、李方平、王华飞、 谢静、郭炜、倪旻、蒋严冰。 ⅠGB/T29191—2012 引 言 近年来随着互联网和信息技术的迅速发展,现代服务业逐渐成为我国经济的支撑产业。现代服务 业主要依托信息技术和现代管理理念发展起来,由于产业分工的社会化和专业化,衍生出种类繁多的共 性服务。共性服务作为各领域、行业普遍使用的服务,需要对它们的内涵和服务接口等信息进行精确的 定义和规范化描述,以便被不同行业和不同应用所调用,指导和规范共性服务的开发和应用。 共性服务标准制定者可以按照本标准框架制定各种具体的共性服务标准,以便于服务资源的共享 与使用;共性服务提供者也可以在本标准的指导下,开发共性服务,供服务使用者使用。 ⅡGB/T29191—2012 共性服务信息描述规范 1 范围 本标准规定了共性服务及服务接口的描述模型,包括服务概要、服务接口、服务质量和服务策略,并 给出服务描述的扩展方式和规则。 本标准适用于共性服务标准的制定和共性服务的开发。 2 规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件,仅注日期的版本适用于本文 件。凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。 GB2312 信息交换用汉字编码字符集 基本集 GB/T7408 数据元和交换格式 信息交换 日期和时间表示法 GB11714 全国组织机构代码编制规则 3 术语和定义 下列术语和定义适用于本文件。 3.1 服务 service 由某个实体,以约定的接口提供的满足特定需求的功能或功能的集合。 注1:改写ISO19119:2005,定义4.1.1。 注2:服务在技术上可以有多种表现形式和使用方式。如Web服务等。 3.2 共性服务 commonservice 跨行业、领域普遍使用的、可重用的服务,一般通过标准开放的网络协议和标准接口被外部访问和使用。 3.3 值域 valuedomain 允许值的集合。 3.4 接口 interface 表征实体行为的操作的命名集合。实体或实体的某种代表(如:服务)通过接口来实现功能。 3.5 操作 operation 被执行的某一转换或查询的规范说明。操作是对信息系统相关实体执行的行为。 注:某个操作具有一个名称和一列参数。 4 缩略语 下列缩略语适用于本文件。 1GB/T29191—2012 CSDM:共性服务描述模型(CommonServiceDescriptionModel) LCC:首字母小写(LowerCamelCase) SOAP:简单对象访问协议(SimpleObjectAccessProtocol) UML:统一建模语言(UnifiedModelingLanguage) URI:统一资源标识符(UniformResourceIdentifier) URL:统一资源定位符(UniformResourceLocator) XML:可扩展置标语言(ExtensibleMarkupLanguage) 5 描述模型的基础 5.1 概述 本标准采用UML描述CSDM。附录A给出了CSDM的XMLSchema。 本标准中,用UML中“类”的概念表示“描述项”(简称“项”);用UML中“类的属性”的概念表示 “描述项的元素”。 描述项和元素的英文名称采用LCC方式,即除第一个英文单词外,每个单词的首字母大写,并把这 些单词组合起来。 5.2 模型中关系及符号说明 本标准涉及UML定义的以下两种模型关系,并采用UML静态结构图表示描述项之间的关系: a) 关联,用于描述两个或更多描述项之间的一般关系。 关联的方向需说明。如果不指明方向,则假定为双向关联,见图1中的b);如果是单向关联,关联 方向可以在线段终点用箭头来标记,见图1中的a)。 模型中使用“角色名称”说明源对象与目标对象之间的关系,见图1中的c)。在双向关联中,提供 两个角色名称。角色名称“角色1”是描述项1对描述项2的关系;“角色2”是描述项2对描述项1的关 系;“基数1”表示描述项1与描述项2单个实例关联的实例的数量;“基数2”表示描述项2与描述项1 单个实例关联的实例的数量。基数的取值可以是一个n,也可以是“m..n”,其中m是非负整数,n是正 整数,m小于或等于n。当基数取值为1时,可以省略不写。 a) b) c) 图1 关联关系 b) 聚合,用于说明两个项之间的部分与整体的关系。 在聚合关系中,一个项(H)包含另外的项(J、K),J、K可认为是H的子描述项(简称子项),见图2。 对于子项J、K,可标注“基数”,表示H包含的J的实例数量、K的实例数量。基数的取值可以是一个n, 2GB/T29191—2012 也可以是“m..n”,其中m是非负整数,n是正整数,m小于或等于n。当基数取值为1时,可以省略 不写。 a) b) 图2 聚合关系 5.3 模型中描述项及描述项中元素的描述方法 本标准中共性服务描述项及描述项的元素采用的表述方式分别见表1和表2。 表1 模型中描述项描述方法 英文名称 中文名称 可选性 最大出现次数 说 明 表2 模型中元素描述方法 英文名称 中文名称 数据类型数据格式可选性最大出现次数 值域 说明 其中: 英文名称:描述项或元素的英文名称。 中文名称:描述项或元素的中文名称。 数据类型:元素的数据类型,元素的有效值域和允许对该值域内的值进行有效操作的规定。本标准 中涉及的基本数据类型见5.4。 数据格式:从业务的角度规定的描述项或元素的格式需求,包括所允许的最大和/或最小字符长度, 描述项或元素的表示格式等。 可选性:说明该描述项或元素是否为描述共性服务所必选的(M)、条件必选(C)或可选的(O)。 最大出现次数:说明该描述项或元素可以具有的最大实例数目。 值域:说明该元素的取值范围。 说明:对描述项或元素含义的进一步解释。 5.4 基本数据类型和数据格式 基本数据类型包括布尔型(boolean)、日期型(date)、日期时间型(datetime)、数字型(number)、字 3GB/T29191—2012 符型(string)、文本型(text)。本标准采用UML描述CSDM概念模型时所用的基本数据类型和数据格 式见表3。 表3 基本数据类型和数据格式 数据类型 数据格式 说明 示例 booleanOn/Off、True/False、1/0 两个且只有两个表明条件的值 dateYYYYMMDD通过YYYYMMDD的形式表达的值 的类型,符合GB/T740820081025 datetimeYYYYMMDDhhmmss通过YYYYMMDDhhmmss的形式 表达的值的类型,符合GB/T740820080908104532 numbernm表示定长m位的数字 n..p,q(p,q均为自然数)表示最长p 位数字,小数点后q位 n..表示确定了最小和最大位数的不 定长数字,前面附加最小位数,后面 附加最大位数通过从“0”到“9”数字形式表达的值 的类型n5表示定长5位的数字 n..17,2表示最长17位 数字,小数点后两位 n2..10表示最大10位、 最小2位的不定长数字 stringCm(m为自然数)表示定长m个字 符集(字符集默认为GB2312)通过字符形式表达的值的类型 C5表示定长5个字符 C..ul表示长度不确定的文本 C..表示确定了最小和最大长度的不 定长字符,前面附加最小长度,后面 附加最大长度C2..10表示最大长度为 8,最小长度