Creating and Editing Items
New items, such as requirements, test cases, test scenarios or defects can be easily created using the New button in the upper left corner of the ribbon in the navigation module. The item will be created in the currently selected folder of the project browser.
The new item is then opened in a new tab and can be edited and saved there.
The following areas are included in all items:
1. Ribbon Bar
2. Details
3. Description
4. Navigation bar
5. Path
Ribbon Bar
In the ribbon bar you have a quick access to different actions and functions for the opened item. Changes are only forwarded to the aqua server when you save them. As long as no changes are made, the buttons
Save and
Save & Close are inactive. You can also save or save and close your changes at any time using the familiar
Shortcuts ctrl+s or ctrl+shift+s. With the
Copy Link button a link to the selected Item is copied to the clipboard and can then for example be sent by e-mail.
Print can be used to print all information about the element, such as the details, description, attachments, dependencies or even the history. The
Workflow Preview shows you the configured workflow, if one exists. The workflow shows which status states are possible and which transitions are allowed. The workflow itself is activated and configured in the
Workflow Configuration. In the
Notification area you can notify other users directly from the item or add yourself as a watcher. In the
Create Dependent Item area you can create other items with
Dependencies to this item. With the
Test It! button you can directly execute linked test cases for requirements and defects. Under
Help you will find a link to the aqua Wiki where you are automatically directed to the chapter relevant for the selected item.
Details
In the details, you can enter basic information about the item, such as the name, status or priority. The displayed fields are freely configurable for each item type in the Template Configuration of a project.
Field names can be altered, fields can be removed/added, default values and allowed value ranges can be defined and user-defined fields and field values can be added. The following field types can therefore be available: Selection fields, multiple selection fields, user fields, user multiple selection fields, date fields, number fields and text fields. With text fields you also have the possibility to add a link to a web page, which can then be opened directly from within the field. For this, you have to use the correct formatting, i.e. the link must start with 'http(s)://'. Mandatory fields are marked with an asterisk and must be filled in order to save the item. These mandatory fields are set in the Workflow Configuration. The name is always a required field. Some fields are also filled in automatically, such as the creator or the creation date. Each item automatically gets a unique ID (across all projects) after creation, starting with RQ (Requirement), TC (Testcase), TS (Testscenario), or DF (Defect). In addition, when you create a new item, you can define a Template that will be used when creating additional items.
As soon as you edit an item, this item is locked for further users. The users can still open the item but cannot edit it. As soon as the item is saved and closed, it can be edited by other users again. To facilitate the workflow, the user who has locked the item can be contacted directly from within aqua.
Description
In the Description you can specify and format the content of an item. You can create formatted texts, hyperlinks, tables, and graphics as well as copy and paste content from other documents (*.doc, docx, rft, txt). As soon as you click into the description field the Editor is displayed instead of the ribbon bar. If you want to return to the ribbon bar, just click on the tab to the left of the editor (Requirement, Test Case, Defect etc., named after the item type you are editing).
Here you can format the text and insert pictures and screenshots using the picture symbol or insert tables using the tables symbol. In the table properties you can easily edit the cell size, alignment, table format and other properties.
Screenshots can also easily be pasted from the clipboard via copy & paste.
Navigation Bar
Path
On the bottom of the opened element you can see the path the item is located as well as the aqua version. You can also move the item to another folder by clicking on the edit icon, selecting the desired folder and confirming with the check mark in the upper right corner.
