...
- Click the Add Structure button from the tool bar in the Input/Output Structure Panel and choose the structure type from the drop down list.
Figure 1: Choosing from Add Structure dropdown list
- Right-click on the Input/Output Structure Panel and select Add Structure and choose the structure type from the sub-menu.
Figure 2: Choosing from right-click menu
The drop-down list or the sub-menu has the following options:
- XSD For for loading structure from an XSD document
- DTD For for loading structure from a DTD document
- XML For loading for loading structure from an XML document
- FIX For for loading a structure from a FIX message
Load Input/Output Structure From an XSD document
Select XSD from the Add Structure menu. The Load Input/Output XSD Structure Wizard appears. The wizard contains two pages, Structure Selection page and External XSDs page.
Figure 13: Structure Selection Page
...
The name of the structure can be specified in the Structure Name text field at the top of the page.
Note |
---|
The structure name cannot contain special characters. Only alphabets, numbers and '_' are allowed in a structure name. Two structures with the same name are not allowed. |
...
The schema can also be loaded from an existing file using the Load from File button. Clicking this button will open a file dialog through which you can browse through the file system to choose an existing file. Modifications, if any, to the schema are loaded from the file from this page.
External XSDs Page
Figure 2: Adding External XSDs
Any external XSDs used by a structure can be added from this page. External XSDs can be added by performing the following steps:
- Click
...
- Next in the Structure selection pane to move to the next panel.
- In the Specify External XSDs panel, click the Add button to add a new external schema.
...
- Choose any one of the following:
- New XSD: to add an external schema by providing it or by adding the xsd file available in the database.
- Existing Schema: to select a schema that is already present in the eMapper Project.
Figure 4: Options of adding XSD
Adding a new XSD
- Click New XSD. This will enable the Schema Content Area where the content of the schema can be entered.
...
- Perform any one of the following actions:
- Provide a valid file name
...
- in the Schema File field. The provided XSD will be saved with the name specified in the PROJECT_HOME/resources/schemas directory.
...
- Click the Browse button
...
- , browse through the file system and select the required file.
- After providing the XSD,
...
- click the Save button to save it as an external XSD for the structure
...
- .
Info |
---|
|
...
|
...
|
Adding an existing schema
To use an XSD which is already present in the eMapper Project, click Existing Schema in the New context menu. A list of all the XSD present in the PROJECT_HOME/resources/schemas directory is shown. Choose an XSD and it will be saved as an external schema to the current structure.
Note |
---|
|
...
|
...
|
Load Input/Output Structure from a DTD document
Select DTD from the Add Structure menu. The Load Input/Output DTD Structure wizard appears. The DTD content can be specified from the Structure Selection Page present in this wizard. Similar to the Structure Selection Page in Load Input/Output XSD Structure Wizard, this page allows the user to enter the structure content directly or by loading it from an existing file. To load content from an existing DTD document, click the Load From File button.
Figure 35: Load Input DTD Structure
...
The structure can be saved and loaded in the Input/Output Structure panel by clicking the Finish button. The content is saved in a file with name <Structure_Name>.<Mime_Type> in the PROJECT_HOME/resources/schemas directory. If the schema is not valid an exception is logged in the Error Log view.
Figure 46: Load Input XML Structure
...
Select FIX from the Add Structure menu A list of different FIX versions and message types is displayed where the messages to be loaded can be chosen. Select the message types and click the Load button to load the messages types in to the workspace. Click Finish in the Add Structure wizard and the FIX message structure is loaded in Mapper.
Figure 57: Loading a Fix Message
More information on FIX-XML transformation is provided in the FIX-XML Transformations section.
...
To edit Input/Output Structure:
- Right-click the structure and click the Edit Structure option. The Edit Structure dialog
...
- opens
...
- .
- The selected structure is shown in the text area. A drop-down in the top lists all the imported schemas added to the structure. Selecting a schema from the drop-down will populate its content in the text area. Modifications to the structure can be done here.
- The (Load From File) button can be used to load structure from a file
...
- The (Save) button to save the modifications in the current schema.
- Click the OK button to save the modifications to the structure and to refresh the tree structure in the mapper with the modified structure.
Figure 6: Edit Structure Dialog
If the new structure is valid, it gets saved and loaded in its corresponding panel. Otherwise, an error dialog box is shown and the modifications are ignored. Upon editing a structure, mappings defined to the affected elements/attributes are discarded.
Figure 6: Edit Structure Dialog