From 08416f0ec7bd76938e8925ebbd4fbc52a8185ad3 Mon Sep 17 00:00:00 2001 From: Tom Grace Date: Fri, 2 Feb 2018 09:39:41 +0000 Subject: Update Jira integration docs for new Jira UI Closes https://gitlab.com/gitlab-org/gitlab-ce/issues/42663 The new Jira UI doesn't show transition IDs in the admin interface. This updates the docs to list a couple of alternative methods of getting the required ID. --- .../integrations/img/jira_workflow_screenshot.png | Bin 66685 -> 0 bytes doc/user/project/integrations/jira.md | 11 ++++++++++- 2 files changed, 10 insertions(+), 1 deletion(-) delete mode 100644 doc/user/project/integrations/img/jira_workflow_screenshot.png (limited to 'doc/user') diff --git a/doc/user/project/integrations/img/jira_workflow_screenshot.png b/doc/user/project/integrations/img/jira_workflow_screenshot.png deleted file mode 100644 index e62fb202613..00000000000 Binary files a/doc/user/project/integrations/img/jira_workflow_screenshot.png and /dev/null differ diff --git a/doc/user/project/integrations/jira.md b/doc/user/project/integrations/jira.md index f77569e4886..0be86915448 100644 --- a/doc/user/project/integrations/jira.md +++ b/doc/user/project/integrations/jira.md @@ -113,7 +113,16 @@ in the table below. | `JIRA API URL` | The base URL to the JIRA instance API. Web URL value will be used if not set. E.g., `https://jira-api.example.com`. | | `Username` | The user name created in [configuring JIRA step](#configuring-jira). | | `Password` |The password of the user created in [configuring JIRA step](#configuring-jira). | -| `Transition ID` | This is the ID of a transition that moves issues to a closed state. You can find this number under JIRA workflow administration ([see screenshot](img/jira_workflow_screenshot.png)). **Closing JIRA issues via commits or Merge Requests won't work if you don't set the ID correctly.** | +| `Transition ID` | This is the ID of a transition that moves issues to the desired state. **Closing JIRA issues via commits or Merge Requests won't work if you don't set the ID correctly.** | + +### Getting a Transition ID + +In the most recent Jira UI, you can no longer see transition IDs in the workflow administration UI. You can get the ID you need in either of the following ways: + +1. Use the API, with a request like https://yourcompany.atlassian.net/rest/api/2/issue/ISSUE-123/transitions using an issue that is in the appropriate "open" state +1. By mousing over the link for the transition you want and looking for the "action" parameter in the URL + +Note that the transition ID may vary between workflows (i.e. bug vs. story), even if the status you are changing to is the same. After saving the configuration, your GitLab project will be able to interact with all JIRA projects in your JIRA instance. -- cgit v1.2.3 From dbbc9e67c7f4201fcc5b5e9b53759b395576fa00 Mon Sep 17 00:00:00 2001 From: Achilleas Pipinellis Date: Fri, 30 Mar 2018 14:55:24 +0200 Subject: Copyedit JIRA docs --- doc/user/project/integrations/jira.md | 14 +++++++++----- 1 file changed, 9 insertions(+), 5 deletions(-) (limited to 'doc/user') diff --git a/doc/user/project/integrations/jira.md b/doc/user/project/integrations/jira.md index 0be86915448..2f6e415c5cf 100644 --- a/doc/user/project/integrations/jira.md +++ b/doc/user/project/integrations/jira.md @@ -115,14 +115,18 @@ in the table below. | `Password` |The password of the user created in [configuring JIRA step](#configuring-jira). | | `Transition ID` | This is the ID of a transition that moves issues to the desired state. **Closing JIRA issues via commits or Merge Requests won't work if you don't set the ID correctly.** | -### Getting a Transition ID +### Getting a transition ID -In the most recent Jira UI, you can no longer see transition IDs in the workflow administration UI. You can get the ID you need in either of the following ways: +In the most recent JIRA UI, you can no longer see transition IDs in the workflow +administration UI. You can get the ID you need in either of the following ways: -1. Use the API, with a request like https://yourcompany.atlassian.net/rest/api/2/issue/ISSUE-123/transitions using an issue that is in the appropriate "open" state -1. By mousing over the link for the transition you want and looking for the "action" parameter in the URL +1. By using the API, with a request like `https://yourcompany.atlassian.net/rest/api/2/issue/ISSUE-123/transitions` + using an issue that is in the appropriate "open" state +1. By mousing over the link for the transition you want and looking for the + "action" parameter in the URL -Note that the transition ID may vary between workflows (i.e. bug vs. story), even if the status you are changing to is the same. +Note that the transition ID may vary between workflows (e.g., bug vs. story), +even if the status you are changing to is the same. After saving the configuration, your GitLab project will be able to interact with all JIRA projects in your JIRA instance. -- cgit v1.2.3