Report Selection Screen

Report Selection screen

Each of the report screens have a similar layout. Sections include:

Report Selection Criteria

This is where you define the criteria that will be applied to the report to filter the output to just the records you want.

Field Name

To display a list of fields available in the selected file, click on the arrow below the Field name field. A drop-down list appears that shows all available fields that can be used in filter expressions. Press [up-arrow], [down-arrow], [Page Up] and [Page Down] to move the highlight to a field, then either click on the highlighted field name, or press [Enter]. Fields names usually correspond with the most commonly used fields in the relevant report module you have selected, but can also include special conditions so read the field list carefully.

Operator

Specifies the function to be performed on data during a sort to determine if a record meets criteria required for selection from the database. Available operators include:

Note: Not all operators are available at all times depending on the type of Field Name selected above.

Value

To finish the filter expression, type the value to which the records will be compared in the Value field. The entry in Value specifies the comparison value. The comparison value is not case-sensitive. For example, in the filter State Equal to “NSW”, the Value is NSW. If your field name is a date then an additional option becomes available. You will notice a check box to the right of the date value entry field. You can enter a specific date if you wish but if you check the box, a series of new date options appear. These are:

Using the special data values allows you to easily and consistently select date ranges without having to know the exact dates. Additionally, saved report definitions can be recalled and reused without having to update the date ranges. This is very important when scheduling reports.

Note: The value may not always be required depending on the Field Name and type of Operator selected. Once you have selected the relevant report file on which to apply the filter, then selected a field, operator, and value, you must connect the components together into a condition. press the Insert button to place the condition into the Report Selection Criteria list.

Note: A common mistake is to enter report selection criteria and not pressing the Insert button to insert the criteria into the Criteria List. Report Selection Criteria are not recognised until your insert them.

Building Complex Expressions

Complex filter expressions are composed of simple filter expressions connected by logical conjunctions. These conjunctions have an order of precedence that determines the sequence in which the simple expressions are evaluated within the complex expression. Parentheses ( ) within complex expressions are used to modify the order of evaluation. Simple or complex expressions, enclosed with parentheses, are considered simple expressions. TSM evaluates these sub expressions before continuing to evaluate the remainder of the complex expression. Complex expressions are evaluated as follows:

  1. When there are simple expressions within complex expressions, the simple expressions are evaluated first.
  2. When there are AND conjunctions within complex expressions, if the two operands surrounding the AND operator are both true, then the expression is evaluated to be true. If either of the operands is false, then the expression is evaluated to be false. The operands surrounding the AND operator can also be expressions.
  3. When there are OR conjunctions within complex expressions, and if either of the two operands surrounding the OR operator are true, then the expression is evaluated to be true. If both operands are false, then the expression is evaluated to be false. The operands surrounding the OR operator can also be expressions.

By connecting simple expressions according to the rules listed above, you can create very complex expressions that test for very specific conditions on the contact record. For example:

((State is Equal to "NSW" OR 
State is Equal to "VIC") OR 
(Phone Begins With "02" AND Contact Type is Equal to "CONTACT")) AND
Account Status is Not Equal To “Hold”

When this filter is active, records will be displayed if: either contact’s state is NSW or VIC or the contact’s phone number begins with “02” and the contact type of the contact is “Contact” and the contact’s account status is anything but hold

You can add conditions to the simple expression to build a complex expression from the following:

(

Opening parenthesis: inserts a left, or opening, parenthesis in the filter expression.

)

Closing parenthesis: inserts a right, or closing, parenthesis in the filter expression.

AND

Inserts a logical AND in the filter expression.

OR

Inserts a logical OR in the filter expression.

It is easy to get confused with the above logic. A common mistake would be to code the following filter to list all of Joe or Fred’s jobs that are open. Employee equals Joe OR Employee = Fred AND Job Type = Open. The above example would give all of Joes jobs forever OR All of Fred’s jobs which are open since the AND forces a simple expression with Fred and Job Type. To force the intended logic, you should use parenthesis to force the simple expressions to be evaluated in the correct order:

(Employee equals Joe OR Employee = Fred) AND Job Type = Open

Report Criteria Actions

Insert

Inserts a new report criterion into the Report Selection Criteria list using the values specified in the report selection criteria dropdowns.

Update

Updates (edits) the selected report criteria in the Report Selection Criteria list.

Remove

Removes the selected report criteria from the Report Selection Criteria list.

Clear All

Removes all report criteria from the Report Selection Criteria list.

Up

Swap the order of the selected row in the Report Criteria list with the one immediately above it in the Report Criteria List.

Down

Swap the order of the selected row in the Report Criteria list with the one immediately below it in the Report Criteria List.

Save

Saves the report criteria list for later reuse. You can improve the speed of producing frequently accessed reports by saving complex report criteria for reuse later. Select whether the report criteria will be saved as a publicly available filter or a filter saved under your login name. Enter a meaningful Description of the Report Criteria. Press the Save button to save the report criteria.

Delete

You can permanently remove saved filters by selecting the filter you want to remove and pressing the Delete button.

Public

View report filters available to all users.

Private

View report filters available to the logged in user only.

Screen Specific Options

This area contains options that vary depending on which Report Screen you have selected.

Sort By

Choose the order you want the output to be sorted by. Some reports can not be sorted.

Selected Report Layout

TSM provides many different report layouts for you to choose from. Select the report layout you want this report run to use. TSM will remember the layout you last selected. Report layouts are customisable via the TSM Report Customisation screen.

Level of Detail

Action Buttons

Setup Reports

Maintain your own custom reports. See the Customising Reports section for more details.

Exit

Exit the Reports screen.

Print

Output the selected report to your preferred output device. The following options will become available:

Printer

Output the report to the printer. If you want to choose the printer you will print to, select the check box and you can choose your printer. Otherwise, TSM will print to the default printer setup in the TSM setup screen.

Screen

Display the report to the screen. Note: You must have Adobe Acrobat reader loaded for this to work (available from the TSM CDROM or from the TSM web site or from www.acrobat.com. TSM Generates a PDF representation of the report on the fly then launches Adobe Acrobat to display the report.

File

Output report information to an output file. Enter the name of the file you want to create. Select Report output type

Regardless of which type you select, you will be able to preview the file to screen when completed.

E-Mail

Automatically email the printed output to your desired recipient. This option creates an Adobe Acrobat compatible PDF file (or text file depending on your Setup options) which it links as an attachment to an email. Acrobat PDF files are a convenient way of emailing or saving reports for later review. TSM can use it's internal email module or a MAPI client to send email. See the Miscellaneous section of setup for more details.

Cancel

Cancel report output.