### Общие сведения {#overview}

Synergy CRM устанавливается отдельным пакетом. Возможные варианты установки:

1. Установка конфигурации CRM без данных (чистая установка)
2. Установка конфигурации CRM с демо-данными

> **Внимание!** Первые 2 варианта удаляют все текущие данные в системе!

3. Установка конфигурации CRM  Install/Upgrade Configuration
4. Установка конфигурации CRM Manual с загрузкой конфигурации  пользователем

> **Примечание:**
>
> Для работы данного приложения требуется Synergy 3.11 и выше.


### Базовая установка конфигурации CRM {#basic_setting}
 
После обновления Synergy на 3.11 необходимо сначала обновить базу данных 
в Административном приложении.

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

1. Необходимо установить пакет `arta-synergy-apps-crm`:

 `# aptitude install arta-synergy-apps-crm `

2. После этого выйдет окно терминала для выбора вида установки:

![Виды установки CRM](resources/img/install_type.png)

Необходимо выбрать вид установки приложения CRM:

* `Clean`- установка приложения CRM и загрузка преднастроенной БД и хранилища Synergy
* `Demo` - установка приложения CRM и загрузка преднастроенной БД и хранилища Synergy 
с демонстрационными данными

> ***Внимание!***
>
> **Варианты установки `Clean` и `Demo` удаляют все текущие данные в системе**

* `Install/Upgrade Configuration` - установка приложения CRM и загрузка его конфигурации
* `Manual` - установка приложения CRM без автоматической загрузки конфигурации


### Установка конфигурации CRM без данных {#crm_without_data}

Выбрав 1 вариант Clean crm, необходимо ввести URL до Synergy, на котором 
производится работа. Например: http://192.168.1.172:8080/Synergy

![Настройки пакета CRM](resources/img/package_configuration2.png)

Далее ввести пароль Mysql - `root`.


#### Настройка в подсистеме администрирования и Конфигураторе: {#configure}

Для варианта Clean crm будет загружена база с настроенными:

-   Чистым хранилищем

-   Пользователями:

    - Системный Пользователь-(от имени которого будут 
      выполняться сопоставления).

    - Пользователь1 - Жуматаев Ерик Жуманович - Руководитель отдела маркетинга
 (логин - Жуматаев, пароль - Жуматаев).

    - Пользователь2 - Муканова Камила Манаповна - Специалист по маркетингу 
(логин - Муканова, пароль - Муканова).

-   Всем разрешен доступ в систему, сгенерированы логины/пароли, прочими 
    свойствами не обладают.

-   Орг.структурой:

    - Организация (подразделение, руководитель отсутствует)

    -     - Отдел маркетинга (подразделение, руководитель Пользователь1)

    -     -     - Специалист по маркетингу (должность, на нее назначен Пользователь2)

-   Дополнительно на "Отдел маркетинга" настроено отображение только следующих модулей:

    - Ежедневник

    - Хранилище -> Реестры

    - Маркетинг

-   Группами:

    - Все маркетологи

    - Маркетологи-менеджеры (Пользователь1)

    - Маркетологи-специалисты (Пользователь2 и Системный Пользователь)

-   Прочими опциями (их значения отличаются от дефолтных):

    - форма завершения "Комментарий": "Требовать подтверждения результата" - нет

    - "Отображать полное ФИО пользователя" - да
    - "Отображать ФИО и должность пользователя на момент подписи в листе подписей" - да

    - "Отображать в ходе исполнения будущие этапы" - да

    - "Требовать ввода комментария при согласовании/утверждении" - да

    - "Требовать ввода комментария при отказе в согласовании/утверждении" - да

    - "Форма завершения по умолчанию" - Комментарий

    - "Переназначение работ" - везде переназначить работы на непосредственного
       руководителя

    - "Название системы" - ARTA Synergy CRM

    - "Интеграция с почтой" - да 

Права на реестры настраиваются в Конфигураторе, чтобы они отображались. Заходим в систему 
под пользователем с правами на реестры. 

> **Примечание:**
>
>"Интеграция с почтой" предназначена для отправки уведомлений, шаблонов документов
(коммерческое предложение, акт приема-передачи, договора) заказчикам на почту. 
В Конфигураторе включить опцию -"Интеграция с почтой", затем ввойти в Основное приложение Synergy, 
нужно прописать настройки сервера для отправки и заполнить 
электронные адреса пользователей.

![Интеграция почты](resources/img/mail.png)

Обязательно включить галочку в параметре -"Основной", 
иначе почтовые уведомления не будут работать. 
Более подробно можно ознакомиться в [`описании настроек почты`](http://tdd.lan.arta.kz/docs/cases/crm/user-manual/html/sec.appendix.html#user_settings)

После установки системы необходимо зайти в Основное приложение Synergy и проверить модули. 
При переходе в модуль “Хранилище” должны отображаться реестры, например как на следующем рисунке:

![Хранилище](resources/img/registries.png)

На рисунке показано, как должна выглядеть система, если кликнуть на верхней 
панели модуля Маркетинг, т.к данных нет, во всех данных нулевые значения. 

![Маркетинг](resources/img/marketing.png)

Если отображается серое окно, значит при установке были допущены ошибки.Подробнее все ошибки 
рассмотрены в разделе - [`Устранение неполадок`](#Troubleshooting)


### Установка конфигурации CRM с демо-данными {#crm_with_demo}

Для варианта 2 (**Demo CRM**), в дополнение к варианту Clean CRM будет загружена 
преднастроенная база данных и хранилище Synergy с демонстрационными данными. 


## Установка конфигурации CRM - Install/Upgrade Configuration {#Install_Upgrade}

После обновления Synergy на 3.11 необходимо сначала обновить базу данных в Административном приложении.
Данный вариант установки Install/Upgrade Configuration отличается от других видов тем, 
что автоматически загружается конфигурация через API, не удаляя при этом информацию 
пользователя. 

> В терминале выполняются следующие команды:

1. Перед установкой проверьте подключенные репозитории, ознакомиться по следующей 
[`ссылке`](http://tdd.lan.arta.kz/docs/synergy/trunk/admin-manual/html/install-and-setup.html#install-and-setup.internet.repos)

2. Необходимо установить пакет CRM arta-synergy-apps-crm на сервер.
Для этого выполним команду:

   # aptitude install arta-synergy-apps-crm

3. Выбрать 3 вид установки - Install/Upgrade Configuration

![Виды установки CRM](resources/img/install_type.png)

4. Далее необходимо ввести URL до Synergy, на котором производится работа.
Например: http://192.168.1.172:8080/Synergy.

5. Ввести логин и пароль пользователя с доступом на Конфигуратор.

6. Создать в Административном приложении системного пользователя, от имени которого будут выполняться
   все сопоставления реестров в Synergy.

7. Перейти  в  файл crm.properties, который находится - 
/opt/synergy/jboss/standalone/configuration/arta/apps/crm/crm.properties и добавить следующее содержимое:

```xml
synergy.address=http://localhost:8080/Synergy
user.login=логин
user.password=пароль
```

Указать логин/пароль системного пользователя, созданного в пункте 6.

8. Для примера предлагаем следующие настройки [`Настройка в подсистеме администрирования и Конфигураторе`](#configure)

9. Настроить права на внешний модуль нужным пользователям в организационной  структуре 
в Подсистеме администрирования.

10. Должны быть настроены права на следующие реестры:

+---------------------------+-----------------------+----------------------+
| **Реестр**                | **Группа**            | **Права**            |
+===========================+=======================+======================+
| Маркетинговые мероприятия | Все маркетологи       | Все                  |
+---------------------------+-----------------------+----------------------+
| Лиды                      | Все маркетологи       | Все                  |
+---------------------------+-----------------------+----------------------+
| Сделки                    | Все маркетологи       | Просмотр списка,     |
|                           |                       | Просмотр данных,     |
|                           |                       | Создание, Изменение, |
|                           |                       | Редактирование       |
+---------------------------+-----------------------+----------------------+
| Аккаунты                  | Все маркетологи       | Все                  |
+---------------------------+-----------------------+----------------------+
| Контакты                  | Все маркетологи       | Все                  |
+---------------------------+-----------------------+----------------------+
| % комиссии                | Маркетологи-менеджеры | Просмотр списка,     |
|                           |                       | Просмотр данных,     |
|                           |                       | Изменение,           |
|                           |                       | Редактирование       |
+---------------------------+-----------------------+----------------------+
| Темы сотрудничества       | Все маркетологи       | Все                  |
+---------------------------+-----------------------+----------------------+
| Каталог товаров и услуг   | Все маркетологи       | Все                  |
+---------------------------+-----------------------+----------------------+
| Прайс-лист                | Все маркетологи       | Все                  |
+---------------------------+-----------------------+----------------------+
| Договоры поставки         | Все маркетологи       | Все                  |
| (единовременная оплата)   |                       |                      |
+---------------------------+-----------------------+----------------------+
| Договоры поставки         | Все маркетологи       | Все                  |
| (оплата частями)          |                       |                      |
+---------------------------+-----------------------+----------------------+
| Акты приема-передачи      | Все маркетологи       | Все                  |
| товара                    |                       |                      |
+---------------------------+-----------------------+----------------------+
| Коммерческое предложение  | Все маркетологи       | Все                  |
+---------------------------+-----------------------+----------------------+

> **Примечание:**
>
> Данные настройки создаются только в начальной установке CRM, при последующих обновлениях 
конфигурации не изменяются.


### Установка конфигурации CRM с загрузкой пользователем - Manual {#crm_manual}

После обновления Synergy на 3.11 необходимо сначала обновить базу данных в Административном приложении.
Чтобы установить CRM систему на сервер необходимо выполнить 
следующие шаги:

1. Перед установкой проверьте подключенные репозитории, ознакомиться по следующей 
[`ссылке`](http://tdd.lan.arta.kz/docs/synergy/trunk/admin-manual/html/install-and-setup.html#install-and-setup.internet.repos)

2. Необходимо установить пакет CRM arta-synergy-apps-crm на сервер.
Для этого выполним команду:

   # aptitude install arta-synergy-apps-crm

3. Выбрать 4 вид установки - Manual.

4. Затем необходимо ввести URL до Synergy, на котором производится работа.
Например: http://192.168.1.124:8080/Synergy.

5. Загрузить конфигурацию в Конфигуратор по адресу,расположенному  /opt/synergy/apps/crm/crm_configuration.xml 
с того компьютера, где установлен пакет arta-synergy-apps-crm.

6. Изменить URL до Synergy в настройках внешнего модуля в Конфигураторе  с адресом `http://host:port/crm`, 
в нашем случае - `http://192.168.1.124:8080/crm`

![Внешний модуль](resources/img/external_module.png)

7. Создать в Административном Приложении системного пользователя от имени которого, будут выполняться 
все сопоставления реестров в Synergy.

8. Перейти  в  файл crm.properties, который находится- 
/opt/synergy/jboss/standalone/configuration/arta/apps/crm/crm.properties и добавить следующее содержимое:

```xml
synergy.address=http://localhost:8080/Synergy
user.login=логин
user.password=пароль
```

Указать логин/пароль системного пользователя , созданного в пункте 7.

9. Для примера предлагаем следующие настройки [`Настройка в подсистеме администрирования и Конфигураторе`](#configure)

10. Добавить и настроить права пользователям на реестры CRM  в Конфигураторе для их отображения 
в Основном приложении Synergy для модуля Хранилище.

11. Должны быть настроены права на следующие реестры:

+---------------------------+-----------------------+----------------------+
| **Реестр**                | **Группа**            | **Права**            |
+===========================+=======================+======================+
| Маркетинговые мероприятия | Все маркетологи       | Все                  |
+---------------------------+-----------------------+----------------------+
| Лиды                      | Все маркетологи       | Все                  |
+---------------------------+-----------------------+----------------------+
| Сделки                    | Все маркетологи       | Просмотр списка,     |
|                           |                       | Просмотр данных,     |
|                           |                       | Создание, Изменение, |
|                           |                       | Редактирование       |
+---------------------------+-----------------------+----------------------+
| Аккаунты                  | Все маркетологи       | Все                  |
+---------------------------+-----------------------+----------------------+
| Контакты                  | Все маркетологи       | Все                  |
+---------------------------+-----------------------+----------------------+
| % комиссии                | Маркетологи-менеджеры | Просмотр списка,     |
|                           |                       | Просмотр данных,     |
|                           |                       | Изменение,           |
|                           |                       | Редактирование       |
+---------------------------+-----------------------+----------------------+
| Темы сотрудничества       | Все маркетологи       | Все                  |
+---------------------------+-----------------------+----------------------+
| Каталог товаров и услуг   | Все маркетологи       | Все                  |
+---------------------------+-----------------------+----------------------+
| Прайс-лист                | Все маркетологи       | Все                  |
+---------------------------+-----------------------+----------------------+
| Договоры поставки         | Все маркетологи       | Все                  |
| (единовременная оплата)   |                       |                      |
+---------------------------+-----------------------+----------------------+
| Договоры поставки         | Все маркетологи       | Все                  |
| (оплата частями)          |                       |                      |
+---------------------------+-----------------------+----------------------+
| Акты приема-передачи      | Все маркетологи       | Все                  |
| товара                    |                       |                      |
+---------------------------+-----------------------+----------------------+
| Коммерческое предложение  | Все маркетологи       | Все                  |
+---------------------------+-----------------------+----------------------+

> **Примечание:**
>
> Данные настройки создаются только в начальной установке CRM, при последующих обновлениях 
конфигурации не изменяются.

Все настройки по правам пользователя 
указаны в пункте - [`Настройка в подсистеме администрирования и Конфигураторе`](#configure)

Сопоставление полей реестров можно посмотреть [`сопостовления полей реестров:`](http://tdd.lan.arta.kz/docs/cases/crm/spec/html/sec.crm_conf_consist.html#user_components.matching)


### Устранение неполадок {#Troubleshooting}

1. **Проблема:** в модуле "Маркетинг" ничего не отображается

   **Возможная причина:** при установке неправильно указан URL для Synergy
   
   **Пути устранения:** в терминале необходимо выполнить команду
 
`# dpkg-reconfigure arta-synergy-apps-crm ` или исправить настройки в 
Конфигураторе

2. **Проблема:** нет реестров у пользователя
   
   **Возможная причина:** не настроены права для реестров 
  
   **Пути устранения:** необходимо настроить в Конфигураторе права пользователю на все реестры CRM.

3. **Проблема:** не отображаются Лиды или не работают сопоставления реестров.

   **Возможная причина:** неправильно прописаны очереди в файле.

   **Пути устранения:** 1) прописать очередь в файле, расположенному 
/opt/synergy/jboss/standalone/configuration/arta/api-observation-configuration.xml

```xml
<listener>
 <queue>java:jboss/queues/Synergy/FormDataChange</queue>
 <event>event.form.formdata.change</event>
</listener>
<listener>
 <queue>java:jboss/queues/Synergy/LeadDelete</queue>
 <event>crm.lead.delete</event>
</listener>
```

    2) В файл /opt/synergy/jboss/standalone/configuration/standalone-onesynergy.xml добавить
в секцию 
```xml
<jms-destinations/>
```
очередь
```xml
<jms-queue name="FormDataChange">
<entry name="queue/FormDataChange"/>
<entry name="java:jboss/queues/Synergy/FormDataChange"/>
<durable>true</durable>
</jms-queue>
<jms-queue name="LeadDelete">
<entry name="queue/LeadDelete"/>
<entry name="java:jboss/queues/Synergy/LeadDelete"/>
<durable>true</durable>
</jms-queue>
```





