2012年10月

1 深圳市交委数字交通系统概述

目前在用的数字交通系统是一个依托于深圳市数字业务综合处理平台，包含了数字路桥和交运通等综合信息系统。为保证系统的稳定高效运行、切实提高办事效率和对外服务水平，需要做好完善的系统及接口的维护升级预案。

2 数据交换接口维护开发

2.1　概述

由于数据的交换是运行Internet的环境上，所以对数据安全性要求比较高，局与交委的通讯交换是当前流利通讯标准SOAP协议来通讯，并把SOAP构架于Http传输协议之上，数据用XML来表示，保证系统的跨平台的能力。并通过WS*标准来扩展安全性和传输的可靠性，在局与交委之间各部署了一套Web 服务器，在Web服务上部署了一系列的Web Service来通讯。

本系统在传输及其安全性对于各单位的开发业务系统都是透明，按现有的开发接口标准，在本地来对消息的接收以及发送，保证消息的传送是安全和可靠的。

2.2 开发接口

开发接口可分为：接口管理器、消息接收和消息发送三部分。

1）、接口管理器：包括对消息的监控，连接的安全，接口的配置等功能。

2）、消息接收接口：负责接收消息，并具体实现接口，把接收到的消息与各单位具体的业务挂接起来。

3）、消息发送接口：调用消息发送接口，把之前接收到消息经过内部业务处理后，到处理结果反馈到局。

3.2 数据交换机制

数据接口按数据传输的实时性分为数据实时传输接口和数据批量传输接口。数据实时传输是指数据采集后立即通过传输接口自动将数据传输入库，数据批量传输接口是指通过程序自动或人工启动程序并有相应的设置，把要入库的数据通过整理后入库。数据实时传输方式又可以分为按固定时间间隔传输数据和新数据触发传输数据的方式，新数据触发传输数据的方式是指数据源一旦有新的采集数据，本接口软件能够立即将新数据传输到目的系统中，而当没有新数据时，该接口一直处于待运行状态。

设计数据接口根据实际情况和要求而定，对于那些没有实时性要求的数据和不要求实时传输的数据，我们可以采取批量的方式整理入库；对于有实时性要求的，根据实时性要求的程度和数据的实际状况来设计数据接口。设计的数据接口程序应该可靠、稳定、高效率、易用，还要保证数据的一致性、正确性。

3.3 各程序集基本概述

3.3.1 Topevery.Web.Services程序集

Topevery.Web.Services是本系统的底层功能的封装的类库，在发送消息的时候需要对它的引用。Topevery.Web.Services以NET和COM标准封装，可以在NET里面对本程序集直接引用，也可以在其他以COM标准的开发工具对它以类型库方式导入。

3.3.2 SZUM.DUM.ClientShareToolkit程序集

SZUM.DUM.ClientShareToolkit是本系统的发送消息的具体应用的封装，通过里面ServiceProxy接口来提供的功能对消息发送。

3.3.3 SZUM.DUM.ClientShare程序集

SZUM.DUM.ClientShare是本系统中消息接收和消息发送中的数据实体的封装，以及接收消息接口的定义，在本类库中已经是Web Service接收和发送的XML转换为应用程序可以理解的各个实体库，方便开发应用，提高开发效率。

3.4 具体接口维护开发

3.4.1 数字案件消息接收接口维护

在程序集SZUM.DUM.ClientShare中声明了一个IDataReceiver接口，该接口定义了一个OnDataReceived方法，用于实现接收消息的基本接口，数字交通系统要接收到消息，需要实现该接口，并在服务器中的组件服务中注册，从而实现消息的接收。具体实现可以参考

1）.事件OnDataReceived，当消息到达时，系统会调用在接口管理器中注册的消息接收器，并调用对应接口实现的该方法。

参数：msgData, 类型：object,需要强制转换为在程序集SZUM.DUM.ClientShare中的ClientReceiveData，接收到消息的数据，把接收到的消息以数据实体方式表示。

返回值：类型：bool,表示对消息处理成功（true）与失败(false)。

3.4.2数字案件反馈消息发送接口维护

在程序集SZUM.DUM.ClientShareToolkit中，存在类型ServerProxy接口，该接口定义一个SendClientReportData方法，表示发送回复数据。

1）方法SendClientReportData,表示要发送回复数据。

参数：reportData，类型: ClientReportData。

3.4.3 与交运通案件办理接口的维护

该接口实现与交运通案件办理并实现分发，接口具体包含的属性和方法有：

1）属性Index，类型Int,表示对应索引值，从1开始。

2）属性Operator，类型String，表示操作者。

3）属性OperatorOpinion，类型String，表示经办人意见。

4）属性Stage，类型String，表示环节名称。

5）属性CheckDate，类型DateTime，表示受理时间。

6）属性FinishDate，类型Datetime，表示办结时间。

3.4.4数字交通系统与交运通的接口增加办结功能

该功能用于表示实现数字交通系统与交运通系统之间的案件办结功能，接口所包含的方法和属性有：

1）.属性ID，类型Guid，表示该消息的唯一ID，应用程序要保存该ID。

2）.属性RelationID,类型Guid，表示与该消息相关联的ID。

3）.属性BaseInfo,类型ClientReceiveDataBaseInfo,表示接收到案件的基本数据。

4）.属性Attachments,类型ClientReceiveDataAttachmentCollection,表示附件的集合。

5) .属性WorkflowRecords,类型ClientReceiveWorkflowRecordCollection,表示对应案件办结流程信息集合。

3.4.5数字交通系统与交运通的接口增加案件对账查询

该功能用于表示实现数字交通系统与交运通系统之间的案件对账查询功能，接口所包含的方法和属性有：

1）.属性ID，类型Guid，表示该消息的唯一ID，应用程序要保存该ID。

2）.属性RelationID,类型Guid，表示与该消息相关联的ID。

3）.属性BaseInfo,类型ClientReceiveDataBaseInfo,表示接收到案件查询的基本数据。

4）.属性Attachments,类型ClientReceiveDataAttachmentCollection,表示附件的集合。

5) .属性WorkflowRecords,类型ClientReceiveWorkflowRecordCollection,表示对应案件对账查询流程信息集合。

3.4.6数字交通系统与交运通的接口增加重复案件更新功能

该功能用于表示实现数字交通系统与交运通系统之间的重复案件更新功能，接口所包含的方法和属性有：

1）.属性ID，类型Guid，表示该消息的唯一ID，应用程序要保存该ID。

2）.属性RelationID,类型Guid，表示与该消息相关联的ID。

3）.属性BaseInfo,类型ClientReceiveDataBaseInfo,表示接收到的重复案件的基本数据。

4）.属性Attachments,类型ClientReceiveDataAttachmentCollection,表示附件的集合。

5) .属性WorkflowRecords,类型ClientReceiveWorkflowRecordCollection,表示对应流程信息集合。

3.4.7 数字交通系统中的案件强制办理维护升级

该接口实现与案件强制办理的有关状态同步，包含有：

1)属性AttachmentType，类型ClientReceiveDataAttachmentType（0：表示Image，1：表示Sound），表示附件类型。

2)属性Data，类型Byte数组，包含附件对应的数据。

3)属性AttachmentFileName，类型String，表示状态同步情况。

3.4.8 与数字的数据同步接口

该接口实现与数字的数据同步，包含的方法和属性有：

1）方法Item

返回值，类型ClientReceiveDataAttachment，可以通过Item索引器访问集合里面的数据。

2）属性Count，类型Int,表示返回集合里包含的同步状态等信息。

3.4.9数字与数字路桥系统接口更新开发

在程序集SZUM.DUM.SZLQShare中声明了一个IDataReceiver接口，该接口定义了一个OnDataReceived方法，用于实现从数字路桥系统中派遣案件到数字系统的基本接口，数字系统要接收到案件消息，需要更新开发该接口，并在服务器中的组件服务中注册，从而实现消息的接收。具体实现可以参考

1）.事件OnDataReceived，当消息到达时，系统会调用在接口管理器中注册的消息接收器，并调用对应接口实现的该方法。

参数：msgData, 类型：object,需要强制转换为在程序集SZUM.DUM. SZLQShare中的ClientReceiveData，接收到消息的数据，把接收到的消息以数据实体方式表示。

返回值：类型：bool,表示对消息处理成功（true）与失败(false)。

3.4.10案件重复派遣维护改进

该功能针对系统中存在的案件重复派遣问题；两个案件号处理问题；页面查询不一致的Bug；手动办结案件和案件数据同步等需求提供统一的开发改进，涉及到的接口所包含的方法和属性为：

1）.属性ID，类型Guid，表示该消息的唯一ID，应用程序要保存该ID。

2）.属性RelationID,类型Guid，表示与该消息相关联的ID。

3）.属性BaseInfo,类型ClientReceiveDataBaseInfo,表示接收到案件重复派遣的基本数据。

4）.属性Attachments,类型ClientReceiveDataAttachmentCollection,表示附件的集合。

5) .属性WorkflowRecords,类型ClientReceiveWorkflowRecordCollection,表示对应流程信息集合。下载本文