Tools Menu

Add Container (Alt-C)

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 the toolbar button

or the shortcut key Alt-C to achieve the same thing.
When this menu item is selected, you will be asked if you want to use percentage based layout.

Note: Please use percentage based layout throughout the layout! The column/row span based layout needs much more nested containers for complex form layouts. Also never mix and match percentage based layout with the
column/row span based layout.

If you click yes, 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, specify the size of an individual grid cell in percentages.
You select an individual cell by pointing and clicking in that cell in the preview. In the dialog box above, for example, the second row, first column is currently selected. The column occupies half of the container width (50%) and 40% of the container height. In the selected row , it seems that there are only two columns. Actually there are four columns like the other rows, but two of the columns have 0% width. You can not specify 0% height for a row.

When you edit any of the percentages, please do not forget to press Enter , to apply the change. Once you change the percentage of a grid cell's row or column, the remaining height/width in the container will be distributed preserving the ratio of height/width of the other rows, cells. Therefore, you may need to adjust the percentages more than once till you get the desired layout.

You can also set all column width for a row or a range of rows at once, by selecting lower and upper bounds (inclusive) of rows in the Set Column percents for row(s) section of the dialog box and pressing Update Row button. You will see a dialog box similar to the one below, where you can enter individual percentages.

Once you are satisfied with the cell arrangements, press OK button and Left click in any empty cell on the form layout pane of the CALM.

You can edit an existing container, either by left double-clicking in an empty cell or Ctrl - left double click anywhere with the particular container you are interested. The Container grid lines are only a visual guidance and they are not included in the final online assessment forms.

Adding a new row after a selected row in a container

While you can append rows and columns , to the end by using the dropdowns in the 'Adjust row/column numbers' section of the Edit Layout dialog, to add a new row after any row,

Select the row you want to add a new row after
Press the right mouse button to bring up the popup menu and select 'Add a row after the selected row'. A new row with equal column percents will be added after the selected row in the preview panel (Actually preview panel is the skeleton view of the actual container you are editing, therefore any change here will automatically affect the actual container. Cancel button will not undo the changes. This will be fixed in later versions)
Press OK button.

Deleting the selected row from the Container

Select the row you want to delete in the preview panel in the Edit Layout Dialog by clicking anywhere inside the row.
Press the right mouse button to bring up the popup menu and select 'Delete the selected row'.
Press OK button

Add Text (Alt-E)

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.

class (optional) - used for Cascaded Style Sheet (CSS) support. It corresponds to a class selector in the CSS stylesheet used by the generated JSP pages for the BIRN HID web application. The class selector must be defined in the $CLINICAL_HOME/web/pages/layout/clinical.css For example, let assume you have the following class selector definition in the clinical.css file
```
	.sars_question { color: blue; font-family: arial }
```
Then you can enter sars_question as the class for a multiline text component to be added to the CALM form layout design screen. In the final generated JSP the text will endup in blue Arial font.
justification (default Left justified) - used to specify the justification (alignment) of the component within its container cell.
label - used to specify multiline line text. You can also embed basic HTML adornments (<b>,<i>,<u> ).

A limited number of HTML tags are recognized as shown below.

Add Radio Button (Alt-R)

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 or shortcut Alt-R), left click in the grid cell you want to add a radio button.

class (optional) - used for Cascaded Style Sheet (CSS) support. It corresponds to a class selector in the CSS stylesheet used by the generated JSP pages for the BIRN HID web application. The class selector must be defined in the $CLINICAL_HOME/web/pages/layout/clinical.css For example, let assume you have the following class selector definition in the clinical.css file
```
	.sars_radio { color: blue; font-family: arial; 
                              border-style: solid;
                              border-color: #0000ff
                    }
    
```
Then you can enter sars_radio as the class for the radio button added to the CALM form layout design screen. In the final generated JSP the text of radio button will will end up in blue Arial font and there will be a blue border around the radio button and its text.
justification (default Center justified) - used to specify the justification (alignment) of the component within its container cell.
text - the text that will appear right to the radio button
value (optional) - the value that will be submitted to the web server when this radio button is pressed. In most cases this value is set using the associated score's score code information, thus in most cases you can leave this field blank.

Add Check Box (Alt-X)

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 or shortcut Alt-X), left click in the grid cell you want to add a check box.

class (optional) - used for Cascaded Style Sheet (CSS) support. It corresponds to a class selector in the CSS stylesheet used by the generated JSP pages for the BIRN HID web application. The class selector must be defined in the $CLINICAL_HOME/web/pages/layout/clinical.css For example, let assume you have the following class selector definition in the clinical.css file
```
	.sars_check { color: blue; font-family: arial; 
                              border-style: solid;
                              border-color: #0000ff
                    }
    
```
Then you can enter sars_check as the class for the check box added to the CALM form layout design screen. In the final generated JSP the text of the check box will will end up in blue Arial font and there will be a blue border around the check box and its text.
justification (default Center justified) - used to specify the justification (alignment) of the component within its container cell.
text - the text that will appear right to the radio button
value (optional) - the value that will be submitted to the web server when this check box is pressed. In most cases this value is set using the associated score's score code information, thus in most cases you can leave this field blank.

Add Text Input Field (Alt-T )

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 or shortcut Alt-T), left click in the grid cell you want to add text input field.

class (optional) - used for Cascaded Style Sheet (CSS) support. It corresponds to a class selector in the CSS stylesheet used by the generated JSP pages for the BIRN HID web application. The class selector must be defined in the $CLINICAL_HOME/web/pages/layout/clinical.css For example, let assume you have the following class selector definition in the clinical.css file
```
	.sars_textfield { color: blue; font-family: arial; 
                              border-style: solid;
                              border-color: #0000ff
                    }
    
```
Then you can enter sars_textfield as the class for the text field added to the CALM form layout design screen. In the final generated JSP the text in the text field will will end up in blue Arial font and there will be a blue border around the text field.
fieldLength (default 10 characters)
justification (default Left justified) - used to specify the justification (alignment) of the component within its container cell.
maxFieldLength (default 10) - maximum number of characters that can be entered into this text input field.

Add Text Area Field (Alt-A )

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

class (optional) - used for Cascaded Style Sheet (CSS) support. It corresponds to a class selector in the CSS stylesheet used by the generated JSP pages for the BIRN HID web application. The class selector must be defined in the $CLINICAL_HOME/web/pages/layout/clinical.css For example, let assume you have the following class selector definition in the clinical.css file
```
	.sars_textarea { color: blue; font-family: arial; 
                              border-style: solid;
                              border-color: #0000ff
                    }
    
```
Then you can enter sars_textarea as the class for the text field added to the CALM form layout design screen. In the final generated JSP the text in the text area will will end up in blue Arial font and there will be a blue border around the text field.
justification (default Left justified) - used to specify the justification (alignment) of the component within its container cell.
numCols - width of the textarea in characters
numRows - the height of the textarea in number of lines

Add Dropdown Field (Alt-D )

This menu item is used to add a static dropdown field to one of the cells in a container. After selecting the menu item ( or the corresponding toolbar button or shortcut Alt-D), you will see a dropdown selection dialog where you can create your own dropdown with its option list or selected from canned dropdowns. Currently, the only canned dropdown is informant relation dropdown. After that you will see a dialog box like below, where you can edit dropdown properties and edit the dropdown option list. Once you are finished thes steps, left click in the grid cell you want to add a dropdown field.

class (optional) - used for Cascaded Style Sheet (CSS) support. It corresponds to a class selector in the CSS stylesheet used by the generated JSP pages for the BIRN HID web application. The class selector must be defined in the $CLINICAL_HOME/web/pages/layout/clinical.css For example, let assume you have the following class selector definition in the clinical.css file
```
	.sars_dropdown { color: blue; font-family: arial; 
                              border-style: solid;
                              border-color: #0000ff
                    }
    
```
Then you can enter sars_dropdown as the class for the text field added to the CALM form layout design screen. In the final generated JSP the text in the dropdown will will end up in blue Arial font and there will be a blue border around the text field.
justification (default Left justified) - used to specify the justification (alignment) of the component within its container cell.

Add Button (Alt-B )

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

action (default Submit, One of Submit, Previous, Next) - the type of button that can be used with the Generic Assessment Management Engine (GAME) in the BIRN HID web application. If you have a multiple page assessment form, The first page will have a Next button, all but the last of the remining pages will have a Previous and Next button. The last page will have a Previous and Submit button. A single page assessment without a cover page will have a single Submit button.
class (optional) - used for Cascaded Style Sheet (CSS) support. It corresponds to a class selector in the CSS stylesheet used by the generated JSP pages for the BIRN HID web application. The class selector must be defined in the $CLINICAL_HOME/web/pages/layout/clinical.css For example, let assume you have the following class selector definition in the clinical.css file
```
	.sars_button { color: blue; font-family: arial}
    
```
Then you can enter sars_button as the class for the button added to the CALM form layout design screen. In the final generated JSP the text in the button will will end up in blue Arial font.
justification (default Left justified) - used to specify the justification (alignment) of the component within its container cell.

Select Components (Alt-S)

This menu item enables mouse based selection of a portion of the layout. Just 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. The color of the selected container/ display component(s) will change to blue. Then press the right mouse button to active the popup menu. You can either

Save the selected container as a template
Delete the selected container / display component(s)
Copy the selected container / display component(s) to be pasted to an another place in the layout by left clicking the mouse inside the grid cell you want to paste.
Or logically group or ungroup a group of display components ( like a group of radio buttons ) to be associated with a score.

Add TemplateComponent (Alt-Z)

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

Struts Code Generator (Alt-G)

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 andupdate the struts-config.xml file for the Generic Assessment Management Engine (GAME) in the HID web application. For this, either select Struts Code Generator from the Tools menu or press Alt and G keys simultaneously.

Show Associations (Alt-H)

Toggles the assessment score association hint information display in the form layout for quickly detecting which fields are associated with a score. The first 8 characters of the Score name will be shown in the upper left hand corner of the form field.

Show Question Groups (Alt-Q)

Toggles the question group hint information display in the form layout for quickly detecting which fields are comprise a question. The fields in a question will be
hilited in orange and the question number will be shown in red.

Save Assessment to DB (Alt-D)

Saves the modified assessment, scores, score codes and assessment items ( question text) to the connected Oracle database if and only if the assessment is not populated with subject data. This option will first remove the previously existing assessment records and create a new assessment.