Функции в шаблонах документов

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

Формулы

В шаблонах документов можно использовать формулы. Для того, чтобы добавить формулу в документ, используйте следующий синтаксис: %%%ФОРМУЛА%%%.

ФОРМУЛА — это выражение, которое можно использовать в вычисляемом поле.

Пример:

%%%ТЕКСТ({{Аналитика.Услуга.Количество}}*{{Аналитика.Услуга.Стоимость}};".2f")%%%

В примере выше информация из аналитики «Услуга» с помощью соответствующих переменных попадает в формулу. Значения перемножаются, и вычисляется значение общей суммы конкретной услуги или товара. А с помощью функции ТЕКСТ() полученное значение приводится в удобочитаемый вид в виде строки текста.

Функции

Перечень функций, которые можно использовать для формирования шаблонов документов:

• СУММА()
• МНОЖЕСТВЕННОЕЧИСЛО()
• ЧИСЛОПРОПИСЬЮ()
• ДРОБНАЯЧАСТЬ()

Функция СУММА

СУММА() — это множащаяся переменная. Например, у вас есть аналитика «Услуга», и вы хотите в документе посчитать полную стоимость всех услуг. Для этого в документе укажите функцию:

Сумма({{Аналитика.Услуга.Стоимость}})

Для того, чтобы получить полную стоимость оказанных услуг, которые могут предоставляться несколько раз, необходимо стоимость умножить на количество, затем всё суммировать. В итоге в документе укажите такую формулу:

СУММА({{Аналитика.Услуга.Стоимость}}*{{Аналитика.Услуга.Количество}})

Обратите внимание, функция СУММА() может содержать внутри себя любую формулу, состоящую из функций.

Функция МНОЖЕСТВЕННОЕЧИСЛО

Используется для склонения окончания слова в зависимости от числа, которое указано перед ним в шаблоне документа.

Формат:

МНОЖЕСТВЕННОЕЧИСЛО(число; "текст1"; "текст2"; "текст3")

В зависимости от вычисленного значения числа функция подберет один из трёх параметров. Параметры необходимо указать в строгой последовательности, которая подбирается по алгоритму.

Например, вам необходимо просклонять слово «рубль». Действуйте по следующему алгоритму.

Сначала просклоняйте нужное слово с числами 1 и 21:

• 1 рубль
• 21 рубль

Значит первым параметром в функции вместо "текст1" надо указать слово «рубль».

Затем просклоняйте то же слово с числами 2 и 123:

• 2 рубля
• 123 рубля

Значит вторым параметром в функции вместо "текст2" надо указать слово «рубля».

Потом просклоняйте нужное слово с числами 25 и 111:

• 25 рублей
• 111 рублей

Значит третьим параметром в функции вместо "текст3" будет слово «рублей».

В итоги функция может выглядеть так:

МНОЖЕСТВЕННОЕЧИСЛО (СУММА(Шаблон:Аналитика.Услуга.Стоимость*Шаблон:Аналитика.Услуга.Количество); "рубль"; "рубля"; "рублей")

Перейти

• Шаблоны документов
• Документы