FILTER


Applies to: CELONIS 4.0 CELONIS 4.2 CELONIS 4.3 CELONIS 4.4

Description

Filters can be defined as Analysis filters, Sheet filters or Component filters. If a query is sent to Celonis, all active filters are propagated to the input table(s). Multiple filters on a table are merged together by a logical AND.
Filters are applied to the input tables before the actual query. If the filter expression evaluates to false for a row of the input table(s), this row is excluded before the query is applied.

Фильтры могут быть определены как фильтры анализа, листовые фильтры или фильтры компонентов. Если запрос отправляется в Celonis, все активные фильтры распространяются на входные таблицы. Несколько фильтров в таблице объединяются с помощью логического И.
Фильтры применяются к входным таблицам перед фактическим запросом. Если выражение фильтра оценивается как ложное для строки входных таблиц, эта строка исключается до применения запроса.

Comparison against NULL

Applying a filter which compares a column against null or not null always returns an empty result. To filter on all not null values use the ISNULL function. The reasoning behind it is the same as in the previous example. Null represents an unknown value. Celonis can not be sure if two unknown values are not the same.

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

Syntax


FILTER [FORCED] condition;

Forced Filter

If a regular filter is set as a sheet or component filter, the affected Dropdown and Button Dropdown components still show all available values. If only those values which respect the filter should be displayed and selectable, a forced filter can be used. Analysis filters are forced by default.

Если обычный фильтр установлен в качестве фильтра листа или компонента, затронутые выпадающие и кнопочные выпадающие компоненты по-прежнему отображают все доступные значения. Если только те значения, которые соответствуют фильтру, должны отображаться и выбираться, можно использовать принудительный фильтр. Фильтры анализа являются принудительными по умолчанию.

Example

Dropdown component using this regular sheet or component filter:
Выпадающий компонент, использующий этот обычный лист или фильтр компонента:

FILTER "Table"."Country" IN ('DE','US');

All values are available in the dropdown menu. Values which do not match the filter condition are displayed in gray color.
Все значения доступны в выпадающем меню. Значения, которые не соответствуют условиям фильтра, отображаются серым цветом.
Dropdown component using this forced sheet or component filter:
Выпадающий компонент с использованием этого принудительного фильтра листа или компонента:

FILTER FORCED "Table"."Country" IN ('DE','US');

Only values which match the filter condition are available.
Доступны только те значения, которые соответствуют условию фильтра.

Examples

Example where one filter is applied to the query. The filter condition excludes the second input row.
Пример, когда к запросу применяется один фильтр. Условие фильтра исключает вторую строку ввода.
Query
Filter

FILTER "Numbers"."number" != 22

Column1

"Numbers"."id"

Column2

"Numbers"."number"

Input
Numbers

id : INT
number : INT
1
13
2
22
3
34

Output
Result

Column1 : INT
Column2 : INT
1
13
3
34




Example where one filter is applied to the query. The filter condition excludes the second input row.
Пример, когда к запросу применяется один фильтр. Условие фильтра исключает вторую строку ввода.
Query
Filter

FILTER "Numbers"."number" IN (13, 34)

Column1

"Numbers"."id"

Column2

"Numbers"."number"

Input
Numbers

id : INT
number : INT
1
13
2
22
3
34

Output
Result

Column1 : INT
Column2 : INT
1
13
3
34




Example where two filters are applied to the query. Both filter conditions are merged together by a logical AND. The first filter condition excludes the second input row, and the second filter condition excludes the first input row. Therefore, only the third row appears in the result.

Пример, когда к запросу применяются два фильтра. Оба условия фильтра объединяются с помощью логического И. Первое условие фильтра исключает вторую входную строку, а второе условие фильтра исключает первую входную строку. Поэтому в результате появляется только третья строка.
Query
Filter

FILTER "Numbers"."number" IN (13, 34)

Filter

FILTER "Numbers"."id" IN (2, 3)

Column1

"Numbers"."id"

Column2

"Numbers"."number"

Input
Numbers

id : INT
number : INT
1
13
2
22
3
34

Output
Result

Column1 : INT
Column2 : INT
3
34




Example where one filter is applied to the query. The SUM aggregate function is applied after the filter has been applied to the input table.

Пример, когда к запросу применяется один фильтр. Агрегирующая функция SUM применяется после применения фильтра к входной таблице.
Query
Filter

FILTER "Numbers"."number" IN (13, 34)

Column1

SUM("Numbers"."number")

Input
Numbers

id : INT
number : INT
1
13
2
22
3
34

Output
Result

Column1 : INT
47




Example where two filters are applied to the query. Both filter conditions are merged together by a logical AND. The first filter condition excludes the first and third input row, and the second filter condition excludes the second and third input row. Therefore, the result is empty.

Пример, когда к запросу применяются два фильтра. Оба условия фильтра объединяются с помощью логического И. Первое условие фильтра исключает первую и третью строки ввода, а второе условие фильтра исключает вторую и третью строки ввода. Поэтому результат пустой.
Query
Filter

FILTER "Numbers"."number" NOT IN (13, 34)

Filter

FILTER "Numbers"."id" = 1

Column1

"Numbers"."id"

Column2

"Numbers"."number"

Input
Numbers

id : INT
number : INT
1
13
2
22
3
34

Output
Result

Column1 : INTColumn2 : INT




Example of two joined tables where one filter is applied to the query. The filter condition excludes the last row of the companyDetail input table, therefore, the last two rows of the caseTable are excluded.

Пример двух объединенных таблиц, где к запросу применяется один фильтр. Условие фильтра исключает последнюю строку входной таблицы companyDetail, поэтому последние две строки caseTable исключаются.
Query
Filter

FILTER "companyDetail"."country" = 'DE'

Column1

"caseTable"."caseId"

Input
caseTable

caseId : INT
companyCode : STRING
value : INT
1
'001'
600
2
'001'
400
3
'001'
200
4
'002'
300
5
'003'
300
6
'003'
200

companyDetail

companyCode : STRING
country : STRING
'001''DE'
'002''DE'
'003''US'


Foreign Keys

caseTable.companyCodecompanyDetail.companyCode

Output
Result

Column1 : INT
1
2
3
4




Example of two joined tables where one filter is applied to the query. The filter condition excludes the last four rows of the caseTable.
Пример двух объединенных таблиц, где к запросу применяется один фильтр. Условие фильтра исключает последние четыре строки caseTable.
Query
Filter

FILTER "caseTable"."value" > 300

Column1

"caseTable"."caseId"

Column2

"companyDetail"."country"

Input
caseTable

caseId : INT
companyCode : STRING
value : INT
1
'001'
600
2
'001'
400
3
'001'
200
4
'002'
300
5
'003'
300
6
'003'
200

companyDetail

companyCode : STRING
country : STRING
'001''DE'
'002''DE'
'003''US'


Foreign Keys

caseTable.companyCodecompanyDetail.companyCode

Output
Result

Column1 : INT
Column2 : STRING
1
'DE'
2
'DE'




Applying a filter which compares a column against null always returns an empty result.
Применение фильтра, который сравнивает столбец с нулем, всегда возвращает пустой результат.
Query
Filter

FILTER Table1.Column1 = null

Column1

Table1.Column1

Input
Table1

Column1 : INT
1
null

Output
Result

Column1 : INT




Applying a filter which compares a column against not null always returns an empty result.
Применение фильтра, который сравнивает столбец с ненулевым, всегда возвращает пустой результат.
Query
Filter

FILTER Table1.Column1 != null

Column1

Table1.Column1

Input
Table1

Column1 : INT
1
null

Output
Result

Column1 : INT





Содержание

  1. Data Types
  2. DATE
  3. FLOAT
  4. INT
  5. STRING
  6. Functions
  7. Aggregation Functions
  8. GLOBAL
  9. Pull Up Aggregation Functions
  10. PU_AVG
  11. PU_COUNT
  12. PU_COUNT_DISTINCT
  13. PU_FIRST
  14. PU_LAST
  15. PU_MAX
  16. PU_MEDIAN
  17. PU_MIN
  18. PU_QUANTILE
  19. PU_SUM
  20. Standard Aggregation Functions
  21. AVG
  22. COUNT
  23. COUNT_TABLE
  24. COUNT DISTINCT
  25. MAX
  26. MEDIAN
  27. MIN
  28. QUANTILE
  29. STDEV
  30. SUM
  31. TRIMMED_MEAN
  32. VAR
  33. Moving Aggregation Functions
  34. MOVING_AVG
  35. MOVING_COUNT
  36. MOVING_COUNT_DISTINCT
  37. MOVING_MAX
  38. MOVING_MEDIAN
  39. MOVING_MIN
  40. MOVING_STDEV
  41. MOVING_SUM
  42. MOVING_TRIMMED_MEAN
  43. RUNNING_TOTAL
  44. HOUR_NOW
  45. TODAY
  46. DATE_BETWEEN
  47. DAYS_BETWEEN
  48. HOURS_BETWEEN
  49. MILLIS_BETWEEN
  50. MINUTES_BETWEEN
  51. MONTHS_BETWEEN
  52. SECONDS_BETWEEN
  53. WORKDAYS_BETWEEN
  54. YEARS_BETWEEN
  55. ADD_DAYS
  56. ADD_HOURS
  57. ADD_MILLIS
  58. ADD_MINUTES
  59. ADD_MONTHS
  60. ADD_SECONDS
  61. ADD_WORKDAYS
  62. ADD_YEARS
  63. CALENDAR_WEEK
  64. DATE_MATCH
  65. DAY
  66. DAY_OF_WEEK
  67. HOURS
  68. MILLIS
  69. MINUTES
  70. MONTH
  71. QUARTER
  72. REMAP_TIMESTAMP
  73. SECONDS
  74. TO_TIMESTAMP
  75. YEAR
  76. DateTime Rounding Functions
  77. ROUND_DAY
  78. ROUND_HOUR
  79. ROUND_MINUTE
  80. ROUND_MONTH
  81. ROUND_QUARTER
  82. ROUND_SECOND
  83. ROUND_WEEK
  84. ROUND_YEAR
  85. DECISION_TREE
  86. KMEANS
  87. LINEAR_REGRESSION
  88. Math Functions
  89. ABC
  90. ABS
  91. CEIL
  92. FLOOR
  93. LOG
  94. POWER
  95. ROUND
  96. SQRT
  97. SQUARE
  98. ISNULL
  99. Process Functions
  100. ACTIVATION_COUNT
  101. CALC_CROP
  102. CALC_CROP_TO_NULL
  103. CALC_REWORK
  104. CALC_THROUGHPUT
  105. MATCH_PROCESS
  106. PROCESS_ORDER
  107. PROCESS EQUALS
  108. SOURCE / TARGET
  109. VARIANT
  110. Statistic Functions
  111. QNORM
  112. ZSCORE
  113. CONCAT
  114. LEFT
  115. LEN
  116. LOWER
  117. LTRIM
  118. REVERSE
  119. RIGHT
  120. RTRIM
  121. STR_TO_INT
  122. SUBSTRING
  123. UPPER
  124. Operators
  125. CASE WHEN
  126. FILTER
  127. Math Operators
  128. Addition Operator
  129. Division Operator
  130. MODULO
  131. Multiplication Operator
  132. Subtraction Operator
  133. Predicate Operators
  134. IN
  135. LIKE
  136. Ссылки на мануалы