Adding script application into MobilChange

Introduction

This document provides procedures for adding a new script application in MobilChange and configuring filters and routing of incoming SMS messages into the application.

How to add a new script application in MobilChange

The tool for adding of script applications in MobilChange can be found here: Start Menu -> Programs -> MobilChange -> Scripting -> Add a new script application

In the first dialog, enter the name of the script application and its description.

The name should consist of one word without any diacritics. The name will be entered by your application in the OnInit() function.

Here you need to enter regular expressions used to determine, whether the received SMS is for your application.

Regular expression are described in this document.

Telephone numbers are processed in the international format without the plus mark (+) at the beginning, i.e. +420603899285 will be entered as 420603899285. The format must be considered when constructing Regexp!

Instead of a regular expression for a telephone number you can enter an alias in this format: $<alias name>, e.g. $users.

If you put any sub expressions into brackets in a regular expression for text, you can further use their values (in an e-mail address or application parameters).

Now, enter what should happen with an SMS complying with the previous rules.

As you want to route SMS messages into your application, in the upper edit box enter the application name in this format: $A<application name> , i.e. $Apizza for the "pizza" application.

Below, you enter what text should be sent to the application. You can use these variables: $0 (which is substituted by the text of the entire incoming SMS) and $1 to $9 (which are substituted by the contents of a regular sub expression of an entered number).

Example: If you entered in the previous dialog a filter rule for a message text as
#pizza (.*)
then if an SMS with "#pizza with elephants" was received, your application would receive the following texts depending on the setting:

$0 #pizza with elephants

$1 with elephants

HI $1 BLABLA HI with elephants BLABLA

If the SMS meets the filter requirements, it will be sent to the application. And what should happen with it next?

Terminate processing of this SMS--An SMS will be transferred to the application and then deleted. It will not be sent to any other application or user.

Process other rules as well--If the SMS meets the requirements of other rules, it will also be sent to other applications. Subsequently, it will also be sent to an automatic recipient (if this mode is on and if there is an automatic recipient) and to the default recipient (the public folder).

Process automatic recipients--The SMS will not be transferred to other applications, even if it complies with their rules. It will, however, be sent to the automatic recipient (if the mode is on and if there is any automatic recipient) and the default recipient (the public folder).

You will only be able to see this dialog if your application has not yet been saved in the MobilChange/script/ directory. Save it there and press OK.

The file with your application must be named <application name>.vbs where the application name was entered in the first dialog when adding a script.

If you did not save the application in MobilChange/script/ directory, you will see this dialog. When you press OK, the setup program will close.

If all was correct, this dialog will be displayed and the mxRouteCfg will be run for you to try whether the routing rule works correctly. The mxRouteCfg program is described in this document.

To enable loading of the new routing rules in MobilChange, you must restart the MobilChange.Kernel service.

$0	#pizza with elephants
$1	with elephants
HI $1 BLABLA	HI with elephants BLABLA