XML Extra Plugins for Pentaho KETTLE

This project contains plugins for Pentaho Data Integration (or KETTLE as it is commonly known), that add additional functionality for working with XML.

The plugins provided are:

1. Transform to Canonical XML

   This transform plugin can be used to convert XML held as a `java.util.String` value in a field to C14N Canonical XML.

This project was developed by Evolved Binary and DeveXe as part of Project OMEGA for the National Archives.

Getting the Plugins

You can either download the plugins from our GitHub releases page: https://github.com/nationalarchives/kettle-xml-extra-plugins/releases/, or you can build them from source.

Building from Source Code

The plugins can be built from Source code by installing the pre-requisites and following the steps described below.

Pre-requisites for building the project:

• Apache Maven, version 3+
• Java JDK 1.8
• Git

Build steps:

1. Clone the Git repository

   $ git clone https://github.com/nationalarchives/kettle-xml-extra-plugins.git
   

2. Compile a package

   $ cd kettle-xml-extra-plugins
   $ mvn clean package
   

3. The plugins directory is then available at target/kettle-extra-xml-plugins-1.0.0-SNAPSHOT-kettle-plugin/kettle-xml-extra-plugins

Installing the plugins

• Tested with Pentaho Data Integration - Community Edition - version: 9.1.0.0-324

You need to copy the plugins directory kettle-xml-extra-plugins (from building above) into the plugins sub-directory of your KETTLE installation.

This can be done by either running:

  $ mvn -Pdeploy-pdi-local -Dpentaho-kettle.plugins.dir=/opt/data-integration/plugins antrun:run@deploy-to-pdi

or, you can do so manually, e.g.:

  $ cp -r target/kettle-xml-extra-plugins-1.0.0-SNAPSHOT-kettle-plugin/kettle-xml-extra-plugins /opt/data-integration/plugins/