JIRA 5.x Development Cookbook

JIRA 5.x Development Cookbook

Overview of this book

JIRA provides issue tracking and project tracking for software development teams to improve code quality and the speed of development. "JIRA 5.x Development Cookbook" is a one stop resource to master extensions and customizations in JIRA. You will learn how to create your own JIRA plugins, customize the look and feel of your JIRA UI, work with workflows, issues, custom fields, and much more. "JIRA 5.x Development Cookbook" starts with recipes on simplifying the plugin development process followed by a complete chapter dedicated to the plugin framework to master plugins in JIRA. Then we will move on to writing custom field plugins to create new field types or custom searchers. We then learn how to program and customize workflows to transform JIRA into a user friendly system. Reporting support in an application like JIRA is inevitable! With so much data spanning across different projects, issues, and so on, and a lot of planning done for the project, we will cover how to work on reports and gadgets to get customized data according to our needs. We will then look at customizing the various searching aspects of JIRA such as JQL, searching in plugins, managing filters, and so on. "JIRA 5.x Development Cookbook" steers towards programming issues, such as creating, editing, and deleting issues, creating new issue operations, managing the various other operations available on issues via the JIRA APIs, and so on. In the latter half of "JIRA 5.x Development Cookbook", you will learn how to customize JIRA by adding new tabs, menus, and web items, communicate with JIRA via the REST, SOAP or XML/RPC interfaces, and work with the JIRA database. The book ends with a chapter on useful and general JIRA recipes.

JIRA 5.x Development Cookbook

Credits

About the Author

Acknowledgement

About the Reviewers

www.PacktPub.com

Preface

Free Chapter

Plugin Development Process

Introduction

Setting up the development environment

Creating a skeleton plugin

Adding plugin modules

Deploying a JIRA plugin

Making changes to and redeploying a plugin

Using FastDev for plugin development

Testing and debugging

Understanding the Plugin Framework

Introduction

Architecture explained

Types of plugin modules

Working with the Plugins1 and Plugins2 versions

JIRA system plugins

Stable and core APIs

Modifying Atlassian bundled plugins

Converting plugins from v1 to v2

Adding resources into plugins

Adding web resources into plugins

Building JIRA from source

Adding new webwork actions to JIRA

Extending a webwork action in JIRA

Capturing plugin installation/uninstallation events

Working with Custom Fields

Introduction

Writing a simple custom field

Custom field searchers

Dealing with custom fields on an issue

Programming custom field options

Overriding validation of custom fields

Customizing the change log value

Migrating from one custom field type to another

Making custom fields sortable

Displaying custom fields on subtask columns

User and date fields

Adding custom fields to notification mails

Adding help text for a custom field

Removing the "none" option from a select field

Making the custom field project importable

Changing the size of a text area custom field

Programming Workflows

Introduction

Writing a workflow condition

Writing a workflow validator

Writing a workflow post function

Editing an active workflow

Making an issue editable/non-editable based on workflow status

Including/excluding resolutions for specific transitions

Permissions based on workflow status

Internationalization in workflow transitions

Obtaining available workflow actions programmatically

Programmatically progressing on workflows

Obtaining workflow history from the database

Reordering workflow actions in JIRA

Creating common transitions in workflows

Creating global transitions in workflows

Jelly escalation

Gadgets and Reporting in JIRA

Introduction

Writing a JIRA report

Reports in an Excel format

Data validation in JIRA reports

Restricting access to reports

Object-configurable parameters for reports

Creating a pie chart in JIRA

Writing JIRA 4 gadgets

Invoking REST services from gadgets

Configuring user preferences in gadgets

Accessing gadgets outside of JIRA

The Power of JIRA Searching

Introduction

Writing a JQL function

Sanitizing JQL functions

Adding a search request view

Smart querying using quick search

Searching in plugins

Parsing JQL queries in plugins

Linking directly to search queries

Index and de-index programmatically

Managing filters programmatically

Subscribing to a filter

Programming Issues

Introduction

Creating an issue from a plugin

Creating subtasks on an issue

Updating an issue

Deleting an issue

Adding new issue operations

Conditions on issue operations

Working with attachments

Time tracking and worklog management

Working with comments on issues

Programming change logs

Programming issue links

Discarding fields while cloning

JavaScript tricks on issue fields

Creating issues and comments from an e-mail

Customizing the UI

Introduction

Changing the basic look and feel

Adding new web sections in the UI

Adding new web items in the UI

Use of decorators

Adding conditions for web fragments

Creating new Velocity context for web fragments

Adding a new drop-down menu on the top navigation bar

Dynamic creation of web items

Adding new tabs in the View Issue screen

Adding new tabs in the Browse Project screen

Creating the project tab panel using fragments

Adding new tabs in the Browse Version screen

Adding new tabs in the Browse Component screen

Adding issue link renderers

Extending a webwork action to add UI elements

Displaying dynamic notifications/warnings on issues

Re-ordering issue operations in the View Issue page

Re-ordering fields in the View Issue page

Remote Access to JIRA

Introduction

Writing a Java client for the REST API

Creating a SOAP client

Writing a Java XML-RPC client

Working with issues

Working with attachments

Remote time tracking

Working with comments

Remote user and group management

Progressing an issue in a workflow

Managing versions

Managing components

Remote administration methods

Exposing services and data entities as REST APIs

Deploying a SOAP service in JIRA

Deploying an XML-RPC service within JIRA

Dealing with the JIRA Database

Introduction

Extending the JIRA database with a custom schema

Accessing database entities from plugins

Persisting plugin information in the JIRA database

Using Active Objects to store data

Accessing the JIRA configuration properties

Getting a database connection for JDBC calls

Migrating a custom field from one type to another

Retrieving issue information from a database

Retrieving custom field details from a database

Retrieving permissions on issues from a database

Retrieving workflow details from a database

Updating the issue status in a database

Retrieving users and groups from a database

Dealing with change history in a database

Useful Recipes

Introduction

Writing a service in JIRA

Adding configurable parameters to a service

Writing scheduled tasks in JIRA

Writing listeners in JIRA

Customizing e-mail content

Redirecting to a different page in webwork actions

Adding custom behavior for user details

Deploying a servlet in JIRA

Adding shared parameters to the servlet context

Writing a servlet context listener

Using filters to intercept queries in JIRA

Adding and importing components in JIRA

Adding new module types to JIRA

Enabling access logs in JIRA

Enabling SQL logging in JIRA

Overriding JIRA's default components in plugins

Internationalization in webwork plugins

Sharing common libraries across v2 plugins

Operations using direct HTML links

Index

Customer Reviews

5 star

4 star

3 star

2 star

1 star

Making changes to and redeploying a plugin

Now that we have deployed the test plugin, it is time to add some proper logic, redeploy the plugin, and test it. Making the changes and redeploying a plugin is pretty easy. In this recipe, we will quickly look at how to do this.

How to do it…

You can make changes to the plugin and redeploy it while the JIRA application is still running. Following is how we do it:

Keep the JIRA application running in the window where we executed atlas-run.
Open a new command window and go to the root plugin folder where your pom.xml file resides.
Run atlas-cli.
Wait for the Waiting for commands message to appear.
Run the pi. pi stands for plugin install and this will compile your changes, package the plugin JAR, and install it into the installed-plugins folder.
Note
As of JIRA 4.4, all the modules are reloadable and hence can be redeployed using this technique.

There's more…

It is also possible to run the plugin in debug mode and point your IDE's remote debugger to it.

Debugging in Eclipse

Following are the steps to debug your plugin in Eclipse:

Use atlas-debug instead of atlas-run.
Once the virtual JIRA is up and running with your plugin deployed in it, go to Run | Debug Configurations in Eclipse.
Create a new remote Java application.
Give your application a name, keep the defaults, and give the port number as 5005. This is the default debug port on which the virtual JIRA runs. That's it! Happy debugging!

JIRA 5.x Development Cookbook

JIRA 5.x Development Cookbook

Overview of this book

Related Content you might be interested in

Current Title:

JIRA 5.x Development Cookbook

Making changes to and redeploying a plugin

How to do it…

Note

There's more…

Debugging in Eclipse

See also