Документы 2.0: Создание шаблона и работа с переменными

Переменные

Изменение шаблона и конструктор переменных

С помощью конструктора переменных, можно работать с разными данными из сделки, пользоваться соответствующими переменными, и использовать различные модификаторы преобразования этих данных.
Подробно, как это работает можно посчитать по ссылке в разделе.
Переменная – это функционал виджета, позволяющий создавать свои переменные, которые могут состоять из текстовой информации, изображений, циклов, условий.

Переменные можно создавать в ручную и выбирать созданную переменную в конструкторе переменных. Также можно использовать одни переменные внутри других переменных (порядок не важен).
В первом разделе "Переменные" можно добавить собственные переменные.
Название переменной доступно на английском языке, при необходимости можно добавлять описание.
После создания переменной нажимаем "Сохранить".
Созданную переменную можно скопировать, и добавлять в необходимое место шаблона документа.
Информацию по добавлению Табличной части в шаблон документа, можно найти по ссылке в инструкции

Переменные изображения

Переменные Изображения

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

Работа с циклами. Примеры.

С помощью циклов можно выводить различные данные о контактах и сделках, а также использовать множество других переменных и функций, предоставляемых виджетом:
Пример запроса

{% for item in lead.contacts %}

{{item.name}}: {{item.phone}}

{{ item.cf.2367057 }}

{% endfor %}

В данном коде используется следующая логика:
  1. for item in lead contact - начало цикла, который проходит по каждому элементу массивов lead и contact.
  2. ({item name}): ({item phone}) - выводит имя и номер телефона каждого элемента. Обратите внимание, что item name и item phone предполагают, что каждый элемент массива имеет поля с такими названиями.
  3. (% endfor %) - завершение цикла.
Таким образом, этот код проходит по каждому элементу массивов lead и contact и выводит имя и номер телефона для каждого элемента.
Для использования пользовательского поля {{ item.cf.AAA }} где ААА это id поля в аккаунте
В примере настроен цикл, который выводит данные из полей Контакта в формируемый документ, если в сделке указано несколько контактов, с разными телефонами и должностями.
Вывод данных в документе:
В следующем примере рассмотрим цикл, который выводит данные из полей Сделки по заполненным полям, Сумма заказа и Валюта заказа. Если нам необходимо переводить число в строку по заданной валюте.

(подробное описание по ссылке в разделе)
Пример запроса

{{lead.cf.2823145|inWordsCurrency(lead.cf.2823147)}}

В это случае выводится значение поля lead.cf.2823145 прописью в валюте, которое указывается в поле lead.cf.2823147 с типом список.
Вывод данных в документе: