文档介绍：应用软件技术规范
实施技术规范的目的与适用范围
通过实施应用软件技术规范使苏州交通系统各类新建和已建的应用软件能够有效地实现资源共享和数据交换,为应用软件可持续、可扩展的开发建设奠定基础,为今后的应用整合做好准备。
本规范适用范围:2010年后新建的应用软件必须实现本规范定义的技术要求,2009年底以前建成的应用软件在今后的升级改造中要实现本规范定义的技术要求,目前在建的软件系统要有条件的实现本规范定义的技术要求。
实施技术规范的目标
本规范实施之后开发的应用软件必须能够实现本方案定义的系统接口、编制本方案规定的数据规范和应用本方案提出的组织结构管理要求。
通过实现统一的接口技术规范,使所有应用软件可以实施统一的管理,使应用软件之间可以进行数据交互;
通过使用特定的XML格式设计的数据规范,使应用软件能够开放数据资源,做到数据内容、服务方式和实现技术的无关性,增强了应用软件开发和组合的灵活性;
通过应用统一的组织结构管理要求执行身份验证和角色分配操作,降低了应用软件建设的复杂性,简化了用户身份的管理工作。
通过实现数据流转功能实现不同应用软件之间的数据共享,实现办事信息通知的发送。
接口技术规范
所有应用软件在底层都可以细分为对数据的增加、删除、修改和查询四项操作,为此对应用软件制定了统一的接口技术规范,明确了写入、读取和查询三项操作。
接口的功能说明
通过调用写入操作让应用软件执行元数据的增加、删除和修改操作。元数据是指应用软件中的最基本数据,如果一个数据被拆开后在整个应用软件中不再具备其他意义,那么这个数据就叫做元数据。元数据以外的其他数据是不会调用写入操作的。
通过调用读取操作获取应用软件中的具体数据。读取操作可以获取元数据或具有固定数据标识和类型的单项数据。
通过调用查询操作检索应用软件中的相关数据。查询操作可以包含大量的查询条件,应用软件将系统中符合条件的数据检索出来后返回给调用方。
接口的参数和返回值说明
写入操作主要参数有:用户标识、应用标识、数据标识、数据类型、符合数据规范格式的XML数据。参数含义如下:
用户标识用UserID表示,使用应用软件接口时首先提供身份验证信息,通过认证后将获取用户标识,在以后的访问中使用UserID表示访问接口的用户身份,结束接口使用必须执行用户标识注销操作。用户标识获取和注销操作参见第五节“身份认证和管理规范”。
应用标识用TaskGuid表示,随着系统整合的实施今后一个应用软件可以包含多项专业应用,通过TaskGuid参数值可以让接口在被调用时能够区分出不同的应用。TaskGuid采用标准的GUID格式,TaskGuid的值由系统建设主管单位统一定义,在数据规范文档中描述,一项应用只能定义一个应用标识。
数据标识用DataGuid表示。每个唯一的数据必须具备一个唯一的标识,使用该标识区分不同的数据。由于数据的增加、删除和修改操作都是以DataGuid作为关键字的,不同的系统都要按照GUID标准统一生成DataGuid,以保证数据在不同的系统和平台中不被其他数据覆盖。
数据类型用DataType表示。每一项数据规范都要定义一个唯一的数据类型,应用软件是按照DataType对应的数据规范解析写入的数据,不同应用的数据类型可以重复。
符合数据规范格式的XML数据用XmlData表示。表示写入的具体数据,如果与数据类型对应的数据标识的元数据不存在,就执行数据增加操作;如果与数据类型对应的数据标识的元数据已存在,就执行数据更新操作;如果XmlData是空值或是没有子节点的XML数据,就将数据标识对应的元数据删除;
写入操作的返回结果表示数据在软件中的写入情况。返回0表示数据写入操作成功,返回-1表示数据格式不符合要求,返回-2表示写入数据的逻辑不对,表示返回-3表示没有数据写入权限,返回其它值可以查询“数据写入操作错误信息”来获取具体含义,查询时使用读取操作,其中TaskGuid参数为应用标识,DataGuid参数固定为"c61ed474-e8b1-4fb4-8975-74b356caa22b",DataType参数为“ErrorList"。返回数据格式统一为:
<Document TaskGuid="应用标识" DataGuid="c61ed474-e8b1-4fb4-8975-74b356caa22b" DataType="ErrorList">
<ErrorInfo Code="错误代码">错误信息描述</ErrorInfo>
<ErrorInfo Code="错误代码">错误信息描述</ErrorInfo>
<ErrorInfo Code="错误代码">错误信息描述</ErrorInfo>
……
</Docu