Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Condition The condition builder options allow creating you to create and use dynamically evaluated predefined values for the specified column types of columns, or fields, or tables, or condition operators.

The main use case of this functionality is filtering by fields of Date/Time /DateTime type. Options The options facilitate filtering by using predefined values, such as "Yesterday", "Week before", "Next Month" and others.

Tip

The following options are implemented for the Date, DateTime, DateTime Specific column types:

  • Tomorrow
  • Today
  • Yesterday

These options are delivered within the platform.

Creating a new

Create an option


To create a new option, please complete the steps below:

  1. Navigate to System Definition → Condition Builder → Options.
  2. Click New and fill in the fields.
  3. Click Save or Save and Exit to apply the changes.

Option form fields

then for option is is applicable for against this option is applicable for operators for then is applicable for please Definition → Builder → . please your there is then  when For keep sequence below
FieldMandatoryDescription
TitleY

The Specify the option name. It will be displayed in displayed in the condition builder values choice list. See the screenshot below as an example;

Image Modified

Active
Select this checkbox to make the option active. If not selected, this option is not displayed in the condition builder values choice list.
Field typeNSpecify a column type for to which this option is applicable. If not specified, then the option will be applicable for to all field types created in the system.
Refer to tableN

Specify a referring table (this is helpful in case if you need to select all fields that refer to any specific field of some specific table).

This field appears when the Field type field value is Reference or List.

Use for fieldNSpecify a field to which this option is applicable. If not specified, then the option applies to all columns.
Use in tables NSpecify tables to which this option is applicable. You can specify more than one table. If not specified, the option applies to the whole table structure.
Use with operatorsN

Specify condition

operators to which this option is applicable. You can specify more than one type. If not specified,

the option

applies to all operators supported.

Tip

To find a list of operators supported by options,

navigate here:

System

Definition → Condition

Builder → Operators

To add new operators to this list,

contact

the vendor.


OrderNSpecify an option order. If more than one similar option are created, they will be applied according to the specified value in the ascending order.
ScriptN

Specify a script implementing the option logic.

Note

You can use Script Includes

when defining option logic.

To do this,

complete the

following steps:

  1. Create a script include as described in the article mentioned above.
  2. Import it using the ss.importIncludeScript(name) method.
Code Block
languagejs
themeEclipse
titledateWeekAfter
linenumberstrue
function getDateWeekAfter() {
const simpleDateTime = new SimpleDateTime();
simpleDateTime.addDays(7);
return simpleDateTime.getDate();
}


Code Block
languagejs
themeEclipse
titleImporting Script Include
linenumberstrue
ss.importIncludeScript('getDateWeekAfter');
setResult(getDateWeekAfter()); 
This field appears when the Field type field value is Reference.
Refer to TableNThis field allows specifying a referring table (this is helpful in case if you need to select all fields referring to any specified field of some specified table).



Option example


For example, we you need an option that allows rapid choosing of the specified you to quickly choose a specific user from the employees' list when performing selections of Employee table when selecting managers. For To do this, start creating create an option and fill in the fields as shown with the field values as described below:

FieldValue
TitleJohn Doe
ActiveYes
Field typeReference
Use for fieldManager
Use in tableEmployee
Use with operatorsIS

As a result, we you have got a new option against for the Employee table, as shown on the screenshot below.





Table of Contents
absoluteUrltrue
classfixedPosition
printablefalse