Использование выражений в журналах

В журналах 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 — атрибут с датой или датой-временем.