Статья №95
Клиентское место - параметры файла конфигурации
Параметры файла конфигурации клиентского приложения.
Language. Определяет языковую схему, используемую клиентским приложением до момента
подключения к соответствующему серверу. После подключения производится принудительная
синхронизация языковой схемы. Фактически это происходит в момент отображения окна
авторизации. Подробнее в описании ключа в разделе серверного приложения.
ServerSelectMode. Определяет, каким образом происходит выбор сервера в случае, если
указано несколько адресов (нижеперечисленные ключи конфигурации). «0» - в окне
авторизации отображается список серверов в соответствии с перечислением в
конфигурационном файле. При автоматическом переподключении всегда берется последний
активный сервер. «1» - осуществляется автоматический перебор серверов начиная с самого
первого. Подключение производится к тому, который дал положительный ответ. При
автоматическом подключении без окна авторизации в учет берется не только подключение, но
и ответ авторизации. Таким образом будет активирован сервер, успешно подключенный и
разрешивший вход. В этом случае в окне авторизации список серверов для выбора не
отображается. «2» - перебор серверов осуществляется автоматически, начиная с последнего
активированного. По умолчанию - 0.
NetConnectionName. Название подключения (сервера) для отображения в окне авторизации
(при указании нескольких возможных подключений).
LogicServerAddress. Адрес для подключения к серверу логики.
LogicServerPort. Порт для подключения к серверу логики.
NETCLIENT_SERVER_ADDRESS. Адрес для подключения к серверу аппаратуры.
NETCLIENT_SERVER_PORT. Порт для подключения к серверу аппаратуры.
NETCLIENT_LOCAL_ADDRESS. Сетевой интерфейс, через который осуществляется подключение к
серверу аппаратуры. Требуется указание, если клиентский компьютер находится в разных
подсетях с более чем одним сетевым интерфейсом. По умолчанию параметр закомментирован.
NETCLIENT_LOCAL_PORT. Локальный порт для обмена сигнальным трафиком по UDP.
NETCLIENT_VOICE_PORT. Локальный порт для обмена голосовым трафиком по UDP.
ВНИМАНИЕ! Вышеперечисленные параметры определяют различные адреса и порты для
организации сетевого канала подключения к серверу. Эти параметры могут присутствовать в
конфигурационном файле несколько раз с добавлением к концу строки-ключа разных
целочисленных индексов. Например NetConnectionName_1 и NetConnectionName_2. Индекс 0 не
указывается, вместо него используется значение без индекса. В случае указания в
конфигурационном файле нескольких подключений в окне авторизации будет отображен список
их имен и доступен выбор одного из них. Это удобно использовать при работе с несколькими
серверами с одних и тех же клиентских рабочих станций.
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. Каждый
клиент должен иметь уникальное значение ключа, не совпадающее с реальными возможными
адресами и именами других компьютеров сети.
TerminalAddress. Строка, определяющая уникальный адрес клиентского места. Приписывается
ко всем адресам компьютера для определения клиентского места в карте офиса (например
«FUTURAMA/terminal1»). Именно эту строку необходимо будет указать в карте офиса для
идентификации. Решает проблему терминальных подключений, где все клиенты физически
запускаются с одного компьютера. По умолчанию «».
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. Уровень трассировки аппаратного модуля. Битовая маска xxxx. C конца: 0 -
TraceCall, 1-TraceEvents, 2-TraceVoice, 3-TraceNet. По умолчанию «1». Для полной
трассировки значение «15».
SEPARATE_PROCESS. «1» - запускать отдельный процесс для работы с устройствами. «0» -
работать с устройствами в собственном процессе. По умолчанию «1».
JITTER_DEPTH. Значение глубины джиттер-буфера на клиенте. Минимальное значение - «4», по
умолчанию - «4». При увеличении значения происходит рост задержки в голосовом обмене по
направлению звука в клиентское устройство, эффективнее исключая влияние проблем сети.
WAVE_COUNT. Значение глубины буфера обмена звука. Минимальное значение - «2», по
умолчанию - «2». При увеличении значения происходит рост задержки в голосовом обмене по
направлению звука в клиентское устройство, эффективнее исключая влияние проблем
звукового устройства.
OVER_SERVER. «1» - обмен трафиком через сервер. «0» - обмен трафиком по возможности
напрямую. По умолчанию «0».
WRITE_VOICE. Отладочный параметр для оценки звукового потока на входе в клиентский HAL
из сети до воспроизведения непосредственно в устройстве. «1» - отладочная запись в файл
включена, файл с именем, соответствующим текущему времени размещается в корне
клиентского приложения . «0» - отладочная запись отключена. По умолчанию «0».
WAVEIN_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 разрядных
ОС.
WatcherResourceLogType. Формат логирования ресурсов. С помощью параметра можно настроить
вывод в клиентский лог-журнал WATCHER информации по использованию процессом ресурсов
системы. Объем используемой памяти, количество открытых дескрипторов, количество
потоков, пользовательские системные ресурсы, ориентировочное среднее процессорное время
по всему процессу и отдельно по всем его потокам. 0 - не логировать, 1 - информация о
процессе каждую секунду, 2 - информация о процессе и активным потокам каждую секунду, 3
- информация о процессе и всем его потокам каждую секунду, 4 - информация о процессе
каждую минуту. По умолчанию 4.
RestoreLastModules. «1» - осуществляет при загрузке приложения загрузку и восстановление
модулей, активных перед закрытием программы. «0» - запускает приложение с пустым фоном
без дополнительной загрузки модулей; это экономит время на загрузке, так как некоторые
модули требуют достаточно длительного времени для полной загрузки, однако пользователь
при необходимости сам может активировать модуль по стандартной схеме из главного меню.
По умолчанию «1».
ShowVideoNoise. «1» - в видео-окне модуля ТЕЛЕФОН при отсутствии видео-сигнала
отображается черно-белый шум, «0» - черное окно. По умолчанию «1».
Phone_UseBlockedDelay. «1» - использует асинхронный отложенный механизм по выставлению
заблокированного состояния модулю «Телефон». «0» - заблокированное состояние
выставляется сразу (может потребоваться при работе на медленных машинах, где
асинхронность сказывается отрицательно с приведением телефона в недееспособное
состояние. Рекомендуется изменять только при соответствующем запросе службы технической
поддержки). По умолчанию «1».
Memory_UseSameDialogForms. «1» - активирует режим использования одних и тех же окон в
режиме операторских диалоговых форм без уничтожения и создания при каждом показе.
Используется на компьютерах с минимальным объемом оперативной памяти во избежание
скачкообразного роста используемой памяти. «0» - деактивирует режим. По умолчанию «0».
Debug_PingErrorRestart. «0» - отключает автоматическую перезагрузку клиентского
приложения при отсутствии откликов сервера на команды Ping. Используется для отладочных
режимов, в основном при отладке plugin-программ. «1» - обычный режим. По умолчанию «1».
PingTimeoutNotify. Устанавливает период в миллисекундах, при превышении которого в
момент вызова метода Ping возникает уведомление о плохой связи с сервером.
ActivationServer. Ссылка на сайт активаций для режима автоматической активации тестовой
версии. По умолчанию «http://activate.telsystems.ru».
Раздел LOG.
Хранит настройки лог-сервера комплекса. Среди неописываемых настроек - пути к папкам для
сбора журналов.
LOG_storedays. Длительность хранения лог-журналов в днях. По умолчанию «7». По истечении
указанного периода журналы удаляются системой. В некоторых случаях объем журналов может
достигать нескольких гигабайтов за день.
LOG_maxfilesize. Максимальный размер одного файла лог-журнала в байтах. Имеет
воздействие на все лог-журналы, исключая HAL (Hardware). По умолчанию 3 ГБ.
LOG_root. Абсолютный или относительный путь к папке с лог-журналами. По умолчанию «Log»,
то есть относительный путь в каталоге клиентского приложения.
Параметры файла конфигурации клиентского приложения