配置管理漫漫谈之标识规范

为便于标识、控制和追踪软件开发过程中产生的各种软件项及介质，项目配置管理中一般会遵循特定的文件名称、版本号等规范，为了避免不同项目中规范不一致的情况，软件组织一般都会制定组织的标识规范，作为全组织应遵循的规范和指导原则，以规范管理组织的各种文件与记录。

配置标识是软件配置管理的基础性工作，是管理配置的前提。很难想象缺乏配置项标识的基线管理，如何去区分和定义基线；也很难想象缺乏配置项标识的变更控制，如何去标明版本的变化规迹。

配置标识可以根据项目的实际情况灵活掌握，但有一些基本的原则是需要遵从的：

• 标识唯一：这是为了避免混淆
• 与同类配置项不同的信息，应纳入标识：这是为了便于区分、查找
• 同类配置项的标识方法统一
• 容易记忆：对于经常使用的配置项，标识不宜过长

标识规范按照适用范围可分为项目级和组织级标识规范；按照适用对象可分为文件标识规范、产品标识规范、基准标识规范、基准标识规范，对于部分组织还包括硬件标识规范；按照标识类型可分为名称标识规范和版本号标识规范，部分组织中还定义了编号标识规范。

 

【名称标识规范】

1、文件名称

1)、项目级文件：指项目过程中使用到的文件，如项目管理计划、需求规格说明书、详细设计报告、用户手册等等，项目级文件名称一般包括项目名称(编号、简称)、文件类型、模块名称等，如 项目名称_文件类型_模块名称.扩展名 。

在制定项目级文件编号规范时应充分考虑组织项目中各种文件的共性和特性，使得制定出的规范在各个项目间具备通用性。为使文件名简洁美观，一般会为项目名称、文件类型等组织通用概念设定简称(如使用DDR代替详细设计报告(DetailDesignReport))。

2)、组织级文件：指组织中除项目级文件以外的文件，如各种软件过程等规章制度、组织培训文件等等，组织级文件名称一般包括组织名称(简称)、文件类型、文件名称等，如 组织名称_文件类型_文件名称.扩展名(微软_标准软件过程_项目管理过程.doc)，对于大的组织，组织级文件名称一般包含多种层次，如 微软_标准软件过程_项目管理过程_项目估算指南.doc、微软_中国研究院_服务器软件事业部_行政部_制度_考勤管理制度.doc 。

 

2、产品名称

产品指发布给客户的工作产品，一般为可执行程序、Web应用部署包等。产品名称一般包括组织名称/简称、产品名称、版本信息等，如Microsoft_LiveMessenger_V8.5.exe 、Microsoft_Office_2007_Standard_cn.bin 。

 

3、基准/基线名称

在一个组织中，基准名称一般是固定的，所有项目使用同样的名称进行统一标识。

基准名称的规范制定需要考虑全面性，要充分考虑不同项目、不同业务部门之间的差异，来制定全面的规范供项目裁剪。

 

 

【版本号标识规范】

1、文件版本

文件版本规范提供文件撰写时的版本变更规则。文件版本号并无特别的要求，不过考虑到不断变更的要求，一般考虑无限制进阶式，如下面是典型的文件版本规范：

 

采用[x].[y].[z]的三位格式，[x]、[y]、[z]均为数字

初始版本为1.0.0

[x]:文件大功能/整体架构/用途产生变更时增加

[y]:文件中等规模变更时增加

[z]:文件小规模变更时增加

 

另外的几种常用版本规范是采用日期+流水号(20121212002表示2012年12月12日对该文件的第2此修订)、时间(201012121655表示修订时间为2012年12月12日16时55分修订)、流水号(7表示对该文件的第7此修订)。显而易见典型文件版本规范的优点，不但能标识出版本的唯一性还能一定程度上透露出文件的历史修改幅度。

 

2、产品/代码版本

产品/代码版本规范提供产品/代码的版本变更规则。产品/代码版本规范并无特别的要求，不过和文件版本号规范类似，一般考虑无限制进阶式，如以下是典型的产品/代码版本规范：

 

采用[x].[y].[z]的三位格式，[x]、[y]、[z]均为数字

初始版本为1.0.0

[x]:重大功能变更(比如增加多个模块)/整体架构变更的情况下增加；编号原则上小于10

[y]:新需求/迭代开发/新功能/中等规模功能变更的情况下增加，编号原则上小于10

[z]:修改BUG/小功能的变更/其他小的变更情况下增加，编号原则上小于100

 

一般产品版本与代码版本应该保持一致。

 

对于非正式发布(如内部测试)的产品/代码，一般使用附加日期、附加流水号或者Build号的方法记录，如V1.1.4.20121012。

 

3、基准/基线版本

对于基准/基线版本规范，可参考文件/代码版本规范进行定义，作为基线版本变更的规则。

 

需要注意的是，尽量使文件版本、代码版本和基线版本之间建立一种显而易见的关系以减少另行记录带来的不便。

 

标识规范应作用于整个组织，并由项目配置管理工程师遵循标识规范对工作产品进行标识。配置项标识是一件比较细致的工作，也是配置管理的基础。遵循标识规范是相当必要的，只有这样，才能方便配置项的查找与规类，才能较清晰的看出配置项的状态，给基线控制、变更控制工作的开展创造基础。