流程编写规范参考手册

附录B流程编写规范参考手册B1娱音在线业务语音文件的命名规则和目录结构考虑到娱音在线业务在用户量增大后，留言、录音文件的存放需要适当分布开，否则一个目录下，录音文件太多，会导致系统异常缓慢等现象，甚至出现错误。所以提出娱音在线业务和录音相关的语音文件命名规则以及目录结构规则。1文件命名11用户自我介绍文件命名规则用户IDVOX例如7000001VOX12用户给用户的留言命名规则YYYYMMDDHHMMSS留言者IDTO接收留言者IDVOX例如200311201534127000001TO7000002VOX13用户给BBS论坛留言命名规则YYYYMMDDHHMMSS留言者IDTOBBSNVOX，其中N为多个论坛时的论坛编号。例如200311201534127000003TOBBS1VOX14收藏夹文件命名规则原文件名F收藏者IDVOX例如200311201534127000003TOBBS1F5000001VOX2文件路径规则11用户自我介绍文件路径映射盘SPID节目号VOXUSERRECABAB为0099，和ID号最后两位对应例如Z00801258680VOXUSERREC00Z00801258680VOXUSERREC01Z00801258680VOXUSERREC995000123VOX文件就存放在Z00801258680VOXUSERREC23目录中12用户给用户留言文件的路径规则映射盘SPID节目号VOXUSERMSGMMDD其中MMDD代表月份和日子如Z00801258680VOXUSERMSG0101Z00801258680VOXUSERMSG0102Z00801258680VOXUSERMSG1231200311201534127000001TO7000002VOX文件存放在Z00801258680VOXUSERMSG1120目录下。13用户给BBS论坛留言文件的路径规则映射盘SPID节目号VOXBBSMSGMMDD其中MMDD代表月份和日子如Z00801258680VOXBBSMSG0101Z00801258680VOXBBSMSG0102Z00801258680VOXBBSMSG1231200311201534127000003TOBBS1VOX文件存放在Z00801258680VOXBBSMSG1120目录下。14收藏夹文件存放路径规则映射盘SPID节目号VOXFAVMSGABAB为0099，和ID号最后两位对应如Z00801258680VOXFAVMSG00Z00801258680VOXFAVMSG01Z00801258680VOXFAVMSG99200311201534127000003TOBBS1F5000001VOX文件存放在Z00801258680VOXFAVMSG01目录下。B2关于寄存器的使用为了规范流程开发，统一寄存器在流程中的使用，便于编写和维护流程脚本，现将系统提供的寄存器做如下推荐使用规定。寄存器使用说明备注SR10主叫用户手机号SR9主叫用户ID号码SR8/IR8用户性别SR7/IR7用户年龄SR6/IR6用户性格SR5/IR5用户交友目的SR4用户个人档案语音文件绝对路径SR3留言语音文件绝对路径（用户间留言、BBS发言、收藏夹）SR2/IR2结果集总数SR1/IR1结果集序号SR0语音播放路径（系统提示音）SR20被叫用户手机号SR19被叫用户ID号码SR18SR11临时使用，用于字符串连接、比较、转换等操作SR30SR21临时使用，用于字符串连接、比较、转换等操作SR40SR31日期和时间相关SR50SR41短信内容相关SR63SR51预留推荐IR0IR63配合SR0SR63使用，使它们的含义尽量统一。B3FUN_FINDFRIENDTXT/SP名称业务名称之子流程/函数名称子流程/子函数例如新浪缘分天空之寻找聊友子流程/函数名称FUN_FINDFRIEND/参数输入_FIELD1参数说明输出_FIELD1参数说明返回值0正常返回1异常返回/寄存器SR20主叫用户IDSR21被叫用户IDSR22/IR22用户性别SR23/IR23用户年龄SR24/IR24用户性格SR25/IR25交友目的SR26个人介绍文件名SR27/IR27结果集总数SR28/IR28结果集序号SR30系统提示音播放绝对路径不含文件名称/宏定义DEFINEDATAACCESS_TIMEOUT20000DEFINESUCCESS0DEFINEEXCEPTION1DEFINEFIND_FRIEND“00201“/查找朋友总数和信息/调用通用子函数/无/调用私用子函数INCLUDEFUN_CALLUSER/加载呼叫对方子流程TRACEONFUNCTIONFUN_FINDFRIENDBEGINEVTSTART0/一般是SASSIGN操作,把传入参数存放寄存器SR中STWELCOMESTWELCOMEREADSTRFROMINI_INIFILENAME,“PATHVOXPATH“,SR30SASSIGNSR0,SR30SADDSR0,“WELCOMEVOX“PLAYFILESR0,“EVTRETURN0STINPUTSEXEVTRETURN3STINPUTSEXEVTRETURN1STFINDFRIENDEXCEPTSTINPUTSEXSASSIGNSR0,SR30SADDSR0,“SEXVOX“/请输入性别PLAYFILESR0,“EVTRETURN0STGETSEXEVTRETURN3STGETSEXEVTRETURN1STFINDFRIENDEXCEPTSTGETSEXGETDIGITS1,5,“EVTRETURN0STCHECKSEXEVTRETURN4STINPUTSEXEVTRETURN1STFINDFRIENDEXCEPTSTCHECKSEXSASSIGNSR22,_EVENTDATA/保存性别信息CHECKPUSHEDBUTTONEVTRETURN1STFINDFRIENDBEGINEVTRETURN2STFINDFRIENDBEGINEVTRETURN1STINPUTSEXSTFINDFRIENDBEGIN/访问SP数据库时,推荐使用下列格式SASSIGN_OPERATEID,FIND_FRIENDIASSIGN_FIELDNUM,2SASSIGN_FIELD1,_USERIDSASSIGN_FIELD2,SR22DATAACCESS0,0,DATAACCESS_TIMEOUTEVTRETURN0/访问SP数据库成功SASSIGNSR21,_FIELD1STCALLFRIEND/可以有其他返回值在接口文档中定义EVTRETURN1STFINDFRIENDEXCEPTEVTTIMEREXPIRED1STFINDFRIENDEXCEPTSTCALLFRIENDFUN_CALLUSEREVTRETURN0/呼叫聊友成功IASSIGN_RESULT,SUCCESSENDEVTRETURN1/呼叫聊友失败IASSIGN_RESULT,EXCEPTIONENDSTFINDFRIENDEXCEPTSASSIGNSR0,SR30SADDSR0,“SYSBUSYVOX“PLAYFILESR0,“/“很抱歉,系统正忙,请稍后“EVTRETURN1IASSIGN_RESULT,EXCEPTIONEND/结束此流程,返回到调用函数B412586XY12590XYABINI配置文件模板配置文件命名规则接入号INI说明XY移动分配给各SP的标识AB音信互动业务接入号的后两位SP自定注意等号左边一律大写PATHSYSTIPZ00XY12586XYVOXSYSTEM/系统提示语音文件路径SYSTIPZ00XY12590XYABVOXSYSTEMUSERRECZ00XY12586XYVOXUSERREC/用户个人档案语音文件路径STORYZ00XY12590XYABVOXSTORYUSERMSGZ00XY12586XYVOXUSERMSG/用户给用户留言语音文件路径NEWSZ00XY12590XYABVOXNEWSBBSMSGZ00XY12586XYVOXUSERMSG/用户在BBS留言语音文件路径JOKEZ00XY12590XYABVOXJOKEINFOSPID00XY/注意此值要写成4位CALLEDNUMBER12586XY/接入号CALLEDNUMBER12590XYABSERVICEID86000/对于86业务统一使用“86000“SERVICEID000AB/对于90业务，一个业务内要统一，采用“000接入号后两位“规则CALLOUTPREFIX99986XY01/86业务系统外呼字冠CALLOUTPREFIX990XYAB01/90业务系统外呼字冠CALLOUTIVRFLOWNUM4/外呼流程对应的FLOWIDB5关于BILLBEGIN的说明BILLBEGINSTRING,STRING,INT参数1字符串类型，接入号码参数2字符串类型，子业务号参数3整型，计费代码功能计费开始返回结果无原来的考虑是当有点送类外呼业务时，外呼业务开始计费时，主叫号码填入接入号，如“125908812”，子业务号填入点送用户的手机号码如，后来因为移动政策不对点送用户额外收取点送成功的费用，因此子业务号一直没有用上。计费代码一直作为预留参数，没有用上。建议在参数说明中，2，3项的说明为计费参数1，计费参数2。将来有用时再作统一规定和说明。建议在流程编写时分别填入”0”和0。以备将来扩充。其他说明现在原始话单的格式是SP接入号计费代码子业务号局向号码主叫号码被叫号码开始时间结束时间其中前3项和BILLBEGIN的前三项一一对应，“计费代码”和“子业务号”两项现在在批价时都没有用到，关于呼入呼出的判断现根据主叫号码头两位是否是“12”来判断是不是呼出。B6关于GETDIGITSTXT例如GITDIGITS8,5,“1如果用户输入123，那么_EVENTDATA中存放的值为123，没有问题2如果用户直接输入，那么_EVENTDATA中存放的值为3如果用户输入，那么_EVENTDATA中存放的值为4如果用户输入，那么_EVENTDATA中存放的值为“空5如果用户输入，那么_EVENTDATA中存放的值为“空6如果用户输入123，那么_EVENTDATA中存放的值为1237如果用户输入123，那么_EVENTDATA中存放的值为1237如果用户输入123，那么_EVENTDATA中存放的值为123B7批量转换WAVVOX脚本文件HISUNCONVCO