Руководство администратора по установке портала Итилиум

Возможности портала

Потребителям услуг будут доступны следующие возможности.

• Просмотр списка своих обращений.
• Регистрация нового обращения.
• Просмотр детальной информации по обращению.
• Прикрепление файлов к обращениям.
• Общение по обращению (переписка).
• Согласование и подтверждение обращений.
• Заполнение дополнительных полей обращения при регистрации.
• Просмотр базы знаний (FAQ).

Компоненты для установки

1. Развернутая система Итилиум

Требования к системе Итилиум;

• версия не ниже 4.5.3.6;
• информационная база в серверном варианте (для проверки и тестирования допускается и файловый вариант);
• кластер серверов может быть как на Windows, так и на Linux.

2. Веб-сервер

Веб-сервер должен удовлетворять требованиям платформы «1С Предприятие 8»:
https://v8.1c.ru/tekhnologii/sistemnye-trebovaniya-1s-predpriyatiya-8/

3. Развернутая система управления порталом (1С-Битрикс)

Для системы управления порталом потребуется один из следующих продуктов:

• «1С-Битрикс: Управление сайтом» версии 18.0 или выше;
• «1С-Битрикс24» — только версия для установки на собственный сервер (облачная версия «1С-Битрикс24» не поддерживается).

Требования:

• продукт должен быть развернут на веб-сервере Apache версии 1.3 и выше;
• продукт должен быть установлен в кодировке UTF-8;
• для работы функции изменения забытых паролей требуется наличие модуля, позволяющего отправлять электронные письма.

Программный продукт «Веб-портал Итилиум» является модулем, который устанавливается только при наличии одновременно активной (за исключением ограниченной) лицензии на программу для ЭВМ «1С-Битрикс: Управление сайтом» или на программу для ЭВМ «1С-Битрикс24» (коробочная версия) и стандартной лицензии на модуль.

Требования к серверному программному обеспечению определяются требованиями программ «1С-Битрикс: Управление сайтом» или «1C-Битрикс24» (коробочная версия Битрикс24).

Для корректной работы продукта «Веб-портал Итилиум» дополнительно требуется наличие следующих расширений PHP: 

• cURL — библиотека функций, которая позволяет взаимодействовать с серверами по различным сетевым протоколам.

Для выбора технических решений вам будут полезны следующие материалы.

• Рекомендации по выбору и тестированию хостинга для «1С-Битрикс: Управление сайтом» от разработчиков «1С-Битрикс»
• Технические требования для «1C-Битрикс24» (коробочной версии) от разработчиков «1С-Битрикс»

Протестировать хостинг на предмет соответствия техническим требованиям продукта можно специальным скриптом: bitrix_server_test.php (ссылка). Для проверки необходимо загрузить его на хостинг, затем открыть в браузере и нажать на кнопку «Начать тестирование».

Рекомендуется использовать виртуальную машину, веб-окружение от «1С-Битрикс» (ссылка). Виртуальная машина и веб-окружение максимально оптимизированы для работы с «1С-Битрикс: Управление сайтом», «1С-Битрикс24». Только при работе с этими инструментами разработчики «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 на рисунке) и нажать кнопку «Опубликовать». Для публикации на веб-сервере должна быть установлена только анонимная авторизация.

4. Адрес публикации сервиса формируется по следующему шаблону: https://<АдресСервера>/<ИмяПубликации>/hs/mobiledata, где

• АдресСервера — адрес веб-сервера (IIS или Apache), на котором опубликован http-сервис Итилиум WEBPortal;
• ИмяПубликации — имя, заданное при публикации сервиса в пункте 3 этого шага.

Как убедиться в том, что публикация выполнена правильно

Нужно открыть в браузере ссылку, сформированную по шаблону: <АдресПубликации>/authenticate, где 

• АдресПубликации — ссылка на опубликованный http-сервис, сформированная по правилам из пункта 4 этого шага.

Если открывается пустое окно и выдается запрос аутентификации, то публикация выполнена правильно.

Если выдается какая-либо ошибка, то следует ее устранить, ориентируясь на сообщение об ошибке, и повторить публикацию, начиная с шага 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С-Битрикс, нужно установить флаг «Создать редирект на главной странице»;
• чтобы поместить стартовую страницу модуля портала Итилиум на отдельной странице /itilium, нужно снять флаг «Создать редирект на главной странице».

Чтобы завершить выбор адреса стартовой страницы, нужно нажать кнопку «Установить».

8. Завершить установку модуля портала Итилиум, нажав кнопку «Завершить установку».

Подробнее про администрирование системы 1С-Битрикс можно прочитать в документации: https://dev.1c-bitrix.ru/docs/.

Шаг 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 > Установленные решения» и нажать на кнопку «Действия > Удалить».

Подробнее про администрирование системы 1С-Битрикс можно прочитать в документации: https://dev.1c-bitrix.ru/docs/.

Приятного и полезного использования системы Итилиум и web-портала Итилиум!