IPSWITCH平台业务流程的编写讲义

1、IPSWITCH平台业务流程的编写主讲：谢枚彤目录2实现流程程的模块块流程源文文件的结结构数据类型型动作流程的配配置文件件业务流程程的配置置IPSWITCH平台业务务流程主要由IVR模块实现现相关模块块：ACDAAASERVERDBAccessGATEWAY流程源文文件的构构成. 主文文件文本的主主文件（.sc为后缀）文件头说说明主程序体体图形化的的主文件件（.frm为后缀）. 头文文件IPSWITCH平台流程程语言结结构#include 包含含头文件件说明#define宏宏定义说说明例：文件头中中说明#definePromptThanks2000主程序体体中PROMPTPrompThanks

2、等价于PROMPT2000#iniparam配配置参参数常量量说明例：头文件中中#iniparamSTRINGUserData主程序体体中ASSIGNSR9,UserData配置文件件（后缀缀为.ini）中ParametersUserData=12345则，主程程序体中中该语句句等价于于ASSIGNSR9,”12345”#function函函数说明明主文件文件头说说明它通常是是一组函函数定义义的系列列，每一一函数定定义可描描述如下下：函数名：状态1动作a1参数动作an参数事件e1状态s1事件e2状态s2N事件en状态sn动作a1参数M动作am参数：状态2同上：状态m函数定义义系列中中的第一一个

3、函数数必须是是主函数数（main）主文件主程序体体IPSWITCH平台流程程语言结结构简单的主主文件(.SC)，可编译通通过#functionmainmain:stWaitConnect-stPlay:stPlayPLAYFILE“welcome.vox”StopPlayBack-stExitDialTerminate-stExitFailed-stExitTimeOut-stExit:stExitReturn 0头文件文件头说说明#include 说明包包含另外外一个头头文件#define说明明定义一一个宏#iniparam说说明一个个配置参参数常量量#function说明明一个函函数IPS

4、WITCH平台流程程语言结结构流程的启启动与结结束开始状态态：stWait在stWait状态下以以Connect事件启动动流程结束状态态：stExit在stExit状态下以以Return0动作结束束流程IPSWITCH流程语言言的数据据类型有有三种：整型字串型浮点数型型数据类型型常量整型常量量字串型常常量浮点型常常量宏定义常常量配置参数数常量变 量寄存器变变量整型寄存存器：IR0IR29字串型寄寄存器：SR0SR29FD0FD29浮点型寄寄存器：FR0FR29系统变量量与流程相相关的系系统变量量。如：$ServiceType、$FlowType、 $InputParam、$OutputPara

5、m。与呼叫相相关的系系统变量量。如：$CallerID、$CalledID、$Device1、$Device2。与数据库库访问相相关的系系统变量量。如：$DBKey1、$DBRecCount。与认证计计费相关关的系统统变量。如：$AccountID、$Passwor、$ServiceItemNo变 量共享变量量共享变量量是在同同一台IVR中共用的的变量，用于同同一IVR中流程之之间的通通讯。流流程结束束后，变变量的值值仍然保保存着。变 量注 释/单单行注注释/*/多多行注注释动 作数字运算算动作字符串运运算动作作数据类型型转换动动作比较判断断转移动动作媒体操作作动作呼叫控制制动作数据库访访问动

6、作作计费与认认证动作作文件操作作动作系统操作作动作流程间通通信动作作邮箱管理理动作设置例外外处理函函数动作作其他动作作数字运算算动作AssignI1，I2AssignF1，I2AssignF1，F2AssignS1，S2incI1decI1addI1，I2addF1，I2addF1，F2subI1 ，I2subF1，I2subF1，F2mulI1，I2mulF1，I2mulF1，F2divF1，I2divF1，F2数字运算算动作idivI1，I2/把I1整除I2的值赋给给变量I1modI1，I2/把I1整除I2的余值赋赋给变量量I1IntRandI1/产生一个个0(I1-1)的随机整整数，结结

7、果存于于IR0中FloatRandI1I2/产生一个个0I1之间的随随机浮点点数，精精确到小数点后后I2位。结果果存于FR0中数字运算算动作StrSubS1，I1，I2StrCatS1，S2StrLenS1StrUpperS1StrLowerS1StrStrS1，S2字串运算算动作字串运算算动作ParseParamS1，I1，S2例如：S1=”param1$param2$param3$param4”S2=”$”ParseParamS1,2,”$”取出第二二个参数数param2。StrLTrimS1StrRTrimS1StrTrimS1时间操作作动作NowTimeTimeAddI1，I2，I3把

8、I1表示的时时间按I2指定的类类型，增增加I3的值，结结束存放放在I1I2类型：1（秒）、2（分）、3（小小时）、4（天天）、5（月）、6（年）TimeDifI1，I2，I3按I3的类型，计算I1，I2分别表示示的时间间的差值值，结果果存于IR0中I3类型：1（秒）、2（分）、3（小小时）、4（天天）、5（月）、6（年）7（星期期）时间操作作动作TimePartI1，I2按I2指定的类类型，取取I1表示的时时间的相相应部分分，结果果存于IR0中。I2类型：1（秒）、2（分）、3（小小时）、4（天天）、5（月）、6（年）、7（星期）MakeDateI1，I2，I3把I1作为年份份，I2为月份，I

9、3作为日期期生成一一个整数数表示的的时间，(时分秒秒为缺省省值)，结果存存于IR0中。无效效日期返返回-1。MakeTimeI1，I2，I3把I1作为小时时数，I2为分钟数数，I3为秒数生生成一个个整数表表示的时时间，结果存于于IR0中。(年年月日为为缺省值值)无无效时间间返回-1。时间操作作动作数据类型型转换动动作itosI1stoiS1TimeToStrI1，S2StrToTimeS1ftosF1，I2stofS1EqualI1，I2EqualS1，S2EqualF1，F2，I3GreatS1，S2GreatF1，F2Less S1，S2Less F1，F2以上的几几种比较较动作都都将产生

10、生以下两两个事件件之一：Passed成立Failed不成立比较判断断转移动动作Case I1根据I1的值转移移到不同同的状态态执行，它产生生一个Case（参数）的的事事件，对这这一事件件处理分分别迁移移到不同同的状态态即可实实现了多多分支程程序的设计。比较判断断转移动动作SetDTMFS1设置响应应的拨号号“？”表表示所有有按键均均可响应应(缺省省)“D”表示09的数数字按键键均可响响应“d”表示19的数数字按键键均可响响应“”表示示所有键键均不响响应。媒体操作作动作SetRecInitI1SetPlayInitI1SetIntrDigI1设置拨号号的时间间间隔(单位为为秒)，即用户户如果在在

11、按了一一个键后后在给 定时时间内未未按下一一个键则则收号过过程结束束（产生生TimeOut事件），缺省值为为5秒。媒体操作作动作SetMaxSilI1设置录音音过程中中的最大大静音时时长为I1秒。即在在录音过过程中如如果出现现了给定时长的的静音时时间，则则录音过过程结束束（产生生Record事件），缺省为为5秒。SetLangI1设置播放放提示音音、合成成音的语语种：I1=1：普通话（缺省）I1=2：本地方言言I1=3：英语媒体操作作动作PromptI1播放第I1段提示音音，产生生以下事事件：StopPlayBack正常放音音结束DialTerminate放音被按按键打断断Failed失败LP

12、romptI1，I2，I3根据语种种的值选选择播放放I1，I2，I3的提示音音，产生生以下事事件：StopPlayBack正常放音音结束DialTerminate放音被按按键打断断Failed失败媒体操作作动作媒体操作作动作MixPlayI1，S1根据语种种自动合合成语音音播放。I1为合成的的格式：1（金金额）、2整数）、3（字符）、4（日期时时间）、5（小小数）结束时产产生以下下事件：StopPlayBack正常放音音结束DialTerminate放音被按按键打断断Failed失败PlayFileS1播放语音音文件，S1为文件名名。结束时产产生以下下事件：StopPlayBack正常放音音结

13、束DialTerminate放音被按按键打断断Failed失败（一一般为文文件不存存在）媒体操作作动作ClrMixerAddPromptToMixerI1，I2，I3AddStrToMixerI1，S2AddIntToMixerI1AddTimeToMixerI1，S2AddFloatToMixerF1，I2媒体操作作动作PlayMixer播放合成成音缓冲冲区的内内容。（注意：执行MixPlay将清空合合成音缓缓冲区，执行PlayMixer不会将MixPlay放置的合合成音清清空。）结束时产产生以下下事件：StopPlayBack正常放音音结束DialTerminate放音被按按键打断断Fai

14、led失败媒体操作作动作RecordFileS1，I2，I3录音并存存入文件件中，S1为文件名名，I2为最大录录音时长长（秒），I3是指采取0（覆覆盖的方方式）或或1（添添加的方方式），产生的的事件：Record正常录音音结束（由Setmaxsil设置的最最大静音音时间决决定，录录音时超出出最大静静音时间间则产生生此事件件）DialTerminate录音被话话机按键键打断TimeOut最大录音音时长已已到Failed失败媒体操作作动作DialDTMFS1模拟话机机拨号，产生一一串DTMF串。产生事件件：DialTerminate被对方按按键中止止StopDial正常结束束中止媒体操作作动作Di

15、gitI1接收一位位话机按按键，I1为最大时时间（秒秒），接接收到的的字符值值返回SR0，数字值返返回IR0（“*”=11，“#”=12）。结束时产产生事件件：StopDigits( 值)正正常收号号结束TimeOut超时没有有收到按按键媒体操作作动作语种选择择:stWelcome Prompt2000 /欢迎使用用168，普通通话请按按1，广广州话请请按2，英语请请按3。StopPlayBack-stDigitDialTerminate-stDigitFailed-stExitTimeOut-stExit:stDigit Digit 10 StopDigits(1)-stSetLanStop

16、Digits(2)-stSetLanStopDigits(3)-stSetLanStopDigits(-1) -stWelcomeTimeOut-stWelcome:stSetLanSetLangIR0Lprompt2001,2002,2003接收一位位按键的的例子InputI1，I2接收多位位话机按按键，I1为按键位位数，I2为最大时时长（秒秒），接接收到的字字符返回回SR0。按键位数数最多31位。结束时产产生事件件：StopDigits( 值)正正常收号号结束，或收到到一个终终止按键键。TimeOut超时没有有收到规规定长度度的按键键媒体操作作动作输入身份份证号码码:stWelcome P

17、rompt2000 /请输入您您的身份份证号码码，15位的请请按键键结束，按*键重输。StopPlayBack-stInputDialTerminate-stInputFailed-stExitTimeOut-stExit:stInputSetDTMF “*#” Input 18，50 StopDigits(*)-stWelcomeStopDigits(#)-stInserDBStopDigits(-1) -stInserDBTimeOut-stWelcomeParseParamSR0,1,“# AssignSR2,SR0 接收多位位按键的的例子SendFaxS1发送传真真，S1为要发送送的传

18、真真文件名名（TIFF/F格式）发发送完成成产生事件：StopSendFax发送成功功TimeOut发送超时时Failed发送失败败媒体操作作动作RecvFaxS1接收传真真并存入入文件中中，S1为文件名名，接收收完成产产生事件件：StopRecvFax接收成功功TimeOut超时错误误Failed失败媒体操作作动作HoldCall保持当前前呼叫（用户与与IVR已不能通通话，但但线路处处在保持持状态。）结束产生生事件：CallHeld呼叫被保保持（值值=0）呼叫保持持错误（值=1）呼叫控制制动作RetrieveCall恢复连接接，恢复复原来Hold的呼叫。（用户户与IVR恢复通话话） 恢复完成

19、成产生事事件：Passed成功Failed失败呼叫控制制动作SingleStepTransferS1，S2，S3单步转移移呼叫，S1为被叫号号，S2为主叫号号，S3为自定义义数据串串，可为为传真文件名名等。系系统变量量$Called被改为S1。（单步转移移后，IVR将打进来来的用户跟另另一用户户连接，IVR本身跟此此两用户户断开连连接。）转移完成成产生事事件：Passed成功Failed失败注意：一一般用于于D3为计费点点时。如如：D3为IVR或者坐席席。呼叫控制制动作MakeCall200S1，S2，S3产生一个个类似200业业务的呼呼叫即S1为被叫号号，S2为主叫号号，S3为自定义义数据字

20、字串。系统变量量$Called改为S1。注意：一一般用于于D3为非计费费点，有有流程来来帮其计计费时。如：外外线专家家。呼叫控制制动作呼叫控制制动作MakeCall200呼出完成成产生事事件：CallTerm(0)被叫应答答，成功功CallTerm(1)无人接CallTerm(2)被叫市话话忙CallTerm(3)被叫长话话忙CallTerm(4)拥塞CallTerm(5)空号AlternateCall在MakeCall200成功之后后可用这这一动作作在两个个呼叫之之间切换换。 切换完毕毕产生以以下事件件：Passed成功Failed失败呼叫控制制动作ReconnectCall在MakeCal

21、l200成功之后后可用这这一动作作把被保保持的呼呼叫重新新连接，同时把新的呼呼叫释放放。系统统变量$Called被改回MakeCall200之前的值值。完毕产生生以下事事件：Passed成功Failed失败D1C1D2IVRcD1C1D2C2D3IVRch呼叫控制制动作ClearCallI1清除呼叫叫（一般般情况不不需使用用，流程程结束后后系统会会自动清除呼叫叫）完毕产生生事件：ClearCallOK成功ClearCallFail失败呼叫控制制动作IVR与数据库库之间的的数据存存取通过过DBA（DataBaseAccess）来完成。SQL语句通过过DBA的维护界界面加入入。SelectDBI1

22、I2检索用户户自定义义数据表表，I1为SQLID值，I2为Where条件子句句参数的的个数，参数数值存放放在系统统变量$DBKEY1、$DBKEY2、$DBKEY3中。检索的结果果存于FD0FD9中。检索完毕毕产生事事件：Passed成功Failed失败数据库访访问动作作SelectDB动作例子子流程要执执行的SQL语句是：Selectdata3,data4fromflow_testwheredata1=”aaa” anddata2=”bbb”则在流程程里设置置动作ASSIGN$DBKey1,”aaa”ASSIGN $DBKey2,”bbb”SELECTDB10,2在DBA的维护界界面主要要需

23、加入入：数据库访访问动作作InsertDBI1I2在用户自自定义数数据表中中插入记记录，I1为SQLID值，插入入的字段段值存放放在FD0FD9中，I2为插入的的字段数数。插入完毕毕产生事事件：Passed成功Failed失败数据库访访问动作作InsertDB动作例子子例：流程程要执行行的SQL语句是：Insertintoflow_testvalues(1,2,3,4)则在流程程里设置置动作ASSIGNFD0,”1”ASSIGN FD1,”2”ASSIGN FD2,”3”ASSIGN FD3,”4” INSERTDB 11,4在DBA的维护界界面主要要需加入入：数据库访访问动作作DeleteD

24、BI1I2在用户自自定义数数据表中中删去记记录，I1为SQLID值。I2为Where条件子句句参数的个个数。删除完毕毕产生事事件：Passed成功Failed失败数据库访访问动作作UpdateDBI1I2I3在用户自自定义数数据表中中修改记记录，I1为SQLID值，I2为数据个个数，I3为要修改改的字段段个数，要修改改的字段段值放在在FD0FD29中。修改改完毕产产生。事件：Passed成功Failed失败数据库访访问动作作FirstDB在检索记记录（SelectDB）完成之后后在有多多条记录录返回时时执行该该动作将将把当前数数据表指指针指向向第一条条返回记记录，同同时FD0FD29的结果值值

25、作相应修改。完成后产产生事件件：Passed成功Failed失败数据库访访问动作作NextDB在检索记记录（SelectDB）完成之后后有多条条记录返返回时执执行该动动作，将把当前前数据表表指针指指向下一一条记录录，同时时FD0FD29的值相应应修改。完成后产产生事件件：Passed成功Failed失败数据库访访问动作作PriorDB在检索记记录（SelectDB）完成之后后有多条条记录返返回时执执行该动动作，将将把当前数数据表指指针指向向上一条条记录，同时FD0FD29的值相应应修改。完成后产产生事件件：Passed成功Failed失败数据库访访问动作作LastDB在检索记记录（Select

26、DB）完成之后后在有多多条记录录返回时时执行该该动作将将把当前数数据表指指针指向向最后一一条记录录，同时时FD0FD29的值将相相应修改改。完成后产产生事件件：Passed成功Failed失败数据库访访问动作作ExecSQLS1执行SQL命令，S1为要执行行的命令令字符串串。完成后产产生事件件：Passed成功Failed失败数据库访访问动作作ExecStoredProcI1I2执行存储储过程，I1为存储过过程编号号，输入入的参数数在FD0FD9中，I2为参数个数。运行的的结果存存于FD0FD9中。执行完毕毕产生事事件：Passed成功Failed失败数据库访访问动作作DirectReques

27、tDataI1I2S3向数据网网关请求求数据，I1为数据网网关ID（由每个网网关自行规定），I2为请求命命令的ID（由各网关关定义），S3为命令的内容。返回的的数据存存放在FD0。完成后产产生事件件：GatewayNotExist网关不存存在DataReceived(值)具体体意义由由各应用用网关确确定数据库访访问动作作需要访问问的网关关为DBF网关,网网关号1065，flow _test.dbf的表号为为1。流程要执执行的SQL语句是：Selectdata3,data4fromflow_test.dbfwheredata1=”aaa” anddata2=”bbb”则在流程程里设置置动作Dir

28、ectRequestData1024,301,”1;data1=aaa;data2=bbb”DataReceived(0)-stPromptDataReceived(-1) -stSayErrorGatewayNotExist-stSayErrorTimeOut-stSayError此动作的的参数1为网关关号，此此处为1065；参数数2为命命令的ID，此处为301，表示命命令为select；参数3为为命令的的内容，此处为为”1;data1=aaa;data2=bbb”,1表示访问问的表在在网关中中的表号号，data1=aaa;data2=bbb表示查询询的条件件。DataRecerved(0)

29、事件发生生，表示示查询成成功，返返回的结结果存放放在FD0中，各个个字段的的值用“，”隔隔开。访问DBF网关的例例子IVR的认证与与计费通通过AAASERVER实现。IVR向AAASERVER传送参数数，由AAASERVER完成认证证和计费费，再返返回结果果到IVR。VerifyUserS1帐户认证证。若S1为有效用用户帐号号，将设设置相关关的系统统变量（包括账账号性质、密码、余额、限制等等），并并将账号号加锁，不允许许账号同同时使用。认证证完毕产产生事件件：Verify（值）。认证与计计费动作作AccountCancelLock取消VerifyUser动作所作作的帐号号锁定。认证与计计费动作

30、作BillBeginI1I2S3启动计费费。I1为计费方方式：0（不不计费）、1（按主叫叫）、2（按被被叫）、3（按按原主叫叫）、4（按账账号）、5（按按计费号号码）、6（按按原被叫叫）；I2是否计算算可打时时长（按按帐号计计费时用用），0：否；1：是是。如果果需计算算可服务务时长，结果存存放在IR0中（-1表示没没有限制制）。S3为服务项项目编码码，一般般情况下下应该为为系统变变量$ServiceItemNo按帐号计计费完毕毕产生事事件：Verify（值）其中中值0有效效用户1 无效用用户(帐帐号余额额不够)2 该账号号没有登登记此项项服务4 黑名单单5 其它认证与计计费动作作认证与计计费动

31、作作BillEnd结束计费费，并产产生话单单（当用用户挂机机时系统统也会自自动产生生话单。）完毕产生生事件：Verify（值）其中中值0OK1 Error开始计费费(按主主叫计费费)：BillBegin1,0,$ServiceItemNo Verify(0)-stWelcome/启动计费费成功Verify(-1) - stExit/启动计费费失败结束计费费BillEnd Verify(0)-stFreeAd/结束计费费成功Verify(-1) - stExit/结束计费费失败注意：一一般只需需启动计计费，因因为如果果用户挂挂机，系系统会自自动结束束计费。计费的例例子ChangePassword

32、S1修改帐号号密码。在这个个之前须须先执行行了VerifyUser动作，执行VerifyUser动作后，系统将将帐号的的原密码码放置在在系统变变量$Password中。完成后产产生事件件：Passed成功Failed失败认证与计计费动作作TempFileEraseFileS1CopyFileS1，S2GetFileTimeS1文件操作作动作OpenMailBoxS1若打开成成功，系系统自动动设置如如下的系系统变量量：$TotalMail,$CurrentMailCloseMailBoxAddMailS1DelMailS1ReplaceMailS1PlayMail邮箱管理理动作LockMailBoxUnLockMailBoxPrevMailS1NextMailS1ShiftMailS1GetMailTextPutMailTextS1NewMailBoxS1,I1邮箱管理理动作OnCallCleared&F1当IVR接收到ACD送过来的的CallCleared事件时执执行处理理函数F1。OnStopFlow&F1当系统要要停止流流程的运运行时执执行处理理函数为为F1。同时传来来自定义义数据串串，存放放于系统统变量INPUTPARAM中。系统缺省省处理：强行终终止当前前流程。设置例外外处理函函数动作作SetStopWatchI1启动