Oakland Data Transformer - Installation

To install the designer, you need to be running Eclipse Helios (3.5) or any more recent Eclipse 3.x version (ODT is not yet supported on Eclipse 4.x).

Use the Help -> Install New Software menu item and install from this update site (note this site will not work with your browser, it's intended only to be an Eclipse update site):

http://www.oaklandsoftware.com/updates/transform/ideExp

Once you have installed be sure and select the recommended "Restart" option. Then, once restarted, go to WIndows -> Open Perspective. In "Other..", select the Data Transformer perspective. This will then show you the Examples project. From there, use Help -> Cheat Sheets and look in the Data Transformer category for tutorials to get you started.

Important note: if you are working with definitions of any significant size (like large XML schemas or EDI) you will likely need to increase the Java memory given to your Eclipse. You can do this by editing the eclipse.ini file located at the base of your Eclipse installation. We recommend setting the maximum memory to 800MB (-Xmx800m); you also may need to increase your stack size to 2MB (-Xss2m). If you notice that certain operations take a very long time, it is likely that you need to increase your memory.

You can develop and test your maps completely using the designer as it contains the same runtime that is used to execute the maps separately.

To install the runtime:

  1. Download the runtime kit which includes the Jar file and documentation.
  2. Put the odtapi_<version>.jar file in your classpath.
  3. Set the ODT_INSTALL Java System property to the location where you wish the product to be installed. If it's not specified, the runtime will be installed into a temporary directory.
  4. Use the API as described in the Javadoc to execute the map. There is an example program in the kit that you can as a model.