Add-Ons for JIRA_ Raimar Falke AUG Hamburg, 22. June 2015

About

2

Customization Levels

3

Level 0: As downloaded

4

Level 1: Discovering the Admin menu

5

Level 2: Marketplace to the rescue

6

Level 3: Solve problems with code

7

Level 3: Solve problems with code

8

• Mostly Javascript and Groovy (script runner) •  Distribution (banner, description) •  Staging vs Production •  Revisioned? (file system)

Level 4: Custom add-on

9

Custom developed add-on

Advantages. •  Software developed like software •  Code and add-on are revisioned •  Tests, tests, tests (blog.codecentric.de)

•  Bundle functionality, data and config •  Can control almost all aspects of JIRA •  Custom made

10

Custom developed add-on

Disadvantages. •  You need (a) software developer(s) •  Customer must specify functionality •  Every project has risks • Maintenace costs

11

12

Under the hood

OSGi

13

What is an add-on?

JIRA add-on

Java Classes

HTML / CSS / Javascript

Add-on Configuration

14

APIs

How to interact. •  Java: API (may also get source code for $10) •  Javascript: AJS (jQuery with custom name) •  GUI: AUI (Atlassian User Interface)

15

Modules

•  Add-on = set of modules •  34 module types describe extention points •  Keyboard Shortcut, Custom Field•  Project, Issue and Version Tab Panel•  JQL Function, Servlet Filter, Report•  Workflow: Condition, Post Function, Validator•  Gadgets, RPC and REST Endpoint•  …

•  Type specific config •  References: Java, Javascript, HTML, SOY

templates, I18N resources, CSS, images,… •  Specified in atlassian-plugin.xml

16

Getting started

First round trip. 1.  Download SDK (custom maven) 2. atlas-create-jira-plugin 3. atlas-create-jira-plugin-module 4. Optional: add some code 5. atlas-run 6. After startup JIRA is at localhost:2990 7.  atlas-package to get a deployable JAR 8. Optional: Purchase JIRA for $10 to get the

source code

17

Distribution Te

sted

JA

R

To Marketplace

Upload JAR to production server

Customer

Developer

18

19

Thank you!

19

Photos from wikimedia.org and geograph.org.uk