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:
- Logon2.html - needs to be added to the actual form (after the <form action= command) AND within the First Time Users link
The FORMSTATE tag should only be added to the pages listed above, which are displayed via the DLL. It does not need to be added to the Logon.html page.
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.
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>
This link replaces the FirstTime.html link and is included by default on new installations of ILLiad 8.3 and up. Existing sites will need to edit their existing web page or replace the page with the new default web page.
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>
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>
The FORMSTATE tag should only be added to ILLiad version 9.0 since the new user password change prompts only apply after the update.