Nav
You are viewing an older version of this section. Click here to navigate to the latest version.

DataWeave Migrator Tool

If you have projects that are built with the deprecated DataMapper, a migration tool is now included in Studio, which assists in converting a DataMapper map to DataWeave. This tool doesn’t replace the original DataMapper in your flow, it creates a new equivalent DataWeave component next to it. The old DataMapper component is left in its place so that you can compare both as they sit next to each other on your flow, but you must then delete it for the flow to be executable.

Using the Migrator Tool

To migrate a DataMapper component to DataWeave, do the following:

  1. Right click on a DataMapper component, select Migrate to DataWeave

    dw migrator

  2. Note that a new DataWeave component exists next to your DataMapper component. Revise both carefully to make sure that the new component is equivalent in all possible use cases.

    If your DataMapper includes features that aren’t supported by the migration script, comments will be added within the DataWeave code to warn you. This does not necessarily mean that your transformation is not supported by the DataWeave language, see DataWeave Reference Documentation.
  3. Once you’re sure that the migration has properly covered every use case, delete the old DataMapper component from your flow

Known Issues

If your original DataMapper component matches any of the following use cases, then the migrator tool will not fully migrate it and a note will be added about it.

Use case Workaround

Invokes java functions

Add a MEL global function that invokes this java function. Then invoke this MEL function from the DW code

Uses If/Else statements

Use When/Otherwise

Handles Excel and flat file formats

These formats are currently not supported by DataWeave

Includes Output arguments

Replace these by multiple outputs