软件技术规范

1软件技术规范一、实施技术规范的目的与适用范围通过实施应用软件技术规范使苏州交通系统各类新建和已建的应用软件能够有效地实现资源共享和数据交换，为应用软件可持续、可扩展的开发建设奠定基础，为今后的应用整合做好准备。本规范适用范围：2010年后新建的应用软件必须实现本规范定义的技术要求，2009年底以前建成的应用软件在今后的升级改造中要实现本规范定义的技术要求，目前在建的软件系统要有条件的实现本规范定义的技术要求。二、实施技术规范的目标本规范实施之后开发的应用软件必须能够实现本方案定义的系统接口、编制本方案规定的数据规范和应用本方案提出的组织结构管理要求。通过实现统一的接口技术规范，使所有应用软件可以实施统一的管理，使应用软件之间可以进行数据交互；通过使用特定的XML格式设计的数据规范，使应用软件能够开放数据资源，做到数据内容、服务方式和实现技术的无关性，增强了应用软件开发和组合的灵活性；通过应用统一的组织结构管理要求执行身份验证和角色分配操作，降低了应用软件建设的复杂性，简化了用户身份的管理工作。通过实现数据流转功能实现不同应用软件之间的数据共享，实现办事信息通知的发送。三、接口技术规范所有应用软件在底层都可以细分为对数据的增加、删除、修改和查询四项操作，为此对应用软件制定了统一的接口技术规范，明确了写入、读取和查询三项操作。1.接口的功能说明通过调用写入操作让应用软件执行元数据的增加、删除和修改操作。元数据是指应用软件中的最基本数据，如果一个数据被拆开后在整个应用软件中不再具备其他意义，那么这个数据就叫做元数据。元数据以外的其他数据是不会调用写入操作的。通过调用读取操作获取应用软件中的具体数据。读取操作可以获取元数据或具有固定数据标识和类型的单项数据。通过调用查询操作检索应用软件中的相关数据。查询操作可以包含大量的查询条件，应用软件将系统中符合条件的数据检索出来后返回给调用方。2.接口的参数和返回值说明2写入操作主要参数有：用户标识、应用标识、数据标识、数据类型、符合数据规范格式的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。返回数据格式统一为：DocumentTaskGuid=应用标识DataGuid=c61ed474-e8b1-4fb4-8975-74b356caa22bDataType=ErrorListErrorInfoCode=错误代码错误信息描述/ErrorInfoErrorInfoCode=错误代码错误信息描述/ErrorInfoErrorInfoCode=错误代码错误信息描述/ErrorInfo……/Document错误代码要求大于100或小于负100，正负100之间的错误码作为保留值不能使用。读取操作主要参数有：用户标识、应用标识、数据标识和数据类型。参数含义如下：用户标识用UserID表示，具体含义与写入操作参数相同。应用标识用TaskGuid表示，具体含义与写入操作参数相同。数据标识用DataGuid表示，每个唯一的数据必须具备一个唯一的标识，使用该标识区分不同的数据。读取操作中数据标识表示需要读取的唯一数据。数据类型用DataType表示。每一项数据规范都要定义一个唯一的数据类型，应用软件是按照DataType对应3的数据规范生成读取的数据，不同应用的数据类型可以重复。读取操作的返回结果是符合数据规范格式的XML数据。如果对应的数据不存在也必须返回符合数据规范格式并包含所有节点的空数据。返回空值表示无对应数据的读取权限或者是应用软件不支持该类型的数据。查询操作主要参数有：用户标识、应用标识、符合数据规范格式的XML查询命令。参数含义如下：用户标识用UserID表示，具体含义与写入操作参数相同。应用标识用TaskGuid表示，具体含义与写入操作参数相同。符合数据规范格式的XML查询命令用XmlTransform表示。在查询操作中包含需要查询的条件。查询操作的返回结果是符合查询条件的具体数据。大批量数据的返回要实现数据分页的查询操作。即使查询结果没有符合条件的数据也必须返回符合格式的数据，返回空值表示无对应数据的查询权限或者是应用软件不支持对应的查询操作。3.接口的实现方式考虑到不同层面的对接要求系统接口的实现定义了网页、Web服务和Socket三种方式，应用软件至少需要实现其中一种接口方式，具体实现哪几种接口方式，将由建设单位明确。网页方式。该方式是专供JaveScript调用的一种方式，使用浏览器的XMLHttpRequest对象向对应的网页发出请求或发送数据可以调用应用软件的写入、读取和查询操作。写入操作使用“POST”方式将符合数据规范格式的XML字符串发送到提供写入操作的网页上。用户标识、应用标识、数据标识、数据类型等参数通过在网页后面跟上字符串：?UserID=…&TaskGuid=…&DataGuid=…&DataType=…的方式传递，返回值为数值型的字符串。读取操作使用“GET”方法调用提供读取操作的网页。用户标识、应用标识、数据标识和数据类型，等参数通过在网页后面跟上字符串：?UserID=…&TaskGuid=…&DataGuid=…&DataType=…的方式传递，返回值为符合数据规范格式的XML字符串。查询操作使用“POST”方式将符合数据规范格式的XML查询命令发送到提供查询操作的网页上。用户标识、应用标识等参数通过在网页后面跟上字符串：?UserID=…&TaskGuid=…的方式传递，返回值为符合数据规范格式的查询结果字符串。提供写入、读取和查询操作的网页可以通过一个网页文件来完成对应的功能。Web服务方式。该方式是提供给函数方式调用的一种接口，凡是能够支持Web服务调用的软件都可以使用这种接口调用应用软件的写入、读取和查询操作。Web服务必须遵循附件一的WSDL定义，实现下面三个函数：写入操作调用Web服务的SetData函数，参数按照函数的方式传递，返回值为数值型。函数原型如下：SetData(UserIDAsstring,TaskGuidAsstring,DataGuidAsstring,DataTypeAsstring,XmlDataAsstring)Asint读取操作调用Web服务的GetData函数，参数按照函数的方式传递，返回值为符合数据规范格式的XML字符串。函数原型如下：4GetData(UserIDAsstring,TaskGuidAsstring,DataGuidAsstring,DataTypeAsstring)Asstring查询操作调用Web服务的TransformData函数，参数按照函数的方式传递，返回值为符合数据规范格式的查询结果字符串。函数原型如下：TransformData(UserIDAsstring,TaskGuidAsstring,XmlTransformAsstring)AsstringSocket方式。该方式是采用通讯端口方式进行操作的接口。通过向通讯端口发送指定格式的数据实现对应用软件的写入、读取和查询操作。写入操作发送如下格式的数据到通讯端口：CommandSystemName=系统名称Type=SetDataUserID用户标识/UserIDTaskGuid应用标识/TaskGuidDataGuid数据标识/DataGuidDataType数据类型/DataTypeXmlData……//符合数据规范格式的XML数据/XmlData/Command返回值是数值型的字符串。读取操作发送如下格式的数据到通讯端口：CommandSystemName=系统名称Type=GetDataUserID用户标识/UserIDTaskGuid应用标识/TaskGuidDataGuid数据标识/DataGuidDataType数据类型/DataType/Command返回值是符合数据规范格式的字符串。查询操作发送如下格式的数据到通讯端口：CommandSystemName=系统名称Type=TransformDataUserID用户标识/UserIDTaskGuid应用标识/TaskGuidXmlTransform……//符合数据规范格式的XML查询命令/XmlTransform/Command返回值是符合数据规范格式的查询结果字符串。4.批量数据处理由于系统接口采用XML作为传输数据的格式，在实际应用中发现传输数据的时间要比处理数据的时间大很多，在大数据交互应用中如果每个写入、读取和查询操作只写入或反馈一个数据将会大大影响系统效率，为此定义了批量数据处理方式来满足大数据量应用的要求。5批量数据以Documents作为根节点，内含一组符合数据规范的Document子节点。数据格式如下：DocumentsDocumentTaskGuid=应用标识DataGuid=数据标识DataType=数据类型……/Document……/Documents写入操作中使用批量数据表示对数据中的每个Document都执行一次独立的写入操作，写入每个Document时使用其包含的应用标识、数据标识和数据类型代替TaskGuid、DataGuid和DataType参数，批量写入操作中提供的这三个参数忽略。读取和查询操作中使用批量数据可以根据实际逻辑定义批量数据反馈格式。四、数据格式规范要想让同一种数据在不同的软件接口中使用，必须让数据遵循共同的描述方式，为了让数据通俗易懂便于计算机处理和人理解特采用XML格式作为所有数据的标准格式，按照特定的XML格式定义的数据描述称做数据规范。采用数据规范后应用软件的功能实现就具备一定的灵活性数据规范在应用软件接口中涉及写入和读取操作中的“XML数据”，查询操作中的“XML查询命令”和“XML查询结果”。大型应用软件的数据规范聘请专业单位进行独立设计，小型应用软件的数据规范由软件开发单位负责设计。1.数据规范