Clinical Assessment Layout Manager (CALM) Tool

This application facilitates preparation on online clinical assessment entry forms. Each online clinical assessment consists of multiple pages. Each page consists of an arbitary depth container and display elements hierarchy. A container contains zero or more display components. A display component corresponds to a form field like text entry field, radio button or  to styled text. Each container has a layout manager which constraints how its children (other containers and/or display elements) are
laid out wrt each other and their parent container.

Tools Menu

Add Container

This menu item is used to add a container to the current page of the clinical assessment you are working on.  A container contains zero or more display components.
A display component corresponds to a form field like text entry field, radio button or  to styled text. You can also press thetoolbar button  to achieve the same thing.
When this menu item is selected, you will see a dialog box like the one below;


In this dialog box, you can edit the layout manager for the container you want to add to the clinical assessment layout by changing the number of rows and/or the
columns of the grid, changing the number of rows and/or columns a grid cell spans.  You select an individual cell by pointing and clicking in that cell in the preview.
Once you are satisfied with the cell arrangements, press OK button.

Add Text 

This menu item is used to add multiline styled text to one of the cells in a container.  After selecting the menu item ( or the corresponding toolbar button)
left click in the grid cell you want to add text. You will first see a property editor where you can enter the styled text. A limited number of HTML tags are
recognized as shown below.



Add Radio Button 

This menu item is used to add a radio button with optional text to one of the cells in a container. After selecting the menu item ( or the corresponding toolbar button)
left click in the grid cell you want to add a radio button.

Add Check Box 

This menu item is used to add a check box with optional text to one of the cells in a container. After selecting the menu item ( or the corresponding toolbar button)
left click in the grid cell you want to add a check box.

Add Text Input Field 

This menu item is used to add a text input field  to one of the cells in a container. After selecting the menu item ( or the corresponding toolbar button)
left click in the grid cell you want to add text input field.

Select Components 

This menu item enables mouse based selection of a portion of the layout. Just press the left mouse button outside of the container you want to select and drag the mouse till the rubber band totally includes the container you want to select and release the button. The color of the selected container will change to blue. Then press the right mouse button to active the popup menu. You can  either

Add Template 

This menu item allows you to select a template from  the list of previously saved templates and insert into any location in the currently edited page of the clinical
assessment


Working with Multiple Page Clinical Assessment Layout Documents 

While working with multiple page assessment layouts, you can select the page you want work on by selecting the corresponding page number from the dropdown in the toolbar. You can add a new page by pressing the button in the toolbar.

Once you are down with a document you can select File->Save As to save the layout document in XML. You can load a saved layout document via File->Open menu item.

Editing container and display element properties 

To edit a display component double click on the component, which will popup a property dialog, where you can edit the properties of the display component. To
edit the grid layout of a container, double-click in an empty grid cell. You can delete a display element by right clicking on that display element which shows a popup
menu, from which you select Delete. To copy a display component, right click and select Copy from the popup menu.



Associating the assessment scores with the form elements 

Select Associate from the Tools menu. If you are not connected to your database before during your form building session, you will see the following dialog box



After you entered your database parameters, you should see a list of available assessments from which you need the the select the one that your form(s) are for.



Now you should see the UI to assessment score association dialog box. The left tree in the dialog shows the assessment and its score hierarchy and two
mandatory variables, namely Time and Date which should be associated with text edit controls in the form. (If you have multiple forms for an assessment,
then this time and date text boxes  must be in the first form). The right tree shows the currently loaded document hierarchy. Each document can have multiple
pages (forms). So you can associate an assessment score with a component ( like an edit field) or with a group of components ( like a group of radio boxes).
When a score is associated with a form component its tree node becomes green. To associate a score, right click and select Associate from the popup menu


   


Now you should see the Association dialog.   From the form document hierarchy select the container or component you want to associate the score with. Then associate the Score Value. Since a single score value can be bound (associated) with a group of form components, there is not always a one-to-one mapping of scores with form elements. Here the score 'awake' is associated with container having ID C34 (The IDs are assigned automatically by the CALM editor).  Notice the <group> tag on the
container which means the child form elements are logically grouped. CALM editor reads the possible values for the selected score from the database and by default
assigns each form element in the group to the possible score values in ascending order. You can change the assignment order of the form elements by clicking and selecting from the drop-down of the table cell under Associated Component column




Code Generation from the CALM Form Editor ( for Struts Framework)

Once you had associated all the assessment scores and the mandatory fields with the form components, it is time to generate the JSPs, Struts Form Bean and
update the struts-config.xml file for the Generic Assessment Management Engine (GAME) in the HID web application. For this, select Struts Code Generator
from the Tools menu. You should see the following dialog box.




Since each clinical assessment can map to multiple JSPs, the names of the to be  generated JSPs must be specified. CALM form editor gives them default names.

After you have populated the dialog box, press OK to start code generation.