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.56.0 - On Premise
      • 25.52.0 - On Premise
      • 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.56.0 - On premise
      • 25.52.0 - On premise
      • 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.56.0 - public and private cloud
      • 25.52.0 - public and private cloud
      • 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.56.0 - public and private cloud
      • 25.52.0 - public and private cloud
      • 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
      • Upcoming new storage options for On-premise deployments
      • 🔒 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
  • New aqua home page
  • New UI: Redesigned Navigation page
  • Quick actions panel
  • New search module
  • Filtering
  • Grid and columns
  • Show Archived and Subfolders
  • Views
  • Preview details of the item
  • Open item via clicking on the title or the ‘Open’ button
  • Jira | Improved flows for connecting Jira issues with aqua test executions and aqua items
  • Ranorex | Handle links in project to external files in Ranorex scripts

Was this helpful?

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

23.70.0 - On Premise

Previous23.102.0 - On PremiseNext23.22.0 - On Premise

Last updated 1 year ago

Was this helpful?

Guidelines

Version 23.70 Date: 10.07.2023

New aqua home page

With the new aqua home page, you can get much easier access to all aqua offerings, partners and products. You can also find documentation or contact our customer support here. What needs to be done to configure it:

If you show internal resources instead of aqua news page please ensure that you have added in the aquaWebNG.config file the following key including your custom URL: i.e. AQUA_HOME_HOMEPAGE_URL: https://customer-internal.example/

If you show the aqua news page, then once you install the new version of aqua, no special actions are required from your side. The new page will be shown automatically.

New UI: Redesigned Navigation page

Quick actions panel

Useful when:

  • You need an easy access to the most frequently used options

  • You want to know what item you are creating and on what tab you are right now

Guide:

To create a new item, folder or project, hover over the button and select one of the available options from the dropdown menu.

Alternatively, you can navigate to any of the item type tabs, and clicking the New button there will automatically create an item of the same type. This means that you can create new items with minimal clicks, saving you valuable time and effort.

To copy a link or modify an item, select one or more items on the grid, and click on one of the available quick actions.

For even more options, head over to the 3-dot menu or use the context menu.

If you want to see changes in the last few seconds or see the latest test execution, click on the Refresh button to update the grid.

New search module

Useful when:

  • You want to search for specific information within the project

  • You need to see all items that contain key words in one go

  • You want to filter items that meet the search criteria and show them on the grid

Guide:

To search for an item at the project level, enter a keyword into the search box and press the Enter key. By default, the system will begin searching for items that meet the specified criteria within the project. If you wish to search for tickets within a specific item type, you may select that type from the dropdown menu prior to initiating the search. Similarly, if you wish to filter results that are of the specific item type, you may select it from the dropdown after results for all types of items have been returned.

Once the items are found, you can open one of them from the pop up by clicking on the title. If you want to check a group of items and apply the filtering next, then click on Show on the grid and the items will be filtered and displayed.

To reset the list on the navigation screen, simply clear the search box by clicking on the cross. For your convenience, we also added a shortcut to trigger search and added 5 recent searched words, making it easier for you to find items in no time.

Filtering

Useful when:

  • You want to see what filters are applied to the grid

  • You need to granulary change the applied filtering

  • You want to apply filtering and then create a custom view

Guide:

In the old version of aqua, filters were located on the ribbon in the Item grid group. But in the latest version, we've moved filters to a separate group closer to the grid. This makes it more convenient for you to view subsets of the information displayed.

To view a subset of the information that is currently displayed, click on the Filter button and select one of the available options.

Select the Filter row option to display items that meet specific criteria for a given column or use Add filter for more advanced filtering scenarios.

Once you applied a filter, all the criteria you had selected will be displayed at the top of the grid, making it easy for you to see what filters are active.

If you need to remove a filter, simply click on the 'x' next to the filter label. The other filters will remain active.

Grid and columns

Useful when:

  • You want to see what columns are active before you modify the grid

  • You need a quick access to the column picker to add additional options to the grid via a shortcut

Guide:

In the old version of aqua, you had the option to add a column or reset to default the grid view only from the ribbon.

Now, these features are easily accessible from the Views section, making customisation even more straightforward!

To customise the grid view, for example add or hide columns, simply click on the Views button. From there, you can quickly customise your grid. At the top of the panel, you'll find a group of default columns along with any custom columns you've added.

To add a specific column, click on the plus button or use a shortcut to enable the column picker. Besides, the old column picker can be called with a shortcut even when the panel is closed. If you want to return the initial look and feel of the grid, click on ‘Reset to default’.

To hide the column, click the corresponding label. It will be removed from the grid.

Note: Default column labels are always visible on the panel, while custom columns’ labels are hidden from it once you disable them.

Show Archived and Subfolders

Guide:

These two options are now part of the Views as well.

If you want to view archived items, folders or projects, click on the toggler to display them.You will need a similar toggle to show/hide items from the subfolders on the grid view when a project is selected.

Views

Useful when:

  • You want to customise your grid view and create a personalised layout that works for you and your team's needs.

  • You need to organise and quickly access information within the grid view, making it easier to work more efficiently.

  • You want to collaborate with team members by sharing your views, making it simpler to work together on projects.

Guide: Views have become easier to create, use and modify. They moved from the ribbon to the panel, too.

To add a new view, simply enable the 'View' panel above the grid and click on the Add view button. Provide a title, colour, and description, and specify what you want to display. Once you save the view, it will automatically be applied to your grid.

Your newly created view can be found under My views, where you can easily modify or make it public, so that other team members within your project will be able to use this view but not modify it.

Preview details of the item

Useful when:

  • You want to see the context for the item

  • You need to quickly preview details or items related to the ticket

  • You want to see linked items and the details of a ticket in a tree view

Guide:

The options to see different types of the item details are moved to the item preview block. When you need to preview specific information, click on the item and then switch between the tabs below.

To preview related items in a different mode, click on the dependency and then pick the needed view. Graph view is set by default to quickly see high-level information. In case you want to check in more details linked defects, test scenarios or Jira issues, switch to the Tree view by clicking on the corresponding item.

aqua tip: If you want to add more columns to the dependency tree view, navigate to the item and add the column. It will be automatically added to the preview.

Open item via clicking on the title or the ‘Open’ button

Guide:

To open the item which you would like to check more deeply, simply click on the title or click the Open button on the preview page block.

Save and Run buttons in Step Designer

Useful when:

  • You want to quickly save the changes to the test case without leaving the tab

  • You want to start executing a test case from the step designer page once you created ticket or modified it

Guide:

Create a new or open an existing test case, then make some changes to it. Without leaving the step designer tab, save the recent changes.

Once the edits are saved, you can launch execution by clicking the Run button right from the step designer tab.

Jira | Improved flows for connecting Jira issues with aqua test executions and aqua items

Useful when:

  • You want to connect an already existing Jira issue to the test execution

  • You want to create a Jira issue from aqua item and add it as a dependency

  • You want to connect multiple Jira issues at once to aqua test execution or aqua items

Guide:

To connect existing Jira issues to aqua tickets, you need to set up the integration with Jira first. Follow this guide to get started in less than 5 minutes. Once the integration is in place, open the desired aqua item, navigate to the ‘Dependencies’ tab, and then click the ‘Connect Jira issue’ button.

When the popup opens, provide the IDs of the Jira issues (separated by commas) and then click the ‘Connect’ button.

All referenced issues will be linked to the target aqua item.

Please note, there is a limit of 10 IDs that you can provide at once. You will be able to link more items by going through the same steps again.

In case you want to create a new Jira issue and link it to the aqua item, just click the ‘New issue’ button and, once you save it on the Jira side, go back to aqua and provide the ID. You can use the same flow to connect multiple existing or new Jira issues to aqua’s test executions. Just click the same ‘Connect Jira issue’ button on the test execution or test execution details page.

Ranorex | Handle links in project to external files in Ranorex scripts

Useful when:

  • You want to link to external files in your project in Ranorex scripts

Guide:

In Ranorex Studio, open the desired project and navigate to the script's subfolder. Then right-click the subfolder and select the ‘Add’ option.

From the context menu, pick ‘Existing item’ and, once you select the file, click the ‘Link’ button.

Please note: when you link external files to multiple projects, you need to remember that it’s now dependent on the linked files that are not managed by aqua. As a user, you need to make sure that these files are located in the same place where they were originally linked from.

For example, if you developed the script on machine A, the linked file must be accessible in the exact same location on machine B in order to run the script there. aqua only establishes the link to the file and doesn't handle actual access to the file.

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

In case you don’t have these feature guidelines at hand in the future, we got you covered. You can find all the information on the new features in our

In the meantime, let us know if you have any questions or share feedback at support@aqua-cloud

🚀
🤚
aqua wiki
.