Файл конфигурации сервера сообщений (Архив) — различия между версиями

Версия 13:48, 29 сентября 2009

Файл конфигурации СМС-сервера — это файл конфигурации, в котором хранятся настройки СМС-сервера. Этот файл расположен в папке, в которую установлен СМС-сервер, и называется «TMComDevs.ini».

Содержимое файла конфигурации может выглядеть так:

[TMComDevs]
DatabaseName=LOCALHOST:C:\Program Files\Taxi\Data.gdb
UserName=TAXI
Password=bCgj4bSr
LogFileName=C:\Program Files\Taxi\TMComDevs\Logs\TMComDevs.log
RefreshInterval=10

[TMComDevice0]
Name=Nokia 32
TypeID=1
Active=1
LogFile=C:\Program Files\Taxi\TMComDevs\Logs\TMCD_Nokia32.log
CellLogFile=C:\Program Files\Taxi\TMComDevs\Logs\Nokia32_sms.log
CellCOMPort=COM1
SMSRecv=1
SendSMSDelay=5000
CellConfigFile=C:\Program Files\Taxi\TMComDevs\lcell.conf
CellDeleteSMS=1
CellHangUpOnRing=1

Синтаксис файла конфигурации

Файл конфигурации СМС-сервера содержит данные в формате «ini»-файла, то есть данные, записанные в виде «параметр»=«значение». Все параметры разбиты на секции, каждая из которых имеет имя и обозначается следующим образом:

[Секция]

Все параметры, которые идут после этого обозначения и до следующей секции, принадлежат текущей секции:

[Секция]
Параметр=значение
Другой_параметр=Другое значение

Секции могут идти друг за другом:

[Секция1]
Параметр=значение

[Секция2]
Другой_параметр=Другое значение

Комментарии, наличие которых в тексте несет исключительно информационный смысл, не обрабатываются. Они начинаются со знака «;» и занимают одну целую строку:

[Секция]
;Если этот параметр принимает значение "Значение", мир, определенно, может достигнуть Нирваны
Параметр=Значение

Настройки, хранимые в файле конфигурации

В файле конфигурации СМС-сервера хранятся настройки, отвечающие за подключение СМС-сервера к базе данных, а также параметры устройств, которые опрашивает СМС-сервер. Все настройки делятся на однозначно определенные секции.

Секция общих настроек

Первая секция — «[TMComDevs]». В ней присутствует несколько параметров:

• «DatabaseName» — путь к базе данных в виде «компьютер:путь», где «компьютер» — имя или ip-адрес компьютера, на котором установлен Firebird и работает база, а «путь» — абсолютный путь к базе данных.
• «UserName» — имя пользователя, под которым происходит соединение с базой данных. Не требует редактирования в большинстве случаев.
• «Password» — шифрованный пароль для подключения к базе данных. Не требует редактирования в большинстве случаев.
• «LogFileName» — важный параметр, который содержит путь к файлу журнала работы СМС-сервера.
• «RefreshInterval» — время обновления задач для сервера (в секундах). По умолчанию устанавливается значение «10». Это значит, что каждые 10 секунд СМС-сервер собирает задачи по отправке и приему сообщений и выполняет их.

Секции частных настроек устройств

Далее может быть несколько секций «[TMComDeviceX]» («X» — порядковый номер секции и ИД устройства одновременно). Нумерация секций начинается с 0, поэтому первая секция — «[TMComDevice0]», вторая — «[TMComDevice1]» и т. д. Нарушение этого правила влечет некорректную работу СМС-сервера. В секции «[TMComDeviceX]» определяется устройство связи, в зависимости от этого могу меняться параметры:

Сотовый телефон

Ниже указан список параметров, которые могут следовать после секции «TMComDeviceX», относящихся к сотовым телефонам и GSM-шлюзам.

1. «Name» — название устройства, например, «{{{1}}}».
2. «TypeID» — идентификатор устройства (см. ниже). Здесь — «{{{1}}}»
3. «Active» — флаг активности. Если установлено значение «{{{1}}}», устройство активно; если «{{{1}}}», то задачи этим устройством не обрабатываются.
4. «CityCode» — код вашего города. Например, «{{{1}}}».
5. «LogFile» — журнал работы устройства связи. Например, «{{{1}}}».
6. «CellLogFile» — журнал отправки и приема СМС-сообщений, содержащий команды, вызываемые для работы сотового телефона, а точнее — встроенного в него модема. Например, «{{{1}}}».
7. «CellCOMPort» — важный параметр, определяющий, к какому COM-порту подключен сотовый телефон. О том, как это узнать, читайте ниже.
8. «SMSRecv» — флаг, включающий или отключающий сбор входящих сообщений с сотового телефона. Если флаг выставлен («{{{1}}}»), то входящие сообщения будут копироваться; если «{{{1}}}», то не будут.
9. «SendSMSDelay» — интервал между отправками сообщений (в миллисекундах). По умолчанию устанавливается значение «3000»: «{{{1}}}». Это означает, что сообщения отправляются каждые 3 секунды.
10. «CellDeleteSMS» — флаг, отвечающий за автоматическое удаление всех сообщений с устройства. Если флаг установлен («{{{1}}}»), то сообщения удаляются автоматически после отправки 25 сообщений и при инициализации СМС-сервера.
11. «CellHangUpOnRing» — флаг, отвечающий за автоматический сброс входящего звонка. Если флаг установлен («{{{1}}}»), то все входящие звонки будут сбрасываться, чтобы не было препятствий для отправки и приема сообщений.

Пример секции:

[TMComDevice0]
Name=Nokia 32
TypeID=1
Active=1
LogFile=C:\TMComDevs\Logs\TMCD_Nokia32.log
CellLogFile=C:\TMComDevs\Logs\Nokia32_sms.log
CellCOMPort=COM1
SMSRecv=1
SendSMSDelay=5000
CellConfigFile=C:\TMComDevs\lcell.conf
CellDeleteSMS=1
CellHangUpOnRing=1

E-mail-гейт

Для e-mail-гейта существует особый список параметров.

1. «SMTPServer» — IP-адрес или DNS-имя SMTP-сервера, принимающего e-mail-сообщения и преобразующего их в СМС-сообщения.
2. «Login» — логин для авторизации на SMTP-сервере.
3. «Password» — пароль для авторизации на SMTP-сервере.
4. «FromAddress» — адрес отправителя письма.
5. «FromName» — имя отправителя письма.
6. «Subject» — тема отправляемого письма (задается в параметрах и не может быть изменена в ходе работы СМС-сервера, но может содержать особый тег, см. ниже).
7. «CharSet» — кодировка писем (по умолчанию, «windows-1251»).
8. «ContentType» — mime-тип содержимого писем (по умолчанию, «text/plain»).
9. «ConnectionTimeout» — время ожидания соединения с сервером (в миллисекундах).
10. «SendSMSDelay» — интервал между отправками сообщений (в миллисекундах).
11. «MessageTemplate» — файл шаблона сообщения.
12. «ProviderLogin» — логин для авторизации у провайдера.
13. «ProviderPassword» — пароль для авторизации у провайдера.

Пример:

[TMComDevice1]
SMTPServer=smtp.foo.ru
Login=foo
Password=bar
FromAddress=root@quz.ru
FromName=Root
Subject=СМС-сообщение
CharSet=windows-1251
ContentType=text/plain
ConnectionTimeout=5000
SendSMSDelay=500
MessageTemplate=C:\Program Files\Taxi\TMComDevs\EmailMessageTemplate.txt
ProviderLogin=
ProviderPassword=

Параметр Subject

Для параметра «Subject» могут быть использованы теги, которые используются в файле шаблона сообщения (не путать с тегами, используемыми в шаблонах СМС-сообщений!).

Поиск COM-порта, к которому подключен сотовый телефон

Чтобы узнать, к какому COM-порту подключен сотовый телефон, откройте диспетчер устройств («Панель управления» → «Система» → «Диспетчер устройств»), в дереве устройств найдите пункт «Модемы», раскройте его и откройте свойства модема, соответствующего вашему сотовому телефону. Если вы не можете найти пункт «Модемы», или модем вашего сотового телефона отсутствует в этом списке, возможно, вы не установили драйвер для телефона. Поиск и установка драйвера входит в список задач вашего технического специалиста и в большинстве случаев решается тривиально.

В окне свойств модема найдите вкладку «Модем» и откройте ее. На панели будет написан номер COM-порта (например, “COM1” или “COM4”). Запомните этот порт, чтобы указать его в качестве значения параметра «CellCOMPort» секции «[TMComDeviceX]» («X» → порядковый ИД устройства).