GB/T 29191-2012 共性服务信息描述规范

ICS35.240.01

L70百目

中华人民共和国国彖标准

GB/T29191—2012

共性服务信息描述规范

Specificationfordescriptionofcommonserviceinformation

2012-12-31发布2013-06-01实施

GB/T291912012

目次

,、/d•、T

刖有I

引言n

1范围1

2规范性引用文件1

3术语和定义1

4缩略语1

5描述模型的基础2

6共性服务描述模型4

7共性服务信息描述扩展方式和规则18

附录A（规范性附录）CSDM的XMLSchema表示19

参考文献26

GB/T291912012

■ir■■i

刖吕

本标准按照GB/T1.1-2009给出的规则起草。

本标准由全国电子业务标准化技术委员会（SAC/TC83）提出并归口。

本标准起草单位：中国标准化研究院、长风开放标准平台软件联盟、用友软件股份有限公司、中国科

学院计算技术研究所、神州数码（中国）有限公司、易达讯网络科技（北京）有限公司。

本标准主要起草人:刘颖、曾硝、杨冬菊、章建方、马胜男、隋媛、付东普、朱律玮、李方平、王华飞、

谢静、郭炜、倪旻、蒋严冰。

T

GB/T291912012

引言

近年来随着互联网和信息技术的迅速发展，现代服务业逐渐成为我国经济的支撑产业。现代服务

业主要依托信息技术和现代管理理念发展起来，由于产业分工的社会化和专业化，衍生出种类繁多的共

性服务。共性服务作为各领域、行业普遍使用的服务,需要对它们的内涵和服务接口等信息进行精确的

定义和规范化描述，以便被不同行业和不同应用所调用，指导和规范共性服务的开发和应用。

共性服务标准制定者可以按照本标准框架制定各种具体的共性服务标准，以便于服务资源的共享

与使用；共性服务提供者也可以在本标准的指导下，开发共性服务,供服务使用者使用。

n

GB/T291912012

共性服务信息描述规范

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缩略语

下列缩略语适用于本文件。

1

GB/T291912012

CSDM:共性服务描述模型(CommonServiceDescriptionModel)

LCC：首字母小写(LoweCamelCase)

SOAP：简单对象访问协议(SimpleObjectAccessProtocol)

UML：统一建模语H(UnifiedModelingLanguage)

URI：统一资源标识符(UniformResourceIdentifier)

URL：统一资源定位符(UniformResourceLocator)

XML：可扩展置标语言(ExtensibleMarkupLanguage)

5描述模型的基础

5.1概述

本标准采用UML描述CSDM。附录A给出了CSDM的XMLSchema0

本标准中，用UML中“类”的概念表示“描述项”（简称“项”）；用UML中“类的属性”的概念表示

“描述项的元素”。

描述项和元素的英文名称采用LCC方式，即除第一个英文单词外，每个单词的首字母大写，并把这

些单词组合起来。

5.2模型中关系及符号说明

本标准涉及UML定义的以下两种模型关系，并采用UML静态结构图表示描述项之间的关系：

a）关联，用于描述两个或更多描述项之间的一般关系。

关联的方向需说明。如果不指明方向，则假定为双向关联，见图1中的b）；如果是单向关联，关联

方向可以在线段终点用箭头来标记，见图1中的a）。

模型中使用“角色名称”说明源对象与日标对象之间的关系，见图1中的c）o在双向关联中，提供

两个角色名称。角色名称“角色1”是描述项1对描述项2的关系；“角色2”是描述项2对描述项1的关

系；“基数1”表示描述项1与描述项2单个实例关联的实例的数量；“基数2”表示描述项2与描述项1

单个实例关联的实例的数量。基数的取值可以是一个n,也可以是其中m是非负整数，n是正

整数,m小于或等于n。当基数取值为1时，可以省略不写。

mg

b)

图1关联关系

b）聚合，用于说明两个项之间的部分与整体的关系。

在聚合关系中，一个项（H）包含另外的项（J、K）,J、K可认为是H的子描述项（简称子项），见图2。

对于子项J、K,可标注“基数”，表示H包含的J的实例数量、K的实例数量。基数的取值可以是一个n,

2

GB/T291912012

也可以是其中m是非负整数，n是正整数，m小于或等于n。当基数取值为1时，可以省略

不写。

图2聚合关系

5.3模型中描述项及描述项中元素的描述方法

本标准中共性服务描述项及描述项的元素采用的表述方式分别见表1和表2。

表1模型中描述项描述方法

英文名称中文名称可选性最大出现次数说明

表2模型中元素描述方法

英文名称中文名称数据类型数据格式可选性最大出现次数值域说明

其中：

英文名称:描述项或元素的英文名称。

中文名称:描述项或元素的中文名称。

数据类型：元素的数据类型，元素的有效值域和允许对该值域内的值进行有效操作的规定。本标准

中涉及的基本数据类型见5.4。

数据格式:从业务的角度规定的描述项或元素的格式需求,包括所允许的最大和/或最小字符长度，

描述项或元素的表示格式等。

可选性：说明该描述项或元素是否为描述共性服务所必选的（M）、条件必选（C）或可选的（0）。

最大出现次数：说明该描述项或元素可以具有的最大实例数目。

值域:说明该元素的取值范围。

说明：对描述项或元素含义的进一步解释。

5.4基本数据类型和数据格式

基本数据类型包括布尔型（boolean）.0期型（date）、日期时间型（datetime）.数字型（numbe）.字

3

GB/T291912012

符型（string）.文本型（text）o本标准采用UML描述CSDM概念模型时所用的基本数据类型和数据格

式见表3。

表3基本数据类型和数据格式

数据类型数据格式说明示例

booleanOn/Off、True/False、1/0两个且只有两个表明条件的值

通过YYYYMMDD的形式表达的值

dateYYYYMMDD20081025

的类型，符合GB/T7408

通过YYYYMMDDhhmmss的形式

datetimeYYYYMMDDhhmmss20080908104532

表达的值的类型，符合GB/T7408

nm表示定长m位的数字n5表示定长5位的数字

n..p,q（p,q均为自然数）表示最长pn..17,2表示最长17位

位数字，小数点后q位通过从“0”到“9”数字形式表达的值数字,小数点后两位

numbe

的类型

n..表示确定了最小和最大位数的不

n2・.10表示最大10位、

定长数字，前面附加最小位数，后面

最小2位的不定长数字

附加最大位数

Cm（m为自然数）表示定长m个字

通过字符形式表达的值的类型C5表示定长5个字符

符集（字符集默认为GB2312）

C..L11表示长度不确定的文本

string

C..表示确定了最小和最大长度的不C2..10表示最大长度为

定长字符，前面附加最小长度，后面8,最小长度为3的不定长

附加最大长度的字符

text长文本，长度不确定

6共性服务描述模型

6.1共性服务描述模型总体框架

共性服务描述模型的总体框架见图30

kci八性8(势

0Ixtstoefhilic%o(fc务>

务蔓丈名專i«nn/

』鈔中ULtiff•vrnnx

♦KmpyllAJR斯4B1K符11IID

naKclntcrltox•口>

图3共性服务描述模型的总体框架

4

GB/T291912012

共性服务通过基本元素和其包含的子项给出完整的描述。commonService（共性服务）的基本元素

有:serviceENameC服务英文名称）、serviceCName（服务中文名称）、servicelD（服务标识符），见表4。

commonService（共性服务）的四个子项包括服务概要、服务接口、服务质量、服务策略，见表5。

表4commonService（共性服务）的基本元素

最大出

英文名称中文名称数据类型数据格式可选性值域说明

现次数

服务的英文名称，命名规

serviceEName服务英文名称stringM1

则采用LCC方式

serviceCName服务中文名称stringM1服务的中文名称

服务的唯一标识，按照一

定规则组成。

servicelD服务标识符stringC1当服务向注册中心注册

时，注册中心应设定服务

标识

表5commonService（共性服务）的描述项

最大出

英文名称中文名称町选性说明

现次数

服务的简要描述，定义服务所属的类别，服务执行成功的前提

serviceProfile服务概要M1

条件，服务执行的可能结果等;模型的详细描述见6.2

描述服务的调用，表达服务的相关操作及输入和输.'II信息，服

serviceinterface服务接口M1

务部署的访问点，绑定的协议等;模型的详细描述见6.3

描述服务的稳定性和性能，包括可用性、可访问性、可靠性、故

serviceQuality服务质量O1障恢复时间、响应时间、吞吐量、并发性等方面的内容；模型的

详细描述见6.4

包含安全性、事务性、约束等策略.通知服务请求者需要某些补

servicePolicy服务策略O1

充性要求方可成功调用；模型的详细描述见6.5

6.2服务概要

6.2.1服务概要描述模型

服务概要是对服务的简要描述。serviceProfile（服务概要）包含basiclnformation（基本信息）、ser-

viceFunctionC服务功能）、serviceProvide（服务提供者）和information（）fScrviceUpdate（服务更新信息）

等四个描述项。具体定义服务所属的类别，表达服务的关键词、服务提供的功能、服务执行成功的前提

条件、服务执行的可能结果、服务的提供者相关信息以及服务更新信息的地址。服务概要描述模型见

图4。

5

GB/T291912012

图4服务概要描述模型

6.2.2服务概要子项及其元素描述

服务概要包括四个子项：basiclnformation（基本信息）、serviceFunction（服务功能）、serviccProvide

（服务提供者）和informationOfServiceUpdate（服务更新信息），见表6。各子项的元素描述如表7〜

表1C，所示。

表6serviceProfile（服务概要）的描述项

最大出

英文名称中文名称可选性说明

现次数

服务的基本信息，包括服务类别，常用的关键字、版本、

basiclnformation基本信息M1

注册日期等内容

说明服务的功能，包括服务的功能描述，服务执行的前

serviceFunction服务功能M1

提条件和结果

serviceProvide服务提供者01服务提供者的相关信息

informationOf­服务更

01提供服务更新的相关信息

ServiceUpdate新信息

表7basiclnformation（基本信息）的元素

最大出

英文名称中文名称数据类型数据咯式可选性值域说明

现次数

category类别string0N服务的类别

描述服务关键特性的

keyword关键字string0N词，用于服务检索。

如：认证、计费

服务的当前版本。一

version版本stringM1般用vl.0、vl.1、v2.

0•…形式表示

当服务向注册中心注

registerDate注册日期dateYYYYMMDDhhmmssC1册时，注册中心须记录

注册日期

6

GB/T291912012

表8serviceFunction（服务功能）的元素

最大出

英文名称中文名称数据类型数据格式可选性值域说明

现次数

functionDescription功能描述textM1描述服务的功能

执行服务所需的必要

precondition前提条件string0n

条件的描述或标识

服务执行结果的描述

result结果string0n

或标识

表9serviceProviderC服务提供者）的元素

数据数据最大出

英文名称中文名称可选性值域说明

类型格式现次数

name名称stringM1提供服务的机构名称

符合GB11714中的

组织机构由组织机构代码中心

IDstringo1组织机构代码编制

代码分配

规则

contact联系人stringo1联系人的姓名

phone电话stringo1联系人的电话

电子邮件

e-mailstringo1联系人的电子邮件地址

地址

表10informationOfServiceUpdateC服务更新信息）的元素

最大出

英文名称中文名称数据类型数据格式可选性值域说明

现次数

给出可查阅有关服务更新

location位置URIM1信息的网络地址，以URL

方式描述

6.3服务接口

6.3.1服务接口描述模型

servicelnterfaceC服务接口）表达服务执行时在服务提供者和服务请求者之间进行服务交互的接

口。serviceinterface包括多个描述项。从抽象的角度来看，服务由一个或多个接口提供。因此，

interfaceC接口）是serviceinterface的核心描述项,interface和message（消息）给出抽象消息模型，未限

定到特定消息交换协议和通信端点;serviceDcploymentC服务部署）和binding（绑定）将抽象服务限定到

特定协议和通信端点。服务接口描述模型见图5。

7

GB/T291912012

birxinp需世i

MarxixInlcTfins(Ji势樓口TtiirneTSWx^n!^

♦iineftKH•IIitticrfMx:

♦tyz烫・mn£

KT»K3cOcf4；*»TY£lilI

0..11

4*nair»d^*isirr|；

mdPoillWiS)

4

Iini>n|»hrdirv

tfiiettMaII〔iMLttbIIKI

(■(VriUiattlkfl*I

|uippfirinrraaciKvil性｝:bciikwi

£4iQefba：KMiN・De“YtlM礼銳■：$inng|

d・n0.・n0..n

tuuliittJi•検入i■复I

-frtMftdf"冀2『忤+名WTt氓

I”34^:圳小rreyr4vieisic|rTCfky；

图5服务接口描述模型

6.3.2服务接口子项及元素描述

serviceinterface包括以下几个子描述项：interface（接口）、message（消息）、serviceDcployment（服

务部署）＞binding（绑定），见表110

表11servicelnterface（服务接口）的子项

最大出

英文名称中文名称町选性说明

现次数

将与操作相关的消息组织到对应的操作，由此描述了一个服务

interface接口MN

发送和（或）接