专业文档流程编写规范docWord文件下载.docx
《专业文档流程编写规范docWord文件下载.docx》由会员分享,可在线阅读,更多相关《专业文档流程编写规范docWord文件下载.docx(15页珍藏版)》请在冰豆网上搜索。
放音动作所需的语音文件.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:
流程头部配置参数、宏、函数、全局变量定义区域按先后顺序分开并注释含义。
规则3-3:
流程头部必须注明各种配置参数使用约定。
规则3-4:
在流程头部定义全局变量的同时须明确列出该全局变量的含义及使用方案。
例3:
//***********************全局变量****************************
#declareIRg_nLeaveWordType=0//留言类型0发送留言,1转发留言,2回复留言
#declareIRg_nCanChoose=1//收听用户资料时是否可以按键选择
#declareSRg_sYWBegintime="
"
//当前业务开始时间字符串yyyy-mm-ddhh:
mm:
ss
//**********************Endof全局变量***********************
规则3-5:
流程头部必须有自定义函数功能介绍。
规则3-6:
函数体开始之前必须有传入、传出参数解释,函数返回值解释。
返回值的一般0表示正常,1表示有错,9表示异常退出,4表示转座席、8回主流程、7回上级菜单。
例4:
//*********************************************************
//Functionname:
FormatTxtFile
//Functionusage:
用于将文本文件转换成传真文件
//
//传入参数:
//g_sTxtFileName:
需要转换的文本文件;
//传出参数:
//g_sFaxFileName:
转换后的传真文件名;
//Returned:
0转换成功;
9异常错误;
//厦门建行客服中心
//编写日期:
03/22/2001
规则3-7:
子函数必须有编写/修改日期。
示例参见例4。
规则3-8:
如果有与网关交易部分必须明确收发包格式。
例5:
//**********************************************************
//functionname:
funcTrans282600
//functionusage:
对公业务-修改电话银行密码
0修改成功;
9连接数据库失败
//上传报文:
|282600|9999||帐号|密码|^
//下传报文:
|282600|返回码|^
规则3-9:
注释应与其描述的代码相近,对子函数代码的注释应放在其上方,需与其上面的代码用空行隔开;
对函数中代码的注释应置于右方相邻位置,不可放在下面。
规则3-10:
流程文件中尽量使代码右方注释处于同一列,方便阅读理解。
规则3-11:
流程中重要部分一定要注释。
例如菜单选择后状态跳转。
规则3-12:
涉及数据库操作必须注明实际SQL。
说明:
明确数据库操作目的,方便后期调试、测试核对流程。
例6:
//************查询不得注册用户黑名单(如电话卡用户)*************
funcQueryRegBlacklist
查询主叫号码是否在不得注册用户黑名单(如电话卡用户)
主叫号码$CallerID
无
//Returned:
0表示非黑名单用户1为黑名单用户2为数据库超时
//****************************************************************
funcQueryRegBlackList
{
#declareIRm_nReturn=0//返回值
stWait
[Assigng_sSQL,"
select*fromqq_RegBlacklistwhereF_callerlike'
[StrCatg_sSQL,$CallerID]
[StrCatg_sSQL,"
%'
[ExecSQLg_sSQL]//select*fromqq_RegBlacklist
//whereF_callerlike‘%%’
Passed->
stIsBlacklist
Failed->
stNotBlackList
TimeOut->
stTimeout
stIsBlacklist
[Assignm_nReturn,1]//1表示是黑名单用户
[ClearDTMF]
[SetDTMF"
?
[AssignSR0,MAINPATH]
[StrcatSR0,MAINVOX29]
[PlayFileSR0]//“本用户不能进行注册”
StopPlayBack->
stExit
DialTerminate->
Failed->
stNotBlackList
[Assignm_nReturn,0]//0表示非黑名单用户
->
stTimeout
[Assignm_nReturn,2]//2表示数据库超时
stExit
[Returnm_nReturn]
}
//************Endof查询不得注册用户黑名单***************
规则3-13:
播放语音必须注释放音实际文字。
便于核对流程,以及方便阅读,以及语音文件遗失情况下恢复
例7:
stBegin
[ClearDTMF]
12"
[AssignSR0,INCARDPATH]
[StrcatSR0,REGINPUTVOX1]//请输入您的个人资料,男生按1,女生按2
[PlayFileSR0]
stSelectSex//选择性别
stSelectSex
Failed->
规则3-14:
在流程中使用到全局变量必须注释用途含义,保持全局变量含义统一,避免在另外一处改变其含义。
例8:
stPromptUserType1
[Assigng_nUserType,1]//用户权限为1级管理员
[AssignSR1,PROMPTUSERTYPEPATH]
[StrcatSR1,PROMPTUSERTYPE1]//您好,您是本聊天室的1级管理员
[PlayFileSR1]
stExit0
规则3-15:
边写代码边注释,修改代码同时修改相应注释,以保证注释与代码一致性。
没用的注释要及时删除。
规则3-16:
注释内容要清楚、明了,含义准确,防止二义性。
规则3-17:
避免在注释中使用缩写,特别是非常用缩写
在使用缩写时或之前,应对缩写进行必要说明。
建议3-1:
通过对函数或状态、变量等正确命名,使流程代码成为自注释的。
3.4命名
规则4-1:
状态、变量、函数命名只能使用英文字母、下划线以及数字的组合。
应当尽量使用常规的英文或英文缩写,避免使用无法阅读理解的命名方式。
规则4-2:
配置文件参数,如果是字符串string类型的以“@s”做为前缀;
如果是整数int类型的则以“@n”做为前缀。
例9:
规则4-3:
宏定义必须全部大写。
示例参见上面例1中的宏定义。
规则4-4:
全局变量命名参见规则5-1“全局变量命名”。
规则4-5:
局部变量命名参见规则5-2“局部变量命名”。
规则4-6:
状态命名参见规则6-1“状态命名约定”。
规则4-7:
函数命名参见规则7-2“主函数命名”、规则7-4、规则7-5“自定义子函数命名”、规则7-6“自定义例外处理函数命名”。
规则4-8:
命名要清晰、明了,有明确含义,同时使用完整的单词或大家基本可以理解的缩写。
较短的单词可通过去掉元音形成缩写,较长的单词可取单词的头几个字母形成缩写,单词的第一个字母大写。
一些单词有大家公认的缩写。
例10:
如下单词的缩写能够被大家基本认可。
Send可缩写为Snd;
Receive可缩写为Rcv
temp可缩写为Tmp;
flag可缩写为Flg;
statistic可缩写为Stat;
status可缩写为Sta;
message可缩写为Msg;
规则4-9:
命名中若使用特殊约定或缩写,则要有注释说明。
规则4-10:
用正确的反义词组命名具有互斥意义的变量或相反动作的函数等。
例11:
begin/endcreate/destroyinsert/deleteput/getmin/max等。
3.5变量
规则5-1:
全局变量命名要以g_开头(g表示global),如果是字符串类型的则为g_s做前缀,如果是整型的则以g_n做前缀,如果是浮点型的则以g_f做前缀。
例12:
#declareFRg_fMyMoney=10.5
#declareIRg_nCount
规则5-2:
局部变量命名要以m_为前缀(m表示member),如果SR类型的则为m_s做前缀,如果是IR类型的则以m_n做前缀。
例13:
#declareSRm_sAstring="
#declareFRm_fMyMoney=10.5
#declareIRm_nCount
规则5-3:
全局变量定义区域参见规则2-3“流程头部配置参数、宏、函数、全局变量定义区域”,示例参见例1。
规则5-4:
参见规则3-4“在流程头部定义全局变量的同时须明确列出该全局变量的含义及使用方案”。
规则5-5:
变量命名尽量符合该变量实际含义。
规则5-6:
去掉没有必要的全局变量,函数内部尽量使用局部变量。
全局变量是增大模块间耦合的原因之一,故应减少没必要的全局变量以降低耦合度。
规则5-7:
在流程开头仔细定义并明确全局变量的含义、作用、取值范围及全局变量间的关系。
规则5-8:
当向全局变量传递数据时,要十分小心,防止赋予不合理的值或越界等现象
当向全局变量传递数据时,应进行合法性检查,并在该行对变量含义做注释说明。
规则5-9:
寄存器变量使用一般作为IVR系统函数传递参数/返回值使用。
流程内部自定义函数不推荐使用寄存器变量。
除了动作返回值等不得不使用寄存器变量的情况外,一律不使用寄存器变量,用自定义变量代替。
规则5-10:
参见规则3-14“在流程中使用到全局变量必须注释用途含义,保持全局变量含义统一,避免在另外一处改变其含义”。
规则5-11:
防止局部变量与全局变量同名。
规则5-12:
严禁使用未经初始化的变量作为赋值。
建议5-1:
建议不使用IR0或者SR0作为后续状态的变量,特别的,如果要超过3个状态后仍然需要使用当前IR0或SR0的值,先把IR0或SR0赋值给其他变量中保存。
3.6状态
规则6-1:
状态命名约定以“st”开头,第三个字母大写表示实际有含义的名称开始。
例14:
Connect->
stGetTime
stGetTime
[NowTime]
[Assignm_sTime,SR0]
规则6-2:
函数中以状态stWait开始,以状态stExit结束。
示例参见下面例15、例17。
规则6-3:
状态跳转为事件所驱动。
3.7函数
规则7-1:
在一个业务流程程序里面只能有一个主函数。
规则7-2:
主函数只能名为main,在开始一个业务流程的时候自动执行。
规则7-3:
在一个业务流程程序里面可以有多个子函数。
规则7-4:
子函数名不能为main。
规则7-5:
自定义子函数除例外处理函数外,命名要以“func”开头,第五个字母大写表示实际有含义的名称开始,尽量表示该函数执行的具体功能、操作。
例15:
//**************************通用聊天过程************************
//functionname:
funcChatProcess
//functionusage:
通用聊天过程
//输入参数:
g_nChatID聊天室编号,g_nChatType加入聊天的方式,g_nQQIdentify加入聊天身份,
//g_nTalkTime聊天时长,g_nIsFullExit当没可说资源时是否退出来,在主题聊天时会用到要退出
//输出参数:
//返回值0正常退出,1对碰中退出,2聊天室编号不存在,3其他错误,4没可说资源的退出
//通用聊天过程
//actionhere.
//**********************Endof通用聊天过程**********************
规则7-6:
流程自定义例外处理函数,以“OnClear_”为前缀。
例16:
#functionOnClear_QQCallOutClear//电话QQ呼出异常处理函数
#functionOnClear_sslwCountTime//三省联网统计互拨时长
规则7-7:
流程中每一层菜单是独立函数,每一个选择项是独立函数。
规则7-8:
在自定义函数开头须注释该函数的功能说明,详细传递参数、返回值的各种含义。
示例参见例15。
规则7-9:
传入、传出参数尽量使用自定义全局变量,除系统规定外不推荐使用寄存器。
承担函数传递参数的全局变量命名要符合变量命名规则。
规则7-10:
子函数返回值约定,通常约定返回值0表示成功,其他值表示其他不成功原因。
目前已经形成的一些基本约定
A,Returened(9)表示出错需要主动退出流程,如资源分配失败/放音失败等
B,Returened(8)表示需要回到主流程
C,Returened(7)表示只需回到上层菜单
D,Returened(4)表示转坐席后退出
E,其他返回值暂定回到上一级菜单
F,每个函数后都需要处理Returned(-1)事件
例17:
//连接坐席
funcConnectAgent
#declareIRm_nReturnedCode//标识子函数退出状态
:
[Equalg_nData,0]//判断传入参数
->
stStar
stStar
//actionhere.
//…
stSuccess
[Assignm_nReturnedCode,0]//正常连接坐席成功
stAgentExit
[Assignm_nReturnedCode,4]//转坐席后退出
s