Tables below provide information about condition operators, available for specified column types.
In the tables below, condition operators separated by the column types supported are given.
In the Operator Display Name table column, the displayed operator name is specified.
In the System name table column, the system operator name is specified, usable in condition strings or scripts.
In the Script table column, the example script is represented.
In the Condition Builder table column, the condition and its result are represented.
Available Extra Operators
Condition operators changes, changes from and changes to are applicable to any type of condition. They are used to track updates and changes in a particular field during record insert or update.
To use the VALCHANGES, CHANGESFROM, CHANGESTO operators, you need to configure it as a column extra attribute first.
Operator Display Name | System name | Condition Builder |
---|---|---|
changes | VALCHANGES | Priority changes Returns true if "Priority" field value has changed during record insert/update. When a record is inserted, the changes operator returns true for fields of any type. For example, if a business rule running on Insert has condition "Subject changes", then it will run when the Subject field is inserted with any value (not null or different from the Default Value). |
changes from | CHANGESFROM | Priority changes from High Returns true if "State" field value has changed from "High" to any other value during record insert/update. |
changes to | CHANGESTO | Priority changes to High Returns true if "Priority" field value has changed to "High" during record insert/update. |
Boolean
Operator Display Name | System name | Script | Condition Builder |
---|---|---|---|
is | = | current.addQuery('active', true); current.addQuery('active', '1'); | Active is Yes The output is all records where "Active" field value is Yes only (attribute active=1). |
is not | != | current.addQuery('active', '!=', true); current.addQuery('active', '!=', '1'); // true | Active is not Yes The output is all records where the Active field is not enabled (that is, this attribute value = 'false'). |
is same | SAMEAS | current.addQuery('active', 'sameas', 'published'); | Active is same Published The output is all records where "Active" and "Published" have the same value (both have Yes or No). |
is different | NSAMEAS | current.addQuery('active', 'nsameas', 'published'); | Active is different Published The output is all records where "Active" and "Published" have different values (one has Yes and the other has No or vice versa). |
is anything | ANYTHING | current.addQuery('active', 'anything'); | Active is anything The output is all records where "Active" has any value (Yes or No). |
Choice
Operator Display Name | System name | Script | Condition Builder |
---|---|---|---|
is | = | current.addQuery('priority', '2'); // High | Priority is High The output is all records where "Priority" field value is "High" only. |
is not | != | current.addQuery('priority', '!=', '2'); // not High | Priority is not High The output is all records where "Priority" field value is not equal to "High". |
is one of | IN | // High OR Moderate current.addQuery('priority', 'in', ['2', '3']); | Priority is one of High, Moderate The output is all records where "Priority" value is "High" or "Moderate". |
is not one of | NOT IN | // not High AND not Moderate current.addQuery('priority', 'not in', ['2', '3']);; | Priority is not one of High, Moderate The output is all records where "Priority" value is any other than "High" or "Moderate" |
greater than | > | current.addQuery('state', '>', '3') // High | Priority is greater than High The output is all records where "Priority" value is greater than High. |
less than | < | current.addQuery('state', '<', '3') // High | Priority is less than High The output is all records where "Priority" value is less than High. |
greater than or is | => | current.addQuery('state', '=>', '3') // High | Priority is greater than or equal to High The output is all records where "Priority" value is greater than or equal to High. |
less than or is | <= | current.addQuery('state', '<=', '3') // High | Priority is less than or equal to High The output is all records where "Priority" value is less than or equal to High. |
between | BETWEEN | current.addQuery('state', 'between', '1', '3') // between Low and High | Priority is between Low and High The output is all records where "Priority" value is between Low and High (Critical priority is not included). |
contains | LIKE | current.addQuery('state', 'like', 'publish'); | State contains publish The output is all records where "State" contains substring "publish" in choice title. |
does not contain | NOTLIKE | current.addQuery('state', 'notlike', 'publish'); | State does not contain publish The output is all records where "State" does not contain these characters in choice title. |
starts with | STARTSWITH | current.addQuery('state', 'startswith', 'publish'); | State starts with publish The output is all records where "State" contains these characters at the beginning of choice title. |
ends with | ENDSWITH | current.addQuery('state', 'endswith', 'ed'); | State ends with ed The output is all records where "State" contains these characters at the end of choice title. |
is empty | ISEMPTY | current.addQuery('state', 'isempty'); // None | State is empty The output is all records where "State" does not contain any value (None). |
is not empty | ISNOTEMPTY | current.addQuery('state', 'isnotempty'); // not None | State is not empty The output is all records where "State" contains any value. |
is same | SAMEAS | current.addQuery('urgency', 'sameas', 'impact'); | Urgency is same Impact The output is all records where "Urgency " and "Impact" have the same value (both have Low, for example). |
is different | NSAMEAS | current.addQuery('urgency', 'nsameas', 'impact'); | Urgency is different Impact The output is all records where values of "Urgency" and "Impact" have different values (one has High and the other has Moderate, for example). |
is anything | ANYTHING | current.addQuery('urgency', 'anything'); | Urgency is anything The output is all records where the "Urgency" field has any value. |
Date
Operator Display Name | System name | Script | Condition Builder |
---|---|---|---|
on | ON | current.addQuery('expired_at', '2019-01-01'); current.addQuery('expired_at', '=', '2019-01-01'); | Expire at on 2019-01-01 The output is all records where "Expire at" field value is "2019-01-01" exactly. |
not on | NOTON | current.addQuery('expired_at', '!=', '2019-01-01'); | Expire at not on 2019-01-01 The output is all records where "Expire at" is any value but "2019-01-01". |
before | < | current.addQuery('expired_at', '<', '2019-01-01'); | Expire at before 2019-01-01 The output is all records where "Expire at" date before "2019-01-01". |
after | > | current.addQuery('expired_at', '>', '2019-01-01'); | Expire at after 2019-01-01 The output is all records where "Expire at" date after "2019-01-01". |
at or before | <= | current.addQuery('expired_at', '<=', '2019-01-01'); | Expire at at or before 2019-01-01 The output is all records where "Expire at" is "2019-01-01" or the date before it. |
at or after | >= | current.addQuery('expired_at', '>=', '2019-01-01'); | Expire at at or after 2019-01-01 The output is all records where "Expire at" is "2019-01-01" or the date after it. |
between | BETWEEN | current.addQuery('sys_created_at', 'between', '2019-01-01 03:00:00', '2019-01-01 03:00:00'); | Expire at between 2019-01-01 (and) 2019-01-31 The output is all records where "Expire at" contains a date between 2019-01-01 and 2019-01-31 including these dates. |
contains | LIKE | current.addQuery('expired_at', 'like', '2019-01'); | Expire at contains 2019-01 The output is all records where database value (in UTC) of "Expire at" contains "2019-01" (for example, records that expire at 2019-01-23). |
does not contain | NOTLIKE | current.addQuery('expired_at', 'notlike', '2019-01'); | Expire at does not contain 2019-01 The output is all records where database value (in UTC) "Expire at" does not contain "2019-01" (for example, records that expire at 2019-02-01). |
is empty | ISEMPTY | current.addQuery('expired_at', 'isempty'); | Expire at is empty The output is all records where "Expire at" does not contain any value. |
is not empty | ISNOTEMPTY | current.addQuery('expired_at', 'isnotempty'); | Expire at is not empty The output is all records where "Expire at" contains any value. |
is same | SAMEAS | current.addQuery('expired_at', 'sameas', 'starts_at'); | Expire at is same Starts at The output is all records where "Expire at" and "Starts at" have the same date. |
is different | NSAMEAS | current.addQuery('expired_at', 'nsameas', 'starts_at'); | Expire at is different Starts at The output is all records where the "Expire at" value is different to the "Starts at" one. |
is anything | ANYTHING | current.addQuery('expire_at', 'anything'); | Expire at is anything The output is all records where the "Expire at" field contains any value. |
year is | YEAR_IS | current.addQuery('expired_at', 'year_is', '2020'); | Expire at year is 2020 The output is all records where the database value (in UTC) of "Expire at" contains the corresponding year. |
month is | MONTH_IS | current.addQuery('expired_at', 'month_is', '9'); | Expire at month is September The output is all records where the database value (in UTC) of "Expire at" contains the corresponding month. |
quarter is | QUARTER_IS | current.addQuery('expired_at', 'quarter_is', '2'); | Expire at quarter is II The output is all records where the database value (in UTC) of "Expire at" contains the corresponding quarter. |
week is | WEEK_IS | current.addQuery('expired_at', 'week_is', '32'); | Expire at week is 32 The output is all records where the database value (in UTC) of "Expire at" contains the corresponding week. |
day is | DAY_IS | current.addQuery('expired_at', 'day_is', '10'); | Expire at day is 10 The output is all records where the database value (in UTC) of "Expire at" contains the corresponding day of a month (10th day of any month). |
day of week is | DAY_OF_WEEK_IS | current.addQuery('expired_at', 'day_of_week_is', '1'); | Expire at day of the week is Monday The output is all records where the database value (in UTC) of "Expire at" contains the corresponding day of the week. |
Date/Time, Date/Time Specific
The input data for Date/Time fields must have the following format: YYYY-MM-DD hh:mm:ss
Operator Display Name | System name | Script | Condition Builder |
---|---|---|---|
on | ON | current.addQuery('sys_created_at', '2019-01-01 03:00:00'); current.addQuery('sys_created_at', '=', '2019-01-01 03:00:00'); | Created at on 2019-01-01 03:00:00 The output is all records where "Created at" field value is "2019-01-01 03:00:00" exactly. |
not on | NOTON | current.addQuery('sys_created_at', '!=', '2019-01-01 03:00:00'); | Created at not on 2019-01-01 03:00:00 The output is all records where "Created at" is any value but "2019-01-01 03:00:00". |
before | < | current.addQuery('sys_created_at', '<', '2019-01-01 02:59:59'); | Created at before 2019-01-01 02:59:59 The output is all records where "Created at" before datetime "2019-01-01 02:59:59". |
after | > | current.addQuery('sys_created_at', '>', '2019-01-01 02:59:59'); | Created at after 2019-01-01 02:59:59 The output is all records where "Created at" after datetime "2019-01-01 02:59:59". |
at or before | <= | current.addQuery('sys_created_at', '<=', '2019-01-01 03:00:00'); | Created at at or before 2019-01-01 03:00:00 The output is all records where "Created at" is "2019-01-01 03:00:00" or the datetime before it. |
at or after | >= | current.addQuery('sys_created_at', '>=', '2019-01-01 03:00:00'); | Created at at or after 2019-11-01 The output is all records where "Created at" contains "2019-11-01" or the dateme after it. |
between | BETWEEN | current.addQuery('sys_created_at', 'between', '2019-01-01 03:00:00', '2019-01-01 03:00:00'); | Created at between 2019-01-01 03:00:00 (and) 2019-01-02 02:59:59 The output is all records where "Created at" contains a datetime between 2019-01-01 03:00:00 and 2019-01-02 02:59:59 including these datetimes. |
contains | LIKE | current.addQuery('sys_created_at', 'like', '2019-01-01 03:44:'); | Created at contains 2019-01-01 03:44: The output is all records where database value (in UTC) of "Created at" contains "2019-01-01 03:44:" (for example, records that created at 2019-01-01 03:44:11). This condition operator returns records with partial matches and requires input datetime in UTC. |
does not contain | NOTLIKE | current.addQuery('sys_created_at', 'notlike', '2019-01-01 03:'); | Created at does not contain 2019-01-01 03: The output is all records where database value (in UTC) "Created at" does not contain "2019-01-01 03:44:" (for example, records that created at 2019-01-01 03:44:11). This condition operator returns records with partial matches and requires input datetime in UTC. |
is empty | ISEMPTY | current.addQuery('closed_at', 'isempty'); | Closed at is empty The output is all records where "Closed at" does not contain any value. |
is not empty | ISNOTEMPTY | current.addQuery('closed_at', 'isnotempty'); | Closed at is not empty The output is all records where "Closed at" contains any value. |
is same | SAMEAS | current.addQuery('sys_created_at', 'sameas', 'sys_updated_at'); | Created at is same Updated at The output is all records where "Created at" and "Updated at" have the same value. |
is different | NSAMEAS | current.addQuery('sys_created_at', 'nsameas', 'sys_updated_at'); | Created at is different Updated at The output is all records where "Created at" and "Updated at" have different values. |
is anything | ANYTHING | current.addQuery('sys_created_at', 'anything'); | Created at is anything The output is all records where "Created at" has any value. |
year is | YEAR_IS | current.addQuery('sys_created_at', 'year_is', '2019'); | Created at year is 2019 The output is all records where the database value (in UTC) of "Created at" contains the corresponding year. This condition operator returns records with partial matches and requires input datetime in UTC. |
month is | MONTH_IS | current.addQuery('sys_created_at', 'month_is', '9'); | Created at month is September The output is all records where the database value (in UTC) of "Created at" contains the corresponding month. This condition operator returns records with partial matches and requires input datetime in UTC. |
quarter is | QUARTER_IS | current.addQuery('sys_created_at', 'quarter_is', '2'); | Created at quarter is II The output is all records where the database value (in UTC) of "Created at" contains the corresponding quarter. This condition operator returns records with partial matches and requires input datetime in UTC. |
week is | WEEK_IS | current.addQuery('sys_created_at', 'week_is', '32'); | Created at week is 32 The output is all records where the database value (in UTC) of "Created at" contains the corresponding week. This condition operator returns records with partial matches and requires input datetime in UTC. |
day is | DAY_IS | current.addQuery('sys_created_at', 'day_is', '32'); | Created at day is 10 The output is all records where the database value (in UTC) of "Created at" contains the corresponding day of a month (10th day of any month). This condition operator returns records with partial matches and requires input datetime in UTC. |
day of week is | DAY_OF_WEEK_IS | current.addQuery('sys_created_at', 'day_of_week_is', '1'); | Created at day of the week is Monday The output is all records where the database value (in UTC) of "Created at" contains the corresponding day of the week. This condition operator returns records with partial matches and requires input datetime in UTC. |
hour is | HOUR_IS | current.addQuery('sys_created_at', 'hour_is', '10'); | Created at hour is 10 The output is all records where the database value (in UTC) of "Created at" contains the corresponding hour. This condition operator returns records with partial matches and requires input datetime in UTC. |
Document ID
Operator Display Name | System name | Script | Condition Builder |
---|---|---|---|
is | = | current.addQuery('item', '0229fa8abcbe1f530255bff6baf40b91'); | Item is TSK0000001 My task 1 The output is all records where the value of "Item" field is "TSK0000001 My task 1". |
is not | != | current.addQuery('item', '!=', '0229fa8abcbe1f530255bff6baf40b91') | Item is not TSK0000001 My task 1 The output is all records where the value of the "Item" field is not "TSK0000001 My task 1". |
is one of | IN | current.addQuery('item', 'in', ['0229fa8abcbe1f530255bff70874ca7e', '0229fa8abcbe1f530255bff6baf40b91']); | The is one of operator is not available for Document ID fields in the Condition Builder. Instead, use the combination of is OR is as in the example below: |
is not one of | NOT IN | current.addQuery('item', 'not in', ['0229fa8abcbe1f530255bff70874ca7e', '0229fa8abcbe1f530255bff6baf40b91']); | The is not one of operator is not available for Document ID fields in the Condition Builder. Instead, use the combination of is not AND is not as in the example below: Item is not TSK0000005 Verification AND Item is not TSK0000001 My task 1 |
contains | LIKE | current.addQuery('item', 'like', '0229fa8a-bcbe-1f53'); | Item contains 0229fa8a-bcbe-1f53 The output is all records where the value of the "Item" field contains "0229fa8a-bcbe-1f53". In the "Item" field, records from the Task (task) table are specified. Example const tableName = 'task'; const table = new SimpleRecord('sys_db_table'); table.get('name', tableName); const uuidExample = ss.getDocIdByIds(table.sys_id, '0'); const re = /(.{8})(.{4})(.{4})/; const uuidFirstHalf = uuidExample.slice(0, 16).replace(re, '$1-$2-$3'); ss.info(uuidFirstHalf); // Info: 0229fa8a-bcbe-1f53 |
does not contain | NOTLIKE | record.addQuery('item', 'notlike', '0229fa8a-bcbe-1f53'); | Item does not contain 0229fa8a-bcbe-1f53 The output is all records where the value of the "Item" field does not contain "0229fa8a-bcbe-1f53". The "Item" field does not contain records from the Task (task) table. Example const tableName = 'task'; const table = new SimpleRecord('sys_db_table'); table.get('name', tableName); const uuidExample = ss.getDocIdByIds(table.sys_id, '0'); const re = /(.{8})(.{4})(.{4})/; const uuidFirstHalf = uuidExample.slice(0, 16).replace(re, '$1-$2-$3'); ss.info(uuidFirstHalf); // Info: 0229fa8a-bcbe-1f53 |
is empty | ISEMPTY | current.addQuery('record_document_id', 'isempty') | Document Record is empty The output is all records where the value of the "Document Record" field is empty. |
is not empty | ISNOTEMPTY | current.addQuery('record_document_id', 'isnotempty') | Document Record is empty The output is all records where the value of the "Document Record" field is not empty. |
Field Name
Operator Display Name | System name | Script | Condition Builder |
---|---|---|---|
contains | LIKE | current.addQuery('column_id', 'like', 'typ'); | Column contains typ The output is all records where the display value of "Column" contains "typ". |
does not contain | NOTLIKE | current.addQuery('column_id', 'notlike', 'typ'); | Column does not contain typ The output is all records where the display value of "Column" does not contain "typ". |
starts with | STARTSWITH | current.addQuery('column_id', 'startswith', 'typ'); | Column starts with typ The output is all records where the display value of "Column" contains "typ" at the beginning. |
ends with | ENDSWITH | current.addQuery('column_id', 'endswith', 'typ'); | Column ends with typ The output is all records where the display value of "Column" contains "typ" at the end. |
is empty | ISEMPTY | current.addQuery('column_id', 'isempty'); | Column is empty The output is all records where "Column" does not contain any value. |
is not empty | ISNOTEMPTY | current.addQuery('column_id', 'isnotempty'); | Column is not empty The output is all records where "Column" contains any value. |
JSON
Operator Display Name | System name | Script | Condition Builder |
---|---|---|---|
contains | LIKE | current.addQuery('json_copy', 'like', '"url": null'); | JSON Copy contains "url": null The output is all records where "JSON Copy" display value contains "url": null. |
does not contain | NOTLIKE | current.addQuery('json_copy', 'notlike', '"url": null'); | JSON Copy does not contain "url": null The output is all records where "JSON Copy" display value does not contain ""url": null". |
is | = | current.addQuery('data', '{"user_id": "john.doe", "email": "john.doe@example.com"}'); | Data is {"user_id": "john.doe", "email": "john.doe@example.com"} The output is all records where "Data" field value is exactly this input. |
is not | != | current.addQuery('data', '!=', '{"user_id": "john.doe", "email": "john.doe@example.com"}'); | Data is not {"user_id": "john.doe", "email": "john.doe@example.com"} The output is all records where "Data" field value is not equal to this input. |
is empty | ISEMPTY | current.addQuery('json_copy', 'isempty'); | JSON Copy is empty The output is all values where "JSON Copy" does not contain any value. |
is not empty | ISNOTEMPTY | current.addQuery('json_copy', 'isnotempty'); | JSON Copy is not empty The output is all values where "JSON Copy" contains any value. |
is same | SAMEAS | current.addQuery('diplayable_path', 'sameas', 'formatter'); | Displayable Path is same Formatter The output is all values where "Displayable Path" and "Formatter" have the same values. |
is different | NSAMEAS | current.addQuery('diplayable_path', 'nsameas', 'formatter'); | Displayable Path is different Formatter The output is all values where "Displayable Path" and "Formatter" have different values. |
is anything | ANYTHING | current.addQuery('data', 'anything'); | Data is anything The output is all records where the "Data" fileld has any value. |
Keywords
Operator Display Name | System name | Script | Condition Builder |
---|---|---|---|
are | ARE | current.addQuery('keywords', 'are', 'mail'); | Keywords are mail The output is all records Full text search column of which contains the corresponding value. |
Image
Operator Display Name | System name | Script | Condition Builder |
---|---|---|---|
is empty | ISEMPTY | current.addQuery('profile_picture', 'isempty'); | Profile Picture is empty The output is all records where "Profile Picture" does not contain any image files. |
is not empty | ISNOTEMPTY | current.addQuery('profile_picture', 'isnotempty'); | Profile Picture is not empty The output is all records where "Profile Picture" contains an image file. |
List
Operator Display Name | System name | Script | Condition Builder |
---|---|---|---|
has | HAS | current.addQuery('categories', 'has', '155988310508800001,157688891108786828'); | Categories has Article, Model The output is all records where "Categories" contains the corresponding lists of references in this order exactly. "Categories has Article, Model" To get all records with Article, Model categories build the following condition:
|
has not | HASNOT | current.addQuery('categories', 'hasnot', '155988310508800001,157688891108786828'); | Categories has not Article, Model The output is all records where "Categories" does not contain the corresponding lists of references in this order exactly. "Categories has not Article, Model" To exclude all records with "Article" and "Model" categories build the following condition:
|
is | = | current.addQuery('categories', '155988310508800001'); | Categories is Article The output is all records where "Categories" contains only the corresponding reference. |
is not | != | current.addQuery('categories', '!=', '155988310508800001'); | Categories is not Article The output is all records where "Categories" is not equal to the corresponding reference (all but Article). |
contains | LIKE | current.addQuery('categories', 'like', 'artic'); | Categories contains artic The output is all records where references in "Categories" field contains corresponding characters in Display by Ref field. |
does not contain | NOTLIKE | current.addQuery('categories', 'notlike', 'artic'); | Categories does not contain artic The output is all records where references in "Categories" field does not contain corresponding characters in Display by Ref field. |
is empty | ISEMPTY | current.addQuery('categories', 'isempty'); | Categories is empty The output is all records where "Categories" field is empty. |
is not empty | ISNOTEMPTY | current.addQuery('categories', 'isnotempty'); | Categories is not empty The output is all records where "Categories" field is not empty. |
contains (dynamic) | CONTAINS_DYNAMIC | current.addQuery('followers', 'contains_dynamic', '160516373014385744'); | Followers contains (dynamic) Me The output is all records where "Followers" contains ID of current user. Using dynamic filters returning sequence of IDs is not right because the sequence is taken into account. |
does not contain (dynamic) | DOESNOTCONTAIN_DYNAMIC | current.addQuery('followers', 'doesnotcontain_dynamic', '160516373014385744'); | Followers does not contain (dynamic) Me The output is all records where "Followers" does not contain ID of current user. Using dynamic filter returning sequence of IDs is not right because the sequence is taken into account. |
Big Integer, Integer, Small Integer, Decimal, Float, Percent Complete, Days of Week, Duration
Operator Display Name | System name | Script | Condition Builder |
---|---|---|---|
is | = | current.addQuery('max_length', 10); | Max Length is 10 The output is all records where "Max Length" is 10. |
is not | != | current.addQuery('max_length', '!=', 10); | Max Length is not 10 The output is all records where "Max Length" is not 10. |
contains | LIKE | current.addQuery('serial_number', 'like', 99); | Serial Number contains 99 The output is all records where "Serial Number" contains 99. The contains operator is not available for numeric fields in the Condition Builder. It is used for filtering in scripts. |
does not contains | NOTLIKE | current.addQuery('serial_number', 'notlike', 99); | Serial Number does not contains 99 The output is all records where "Serial Number" does not contain 99. The does not contains operator is not available for numeric fields in the Condition Builder. It is used for filtering in scripts. |
is one of | IN | current.addQuery('max_length', 'in', [10, 32]); | Max Length is one of 10, 32 The output is all records where "Max Length" is "10" or "32". The values in the input field should be comma-separated or separated by line break. Spaces are not allowed. |
is not one of | NOT IN | current.addQuery('max_length', 'not in', [10, 32]); | The output is all records where "Max Length" is not "10" and is not "32". The is not one of operator is not available for numeric fields in the Condition Builder. It is used for filtering in scripts. |
less than | < | current.addQuery('max_length', '<', 255); | Max Length less than 255 The output is all records where "Max Length" value is less than 255. |
greater than | > | current.addQuery('max_length', '>', 255); | Max Length greater than 255 The output is all records where "Max Length" value is greater than 255. |
less than or is | <= | current.addQuery('max_length', '<=', 255); | Max Length less than or is 255 The output is all records where "Max Length" value is less than 255 or equal to 255. |
greater than or is | >= | current.addQuery('max_length', '>=', 255); | Max Length greater than or is 255 The output is all records where "Max Length" value greater than 255 or equal to 255. |
between | BETWEEN | current.addQuery('max_length', 'between', [10, 255]); current.addQuery('max_length', 'between', ['10', '255']); | Max Length between 10 (and) 255 The output is all records where "Max Length" value is in this range: [10; 255]. |
is same | SAMEAS | current.addQuery('taskpd', 'sameas', 'completed_tasks'); | Tasks per day is same Completed tasks The output is all records where "Tasks per day" and "Completed tasks" have the same value. |
is different | NSAMEAS | current.addQuery('taskpd', 'nsameas', 'completed_tasks'); | Tasks per day is different Completed tasks The output is all records where "Tasks per day" and "Completed tasks" have different values. |
is anything | ANYTHING | current.addQuery('max_length', 'anything'); | Max Length is anything The output is all records where the "Max Length" has any value. |
greater than field | GT_FIELD | current.addQuery('taskpd', 'gt_field', 'completed_tasks'); | Tasks per day greater than field Completed tasks The output is all records where the field value of "Tasks per day" is greater than the field value of "Completed tasks" (not including its value). |
less than field | LT_FIELD | current.addQuery('taskpd', 'lt_field', 'completed_tasks'); | Tasks per day less than field Completed tasks The output is all records where the field value of "Tasks per day" is less than the field value of "Completed tasks" (not including its value). |
greater than or is field | GT_OR_EQUALS_FIELD | current.addQuery('taskpd', 'gt_or_equals_field', 'completed_tasks'); | Tasks per day greater than or is field Completed tasks The output is all records where the field value of "Tasks per day" is greater than the field value of "Completed tasks" or is equal to the value. |
less than or is field | LT_OR_EQUALS_FIELD | current.addQuery('taskpd', 'lt_or_equals_field', 'completed_tasks'); | Tasks per day less than or is field Completed tasks The output is all records where the field value of "Tasks per day" is less than the field value of "Completed tasks" or is equal to the value. |
is empty | ISEMPTY | current.addQuery('max_length', 'isempty'); | Max Length is empty The output is all records where "Max Length" does nor contain any value. |
is not empty | ISNOTEMPTY | current.addQuery('max_length', 'isnotempty'); | Max Length is not empty The output is all records where "Max Length" contains any value. |
Reference
Operator Display Name | System name | Script | Condition Builder |
---|---|---|---|
is | = | current.addQuery('caller', '160624751417596911'); | Caller is John Doe The output is all records where "Caller" field value is "John Doe" only. |
is not | != | current.addQuery('caller', '!=', '160624751417596911'); | Caller is not John Doe The output is all records where "Caller" field value is not "John Doe" (empty records are displayed too). |
is one of | IN | current.addQuery('table_id', 'in', ['155964310500000291', '160456341213536956']); | Table is one of Known Errors, Article The output is all records where "Table" field contains "Known Errors" or "Article". |
is not one of | NOT IN | current.addQuery('table_id', 'not in', ['155964310500000291', '160456341213536956']); | Table is not one of Known Errors, Article The output is all records where "Table" is not "Known Errors" and is not "Article". The is not one of operator is not available for Reference fields in the Condition Builder. It is used for filtering in scripts. |
contains | LIKE | current.addQuery('caller', 'like', 'Aleks'); | Caller contains Aleks The output is all records where references in "Caller" field contains corresponding characters in Display by Ref field. |
does not contain | NOTLIKE | current.addQuery('caller', 'notlike', 'Aleks'); | Caller does not contain Aleks The output is all records where references in "Caller" field does not contain corresponding characters in Display by Ref field. |
starts with | STARTSWITH | current.addQuery('caller', 'startswith', 'Aleks'); | Caller starts with Aleks The output is all records where references in "Caller" field starts with corresponding characters in Display by Ref field. |
ends with | ENDSWITH | current.addQuery('caller', 'endswith', 'ev'); | Caller ends with ev The output is all records where references in "Caller" field ends with corresponding characters in Display by Ref field. |
is empty | ISEMPTY | current.addQuery('related_ticket', 'isempty'); | Related Ticket is empty The output is all records where "Related Ticket" does not contain any reference. Please note that in case the Reference field is configured to On delete = No Action, the sys_id of the deleted record remains in the field (then the reference leads to nonexisting record). Such records will not be displayed in the output of "Reference field is empty". In order to exclude records with deleted reference in the output, please use this condition: Reference Field → ID is empty. |
is not empty | ISNOTEMPTY | current.addQuery('related_ticket', 'isnotempty'); | Related Ticket is not empty The output is all records where "Related Ticket" contain any reference. Please note that in case the Reference field is configured to On delete = No Action, the sys_id of the deleted record remains in the field (then the reference leads to nonexisting record). Such records will be displayed in the output of "Reference field is not empty". In order to exclude records with deleted reference from the output, please use this condition: Reference Field → ID is empty. |
is same | SAMEAS | current.addQuery('caller', 'sameas', 'assigned_user'); | Caller is same Assigned User The output is all records where "Caller" and "Assigned User" have the same reference (empty values are suitable). |
is different | NSAMEAS | current.addQuery('caller', 'nsameas', 'assigned_user'); | Caller is different Assigned User The output is all records where "Caller" and "Assigned User" have different reference (one empty value is suitable). |
is anything | ANYTHING | current.addQuery('caller', 'anything'); | Caller is anything The output is all records where "Caller" has any value. |
is (dynamic) | DYNAMIC | current.addQuery('assignment_group', 'dynamic', '1589643105003304555'); | Assignment Group is (dynamic) One of My Group The output is all records where "Assignment Group" contains one of current user group ID. |
is not (dynamic) | ISNOT_DYNAMIC | current.addQuery('assigned_user', 'isnotdynamic', '164643105003300222'); | Assigned User is not (dynamic) Me The output is all records where "Assigned User" does not contain ID of current user (empty values are suitable). |
Record Class
Operator Display Name | System name | Script | Condition Builder |
---|---|---|---|
is | = | current.addQuery('sys_db_table_id', '155931135900000084'); | Table is User The output is all records where "Table" field value is "User". |
is not | != | current.addQuery('sys_db_table_id', '!=', '155931135900000084'); | Table is not Users The output is all records where the value of "Table" field is any table but "User". |
is one of | IN | current.addQuery('sys_db_table_id', 'in', ['155931135900000084', '156873090301469473']); | Table is one of Users, Employee The output is all records where the value of "Table" field is "User" or "Employee". |
is not one of | NOT IN | current.addQuery('sys_db_table_id', 'not in', ['155931135900000084', '156873090301469473']); | Table is not one of Users, Employee The output is all records where the value of "Table" field is not "User" and is not "Employee". The is not one of operator is not available for Record Class fields in the Condition Builder. It is used for filtering in scripts. |
contains | LIKE | current.addQuery('sys_db_table_id', 'like', 'rep'); | Table contains rep The output is all records where "Table" title contains these characters anywhere in it. |
does not contain | NOTLIKE | current.addQuery('sys_db_table_id', 'notlike', 'rep'); | Table does not contain rep The output is all records where "Table" title does not contain these characters. |
starts with | STARTSWITH | current.addQuery('sys_db_table_id', 'startswith', 'sys'); | Table starts with sys The output is all records where "Table" title contains "sys" at the beginning. |
ends with | ENDSWITH | current.addQuery('sys_db_table_id', 'endswith', 'rule'); | Table ends with rule The output is all records where "Table" title contains "rule" at the end. |
HTML, Script
Operator Display Name | System name | Script | Condition Builder |
---|---|---|---|
contains | LIKE | current.addQuery('script', 'like', 'return user.sys_id'); | Script contains return user.sys_id The output is all records where "Script" contains these characters anywhere in it. |
does not contain | NOTLIKE | current.addQuery('script', 'notlike', 'return user.sys_id'); | Script does not contain return user.sys_id The output is all records where "Script" does not contain these characters. |
is empty | ISEMPTY | current.addQuery('script', 'isempty'); | Script is empty The output is all records where "Script" does not contain any value. |
is not empty | ISNOTEMPTY | current.addQuery('script', 'isnotempty'); | Script is not empty The output is all records where "Script" contains any value. |
Phone, String, Text, Translated Text, Conditions, URL
Operator Display Name | System name | Script | Condition Builder |
---|---|---|---|
contains | LIKE | current.addQuery('email', 'like', 'lot'); | Email contains lot The output is all records where "Email" contains these characters anywhere in it. Please note that the operator is case insensitive. |
does not contain | NOTLIKE | current.addQuery('email', 'notlike', '_'); | Email does not contain _ The output is all records where "Email" does not contain these characters. Please note that the operator is case insensitive. |
starts with | STARTSWITH | current.addQuery('last_name', 'startswith', 'iv'); | Last Name starts with iv The output is all records where "Last Name" contains "iv" at the beginning. Please note that the operator is case insensitive. |
ends with | ENDSWITH | current.addQuery('last_name', 'endswith', 'ov'); | Last Name ends with ov The output is all records where "Last Name" contains "ov" at the end. Please note that the operator is case insensitive. |
is | = | current.addQuery('last_name', 'Ivanov'); | Last Name is Ivanov The output is all records where "Last Name" contains "Ivanov" exactly. Please note that the operator is case sensitive. |
is not | != | current.addQuery('last_name', '!=', 'Ivanov'); | Last Name is not Ivanov The output is all records where "Last Name" contains any value but "Ivanov". Please note that the operator is case sensitive. |
is empty | ISEMPTY | current.addQuery('username', 'isempty'); | Username is empty The output is all records where "Username" does not contain any value. |
is not empty | ISNOTEMPTY | current.addQuery('username', 'isnotempty'); | Username is not empty The output is all records where "Username" contains any value. |
is same | SAMEAS | current.addQuery('display_name', 'sameas', 'number'); | Display Name is same Number The output is all records where "Display Name" and "Number" have the same value. Please note that the operator is case sensitive. |
is different | NSAMEAS | current.addQuery('display_name', 'nsameas', 'number'); | Display Name is different Number The output is all records where "Display Name" and "Number" have different values. Please note that the operator is case sensitive. |
is anything | ANYTHING | current.addQuery('display_name', 'anything'); | Display Name is anything The output is all records where "Display Name" has any value. |
Time
This condition requires input time in UTC.
Operator Display Name | System name | Script | Condition Builder |
---|---|---|---|
on | ON | current.addQuery('run_time', '11:00:00'); | Run Time on 11:00:00 The output is all records where "Run Time" database value is "11:00:00" exactly. |
not on | NOTON | current.addQuery('run_time', '!=', '11:00:00'); | Run Time not on 11:00:00 The output is all records where "Run Time" database value is not "11:00:00". |
before | < | current.addQuery('run_time', '<', '11:00:00'); | Run Time before 11:00:00 The output is all records where "Run Time" contains time before "11:00:00" (at 10:59:59 and earlier). |
after | > | current.addQuery('run_time', '>', '11:00:00'); | Run Time after 11:00:00 The output is all records where "Created at" contains time before "11:00:00" (at 11:01:01 and later). |
at or before | <= | current.addQuery('run_time', '<=', '11:00:00'); | Run Time at or before 11:00:00 The output is all records where "Run Time" contains "11:00:00" or time before it (10:59:59 and earlier). |
at or after | >= | current.addQuery('run_time', '>=', '11:00:00'); | Run Time at or after 11:00:00 The output is all records where "Created at" contains "11:00:00" or the time after it (11:01:01 and later). |
between | BETWEEN | current.addQuery('run_time', '>=', '10:00:00'); current.addQuery('run_time', '=<', '11:00:00'); | Run Time between 10:00:00 (and) 11:00:00 The output is all records where "Run Time" contains time between 10:00:00 and 11:00:00. |
contains | LIKE | current.addQuery('run_time', 'like', '11'); | Run Time contains 11 The output is all records where "Run Time" contains "11" anywhere in it (hour, minute, second). |
does not contain | NOTLIKE | current.addQuery('run_time', 'notlike', ':11:'); | Run Time does not contain :11: The output is all records where "Run Time" contains any minutes value but 11. |
is empty | ISEMPTY | current.addQuery('run_time', 'isempty'); | Run Time is empty The output is all records where "Run Time" does not contain any value. |
is not empty | ISNOTEMPTY | current.addQuery('run_time', 'isnotempty'); | Run Time is not empty The output is all records where "Run Time" contains any value. |
is same | SAMEAS | current.addQuery('start_time', 'sameas', 'end_time'); | Start Time is same End Time The output is all records where "Start Time" and "End Time" have the same value. |
is different | NSAMEAS | current.addQuery('start_time', 'nsameas', 'end_time'); | Start Time is different End Time The output is all records where "Start Time" and "End Time" have different values. |
hour is | HOUR_IS | current.addQuery('run_time', 'hour_is', '11'); | Run Time hour is 11 The output is all records where "Run Time" contains the corresponding hour: the range is [11:00:00; 11:59:59]. |
- No labels