Menu File

This menu item includes subitems for management of documents in the CLaRK system. The documents that the system recognizes are XML well-formed documents. These documents can be divided into two kinds. The documents of the first kind are the documents that are outside of the system. In order for the system to work with these documents they have to be imported inside the system. The external documents can have one of the following character encodings: ASCII, UNICODE (UTF-16) or UNICODE (Microsoft version of UTF-16). The documents of the second kind are the documents that are imported into the system and which are stored in an internal representation. When a document is processed inside the system, this document has to be connected with a document type definition (DTD). This DTD has to be compiled in an internal representation before being assigned to the document. The document loaded in the active view of the system is called a current document.

Document Manager

This component is responsible for the management of the internal documents in the CLaRK System. It keeps a record of all documents saved in the system. In addition, there is a system of document groups which are arranged in a tree, similar to the directory structure. Each document group contains zero or more internal documents and zero or more sub-groups. The main group is called "Root" and it can not be renamed or deleted by the user. It includes one more special document group, named "SYSTEM". The latter is expected to contain documents for special purposes (help documents for the constraints, documents containing XSL Transformations and others). The "SYSTEM" group also can not be modified. The possible operations for a group are: creating of a new group; removing a group with its content; adding document(s) which do not present in the group but are saved in the system. It is allowable for one document to be included in more than one group. In this way different views of the document database can be created. Removing a document from a group does not mean that it is removed from the database. It is just excluded from the group. The Document Manager also provides a list of all internal documents no matter in which group they are included. Here is one example picture of the Document Manager window:

The manager window contains two main parts:

  1. The panel on the left. It contains the tree representation of the group hierarchy. As it can be seen above, it consists of 5 groups (2 system and 3 user defined). When the user selects a node in this tree, content of the corresponding group is loaded in the component on the right side.
  2. Current group monitor. This is the panel situated on the right side of the window. It is a list with the content of the currently selected group in the tree. The list components, which are in blue color, are sub-groups. The other entries are the documents included in this group. They are colored in black or red, depending on whether they are valid or not, according to their DTDs.

    There are three additional buttons which can be used for modification the content of the current group:

    • New Group - creates a new sub-group of the current one. The user is asked to supply a name for it;
    • Remove - removes the selected entries from the list. The removal is preceded by a confirm message. If the selection includes sub-groups, they are removed with their entire contents.
    • Add Document - gives a list of all internal documents which do not present in the current group. The user is expected to choose one or more documents to be included in the current group.
    • Hard Remove!* - this button is visible only when the Document Manager is started from menu File/Document Manager. This function can be used for removing documents from the internal document database. It can be applied only to documents, not to whole groups. The latter are excluded from any selections, if included in such. The removal of documents is preceded by a confirm message. The documents to be removed, are excluded from all groups they may belong to.

When the document management is done, the user can update or cancel the changes made over the document database structure by using the two buttons on the bottom of the window.

Navigation in the group structure can be made also in the panel on the right. When the user wants to see the content of a certain sub-group of the current group, s/he just have to perform a double click on the desired sub-group. This will change the current group to the new one. This represents the movement from a group to a sub-group. The movement in the other direction is also possible. For each document group (excluding the Root), a special sub-group is included, named: ". .". By performing a double click on it, similarly to most file systems, the current group is changed to the parent group of the current one.


Sub-Menus:

New

A shortcut Ctrl+N
An icon on the toolbar

Choosing this item the user creates a new empty document. First, a menu for choosing a DTD appears. The user can create a document with respect to one of the DTDs compiled into the system. If the appropriate DTD is not compiled, then the user has to close the dialog and compile the required DTD. After choosing the DTD a new document containing only the root element with empty content is created. In most cases this document will not be valid.

Open

A shortcut Ctrl+O
An icon on the toolbar

Choosing this item the user opens document(s) saved in the internal document database of the system. A Document Manager window is opened on the screen.

The user has to point out to a certain document and click the Open button. Then the corresponding document is loaded into the system. The internal documents are stored together with information for their DTD. If their DTD is compiled in the system, then they are opened with respect to it. If the DTD is deleted (for some reason) from the DTD database of the system, the user is asked to choose a DTD from the available ones.

The user can choose document(s) to open in two modes:

If the Cancel button is chosen the manager window is closed and no document is loaded into the system.

The user can also open a document in the manager by performing a double click on a certain document name either in the list of all documents or in the list of the current group.

Note that Open menu does not open text files. If you want to load an XML document from a text file, then choose Import XML item.

Save

A shortcut Ctrl+O
An icon on the toolbar

Choosing this item the user saves the current document in the internal document database of the system. The user has to give a name for the document in a dialog box. Optionally the user can specify a document group in which the document should be included. Then the system tries to save the document. If there exists a document with the specified name, the user is asked to confirm the overwriting of the document or to choose a new name.

Delete

Choosing this item the user deletes document(s), saved in the internal document database of the system. A Document Manager window is opened on the screen.

The user has to point out to a document (or a set of documents) and click the Remove button. Then a confirm dialog appears. If the user clicks on the Yes button, the chosen document(s)  is(are) permanently deleted from the database. If the user clicks on the No button the document(s) is(are) not deleted.

Similar to the "Open" function, the user can choose documents in two modes: from all documents or from a certain group. When documents are removed from the list of all documents, the groups they belong are also updated.

The user can also delete a document in the manager by performing a double click on a certain document name either in the list of all documents or in the list of the current group.

Close

A shortcut Ctrl+F4

Choosing this item the user closes the current view of the current document and removes it from the memory.

If this is the only view of the current document and the document has been edited, then the user is asked whether he/she wants to save the changes.

When the view is closed, if there is at least one view, loaded in the system, the previous active view becomes a current view. If there is no more documents, the system blank view appears.

Document Manager

Opens the Document Manager window for exploring the internal document structure. For details see Document Manager


Import XML

An icon on the toolbar

Choosing this item the user loads a text file containing an XML document within the system. A standard dialog for choosing a file appears. The user has to specify the name of the file to load and its character encoding in Files of type: choice box. The possible encodings for files are: ASCII, UNICODE (UTF-16) or UNICODE (Microsoft version of UTF-16). Then the user is asked to choose a DTD from the DTD database of the system. If the document contains a DTD, this DTD is ignored during the parsing.

Note: If a document is opened in ASCII format (and it is sure it is an ASCII file) and in the system it contains different symbols than the expected ones, the possible problems are two:

  1. Inappropriate system font (for details see Options/Fonts);
  2. Inappropriate character encoding converter from ASCII to Unicode (for details see Options/Encoding Correction).

The system tries to parse the document. If the document is well-formed, then it is parsed into the internal representation. The system creates a view of the document, validates the document and if the document is not valid with respect to the chosen DTD, a list of errors is printed in the error window. A description of all validation errors can be found in Validation error messages section.

If the document is not well-formed, then the system reports an error. A detailed description of all parsing errors can be found in Parse error messages section. The errors of this kind have to be repaired with an editor outside the system. The error message reported by CLaRK system can help the user to find the error in the document.

ReImport

A shortcut Ctrl+R

When the user tries to load a document, which is not well-formed, an error message is reported by the CLaRK system and the user has to edit the document outside the CLaRK system. Then he/she would like to try to load the same document. In order not to go throughout the whole process of choosing the file and so on, the user can use ReImport item to try to load the last chosen document.

The system tries to parse the document. If the document is well-formed, it is parsed into the internal representation. The system creates a view of the document, validates the document and if the document is not valid with respect to the chosen DTD, a list of errors is printed in the error window. A description of all validation errors can be found in Validation error messages section.

If the document is not well-formed, then the system reports an error. A detailed description of all parsing errors can be found in Parse error messages section. The errors of this kind have to be repaired with an editor outside the system. The error message reported by CLaRK system can help the user to find the error in the document.

Export XML

An icon on the toolbar

Choosing this item the user can save the current document into a text file outside the system. A standard dialog for choosing a file appears. The user has to specify the name of the file which will contain the document and the character encoding of the exported text in Files of type: choice box. The possible encodings for files are: ASCII, UNICODE (UTF-16) or UNICODE (Microsoft version of UTF-16). If the files already exist the user is asked whether he/she wants to overwrite it.

Note: If a document is exported in ASCII format but the content of the output file is not readable for other programs or even for the CLaRK System, then the problem can be in a inappropriate character encoding converter from Unicode to ASCII (for details see Options/Encoding Correction).

The text in the file is formatted according to the layout specified for the DTD of the document.


Multi-Import

Choosing this item the user can load several text files containing XML documents within the system. A standard dialog for choosing a file appears. The user has to choose one or more files from a directory. The files have to contain XML documents in the same character encoding (ASCII, UNICODE (UTF-16) or UNICODE (Microsoft version of UTF-16)). The character encoding can be stated in the Files of type: choice box.

Note: If a document is opened in ASCII format (and it is sure it is an ASCII file) and in the system it contains different symbols than the expected ones, the possible problems are two:

  1. Inappropriate system font (for details see Options/Fonts);
  2. Inappropriate character encoding converter from ASCII to Unicode (for details see Options/Encoding Correction).

After choosing the files to be imported, a Multi-Import Manager dialog appears. Here is a screen shot of one example dialog window configuration:

The manager window contains the following components:

If a document is not well-formed, then the system reports an error. A detailed description of all parsing errors can be found in Parse error messages section. The errors of this kind have to be repaired with an editor outside the system. The error message reported by CLaRK system can help the user to find the error in the document.

Multi-Export

This item allows the user to export a set of internal documents: whole group or/and single documents. The user selects an output directory and encoding for all selected documents. Here is a screen-shot of the Multi-Export Manager window:

The manager window consists of:

Document Selector

The Document Selector is an universal component which is used in almost all system tools which can work with more than one document. The selector gives the user the ability to point to which documents from the internal document database a particular tool will be applied to. It consists of two sub-components: a selection list and a selecting dialog window. The selection list shows the currently selected documents. Initially this list is empty. Here follows a picture of the selection list. Usually it is embedded in another dialog window.

Three operations can be applied to this list: adding new list entries, removing selected list entries, clearing the whole list. These operations can be applied by using the buttons on the right:

The second sub-component of the Document Selector is a dialog window for adding entries to the Selected Documents list. This dialog window is visualized when the button Add Documents is pressed. Here is a preview of the dialog:

It supports three modes of document selection:

  1. Selecting a whole document group

    In order to select a whole group, the user must do two things. First, to select a group from the choice list "Document Group". It contains all groups in the system. The initial selected group is the last group used in the system. Changing the selection in this list updates the content of the list on the left with the new selected group content. The second thing is to select the radio button Add Whole Group, situated in the bottom right corner (visible on the picture above). This makes all entries of the list on the left to get selected and the selection can not be changed.

  2. Selecting single documents from a document group

    Here again the user must select a group from the "Document Group" list and then to switch the radio button Single Documents on. Changing the selected group updates the content of the list on the left with the new group content. The next thing to do is to select manually document from the list to be added.

  3. Selecting single documents from a list of all documents

    To select items from the list of all documents the user must select the option All Documents situated on the top of the window. The default selection here is always In Groups. Having selected "All Documents", the user is show a list of all documents where s/he can select single documents with no respect to the groups they belong to.

After the selection of documents is completed, the user must confirm it by using button OK or reject with button Cancel. In case of confirmation, the new selected documents are added to the Selected Documents list.


Exit

Choosing this item the user closes all opened files and exits the system. If there are unsaved documents, the user is asked whether to save the changes or not.