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

Версия 13:36, 30 сентября 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

Содержание

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

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

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

[Секция]

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

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

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

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

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

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

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

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

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

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

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

«DatabaseName» — путь к базе данных в виде «компьютер:путь», где «компьютер» — имя или ip-адрес компьютера, на котором установлен Firebird и работает база, а «путь» — абсолютный путь к базе данных.
«UserName» — имя пользователя, под которым происходит соединение с базой данных. Не требует редактирования в большинстве случаев.
«Password» — шифрованный пароль для подключения к базе данных. Не требует редактирования в большинстве случаев.
«LogFileName» — важный параметр, который содержит путь к файлу журнала работы СМС-сервера.
«RefreshInterval» — время обновления задач для сервера (в секундах). По умолчанию устанавливается значение «10». Это значит, что каждые 10 секунд СМС-сервер собирает задачи по отправке и приему сообщений и выполняет их.
«UseNokiaDevices» — глобальный флаг, включающий (если =«1») или отключающий («0») работу с Nokia PC Suite.
«NokiaDllFolder» — путь к папке, в которую установлен Nokia PC Suite (если «UseNokiaDevices»=«1»). Если Nokia PC Suite установлен в папку по умолчанию, то путь — такой: «C:\Program Files\PC Connectivity Solution».

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

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

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

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

«Name» — название устройства, например, «Name»=«Nokia 32».
«TypeID» — идентификатор устройства (см. ниже). Здесь — «TypeID»=«1»
«Active» — флаг активности. Если установлено значение «Active»=«1», устройство активно; если «Active»=«0», то задачи этим устройством не обрабатываются.
«CityCode» — код вашего города. Например, «CityCode»=«+73412».
«LogFile» — журнал работы устройства связи. Например, «LogFile»=«C:\TMComDevs\Logs\TMCD_Nokia32.log».
«CellLogFile» — журнал отправки и приема СМС-сообщений, содержащий команды, вызываемые для работы сотового телефона, а точнее — встроенного в него модема. Например, «CellLogFile»=«C:\TMComDevs\Logs\Nokia32_sms.log».
«CellCOMPort» — важный параметр, определяющий, к какому COM-порту подключен сотовый телефон. О том, как это узнать, читайте ниже.
«SMSRecv» — флаг, включающий или отключающий сбор входящих сообщений с сотового телефона. Если флаг выставлен («SMSRecv»=«1»), то входящие сообщения будут копироваться; если «SMSRecv»=«0», то не будут.
«SendSMSDelay» — интервал между отправками сообщений (в миллисекундах). По умолчанию устанавливается значение «3000»: «SendSMSDelay»=«3000». Это означает, что сообщения отправляются каждые 3 секунды.
«CellDeleteSMS» — флаг, отвечающий за автоматическое удаление всех сообщений с устройства. Если флаг установлен («CellDeleteSMS»=«1»), то сообщения удаляются автоматически после отправки 25 сообщений и при инициализации СМС-сервера.
«CellHangUpOnRing» — флаг, отвечающий за автоматический сброс входящего звонка. Если флаг установлен («CellHangUpOnRing»=«1»), то все входящие звонки будут сбрасываться, чтобы не было препятствий для отправки и приема сообщений.

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

[TMComDevice0]
IsNokiaDevice=0
Name=SonyEricsson Walkman
TypeID=1
Active=1
LogFile=C:\TMComDevs\Logs\TMCD_SEW.log
CellLogFile=C:\TMComDevs\Logs\SEW_sms.log
CellCOMPort=COM1
SMSRecv=1
SendSMSDelay=5000
CellConfigFile=C:\TMComDevs\lcell.conf
CellDeleteSMS=1
CellHangUpOnRing=1

Сотовый телефон + Nokia PC Suite

СМС-сервер поддерживает работу с Nokia PC Suite, поэтому если вы располагаете сотовым телефоном Nokia, то для вас настройка упрощена максимально. Чтобы отправлять и принимать СМС-сообщения через телефон Nokia, нужны следующие компоненты:

Практически вся настройка (за исключением фильтров и шаблонов) происходит в файле «TMComDevs.ini».

Наряду с параметрами сотового телефона как модема, имеются особые параметры, которые указывают на то, что данный сотовый телефон обслуживается ПО Nokia PC Suite:

«IsNokiaDevice» — флаг, указывающий на то, что данный телефон обслуживается средствами Nokia PC Suite. «1» → обслуживается, «0» — работает как стандартный GSM-модем.

Следующее добавить к предыдущему пункту, чтобы сообщения отправлялись с телефона средствами Nokia PC Suite:

Установите Nokia PC Suite и СМС-сервер на компьютер, к которому подключен телефон.
Откройте файл конфигурации («TMComDevs.ini», о нем и идет речь во всей статье).
В секцию «[TMComDevs]» добавьте запись «{{{1}}}».
Туда же добавьте запись Шаблон:NokiaDllFolder=путь-к-NPCS, где «путь-к-NPCS» — это путь к папке, в которую установлен Nokia PC Suite (по умолчанию, «C:\Program Files\PC Connectivity Solution»).
В секцию, относящейся к телефону Nokia (например, «[TMComDevice0]»), добавьте запись «{{{1}}}».
Сохраните файл и перезапустите СМС-сервер.

После этого СМС-сервер будет считать устройство с ИД, равным «0», телефоном, к которому нужно обращаться средствами Nokia PC Suite.

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

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

E-mail-гейт

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

«SMTPServer» — IP-адрес или DNS-имя SMTP-сервера, принимающего e-mail-сообщения и преобразующего их в СМС-сообщения.
«Login» — логин для авторизации на SMTP-сервере.
«Password» — пароль для авторизации на SMTP-сервере.
«FromAddress» — адрес отправителя письма.
«FromName» — имя отправителя письма.
«Subject» — тема отправляемого письма (задается в параметрах и не может быть изменена в ходе работы СМС-сервера, но может содержать особый тег, см. ниже).
«CharSet» — кодировка писем (по умолчанию, «windows-1251»).
«ContentType» — mime-тип содержимого писем (по умолчанию, «text/plain»).
«ConnectionTimeout» — время ожидания соединения с сервером (в миллисекундах).
«SendSMSDelay» — интервал между отправками сообщений (в миллисекундах).
«MessageTemplate» — файл шаблона сообщения.
«ProviderLogin» — логин для авторизации у провайдера.
«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» → порядковый ИД устройства).

Ссылки

@@ Строка 78: / Строка 78: @@
 Ниже указан список параметров, которые могут следовать после секции {{code|TMComDeviceX}}, относящихся к сотовым телефонам и GSM-шлюзам.
-# {{code|Name}} — название устройства, например, {{code|Name=Nokia 32}}.
+# {{code|Name}} — название устройства, например, {{code|Name}}={{code|Nokia 32}}.
-# {{code|TypeID}} — идентификатор устройства (см. ниже). Здесь — {{code|TypeID=1}}
+# {{code|TypeID}} — идентификатор устройства (см. ниже). Здесь — {{code|TypeID}}={{code|1}}
-# {{code|Active}} — флаг активности. Если установлено значение {{code|Active=1}}, устройство активно; если {{code|Active=0}}, то задачи этим устройством не обрабатываются.
+# {{code|Active}} — флаг активности. Если установлено значение {{code|Active}}={{code|1}}, устройство активно; если {{code|Active}}={{code|0}}, то задачи этим устройством не обрабатываются.
-# {{code|CityCode}} — код вашего города. Например, {{code|CityCode=+73412}}.
+# {{code|CityCode}} — код вашего города. Например, {{code|CityCode}}={{code|+73412}}.
-# {{code|LogFile}} — [[журнал работы устройства связи]]. Например, {{code|LogFile=C:\TMComDevs\Logs\TMCD_Nokia32.log}}.
+# {{code|LogFile}} — [[журнал работы устройства связи]]. Например, {{code|LogFile}}={{code|C:\TMComDevs\Logs\TMCD_Nokia32.log}}.
-# {{code|CellLogFile}} — [[журнал отправки и приема СМС-сообщений]], содержащий команды, вызываемые для работы сотового телефона, а точнее — встроенного в него модема. Например, {{code|CellLogFile=C:\TMComDevs\Logs\Nokia32_sms.log}}.
+# {{code|CellLogFile}} — [[журнал отправки и приема СМС-сообщений]], содержащий команды, вызываемые для работы сотового телефона, а точнее — встроенного в него модема. Например, {{code|CellLogFile}}={{code|C:\TMComDevs\Logs\Nokia32_sms.log}}.
 # {{code|CellCOMPort}} — важный параметр, определяющий, к какому COM-порту подключен сотовый телефон. О том, как это узнать, читайте ниже.
-# {{code|SMSRecv}} — флаг, включающий или отключающий сбор входящих сообщений с сотового телефона. Если флаг выставлен ({{code|SMSRecv=1}}), то входящие сообщения будут копироваться; если {{code|SMSRecv=0}}, то не будут.
+# {{code|SMSRecv}} — флаг, включающий или отключающий сбор входящих сообщений с сотового телефона. Если флаг выставлен ({{code|SMSRecv}}={{code|1}}), то входящие сообщения будут копироваться; если {{code|SMSRecv}}={{code|0}}, то не будут.
-# {{code|SendSMSDelay}} — интервал между отправками сообщений (в миллисекундах). По умолчанию устанавливается значение {{code|3000}}: {{code|SendSMSDelay=3000}}. Это означает, что сообщения отправляются каждые 3 секунды.
+# {{code|SendSMSDelay}} — интервал между отправками сообщений (в миллисекундах). По умолчанию устанавливается значение {{code|3000}}: {{code|SendSMSDelay}}={{code|3000}}. Это означает, что сообщения отправляются каждые 3 секунды.
-# {{code|CellDeleteSMS}} — флаг, отвечающий за автоматическое удаление всех сообщений с устройства. Если флаг установлен ({{code|CellDeleteSMS=1}}), то сообщения удаляются автоматически после отправки 25 сообщений и при инициализации СМС-сервера.
+# {{code|CellDeleteSMS}} — флаг, отвечающий за автоматическое удаление всех сообщений с устройства. Если флаг установлен ({{code|CellDeleteSMS}}={{code|1}}), то сообщения удаляются автоматически после отправки 25 сообщений и при инициализации СМС-сервера.
-# {{code|CellHangUpOnRing}} — флаг, отвечающий за автоматический сброс входящего звонка. Если флаг установлен ({{code|CellHangUpOnRing=1}}), то все входящие звонки будут сбрасываться, чтобы не было препятствий для отправки и приема сообщений.
+# {{code|CellHangUpOnRing}} — флаг, отвечающий за автоматический сброс входящего звонка. Если флаг установлен ({{code|CellHangUpOnRing}}={{code|1}}), то все входящие звонки будут сбрасываться, чтобы не было препятствий для отправки и приема сообщений.
 Пример секции: