Tools Menu

Add Container (Alt-C)

 

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.

Adding a new row after a selected row in a container

1. Select the row you want to add a new row after
2. 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)
3. Press OK button.
   

Deleting the selected row from the Container

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

Add Text  (Alt-E)

• 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> ).
  

Add Radio Button  (Alt-R)

• 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) 

 

• 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 )

• 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 )

• 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 )

You can also create a dynamic dropdown which is populated from the SQL query you provide when deployed under HID web application. As of 3/10/2005 only clinicalrater mandatory field is recognized by the Struts code generator in CALM and GAME in HID web app for SQL backed dropdowns. When you select 'Dynamic' from the  dropdown type selection dialog box , you will see a dialog box like below, where you can provide the SQL query to retrieve the contents of the dropdown from the underlying database for HID web app. Once you are done editing dropdown properties, 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.

Skip Button for Conditional Skipping

Conditional skipping ( leaving a certain number of questions constituting a section in the online assessment unanswered ) is provided by adding skip button(s) to
the form. The button properties dialog box for a Skip button is shown below

For each section to be (potentially) skipped, you  need a  different Skip button. To differentiate Skip Buttons  visually ,  you can  provide different button label. Every question in the assessment laid out has  a unique question ID assigned by CALM. You can view, the question IDs in the current form page viewed in CALM by selecting Tools->Show Question Groups and selecting the checkbox.  If you check JavaScript Only checkbox, the request will not go to the server but be handled by client side JavaScript only, thus only affecting the current page of the form. If you have sections spanning multiple pages, you need to use server side conditional skipping which you can indicate by unchecking JavaScript Only checkbox.

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 Association  Tips (Alt-O)

Toggles the assessment score association tip display in the form layout for quickly detecting which fields are associated with a score. Just point your mouse inside  a form field. A text describing the score this component is associtated in a small popup display.  If the form field is not associated with any scores nothing will popup.

Show Question Groups (Alt-Q)

Toggles the question group hint information display in the form layout for quickly detecting which fields 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. As of October 2005 you can remove an assessment which is already populated with subject data if you choose to do so. This option will first remove the previously existing assessment records and create a new assessment.