Setting up a DataSearch filter

  1. Open the DataSearch Source Setup form and execute Filter-In-Place.
  2. Select the DataSearch you want to set up, or initiate a new DataSearch record.
  3. If you are creating a new DataSearch source, provide this information:
    Source Name
    Specify the name by which to identify the DataSearch source.
    IDO Name
    Select the IDO to use as the source for the data.
    Note: To search a multi-level structure, such as orders and order lines, you must either set up multiple DataSearch sources or add the appropriate columns from the second tier (order lines) to the selected IDO (orders).

    Optionally, provide values for the other header section fields.

  4. Click Filter.
  5. In the Property Name field, specify the IDO property for which you want to set up the filter.
  6. Specify the operator to use for the filter.
    If you select IS NULL or IS NOT NULL, the comparison field and value need not be specified.
  7. Select the comparison type:
    • Literal: The property value is compared to the literal value that you specify in the last field on this row.
    • DataSearch Source Property: The property value is compared to another property value from the DataSearch source.

      This can be useful when you want to use a comparison of two properties to control what records are searched. For example, if you wanted to search only orders that do not have the full number of items shipped, you could set up the property comparison QtyShipped < QtyOrdered. Or suppose you wanted to search only orders that were not shipped on time, you could set up the property comparison ShipDate > DueDate.

  8. In the last field on this row, specify the comparison value to be used for the corresponding comparison type.
  9. Optionally, if you use multiple filter clauses, to instruct the system to treat the clause as Boolean OR comparisons rather than Boolean AND comparisons with the previous clause, select OR Instead of AND with Previous Clause.
  10. To add the filter clause to the list of clauses in the display panel, click Add.
    The clause is added to the list, formatted with the proper syntax.
  11. Optionally, use Steps 4 through 10 to specify additional filter clauses.
  12. Optionally, to remove all filter clauses and start over, click Remove.
    Note:  You cannot selectively remove individual filter clauses: If you choose to remove one, you remove them all.
  13. Click OK.
For complex comparison logic, it might be necessary to add parentheses around filter clauses, to make sure they are evaluated properly. To accomplish this task, manually edit the data in the display list.
Note:  To get a better understanding of how filters can be used, look at the vendor level DataSearch Sources provided as part of the application installation.