Data can be transformed from any Jitterbit supported format to XML and vice versa. Before attempting to use an XML as a source or target you need to have a DTD or XSD definition file that represents the XML structure you wish to use uploaded to the Jitterbit server.
Transforming to XML structures is similar to transforming to other data structures. If XML is used as a target then XML schemas can provide rules and more information about their structure than say standard database table interfaces. Jitterbit will highlight those rules to help you in mapping.
Examples of these include:
- Mandatory fields which are highlighted in red in the target tree. Please note that mandatory fields may highlight once you map to certain elements, as they may be conditional e.g. if element A has a values then element B must have a value, otherwise element B is optional.
- XML schemas can also tell you what values are valid for a particular element e.g. element A is Boolean and must have the values: True, False, 1, 0, Yes, No. Or element B can only have the values: Red, White or Blue. The Jitterbit server can enforce XML validation before generating the target document.
Create a New Transformation
- Make sure you have opened the appropriate project in which you want to create the new transformation.
- There are several ways you can start to create a new transformation:
- If you are working in an operation, you can click the control button to the right of the Transformation field and select Create New; OR
- Select New in the File menu, then choose New Transformation from the sub-menu; OR
- Click the down arrow next to the file icon in the toolbar, then choose New Transformation from the sub-menu; OR
- Right-click on Transformations in the hierarchical tree in the Design tab in the left pane of the screen, then choose New Transformation from the pop-up menu.
- The transformation wizard appears in its own New Transformation tab in the right pane of the window.
Specify Source and Target Types
- Enter an appropriate name for your new transformation in the Transformation Name field.
- Select Text from the Source and XML from the Target drop-down menus.
- Click the Next button in the toolbar to continue.
Select Source Text Information
In the next screen of the Transformation Wizard, select the document you want to use as a source from the Text Document Definition drop-down menu, or click the control button to the right of the field to create a new definition. See Creating a New Text Document Definition or Creating a Text Document Definition from a Template File for additional information.
Click the Next button in the toolbar to continue.
Select XML Target Information
You have three options for loading your XML document. Click on the scenario that describes where your XML document's DTD/XSD file is located:
You are using an XML document whose definition is already loaded into the software.
You need to use an XML document whose definition has not yet been loaded into the software.
You can upload an example XML document to have Jitterbit create the definition.
Now that you have defined the nature of the source and your desired target, you are ready to map the relationship between your source and target at the field, or element, level.