Файл конфигурации сервера сообщений (Архив)

Материал из TaxiMaster
Версия от 14:05, 20 сентября 2010; RishatMuhametshin (обсуждение | вклад) (Настройки, хранимые в файле конфигурации)

Перейти к: навигация, поиск
Имеются страницы, на которые следует обратить внимание
Обратите внимание на следующую страницу документации: Конфигуратор СМС-сервера

Файл конфигурации СМС-сервера — это файл конфигурации, в котором хранятся настройки СМС-сервера. Этот файл расположен в папке, в которую установлен СМС-сервер, и называется «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]
Другой_параметр=Другое значение

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

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

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

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

Секции также зависят от типа устройства:

Название устройства

Описание устройства и функций, которые оно предоставляет СМС-серверу

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

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

SMPP

По протоколу SMPP происходит работа с провайдером СМС, через которого Такси-Мастер отправляет и принимает* СМС-сообщения. Этот вариант — самый быстрый, простой и чаще всего наиболее выгодный.

Свяжитесь с ОТП для заключения договора на поставку услуг провайдера СМС. Наш сотрудник проведет операцию в течение нескольких рабочих дней.

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

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

Первая секция — «[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-шлюзам.

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

  1. Модуль СМС
  2. СМС-сервер
  3. Nokia PC Suite

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

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

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

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

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

После этого СМС-сервер будет считать устройство с ИД, равным «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


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

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

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

Ссылки