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

Версия 13:44, 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

Содержание

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

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

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

[Секция]

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

«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]».

@@ Строка 1: / Строка 1: @@
 '''Файл конфигурации СМС-сервера''' — это файл конфигурации, в котором хранятся [[Настройка СМС-сервера|настройки]] [[СМС-сервер]]а.
-Этот файл расположен в папке, в которую установлен СМС-сервер, и называется <tt>TMComDevs.ini</tt>.
+Этот файл расположен в папке, в которую установлен СМС-сервер, и называется {{code|[[TMComDevs.ini]]}}.
 Содержимое файла конфигурации может выглядеть так:
@@ Строка 27: / Строка 27: @@
 == Синтаксис файла конфигурации ==
-Файл конфигурации [[СМС-сервер]]а содержит данные в формате <tt>ini</tt>-файла, то есть данные, записанные в виде <tt>параметр=значение</tt>.
+Файл конфигурации [[СМС-сервер]]а содержит данные в формате {{code|ini}}-файла, то есть данные, записанные в виде {{code|параметр=значение}}.
 Все параметры разбиты на ''секции'', каждая из которых имеет имя и обозначается следующим образом:
@@ Строка 47: / Строка 47: @@
 Комментарии, наличие которых в тексте несет исключительно информационный смысл, не обрабатываются.
-Они начинаются со знака <tt>;</tt> и занимают одну целую строку:
+Они начинаются со знака {{code|;}} и занимают одну целую строку:
   [Секция]
@@ Строка 58: / Строка 58: @@
 === Секция общих настроек ===
-Первая секция — <tt>[TMComDevs]</tt>.
+Первая секция — {{code|[TMComDevs]}}.
 В ней присутствует несколько параметров:
-* <tt>DatabaseName</tt> — путь к базе данных в виде <tt>компьютер:путь</tt>, где <tt>компьютер</tt> — имя или ip-адрес компьютера, на котором установлен [[Firebird]] и работает база, а <tt>путь</tt> — ''абсолютный путь'' к базе данных.
+* {{code|DatabaseName}} — путь к базе данных в виде {{code|компьютер:путь}}, где {{code|компьютер}} — имя или ip-адрес компьютера, на котором установлен [[Firebird]] и работает база, а {{code|путь}} — ''абсолютный путь'' к базе данных.
-* <tt>UserName</tt> — имя пользователя, под которым происходит соединение с базой данных. Не требует редактирования в большинстве случаев.
+* {{code|UserName}} — имя пользователя, под которым происходит соединение с базой данных. Не требует редактирования в большинстве случаев.
-* <tt>Password</tt> — шифрованный пароль для подключения к базе данных. Не требует редактирования в большинстве случаев.
+* {{code|Password}} — шифрованный пароль для подключения к базе данных. Не требует редактирования в большинстве случаев.
-* <tt>LogFileName</tt> — важный параметр, который содержит путь к файлу [[Журнал работы|журнала работы]] СМС-сервера.
+* {{code|LogFileName}} — важный параметр, который содержит путь к файлу [[Журнал работы|журнала работы]] СМС-сервера.
-* <tt>RefreshInterval</tt> — время обновления задач для сервера (в секундах). По умолчанию устанавливается значение <tt>10</tt>. Это значит, что каждые 10 секунд СМС-сервер собирает задачи по отправке и приему сообщений и выполняет их.
+* {{code|RefreshInterval}} — время обновления задач для сервера (в секундах). По умолчанию устанавливается значение {{code|10}}. Это значит, что каждые 10 секунд СМС-сервер собирает задачи по отправке и приему сообщений и выполняет их.
 === Секции частных настроек устройств ===
-Далее может быть несколько секций <tt>[TMComDeviceX]</tt> (<tt>X</tt> — порядковый номер секции и [[ИД устройства]] одновременно).
+Далее может быть несколько секций {{code|[TMComDeviceX]}} ({{code|X}} — порядковый номер секции и [[ИД устройства]] одновременно).
-Нумерация секций начинается с 0, поэтому первая секция — <tt>[TMComDevice0]</tt>, вторая — <tt>[TMComDevice1]</tt> и т. д.
+Нумерация секций начинается с 0, поэтому первая секция — {{code|[TMComDevice0]}}, вторая — {{code|[TMComDevice1]}} и т. д.
 Нарушение этого правила влечет некорректную работу СМС-сервера.
-В секции <tt>[TMComDeviceX]</tt> определяется устройство связи, в зависимости от этого могу меняться параметры:
+В секции {{code|[TMComDeviceX]}} определяется устройство связи, в зависимости от этого могу меняться параметры:
 ==== Сотовый телефон ====
-Ниже указан список параметров, которые могут следовать после секции <tt>TMComDeviceX</tt>, относящихся к сотовым телефонам и GSM-шлюзам.
+Ниже указан список параметров, которые могут следовать после секции {{code|TMComDeviceX}}, относящихся к сотовым телефонам и GSM-шлюзам.
-# <tt>Name</tt> — название устройства, например, <tt>Name=Nokia 32</tt>.
+# {{code|Name}} — название устройства, например, {{code|Name=Nokia 32}}.
-# <tt>TypeID</tt> — идентификатор устройства (см. ниже). Здесь — <tt>TypeID=1</tt>
+# {{code|TypeID}} — идентификатор устройства (см. ниже). Здесь — {{code|TypeID=1}}
-# <tt>Active</tt> — флаг активности. Если установлено значение <tt>Active=1</tt>, устройство активно; если <tt>Active=0</tt>, то задачи этим устройством не обрабатываются.
+# {{code|Active}} — флаг активности. Если установлено значение {{code|Active=1}}, устройство активно; если {{code|Active=0}}, то задачи этим устройством не обрабатываются.
-# <tt>CityCode</tt> — код вашего города. Например, <tt>CityCode=+73412</tt>.
+# {{code|CityCode}} — код вашего города. Например, {{code|CityCode=+73412}}.
-# <tt>LogFile</tt> — [[журнал работы устройства связи]]. Например, <tt>LogFile=C:\TMComDevs\Logs\TMCD_Nokia32.log</tt>.
+# {{code|LogFile}} — [[журнал работы устройства связи]]. Например, {{code|LogFile=C:\TMComDevs\Logs\TMCD_Nokia32.log}}.
-# <tt>CellLogFile</tt> — [[журнал отправки и приема СМС-сообщений]], содержащий команды, вызываемые для работы сотового телефона, а точнее — встроенного в него модема. Например, <tt>CellLogFile=C:\TMComDevs\Logs\Nokia32_sms.log</tt>.
+# {{code|CellLogFile}} — [[журнал отправки и приема СМС-сообщений]], содержащий команды, вызываемые для работы сотового телефона, а точнее — встроенного в него модема. Например, {{code|CellLogFile=C:\TMComDevs\Logs\Nokia32_sms.log}}.
-# <tt>CellCOMPort</tt> — важный параметр, определяющий, к какому COM-порту подключен сотовый телефон. О том, как это узнать, читайте ниже.
+# {{code|CellCOMPort}} — важный параметр, определяющий, к какому COM-порту подключен сотовый телефон. О том, как это узнать, читайте ниже.
-# <tt>SMSRecv</tt> — флаг, включающий или отключающий сбор входящих сообщений с сотового телефона. Если флаг выставлен (<tt>SMSRecv=1</tt>), то входящие сообщения будут копироваться; если <tt>SMSRecv=0</tt>, то не будут.
+# {{code|SMSRecv}} — флаг, включающий или отключающий сбор входящих сообщений с сотового телефона. Если флаг выставлен ({{code|SMSRecv=1}}), то входящие сообщения будут копироваться; если {{code|SMSRecv=0}}, то не будут.
-# <tt>SendSMSDelay</tt> — интервал между отправками сообщений (в миллисекундах). По умолчанию устанавливается значение <tt>3000</tt>: <tt>SendSMSDelay=3000</tt>. Это означает, что сообщения отправляются каждые 3 секунды.
+# {{code|SendSMSDelay}} — интервал между отправками сообщений (в миллисекундах). По умолчанию устанавливается значение {{code|3000}}: {{code|SendSMSDelay=3000}}. Это означает, что сообщения отправляются каждые 3 секунды.
-# <tt>CellDeleteSMS</tt> — флаг, отвечающий за автоматическое удаление всех сообщений с устройства. Если флаг установлен (<tt>CellDeleteSMS=1</tt>), то сообщения удаляются автоматически после отправки 25 сообщений и при инициализации СМС-сервера.
+# {{code|CellDeleteSMS}} — флаг, отвечающий за автоматическое удаление всех сообщений с устройства. Если флаг установлен ({{code|CellDeleteSMS=1}}), то сообщения удаляются автоматически после отправки 25 сообщений и при инициализации СМС-сервера.
-# <tt>CellHangUpOnRing</tt> — флаг, отвечающий за автоматический сброс входящего звонка. Если флаг установлен (<tt>CellHangUpOnRing=1</tt>), то все входящие звонки будут сбрасываться, чтобы не было препятствий для отправки и приема сообщений.
+# {{code|CellHangUpOnRing}} — флаг, отвечающий за автоматический сброс входящего звонка. Если флаг установлен ({{code|CellHangUpOnRing=1}}), то все входящие звонки будут сбрасываться, чтобы не было препятствий для отправки и приема сообщений.
 Пример секции:
@@ Строка 108: / Строка 108: @@
 Для e-mail-гейта существует особый список параметров.
-# <tt>SMTPServer</tt> — IP-адрес или DNS-имя SMTP-сервера, принимающего e-mail-сообщения и преобразующего их в СМС-сообщения.
+# {{code|SMTPServer}} — IP-адрес или DNS-имя SMTP-сервера, принимающего e-mail-сообщения и преобразующего их в СМС-сообщения.
-# <tt>Login</tt> — логин для авторизации на SMTP-сервере.
+# {{code|Login}} — логин для авторизации на SMTP-сервере.
-# <tt>Password</tt> — пароль для авторизации на SMTP-сервере.
+# {{code|Password}} — пароль для авторизации на SMTP-сервере.
-# <tt>FromAddress</tt> — адрес отправителя письма.
+# {{code|FromAddress}} — адрес отправителя письма.
-# <tt>FromName</tt> — имя отправителя письма.
+# {{code|FromName}} — имя отправителя письма.
-# <tt>Subject</tt> — тема отправляемого письма (задается в параметрах и не может быть изменена в ходе работы [[СМС-сервер]]а, но может содержать особый тег, см. ниже).
+# {{code|Subject}} — тема отправляемого письма (задается в параметрах и не может быть изменена в ходе работы [[СМС-сервер]]а, но может содержать особый тег, см. ниже).
-# <tt>CharSet</tt> — кодировка писем (по умолчанию, <tt>windows-1251</tt>).
+# {{code|CharSet}} — кодировка писем (по умолчанию, {{code|windows-1251}}).
-# <tt>ContentType</tt> — mime-тип содержимого писем (по умолчанию, <tt>text/plain</tt>).
+# {{code|ContentType}} — mime-тип содержимого писем (по умолчанию, {{code|text/plain}}).
-# <tt>ConnectionTimeout</tt> — время ожидания соединения с сервером (в миллисекундах).
+# {{code|ConnectionTimeout}} — время ожидания соединения с сервером (в миллисекундах).
-# <tt>SendSMSDelay</tt> — интервал между отправками сообщений (в миллисекундах).
+# {{code|SendSMSDelay}} — интервал между отправками сообщений (в миллисекундах).
-# <tt>MessageTemplate</tt> — [[файл шаблона сообщения]].
+# {{code|MessageTemplate}} — [[файл шаблона сообщения]].
-# <tt>ProviderLogin</tt> — логин для авторизации у провайдера.
+# {{code|ProviderLogin}} — логин для авторизации у провайдера.
-# <tt>ProviderPassword</tt> — пароль для авторизации у провайдера.
+# {{code|ProviderPassword}} — пароль для авторизации у провайдера.
 Пример:
@@ Строка 143: / Строка 143: @@
 ===== Параметр Subject =====
 {{info|
-Для параметра <tt>Subject</tt> могут быть использованы теги, которые используются в [[EMailMessageTemplate.txt|файле шаблона сообщения]] (не путать с [[тег]]ами, используемыми в шаблонах СМС-сообщений!).
+Для параметра {{code|Subject}} могут быть использованы теги, которые используются в [[EMailMessageTemplate.txt|файле шаблона сообщения]] (не путать с [[тег]]ами, используемыми в шаблонах СМС-сообщений!).
 }}
 === Поиск COM-порта, к которому подключен сотовый телефон ===
-Чтобы узнать, к какому COM-порту подключен сотовый телефон, откройте диспетчер устройств ''(Панель управления → Система → Диспетчер устройств)'', в дереве устройств найдите пункт '''Модемы''', раскройте его и откройте свойства модема, соответствующего вашему сотовому телефону.
+Чтобы узнать, к какому COM-порту подключен сотовый телефон, откройте диспетчер устройств ({{button|Панель управления}} → {{button|Система}} → {{button|Диспетчер устройств}}), в дереве устройств найдите пункт {{button|Модемы}}, раскройте его и откройте свойства модема, соответствующего вашему сотовому телефону.
-Если вы не можете найти пункт '''Модемы''', или модем вашего сотового телефона отсутствует в этом списке, возможно, вы не установили драйвер для телефона.
+Если вы не можете найти пункт {{button|Модемы}}, или модем вашего сотового телефона отсутствует в этом списке, возможно, вы не установили драйвер для телефона.
 Поиск и установка драйвера входит в список задач вашего технического специалиста и в большинстве случаев решается тривиально.
-В окне свойств модема найдите вкладку «Модем» и откройте ее.
+В окне свойств модема найдите вкладку {{tab|Модем}} и откройте ее.
 На панели будет написан номер COM-порта (например, “COM1” или “COM4”).
-Запомните этот порт, чтобы указать его в качестве значения параметра <tt>CellCOMPort</tt> секции <tt>[TMComDeviceX]</tt>.
+Запомните этот порт, чтобы указать его в качестве значения параметра {{code|CellCOMPort}} секции {{code|[TMComDeviceX]}}.
 [[Категория:Файлы конфигурации]]
 [[Категория:Настройка]]
 [[Категория:Модуль СМС]]