Posts Tagged ‘e-journals’

Java, John and JournalTOCs

Posted on April 17th, 2012 by Paul Stainthorp

I heard recently that the ticTOCs journal tables-of-contents service will close down in the next month or so. ticTOCs was a JISC-funded project which hasn’t been developed for several years now.

Screenshot of ticTOCs

It’s effectively been superseded by the JournalTOCs service, “the largest, free collection of scholarly Tables of Contents (TOCs)”. The outgoing service has published some advice for users on transferring saved lists of TOCs between ticTOCs and JournalTOCs.

ticTOCs did have one particularly useful feature: a text file of all the TOCs it contained (at http://www.tictocs.ac.uk/text.php), which I’ve been filtering and using since 2009 to create a custom package of RSS feeds for upload to the e-journals A-to-Z at Lincoln.

While JournalTOCs doesn’t provide the same simple text list feature, it does have a fully-documented API. This is much more powerful and flexible for developers, but it’s not quite so straightforward as /text.php to create my list (a subset of all the feeds in JournalTOCs, matching only those journals to which the University has full-text access) using desktop tools and no programming.

A chance comment from a colleague at another university about Lincoln having “developers coming out of its ears“(!) inspired me to ask on the LNCD development group for help.

Dr John Murray of the Lincoln School of Computer Science responded, and very kindly supplied a Java program which I can use to identify which journals in our A-to-Z are represented in JournalTOCs, and so build a list of links to valid RSS feeds. Starting with a comma-separated list of ISSNs (which I downloaded from the A-to-Z), the program takes each ISSN in turn and makes a call to the JournalTOCs journals API. Depending on the data returned by JournalTOCs, the program records each ISSN as ‘VALID’ or ‘INVALID’ (i.e. no RSS feed available) in a new .csv file.

Thank you very much, John!

[Aside: to use John's code I had to learn how to compile and run Java programs on my laptop (running Ubuntu 11.10). For the record—and because I imagine it'll be useful again in the future—I first had to install OpenJDK 6 by going to the terminal and running the command:

sudo apt-get install openjdk-6-jdk

…then, once OpenJDK had installed, using the following command to select the correct version of Java:

sudo update-alternatives --config java

…before compiling and running the program itself.]

Once all the ISSNs had been checked against the API and the validated list constructed (this took ~5hrs to run!), I used Microsoft Excel to filter out only the ‘VALID’ ISSNs matched in JournalTOCs, and used Excel’s =LOOKUP() function to pull in enough information about each journal from our managed title list (previously downloaded), to create a custom upload text file.

Screenshot of the A-to-Z

The updated package of journal article RSS feeds is now available to view on the A-to-Z. We’ll review and re-generate this every few months, as we do with all custom and publisher-generated e-journal packages. At the time of writing, it contains just over 10,000 journal article RSS feeds, each one corresponding to one of our full-text journals. I’ve also added an orange RSS icon and link to JournalTOCs for each one, using the A-to-Z’s public notes feature.

So: which other library APIs will accept an ISSN as an input, and what other custom packages could I create using John Murray’s code in the same way?

E-resource URL hacking for fun and profit: how to build direct, reliable login links to journals

Posted on March 9th, 2012 by Paul Stainthorp

I’ve got a bee in my bonnet about electronic resources which make it difficult or impossible to create reliable deep-ish links to a particular bit of the resource from Library websites (usually our library catalogue or EBSCO’s e-journals A-to-Z/link resolver) – links which handle the authentication properly and take the user to the place they wanted to go in the first place, and which do so consistently.

Below is an example of the kind of process we go through to construct direct, reliable login links to the home pages of journals, when authentication is via Athens and/or the UK Access Management Federation (UKAMF). The process uses a facility the A-to-Z has to rewrite URLs according to a set of predictable rules, generating a new login link which is a function of the original URL.

N.B. it’s only possible to do this at all if the Athens/UKAMF authentication point for the journal has a predictable structure. If a login URL includes any randomly-generated or unknown elements which vary from journal to journal, then it can’t be generated by predictable rules. If the login URL can’t be expressed as a predictable function of the basic URL for the journal, then we won’t able to create a direct, reliable login link for the resource. Some providers rule themselves out at the first hurdle because of this, and it’s intensely irritating for me and even more so for users.

This whole process should get easier (and the end result less frustrating for users) when we introduce EZproxy as an additional authentication tool, but even so I would say that the ability to analyse, deconstruct, rewrite and generally hack URLs is one of the most important skills needed by anyone who works with e-resources.

Here’s how to build a direct, reliable login link via Athens/UKAMF. Bear in mind that the example given is one of the easy ones!

  1. The A-to-Z knowledgebase stores the basic resource URL; usually a link to the journal home page. In the kind of pseudo-markup tags used by the A-to-Z to rewrite URLs, this is identified as {URL}.
    • For example, the {URL} of the e- journal Food Science and Technology International is:
      • http://fst.sagepub.com/
  2. First we visit the journal home page at {URL} and hunt around until we track down a reliable Athens or WAYFless UK Federation login URL. Often we look at other libraries’ web pages and/or UKAMF guidelines for inspiration.
  3. Determine whether the login URL is indeed a predictable function of {URL}. If it isn’t; you might as well stop at this point!
    • E.g. (this one goes via Athens, and is predictable):
      • http://auth.athensams.net/?ath_dspid=SAGE&ath_returl=http%3A%2F%2Fonline.sagepub.com%2Flogin%3Furi%3Dhttp%253A%252F%252Ffst.sagepub.com%252F
  4. Often {URL} will need to be %-encoded one or more times (roughly; one level of encoding for each level of URL ‘nesting’: each time a parameter within the URL is itself another URL). Encoding can be expressed in the A-to-Z using the paired tags {startencode} and {endencode}. Now rewrite the login URL using A-to-Z markup tags:
    • E.g. (note the double encoding!):
      • http://auth.athensams.net/?ath_dspid=SAGE&ath_returl=http%3A%2F%2Fonline.sagepub.com%2Flogin%3Furi%3D{startencode}{startencode}{URL}{endencode}{endencode}
    • Or (equally valid):
      • http://auth.athensams.net/?ath_dspid=SAGE&ath_returl={startencode}http://online.sagepub.com/login?uri={startencode}{URL}{endencode}{endencode}
  5. Then, encode the whole login URL one more time, and prefix the whole thing with the standard Athens cookie-setting URL. This ensures that users are sent to the University of Lincoln ‘alternative login’ point, rather than the old-fashioned Athens username and password form.
    • Either:
      • http://auth.athensams.net/setorg.php?id=LINCUNI&ath_returl={startencode}http://auth.athensams.net/?ath_dspid=SAGE&ath_returl={startencode}http://online.sagepub.com/login?uri={startencode}{URL}{endencode}{endencode}{endencode}
    • Or:
      • http://auth.athensams.net/setorg.php?id=LINCUNI&ath_returl=http%3A%2F%2Fauth.athensams.net%2F%3Fath_dspid%3DSAGE%26ath_returl%3Dhttp%253A%252F%252Fonline.sagepub.com%252Flogin%253Furi%253D{startencode}{startencode}{startencode}{URL}{endencode}{endencode}{endencode}

It may look awful, but it works! (Usually.) It would be very useful if there were a place for A-to-Z customers to share (via a wiki, maybe) URL rewriting tips and examples. Some other useful links:

EJS / E-journals from EBSCO being phased out

Posted on March 2nd, 2012 by Paul Stainthorp

Just a note that the 11 journal titles which used to form the E-journals from EBSCO (a.k.a. the EBSCOhost Electronic Journals Service or EJS) are no longer listed as a discrete package on the e-journals A-to-Z. The EJS platform is (apparently) no longer being actively developed by EBSCO. The following journals should all still be accessible via the A-to-Z, as part of other publisher and/or database packages:

  1. Digital arts
  2. English Today
  3. HerbalGram
  4. Journal of sociolinguistics
  5. Language in Society
  6. Museum History Journal
  7. New Theatre Quarterly
  8. Performance Research
  9. Theatre Research International
  10. Theatre Survey
  11. World Englishes

The EJS platform has also been removed from the University Portal.

SpringerLINK journals

Posted on December 21st, 2011 by Paul Stainthorp

This blog post is prompted by a couple of recent enquiries about the University of Lincoln’s access to e-journals on the SpringerLINK platform (www.springerlink.com). Basically, we don’t currently have platform-wide access to all articles on SpringerLINK, nor can Lincoln students/staff log in using Athens.

However, we do subscribe to a small number of individual titles from Springer, those being:

  1. Animal Cognition (issn:1435-9448)
  2. Crime, Law and Social Change (issn:0925-4994)
  3. Current Psychology: Research and Reviews (issn:1046-1310)
  4. Distributed Computing (issn:0178-2770)
  5. Environmentalist (issn:0251-1088)
  6. International journal of legal medicine (issn:0937-9827)
  7. Journal of Abnormal Child Psychology (issn:0091-0627)
  8. Memory & cognition (issn:0090-502X)
  9. Systemic Practice and Action Research (issn:1094-429X)
  10. Theory and Society (issn:0304-2421)
  11. Voluntas: International Journal of Voluntary and Nonprofit Organizations (issn:0957-8765)

These 11 subscription journals are now listed on the Library’s electronic journals A-to-Z site. Access is not via Athens, but you can log in—whether on or off campus—using your normal University of Lincoln network\accountID and password.

The SpringerLINK platform also provides access to freely-accessible content from about 40 Open-Access journals, under the SpringerOpen initiative. SpringerOpen journals are now also listed on the e-journals A-to-Z. If you need an article from any other Springer journals (not listed above and/or Open Access), you can order a copy using the Library’s inter-library loans service.

E-journal authentication behind the mask

Posted on November 16th, 2011 by Paul Stainthorp

This blog post is an attempt to elaborate on a problem with managing on/off campus access to electronic journals at the University of Lincoln. It’s a problem which confuses a lot of our users. I hinted at the issue in an earlier blog post.

Underlying the problem is a lack of consistency in the way e-journal platform providers/publishers implement Athens/”Shibboleth” access to their content.

I think the answer to this problem is “…use EZProxy as well or instead“. (We plan to do so.) However if anyone from a ‘strong’ federated-access position can suggest a way around the problem based purely on honest, SAML-based principles, then I’m all ears!

~~~wavy lines~~~

The system we use to manage access to e-journals at the University of Lincoln is EBSCO’s electronic journals A-to-Z. Within its underlying journals knowledgebase, the A-to-Z stores a URL for each journal – here I’ll refer to that URL as A.

The A-to-Z also provides the facility—a very nice facility, as it happens—to rewrite that URL according to a set of predictable rules, generating a new URL which is a function of the original URL: in my pseudomathematical shorthand I’ll call this f(A).

EBSCO call this facility of theirs a “Proxy Server”. Now – I could be being thick, but I don’t think this is a proxy server: it’s a URL rewriting application which merely happens to be used by some libraries to redirect traffic via a URL-rewriting proxy (such as the aforementioned EZProxy); in fact it can be used to ‘mask’ any URL.

We use the so-called “Proxy Server” facility to mask the default URL, A, and instead direct the browser back to the OpenAthens authentication point for the journal provider/publisher (allowing authentication both via the UK Federation and trad. Athens), with a redirect back to the post-authentication page for the journal. We’ll call that page A′ (i.e. “A prime”). A′ permits access to the full text of the journal.

Flowchart of URL masking and authentication workflow

N.B. it’s only possible to do this at all if the Athens/UKAMF authentication point for the journal has a predictable structure. If A′ includes any randomly-generated or unknown elements that aren’t in A and which vary from journal to journal, then A′ can’t be generated by f(A) – so some providers rule themselves out at the first hurdle. Bonjour, most legal databases! Yeah, you know who you are…

If it isn’t possible to create an A-to-Z “Proxy Server” URL mask, then our usual fallback position is to rely on IP authentication for on-campus traffic, but to instruct the user to manually select an Athens/’my institution’-type login for off campus access. This is not ideal: it confuses off-campus users who are used to seamless on-campus access, and it requires that we create help guides—I name and shame thee, Elsevier ScienceDirect—to lead people through often terribly confusing login procedures.

Flowchart of authentication workflow with on- and off-campus differences

There’s another complication: some journal providers, upon Athens-esque authentication from A, don’t send the user to A′. Instead, they redirect to a generic post-authentication page, D.

This = Bad. If you do this, I… just… can’t speak to you right now.

If we don’t (or can’t) apply a URL-rewriting mask in the A-to-Z for a journal package which exhibits this awful behaviour, then we’re relegating off-campus users to a third-class service; further widening the gap between on- and off-campus behaviour. If we do apply a mask, we relegate all users to the same lack of functionality. Which compromise do we choose? We’re damaging the user experience in both cases. [Click the diagram below to embiggen.]

Flowchart of complex authentication workflow for masked and non-masked journals

Finally, and for the sake of completeness, I think that this [below] would be the equivalent flowchart for EZProxy. (You can see why some libraries—and apparently their users—find it attractively simple. It also has the advantage that the ’masking’ is consistent across all or most journals, the configuration for each e-journal provider being done within EZProxy itself.)

Flowchart of the authentication workflow using EZProxy

Last word – here’s a useful page from Eduserv of Athens-authentication deep links for various e-resource providers. It may be helpful in creating masked URLs for Athens-authenticated journals.

New journals available off campus (via LibResProxy)

Posted on November 10th, 2011 by Paul Stainthorp

The following electronic journals are now available from off campus via the e-journals A-to-Z:

  1. Capital & Class (Sage Publications, issn:0309-8168)
  2. Ecology (Ecological Society of America, issn:0012-9658)
  3. New Left Review (New Left Review, issn:0028-6060)
  4. Science (American Association for the Advancement of Science, issn:0036-8075)

…plus the following 14 titles from Palgrave Macmillan Journals:

  1. Corporate Reputation Review (issn:1363-3589)
  2. Economic & Labour Market Review (issn:1751-8326)
  3. Family Spending (issn:0965-1403)
  4. Feminist Review (issn:0141-7789)
  5. Financial Statistics (issn:0015-203X)
  6. Journal of Information Technology (issn:0268-3962)
  7. Journal of Information Technology Teaching Cases (issn:2043-8869)
  8. Journal of International Business Studies (issn:0047-2506)
  9. Journal of the Operational Research Society (issn:0160-5682)
  10. Knowledge Management Research & Practice (issn:1477-8238)
  11. Monthly Digest of Statistics (issn:0308-6666)
  12. United Kingdom Balance of Payments – The Pink Book (issn:0950-7558)
  13. United Kingdom Economic Accounts (issn:1350-4401)
  14. United Kingdom National Accounts – The Blue Book (issn:0267-8691)

To access these journals you will need to log in using your network\username and password.

Screenshot of the e-journals A-to-Z

(Technical note: this alternative method of access uses LibResProxy, a CGI proxy application which mimics IP-based on-campus authentication. It will be slower than normal access, and not all features of the database may be available.)

Creating stable links to e-journal articles by hand (Blackboard / OpenURL / “Find it @ Lincoln”)

Posted on September 23rd, 2011 by Paul Stainthorp

It can be maddeningly difficult to create stable, persistent, reliable links to articles in e-journals from Blackboard. Links copied from publishers’ websites sometimes don’t include all the information needed to locate the article properly, or else they bypass the authentication processes needed to access an electronic journal: meaning that students aren’t logged in correctly, especially when using Blackboard off campus.

These sorts of links also break very easily – if a publisher alters its website, or if the Library changes its online database subscriptions.

Below is a reliable—albeit long-winded—way of creating persistent links to articles that should always work when placed in a Blackboard site. This method routes all links via “Find it @ Lincoln“, the University of Lincoln’s OpenURL link resolver software (provided by EBSCO). This software will present the user with links to the most appropriate [electronic] copy/ies of an article available.

Find it at Lincoln button

For example, taking the journal article:

  • Martin, J., et al. (1993) An accurate ab initio quartic force field for formaldehyde and its isotopomers. Journal of Molecular Spectroscopy, 160(1): pp.105–116

[N.B. Lincoln doesn't actually have electronic access to that article!]

We can build up a stable URL (web link) out of the following building blocks: up to 12 elements, strung together to form a great long link containing the citation details:

[1] http://openurl.ac.uk/ukfed:lincoln.ac.uk

This is the ‘base’ for the URL, routed through the national EDINA OpenURL Router service, and authenticating the user via the UK Access Management Federation. The national router service logs requests and provides a standardised, platform-independent web address at openurl.ac.uk.

[2] ?url_ver=Z39.88-2004

This tells our link resolver, a.k.a. “Find it @ Lincoln”, what version of the OpenURL standard (ANSI/NISO standard Z39.88-2004) to expect.

[3] &genre=article

This tells the link resolver to expect a journal article, rather than some other sort of publication.

[4] &rft_id=info:doi/__________

Fill in the blank space with the DOI (Digital Object Identifier) of the article, if one exists. For example: &rft_id=info:doi/10.1006/jmsp.1993.1161

[5] &issn=__________

Fill in the blank with the ISSN. For example: &issn=0022-2852

[6] &volume=_________

Fill in the blank with the volume number. For example: &volume=160

[7] &issue=__________

Fill in the blank with the issue number. For example: &issue=1

[8] &spage=__________

Fill in the blank with the number of the first page of the article. For example: &spage=105

[9] &aulast=__________

Fill in the blank with the surname of the lead author. For example: &aulast=Martin

[10] &aufirst=__________

Fill in the blank with the first initial of the lead author. For example: &aufirst=J

[11] &atitle=__________

Fill in the blank with the title of the article. Replace any spaces with a ‘+’ character. Percent-encode any nonalphanumeric characters (&%*/!£$, etc.). For example: &atitle=An+accurate+ab+initio+quartic+force+field+for+formaldehyde+and+its+isotopomers

[12] &title=__________

Fill in the blank with the name of the journal. Replace any spaces with a ‘+’ character. Percent-encode any nonalphanumeric characters (&%*/!£$, etc.). For example: &title=Journal+of+Molecular+Spectroscopy

…stringing all of the above together gives a finished URL which looks like this:

Once you’ve built it up, you can take the finished link and add it to a Blackboard Site by using the ‘Build Content’ menu to add a URL.

Screenshot from Blackboard

Paste your link into the URL box on the ‘Create URL’ page, and give it a Name (that’s the text the student will see, and the bit they will click on to access the article) and a Description.

You should also scroll down to the option marked ‘Open in New Window’ and select ‘Yes‘. If you don’t do this, your students may not be able to log in to the journal article. Then hit ‘Submit’.

Screenshot from Blackboard

It will then appear on Blackboard as hyperlinked text. When students click on the link, they will be asked to log in via Athens, then will see options for accessing the article online (or in print, if an e-version is not available).

Tips:

  • Don’t worry if you don’t have all the details of the citation: just leave out the elements you’re missing. Find it @ Lincoln will do its best to locate the article from even a partial citation.
  • If your link is very long, Blackboard may truncate it – breaking it in the process. If this happens, reduce the length of the URL by passing it through a link shortening service such as Linking You (for example: the shortened link for the article above is http://lncn.eu/deq), then add that URL to Blackboard instead.
  • You should percent encode any nonalphanumeric characters—i.e.many of the characters or symbols which appear in this list—that appear as part of the article title, the name of the journal, and potentially even accented letters in the name of the author. Doing so makes it much less likely that your link will break.
  • Remember to set the link to ’Open in New Window’ from within Blackboard. This ensures the authentication processes will run correctly, and is also good practice from a copyright perspective.
  • A very small number of electronic journals do not permit you to link to them from Blackboard; the most notable being the Harvard Business Review (issn:0017-8012). The terms of use of that e-journal specifically prohibit your linking to it in the course of your teaching. (Crazy, I know.)
  • See the ANSI/NISO standard Z39.88-2004 documentation for more information about the OpenURL standard. Or read this Library Journal article (from 2004 but still relevant) or the Wikipedia page.
  • If you need any help with creating these links and adding them to Blackboard, please contact your subject librarian, or email: athens@lincoln.ac.uk

Building an e-library in a new university in Ghana

Posted on September 9th, 2011 by Paul Stainthorp

Kumasi RailtracksDr Kofi Appiah, a postdoctoral researcher from the University of Lincoln School of Computer Science, is spending a year in his native Ghana to help establish a school of technology in a new HE institution there: the Christ Apostolic University College (www.cauc.edu.gh) in the city of Kumasi.

Before he left, Kofi asked me for advice on how he could help the new School of Technology build an e-library infrastructure and/or access to e-library resources for their CompSci students and staff.

I suggested he look at a few things:

What else would you suggest? I’ll forward on any suggestions to Kofi, or you can email him yourself if you prefer.

Thanks!

Off-campus access to 14 engineering journals from IEEE Xplore

Posted on July 22nd, 2011 by Paul Stainthorp

These 14 full-text engineering journals from IEEE Xplore are now available from off campus. Lincoln students and staff can log in via Athens, using their university network\accountID and password.

  1. Automatic Control, IEEE Transactions on
  2. Circuits and Systems I: Regular Papers, IEEE Transactions on
  3. Circuits and Systems II: Express Briefs, IEEE Transactions on
  4. Control Systems Technology, IEEE Transactions on
  5. Energy Conversion, IEEE Transactions on
  6. Industrial Electronics, IEEE Transactions on
  7. Industry Applications Magazine, IEEE
  8. Magnetics, IEEE Transactions on
  9. Neural Networks, IEEE Transactions on
  10. Power Electronics, IEEE Transactions on
  11. Power Systems, IEEE Transactions on
  12. Signal Processing, IEEE Transactions on
  13. Smart Grid, IEEE Transactions on
  14. Systems, Man, and Cybernetics, Part B: Cybernetics, IEEE Transactions on

You can access the IEEE Xplore journals through the Portal and e-journals A-to-Z. (Or, you could try accessing them through the new beta version of the e-journals A-to-Z, launching soon.) If you need any more information about the IEEE Xplore journals, Judith Elkin is the subject librarian for engineering.

A fresh coat of paint for the e-journals A-to-Z

Posted on July 12th, 2011 by Paul Stainthorp

The Library’s electronic journals A-to-Z service is in line to receive an updated look and feel this summer.

beta preview of the still-in-development new-look A-to-Z will be available until the end of August. The new A-t0-Z will be launched on 1 September 2011. EBSCO Information Services, who supply the A-to-Z to the University, are making these changes to bring the look of the A-to-Z more in line with their EBSCOhost databases.

The Library will be working through August to tweak the new-look A-to-Z site, to make sure it’s properly set up for the University of Lincoln, and to produce some new training materials on using the A-to-Z to find e-journals by title.

You can try the (still beta!) new-look A-to-Z for the University of Lincoln, at: http://beta.atoz.ebsco.com/titles/1710

Screenshot of the new-look A-to-Z

EBSCO have some slides about the enhancements they’re making to the A-to-Z, available to download from their website.