|
Файл User.config поддерживается, начиная с версии WebMap.NET 2017.3.10. До этой версии все настройки – системные и пользовательские хранились в файле Web.config. В файл User.config перенесены все настройки раздела \appSettings из файла Web.config.
|
ОБЩИЕ СВЕДЕНИЯ
Хранение пользовательских настроек в отдельном файле позволяет сохранить их при обновлении программы. Для этого достаточно перед выполнением обновления переместить файл User.config во временную папку, а после обновления вернуть в папку приложения WebMap.NET.
Если настройка отсутствует в файле User.config (не добавлена или закомментирована), то в программе будет применено значение по умолчанию. Такое может иметь место, например, если в новой версии программы были добавлены новые параметры в файл User.config, но пользователь использует старую версию файла с установленными настройками. Новая настройка может быть добавлена в файл User.config в любом текстовом редакторе.
СОДЕРЖИМОЕ ФАЙЛА
Файл User.config расположен в папке \webmap – папка приложения WebMap.NET. Файл может быть открыт, изменен и сохранен в любом текстовом редакторе.
|
Изменяя настройки в файле User.config, убедитесь, что настройка не закомментирована. Такие настройки не обрабатываются. Комментарии ограничиваются символами "<!--" и "-->", например: <!-- <add key="links-upper" value="Сайт производителя=http://tk-nav.ru"/> --> |
Ниже рассмотрены основные разделы настроек, заданные в файле User.config. Каждая настройка имеет определенный тег. Формат файл - XML.
<appSettings> <add key="AGConnectionString" value="User ID=SA;Password=хххххх;Integrated Security=False;Persist Security Info=True;Data Source=(LOCAL)\SQLEXPRESS;Initial Catalog=AG;" /> <add key="default-locale" value="ru-RU" /> <add key="multicast-endpoint" value="224.0.0.100:2222" />
<add key="license-file" value="~/App_Data/license.xml" />
<add key="links-upper" value="|Условия предоставления сервиса=http://ya.ru;Сайт разработчика=http://tk-nav.ru"/> <add key="logo-upper" value="~/App_Data/TK.png"/> <add key="logo-upper-link" value="http://tk-nav.ru"/>
<add key="cache-org-max-time" value="15" />
<add key="driver-to-string" value="1" /> <add key="timespan-to-string" value="0" />
<add key="redis-host" value="localhost:6379"/>
<add key="proxy-host" value="http://nas:5190"/> <add key="proxy-login" value=""/> <add key="proxy-pass" value=""/>
</appSettings> |
Описание тегов (add key=):
AGConnectionString – параметры подключения к базе данных: имя пользователя, пароль, имя базы данных и т.д. Именно эти настройки используются для создания и обновления базы данных в разделе \Install, на вкладке "Конфигурация БД".
default-locale – начальный язык интерфейса, используемый при входе пользователя в программу в первый раз. При первом входе информация об использованном языке интерфейса (текущий заданный или тот, на который переключился пользователь после входа) сохраняется в файл cookie и далее этот язык автоматически устанавливается при следующих сессиях. Начальный язык интерфейса необходимо задавать в формате XML. Всего программа поддерживает 4 языка: Русский, Английский, Немецкий и Китайский.
multicast-endpoint – адрес для групповой рассылки уведомлений об изменении данных при использовании нескольких web-серверов. Данная настройка необходима для правильной синхронизации файлов в системе с разделением web-сервера на несколько разных с целью уменьшения нагрузки. При такой схеме одинаковые адреса "multicast-endpoint" должны быть заданы на всех web-серверах.
license-file – путь к файлу лицензии. Путь может быть задан как абсолютный, так и относительный (относительно папки приложения WebMap.NET). По умолчанию файл лицензии хранится в папке \App_Data. Для того чтобы использовать файл лицензии из другой папки необходимо в строке с тегом "license-file" указать полный путь к этому файлу. Подробнее о получении и установке лицензии см. в разделе "Установка лицензии".
links-upper – дополнительные ссылки на стартовой странице программы. Ссылка и заголовок должны быть заданы в формате "Заголовок=ссылка". Несколько ссылок должны быть разделены точкой с запятой (;): "Заголовок1=ссылка1;Заголовок2=ссылка2". Пример ссылок на основе настроек, заданных в файле User.config выше, приведен на Рис.1.
Рис.1. Верхние ссылки.
logo-upper – URL графического файла с дополнительным логотип, который будет отображаться рядом с логотипом ТехноКом на стартовой странице программы. Не допускаются ссылки на локальные каталоги с изображением. Поддерживаются все графические форматы файлов. Размер прикрепляемого изображения не должен превышать 400х53 пикселей.
logo-upper-llinks – ссылка, которая будет открываться при нажатии на дополнительный логотип "logo-upper", например, таким образом может быть настроен переход на сайт дилера при нажатии на логотип компании. Данный параметр может быть пустым, в этом случае логотип будет без ссылки.
cache-org-max-time – максимальное время хранения организации в кэше, в минутах. Если организация не используется дольше заданного времени, то эта организация выгружается из кэша. Значение по умолчанию – 10 минут. Если настройка не задана в файле User.config, то программа использует значение по умолчанию.
Приведенные ниже настройки используются сторонними сервисами, запрашивающих данные с программы WebMap.NET: ServiceJSON/WCF и 1C:ASMX.
driver-to-string – информация о водителях, передаваемая web-сервером внешнему сервису: 0 – передается глобальный уникальный идентификатор водителя (GUID); 1 – передается строка номер карточки.
time-to-string – формат, в котором web-сервер передает время внешнему сервису: 0 – время (длительность) будут передаваться в формате ISO 8601 (например, PT5H35M, если длительность 05 часов, 35 минут); 1 – время передается в формате HH:MM, например, 05:35, если длительность 05 часов 35 минут).
redis-host – адрес и порт для подключения к серверу Redis для кэширования данных. Такой способ хранения кэша актуален, когда используется несколько серверов. В этом случае будет одно общее хранилище кэша. Сервис Redis используется только для хранения тайлов интернет-карт, трека и онлайн данных ТС.
Приведенные ниже настройки относятся к прокси-серверу, используемому на web-сервере для доступа к сети Интернет. Данный блок настроек необходим для возможности кэширования интернет карт при использовании прокси-сервера.
proxy-host – это полный адрес прокси-сервера и номер порта для подключения в формате адрес:порт;
proxy-login – это имя пользователя прокси-сервера;
proxy-pass – это пароль для подключения к прокси-серверу.