Подсветка карточек CRM

Общие сведения

Функционал приложения позволяет подсвечивать (раскрашивать) карточки сущностей CRM (лиды, контакты, сделки, компании и смарт-процессы) во всех представлениях («Список», «Воронки» («Канбан»), «Дела» и «Календарь»).

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

• «Список»;
  
• «Строка».
  

В случае, если выбрано поле с типом «Список», пользователю отображаются поля для ввода или выбора кода цвета подсветки для каждого элемента списка.
После того, как произведена настройка решения, необходимо указать цвет подсветки для необходимых экземпляров сущностей:

• если выбрано поле с типом «Список» - выбирать названия элемента списка;
  
• если выбрано поле с типом «Строка» - заполнять поля правильными значениями кодов цвета. Доступны форматы:
  - RGB, например, 255.255.255;
  - HEX, например, #ddeedd;
  - буквенные обозначения, например, yellow, green.
  

Механизм работы приложения:

1. пользователь проходит на вкладку с необходимым представлением карточек сущности CRM;
   
2. слушатель событий, который устанавливается в браузер в момент установки расширения, определяет, что пользователь или перешел на вкладку Битрикс24 на одну из страниц раздела CRM или на страницы смарт-процессов, или перешел в эти разделы из других разделов портала, и вызывает действия подсветки карточек экземпляров сущностей.
   

Если все настройки выполнены и пользователь находится на целевой странице, он может видеть следующие примеры работы приложения:

Рис. 1 - Пример отображения страницы смарт-процесса «Заявки» в представлении «Канбан»

Рис. 2 - Пример отображения страницы «Сделки» в представлении «Календарь»

Рис. 3 - Пример отображения страницы «Лиды» в представлении «Канбан»

Рис. 4 - Пример отображения страницы «Контакты» в представлении «Список»
Настройки приложения доступны в разделе «Приложения» сайта и представлены на следующих вкладках:

• «Основное»
  
  Рис. 5 - Пример отображения вкладки «Основное»
  На данной вкладке доступны следующие опции:
    - «Активность» - признак, указывающий активно ли приложение (по умолчанию - активно). Карточки экземпляров задач подсвечиваются только в случае, если приложение активно;
    - «Тип поля, которое хранит данные о подсветке»:
       - «Строка» (значение по умолчанию);
       - «Список»;
  - «Подсвечивать карточки Смарт-процесса на других страницах» - признак, указывающий, следует ли подсвечивать карточки смарт-процессов, расположенных в других разделах портала (вне раздела «CRM»);
  - «URL» - перечень относительных ссылок портала без указания доменного имени, при переходе на которые осуществляется подсветка карточек смарт-процессов, например, «/page/sluzhebnaya_zapiska/od» (данное поле доступно только в том случае, если поле «Подсвечивать карточки смарт-процесса на других страницах» отмечено флажком). В результате нажатия на кнопку «Добавить» осуществляется добавление новой строки для ввода относительной ссылки сайта.
  
• «Основные сущности»
  
  Рис. 6 - Пример отображения вкладки «Основные сущности». Тип поля для хранения кодов цветов подсветки - «Список»
  На данной вкладке отображаются дочерние вкладки с названием сущности CRM. На каждой такой дочерней вкладке доступны следующие опции:
    - «Поле для хранения данных о подсветке» - одно из полей сущности с типом данных, заданным на вкладке «Настройки». В случае, если выбрано поле с типом данных «Список», также отображается блок настроек сопоставления элементов списка и названий цветов. В результате нажатия на область задания цвета отображается диалоговое окно для выбора цвета подсветки, как показано на рисунке 8.
  

• «Смарт-процессы»
  
  Рис. 7 - Пример отображения вкладки «Смарт-процессы». Тип поля для хранения кодов цветов подсветки - «Строка»
  На данной вкладке отображаются дочерние вкладки с названием смарт-процесса CRM. На каждой такой дочерней вкладке доступны следующие опции:
   - «Поле для хранения данных о подсветке» - одно из полей сущности с типом данных, заданным на вкладке «Настройки». В случае, если выбрано поле с типом данных «Список», также отображается блок настроек сопоставления элементов списка и цветов. В результате нажатия на область задания цвета отображается диалоговое окно для выбора цвета подсветки, как показано на рисунке 8.
  

Дополнительные сведения
Для выбора цвета элемента списочного поля используется штатная библиотека ColorPicker. Пример отображения выбора цвета для элемента списочного поля показан на рисунке ниже.


Рис. 8 - Пример отображения диалогового окна выбора цвета подсветки штатной библиотеки ColorPicker
Существует возможность смены цвета сразу для нескольких экземпляров сущности в представлении «Список». Такая возможность появляется только тогда, когда у сущности существует хотя бы одно поле с выбранным типом для хранения данных о цвете подсветки и это поле выбрано в настройках приложения.
Для массовой смены цвета подсветки нескольких экземпляров сущности необходимо выполнить следующие действия:

1. перейти в представление «Список»;
   
2. выбрать в табличном представлении необходимые записи. В результате активируется панель массовых операций;
   
3. выбрать пункт меню «Указать цвет подсветки», как показано на рисунке ниже.
   
   Рис. 9 - Пример отображения диалогового окна выбора действия
   В результате в зависимости от типа поля, которое хранит данные о цвете подсветки сущности, отобразятся или поле для ввода значения цвета в формате HEX (доступен выбор поля посредством штатной библиотеки ColorPicker) или поле для выбора значения цвета, а также кнопка «Применить», как показано на рисунке ниже.
   
   Рис. 9 - Пример отображения диалогового окна выбора элемента списочного поля
   
4. выбрать или указать цвет подсветки;
   
5. нажать на кнопку «Применить».
   

В результате данных действий будет изменен цвет подсветки для выбранных экземпляров сущности.