Setting up a FormConfig Configuration file.

A FormConfig file controls the appearance of the Online Registration form. It is a configuration file "with sections". Each section represents one field on the form.

There are several fields that are required for the Online Registration process to function. Those fields are defined below. The rest of the fields are at the program's discretion.

• Field Format
• Field Types
• Required Fields

Each field consists os a section name and multiple characteristics.

Section Name

The section name is really the internal field name. This is what is used withinteh library and what will appear as a column label in the data file.

 

Characteristic: Required

The "Required" characteristic tells teh registration proess whether the field is required or not. If a field is required the user must supply data before the process can continue.

 

Characteristic: Type

The "Type" characteristic defines what type of data may be entered into the field. See Field Types for more information.

 

Characteristic: Label

The "Label" characteristic defines the label that will appear next to the data entry field. The label should be enclosed within double quotes.

 

Characteristic: Default

The "Default" characteristic is an optional characteristic that allows you to define a default value.

[First_Name]
Required = Yes
Type = "text(20,40)"
Label = "Participant First Name"

Back to top.

There are several types of data that can be requested from the user. By specifying a specific type you can sometimes prevent incorrect information from being entered.

text(size, maximum)

The "text" type allows the user to enter any alphanumeric characters. "size" is the size of the box to be opened. "maximum" is the maximum number of characters that will be accepted. Both "size" and "maximum" are optional. However, "size" must be configured if you wnat to configure "maximum".

 

phone

The "phone" type will required the user to enter a 10 digit phone number. They can only enter numbers, dashes or periods. They must supply the full 10 digits or the input will be rejected.

 

email

The "email" type makes sure that the information entered is formatted like an e-mail address.

 

number(minimum, maximum)

The "number" type required the user to enter a number that is between the minimum and maximum values.

 

list(value/value/...)

The "list" type allows you to configure a list of values that the user can select from. This works fine for relatively small lists.

 

biglist(filename)

The "biglist" type is for lists with a lareg number of values or lists that are shared across multiple programs. The most common use would be for a list of schools in an area.

[City]
Required = Yes
Type = "text(20,40)"
Label = "City"

[State]
Required = Yes
Type = "text(2,2)"
Label = "State"
Default = "MN"

[Home_Phone]
Required = Yes
Type = "phone"
Label = "Home Phone"

[Email]
Required = Yes
Type = "email"
Label = "Home Email"

[Gender]
Required = Yes
Type = "list(Female/Male)"
Label = "Gender"

[Shirt_Size]
Required = Yes
Type = "list(Child Med/Child Large/Adult Small/Adult Medium/Adult Large/Adult X-
Large/XX-Large)"
Label = "Jersey Size"

Back to top.

The Online Registration process requires that a set of required fields exist. You may change the name of teh fields as long as you tell the process the new names. You tell the process by configuring them in the RegistrationConfig file.

Back to top.

Back to OnlineRegistration