# 23.102.0 - On Premise

Guidelines

Version  23.102\
Date: 07.09.2023

## Linked Jira Issues in Reports: Know more! <a href="#linked_jira_issues_in_reports_know_more" id="linked_jira_issues_in_reports_know_more"></a>

\
Useful when:

* You are using aqua and Jira and want to create a comprehensive report for your stakeholders to provide update on the project's status
* You need to see Jira issues in the reports after test runs are done for the audit purposes

Guide:\
\
Navigate to the ‘Reports’ page and either select the report you want to modify or create a new one.

Then, at the ‘Edit properties’ step, select when you want the Jira issue to be loaded

<figure><img src="https://lh5.googleusercontent.com/L7TFigmK3V9bnUjWZgEvgDwSaejI84R-i9WmN8kTJ82PO5j5P2TVwtCTx8-7jlOKeP4hzOFUEyGZBqUp39WZPwKpsRrWVGPlOqnl3XvQg8pF4b_iWCGiEGTBCk7A7YX51SxoCr0xOmL4V-cu07Z7qJs" alt=""><figcaption></figcaption></figure>

Go back to the layout step, navigate to the following group, and add the label to your layout.&#x20;

<figure><img src="https://lh6.googleusercontent.com/vGrsi465Egn_I5zezhYdWKQXegBb5lrwFIuVq9JdfeatP6ttKY9bz794t6hUCK0ec9ATaCZ_myfhx_iBiJDUTppr76h_ivINGGY2PamINSUkszkAe89C-AyhDbsK8hGMErW0iijQ1ik_2dh5dsCQJ-0" alt=""><figcaption></figcaption></figure>

You can also reference a link to the Jira issue. To do so, click on the added label and once the expression sidebar opens, click on the 3-dot menu next to the ‘Navigation URL’ field.

<figure><img src="https://lh5.googleusercontent.com/35bWj7tWdvVMWw1sURXej18oBh2WYxihKKCbqRNSZ4jJliD9LyF3LUMtUNH8hVkCl4Nud4Evjo17CU1MdpDt1CbUYQMsXDiLWz33HJ74UnGWc_MU5rSQ714LlmgN_vIsmcdPg19HJjkcLcs2GAMUjBY" alt=""><figcaption></figcaption></figure>

Add your base Jira URL to the issues, with apostrophes before and after the URL.  Then, add plus and navigate to the `‘Fields’` section, expand '`RelatedJiraIssues’` and doubleclick on `‘TargetId’,` and save the report.<br>

Once you generate the report, there will be a link to the Jira issue that is linked with your aqua test case or any other item you referenced in the report.&#x20;

<figure><img src="https://lh5.googleusercontent.com/VwVbQPF7P5eYEskW26sCuiwjHrdokoGw--fLO0LHHhYz6jOwHPpHepIYQ4QzJbd5i11Fy8gcTRzMnyAxZBLiCOLDCq1BiTTrs3rZlw-rKQe5oUdrS6k0qILiNafXhrzO7cu1ouPfuqW_noRRN2qVAXo" alt=""><figcaption></figcaption></figure>

If you want to include multiple Jira issues, click on the ‘DetailReport \[itemtype] section when creating the report.&#x20;

<figure><img src="https://lh3.googleusercontent.com/JdPVktnTvjyXiDmOplrJWx5lXp2q7Zkpk1-eHeA2YvEL8UQZaloWm-xPO5OCUT-Ip_XRk7VUcyunwYUURajB_bdRNjzPPI_6Rm78kLnyueOOmX88VVdnTjWND3h2KNP1rF7SaxWNjq9GXyZyo5Y-NAs" alt=""><figcaption></figcaption></figure>

On the ‘Properties’ sidebar under the ‘Actions’ group, click on the ‘Report Band’.

<figure><img src="https://lh4.googleusercontent.com/MOJ8DlR7voMBGRocc5zB1oxbqX_gQNOPZxs69jWK2Gulz6Km0GtNRBafrsq40xIblyXU0bsIyVaOOszw-045wz1CXIeJy7J1TtNvTKaStOOr1QufcLw1QBP9EhknrXnzRw1tmSGhzKqroLs3Vi6CBzE" alt=""><figcaption></figcaption></figure>

Once you do that, the new block will be added to the layout.&#x20;

<figure><img src="https://lh5.googleusercontent.com/OaGVQheCKaRoy_FsaNcbDK6rAZZY3-bPArW2O-ikDieLFG5aLR7VllyZRlw58A9lts6nPrSNAFnHTpramPOEFylG08K0jxZRcCprLBF6TM-5ph53MqzXPIELOt5scm7xBGgnuu8o8XyhMETVZNwv64g" alt=""><figcaption></figcaption></figure>

For ‘Data Source’, select the ‘Data’ property; for ‘Data Member’, select the ‘Related Jira issues‘ property.

Now, select ‘DetailReport1’ and drag and drop e.g. table to the page.

<figure><img src="https://lh6.googleusercontent.com/_6M6suOOkJYdYkEqWTP1IyyHKvdTwsOUeqI5PByE-0INd6vCJlsQbYFwDhOBeqsKimAZkanpxlWF9UpsKABORarzLc4CoT7et2hF98WapTYT9QpyU-h245bH0J-YuCItqG3IY2WHF1t6EwKzYOiq6Eo" alt=""><figcaption></figcaption></figure>

\
Leave as many cells as you need, then go the Field list’, select 'Report Data' -> 'TestCaseReport' -> 'TestCases' -> 'RelatedJiraIssues' and then drag and drop to the cell ‘TargetId’<br>

<figure><img src="https://lh5.googleusercontent.com/M-Lr3aIT2o-crWtrlhFHkUu5t2DtREnAD8uACb8laHCrFK3kdcUrajrCp65-LYn6aUAiaWK2WF0g2yMx5YoxcM3wjzWPSqs85AIJjhu0_2lTrOGeVbwlhV10Rw3qjEQpcosfCRa0BJWJ3pqn0Zdr08c" alt=""><figcaption></figcaption></figure>

Save your report and once you generate it, all linked Jira issues will be included into your report.

New Integrations Page Look and Feel – Your Integration Superpower!\ <a href="#new_integrations_page_look_and_feel__your_integration_superpower" id="new_integrations_page_look_and_feel__your_integration_superpower"></a>
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

Useful when:

* You want to have an overview, which project has an integration
* You want to see if there is a connection to Jira to make sure that integration is successful
* You are looking forward to new integrations and want to provide some feedback

\
Guide:

\
Open the 'Integrations' page, and you'll land on the 'Global' tab. Here, you can set up a single integration that applies to all the projects you have in aqua.

<figure><img src="https://lh3.googleusercontent.com/Vk5KhcHaZLCB0yFf8iM2K_yLYxGbVK3PCM878gX7qOmVvWl_f91FELWU9Ox2LGk-9UCGqK43-kPa8LmAXm47QLJf9-Rwa47QMBxJv9QaZ-Ucj-5HPckSBt2tX0rtLJvbv2nQ53_kxVtZy1wPHoNYK_M" alt=""><figcaption></figcaption></figure>

<figure><img src="https://lh3.googleusercontent.com/gAnmeNLnd_D-eSSjYaTVdAaEf8dFSPuv4vz7_sLjAoUH9ejIHri8g8MWDFc8F4ACYnfnkoO3Ge5FByVkGARMDvz7szB4imsAGYR_1Scd922sxi-ZnVH5xnop7GJmS7eYjWoCFE2aBNStXN0BYBPItlg" alt=""><figcaption></figcaption></figure>

Choose the integration, such as Jira, and then click the 'Configure' button.&#x20;

<figure><img src="https://lh5.googleusercontent.com/LKEY5qHnnU40KFkLPB8XpMzcKQxmvC9oELe4kC3hmvkZMiennq7CmdRmkFFdB6pNo3XlNH63bbspkWH4_9opqN2n3TX1TBVZZzNZx1kxBZzfsUCoFSsPINrs_0nZBXG0CQkA3CZb5VQuD4CnDADcXjA" alt=""><figcaption></figcaption></figure>

Enter all the necessary details and click 'Check connection.' If all your credentials are correct, you'll see the following message:

<figure><img src="https://lh4.googleusercontent.com/l8sG9H9Ur-CApK7sJj9q_2Vf_xIMp2RaNn-c0l78ZdkFr4640tuCCzfstpWx1dARRRy94VAOIp4ZtjUrZCCTG6QizQCjid04WW6pm2Ibuyu4bx6R-Pbqxu3e2SyYtIZAzSmPknp-DBk6TYzBXnHHl58" alt=""><figcaption></figcaption></figure>

If your credentials are incorrect, you'll encounter the following message:

<figure><img src="https://lh4.googleusercontent.com/NZuADN77zkEgNPcxZ7vPRyeaf_53WutZnhdHOKdwQglclbE2_onJctzY4b3KlRYTJsyL6pPnefkwmArl1aU4EFTw0PotHwYqO0qWB5dCK10buY_qXbwmEuAYMKVZCFBA1HdV_7m_-Rn3j3zOgexTI0k" alt=""><figcaption></figcaption></figure>

To finish the integration set up, don’t forget to click the ‘Save’ button.

\
You can also set up the integration on a project level, either from the main Integrations page or within the project settings.

Once you've created an integration on a project level, you'll find a tile under the project tab that displays the added integration and which project it's associated with.

<figure><img src="https://lh3.googleusercontent.com/rRuvDQYHiKrDLm24-gJcA-HdQW7YaQcyBr4a4loa9izsH00nYAcMVDhLNcbcKtF_vIbLcmmhAqXHFFXoKqJ8wSOveSF5hDuyL8irjiCWmOt7oegby55JStdclMi7hUhSuviTgudkdLEyPgV6-RAuLV4" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
It's important to note that project-level configuration takes precedence over the global configuration.
{% endhint %}

\
Additionally, moving forward, if your project is put on hold, or you need to make adjustments, there's no need to remove the integration entirely. You can simply disable it and re-enable it as needed.&#x20;

<figure><img src="https://lh3.googleusercontent.com/BM0UMcqdFlWooD-y0WRvIpiMiww1FKF5um_ADih_pCufF1ifJ6OBLLvqLG8vWGOJhrPuNJG4NBnlVBnsSGkOIMMH129Dz0rp2r4t-yZ8RQctRVz5eT0AET_mZeQtkcvZqhBcRZbAiU2LeK8Q_vSJY7o" alt=""><figcaption></figcaption></figure>

This means that users won't have the ability to preview or link issues or tickets to aqua projects while it’s disabled, but everything becomes available again as soon as the integration is re-enabled.

We also added the page with aqua apps that you can download and utilise for free. Learn more [here](https://docs.usecapture.io/help-articles) about Capture and [here ](https://docs.aqua-cloud.io/documentation/integrations/aqua4jira-plugin-cover-jira-issue-with-aqua-test-cases)about the Jira plugin if you haven’t used it yet.

<figure><img src="https://lh6.googleusercontent.com/2vVLz-Pk_cAQL5yBce0lA9-nSvYf4Y3N3sTlt7sZHkPAhufRXXGbGHaRt-re2WgnNkuY7HVvlD2y464VFnOm4nrP8hQgn6MTsce5B_tco3zPd7ne5stCPoliZ74Z5_HztcQz8vn6m78I_nKk-VR6GeY" alt=""><figcaption></figcaption></figure>

Got a wish-list of integrations you'd love to see? We're all ears! Access the survey from the ‘Integrations’ page and tell us what you're dreaming of.

<figure><img src="https://lh3.googleusercontent.com/_zkVCR0L9k-6x2ixYMUiP4fl5ZRXzkp6hyDcZYDDI6PGEqEj8QbZLIXE6nJLSPcLFVY0ANkItdwOSB6DN0ZctAMJtGFrQ6dX1x_vsBqNV2MNROX9gvvpJO9C5VY6LUiEZlUE-p3dZZx-QtqpnmeunNM" alt=""><figcaption></figcaption></figure>

## Test Execution: Your Choice, Your Pace <a href="#test_execution_your_choice_your_pace" id="test_execution_your_choice_your_pace"></a>

\
Useful when:

* You want to resume an incomplete test and pick up right where you left off, ensuring that the effort already invested in the test is not wasted
* You want to ensure that there are no unfinished text executions and user don’t populate unnecessary runs

Guide:

From now on, aqua will automatically prompt you once there is a previous unfinished test execution.

Just press the ‘New Run’ button and you’ll see the pop-up. Select ‘Continue’ if you want to resume the previous run. In case you want to start a new one, just click ‘New run’

<figure><img src="https://lh5.googleusercontent.com/A21IvcN_3IgyhA7WTJ-io7kHQCLUZCEVc3TdVS10-N43jRpsVDla0CST6LSLbvzz1870QyjtG15wc5wrv1fQqJ0O53LFRo5TdhHCBohgnLtVOwCVG4_f_3Z_9s-H4eQnZy87KIgIPEwOifJF8b7RP7E" alt=""><figcaption></figcaption></figure>

Please note: aqua will show you this pop up only if the last test execution is not completed.  It won’t be shown in case you have old recorded uncompleted test executions.

## Dashboard Bliss: Fresh Look, Effortless Management <a href="#dashboard_bliss_fresh_look_effortless_management" id="dashboard_bliss_fresh_look_effortless_management"></a>

Benefits:

* The enhanced dashboard design: you now have the power to create new charts from multiple locations with ease.
* Everything you need is thoughtfully organized in header, sidebar and dropdowns, ensuring that locating and utilizing it is effortless.

Guide:

Create the dashboard from multiple locations by clicking the corresponding option

<figure><img src="https://lh5.googleusercontent.com/ESaBCWGfAREm2JNeSFO7j4hFHOBlvrugkrLA65uzNNzqU0ptqd1kcdd5Y2OhzP54r-FwTex7o17e9AdFTxX944sYjtIczeRHS9YsiZKkuOBopV-m8xeXko-VjcaJMPdnM1JCR6mLIC8JOHmkbxQ-TVo" alt=""><figcaption></figcaption></figure>

Select the type of the chart you want to create and connect the data to display afterwards.

All main options are logically grouped at the header and easily accessible for you whenever you need to update the title, change the size of the chart, share it or copy and add to another dashboard.

<figure><img src="https://lh3.googleusercontent.com/nZ3RbtbTVYPKApyeLrwBtloch9vNHlnyRVgnwq7wGq7_5FUcylZUEiXn-cc7R2sEMUYXWi6mcjckYZckchjgqZbJEybOlMU7IMSJTXitvh6EVBBr2SrvTd8_8I5n1jJbZKWDo6moraycS2l-xrPoewY" alt=""><figcaption></figcaption></figure>

New Look and Feel for Chart Creation: A Dash of Wow!\ <a href="#new_look_and_feel_for_chart_creation_a_dash_of_wow" id="new_look_and_feel_for_chart_creation_a_dash_of_wow"></a>
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

Benefits:

* Streamlined Chart Creation: Easier to select and change the chart types
* Customization Power: With the revamped chart creation, you gain more control over the appearance and behaviour of your charts.

<br>

Guide:

Open the dashboard and click on the 'New Chart' button.&#x20;

<figure><img src="https://lh4.googleusercontent.com/qb1mRod3CR3MT7ThLrgBKeJjbG7Fcs7C5U9Qgoqat9iJbT0LuIFkdVa0P_w6wv04k7t8ZKwgf5muJP7v1sVY9PWSxa0mwcOUJSVRenMyZVD8yTIRT88EHu1reJD0lglrtlkxfzJvls7Fy4YGGMlYxcI" alt=""><figcaption></figcaption></figure>

Once the modal window appears, choose the type of chart you'd like to use.&#x20;

<figure><img src="https://lh4.googleusercontent.com/G0shTRHXjiVmNsMa5vAZDMKUK7YhQpbxYDyuoIB3pGRq88o9gDG_xCl0lFKWr3VcqUkIRhqBn1jUHi2h4h3nHDjywn2w7n7j52jiPfp9mNMqth_XrJZVZR-YAGNgW8Lrlu0WcFs1v8sC-RX5BVkUC30" alt=""><figcaption></figcaption></figure>

Next, select the project or specific folder containing the data you want to use for your chart and the item type.

<figure><img src="https://lh5.googleusercontent.com/QUL7MJRqmaVq3JvYuuyMlRRhUh0iCn2KLeCuDNYAN_yYAUBsx_TCvlG5duQmvqYnHMxXhi07y60bWTNfmcOJFZJENu3oUPKs4n57RNqBxU1ozoeCq3vC7DpsdNoF7auT4qGjyg85__RedoM-Got2Qg0" alt=""><figcaption></figcaption></figure>

Make any necessary adjustments by applying filters and selecting additional details you want to display. Finally, click the 'Save' button to preview your chart.

<figure><img src="https://lh5.googleusercontent.com/WFoFmJq2ZMYNjnpf6LFNyRntxjGyV0hcI0h-Z7-VNccH-nvgWm-LPyLvnejnp1g9JteXFrN_h3e5JtSaz8XXFbQspqcRd0Efm9r0aIOEGyctlRY4kk1p2bQl7-0BX27N8tZkgyI1Wm7zwERi7L3NW4Y" alt=""><figcaption></figcaption></figure>

If you're satisfied with how the data is presented, simply click 'Save & Close.'&#x20;

<figure><img src="https://lh4.googleusercontent.com/dLaSCrOazZ5T6wNMl-hBhHE357thJubDcWQxwR7zSEhEfYIP6uL-Gr8OlXQ7422kqJ6xCM4SXkd9JBcW7t17xTOm1L4NRU-OtzPFTNlpeL14w3IMDWW1FSAcqAyhy7JPepKe2Nu4Kn3Wjtf3vTLYHTk" alt=""><figcaption></figcaption></figure>

If you wish to make adjustments or change the chart type, no worries; make the necessary changes and click the 'Save' button again.

Don't forget to provide a title for your chart so you can easily understand the data it presents.

<figure><img src="https://lh5.googleusercontent.com/612vajEqVn5IANctxYgulPKSlTLcXTNe9ZRI9zW0uCQUJcOBATm2CJZJU93sHwnwJioieP53pHF5SdHLdl2h1-h_ID5aOoWceQgs8_v8bpuwfjgvW-tBG80yVd1tjq2wCMDSsAv5k-sTI7S8aeskboQ" alt=""><figcaption></figcaption></figure>

Small UX Tweak: Project and Item Creation Made a Breeze\ <a href="#small_ux_tweak_project_and_item_creation_made_a_breeze" id="small_ux_tweak_project_and_item_creation_made_a_breeze"></a>
-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

Benefits:

* More intuitive and user-friendly approach that reduces the learning curve for new users and minimizes the steps required to manage projects and their associated items.&#x20;
* Option to create it from a tree view enhances the overall user experience and reduces the potential for errors.

Guide:

Creating a project becomes even easier. Just click the 'Plus' icon next to the 'Project' label.&#x20;

<figure><img src="https://lh5.googleusercontent.com/fzDMOWLPaR0VHCkQswSYOdWm_kVrGJeSEamxTVrCigjXSbQUnbh5w-C82G5jhKP0GS5nwvbXIrKqEBerAIy5PHUAFcIAIs-GDOf_j2KusrOD60BzWBvuuUz24qItc5G4GAUO5aiCFJS4iEkE1K-vUUY" alt=""><figcaption></figcaption></figure>

We haven't removed this option from the dropdown, so you can use either method based on what's more convenient for you.

<figure><img src="https://lh3.googleusercontent.com/PQl0I4xZr1fEa5nA4vVAdxvB0aVaQ266mUXuVKFm5wndHvSomOxEM6SyyKsgdLuxdiU1jCH4f6Ekr_FGSrJEuHzSiyZqj_MOWaVE79_L9P7vTlREMbciCGhaQrr0A00UF6fy7d1U3pIbKxpkTPLNDiQ" alt=""><figcaption></figcaption></figure>

To create an item or folder within a specific project, first select the project, and the plus icon will appear. Click on it, and choose the option you need.

<figure><img src="https://lh5.googleusercontent.com/IwNX3gH-lZFjDHteTsRjv8JJrQ3I_a-xpCz5V6iT5_bsQdDq9_z0DYbIF4MeiS1-CVNquhJB1Z3hYPNzuRx08GljuG0wa0J7ZW5huMJI6f4hAAwGlshOGmEyu9v0XXeHqt5yzrn-6lG2cjatjeAwUYw" alt=""><figcaption></figcaption></figure>

If you want to create an item within a folder or subfolder, select the folder and click on the 'Plus' icon that appears. Then, perform the same actions as described above.

<figure><img src="https://lh6.googleusercontent.com/mL_9Jm4XhxCfykch-8O0J_lzbhcDqOOBT4FhqBP9IwLbIKgHN5qMvLszdSo41bJqlKSA-egNYeXv_yL7GdECKnLpTa2k3rLTT2XgODtHR3gczF7Q2WON9sC2HwKSSHorUxzhA7mt22w0C8zMk2mTvz8" alt=""><figcaption></figcaption></figure>

\
Single Tab Ticket Management: Tab-tastic Efficiency
---------------------------------------------------

Useful when:

* You are annoyed by juggling multiple tabs to access different items and want to open the item in the same tab
* You want a clutter-free window and ease navigation between the tabs
* You need to easily navigate to the main page whenever it’s needed and save time on opening the new tab with aqua navigation page

\
Guide:

Whenever you need to open the item, just do it the same way as you did before: either click on the item title or the ‘Open’ button.

The ticket will open in the same tab without populating separate tabs.

In case you need to go back, just click the ‘Back to main’ button, and you’ll get back to the ‘Navigation’ page.

<figure><img src="https://lh3.googleusercontent.com/3W9gfi5HOSuV-lSclymmR9dzzTctOw9U8jwGA_ILRrsRC1Pgcz1qkTB9-YiRBPsoC_6rQYUtqzgZpTEWiq4g8nWrkWGc5uKh2tzggg5RKQIoUNfjCf4_zOmFBlyjTUOd0W2osNyCwUB0-PRHk0r3nmU" alt=""><figcaption></figcaption></figure>

\
When  you need to open multiple items, just click on the item and click on the ‘Open in a new tab’ option in the context menu.

<figure><img src="https://lh6.googleusercontent.com/d4VL-bRr8vkRa2C4WZZyOuq8P9eGMVhcPlOVWuCxEJNV4lc9Mu1V4NptjU3HLndANiCL0aoo5SiE74s7lzf6_NB13Y3i-U4iWDAsj3FRbYHlRKRsL8eOqXgjRigGkrcunU3CKJPU4kgQi2hHW10t32E" alt=""><figcaption></figcaption></figure>

## Drag and Drop Columns: Effortless Navigation Tweaks <a href="#drag_and_drop_columns_effortless_navigation_tweaks" id="drag_and_drop_columns_effortless_navigation_tweaks"></a>

<br>

Useful when:

* You want to easily add the column to the exact place to the item grid

\
Guide:

Whenever you need to drag and drop a new column to the grid, you can use the Alt+Shift+C shortcut. The column chooser will appear, and you can drag and drop items to the exact place on the grid.

<figure><img src="https://lh5.googleusercontent.com/K356nqMx1kjzVqy_Knr9bOFjggAyAG2u3NyhhwGuSzizGoRTX5XwNC2NO0E4LNUaNP_VtyPtk6kmIeyOZC8VyeWWZGA9XRdkytECPDfxGiieuanKfYKMtWJNiaSeYXz4WemVh16nBtrxClSa9as7lfw" alt=""><figcaption></figcaption></figure>

Alternatively, you can easily see the whole list of the columns by enabling the ‘View’ sidebar and then clicking the ‘Add column’ button. The same column chooser will appear, allowing you to select data you want to display.&#x20;

<figure><img src="https://lh5.googleusercontent.com/x8hwqxGt_QMXaS5MeUaPHaJrQpSxOFiwcWqWLzuQtz1jY1iCwUBqJpMDnCkn0D1Yx0ifE2M4QHAXT6w8JXmvpqRQ2enkwagzsvCFqM3vm3YP4XpP5793kkgCp0RxhIDoQACFnqPFzL5X3XnwCLsa9DA" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
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](https://docs.aqua-cloud.io/documentation/web-client/getting-started).&#x20;

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.&#x20;

In the meantime, let us know if you have any questions or share feedback at support\@aqua-cloud or <feedback@aqua-cloud.io>
{% endhint %}

<br>

<br>
