Home | Using Katmandoo | Quick Start Guide | How-toReference | Table of Contents | Using Help | See Also | Collapse All

Glossary for Templates

Main Form Template

All the main forms (such as Contact Main Form, Site Main Form, Trial Main Form etc) are based on the main form template.
Illustrative snapshot:
Main Form Template (Click it to change its size)
  1. Minimize, Maximize and close button of the form displayed in the MDI (Multiple Document Interface) form.
  2. Toolbar for the form (in this example Trial Main form).
  3. Filter for the form.
  4. data operation toolbar of the main form.
  5. data row navigation toolbar for main datagrid (6).
  6. Main datagrid with displayed data. 
    • Use [ View > Arrange columns in Main Form ] to arrange columns in this datagrid.
  7. Detail section of the main form, which displays more information of the selected row in the main form.
    • Click this button to hide the detail section. 
  8. Sub-forms that displays more information (using Virtual column) of the selection row in main datagrid (6)
  9. Status bar displaying message for the main form.

Data operation Toolbar / Record Menu of Main Form

All the main forms (such as Contact Main Form, Site Main Form, Trial Main Form etc) has data operation Toolbar and Record Menu.
Illustrative snapshot:
Main Form data Operation (Click it to change its size)
  1. Add a new record.
  2. Edit selected row in the main datagrid.
  3. Repeat (duplicate) selected row in the main datagrid.
  4. Delete selected row in the main datagrid
  5. Export data ("Trial Metadata" information in the snapshot) that are displayed in the main form.
  6. Import data ("Trial Metadata" information in the snapshot) from a source file.

Data row navigator Toolbar of Main Form

All the main forms (such as Contact Main Form, Site Main Form, Trial Main Form etc) has data row navigator toolbar to quickly access row in the main datagrid.
Illustrative snapshot:
Main Form data Row Navigator (Click it to change its size)
  1. Move to first row in the main datagrid.
  2. Move to previous row in the main datagrid.
  3. Row number of the selected row in the main datagrid.
  4. Total number of rows displayed in the main datagrid.
  5. Move to next row in the main datagrid.
  6. Move to last row in the main datagrid.
  7. Auto-resize height of all the rows in main datagrid.
  8. Auto-resize width of all the columns in main datagrid.

Navigator Template

All the navigators (Contact Navigator, Site Navigator, Trial Navigator, Genotype Navigator, Trial AOV Navigator and Meteorology Station Navigator) are based on the navigator template. It has following parts:
Use View Menu to show/hide currently Active Navigator.
Illustrative snapshot:
Navigator Template
  1. Click to load navigator nodes based on Latitude and Longitude of Location.
    • When this option is used, the search condition option (3-6 in the snapshot) is ignored.
  2. Click to close the navigator and its associated forms.
  3. Click to select a column name which is part of the search condition that is used to search data.
  4. Click to select an operator which is part of the search condition that is used to search data.
  5. Enter a search value (enter * to search all the data) which is part of the search (filter) condition that is used to search data.
  6. Click Search on Database (Search on Database) to load data using the search condition and build the navigator nodes using the loaded data.
  7. A root (parent node) of the navigator
  8. Child node of the root node (7)
  9. Move mouse-cursor to this splitter (mouse pointer is changed to splitter Mouse splitter ), and drag-it to change width of the navigator.

Open File Dialog

The Open File Dialog is used to select a file while importing data.
Illustrative snapshot:
Open File Dialog (Click it to change its size)
  1. Shortcut to access different folder or device.
  2. Folder currently selected
  3. Click it to "go to last folder visisted"
  4. Click it to move up one level
  5. Click it to create a new folder in the selected folder
  6. Click it to change the file view type to Thumbnails, Tiles, Icons, List or Details.
  7. Listed File Name that can be selected
  8. File name used as filter (in the snapshot "lo*.xls" means display all the files that start with "Lo" and has "xls" extension.) When a file is selected, it is changed to the selected file name.
  9. Select a File type to display the files of the selected type only.

Restricted data Entry Control

If the current record has dependant data, the data entry control is disabled in the Setup Form to restrict user from changing its value.

But only the system administrator can change the restricted value by clicking on [ Remove Restriction ] button which enables the data entry control so it can be edited. When the [ Remove Restriction ] button is clicked, it becomes invisible after enabling the restricted controls.

Setup Form Template

All the setup forms (such as Contact Setup Form, Site Setup Form, Trial Setup Form etc) are based on the setup form template. The template has following parts:
Illustrative snapshot:
Setup Form Template (Click it to change its size)
  1. Header of the current page (see 10)
  2. Description of the current page (see 10)
  3. A Label Control display the ContactId of the current Contact. Text value in the Label Control can not be edited.
  4. Label for the data entry controls (at the right of the label). In the snapshot, "Last Name" is the label for the text value "Shrestha". * (astrick) in the label "Last Name:*" indicates that a value must be entered in the control ie Last Name text box.
  5. Restricted text box which is disabled from editing its value because its dependant record exist in the database
  6. A non-restricted text box ie text value in the text box can be changed as required.
  7. Click on combo-box to select a value from its list.
  8. Click Reload From Database to reload the data from the database to populate the combo-box (ie Organisation Names in the snapshot).
  9. Click Apply Filter place filter in combo-box list ((ie Location Name in the snapshot) so that only the values matching the filter condition are listed.
  10. Current Page of the Setup Form Template.
  11. The [ Remove Restriction ] button is used to enabled the restricted data entry control (see 5) in order to edit its value. 
  12. Click either [ Cancel ] or [ X ] button to cancel the changes and return to the main form.
  13. When the form is in page 2 (see 10), click [ Back ] to move to the previous page ie page 1
  14. When the form is in page 1 (see 10), click [ Next ] to move to the previous page ie page 2
  15. Click [ Save and Exit ] to save the changes into the database and exit from the setup form.
  16. Virtual Column data Entry Datagrid

Virtual Column data Entry datagrid

The datagrid is used to display and enter data for the Virtual Columns of the respective table.
Illustrative snapshot:
Virtual Column data Entry data Grid (Click it to change its size)
  1. Currently selected row locator of the datagrid. In case of any error, the 
  2. Column Name in the column-cell of the selected row. Note that the datagrid is sorted on column name.
  3. Text cursor in the value-cell where data can be entered. Click on the value-cell to enter into the edit mode
  4. The error-icon is displayed in the value-cell that has error. In the snapshot the Jov end date has invalid date ie the date is not in dd/mm/yyyy format.

See Also