软件集成规范范例

本标准的目的是说明北京市农业信息技术研究中心项目的产品集成方法，将软件工程活动和管理活动集成为一个协调的、已定义的软件过程，使得各个项目的软件是由组织的标准软件过程裁剪而得，从而达到提高效率，标准统一的目的。

本部分适用于软件系统的集成问题。

2术语和定义

下列术语和定义适用于本标准

系统集成：将不同的信息资源的数据和业务事件互相衔接起来，实现夸越应用系统边界的集成。

信息资源：企业信息的生产/消费者。潜在的信息资源非常广泛，包括数据库，应用系统，包软件等。

事件：通过TCP/IP网络，在适配器和信息中介间交换字描述的结构信息，每个时间都是分类的，一遍互相区别。

系统架构：系统构架是对已确定的需求的技术实现构架、作好规划，运用成套、完整的工具，在规划的步骤下去完成任务。抽象来说，它是计算机系统结构，或称计算机体系结构，是一个系统在其所处环境中最高层次的概念；它确定一台计算机硬件和软件之间的衔接。

3缩略语

下列缩略语适用于本标准

CM（Configuration Management）：配置管理

MA（Measurement and Analysis）：度量分析

API（Application Programming Interface）：应用程序接口

PI（Plant Information System）：系统是一个直观显示企业生产过程的虚拟窗口

UI（UserInterface）：用户接口，系统和用户之间进行交互和信息交换的媒介

PPQA（Process and Product Quality Assurance）：过程与产品质量保证

ECI（Electronic Conversion Interface）：电子转换接口

RD（Research and Development）：需求开发

TS（Technical Solution）：技术解决方案

4系统架构集成规范

4.1集成架构需求

核心业务需求：产品/服务的设计与研发、生产、采购、加工、储运和客户与供应商的管理。

支撑业务需求：物资管理、财务管理、人力资源管理、行政管理、配套服务等。

管控业务需求：全局管控、预算绩效管理、大数据分析、前景预测等。

4.2集成架构组成

系统集成应以核心业务活动为主体，管控业务活动与支撑业务活动为两翼，以满足用户核心需求为标准，构建集成架构。

图1业务流程集成架构图

5代码集成规范

集成系统前的准备工作有CA、MA等，为保证集成系统的事件发生后有正常的反馈，需预先建立TS。集成系统的工作内容包括确立集成顺序、搭建集成环境、设立集成规范、成果验收。软件集成的代码质量决定系统集成的完整度，建立代码集成规范，保证完成质量。

5.1建立集成环境

建立集成环境，在需求开发阶段，应制集成软件或其他资源需求，集成环境通过自身搭建或者购买获得，集成过程中的每一步要按照所要求的的环境包括编译工具，pc模拟工具（在没有可以使用的软件时使用）、硬件设备和IDE。集成换机还包括复用现有的资源。

建立好的集成环境需要经过验证，并且在功能设计完成以后将产品集成环境记录在相应文档内。

5.2建立软件集成准则

建立软件集成规范。软件组件的集成规程包括:要进行的渐进迭代次数、每一步中要执行的测试细节和评价。建立《软件产品集成规范》。

确定产品构件的可接受性标准。建立《软件集成准则》。

对于项目米说，如果在功能设计完成以后，发现组织级的《软件产品集成规程》、《软件产品集成准则》不适合于本项日，则必须参照相应的组织级文档，建立本项目的产品集成规程和准则。

5.3确保接口完整性和兼容性

确保接口的兼容性工作在功能设计完成以后进行。有效地管理软件组件的接口需求、用户说明书和设计有助于确保接口的完整性和兼容性。

接口一旦建立，就必须周期性地审查对接口的描述，以确保该描述与正在开发的软件之间没有偏离。确定接口的类型。必须考虑全部软件组件，通常把接口分成如下3种主要类型:UI,API,ECI。对这些类型的典型分类包括如下:系统，通信，读卡器，PED。

确定每类的接口列表。在确定好接口类型的基础上进一步识别每类接口中的接口。

确定接口与组件和集成环境之间的关系，其中的内容包括，接口的分类、每类接口一-览以及接口与构件和集成环境的对应关系。参见RD PA中的《接口需求列表》。

定期对接口进行评审，确保接口描述的充分性，并且将评审结果记录在《软件集成接口审核表》中。

5.4代码集成规范

为保证集成系统的质量和后期维护对代码集成指定相应规范，在项目集成时需满足代码书写规范，具体项目可对代码书写提高标准。

（1）程序块要采用缩进风格编写，缩进的空格数为4个。

（2）相对的程序块之间、变量说明之后必须加空行。

（3）较长的语句（>80字符）要分成多行书写，长表达式要在低优先级操作符处划分新行，操作符放在新行之首，划分出的新行要进行适当的缩进，使排版整齐，语句可读。

（4）若函数或过程中的参数较长，则要进行适当的划分。

（5）不允许把多个短语句写在一行中，即一行只写一条语句。

（6）if、for、do、while、case、switch、default等语句自占一行，且if、for、do、while等语句的执行语句部分无论多少都要加括号{}。

（7）代码注释文档说明要清晰。

6数据集成规范

所有的集成系统与公共数据库进行对接，以及要考虑到未来的新建系统与数据库的对接，完成与数据中心平台的集成，实现数据互通和共享。

6.1认证集成规范

本期所有的新建系统要与统一身份认证平台进行对接，所有系统的认证都需要归入统一身份认证中。完成与统一身份认证平台的集成，实现校内用户的统一认证、统一权限和单点登录。

使用基础平台提供的统一身份认证接口进行系统改造（包括单点登陆、单点注销、本地认证），本地认证及不影响原有系统登陆的情况下为单点登陆提供新的登陆地址，基础平台提供技术支持，将系统Web应用接入统一门户。

6.2数据同步规范

由基础平台提供数据对接相关数据表结构或视图的说明文档，以表或者视图的方式将共享的结果数据共享出来，基础平台根据标准数据信息项在集成系统数据库中建立数据中间表，基础平台需完成数据同步工作，将中间表数据同步到业务表中。

7其他规范

7.1项目过程规范

1)PPQA:评审PI活动和审计PI的工作产品:评审本过程域的工作产品;确保过程活动遵循所规定的标准和规程;

2)高层经理:高层经理在每月和里程碑处评审PI活动:评审本过程域的工作产品;解决项日经理在实施本过程域中所遇到的无法解决的问题。

3)项目经理:项目经理在每周和里程碑处或事件驱动方式评审PI的活动:评审本过程域的工作产品;向高层经理报告本过程域的实施情况;跟踪工作产品完成情况。