[流程管理]流程编写规范

Software Project Management Standards

SUNTEK R&D SPMS （流程管理)流程编写规范

IVR流程编写规范

IVRCodingStandard

编制单位：新太科技技术开发中心

编制时间：2004/2/20

文档编号：SPMS-SEP-12

版本号：内部试用版

变更记录

A-ADDED M-MODIFIED D-DELETED

目录

1.目的4

2.说明4

3.流程规范4

3.1组织结构4

3.2排版4

3.3注释6

3.4命名11

3.5变量12

3.6状态13

3.7函数14

3.8流程动作基本约定18

1.目的

本部分编写规范适用于新太IPS流程编写。

2.说明

本规范作为壹个标准的IPS流程编写规范，其中对于规则是必须遵守的，建议是提醒您需要注意的地方，或者是于该情况下壹个较好的选择。

3.流程规范

3.1组织结构

规则1-1：于流程文件存放的根目录下，只能有.sc、.cod、.ini文件。其他的文件，按所属业务不同存放于不同的目录下，保持流程的根目录清洁。

建议1-1：不同类型文件按类型分目录存放，原则是要类型分明，便于管理，便于过期删除，目录下文件如果有无限增长的趋势，请按壹定规则（例如日期）分目录存放。

建议1-2：放音动作所需的语音文件.vox/.v41文件，于./vox/目录存放；流程图等文档说明于./doc/目录下存放。

3.2排版

规则2-1：流程中各状态块间保留1行空行。

规则2-2：函数之间保留3行空行。

规则2-3：流程头部配置参数、宏、函数、全局变量定义区域按先后顺序分开且注释含义，便于查找。

例1：

//*************************************************************

//流程配置参数定义

//*************************************************************

#iniparamstring@sAgentStartTime//座席开始服务时间

#iniparamstring@sAgentStopTime//座席结束服务时间

#iniparamstring@sCurrencyFaxFile//货币代码传真文件

#iniparamint@nMaxTalkRecs//系统最大的可说资源数

//************************Endof配置文件***********************

//*************************************************************

//流程宏定义

//*************************************************************

#defineINPUTERRLIMIT3//输入错误次数限制

#defineACCOUTLENGTH23//账号长度（最长）

#defineMAINPATH".\\sysvox\\"//主函数语音文件根目录

#defineMAINVOX1"NQQWel.vox"//您好，QQ现已开通千里音缘服务#defineMAINVOX2"NQQCity.vox"//千里音缘目前已开放四川、海南俩地//************************Endof宏定义***********************

//*************************************************************

//流程函数定义

//*************************************************************

#functionmain//主函数

#functionOnClear_QQCallOut//异常处理函数

//************************Endof函数定义***********************

//*************************************************************

//流程全局变量定义

//*************************************************************

#declareSRg_sAstring="Thisisastring"//壹个全局使用的数据串

#declareFRg_fMyMoney=10.5//壹个全局使用浮点数，表示金额

#declareIRg_nCount//整型全局变量表示数目

//************************Endof全局变量***********************

规则2-4：使用不同编辑工具时，要求定义Tab键为4个空格位（不要用空格填充）。

规则2-5：函数体里状态左缩进壹个Tab键，保持左对齐，该状态下的动作、事件语句左缩进壹个Tab键，保持左对齐。

规则2-6：流程动作语句中，“[”符号右边保留壹个空格；“]”符号左边保留壹个空格；流程动作中参数分隔符“,”右边保留壹个空格。

规则2-7：流程动作语句中，状态跳转符号“->”之前至少要保留壹个TAB 键（最好同壹个状态下的所有->符号均对齐），“->”之后要保留壹个空格。

例2：

:stNationalQQCallIn//外省用户呼入

[Strsub$CallerID,1,2]

[EqualSR0,"13"]

Passed->stLocalQQNormal//本地用户

Failed->stNationalQQCall//外地用户

规则2-8：iniparam，define，declare等定义时，第二个参数和第三个参数之间用壹个或者多个Tab键间隔开，以对齐美观为准。示例参见上面例1。

3.3注释

规则3-1：壹般情况下，源程序有效注释量必须于20%之上。

说明：注释的原则是有助于对程序的阅读理解，于该加的地方均加了，注释不宜太多也不能太少，注释语言必须准确、易懂、简洁。

规则3-2：流程头部配置参数、宏、函数、全局变量定义区域按先后顺序分开且注释含义。示例参见上面例1。

规则3-3：流程头部必须注明各种配置参数使用约定。

规则3-4：于流程头部定义全局变量的同时须明确列出该全局变量的含义及使用方案。

例3：

//***********************全局变量****************************