Фильтры экземпляров

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

Фильтр представлен в виде таблицы со следующими полями:

Имя

Тип

Описание

Логическая операция

Integer

Доступны следующие опции: И и ИЛИ. Если выбрать И, то и это правило, и предыдущие правила должны быть истинными. Если выбрано ИЛИ, то истинными должны быть либо это правило, либо предыдущие правила. Логическая операция недоступна для первого правила в наборе правил.

  • 0 - первая запись не имеет логической операции, так как она будет обрабатываться независимо от последующих правил.

  • 1 - представляет значение И.

  • 2 - представляет значение ИЛИ.

Тип

Integer

Условие или Вложенные условия. Если выбрано Условие, то правило обрабатывается в соответствии с определенными в нем Колонкой, Операцией и Значением. Если выбрано Вложенные условия, результат правила равен агрегированному результату набора вложенных правил, определенных в таблице Вложенные условия.

  • 0 - значение Условия .

  • 1 - представляет значение Вложенные условия.

Колонка

String

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

Операция

String

Определяет, какая операция применяется для проверки значения колонки, например Равен Null или Больше чем. Доступность операций зависит от типа колонки и перечислена ниже.

Значение

String

Выражение, которое должно вычислить соответствующее значение, по которому будут проверяться значения столбцов. Некоторые операции игнорируют это значение.

Вложенные условия

Таблица данных

Определяет правила вложенного фильтра. Вложенный фильтр представляет собой таблицу с теми же полями, что и таблица правил фильтра верхнего уровня. Уровень вложенности не ограничен.

Возможные значения операторов

Оператор

Тип колонки

Заметки

IS_NULL

Любой

Истина, если значение колонки является NULL и игнорирует значение.

IS_NOT_NULL

Любой

Истина, если значение колонки не является NULL и игнорирует значение Null.

CONTAINS

String

Истинно, если значение содержится в значении колонки.

IN

Numerical, String, Date

Истинно, если значение колонки равно Значение или равно одной или нескольким строкам в списке Значение.

Список Значений выражается в виде строки, элементы которой отделены друг от друга символом , или запятой. Если символ запятой , должен появиться как литерал в Значение или в элементе списка Значений, он должен быть экранирован символом обратной косой черты \.

  • Если Значение - это строка "a,1,2001-07-04T12:08:56Z", то список Значение будет состоять из a, 1 и 2001-07-04T12:08:56Z. Каждый элемент сравнивается со значением Колонки. Условие будет True, если значение Колонки равно любому из значений в списке Значение .

  • Если один или несколько элементов из списка, сформированного на основе строки Значение, должны содержать запятую, она должна быть экранирована следующим образом: "James\, Avery Taylor, Phuong\, Casey Nguyen". Текущий список с элементами James, Avery Taylor и Phuong, Casey Nguyen будет сравниваться со значениями Колонки .

DOES_NOT_CONTAIN

String

Истина, если значение не содержится в значении колонки или значение колонки является NULL.

BEGINS_WITH

String

Истинно, если значение колонки начинается на Значение.

DOES_NOT_BEGIN_WITH

String

Истинно, если значение колонки не начинается на Значение или значение колонки является NULL.

ENDS_WITH

String

Истинно, если значение колонки заканчивается значением Значение.

DOES_NOT_END_WITH

String

Истинно, если значение колонки не заканчивается на Значение или значение колонки является NULL.

EQUALS

Numerical, String, Boolean

Истинно, если значение колонки равно Значению.

DOES_NOT_EQUAL

Numerical, String, Boolean

Истинно, если значение колонки не равно Значению.

IS_GREATER_THAN

Numerical, Date

Истинно, если значение колонки больше значения.

IS_GREATER_OR_EQUAL_THAN

Numerical, Date

Истинно, если значение колонки больше или равно Значению.

IS_LESS_THAN

Numerical, Date

Истинно, если значение колонки меньше значения Значение.

IS_LESS_OR_EQUAL_THAN

Numerical, Date

Истинно, если значение колонки меньше или равно Значению.

ON

Date

Истинно, если дата в колонке равна дате Значение .

ON_OR_AFTER

Date

Истинно, если дата в колонке совпадает или позже даты значения .

ON_OR_BEFORE

Date

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

LAST_HOUR

Date

Истинно, если час в колонке равен текущему часу минус один.

THIS_HOUR

Date

Истинно, если час в колонке равен текущему часу.

NEXT_HOUR

Date

Истинно, если час в колонке равен текущему часу плюс один.

YESTERDAY

Date

Истинно, если дата в колонке равна вчерашней дате.

TODAY

Date

Истинно, если дата в колонке равна сегодняшней дате.

TOMORROW

Date

Истинно, если дата в колонке равна завтрашней дате.

LAST_WEEK

Date

Верно, если неделя в колонке равна неделе года минус один.

THIS_WEEK

Date

Истинно, если неделя в колонке равна этой неделе года.

NEXT_WEEK

Date

Верно, если неделя в колонке равна этой неделе года плюс один.

LAST_MONTH

Date

Истинно, если месяц в колонке равен текущему месяцу минус один.

THIS_MONTH

Date

Истинно, если месяц в колонке равен текущему месяцу.

NEXT_MONTH

Date

Верно, если месяц в колонке равен текущему месяцу плюс один.

LAST_YEAR

Date

Верно, если год в колонке равен текущему году минус один.

THIS_YEAR

Date

Истинно, если год в колонке равен текущему году.

NEXT_YEAR

Date

Истинно, если год в колонке равен текущему году плюс один.

LAST_X_HOURS

Date

Истинно, если Час в колонке находится между текущим часом и минусовым значением текущего часа.

NEXT_X_HOURS

Date

Истинно, если час в колонке находится между текущим часом и текущим часом плюс значение.

LAST_X_DAYS

Date

Истинно, если день в колонке находится между текущим днем и минусовым значением текущего дня.

NEXT_X_DAYS

Date

Истинно, если день в колонке находится между текущим днем и текущим днем плюс значение.

LAST_X_WEEKS

Date

Истинно, если неделя в колонке находится между текущей неделей и минусовым значением текущей недели.

NEXT_X_WEEKS

Date

Истинно, если неделя в колонке находится между текущей неделей и текущей неделей с плюсовым значением.

LAST_X_MONTHS

Date

Истинно, если месяц по колонке находится между текущим месяцем и текущим месяцем с минусовым значением.

NEXT_X_MONTHS

Date

Истинно, если месяц в колонке находится между текущим месяцем и текущим месяцем с плюсовым значением.

LAST_X_YEARS

Date

Истинно, если год в колонке находится между текущим годом и текущим годом минус значение.

NEXT_X_YEARS

Date

Истинно, если год в колонке находится между текущим годом и текущим годом плюс значение.