Database to XML¶
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:
Required 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 value 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 Database from the Source drop-down list and "XML" from the Target drop-down list.
Click the Next button in the toolbar to continue.
Select Source Database Information¶
In the next screen of the Transformation Wizard, select the name of the source that holds the database information you want to transform from the Database Source drop-down menu, OR click the control button to the right of the field to create a new source database.
Click the >Next button in the toolbar to continue.
The next steps you follow depend upon whether you want to use only a single table in your source database, or whether you need to access more than one database table. Select how you will get information from your source database:
- Only a single table in the source database will be accessed.
- More than one table in the source database will be accessed.
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.