В результате портал Витрины услуг будет доступен по адресу ``http[s]://<host>:<port>/showcase``:
.. figure:: ../_static/showcase3.png
Install/upgrade configuration
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
...
...
@@ -29,6 +51,9 @@ Install/upgrade configuration
#. Добавить гостевого пользователя в группу "Клиенты Showcase" ``showcase_clients``.
#. Добавить операторов, обрабатывающих заявки на услуги, и контент-менеджеров, настраивающих описание услуг, в группу
"Операторы Showcase" ``showcase_operators``.
#. Добавить ``war`` приложения Showcase на сервер в папку ``/opt/synergy/jboss/standalone/deployments`` (см. алгоритм для **Clean**).
Авторизоваться в Конструкторе приложений можно от имени пользователя с ролью "Конструктор web-клиента".
...
...
@@ -38,32 +63,29 @@ Install/upgrade configuration
#. Для шаблонов маршрутов ``showcase_templates_status01``, ``showcase_templates_status02`` и ``showcase_templates_status03`` указать
ответственного оператора для услуг.
#. В разделе "Настройки платформы" создать новую роль "Просмотр услуг" с
Manual
~~~~~~
#. В разделе "Настройки платформы" - "Хранилище" - "Роли" создать новую роль "Просмотр услуг" с правами:
#. Импортировать приложение Showcase из архива ``/opt/synergy/apps/showcase/app-showcase.7zip``.
- "Просмотр"
.. hint::
- "Просмотр комментариев"
#. При импорте приложения рекомендуем руководствоваться `документацией`_.
- "Просмотр версий документа"
#. Если на сервере уже был установлен продукт, следует сверить номера версий приложения в архиве и на сервере, при необходимости нужно увеличить номер версии в архиве.
- "Просмотр свойств документа"
#. Добавить системного пользователя в группу ``Showcase``.
- "Просмотр категорий документа"
#. Прописать логин и пароль системного пользователя в настройки скриптов интерпретатора ``event.blocking.interpreter.createContact`` и ``event.form.formdata.change``.
- "Просмотр списка ссылок документа"
#. Проверить, что группе пользователей ``Showcase`` предоставлены все права на реестр **"Каталог услуг"**, а также на все реестры заявок.
#. В разделе "Настройки платформы" - "Хранилище" - "Папки" создать новую папку "Документы для услуг". Предоставить доступ к этой папке
группам пользователей:
Настройки каталога услуг
~~~~~~~~~~~~~~~~~~~~~~~~
- "Клиенты Showcase" - роль "Просмотр услуг"
После установки необходимо в клиентской части создать одну запись в реестре **"Настройки каталога услуг"**, где указывается количество плашек услуг в одной строке при их отображении на портале.
- "Операторы Showcase" - роль "Полный доступ"
После этого в Synergy IDE нужно убрать права на создание и удаление записей в этом реестре.
#. В этом же разделе "Настройки платформы" - "Хранилище" - "Папки" в папке "Документы для услуг" создать дочернюю папку "Пустая".
Каждой услуге соответствует некоторый реестр заявок. Для разных услуг может использоваться как некоторая типовая форма заявки, так и уникальные формы с собственными реестрами и маршрутами.
Здесь будет рассмотрен случай настройки уникальной формы заявки на услугу.
Справочник статусов заявок
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Для указания статуса любой заявки используется справочник **"Статусы заявок"**. Поля этого справочника регулируют поведение заявки и ее отображение в Личном кабинете портала:
#. Значение ``isEditable=1`` означает, что:
- заявку в этом статусе клиент сможет отредактировать из Личного кабинета. Обычно используется для статусов типа "На доработку" или "Ожидает ответа клиента". Если в поле указано 0, то клиент не редактирует заявку.
- если в заявке заполнены поля ``crm_form_contact_product_file`` или ``crm_form_contact_product_comment``, содержимое этих компонентов будет отображено у пользователя в Личном кабинете.
#. Значение ``isEnd=1`` означает, что, если в заявке заполнены поля ``crm_form_contact_product_file`` или ``crm_form_contact_product_comment``, содержимое этих компонентов будет отображено у пользователя в Личном кабинете. В справочнике должен быть ровно один элемент, у которого в этом поле указано ``0``, для всех остальных нужно указать ``1``.
#. Значение ``isModified=1`` означает, что в этот статус заявка перейдет после того, как клиент из своего Личного кабинета отредактировал заявку и сохранил изменения в ней. Например, может использоваться для перехода из статуса "На доработке" в статус "В работе". В справочнике должен быть ровно один элемент, у которого в этом поле указано ``0``, для всех остальных нужно указать ``1``.
Настройка формы заявки
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
После импорта приложение **Showcase** содержит две типовые формы заявок: "Заявка №1" и "Заявка №2". Для ускорения конфигурирования новой формы заявки можно сделать копию одной из этих форм.
Каждая форма заявки обязательно должна содержать следующие компоненты:
- ``crm_form_contact_product_requestID`` - идентификатор заявки. Не допускается совпадение идентификаторов для заявок на разные услуги: нужно использовать либо единый шаблон номера для всех услуг, либо для каждой услуги в шаблоне номера указывать некий префикс, уникальный для этой услуги.
- ``crm_form_contact_product`` - ссылка на реестр "Каталог услуг" ``items``, заполняется ссылкой на выбранную услугу
- ``crm_form_contact_product_date`` - компонент "Дата и время", дата подачи заявки
- ``crm_form_contact_product_status`` - компонент "Выпадающий список", используется справочник "Статусы заявок", содержит текущий статус заявки
- ``crm_form_contact_product_file`` - компонент "Ссылка на файл в Хранилище", может быть приложен файл для обратной связи с клиентом
- ``crm_form_contact_product_comment`` - компонент "Многострочное поле", может быть добавлен комментарий для обратной связи с клиентом
Код формы заявки на услугу должен начинаться с ``showcase_form_request_``.
Настройка реестра заявки
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
После создания формы заявки необходимо создать и настроить реестр для нее:
#. В начало маршрута активации реестра заявки на услугу необходимо добавлять блокирующий процесс ``event.blocking.interpreter.createContact``, иначе поданная заявка не будет добавлена в запись контактов.
#. Все права на реестр необходимо предоставить группе пользователей ``Showcase``.
Созданный реестр нужно указать в сведениях о соответствующей услуге (реестр "Каталог услуг", поле "Ссылка на реестр").
Все услуги, публикуемые на витрине Showcase, настраиваются через реестр **"Каталог услуг"**. Для того, чтобы опубликовать новую услугу, нужно создать в реестре новую запись для нее.
Прежде, чем публиковать новую услугу, следует ответить на вопросы:
- Какая форма заявки будет использоваться для услуги - одна из типовых форм, ранее созданных для других услуг,
или с собственным набором полей?
- Будет ли описание услуги сопровождаться документами, которые пользователь может скачать и просмотреть?
В зависимости от ответов на эти вопросы будет отличаться процесс добавления новой услуги:
#. Если услуга требует использования уникальной формы заявки - необходимо создать эту форму и реестр для нее в Synergy IDE.
Если можно использовать уже существующую форму заявки, этот шаг можно пропустить.
#. Если услуга требует приложения некоторого набора документов, которые клиент может просмотреть - необходимо предварительно
создать папку в модуле Хранилище - Файлы. Эта папка должна быть вложена в ранее созданную папку "Документы для услуг", чтобы
права на нее были настроены корректно.
#. В любом случае процедура добавления новой услуги на Витрину услуг завершается созданием новой записи в Каталоге услуг.
.. hint::
По умолчанию приложение **Showcase** содержит типовую форму заявки "Заявка 1" и реестр "Заявки 1". Для ускорения конфигурирования
новой формы заявки можно сделать копию реестра "Заявки 1" - при этом будут созданы копии этого реестра и его формы.
Это позволит сократить время настройки обязательных компонентов формы, маршрута активации и сопоставления данных в реестре.
Создание новой формы заявки
~~~~~~~~~~~~~~~~~~~~~~~~~~~
Каждая форма заявки должна содержать следующие компоненты:
Все услуги, публикуемые на витрине Showcase, настраиваются через реестр **"Каталог услуг"**. Для того, чтобы опубликовать
новую услугу, нужно создать в реестре новую запись для нее.
Сведения об услуге:
- идентификатор - регулирует порядок следования услуг;
- название - отображается на плашке услуги и является заголовком на странице услуги;
- категория услуги - справочное поле (в текущей версии не используется);
- URL - часть URL страницы услуги (в текущей версии не используется);
- флаг "Добавить на главную" - регулирует, будет ли услуга отображена в слайдере или в виде плашки в основной области главной страницы. Если флаг включен, услуга будет добавлена в слайдер;
- флаг "Добавить на главную" - регулирует, будет ли услуга отображена в слайдере или в виде плашки в основной области
главной страницы. В текущей версии не используется;
- "Отображается на сайте" - справочное поле, регулирующее публикацию услуги на портале;
- изображение - изображение, которое будет использовано для услуги на главной странице. Если услуга добавляется в слайдер, рекомендуется использовать широкоформатные изображения с высоким разрешением;
- кнопка в плашке - используется для подписи кнопки перехода из плашки услуги на страницу этой услуги (например, "Подробнее", "Описание" и т.д.);
- изображение - изображение, которое будет использовано для услуги на главной странице. Рекомендуется использовать
широкоформатные изображения с высоким разрешением;
- кнопка в плашке - используется для подписи кнопки перехода из плашки услуги на страницу этой услуги (например,
"Подробнее", "Описание" и т.д.);
- кнопка в описании - используется для подписи кнопки подачи заявки на услугу (например, "Заказать");
- ссылка на реестр - в выпадающем списке нужно выбрать реестр, который будет использоваться для заявок по этой услуге;
- ценность - отображается на плашке услуги и является подзаголовком на странице услуги;
- описание - многострочное поле, в котором указывается подробное описание услуги;
- видео - в это поле может быть добавлена ссылка на видео, которое будет отображено на странице услуги;
- презентация - текстовое поле, в которое нужно добавить блок ``iframe`` для публикации презентации. Например:
.. note:: Если для услуги одновременно добавлены и видео, и презентация, то на странице этой услуги на портале будет отображено только видео.
.. hint:: Для получения кода для встраивания презентации можно воспрользоваться сервисом `Slideshare <http://www.slideshare.net>`_
- ключевые слова - однострочное поле, в котором через запятую указываются ключевые слова, по которым пользователи могут
найти услугу;
- путь к папке с документами для услуги - однострочное поле, в котором нужно указать путь к папке Хранилища, в которой
расположены документы по этой услуге, или путь к пустой папке.
- таблица "Документы", в которой нужно выбрать файл из Хранилища и указать название этого файла. Выбранные документы будут отображены на странице услуги в разделе "Материалы".
.. important:: После создания новой записи в Каталоге услуг не забудьте вернуться к конфигурированию формы заявки на
эту услугу и указать созданную запись в поле ``item_request_itemName``.
После создания/редактирования записи реестра услуга будет сразу добавлена/изменена на портале.
