TANDBERG D13639 manual XML Documents, Status Documents r

TANDBERG MPS API

User Guide

1.4 The XML Documents

1.4.1 Documents

The XML Data in the TANDBERG systems are divided into three main types of documents. The division is based on whether the information is Read Information, Write Information or Read-Writeinformation:

1.Status documents (r): Documents holding all available Status Information in the system.

Supported documents:

a.status.xml

b.history.xml

2.Configuration documents (rw): Documents holding all system configurations. Supported documents:

a.configuration.xml

b.directory.xml

3.Command documents (w): Documents defining the supported system commands used to initiate system processes. This is write data, i.e. the parameter values for a given command are defined by the user and posted to the system. The posted values will not be returned when reading the document from the system. Reading a command document from the system returns descriptions of the supported commands with empty parameter values.

Supported documents:

a.command.xml

4.Meta Documents: Meta documents contain information that can be referenced by other documents, e.g. value domains of configurations or command parameters. Supported Meta Documents:

a.valuespace.xml

1.4.2 Status Documents (r)

The Status Documents are characterised by an extensive use of XML attributes. In addition to holding information, the attributes are used to reflect the structure of the sub-elements, which are dependent on the state of the system.

Example 9

The element Call will contain different sub elements depending on the call state, call type or direction:

<Call item="1" status="Synced" type="Vtlph" protocol=”H323” direction="Outgoing">

<CallRate item="1">768</CallRate> <RemoteNumber item="1">58458</RemoteNumber> <Mute item="1">Off</Mute>

<Microphone item="1">Off</Microphone> <Duration item="1">15</Duration> <Channels item="1" type="Incoming">

<Rate item="1">768</Rate> <Restrict item="1">Off</Restrict> <Encryption item="1" status="Off" /> <Audio item="1" status="Active">

<Protocol item="1">G722</Protocol> <Rate item="1">64</Rate>

9