A Communications Tool For D-STAR

Building Custom Forms PDF Print
Article Index
0.1. Message Templates
0.1.1. Form Manager
0.1.2. Creating or Editing a Form
0.1.3. Form Elements
0.1.4. Form Elements Types
0.1.5. Form Attachments:

0.1. Message Templates

The Form Manager program was designed to use XML (Extensible Markup Language) for encoding documents electronically. XML design focuses on document design and it is widely used for the representation of arbitrary data structures. It is used in conjunction with XSL “Extensible Stylesheet Language” for transforming and rendering XML documents. What you need to understand about this design is that it is very efficient in the storage of information and provides a platform which allows for the maximum amount of information to be sent in the least amount of time. These efficiencies are very important in Emergency communications situation, where you are tasked to move a lot of information on frequencies that may have substantial network congestion.

0.1.1. Form Manager

When working with the “Form Manager” the user is given a listing of those documents currently existing on the DRATS system. The Form Manager lists the documents by ID and Title.
The user is given four choices (New, Edit, Delete and Close) from the initial Form Manager window. To create a new Message Template select “New”, to edit and existing template highlight your choice and select edit, to delete a template select the template and select delete. To close the Form Manager select the close option.
form_manager

0.1.2. Creating or Editing a Form

When selecting the “New” option the following “Form Builder” menu is displayed. It is from this menu that the user will design a new form or modify an existing form.
form_builder
By design the top three fields of the document are fixed by the application software: (Title, ID and Logo). The “Title Box” is used to set the document title, while the ID is basically the document name. The document ID needs to be unique, while the document title may be duplicated. The Logo is the path to your form Icons. The default path is “C:\Program Files\D-RATS\” (on Windows) it is recommended that you create an ICON directory at this location, and then put all you Icons/Logos in that newly created folder. The path on the Logo line would then read: Icon\filename.filetype. It should be noted that the application is capable to displaying most types of graphics: .jpg, gif (static or animated), tif, bmp and etc. It is capable of displaying an animated .gif. One caution is that graphics that are too big will overwhelm the form, so select an appropriate sized (approximately AAAxYYY) image. It should also be noted that the graphic is not sent as part of the form and that to work both the sender and the recipients must have the same graphics stored at the same path locations.

0.1.3. Form Elements

The form elements: ID, Type, Caption, Initial Value
  • ID default is “foo”, but this item can be renamed.
  • Type: Must select one of the “Form Elements”, which are program defined.
  • Caption: The display name of the field as shown to the user (can be set by the form editor).
  • Initial Value: Shows the initial (or default) value the field will have, if any.
On the bottom of the form there are three options: Save, Cancel and Preview:
  • Save: this option will save the exiting information in the form and return to the “Form Manager”.
  • Cancel: this option will return the user to the “Form Manager” menu, without saving information.
  • Preview: will show you the existing form as it will be displayed when used.
When previewing a form there are four options: Cancel, Save, Export and Printable:
  • Cancel: returns the user to “Form Builder”.
  • Save: saves the form format and returns to “Form Builder”.
  • Export: Exports the current form to an “HTML” format and allows user to save it to an HTML file.
  • Printable: converts and shows the current form in HTML format.
form_preview
Along the right side of the “Form Builder” page there are five options:
  • Add: This option will add a new element or line to the form.
  • Edit: This option allows the user to edit and existing line in the form.
  • Delete: This deletes the selected line from the form.
  • Move up: This will move the selected line up one position on the form.
  • Move down: This will move the selected line down one position on the form.

0.1.4. Form Elements Types

  • ID: Default is “foo” this can be changed to add clarity, it is recommended to select a single-word identifier that makes sense (i.e. ‘subject’, ‘type’, ‘destination’, etc.).
  • Type: opens the following menu:

form_edit_element

 

From the above item the droop down list displays the following valid Field types. The Initial value is set using this menu.

 

  • Text: The input will be standard text.
  • Numeric: The input and numeric serial or auto number field. The user is given the opportunity of where to start the number sequence.
  • Choice: Allows user to select one item from a user defined list.
    choice_example
  • Toggle: Users can set the default value, and toggle that choice with a check mark. 
    toggle_example
  • Multiline: This element is where most of the message information is input. 
    multiline_example
  • Time: Is based on military time (24H): Hours (00-23), Minutes (00-59), Seconds (00-59)
    time_example
  • Date: The date field is fixed at Month (Jan-Dec), Day (1-31) and Year (2007-2010). The year feature currently is limited to four years, but will be corrected on the next revision to span 10 years based on the computers current date stamp.
    date_example
  • Multiselect: Allows user to select one or more items from a user defined list. 
    multiselect_example
  • Label: The only option with this feature is to change the Caption. Labels are shown in “BLUE” text on a message form.
    label_example

 

The Caption strings are user defined and are displayed next to the input fields for each element in the form presented to the user.

 

0.1.5. Form Attachments:

Each form is equipped with a fixed attachment block as follows:

 

attachment_example

 

Users can attach as many files as they would like, but it is advisable to keep the total size small. Users should know that DRATS running low speed DV mode are only capable of sending 950bps and computer files are shown in bytes. So a 10KB computer file is equivalent to approximately 80,000 bits. This means that to send that much information it is going to take approximately 84 seconds of dedicated transmission time. The larger the file the more problems you may experience on high usage transmission frequency. The block size that you have set in your preferences under the “transfers” section is also going to segment files based on the block size selected. This along with the files size and network congestion and retry sequences will determine the time it takes to transfer information.

 

As users attach files they are able to use the browse feature to located files. Once they get all of their attachment added, they will save them.

 

 

Last Updated on Monday, 14 September 2009 12:15
 

Valid XHTML 1.0 Transitional CSS ist valide!