Feature Guidelines 23.70.0 - On Premise

Feature Guidelines 23.70.0 - On Premise


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:

We have an important note for those customers who don’t plan to install a new aqua version and currently show the aqua news page. Our team plans to shut down this service on 24th of July.

To enable the new aqua home page your Administrator needs to set the following keys in the aquaWebNG.config:
AQUA_HOME_NEWSPAGE_URL: https://app-homepage.aqua-cloud.io/
AQUA_HOME_NEWSPAGE_IS_WEBPAGE: true

If you show internal resources instead of aqua news page to continue it working, once you install a new aqua version, you need to change the key in the aquaWebNG.config 
from AQUA_HOME_HOMEPAGE_URL: https://customer-internal.example/ to 
AQUA_HOME_NEWSPAGE_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.


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 aqua wiki. 


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 the meantime, let us know if you have any questions or share feedback at support@aqua-cloud



    • Related Articles

    • Feature guidelines 24.8 - On Premise

      Guidelines Version 24.8 Date: 16.02.2024 aqua4Jira Plugin - Now Compatible with Jira Data Center! Useful when: You are migrating from Jira Server to Jira Data Center You already using Jira Data Center but couldn’t connect aqua4Jira Guide: If you are ...

    • Feature Guidelines 22.132.0 - On Premise

      Guidelines Version 22.132.0 Date: 30.01.2023 Feature: Disable internal aqua authentication when SAML, LDAP or oAuth is set up Useful when: You have custom security rules in your external authentication system and want to prevent a user from bypassing ...

    • Feature Guidelines 23.22.0 - On Premise

      Guidelines Version 23.22 Date: 23.03.2023 Improvement: Preserving the high resolution and clarity of images when saving a ticket Useful when: You add a lot of images to the tickets You change the size of the images quite often Guide: The upcoming ...

    • Feature Guidelines 22.123.0 - On Premise

      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 ...

    • Feature Guidelines 23.126.0 - On Premise

      Guidelines Version 23.126 Date: 18.10.2023 Empower Your Testing: Customized execution fields for tailored test case runs Useful when: You want to be flexible when it comes to running in agile environments where test cases may need to accommodate ...