User Guide > Objects > Alphabetical Listing > Filter Tab

Filter Tab

The Filter tab contains the criteria that should be applied in searching the reports of tasks or files.

Description

All filter definitions can contain the wildcard characters "*" and "?". "*" stands for any characters, "?" for exactly one character. There is no need to use the * character at the beginning and the end because the search takes place within the specified term.

For each Filter object, you can specify several different reports or files and you can also check several terms in each file/report. To insert Filter definitions, you click in a field (such as report - contains) and then you click the "+" button that appears to its right. A new line will automatically be inserted below the selected entry. To delete lines, you click "-".

Further important notes:

The task ends on status FAULT_POST_PROCESSING if the report does not exist or the file cannot be accessed.
A line break is inserted if individual report lines exceed the report's block size.
The search function ignores line breaks. For example, searching for "ERROR*file" means that the filter definition is met when "ERROR" and "file" are found in one line or in different lines.
A text search is used for regular reports but also for XML reports.
The CodeTable of the agent that is used in the task is applied.
Variables used in filter objects must be used in the Automic script. eg :set &Dummy#= &$PHYS_DATE_YYYY_MM_DD_p#.

Field/Element		Description
Operation of the filter definitions
AND operation		All filter definitions must apply.
OR operation		At least one filter definition must apply.
Filter definitions
Report		Report type The report must be stored in the AE databaseA database is an organized collection of data including relevant data structures.. Use the filter definition "File" if you store reports in the file system. The selected operation setting is also valid if wildcard characters are used for the report type. For example: The string "ERROR" is to be found in reports of type "S*". All SAP reports are searched. The filter definition is met if "ERROR" is found in at least one SAP report (because of the OR operation).
	contains does not contain	Any string. The notation of the string is irrelevant because this field is case-insensitive. You can determine whether trailing spaces of the string should be truncated or not in the variable UC_SYSTEM_SETTINGS, setting GET_PROCESS_LINE_RTRIM. By default, these spaces are automatically removed.
File		File or filter for several files. The selected operation setting is also valid if wildcard characters are used in the file name. For example: The string "ERROR" is to be found in C:\Temp\*.txt. The files a.txt and b.txt are available in the directory C:\Temp. An AND operation has been selected; therefore, the filter definitions are only met if "ERROR" exists in both files.
	contains does not contain	Any string Note that the search for files is case sensitive.
Registered Job Output		File or filter for several files. This filter category can be used to check the content of external job output files. Filter objects that include definitions of this kind can only be used in combination with jobs. The condition does not apply if the specified file cannot be found.
	contains does not contain	Any string