Как загрузить 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
Округлить сумму сделки до целого числа	{{ object.amount

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

В S2 CRM можно загружать liquid-шаблоны c форматом файлов html и DOCX.

1. Создайте шаблон документа и оформите его, вставив нужные переменные.

Чтобы просмотреть переменные, доступные для liquid-шаблонов, откройте Настройки — Документы — Шаблоны. Нажмите + — Загрузить шаблон Liquid или DOCX (liquid формат) и перейдите во вкладку Переменные.

2. Перейдите в Настройки — Документы — Шаблоны. Нажмите + — Загрузить шаблон Liquid или DOCX (liquid формат)

3. Нажмите Выбрать файл и загрузите ваш шаблон в CRM-систему. 

4. Укажите название шаблона и имя файла, генерируемого на основе шаблона. 

5. Нажмите Сохранить.

Готово, шаблон загружен в S2 CRM и его можно использовать в карточках объектов.