10.4. System

10.4.1. Miscellaneous Settings
10.4.2. Notification Settings
10.4.3. Test Execution
10.4.4. Interface Settings
10.4.5. Languages

This page contains the settings for the appearance and behavior of Klaros-Test­management. It contains four tabs, Miscellaneous, Notifications, Interface and Languages.

Clicking the Save button persists the changes to the Klaros-Test­management properties file, and clicking Cancel discards all changes.

10.4.1. Miscellaneous Settings

The Miscellaneous Settings Tab

Figure 10.10. The Miscellaneous Settings Tab

This tab contains settings which govern the behavior of Klaros-Test­management. The following settings can be controlled here:

  • Application URL

    This URL must only be provided if the application is accessed through a proxy server. The proxy is responsible to redirect the user request to a physical URL. The URL specified in the proxy must be entered here. More information about rewriting URLs can be found at http://httpd.apache.org/docs/2.0/mod/mod_proxy.html.

    Press the Check Application URL link to test if the URL has been entered correctly.

  • Maximum Upload File Size [Byte]

    The maximum attachment size which can be uploaded. Changing this value requires a restart of the application server.

  • Use the default container session timeout

    If checked, the default tomcat session timeout will be used (30 minutes).

  • Session Timeout (Minutes)

    If the checkbox above is unchecked, this value is used as the session timeout.

    [Note] Note

    A newly set session timeout will not be applied to currently running sessions.

  • Authentication required for import

    If true, user credentials are required to import results (e.g. using Jenkins/Hudson plugin). See also Section, “Jenkins Plugin for Klaros-Test­management”.

  • Only Administrators can create Users

    If checked, only administrators can create users. If unchecked, managers can also create users.

  • Only Managers and Administrators can see other users in the user management

    If this option is set, testers and guests will only see their own user entry. Turn on this option if you like to hide user information from the eyes of your testers and guests.

  • Only managers are allowed to change a job status:

    If checked, only users in the role of Manager or higher may change the status of jobs.

10.4.2. Notification Settings

Notifications will be sent by the system via email for various events like creating a user account or assigning a job. This section allows to configure the conditions under which these notification emails will be sent.

Sets of notifications can be defined in a notification scheme and reused for various projects. If a notification scheme is declared as the default notification scheme, it will automatically be assigned to every existing project unless a different scheme is defined for this project.

Figure 10.11 shows the notification scheme definition tab.

[Caution] Email-Configuration required!

For notifications to work properly it is required to both configure the email server settings as described in Section 10.5.3, “E-Mail” and make sure that all user accounts contain a valid email address.

The Notification Schemes Tab

Figure 10.11. The Notification Schemes Tab

Clicking the New button creates a notification scheme. The Name and Description fields can be set here directly. If the Default check box is activated this notification scheme will be the default notification scheme which is per default applied to every project.

By pressing the icon the notification edit tab is shown where the notifications and project assignments can be defined. Clicking the icon causes the notification scheme to be sceduled for deletion.

When the Save button is clicked the notification scheme will be saved. The Cancel discards the changes made. Notification Scheme Settings

Figure 10.12 shows the edit options for a notification scheme.

The list shows the notifications already defined for the notification scheme currently edited. For creating a notification, the user may individually assign events from a predefined set of available notification events to one or more notification targets (user accounts).

The available notification events are:

  • Job Assigned

    This event is triggered once a Job is saved with a new assignee.

  • Account Created

    This event is triggered once a user account has been created.

  • Account Password Changed

    This event is triggered once an account password has been changed in the local user database.

  • Test execution failed

    This event is triggered if a test case step gets marked as failed or error during execution.

  • Job ready for execution

    This event is triggered whenever a non-executable job becomes executable, because all dependencies of the job are fulfilled (See Section, “Dependencies”).

The available notification targets are:

  • Assignee

    The assigned user account for a job assignment or the currently created/changed user account.

  • Creator

    The user responsible for triggering the notification event, e.g. by assigning a job.

  • Current User

    The user account currently active.

  • Specific User

    A specific user account.

The Notifications Tab

Figure 10.12. The Notifications Tab

Using the Assign Projects button the user may assign a notification scheme to a limited set of projects, thus overriding the default notification scheme.

Figure 10.13 shows the dialog for project assignement.

Assigning Projects to a Notification Scheme

Figure 10.13. Assigning Projects to a Notification Scheme

10.4.3. Test Execution

The Test Execution Tab

Figure 10.14. The Test Execution Tab

This tab contains settings regarding the test execution. The following settings can be changed here:

  • Create test suite results when importing test case results

    If true, test suite results are automatically created for the corresponding test suite information contained in the result file. This information may vary with the import format. Additionally a corresponding test suite is created for the test suite result if it did not yet exist.

  • Testers may only execute tests via a related job

    If checked, users in the role of Tester may only execute tests by executing a Job.

  • Testers may only resume their own test runs

    If checked, users in the role of Tester may only resume test runs they have started. If a test run has been started via a job, they can execute it only if the job is assigned to them. Templates for stating Reasons of Skipped Test Results

This table (initially empty) contains all defined templates for reasons for skipping test results. When skipping a test case during manual test execution, testers are asked for a reason for skipping the test case and can choose from those templates in addition to providing their own notes (see Section 8.4, “Permanently Skipping Test Cases”).

To create a new reason template, press the New button, which will insert a new entry into the table. To modify a reason template, press the icon, to remove it, press the icon.

The Edit Reason Popup

Figure 10.15. The Edit Reason Popup

10.4.4. Interface Settings

This tab contains settings which govern the behavior of the user interface in Klaros-Test­management.

The Interface Settings Tab

Figure 10.16. The Interface Settings Tab

The following settings can be controlled here:

  • Test Runner starts in tabular view

    If true the testrunner will per default show the tabluar view.

  • Show test case information during test execution

    If true, the test case detail information panel is always expanded per default when launching or executing tests.

  • Test step editing starts in the tabbed view mode

    If true, the default view in the Steps tab in the Test Case Details section will be the tabular view.

  • Rows per table page

    With this option, the number of rows per table page can be set.

  • Maximum preview image height

    This option sets the maximum height of the preview images of attachments during test case execution (see Figure 6.32, “An Attachment Reference replaced by a Preview of the Attachment”).

  • Maximum preview image width

    This option sets the maximum width of the preview images of attachments during test case execution (see Figure 6.32, “An Attachment Reference replaced by a Preview of the Attachment”).

  • Quote of the day

    The message to display on the login screen.

  • Use random quote of the day

    If true, a line from the file uploaded below will be displayed as the quote of the day.

  • Upload quotes

    This allows the user to upload a quotes file to be used for the random quote of the day. This should be a text file named quotes.txt with one quote per line. The details of the current quotes file are shown below, including a download link for the file itself, and a delete button, which causes the default quotes file to be restored.

    [Caution] Caution

    Please refer to Section 4.2, “Custom Quotes” for detailed information on the file format.

10.4.5. Languages

Klaros-Test­management supports the addition of custom languages. The available languages can be set in the Languages section of the system parameters section. The language settings page is shown in Figure 10.17, “The Languages Tab”.

The Languages Tab

Figure 10.17. The Languages Tab Enabling and Disabling Languages

Up to 5 languages can be enabled at once. Enabled languages are added to the language selection panel at the top of the screen in Klaros. To enable a language, click the icon in the Available Languages table and to disable a language, click the icon in the Enabled Languages table.

[Caution] Caution

Please refer to Section 4.1, “Languages” for detailed information on the file format.