Changes for page Jira

Last modified by Boris Folgmann on 2026/05/08 15:42

Manage
- Copy
Actions
- Export
- Print Preview
Viewers
- Source
- Children
- Content
- Comments
- Likes

From 28.1 to 27.1 From 33.1 to 32.1

From version 32.1

edited by Boris Folgmann
on 2026/05/08 15:15

Change comment: There is no comment for this version

To version 28.1

edited by Boris Folgmann
on 2026/05/08 15:14

Change comment: Uploaded new attachment "image2019-9-4_11-38-46.png", version {1}

Raw
Rendered

Summary

Page properties (1 modified, 0 added, 0 removed)
Attachments (2 modified, 0 added, 0 removed)
- image2019-9-11_10-41-21.png
- image2019-9-4_11-27-48.png

Details

Page properties

Content

@@ -1,55 +1,352 @@
  {{toc/}}
--= Introduction =
++= First steps in Jira =
--This document describes the important features of DevOps-as-a-Service concerning Jira. For general concepts and details about Jira, please refer to the **Jira vendor documentation **section at the end of this document.
++{{info}}
++**You have two options to log in to Jira:**
--Project admins can edit and save their projects in the DevOps Portal. This can be used to change the name or description of a project. The change is automatically propagated to all tools including Jira.
++* you can **use SDPortal**, in this case the selected project will be set
++* you can **use a direct URL** (for example a bookmark) but in this case **you have to [[**select the project** **manually**>>doc:||anchor="selectprojectjira"]]** in Jira that you would like to work on.
++{{/info}}
--A custom Jira plugin automatically removes unused screens, screen schemes, and issue-type screen schemes whenever the DevOps Portal deletes a project, helping to free up resources and improve performance.
++== {{id name="logintojira"/}}Log in to Jira from SDPortal ==
--= First steps in Jira =
++In SDPortal click **Jira** in the **Tools** section of your project.
--== {{id name="logintojira"/}}Log in to Jira from DevOps Portal ==
++In this example the FCI project will be the selected project to work on.
--In DevOps Portal sign in to your account with your registered mail and password.
++[[image:attach:image2019-8-26_10-29-45.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="244" width="1100"]]
--For more information about logging in to DevOps Portal see : [[DevOps Portal for Users>>https://prd.sdc.t-systems.net/xwiki/wiki/devopsaas/view/DevOps%20Portal%20for%20Users/]]
++In this example the user is assigned to two projects, and the user has a specific role in each project.
--== {{id name="selectprojectjira"/}}Select Project ==
++{{info}}
++The roles can be used to restrict certain rights according to the project. A detailed role matrix for Jira can be found in the [[Jira project roles section>>doc:||anchor="jira_project_roles"]]
++{{/info}}
--After successful authentication, you will be directed to the DevOps Portal, in this example the user is assigned to two projects, and the user has a specific role in each project:
++Log in to Jira with your username and password:
--[[image:2.png||height="273" width="535"]]
++[[image:attach:image2019-9-10_14-26-41.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" width="600"]]
--By clicking on **Agile Board**, you will be redirected to the selected project’s board in Jira:
++== First login to Jira ==
--[[image:2.1.png||height="297" width="418"]]
++If you log in for the first time, you can choose the preferred language and your avatar image, then you can continue by clicking (% style="letter-spacing:0.0px" %)**Next**(%%) button:
--[[image:2.2.png||height="404" width="977"]]
++Gravatar is enabled for user avatars, so your Gravatar  - i.e. the Gravatar associated with the email address in your user profile -  will automatically be set as your user avatar and this step will be skipped.
--The next option shows the **Backlog**, where the created issues will appear. If you are the first user to create an issue, the Backlog will be empty:
++[[image:attach:image2019-8-27_14-11-1.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" width="600"]]
--[[image:backlog.png||data-xwiki-image-style-border="true" height="276" width="468"]]
++The next screen shows the **Backlog**, where the created issues will appear.
--[[image:backlog-1.png||data-xwiki-image-style-border="true" height="355" width="933"]]
++If you are the first user to create an issue, the Backlog will be empty:
--If you would like to create or view issues belonging to other projects you can select the project by clicking **Projects** on the top. In this example you can see the current project (NEWPROJECT):
++[[image:attach:image2019-8-27_14-39-22.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="452" width="1100"]]
--[[image:view%20all%20prj.png||alt="view all prj.png" data-xwiki-image-style-border="true" height="281" width="633"]]
++You can open the backlog any time by clicking the **backlog** button on the left:
--If **View All Projects** is selected, you can see the projects to which you are assigned to.
++[[image:attach:image2019-8-29_11-14-41.png||data-xwiki-image-style-border="true" thumbnail="true" height="250"]]
--[[image:view%20all%20prj-2.png||alt="view all prj-2.png" data-xwiki-image-style-border="true" height="273" width="1002"]]
++== {{id name="selectprojectjira"/}}Select Project ==
++
++If you would like to create or view issues belonging to other projects you can select the project by clicking **Projects** on the top
++
++[[image:attach:image2019-8-27_14-48-0.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="328" width="363"]]
++
++In this example you can see the same projects that are assigned to this user in SDPortal (//Future Cloud Infrastructure// and //Showing Devops as a Service capabilities//).
++
++If **View All Projects** is selected, you can see the projects you are assigned to.
++
++[[image:attach:image2019-8-27_14-54-7.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="290" width="1100"]]
++
  You can select the desired project to continue your work.
--= DevOps Jira Agile Board Management =
++= Issues =
--As it is shown in the picture below, by clicking on the dots menu in the top left corner of Jira, you have quick access to all tools which are part of your the DevOps-as-a-Service instance.
++Issues are the building blocks of any Jira project. An issue could represent a story, a bug, a task, or another issue type in your project.
--[[image:devops.png||height="402" width="465"]]
++== {{id name="createissue"/}}Create an Issue ==
++
++To create an issue click the **Create an issue** button.
++
++[[image:attach:image2019-8-27_15-2-49.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="102" width="450"]]
++
++First you have to select the(% style="letter-spacing:0.0px" %)** Issue Type**(%%), which can be Task, Story, Epic or Bug.
++
++In this example this issue will be a Task.
++
++[[image:attach:image2019-8-29_9-57-32.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="228" width="450"]]
++
++Fill the required fields, the user who creates the issue ticket will be the **Reporter**.
++
++[[image:attach:image2019-8-29_10-7-5.png||queryparams="effects=drop-shadow" height="649" width="700"]]
++
++If there are tickets that have been already created you can link those to this ticket as **Linked Issues. **
++
++You can also link this issue to an Epic, or to an existing Sprint.
++
++The **Assignee** can be selected from existing users, or you can assign it to yourself by clicking **Assign to me**.
++
++(For further refinement of the settings click (% style="letter-spacing:0.0px" %)//Configure Fields//(%%).)
++
++To create the ticket click the **Create** button.
++
++[[image:attach:image2019-8-29_10-9-19.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="649" width="700"]]
++
++Now your ticket appears in the **Backlog**:
++
++[[image:attach:image2019-8-29_10-20-14.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="351" width="450"]]
++
++By repeating these steps you can add new issues to the Backlog.
++
++== Edit an Issue ==
++
++{{info}}
++**Prerequisites**
++
++    You are logged in to Jira.
++    You have recently created an issue as shown in the Create an issue section.
++{{/info}}
++
++
++You can **Edit** or** Delete** the issue ticket any time, simply just click the ticket name (in this example FCI-1) in the (% style="letter-spacing:0.0px" %)//Backlog//(%%):
++
++[[image:attach:image2019-8-29_10-45-11.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="150" width="350"]]
++
++Then click on the** Issue menu **button (three dots) on the right side:
++
++[[image:attach:image2019-8-29_10-31-41.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="358" width="1100"]]
++
++**Edit** an issue can be useful option if you would like to for example assign an issue to another user (allows you to edit all the fields that  are possible to edit when creating an issue).
++
++== Find a recently created Issue ==
++
++{{info}}
++**Prerequisites**
++
++    You are logged in to Jira.
++    You have selected the project you want to start searching and you also have recently created an issue as shown in the Create an issue section.
++{{/info}}
++
++Select the Project you want to see a recently created issue (here as example the project name is //Future Cloud Infrastructure//) - click on(% style="letter-spacing:0.0px" %)** Project**(%%) button on the top, select(% style="letter-spacing:0.0px" %)** View all Projects**(%%), the click on the selected P(% style="letter-spacing:0.0px" %)**roject**(%%):
++
++[[image:attach:image2019-8-30_13-49-26.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" width="800"]]
++
++Click the **Issues** button on the left column:
++
++[[image:attach:image2019-8-30_13-53-46.png||data-xwiki-image-style-border="true" thumbnail="true" height="250"]]
++
++Now all open issues are listed.
++
++On the **Order by Priority** click the drop down Menu and select Created:
++
++[[image:attach:image2019-8-30_13-56-14.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="506" width="357"]]
++
++You can also use the search field to find a category for the order of issues.
++
++== Search for issues ==
++
++{{info}}
++**Prerequisites**
++
++    You are logged in to Jira.
++    You have selected the project you want to start searching and you also have already created an issue as shown in the Create an issue section.
++{{/info}}
++
++To find a specific issue you should use the search field on the top right section in Jira and start typing words related to the issue that you are searching for.
++
++In this example the issue that is being searched is //Create documentation for Release 1.0 //
++
++If you are assigned to more than 1 project, the matching results for the search may //display issues from other projects too//:
++
++[[image:attach:image2019-8-30_14-3-30.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="336" width="400"]]
++
++= Sprints =
++
++In Jira Software, you can view sprints on a board and assign issues to sprints - this feature is only available for Scrum boards.
++
++== {{id name="startsprint"/}}Start a Sprint ==
++
++If you and your colleagues created the issues you can set up a sprint.
++
++{{info}}
++**Prerequisites**
++
++1.     You are logged in to Jira.
++1.     You have selected the project where you want to start a Sprint, and you are using a Scrum board for the project.
++1.     You have at least MASTER role on this project.
++{{/info}}
++
++
++Keep in mind that only **//Admin//** and **//Master//** roles allows to create a sprint (with only Developer or Viewer role it is not possible).
++
++{{info}}
++(% class="title" %)
++**Hint**
++
++If you need to know how to change your role to MASTER, please visit in SDPortal for Admins - [[Assign a user to a project>>doc:DevOps Portal for Admins.WebHome||anchor="assignusertoproject"]]
++{{/info}}
++
++Select  the **Backlog icon** on the left column then click on **Create Sprint**.
++
++[[image:attach:image2019-8-30_10-11-1.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="140" width="1100"]]
++
++To determine a sprint goal (that you may want to achieve at the end of the sprint) just click on the sprint menu (three dots) on the right and then select **Add sprint goal.**
++
++[[image:attach:image2019-8-30_10-15-14.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="516" width="1100"]]
++
++After you have set the goals proceed to **drag and drop** the selected issue(s) from the Backlog to** Plan your Sprint** section.
++
++[[image:attach:image2019-8-30_10-19-14.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="516" width="1100"]]
++
++The dragged issues appear in the sprint section (here it is named FCI Sprint 1). If all the desired issues are in this section click on** Start Sprint**:
++
++[[image:attach:image2019-8-30_11-40-52.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="350" width="1100"]]
++
++Then you can set the **Duration **and** Start Date** for the sprint,
++
++To start the sprint click **Start**:
++
++[[image:attach:image2019-8-30_11-39-21.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="431" width="450"]]
++
++A successful Sprint start will display this message: " (% style="letter-spacing:0.0px" %)**Sprint 'FCI Sprint 1 has successfully started'.**(%%) "
++
++== Move existing Issues from Backlog into current Sprint ==
++
++{{info}}
++**Prerequisites**
++
++1. You are logged in to Jira.
++1. You have selected the project and you have already started a Sprint.
++1. You have at least MASTER role on this project.
++
++n message here.
++{{/info}}
++
++Select in Jira the Backlog icon on the left column and with the mouse proceed to **drag and drop** the desired issues from Backlog to the sprint.
++
++In this example the issue named FCI-4 is being added to the current sprint.
++
++[[image:attach:image2019-8-30_13-29-48.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="250"]]
++
++After an issue has been dragged the following message appears and you have to **Confirm** the change:
++
++[[image:attach:image2019-8-30_13-31-32.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="219" width="527"]]
++
++== Manage Sprints ==
++
++{{info}}
++**Prerequisites**
++
++1. You are logged in to Jira.
++1. You have selected the project and you have already started a Sprint.
++1. You have at least MASTER role on this project.
++{{/info}}
++
++If you would like to manage issues in the sprint click **Active sprints** on the left column:
++
++[[image:attach:image2019-8-30_14-16-11.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="324" width="1100"]]
++
++If you start work on an issue you can simply drag the issue from **To Do** to the  **In Progress** column (this status can be set by //Edit an issue// too)
++
++[[image:attach:image2019-8-30_14-19-15.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="250"]]
++
++If an issue is closed you can drag to the **Done** column also, and the letters will change to the strike-through type.
++
++In this example the work on FCI-2 has not started yet, FCI-3 is in progress and FCI-4 is finished:
++
++[[image:attach:image2019-8-30_14-28-30.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="324" width="1100"]]
++
++You can also close the current sprint any time by clicking on **Complete Sprint** on the top right.
++
++[[image:attach:image2019-8-30_14-23-16.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="172" width="450"]]
++
++= Dashboards =
++
++Your dashboard is the main display you see when you log in to Jira. You can create multiple dashboards from different projects, or multiple dashboards for one massive overview of all the work you're involved with.
++
++== Create a new Dashboard ==
++
++You can create custom dashboards to Jira by clicking the **Dashboards** tab, then click on **Manage Dashboards**:
++
++[[image:attach:image2019-9-3_13-17-57.png||data-xwiki-image-style-border="true" thumbnail="true" height="109" width="167"]]
++
++Select the Dashboards Tab and on the right side select **Create new dashboard **button** **on the top right corner:
++
++[[image:attach:image2019-8-30_14-40-25.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="107" width="313"]]
++
++Fill the **Name** field (Description is mandatory), then select  the Project option from **Add Viewers** (you will see the project name appearing next to this).
++
++The options can be to select a **Group** (for example// jira-software-users//), members of an exact **Project**, **Any logged-in user** (no matter what projects assigned to the users) or **Public**.
++
++[[image:attach:image2019-8-30_15-6-37.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="420" width="500"]]
++
++{{info}}
++⚠** WARNING**
++
++Sharing with the public will make this visible to all users, including users who are not logged in.
++{{/info}}
++
++You can pick a role (in the project) or you can select **All** (as this example shows), and you have to click **Add** to set the Viewers for this dashboard.
++
++[[image:attach:image2019-8-30_15-12-35.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" width="600"]]
++
++You also have to **Add Editors** for the dashboard (in the next row), for example you can choose a **User** (instead of group) then start typing the username to select the user:
++
++[[image:attach:image2019-8-30_15-18-7.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" width="600"]]
++
++Click **Add** at the end of this line, and if you would like to add a another user just type in the field and click **Add** again.
++
++In this example the users  add to Editors have the right to edit this dashboard.
++
++To create this new dashboard click **Add** on the bottom:
++
++[[image:attach:image2019-8-30_15-21-20.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="470" width="600"]]
++
++== Add Gadgets to Dashboards ==
++
++Now the new dashboard is available (when you click on **Dashboards** on the top), click on the created dashboard to continue with adding gadgets:
++
++[[image:attach:image2019-9-4_9-27-52.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="114" width="179"]]
++
++In the appearing screen you can see your selected dashboard's name on the right.
++
++Click on **add a new gadget **to populate a gadget to this dashboard:
++
++[[image:attach:image2019-9-4_9-36-20.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="240" width="700"]]
++
++By default you can add only the //Bubble Chart// and the //Introduction// gadget, so click on **Load all gadgets** to see more:
++
++[[image:attach:image2019-9-4_9-41-17.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="295" width="700"]]
++
++You can select from the loaded gadgets by clicking **Add gadget. **In this example a new Pie Chart will be placed on the dashboard:
++
++[[image:attach:image2019-9-4_9-46-40.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="199" width="700"]]
++
++You can select more gadgets (in this example Issues in progress is also added) and if you are finished the selection you can close this window by clicking X on the top.
++
++You can reorder the gadgets by drag and drop method.
++
++Fill the fields with the required data or sslect the available oprtions. For the Pie chart for example you can select the project:
++
++[[image:attach:image2019-9-4_9-53-46.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="377" width="700"]]
++
++Click **Save** on each gadget to see the results
++
++In this example the //Pie Chart// shows the Assignee of the tickets, and the// Issues in progress// show only the ticket which is assigned to the user who is created the dashboard:
++
++[[image:attach:image2019-9-4_10-38-55.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="447" width="700"]]
++
++== Manage Dashboards ==
++
++ Select the **Dashboards** tab and select **Manage Dashboards**
++
++[[image:attach:image2019-9-4_10-52-45.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="146" width="185"]]
++
++In this example, the user has yet created another dashboard (SDCloud Dashboard) and has the right to modify each dashboard by clicking the** clog icon** - available options are **Edit**, **Delete** or **Copy** the dashboard.
++
++[[image:attach:image2019-9-4_10-49-23.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="337" width="1100"]]
++
  = Boards =
  A board displays issues from one or more projects, giving you a flexible way of viewing, managing, and reporting on work in progress. The available types of boards in Jira are:
@@ -59,7 +59,7 @@
  Select the** Boards** tab and select **View all boards**:
--[[image:all%20boards.png||alt="all boards.png" height="135" width="582"]]
++[[image:attach:image2019-9-10_11-0-22.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="198" width="185"]]
  == {{id name="jira_create_boards"/}}Create Boards ==
@@ -67,43 +67,32 @@
  **Prerequisites**
 . You are logged in to Jira.
--1. You can create new boards, but you must have at least a VIEWER role on the project for which you want to create a board to see the issues.
++1. You have at least ADMIN role on this project to be able to create new boards.
  {{/info}}
  To create a new board click on **Create board** button on the right corner:
--[[image:image2019-9-18_10-41-10.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="118" width="700"]]
++[[image:attach:image2019-9-18_10-41-10.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="118" width="700"]]
--Select the type of the new board: it can be **Scrum** or **Kanban** board.
++Select the type of the new board: it can be **Scrum** or **Kanban** board.
--=== Creating a Scrum Board ===
++[[image:attach:image2019-9-18_10-42-48.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="249" width="700"]]
--[[image:image2019-9-18_10-42-48.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="249" width="700"]]
++In this example a Scrum board have been selected and there is an option to create a **Board from an existing project** or from an existing Saved Filter.
++[[image:attach:image2019-9-18_10-58-28.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" width="700"]]
--In this example a Scrum board has been selected and there is an option to create a **Board from an existing project** or from an existing Saved Filter.
--
--[[image:image2019-9-18_10-58-28.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" width="700"]]
--
  Type the **Board Name** and select a **Project(s). **Then click** Create board.**
--In this example the name is //Custom Scrum board// and the selected project is //NEWPROJECT.//
++In this example the name is //Custom Scrum board// //for FCI// and the selected project is //Future Cloud Infrastructure.//
--**[[image:create%20board.png||alt="create board.png" height="356" width="812"]]**
++**[[image:attach:image2019-9-18_11-11-1.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="261" width="700"]]**
--=== Creating a Kanban Board ===
++The following message indicates that the new board has been created:
--[[image:1757324747229-442.png||height="304" width="760"]]
++[[image:attach:image2019-9-18_11-14-15.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="73" width="417"]]
--In this example the Kanban board has been selected and created as** **an** existing project** like the above example. In the next step, after naming the board
++Now you can modify the board's properties, all the settings based on the project's board by default.
--and selecting a project from the drop-down list, we can create the Kanban board:
--
--[[image:1757325036888-798.png||height="304" width="766"]]
--
--After creating the board, we will be forwarded to the Kanban board, where we can see the selected project with its created issues.
--
--The difference between Kanban and Scrum is that Scrum uses sprints with defined meetings, a fixed set of tasks in a fixed period of time (typically e2 weeks). Kanban on the other hand, is an ongoing process. Scrum boards will be changed/updated after each sprint, but Kanban boards are continuously updated throughout a project and are more flexible.
--
  == Manage Boards ==
  {{info}}
@@ -110,28 +110,21 @@
  **Prerequisites**
 . You are logged in to Jira.
--1. You have at least ADMIN role on this project to be able to manage boards connected with the project.
++1. You have at least ADMIN role on this project to be able to manage boards.
  {{/info}}
--Click the **Board menu** (3 dots on the right)  of the selected board. You can **Copy** or **Delete** the board, and you can also modify the default settings by selecting **Configure**:
++Click the **Board menu** (3 dots on the right)  of the selected board:
--[[image:image2019-9-10_11-20-4.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="152" width="183"]]
++[[image:attach:image2019-9-10_11-16-54.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="228" width="1100"]]
--The //**General**// information of the board appears, containing the //board's name//, the //administrator(s)// and the //filter// which defines what issues are visualized in the board.
++You can **Copy** or **Delete** the board, and you can also modify the default settings by selecting **Configure**:
--[[image:general.png||height="480" width="872"]]
++[[image:attach:image2019-9-10_11-20-4.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="152" width="183"]]
--{{info}}
--In DevOps Portal, each time a project is resynced or an Admin is modified (added or deleted), the DevOps platform will align the Administrators of the corresponding boards to the list of Project Admins
++The //**General**// information of the board appears, containg the //board's name//, the //administrator(s)//, the //filter// data, and the //owner// (of the project)
--To qualify for a match, the board name has to start with the project key. For example, if the project key is "PKEY":
++[[image:attach:image2019-9-10_11-24-16.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="548" width="1100"]]
--* Board names like "PKEY", "PKEY Kanban Board", "PKEY_Team_Board", "PKEY-CoolBoard" etc. will have their Administrators managed by the DevOps Portal
--* Board names like "_PKEY MyBoard" or "Joe's Board" don't have a "PKEY" prefix. They will not be managed by the DevOps Portal.
--* If no boards were created manually, no changes are needed, as “PKEY” is the default name for automatically created boards. These boards will continue to be recognized and managed by DevOps Portal as before.If any boards were created manually, please review their names and rename them as necessary to ensure the desired behavior.
--Because board administrators have the ability to rename their boards, each administrator can choose whether to keep a board managed by DevOps Portal or convert it into an independent board where the list of administrators is maintained manually in Jira.
--{{/info}}
--
  === Configuring Columns of a Board ===
  To Edit the columns of the board (e.g. you would like to create a new column) just click Columns tab on the left.
@@ -140,23 +140,23 @@
  First  a new status can be created by clicking **Add status**:
--[[image:image2019-9-10_11-39-43.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="396" width="1100"]]
++[[image:attach:image2019-9-10_11-39-43.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="396" width="1100"]]
  In the appearing window type //Blocked// for the name than click **Add** to create a new status.
--[[image:image2019-9-10_11-56-24.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="205" width="461"]]
++[[image:attach:image2019-9-10_11-56-24.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="205" width="461"]]
  Then the new column can be created by clicking **Add column**:
--[[image:image2019-9-10_11-58-34.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="498" width="1100"]]
++[[image:attach:image2019-9-10_11-58-34.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="498" width="1100"]]
  In the appearing window type //Blocked// for the name than click **Add** to create a new column.
--[[image:image2019-9-10_12-1-13.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="218" width="483"]]
++[[image:attach:image2019-9-10_12-1-13.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="218" width="483"]]
  Now the new column with a new status has been created:
--[[image:image2019-9-10_12-2-2.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="454" width="1100"]]
++[[image:attach:image2019-9-10_12-2-2.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="454" width="1100"]]
  You can also change the columns order with a drag and drop method.
@@ -164,13 +164,13 @@
  To configure the rows (to group issues) click **Swimlanes** on the left then select from** Base Swimlanes** on:
--[[image:image2019-9-10_14-2-23.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="434" width="1100"]]
++[[image:attach:image2019-9-10_14-2-23.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="434" width="1100"]]
  === Configuring quick filters ===
  You can set custom filter tabs for the board - in this example a new tab named Max Mustermann is created, and by clicking this tab only the user's issues visible:
--[[image:image2019-9-10_11-48-1.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="273" width="1100"]]
++[[image:attach:image2019-9-10_11-48-1.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="273" width="1100"]]
  === Other Configuration Options ===
@@ -182,40 +182,151 @@
  You can customize the issue's appearance in **Issue Detail View.**
--== Change the Project Lead in Jira ==
++= Manage Projects =
--Select the user who would be the **Project Lead **on the top (in this example Barney Rubble), and change the **Default Assignee** to Project Lead, then click **Update**:
++{{info}}
++**Prerequisites**
--[[image:image2019-9-4_11-36-39.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="204" width="450"]]
++1. You are logged in to Jira.
++1. You have at least ADMIN role on this project.
++{{/info}}
--Now as the example shows Barney Rubble is the //Project Lead//, and this user will be the //Default Assignee// of the created issues:
++Click on the **Administration icon** in the top right corner, then select **Projects**:
--[[image:image2019-9-4_11-38-46.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="133" width="450"]]
++[[image:attach:image2019-9-4_11-19-54.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="128" width="255"]]
--== Manage Users and Roles ==
++Click on the selected** project** (in this example //Future cloud Infrastructure//):
--Open your project, click on **Project settings icon** in the bottom-left corner of Jira**.**
++[[image:attach:image2019-9-4_11-41-16.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="336" width="1100"]]
++The **Summary** page of the **Project settings** appear:
++
++[[image:attach:image2019-9-12_10-14-5.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="512" width="1100"]]
++
++In the left column you can find the category of the settings, which are also visible in the **Summary** page.
++
++If you click Details on the left you can a brief information of the current project.
++
++[[image:attach:image2019-9-12_10-17-29.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" width="600"]]
++
++You can change the name or the description of the project but it is not allowed to change the Project Key - which is managed in SDPortal.
++
++== Manage Issue types ==
++
++{{info}}
++**Prerequisites**
++
++1. You are logged in to Jira.
++1. You have at least ADMIN role on this project to be able to manage issue types.
++{{/info}}
++
++Click left on **Issue types** to see what type of issues are used in the project..
++
++{{info}}
++💡 **Reminder**
++
++You can only add/ modify an issue type if you have the permission to manage the set of issue types called //Issue Type Scheme.//
++{{/info}}
++
++By default there are 5 issue types you can choose from: S//tory, Bug, Epic, Task or Sub-task.//
++
++[[image:attach:image2019-9-12_10-23-32.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="397" width="1100"]]
++
++Each issue type belongs to a workflow, which can be seen by clicking the issue types on the left. You can see the same chart if you click Workflows the select the issue type.
++
++== Manage Workflows and Fields ==
++
++Click Workflows on the left, then select an issue type. In this example it is the// Story~://
++
++[[image:attach:image2019-9-12_10-35-41.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="514" width="1100"]]
++
++You can see the workflow of thee issue type, which can be change by clicking **Edit**, or you can modify the fields by clicking **Fields**.
++
++[[image:attach:image2019-9-12_10-39-40.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="432" width="1100"]]
++
++You can also edit the fields by clicking **Fields** on the left.
++
++== Manage Priorities ==
++
++You can see the issue priority types by clicking **Priorities** on the left column:
++
++[[image:attach:image2019-9-12_10-45-30.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="387" width="1100"]]
++
++By default there are 6 priority types: //Highest, High, Medium, Low, Lowest and Major.//
++
++{{info}}
++💡 **Reminder**
++
++You can only add a new priority type if you have the permission to manage the set of issue types called Priority T//ype Scheme.//
++{{/info}}
++
++== Manage users ==
++
  Select **Users and roles** on the left menu and you can see the users and groups with the assigned roles:
--[[image:image2019-9-4_11-27-48.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="661" width="1100"]]
++[[image:attach:image2019-9-4_11-27-48.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="661" width="1100"]]
--As a project admin you can change the role assignments here, but please note that if you trigger a "Resync project and roles" in the DevOps Portal, it will reset the roles to exactly what has been defined in the Portal. Therefore changes here, make most sense for temporarily exceptions for certain user, e.g. to raise their possibilities for a limited amount of time.
++== Change the Project Lead in Jira ==
--= View Project Permissions =
++Select the user who would be the **Project Lead **on the top (in this example Barney Rubble), and change the **Default Assignee** to Project Lead, then click **Update**:
--Click on** Permissions **as seen below view the permissions of the 4 project roles:
++[[image:attach:image2019-9-4_11-36-39.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="204" width="450"]]
--[[image:image2019-9-11_10-41-21.png||data-xwiki-image-style-border="true" height="605" width="1100"]]
++Now as the example shows Barney Rubble is the //Project Lead//, and this user will be the //Default Assignee// of the created issues:
--For more details refer to [[Users and roles>>https://prd.sdc.t-systems.net/xwiki/wiki/sdcloud/view/DRAFT%20DevOps%20Portal%20for%20Creators%20and%20Admins/Users%20and%20roles/]]
++[[image:attach:image2019-9-4_11-38-46.png||data-xwiki-image-style-border="true" queryparams="effects=drop-shadow" height="133" width="450"]]
--= Links to Jira vendor documentation =
++== Manage user permissions ==
--* [[Scrum Guide>>https://www.atlassian.com/agile/scrum]]
--* [[Kanban Guide>>https://www.atlassian.com/agile/kanban]]
--* [[Agile Epic and user stories>>https://www.atlassian.com/agile/project-management/epics-stories-themes]]
--* [[Jira Board>>https://www.atlassian.com/software/jira/guides/boards/overview#what-is-a-jira-board]]
--* [[Jira Work Items/Issues>>https://www.atlassian.com/software/jira/guides/issues/overview#what-is-jira-work%20item-hierarchy]]
++[[image:attach:image2019-9-11_10-41-21.png||data-xwiki-image-style-border="true" height="605" width="1100"]]
++= {{id name="jira_project_roles"/}}JIRA Project Roles / Permission Scheme =
++
++Jira is using the SDCloud Permission Scheme which is associated with Jira projects.
++
++(% class="table-bordered" %)
++(% class="active" %)|=Permission / Role|=Admin|=Master|=Developer|=Viewer
++(% class="active" %)|=Project Permissions| | | |
++|=(% class="active" %)Administer projects Enabled Extended project administration|✅|❌|❌|❌
++|=(% class="active" %)Browse projects|✅|✅|✅|✅
++|=(% class="active" %)Manage sprints|✅|✅|❌|❌
++|=(% class="active" %)Service Desk Agent *|✅|✅|✅|❌
++|=(% class="active" %)View development tool|✅|✅|✅|✅
++|=(% class="active" %)View (read-only) workflow|✅|✅|✅|✅
++(% class="active" %)|=Issue Permissions| | | |
++|=(% class="active" %)Assign issues|✅|✅|✅|❌
++|=(% class="active" %)Assignable user|✅|✅|✅|❌
++|=(% class="active" %)Close issues|✅|✅|❌|❌
++|=(% class="active" %)Create issues|✅|✅|✅|❌
++|=(% class="active" %)Delete issues|✅|❌|❌|❌
++|=(% class="active" %)Edit issues|✅|✅|✅|❌
++|=(% class="active" %)Link issues|✅|✅|✅|❌
++|=(% class="active" %)Modify reporter|✅|✅|❌|❌
++|=(% class="active" %)Move issues|✅|✅|❌|❌
++|=(% class="active" %)Resolve issues|✅|✅|✅|❌
++|=(% class="active" %)Schedule issues|✅|✅|❌|❌
++|=(% class="active" %)Set issues security|✅|❌|❌|❌
++|=(% class="active" %)Transition issues|✅|✅|✅|❌
++(% class="active" %)|=Voters & watchers permissions|= |= |= |=
++|=(% class="active" %)Manage watcher list|✅|✅|❌|❌
++|=(% class="active" %)View voters and watchers|✅|✅|✅|❌
++(% class="active" %)|=Comments permissions|= |= |= |=
++|=(% class="active" %)Add comments|✅|✅|✅|❌
++|=(% class="active" %)Delete all comments|✅|❌|❌|❌
++|=(% class="active" %)Delete own comments|✅|✅|✅|❌
++|=(% class="active" %)Edit all comments|✅|❌|❌|❌
++|=(% class="active" %)Edit own comments|✅|✅|✅|❌
++(% class="active" %)|=Attachments permissions| | | |
++|=(% class="active" %)Create attachments|✅|✅|✅|❌
++|=(% class="active" %)Delete all attachments|✅|❌|❌|❌
++|=(% class="active" %)Delete own attachments|✅|✅|✅|❌
++(% class="active" %)|=Time-tracking Permissions| | | |
++|=(% class="active" %)Work on issues|✅|✅|✅|❌
++|=(% class="active" %)Delete all worklogs|✅|❌|❌|❌
++|=(% class="active" %)Delete own worklogs|✅|✅|✅|❌
++|=(% class="active" %)Edit all worklogs|✅|❌|❌|❌
++|=(% class="active" %)Edit own worklogs|✅|✅|✅|❌
++
++~* Service Desk Agent is only available if the software was added to JIRA
++

image2019-9-11_10-41-21.png

Author

@@ -1,1 +1,1 @@
--xwiki:XWiki.borisfolgmannt-systemscom
++xwiki:XWiki.sdcloud-admin-0

Size

@@ -1,1 +1,1 @@
--103.0 KB
++119.9 KB

Content

image2019-9-4_11-27-48.png

Author

@@ -1,1 +1,1 @@
--xwiki:XWiki.borisfolgmannt-systemscom
++xwiki:XWiki.sdcloud-admin-0

Size

@@ -1,1 +1,1 @@
--100.3 KB
++100.5 KB

Content