短信API接口在泛普OA辦公系統(tǒng)中很好實(shí)現(xiàn)

申請免費(fèi)試用、咨詢電話：400-8352-114

短信API接口在泛普OA辦公系統(tǒng)中很好實(shí)現(xiàn)
一. 接口說明
該接口用來實(shí)現(xiàn)調(diào)用各短信廠商提供的短信發(fā)送網(wǎng)關(guān)或者信息機(jī)實(shí)現(xiàn)泛普OA辦公軟件泛普OA系統(tǒng)短信發(fā)送的功能。
二. 實(shí)現(xiàn)方法&步驟

實(shí)現(xiàn)方法分為兩類：一類是使用中間表方式實(shí)現(xiàn)，另外一類是可自行編寫接口代碼方式來調(diào)用方法；
中間表實(shí)現(xiàn)方法：接口的原理很簡單，就是泛普OA辦公軟件泛普OA系統(tǒng)只負(fù)責(zé)把需要發(fā)送的短信數(shù)據(jù)放到中間表里，由短信設(shè)備供應(yīng)商或客戶自己把中間表里的數(shù)據(jù)發(fā)送出去。實(shí)際上大多數(shù)短信設(shè)備供應(yīng)商已經(jīng)實(shí)現(xiàn)了通過中間表方式發(fā)送短信。
接口對中間表的存放的位置、中間表名及字段名沒有要求，因?yàn)橥虚g表插入數(shù)據(jù)的sql是在配置文件中指定的，但是有兩點(diǎn)要注意
1.       必須使用sql server或oracle數(shù)據(jù)庫，其他的數(shù)據(jù)庫暫時(shí)不支持。
2.       必須有用于存放短信內(nèi)容、短信接受人的字段。
使用說明：
在理解了上面的原理之后，我們可以繼續(xù)了解配置使用接口的方法。
1. xml文件配置
文件位于ecoloyg/WEB-INF/service/sms.xml,打開這個(gè)文件，里面的內(nèi)容如下：
<module id="sms" version="1.0.0">
    <service-point id="smssender" interface="OA.sms.SmsService">
        <invoke-factory>
            <construct class="OA.sms.JdbcSmsService">
                <set property="type" value="sqlserver"/>
                <set property="host" value="192.168.0.204"/>
                <set property="port" value="1433"/>
                <set property="dbname" value="泛普OA辦公軟件泛普OA系統(tǒng)3802"/>
                <set property="username" value="sa"/>
                <set property="password" value="123"/>
                <set property="sql" value="insert into OutBox(ReceiverMobileNo,Msg,SendTime,IsChinese,ExpressLevel,Sender) values(?,?,getDate(),1,1,1)"/>
            </construct>
        </invoke-factory>
    </service-point>  
</module>

我們需要關(guān)注的是紅色部分的內(nèi)容。我逐一講解一下.
 <set property="type" value="sqlserver"/>: 指定中間表所在數(shù)據(jù)庫的類型，如果是oracle的話就改為value="oracle"
 <set property="host" value="192.168.0.204"/>:  指定中間表所在數(shù)據(jù)庫服務(wù)器的ip
 <set property="port" value="1433"/>: 指定中間表所在數(shù)據(jù)庫的端口，如果是oracle的話應(yīng)改為1521
 <set property="dbname" value="泛普OA辦公軟件泛普OA系統(tǒng)3802"/>: 指定中間表所在數(shù)據(jù)庫名
 <set property="username" value="sa"/>: 指定中間表所在數(shù)據(jù)庫帳號(hào)
 <set property="password" value="123"/>:指定中間表所在數(shù)據(jù)庫密碼
 以上的配置和OA.properties中的參數(shù)差不多，應(yīng)該不難理解。
 <set property="sql" value="insert into OutBox(ReceiverMobileNo,Msg,SendTime,IsChinese,ExpressLevel,Sender) values(?,?,getDate(),1,1,1)"/>: 指定往中間表插入數(shù)據(jù)使用的sql語句。
表名：OutBox
字段：ReceiverMobileNo,   ----------------接受人
Msg,               ----------------短信內(nèi)容
SendTime,          -----------------發(fā)送時(shí)間
IsChinese,          -----------------是否中文
ExpressLevel,       -----------------緊急程度
Sender             ----------------發(fā)送人

實(shí)際上我們只需要用到接受人和短信內(nèi)容兩個(gè)字段，這兩個(gè)字段的值不是固定的，由我們的接口負(fù)責(zé)把數(shù)據(jù)傳過來，因此用?號(hào)表示他們的值。其他字段的值我們不關(guān)心，可以隨便寫死一些數(shù)據(jù)，這個(gè)例子里全部寫的1,發(fā)送時(shí)間是用sql server自帶的函數(shù)getDate()獲取的。

我們可以這樣理解，最簡單的中間表可以是這樣子的：
表名：someTable
字段：MobileNo,
      messageBody
2. 短信設(shè)備配置文件修改
修改泛普OA辦公軟件泛普OA系統(tǒng)/WEB-INF/prop/OA_rtx.properties中的內(nèi)容為：
#config file
#Fri Aug 13 11:30:56 CST 2004
IsInitRTXOrg=true
IsDownLineNotify=true
#CurSmsServer=rtx
CurSmsServerIsValid=true
RTXServerPort=8036
RTXServerIP=
RTXServerOutIP=

也就是說只要把CurSmsServer=rtx用#號(hào)注釋掉就可以了。
3. 中間表之sql腳本樣例
下面提供兩個(gè)建中間表的sql腳本供參考：
1. for sqlserver
CREATE TABLE outbox (
 ID  int IDENTITY (1, 1) ,
 ExpressLevel int ,
 Sender varchar (50) ,
 ReceiverMobileNo varchar (50),
 Msg varchar (500) ,
 SendTime datetime,
 IsChinese bit
 )

2. for oracle
create table OUTBOX
(
  ID               NUMBER not null,
  EXPRESSLEVEL     NUMBER,
  SENDER           VARCHAR2(50),
  RECEIVERMOBILENO VARCHAR2(50) not null,
  MSG              VARCHAR2(500),
  SENDTIME         DATE not null,
  ISCHINESE        NUMBER not null
);
create sequence OUTBOX_ID_SEQ
minvalue 1
maxvalue 999999999
start with 141
increment by 1
cache 20;
CREATE OR REPLACE TRIGGER "SET_OUTBOX_ID" BEFORE
    INSERT  ON "OUTBOX"
FOR EACH ROW

DECLARE
  NEXT_OUTBOX_ID NUMBER;
BEGIN
  SELECT OUTBOX_ID_SEQ.NEXTVAL INTO NEXT_OUTBOX_ID FROM DUAL;
  :NEW.ID := NEXT_OUTBOX_ID;
END;

 oracle下對應(yīng)的sms.xml文件內(nèi)容為：
<module id="sms" version="1.0.0">
    <service-point id="smssender" interface="OA.sms.SmsService">
        <invoke-factory>
            <construct class="OA.sms.JdbcSmsService">
                <set property="type" value="oracle"/>
                <set property="host" value="192.168.0.204"/>
                <set property="port" value="1521"/>
                <set property="dbname" value="OA1"/>
                <set property="username" value="泛普OA辦公軟件泛普OA系統(tǒng)40002"/>
                <set property="password" value="泛普OA辦公軟件泛普OA系統(tǒng)"/>
                <set property="sql" value="insert into OutBox(ReceiverMobileNo,Msg,SendTime,IsChinese,ExpressLevel,Sender) values(?,?,(select sysdate from dual),1,1,'1')"/>
            </construct>
        </invoke-factory>
    </service-point>  
</module>
 

 注意：每次配置后需要重啟OA服務(wù)方可生效；