Chetco Digital Instruments SeaSmart.Net, Руководство пользователя, Страница: 43 / 59

SeaSmart.Net Adapter Manual Version1.3
43
•
An element typically consists of two tags, a “start tag” and an “end tag,” possibly surrounding text
and other elements.
•
The start tag consists of a name surrounded by angle brackets, like <configrecord>.
•
The end tag consists of the same name surrounded by angle brackets, but with a forward slash
preceding the name, like </configrecord>.
•
The element content is everything that appears between the start tag and end tag, including text and
other (child) elements.
In addition to content, an element can contain attributes—name-value pairs included in the start tag after
the element name.
•
Attribute values must always be quoted, using single or double quotes.
•
Each attribute name should appear only once in an element.
SeaSmart.net uses the following attributes to label the group configuration settings.
Record, Group, Item, and Value Tags
A <configgroup> is a logical grouping of configuration parameters and must contain one
or more <configitem> elements. It must have a name attribute and may have an instance
attribute.
A <configitem> is a specific grouping of configuration parameters relevant to its parent
group. An item takes the name attribute and must contain one or more value elements.
For example, the line group might have parameters such as baud rate, data bits, and
parity.
A value may specify the value of a configuration parameter. It may take the name
attribute. In our example, a value of 9600 might be specified for baud rate; 7 may be
specified for data bits, and even may be specified for parity.
•
_ A name attribute identifies the group, item, or value. It is always quoted (as are all XML
attributes). For example, a group that contains serial port parameters has the name “line”.
•
_ An instance attribute identifies which of several instances is being addressed. It is always quoted.
For example, the serial port name has the instance “1” to indicate serial port 1 or “2” to specify
serial port 2.
The following figures show examples of XML configuration records and the use of the
<configrecord>, <configgroup>, <configitem>, and <value> XML elements.