Get Started With DataMinder Plugin Development
The prerequisites for Plugin development
To start developing your own DataMinder plugins you need the following:
- A DataMinder installation
- Java development environment
A starting point for documentation is support pages. Here you can find the main help file describing DataMinder and DataMinder plugin development especially. And you can find the Javadoc documentation for plugin interfaces and utility classes.
Plugin development in 6 easy steps
To make your custom plugins available in DataMinder you need to create a plugin library that contains at least one plugin and add the library to DataMinder plugin folder.
To create a new plugin library follow these 6 easy steps:
- Create a Java project using your favorite Java Development tool.
- Add the plugin development libraries to your projects classpath.
- Implement one of the plugin interfaces for:
Task, Output, Input, Scheduler, Decision, Common Object, Service or Listener - Create a Java Jar file.
- Install your new Plugin Library by putting the Jar in plugin library folder.
- Done! Now you can let your plugins work by combining them into processes.
Set up your Java development
Set up a standard Java project in your favorite Java development tool.
Add the following 2 plugin development libraries (Jar files) to your project classpath. You can find them in DataMinder installation directory.
- DataMinder/Server/PluginDevelopment/DMExternalLibs.jar
- DataMinder/Server/PluginDevelopment/DMPublicAPI.jar
Implement chosen plugin
For current information about building plugins please see the help file PluginDevelopment.
The easies way is to use our code generator to generate:
- Plugin stub code
- Library manifest file: META-INF/MANIFEST.MF
- Library listing object
Install your library in DataMinder
When you have implemented your first plugin and generated the library Jar file you install the library by puting the library in plugin library folder. Let's say our library is called "DemoPlugins".
- Create folder DataMinder/Server/Config/Plugins/DemoPlugins
- Put your generated Jar file DemoPlugins.jar as DataMinder/Server/Config/Plugins/DemoPlugins/DemoPlugins.jar
- [Optional] If you need external libraries to support the plugins put them in DataMinder/Server/Config/Plugins/DemoPlugins/lib