Klaros-Testmanagement User Manual

Selcuk Akgünlü

Caroline Albuquerque

Sabrina Gidley

Fabian Klaffke

Claudia Könnecke

Klaus Mandola

Patrick Reilly

Tobias Schmitt

Torsten Stolpmann

Heiner Westphal

verit Informationssysteme GmbH

Version 4.6.3

Legal Notice

March 29 2017

Abstract

This document serves as the reference documentation for the Klaros-Testmanagement application. It gives a detailed description of the user interface and the provided functionality.


Table of Contents

1. Key Features
1.1. Klaros-Testmanagement Community Edition Features
1.2. Klaros-Testmanagement Enterprise Edition Features
1.3. Klaros-Testmanagement Mobile Edition Features
2. Introduction
2.1. What is Klaros-Testmanagement
2.2. Test Cases - The Basis of Testing
2.3. Test Suites - Organizing Test Cases
2.4. Test Runs - Executed Tests with their Results
2.5. Test Environment and System under Test - Influences of Test Results
2.6. Iterations - Subdividing your project into phases
2.7. Requirements – Meeting Quality Standards
2.8. Jobs - Planning the test process
2.9. User Roles - Every User has his Rights
2.10. Overview of Artifacts
2.11. Issue Management Systems
3. Installation
3.1. License Model
3.1.1. License Model (Users)
3.1.2. License Model (Mobile Devices)
3.2. Prerequisites
3.2.1. Client Prerequisites
3.2.2. Server Prerequisites
3.3. Installation Process
3.3.1. Step 1: Welcome
3.3.2. Step 2: Information
3.3.3. Step 3: Licensing Agreements
3.3.4. Step 4: Target Path
3.3.5. Step 5: Select Installation Packages
3.3.6. Step 6: User Data
3.3.7. Step 7: Installation
3.3.8. Step 8: Perform External Processes
3.3.9. Step 9: Setup Shortcuts
3.3.10. Step 10: Installation Finished
3.4. Console based installation
3.4.1. Step 1: Welcome
3.4.2. Step 2: Information
3.4.3. Step 3: Licensing Agreements
3.4.4. Step 4: Target Path
3.4.5. Step 5: Select Installation Packages
3.4.6. Step 6: User Data
3.4.7. Step 7: Installation
3.4.8. Step 8: Perform External Processes
3.4.9. Step 9: Setup Shortcuts
3.4.10. Step 10: Installation Finished
3.5. Automated Installation Script
3.6. Update Process
3.6.1. Incompatible Installation Detected
3.6.2. Manual Changes
3.6.3. Database Migration
3.7. Important File Locations
3.7.1. Log Files
3.7.2. The Hibernate Properties File
3.7.3. Language Files
3.7.4. The Quotes File
3.7.5. The Derby Database
3.7.6. The Attachment Repository
3.8. Running Klaros-Testmanagement
3.9. Changing the Default Database
3.10. Installing Klaros-Testmanagement as a Service
3.10.1. Installing Klaros-Testmanagement as a Linux service
3.10.2. Installing Klaros-Testmanagement as a Windows service
3.11. Monitoring Klaros-Testmanagement
3.12. Configuring External Issue Management Systems
3.12.1. JIRA Configuration
3.12.2. Redmine Configuration
3.12.3. Trac Server Configuration
3.13. SSL Support
3.14. Uninstall
4. Customization
4.1. Languages
4.1.1. Defining Language Files
4.2. Custom Quotes
5. Functional Overview
5.1. Login
5.1.1. LDAP Login
5.2. Main Functions
5.2.1. The Help Menu
5.2.2. The User Menu
5.2.3. Search / Quick-Select
5.2.4. The Log Panel
5.2.5. Filtering and Sorting
5.2.6. Print Pages
5.2.7. Categorization
5.2.8. Conflict Handling
5.2.9. Deleting Objects
5.2.10. Bulk Actions
5.2.11. Attachments
5.2.12. User Defined Properties
5.2.13. Referencing User Defined Properties
5.2.14. Referencing Attachments
5.2.15. Revisions
5.2.16. Related Test Runs and Results
5.2.17. Change History
5.2.18. Overview Tabs
6. Define
6.1. Projects
6.1.1. Creating a Project
6.1.2. Deleting a Project
6.1.3. Restoring a Project
6.1.4. Purging a Project
6.1.5. Editing the Description of a Project
6.1.6. Project Details
6.2. Iterations
6.2.1. Bulk Actions
6.2.2. Creating an Iteration
6.2.3. Iteration Details
6.3. Requirements
6.3.1. Remote Requirements Management System Synchronization
6.3.2. Bulk Actions
6.3.3. Creating a Requirement
6.3.4. Requirement Details
6.4. Test Environments
6.4.1. Bulk Actions
6.4.2. Creating a Test Environment
6.4.3. Test Environment Details
6.5. Systems under Test
6.5.1. Creating a System under Test
6.5.2. Bulk Actions
6.5.3. System under Test Details
6.6. Test Cases
6.6.1. Bulk Actions
6.6.2. Creating Test Cases
6.6.3. Test Case Details
6.7. Test Suites
6.7.1. Bulk Actions
6.7.2. Create Test Suites
6.7.3. Test Suite Details
7. Plan
7.1. Maintain Jobs
7.1.1. Bulk Actions
7.1.2. Creating Jobs
7.1.3. Arranging Jobs
7.1.4. Executing a Job
7.1.5. Job Details
7.2. Jobs from Test Cases
7.3. Jobs from Test Suites
7.4. Jobs by User
7.4.1. Jobs by User - Details
8. Execute
8.1. My Jobs
8.2. Run Test Case
8.2.1. Executing a Single Test Case
8.3. Run Test Suite
8.3.1. Executing a Test Suite
8.4. Permanently Skipping Test Cases
8.5. Continue Test Run
8.5.1. Continuing a Suspended Test Run
8.6. Import Test Results
8.7. Creating Issues
8.8. Creating Review Jobs
9. Evaluate
9.1. Dashboard
9.1.1. The Overview Reports
9.1.2. The Dashboard Reports
9.2. Report Templates
9.3. Test Run History Report
9.4. Test Runs
9.4.1. The Test Run Report
9.5. Test Case Results
9.5.1. Single Test Case Results
9.6. Test Suite Results
9.6.1. Single Test Suite Results
9.7. Viewing Reasons of Skipped Test Cases
9.8. Issues
9.8.1. Issues by Test Case
9.8.2. Issue Details (Creating a new Issue)
9.8.3. Link Issues
9.9. Bookmarking Results
10. Configure
10.1. Overview
10.2. Report Templates
10.2.1. Report Details
10.3. Users
10.3.1. Creating a User
10.3.2. Deleting a User
10.3.3. User Details
10.4. Mobile Devices
10.4.1. Mobile Device Details
10.5. System
10.5.1. Miscellaneous Settings
10.5.2. Notification Settings
10.5.3. Test Execution
10.5.4. Interface Settings
10.5.5. Languages
10.6. Integration
10.6.1. Issue Management
10.6.2. Requirements Management
10.6.3. E-Mail
10.6.4. Network
10.6.5. LDAP
10.7. Backup
10.7.1. Export
10.7.2. Import
11. Custom Reports
11.1. Create A New Report Template
11.1.1. Supported Parameter Types
11.1.2. Dealing with Parameters
11.2. Applying a Report Template
11.3. Example Report
11.3.1. Creating the Groovy Script
11.3.2. Creating a SeamPDF Report Template
11.3.3. Creating a Chart
11.3.4. Including Images
11.3.5. Creating a SeamExcel Report Template
12. Import/Export
12.1. Importing Test Cases from Excel
12.1.1. Import Format
12.1.2. Prerequisites
12.1.3. Execution
12.2. Importing Test Cases from XML
12.2.1. Prerequisites
12.2.2. Execution
12.3. Importing Requirements from Excel
12.3.1. Import Format
12.3.2. Prerequisites
12.3.3. Execution
12.4. Importing and Synchronizing Requirements from XML
12.4.1. Prerequisites
12.4.2. Importing
12.4.3. Synchronizing
12.5. Importing Test Results
12.5.1. Prerequisites
12.5.2. Execution
12.6. Exporting Table Content to Excel
12.7. Backup/Recovery
13. The Klaros-Testmanagement Remote API
13.1. Overview
13.2. REST Clients
13.3. Documentation
Glossary
A. Role Permission Overview
B. Model API Reference
B.1. API-Reference
B.1.1. de.verit.klaros.core.model
B.1.2. Deprecated API
B.2. Scripting API-Reference
B.2.1. de.verit.klaros.scripting
B.2.2. de.verit.klaros.scripting.context
B.2.3. de.verit.klaros.scripting.custom
B.2.4. de.verit.klaros.scripting.model
B.2.5. Constant field values
C. Test Case Import File Specification
C.1. <step>
C.2. <steps>
C.3. <attribute>
C.4. <attributes>
C.5. <container>
C.6. <testcases>
C.7. <testcase>
C.8. <triggers>
C.9. <testsuite>
C.10. <externalId>
C.11. <externalRevision>
C.12. <trigger>
C.13. <areatopic>
C.14. <depends>
C.15. <description>
C.16. <docbase>
C.17. <evaluation>
C.18. <execution>
C.19. <expectedResult>
C.20. <level>
C.21. <method>
C.22. <note>
C.23. <postcondition>
C.24. <precondition>
C.25. <revision>
C.26. <priority>
C.27. <shortname>
C.28. <state>
C.29. <team>
C.30. <traceability>
C.31. <variety>
C.32. <name>
C.33. <value>
D. Requirement Import File Specification
D.1. <attribute>
D.2. <attributes>
D.3. <container>
D.4. <requirements>
D.5. <requirement>
D.6. <triggers>
D.7. <externalId>
D.8. <externalRevision>
D.9. <trigger>
D.10. <description>
D.11. <priority>
D.12. <revision>
D.13. <shortname>
D.14. <summary>
D.15. <name>
D.16. <value>
E. Reporting Resources
E.1. Context Variables
E.2. KlarosScript Interface
E.3. Example report template
Index