Layout

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 append 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. (See Tools Menu Documentation).
To edit the grid layout of a container, double-click in an empty grid cell or Ctrl-double click in the container. Please note that, if multiple containers are nested and you want to edit one of those outer cells, Ctrl- double click outside the border of the container that is included by the container you want to edit.
New: As of 3/29/2006, you can adjust the width of individual grid cells and the height of a grid row by mouse visually. Just press and hold Control key and move the mouse pointer close to the border of the grid you want to adjust in the container cell in the Layout pane and press the left mouse button and drag the border till it is at the desired position and release the mouse button. This way, you can quickly fine tune a layout.
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.
To copy a group of display components ( for example to copy a whole laid out question ), select Tools->Select Components or (Alt - S) and press the left mouse button outside of the container/ display component(s) you want to select and drag the mouse till the rubber band totally includes the container / display component(s) you want to select and release the button. Then right click and select Copyfrom the popup menu.
To logically group or ungroup a group of display components ( like a group of radio buttons ) to be associated with a score, select Tools->Select Components or (Alt - S) and press the left mouse button outside of the container/ display component(s) you want to select and drag the mouse till the rubber band totally includes the container / display component(s) you want to select and release the button. Then right click and select Logically Group Selection or UnGroup Selection from the popup menu.
Since what constitutes a question is based on the content, the components belonging to a question needs to be explicitly specified to CALM especially for generating logic for unanswered questions, notes handing and multi-answer question logic handling. This is acomplished by;

selecting Tools->Select Components (or pressing Alt - S) and pressing the left mouse button outside of the container/ display component(s) you want to select and drag the mouse till the rubber band totally includes the container / display component(s) you want to select and releasing the button.
Right clicking and selecting Group Selection as a Question from the popup menu.
Editing the question meta data (like question type (regular or multi-answer and attributes like minimum and maximum number of answers) in the shown dialog box.

To ungroup a selected question, select Tools->Select Components or (Alt - S) and press the left mouse button outside of the container/ display component(s) you want to select and drag the mouse till the rubber band totally includes the container / display component(s) you want to select and release the button. Then right click and select Ungroup Selected Question from the popup menu.

Creating a multi-answer question

A multi-answer question, (like drug dosage history) is laid out like any regular question with following two constraints;

Each multi-answer question needs to be contained within a SINGLE container row with a SINGLE column of the topmost container you have added for the assessment page. Since containers can be nested arbitarily, the layout possibilities within that single container row is not limited.
Each multi-answer question needs to have an Add button component to add new input for additional answers (upto (and including) the max allowed answer limit)
New: As of 4/4/2006, each multi-answer question can have also a Remove Last button component to remove the current last answer displayed on the form. Thus you can delete multiple answer entries starting from the last one going backwards excluding the first entry which is not allowed to delete and ignored if attempted

An example multi-answer question layout is shown below

The container layout for this question is shown below. Notice that the whole multi-answer question is contained within an outer container (the black container), that is necessary for the question to be recognized as multi-answer question with potentially multiple score assignments (like the question above).

Once a multi-answer question laid out, the input fields can be logically grouped (for mutually exclusive radio button groups, and check box groups) and associated with their corresponding scores like a regular question. Then the question needs to be grouped (See Group Selection as a Question above) and the question metadata information needs to be supplied

question type = multi-answer
Min Answer = 1 (always needs to be one currently)
Max Answer (> 1) (Even if you don't know the possible maximum answer number, provide a conservative guess. There will be maximum answer number of hidden form fields, so the conservative guess needs to be reasonable.)