Как загрузить liquid-шаблон в S2 CRM

В S2 есть редактор шаблонов, возможности которого позволяют подставлять в документы нужные значения из CRM-системы. Но иногда функций стандартного редактора недостаточно. Это касается случаев, когда нужно не просто вывести в документ данные, но и задать для вывода определенную логику, либо как-то обработать данные. Для таких ситуаций в S2 реализован функционал liquid-шаблонов. Особенности работы с ними мы рассмотрим в данной справке.

Обратите внимание: для создания и настройки liquid-шаблонов вам могут потребоваться базовые знания в языках программирования html, ruby и liquid.

Возможности 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\| upcase }}
Округлить сумму сделки до целого числа	{{ object.amount \| floor }}