Search icon CANCEL
Subscription
0
Cart icon
Your Cart (0 item)
Close icon
You have no products in your basket yet
Arrow left icon
Explore Products
Best Sellers
New Releases
Books
Videos
Audiobooks
Learning Hub
Free Learning
Arrow right icon
JIRA 7 Administration Cookbook
JIRA 7 Administration Cookbook

JIRA 7 Administration Cookbook: Over 80 hands-on recipes to help you efficiently administer, customize, and extend your JIRA 7 implementation , Second Edition

Arrow left icon
Profile Icon Patrick Li
Arrow right icon
$19.99 per month
Full star icon Full star icon Full star icon Full star icon Empty star icon 4 (3 Ratings)
Paperback May 2016 264 pages 2nd Edition
eBook
$29.99 $43.99
Paperback
$54.99
Subscription
Free Trial
Renews at $19.99p/m
Arrow left icon
Profile Icon Patrick Li
Arrow right icon
$19.99 per month
Full star icon Full star icon Full star icon Full star icon Empty star icon 4 (3 Ratings)
Paperback May 2016 264 pages 2nd Edition
eBook
$29.99 $43.99
Paperback
$54.99
Subscription
Free Trial
Renews at $19.99p/m
eBook
$29.99 $43.99
Paperback
$54.99
Subscription
Free Trial
Renews at $19.99p/m

What do you get with a Packt Subscription?

Free for first 7 days. $19.99 p/m after that. Cancel any time!
Product feature icon Unlimited ad-free access to the largest independent learning library in tech. Access this title and thousands more!
Product feature icon 50+ new titles added per month, including many first-to-market concepts and exclusive early access to books as they are being written.
Product feature icon Innovative learning tools, including AI book assistants, code context explainers, and text-to-speech.
Product feature icon Thousands of reference materials covering every tech concept you need to stay up to date.
Subscribe now
View plans & pricing
Table of content icon View table of contents Preview book icon Preview Book

JIRA 7 Administration Cookbook

Chapter 2.  Customizing JIRA for Your Projects

In this chapter, we will cover the following topics:

  • Setting up different issue types for projects
  • Making a field required
  • Making the assignee field required
  • Hiding a field from view
  • Choosing a different field renderer
  • Creating a new field configuration
  • Setting up customized screens for your project
  • Removing a select list's none option
  • Adding help tips to custom fields
  • Using JavaScript with custom fields
  • Creating your own custom field types
  • Customizing project agile boards

Introduction

An information system such as Atlassian JIRA is only as useful as the data that goes into it, so it is no surprise that JIRA is very flexible when it comes to letting you customize the fields and screens. JIRA comes with a suite of default fields to help you get it up and running quickly, and it also allows you to add your own fields, called custom fields, to address your unique needs.

In this chapter, we will learn not only about how to create these custom fields in JIRA, but also the different behaviors that these fields can have. We will end the chapter by showing you an example of expanding the types of custom fields that you can have with third-party add-ons, and using scripts to create your own field logic.

Setting up different issue types for projects

JIRA comes with a number of issue types out of the box, that are designed for software project management. However, over time, you might find that these issue types do not apply to all of your projects, and you have added your own. In this recipe, we will look at how to manage the issue types so that each project can have its own set of issue types.

How to do it...

Proceed with the following steps to set up a project-specific issue type list:

  1. Navigate to Administration | Issues | Issue Type Schemes.
  2. Click on the Add Issue Type Scheme button.
  3. Enter the name for the new issue type scheme.
  4. Add issue types to the scheme by dragging them from right to left.
  5. Select the default issue type.
  6. Click on the Save button to create the new scheme, as shown in the following screenshot:
    How to do it...

Having created your new issue type scheme, you now need to apply it to projects in which you want to restrict issue type selections:

  1. Click on the Associate link for the new issue type...

Making a field required

Required fields such as Summary and Issue Type have a little red asterisk next to them, which means they must have a value when you are creating or updating an issue. This is a great way to ensure that users do not skip filling in important information.

We will look at how to make any fields of your choice required in this recipe, with field configurations. A field configuration controls the behavior of a field; this includes the field's mandatory requirements, visibility, renderer, and description.

How to do it...

Proceed with the following steps to make a field required in JIRA:

  1. Log into JIRA as a JIRA administrator.
  2. Navigate to Administration | Issues | Field Configurations.
  3. Click on the Configure link for the field configuration used by the project and issue type.
  4. Click on the Required link for the Due Date field.

Once you have marked the Due Date field as required, whenever you create or edit an issue, JIRA will make sure a value is entered for it, as shown in...

Making the assignee field required

By default, the assignee field has an unassigned option, which is equivalent to making the field optional. If you check out field configuration, you would realize that you cannot make the assignee field required, as there is no such option available.

In this recipe, we will look at how to disable the unassigned option, effectively making the assignee a required field.

Getting ready

You cannot disable the unassigned option if you have:

  • Issues that are currently using that option for the assignee
  • Projects that have an unassigned set as the default

How to do it...

Proceed with the following steps to disable the unassigned option:

  1. Log in to JIRA as a JIRA administrator.
  2. Navigate to Administration | System.
  3. Click on the Edit Settings button.
  4. Scroll down, and select the OFF option for Allow unassigned issues; click on Update.

As shown in the following screenshot, once the option is disabled, issues can no longer be unassigned:

How to do it...

Hiding a field from view

There will be times when a field is no longer needed. When this happens, instead of deleting the field, which would also remove all its data, you can choose to hide it. So if you need the field again further down the track, you can simply unhide it, and retain all the data.

In this recipe, we will be hiding both the Priority and Due Date fields.

How to do it...

Proceed with the following steps to hide a field in JIRA:

  1. Log in to JIRA as a JIRA administrator.
  2. Navigate to Administration | Issues | Field Configurations.
  3. Click on the Configure link for the field configuration used by the project and issue type.
  4. Click on the Hide link for Priority and Due Date.

    Note

    Clicking on the Show link will unhide the field. You cannot hide a mandatory field.

There's more...

Using field configuration is one way to hide fields from the user. There are two more ways to make a field hidden from view:

  • Take the field off screen. Note that for the View screen, default fields such as summary...

Introduction


An information system such as Atlassian JIRA is only as useful as the data that goes into it, so it is no surprise that JIRA is very flexible when it comes to letting you customize the fields and screens. JIRA comes with a suite of default fields to help you get it up and running quickly, and it also allows you to add your own fields, called custom fields, to address your unique needs.

In this chapter, we will learn not only about how to create these custom fields in JIRA, but also the different behaviors that these fields can have. We will end the chapter by showing you an example of expanding the types of custom fields that you can have with third-party add-ons, and using scripts to create your own field logic.

Setting up different issue types for projects


JIRA comes with a number of issue types out of the box, that are designed for software project management. However, over time, you might find that these issue types do not apply to all of your projects, and you have added your own. In this recipe, we will look at how to manage the issue types so that each project can have its own set of issue types.

How to do it...

Proceed with the following steps to set up a project-specific issue type list:

  1. Navigate to Administration | Issues | Issue Type Schemes.

  2. Click on the Add Issue Type Scheme button.

  3. Enter the name for the new issue type scheme.

  4. Add issue types to the scheme by dragging them from right to left.

  5. Select the default issue type.

  6. Click on the Save button to create the new scheme, as shown in the following screenshot:

Having created your new issue type scheme, you now need to apply it to projects in which you want to restrict issue type selections:

  1. Click on the Associate link for the new issue type scheme...

Making a field required


Required fields such as Summary and Issue Type have a little red asterisk next to them, which means they must have a value when you are creating or updating an issue. This is a great way to ensure that users do not skip filling in important information.

We will look at how to make any fields of your choice required in this recipe, with field configurations. A field configuration controls the behavior of a field; this includes the field's mandatory requirements, visibility, renderer, and description.

How to do it...

Proceed with the following steps to make a field required in JIRA:

  1. Log into JIRA as a JIRA administrator.

  2. Navigate to Administration | Issues | Field Configurations.

  3. Click on the Configure link for the field configuration used by the project and issue type.

  4. Click on the Required link for the Due Date field.

Once you have marked the Due Date field as required, whenever you create or edit an issue, JIRA will make sure a value is entered for it, as shown in the following...

Making the assignee field required


By default, the assignee field has an unassigned option, which is equivalent to making the field optional. If you check out field configuration, you would realize that you cannot make the assignee field required, as there is no such option available.

In this recipe, we will look at how to disable the unassigned option, effectively making the assignee a required field.

Getting ready

You cannot disable the unassigned option if you have:

  • Issues that are currently using that option for the assignee

  • Projects that have an unassigned set as the default

How to do it...

Proceed with the following steps to disable the unassigned option:

  1. Log in to JIRA as a JIRA administrator.

  2. Navigate to Administration | System.

  3. Click on the Edit Settings button.

  4. Scroll down, and select the OFF option for Allow unassigned issues; click on Update.

As shown in the following screenshot, once the option is disabled, issues can no longer be unassigned:

Hiding a field from view


There will be times when a field is no longer needed. When this happens, instead of deleting the field, which would also remove all its data, you can choose to hide it. So if you need the field again further down the track, you can simply unhide it, and retain all the data.

In this recipe, we will be hiding both the Priority and Due Date fields.

How to do it...

Proceed with the following steps to hide a field in JIRA:

  1. Log in to JIRA as a JIRA administrator.

  2. Navigate to Administration | Issues | Field Configurations.

  3. Click on the Configure link for the field configuration used by the project and issue type.

  4. Click on the Hide link for Priority and Due Date.

    Note

    Clicking on the Show link will unhide the field. You cannot hide a mandatory field.

There's more...

Using field configuration is one way to hide fields from the user. There are two more ways to make a field hidden from view:

  • Take the field off screen. Note that for the View screen, default fields such as summary and description...

Choosing a different field renderer


Most custom field types, such as select lists and text fields, can be rendered in multiple ways. For example, select lists can be rendered either with an autocomplete feature or as a simple, standard drop-down list.

In this recipe, we will be changing the Components field to use Select List Renderer so that we can see all the available selections.

How to do it...

Proceed with the following steps to change the option:

  1. Log in to JIRA as a JIRA administrator.

  2. Navigate to Administration | Issues | Field Configurations.

  3. Click on the Configure link for the field configuration used by the project and issue type.

  4. Click on the Renders link for the field to change.

  5. Select the new renderer type from the Active Renderer drop-down list.

  6. Click on Update to apply the change, as shown in the following screenshot:

There's more...

JIRA comes with several field renderers to choose from, and you can install custom renderers from third-party vendors. A good example is the JEditor add...

Creating a new field configuration


As we have seen in previous recipes, you can configure a field's behavior with field configuration. JIRA not only comes with a default field configuration that is applied to all project and issue types by default, but it also lets you create your own so that you can choose the projects and/or issue types to apply your field configuration to.

In this recipe, we will make the Description and Assignee fields required only for the Task issue type.

How to do it...

Setting up a new field configuration is a three-step process. The first step is to create the new field configurations:

  1. Log in to JIRA as a JIRA administrator.

  2. Navigate to Administration | Issues | Field Configurations.

  3. Click on the Add Field Configuration button, and name it Task Field Configuration; click on Add.

  4. Click on the Required link for the Description and Assignee fields.

The second step is to associate the new field configuration with a new field configuration scheme:

  1. Navigate to Administration ...

Setting up customized screens for your project


JIRA comes with three screens by default: the Default Screen, the Resolve Issue Screen, and the Workflow Screen.

In this recipe, we will look at how to create a new screen from scratch, and then make it appear when we are creating a new issue of type Task.

How to do it...

The screen is one of the most complicated configurations in JIRA. To create a new screen and apply it often requires you to configure multiple schemes. So we will break these steps into three logical groups.

Firstly, we need to create our new screen:

  1. Log in to JIRA as a JIRA administrator.

  2. Navigate to Administration | Issues | Screens.

  3. Click on the Add Screen button, and name the new screen Task Create Screen click on Add.

  4. Select and add the Summary, Issue Type, Description, Assignee, and Reporter fields, as shown in the following screenshot:

Secondly, we need to assign the new Task Create Screen to the Create Issue operation:

  1. Navigate to Administration | Issues | Screen schemes.

  2. Click...

Left arrow icon Right arrow icon

Key benefits

  • Make JIRA adapt to your organization and process flow
  • Gather and display the right information from users with customized forms and layouts
  • Extend the capabilities of JIRA with add-ons, scripts, and integrations with other popular applications and cloud platforms
  • Use JIRA Service Desk as a customer service support portal

Description

JIRA 7 Administration Cookbook, Second Edition covers all the new major features that provide better prioritizing capabilities, enhanced visibility, and the ability to customize JIRA application to meet your needs. We start by upgrading your existing JIRA instance and working through tasks you can perform at the server level to better maintain it. We then delve deep into adapting JIRA to your organization's needs, starting with the visual elements of setting up custom forms to capturing important data with custom fields and screens, and moving on to ensuring data integrity through defining field behaviors. You'll gain insights into JIRA's e-mail capabilities, including managing outgoing e-mail rules and processing incoming e-mails for automated issue creation. The book contains tips and tricks that will make things easier for you as administrators, such as running scripts to automate tasks, getting easy access to logs, and working with tools to troubleshoot problems. The book concludes with a chapter on JIRA Service Desk, which will enable you to set up and customize your own support portal, work with internal teams to solve problems, and achieve optimized services with SLA.

Who is this book for?

This book is for administrators who customize, support, and maintain JIRA for their organization.

What you will learn

  • Customize basic settings for your projects, such as screens and fields
  • Create and customize workflows to suit your business process needs
  • Make workflows more effective and efficient
  • Manage users and groups inside JIRA and manage advanced login options
  • Secure your JIRA instance using effective practices
  • Perform e-mail functionalities with JIRA
  • Extend JIRA to integrate with other products and services

Product Details

Country selected
Publication date, Length, Edition, Language, ISBN-13
Publication date : May 26, 2016
Length: 264 pages
Edition : 2nd
Language : English
ISBN-13 : 9781785888441
Vendor :
Atlassian
Languages :
Tools :

What do you get with a Packt Subscription?

Free for first 7 days. $19.99 p/m after that. Cancel any time!
Product feature icon Unlimited ad-free access to the largest independent learning library in tech. Access this title and thousands more!
Product feature icon 50+ new titles added per month, including many first-to-market concepts and exclusive early access to books as they are being written.
Product feature icon Innovative learning tools, including AI book assistants, code context explainers, and text-to-speech.
Product feature icon Thousands of reference materials covering every tech concept you need to stay up to date.
Subscribe now
View plans & pricing

Product Details

Publication date : May 26, 2016
Length: 264 pages
Edition : 2nd
Language : English
ISBN-13 : 9781785888441
Vendor :
Atlassian
Languages :
Tools :

Packt Subscriptions

See our plans and pricing
Modal Close icon
$19.99 billed monthly
Feature tick icon Unlimited access to Packt's library of 7,000+ practical books and videos
Feature tick icon Constantly refreshed with 50+ new titles a month
Feature tick icon Exclusive Early access to books as they're written
Feature tick icon Solve problems while you work with advanced search and reference features
Feature tick icon Offline reading on the mobile app
Feature tick icon Simple pricing, no contract
$199.99 billed annually
Feature tick icon Unlimited access to Packt's library of 7,000+ practical books and videos
Feature tick icon Constantly refreshed with 50+ new titles a month
Feature tick icon Exclusive Early access to books as they're written
Feature tick icon Solve problems while you work with advanced search and reference features
Feature tick icon Offline reading on the mobile app
Feature tick icon Choose a DRM-free eBook or Video every month to keep
Feature tick icon PLUS own as many other DRM-free eBooks or Videos as you like for just $5 each
Feature tick icon Exclusive print discounts
$279.99 billed in 18 months
Feature tick icon Unlimited access to Packt's library of 7,000+ practical books and videos
Feature tick icon Constantly refreshed with 50+ new titles a month
Feature tick icon Exclusive Early access to books as they're written
Feature tick icon Solve problems while you work with advanced search and reference features
Feature tick icon Offline reading on the mobile app
Feature tick icon Choose a DRM-free eBook or Video every month to keep
Feature tick icon PLUS own as many other DRM-free eBooks or Videos as you like for just $5 each
Feature tick icon Exclusive print discounts

Frequently bought together


Stars icon
Total $ 169.97
JIRA 7 Essentials
$65.99
Mastering JIRA 7
$48.99
JIRA 7 Administration Cookbook
$54.99
Total $ 169.97 Stars icon
Banner background image

Table of Contents

9 Chapters
1. JIRA Server Administration Chevron down icon Chevron up icon
2. Customizing JIRA for Your Projects Chevron down icon Chevron up icon
3. JIRA Workflows Chevron down icon Chevron up icon
4. User Management Chevron down icon Chevron up icon
5. JIRA Security Chevron down icon Chevron up icon
6. E-mails and Notifications Chevron down icon Chevron up icon
7. Integrations with JIRA Chevron down icon Chevron up icon
8. JIRA Troubleshooting Chevron down icon Chevron up icon
9. JIRA Service Desk Chevron down icon Chevron up icon

Customer reviews

Rating distribution
Full star icon Full star icon Full star icon Full star icon Empty star icon 4
(3 Ratings)
5 star 33.3%
4 star 33.3%
3 star 33.3%
2 star 0%
1 star 0%
praveen ad Feb 14, 2017
Full star icon Full star icon Full star icon Full star icon Full star icon 5
I just ordered this book , let me see once i will go through.ThanksPraveen
Amazon Verified review Amazon
J. Kelly Jan 16, 2017
Full star icon Full star icon Full star icon Full star icon Empty star icon 4
I like the clear and concise steps to accomplish various administrative tasks. It was great to learn how to integrate JIRA with Google drive (and possibly Box) to link documents with tickets.
Amazon Verified review Amazon
Amazon Customer Dec 24, 2016
Full star icon Full star icon Full star icon Empty star icon Empty star icon 3
Good Book if you follow along with the Workflow Samples. Also note, updates are frequent from Atlassian so gets outdated very Quickly. The online Support Page from Atlassian is a better resource. A good section of the Book could have been dedicated to Add-ons and Plug-ins.
Amazon Verified review Amazon
Get free access to Packt library with over 7500+ books and video courses for 7 days!
Start Free Trial

FAQs

What is included in a Packt subscription? Chevron down icon Chevron up icon

A subscription provides you with full access to view all Packt and licnesed content online, this includes exclusive access to Early Access titles. Depending on the tier chosen you can also earn credits and discounts to use for owning content

How can I cancel my subscription? Chevron down icon Chevron up icon

To cancel your subscription with us simply go to the account page - found in the top right of the page or at https://subscription.packtpub.com/my-account/subscription - From here you will see the ‘cancel subscription’ button in the grey box with your subscription information in.

What are credits? Chevron down icon Chevron up icon

Credits can be earned from reading 40 section of any title within the payment cycle - a month starting from the day of subscription payment. You also earn a Credit every month if you subscribe to our annual or 18 month plans. Credits can be used to buy books DRM free, the same way that you would pay for a book. Your credits can be found in the subscription homepage - subscription.packtpub.com - clicking on ‘the my’ library dropdown and selecting ‘credits’.

What happens if an Early Access Course is cancelled? Chevron down icon Chevron up icon

Projects are rarely cancelled, but sometimes it's unavoidable. If an Early Access course is cancelled or excessively delayed, you can exchange your purchase for another course. For further details, please contact us here.

Where can I send feedback about an Early Access title? Chevron down icon Chevron up icon

If you have any feedback about the product you're reading, or Early Access in general, then please fill out a contact form here and we'll make sure the feedback gets to the right team. 

Can I download the code files for Early Access titles? Chevron down icon Chevron up icon

We try to ensure that all books in Early Access have code available to use, download, and fork on GitHub. This helps us be more agile in the development of the book, and helps keep the often changing code base of new versions and new technologies as up to date as possible. Unfortunately, however, there will be rare cases when it is not possible for us to have downloadable code samples available until publication.

When we publish the book, the code files will also be available to download from the Packt website.

How accurate is the publication date? Chevron down icon Chevron up icon

The publication date is as accurate as we can be at any point in the project. Unfortunately, delays can happen. Often those delays are out of our control, such as changes to the technology code base or delays in the tech release. We do our best to give you an accurate estimate of the publication date at any given time, and as more chapters are delivered, the more accurate the delivery date will become.

How will I know when new chapters are ready? Chevron down icon Chevron up icon

We'll let you know every time there has been an update to a course that you've bought in Early Access. You'll get an email to let you know there has been a new chapter, or a change to a previous chapter. The new chapters are automatically added to your account, so you can also check back there any time you're ready and download or read them online.

I am a Packt subscriber, do I get Early Access? Chevron down icon Chevron up icon

Yes, all Early Access content is fully available through your subscription. You will need to have a paid for or active trial subscription in order to access all titles.

How is Early Access delivered? Chevron down icon Chevron up icon

Early Access is currently only available as a PDF or through our online reader. As we make changes or add new chapters, the files in your Packt account will be updated so you can download them again or view them online immediately.

How do I buy Early Access content? Chevron down icon Chevron up icon

Early Access is a way of us getting our content to you quicker, but the method of buying the Early Access course is still the same. Just find the course you want to buy, go through the check-out steps, and you’ll get a confirmation email from us with information and a link to the relevant Early Access courses.

What is Early Access? Chevron down icon Chevron up icon

Keeping up to date with the latest technology is difficult; new versions, new frameworks, new techniques. This feature gives you a head-start to our content, as it's being created. With Early Access you'll receive each chapter as it's written, and get regular updates throughout the product's development, as well as the final course as soon as it's ready.We created Early Access as a means of giving you the information you need, as soon as it's available. As we go through the process of developing a course, 99% of it can be ready but we can't publish until that last 1% falls in to place. Early Access helps to unlock the potential of our content early, to help you start your learning when you need it most. You not only get access to every chapter as it's delivered, edited, and updated, but you'll also get the finalized, DRM-free product to download in any format you want when it's published. As a member of Packt, you'll also be eligible for our exclusive offers, including a free course every day, and discounts on new and popular titles.