FORMSTATE Tag

When a user submits a request from a web form outside of ILLiad (such as through OpenURL or another system), ILLiad will first display a login screen. Once the user has logged in to their account, ILLiad will automatically place the request. In order to carry OpenURL or EAD information through the login or registration process to a request form, the FORMSTATE tag must be present on all web pages that are displayed before logging on to the system.

FORMSTATE Tag Placement

The FORMSTATE tag must be placed on the following HTML pages:

• FirstTime.html
• NewUserRegistration.html
• NewAuthRegistration.html
• ChangeUserInformation.html
• ChangePassword.html
• EditAccountInformation.html
• Logon2.html - needs to be added to the actual form (after the <form action= command) AND within the First Time Users link

The First Time Users Link 

The First Time Users link is used when new users place external requests as described above. First-time users are directed via the First Time Users link on the Logon page to the FirstTime.html page. There, they can click on the "First Time Users Click Here" link and they will be taken to the NewUserRegistration.html page. To add a first-time users link, please include the information listed under the Logon2.html and Logon.html sections of this article.

Logon2.html

The First Time Users link is displayed via the DLL using the FORMSTATE Tag. The new form link is configured as a separate form, called RegisterForm, located within the Logon2.html file as a form action command. The format for the link is:

<form action="illiad.dll?Action=10&Form=79" method="post" name="RegisterForm" 
id="RegisterForm">
<#FORMSTATE>
<a href="#" onclick="RegisterForm.submit(); return false;">First Time Users</a>
</form>

Logon.html

The Logon.html page does not need a FORMSTATE tag because it does not carry OpenURL or EAD information through the login or registration process to the request form. Instead, the Logon.html page uses an action/form combination command. The DLL is used to process the FirstTime.html page, handling the FORMSTATE tag on that page.

Replace the old link on the Logon.html page:

<a href="FirstTime.html">First Time Users</a>

with this new link as shown below:

<a href="illiad.dll?Action=10&Form=79">First Time Users</a>

ChangePassword.html

The ChangePassword.html form displays immediately after a user logs in if a password change is required. To avoid losing the session state & information if entering ILLiad via OpenURL, enter the <#FORMSTATE> tag on the ChangePassword.html.

<form action="illiad.dll" method="post" name="ChangePassword" class="f-wrap-request">
	<input type="hidden" name="ILLiadForm" value="ChangePassword">
	<input type="hidden" name="Username" value="<#PARAM name='Username'>">
	<input type="hidden" name="SessionID" value="<#PARAM name='SessionID'>">
	<#FORMSTATE>
		<div class="req"><b>*</b> Indicates required field</div>