|
協(xié)同OA軟件通用短信接口實現(xiàn)方式及使用說明
|
名易通用短信接口實現(xiàn)方式及使用說明名易oa協(xié)同辦公平臺通用短信接口實現(xiàn)方式及使用說明考慮到目前短信設備多如牛毛，我們不可能和每個供應商做集成開發(fā)，因此設計了這個短信通用接口。接口的原理很簡單，就是名易OA系統(tǒng)只負責把需要發(fā)送的短信數(shù)據放到中間表里，由短信設備供應商或客戶自己把中間表里的數(shù)據發(fā)送出去。實際上大多數(shù)短信設備供應商已經實現(xiàn)了通過中間表方式發(fā)送短信。接口對中間表的存放的位置、中間表名及字段名沒有要求，因為往中間表插入數(shù)據的sql是在配置文件中指定的，但是有兩點要注意1.必須使用sqlserver或oracle數(shù)據庫，其他的數(shù)據庫暫時不支持。2.必須有用于存放短信內容、短信接受人的字段。名易OA使用說明：在理解了上面的原理之后，我們可以繼續(xù)了解配置使用接口的方法。1.找到名易OA系統(tǒng)WEB-INFervicems.xml,打開這個文件，里面的內容如下：moduleid=smsversion=1.0.0service-pointid=smssenderinterface=OA.sms.SmsServiceinvoke-factoryconstructclass=OA.sms.JdbcSmsServicesetproperty=typevalue=sqlserversetproperty=hostvalue=192.168.0.204setproperty=portvalue=1433setproperty=dbnamevalue=名易OA系統(tǒng)3802setproperty=usernamevalue=sasetproperty=passwordvalue=123setproperty=sqlvalue=insertintoOutBox(ReceiverMobileNo,Msg,SendTime,IsChinese,ExpressLevel,Sender)values(?,?,getDate(),1,1,1)constructinvoke-factoryervice-pointmodule我們需要關注的是紅色部分的內容。我逐一講解一下.setproperty=typevalue=sqlserver:指定中間表所在數(shù)據庫的類型，如果是oracle的話就改為value=oraclesetproperty=hostvalue=192.168.0.204:指定中間表所在數(shù)據庫服務器的ipsetproperty=portvalue=1433:指定中間表所在數(shù)據庫的端口，如果是oracle的話應改為1521setproperty=dbnamevalue=名易OA系統(tǒng)3802:指定中間表所在數(shù)據庫名setproperty=usernamevalue=sa:指定中間表所在數(shù)據庫帳號setproperty=passwordvalue=123:指定中間表所在數(shù)據庫密碼以上的配置和OA.properties中的參數(shù)差不多，應該不難理解。setproperty=sqlvalue=insertintoOutBox(ReceiverMobileNo,Msg,SendTime,IsChinese,ExpressLevel,Sender)values(?,?,getDate(),1,1,1):指定往中間表插入數(shù)據使用的sql語句。例子中的這條sql是我給一個客戶寫的，客戶提供的中間表結構是：表名：OutBox字段：ReceiverMobileNo,----------------接受人Msg,----------------短信內容SendTime,-----------------發(fā)送時間IsChinese,-----------------是否中文ExpressLevel,-----------------緊急程度Sender----------------發(fā)送人實際上我們只需要用到接受人和短信內容兩個字段，這兩個字段的值不是固定的，由我們的接口負責把數(shù)據傳過來，因此用?號表示他們的值。其他字段的值我們不關心，可以隨便寫死一些數(shù)據，這個例子里我全部寫的1,發(fā)送時間是用sqlserver自帶的函數(shù)getDate()獲取的。我們可以這樣理解名易，最簡單的中間表可以是這樣子的：表名：someTable字段：MobileNo,messageBody2.修改名易OA系統(tǒng)WEB-INFpropOA_rtx.properties中的內容為：#configfile#FriAug1311:30:56CST2004IsInitRTXOrg=trueIsDownLineNotify=true#CurSmsServer=rtxCurSmsServerIsValid=trueRTXServerPort=8036RTXServerIP=RTXServerOutIP=也就是說只要把CurSmsServer=rtx用#號注釋掉就可以了。（相信大家都清楚CurSmsServer參數(shù)是用來指定當前短信發(fā)送設備的）下面我提供兩個建中間表的sql腳本供客戶參考：1.forsqlserverCREATETABLEoutbox(IDintIDENTITY(1,1),ExpressLevelint,Sendervarchar(50),ReceiverMobileNovarchar(50),Msgvarchar(500),SendTimedatetime,IsChinesebit)3.fororaclecreatetableOUTBOX(IDNUMBERnotnull,EXPRESSLEVELNUMBER,SENDERVARCHAR2(50),RECEIVERMOBILENOVARCHAR2(50)notnull,MSGVARCHAR2(500),SENDTIMEDATEnotnull,ISCHINESENUMBERnotnull);createsequenceOUTBOX_ID_SEQminvalue1maxvalue999999999startwith141incrementby1cache20;CREATEORREPLACETRIGGERSET_OUTBOX_IDBEFOREINSERTONOUTBOXFOREACHROWDECLARENEXT_OUTBOX_IDNUMBER;BEGINSELECTOUTBOX_ID_SEQ.NEXTVALINTONEXT_OUTBOX_IDFROMDUAL;:NEW.ID:=NEXT_OUTBOX_ID;END;oracle下對應的sms.xml文件內容為：moduleid=smsversion=1.0.0service-pointid=smssenderinterface=OA.sms.SmsServiceinvoke-factoryconstructclass=OA.sms.JdbcSmsServicesetproperty=typevalue=oraclesetproperty=hostvalue=192.168.0.204setproperty=portvalue=1521setproperty=dbnamevalue=OA1setproperty=usernamevalue=名易OA系統(tǒng)40002setproperty=passwordvalue=名易OA系統(tǒng)setproperty=sqlvalue=insertintoOutBox(ReceiverMobileNo,Msg,SendTime,IsChinese,ExpressLevel,Sender)values(?,?,(selectsysdatefromdual),1,1,'1')constructinvoke-factoryervice-pointmodule名易OA協(xié)同實際上使用中間表來和短信供應商集成只是我們通用接口的一部分，這種實現(xiàn)方式的缺點是短信供應商通常以定時掃描中間表的方式來把短信數(shù)據發(fā)送出去，短信發(fā)送的時間取決于掃描的頻度，實時性稍差。如果客戶不喜歡中間表的方式，他還可以選擇自己去實現(xiàn)發(fā)送短信的方法，當然，必須使用java編程語言。當他把自己寫的發(fā)送方法部署到系統(tǒng)中之后，名易OA系統(tǒng)在發(fā)送短信的時候就會調用客戶的實現(xiàn)。部署的方法也很簡單，復雜的是只有java程序員才看的懂，具體操作起來可以向名易開發(fā)人員咨詢：1.編寫客戶自己的實現(xiàn)。只需要實現(xiàn)我們提供的SMSService接口：publicinterfaceSmsService{publicbooleansendSMS(StringsmsId,Stringnumber,Stringmsg);}假定客戶是這樣實現(xiàn)的：publicclassTestServiceimplementsSmsService{publicbooleansendSMS(StringsmsId,Stringnumber,Stringmsg){System.out.println(接受人：+number);System.out.println(測試短信：+msg);returntrue;}}那么名易OA系統(tǒng)系統(tǒng)在發(fā)送短信時將會調用TestService中的sendSMS方法。2.把客戶的實現(xiàn)部署到名易OA系統(tǒng)中。修改sms.xml就可以了，我還是用上面的客戶實現(xiàn)為例：moduleid=smsversion=1.0.0service-pointid=smssenderinterface=OA.sms.SmsServiceinvoke-factoryconstructclass=TestServiceconstructinvoke-factoryervice-pointmodule紅色部分表示名易OA系統(tǒng)在發(fā)送短信是將調用TestService實現(xiàn)。
信息發(fā)布：廣州名易軟件有限公司 http://m.jetlc.com
|
|
|
|
名易MyOA協(xié)同綜合辦公平臺
名易MyCRM客戶關系管理平臺
名易MyHR人力資源管理平臺
名易MyIDP智能開發(fā)平臺
名易MyIBP保險業(yè)務管理平臺
名易MyHMS酒店綜合管理系統(tǒng)
名易MyPM項目管理平臺
名易MyTMS物流運輸管理平臺
名易MyVMS汽車綜合管理系統(tǒng)
名易MyIMS貸款管理系統(tǒng)
名易MyEDU教育管理平臺
名易MyPCS生產事務協(xié)調系統(tǒng)
名易MyWIDP微信智能開發(fā)平臺
