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