Параметры файлов конфигурации — различия между версиями

Материал из Oktell
Перейти к: навигация, поиск
м (Параметры файла конфигурации серверного приложения)
 
(не показано 49 промежуточных версии 2 участников)
Строка 1: Строка 1:
[[Дополнительно|Наверх]]
+
[[Техническая документация|Наверх]]
  
 +
__TOC__
  
 
Ряд настроек комплекса хранится в файлах конфигурации соответствующих приложений. Файл конфигурации загружается однократно в момент запуска приложения, и хранящиеся в нем настройки не могут быть изменены в ходе работы. Любые изменения файлов конфигурации применяются только при следующем запуске соответствующего приложения.  
 
Ряд настроек комплекса хранится в файлах конфигурации соответствующих приложений. Файл конфигурации загружается однократно в момент запуска приложения, и хранящиеся в нем настройки не могут быть изменены в ходе работы. Любые изменения файлов конфигурации применяются только при следующем запуске соответствующего приложения.  
Строка 34: Строка 35:
  
  
При необходимости обновить настройки файлов конфигурации у всех или некоторых клиентов можно воспользоваться системой обновления (каталог LiveUpdate сервера). Размещение клиентского конфигурационного файла целиком возможно только в том случае, когда все настройки, включая адрес сервера, идентичны у всех клиентов. При различиях можно воспользоваться служебным механизмом частичного обновления: файлы update*.config, находящиеся в каталоге LiveUpdate, сортируются лексикографически и применяются к тем клиентам, которые определены в настройках каждого из этих файлов. При этом могут быть указаны конкретные клиентские места, или исключения. Клиентские места указываются с помощью идентификатора, определяющего его в карте сети (любой принадлежащий ему IP-адрес, имя хоста, либо хеш-идентификатор, определенный ключом [[#ManualHostAddress]]).
+
При необходимости обновить настройки файлов конфигурации у всех или некоторых клиентов можно воспользоваться системой обновления (каталог LiveUpdate сервера). Размещение клиентского конфигурационного файла целиком возможно только в том случае, когда все настройки, включая адрес сервера, идентичны у всех клиентов. При различиях можно воспользоваться служебным механизмом частичного обновления: файлы update*.config, находящиеся в каталоге LiveUpdate, сортируются лексикографически и применяются к тем клиентам, которые определены в настройках каждого из этих файлов. При этом могут быть указаны конкретные клиентские места, или исключения. Клиентские места указываются с помощью идентификатора, определяющего его в карте сети (любой принадлежащий ему IP-адрес, имя хоста, либо хеш-идентификатор, определенный ключом [[#ManualHostAddress|ManualHostAddress]]).
  
 
Например, нижеприведенный файл update1.config применится на всех клиентах, локальный адрес которых 192.168.0.12 или 192.168.0.13.
 
Например, нижеприведенный файл update1.config применится на всех клиентах, локальный адрес которых 192.168.0.12 или 192.168.0.13.
Строка 161: Строка 162:
 
:::3 - Мультимедийный таймер. Дает наиболее точное тактирование, однако имеет общее ограничение на количество одновременно существующих таймеров в системе (16 объектов). Сервер Oktell использует 3 объекта таймера высокой разрешающей способности.
 
:::3 - Мультимедийный таймер. Дает наиболее точное тактирование, однако имеет общее ограничение на количество одновременно существующих таймеров в системе (16 объектов). Сервер Oktell использует 3 объекта таймера высокой разрешающей способности.
  
:::4 - Автоопределение. На старте системы осуществляется тестовый прогон всех вариантов таймеров и определяется средне наиболее точный. В случае, если все имеют одинаковую среднюю точность, предпочтение отдается таймеру с меньшим индексом (таймер по умолчанию, системный, таймер ожидания, мультимедийный). На прогон теста на старте системы выделяется лишняя секунда.По умолчанию «4».
+
:::4 - Автоопределение. На старте системы осуществляется тестовый прогон всех вариантов таймеров и определяется средне наиболее точный. В случае, если все имеют одинаковую среднюю точность, предпочтение отдается таймеру с меньшим индексом (таймер по умолчанию системный, таймер ожидания, мультимедийный). На прогон теста на старте системы выделяется лишняя секунда.По умолчанию «4».
  
 
   
 
   
Строка 172: Строка 173:
 
<div id="EnableSipTransportFilter"></div>
 
<div id="EnableSipTransportFilter"></div>
 
<span style="color:blue;">EnableSipTransportFilter</span>. «1» - активирует на сервере спам-фильтр, защищающий от атак на SIP-подсистему. При поступлении с одного IP-адреса за короткий отрезок времени чрезмерно большого количества регистрационных пакетов, завершающихся неудачей по причине неверной авторизационной информации, осуществляется блокирование адреса на период времени, указанный в параметре и исчислимый в минутах. На все попытки регистрации с заблокированного IP-адреса сервер не отвечает никаким образом. По умолчанию 1440 минут (= 1 сутки), 1 - не отключать фильтрацию адреса вплоть до перезагрузки сервера, остальные действительные значения являются непосредственными значениями интервала в минутах. 0 - режим отключен.
 
<span style="color:blue;">EnableSipTransportFilter</span>. «1» - активирует на сервере спам-фильтр, защищающий от атак на SIP-подсистему. При поступлении с одного IP-адреса за короткий отрезок времени чрезмерно большого количества регистрационных пакетов, завершающихся неудачей по причине неверной авторизационной информации, осуществляется блокирование адреса на период времени, указанный в параметре и исчислимый в минутах. На все попытки регистрации с заблокированного IP-адреса сервер не отвечает никаким образом. По умолчанию 1440 минут (= 1 сутки), 1 - не отключать фильтрацию адреса вплоть до перезагрузки сервера, остальные действительные значения являются непосредственными значениями интервала в минутах. 0 - режим отключен.
 
 
 
  
  
Строка 185: Строка 183:
 
<span style="color:blue;">ExternalClientPort</span>. Порт для подключения внешних приложений 4053.
 
<span style="color:blue;">ExternalClientPort</span>. Порт для подключения внешних приложений 4053.
  
 +
<span style="color:blue;">SIP_ENABLE_TCP</span>. Разрешает TCP-подключение по протоколу SIP. Конкретный порт зависит от настроек SIP-сервера (по умолчанию 5060). «0» - не активно, «1» - активно. По умолчанию «0».
 +
 +
 +
'''Раздел <span style="color:green;">Настройки автодозвона</span>.'''
 +
 +
<span style="color:blue;">ACM_UseIntercom</span>. «1» - активирует интерком-звонок при автодозвоне, в случае схемы "абонент, затем пользователь", «0» - выключает. По умолчанию «1»
  
 +
<span style="color:blue;">ACM_DisableIntercomModeBack</span>. «0» - активирует интерком-звонок при автодозвоне, в случае схемы "пользователь, затем абонент", «1» - выключает. По умолчанию «0»
  
  
Строка 192: Строка 197:
 
<span style="color:blue;">WORK_ROOTDIR</span>. Устанавливает в явном виде путь к рабочей папке серверной службы. Временные файлы, сценарии, проекты, плагины, каталог по умолчанию для записи разговоров, резервные копии - все, кроме основных сборок службы, размещается именно там.
 
<span style="color:blue;">WORK_ROOTDIR</span>. Устанавливает в явном виде путь к рабочей папке серверной службы. Временные файлы, сценарии, проекты, плагины, каталог по умолчанию для записи разговоров, резервные копии - все, кроме основных сборок службы, размещается именно там.
  
<span style="color:blue;">WORK_ROOTDIR_TYPE</span>. Устанавливает один из нескольких возможных вариантов размещения рабочей папки. Используется, если не задана рабочая папка в явном виде. Возможные варианты: 0 – папка запустившего процесс выполняемого файла, 2 – Documents And Settings\All Users, 3 – Documents And Settings\CurrentUser.
+
<span style="color:blue;">WORK_ROOTDIR_TYPE</span>. Устанавливает один из нескольких возможных вариантов размещения рабочей папки. Используется, если не задана рабочая папка в явном виде. Возможные варианты: 0 – папка запустившего процесс выполняемого файла, 2 – Documents And Settings\All Users, 3 – Documents And Settings\CurrentUser (''C:\Users\User\AppData\Roaming\Oktell\Client\Scripts\Ivr'')
  
  
Строка 251: Строка 256:
 
<span style="color:blue;">EnableEmptyAdmin</span>. «1» - активирует на сервере возможность пользования учетной записью системного администратора. По умолчанию запись доступна только на сервере, где неактивен сервер состояний или среди учетных записей пользователей которого не существует ни одной, обладающей базовой ролью администратора. Может понадобиться в случае, если пароль учетной записи администратора утерян. Для применения требуется перезапуск службы сервера. По умолчанию «0».
 
<span style="color:blue;">EnableEmptyAdmin</span>. «1» - активирует на сервере возможность пользования учетной записью системного администратора. По умолчанию запись доступна только на сервере, где неактивен сервер состояний или среди учетных записей пользователей которого не существует ни одной, обладающей базовой ролью администратора. Может понадобиться в случае, если пароль учетной записи администратора утерян. Для применения требуется перезапуск службы сервера. По умолчанию «0».
  
<span style="color:blue;">EnableAutoMap</span>. «1» - активирован режим, при котором авторизация с рабочего места, не имеющего в карте сети учетной записи, приводит к автоматической временной регистрации на сервере рабочего места, снабженного USB-телефоном. «0» - доступ с неизвестных рабочих станций заблокирован.
+
<div id="EnableAutoMap"></div>
 +
<span style="color:blue;">EnableAutoMap</span>. «1» - активирован режим, при котором авторизация с рабочего места, не имеющего в карте сети учетной записи, приводит к автоматической временной регистрации на сервере рабочего места, снабженного USB-телефоном. «0» - доступ с неизвестных рабочих станций заблокирован. В целях обеспечения работы веб-клиентов, значение по умолчанию «1».
 +
 
 +
<div id="EnableAutoMapSip"></div>
 +
<span style="color:blue;">EnableAutoMapSip</span>. «1» - активирован режим, при котором при динамической регистрации вместо создания динамической линии USB-телефона производится связка с существующим в карте сети SIP-телефоном. Связка осуществляется по совпадению логина телефона с логином пользователя, либо по совпадению назначенного «пользователя по умолчанию» с авторизующимся пользователем. Для работы требуется включение параметра [[#EnableAutoMap|EnableAutoMap]]. «0» - связка динамических рабочих мест с SIP-телефонами не используется.
  
 
<span style="color:blue;">UseWlockForDynamicReg</span>. «1» - использовать блокировку писателя при добавлении/удалении динамических рабочих мест. По умолчанию «0» - использовать блокировку читателя.
 
<span style="color:blue;">UseWlockForDynamicReg</span>. «1» - использовать блокировку писателя при добавлении/удалении динамических рабочих мест. По умолчанию «0» - использовать блокировку читателя.
 +
 +
<div id="Use4xLineNumbers"></div>
 +
<span style="color:blue;">Use4xLineNumbers</span>. «1» - использовать при создании линий четырехзначную числовую нумерацию (0000-9999). Может быть использовано в проектах с более чем 1000 линий одного типа. По умолчанию «0».
 +
  
 
<span style="color:blue;">ManualHostAddress</span>. Устанавливает уникальное имя сервера для идентификации в карте сети на старте службы. В случае, если в качестве адреса сервера в карте сети указано это значение - позволяет устранить зависимость от смены DNS-имени, а также смены и назначения динамических адресов сервера.  
 
<span style="color:blue;">ManualHostAddress</span>. Устанавливает уникальное имя сервера для идентификации в карте сети на старте службы. В случае, если в качестве адреса сервера в карте сети указано это значение - позволяет устранить зависимость от смены DNS-имени, а также смены и назначения динамических адресов сервера.  
Строка 275: Строка 288:
 
<div id="UseSimpleLineState"></div>
 
<div id="UseSimpleLineState"></div>
 
<span style="color:blue;">UseSimpleLineState</span>. Определяет способ привязки состояний внутренних номеров, ссылающихся на линии к состоянию самих линий. Если указать 0, то состояние номера, в случае свободности подчиненной ему линии, будет оцениваться по состоянию привязанного к ней пользователя. По умолчанию 1.
 
<span style="color:blue;">UseSimpleLineState</span>. Определяет способ привязки состояний внутренних номеров, ссылающихся на линии к состоянию самих линий. Если указать 0, то состояние номера, в случае свободности подчиненной ему линии, будет оцениваться по состоянию привязанного к ней пользователя. По умолчанию 1.
 
<div id="ADLoginChecker"></div>
 
<span style="color:blue;">ADLoginChecker</span>. Требует указания пути (относительного или абсолютного) к консольному приложению, осуществляющего доступ к ActiveDirectory. При указании корректных значений в конфигурационных файлах и сервера, и клиента позволяет проводить авторизацию с паролем пользователя из AD. Логины же тем не менее должны быть продублированы в учетных записях сервера Oktell. Клиентское приложение в этом случае при запуске автоматически подставляет учетную запись пользователя AD.
 
Для работы режима требуется специальное консольное приложение GetUserInfo.exe и наличие ActiveDirectory. Не рекомендуется к использованию в публичных сетях.
 
 
<div id="ADRestartType"></div>
 
<span style="color:blue;">ADRestartType</span>. 0 - в случае сбоя или задержки в ответе консольного приложения проверки учетных записей ActiveDirectory будет произведено отключение режима входа через учетные записи ActiveDirectory. 1 - задержка в ответе не повлияет на дальнейшую работу. По умолчанию 0.
 
 
<div id="ADLoginCheckerWaitMs"></div>
 
<span style="color:blue;">ADLoginCheckerWaitMs</span>. Устанавливает таймаут ожидания ответа консольного приложения проверки учетных записей ActiveDirectory. Указывается в мс, по умолчанию 1000.
 
  
 
<div id="HideGhostMonitor"></div>
 
<div id="HideGhostMonitor"></div>
Строка 296: Строка 299:
  
 
<span style="color:blue;">DEBUG_incomingemail</span>. Логирование в common логе сервера принимаемых e-mail сообщений (pop3) "1" - включено. По умолчанию выключено.
 
<span style="color:blue;">DEBUG_incomingemail</span>. Логирование в common логе сервера принимаемых e-mail сообщений (pop3) "1" - включено. По умолчанию выключено.
 +
 +
<div id="DEBUG_LogActiveThreadStackTrace"></div>
 +
<span style="color:blue;">DEBUG_LogActiveThreadStackTrace</span>. При установке значения «1» производит вывод в лог ''DEBUG'' информации о стеке всех активных потоков основной службы сервера.
 +
  
 
<div id="UsePriorSwitchCallername"></div>
 
<div id="UsePriorSwitchCallername"></div>
Строка 311: Строка 318:
 
<span style="color:blue;">AllowDownloadFilesDirectlyOnlyFromTemp</span>. 1 - блокирует скачивание файлов с сервера через HTTP интерфейс отовсюду, кроме как из временной папки Temp и [[Настройки веб-сервера#LocalStoragePath|локального хранилища]]. 0 - разрешает скачивать произвольные файлы с диска сервера по прямой ссылке. По умолчанию 1 (блокировать).
 
<span style="color:blue;">AllowDownloadFilesDirectlyOnlyFromTemp</span>. 1 - блокирует скачивание файлов с сервера через HTTP интерфейс отовсюду, кроме как из временной папки Temp и [[Настройки веб-сервера#LocalStoragePath|локального хранилища]]. 0 - разрешает скачивать произвольные файлы с диска сервера по прямой ссылке. По умолчанию 1 (блокировать).
  
 +
<div id="BanUserAgent"></div>
 +
<span style="color:blue;">BanUserAgentXX</span>, XX - порядковый номер от 00 до 99. Позволяет установить SIP-транспортный фильтр для определенных значений поля User-Agent. По умолчанию банится "Friendly-Scanner" в целях снижения нагрузки и уменьшения вероятности взлома.
  
<div id="FileServer"></div>
+
<div id="WhiteListIps"></div>
<span style="color:blue;">FileServer_Log</span>, <span style="color:blue;">FileServer_Record</span>. Позволяет активировать сохранение соответственно лог-журналов и записей разговоров на удаленный файл-сервер. Значение задается в формате «address:port», например «192.168.0.199:4088». В качестве файлсервера может выступать любой компьютер с установленной и активированной службой oktell.FileService.exe из каталога серверной службы Oktell. О настройке и способах работы файл-сервера доступна [[http://r.oktell.ru/wiki/306/ статья]] в базе знаний.
+
<span style="color:blue;">WhiteListIps</span>. Позволяет установить список разрешённых IP-адресов, которые исключаются из проверки спам-фильтром. Можно указать несколько адресов через точку запятой. По умолчанию пустой список.
  
<div id="FileServerRecDir"></div>
+
<div id="UpdateSelectorOnDirectorDisconnect"></div>
Хранение записей может происходить в разных каталогах в соответствии с настройкой в Oktell. При использовании файл-сервера в качестве хранилища записей может потребоваться подключать дополнительные хранилища и изменять путь для сохранения записей и последующего доступа к ним. Чтобы это обеспечить, необходимо подвергать корректировке совместно настройку каталога для записи в Oktell и конфиг файлового-сервера. При этом в конфигурационном файле файлового сервера требуется указание соответствия переданного службой Oktell пути с локальным путем (ключ ''BaseDir_*'', где * - это subdir.ToLower(recordedfiles\dirname), а dirname - название последнего внутреннего каталога по выбранному службой Oktell пути; значение - локальный путь на файловом сервере. Например <add key="BaseDir_recordedfiles\path2" value="D:\_OktellWorkDir\Files\Base2\"/>. При настройке Oktell следует указывать пути, последний каталог которых имеет уникальное название и ранее не использовалось).
+
<span style="color:blue;">UpdateSelectorOnDirectorDisconnect</span>. 1 - при выходе/выпадении управляющего из селекторного совещания производит преобразование селектора к общей конференции. 0 - оставляет селектор с теми правами и в том виде, в котором он находился в последний момент присутствия управляющего. По умолчанию «1».
  
 +
<div id="PBX_Use180SdpAs183"></div>
 +
<span style="color:blue;">PBX_Use180SdpAs183</span>. 1 - воспринимает команду ''180 Ringing'' с SDP содержимым как команду ''183 Progress'' и начинает сеанс медиасвязи. Используется в режиме ''прослушивание медиа-потока'' компонента [[Компоненты_сценариев_IVR#SwitchExt|Переключение на внешние линии]]. 0 - генерирует стандартный сигнал КПВ (длинные гудки). По умолчанию 1.
  
<span style="color:blue;">ContactServerName</span>. Тип подключения к драйверу ключа защиты SENTINEL по умолчанию. В случае невозможности осуществляется перебор всех возможных вариантов.
+
<div id="PBX_BackFrom183To180"></div>
 +
<span style="color:blue;">PBX_BackFrom183To180</span>. 1 - воспринимает команду ''180 Ringing'' к обязательному исполнению - начинает генерацию сигнала КПВ (длинные гудки), даже если предварительно был получен ответ ''183 Progress'' и канал находится в медиа-коммутации. Используется в режиме ''прослушивание медиа-потока'' компонента [[Компоненты_сценариев_IVR#SwitchExt|Переключение на внешние линии]]. 0 - пропускает такую команду. По умолчанию 0.
  
<span style="color:blue;">LicenseMode</span>. Текущий режим лицензирования. По умолчанию «1» - использование файла сертификата.
+
<div id="UseAssertedIdentity"></div>
 +
<span style="color:blue;">UseAssertedIdentity</span>. Включает отправку SIP-заголовоков ''P-Asserted-Identity'' и ''Remote-Party-ID'' в ответ на входящие вызовы с внутренних SIP-устройств на сервер с целью отправить на отображение в SIP-устройство ''Сaller-name'' вызываемого абонента. Применяется в случае осуществления вызова на внутренний номер.
  
<span style="color:blue;">QueryWebServerPort</span>. Устанавливает порт слушателя [[Серверный интерфейс|HTTP-запросов]] к серверной службе. Применяется только если значение, установленное в общих настройках нулевое (поддержка устаревших настроек новыми версиями). Однако включение сервера тем не менее происходит в общих настройках в разделе управления веб-сервером.
+
<div id="ScreenShotSize"></div>
 +
<span style="color:blue;">AutoScreenshotWidth</span>, <span style="color:blue;">AutoScreenshotHeight</span>. Определяют максимальные размеры скриншотов экранов, снимаемых с помощью компонента сценариев [[Общие компоненты сценариев#UserState|Статус объекта]].
  
<span style="color:blue;">QueryWebServerPassword</span>. Устанавливает пароль, проверяемый при поступлении всех [[Серверный интерфейс|HTTP-запросов]] к серверу. Применяется только если значение, установленное в общих настройках пустое (поддержка устаревших настроек новыми версиями).
+
<div id="PredictivePoolTimerIntervalMs"></div>
 +
<span style="color:blue;">PredictivePoolTimerIntervalMs</span>. Устанавливает общий для всей системы интервал пересчета параметров предиктивных задач в мс, в ходе которого могут быть начаты новые дозвоны (по умолчанию 5000).  
  
 +
<div id="PredictivePoolClearStatOnDeactivate"></div>
 +
<span style="color:blue;">PredictivePoolClearStatOnDeactivate</span>. Устанавливает общий для всей системы режим очистки статистики в предиктивных задачах при деактивации (по умолчанию 0).
 +
 +
<div id="PredictivePoolExtraShiftTimeoutMs"></div>
 +
<span style="color:blue;">PredictivePoolExtraShiftTimeoutMs</span>. Устанавливает общий для всей системы дополнительный интервал в мс, применяемый безусловно к спрогнозированным параметрам. Может быть отрицательным и положительным. Если указать положительное число, следующий звонок будет совершаться с запозданием, давая операторам некоторое дополнительное время, например, для перерыва. Если указать отрицательное число, следующий звонок будет совершаться раньше, чем это требуется, тем самым ускоряя темп обзвона. По умолчанию 0.
 +
 +
<div id="WebServerNoAuth_Loopback"></div>
 +
<span style="color:blue;">WebServerNoAuth_Loopback</span>. Позволяет отменить требование базовой авторизации при обращении к веб-серверу по loopback-интерфейсу (из приложений на самом сервере). По умолчанию 0.
 +
 +
 +
<div id="FileServer"></div>
 +
<span style="color:blue;">FileServer_Log</span>, <span style="color:blue;">FileServer_Record</span>. Позволяет активировать сохранение соответственно лог-журналов и записей разговоров на удаленный файл-сервер. Значение задается в формате «address:port», например «192.168.0.199:4088». В качестве файлсервера может выступать любой компьютер с установленной и активированной службой oktell.FileService.exe из каталога серверной службы Oktell. О настройке и способах работы файл-сервера доступна [[Запись лог-журналов и записей разговоров на удаленный файловый сервер|статья]] в базе знаний.
 +
 +
<div id="FileServerRecDir"></div>
 +
Хранение записей может происходить в разных каталогах в соответствии с настройкой в Oktell. При использовании файл-сервера в качестве хранилища записей может потребоваться подключать дополнительные хранилища и изменять путь для сохранения записей и последующего доступа к ним. Чтобы это обеспечить, необходимо подвергать корректировке совместно настройку каталога для записи в Oktell и конфиг файлового-сервера. При этом в конфигурационном файле файлового сервера требуется указание соответствия переданного службой Oktell пути с локальным путем (ключ ''BaseDir_*'', где * - это subdir.ToLower(recordedfiles\dirname), а dirname - название последнего внутреннего каталога по выбранному службой Oktell пути; значение - локальный путь на файловом сервере. Например <add key="BaseDir_recordedfiles\path2" value="D:\_OktellWorkDir\Files\Base2\"/>. При настройке Oktell следует указывать пути, последний каталог которых имеет уникальное название и ранее не использовалось).
  
  
Строка 411: Строка 441:
  
 
<span style="color:blue;">LOG_root</span>. Абсолютный или относительный путь к папке с лог-журналами. По умолчанию «Log», то есть относительный путь в каталоге серверной службы/приложения.
 
<span style="color:blue;">LOG_root</span>. Абсолютный или относительный путь к папке с лог-журналами. По умолчанию «Log», то есть относительный путь в каталоге серверной службы/приложения.
 +
 +
 +
<span style="color:blue;">LOG_asyncwrite</span>. Использовать асинхронную запись в лог модулем аппаратуры. По умолчанию «0» - выключено.
 +
 +
<span style="color:blue;">LOG_cachesize</span>. Размер кэша памяти(в Кб) хранения логов перед записью на диск. По умолчанию 128 Кб.
 +
 +
<span style="color:blue;">LOG_cachefreq</span>. Частота(в мс) записи кэша на диск. По умолчанию 100 мс.
  
  
Строка 419: Строка 456:
 
<span style="color:blue;">DebugLogCPEventTypes</span>. 1 - включает логирование информации обо всех событиях, отправляемых в клиентские приложения в Debug-лог. По умолчанию 0 - выключено.
 
<span style="color:blue;">DebugLogCPEventTypes</span>. 1 - включает логирование информации обо всех событиях, отправляемых в клиентские приложения в Debug-лог. По умолчанию 0 - выключено.
  
 +
<span style="color:blue;">WEBSOCK_LogTransform</span>. При установке 1 выводит в лог TCP информацию о работе протокола WebSocket.
  
 +
<span style="color:blue;">WEBSOCK_LogListener</span>. При установке 1 выводит в лог TCP информацию о работе протокола WebSocket.
  
'''Раздел <span style="color:green;">DEBUGGING</span>.'''
+
<span style="color:blue;">WEBSOCK_LogDebug</span>. При установке 1 выводит в лог TCP информацию о работе протокола WebSocket.
  
Хранит настройки, согласно которым ведется заполнение служебного сервисного лог-журнала. По умолчанию все параметры выставлены в «1», что влечет полное логирование служб сервера. Полное или частичное отключение уменьшает размер журнала, однако не даст информации в случае возникновения сбоев и общением с технической поддержкой.
+
<span style="color:blue;">WEBSOCK_LogPackets</span>. При установке 1 выводит в лог TCP информацию о работе протокола WebSocket.
  
  
  
'''Раздел <span style="color:green;">KEYREMOTE</span>.'''
+
'''Раздел <span style="color:green;">DEBUGGING</span>.'''
  
Хранит настройки для подключения к внешнему серверу, управляющему ключом защиты. Необходимо в редких случаях, если USB-порт на сервере не функционирует должным образом.
+
Хранит настройки, согласно которым ведется заполнение служебного сервисного лог-журнала. По умолчанию все параметры выставлены в «1», что влечет полное логирование служб сервера. Полное или частичное отключение уменьшает размер журнала, однако не даст информации в случае возникновения сбоев и общением с технической поддержкой.
  
  
  
 +
'''Раздел <span style="color:green;">KEYREMOTE</span>.'''
  
 +
Хранит настройки для подключения к внешнему серверу, управляющему ключом защиты. Необходимо в редких случаях, если USB-порт на сервере не функционирует должным образом.
  
 
===Параметры файла конфигурации клиентского приложения===
 
===Параметры файла конфигурации клиентского приложения===
Строка 454: Строка 495:
 
<span style="color:blue;">LogicServerPort</span>. Порт для подключения к серверу логики.
 
<span style="color:blue;">LogicServerPort</span>. Порт для подключения к серверу логики.
  
<span style="color:blue;">ConnectProtocol</span>. Устанавливает протокол, по которому осуществляется подключение клиента к серверу. 0 - по умолчанию, 1 - Remoting, 2 - OkTCP.
+
<span style="color:blue;">ConnectProtocol</span>. Устанавливает протокол, по которому осуществляется подключение клиента к серверу. 0 - по умолчанию 1 - Remoting, 2 - OkTCP.
  
 
<span style="color:blue;">NETCLIENT_SERVER_ADDRESS</span>. Адрес для подключения к серверу аппаратуры.
 
<span style="color:blue;">NETCLIENT_SERVER_ADDRESS</span>. Адрес для подключения к серверу аппаратуры.
Строка 460: Строка 501:
 
<span style="color:blue;">NETCLIENT_SERVER_PORT</span>. Порт на сервере для подключения к нему по сигнальному протоколу.
 
<span style="color:blue;">NETCLIENT_SERVER_PORT</span>. Порт на сервере для подключения к нему по сигнальному протоколу.
  
<span style="color:blue;">NETCLIENT_LOCAL_PORT</span>. Локальный порт для обмена сигнальным трафиком по UDP.
+
<span style="color:blue;">NETCLIENT_LOCAL_PORT</span>. Локальный порт для обмена сигнальным трафиком по UDP. Используется для версий 2.9 и ниже, работающих по VOIP-технологии.
  
 
<span style="color:blue;">NETCLIENT_VOICE_PORT</span>. Локальный порт для обмена голосовым трафиком по UDP.  
 
<span style="color:blue;">NETCLIENT_VOICE_PORT</span>. Локальный порт для обмена голосовым трафиком по UDP.  
  
 +
<div id="SipDomain"></div>
 +
<span style="color:blue;">SipDomain</span>. Переопределяет доменное имя SIP-сервера при отправке регистрационных пакетов с клиентского локального устройства. Явное указание может потребоваться в случае нестандартных настроек NAT сервера.
 +
 +
<div id="SipPort"></div>
 +
<span style="color:blue;">SipPort</span>. Переопределяет порт SIP-сервера при отправке SIP пакетов с клиентского локального устройства. Явное указание может потребоваться в случае нестандартных настроек NAT сервера. По умолчанию 5060.
 +
 +
<span style="color:blue;">SipLocalPort</span>. Переопределяет локальный порт клиентского приложения для обмена сигнальным трафиком по протоколу SIP. По умолчанию 5080. Работает начиная с версии 2.11.
 
   
 
   
 
<span style="color:red;">ВНИМАНИЕ! Вышеперечисленные параметры (NetConnectionName, ..., NETCLIENT_VOICE_PORT) определяют различные адреса и порты для организации сетевого канала подключения к серверу. Эти параметры могут присутствовать в конфигурационном файле несколько раз с добавлением к концу строки-ключа разных целочисленных индексов. Например NetConnectionName_1 и NetConnectionName_2. Индекс 0 не указывается, вместо него используется значение без индекса. В случае указания в конфигурационном файле нескольких подключений в окне авторизации будет отображен список их имен и доступен выбор одного из них. Это удобно использовать при работе с несколькими серверами с одних и тех же клиентских рабочих станций.</span>
 
<span style="color:red;">ВНИМАНИЕ! Вышеперечисленные параметры (NetConnectionName, ..., NETCLIENT_VOICE_PORT) определяют различные адреса и порты для организации сетевого канала подключения к серверу. Эти параметры могут присутствовать в конфигурационном файле несколько раз с добавлением к концу строки-ключа разных целочисленных индексов. Например NetConnectionName_1 и NetConnectionName_2. Индекс 0 не указывается, вместо него используется значение без индекса. В случае указания в конфигурационном файле нескольких подключений в окне авторизации будет отображен список их имен и доступен выбор одного из них. Это удобно использовать при работе с несколькими серверами с одних и тех же клиентских рабочих станций.</span>
  
  
 +
<div id="SipDomainMode"></div>
 +
<span style="color:blue;">SipDomainMode</span>. Режим формирования доменного имени при подключении локального устройства по SIP к серверу. По умолчанию используется IP-адрес указанного в конфигурационном файле [[#LogicServerAddress|доменного имени логического сервера]] (''=2''). Варианты: ''0'' - имя хоста серверной машины, ''1'' - указанное в конфигурационном файле [[#LogicServerAddress|доменное имя логического сервера]]. В любом случае доменное имя может быть явно переопределено параметром конфига [[#SipDomain]], если он установлен для текущего подключения. В большинстве случаев изменения значения этого параметра не требуется
 +
 +
<div id="SipForceKeepAliveIntervalSec"></div>
 +
<span style="color:blue;">SipForceKeepAliveIntervalSec</span>. Позволяет явно включить и задать интервал в секундах для отправки пакетов Keep-Alive в SIP-подключении к серверу. Может потребоваться при настройках NAT для удерживания порта.
 
   
 
   
 +
 
<span style="color:blue;">WORK_ROOTDIR</span>. Устанавливает в явном виде путь к рабочей папке клиентского приложения. Временные файлы, сценарии, проекты, плагины, каталог по умолчанию для записи разговоров - все кроме основных сборок службы размещается именно там.
 
<span style="color:blue;">WORK_ROOTDIR</span>. Устанавливает в явном виде путь к рабочей папке клиентского приложения. Временные файлы, сценарии, проекты, плагины, каталог по умолчанию для записи разговоров - все кроме основных сборок службы размещается именно там.
  
Строка 480: Строка 534:
 
<span style="color:blue;">ManualHostAddress</span>. Альтернативный псевдо-адрес клиентского компьютера для идентификации на сервере в карте сети. Может быть использован для подключения к серверу при динамически выделяемом IP-адресе и сложностях с идентификацией по HostName. Каждый клиент должен иметь уникальное значение ключа, не совпадающее с реальными возможными адресами и именами других компьютеров сети.
 
<span style="color:blue;">ManualHostAddress</span>. Альтернативный псевдо-адрес клиентского компьютера для идентификации на сервере в карте сети. Может быть использован для подключения к серверу при динамически выделяемом IP-адресе и сложностях с идентификацией по HostName. Каждый клиент должен иметь уникальное значение ключа, не совпадающее с реальными возможными адресами и именами других компьютеров сети.
  
 +
<div id="TerminalMode"></div>
 +
<span style="color:blue;">TerminalMode</span>. Определяет режим подстановки адреса (для организации работы в терминальном режиме) - какой адрес берется, какое терминальное расширение для идентификации в карте сети используется (''address/terminalkey''). С помощью настройки вы можете передавать название вашего компьютера через удаленное подключение.
 +
0 — адрес локальный, без терминального расширения: ''address''.
 +
1 — адрес локальный, терминальное расширение из текущего конфигурационного файла [[#TerminalAddress|TerminalAddress]]: ''address/terminalkey''.
 +
2 — адрес локальный, терминальное расширение с помощью текущего авторизованного Win-User: ''address/user''.
 +
3 — адрес клиентского терминала (ищется активная сессия авторизованная под совпадающим с текущим win-user), терминальное расширение из текущего
 +
конфигурационного файла [[#TerminalAddress|TerminalAddress]]: ''clientaddress/terminalkey''.
 +
Если удовлетворяющая условиям терминальная сессия не найдена, то используется локальный адрес. Если терминальное расширение не задано - не используется.
 +
По умолчанию 1.
 +
 +
<div id="TerminalAddress"></div>
 
<span style="color:blue;">TerminalAddress</span>. Строка, определяющая уникальный адрес клиентского места. Приписывается ко всем адресам компьютера для определения клиентского места в карте офиса (например «FUTURAMA/terminal1»). Именно эту строку необходимо будет указать в карте офиса для идентификации. Решает проблему терминальных подключений, где все клиенты физически запускаются с одного компьютера. По умолчанию «».
 
<span style="color:blue;">TerminalAddress</span>. Строка, определяющая уникальный адрес клиентского места. Приписывается ко всем адресам компьютера для определения клиентского места в карте офиса (например «FUTURAMA/terminal1»). Именно эту строку необходимо будет указать в карте офиса для идентификации. Решает проблему терминальных подключений, где все клиенты физически запускаются с одного компьютера. По умолчанию «».
 +
 +
<div id="ShowLoginAuthMode"></div>
 +
<span style="color:blue;">ShowLoginAuthMode</span>. ''1'' - отображать выбор способа авторизации (active dictionary/oktell), ''0'' - не отображать и использовать всегда стандартный режим. По умолчанию ''1''.
  
 
<span style="color:blue;">TimeSynchronization</span>. «1» - синхронизировать время с сервером при запуске, «0» - не синхронизировать. По умолчанию «1».
 
<span style="color:blue;">TimeSynchronization</span>. «1» - синхронизировать время с сервером при запуске, «0» - не синхронизировать. По умолчанию «1».
  
RestartApplicationWithProcess</span>. «1» - любой перезапуск клиента производится с выгрузкой процесса. «0» - выгрузка процесса производится только для применения обновлений, другие перезапуски осуществляются внутри процесса. По умолчанию «0».  
+
<span style="color:blue;">RestartApplicationWithProcess</span>. «1» - любой перезапуск клиента производится с выгрузкой процесса. «0» - выгрузка процесса производится только для применения обновлений, другие перезапуски осуществляются внутри процесса. По умолчанию «0».  
  
ProcessPriority</span>. Приоритет процесса клиентского приложения и процесса обслуживания внешних звуковых устройств. «0» - нормальный, «1» - выше среднего, «2» - высокий, «3» - реального времени. По умолчанию «1».
+
<span style="color:blue;">ProcessPriority</span>. Приоритет процесса клиентского приложения и процесса обслуживания внешних звуковых устройств. «0» - нормальный, «1» - выше среднего, «2» - высокий, «3» - реального времени. По умолчанию «1».
  
 
<span style="color:blue;">HAL_skip_loading</span>. «1» - пропускать загрузку модуля обслуживания устройств работы со звуком. «0» - нормальный режим.
 
<span style="color:blue;">HAL_skip_loading</span>. «1» - пропускать загрузку модуля обслуживания устройств работы со звуком. «0» - нормальный режим.
Строка 492: Строка 560:
 
<span style="color:blue;">Register_ocx</span>. «1» - регистрировать библиотеки обслуживаемых устройств перед запуском, «0» - не регистрировать. По умолчанию «1».
 
<span style="color:blue;">Register_ocx</span>. «1» - регистрировать библиотеки обслуживаемых устройств перед запуском, «0» - не регистрировать. По умолчанию «1».
  
<span style="color:blue;">ClientWebServerPort</span>. Устанавливает порт слушателя [[Клиентский интерфейс|HTTP-запросов]] к клиентскому приложению (например запрос http://localhost:4059/callto?number=184 - команда на звонок через Oktell). Доступ возможен только по локальному loopback интерфейсу.
+
<div id="ClientWebServerPort"></div>
 +
<span style="color:blue;">ClientWebServerPort</span>. Устанавливает порт слушателя [[Клиентский_HTTP_интерфейс|HTTP-запросов]] к клиентскому приложению (например запрос http://localhost:4059/callto?number=184 - команда на звонок через Oktell). Доступ возможен только по локальному loopback интерфейсу.
  
 
<span style="color:blue;">ComAsyncEventing</span>. Применяется для форсированной активации/отключения соответствующего режима COM-ядра без изменения кода приложения. Активирует/деактивирует режим раздачи событий COM-объекта в асинхронных служебных потоках. Применяется только в случае указания значений «1» или «0». По умолчанию применяется режим, установленный в коде внешнего интегрирующего приложения. Подробно в руководстве по интеграции (раздел «Октелл в других проектах», статья «Загрузка и выгрузка модуля»).
 
<span style="color:blue;">ComAsyncEventing</span>. Применяется для форсированной активации/отключения соответствующего режима COM-ядра без изменения кода приложения. Активирует/деактивирует режим раздачи событий COM-объекта в асинхронных служебных потоках. Применяется только в случае указания значений «1» или «0». По умолчанию применяется режим, установленный в коде внешнего интегрирующего приложения. Подробно в руководстве по интеграции (раздел «Октелл в других проектах», статья «Загрузка и выгрузка модуля»).
Строка 498: Строка 567:
 
<span style="color:blue;">ComXmlFullLogging</span>. Применяется для форсированной активации/отключения соответствующего режима COM-ядра без изменения кода приложения. Активирует/деактивирует режим полного логирования всех событий и вызовов управляющего объекта. Применяется только в случае указания значений «1» или «0». По умолчанию применяется режим, установленный в коде внешнего интегрирующего приложения. Подробно в руководстве по интеграции (раздел «Октелл в других проектах», статья «Загрузка и выгрузка модуля»).
 
<span style="color:blue;">ComXmlFullLogging</span>. Применяется для форсированной активации/отключения соответствующего режима COM-ядра без изменения кода приложения. Активирует/деактивирует режим полного логирования всех событий и вызовов управляющего объекта. Применяется только в случае указания значений «1» или «0». По умолчанию применяется режим, установленный в коде внешнего интегрирующего приложения. Подробно в руководстве по интеграции (раздел «Октелл в других проектах», статья «Загрузка и выгрузка модуля»).
  
<span style="color:blue;">TRACE_HARDWARE</span>. Уровень трассировки аппаратного модуля. Битовая маска xxxx. C конца: 0 - TraceCall, 1-TraceEvents, 2-TraceVoice, 3-TraceNet. По умолчанию «1». Для полной трассировки значение «1111111111».
+
<span style="color:blue;">TRACE_HARDWARE</span>. Уровень трассировки аппаратного модуля. Применяется для логирования событий в момент запуска системы. Возможны следующие ключи: CALL, NET, TRANS, SESSION, PROTO, EVENTS, TIMER, ERRORS, WARNING, RTP-FLOW, MEDIA-FLOW. Ключи необходимо перечислить в атрибуте value друг за другом через пробел. Прочитать описание ключей можно в статье [[Логирование#.D0.9F.D0.B0.D1.80.D0.B0.D0.BC.D0.B5.D1.82.D1.80.D1.8B_.D0.B0.D0.BF.D0.BF.D0.B0.D1.80.D0.B0.D1.82.D1.83.D1.80.D1.8B._.D0.9A.D0.BE.D0.BD.D1.84.D0.B8.D0.B3.D1.83.D1.80.D0.B0.D1.86.D0.B8.D1.8F|Логирование]]
  
 
<span style="color:blue;">SEPARATE_PROCESS</span>. «1» - запускать отдельный процесс для работы с устройствами. «0» - работать с устройствами в собственном процессе. По умолчанию «1».
 
<span style="color:blue;">SEPARATE_PROCESS</span>. «1» - запускать отдельный процесс для работы с устройствами. «0» - работать с устройствами в собственном процессе. По умолчанию «1».
Строка 528: Строка 597:
 
<span style="color:blue;">SIGNAL_VOLUME</span>. 0-100. Уровень громкости генерируемых в локальное устройство системных звуков и тонов. По умолчанию 50.
 
<span style="color:blue;">SIGNAL_VOLUME</span>. 0-100. Уровень громкости генерируемых в локальное устройство системных звуков и тонов. По умолчанию 50.
  
<span style="color:blue;">UseKeyHook</span>. Параметр позволяет принудительно отключить режим перехвата действий клавиатуры для управления гарнитурой. Отключение может понадобиться при обнаружении проблем и конфликтов с операционной системой. «1» - режим перехвата активирован. «0» - режим перехвата деактивирован. По умолчанию «1». Выключение требуется на 64 разрядных ОС.
+
 
 +
 
 +
<div id="UseKeyHook"></div>
 +
<span style="color:blue;">UseKeyHook</span>. Параметр позволяет принудительно отключить режим перехвата действий клавиатуры для управления гарнитурой. Отключение может понадобиться при обнаружении проблем и конфликтов с операционной системой. «1» - режим перехвата активирован. «0» - режим перехвата деактивирован. По умолчанию «1». Выключение требуется на 64 разрядных ОС при работе версий до 2.8.130325.
  
 
<span style="color:blue;">default_HeadSet_AutoHookUp</span>. Определяет используемый по умолчанию режим автоподнятия трубки на гарнитуре при поступлении входящего звонка. После фактического изменения настроек пользователем в параметрах локального устройства значение из конфигурационного файла теряет актуальность. По умолчанию «1».
 
<span style="color:blue;">default_HeadSet_AutoHookUp</span>. Определяет используемый по умолчанию режим автоподнятия трубки на гарнитуре при поступлении входящего звонка. После фактического изменения настроек пользователем в параметрах локального устройства значение из конфигурационного файла теряет актуальность. По умолчанию «1».
Строка 547: Строка 619:
  
 
<span style="color:blue;">CameraJitterDepth</span>. Глубина джиттер-буфера фреймов с камеры. Позволяет нивелировать задержку в выдаче кадров в целях выравнивания отправляемого видео-потока. По умолчанию «3». «0» - не использовать джиттер.   
 
<span style="color:blue;">CameraJitterDepth</span>. Глубина джиттер-буфера фреймов с камеры. Позволяет нивелировать задержку в выдаче кадров в целях выравнивания отправляемого видео-потока. По умолчанию «3». «0» - не использовать джиттер.   
 +
 +
<span style="color:blue;">SkipLoadCamera</span>. «1» - пропускать загрузку модуля работы с веб-камерой. «0» - нормальный режим.
  
 
<span style="color:blue;">Phone_UseBlockedDelay</span>. «1» - использует асинхронный отложенный механизм по выставлению заблокированного состояния модулю [[Телефон]]. «0» - заблокированное состояние выставляется сразу (может потребоваться при работе на медленных машинах, где асинхронность сказывается отрицательно с приведением телефона в недееспособное состояние. Рекомендуется изменять только при соответствующем запросе службы технической поддержки). По умолчанию «1».
 
<span style="color:blue;">Phone_UseBlockedDelay</span>. «1» - использует асинхронный отложенный механизм по выставлению заблокированного состояния модулю [[Телефон]]. «0» - заблокированное состояние выставляется сразу (может потребоваться при работе на медленных машинах, где асинхронность сказывается отрицательно с приведением телефона в недееспособное состояние. Рекомендуется изменять только при соответствующем запросе службы технической поддержки). По умолчанию «1».
  
 
<span style="color:blue;">Phone_ACMMode</span>. Определяет порядок действий при нажатии на кнопку «Позвонить» в модуле [[Телефон]]. «0» - стандартная последовательность действий: сначала производится вызов абонента, потом обратный вызов пользователя. «1» - обратная последовательность: сначала производится вызов самого пользователя, потом абонента. См. раздел [[Звонки и сервис автодозвона|Телефон. Звонки]].
 
<span style="color:blue;">Phone_ACMMode</span>. Определяет порядок действий при нажатии на кнопку «Позвонить» в модуле [[Телефон]]. «0» - стандартная последовательность действий: сначала производится вызов абонента, потом обратный вызов пользователя. «1» - обратная последовательность: сначала производится вызов самого пользователя, потом абонента. См. раздел [[Звонки и сервис автодозвона|Телефон. Звонки]].
 +
 +
<span style="color:blue;">ACM_directcallfrommodules</span>. Режим использования сервиса автодозвона в разделах клиентского приложения для доступных команд контекстного меню (Например: Позвонить). По умолчанию ''1''
 +
 +
<span style="color:blue;">ACM_callsequence</span>. Используется при установке ключа '''ACM_directcallfrommodules'''=0. Режим автодозвона в разделах клиентского приложения где доступно контекстное меню "Позвонить". «0» - сначала абонент, затем обратный вызов пользователя. «1» - сначала обратный вызов пользователя, затем набор номера. По умолчанию ''0''
 +
 +
<span style="color:blue;">ACM_switchsequence</span>. Используется при установке ключа '''ACM_directcallfrommodules'''=0. Режим автодозвона в разделах клиентского приложения где доступно контекстное меню "Переключить". «0» - сначала абонент, затем обратный вызов пользователя. «1» - сначала обратный вызов пользователя, затем набор номера. По умолчанию ''1''
 +
 +
<div id="PhoneAllowHotline"></div>
 +
<span style="color:blue;">PhoneAllowHotline</span>. ''1'' - разрешить ''HOTLINE'' вызовы из локального устройства на SIP-сервер (при звонке на пустой номер), ''0'' - запретить. По умолчанию ''1''.
  
 
<span style="color:blue;">HeadsetNonACMMode</span>. Режим вызова с гарнитуры без использования автодозвона. «0» - сначала обратный вызов пользователя, потом набор абонента. «1» - поднятие трубки, таймаут, набор номера. По умолчанию «1».
 
<span style="color:blue;">HeadsetNonACMMode</span>. Режим вызова с гарнитуры без использования автодозвона. «0» - сначала обратный вызов пользователя, потом набор абонента. «1» - поднятие трубки, таймаут, набор номера. По умолчанию «1».
Строка 556: Строка 639:
 
<span style="color:blue;">UseAutoReconnectOnFly</span>. При установке значения «1» в случае потери связи по каналу TCP между клиентом и сервером клиентское приложение будет пытаться переподключиться без перезагрузки. Неактуально при использовании протокола Remoting (по умолчанию порт 4050).
 
<span style="color:blue;">UseAutoReconnectOnFly</span>. При установке значения «1» в случае потери связи по каналу TCP между клиентом и сервером клиентское приложение будет пытаться переподключиться без перезагрузки. Неактуально при использовании протокола Remoting (по умолчанию порт 4050).
  
<span style="color:blue;">ShowHelpInside</span>. Определяет, где отображать справку по системе. «0» - в отдельных процессах браузера по умолчанию, «1» - во встроенном браузере в окне клиентского приложения. По умолчанию «0».
+
<span style="color:blue;">ShowHelpInside</span>. Определяет, где отображать справку по системе. «0» - в отдельных процессах браузера по умолчанию «1» - во встроенном браузере в окне клиентского приложения. По умолчанию «0».
  
 
<div id="PlugRegLoadType"></div>
 
<div id="PlugRegLoadType"></div>
Строка 567: Строка 650:
 
<div id="SplitDepartmentsTreeByDot"></div>
 
<div id="SplitDepartmentsTreeByDot"></div>
 
<span style="color:blue;">SplitDepartmentsTreeByDot</span>. «1» - осуществлять построение глубокого дерева вложенных отделов в модуле «Сотрудники», разбивая указанные для сотрудников отделы на категории по символу «.». «0» - одноуровневое дерево отделов. По умолчанию «0».
 
<span style="color:blue;">SplitDepartmentsTreeByDot</span>. «1» - осуществлять построение глубокого дерева вложенных отделов в модуле «Сотрудники», разбивая указанные для сотрудников отделы на категории по символу «.». «0» - одноуровневое дерево отделов. По умолчанию «0».
 +
 +
<div id="ExportCsvDelimiter"></div>
 +
<span style="color:blue;">ExportCsvDelimiter</span>. Устанавливает символ-разделитель столбцов при формировании файлов экспорта CSV во всех модулях клиентского приложения. Список возможных значений: comma, space, semicolon, tab.
 +
 +
<div id="ExportTextDelimiter"></div>
 +
<span style="color:blue;">ExportTextDelimiter</span>. Устанавливает символ-разделитель столбцов при формировании текстовых файлов с отчетами во всех модулях клиентского приложения. Список возможных значений: comma, space, semicolon, tab.
 +
 +
<span style="color:blue;">CCJournalTopCount</span>. Для версий ниже 2.11.2.141120. Устанавливает ограничение на количество выводимых строк в статистике Call-центра.
  
 
<span style="color:blue;">HandleSessionToChangeUserState</span>. «1» - при блокировании сессии авторизованного пользователя windows производится автоматический перевод состояния авторизованного пользователя oktell в «Нет на месте». При возврате в сессию производится автоматический перевод в «На месте». При этом перевод не осуществляется, если в момент блокировки пользователь не был свободен (находился в разговоре, в резерве или в состоянии перерыва), при этом не производится и обратного перевода при входе в сессию. «0» - действие по автоматической смене состояний не применяется. По умолчанию «1».
 
<span style="color:blue;">HandleSessionToChangeUserState</span>. «1» - при блокировании сессии авторизованного пользователя windows производится автоматический перевод состояния авторизованного пользователя oktell в «Нет на месте». При возврате в сессию производится автоматический перевод в «На месте». При этом перевод не осуществляется, если в момент блокировки пользователь не был свободен (находился в разговоре, в резерве или в состоянии перерыва), при этом не производится и обратного перевода при входе в сессию. «0» - действие по автоматической смене состояний не применяется. По умолчанию «1».
Строка 577: Строка 668:
  
 
<span style="color:blue;">PingTimeoutNotify</span>. Устанавливает период в миллисекундах, при превышении которого в момент вызова метода Ping возникает уведомление о плохой связи с сервером.  
 
<span style="color:blue;">PingTimeoutNotify</span>. Устанавливает период в миллисекундах, при превышении которого в момент вызова метода Ping возникает уведомление о плохой связи с сервером.  
 +
 +
<span style="color:blue;">Debug_PingPause</span>. Устанавливает паузу между опросами от клиентского приложения к серверу.
 +
 +
<span style="color:blue;">Debug_PingOutTimes</span>. Устанавливает количество неудачных опросов, после которого закрывать клиентское приложение.
  
 
<span style="color:blue;">ActivationServer</span>. Ссылка на сайт активаций для режима автоматической активации тестовой версии. По умолчанию «http://activate.telsystems.ru».
 
<span style="color:blue;">ActivationServer</span>. Ссылка на сайт активаций для режима автоматической активации тестовой версии. По умолчанию «http://activate.telsystems.ru».
  
  
 +
<span style="color:blue;">ShowLoadingBar</span>. Отображает полосу загрузки при открытии модулей клиентского приложения. В некоторых случаях, улучшает работу отрисовки приложения. «0» - не отображает, «1» - отображает. По умолчанию «1».
  
 
<span style="color:blue;">helplinks</span>. Тип используемой справки: «0» - встроенная справка в файле manual.chm, «1» - ссылка на вики. По умолчанию «1».
 
<span style="color:blue;">helplinks</span>. Тип используемой справки: «0» - встроенная справка в файле manual.chm, «1» - ссылка на вики. По умолчанию «1».
 +
 +
<span style="color:blue;">BrowserType</span>. Используемый браузер в приложении: «1»- IE7, «2»- IE7, «3»- Chrome18. По умолчанию «3»
  
 
<span style="color:blue;">FaxPreperformProcess</span>. Режим работы факса при отправке с клиентского приложения: «0» - обычный режим отправки изображений с преобразованием на сервере к необходимому виду. «1» - использование локального XPS-принтера для изготовления общего многостраничного файла TIFF из нескольких выбранных документов (для этого режима необходимы .NET Framework 3.0, установленный Microsoft Office версии 2003 или старше, установленный XPS принтер). По умолчанию «0».
 
<span style="color:blue;">FaxPreperformProcess</span>. Режим работы факса при отправке с клиентского приложения: «0» - обычный режим отправки изображений с преобразованием на сервере к необходимому виду. «1» - использование локального XPS-принтера для изготовления общего многостраничного файла TIFF из нескольких выбранных документов (для этого режима необходимы .NET Framework 3.0, установленный Microsoft Office версии 2003 или старше, установленный XPS принтер). По умолчанию «0».
  
<div id="">AutoUserStateChangeOnSystemLock</div>
+
<div id="AutoUserStateChangeOnSystemLock"></div>
<span style="color:blue;">AutoUserStateChangeOnSystemLock</span>. 1 - активирует режим автоматического перевода состояния пользователя в ''Отключен'' или ''Перерыв'' (в зависимости от присутствия пользователя в режиме Call-центра) при блокировке ОС и автоматический перевод обратно при входе в систему снова. 0 - не использует режим. По умчоланию 1.
+
<span style="color:blue;">AutoUserStateChangeOnSystemLock</span>. 1 - активирует режим автоматического перевода состояния пользователя в ''Отключен'' или ''Перерыв'' (в зависимости от присутствия пользователя в режиме Call-центра) при блокировке ОС и автоматический перевод обратно при входе в систему снова. 0 - не использует режим. По умолчанию 1.
  
<div id="">PhoneDirectDigit</div>
+
<div id="PhoneDirectDigit"></div>
 
<span style="color:blue;">PhoneDirectDigit</span>. Определяет поведение софт-телефона. 1 - в активном состоянии набор символов осуществляется по одному, ввод в текстовое поле невозможен, кнопка «Набрать» недоступна. 0 - набор осуществляется в текстовое поле, после чего кнопкой «Набрать» отправляется на сервер. По умолчанию 0. Это касается состояний набора номера, коммутаций с абонентами, коммутаций с IVR, ожидания ответа, ожидания факс-сеанса.
 
<span style="color:blue;">PhoneDirectDigit</span>. Определяет поведение софт-телефона. 1 - в активном состоянии набор символов осуществляется по одному, ввод в текстовое поле невозможен, кнопка «Набрать» недоступна. 0 - набор осуществляется в текстовое поле, после чего кнопкой «Набрать» отправляется на сервер. По умолчанию 0. Это касается состояний набора номера, коммутаций с абонентами, коммутаций с IVR, ожидания ответа, ожидания факс-сеанса.
  

Текущая версия на 10:45, 16 июня 2023

Наверх

Ряд настроек комплекса хранится в файлах конфигурации соответствующих приложений. Файл конфигурации загружается однократно в момент запуска приложения, и хранящиеся в нем настройки не могут быть изменены в ходе работы. Любые изменения файлов конфигурации применяются только при следующем запуске соответствующего приложения.

Настройки файла конфигурации клиентского приложения влияют на работу только конкретного клиента.


Файлы конфигурации находятся в том же каталоге, в котором расположен запускаемый модуль.

Файл конфигурации клиентского приложения: oktell.ClientStarter4.exe.config

Файл конфигурации серверной службы: oktell.ServerService.exe.config (приложения - oktell.ServerForm.exe.config)

Файлы конфигурации есть также у ряда сопутствующих сервисов: служба файл-сервера, служба обмена межсерверными сообщениями, служба туннелирования запросов в БД, служба сервера видео-конференций, и т.д.


Изменять файлы необходимо в редакторах, не изменяющих кодировку (рекомендуется стандартный редактор «Блокнот»). Такие редакторы как «Microsoft Word» и «Wordpad» сбивают кодировку, в следствие чего запуск приложения системы становится невозможным. При попытке запуска с некорректным конфигурационном файлом возникает системное окно с описанием ошибки.

Конфигурационные файлы содержат ряд служебных настроек, поэтому в целях сохранения целостности и работоспособности не рекомендуется изменять формат файла и параметры, у которых нет описания.

Формат представляет собой стандартный XML-документ со специфическими элементами. Допустимые настройки находятся в разделе между тегами <appSettings> и </appSettings>. Каждый конкретный параметр представляет собой строку

 <add key="KEY_STRING" value="VALUE_STRING" />

где KEY_STRING-название параметра,VALUE_STRING-значение параметра.Комментарии располагаются между строками <!-- и -->.




Обновление клиентских конфигураций

При необходимости обновить настройки файлов конфигурации у всех или некоторых клиентов можно воспользоваться системой обновления (каталог LiveUpdate сервера). Размещение клиентского конфигурационного файла целиком возможно только в том случае, когда все настройки, включая адрес сервера, идентичны у всех клиентов. При различиях можно воспользоваться служебным механизмом частичного обновления: файлы update*.config, находящиеся в каталоге LiveUpdate, сортируются лексикографически и применяются к тем клиентам, которые определены в настройках каждого из этих файлов. При этом могут быть указаны конкретные клиентские места, или исключения. Клиентские места указываются с помощью идентификатора, определяющего его в карте сети (любой принадлежащий ему IP-адрес, имя хоста, либо хеш-идентификатор, определенный ключом ManualHostAddress).

Например, нижеприведенный файл update1.config применится на всех клиентах, локальный адрес которых 192.168.0.12 или 192.168.0.13. При этом будут добавлены/обновлены ключи "xxx" и "yyy", а ключ "zzz" будет удален.

<?xml version="1.0"?>
<configuration>

  <updateAddress>
  	<include address="192.168.0.12"/>
  	<include address="192.168.0.13"/>
  </updateAddress>

  <appSettings>

	<add key="xxx" value="111" />
	<add key="yyy" value="555" />
	<add key="zzz" />

  </appSettings>

</configuration>


По умолчанию при отсутствии раздела updateAddress изменение конфигурационного файла производится на всех клиентских рабочих местах, подключающихся к серверу. Могут быть обновлены конкретные (<include address="*"/>), или все кроме указанных (<exclude address="*"/>), где * - IP-адрес, имя хоста или хеш-идентификатор.

Обновиться самостоятельно могут только те клиенты, которые в силу текущих настроек конфигурационного файла способны подключиться к серверу.


Параметры файла конфигурации серверного приложения

Language. Определяет языковую схему, используемую комплексом. В основном каталоге приложения находятся файлы Lang*.xml, представляющие собой наборы текстов для отображения в клиентских интерфейсах и БД. Для выбора того или иного языка необходимо в качестве значения данного параметра выставить соответствующее расширение имени файла (*). Например для использования файла LangRus.xml необходимо прописать значение «rus».

Язык по умолчанию – русский (применяется, если в конфигурационном файле не указан язык, или если не найден файл указанного языка).

Русский также является базовым языком. То есть если какого-либо кода не найдено в файле языка, то в альтернативу будет применен русский текст, заданный в коде программы. Язык также определяется в конфигурационном файле клиентского приложения, но после подключения к серверу клиентское приложение синхронизирует язык с установленным на сервере.

Локализация программы производится компаниями-партнерами, файлы с текстами могут распространяться в открытом и шифрованном виде. В последнем случае осуществляется привязка к лицензии.

HALSeparate. Режим запуска модуля поддержки оборудования. «0» - в текущем процессе, «1» - в отдельном процессе используя взаимодействие через NET.Remoting, «2» - в отдельном процессе используя собственный альтернативный канал связи по протоколу TCP.

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

В момент перерегистрации все линии переходят в состояние «Отключена», пользователи переходят в состояние «Без телефона», все коммутации разрываются, логика резервирований очищается. Менеджер задач реагирует способом, аналогичным тому случаю, когда абоненты на внешних линиях положили трубки. Возможно файлы записей оборвавшихся разговоров будут иметь некорректный заголовок, что сделает невозможным их прослушивание стандартными средствами. Полностью процесс автоматической переинициализации занимает 5-10 секунд.

HALRemoteAddress. Адрес расположения вынесенной в отдельной процесс службы HAL. По умолчанию localhost.

HALRemotePort. Порт доступа к вынесенной в отдельный процесс службе HAL. По умолчанию 4052.


Раздел Настройки серверов HAL.

START_SERVER. Индексированные параметры, определяющие запускаемые серверы аппаратуры. Доступные серверы: Сервер CTI плат Ольха-9, Сервер CTI плат Ольха-14, сервер CTI плат Synway, сервер SIP, серверы VoIP телефонии. При установке системы параметры выставляются согласно выбранным в дистрибутиве значениям. Однако в сложных системах могут потребоваться модификации. Например, в случае если происходит замена типа платы на рабочей системе, использование нескольких разных типов плат, а также при запуске нескольких VoIP серверов, обслуживающих разные подсети. Загрузке подлежат серверы с индексами от 1 до 32 (в примере - часть строки XX).


Сервер плат «Ольха 9», «Ольха 14»:

<add key="START_SERVER_XX" value="Alder9 Server;oktell.HALAlder9Srv.dll;Alder9;_Loaders\" />

<add key="START_SERVER_XX" value="Alder14 Server;oktell.HALAlder9Srv.dll;Alder14;_Loaders\" />

Последний элемент строки после точки с запятой указывает путь к файлам-загрузчикам. По умолчанию это подкаталог серверной службы _Loaders.


Сервер плат «Synway»:

<add key="START_SERVER_XX" value="Synway Server;oktell.HALSynwaySrv.dll;ShCti;" />


Сервер плат «Yeastar»:

<add key="START_SERVER_XX" value="E1 Yeastar Server;oktell.HALYeastarSrv.dll;YeaCTI" />

<add key="START_SERVER_XX" value="TDM800 Yeastar Server;oktell.HALYeastarSrv.dll;TDM800" />


Сервер SIP:

<add key="START_SERVER_XX" value="SIP Server;oktell.HALSipSrv.dll;SIP;sip:*:5060" />

Последний элемент строки после точки с запятой устанавливает детальные настройки сетевого интерфейса и порта, на которых запускаемый SIP-сервер будет активен. По умолчанию «sip:*:5060», то есть сервер слушает все интерфейсы на порте 5060. При необходимости установить какой-либо конкретный интерфейс необходимо вместо «*» указать его адрес.


Серверы VoIP:

<add key="START_SERVER_XX" value="Buildin VOIP Server;;Voip;localhost:4003" />

Последний элемент строки после точки с запятой указывает сетевой интерфейс и порт слушателя регистраций локальных устройств. При необходимости использования сервера для поддержки локальных устройств разных подсетей возможно запустить несколько VoIP-серверов - несколько однотипных строчек файла конфигурации с разными индексами и разными сетевыми интерфейсами.


Сервер виртуальных каналов

<add key="START_SERVER_XX" value="Virtual Server;oktell.HALVirtualSrv.dll;VS;12/10" />

Последний элемент строки указывает количество используемых каналов - внешних/внутренних.


RTP_PORT_START. Начальный порт для обмена RTP-трафиком медиа-подсистемой (SIP, VoIP). По умолчанию 9000.

RTP_PORT_COUNT. Количество портов, начиная со стартового, доступные для медиа-подсистемы (SIP, VoIP). По умолчанию 10000.

RTP_MAX_CHANNELS. Количество сокетов получения RTP-трафика на один поток-слушатель. От 1 до 32. (SIP, VoIP). По умолчанию 8.

USE_AFFINITY_MASK. «1» - использовать разделение задач по процессорам. Половина процессоров для сервера логики, другая половина для сервера HAL. «0» - значение по умолчанию. В этом случае операционная система самостоятельно занимается распределением.

JITTER_DEPTH. Значение глубины джиттер-буфера на сервере. Минимальное значение - «4», по умолчанию - «4». При увеличении значения происходит рост задержки в голосовом обмене по направлению звука к серверу, эффективнее исключая влияние проблем сети.

TIMER_TYPE. Тип используемого таймера высокой разрешающей способности для тактирования звуковых пакетов. На разных операционных системах и компьютерах различные варианты таймеров могут иметь достаточно сильную погрешность, влияющую на итоговое качество звука. Основная задача при выборе таймера состоит в обеспечении корректного среднего промежутка времени между тиками. Замечены случаи, когда некоторые из вариантов таймеров ОС тактируют постоянно увеличенные интервалы времени (например постоянно 46 мс вместо 40 положенных). Если не происходит корректировок, то такой таймер следует заменить на другой тип. Для определения значений всех вариантов таймеров можно использовать специальное тестовое приложение.

Возможные значения:

0 - Системный таймер по умолчанию. Дает более точное тактирование по сравнению с таймером на ожидании. Выдает точное тактирование в Windows Vista и некоторую погрешность в предыдущих версиях Windows. Система буферизации звука в этом случае сглаживает разброс, однако существуют компьютеры, где погрешность таймера постоянна. Это влечет пропуск пакетов и заметное ухудшение итогового качества звука. На таких компьютерах необходимо использовать другие типы таймеров. Рекомендуется мультимедийный.
1 - Системный таймер в собственном потоке приложения.
2 - Имплементация таймера в потоке с использованием функции WaitForSingleObject().
3 - Мультимедийный таймер. Дает наиболее точное тактирование, однако имеет общее ограничение на количество одновременно существующих таймеров в системе (16 объектов). Сервер Oktell использует 3 объекта таймера высокой разрешающей способности.
4 - Автоопределение. На старте системы осуществляется тестовый прогон всех вариантов таймеров и определяется средне наиболее точный. В случае, если все имеют одинаковую среднюю точность, предпочтение отдается таймеру с меньшим индексом (таймер по умолчанию системный, таймер ожидания, мультимедийный). На прогон теста на старте системы выделяется лишняя секунда.По умолчанию «4».


TIMER_HIGHRES. Тип используемого счетчика интервалов времени. «0» - миллисекундный системный счетчик GetTickCount, «1» - Query Performance Counter. По умолчанию «1».

FORCE_BRACKETS_FOR_URI. «1» - значения заголовков To и From отправляемых SIP-пакетов размещаются в треугольных скобках. По умолчанию «0».


EnableSipTransportFilter. «1» - активирует на сервере спам-фильтр, защищающий от атак на SIP-подсистему. При поступлении с одного IP-адреса за короткий отрезок времени чрезмерно большого количества регистрационных пакетов, завершающихся неудачей по причине неверной авторизационной информации, осуществляется блокирование адреса на период времени, указанный в параметре и исчислимый в минутах. На все попытки регистрации с заблокированного IP-адреса сервер не отвечает никаким образом. По умолчанию 1440 минут (= 1 сутки), 1 - не отключать фильтрацию адреса вплоть до перезагрузки сервера, остальные действительные значения являются непосредственными значениями интервала в минутах. 0 - режим отключен.


Раздел Настройки клиентских подключений.

PBXServerPort. Порт для подключения собственных клиентских приложений через механизм NET.Remoting (устаревш.).

InternalClientPort. Порт для подключения собственных клиентских приложений и приложений на базе клиентского ядра через встроенную надстройку над протоколом TCP. По умолчанию 4054.

ExternalClientPort. Порт для подключения внешних приложений 4053.

SIP_ENABLE_TCP. Разрешает TCP-подключение по протоколу SIP. Конкретный порт зависит от настроек SIP-сервера (по умолчанию 5060). «0» - не активно, «1» - активно. По умолчанию «0».


Раздел Настройки автодозвона.

ACM_UseIntercom. «1» - активирует интерком-звонок при автодозвоне, в случае схемы "абонент, затем пользователь", «0» - выключает. По умолчанию «1»

ACM_DisableIntercomModeBack. «0» - активирует интерком-звонок при автодозвоне, в случае схемы "пользователь, затем абонент", «1» - выключает. По умолчанию «0»


Раздел Настройки рабочего каталога.

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

WORK_ROOTDIR_TYPE. Устанавливает один из нескольких возможных вариантов размещения рабочей папки. Используется, если не задана рабочая папка в явном виде. Возможные варианты: 0 – папка запустившего процесс выполняемого файла, 2 – Documents And Settings\All Users, 3 – Documents And Settings\CurrentUser (C:\Users\User\AppData\Roaming\Oktell\Client\Scripts\Ivr)



Раздел Настройки доступа к БД.

DBServerName. Адрес сервера, на котором находится база данных MSSQL. По умолчанию «(local)».

DBName. Имя основной оперативной базы данных, к которой производится подключение. По умолчанию «oktell».

DBNameCC. Имя базы данных статистики call-центра. По умолчанию «oktell_cc_temp».

DBNameSettings. Имя базы данных с настройками системы. По умолчанию «oktell_settings».

DBLogin. Имя пользователя, учетной записью которого пользуется система. По умолчанию «AutelService».

DBInstanceName. Имя экземпляра сервера MSSQL. По умолчанию «MSSQLSERVER». Для доступа к службе, обеспечивающей работу БД. В момент запуска службы Oktell осуществляется проверка доступности БД. Если SQLServer, обслуживающий БД коммуникационного сервера, находится на том же компьютере, что и служба Oktell, то при невозможности обращения к БД Oktellпроверяет и перезапускает локальную службу SQLServer (указанный instance).

Если работа SQLServer осуществляется на другом компьютере, то во избежании запуска службы SQLServer на локальной машине в значение поля можно поставить «0». Октелл будет осуществлять бесконечное ожидание корректного подключения к БД перед началом загрузки, а сервер баз данных не будет загружать в ОЗУ свои данные, тем самым коммуникационный сервер будет гарантирован от кэширования данных на диск, и, как следствие, временных приостановок операционной системой работы всех служб и приложений в ожидании завершения операции, что достаточно критично при активных коммутациях.

DBConnectionString. Строка подключения, задаваемая явно. Используется при настройке подключения к службам SQL с индивидуальными параметрами, при которых не подходят параметры по умолчанию. При отсуствии этого свойства, или пустом его значении, подставляется строка:

"server=(local);database=oktell;uid=AutelService;pwd=[pwd];pooling=true",

где значения параметров server, database и uid подставляются из вышеописанных свойств. При явном указании строки подключения пароль может быть указан явно, либо использована последовательность символов «[pwd]», указывающая системе на необходимость подстановки пароля для логина AutelService.

DBTransactionLogSize_1, DBTransactionLogSize_2. Размеры транзакционных лог-файлов баз данных - основной и пространственной. По умолчанию по 500 МБ.

DBBackupDir. Путь к каталогу на сервере баз данных, в котором осуществляется создание резервных копий баз данных. По умолчанию это Backup в рабочей папке сервера. Однако в случае, если сервер баз данных работает на отдельном компьютере, путь должен существовать именно на нём.

DBAutoDailyBackup. «1» - устанавливает режим автоматического ежедневного резервного копирования баз данных одновременно с оптимизацией используемых баз данных. Режим оптимизации сам по себе настраивается в разделе Администрирование. Общие настройки. Управление базами данных. Если режим ежедневной оптимизации отключен, то вне зависимости от значения описываемого параметра резервная копия создана не будет. Cоздание файлов резервных копий производится на компьютере, где установлен текущий используемый MSSQLServer. Файлы размещаются в каталоге, установленном параметром DBBackupDir, а при его отсутствии в каталоге, путь к которому совпадает с рабочей папкой службы сервера в подкаталоге \Backup. Файлы резервных копий баз имеют названия db_ok.bak, db_okcc.bak, db_okset.bak, при ежедневном автоматическом создании резервных копий предыдущие резервные копии автоматически заменяются новыми. При необходимости осуществлять хранение нескольких копий за некоторый промежуток времени необходимо налаживать схему бэкапа или копирования файлов самостоятельно.

ScrBackupDir. Путь к каталогу на сервере АТС, в котором осуществляется создание резервных архивов со сценариями. По умолчанию это каталог Backup в рабочей папке сервера.

RepUpdateDir. Каталог с обновлениями отчетов call-центра.

DBUpdateDir. Каталог с обновлениями для БД.

DBUpdateDirExtern. Каталог с внешними обновлениями для БД. Расположенные здесь файлы с текстом, представляющим собой один совокупность нескольких SQL-batch, исполняются в БД по очередности их имен в момент запуска сервера. После успешного исполнения файлы удаляются. В случае возникновения ошибок их описание можно обнаружить в лог-журнале Exception.

PauseTMOnDbQueueLength. Определяет количество сообщений в очереди на сохранение в БД, при котором менеджер задач приостанавливает совершение звонков по исходящим голосовым задачам. Система считает, что таким образом нагрузка уменьшается, и БД имеет больше шансов к уменьшению очереди запросов. По умолчанию 100. Бывают случаи временной загрузки БД, когда своп происходит редко и длится в течение минуты или более того, а в остальные случаи сервер БД не подвержен притормаживанию. В этом случае имеет смысл оценить производительность сервера и увеличить максимальный предел очереди вплоть до нескольких тысяч. Отсутствие предела может привести в особо критичных случаях к тому, что данных в очереди накопится чрезмерно много, что выльется либо в нехватку памяти процессу, либо в несохранение результатов звонков после их совершения в случае сбоя сервера или базы данных.

PauseProgressiveOnDbQueueLength. Аналогичный предыдущему параметр для прогрессивного пула задач. Может иметь обособленную настройку и сказывается на запуск прогрессивных исходящих звонков. По умолчанию 50;


UseDbRemote. Довольно большое количество обращений из клиентских приложений к серверу являются суть запросами к БД. 1 - использует отдельный процесс туннелирования (oktell.DbRemoteService.exe) для прямых обращений к БД из клиентских приложений. 0 - все обращения к БД через основную службу. По умолчанию 0. При подключении к службе туннелирования все клиенты проходят аутентификацию. Служба туннелирования получает параметры доступа к БД из конфигурационного файла основной службы Oktell. Собственный конфигурационный файл необходим лишь для определения способа старта (служба или приложение), порта слушателя TCP подключений, а также возможно некоторых настроек логирования.

CheckStartDbRemote. Применяется в случае использования отдельного процесса туннелирования доступа клиентских приложений к БД. 1 - указывает серверу на необходимость самостоятельного запуска процесса; процесс при этом запускается на том же физическом сервере, где и основная служба Oktell; при завершении службы при этом процесс выгружается. 0 - указывает на необходимость подключения к постоянно запущенной службе (при этом служба может находиться на другом физическом сервере). По умолчанию 1. В конфигурационном файле службы туннелирования устанавливается, какой способ запуска используется - как служба или как приложение (ключ IsService). Настройки доступа к процессу туннелирования и самого процесса должны соответствовать друг другу.

DbRemoteServer. Применяется в случае использования отдельного процесса туннелирования доступа клиентских приложений к БД. Определяет адрес и порт для TCP доступа к приложению («address:port»). Сервер с помощью них осуществляет самостоятельное подключение для управления, а также выдает этот адрес клиентам для организации их собственных каналов связи. В случае, если указан localhost (используется по умолчанию), сервер выдает клиентам свой публичный адрес. Порт указывается в конфигурационном файле приложения/службы oktell.DbRemoteService.exe, по умолчанию 4086.


Раздел Настройки службы.

EnableEmptyAdmin. «1» - активирует на сервере возможность пользования учетной записью системного администратора. По умолчанию запись доступна только на сервере, где неактивен сервер состояний или среди учетных записей пользователей которого не существует ни одной, обладающей базовой ролью администратора. Может понадобиться в случае, если пароль учетной записи администратора утерян. Для применения требуется перезапуск службы сервера. По умолчанию «0».

EnableAutoMap. «1» - активирован режим, при котором авторизация с рабочего места, не имеющего в карте сети учетной записи, приводит к автоматической временной регистрации на сервере рабочего места, снабженного USB-телефоном. «0» - доступ с неизвестных рабочих станций заблокирован. В целях обеспечения работы веб-клиентов, значение по умолчанию «1».

EnableAutoMapSip. «1» - активирован режим, при котором при динамической регистрации вместо создания динамической линии USB-телефона производится связка с существующим в карте сети SIP-телефоном. Связка осуществляется по совпадению логина телефона с логином пользователя, либо по совпадению назначенного «пользователя по умолчанию» с авторизующимся пользователем. Для работы требуется включение параметра EnableAutoMap. «0» - связка динамических рабочих мест с SIP-телефонами не используется.

UseWlockForDynamicReg. «1» - использовать блокировку писателя при добавлении/удалении динамических рабочих мест. По умолчанию «0» - использовать блокировку читателя.

Use4xLineNumbers. «1» - использовать при создании линий четырехзначную числовую нумерацию (0000-9999). Может быть использовано в проектах с более чем 1000 линий одного типа. По умолчанию «0».


ManualHostAddress. Устанавливает уникальное имя сервера для идентификации в карте сети на старте службы. В случае, если в качестве адреса сервера в карте сети указано это значение - позволяет устранить зависимость от смены DNS-имени, а также смены и назначения динамических адресов сервера.

Следует обратить внимание, что сервер может являться также и клиентской рабочей станцией. В этом случае необходимо в файл конфигурации клиентского приложения на сервере задать аналогичный параметр тем же значением, либо создать в карте сети отдельный компьютер с указанным реальным адресом или любой другой уникальной строкой (в случае использования на клиенте аналогичной схемы подмены адреса).

ProcessPriority. Приоритет серверного процесса. По умолчанию «0» - Нормальный. «1» - выше среднего, «2» - высокий, «3» - реального времени.

HALRemoteProcessPriority. Приоритет процесса HALRemote. «0» - нормальный, «1» - выше среднего (по умолчанию), «2» - высокий, «3» - реального времени.

Default_DateTime_Format. Индексированные параметры, определяющие нестандартныей варианты преобразования типа СТРОКА к типу ДАТАВРЕМЯ. Используются строки с индексами от 0 до 99, перебор в ходе работы осуществляется в порядке увеличения индексов.

MixerDeleteSourceRecords. «1» - удалять исходные файлы записей коммутаций после упаковки и/или микширования, «0» - оставлять на месте. По умолчанию «1».

CheckRecordDriveEmptySpace. «1» - осуществляет слежение за объемом свободного места на диске для записи разговоров. «0» - игнорирует проверку. Игнорирование может потребоваться при использовании сетевых дисков для записи, размер свободного пространства которых системой определяется нулевым, а также при использовании файлового сервера. По умолчанию «1».

TaskListAbonentUseLikeNumber. «1» - позволяет активировать поиск абонентской строчки в таблице абонентов с фильтром "number like '%x%'". По умолчанию «0» и поиск осуществляется только по идентификатору абонента.

SkipCloseMutexCommand. Режим автоматического закрытия сервера через мьютекс-команду необходим в целях исключения проблем с операциями обнаружения процессов. Встречаются системы, в которых отключены или недееспособны службы, необходимые для обнаружения внешнего процесса. В этом случае процесс копира не в состоянии при необходимости остановить серверный процесс перед обновлением и/или для перезапуска. «1» - пропускать команду закрытия, отданную через системные мьютексы процессом копира. «0» и другие значения - команда будет распознаваться и сервер будет реагировать на нее автоматическим закрытием.

UseSimpleLineState. Определяет способ привязки состояний внутренних номеров, ссылающихся на линии к состоянию самих линий. Если указать 0, то состояние номера, в случае свободности подчиненной ему линии, будет оцениваться по состоянию привязанного к ней пользователя. По умолчанию 1.

HideGhostMonitor. 1 - скрывает слушателей разговора друг от друга, 0 - делает их доступными друг другу. По умолчанию 1.

GCCollectorPeriodMin. Определяет периодичность принудительного запуска сборщика мусора .NET в минутах. По умолчанию 1 минута.

UseNumStateChangedEventDelayer. Интервал в мс, определяющий задержку перед рассылкой уведомлений о смене состояния номеров в номерном плане. 0 - выключено. По умолчанию 500. Применяется при большом количестве номеров и пользователей, следящих за их изменением. За время задержки происходит накопление данных и отправка одним пакетом. Позволяет экономить вычислительную мощность.

DEBUG_incomingemail. Логирование в common логе сервера принимаемых e-mail сообщений (pop3) "1" - включено. По умолчанию выключено.

DEBUG_LogActiveThreadStackTrace. При установке значения «1» производит вывод в лог DEBUG информации о стеке всех активных потоков основной службы сервера.


UsePriorSwitchCallername. При осуществлении переключения из сценария на внутренний номер определяет, что будет отображаться в качестве имени абонента (callername) на sip-телефоне. 0 - автоопределение; если пусто, то callername из компонента «Переключение на номер» сценария IVR. 1 - наоборот, с приоритетом заданного в компоненте значения. По умолчанию 1.

UserMessageCheckPeriodSec. Позволяет активировать отслеживание появления новых сообщений между пользователями в базе данных и отправить их на отображение. Применяется в случае индивидуальной или внешней настройки и отправки сообщений путем размещения в таблицу A_UserMessages в БД. Указывается период отслеживания появления новых в секундах. 0 - выключено. По умолчанию 0.

UserMessageCheckMakeViewed. В случае периодического отслеживания появления новых сообщений между пользователями в БД, указывает, отмечать ли их сразу как прочитанные с тем, чтобы при следующей итерации они не возникали вновь.

DBPluginCommandTimeoutSec. Позволяет задать таймаут в секундах на исполнение запросов от плагинов к БД. По умолчанию 600. Начиная с версии 120911.

AllowDownloadFilesDirectlyOnlyFromTemp. 1 - блокирует скачивание файлов с сервера через HTTP интерфейс отовсюду, кроме как из временной папки Temp и локального хранилища. 0 - разрешает скачивать произвольные файлы с диска сервера по прямой ссылке. По умолчанию 1 (блокировать).

BanUserAgentXX, XX - порядковый номер от 00 до 99. Позволяет установить SIP-транспортный фильтр для определенных значений поля User-Agent. По умолчанию банится "Friendly-Scanner" в целях снижения нагрузки и уменьшения вероятности взлома.

WhiteListIps. Позволяет установить список разрешённых IP-адресов, которые исключаются из проверки спам-фильтром. Можно указать несколько адресов через точку запятой. По умолчанию пустой список.

UpdateSelectorOnDirectorDisconnect. 1 - при выходе/выпадении управляющего из селекторного совещания производит преобразование селектора к общей конференции. 0 - оставляет селектор с теми правами и в том виде, в котором он находился в последний момент присутствия управляющего. По умолчанию «1».

PBX_Use180SdpAs183. 1 - воспринимает команду 180 Ringing с SDP содержимым как команду 183 Progress и начинает сеанс медиасвязи. Используется в режиме прослушивание медиа-потока компонента Переключение на внешние линии. 0 - генерирует стандартный сигнал КПВ (длинные гудки). По умолчанию 1.

PBX_BackFrom183To180. 1 - воспринимает команду 180 Ringing к обязательному исполнению - начинает генерацию сигнала КПВ (длинные гудки), даже если предварительно был получен ответ 183 Progress и канал находится в медиа-коммутации. Используется в режиме прослушивание медиа-потока компонента Переключение на внешние линии. 0 - пропускает такую команду. По умолчанию 0.

UseAssertedIdentity. Включает отправку SIP-заголовоков P-Asserted-Identity и Remote-Party-ID в ответ на входящие вызовы с внутренних SIP-устройств на сервер с целью отправить на отображение в SIP-устройство Сaller-name вызываемого абонента. Применяется в случае осуществления вызова на внутренний номер.

AutoScreenshotWidth, AutoScreenshotHeight. Определяют максимальные размеры скриншотов экранов, снимаемых с помощью компонента сценариев Статус объекта.

PredictivePoolTimerIntervalMs. Устанавливает общий для всей системы интервал пересчета параметров предиктивных задач в мс, в ходе которого могут быть начаты новые дозвоны (по умолчанию 5000).

PredictivePoolClearStatOnDeactivate. Устанавливает общий для всей системы режим очистки статистики в предиктивных задачах при деактивации (по умолчанию 0).

PredictivePoolExtraShiftTimeoutMs. Устанавливает общий для всей системы дополнительный интервал в мс, применяемый безусловно к спрогнозированным параметрам. Может быть отрицательным и положительным. Если указать положительное число, следующий звонок будет совершаться с запозданием, давая операторам некоторое дополнительное время, например, для перерыва. Если указать отрицательное число, следующий звонок будет совершаться раньше, чем это требуется, тем самым ускоряя темп обзвона. По умолчанию 0.

WebServerNoAuth_Loopback. Позволяет отменить требование базовой авторизации при обращении к веб-серверу по loopback-интерфейсу (из приложений на самом сервере). По умолчанию 0.


FileServer_Log, FileServer_Record. Позволяет активировать сохранение соответственно лог-журналов и записей разговоров на удаленный файл-сервер. Значение задается в формате «address:port», например «192.168.0.199:4088». В качестве файлсервера может выступать любой компьютер с установленной и активированной службой oktell.FileService.exe из каталога серверной службы Oktell. О настройке и способах работы файл-сервера доступна статья в базе знаний.

Хранение записей может происходить в разных каталогах в соответствии с настройкой в Oktell. При использовании файл-сервера в качестве хранилища записей может потребоваться подключать дополнительные хранилища и изменять путь для сохранения записей и последующего доступа к ним. Чтобы это обеспечить, необходимо подвергать корректировке совместно настройку каталога для записи в Oktell и конфиг файлового-сервера. При этом в конфигурационном файле файлового сервера требуется указание соответствия переданного службой Oktell пути с локальным путем (ключ BaseDir_*, где * - это subdir.ToLower(recordedfiles\dirname), а dirname - название последнего внутреннего каталога по выбранному службой Oktell пути; значение - локальный путь на файловом сервере. Например <add key="BaseDir_recordedfiles\path2" value="D:\_OktellWorkDir\Files\Base2\"/>. При настройке Oktell следует указывать пути, последний каталог которых имеет уникальное название и ранее не использовалось).


Раздел Настройки сервера видео-конференций.

FaceTimeLocalPort. Определяет порт локального сервиса видео-конференций. По умолчанию 4090.

FaceTimeServer. Определяет доступные серверы видео-конференций. Перечисляются через запятую с помощью алиасов, которые затем определяются отдельными ключами конфигурации. По умолчанию доступен только локальный сервер, но могут быть вместо или дополнительно настроены один или несколько обособленных серверов. Локальный сервер определяется алиасом «local». Например

<add key="FaceTimeServer" value="local, futurama, videoserver"/>

FaceTime_*. Определяет адрес и порт обособленного сервера видео-конференций. Вместо символа * подлежит указанию алиас сервера. Эта настройка должна присутствовать для каждого упомянутого алиаса кроме «local». Например

<add key="FaceTime_futurama" value="192.168.0.10:4092"/>


Раздел Управление потоками.

Позволяет ограничивать максимальное количество потоков-обработчиков для отдельных видов работ.


ThreadCountLowLimit. Количество потоков в общем пуле системы, свободно доступных службе сервера. По умолчанию 500.

ThreadCountHighLimit. Максимально допустимое количество потоков в общем пуле системы, доступных службе сервера. Потоки, находящиеся в разнице между нижним и верхним ограничениями, выделяются системой с запаздыванием. По умолчанию 700.


CachedThreadFreeMode. Режим работы пула асинхронных потоков. «0» по умолчанию - использовать пул, никогда не уничтожать потоки, «1» - не использовать пул, уничтожать потоки сразу после использования, «2» - размещать в пул на 1 секунду, уничтожать по истечении в случае простоя.


CheckReleaseRWOnAbort. По умолчанию «1» - производить дополнительную проверку блокировки критической секции сервера состояний перед освобождением асинхронного потока и освобождать в случае обнаружения. «0» - не производить.


OKTCP_CP_ThreadCountLimit. 0 - отключает ограничение на количество потоков, обслуживающих клиентские запросы.

OKTCP_CP_ThreadCountLimitHighest. Устанавливает максимально допустимое количество потоков, доступных системе для обработки высокоприоритетных клиентских запросов, таких как Ping. По умолчанию 10.

OKTCP_CP_ThreadCountLimitData. Устанавливает максимально допустимое количество потоков, доступных системе для обработки клиентских запросов, возвращающих большие объемы данных. По умолчанию 10. В момент длительной отправки данных по сети поток не считается использующимся.

OKTCP_CP_ThreadCountLimitDownload. Устанавливает максимально допустимое количество потоков, доступных системе для обработки клиентских запросов на скачивание и закачивание файлов. По умолчанию 10. В момент длительной отправки данных по сети поток не считается использующимся.

OKTCP_CP_ThreadCountLimitSetup. Устанавливает максимально допустимое количество потоков, доступных системе для обработки клиентских запросов из раздела администрирования. По умолчанию 5.

OKTCP_CP_ThreadCountLimitLiveupdate. Устанавливает максимально допустимое количество потоков, доступных системе для обработки клиентских запросов в части проверки обновлений, подготовки архива и его скачивания. По умолчанию совпадает с половиной общего количества ядер всех процессоров сервера, но не менее 2. В момент длительной отправки данных по сети поток не считается использующимся.

OKTCP_CP_ThreadCountLimitNormal. Устанавливает максимально допустимое количество потоков, доступных системе для обработки клиентских запросов в части проверки обновлений, подготовки архива и его скачивания. По умолчанию 100.

OKTCP_CP_ThreadCountLimitEvent. Устанавливает максимально допустимое количество потоков, доступных системе для рассылки событий клиентским приложениям. По умолчанию 10.


Этот же набор параметров с другим префиксом действует для службы туннелирования клиентских запросов в БД. Их указание требуется в конфигурационном файле сервера, так как конфигурационные параметры передаются в службу туннелирования из основной службы. OKTCP_DB_ThreadCountLimit. OKTCP_DB_ThreadCountLimitHighest. OKTCP_DB_ThreadCountLimitData. OKTCP_DB_ThreadCountLimitDownload. OKTCP_DB_ThreadCountLimitSetup. OKTCP_DB_ThreadCountLimitNormal.


OKTCP_HALL_ThreadCountLimit. Устанавливает максимально допустимое количество потоков, доступных системе для взаимодействия с внешним процессом HAL. По умолчанию 0 - не ограничено.

OKTCP_HALR_ThreadCountLimit. Применяется в конфигурационном файле внешнего процесса HAL (oktell.HALRemoteApp.exe) или в собственном (если процесс настроен на работу с конфигурационным файлом основной службы). Устанавливает максимально допустимое количество потоков, доступных внешнему процессу HAL для взаимодействия с основным процессом службы. По умолчанию 0 - не ограничено.

Line_ThreadCountLimit. Устанавливает максимально допустимое количество потоков, обслуживающих каналы АТС. По умолчанию 20.

Script_ThreadCountLimit. Устанавливает максимально допустимое количество потоков, обслуживающих сценарии. По умолчанию 20.

TML_ThreadCountLimit. Устанавливает максимально допустимое количество потоков, обслуживающих звонки в голосовых задачах. По умолчанию 10.


Раздел LOG.

Хранит настройки лог-сервера комплекса. Среди неописываемых настроек - пути к папкам для сбора журналов.

LOG_storedays. Длительность хранения лог-журналов в днях. По умолчанию «7». По истечении указанного периода журналы удаляются системой. В некоторых случаях объем журналов может достигать нескольких гигабайтов за день.

LOG_maxfilesize. Максимальный размер одного файла лог-журнала в МБ. При достижении лог-журналом указанного размера логирование прекращается. Имеет воздействие на все лог-журналы, исключая HAL (Hardware). По умолчанию 3 ГБ.

LOG_maxpartsize. Позволяет настроить максимальный размер одного файла в МБ. По умолчанию 500 МБ. При достижении лог-журналом указанного размера формируется новый файл. Имеет воздействие на все лог-журналы, исключая HAL (Hardware).

LOG_root. Абсолютный или относительный путь к папке с лог-журналами. По умолчанию «Log», то есть относительный путь в каталоге серверной службы/приложения.


LOG_asyncwrite. Использовать асинхронную запись в лог модулем аппаратуры. По умолчанию «0» - выключено.

LOG_cachesize. Размер кэша памяти(в Кб) хранения логов перед записью на диск. По умолчанию 128 Кб.

LOG_cachefreq. Частота(в мс) записи кэша на диск. По умолчанию 100 мс.


DebugLogTcpBufferSizeKB. Позволяет включить логирование информации обо всех объемных пакетах, переданных или отправленных сервером. Указывается размер в KB, выше которого пакеты логируются в Debug лог. По умолчанию 0 - не логировать.

DebugLogCPEventTypes. 1 - включает логирование информации обо всех событиях, отправляемых в клиентские приложения в Debug-лог. По умолчанию 0 - выключено.

WEBSOCK_LogTransform. При установке 1 выводит в лог TCP информацию о работе протокола WebSocket.

WEBSOCK_LogListener. При установке 1 выводит в лог TCP информацию о работе протокола WebSocket.

WEBSOCK_LogDebug. При установке 1 выводит в лог TCP информацию о работе протокола WebSocket.

WEBSOCK_LogPackets. При установке 1 выводит в лог TCP информацию о работе протокола WebSocket.


Раздел DEBUGGING.

Хранит настройки, согласно которым ведется заполнение служебного сервисного лог-журнала. По умолчанию все параметры выставлены в «1», что влечет полное логирование служб сервера. Полное или частичное отключение уменьшает размер журнала, однако не даст информации в случае возникновения сбоев и общением с технической поддержкой.


Раздел KEYREMOTE.

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

Параметры файла конфигурации клиентского приложения

Language. Определяет языковую схему, используемую клиентским приложением до момента подключения к соответствующему серверу. После подключения производится принудительная синхронизация языковой схемы. Фактически это происходит в момент отображения окна авторизации. Подробнее в описании ключа в разделе серверного приложения.

ServerSelectMode. Определяет, каким образом происходит выбор сервера в случае, если указано несколько адресов (нижеперечисленные ключи конфигурации). «0» - в окне авторизации отображается список серверов в соответствии с перечислением в конфигурационном файле. При автоматическом переподключении всегда берется последний активный сервер. «1» - осуществляется автоматический перебор серверов начиная с самого первого. Подключение производится к тому, который дал положительный ответ. При автоматическом подключении без окна авторизации в учет берется не только подключение, но и ответ авторизации. Таким образом будет активирован сервер, успешно подключенный и разрешивший вход. В этом случае в окне авторизации список серверов для выбора не отображается. «2» - перебор серверов осуществляется автоматически, начиная с последнего активированного. «3» - случайный выбор сервера. «4» - основной сервер единственный, при потере связи с ним подключение осуществляется к одному из резервных на основании случайного выбора. По умолчанию - 0.

ConnectBackReserve. «1» - активирует режим мониторинга за появлением основного сервера в случае, если текущее подключение установлено с резервным сервером. Применяется при настройке резервных схем с преимущественной привязкой к одному серверу.


Раздел Подключения к серверу.

NetConnectionName. Название подключения (сервера) для отображения в окне авторизации (при указании нескольких возможных подключений).

LogicServerAddress. Адрес для подключения к серверу логики.

LogicServerPort. Порт для подключения к серверу логики.

ConnectProtocol. Устанавливает протокол, по которому осуществляется подключение клиента к серверу. 0 - по умолчанию 1 - Remoting, 2 - OkTCP.

NETCLIENT_SERVER_ADDRESS. Адрес для подключения к серверу аппаратуры.

NETCLIENT_SERVER_PORT. Порт на сервере для подключения к нему по сигнальному протоколу.

NETCLIENT_LOCAL_PORT. Локальный порт для обмена сигнальным трафиком по UDP. Используется для версий 2.9 и ниже, работающих по VOIP-технологии.

NETCLIENT_VOICE_PORT. Локальный порт для обмена голосовым трафиком по UDP.

SipDomain. Переопределяет доменное имя SIP-сервера при отправке регистрационных пакетов с клиентского локального устройства. Явное указание может потребоваться в случае нестандартных настроек NAT сервера.

SipPort. Переопределяет порт SIP-сервера при отправке SIP пакетов с клиентского локального устройства. Явное указание может потребоваться в случае нестандартных настроек NAT сервера. По умолчанию 5060.

SipLocalPort. Переопределяет локальный порт клиентского приложения для обмена сигнальным трафиком по протоколу SIP. По умолчанию 5080. Работает начиная с версии 2.11.

ВНИМАНИЕ! Вышеперечисленные параметры (NetConnectionName, ..., NETCLIENT_VOICE_PORT) определяют различные адреса и порты для организации сетевого канала подключения к серверу. Эти параметры могут присутствовать в конфигурационном файле несколько раз с добавлением к концу строки-ключа разных целочисленных индексов. Например NetConnectionName_1 и NetConnectionName_2. Индекс 0 не указывается, вместо него используется значение без индекса. В случае указания в конфигурационном файле нескольких подключений в окне авторизации будет отображен список их имен и доступен выбор одного из них. Это удобно использовать при работе с несколькими серверами с одних и тех же клиентских рабочих станций.


SipDomainMode. Режим формирования доменного имени при подключении локального устройства по SIP к серверу. По умолчанию используется IP-адрес указанного в конфигурационном файле доменного имени логического сервера (=2). Варианты: 0 - имя хоста серверной машины, 1 - указанное в конфигурационном файле доменное имя логического сервера. В любом случае доменное имя может быть явно переопределено параметром конфига #SipDomain, если он установлен для текущего подключения. В большинстве случаев изменения значения этого параметра не требуется

SipForceKeepAliveIntervalSec. Позволяет явно включить и задать интервал в секундах для отправки пакетов Keep-Alive в SIP-подключении к серверу. Может потребоваться при настройках NAT для удерживания порта.


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

WORK_ROOTDIR_TYPE. Устанавливает один из нескольких возможных вариантов размещения рабочей папки. Используется, если не задана рабочая папка в явном виде. Возможные варианты: 0 – папка запустившего процесс выполняемого файла, 1 – папка размещения основных сборок приложения, 2 – Documents And Settings\All Users, 3 – Documents And Settings\CurrentUser.

AutoUpdate. «1» - обновлять клиента автоматически. «0» - не обновлять автоматически при запуске, если обнаружено отличие версий. По умолчанию «1». Настоятельно не рекомендуется оставлять рабочую версию программы со значением «0» и использовать этот режим только для отладочных целей.

AutoUpdateGateway. «1» - обновлять шлюз автоматически. «0» - не трогать. По умолчанию «0». В список шлюзов требуется добавить адрес сервера, если подключение производится к серверу с несколькими сетевыми интерфейсами через интерфейс с индексом более 1. В большинстве случаев указания не требуется.

ManualHostAddress. Альтернативный псевдо-адрес клиентского компьютера для идентификации на сервере в карте сети. Может быть использован для подключения к серверу при динамически выделяемом IP-адресе и сложностях с идентификацией по HostName. Каждый клиент должен иметь уникальное значение ключа, не совпадающее с реальными возможными адресами и именами других компьютеров сети.

TerminalMode. Определяет режим подстановки адреса (для организации работы в терминальном режиме) - какой адрес берется, какое терминальное расширение для идентификации в карте сети используется (address/terminalkey). С помощью настройки вы можете передавать название вашего компьютера через удаленное подключение.

0 — адрес локальный, без терминального расширения: address.
1 — адрес локальный, терминальное расширение из текущего конфигурационного файла TerminalAddress: address/terminalkey.
2 — адрес локальный, терминальное расширение с помощью текущего авторизованного Win-User: address/user.
3 — адрес клиентского терминала (ищется активная сессия авторизованная под совпадающим с текущим win-user), терминальное расширение из текущего
конфигурационного файла TerminalAddress: clientaddress/terminalkey. 
Если удовлетворяющая условиям терминальная сессия не найдена, то используется локальный адрес. Если терминальное расширение не задано - не используется. 

По умолчанию 1.

TerminalAddress. Строка, определяющая уникальный адрес клиентского места. Приписывается ко всем адресам компьютера для определения клиентского места в карте офиса (например «FUTURAMA/terminal1»). Именно эту строку необходимо будет указать в карте офиса для идентификации. Решает проблему терминальных подключений, где все клиенты физически запускаются с одного компьютера. По умолчанию «».

ShowLoginAuthMode. 1 - отображать выбор способа авторизации (active dictionary/oktell), 0 - не отображать и использовать всегда стандартный режим. По умолчанию 1.

TimeSynchronization. «1» - синхронизировать время с сервером при запуске, «0» - не синхронизировать. По умолчанию «1».

RestartApplicationWithProcess. «1» - любой перезапуск клиента производится с выгрузкой процесса. «0» - выгрузка процесса производится только для применения обновлений, другие перезапуски осуществляются внутри процесса. По умолчанию «0».

ProcessPriority. Приоритет процесса клиентского приложения и процесса обслуживания внешних звуковых устройств. «0» - нормальный, «1» - выше среднего, «2» - высокий, «3» - реального времени. По умолчанию «1».

HAL_skip_loading. «1» - пропускать загрузку модуля обслуживания устройств работы со звуком. «0» - нормальный режим.

Register_ocx. «1» - регистрировать библиотеки обслуживаемых устройств перед запуском, «0» - не регистрировать. По умолчанию «1».

ClientWebServerPort. Устанавливает порт слушателя HTTP-запросов к клиентскому приложению (например запрос http://localhost:4059/callto?number=184 - команда на звонок через Oktell). Доступ возможен только по локальному loopback интерфейсу.

ComAsyncEventing. Применяется для форсированной активации/отключения соответствующего режима COM-ядра без изменения кода приложения. Активирует/деактивирует режим раздачи событий COM-объекта в асинхронных служебных потоках. Применяется только в случае указания значений «1» или «0». По умолчанию применяется режим, установленный в коде внешнего интегрирующего приложения. Подробно в руководстве по интеграции (раздел «Октелл в других проектах», статья «Загрузка и выгрузка модуля»).

ComXmlFullLogging. Применяется для форсированной активации/отключения соответствующего режима COM-ядра без изменения кода приложения. Активирует/деактивирует режим полного логирования всех событий и вызовов управляющего объекта. Применяется только в случае указания значений «1» или «0». По умолчанию применяется режим, установленный в коде внешнего интегрирующего приложения. Подробно в руководстве по интеграции (раздел «Октелл в других проектах», статья «Загрузка и выгрузка модуля»).

TRACE_HARDWARE. Уровень трассировки аппаратного модуля. Применяется для логирования событий в момент запуска системы. Возможны следующие ключи: CALL, NET, TRANS, SESSION, PROTO, EVENTS, TIMER, ERRORS, WARNING, RTP-FLOW, MEDIA-FLOW. Ключи необходимо перечислить в атрибуте value друг за другом через пробел. Прочитать описание ключей можно в статье Логирование

SEPARATE_PROCESS. «1» - запускать отдельный процесс для работы с устройствами. «0» - работать с устройствами в собственном процессе. По умолчанию «1».

JITTER_DEPTH. Значение глубины джиттер-буфера на клиенте, измеряемое в количестве пакетов по 20 мс. Минимальное значение - «0», по умолчанию - «6». При увеличении значения происходит рост задержки в голосовом обмене по направлению звука в локальное устройство, эффективнее устраняя влияние проблем сети. При указании «0» джиттер буфер не используется.

Если наблюдается поступление пакетов вперемешку с незначительным разбросом, и/или периодические задержки с последующим одновременным поступлением серии пакетов, увеличение значения может способствовать выравниванию звука. Для диагностики этого явления можно активировать логирование голосового трафика (TRACE_HARDWARE) или использовать программы-перехватчики трафика (снифферы), например WireShark.

WAVE_COUNT. Значение, определяющее количество буферов для обмена звуком со звуковым устройством. Минимальное значение - «2», по умолчанию - «2». При увеличении значения происходит рост задержки в голосовом обмене по направлению звука в локальное устройство, эффективнее устраняя влияние проблем в медлительности звукового устройства.

Если при ровно поступающем звуке из сети (диагностировать можно с помощью отладочной записи на входе - WAVE_COUNT, либо с помощью программ-перехватчиков трафика, например WireShark) наблюдается щелканье или пропадание кусков голосового потока, увеличение значения может способствовать выравниванию звука.

WRITE_VOICE. Отладочный параметр для оценки звукового потока на входе в клиентский HAL из сети до воспроизведения непосредственно в устройстве. «1» - отладочная запись в файл включена, файл с именем, соответствующим текущему времени размещается в корне клиентского приложения . «0» - отладочная запись отключена. По умолчанию «0».

WAVEIN_AUTOCLOSE. «1» - закрывать устройство ввода звука после завершения коммутации. «0» - оставлять открытым. По умолчанию «0».

WAVEOUT_AUTOCLOSE. «1» - закрывать устройство вывода звука после завершения коммутации. «0» - оставлять открытым. По умолчанию «0».

USE_DIRECTSOUND. Тип работы со звуком по умолчанию. Выбирается в клиентском интерфейсе. «1» - использовать для работы со звуком библиотеки DirectSound. «0» - обычный режим через системные функции Windows Multimedia (WMM). По умолчанию «0».

NETCLIENT_PAYLOAD. Кодек по умолчанию для обмена голосовым трафиком. Выбирается в клиентском интерфейсе. Здесь служит для задания начальной настройки. 0 - 711mulaw, 8 - 711alaw, 41 - gsm610. По умолчанию «8».

PHONEDEVICE_WAVEOUT. Устройство вывода звука (спикер) по умолчанию. Выбирается в клиентском интерфейсе. Здесь служит для задания начальной настройки.

PHONEDEVICE_WAVEIN. Устройство ввода звука (микрофон) по умолчанию. Выбирается в клиентском интерфейсе. Здесь служит для задания начальной настройки.

PHONEDEVICE. Имя устройства по умолчанию. Выбирается в клиентском интерфейсе. Здесь служит для задания начальной настройки.

SIGNAL_VOLUME. 0-100. Уровень громкости генерируемых в локальное устройство системных звуков и тонов. По умолчанию 50.


UseKeyHook. Параметр позволяет принудительно отключить режим перехвата действий клавиатуры для управления гарнитурой. Отключение может понадобиться при обнаружении проблем и конфликтов с операционной системой. «1» - режим перехвата активирован. «0» - режим перехвата деактивирован. По умолчанию «1». Выключение требуется на 64 разрядных ОС при работе версий до 2.8.130325.

default_HeadSet_AutoHookUp. Определяет используемый по умолчанию режим автоподнятия трубки на гарнитуре при поступлении входящего звонка. После фактического изменения настроек пользователем в параметрах локального устройства значение из конфигурационного файла теряет актуальность. По умолчанию «1».

default_HeadSet_UseKeyBoard. Определяет используемый по умолчанию режим перехвата нажатий на клавиатуре для управления гарнитурой. После фактического изменения настроек пользователем в параметрах локального устройства значение из конфигурационного файла теряет актуальность. По умолчанию «1».

default_HeadSet_UseACM. Определяет, активен ли по умолчанию режим автодозвона для гарнитуры. После фактического изменения настроек пользователем в параметрах локального устройства значение из конфигурационного файла теряет актуальность. По умолчанию «1».

default_Phone_ShowRingPopup. Определяет используемый по умолчанию способ отображения информации о вызывающем абоненте (всплывающее окно/всплывающее уведомление). После фактического изменения настроек пользователем в параметрах локального устройства значение из конфигурационного файла теряет актуальность. По умолчанию «1».

WatcherResourceLogType. Формат логирования ресурсов. С помощью параметра можно настроить вывод в клиентский лог-журнал WATCHER информации по использованию процессом ресурсов системы. Объем используемой памяти, количество открытых дескрипторов, количество потоков, пользовательские системные ресурсы, ориентировочное среднее процессорное время по всему процессу и отдельно по всем его потокам. 0 - не логировать, 1 - информация о процессе каждую секунду, 2 - информация о процессе и активным потокам каждую секунду, 3 - информация о процессе и всем его потокам каждую секунду, 4 - информация о процессе каждую минуту. По умолчанию 4.

RestoreLastModules. «1» - осуществляет при загрузке приложения загрузку и восстановление модулей, активных перед закрытием программы. «0» - запускает приложение с пустым фоном без дополнительной загрузки модулей; это экономит время на загрузке, так как некоторые модули требуют достаточно длительного времени для полной загрузки, однако пользователь при необходимости сам может активировать модуль по стандартной схеме из главного меню. По умолчанию «1».

ShowVideoNoise. «1» - в видео-окне модуля ТЕЛЕФОН при отсутствии видео-сигнала отображается черно-белый шум, «0» - черное окно. По умолчанию «1».

CameraFrameFrequencyLimit. Устанавливает ограничение на количество передаваемых кадров из клиентского приложения в сеть в ходе видео-сессии. Может использоваться при необходимости снизить исходящий трафик при видео-коммутациях с настраиваемой клиентской рабочей станцией.

CameraJitterDepth. Глубина джиттер-буфера фреймов с камеры. Позволяет нивелировать задержку в выдаче кадров в целях выравнивания отправляемого видео-потока. По умолчанию «3». «0» - не использовать джиттер.

SkipLoadCamera. «1» - пропускать загрузку модуля работы с веб-камерой. «0» - нормальный режим.

Phone_UseBlockedDelay. «1» - использует асинхронный отложенный механизм по выставлению заблокированного состояния модулю Телефон. «0» - заблокированное состояние выставляется сразу (может потребоваться при работе на медленных машинах, где асинхронность сказывается отрицательно с приведением телефона в недееспособное состояние. Рекомендуется изменять только при соответствующем запросе службы технической поддержки). По умолчанию «1».

Phone_ACMMode. Определяет порядок действий при нажатии на кнопку «Позвонить» в модуле Телефон. «0» - стандартная последовательность действий: сначала производится вызов абонента, потом обратный вызов пользователя. «1» - обратная последовательность: сначала производится вызов самого пользователя, потом абонента. См. раздел Телефон. Звонки.

ACM_directcallfrommodules. Режим использования сервиса автодозвона в разделах клиентского приложения для доступных команд контекстного меню (Например: Позвонить). По умолчанию 1

ACM_callsequence. Используется при установке ключа ACM_directcallfrommodules=0. Режим автодозвона в разделах клиентского приложения где доступно контекстное меню "Позвонить". «0» - сначала абонент, затем обратный вызов пользователя. «1» - сначала обратный вызов пользователя, затем набор номера. По умолчанию 0

ACM_switchsequence. Используется при установке ключа ACM_directcallfrommodules=0. Режим автодозвона в разделах клиентского приложения где доступно контекстное меню "Переключить". «0» - сначала абонент, затем обратный вызов пользователя. «1» - сначала обратный вызов пользователя, затем набор номера. По умолчанию 1

PhoneAllowHotline. 1 - разрешить HOTLINE вызовы из локального устройства на SIP-сервер (при звонке на пустой номер), 0 - запретить. По умолчанию 1.

HeadsetNonACMMode. Режим вызова с гарнитуры без использования автодозвона. «0» - сначала обратный вызов пользователя, потом набор абонента. «1» - поднятие трубки, таймаут, набор номера. По умолчанию «1».

UseAutoReconnectOnFly. При установке значения «1» в случае потери связи по каналу TCP между клиентом и сервером клиентское приложение будет пытаться переподключиться без перезагрузки. Неактуально при использовании протокола Remoting (по умолчанию порт 4050).

ShowHelpInside. Определяет, где отображать справку по системе. «0» - в отдельных процессах браузера по умолчанию «1» - во встроенном браузере в окне клиентского приложения. По умолчанию «0».

PlugRegLoadType. Устанавливает режим загрузки при настройке plugin-программ. «1» - стандартный режим в отдельном домене с последующей выгрузкой. «2» - загрузка plugin-программ в отдельный процесс для настройки. Для загрузки plugin-библиотек используется запускающий модуль oktell.PluginStarter.exe, который может быть скопирован под другим названием. Используемая версия .NET Framework для работы плагина в отдельном процессе определяется в конфигурационном файле этого процесса (по умолчанию oktell.PluginStarter.exe.config). Сам же запускающий модуль (название файла в каталоге клиентского приложения) определяется в конфигурационном файле oktell (клиентском и возможно серверном) с ключом, зависящим от названия основной библиотеки plugin-программы. Например <add key="PluginTcp_libnamewithoutextension" value="oktell.PluginStarter2.exe"/>. Существующий модуль oktell.PluginStarter.exe может скопирован под другим именем и снабжен таким образом индивидуальным конфигурационным файлом. Это может понадобиться в частности для применения разных версий .NET Framework к разным plugin-программам.

AutoSortGroups. Устанавливает режим сортировки отделов для модуля Сотрудники по названиям. По умолчанию «1». В случае отключения ожидается, что сортировкой занимается хранимая процедура, результаты ее исполнения выводятся последовательно.

PersonalHandleDepartments. При установке значения «1» обновление состояний внутренних номеров в разделе «Сотрудники. Отделы» производится только для номеров, входящих в выделенный отдел. Имеет смысл применять для сокращения трафика.

SplitDepartmentsTreeByDot. «1» - осуществлять построение глубокого дерева вложенных отделов в модуле «Сотрудники», разбивая указанные для сотрудников отделы на категории по символу «.». «0» - одноуровневое дерево отделов. По умолчанию «0».

ExportCsvDelimiter. Устанавливает символ-разделитель столбцов при формировании файлов экспорта CSV во всех модулях клиентского приложения. Список возможных значений: comma, space, semicolon, tab.

ExportTextDelimiter. Устанавливает символ-разделитель столбцов при формировании текстовых файлов с отчетами во всех модулях клиентского приложения. Список возможных значений: comma, space, semicolon, tab.

CCJournalTopCount. Для версий ниже 2.11.2.141120. Устанавливает ограничение на количество выводимых строк в статистике Call-центра.

HandleSessionToChangeUserState. «1» - при блокировании сессии авторизованного пользователя windows производится автоматический перевод состояния авторизованного пользователя oktell в «Нет на месте». При возврате в сессию производится автоматический перевод в «На месте». При этом перевод не осуществляется, если в момент блокировки пользователь не был свободен (находился в разговоре, в резерве или в состоянии перерыва), при этом не производится и обратного перевода при входе в сессию. «0» - действие по автоматической смене состояний не применяется. По умолчанию «1».

RecordDownloadNameAddInfo. «1» - устанавливает режим выгрузки записей разговоров статистики с включением в имена файлов имен участвующих абонентов.

Memory_UseSameDialogForms. «1» - активирует режим использования одних и тех же окон в режиме операторских диалоговых форм без уничтожения и создания при каждом показе. Используется на компьютерах с минимальным объемом оперативной памяти во избежание скачкообразного роста используемой памяти. «0» - деактивирует режим. По умолчанию «0».

Debug_PingErrorRestart. «0» - отключает автоматическую перезагрузку клиентского приложения при отсутствии откликов сервера на команды Ping. Используется для отладочных режимов, в основном при отладке plugin-программ. «1» - обычный режим. По умолчанию «1».

PingTimeoutNotify. Устанавливает период в миллисекундах, при превышении которого в момент вызова метода Ping возникает уведомление о плохой связи с сервером.

Debug_PingPause. Устанавливает паузу между опросами от клиентского приложения к серверу.

Debug_PingOutTimes. Устанавливает количество неудачных опросов, после которого закрывать клиентское приложение.

ActivationServer. Ссылка на сайт активаций для режима автоматической активации тестовой версии. По умолчанию «http://activate.telsystems.ru».


ShowLoadingBar. Отображает полосу загрузки при открытии модулей клиентского приложения. В некоторых случаях, улучшает работу отрисовки приложения. «0» - не отображает, «1» - отображает. По умолчанию «1».

helplinks. Тип используемой справки: «0» - встроенная справка в файле manual.chm, «1» - ссылка на вики. По умолчанию «1».

BrowserType. Используемый браузер в приложении: «1»- IE7, «2»- IE7, «3»- Chrome18. По умолчанию «3»

FaxPreperformProcess. Режим работы факса при отправке с клиентского приложения: «0» - обычный режим отправки изображений с преобразованием на сервере к необходимому виду. «1» - использование локального XPS-принтера для изготовления общего многостраничного файла TIFF из нескольких выбранных документов (для этого режима необходимы .NET Framework 3.0, установленный Microsoft Office версии 2003 или старше, установленный XPS принтер). По умолчанию «0».

AutoUserStateChangeOnSystemLock. 1 - активирует режим автоматического перевода состояния пользователя в Отключен или Перерыв (в зависимости от присутствия пользователя в режиме Call-центра) при блокировке ОС и автоматический перевод обратно при входе в систему снова. 0 - не использует режим. По умолчанию 1.

PhoneDirectDigit. Определяет поведение софт-телефона. 1 - в активном состоянии набор символов осуществляется по одному, ввод в текстовое поле невозможен, кнопка «Набрать» недоступна. 0 - набор осуществляется в текстовое поле, после чего кнопкой «Набрать» отправляется на сервер. По умолчанию 0. Это касается состояний набора номера, коммутаций с абонентами, коммутаций с IVR, ожидания ответа, ожидания факс-сеанса.

PhoneIvrDirectDigit. Определяет поведение софт-телефона в состоянии коммутации с IVR при отключенном режиме прямого набора символов. 1 - позволяет активировать прямой набор только для случая коммутации с IVR. 0 - оставляет доступным только набор в текстовое поле с последующей отправкой по нажатию на «Набрать», при этом сценарий завершается и осуществляется набор номера по-новой. По умолчанию 0.

PhoneLineDirectDigit. Определяет поведение софт-телефона в состоянии коммутации с абонентом при отключенном режиме прямого набора символов. 1 - позволяет активировать прямой набор только для случая коммутации с абонентом. 0 - оставляет доступным только набор в текстовое поле с последующей отправкой по нажатию на «Набрать», при этом осуществляется переключение. По умолчанию 1.


Раздел LOG.

Хранит настройки лог-сервера комплекса. Среди неописываемых настроек - пути к папкам для сбора журналов.

LOG_storedays. Длительность хранения лог-журналов в днях. По умолчанию «7». По истечении указанного периода журналы удаляются системой. В некоторых случаях объем журналов может достигать нескольких гигабайтов за день.

LOG_maxfilesize. Максимальный размер одного файла лог-журнала в байтах. Имеет воздействие на все лог-журналы, исключая HAL (Hardware). По умолчанию 3 ГБ.

LOG_root. Абсолютный или относительный путь к папке с лог-журналами. По умолчанию «Log», то есть относительный путь в каталоге клиентского приложения.