Skip to content

DataSplice Support Website

Sections
Personal tools
You are here: Home » Product Manuals DataSplice 2.3 » DataSplice 2.3 Admin Client Manual » Views - View Criteria Tab

Views - View Criteria Tab

The View Criteria tab allows the administrator to set up one or more sets of criteria that control what data the users see. Also, different types of criteria can be established in conjunction with view and user attributes to allow data selection to vary based on the current client connection.

Criteria Tab

Criteria Name This is the name of the view criteria.
Type This is the type of the criteria. It can be either Default, Mandatory, or Offline:

  • Default - This criteria type is used to set up initial filtering of view data. It does not restrict what the users can filter on from the client, and is primarily designed for online sessions.
  • Mandatory - This criteria type is used to control what data can be seen regardless of session type. It gets applied for both online and offline sessions, and is not changeable by the user.
  • Offline - This criteria type is used to control what data gets cached offline when clients request an offline session.

Adding Criteria Sets to a View

Edit View Criteria To add criteria sets to a view:

  1. Select Views in the left pane.
  2. Select the desired view from the Available Views list.
  3. Click the View Criteria tab.
  4. Click the Add View Criteria button Add  Criteria .
  5. The Edit View Criteria dialog will open (as seen at left).
  6. Enter the name for the criteria in the Criteria Name box.
  7. Select the criteria type from the Type dropdown box.
  8. If the type is Offline, specify the maximum number of records to cache in the Max Records box. 0 or less results in an unlimited number of records.
  9. In the Filter tab, specify the filter (if any) to use to limit the data cached offline.
  10. In the Sorting tab, specify the ordering in which the records should be cached.
  11. Click the OK Button.

Edit View Criteria Dialog Box Properties

Criteria Name This is the name of the view criteria. It helps to make the name meaningful, especially when the list of view criteria is long. For example, if the criteria set defines offline work order data for the logged in user, it could be named Offline WO Data by User.
Type There are three types of view criteria - Default, Mandatory, and Offline:

  • Default - This criteria type is used to setup initial filtering of view data. It does not restrict what the users can filter on from the client, and is primarily designed for online sessions.
  • Mandatory - This criteria type is used to control what data can be seen regardless of session type. It gets applied for both online and offline sessions, and is not changeable by the user.
  • Offline - This criteria type is used to control what data gets cached offline when clients request on offline session.

Max Records This entry is only valid for offline criteria types. Setting Max Records to zero will specify an unlimited number of records. Any number greater than zero will limit the cached offline records on the client to that specified number.
Filter The Filter tab is used to specify filtering for the view criteria.
Sorting The Sorting tab is used to specify the ordering of the records for the view criteria.

Filter Tab

Simple Filter

To create a simple filter:

  1. Double click on the Criteria Name field of interest. This will bring up the Edit View Criteria dialog box. Select the Filter tab.
  2. Select the field to filter by clicking the blue Field Name and selecting a field from the list of searchable fields.
  3. Select the filter operator by clicking the = next to the Field Name and selecting the desired operator.
  4. Enter the Value to filter on in the box next to the filter operator.
  5. Click OK.

To create multiple simple filters:

  1. Double click on the Criteria Name field of interest. This will bring up the Edit View Criteria dialog box. Select the Filter tab.
  2. Click the blue Field Name to open the Filter Field menu.
  3. Select Add New Field from the Filter Field menu.
  4. A new filter will appear. Edit this filter as described above.
  5. Click OK.

Creating Complex Filters

Advanced Filter To create a complex filter:

  1. Double click on the Criteria Name field of interest. This will bring up the Edit View Criteria dialog box. Select the Filter tab.
  2. Click the blue Edit Complex Filter link.
  3. The Complex Filter grid will appear.
  4. Double click in the grid to add a filter.
  5. The Edit Filter Item dialog box will appear (as seen here).
  6. Edit the Display Name, Test, and Value fields and click OK. Display Name and Test are dropdown lists.
  7. The new filter will now appear in the filter grid.

Combining Filters

Filters may also be combined to further refine the data displayed. Filters in the same column are joined with an and operation. The records retrieved with an and operation must meet all of the conditions of all of the filters in that row. Filters in the same row are joined by an or operation. The records retrieved with an or operation must meet all of the conditions of at least one of the filters.

In the following example, the records retrieved would have a Physical Count number greater than 100 OR they would have both a Store Room starting with MAIN AND a Bin starting with A-:

Complex Filters

Advanced Filters

The basic filtering technique (selecting field, test, and value) works for most situations and is preferred because it ensures correct syntax in the query statements. More advanced filters may be created by checking the Plain Text Filter box on the Edit Filter Item dialog box and entering a custom SQL statement. This provides the opportunity to create unique filters based on the syntax of the particular database view by inputting text that will be inserted into the where clause without modification.

Plain text filter

Filter Operators

= Equal To
< Less Than
> Greater Than
<= Less Than or Equal To
>= Greater Than or Equal To
<> Not Equal To
LIKE Compares an item using a wildcard
IS NULL Returns values which are null
IS NOT NULL Returns values which are not null

Wildcards

A wildcard is a placeholder for characters which do not have to be specified. Wildcards can be used in the filter field. For example, the records for all employees whose employee numbers begin with 27 can be retrieved by using a wildcard. In this case, the filter field would be Employee Number, and the value in the field would be 27%. The percent sign indicates that anything can follow the 27. In this particular case, all of the following numbers could be returned: 27, 270, 27462983.

Sorting Tab

The Sorting tab is used to specify the ordering of the records for the view criteria. The following image shows a sort order for an offline criteria. The specified sorting orders the records in ascending order based on the value of the Location field. Additional fields can be added to the sorting of the view criteria. The first field selected as a sort parameter will establish the primary sorting order for all records. For any subsequent fields, the sorting order will be applied in the order the fields were configured.

Filter Sorting

Display Name This dropdown list consists of all the sortable fields in the view.
Direction This dropdown list indicates whether to sort the data in ascending or descending order.

 

Created by root
Last modified 2005-03-02 04:21 PM
 

Powered by Plone

This site conforms to the following standards: