Функции в шаблонах документов
При автоматическом формировании документов по шаблонам могут применяться функции. Они упрощают отображение различных данных в документе, например: автоматический вывод суммы прописью, склонение окончания слов при подсчете денежных единиц или вычисление стоимости заказа с помощью формул.
Формулы
В шаблонах документов можно использовать формулы. Для того, чтобы добавить формулу в документ, используйте следующий синтаксис: %%%ФОРМУЛА%%%.
ФОРМУЛА — это выражение, которое можно использовать в вычисляемом поле.
Пример:
%%%ТЕКСТ({{Аналитика.Услуга.Количество}}*{{Аналитика.Услуга.Стоимость}};".2f")%%%
В примере выше информация из аналитики «Услуга» с помощью соответствующих переменных попадает в формулу. Значения перемножаются, и вычисляется значение общей суммы конкретной услуги или товара. А с помощью функции ТЕКСТ() полученное значение приводится в удобочитаемый вид в виде строки текста.
Функции
Перечень функций, которые можно использовать для формирования шаблонов документов:
Функция СУММА
СУММА() — это множащаяся переменная. Например, у вас есть аналитика «Услуга», и вы хотите в документе посчитать полную стоимость всех услуг. Для этого в документе укажите функцию:
Сумма({{Аналитика.Услуга.Стоимость}})
Для того, чтобы получить полную стоимость оказанных услуг, которые могут предоставляться несколько раз, необходимо стоимость умножить на количество, затем всё суммировать. В итоге в документе укажите такую формулу:
СУММА({{Аналитика.Услуга.Стоимость}}*{{Аналитика.Услуга.Количество}})
Обратите внимание, функция СУММА() может содержать внутри себя любую формулу, состоящую из функций.
Функция МНОЖЕСТВЕННОЕЧИСЛО
Используется для склонения окончания слова в зависимости от числа, которое указано перед ним в шаблоне документа.
Формат:
МНОЖЕСТВЕННОЕЧИСЛО(число; "текст1"; "текст2"; "текст3")
В зависимости от вычисленного значения числа функция подберет один из трёх параметров. Параметры необходимо указать в строгой последовательности, которая подбирается по следующему алгоритму. Например, вам необходимо просклонять слово «рубль».
Для того, чтобы получить "текст1", просклоняем два числа 1 и 21. Получаем:
- 1 рубль
- 21 рубль
Значит первым параметром в функции вместо "текст1" можно указать слово «рубль».
Параметр № 2:
Берем два числа 2 и 123 и склоняем окончание слова «рубль». Получаем: 2 рубля 123 рубля
Значит вторым параметром будет слово «Рубля»
Параметр № 3:
Берем два числа 25 и 111 и склоняем окончание слова «рубль». Получаем: 25 рублей 111 рублей
Значит третьим параметром будет слово «Рублей».
В итоги функция будет выглядеть так:
МНОЖЕСТВЕННОЕЧИСЛО (СУММА(Шаблон:Аналитика.Услуга.Стоимость*Шаблон:Аналитика.Услуга.Количество); "рубль"; "рубля"; "рублей")