JIRA Development Cookbook电子书

JIRA Development Cookbook

Table of Contents

JIRA Development Cookbook

Credits

About the Author

Acknowledgment

About the Reviewers

www.PacktPub.com

Support files, eBooks, discount offers and more

Why Subscribe?

Free Access for Packt account holders

Instant Updates on New Packt Books

Preface

What this book covers

What you need for this book

Who this book is for

Conventions

Reader feedback

Customer support

Downloading the example code for this book

Errata

Piracy

Questions

1. Plugin Development Process

Introduction

What is a JIRA plugin?

The plugin development process

Atlassian plugin exchange

Troubleshooting

Setting up the development environment

Getting ready

How to do it...

How it works...

There's more...

Proxy settings for Maven

Using local Maven

Configuring IDEs to use SDK

Troubleshooting

See also

Creating a skeleton plugin

Getting ready

How to do it...

How it works...

There's more...

One step to your skeleton plugin

Creating an Eclipse project

See also

Deploying a plugin

Getting ready

How to do it...

How it works...

There's more...

Using a specific version of JIRA

Reusing the configurations in each run

Troubleshooting

Making changes and re-deploying a plugin

How to do it...

Debugging in Eclipse

See also

Testing and debugging

Getting ready

How to do it...

How it works...

There's more...

Using custom data for Integration/Functional Tests

Testing against different version of JIRA/Tomcat

See also

2. Understanding Plugin Framework

Introduction

JIRA Architecture

Third-party components

Webwork

Seraph

OSUser

PropertySet

OSWorkflow

OfBiz Entity Engine

Apache Lucene

Atlassian Gadget JavaScript Framework

Quartz

Architecture explained…

Authentication and user management

Property management

Presentation

Database

Workflows

Searching

Scheduled jobs

Plugins

Types of plugin modules

Reporting

Workflows

Custom fields

Searching

Links and tabs

Remote invocation

Actions and components

Other plugin modules

What goes into atlassian-plugin.xml?

Working with the Plugins1 and Plugins2 versions

Development

Installation

JIRA System plugins

Converting plugins from v1 to v2

Getting ready

How to do it...

How it works...

See also

Adding resources into plugins

Getting ready

How to do it...

Adding web resources into plugins

How to do it...

How it works...

There's more...

Web resource contexts

Turning off batchmode

See also

Building JIRA from source

Getting ready

How to do it...

How it works...

There's more...

Building JIRA dependencies

See also

Adding new webwork actions to JIRA

Getting ready

How to do it...

How it works...

There's more...

Adding new commands to the action

See also

Extending a webwork action in JIRA

How to do it...

How it works...

See also

3. Working with Custom Fields

Introduction

Writing a simple custom field

Getting ready

How to do it...

How it works...

There's more...

See also

Custom field searchers

Getting ready

How to do it...

How it works...

There's more...

Dealing with custom fields on an issue

Getting ready

How to do it...

How it works...

See also

Programming custom field options

Getting ready

How to do it...

See also

Overriding validation of custom fields

Getting ready

How to do it...

See also

Customizing the change log value

Getting ready

How to do it...

How it works...

Migrating from one custom field type to another

How to do it...

How it works...

There's more...

Changing the type of a custom field

See also

Making custom fields sortable

Getting ready

How to do it...

How it works...

There's more...

See also

Displaying custom fields on subtask columns

How to do it...

How it works...

User and date fields from 4.1.x

How to do it...

How it works...

See also

Adding custom fields to notification mails

Getting ready

How to do it...

How it works...

Adding help text for a custom field

Getting ready

How to do it...

How it works...

Removing the 'none' option from a select field

How to do it...

There's more...

Reloading velocity changes without restart (auto reloading)

See also

Making the custom field project importable

How to do it...

See also

Changing the size of a text area custom field

How to do it...

See also

4. Programming Workflows

Introduction

Writing a workflow condition

Getting ready

How to do it...

How it works...

See also

Writing a workflow validator

Getting ready

How to do it...

How it works...

See also

Writing a workflow post function

Getting ready

How to do it...

How it works...

See also

Editing an active workflow

How to do it...

How it works...

There's more...

Modifying workflows in JIRA database

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

How to do it...

How it works...

See also

Including/excluding resolutions for specific transitions

How to do it...

How it works...

Permissions based on workflow status

How to do it...

How it works...

See also

Internationalization in workflow transitions

How to do it...

How it works...

See also

Obtaining available workflow actions programmatically

How to do it...

How it works...

There's more...

Getting the Action IDs, given name

Programmatically progressing on workflows

How to do it...

How it works...

Obtaining workflow history from the database

Getting ready

How to do it...

How it works...

See also

Re-ordering workflow actions in JIRA

How to do it...

How it works...

Creating common transitions in workflows

How to do it...

How i works...

Jelly escalation

Getting ready

How to do it...

How it works...

5. Gadgets and Reporting in JIRA

Introduction

Writing a JIRA report

Getting ready

How to do it...

How it works...

See also

Reports in Excel format

Getting ready

How to do it...

How it works...

There's more...

See also

Data validation in JIRA reports

Getting ready

How to do it...

How it works...

See also

Restricting access to reports

Getting ready

How to do it...

How it works...

See also

Object configurable parameters for reports

How to do it...

How it works...

See also

Creating a pie chart in JIRA

Getting ready…

How to do it...

How it works...

There's more...

See also

Writing JIRA 4 gadgets

Getting ready

How to do it...

How it works...

There's more...

Invoking REST services from gadgets

Getting ready

How to do it...

How it works...

See also

Configuring user preferences in gadgets

Getting ready...

How to do it...

How it works...

There's more...

See also

Accessing gadgets outside of JIRA

How to do it...

How it works...

See also

6. The Power of JIRA Searching

Introduction

Writing a JQL function

Getting ready

How to do it...

How it works...

See also

Sanitizing JQL functions

Getting ready

How to do it...

How it works...

See also

Adding a search request view

Getting ready

How to do it...

How it works...

See also

Smart querying using quick search

How to do it...

There's more...

Searching in plugins

How to do it...

There's more...

See also

Parsing a JQL query in plugins

How to do it...

How it works...

See also

Linking directly to search queries

How to do it...

How it works...

There's more...

Index and de-index programmatically

How to do it...

See also

Managing filters programmatically

How to do it...

See also

Subscribing to a filter

How to do it...

How it works...

There's more...

See also

7. Programming Issues

Introduction

Creating an issue from a plugin

How to do it...

How it works...

There's more...

Using IssueManager to create the issue

Creating subtasks on an issue

How to do it...

See also

Updating an issue

How to do it...

Deleting an issue

How to do it...

Adding new issue operations

Getting ready

How to do it...

How it works...

There's more...

See also

Conditions on issue operations

Getting ready...

How to do it...

How it works...

Working with attachments

Getting ready...

How to do it...

Creating an attachment

Reading attachments on an issue

Deleting an attachment

There's more...

Time tracking and worklog management

Getting ready...

How to do it...

Auto adjusting the remaining estimate

Logging work and retaining the remaining estimate

Logging work with a new remaining estimate

Logging work and adjusting the remaining estimate by a value

How it works...

There's more

Updating worklogs

Deleting worklogs

Auto Adjusting remaining estimate

Deleting a worklog and retaining the remaining estimate

Deleting a worklog with a new remaining estimate

Working with comments on issues

How to do it...

Creating comments on issues

Creating comments on an issue and restricting it to a project role or group

Updating comments

Deleting comments

Programming Change Logs

How to do it...

How it works...

Programming issue links

Getting Ready...

How to do it...

There's more...

Deleting Issue Links

Retrieving Issue Links on an issue

Validations on issue linking

Getting Ready...

How to do it...

How it works...

See also

Discarding fields while cloning

Getting ready...

How to do it...

How it works...

See also

JavaScript tricks on issue fields

How to do it...

How it works...

8. Customizing the UI

Introduction

Changing the basic look and feel

How to do it...

Adding new web sections in the UI

How to do it...

How it works...

See also

Adding new web items in the UI

How to do it...

How it works...

See also

Adding conditions for web fragments

How to do it...

How it works...

Creating new velocity context for web fragments

How to do it...

How it works...

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

How to do it...

How it works...

Dynamic creation of web items

Getting ready

How to do it...

How it works...

Adding new tabs in the View Issue screen

Getting ready

How to do it...

How it works...

Adding new tabs in the Browse Project screen

Getting ready

How to do it...

How it works...

Creating Project Tab Panel using fragments

How to do it...

How it works...

Adding new tabs in the Browse Version screen

Getting ready

How to do it...

How it works...

Adding new tabs in the Browse Component screen

Getting ready

How to do it...

How it works...

Extending a webwork action to add UI elements

Getting ready

How to do it...

How it works...

See also

Displaying dynamic notifications/warnings on issues

Getting ready

How to do it...

How it works...

See also

Re-ordering Issue Operations in the View Issue page

How to do it...

How it works...

See also

Re-ordering fields in the View Issue page

How to do it...

9. Remote Access to JIRA

Introduction

Creating a SOAP client

Getting ready

How to do it...

Creating an issue via SOAP

Getting ready

How to do it...

How it works...

Working with custom fields and SOAP

Getting ready

How to do it...

Creating an issue with custom field values

Updating custom fields on an issue

Browsing custom fields on an issue

Attachments and SOAP

Getting ready

How to do it...

Worklogs and time tracking via SOAP

Getting ready...

How to do it...

How it works...

There's more...

Commenting on an issue via SOAP

Getting ready

How to do it...

User and group management via SOAP

Getting ready

How to do it...

Progressing an issue in workflow using SOAP

Getting ready

How to do it...

Managing versions via SOAP

Getting ready

How to do it...

Administration methods in SOAP API

Getting ready

How to do it...

How it works...

Deploy a SOAP service in JIRA

Getting ready

How to do it...

How it works...

Deploy a XML-RPC service within JIRA

Getting ready

How to do it...

How it works...

See also

Writing a Java XML-RPC client

Getting ready

How to do it...

Expose services and data entities as REST APIs

Getting ready

How to do it...

How it works...

Writing Java client for REST API

Getting ready

How to do it...

10. Dealing with a Database

Introduction

Extending JIRA DB with custom schema

How to do it...

How it works...

Accessing DB entities from plugins

How to do it...

Reading from a database

Writing a new record

Updating a record

Persisting plugin information in JIRA DB

How to do it...

How it works...

Using active objects to store data

Getting ready

How to do it...

How it works...

Accessing JIRA configuration properties

How to do it...

Getting database connection for JDBC calls

How to do it...

Migrating a custom field from one type to another

How to do it...

Retrieving issue information from a Database

How to do it...

There's more...

Retrieving custom field details from a database

How to do it...

Retrieving permissions on issues from a database

How to do it...

Retrieving workflow details from a database

How to do it...

Updating issue status in a database

Getting ready

How to do it...

Retrieving users and groups from a database

How to do it...

Dealing with Change history in a database

How to do it...

11. Useful Recipes

Introduction

Writing a service in JIRA

Getting ready

How to do it...

See also

Adding configurable parameters to a service

How to do it…

How it works...

See also

Writing scheduled tasks in JIRA

How to do it...

How it works...

Writing listeners in JIRA

Getting ready

How to do it...

How it works...

There's more...

Handling, enabling, and disabling of plugins

Customizing e-mail content

How to do it...

How it works...

There's more...

Advanced Customization—adding custom field information

Redirecting to different page in webwork actions

How to do it...

Adding custom behavior for user details

Getting ready

How to do it...

How it works...

Deploying a servlet in JIRA

Getting ready

How to do it...

How it works...

Adding shared parameters to Servlet Context

Getting ready

How to do it...

How it works...

Writing a Servlet Context Listener

Getting ready

How to do it...

How it works...

Using filters to intercept queries in JIRA

Getting ready

How to do it...

How it works...

Adding and importing components in JIRA

Getting ready

How to do it...

Exposing components to other plugins

Importing public components

Using service properties in components

How it works...

Adding new module types to JIRA

Getting ready

How to do it...

Creating modules using the new module type

Using the new modules created

How it works...

Enabling access logs in JIRA

How to do it...

Enabling Access logs prior to JIRA 4.x

How it works...

Enabling SQL logging in JIRA

How to do it...

How it works...

Overriding JIRA's default components in plugins

Getting ready

How to do it...

How it works...

There's more...

Overriding by modifying JIRA code

Overriding by extending PicoContainer

Creating issues and comments from e-mail

How to do it...

How it works...

Internationalization in webwork plugins

How to do it...

Sharing common libraries across v2 plugins

Getting ready

How to do it...

Operations using direct HTML links

How to do it...

Index