В S2 есть редактор шаблонов, возможности которого позволяют подставлять в документы нужные значения из CRM-системы. Но иногда функций стандартного редактора недостаточно. Это касается случаев, когда нужно не просто вывести в документ данные, но и задать для вывода определенную логику, либо как-то обработать данные. Для таких ситуаций в S2 реализован функционал liquid-шаблонов. Особенности работы с ними мы рассмотрим в данной справке.
Обратите внимание: для создания и настройки liquid-шаблонов вам могут потребоваться базовые знания в языках программирования html, ruby и liquid.
Как мы уже отметили, особенность liquid-шаблонов в том, что они позволяют не только выводить данные, но также обрабатывать или устанавливать для них определенную логику.
Рассмотрим основные возможности liquid-шаблонов, а также приведем примеры, как можно использовать указанный функционал в работе.
Вывод данных дает возможность подставлять в документ нужные значения из полей объектов CRM-системы. Для вывода данных в liquid используется разделитель {{ }}.
| Пример | Код, c помощью которого пример можно реализовать в шаблоне |
|---|
| Вывести в документ имя контакта | {{object.first_name}} |
| Вывести в документ данные о компаниях, которые привязаны к сделке | {{object.entity.name}} |
Установка логики вывода данных позволяет задавать для вывода данных нужные условия и работать с массивами. Чтобы управлять логикой вывода, используется разделитель {%%}.
| Пример | Код, c помощью которого пример можно реализовать в шаблоне |
|---|
| Если у привязанного к объекту продукта есть скидка, вывести в документ цену продукта и размер скидки. Если скидки нет, вывести только цену. | {% if object.discount %} |
| Цена со скидкой {{ object.discount }}% — {{object.selling_price}} ₽ | |
| {% else %} | |
| {{object.selling_price}} ₽ | |
| {% endif %} | |
| Вывести в документ все вложенные в сделку продукты с указанием названия и цены. | {% for product in object.products %} |
| Название: {{ product.name }} | |
| Цена: {{ product.selling_price }} | |
| {% endfor %} | |
Обработка данных позволяет перед выводом значений модифицировать их так как вам нужно. Для изменения данных используется оператор |.
| Пример использования функционала | Код, c помощью которого можно реализовать пример в шаблоне |
|---|
| Вывести в документ название продукта заглавными буквами | {{ object.name |
| Округлить сумму сделки до целого числа | {{ object.amount |
В S2 CRM можно загружать liquid-шаблоны c форматом файлов html и DOCX.
1. Создайте шаблон документа и оформите его, вставив нужные переменные.
Чтобы просмотреть переменные, доступные для liquid-шаблонов, откройте Настройки — Документы — Шаблоны. Нажмите + — Загрузить шаблон Liquid или DOCX (liquid формат) и перейдите во вкладку Переменные.
2. Перейдите в Настройки — Документы — Шаблоны. Нажмите + — Загрузить шаблон Liquid или DOCX (liquid формат)
3. Нажмите Выбрать файл и загрузите ваш шаблон в CRM-систему.
4. Укажите название шаблона и имя файла, генерируемого на основе шаблона.
5. Нажмите Сохранить.
Готово, шаблон загружен в S2 CRM и его можно использовать в карточках объектов.
