impex:exportdata

Full name:

org.kuali.maven.plugins:maven-impex-plugin:1.1.13:exportdata

Description:

Reads the content of tables from a database and exports the data in a database agnostic format to XML files.

Attributes:

  • Requires a Maven project to be executed.
  • Binds by default to the lifecycle phase: generate-sources.

Required Parameters

Name Type Since Description
artifactId String - The Maven artifactId. Included here as a simple property of the mojo itself to facilitate usage of BeanUtils.copyProperties() to copy properties between Mojo's and Ant tasks
Default value is: ${project.artifactId}.
User property is: artifactId.
dataXMLDir File - The directory where data XML files will be written
Default value is: ${basedir}/src/main/impex.
User property is: dataXMLDir.
dateFormat String - The format to use for dates/timestamps
Default value is: yyyyMMddHHmmss z.
User property is: dateFormat.
forceMojoExecution boolean - Setting this parameter to true will force the execution of this mojo, even if it would get skipped usually.
Default value is: false.
User property is: forceMojoExecution.
includeVersionInComment boolean - By default the version of the maven plugin being used during the build will be included as part of a comment in the XML. Set this to false to prevent this. Useful if you are committing files to SCM and don't want a change in the version of the plugin to show up as a change to the data.
Default value is: true.
User property is: includeVersionInComment.
url String - The connect URL of the database.
User property is: url.

Optional Parameters

Name Type Since Description
antCompatibilityMode boolean - If true, files will be exported in a format that the Ant impex tasks can understand
Default value is: false.
User property is: antCompatibilityMode.
comment String - Additional comment that gets placed into the generated XML document. Anything included here gets appended to the default value
Default value is: Auto-generated by the maven-impex-plugin v1.0.2

User property is: comment.
driver String - Database driver classname. This parameter is optional, as the correct JDBC driver to use is detected from the url in almost all cases (works for Oracle, MySQL, Derby, PostGresSQL, DB2, H2, HSQL, SQL Server). If a driver is explicitly supplied, it will be used in place of the JDBC driver the automatic detection logic would have chosen.
User property is: driver.
driverProperties Properties - Additional properties for the JDBC driver
encoding String - The encoding to use when reading/writing files. If not specified this defaults to the platform specific encoding of whatever machine the build is running on.
Default value is: ${project.build.sourceEncoding}.
User property is: encoding.
excludes String - Comma separated list of regular expressions for tables to exclude from the export
User property is: excludes.
includes String - Comma separated list of regular expressions for tables to include in the export
User property is: includes.
password String - The password for the database user. If not specified this is automatically generated by platform specific logic for converting the artifact id.

For example:
ks-embedded-db becomes KSEMBEDDED for Oracle and ksembedded for MySQL
User property is: password.
schema String - The schema to export. This parameter is optional, as the schema to export is automatically derived from platform specific logic that converts the artifactId.

For example:
ks-embedded-db becomes KSEMBEDDED for Oracle, and ksembedded for MySQL If schema is supplied, the supplied value will be used instead of the value derived from the artifactId
User property is: schema.
skip boolean - When true, skip the execution of this mojo
Default value is: false.
startMavenLogger boolean - When true, redirect logging from Log4j and Jakarta Commons Logging to the Maven logging system
Default value is: true.
User property is: startMavenLogger.
targetDatabase String - The type of database we are targeting (eg oracle, mysql). This is optional if url is supplied as the database type will be automatically detected based on the url. If targetDatabase is explicitly supplied it will override the type selected by the automatic detection logic.
User property is: targetDatabase.
username String - The user name to connect to the database. If not specified this is automatically generated by platform specific logic for converting the artifact id.

For example:
ks-embedded-db becomes KSEMBEDDED for Oracle and ksembedded for MySQL
User property is: username.

Parameter Details

antCompatibilityMode:

If true, files will be exported in a format that the Ant impex tasks can understand
  • Type: boolean
  • Required: No
  • User Property: antCompatibilityMode
  • Default: false

artifactId:

The Maven artifactId. Included here as a simple property of the mojo itself to facilitate usage of BeanUtils.copyProperties() to copy properties between Mojo's and Ant tasks
  • Type: java.lang.String
  • Required: Yes
  • User Property: artifactId
  • Default: ${project.artifactId}

comment:

Additional comment that gets placed into the generated XML document. Anything included here gets appended to the default value
Default value is: Auto-generated by the maven-impex-plugin v1.0.2
  • Type: java.lang.String
  • Required: No
  • User Property: comment

dataXMLDir:

The directory where data XML files will be written
  • Type: java.io.File
  • Required: Yes
  • User Property: dataXMLDir
  • Default: ${basedir}/src/main/impex

dateFormat:

The format to use for dates/timestamps
  • Type: java.lang.String
  • Required: Yes
  • User Property: dateFormat
  • Default: yyyyMMddHHmmss z

driver:

Database driver classname. This parameter is optional, as the correct JDBC driver to use is detected from the url in almost all cases (works for Oracle, MySQL, Derby, PostGresSQL, DB2, H2, HSQL, SQL Server). If a driver is explicitly supplied, it will be used in place of the JDBC driver the automatic detection logic would have chosen.
  • Type: java.lang.String
  • Required: No
  • User Property: driver

driverProperties:

Additional properties for the JDBC driver
  • Type: java.util.Properties
  • Required: No

encoding:

The encoding to use when reading/writing files. If not specified this defaults to the platform specific encoding of whatever machine the build is running on.
  • Type: java.lang.String
  • Required: No
  • User Property: encoding
  • Default: ${project.build.sourceEncoding}

excludes:

Comma separated list of regular expressions for tables to exclude from the export
  • Type: java.lang.String
  • Required: No
  • User Property: excludes

forceMojoExecution:

Setting this parameter to true will force the execution of this mojo, even if it would get skipped usually.
  • Type: boolean
  • Required: Yes
  • User Property: forceMojoExecution
  • Default: false

includeVersionInComment:

By default the version of the maven plugin being used during the build will be included as part of a comment in the XML. Set this to false to prevent this. Useful if you are committing files to SCM and don't want a change in the version of the plugin to show up as a change to the data.
  • Type: boolean
  • Required: Yes
  • User Property: includeVersionInComment
  • Default: true

includes:

Comma separated list of regular expressions for tables to include in the export
  • Type: java.lang.String
  • Required: No
  • User Property: includes

password:

The password for the database user. If not specified this is automatically generated by platform specific logic for converting the artifact id.

For example:
ks-embedded-db becomes KSEMBEDDED for Oracle and ksembedded for MySQL
  • Type: java.lang.String
  • Required: No
  • User Property: password

schema:

The schema to export. This parameter is optional, as the schema to export is automatically derived from platform specific logic that converts the artifactId.

For example:
ks-embedded-db becomes KSEMBEDDED for Oracle, and ksembedded for MySQL If schema is supplied, the supplied value will be used instead of the value derived from the artifactId
  • Type: java.lang.String
  • Required: No
  • User Property: schema

skip:

When true, skip the execution of this mojo
  • Type: boolean
  • Required: No
  • Default: false

startMavenLogger:

When true, redirect logging from Log4j and Jakarta Commons Logging to the Maven logging system
  • Type: boolean
  • Required: No
  • User Property: startMavenLogger
  • Default: true

targetDatabase:

The type of database we are targeting (eg oracle, mysql). This is optional if url is supplied as the database type will be automatically detected based on the url. If targetDatabase is explicitly supplied it will override the type selected by the automatic detection logic.
  • Type: java.lang.String
  • Required: No
  • User Property: targetDatabase

url:

The connect URL of the database.
  • Type: java.lang.String
  • Required: Yes
  • User Property: url

username:

The user name to connect to the database. If not specified this is automatically generated by platform specific logic for converting the artifact id.

For example:
ks-embedded-db becomes KSEMBEDDED for Oracle and ksembedded for MySQL
  • Type: java.lang.String
  • Required: No
  • User Property: username