Template configuration
Every aqua project implements a template which defines the configuration of the project. By editing the template, you can customize the layout and the dialog fields for the following items: defects, requirements, test cases, test scenarios and scripts. There are two types of fields - predefined fields and custom fields. Predefined fields are configured by default and can only be partially customized by the aqua users. Custom fields can be added when additional fields are required for an individual configuration.
General configuration of Fields
Select your project in the project browser and click on the configuration menu in the upper left corner of the aqua header 
. In the Project Configuration area, select the Template entry.
. In the Project Configuration area, select the Template entry.
A list with all item fields appears. In the bar on the bottom you can choose, for which item type you want to edit the fields.
When you select a field from the list, you can change different properties depending on the field type, such as field name or field values. Clicking the dot to the left of the field name adds (green dot) or removes (red dot) a field from the selected fields. Only the selected fields are visible in the layout.
By pressing the 
button, you can move fields in the list. This will also move the fields in the items. With Column Span you can define how much space a field takes up in the layout and with Start new line you can define that this field is at the first position in the layout in the respective row. If you would like to get a preview of the changes, press 
.
button, you can move fields in the list. This will also move the fields in the items. With Column Span you can define how much space a field takes up in the layout and with Start new line you can define that this field is at the first position in the layout in the respective row. If you would like to get a preview of the changes, press .Configuration of predefined fields
Predefined fields are automatically available in every project configuration and cannot be deleted. However, they can be removed from the view or added to the view as described above. In addition, the name can be changed for all predefined fields. The original name is still shown in the field list in brackets. The type of the predefined fields cannot be changed, but they can be partially customized; in particular, the field values for bulleted fields can always be changed, added or deleted (e.g. in the Status field). In addition, some predefined fields have special features, which are summarized in the following table:
Field name | Type | Special Feature |
Name | Text | Always displayed in the first line of the layout. |
Id | Id field | Is automatically generated when the item is created, is unique across all projects on a server and cannot be edited. |
Status | Enumeration | This field is linked to the workflow. The possible status values can be configured in the template configuration. The permitted status transitions and restrictions can then be defined in the workflow configuration. |
Owner | User | Is automatically filled with the current user during item creation and cannot be edited. |
Last Editor | User | Is automatically filled with the current user when there is a change to the element and cannot be edited. |
Assigned to | User | This field is linked to the following notification settings: - Assign an item to me - Changes in items that are assigned to me |
Date created | Date/ Time | Is automatically filled with the current date and time at item creation and cannot be edited. |
Last modified | Date/ Time | Is automatically filled with the current date and time when the item is changed and cannot be edited. |
Implemented in | Text (Auto complete) | This is a text field, which also remembers all previously entered values and provides them as a selection list. Only used for requirements and defects. |
Found Version | Text (Auto complete) | This is a text field, which also remembers all previously entered values and provides them as a selection list. Only used for defects. |
Valid for | Text (Auto complete) | This is a text field, which also remembers all previously entered values and provides them as a selection list. Only used for test cases and test scenarios. |
Progress | Decimal Number | In this field, the progress of an element can be tracked between 0% and 100% using a slider. |
Sprint | Sprint | This field shows sprints that were created in the agile module in the desktop client. |
Points | Decimal Number | In this field, points can be assigned to estimate the effort in agile projects. These are then also used in the agile module in the desktop client for the progress display in the burn-down diagram. |
Configuration of custom fields
To add a new custom field, click on Add custom field in the ribbon bar. You can then select the field type and choose between the following types:
Type | Maximum number of fields of this type | Description | Example |
String: | 35 | Used for short text values. | Name, note, link to website |
Decimal: | 20 | Used for number values. | Points, euros, business values |
Date: | 20 | Used for calendar dates and time. | Date the defect was fixed, date until the test case should be executed |
Dictionary (single selection): | 25 | Allows choosing one value from a list with predefined values. | Version, priority, significance |
Dictionary (multi selection): | 10 | Allows choosing multiple values from a list with predefined values. | Affected system, requested customer |
User (single selection): | 20 | Allows choosing one user from a list with the existing users of the project. | Mainly responsible user, project manager |
User (multi selection): | 5 | Allows choosing multiple users from a list with the existing users of the project. | Team members |
Rich Text Field | 5 | Used for rich text, such as comments, descriptions and pictures. | comments |
If you choose one of these types, a field is created and you can choose the settings for this field. Then you can add the field to the selected fields by clicking on the red dot. You can then move fields in the list as described above. User-defined fields can also be removed by deleting them.
Modifying fields in a live project
If you make changes to the project configuration in a running project, this can affect the existing items. If the layout is modified and fields are moved, the new layout is applied to both new and existing items. Therefore, if you remove fields from the view (click on the green dot), the field will not be displayed in any existing items. However, the information stored in this field (e.g. the selection value of a selection field) remains in the database and is displayed accordingly when the field is added to the view again. However, if you delete a field, this field is also deleted from all existing items, including the data stored in this field.
If you change the order of the selection values in selection fields or add new selection values, this will be displayed in both new and existing items. No existing entries will get lost or modified by these changes. If you rename values from a selection field, however, this renaming will be implemented directly in all existing items, i.e. if you change the priority from "high" to "1 - High" in a live project, "1 - High" will now be displayed directly in all items for which "high" was selected.
If you delete a value from a selection field in the project configuration, this value is no longer displayed as a selection in new items, but is not deleted from existing items. The deleted value is therefore still displayed in existing items where it was selected. When you then open the selection field, this value is highlighted in red to show that it no longer exists and you can simply select one of the existing selection values and track this change in the history.
Before deleting fields or selection values for items where these selection values are used, it is recommended to set the desired new selection values via a batch update or if necessary fill out new fields that are to replace the old fields. One quick way to do this, is to filter for the desired items and select them with Ctrl+a and perform the desired batch update.
Related Articles
Workflow Configuration
In aqua you can define a workflow for each item type. To configure a workflow, select your project in the project browser and click on the configuration menu in the upper left corner of the aqua header . In the project configuration area select the ...Creating a new report template
To create a new report it is important to decide which data you want to use as a basis. You can decide to base your report on requirements, test cases, test scenarios, or defects. The layout designer will not be affected by your choice, only the ...Configuration of Fields and Workflows (Rich Client)
In this chapter you will learn more about the configuration of data fields for your aqua projects. You will receive information how to set the position of fields in the layout designer, how to configure workflows, and how to configure restrictions. ...Creating a new report template
To create a new report it is important to decide which data you want to use as a basis. You can decide to base your report on requirements, test cases, test scenarios, or defects. The layout designer will not be affected by your choice, only the ...SSL-Configuration
In order to enable a connection via SSL between aqua Rich Client and aqua Server, the aqua Server requires some additional configuration and an appropriate SSL-certificate. 1. Log In to your aqua Server 2. Open IIS Management Console 3. Select ...