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

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

Текущая версия на 14:28, 17 декабря 2021

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

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