View source for Core.Documents

{{DISPLAYTITLE:OTX '''Documents'''}}[[Category:OTX-Core]][[Category:Documents]]
== Classification ==
{{ClassificationCore | Documents | XML file which contain all OTX elements | [[OtxReference#Core|OTX Core]] | - }}

== Introduction ==
{{PackageDocumentIntroduction}}

== Semantics ==
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:

*  '''Id''' (required)
: 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.
*  '''Name'''
: 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.
*  '''Package''' (required)
: This attribute shall represent the package which the OTX document belongs to. 
*  '''Version''' (required)
: This attribute shall contain the version of the OTX document (for supporting versioning systems).
*  '''Timestamp''' (required)
: This attribute shall contain the document creation timestamp.
*  '''MetaData'''
: This optional element shall contain meta information concerning the OTX document as a whole.
* '''Specification'''
: The static string content of this optional element shall be used to describe the purpose of the OTX document in simple prose. 
* '''AdminData'''
: 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. 
* '''Imports'''
: Contains a list of '''''Import''''' elements for importing other OTX documents.
* '''Declarations'''
: Element representing the global declaration block where global constants, context variables and global variables shall be defined.
* '''Validities'''
: A list of global scope validity terms shall be defined here. 
* '''Signatures'''
: This optional element shall contain a list of '''''Signature''''' elements.
* '''Procedures'''
: This optional element shall contain a list of '''''Procedure''''' elements.

== Checker rules ==
{| {{TableHeader}}
{{TableRowKeyValueList|[[Core.Validation.CoreChk001|Core_Chk001]]|Document name matches file name}}
{{TableRowKeyValueList|[[Core.Validation.CoreChk002|Core_Chk002]]|Package-wide uniqueness of document names }}
|}

== See also ==
[[General.NamingConventions|Naming Conventions]] <br/>
[[Core.Imports|Imports]] <br/>
[[Core.Validities|Validities]] <br/>
[[Core.Declarations.GlobalDeclarations|Global Declarations]] <br/>
[[Core.Signatures|Signatures]] <br/>
[[Core.Procedures|Procedures]] <br/>
[[Core.Validation|Validation (OTX-Checker)]] <br/>