深圳市百利通科技有限公司全國服務熱線：400-057-8590PAGE第4頁，共28頁QQ：757013743企業短信服務器二次開發平臺V4.1（支持長短信收發）使用說明書目錄二、短信服務器二次開發平臺原理下面是短信服務器原理圖：下面是某市建設銀行采用本短信二次開發平臺時實施的系統方案圖：在該方案中，考慮到銀行是對信息安全性要求很高的行業，采用GSMMODEM作為短信收發設備，避免了常用的通過移動互聯網網關與移動短信中心相連接的方式，從而避免了來自互聯網的安全性威脅。短信收發記錄采用通用數據庫（如Oracle、SQLServer等）存儲，為新建系統或應用系統新增功能提供了方便。例如，在該方案中，要對儲戶短信查詢進行按條數計費，計費系統可直接統計本數據庫中的各儲戶的查詢記錄即可。短信服務器使用基本步驟：安裝服務器軟件、加密狗驅動程序。點擊“開始”菜單頂部的“短信服務器”運行軟件，然后點擊界面“設備管理”進行設備配置，當“設備狀態”是綠色的“啟用”狀態時，表明正常連接了設備，軟件可正常工作。3、利用軟件提供的6種開發接口進行二次開發。若設備“工作狀態”是“無法啟動”，那么請按以上步驟檢查：短信設備與電腦是否連接好短信設備天線是否擰緊短信設備插入手機卡10秒后，插卡旁邊的工作指示燈應該是有規律的閃爍，如果是一直紅燈，表明沒有插卡或者卡沒有插好、卡內無話費、卡有開機密碼，需要換手機卡。三、短信服務器二次開發平臺特點基于此平臺可快速開發網絡短信的應用，哪怕在不涉及編程的情況下也能夠讓你的現有系統快速集成短信功能。方便、靈活、簡單的六種開發接口供選擇，任何一位軟件開發人員都能選擇到一種自己得心應手的開發接口進行開發。采用數據庫與應用系統接口，支持WINDOWS下的各種編程開發工具。支持常見的數據庫，如Oracle、SQLServer、Access等。本平臺具備性能穩定的短信群發功能。短信服務器可以外接20個GSM模塊，自動調節模塊間的負載平衡，從而非常簡單地就可實現多模塊并行發送擴展。能夠控制各個GSM模塊的發送范圍（如移動或聯通），能分別設定各個客戶端允許使用的GSM模塊，以及各個客戶端的使用優先級。短信服務器包含禁發詞匯過濾功能，系統操作員可定義禁發詞匯，一旦客戶端提交了包含禁發詞匯的短信內容，服務器能夠自動刪除該短信。能夠分別設定各個GSM模塊的發送速度，以及實時查看各個GSM模塊當前實際發送速率。能夠自動檢測短信服務器上各個GSM模塊的設備運行狀況。能夠通過手機短信遠程查詢服務器的運行狀況。能夠設定系統發送工作時間段。可按軟件定義規則向各客戶端轉發GSM模塊收到的短信（有明確轉發和隱式轉發兩種方式。明確轉發，要求短信格式為：客戶端名稱*短信內容；隱式轉發不要求短信格式，服務器自動按“誰最近往該手機號碼上發過短信，則轉發給誰”的原則處理。系統優先使用明確轉發方式，如果明確轉發方式失敗，自動使用隱式轉發方式）。短信服務器有短信發送和接收的日志記錄，有收發權限管理。系統能實時記錄完整的系統操作員的操作日志以及出錯日志。系統維護和升級比較簡單。

四、二次開發平臺數據庫表說明：

4.1短信禁發詞匯表BlackWordTable：字段名類型說明BlackWord文本短信禁發詞匯4.2錯誤日志表ErrorLogTable：字段名類型說明ErrorIndex自動編號錯誤編號，主鍵，自動生成ErrorTime日期/時間出錯時間ErrorText文本錯誤描述4.3設備管理表ModemTable：字段名類型說明ModemIndex文本設備序號，如短信設備1、短信設備2、短信設備3……ModemState文本標記設備狀態：啟用或禁用ComName文本連接串口(COM)號，例如：COM1、COM2、COM3……ModemType文本設備類型：工業GSMModem或西門子手機ComRate文本設備連接波特率，根據設備的不同可能為9600、19200、38400、57600、115200。注：GSMModem的波特率為9600NumberArea文本發送對象的范圍，值可為：不限范圍，移動號碼，聯通號碼SendRate文本發送速度SendSucceedCount數字本設備已累計發送成功的短信條數SendErrorCount數字本設備已累計發送失敗的短信條數MaxSendCount數字限制發送短信條數（只計算發送成功數，0為不限制）Remark文本備注信息，可為任意文本4.4用戶短信條數日志表PayLogTable：字段名類型說明PayIndex自動編號記錄編號，主鍵，自動生成PayTime日期/時間操作時間UserID文本用戶代碼PayValue數字添加或刪除短信條數4.5短信接收日志表RecvSmsTable：字段名類型說明SmsIndex自動編號接收短信編號，主鍵，自動生成SmsTime日期/時間接收時間SendNumber文本短信發送號碼SmsContent文本短信內容RecvModemSet文本接收本條短信的設備序號NewFlag數字未處理標志（預留給應用系統使用）。默認值為1SendTime日期/時間短信發送的時間注：本表記錄的增加由短信服務器二次開發平臺來完成；應用系統只需查詢有無新記錄，（NewFlag字段值為1，表示是新記錄），有則讀出處理。4.6待發短信表SendingSmsTable：字段名類型說明SmsIndex自動編號發送短信編號，主鍵，自動生成SmsUser文本發送短信的用戶（或類型）PhoneNumber文本短信接收號碼SmsContent文本短信內容UserDefineNo數字用戶自定義編號（可用于短信的標識）PutInType文本信息提交方式SendModem數字發送短信的設備，如：1、2、3……表示使用某號短信設備來發送，如為0，則表示不作發送設備限制。默認值為0SendLevel數字短信發送優先級，數值越低，優先級越高。范圍：－2，－1，0，1，2；默認值為1NewFlag數字未處理標志，默認值為1RM1文本供用戶使用RM2文本供用戶使用RM3文本供用戶使用注：本表記錄的增加由應用系統來完成，至少需要更新以下字段值：PhoneNumber、SmsContent、NewFlag。具體開發方法請參見：6.3.2章節。4.7短信發送日志表SentSmsTable：字段名類型說明SmsIndex自動編號已發短信編號，主鍵，自動生成PhoneNumber文本短信接收號碼SmsContent文本短信內容SmsTime日期/時間發送時間SmsUser文本提交短信的用戶（或類型）Status數字發送結果，1為成功，否則為失敗NewFlag數字未處理標志（預留給應用系統使用），默認值為1UserDefineNo數字用戶短信自定義編號（用于短信標識使用）SendSetIndex數字發送該短信的設備序號RM1文本供用戶使用RM2文本供用戶使用RM3文本供用戶使用注：本表記錄的增加亦由短信服務器二次開發平臺來完成；應用系統只需查詢有無新記錄，有則讀出處理4.8系統日志表SystemLogTable：字段名類型說明LogIndex自動編號系統日志編號,主鍵，自動生成LogTime日期/時間記錄時間LogText文本記錄內容NewFlag數字未處理標志，默認值為14.9用戶管理表UserTable：字段名類型說明UserID文本用戶代碼UserDesc文本用戶描述UserKey文本用戶口令UseSetList文本用戶可以使用短信設備列表，如：<短信設備1><短信設備2><短信設備3><短信設備4>……UserLevel數字數值越低，優先級越高；0為最高級，1為優先級，2為普通級SmsCount數字剩余可發送短信條數，默認值為04.10定時發送信息表TimeSendSmsTable：字段名類型說明SmsIndex自動編號定時發短信編號，主鍵，自動生成PhoneNumber文本短信接收號碼SmsContent文本短信內容SmsUser文本提交短信的用戶（或類型）UserDefineNo數字用戶短信自定義編號（用于短信標識使用）SendLevel數字設置短信的優先級，數值越低，優先級越高，默認值為0SendModem數字發送短信的設備，如：1、2、3……表示使用某號短信設備來發送，如為0，則表示不作發送設備限制。默認值為0SendTime數字設置發送短信的時間表示方法：yyyy-mm-ddhh:mm:ss，即年（4位）-月（2位）-日（2位）時（2位）:分（2位）:秒（2位）RM1文本供用戶使用RM2文本供用戶使用RM3文本供用戶使用五、OEM短信服務器產品信息5.1開發目的修改短信服務器界面和標識，使之與公司產品統一和配套。5.2開發方法服務器軟件的界面圖片文件為m1.bmp、m2.bmp，修改界面圖片信息，即可完成短信服務器界面的修改。5.3開發難度簡單，不涉及編程，只需要會使用圖像處理工具（如Photoshop等）即可。六、實現應用系統的短信功能6.1基于命令行方式的短信功能實現6.1.1使用特點快速、簡單地實現短信收發功能，對開發語言的支持性好，Windows平臺上的各種開發語言都可以非常簡單地完成。使用簡單，調試過程短。6.1.2開發方法1、發送短信程序中執行命令行：SendSms發送手機號碼發送短信內容如：WinExec("SendSm日快樂！",SW_HIDE)2、接收短信 在短信服務器界面的“系統設置/命令行方式/設置接收日志文件”中，設置好接收日志文件，則短信服務器每接收到手機用戶發過來的短信，就會自動寫入該接收日志文件中。應用系統定時檢測接收日志文件的內容即可接收短信。3、查詢發送短信情況 在短信服務器界面的“系統設置/命令行方式/設置發送日志文件”中，設置好發送日志文件，則通過命令行發送短信的發送結果（成功或失敗，發送時間）將自動寫入該文件中。應用系統定時檢測發送日志文件的內容來判斷短信發送情況。6.1.3開發難度簡單，要實現發送短信，一般只需添加一行代碼即可完成。6.2基于外部數據庫的開發接口6.2.1使用特點快速地使現有的應用系統具備短信收發功能，不需要編程，不需要對原應用系統進行代碼修改，只需要在短信服務器界面上作些配置即可，尤其適合已存在系統的功能升級（特別是源代碼已不存在的系統）。6.2.2開發方法建立應用系統數據庫的ODBC連接，然后在短信服務器上指定應用系統的發送表和接收表（相對于短信服務器系統而言，稱之為外部發送表和外部接收表）。發送短信原理與配置方法：短信服務器通過定時掃描外部發送表，來判斷外部發送表中是否有新記錄，如果有新記錄，則將新記錄讀出來，并將該記錄寫入短信服務器自帶的待發短信表中（凡被寫入該表的記錄均會被自動用短信發送出去），然后在外部發送表中刪除本條記錄、或修改本條記錄的狀態標志。短信服務器短信服務器應用系統應用系統數據庫應用系統數據表1應用系統數據表2（設定為發送表）應用系統數據表3應用系統數據表4應用系統數據表5…………短信服務器數據庫用戶管理表設備管理表短信發送日志表短信接收日志表待發短信表…………定時檢測是否有新記錄有新記錄，取入內部待發送表中，待發外部發送表的配置在短信服務器軟件的“系統設置/配置外部發送表”中進行，配置界面如下圖所示（圖中數據僅為示例）：配置完成后，向發送表中插入一條新記錄，更新“手機號碼字段”、“短信內容字段”值即可。接收短信原理與配置方法：短信服務器通過短信設備接收到手機用戶發過來的短信后，一方面把接收到的短信寫到自帶的短信接收日志表中，同時也把該短信寫入外部接收表中（假設已把應用系統的某張表指定為外部接收表）。應用系統即可通過定時（或事件觸發）檢查接收表中有無新記錄，如有記錄，則讀進應用系統，然后應用系統再作分析處理。短信服務器短信服務器應用系統應用系統數據庫應用系統數據表1應用系統數據表2應用系統數據表3（設定為接收表）應用系統數據表4應用系統數據表5…………短信服務器數據庫用戶管理表設備管理表短信發送日志表短信接收日志表待發短信表…………收到手機短信同步寫入外部接收表的配置在短信服務器軟件的“系統設置/配置外部接收表”中進行，配置界面如下圖所示（圖中數據僅為示例）：6.2.3開發難度簡單，不涉及編程，不需要對原系統的代碼進行修改。6.3基于系統數據庫的開發接口6.3.1使用特點多個應用系統共享一個短信服務器來收發短信，希望是一個簡單的網絡應用，應用系統在收發選項上希望比命令行方式更多一些，更靈活一些。需要對應用系統代碼進行修改，需要編程。6.3.2開發方法注：系統數據庫連接文件為短信服務器二次開發平臺安裝目錄下的GWDB_link.ini文件，要修改系統數據庫連接，直接修改GWDB_link.ini文件即可。（若無，運行二次開發平臺，將自動生成；然后可以修改。）系統安裝時，默認安裝的數據庫為Access類型數據庫，數據庫文件是位于短信服務器二次開發平臺安裝目錄下的SmsServer.mdb文件。短信發送：把您要發送的短信寫入SendingSmsTable表里（注意：請按字段描述的要求寫入），系統將自動讀出該記錄并發送；已發送記錄保存在SentSmsTable表中。示例SQL語句：PhoneNumber,SmsContent,NewFlag三個字段值必須添加，NewFlag為1表示新加入（未處理）:insertintoSendingSmsTable(PhoneNumber,SmsContent,NewFlag)values(,’文字短信測試消息一’采用1號短信設備發送,且該短信優先級為’0insertintoSendingSmsTable(PhoneNumber,SmsContent,SmsModem,SmsLevel,NewFlag)values(,’文字短信測試消息二’2、查看短信發送情況：通過查看SentSmsTable下記錄得Status字段來獲知該記錄發送成功還是失敗，當Status值為1時，表示發送成功；否則為失敗。3、短信接收：短信服務器通過短信設備接收到手機用戶發過來的短信后，均寫入了數據庫RecvSmsTable表中，應用系統可從中讀取接收到的短信。4、設置短信設備信息和查看短信設備狀態：設置ModemTable表中的CommName和ModemStatus值可以向開發平臺系統傳遞所連接短信設備的Com口號和讓該設備工作與否。設置MaxSendCount值可以向開發平臺傳遞該設備的限制發送條數（以成功計算，0為不限制）。讀取SendSucceedCount可以知道該設備上累計發送成功了多少條信息；讀取SendErrorCount可以知道該設備上累計發送失敗的信息條數。5、查看出錯信息：讀取ErrorTable表中的記錄，即可獲取出錯信息。5.3.3開發難度中等難度，只要會數據庫讀寫操作，一般都可以順利完成開發。6.4基于Socket客戶端的開發接口6.4.1使用特點方便于網絡（局域網或廣域網）上多用戶使用。網絡上要發送短信的軟件，只需要通過TCP與服務器相連，并按照規定協議與服務器進行指令交互，即可完成短信的收發操作。6.4.2開發方法連接端口號：TCP協議，端口號9518，長連接。命令語法：<指令名>參數1#參數2#參數3#……功能發起過程客戶端服務器登陸客戶端服務器<登陸>用戶名#密碼#<登陸>成功可發送條數#<登陸>用戶名錯誤#<登陸>口令錯誤#發送短信客戶端服務器<發短信>自定義編號#手機號#短信內容#服務器即時返回：<發短信>提交成功可發送條數#；<發短信>失敗：無授權條數#；<發短信>未登陸#。服務器稍后返回：<短信發送報告>發送成功#自定義編號#<短信發送報告>發送失敗#自定義編號#接收短信服務器客戶端（客戶端在線時才轉達接收的短信）<收到短信>手機號碼#短信內容#注：僅客戶端在線時才轉達接收的短信，轉發規則見第三章。注：如果服務器暫停服務，則上述客戶端的每條指令返回均為“<服務暫停>服務暫停#”。6.4.3開發難度中等，需要有網絡程序開發經驗。6.5基于網絡客戶端OCX控件的開發接口6.5.1使用特點方便于網絡（局域網或廣域網）上多用戶使用。只需要插入客戶端ocx控件后，簡單地調用控件接口函數，就可以方便地發送和接收短信。簡單、易用。6.5.2開發方法應用系統中嵌入短信客戶端OCX控件，通過調用控件接口函數實現網絡（包括互聯網）方式的短信發送和接收。控件文件名：SmsClient.ocx控件接口名：SmsClient。短信客戶端OCX控件接口函數：接口函數一：函數名LongConnectSmsServer(CStringServerIP,CStringUserName,CStringPassWord)函數描述連接短信服務器。參數描述SmsServerIP服務器IP地址。UserName登陸用戶名。PassWord登陸口令。返回值1為成功登陸，其余為連接失敗；-1、連接失敗；-2、用戶名錯誤；-3、密碼錯誤。 接口函數二：函數名longGetCanSendSmsAmount()函數描述取得該客戶端的可發送短信條數。參數描述無無。返回值可發送短信條數接口函數三：函數名longSendSms(CStringPhoneNumber,CStringSmsContent,longSmsIndex)函數描述發送短信。參數描述PhoneNumber接收手機號碼。SmsContent短新內容SmsIndex自定義編號返回值1、提交成功；-1、服務器拒絕請求；-2、尚未連接服務器。 接口函數四：函數名voidDisconnectSmsServer()函數描述斷開與服務器的連接。參數描述無無。返回值無短信客戶端OCX控件接口事件事件一：事件名RecvSms(LPCTSTRPhoneNumber,LPCTSTRSmsContent)事件描述收到短信。參數描述PhoneNumber發送者手機號碼SmsContent短信內容事件二：事件名SendSmsResult(longResult,longSmsIndex);事件描述短信發送報告。參數描述Result發送結果，1為成功發送，其余為失敗。SmsIndex發送短信的自定義標識編號 事件三：事件名ServerDisConnect();事件描述服務器關閉了與本客戶端的連接。參數描述無無。6.5.3開發難度簡單，需要進行程序開發。6.6基于HTTP協議的開發接口6.6.1使用特點在網頁程序或Java程序中直接調用URL語句來完成發送短信的提交以及接收短信。簡單、易用。6.6.2開發方法1、發送短信調用格式：http://服務器地址:9618/User=,Password=,MsgID=,Phone=,Msg=注：如User、Msg內容中有特殊字符，請先按HTTP協議方法做Unicode編碼（常用server.urlencode()函數進行轉換）。MsgID內容為數字，用于短信的標識（也可無值）。各項參數的排列順序不可以顛倒。示例：:9618/User=abc,Password=111,MsgID=1,PhoneMsg=%B2%E2%CA%D4%D2%BB%CF%C2%D0%A7%B9%FB+%3CISOK%3F%3E返回值：00：成功01：密碼或口令錯02：無可發送條數03：其它原因拒絕接收短信URL調用格式：在短信服務器軟件上設置一條傳遞收到短信信息的URL語句，短信服務器作為調用方，應用系統作為WebServer方。當短信服務器接后到短信后，短信服務器調用該URL向應用系統傳遞接收到的短信。在該URL語句中需要具備發送號碼、短信內容、接收時間、接收串口號等信息元素，元素內容用替換符來標識，替換符定義如下：發送號碼的替換符為[@1]，短信內容的替換符為[@2]，接收時間的替換符為[@3]，接收串口號的替換符為[@4]。在URL語句中同一替換符只能出現一次。某應用系統的接收URL示例：http://xxx.xxx.xxx.xxx/sms.input.php?telephone_num[@1]&sms_txt=[@2]&date=[@3]&sms_port=[@4]6.6.3開發難度一般，需要進行程序開發。比較適于web網站上使用七、六種開發接口的分析比較開發方式是否涉及編程調試難易度工作量開發難易度所需技能命令行要編程簡單小簡單無外部數據庫可以不編程簡單小簡單了解數據庫開發系統數據庫要編程中等中等簡單了解數據庫開發SOCKET客戶端要編程中等中等中等了解網絡編程客戶端OCX控件要編程簡單小簡單無HTTP協議方式要編程簡單小簡單無注：開發工作量小于4小時為“小”，2工作日之內為“中等”。八、在MSSQLServer中安裝開發平臺數據庫8.1方法一：通過附加數據庫方式實現步驟如下：打開企業管理器，依次展開SQLServer組，右鍵單擊“數據庫”，選擇“所有任務”→“附加數據庫”。如圖：然后點擊瀏覽按鈕，找到安裝目錄（默認安裝目錄為：C:\ProgramFiles\SmsSDK）下的sms_Data.MDF。單擊“確定”完成。如圖：注意事項：由于重裝軟件會覆蓋掉安裝目錄下的sms_Data.MDF和sms_Data.LDF文件，所以您可以將這2個文件復制到其他目錄再附加；或者在重裝軟件時，做好這2個文件的備份工作。8.2方法二：