3.7.

1 Переменные

Для действий, которые выполняются в правилах приема и отправки SMS сообщений, в большинстве
текстовых полей ввода формы "Настройка действия ..." можно указывать предопределенные
переменные, на место которых при выполнении действия будут подставлены значения полей SMS
сообщения.

Предопределены следующие переменные:

<SMS_PHONE> Номер телефона входящего или исходящего сообщения.

<SMS_TEXT> Текст сообщения в кодировке Windows (ANSI).

<SMS_TEXT_OEM> Текст сообщения в кодировке MS_DOS (OEM).

<SMS_DATE> Дата получения для входящего сообщения.

Дата отправки для исходящего сообщения.

<SMS_TIME> Время получения для входящего сообщения.

Время отправки для исходящего сообщения.

 Для значений переменных <SMS_DATE>, <SMS_TIME> используется формат и

разделители, заданные в разделе "Язык и стандарты" операционной системы.

SMSGATE.3 (Версия 3.0.0 beta 1) 32

3.7.2 Действие "Выполнить программу".

Это действие позволяет выполнить внешнюю программу или скрипт (VBScript, JScript). В процессе
выполнения программа может создать в предопределенном формате файл, содержащий SMS
сообщения, которые будут отправлены на указанные номера телефонов.

Закладка “Действие” (рис. 3.7.2.1)

рис. 3.7.2.1

В поле Программа: указывается полный путь к программе, которая должна быть запущена.

В поле Рабочий каталог: указывается полный путь к каталогу, который будет установлен по
умолчанию для указанной программы.

В поле Параметры командной строки: можно задать параметры, которые будут переданы указанной
программе.

 В текстовых полях ввода возможно использовать переменные (см. 3.7.1).

SMSGATE.3 (Версия 3.0.0 beta 1) 33

Закладка “Подтверждение” (рис. 3.7.2.2)

рис. 3.7.2.2

Данная закладка позволяет указать имя файла, который может создать программа в зависимости от
результатов выполнения, содержащий одно или несколько SMS сообщений, которые будут
отправлены на указанные номера телефонов.

В поле Имя файла: указывается имя файла, который содержит одно или несколько сообщений в
зависимости от его формата.

Варианты Формат файла: позволяют выбрать формат файла, в котором будут находиться
сообщения. Поддерживаемые форматы файлов описаны в приложении 5.1.

При выборе формата файла TXT, в поле Отправить файл на указанный телефон: требуется указать
номер телефона, на который нужно отправить сообщение.

Варианты Кодировка: позволяют указать вид кодировки текста при сохранении сообщения в файле.

Опция Удалить файл после отправки позволяет удалить файл после выполнения действия.

 В текстовых полях ввода возможно использовать переменные (см. 3.7.1).

SMSGATE.3 (Версия 3.0.0 beta 1) 34

3.7.3 Действие "Отправить сообщение"

Это действие позволяет отправить SMS сообщение на указанный телефонный номер.

Закладка “Действие” (рис. 3.7.3.1)

рис. 3.7.3.1

В поле Отправить SMS сообщение на указанный телефон: должен быть указан номер телефона, на
который нужно отправить сообщение.

В поле Сообщение: вводится текст сообщения.

 В текстовых полях ввода возможно использовать переменные (см. 3.7.1).

SMSGATE.3 (Версия 3.0.0 beta 1) 35

3.7.4 Действие "Переслать сообщение на группу номеров"

Это действие позволяет переслать SMS сообщение на заданный номер или группу номеров.

Закладка “Действие” (рис. 3.7.4.1)

рис. 3.7.4.1

Кнопки Добавить, Изменить, Удалить позволяют редактировать список номеров телефонов, на

которые будет отправлено SMS сообщение.

SMSGATE.3 (Версия 3.0.0 beta 1) 36

3.7.5 Действие "Выполнить SQL запрос к БД (MSADO)"

Это действие позволяет выполнить SQL запрос к внешней базе данных и в зависимости от результата
послать одно или несколько SMS сообщении, в которых возможно использовать значения полей
запроса.

Взаимодействие с БД осуществляется через объекты MS ADO.

Закладка “Подключение” (рис. 3.7.5.1)

рис. 3.7.5.1

В поле Параметры соединения (ADO): указывают параметры инициализации и соединения,

соответствующие используемому механизму доступа к БД.

Примеры для подключения:

"MS SQL Server"

Provider=SQLOLEDB.1;Initial Catalog=SMSGATE3;Data Source=SQL_SERVER

"ODBC"
Provider=MSDASQL;Data Source=SMSGATE3

"MS Access"
Provider=Microsoft.Jet.OLEDB.4.0;Data Source=SMSGateServer.mdb

 Описание параметров соединения и инициализации можно найти в MSDN или в

документации по OLE DB.

В полях "Пользователь:" и "Пароль:" указываются соответственно имя пользователя и пароль для

доступа к БД, если это требуется. Имя пользователя и пароль можно указать в строке параметров
соединения.

SMSGATE.3 (Версия 3.0.0 beta 1) 37

Закладка “Запрос” (рис. 3.7.5.2)

рис. 3.7.5.2

Данная закладка позволяет ввести текст SQL запроса.

 В текстовых полях ввода возможно использовать переменные (см. 3.7.1).

SMSGATE.3 (Версия 3.0.0 beta 1) 38

Закладка “Подтверждение” (рис.3.7.5.3)

рис. 3.7.5.3

Данная закладка позволяет по результатам выполнения действия сформировать и отправить одно или
несколько SMS сообщений на указанный номер в поле на номер: или на номера телефонов,
полученных в результате запроса к Базе Данных.

Текст сообщения может быть представлен в нескольких вариантах в зависимости от того, получены в
результате выполнения SQL запроса данные или нет.

Опция Вставить поля из SQL запроса позволяет использовать при формировании текста сообщения
значения полей записи, полученных в результате запроса.

Опция Отправить на номер из поля PHONE позволяет отправить сообщение на номер телефона,
значение которого возвращается в поле, имеющем зарезервированное название PHONE.

 Количество сформированных сообщений определяется количеством записей, полученных

в результате выполнения запроса.

 В текстовых полях ввода возможно использовать переменные (см. 3.7.1).

SMSGATE.3 (Версия 3.0.0 beta 1) 39

3.7.6 Действие "Сохранить сообщение"

Это действие позволяет сохранить входящее или исходящее сообщение в указанном файле.

Закладка “Действие” (рис. 3.7.6.1)

рис. 3.7.6.1

В поле Сохранить сообщение в папке: указывается название папка, в которой должен сохраняться
файл SMS сообщения.

SMS сообщение может быть сохранено:

- В новых файл, вариант Создать новый файл.

- Добавлено в существующий файл, вариант Добавить в файл.
Если файл не существует, то будет создан новый файл.

В поле Имя файла: указывается имя файла, в котором будет сохраняться сообщение.

Варианты Формат файла: позволяют выбрать формат файла, в котором будет сохранено сообщение.
Поддерживаемые форматы файлов описаны в приложении 5.1.

Варианты Кодировка: позволяют указать вид кодировки текста при сохранении сообщения в файле.

Опция Сбросить у файла атрибут 'А' – архивный позволяет изменить атрибуты файла после
выполнения действия.

 В текстовых полях ввода возможно использовать переменные (см. 3.7.1).

SMSGATE.3 (Версия 3.0.0 beta 1) 40

3.7.7 Действие "Отправить файл или группу файлов"

Это действие позволяет поместить в очередь на отправку одно или несколько сообщений,
содержащихся в указанных файлах.

Закладка “Действие” (рис. 3.7.7.1)

рис. 3.7.7.1

В поле Послать файл(ы) из папки: указывается полный путь к папке, где находятся файлы
сообщений.

В поле Имя или маска файлов: указывается имя файла или маска группы файлов, сообщения из
которых нужно отправить. В маске файлов используются символы, разрешенные в операционной
системе, например '*', '?'.

Варианты Формат файла: позволяют указать тип файла, содержащего одно или несколько
сообщений. Поддерживаемые форматы файлов описаны в приложении 5.1.

При выборе формата файла TXT, в поле Отправить файл на указанный телефон: требуется указать
номер телефона, на который нужно отправить сообщение.

Опции Удалить файл после отправки и Сбросить у файла атрибут 'А' – архивный позволяют
удалить файл или изменить его атрибуты после выполнения действия.

 В текстовых полях ввода возможно использовать переменные (см. 3.7.1).

SMSGATE.3 (Версия 3.0.0 beta 1) 41

5 Приложения

5.1 Форматы файлов SMS сообщения

Поддерживаются несколько форматов файла, содержащего одно или несколько SMS сообщений,
который может использоваться при отправке сообщений из командной строки (см. 4.4) или для
сохранения или отправки в результате выполнения действий (см. 3.7.2).

TXT формат

Файл содержит только текст SMS сообщения.

 Для TXT формата, текст сообщения должен быть представлен в OEM кодировке при
отправке сообщения из командной строки.

BIN формат

В данной версии не поддерживается.

CSV формат

Каждая строка текстового файла содержит номер телефона и далее через разделитель текст
сообщения.
Поддерживаются следующие разделители полей между номером телефона и текстом сообщения:

+79210000001 Тестовое сообщение 1

+79210000002 Тестовое сообщение 2

"табуляция","пробел" "," ";"

 Для CSV формата, текст сообщения должен быть представлен в OEM кодировке при
отправке сообщения из командной строки.

XML формат

<?xml version="1.0" encoding="Windows-1251"?>

<SMSLIST>
<SMSMESSAGE phone="+79210000000" text="Test message 0"/>
<SMSMESSAGE phone="+79210000001" text="Test message 1"/>
…
</SMSLIST>

 При использовании формата XML возможно задание XML атрибутов сообщения (время
отправки, максимальное время доставки, перекодирование в translit, приоритет отправки,
запрос подтверждения о доставке и т.д.). Описание XML атрибутов SMS сообщения
включено в состав SMSGATE.3 SDK.

 Для XML формата тип кодировки можно указать в заголовке файла при отправке
сообщения из командной строки.

EMS формат

В данной версии не поддерживается.

SMSGATE.3 (Версия 3.0.0 beta 1) 51