Post-Job Action module

Available:

Bamboo 2.7 and later

Purpose of this Module Type

Post-Job Action modules allow plugins to define custom functionality that runs after all the results for jobs belonging to the stage have been returned to the server and saved to the database.

Configuration

The root element for the Post-Job Action module is postJobAction. It allows the following attributes and child elements for configuration:

Attributes

Name*

Description

class

The class which implements this plugin module. The class you need to provide depends on the module type. For example, Confluence theme, layout and colour-scheme modules can use classes already provided in Confluence. So you can write a theme-plugin without any Java code. But for macro and listener modules you need to write your own implementing class and include it in your plugin. See the plugin framework guide to creating plugin module instances.

key

The unique identifier of the plugin module. You refer to this key to use the resource from other contexts in your plugin, such as from the plugin Java code or JavaScript resources.
1
2
3
<component-import 
  key="appProps" 
  interface="com.atlassian.sal.api.ApplicationProperties"/>

In the example, appProps is the key for this particular module declaration, for component-import, in this case.

name

The human-readable name of the plugin module.

Only used in the plugin's administrative user interface.

*class and key attributes are required.

Elements

The table summarises the elements. The sections below contain further information.

Name

Description

description

The description of the plugin module. The 'key' attribute can be specified to declare a localisation key for the value instead of text in the element body.

Use this element to describe the section.

Interface

Post-Job Action modules must implement the PostJobAction interface.

Example

Here is an example atlassian-plugin.xml file containing a Post-Job Action module:

1
2
3
4
5
6
7
8
9
10
11
<atlassian-plugin name="Hello World" key="example.plugin.helloworld">
    <plugin-info>
        <description>A Post-Job Action module type test</description>
        <vendor name="Atlassian Software Systems" url="http://www.atlassian.com"/>
        <version>1.0</version>
    </plugin-info>

    <postJobAction key="myPostJobAction" class="com.atlassian.example.bamboo.actions.MyPostJobAction">
        <description>Tears down the Job once the result has been returned to the server and saved to the database</description>
    </postJobAction>
</atlassian-plugin>