Almost all of the configuration files in Corda® 7 are in XML.
XML (Extensible Markup Language) is a meta-markup language used to describe everything from data in a database to word-processing documents to graphs and maps. Its versatility, uniformity, and ease of use have led to its rapid acceptance as the standard for information sharing.
There are numerous resources on the Internet for learning XML, so this reference does not endeavor to teach you XML. Instead, it offers a quick example to clarify the conventions and notations used in this documentation.
The example below shows a typical XML document, followed by a brief explanation of its different parts.
Document Header Specifies the document type (XML), version (1.0), and encoding (ISO-8859-1). It is good practice to include this line in XML documents, but Corda Server™ does not require it.
Top Property The first property in the document. All other properties in the XML document are contained by the top property. In ITXML, the top property is cit:image-template (see the example above).
Property An organizational tag used to specify XML data. Properties can be nested to provide structure to the XML document, with no limit to the number of properties nested within another property. Properties require a starting tag (e.g., <cit:row>), followed by data and a closing tag (e.g., </cit:row>). Properties that do not contain any other properties can be "self terminated" with a forward-slash at the end (e.g., <cit:note-settings fill-color="#FFFFC8"/>). Starting tags can include any number of attributes.
Attribute Provides specific data related to the associated XML property. A property can have any number of attributes, all of which are listed in the property's starting tag. An attribute consists of the attribute name, an equals (=) sign, and an attribute value enclosed in either single or double quotation mark (e.g., name="graph").