Submitting Requests Via OpenURL and External Systems

Follow

External Systems

Aeon requires users placing requests via OpenURL or other external systems to log into their account (or register for an account, if a first-time user) before creating the request in Aeon. When a user submits a request from a webform outside the Aeon system, Aeon attempts to create the request, but first displays the logon screen so the user can log into the Aeon system. Once the user has logged into their account (or registered for an account), Aeon automatically places the request and the web page opens to show the newly submitted request. In order to carry the OpenURL or EAD information through the logon or registration process to the request form, a <#FORMSTATE> tag must be present on all pages that are displayed before logging onto the system.

The <#FORMSTATE> tag is included by default on new installations of Aeon 3.1 and higher; existing sites will need to copy or manually add this tag from the new pages (located under Aeon/Update) to their existing pages. The <#FORMSTATE> tag must be placed on the following HTML pages:

  • Logon2.html: the tag should be added in two places on the Logon2.html form:
    • within the actual form
    • within the new RegisterForm link, which is the First Time Users link
  • FirstTime.html
  • NewAuthRegistration.html
  • NewUserRegistration.html

The image to the right shows the <#FORMSTATE> tags added to the Logon2.html page in 2 places as described above.

The tag should not be added to the Logon.html page. It should only be added to the pages listed above, which are displayed via the DLL.

The First Time Users (RegisterForm) Link

First-time users are directed via the First Time Users link on the Logon page (Logon2.html) to the First Time User Registration for Aeon information page (FirstTime.html). There, they click the "First Time Users Click Here" link and are taken to the New User Registration for Aeon page (NewUserRegistration.html). This First Time Users link on the Logon2.html page is used when new researchers place external requests as described above. It is configured as a separate form, called RegisterForm, located within the Logon2.html file as a form action command. The new form link is included by default on new installations of Aeon 3.1 and higher; existing sites will need to copy or manually add the new link from the new pages (located under Aeon/Update) to their existing pages. This submits the form via a post using Javascript; it no longer uses a GET request with a URL link.

In addition, the First Time Users link is now displayed via the DLL using the form tag <#FORMSTATE>. The format for the link is:

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

Questions?

If this article didn’t resolve your issue, please take a moment and answer a few questions to help improve our documentation:

Feedback