D Rats Forms and messages internal formats - wb8tyw/D-Rats GitHub Wiki

Forms and style sheets

Each form is an XML document and either has an associated style sheet or uses a default style sheet. D-Rats provides a Form Editor. I have not yet determined if it also updates the style sheet.

A style sheet is an XML document containing data on how to render the XML elements.

The form XML document has a repeating set of "form blocks"

D-rats places some restrictions on some of the blocks, such as only one "title".

<xml>
<form id='email'>
<title>Email Message</title>
<field id='subject'>
<caption>Subject</caption>
<entry type='text'/>
</field>
<field id='message'>
<caption>Message</caption>
<entry type='multiline'/>
</field>
</form>
</xml>

Messages

Messages are also sent as XML documents.

The actual message over the wire will probably be gzipped.

Any attachments to the message were gzipped when attached to the message, so they are double gzipped over the wire. That double gzip can make the message size larger.

<?xml version="1.0"?>
<xml>
<form id="email">
<title>Email Message</title>
<field id="subject">
<caption>Subject</caption>
<entry type="text">Test with attachment</entry>
</field>
<field id="message">
<caption>Message</caption>
<entry type="multiline"/>
</field>
<path><e>WB8TYW-1</e><src>WB8TYW-1</src><mid>WB8TYW-1.1df6286a.6f07</mid><dst>WB8TYW-2</dst></path><att name="setup.cfg">eNqLTkrJLC6JLyrIjeUqSi0szSxKLVawVSioLMnIz9NNz0lMSTXSgXFzMpMqcnNQ+cU5JYZwgeLUoszEHC4ATYEfOg==</att></form>
</xml>
⚠️ **GitHub.com Fallback** ⚠️