Support for Server products ended Feb. 15, 2024. Learn what this means for you.

Post Chain Index Writer module

Available:

Bamboo 2.7 and later

Purpose of this Module Type

The Post Chain Index Writer modules allows you to write your custom data for a build into the index, which allows for future retrieval in your custom Report Module. The Post Chain Index Writer modules will be invoked in three places in Bamboo: when a build completes and it indexes, operations which requires a re-index of a particular chain (result), and when you run the re-index all action under the Administration tab. The Post Chain Index Writer should always be written in conjunction with a Index Reader Module which will be able to retrieve the data in the index.

Configuration

The root element for the Post Chain Index Writer module is postChainIndexWriter. 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. Required: yes Dafault: -
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 `<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. Required: yes Dafault: N/A
name	The human-readable name of the plugin module. Only used in the plugin's administrative user interface. Required: - Dafault: -

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.

Required: yes

Dafault: -

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
<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.

Required: yes

Dafault: N/A

name

The human-readable name of the plugin module. Only used in the plugin's administrative user interface.

Required: -

Dafault: -

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. Required: - Dafault: -

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.

Required: -

Dafault: -

Interface

Post Chain Index Writer modules must implement the PostChainIndexWriter interface.

Example

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

1
2
 
<atlassian-plugin name="Hello World" key="example.plugin.helloworld"> 
  <plugin-info> 
    <description>A Post Chain Index Writer module type test</description> 
    <vendor name="Atlassian Software Systems" url="http://www.atlassian.com"/> 
    <version>1.0</version> 
  </plugin-info> 

  <postChainIndexWriter key="myChainIndexWriter" name="Example Post Chain Index Writer"
          class="com.atlassian.example.bamboo.actions.MyChainIndexWriter">
    <description>Writes the My Example Plugin Results to the Lucene index</description>
  </postChainIndexWriter>
</atlassian-plugin>