Настройка и кастомизация Synergy Customers
============================================

Можно ли изменить дизайн продукта?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

*Теги: изменить дизайн, изменить интерфейс.*

*Уровень: разработчик.*

Продукт реализован на платформе Arta Synergy и конструкторе 
приложений в частности. Данный конструктор приложений 
обеспечивает дизайн "по умолчанию", используется встроенный 
framework `UIKit <https://getuikit.com/docs/introduction>`_.

При этом конструктор приложений позволяет менять дизайн продукта. 
Для этого необходимо:

* подключить разработчика со знаниями HTML/CSS и JavaScript;
* в приложении конструктора ``Customers`` переопределить стили 
  в ресурсах и свойствах всех используемых компонентов:

  * "CSS Класс" и "Стили" - у стандартных компонентов;
  * "HTML" и "Стили" - у пользовательских компонентов.

.. tip:: Изменить цвета витрины продаж можно без разработчика 
         штатными средствами, см. подробнее здесь_.

.. _здесь: #id5

Как изменить URL-адрес приложения?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

*Теги: адрес приложения, URL, /customers.*

*Уровень: системный администратор.*

В качестве примера изменим URL с ``customers`` на ``sales``.

#. Авторизоваться в Конструкторе приложений и перейти в 
   актуальную версию приложения "Customers 3.0" (с кодом 
   ``customers``).

#. Открыть свойства приложения и поменять значение поля URL 
   с дефолтного ``customers`` на новое ``sales``.

#. Передеплоить приложение.

   *Вариант 1.* В Конструкторе приложений использовать меню 
   Клиент -> Деплой.

   *Вариант 2.* Передеплоить приложение со стороны сервера:

   * Перейти в папку ``deployments``:

       .. code-block:: html 

	   # cd /opt/synergy/jboss/standalone/deployments

   * Выполнить команду:

       .. code-block:: html 

	   # touch sales.war.dodeploy

#. Со стороны сервера перейти в конфигурационный файл nginx:

    .. code-block:: html 

	# nano /etc/nginx/sites-enabled/synergy-base

   и поменять дефолтный контекст ``/customers`` на новый 
   ``/sales``.

   *Было customers:*

    .. code-block:: xml 

        location /customers {
                proxy_pass http://127.0.0.1:8080/customers;
        }

   *Стало sales:*

    .. code-block:: xml 

        location /sales {
                proxy_pass http://127.0.0.1:8080/sales;
        }

#. Проверить корректность настроек nginx:

    .. code-block:: html 

	# nginx -t

   При необходимости исправить ошибки.

#. Если проверка прошла успешно, перезагрузить настройки nginx:

    .. code-block:: html 

	# nginx -s reload



Как изменить поля в карточках?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

*Теги: добавить новое поле, изменить заголовок поля, изменить 
порядок следования полей.*

*Уровень: аналитик.*

Продукт реализован на платформе Arta Synergy и редактора 
форм в частности. Данный редактор форм обеспечивает гибкую 
настройку состава полей любых карточек.

#. Авторизоваться в Конфигураторе приложений и перейти в 
   приложение "Customers" (с кодом ``customers``).

#. Найти и открыть нужную форму.

#. Изменить состав полей и их свойства согласно рекомендаций_.

.. _рекомендаций: description.html#id1

Как изменить стадии сделки?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

*Теги: сделка, изменить название стадии, переименовать стадию, 
изменить порядок следования стадий, изменить описание стадии, 
добавить новую стадию, удалить стадию.*

*Уровень: аналитик.*

**Решение:** отредактировать элементы справочника "Стадии сделки".

#. Авторизоваться в Конфигураторе приложений и перейти в 
   приложение "Customers" (с кодом ``customers``).

#. Найти и открыть справочник "Стадии сделки" (с кодом 
   ``customers_dict_dealStatus``).

#. Нажать на кнопку "Элементы". Откроется таблица со списком 
   стадий сделок. Для удобства отсортируйте таблицу по столбцу 
   "Порядковый номер".

#. Изменить элементы согласно описания справочника `стадий сделок`_.

.. _`стадий сделок`: description.html#c

Как изменить стадии договора?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

*Теги: договор, изменить название стадии, переименовать стадию, 
изменить порядок следования стадий, изменить описание стадии, 
изменить цвет стадии, добавить новую стадию, удалить стадию.*

*Уровень: аналитик.*

**Решение:** отредактировать элементы справочника "Стадии договора".

#. Авторизоваться в Конфигураторе приложений и перейти в 
   приложение "Customers" (с кодом ``customers``).

#. Найти и открыть справочник "Стадии договора" (с кодом 
   ``customers_dict_contractStatus``).

#. Нажать на кнопку "Элементы". Откроется таблица со списком 
   стадий договора. Для удобства отсортируйте таблицу по столбцу 
   "Порядковый номер".

#. Изменить элементы согласно описания справочника `стадий договора`_.

.. _`стадий договора`: description.html#id5

Как изменить стадии лида?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

*Теги: лид, изменить название стадии, переименовать стадию, 
изменить порядок следования стадий, добавить новую стадию, удалить стадию.*

*Уровень: аналитик.*

**Решение:** отредактировать элементы справочника "Стадии лида".

#. Авторизоваться в Конфигураторе приложений и перейти в 
   приложение "Customers" (с кодом ``customers``).

#. Найти и открыть справочник "Стадии лида" (с кодом 
   ``customers_dict_leadStatus``).

#. Нажать на кнопку "Элементы". Откроется таблица со списком 
   стадий лида. Для удобства отсортируйте таблицу по столбцу 
   "Порядковый номер".

#. Изменить элементы согласно описания справочника стадий лида.