Changing documents and root element

Use this procedure to update or change the input/output schema or document root elements of a mapping. The progress and result of this action are logged in the Mapping Console view.

  1. In the Mapper Explorer view, right-click a mapping and select Change Documents....

    Your selected mapping must not be open in the Mapping Editor. If open, click OK to close the editor and proceed.

  2. Specify this information:

    The fields are automatically populated with default values. Click the Browse button for a specific field to change the default value.

    Project

    Defaults to the current project name.

    Copy or Overwrite

    Optionally, select the Copy or Overwrite check box to select how to apply your edits.

    Mapping Name

    Specify a new name for the mapping.

    Note: 

    • The mapping name must be a valid Java class name.

    • Because this is a potentially dangerous operation, your current mapping should be preserved. In the process, a new mapping folder is created by copying your current mapping and applying the changes on the mapping with new name.

    Input schema

    Specify a new input schema, or accept the default value.

    Output schema

    Specify a new output schema, or accept the default value.

  3. Click Next.
  4. Select the root elements for the input or output tree.
  5. Click Finish.

    The new mapping opens in a new tab in the Mapping Editor.

    Note: Document elements linked to mapping elements may have disappeared if the new schemas have different content as compared to the old ones. The difference in schema content results to an inconsistent mapping with broken links.