The plugin.xml File

The functionality that a plugin provides is defined in the plugin.xml file. The structure of this file consists of the following:

  • elements used by all plugins: the document type declaration, and the <plugin> root element that identifies the XML schema type, PluginXMLSchema_v1.xsd
  • a header element that provides the identity, version, and description of the plugin
  • the step definitions; each step is delimited by a <step-type> element that defines the functionality and properties available to that step


The following shows an example of a typical plugin.xml file:

<?xml version="1.0" encoding="UTF-8"?>
<plugin xmlns="PluginXMLSchema_v1" 
    <identifier id="plugin_id" version="version_number" name="Plugin Name"/>
  <step-type name="Step_Name">
      <property name="property_name" required="true">
        <property-ui type="textBox" label="Driver Jar" 
            description="The full path to the jdbc driver jar to use." 
        if (properties.get("exitCode") != 0) {
            properties.put("Status", "Failure");
        else {
            properties.put("Status", "Success");
  <command program="${path_to_tool">
      <arg value="parameters_passed_to_tool"/>
      <arg path="${p:jdbcJar}"/>
      <arg file="command_to_run"/>
      <arg file="${PLUGIN_INPUT_PROPS}"/>
      <arg file="${PLUGIN_OUTPUT_PROPS}"/>

The following sections describe the elements of the plugin.xml file and their appropriate attributes.