Список как Продукт — кастомизация генератора документов Битрикс24

14 Января 2021

следующая статья
Мария Чернецкая

Руководитель проектов

Мария Чернецкая
Список как Продукт — кастомизация генератора документов Битрикс24

С появлением генератора документов в Битрикс24 коэффициент полезной работы сотрудников резко возрос, а расходы времени — наоборот, упали. Функционал позволяет в считанные секунды создавать из шаблонов полноценные документы, куда подставляется вся необходимая информация. Остается лишь распечатать, послать по электронной почте или сохранить на диск для хранения. Генератор отлично взаимодействует с сущностями CRM, однако не предусматривает возможности подтягивать информацию из списков. Но если у Вас коробочный Битрикс24 — не сомневайтесь, генератор сможет взаимодействовать со списками после определенных доработок. Доказано разработчиками Авиви. 

Основное о генераторе документов

Автоматическое создание документов из размеченных определенным методом  шаблонов стало возможным еще в 2017 году в виде кастомного приложения в Битрикс24.Маркетплейс. Но уже 1 марта 2018 года на презентации версии “Гонконг” команда Битрикс24 представила этот функционал в качестве штатного, за что сорвала бурные овации зрительного зала. 

Действительно, инструмент оказался удобным, полезным и очень эффективным. После внедрения в облачном сервисе, пользователи обнаружили в комплекте с генератором еще и набор шаблонов типовых документов (в соответствии с правилами деловодства для разных стран мира), что значительно облегчало работу всей компании. 

1 преза генератора.png

Но даже если нужного шаблона не было, создать его и загрузить в систему могли как интеграторы, так и сами сотрудники, имеющие представление о текстовых редакторах, типа MS Word и прочитав инструкцию по правилам разметки. Усовершенствование функционала позволило генератору вытягивать информацию из нужных полей различных сущностей СRM. На момент написания статьи это Лид, Сделка, Контакт, Компания, Счет и Предложение. Этого практически достаточно, чтобы генерировать всевозможные документы на множество печатных страниц и со множеством полей поставленной информации. Но каждый бизнес уникален и порой использует в своих бизнес-процессах нелинейные решения, завязанные на работе с Сущностями. Именно такая ситуация сложилась у одного из наших зарубежных заказчиков — маркетингового агенства The Bedrock из Калифорнии, США. 

100500 ёлок

СRM от Битрикс24 позволяет моделировать самые различные бизнес-процессы, по которым работает компания в плане продаж товаров или услуг. Менеджеры могут не просто накапливать информацию о взаимодействии с клиентом, но и обмениваться документами, вести учет товаров, создавать всевозможные предложения и совершать повторные продажи. Однако не всегда функционалом СRM возможно полной мерой отобразить модель работы с клиентом. 

У наших заказчиков нет типовых клиентов, которым продают одинаковый набор услуг или его вариации. Каждый покупатель у них, можна сказать, кастомный: он получает набор предложений, каждое из которых также имеет десятки вариантов, взаимосвязанных между собой. Для такой деятельности абсолютно не подходит работа с сущностью Продукт, у которого есть свой набор характеристик. В конкретном кейсе “продуктом” является совокупность различного количества составляющих с индивидуальными характеристиками.

Самый простой пример с ёлкой: как продукт, это дерево, у которого есть характеристики высота, цвет и, скажем, “пушистость”. Если бы наши заказчики продавали ёлки, работать с таким Продуктом в Битрикс24 было бы легко и просто. Но в их случае, ёлка может состоять из сотни мельчайших характеристик: диаметра ствола на участке от линии сруба до нижних веток, процентом смолы в древесине, количеством иголок на каждом отдельном ответвлении, которое, в свою очередь, будет зависеть от расположения веточки к подсолнечной стороне произрастания… 

2 ghbvth.png

Таким образом, нужно создавать  100500 продуктов “Ёлка” с учетом ВСЕХ возможных вариантов, либо использовать Списки в Битрикс24. Наши клиенты изначально выбрали этот рациональный вариант, но в таком случае генератор документов не мог формировать коммерческие предложения, счета, поручения, накладные и прочее. Нашей же команде предстояло научить генератор документов черпать данные из списков. 

Практическая реализация 

Если совсем коротко и понятно: разработчики Авиви создали кастомный функционал, который позволяет выводить в документы Список, как Продукт. Поскольку списки клиента представлены динамическими таблицами, то решить задачу методом присваивания переменным статических значений — так называемый “хардкод” — нельзя. 

Исходя из технического задания, мы реализовали максимально простой и удобный метод работы для сотрудников. В коробочном Битрикс24 заказчика был создан новый Highload-блок, куда вносятся все возможные характеристики их связанных продуктов. Наш кастомный код обрабатывает данные и дает генератору документов команды, по которым строятся таблицы в нужных местах шаблона документа, которые уже видят пользователи. 

3 пример.png

Важно отметить, что генератор документов не утратил и штатную способность взаимодействия с Сущностями Битрикс24. Если необходимо подставить поля из сделок, Лидов и так далее, это будет возможно на ряду с подстановкой данных из списков. 

Также хотелось обратить внимание, что построение таблиц Списков происходит аналогично с алгоритмами Битрикс24. В шаблоне указана лишь одна строка, куда система вставляет особый код, сгенерированный нашим обработчиком. И уже генератор документов подставляет в таблицу нужное количество строк и столбцов, наполняет их данными из Списков, которое соответствует количеству элементов Списка, привязанным к текущей сущности . Поэтому важно, чтобы при создании кастомных шаблонов в нужном месте всегда была лишь одна строка — иначе генератор документов “не поймет”, что от него требуется. 

Задел на будущее

В конкретном кейсе была реализована лишь необходимая для работы часть функционала. Наполнение Highload-блок, как известно, происходит из админ-панели коробочного Битрикс24 и за это, в конкретном случае, отвечает человек с необходимыми правами доступа. Мы оценили и предложили функционал, который даст возможность заполнять характеристики продуктов рядовым менеджерам в Портале Битрикс24, но пока заказчик отложил этот вопрос на потом. В админпанели добавление полей характеристик для генерации документа выглядит вот так:

MtjBxDF блур.png

В любом случае кастомизация функционала генератора документов является важным достижением, расширяет возможности системы и, главное — соответствует потребностям заказчика Авиви. Если Вы также активно пользуетесь Списками, мы с радостью поделимся нашими наработками в этом направлении. Ведь кроме генератора документов у нас еще есть функционал, позволяющий групповое редактирование всех полей списков в Битрикс24.

Получайте больше вместе с Авиви!


Похожие статьи

Записаться на консультацию

Мы свяжемся с вами в течении 10 минут