diff --git a/doc/integration/jira/configure.md b/doc/integration/jira/configure.md index 6a0cc83e8134dfbba58210b0618bfd01cab9ed5b..5b1d991fdd0b540e1c8418c70884292b48923cc8 100644 --- a/doc/integration/jira/configure.md +++ b/doc/integration/jira/configure.md @@ -67,7 +67,7 @@ To configure your project settings in GitLab: - For **Jira issue regex**, [enter a regex pattern](issues.md#define-a-regex-pattern). - For **Jira issue prefix**, [enter a prefix](issues.md#define-a-prefix). 1. Optional. In the **Issues** section: - - To [view issues](#view-jira-issues) from a single Jira project in a GitLab project: + - To [view Jira issues](#view-jira-issues) in GitLab: 1. Select the **Enable Jira issues** checkbox. 1. Enter the Jira project key. @@ -106,8 +106,7 @@ To view issues from a single Jira project in a GitLab project: By default, the issues are sorted by **Created date**. The most recently created issues appear at the top. -You can [search and filter the issue list](issues.md#search-and-filter-the-issue-list) -and select an issue to view that issue in GitLab. +You can [filter issues](#filter-jira-issues) and select an issue to view that issue in GitLab. Issues are grouped into the following tabs based on their [Jira status](https://confluence.atlassian.com/adminjiraserver070/defining-status-field-values-749382903.html): @@ -116,6 +115,31 @@ Issues are grouped into the following tabs based on their - **Closed**: issues with a **Done** Jira status. - **All**: issues with any Jira status. +### Filter Jira issues + +DETAILS: +**Tier:** Premium, Ultimate +**Offering:** SaaS, self-managed + +Prerequisites: + +- Ensure the Jira issue integration is [configured](#configure-the-integration) + and the **Enable Jira issues** checkbox is selected. + +When you [view Jira issues](#view-jira-issues) in GitLab, +you can filter the issues by text in summaries and descriptions. +You can also filter the issues by: + +- **Label**: specify one or more Jira issue labels in the `labels[]` parameter in the URL. + When you specify multiple labels, only the issues that have all the specified labels appear + (for example, `/-/integrations/jira/issues?labels[]=backend&labels[]=feature&labels[]=QA`). +- **Status**: specify the Jira issue status in the `status` parameter in the URL + (for example, `/-/integrations/jira/issues?status=In Progress`). +- **Reporter**: specify the Jira display name of the `author_username` parameter in the URL + (for example, `/-/integrations/jira/issues?author_username=John Smith`). +- **Assignee**: specify the Jira display name of the `assignee_username` parameter in the URL + (for example, `/-/integrations/jira/issues?assignee_username=John Smith`). + ## Create a Jira issue for a vulnerability DETAILS: diff --git a/doc/integration/jira/issues.md b/doc/integration/jira/issues.md index aa5a6a34ed5612ca12435406213ec3d278caa030..aef07bfd1e370765fcd3eba775a8c3b61d3b4249 100644 --- a/doc/integration/jira/issues.md +++ b/doc/integration/jira/issues.md @@ -146,29 +146,6 @@ Consider this example: - GitLab adds a formatted comment to Jira, linking back to the commit that resolved the issue. You can [disable comments](#disable-comments-on-jira-issues). -## Search and filter the issue list - -DETAILS: -**Tier:** Premium, Ultimate -**Offering:** SaaS, self-managed - -To refine the list of issues, use the search bar to search for any text -contained in an issue summary (title) or description. Use any combination -of these filters: - -- To filter issues by `labels`, specify one or more labels as part of the `labels[]` - parameter in the URL. When using multiple labels, only issues that contain all specified - labels are listed: `/-/integrations/jira/issues?labels[]=backend&labels[]=feature&labels[]=QA` -- To filter issues by `status`, specify the `status` parameter in the URL: - `/-/integrations/jira/issues?status=In Progress` -- To filter issues by `reporter`, specify a reporter's Jira display name for the - `author_username` parameter in the URL: `/-/integrations/jira/issues?author_username=John Smith` -- To filter issues by `assignee`, specify their Jira display name for the - `assignee_username` parameter in the URL: `/-/integrations/jira/issues?assignee_username=John Smith` - -Enhancements to use these filters through the user interface -[are planned](https://gitlab.com/groups/gitlab-org/-/epics/3622). - ## Automatic issue transitions When you configure automatic issue transitions, you can transition a referenced