COM-FSM

Tutorial

Page last modified 01:43, 12 Sep 2008 by Admin
    Table of contents
    1. 1. Forms
    2. 2. Form Elements
      1. 2.1. Key Values
      2. 2.2. Fields
      3. 2.3. Tables
      4. 2.4. Controls
    3. 3. Field Types

    Version as of 04:27, 22 Nov 2024

    to this version.

    Return to Version archive.

    View current version

    Forms

    Information contained in the student database is created, viewed and modified using forms. Each form is designed to manage information from a specific functional area of the database, and typically covers one or two closely related types of records. The Person form, for example, is used to manage biographical information and includes basic information like date of birth and gender, along with address information.

    Individual forms will never manage information from multiple functional areas. This restriction helps keep information more logically organized, and makes security easier to manage. A form may display information from another area when appropriate, but updates to that information aren't possible. The Award Package form for financial aid is a good example; it displays a summary of student data that is relevant to their receiving financial aid awards, but the information can't be modified.

    Form Elements

    All forms display and manage information in similar ways, and this tutorial covers topics that are common to how all forms operate. Understanding and using the large number of forms that are part of the student database is easier than you may expect, mainly because they all operate in a similar way.

    The Course form provides a good example of how forms work. It includes most of the elements used in all forms. We'll cover other elements using the (???) form later. If you haven't read the Overview already, please take the time now to do so. Many aspects of how forms work are covered there and may not be described again below.

    Key Values

    The Course form manages information in the course catalog, which include course titles, credits, co- and pre-requisites, and course fees. Each course is identified by a unique combination of a subject and course number. Subject and course number are "key values" on the Course form, used to identify one specific course to create, display, or modify its information.

    course1.pngThe top of the Course form contains two select lists. The first, labeled Subject, contains a list of all the Subject codes defined in the database. The first step in identifying a course on this form is to select a subject. You can't enter information elsewhere on the form without first specifying a valid subject. If you try, the focus (where the cursor is blinking) will simply return to the subject list.

    The Course field is also a select list, but its contents are related to Subject. When forms have multiple key values, they become increasingly specific as they're listed from left to right or top to bottom. The Course list only contains values for courses with the Subject you've already entered. In the example above, no Accounting courses exist so the list is empty (indicated by a grey triangle).

    If you are displaying or modifying an existing course you can select it from the list. If you're creating a new course you can simply type in the course number (note that this select field has a + next to the triangle to indicate that new values may be added). The combination of the two fields identifies a specific course so it isn't necessary or appropriate to include the subject code in the course number. The course "AC 131" has subject of "AC" and a course number of "131."

    Both Subject and Course are required fields (indicated by the red dot next to the field label). Since both are key values, both must be specified before any data may be entered in the remainder of the form.

    Fields

    The details for each course are entered in various fields in the Course Information portion of the form. Each field will expect a specific type of information to be supplied, and some may be validated.

    course2.pngLevel is a validated field and is required (it has that red dot). Most validated fields show a description to their right, which can't be modified. The list of valid level codes can be found on the Level validation form.

    The Credits fields (Min and Max) expect numbers. Note that only Min is required. All numeric fields will have a limit on the size of the value entered, and will reformat what you enter to a field-specific precision. Credits, for example, has one place to the right of the decimal and must be less than 100.

    Title is a plain text field. It will have a limit on how many characters of data it can hold, but isn't checked or limited in any other way. Description is similar, but can accept much more information. Both are required.

    In this example we're creating a new record for AC 131, which the icon to the left of the Level field indicates. Each grouping of information will have an indication of whether the data is new, modified, or locked.

    Tables

    Further down the Course form we have a table of Course Requisites. Tables are built using fields exactly like those we have used elsewhere on the Course form.

    course3.pngRequisites are other courses that must be taken before or concurrently with a course. As described above, courses are identified with a unique combination of subject and course number, so each requisite includes that information and a Requisite Type of P (pre-requisite) or C (co-requisite). Subject is a validated field, and Subject and Course together must identify a known course (the combination of both is validated). Title is the course title matching the entered Subject and Course, MS 098 in this example.

    In this example, we're creating a new Requisite, so the row number is amber to indicate that it has not been saved to the database. Tables show any unsaved changes, including deleted rows, with the same amber row number.

    The right-most column is the delete control. Checking the delete control in a table row will indicate that record should be deleted when the form is submitted.

    Controls

    course4.pngAll forms have a set of buttons at the bottom of the form to perfom common tasks.

    The Reset button removes all data from the form and resets it for entry of new information. If you have changed or added any information, you'll be prompted to verify that you want to discard the changes; clicking Cancel will return you to the form and allow changes to be saved.

    The Submit button requests that any new, modified, or deleted data be recorded in the database. Until submitted, any changes or additions you've made have not been saved. If anything prevents the changes from being recorded, you will be alerted to the nature of the problem. Indicators on the form (icons, etc) indicating pending changes will only disappear when data has successfully been saved.

    Some forms also have a Print button to allow the form contents to be sent to a printer. Only forms built specifically to support printing will have this button. Examples include the Student Schedule and Online Transcript.

    If the form or your access don't allow data to be modified, the Submit button won't be displayed.

    Field Types

    Forms are built using fields of the following types:

    • Text - Used for descriptions or other varied content; text fields have a limit on the number of characters that can be entered; some text fields will convert contents to upper case
    • Number - Entry must be numeric; the precision (how many numbers are allowed to the right of the decimal) is form-specific; positive and negative numbers may be allowed
    • Date - Entry must identify a valid calendar date; when entering dates, a variety of formats may be entered (e.g. 2 May, 5/2/08, May 2 08) but they will be converted to MM/DD/YYYY format; if the year is omitted, the current year will be used
    • Time - Entry must be a valid time; value entered is converted to HH:MM with am/pm
    • Indicator - A checkbox used to indicate a yes/no or on/off state; the delete control is similar
    • Validated - Text fields that must contain defined codes; most use a list of values available on a validation form; some may use a form-specific list (e.g. Gender is not defined on a validation form)
    • Display - Read-only fields used to display information, often the description for a validated field

      

    Powered by MindTouch Core