Available: | Bamboo 2.7 and later |
Post-Chain Action modules allow plugins to define custom functionality that runs after the Plan finishes executing. This module will be run regardless of BuildState or LifeCycle state of the ChainResultsSummary (For example, if the build completed successfully or failed). The module provides access to the Chain object, the ChainResultsSummary and the ChainExecution.
The root element for the Pre-Chain Action module is postChainAction. It allows the following attributes and child elements for configuration:
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.
In the example, |
name | The human-readable name of the plugin module. Only used in the plugin's administrative user interface. |
*class and key attributes are required.
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. |
Post-Chain Action modules must implement the PostChainAction interface.
Here is an example atlassian-plugin.xml
file containing a Post-Chain Action module:
1 2<atlassian-plugin name="Hello World" key="example.plugin.helloworld"> <plugin-info> <description>A Post-Chain Action module type test</description> <vendor name="Atlassian Software Systems" url="http://www.atlassian.com"/> <version>1.0</version> </plugin-info> <postChainAction key="myPostChainAction" class="com.atlassian.example.bamboo.actions.MyPostChainAction"> <description>Tears down and saves data for MyBambooPlugin if the Chain has the plugin enabled</description> </postChainAction> </atlassian-plugin>
Rate this page: