Особенности настройки веб-клиента при использовании

Особенности настройки веб-клиента при использовании
конфигураций серии «1С:Электронное обучение»
Продукты серии «1С:Электронное обучение» поддерживают возможность создания и
просмотра в интерфейсе «1С:Предприятие» разнообразных электронных ресурсов.
Электронный ресурс может содержать файлы произвольных форматов (html, swf, java,
png, avi, doc и т.п.). Реализация доступа пользователей к файлам электронных ресурсов
различается при использовании тонкого и веб-клиента.
При использовании тонкого клиента необходимые файлы автоматически копируются
(кэшируются) на компьютер пользователя во временный каталог. Дополнительная
настройка конфигурации в этом случае не требуется.
При использовании веб-клиента требуется выполнить дополнительную настройку вебсервера и конфигурации, чтобы обеспечить возможность доступа пользователей к файлам
электронных ресурсов в интерфейсе 1С:Предприятие. Настройка выполняется в два этапа:
1. Создание на веб-сервере произвольного каталога (кэш файлов);
2. Указание в настройках конфигурации пути к этому каталогу и его веб-адреса
(URL).
Создание каталога для кэширования файлов на веб-сервере
На веб-сервере должен быть создан произвольный каталог, например «cache». При его
создании необходимо учесть следующие особенности:

Веб-адрес хоста каталога должен иметь тот же адрес хоста, что и адрес хоста
информационной базы. Например, если база доступна по адресу
«http://1c.ru/demoBase», то веб-адрес каталога может быть следующий:
«http://1c.ru/cache». Допускается указание адреса без хоста, например «/cache».

Имя каталога не должно начинаться с тех же символов, что и адрес каталога
информационной базы. Для рассмотренного выше примера не рекомендуется
создавать каталог «http://1c.ru/demoBaseCache».

Сервер должен быть настроен так, чтобы файлы из этого каталога могли
отображаться пользователям в браузере без дополнительной авторизации.

Следует учесть, что каталог кэша может содержать файлы, которые не должны
быть доступны некоторым категориям пользователей, поэтому рекомендуется
отключать возможность просмотра его содержимого из браузера.

Сервер «1С:Предприятие» должен иметь права на запись в каталог кэша.

Если рабочие процессы сервера размещены на различных компьютерах, то все
они должны иметь доступ к данному каталогу. Допускается указание сетевого
пути к каталогу.
Настройка конфигурации
После того, как каталог создан, необходимо указать конфигурации путь к этому каталогу
и его веб-адрес. Для этого необходимо открыть форму настройки информационной базы и
заполнить поля: «Путь к общему каталогу» и «Адрес общего каталога».
Пример заполнения показан на рисунке:
Допускается указание адреса каталога без указания хоста, например, для рассмотренного
примера можно указать просто «/cache». После записи настроек требуется перезапустить
программу.
Проверка корректности настройки
В некоторых случаях, может возникнуть ситуация, когда при запуске сервер не успеет
обновить список файлов и некоторые объекты, запускающие при запуске системы,
например, календарь не будут отображены. В этом случае достаточно перезапустить
программу.
Если после выполнения действий по настройке веб-клиента появляются ошибки при
просмотре электронных ресурсов, то для диагностики причин необходимо выполнить
следующие шаги:
1. Зайти в каталог и проверить, имеются ли в нем файлы. Если каталог пуст, то
причиной ошибки может быть:
a. В форме настроек информационной базы неверно указанный путь к
каталогу.
b. Сервер «1С:Предприятие» не имеет прав на запись файлов в каталог кэша.
2. Отобразить в браузере произвольный файл из каталога. Например, можно в
браузере указать путь к файлу изображения: «http:\\<адрес хоста>\<имя
каталога>\v8cache_<номер версии>\res_common\img\ok32.png». В браузере должна
отобразиться картинка. Если картинка не отобразилась, то возможны следующие
причины ошибки:
a. Файла не существует. Необходимо вернуться к п.1 и проверить
существование файла.
b. Сервер требует дополнительной авторизации для просмотра файла.
Необходимо настроить веб-сервер для публичного доступа к файлам кэша.
Очистка каталога кэша
При длительном использовании конфигурации размер каталога кэша может стать очень
большим. Каталог может быть полностью очищен без потери работоспособности
конфигурации. Рекомендуется выполнять очистку, например, при обновлении
конфигурации, когда в базе нет активных пользователей.
Следует учесть, что после очистки каталога может возрасти нагрузка на файловую
подсистему сервера, так как конфигурации потребуется заново выгружать необходимые
файлы на сервер при первом обращении к ним. Оптимальным является удаление
устаревших каталогов «v8cache_N», где N – номер версии каталога. Можно оставлять
каталог только с последним номером версии.