Migration Guide
(→Preferred URL) |
|||
| (30 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
| − | + | ''If you are a user of the [[Asia Version]], please see the [[Asia Migration Guide]]'' | |
| − | + | In August 2010, LexisNexis completed and released a new interface for LexisNexis Academic. This article provides a guide to help subscribing institutions make the transition to the new interface. | |
| − | + | ||
| − | + | ==Migration Status== | |
| + | '''UPDATE: Migration Completed August 7, 2010''' | ||
| − | + | The migration to the new interface has been completed. The old interface has been retired. | |
| − | + | ||
| − | The | + | |
| − | === | + | ===Old LexisNexis Academic URLs Redirected=== |
| − | The | + | The URL http://www.lexisnexis.com/us/lnacademic used to point to the old interface. LexisNexis has implemented an automatic redirect of this URL to the new interface. |
| + | |||
| + | The redirect applies to all URLs, including deep links to specific search forms, title-level links, and durable URLs for specific documents. These deep links will be redirected to the corresponding location in the new interface. | ||
===Preferred URL=== | ===Preferred URL=== | ||
| − | + | ''If you are a user of the [[Asia Version]], please see the [[Asia Migration Guide]]'' | |
| − | + | The preferred URL is the direct URL for the new interface: http://www.lexisnexis.com/hottopics/lnacademic | |
| + | |||
| + | ==Troubleshooting Remote Authentication== | ||
| + | Many subscribers have reported problems with remote authentication following the completion of the migration to the new interface. See the sections below on Proxy Server and RPA (remote patron authentication) scripts to troubleshoot the type of remote access used at your institution. | ||
| − | |||
| − | |||
| − | |||
'''Note: The home page of the interface is on the open web. To test authentication you must run a search in the new interface.''' | '''Note: The home page of the interface is on the open web. To test authentication you must run a search in the new interface.''' | ||
===Proxy Server Authentication=== | ===Proxy Server Authentication=== | ||
| − | + | ====EZProxy==== | |
| − | + | It is very important that EZProxy users update the configuration stanza for LexisNexis Academic to match exactly the official OCLC [http://www.oclc.org/support/documentation/ezproxy/db/lexisnexis.htm EZProxy Configuration Instructions for LexisNexis]. | |
| − | + | A common problem seems to be the omission of the following 2 lines from the configuration: | |
| − | + | *Find location.hostname | |
| − | * | + | *Replace location.host |
| − | * | + | |
| − | + | Note: LexisNexis Academic requires EZproxy 5.0 or later. | |
| − | + | ||
| − | + | ||
| − | === | + | ====Innovative Interfaces WAM Proxy==== |
| − | + | WAM proxy users can adapt the EZProxy instructions to their configuration, and should contact Innovative for further assistance. | |
| − | === | + | ===RPA Script for Remote Patron Authentication=== |
| − | + | Subscribers who rely on LexisNexis RPA scripts to provide remote patron authentication must modify their script as follows. | |
| + | |||
| + | *Change the setting for productURL to "<nowiki>http://www.lexisnexis.com/hottopics/lnacademic</nowiki>" | ||
| + | *Change setting for iapath to "/lnacui2api/iactivation/seamless.do" | ||
| + | *Change setting for setCookiePath to "lnacui2api/setcookie.do" | ||
| + | |||
| + | Note: If you are using an RPA script to provide access other LexisNexis products such as Library Express and Scholastic, you should make the two changes to the Path values, but should not make any change to the productURL. | ||
==Accessing the New Interface== | ==Accessing the New Interface== | ||
| + | ''If you are a user of the [[Asia Version]], please see the [[Asia Migration Guide]]'' | ||
| + | |||
The URL for the new interface is http://www.lexisnexis.com/hottopics/lnacademic/ | The URL for the new interface is http://www.lexisnexis.com/hottopics/lnacademic/ | ||
Please note that the landing page for the new interface is on the open web. You should run a search to test your access. | Please note that the landing page for the new interface is on the open web. You should run a search to test your access. | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
===Documentation=== | ===Documentation=== | ||
| Line 63: | Line 61: | ||
===Cookbook for Converting URLs for Deep Links=== | ===Cookbook for Converting URLs for Deep Links=== | ||
| + | ''If you are a user of the [[Asia-Pacific Version]], please see the [[Asia-Pacific Migration Guide]]'' | ||
| + | |||
| + | |||
It is not necessary to convert URLs for deep links. The automatic redirect that will be implemented at the end of the migration period will cause deep links to the old interface to point to the corresponding location or search result in the new interface. | It is not necessary to convert URLs for deep links. The automatic redirect that will be implemented at the end of the migration period will cause deep links to the old interface to point to the corresponding location or search result in the new interface. | ||
Please note that the Find/Replace options described below look very similar but they are different for each type of link. | Please note that the Find/Replace options described below look very similar but they are different for each type of link. | ||
| − | |||
| − | |||
====Search Form Links==== | ====Search Form Links==== | ||
| Line 94: | Line 93: | ||
*Find: /us/lnacademic/api/version1/sr?shr=t&csi= | *Find: /us/lnacademic/api/version1/sr?shr=t&csi= | ||
*Replace with: /hottopics/lnacademic/?verb=sr&csi= | *Replace with: /hottopics/lnacademic/?verb=sr&csi= | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
==Third-Party Library Systems== | ==Third-Party Library Systems== | ||
| − | To ensure a smooth transition to the new interface, LexisNexis is working closely with third-party vendors including EBSCO, Ex Libris, Innovative Interfaces, Serials Solutions, TDNet. If you have concerns about updating links to the new interface from a particular third-party system, please contact [mailto: | + | To ensure a smooth transition to the new interface, LexisNexis is working closely with third-party vendors including EBSCO, Ex Libris, Innovative Interfaces, Serials Solutions, TDNet. If you have concerns about updating links to the new interface from a particular third-party system, please contact [mailto:jennifer.matheny@lexisnexis.com Jennifer Matheny] |
Links in third-party systems such as federated search and article-linker systems will continue to point to the old interface until the end of the migration period. Given the typical research work-flow on such systems, the continued use of the old interface is not expected to cause significant confusion for users at institutions that have switched to the new interface. | Links in third-party systems such as federated search and article-linker systems will continue to point to the old interface until the end of the migration period. Given the typical research work-flow on such systems, the continued use of the old interface is not expected to cause significant confusion for users at institutions that have switched to the new interface. | ||
| − | + | ||
[[Category: Academic Help]] | [[Category: Academic Help]] | ||
Latest revision as of 11:31, 19 May 2011
If you are a user of the Asia Version, please see the Asia Migration Guide
In August 2010, LexisNexis completed and released a new interface for LexisNexis Academic. This article provides a guide to help subscribing institutions make the transition to the new interface.
Contents |
[edit] Migration Status
UPDATE: Migration Completed August 7, 2010
The migration to the new interface has been completed. The old interface has been retired.
[edit] Old LexisNexis Academic URLs Redirected
The URL http://www.lexisnexis.com/us/lnacademic used to point to the old interface. LexisNexis has implemented an automatic redirect of this URL to the new interface.
The redirect applies to all URLs, including deep links to specific search forms, title-level links, and durable URLs for specific documents. These deep links will be redirected to the corresponding location in the new interface.
[edit] Preferred URL
If you are a user of the Asia Version, please see the Asia Migration Guide
The preferred URL is the direct URL for the new interface: http://www.lexisnexis.com/hottopics/lnacademic
[edit] Troubleshooting Remote Authentication
Many subscribers have reported problems with remote authentication following the completion of the migration to the new interface. See the sections below on Proxy Server and RPA (remote patron authentication) scripts to troubleshoot the type of remote access used at your institution.
Note: The home page of the interface is on the open web. To test authentication you must run a search in the new interface.
[edit] Proxy Server Authentication
[edit] EZProxy
It is very important that EZProxy users update the configuration stanza for LexisNexis Academic to match exactly the official OCLC EZProxy Configuration Instructions for LexisNexis.
A common problem seems to be the omission of the following 2 lines from the configuration:
- Find location.hostname
- Replace location.host
Note: LexisNexis Academic requires EZproxy 5.0 or later.
[edit] Innovative Interfaces WAM Proxy
WAM proxy users can adapt the EZProxy instructions to their configuration, and should contact Innovative for further assistance.
[edit] RPA Script for Remote Patron Authentication
Subscribers who rely on LexisNexis RPA scripts to provide remote patron authentication must modify their script as follows.
- Change the setting for productURL to "http://www.lexisnexis.com/hottopics/lnacademic"
- Change setting for iapath to "/lnacui2api/iactivation/seamless.do"
- Change setting for setCookiePath to "lnacui2api/setcookie.do"
Note: If you are using an RPA script to provide access other LexisNexis products such as Library Express and Scholastic, you should make the two changes to the Path values, but should not make any change to the productURL.
[edit] Accessing the New Interface
If you are a user of the Asia Version, please see the Asia Migration Guide
The URL for the new interface is http://www.lexisnexis.com/hottopics/lnacademic/
Please note that the landing page for the new interface is on the open web. You should run a search to test your access.
[edit] Documentation
The Subscriber Tools site provides documentation for using the LexisNexis Academic URL to build links including durable URLs, title-level links, saved searches, and links to search forms. Please consult that site for documentation on
- LexisNexis Academic URL API Specification - http://www.amdev.net/lna_url_api.php
- A-Z Title List with title-level links - http://www.amdev.net/rpt_std_content.php
- A-Z Migration Spreadsheet showing old and new version of links for each source - http://www.amdev.net/rpt_std_content.php
- OpenURL Title List with linking syntax for document-level links - http://www.amdev.net/rpt_open_url.php
[edit] Cookbook for Converting URLs for Deep Links
If you are a user of the Asia-Pacific Version, please see the Asia-Pacific Migration Guide
It is not necessary to convert URLs for deep links. The automatic redirect that will be implemented at the end of the migration period will cause deep links to the old interface to point to the corresponding location or search result in the new interface.
Please note that the Find/Replace options described below look very similar but they are different for each type of link.
[edit] Search Form Links
To replace links to specific search forms, such as the US Federal & State Cases form, see the new links provided in the article on Academic URLs for Search Forms.
[edit] Source-Level Links
If possible, you should simply use the A-Z Migration Spreadsheet at http://www.amdev.net/rpt_std_content.php to replace the old version of the URL with the new version. If a batch update based on the spreadsheet is not a good option for you, follow the directions below to perform Find/Replace operations. For details see the URL API Specification at http://www.amdev.net/lna_url_api.php
Example of old URL - http://www.lexisnexis.com/us/lnacademic/api/version1/sf?shr=t&sfi=AC00NBGenSrch&csi=6742
Example of new URL - http://www.lexisnexis.com/hottopics/lnacademic/?verb=sf&csi=6742
Find/Replace to convert old URL to new URL:
- Find: /us/lnacademic/api/version1/sf?shr=t&sfi=AC00NBGenSrch&csi=
- Replace with: /hottopics/lnacademic/?verb=sf&csi=
[edit] Document-Level Links
You can update durable links to specific documents using the steps listed below. For details see the URL API Specification at http://www.amdev.net/lna_url_api.php
Example of old URL - http://www.lexisnexis.com/us/lnacademic/api/version1/sr?shr=t&csi=6742&sr=BYLINE(Pogue)+AND+HLEAD(Books+Pop+Up)+AND+DATE+IS+November+22+2007
Example of new URL - http://www.lexisnexis.com/hottopics/lnacademic/?verb=sr&csi=6742&sr=BYLINE(Pogue)+AND+HLEAD(Books+Pop+Up)+AND+DATE+IS+November+22+2007
Steps to convert old URL to new URL:
- Find: /us/lnacademic/api/version1/sr?shr=t&csi=
- Replace with: /hottopics/lnacademic/?verb=sr&csi=
[edit] Canned Queries
You can update URLs that run a canned query (saved search) using the steps listed below. For details see the URL API Specification at http://www.amdev.net/lna_url_api.php
Example of old URL - http://www.lexisnexis.com/us/lnacademic/api/version1/sr?shr=t&csi=8422&sr=HLEAD(congress+AND+vote)+AND+DATE>=%25CURRDATE-7%25
Example of new URL - http://www.lexisnexis.com/hottopics/lnacademic/?verb=sr&csi=8422&sr=HLEAD(congress+AND+vote)+AND+DATE>=%25CURRDATE-7%25
Steps to convert old URL to new URL:
- Find: /us/lnacademic/api/version1/sr?shr=t&csi=
- Replace with: /hottopics/lnacademic/?verb=sr&csi=
[edit] Third-Party Library Systems
To ensure a smooth transition to the new interface, LexisNexis is working closely with third-party vendors including EBSCO, Ex Libris, Innovative Interfaces, Serials Solutions, TDNet. If you have concerns about updating links to the new interface from a particular third-party system, please contact Jennifer Matheny
Links in third-party systems such as federated search and article-linker systems will continue to point to the old interface until the end of the migration period. Given the typical research work-flow on such systems, the continued use of the old interface is not expected to cause significant confusion for users at institutions that have switched to the new interface.