Practical JIRA Plugins: Using JIRA Effectively: Custom Development

by Matthew Doar, Jonathan Doklovic

Overview

One advantage of using JIRA for issue tracking, bug tracking, or project management is the ability to extend this tool with hundreds of plugins from the JIRA community. In this concise book, software toolsmith Matt Doar—the author of Practical JIRA Administration—shows you how to create and maintain your own JIRA plugins to meet the specific needs of a project.

This book uses detailed examples to clarify some of the more confusing aspects of JIRA plugins, and serves as an ideal supplement to the extensive documentation already available.

• Use JIRA’s Plugin SDK, and learn several aspects common to all plugins
• Create your own custom field type, using a JIRA plugin
• Delve into advanced aspects of custom field plugins, and discover how searching for values in custom fields works
• Create JIRA plugins to use with workflows, and learn about conditions, validators, and post-functions
• Store data using the PropertySet interface and the Active Objects plugin
• Upgrade a plugin and upload it to Atlassian Plugin Exchange (PAC)

Product Details

ISBN-13:	9781449308278
Publisher:	O'Reilly Media, Incorporated
Publication date:	08/02/2011
Pages:	111
Product dimensions:	6.90(w) x 9.10(h) x 0.20(d)

About the Author

Matt Doar runs Consulting Toolsmiths, a software consultancy in
Silicon Valley and has extensive experience configuring and customizing JIRA for clients all over the world. He is an Atlassian partner and is part of the wider Atlassian development community.



He also wrote "Practical Development Environments", O'Reilly (2005)
which described the basics of software tools - version control, build tools, testing, issue trackers, automation.



Matt also runs the blog http://jiradev.blogspot.com which has a number of similar tips, trick and examples for practical JIRA development.

Table of Contents

Preface; What This Book Is About; Conventions Used in This Book; Using Code Examples; Safari® Books Online; How to Contact Us; Content Updates; Acknowledgments; Chapter 1: Plugin Basics; 1.1 Overview; 1.2 Creating a JIRA Plugin; 1.3 Reading a Plugin; 1.4 Building and Deploying a Plugin; 1.5 What Can JIRA Plugins Do?; 1.6 Which Methods Should My Plugin Use?; 1.7 Troubleshooting a Build; 1.8 Logging; 1.9 Apache Velocity; 1.10 Maven; 1.11 Further Reading; Chapter 2: Custom Field Types; 2.1 Overview; 2.2 A New Custom Field Type; 2.3 Generating an Empty Plugin; 2.4 Adding a customfield-type to atlassian-plugin.xml; 2.5 Creating the CustomFieldType Class; 2.6 Adding Velocity Template Files; 2.7 Troubleshooting the Plugin; 2.8 Extending the Plugin; 2.9 Summary; 2.10 Further Reading; Chapter 3: Advanced Custom Field Types; 3.1 Overview; 3.2 Adding Configuration to a Custom Field; 3.3 Fields with Multiple Values; 3.4 Read-only and Calculated Fields; 3.5 WebWork; 3.6 Other Examples of Custom Field Types; Chapter 4: Custom Field Searchers; 4.1 Overview; 4.2 How Searchers Work; 4.3 Searchers and atlassian-plugin.xml; 4.4 A Simple Searcher; 4.5 Troubleshooting Searchers; 4.6 More Complex Searchers; 4.7 Statistical Searchers; 4.8 Further Reading; Chapter 5: Workflow Customizations; 5.1 Overview; 5.2 Conditions; 5.3 Configurable Conditions; 5.4 Validators; 5.5 Configurable Validators; 5.6 Post-Functions; 5.7 Configurable Post-Functions; 5.8 Further Reading; Chapter 6: Storing Data with Your Plugin; 6.1 Overview; 6.2 Storing Data with PropertySet; 6.3 Storing Data with Active Objects; 6.4 Further Reading; Chapter 7: Publishing Your Plugin; 7.1 Overview; 7.2 Atlassian Marketplace; 7.3 SPAC (studio.plugins.atlassian.com); 7.4 bitbucket; 7.5 Upgrading a Plugin to a New Version of JIRA; 7.6 Updating a Plugin Version at the Marketplace; 7.7 Further Reading; Chapter 8: Further Plugin Information; 8.1 Overview; 8.2 JIRA Plugins—Beyond the .jar file; 8.3 Internationalization; 8.4 Plugin Security; 8.5 Version One, Version Two and Version Three Plugins; 8.6 JIRA Development Mode; 8.7 Using a Debugger with JIRA; 8.8 Further Reading; Colophon;