# COPYRIGHT (c) 2000, GALE GROUP.
# ALL RIGHTS RESERVED
# The use of this software is governed by a license agreement.

Customized Enrollment Forms

The Enrollment URL mechanism of the account administration system allows web proficient administrators at customer sites to create customized enrollment forms for their users.

The more advanced webmaster might even add a bit of javascript to the customized enrollment web page in order provide more error checking before a form is submitted or to compute default values. Some of these techniques are also suggested in the use of customized advanced logon as documented in http://cpartner.iacnet.com/insite/insitelrti.html#MENU_STYLE.

What follows is a form which presents an enrollment page with a URL pointing to the Account Administration Demo area. This form has the same user-visible components as a standard new enrollment url: http://cpartner.iacnet.com/wbsdemo/newenroll.cgi?couponid=21&mtime=1941110243&chk=52570280, but with some defaults provided, and without the fancy graphical elements. Also the normally hidden coupon id, modification time, and checksum fields are made visible. These normally hidden elements are clearly visible in the enrollment url you obtain by using the create or modify enrollment url commands in the account administration system.

couponid: (normally hidden)
mtime: (normally hidden)
checksum: (normally hidden)
First Name:
Last Name:
Employee ID:
Cost Center Code/Name:
Title: Category:
Department: Category:
Street Address:
City:
State:
ZIP Code:
Country:
Telephone Number:
Fax Number:
Email Address:
Username:
Password:
Reconfirm Password:

A customer administrator who wants his users to only enter their email address and to pick a username and password might keep all other forms fields hidden, and present the user with something like this (but perhaps the values of some of these hidden fields will have been filled in already by way of an active-server-page or other scripting mechanism on the customers intranet web site, which has access to information which simply would not be available any where else):

The html code for the above form looks like this:

<form action="http://cpartner.iacnet.com/wbsdemo/newenroll.cgi" 
      method="GET">
<input type="hidden" name=couponid value="21">
<input type="hidden" name=mtime value="1941110243">
<input type="hidden" name=chk value="52570280">
<input type="hidden" name="first_name" value="NIL">
<input type="hidden" name="last_name" value="NIL">
<input type="hidden" name="employee_id" value="">
<input type="hidden" name="cost_center" value="">
<input type="hidden" name="employee_title" value="">
<input type="hidden" name="title_category" value="">
<input type="hidden" name="employee_department" value="">
<input type="hidden" name="department_category" value="">
<input type="hidden" name="street_address" value="">
<input type="hidden" name="city" value="">
<input type="hidden" name="state" value="">
<input type="hidden" name="zip" value="">
<input type="hidden" name="country" value="">
<input type="hidden" name="phone_number" value="">
<input type="hidden" name="fax_number" value="">
Email address:<input type="text" name="email_address"><BR>
IAC-Insite Username: <input type="text" size="20" maxlength="30"
     name="username" value="IAC_"><BR>
IAC-Insite  Password: <input type="password" size="20" maxlength="16"
     name="password"><BR>
Reconfirm Password: <input type="password" size="20" maxlength="16"
     name="password1"><BR>
<input type="submit" name="submit" value="Submit"> 
<input type="reset" name="reset" value="Reset">
</form>

The following table lists all the fields expected in a new enrollment form:

input
or
attribute
name Non-empty
value
Required? Description

ACTION yes Must be a URL that points to the newenroll.cgi page in the proper directory on the web site on which the Account Administration Application is running.

METHOD yes must be GET

couponid yes obtained from the result of the Create Enrollment URL or Modify Enrollment URL screen of the account administration interface.

mtime yes see above, a security related timestamp

chk yes see above, a digital signature to help ensure the validity and authoritative source of the enrollment URL

first_name yes a string, 1 to 30 characters

last_name yes a string, 1 to 30 characters

employee_id no a string

cost_center no a string

employee_title no a string

title_category no a string which must be from a fixed list of options, see the source code to this document for details.

employee_department no a string

department_category no a string which must be from a fixed list of options, see the source code to this document for details.

street_address no a string

city no a string

state no a string, 2 alphabetic characters.

zip no a string

country no a string

phone_number no a string, must be numeric or from the set " ()-Xx"

fax_number no a string, must be numeric or from the set " ()-Xx"

email_address no a string, must have an @ in it.

username yes a string, 1 to 30 characters, only a-z, A-Z, 0-9, "$", "_", "." are allowed and the first character must be a letter or a number.

password yes a string, must be 6 to 16 characters, with the same character set restrictions as the username.

password1 yes a string, must be identical to the password input

submit yes a string

input or attribute name	Non-empty value Required?	Description
ACTION	yes	Must be a URL that points to the newenroll.cgi page in the proper directory on the web site on which the Account Administration Application is running.
METHOD	yes	must be GET
couponid	yes	obtained from the result of the Create Enrollment URL or Modify Enrollment URL screen of the account administration interface.
mtime	yes	see above, a security related timestamp
chk	yes	see above, a digital signature to help ensure the validity and authoritative source of the enrollment URL
first_name	yes	a string, 1 to 30 characters
last_name	yes	a string, 1 to 30 characters
employee_id	no	a string
cost_center	no	a string
employee_title	no	a string
title_category	no	a string which must be from a fixed list of options, see the source code to this document for details.
employee_department	no	a string
department_category	no	a string which must be from a fixed list of options, see the source code to this document for details.
street_address	no	a string
city	no	a string
state	no	a string, 2 alphabetic characters.
zip	no	a string
country	no	a string
phone_number	no	a string, must be numeric or from the set " ()-Xx"
fax_number	no	a string, must be numeric or from the set " ()-Xx"
email_address	no	a string, must have an @ in it.
username	yes	a string, 1 to 30 characters, only a-z, A-Z, 0-9, "$", "_", "." are allowed and the first character must be a letter or a number.
password	yes	a string, must be 6 to 16 characters, with the same character set restrictions as the username.
password1	yes	a string, must be identical to the password input
submit	yes	a string