{"id":618,"date":"2010-08-31T14:26:18","date_gmt":"2010-08-31T14:26:18","guid":{"rendered":"http:\/\/www.nostuff.org\/words\/2010\/talis-aspire-checking-if-a-course-has-a-list\/"},"modified":"2010-08-31T14:26:18","modified_gmt":"2010-08-31T14:26:18","slug":"talis-aspire-checking-if-a-course-has-a-list","status":"publish","type":"post","link":"https:\/\/www.nostuff.org\/words\/2010\/talis-aspire-checking-if-a-course-has-a-list\/","title":{"rendered":"Talis Aspire, checking if a course has a list"},"content":{"rendered":"

Talis Aspire<\/a> is a new-ish Reading List system used at the University of Sussex Library.<\/p>\n

On Aspire, a url for a Department<\/em> looks like this:
\nhttp:\/\/liblists.sussex.ac.uk\/departments\/anthropology.html<\/a><\/p>\n

A page for a course<\/em> looks like this (for course l6061):
\nhttp:\/\/liblists.sussex.ac.uk\/courses\/l6061.html<\/a><\/p>\n

The nice<\/a> thing is that you can replace the \u2018.html\u2019 with .json<\/a> or .rdf<\/a> \u2013 while the html only has a link to the related list, the json and rdf expose other links and relationships, such as the department.<\/p>\n

For us, most (but not all) courses only have one list. URLs for lists are not predictable in the same way as the courses URL. E.g.
\nhttp:\/\/liblists.sussex.ac.uk\/lists\/EEC1E2AA-C350-DAFC-BDE4-1E9EF5EC69E5.html<\/a><\/p>\n

So what if you want to link to a list from an external system.<\/p>\n

The University has a portal which includes for students a list of their courses and provides a link to those that have a reading list. Two issues: it needs to know which courses have a reading list on Talis Aspire, and it needs a way to link to them.<\/p>\n

\"Sussex<\/a><\/p>\n

The easiest way to achieve the former is for the central admin\/portal server to query (make a http request) for each course provided by the University, if it gets a 404, no list exists for that course. It can then flag each course that has a list (using a field in the database).<\/p>\n

And what about linking to a list. We actually have three options. The first is to simply link to the course link above (second link from the top), this will show any lists for that course, but will normally require the user to click on the single reading list link to see the list items, which isn\u2019t ideal. The second method is to process the json data in the step above (where we were checking for the existence of a course page), the data will include the URL for the list(s) which could then be stored in the portal DB.<\/p>\n

But the third option is the easiest. Turns out there is a nice<\/a> URL you can use, similar to the one above, which will take the user directly to a list for a course, if there is only one, if there is more than more it will show a list (of, ummm, lists) instead, and this URL is predictable for any given course code.<\/p>\n

Here\u2019s an example of both scenarios. Thanks for Chris Clarke at Talis for the information on this.<\/p>\n

http:\/\/liblists.sussex.ac.uk\/courses\/l6061\/lists.html<\/a> [one list, norm]
\nhttp:\/\/liblists.sussex.ac.uk\/courses\/v1367\/lists.html<\/a> (json<\/a>) [two lists]<\/p>\n

Finally, I knocked up some bad php to demonstrate this. It queries the url above, and returns either the urls of the list(s) or a message to say there is no course or lists for that course code.<\/p>\n

http:\/\/www.lib.sussex.ac.uk\/coursechecker.php?course=v1367<\/a>
\nhttp:\/\/www.lib.sussex.ac.uk\/coursechecker.php?course=l6066<\/a>
\nhttp:\/\/www.lib.sussex.ac.uk\/coursechecker.php?course=abc<\/a> [doesn\u2019t exist]<\/p>\n

<?php<\/p>\n

# This script is past a course code
\n# it returns any reading lists attached to that coursecode<\/p>\n

$baseurl = “http:\/\/liblists.sussex.ac.uk”;<\/a><\/p>\n

$coursecode = $_GET[“course”];
\nif ($coursecode == “” OR $coursecode == null) {
\necho “no course”;
\nexit;
\n}<\/p>\n

# this url will exist if there are lists for this course,
\n# and will not exist (404) if there are not
\n$url = $baseurl . “\/courses\/” . $coursecode . “\/lists.json”;
\n# …also available in html and rdf<\/p>\n

# Get webpage using curl
\n$ch\u00a0\u00a0\u00a0\u00a0\u00a0 = curl_init( $url );
\n# OPTION: don’t put it on screen
\ncurl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
\n$page = curl_exec($ch);
\n$header\u00a0 = curl_getinfo( $ch );
\ncurl_close($ch);
\n$statuscode = $header[‘http_code’];<\/p>\n

# if status code 404 then no page
\nif ($statuscode == ‘404’) {
\necho ‘NOREADINGLIST’;
\n}<\/p>\n

# we have a page for this course
\nelseif ($statuscode == ‘200’) {
\n# use json to return url to list(s), though if only one the original url,
\n# ending in html, will take you to it.
\nget_list_url($page);
\n}<\/p>\n

# or maybe we have another status code
\nelse {
\necho ‘NOTSURE’;
\n}<\/p>\n

function get_list_url ($page) {
\n# JSON
\n$data = json_decode($page, true); #true=array<\/p>\n

foreach ($data as $listurl => $stuff) {
\n# we only want lists. not courses or departments
\nif (preg_match(“\/\/lists\/\/”, $listurl)) {
\necho “$listurl<br>n”;
\n}
\n}<\/p>\n

}<\/p>\n

?><\/p><\/blockquote>\n

So once a week, the central portal will query Talis Aspire for each course to see if there is a reading list, and store the result. And it will link to lists using the URL http:\/\/liblists.sussex.ac.uk\/courses\/{coursecode}\/lists.html<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"

Talis Aspire is a new-ish Reading List system used at the University of Sussex Library. On Aspire, a url for a Department looks like this: http:\/\/liblists.sussex.ac.uk\/departments\/anthropology.html A page for a course looks like this (for course l6061): http:\/\/liblists.sussex.ac.uk\/courses\/l6061.html The nice thing is that you can replace the \u2018.html\u2019 with .json or .rdf \u2013 while the […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[3,5],"tags":[25,45,87,140,176],"class_list":["post-618","post","type-post","status-publish","format-standard","hentry","category-code","category-information-searching-and-libraries","tag-aspire","tag-curl","tag-json","tag-php","tag-talis"],"_links":{"self":[{"href":"https:\/\/www.nostuff.org\/words\/wp-json\/wp\/v2\/posts\/618","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.nostuff.org\/words\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.nostuff.org\/words\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.nostuff.org\/words\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.nostuff.org\/words\/wp-json\/wp\/v2\/comments?post=618"}],"version-history":[{"count":0,"href":"https:\/\/www.nostuff.org\/words\/wp-json\/wp\/v2\/posts\/618\/revisions"}],"wp:attachment":[{"href":"https:\/\/www.nostuff.org\/words\/wp-json\/wp\/v2\/media?parent=618"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.nostuff.org\/words\/wp-json\/wp\/v2\/categories?post=618"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.nostuff.org\/words\/wp-json\/wp\/v2\/tags?post=618"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}