Filter definitions

Applications module Properties Filter

1. Join

If you create multiple filter expressions, the type of "Join" is selectable. An "AND" linking will return only data records that fulfill all criteria, and an "OR" linking will return only the data records that fulfill a minimum of one criterion.

2. Data group

First, select the data group, from which the values are to be filtered. The filter can also use data fields from a higher or lower data group level, i.e. parent or child data groups.

3. Data field

The data field will be defined in the "Data field" drop-down list. All data fields of the current application, including reference fields, can be chosen.

4. Operation

Select the operator here. Depending on the type of data field selected, the following operators are available:

Data type: string, longtext
Operator Delivers
Equal Every string that is identical with the comparative value. This is case-sensitive.
Unequal Every string that is not identical with the comparative value. This is case-sensitive.
Less than or equal Every string with a smaller or equal character values (ASCII) as the comparative value.
Less than Every string with a smaller character values (ASCII) as the comparative value.
Greater than or equal Every string with a greater or equal character values (ASCII) as the comparative value.
Greater than Every string with a greater character values (ASCII) as the comparative value.
Undefined Every dataset whose data field does not contain a valid value or has not yet been initialized. A comparative value does not need to be defined for this operator.
Defined The data field contains any random value. An empty string is also valid - e.g. when saving without an entry. A comparative value does not need to be defined for this operator.
Contains All string that contain the comparative value.
Starting with All string that start with the comparative value.
Ending with All string that end with the comparative value.
Is contained in All strings that appear, even in part, in the comparative value. If the string delivered by the data field is identical to the comparative value, no result will be returned. Multiple values can be separated with ||.
Is not contained in All strings that do not appear, even in part, in the comparative value. Multiple values can be separated with ||.

The operators "Less than or equal", "Less than", "Greater than or equal", and "Greater than" offer special usefulness when filtering customer or product numbers that are made up of number and letter strings. With the number “C1000”, the ASCII value of the character string can deliver smaller numbers. The capital letter "C" has an ASCII value of 67, the number "1" has the value 49, and the number "0" has the value 48. The operators named above compare ASCII values lexicographically. With the operator "Less than", all numbers that are smaller than "C1000" will be returned ("C999, C998, "etc.). In order to deliver data sets that possess no entry in the data field, a query must be made with an "OR" link, i.e. whether the value of the field is "NULL" (operator: "Undefined"), or whether the entry is empty because no entry has been saved. In order to return an empty string, select the operator "Equals" and set the comparison value to "User-defined". The "Character string" field will remain empty in this case. If all fields will be filtered to return entries (no empty string and no "NULL"), the filter must be run in this way with an "AND" linking.

Data type: integer, float, datetime
Operator Delivers
Equal Equal values
Unequal Unequal values
Smaller than, or equal Smaller or equal values
Smaller than Smaller values
Exceeding, or equal Exceeding or equal values
Exceeding Exceeding values
Undefined Field does not contain valid data or has not been initialized
Defined Fields containing entries
Is contained in The same as operator "Equals"
Is not contained in The same as operator "Unequal"
Is contained in tenants Is only available for selection if the UserID or a GUID from the Users application has been selected as the data field. It can be compared with the system values "Selected tenants of current user" and "All tenants of current user" to filter the current data by the tenant(s) that area assigned to the current user. Click here for more information.

Data type: boolean
Operator Delivers the result
Equal Equal logical value
Undefined Fields with the value "NULL"
Defined Fields with either the value "True" or "False"

5. Negation

This setting can be activated for the operators "Contains", "Begins with", and "Ends with". This will identify all data fields that do not match the filter.

6. Comparative value

6.1. Data field

Here, a data or reference field of your choice can be chosen for comparison. Comparing fields is only possible with fields of the same data type.

6.2. Current value

Returns every data record that contains the current value of the selected data field from the specified ReadContainer.

Select a data field from a parent data group
Opens a dialog where data fields from a parent data group can be selected. This button is only available if the data group, which is use in the selected ReadContainer, has a parent data group (or higher).

6.3. Current user - Comparison with an integer data field

6.4. Current user - Comparison with other data types

If a data field is selected that does not have the type integer, a comparison can be made here with the corresponding fields from the User manager.

6.5. System value

6.6. System value - Comparison with a datetime data field

If the selected data field is a datetime data field, the value of that field can be compared with the current date. You can find out more about adjusting dates here.
Please note when filtering time periods that a day always begins at 0:00. If you would like to filter the period of 01/08 until 05/08, the filter expression must be ">01/08 and <06/08" so that 05/08 is included in the filter.

6.7. System value - Comparison with a string or text data field

String or text data fields can be compared with the system value "exchange mailbox info". The following values are available: The comparison value "Language" will filter the table entries depending on the language setting of the portal. A requirement of this is that all data fields that will be compared must have a language key (such as "de", "en") for every data record. The comparison value "Layout" will filter the table entries depending on the current layout of the portal.

6.8. User-defined

As user-defined, static comparison values, any character string can be entered to compare string data fields. Please note that capitalization will be considered here. Integer and float data fields can be compared with a number. Datetime data fields can be compared with a date.