Ozeki Message Server 6

SMS API for Microsoft Access developers

In this step-by-step tutorial we explain how to create an Access application, which is capable of sending and receiving SMS messages. In order to use this tutorial, you need an installed copy of OZEKI MESSAGE SERVER and MICROSOFT ACCESS.

Step 1 - Create database table

First you must have a database. You can give it any name. In this example we named it ozeki_ms6_released.

create an access database
Figure 1 - Create an Access database

In this database you need to create two tables. One of these tables is going to be used for sending SMS messages while the other is going to be used for receiving. It is important that the table used for sending messages is named ozekimessageout and the table used for receiving messages is named ozekimessagein. The columns in the tables should be created as presented on the following screenshot. (Figure 2.) Make sure you set the field size of the msg column to 255. You can add additional columns to both tables, but you cannot change the name of the columns used for sms sending and receiving. You can download this database in Access 2003 format from here:

ozeki_ms6_released.mdb (174kb)

specifying of the ozekimessagin and the ozekimessageout table
Figure 2 - Specifying of the Ozekimessagin and the Ozekimessageout table

Step 2 - Setting up windows ODBC driver

In order to use Access you need to set up an ODBC connection. Click on Start / Settings /Control Panel / Administrative Tools and click on the "Data Sources" menu item.(Figure 3).

administrative tools
Figure 3 - Administrative Tools

The following window opens: ODBC Data Source Administrator (Figure 4.) In this window select the System DSN (1) tab. Then click on Add (2).

system dsn
Figure 4 - System DSN

On the Create New Data Source form, select the Microsoft Access Driver (1) and click to Finish (2). (Figure 5.)

creation of the new data source
Figure 5 - Creation of the new data source

This brings up the ODBC Microsoft Access Setup (Figure 6.) form. Set the Data Source Name to MSAccessSystem (1) write some Desciription (2) Click on Select(3). Open the preveously downloaded file, or the file you have created yourself: ozeki_ms6_released.mdb.

selecting database
Figure 6 - Selecting database

Step 3 - Configure OZEKI MESSAGE SERVER to use database connection

This can be done by opening the Plugins menu. Select the Installed Plugins menuitem (Figure 7.)

installation plugins
Figure 7 - Installation plugins

When the form is open, select the database plugin to install. (Figure 8 .)

installation of the database plugin
Figure 8 - Installation of the Database plugin

Next click on Configure! (Figure 9.)

configuration of the database plugin
Figure 9 - Configuration of the Database plugin

If you want to use the database for sending and receiving messages place checkmarks into the Use database for receiving SMS messages and the Use database for sending SMS messages checkbox (2,3). Important: place a checkmark into the Auto connect on startup checkbox (4) as well, to make sure, when you re start the program the database connection will start up automatically. You can define a database connection by clicking on Build database connection (1) (Figure 10.)

configuration in the connection information tab
Figure 10 - Configuration in the Connection information tab

Select the Use Connection String radio button, and click on build (Figure 11.).

connection string
Figure 11 - Connection string

In the Data Link Properties window select the Provider tab and select the OLE DB Provider for ODBC Drivers list item from the OLE DB Provider list box(1). Click on next (2).(Figure 12.)

data link properties
Figure 12 - Data link properties

The Connection tab will appear, Click the drop down menu called "Use data source name" and select MSAccessSystem list item (1,2). Remember in the second step we create the Data Source Name: MSAccessSystem (Figure 5). Make sure the User name is Admin (3). Click to Blank password (4) You should test the connection by clicking on Test Connection (5) (Figure 13.)

choosing of the data source
Figure 13 - Choosing of the data source

If the connection is ok you will see: (Figure 14.)

connection is successfully
Figure 14 - Connection is successfully

When you setup is correct the next window will appear: At the bottom of the window you can see the log if you click on the statusbar. When the Database connection is established the Database plugin 1 : select id,receiver,msg,operator text will appear in the log.

refreshing of the currently installed plugins
Figure 15 - Refreshing of the currently installed plugins

Sending sms via MS Access
When the server starts, go to Access and send a message, by inserting a new record into the ozekimessageout table. You must specify the receiver, enter the message in the msg field and set the status to send! (The incoming SMS messages will appear in the ozekimessagein table.)

content of the ozekimessageout table
Figure 16 - Content of the Ozekimessageout table

OZEKI SMS allow you to control the SQL queries used to access the data in your Access database. In these versions, you must modify these queries to make things work. Here is what you should do:

Remove the apostrophe around the word $id. ('$id' should be changed to $id)

Here is what you should get after modifying the SQL statements:

configuration in the sql templates
Figure 17 - Configuration in the SQL templates

Notice that the apostrophe around the id field is removed.