Skip to Content

Harmony Custom Plugins

Introduction

Plugins are Jitterbit’s deprecated method of extending Harmony’s native capabilities. The recommended and supported way to extend the Harmony platform is by using the Harmony Connector SDK.

Using the Harmony Plugin SDKs, you can create and publish your own plugins for use with Private Agents.

Important

Custom plugin creation is deprecated. See Deprecation and Support in Plugins on Jitterbit’s Success Central.

Create a Custom Plugin

To create a custom plugin, Jitterbit provides libraries in Java or C++ that you can use to interface with Jitterbit Harmony.

The SDKs, in essence, provide incorporation of the plugin code that you write into a Cloud Studio activity or script, or a Design Studio script, source, target, or web service. Using the SDKs lets you take advantage of classes that reduce the amount of code you are required to write. (You can use any computer language capable of generating executable files on the platform you are using, provided it meets these requirements.)

Creating a plugin involves providing a list of input and output files and data elements. Using a plugin changes the data of the input files and its data elements into the output file and its data elements.

A plugin is passed the filename of an XML file that represents the input, and the plugin then creates an output XML file:

  • Input: The input XML file contains a list of files that are relevant at that point in the pipeline. If the plugin runs after the source files have been fetched from a remote site, the corresponding local file names are listed in the XML input. The XML input also lists data elements that have been defined by transformation scripts or by other plugins.
  • Output: After the work is performed, the XML output is generated, consisting of new (or the same) files and modified or new data elements.

If you are using the SDK classes, they automate the process of parsing and creating these XML files.

SDK files are provided for use with either Java or C++.

Warning

If you are using a custom plugin, you are responsible for the security of the custom plugin.

Java Plugin SDK

When writing a custom plugin in Java, use these Java SDK libraries and examples:

  • Java SDK Libraries: Contains the three Java libraries (JAR files) that comprise the SDK.
  • Java SDK Examples: Contains a build README file and several examples demonstrating how to write a plugin using the SDK.

C++ Plugin SDK

When writing a custom plugin in C++, use the Jitterbit C++ 9.0 Plugin SDK:

Plugin Creation Training

Training is available through Jitterbit University and the Jitterbit Plugin Creation Training Course.