Importing an XML document allows you to use data from another Mavim database or another source in your own database, independent of Version Management. To import an XML document:
1. Select the topic below which you want to import the XML information.
2. From the Modelling tab select Mavim XML Document in the Import group.
3. Select the Mavim XML document at the correct file location and click Open.
4. Mavim then checks the XML for validity. If the document is valid, it is scanned for the available topic and/or relationship properties. For more information: see Scanning the Mavim XML Document.
5. The Import Options screen will appear with a number of sections at the top and below that the tabs Filter, Languages and Update:
Based on the available topic and or relationship properties, the corresponding options are enabled and selected. If you are using an existing transport topic, the last used options are selected.
6. Adjust the following settings to your preferences:
Destination Import
Here you can select the topic below which you want to import the XML document. Not all topics can be imported, see List of importable topics.
Transport Topic
Indicate whether you want to use a transport topic, and if so, if you want to create a new transport topic map or if you want to use an existing one. You do not have to use a transport topic. If using an existing transport topic map, the last used Filter and Languages settings will be applied. See also: XML transport topic.
Filter
By default all topic and relationship properties are imported. Here you can indicate which properties you do or do not want to include in the import.
The description can be imported in four different formats. Importing in Word, RTF and HTML format fully retains the layout and the images in a description. ASCII format does not retain the images.
For relationships you can set whether you will import the characteristics, dispatch instructions, and/or user instructions.
Languages
In this tab you indicate how the language-dependent topics are processed in the XML document. The following two options are available:
· Current language: only those properties that are in the same language as the current data language in Mavim will be imported. The user can choose which of the source languages available in the XML file will be used. This makes it possible to move data from one language to another.
· Select the import language: you can specify which of the languages available in the XML file will be imported into the Mavim database. The default option is that all properties in all available languages are imported.
Note: If the XML file consists of languages other than the currently active language, it can also be imported. The topics in the active language will be given the default topic names.
Update
If you are using an existing transport topic map (repeated import), the Update tab becomes enabled. In this tab, you can arrange the following:
· How topic and/or relationship properties should be updated.
· Whether new topics and/or relationships added to the XML document since the last import should be imported into Mavim.
· Whether topics and/or relationships removed from the XML document since the last import should be removed from Mavim, and if so, how they should be removed.
Item Properties
This option allows you to determine how you want to update the properties of topics and/or relationships that were previously imported into Mavim and are included in the transport topic map.
· Always change: the properties of the topics and or relationships in the XML document are updated in Mavim.
· Leave all: the properties and/or relationships in the XML document are not updated in Mavim.
New Items in XML
This option allows you to specify whether you want to import topics and/or relationships that were added to the XML document since the last import, and if yes, how you want to import them.
· Add: the new topics and/or relationships will be imported into Mavim.
· Don't add: the new topics and/or relationships will not be imported into Mavim.
· Add to mapping: the new topics and/or relationships will be added to the transport topic map.
Deleted Items in XML
This option allows you to specify how you want to remove topics and/or relationships from Mavim that have been removed from the XML document since the last import.
· Delete permanently: the removed topics/and or relationships are permanently deleted from Mavim. They are also removed from the transport topic map.
· Recycle bin: the removed topics and/or relationships are moved to the recycle bin.
· Don't delete: the removed topics and/or relationships are not deleted.
· Remove from mapping: removed topics and/or relationships will be removed from the transport topic map. This option is only available when you have chosen Recycle bin or Don't delete.
7. Click OK to confirm import of the XML document with the selected settings.
