|| XML file which contain all OTX elements
|| OTX Core
|| ISO 13209-2
OTX documents can be stored in a file system or in a database. If stored in a file system, certain constraints on the organisation of files and folders allow a simple implementation to find OTX documents easily. The package name (in dotted notation) can simply be translated into a directory path or vice versa, whereas the OTX document name can be translated directly to the file name. It is an analogy to the file system organisation of packages and classes recommended the Java Language Specification.
|| File System
|| document name
|| File content
| Analogies between Java, C # and OTX
||Important: OTX documents are unambiguously identified with the combination of package name and their own name. This allows for having equal document names in different OTX packages and avoiding ambiguity.
||Important: Global entities (global constants, procedures, validities, etc.) contained in the OTX document are unambiguously identified with the combination of package- and document-name, and their name. This allows for having equal global names in different OTX files and avoiding ambiguity.
||Important: Due to the fact that the package name of an document shall not be empty, a so called Root-Package (root folder) shall be exist.
| Package/Document Structure of OTX stored in a file system (package name: Bold, document name: Italic)
An OTX document is a XML file contains all OTX elements. It contains header information like the document name, meta-data or imports and other global scope information like global declarations and validities followed by a list of signatures and a list of OTX procedures:
- This represents the Otx element's id (Otx element is the root element of the OTX document). It shall be unique among all other ids in a document.
- This attribute shall contain the name of the OTX document and it must match the OTX document file name. Among all the OTX documents defined within the same package, the document name must be unique to avoid ambiguities.
- This attribute shall represent the package which the OTX document belongs to.
- This attribute shall contain the version of the OTX document (for supporting versioning systems).
- This attribute shall contain the document creation timestamp.
- This optional element shall contain meta information concerning the OTX document as a whole.
- The static string content of this optional element shall be used to describe the purpose of the OTX document in simple prose.
- This optional element shall be used for linking to document history information. The linked information should be located in the top-level MetaData element of the OTX document (see above), but it may also be stored externally.
- Contains a list of Import elements for importing other OTX documents.
- Element representing the global declaration block where global constants, context variables and global variables shall be defined.
- A list of global scope validity terms shall be defined here.
- This optional element shall contain a list of Signature elements.
- This optional element shall contain a list of Procedure elements.