Использование выражений в журналах
В журналах Citeck помимо простых атрибутов (name, counterparty и др.) можно использовать выражения, если их поддерживает источник данных Records. Например, источник на базе ecos-data может выполнять SQL-подобные вычисления при запросе данных: математические операции и функции работы с датами.
Выражение — набор функций, операторов, скобок и атрибутов, который позволяет вычислить значение на основе данных источника.
Примечание
UI передаёт настроенный атрибут источнику Records. Допустимый синтаксис, функции, поддержка поиска, группировки и сортировки определяются серверным источником. Примеры ниже относятся к источникам, поддерживающим соответствующие функции ecos-data.
Вычисляемые атрибуты типа и computed журнала — отдельные механизмы. Клиентское вычисление значения для отображения само по себе не даёт возможности искать, группировать или сортировать по нему на сервере.
Актуальность вычислений зависит от серверного механизма: выражение может вычисляться во время запроса, а сохранённое вычисляемое поле — обновляться по правилам его пересчёта.
Выражения настраиваются в дополнительных настройках колонки в поле «Атрибут для загрузки».
Для настройки выражения нужно, чтобы в содержимом этого поля была или функция, или выражение, полностью обёрнутое в скобки.
Примеры
Расчёт разницы между датами в днях
ceil(((date_part('epoch', date0) - date_part('epoch', date1)) / (60 * 60 * 24)))
date0 и date1 — атрибуты с датой или датой-временем, между которыми происходит расчёт.
ceil — округлить до ближайшего целого, которое больше или равно аргументу. Вместо этой функции можно использовать:
floor — отбросить дробную часть;
round — округлить результат до ближайшего целого.
Произвольные математические операции
ceil(field0 + field1)
(field0 + field1)
(10 * (field0 + field1))
field0 и field1 — атрибуты сущности. Сложность выражений и количество атрибутов не ограничены.
Получить месяц и год
to_char(date0, 'MM.YYYY')
date0 — атрибут с датой или датой-временем.