Below, in figure 1., is an example of the XML Import dialog window. (see the Overview, for help on how to access this option).
N.B. The imported nodes and links will be placed inside the current view, so make sure the current view is the one you wish to import into.
There are three main import options:
|
Option |
Purpose |
|
Import author and date information? |
If this option is selected, all author and date information of nodes and links will be imported from the xml file. |
|
Set author as "Current Author" and all dates as today? |
If you wish all nodes to be imported with today's date, and with the current user as the author, select this option. |
|
Preserve Transclusions? |
If this option is selected, it means that if your database already contains any of the imported nodes, it will bring the nodes in as transclusion to that original node. You can further qualify this option, by selecting to overwrite existing nodes with imported data. This means that for any that imported nodes which you already have in your database, the imported data will be used to update the existing nodes. Warning: this means your own data for these nodes will be lost. |
| Preserve Imported Node IDs? |
If you select this option, the imported nodes will be stored into
your database with their original ids instead of being assigned new
ones. This is useful if you share maps with people and wish to update them, as you can then use the 'Preserve Transclusions?' option with overwriting of data selected, on subsequent imports of the map and the nodes will update. |
| Mark nodes seen | Mark all imported nodes as already seen. This is part of the groupware functionality. If you do not check this box all imported nodes will be marked as unseen and will have red borders around them until you have viewed thier contents or mared them as seen. |
Once you have completed the import options, press the 'Import XML' button. A file browser dialog window will open, (see figure 2 below), and you will need to locate the file that you wish to import. Only xml files will be accepted for importation.
Once you have selected a file, and pressed 'Import', the importation will begin. You will see a progress bar showing you how the import is progressing.
N.B. All xml files are validated against the Compendium.dtd file, which you will find in your main compendium directory. XML files imported through Compendium must conform to this dtd for successful importation. Also, currently certain characters, usually ones which where originally copied from Word files, break the importation process. So far they have all been very low Hex numbers. It is hoped that this problem will be eliminated in future releases.