Руководство администратора по установке портала Итилиум
Портал Итилиум позволяет предоставить потребителям услуг доступ к системе Итилиум для управления услугами через веб-браузер.
Возможности портала
Потребителям услуг будут доступны следующие возможности.
Просмотр списка своих обращений.
Регистрация нового обращения.
Просмотр детальной информации по обращению.
Прикрепление файлов к обращениям.
Общение по обращению (переписка).
Согласование и подтверждение обращений.
Заполнение дополнительных полей обращения при регистрации.
Просмотр базы знаний (FAQ).
Компоненты для установки
1. Развернутая система Итилиум
Требования к системе Итилиум;
версия не ниже 4.5.3.6;
информационная база в серверном варианте (для проверки и тестирования допускается и файловый вариант);
кластер серверов может быть как на Windows, так и на Linux.
2. Веб-сервер
Веб-сервер должен удовлетворять требованиям платформы «1С Предприятие 8»:
https://v8.1c.ru/tekhnologii/sistemnye-trebovaniya-1s-predpriyatiya-8/
3. Развернутая система управления порталом (1С-Битрикс)
Для системы управления порталом потребуется один из следующих продуктов:
«1С-Битрикс: Управление сайтом» версии 23.0 или выше;
«1С-Битрикс24» — только версия для установки на собственный сервер (облачная версия «1С-Битрикс24» не поддерживается).
Требования:
продукт должен быть развернут на веб-сервере Apache версии 2.0 и выше;
продукт должен быть установлен в кодировке UTF-8;
для работы функции изменения забытых паролей требуется наличие модуля, позволяющего отправлять электронные письма.
Программный продукт «Веб-портал Итилиум» является модулем, который устанавливается только при наличии одновременно активной (за исключением ограниченной) лицензии на программу для ЭВМ «1С-Битрикс: Управление сайтом» или на программу для ЭВМ «1С-Битрикс24» (коробочная версия) и стандартной лицензии на модуль.
Требования к серверному программному обеспечению определяются требованиями программ «1С-Битрикс: Управление сайтом» или «1C-Битрикс24» (коробочная версия Битрикс24).
Для выбора технических решений вам будут полезны следующие материалы.
Протестировать хостинг на предмет соответствия техническим требованиям продукта можно специальным скриптом: bitrix_server_test.php (ссылка). Для проверки необходимо загрузить его на хостинг, затем открыть в браузере и нажать на кнопку «Начать тестирование».
Рекомендуется использовать виртуальную машину, веб-окружение от «1С-Битрикс» (ссылка). Виртуальная машина и веб-окружение максимально оптимизированы для работы с «1С-Битрикс: Управление сайтом», «1С-Битрикс24». Только при работе с этими инструментами разработчики «1С-Битрикс» гарантируют стабильную работу вашего портала.
Важно!
Техническая поддержка веб-портала Итилиум оказывается только при условии установки веб-портала Итилиум в среде виртуальной машины и/или веб-окружения от «1С-Битрикс».
4. Дистрибутив портала Итилиум
По вопросам, связанным с получением дистрибутива портала Итилиум, обращайтесь к нам по телефону +7(499)271-30-77 или по электронной почте: info@itilium.ru.
Установка
Установка портала состоит из четырех шагов.
Шаг 1. Публикация сервиса системы Итилиум на веб-сервере.
Шаг 2. Подключение модуля портала Итилиум к системе 1С-Битрикс.
Шаг 3. Подключение установленного на шаге 2 модуля портала к опубликованному на шаге 1 сервису.
Шаг 4. Настройка потребителей услуг в системе Итилиум.
Кроме инструкций по установке портала, в данном руководстве приведены инструкции по следующим задачам.
Размещение собственного логотипа в заголовке портала Итилиум.
Удаление модуля портала Итилиум.
Шаг 1. Публикация сервиса системы Итилиум на веб-сервере
Что нужно сделать
Опубликовать http-сервис системы Итилиум под названием WEBPortal на веб-сервере, к которому имеет доступ система 1С-Битрикс.
Запомнить (или записать) адрес публикации, чтобы в дальнейшем использовать его при настройке модуля в 1С-Битрикс.
Как это сделать
1. Открыть информационную базу системы Итилиум в режиме конфигуратора с правами администратора с того компьютера, где установлен веб-сервер.
2. Перейти в меню «Администрирование > Публикация на веб-сервере».
3. На вкладке «Основные» задать имя публикации (цифра 1 на рисунке), на вложенной вкладке «HTTP сервисы» установить отметку у сервиса «WEBPortal» (цифра 2 на рисунке) и нажать кнопку «Опубликовать». Для публикации на веб-сервере должна быть установлена только анонимная авторизация.
Внимание!
Подробнее о публикации http-сервисов можно прочитать в «Руководстве администратора по платформе «1С:Предприятие» в главах «Настройка поддержки HTTP-сервисов» и «Настройка веб-серверов для работы с «1С:Предприятием».
4. Адрес публикации сервиса формируется по следующему шаблону: https://<АдресСервера>/<ИмяПубликации>/hs/mobiledata, где
АдресСервера — адрес веб-сервера (IIS или Apache), на котором опубликован http-сервис Итилиум WEBPortal;
ИмяПубликации — имя, заданное при публикации сервиса в пункте 3 этого шага.
Пример
АдресСервера: example.com
ИмяПубликации: itilium
Адрес публикации будет:
https://example.com/itilium/hs/mobiledata/
Как убедиться в том, что публикация выполнена правильно
Нужно открыть в браузере ссылку, сформированную по шаблону: <АдресПубликации>/authenticate, где
АдресПубликации — ссылка на опубликованный http-сервис, сформированная по правилам из пункта 4 этого шага.
Пример
АдресПубликации:
https://example.com/itilium/hs/mobiledata/
Ссылка для проверки:
https://example.com/itilium/hs/mobiledata/authenticate
Если открывается пустое окно и выдается запрос аутентификации, то публикация выполнена правильно.
Если выдается какая-либо ошибка, то следует ее устранить, ориентируясь на сообщение об ошибке, и повторить публикацию, начиная с шага 1.
Шаг 2. Подключение модуля портала Итилиум к системе 1С-Битрикс
Что нужно сделать
Разместить архив с порталом в структуре сайта 1С-Битрикс.
Установить модуль портала Итилиум в панели администратора системы 1С-Битрикс.
Задать адрес стартовой страницы портала Итилиум.
Как это сделать
1. Открыть панель администратора системы 1С-Битрикс.
2. Перейти в меню «Контент > Структура сайта > Файлы и папки».
3. В открывшейся форме нажать кнопку «Загрузить файл».
4. В открывшейся форме нажать первую из кнопок с названием «Добавить файл» и выбрать файл itilium-portal-x.x.zip (где x.x — версия портала) из дистрибутива портала Итилиум для загрузки (на рисунке это itilium-portal-1.0.zip). После выбора файла нажать «Сохранить».
5. В списке файлов и папок найти загруженный файл и выполнить действия:
нажать на значок, отмеченный цифрой 1 на рисунке;
выбрать раздел «Распаковать»;
установить переключатель «При совпадении имен файлов и папок» в положение «Заменить файлы»;
нажать кнопку «Распаковать».
6. Перейти в меню «Marketplace > Установленные решения» (цифры 1, 2 на рисунке) и нажать на кнопку «Действия > Установить» (цифра 3 на рисунке).
7. В открывшейся форме выбрать желаемый адрес стартовой страницы модуля Итилиум.
Возможны следующие варианты:
поместить стартовую страницу модуля на главной странице системы 1С-Битрикс;
поместить стартовую страницу по адресу <Адрес системы 1С-Битрикс>/itilium/, где Адрес системы 1С-Битрикс — URL-адрес системы 1С-Битрикс.
Пример
Адрес системы 1С-Битрикс:
https://mysite.com/
Возможные адреса стартовой страницы портала Итилиум:
• на главной странице — https://mysite.com/
• на отдельной странице /itilium — https://mysite.com/itilium/
За выбор страницы отвечает флаг «Создать редирект на главной странице» на открывшейся форме:
чтобы поместить стартовую страницу модуля портала Итилиум на главной странице системы 1С-Битрикс, нужно установить флаг «Создать редирект на главной странице»;
чтобы поместить стартовую страницу модуля портала Итилиум на отдельной странице /itilium, нужно снять флаг «Создать редирект на главной странице».
Чтобы завершить выбор адреса стартовой страницы, нужно нажать кнопку «Установить».
Шаг 3. Подключение установленного на шаге 2 модуля портала к опубликованному на шаге 1 сервису
Что нужно сделать
Задать в настройках модуля портала Итилиум адрес опубликованного сервиса системы Итилиум.
Настроить ограничения на размер загружаемых файлов.
Как это сделать
1. Открыть панель администратора системы 1С-Битрикс.
2. Перейти в меню «Настройки > Настройки продукта > Настройки модулей > Веб-портал Итилиум» (цифры 1, 2, 3, 4 на рисунке).
3. Задать адрес публикации http-сервиса, полученный на шаге 1 в пункте 4 данной инструкции (цифра 5 на рисунке).
4. Задать ограничения на размеры загружаемых файлов, если ожидаются файлы, не подходящие под ограничения по умолчанию.
5. Нажать кнопку «Сохранить».
Шаг 4. Настройка потребителей услуг в системе Итилиум
Что нужно сделать
Включить всем потребителям услуг, которые могут пользоваться порталом Итилиум, возможность аутентификации средствами «1С:Предприятия» для их «Пользователей ИБ» (ИБ — информационная база) и задать им пароли.
Как это сделать
1. Открыть информационную базу системы Итилиум в режиме предприятия.
2. Перейти в меню «Администрирование > Пользователи > Пользователи (потребители услуг)».
3. Выбрать в списке конкретного потребителя услуг и открыть форму его редактирования двойным щелчком (левой кнопки) мыши или выбрав в контекстном меню пункт «Изменить».
4. На форме потребителя услуг перейти в раздел «Пользователь ИБ» (цифра 1 на рисунке).
5. Установить флаг «Аутентификация 1С:Предприятия» и задать пароль (цифра 2 на рисунке).
6. Установить роль «Потребитель услуг», если она не установлена (цифра 3 на рисунке).
7. Записать изменения (кнопка «Записать и закрыть», чтобы после записи форма закрылась, или «Записать», если нужно чтобы форма осталась открытой).
Размещение собственного логотипа в заголовке портала Итилиум
В этом разделе приведена инструкция по размещению собственного логотипа (например, логотипа компании) в заголовке портала Итилиум.
Что нужно сделать
Загрузить логотип в систему 1С-Битрикс.
Указать путь к логотипу в настройках модуля портала Итилиум.
В качестве логотипа могут быть использованы файлы изображений в форматах .jpeg и .png. Рекомендованный размер — 120х70 px, файлы других размеров будут преобразованы и адаптированы к этому размеру с сохранением пропорций (соотношения сторон).
Как это сделать
1. Открыть панель администратора системы 1С-Битрикс.
2. Перейти в меню «Контент Файлы и папки» (цифры 1, 2 на рисунке).
3. Нажать кнопку «Загрузить файл» (цифра 3 на рисунке).
4. В открывшейся форме выбрать файл для загрузки (цифра 4 на рисунке).
5. Нажать кнопку «Сохранить» (цифра 5 на рисунке).
6. Перейти в меню «Настройки Настройки продукта > Настройки модулей > Веб-портал Итилиум» (цифры 1, 2, 3, 4 на рисунке).
7. Указать путь к загруженному в пункте 5 этого раздела файлу логотипа (цифра 5 на рисунке).
8. Нажать кнопку «Сохранить» (цифра 6 на рисунке).
Удаление модуля портала Итилиум
В этом разделе приведены инструкции по удалению модуля портала Итилиум в системе 1С-Битрикс.
Что нужно сделать
Удалить модуль портала Итилиум в панели администратора системы 1С-Битрикс.
Как это сделать
1. Открыть панель администратора системы 1С-Битрикс.
2. Перейти в меню «Marketplace > Установленные решения» и нажать на кнопку «Действия > Удалить».