Documentation - aqua cloud
🇬🇧 English
🇬🇧 English
  • 💻Web client
    • Getting started
    • General
      • Home page
      • App language
      • User account
      • Change password
      • Shortcuts & Accessibility
    • How to Contact Our Support
  • 👩‍🔧Administration
  • User administration
    • Adding and editing user profile
    • Roles and permissions
    • Assign, unassign or change licenses
      • Comparison of Licenses
    • Assign/unassign projects and roles
    • Licenses statistics
    • Statistics
  • Project configuration
    • [NEW] Project template configuration (fields)
      • Shared value sets
    • [OLD] Project template configuration (fields)
      • Shared value sets
      • Creating field groups
    • Field rules
    • [NEW] Workflow configuration
      • Global rules
      • Status and transitions
    • [OLD] Workflow configuration
    • Additional project settings
    • Project integrations
    • System log
    • Email notifications
      • Project default notifications
      • My notifications
      • Configuration of the project notification templates
      • Troubleshooting
  • Projects and folders
    • Project wizard
    • Projects
      • Export project
      • Import project
        • Migration from Testrail
      • Archive project
    • Folders
      • Export project folder
      • Import project folder
  • 🧩Modules
  • Navigation page
    • Project tree
    • Items grid
    • Filtering and grouping
    • Views
    • Search
    • Preview item details
  • Items
    • Requirements management
      • Requirements
      • Subrequirements
      • Requirements coverage
    • Test cases management
      • Test cases
      • Nested test cases (shared test cases/steps)
      • Manual testing
      • Test data or Variables manager
      • Test environment tracking with labels (tags)
      • Test execution results
      • Test automation
      • Capture: Test recorder/bug reporter
      • Test it: easy way to start run
      • Quick run: test execution of multiple test cases at once
    • Test scenarios management
      • Test scenarios
      • Adding test cases to a test scenario
      • Executing test scenarios
    • Defects management
      • Defects
      • Creating a defect from a test execution
      • Review found or linked defects to the test execution
      • Creating a defect with Capture
    • General item capabilities
      • Creating and Editing Items
      • Copy item to a target project or duplicate within a project
      • Taking over field values between items
      • Item template (defaults)
      • Dependencies
      • Add links to a description
      • Take screenshots
      • Watch item and notify other users
      • Attachments (files)
      • History of changes
      • Discussions (comments)
      • Print item data
  • Reporting
    • Creating a new report template
    • Basic report elements
    • Element tree structure
    • Element properties
    • Diagrams
    • Pivot table
    • 'Sum' function
    • Creating custom report script
    • Parametrization of reports
    • Exclude empty items from a report
    • Adding table of contents to a report
    • How to filter executions based on custom added fields?
  • Dashboards
    • Creating a dashbord
    • Publishing the dashboard
    • Creating a chart
    • KPI alerts
    • Drilldown to details from a chart
    • Burndown chart template
  • Agile
    • Backlog
    • Sprint board
    • Preview
  • 🖥️Desktop client
    • Getting started
      • Important notice: Deprecation of the desktop client in June 2025 [updated]
      • FAQ: Transitioning from the desktop client to the web Client
      • Desktop installation
      • Home screen configuration
      • Views
      • Grid
    • Agile board
      • Burn Down Chart
    • Dashboard
    • User Administration
      • Adding and managing users
      • Roles and permissions
      • Assigning licenses projects and roles
      • Statistics
    • Project configuration
      • Configuration of Fields and Workflows
      • Email Notification
      • Change company logo in printout
      • Import Project Configuration
    • Import / Export Wizard
    • Project Planner
      • Creating and editing a new project plan
      • Adding and syncing items to project plan
      • Resource planning
      • Gates and Stages
    • Requirements Management
      • Dependency
      • Subrequirements
      • Mind map
      • Comments
      • Documents
    • Test Management
      • Step Designer
      • Test Execution
        • Autosave of a test execution
      • Variable Manager
      • Nested Testcases
      • Disable manual test execution time
    • Test Scenarios
      • Test Scenarios
      • Scheduled Executions of Test Scenarios
      • Run Dependency
    • Defect Management
    • Reporting
      • Creating a Report
      • Creating a new report template
      • The Report Wizard
      • Basic Report Elements
      • Element tree structure
      • Element Properties
      • Diagrams
      • Pivot Table
      • Sum Function
      • Script Development
      • Parametrization
      • Performance Improvements for Report Creation
      • Remove empty elements
      • Table of Contents
      • Invalid References
    • Agile Board
      • Configuring the Agile Component
      • Planning board
      • Scrum board
      • Burn Down Chart
    • Versioning
  • 💿Installation for on premise
    • System Requirements
      • Server
      • Desktop Client
      • Web Client
      • Agents
    • Server Installation
    • Server parameters
    • Web Client Installation
    • Getting Agents
    • Connection to MSSQL Database
    • Connection to Oracle Database 12.2c
    • Licenses
    • Monitoring
    • SSL-Configuration
    • Content Security Policy (CSP) Settings
  • 🪄AI Copilot
    • Transform your testing and project management with aqua's AI Copilot
    • Enable and manage AI Copilot options
    • Create documents with ease with AI Copilot
    • AI Copilot: generate a comprehensive description for the test cases in just one click
    • AI Copilot - create test cases out of requirements or based on context in seconds
      • Create test cases from the navigation page
      • Create test cases from a requirement
      • Create a test case from a test case page
    • Generate test data with AI Copilot
    • Generate test case based on a file
    • Generate test cases in BDD format
    • Generate test cases with AI Copilot using test design techniques
    • Create user stories, BDDs, or PRDs based on a file
    • Create multiple user stories or BDDs with AI Copilot
    • Split or convert requirements
    • AI Copilot chat
  • 🔗Integrations
    • Jira sync: synchronize items between aqua and Jira projects
      • Before you begin: key steps for synchronization
      • Sync configurator set up
        • Sync Configurator options
      • Log in to the Sync Configurator
      • Sync of the projects between aqua and Jira
      • Fields mapping
        • Supported default Jira fields
        • General aqua and Jira fields compatibility
        • Special compatibility for aqua and Jira fields
      • Additional settings
        • Allow mapping of only selected values and ignore other field values for the sync
        • Automatic creation and mapping of field values
      • Troubleshooting
      • Synchronisaton of subtasks with aqua
      • Formatting support
    • Azure Devops sync
    • Jira link: create and/or link Jira issues to aqua tickets
    • aqua4Jira plugin: Cover Jira issue with aqua test cases
      • Installation of the plugin
        • aqua4Jira Plugin - Now Compatible with Jira Data Center!
      • Configuration in Jira
      • Configuration in aqua
    • Automatic display of test cases or test scenarios in Jira tickets
    • Confluence integration
    • Capture: record tests or create comprehensive bug reports
    • Testlink: importer tool for migrating test cases to aqua
    • SSO
      • LDAP
      • SAML Configuration
        • Installation
        • Sample
  • 🌀Automation
    • Desktop Client
      • Creating an Automation Agent
      • Configure Automation
      • Ranorex
      • UFT
      • JMeter
      • SoapUI
      • Database
      • UnixShell
      • PowerShell
      • Automation Library
    • Web Client
      • Automation Agent
        • Creation & Configuration
        • Agent pools
        • Running task
      • Powershell
      • Unix Shell
      • Jenkins integration
      • Selenium
    • REST API
    • Automation: CI/CD tools and aqua REST API
      • Gitlab CI/CD: JAVA/Playwright
      • Gitlab CI/CD: TypeScript/Cypress
      • Gitlab CI/CD: TypeScript/Playwright
      • Gitlab CI/CD: TypeScript/Cypress/Cucumber
  • 🚀Product updates for on premise customers
    • Product updates
      • 25.47.0 - On Premise
      • 25.36.0 - On Premise
      • 25.31.0 - On Premise
      • 25.18.0 - On premise
      • 25.10.0 - On Premise
      • 24.135.0 - On Premise
      • 24.130.0 - On Premise
      • 24.126.0 - On Premise
      • 24.108.0 - On Premise
      • 24.101.0 - On Premise
      • 24.93.0 - On Premise
      • 24.83.0 - On Premise
      • 24.71.0 - On Premise
      • 24.53.0 - On Premise
      • 24.8.0 - On Premise
      • 23.140 - On Premise
      • 23.126.0 - On Premise
      • 23.102.0 - On Premise
      • 23.70.0 - On Premise
      • 23.22.0 - On Premise
      • 22.132.0 - On Premise
      • 22.123.0 - On Premise
    • Release Notes
      • 25.47.0 - On Premise
      • 25.36.0 - On Premise
      • 25.31.0 and 25.33.0 - On Premise
      • 25.26.0 - On Premise
      • 25.18.0 - On Premise
      • 25.10.0 - On Premise
      • 24.135.0 - On Premise
      • 24.130.0 - On Premise
      • 24.126.0 - On Premise
      • 24.114.0 - On Premise
      • 24.108.0 - On Premise
      • 24.101.0 - On Premise
      • 24.93.0 - On Premise
      • 24.83.0 - On Premise
      • 24.71.0 - On Premise
      • 24.53.0 - On Premise
      • 24.8.0 - On Premise
      • 23.140.0 - On Premise
      • 23.126.0 - On Premise
      • 23.102.0 - On Premise
      • 23.70.0 - On Premise
      • 23.22.0 - On Premise
      • 22.132.0 - On Premise
      • 22.123.0 - On Premise
  • 🚀Product updates for public and private clouds customers
    • Product updates
      • 25.47.0 - public and private cloud
      • 25.36.0 - public and private cloud
      • 25.33.0 - public and private cloud
      • 25.18.0 - public and private cloud
      • 25.10.0 - public and private cloud
      • 24.135 - public and private clouds
      • 24.130 - public and private clouds
      • 24.126.0 - public and private clouds
      • 24.108.0 - public and private clouds
      • 24.101.0 - public and private clouds
      • 24.93.0 - public and private clouds
      • 24.88.0 - public and private clouds
      • 24.83.0 - public and private clouds
      • 24.71.0 - public and private clouds
      • 24.63.0 - public and private clouds
      • 24.50.0 - public and private clouds
      • 24.33.0 - public and private clouds
      • 24.8.0 - public and private clouds
      • 23.140 - public and private clouds
      • 23.126.0 - public and private clouds
      • 23.107.0 - public and private clouds
      • 23.92.0 - public and private clouds
      • 23.70.0 - public and private clouds
      • 23.46.0 - public and private clouds 1/3
      • 23.46.0 - public and private clouds 2/3
      • 23.46.0 - public and private clouds 3/3
      • 23.22.0 - public and private clouds
      • 22.132.0 - public and private clouds
    • Release notes
      • 25.47.0 - public and private cloud
      • 25.36.0 - public and private cloud
      • 25.33.0 - public and private cloud
      • 25.31.0 - public and private cloud
      • 25.24.0 - public and private cloud
      • 25.18.0 - public and private cloud
      • 25.10.0 - public and private cloud
      • 24.135.0 - public and private clouds
      • 24.130 - public and private clouds
      • 24.126.0 - public and private clouds
      • 24.114.0 - public and private clouds
      • 24.108.0 - public and private clouds
      • 24.101.0 - public and private clouds
      • 24.93.0 - public and private clouds
      • 24.88.0 - public and private clouds
      • 24.83.0 - public and private clouds
      • 24.71.0 - public and private clouds
      • 24.63.0 - public and private clouds
      • 24.50.0 - public and private clouds
      • 24.33.0 - public and private clouds
      • 24.8.0 - public and private clouds
      • 23.140.0 - public and private clouds
      • 23.126.0 - public and private clouds
      • 23.107.0 - public and private clouds
      • 23.92.0 - public and private clouds
      • 23.70.0 - public and private clouds
      • 23.46.0 - public and private clouds
      • 23.22.0 - public and private clouds
      • 22.132.0 - public and private clouds
      • 22.123.0 - public and private clouds
    • 📢AQUA NEWS
      • 🔒 Rate Limits for Public Cloud Users
      • Preview of aqua's public API
      • aqua is now ISO 27001 certified and DORA Compliant
      • Upcoming changes to aqua API
      • AI Copilot launching for All public clouds users on January 27th!
  • 📹Capture
    • What is Capture?
    • Chrome extension installation
    • Capturing in Incognito mode
    • Using Capture with Edge
    • Capturing with video
      • Option to enable mic when capturing a screen and adding voice notes
      • Option to pause/resume while capturing the video
        • Masking sensitive information while capturing
    • Capturing with screenshot
    • Running a test execution
    • Last minute session replay
    • Masked inputs while creating captures
Powered by GitBook
On this page
  • Feature: Requirement traceability: Show test cases and test scenarios that cover the requirements
  • Feature: Show test cases in the backlog or create a Scrum board for test cases
  • Useful when:
  • Feature: Hide test cases with specific statuses in the backlog
  • Useful when:
  • Feature: Quick preview of items on backlog page and scrum board
  • Feature: Chrome extension Capture (ex. aqua Test Recorder): Option to use extension outside aqua
  • Improvement: New design of toast messages

Was this helpful?

  1. Product updates for on premise customers
  2. Product updates

22.123.0 - On Premise

Previous22.132.0 - On PremiseNextRelease Notes

Last updated 10 months ago

Was this helpful?

Guidelines

Version 22.123.0 Date: 20.12.2022

Feature: Requirement traceability: Show test cases and test scenarios that cover the requirements

Useful when:

  • You want to keep everything in one system instead of creating Excel files or managing your requirements and test cases in different tools.

  • You want to confirm that all requirements will be accounted for in the testing phase.

  • You need to see by which test cases or test scenarios the requirements are covered.

  • You want to evaluate by what number of test cases or test scenarios the requirements are covered and see if the number is suitable to move forward within the development process.

Guide

Step 1: Open the ‘Requirements’ navigation page.

Step 2: On the project ribbon, click the ‘Select columns’ button.

Step 3: Choose the ‘Covered by Test Cases’ or ‘Covered by Test Scenarios’ option from the pop-up and drag it to the requirements grid.

Step 4: Once you add the column with test cases, you will see IDs of all test cases linked to the requirements. You will also see the tooltip with a title upon hovering on the test case ID, so you can instantly understand what test case is linked to the requirement.

Step 5: Once you add the column with test scenarios, you will see the IDs of all test scenarios linked to the requirements. You will also see the tooltip with a title upon hovering on the test scenario ID.

Step 6: If you have more than 20 linked test cases, there will be the ‘View test cases’ button instead of the IDs. When hovering on the button, you can see the number of linked test cases

Step 7: When you press the ‘View all test cases’ button, the ‘Dependency’ mode will be activated so you can check all linked test cases.

Feature: Show test cases in the backlog or create a Scrum board for test cases

Useful when:

  • You use aqua only for test cases management.

  • You want to have a clear prioritisation workflow and keep your QA team focused.

  • You want to organise work in sprints for QA specialists.

  • You don’t want to use multiple tools for managing QA and dev teams.

Guide

Step 1: Navigate to the ‘Agile’ tab

Step 2: Enable ‘Test cases’ to display items in the backlog alongside other item types.

Step 3: If you want to create a board exclusively for the QA team, start by creating a new sprint.

Step 4: Enable ‘Test cases’ on the board of the new sprint.

Step 5: Navigate to the backlog, select the test cases and drag them to the created sprint. You can instead right-click the test cases and select from the context menu to which sprint you want to move items.

Step 6: Drag and drop items between the columns or re-prioritise them within the column if needed.

Feature: Hide test cases with specific statuses in the backlog

Useful when:

  • You want to simplify backlog management for the QA team.

  • You want to keep your backlog clean and transparent for QA engineers.

  • You don’t want other teammates to see test cases in the backlog until you finish your part of the work.

Guide

Step 1: Navigate to ‘Project settings’.

Step 2: Select ‘Agile’.

Step 3: Click on the checkbox next to the status of the item which you don’t want to show in the backlog.

Step 4: Click the ‘Save’ button to apply the changes to the settings.

Note:

  • This setting doesn’t hide columns from the Scrum board. If you move an item to a status you marked to hide in the backlog, the item will still be visible on the Scrum board.

  • Once you remove the item from the sprint, however, it won’t be visible in the backlog anymore. You can still find the test case in the ‘Navigation’ tab.

Feature: Quick preview of items on backlog page and scrum board

Useful when:

  • You need to quickly check the content of the item

  • You want to swiftly look through ticket details to understand whether this it is the issue you are looking for

  • You need to see more details about the ticket that is added to the board or backlog page

Guide:

Step 1: Navigate to the backlog page and press the space bar or click the preview icon.

Step 2: Once the preview panel appears, navigate between the items, and you will instantly see the content of the item on the panel.

Step 3: If you need to view more than just fields, you can hover over the panel and scroll within it to see the description too.

Step 4: In case you need to open the ticket to check comments or dependencies, simply click on the expand icon and the item opens in a separate tab.

Step 5: If you would like to share the ticket with your colleague, click on the link icon and the URL will be automatically copied to your clipboard.

Step 6: When you want to close the preview, just press the spacebar again or click on the preview icon.

Step 7: On the scrum board, open preview the same way by clicking the preview icon or pressing the spacebar. You can switch between the tickets on the board and view the content just the way you can do it on the backlog page.

Notes:

  • When activating the preview, it will always show the last previewed ticket.

  • Preview is enabled/disabled separately for backlog page and scrum board.

  • The preview option is not available on the navigation page yet.

Feature: Chrome extension Capture (ex. aqua Test Recorder): Option to use extension outside aqua

Useful when:

  • You need a tool to record videos and annotate screenshots that provides visual proof and steps to reproduce the defects

  • You want to give more context for your developers to fix the defect faster

  • You are looking for a powerful tool that can work with aqua and can also be utilised outside the system

Guide:

Notes:

  • The process of starting the execution and recording is simplified. The test execution page doesn’t have the input field anymore: it was moved to the extension.

  • The new version of the extension is compatible with aqua version 22.123 and higher.

  • You need to update the extension to have new capabilities

Type in your browser:

  • chrome://extensions/

  • Find aqua Test recorder extension

  • Click the ‘Remove’ button

Guidelines:

Step 1: Install or update the Capture extension.

Step 2: Pin it to the toolbar of Chrome extensions to always have quick access to Capture.

Step 3: Open a test case and start execution. Click the ‘Capture’ icon on the Chrome toolbar.

Step 4: Insert a link to a web app or website you want to test and click the ‘Run a session’ button.

Step 5: The page or web app will open in a separate tab, and you can proceed with testing as before. All data will be automatically passed to aqua.

Step 6: You can add videos to your test execution if you want to demonstrate what exactly was done or show what actions need to be performed to reproduce the defect. Click the ‘Record a video’ button and select what you want to record. You can choose between the entire screen, an app or a Chrome tab.

Step 7: Perform the actions the way you do it during the regular test run. Once you are done, click the ‘Stop’ icon or the ‘Stop sharing’ button.

Step 8: Preview the recorded video.

Step 8: If you are happy with the recorded video, click the ‘Set to aqua’ button and the video with the steps and additional information will be added automatically to aqua.

Notes:

  • When clicking on a screenshot option while you are at the test execution tab, it will take a screenshot of the current page. If you want to take a snapshot of a screen or capture the screen area of another page, you can navigate to that page and click the corresponding option on the extension. You will still need to download the image and upload it to aqua.

The screenshot feature will be improved within next iterations.

Step 9: You can use the extension outside of aqua whenever you need to record a video or take a screenshot.

You can add the media to aqua requirements or defects as files or upload it to any system you use.

Anytime you want to create a video or do a snapshot, just click the ‘Capture’ icon and start recording.

Step 10: Once you finish the recording, just click the ‘Save’ button and the video or screenshot will be saved to your desktop.

Improvement: New design of toast messages

Every release, we do small changes and improvements to make aqua’s UI/UX better. We heard your feedback on toast messages, so we made them smoother.

From now on, all toast messages will appear in the bottom right corner of the app and stay for 10 seconds before disappearing. The new approach is a less intrusive and more subtle way of displaying the information.

It gives you more freedom to interact with the app and prevents frustrating situations where you are interrupted during an important task by a pop-up. The new implementation raises your attention to an important even, but does not distract you from work.

aqua tip: If you haven’t used the extension before, Capture is a helpful tool to record video, automatically capture events, and make your QA visual in other ways. You can get Capture on or .

Go to and install Capture

We continue to make aqua beneficial and easy to use. The upcoming releases will bring both new powerful features and user experience improvements. We can’t wait to share them with you

🚀
🤚
Chrome Web Store
Github
Chrome Web Store