{"id":397,"date":"2016-11-07T13:55:02","date_gmt":"2016-11-07T19:55:02","guid":{"rendered":"http:\/\/apps.lib.ua.edu\/blogs\/webservices\/?p=397"},"modified":"2016-11-08T16:01:41","modified_gmt":"2016-11-08T22:01:41","slug":"research-help-bento-card","status":"publish","type":"post","link":"https:\/\/apps.lib.ua.edu\/blogs\/webservices\/2016\/11\/07\/research-help-bento-card\/","title":{"rendered":"Research help in website search results (OneSearch)"},"content":{"rendered":"<p><strong id=\"#whatIsOneSearch\">OneSearch Refresher<br \/>\n<\/strong><\/p>\n<p>OneSearch is the search interface on the library website. \u00a0The idea behind OneSearch is to provide a jumping off point to the various library resources available on a topic.<\/p>\n<p><a href=\"https:\/\/apps.lib.ua.edu\/blogs\/webservices\/files\/2016\/11\/OneSearchExampleResultsPage.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-453\" src=\"https:\/\/apps.lib.ua.edu\/blogs\/webservices\/files\/2016\/11\/OneSearchExampleResultsPage.png\" alt=\"onesearchexampleresultspage\" width=\"1303\" height=\"706\" srcset=\"https:\/\/apps.lib.ua.edu\/blogs\/webservices\/files\/2016\/11\/OneSearchExampleResultsPage.png 1303w, https:\/\/apps.lib.ua.edu\/blogs\/webservices\/files\/2016\/11\/OneSearchExampleResultsPage-300x163.png 300w, https:\/\/apps.lib.ua.edu\/blogs\/webservices\/files\/2016\/11\/OneSearchExampleResultsPage-768x416.png 768w, https:\/\/apps.lib.ua.edu\/blogs\/webservices\/files\/2016\/11\/OneSearchExampleResultsPage-1024x555.png 1024w, https:\/\/apps.lib.ua.edu\/blogs\/webservices\/files\/2016\/11\/OneSearchExampleResultsPage-676x366.png 676w\" sizes=\"auto, (max-width: 1303px) 100vw, 1303px\" \/><\/a><\/p>\n<p>You can search anywhere on the library website and see results broken down into content type &#8212; articles, books, et cetera. \u00a0Results from webpages on the library web site are also included in the Libraries&#8217; Website section. \u00a0For a detailed look\u00a0at OneSearch,\u00a0click <a href=\"http:\/\/guides.lib.ua.edu\/onesearch-howto\">here<\/a>.<\/p>\n<p><strong>What we&#8217;re adding to the OneSearch results<\/strong><\/p>\n<p>Web Technologies and Development has been working on adding a Research Help section to our OneSearch results that will display\u00a0subject specialists based on the user&#8217;s query. These result &#8216;Cards&#8217; are similar to result cards you might see in Google search results when you search for common items such as a thing or a location. Specifically, these new &#8216;research specialist cards&#8217; use call number range mapping to associate keywords (pulled from the query) with subjects, and then with subject specialists. The point is that (a) keywords &#8211; when mapped &amp; appropriate (meaning matching) &#8211; should then result in a collection development \/ subject specialist&#8217;s image, name, title and contact information appearing along with search results because (b) we feel that it is helpful to users to see the person responsible for materials in a certain subject area.<\/p>\n<p>The user may have a question, or want to know what our policies are in regards to subject areas under their domain, or be spurred to ask for a certain item, or just want to know general information. It&#8217;s a heck of a lot easier for the user if the CD librarian appears at the point of a subject\/keyword search, rather than the user go hunting for them at another time.<\/p>\n<p>The basis for the research specialist cards is the University of Michigan federated \/Bento-style search, which uses a similar system to serve CD librarians to users during typical resource searches (more on this at the end of the blog post). For more info on how it works, issues, inherent problems, etc., please scroll down to the Q&amp;A at the bottom of the post.<\/p>\n<p><strong>Show and Tell<\/strong><\/p>\n<p>As an example, let&#8217;s try to search for\u00a0<a href=\"https:\/\/wwwdev2.lib.ua.edu\/#\/bento\/john%20keats%20poetry\">john keats poetry<\/a>\u00a0in OneSearch. \u00a0The results in the Research Help section are shown below:<\/p>\n<p><a href=\"https:\/\/apps.lib.ua.edu\/blogs\/webservices\/files\/2016\/11\/ResearchHelpResults.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-403\" src=\"https:\/\/apps.lib.ua.edu\/blogs\/webservices\/files\/2016\/11\/ResearchHelpResults.png\" alt=\"researchhelpresults\" width=\"926\" height=\"190\" \/><\/a><\/p>\n<p>In response to the query, the user gets English subject specialists in the Research Help section that appears\u00a0below the first row of results.<\/p>\n<p>How about results for\u00a0<a href=\"https:\/\/wwwdev2.lib.ua.edu\/#\/bento\/operas%20by%20mozart\">operas by mozart<\/a>?<\/p>\n<p><a href=\"https:\/\/apps.lib.ua.edu\/blogs\/webservices\/files\/2016\/11\/ResearchHelpMusic.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-405\" src=\"https:\/\/apps.lib.ua.edu\/blogs\/webservices\/files\/2016\/11\/ResearchHelpMusic.png\" alt=\"researchhelpmusic\" width=\"1076\" height=\"239\" srcset=\"https:\/\/apps.lib.ua.edu\/blogs\/webservices\/files\/2016\/11\/ResearchHelpMusic.png 1076w, https:\/\/apps.lib.ua.edu\/blogs\/webservices\/files\/2016\/11\/ResearchHelpMusic-300x67.png 300w, https:\/\/apps.lib.ua.edu\/blogs\/webservices\/files\/2016\/11\/ResearchHelpMusic-768x171.png 768w, https:\/\/apps.lib.ua.edu\/blogs\/webservices\/files\/2016\/11\/ResearchHelpMusic-1024x227.png 1024w, https:\/\/apps.lib.ua.edu\/blogs\/webservices\/files\/2016\/11\/ResearchHelpMusic-676x150.png 676w\" sizes=\"auto, (max-width: 1076px) 100vw, 1076px\" \/><\/a><\/p>\n<p>This doesn&#8217;t work perfectly for every query, unfortunately. \u00a0For some subjects, we don&#8217;t have accurate call number information entered in yet (see more <a href=\"##incompleteCallNumberRanges\">here<\/a>). \u00a0Other subjects\u00a0have other <a href=\"##limitations\">challenges<\/a> associated with them.<\/p>\n<p>You can give this new functionality a try at <a href=\"https:\/\/wwwdev2.lib.ua.edu\">https:\/\/wwwdev2.lib.ua.edu<\/a>. \u00a0Keep in mind that our &#8220;wwwdev2&#8221;\u00a0site can only be accessed from computers on campus that are in the University Libraries faculty\/staff IP range.<\/p>\n<p>If you are interested in further information, I&#8217;ve answered what I expect will be common questions below.<\/p>\n<p><strong>Research Specialist Card Q &amp; A<\/strong><\/p>\n<p><strong>Q:\u00a0<\/strong>Will these results display in Scout?<\/p>\n<p><strong>A:\u00a0<\/strong>These results aren&#8217;t currently slated to display in Scout, but it&#8217;s possible to do so and it&#8217;s something we will consider for the future<strong>.<\/strong><\/p>\n<p><strong>Q:\u00a0<\/strong>How did this come about?<\/p>\n<p><strong>A:\u00a0<\/strong>Since the initial launch of OneSearch in the fall\u00a0of 2015, Web Services has been eager to add a section\u00a0to OneSearch\u00a0that promotes\u00a0reference services. \u00a0Ideally, we didn&#8217;t want to just display static links &#8212; we wanted the reference services of individual librarians to appear based on the context that the user&#8217;s\u00a0search terms\u00a0provide. \u00a0We spoke to other institutions that had a Research Help section of their search results and decided it was something we could implement as well.<\/p>\n<p><strong>Q:\u00a0<\/strong>How do you match user queries to subject specialties?<\/p>\n<p><strong>A:\u00a0<\/strong>Our first iteration of this idea\u00a0used\u00a0the keywords that University of Alabama librarians\u00a0supplied before the launch of the redesign last summer. \u00a0This approach was fairly limited, since a very large\u00a0proportion\u00a0of OneSearch\u00a0user queries\u00a0didn&#8217;t match\u00a0any of our keywords.<\/p>\n<p>We couldn&#8217;t help but notice that Michigan&#8217;s site returned relevant librarians for a wide range of queries. \u00a0When we emailed Michigan\u00a0to ask them how they were accomplishing this, they informed us\u00a0that\u00a0they were taking the query the user put in, searching the catalog with it, and using the call numbers from the results to classify the query in their<a href=\"http:\/\/www.lib.umich.edu\/browse\/categories\/\"> in-house\u00a0taxonomy<\/a> for subject specialties. \u00a0 Once they had classified a query into that hierarchy, they would display the librarian associated with that specialty or specialties.<\/p>\n<p>We thought: what a good idea! \u00a0So we have worked on implementing a beta version of this functionality in OneSearch that displays staff directory information when a query matches a subject specialty. \u00a0<em>For librarians providing services\u00a0that don&#8217;t easily map to Library of Congress\u00a0call numbers, keywords are still available to ensure that they are returned in search results for specific\u00a0searches.<\/em><span id=\"#incompleteCallNumberRanges\"><\/span><\/p>\n<p><strong>Q:\u00a0<\/strong>Where are the call numbers for each subject specialty getting pulled from?<\/p>\n<p><strong>A:\u00a0<\/strong>This (incomplete)\u00a0<a href=\"https:\/\/docs.google.com\/spreadsheets\/d\/1oSaz3PdNAAp064qYOBGWIcVebiJfdHQRg6eMmXU9wLM\/edit?usp=sharing\">spreadsheet<\/a>.\u00a0 Call numbers have been pulled from LibGuides where available, and in instances where doing some sort of rough classification was easy based on the structure of the Library of Congress classification, I have tried to add those into the spreadsheet as well.<\/p>\n<p><strong>Q:\u00a0<\/strong>These call numbers are wrong and\/or incomplete!<\/p>\n<p><strong>A: <\/strong>Our hope is to get accurate\u00a0call number ranges from subject specialists.<strong>\u00a0<\/strong>Currently, the call numbers being used have been pulled together from what&#8217;s in LibGuides for each subject and what&#8217;s easy to pull out of the Library of Congress\u00a0classification online. If you want to make additions or changes to the call numbers getting used for your subject specialty, take a look at this <a href=\"https:\/\/docs.google.com\/spreadsheets\/d\/1oSaz3PdNAAp064qYOBGWIcVebiJfdHQRg6eMmXU9wLM\/edit?usp=sharing\">spreadsheet<\/a>\u00a0and please\u00a0<a href=\"mailto:amparker8@ua.edu\">email me<\/a>!<\/p>\n<p><strong>Q: <\/strong>Why aren&#8217;t results displaying for &lt;insert query here&gt;<\/p>\n<p><strong>A:\u00a0<\/strong>There may not be any call numbers in our system associated with\u00a0that subject specialty &#8212; see the question above.<\/p>\n<p>We&#8217;ve also set a minimum relevance threshold for\u00a0subject specialists getting displayed in search results. \u00a0If one call number out of one hundred returned from the catalog maps to a subject specialist (in an extreme example), it&#8217;s unlikely that specialist is pertinent to that query and it seemingly makes sense to exclude that subject specialist from the results. \u00a0Where exactly that threshold should be, however, is tricky, and that&#8217;s something we&#8217;re still experimenting with.<\/p>\n<p>Finally, we are using AND as the default Boolean operator for catalog queries. \u00a0Using OR would increase the number of queries that return staff directory results, but decrease their likely relevance.<\/p>\n<p>If you actually want to see which\u00a0call numbers are getting matched to each subject, you can &#8212; but there are several\u00a0steps involved.<\/p>\n<p>Here&#8217;s an example URL:<\/p>\n<p>http:\/\/wwwdev2.lib.ua.edu\/oneSearch\/api\/search\/YOUR QUERY HERE\/engine\/128\/resultType\/relevance<\/p>\n<p>Replace YOUR QUERY HERE in the above URL with a query you want to see the raw results\u00a0for, then paste the URL into your browser.<\/p>\n<p>The results will be hard to read, so you&#8217;ll want to make use of an online formatter. \u00a0Go to <a href=\"http:\/\/jsonformatter.org\">jsonformatter.org<\/a>, paste your results on the left-hand side, then click Format \/ Beautify. \u00a0You should see formatted results on the right-hand side.<\/p>\n<p><a href=\"https:\/\/apps.lib.ua.edu\/blogs\/webservices\/files\/2016\/11\/OneSearchJSONFormattedResults.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-400\" src=\"https:\/\/apps.lib.ua.edu\/blogs\/webservices\/files\/2016\/11\/OneSearchJSONFormattedResults.png\" alt=\"onesearchjsonformattedresults\" width=\"563\" height=\"573\" \/><\/a><\/p>\n<p>&nbsp;<\/p>\n<p>There&#8217;s still a lot of information that&#8217;s irrelevant to you here, so I recommend using Ctrl-F to search for &#8220;subject&#8221;. The most important items are\u00a0the name of the subject and the relevance listed after it, which is the number of call numbers that matched call number ranges associated with\u00a0that subject.<\/p>\n<p><span id=\"#limitations\"><\/span><br \/>\n<a href=\"https:\/\/apps.lib.ua.edu\/blogs\/webservices\/files\/2016\/11\/OneSearchJSONResultSnippet.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-401\" src=\"https:\/\/apps.lib.ua.edu\/blogs\/webservices\/files\/2016\/11\/OneSearchJSONResultSnippet.png\" alt=\"onesearchjsonresultsnippet\" width=\"324\" height=\"91\" \/><\/a><\/p>\n<p>&nbsp;<\/p>\n<p>If you&#8217;re interested specifically in what those call numbers are, you can see call numbers listed in &#8220;callNumber&#8221; next to the ranges they matched. \u00a0If there are call numbers that didn&#8217;t map to any subject, they appear in the\u00a0&#8220;<span class=\"property\">nonMatchingCallNumbers&#8221; section (if not, the section won&#8217;t appear). \u00a0<\/span><\/p>\n<p><strong>Q: <\/strong>What are some limitations of this approach?<\/p>\n<p><strong>A:\u00a0<\/strong>Our approach does not work well for queries that mostly return electronic resources &#8212; Computer Science is a good example. \u00a0This is because Voyager&#8217;s somewhat dated SearchService API can&#8217;t be configured to return call numbers if there&#8217;s nothing in the 852 location field, as is the case with our electronic resources. \u00a0If we used Z39.50 (an older search technology) instead of the API, we could get results with call numbers for these resources &#8212; but that would entail quite a bit of additional work and may not integrate\u00a0well with an application that currently\u00a0works with API results only.<\/p>\n<p>Some subjects are largely subsets of other subjects in the LC hierarchy &#8212; for example, PN is Literature (General) and Motion pictures are PN1993-1999. \u00a0When I first tested film-related queries, English subject specialists were always returned ahead of Telecommunication and Film for film queries like &#8220;quentin tarantino&#8221; because the English call number range included all of the film results and then other literature results as well. \u00a0The simple solution is to take the motion pictures call numbers out of the literature range. \u00a0\u00a0Instead of using all of PN for English, it&#8217;s now specified as PN1-1993, PN2000-6790. \u00a0In other instances where this super\/subset relationship exists, similar changes may need to be made to call numbers.<\/p>\n<p>More generally, some subjects are multidisciplinary and don&#8217;t neatly fit into the Library of Congress classification system.<\/p>\n<p><strong>Q: <\/strong>Is this the final design of how the results will display?<\/p>\n<p><strong>A:\u00a0<\/strong>Not necessarily. \u00a0We are also looking into other options for where and how to display the Research Help results. \u00a0Once we have something to share, we&#8217;ll send those along.<\/p>\n<p>We also want to make it more clear to users that OneSearch results don&#8217;t end with the Research Help box in instances where that&#8217;s what a user sees at the bottom of the browser before scrolling.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>OneSearch Refresher OneSearch is the search interface on the library website. \u00a0The idea behind OneSearch is to provide a jumping off point to the various library resources available on a topic. You can search anywhere on the library website and see results broken down into content type &#8212; articles, books, et cetera. \u00a0Results from webpages &hellip; <a href=\"https:\/\/apps.lib.ua.edu\/blogs\/webservices\/2016\/11\/07\/research-help-bento-card\/\" class=\"more-link\">Continue reading <span class=\"screen-reader-text\">Research help in website search results (OneSearch)<\/span><\/a><\/p>\n","protected":false},"author":489,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[20213,20208],"tags":[],"class_list":["post-397","post","type-post","status-publish","format-standard","hentry","category-onesearch","category-website"],"_links":{"self":[{"href":"https:\/\/apps.lib.ua.edu\/blogs\/webservices\/wp-json\/wp\/v2\/posts\/397","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/apps.lib.ua.edu\/blogs\/webservices\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/apps.lib.ua.edu\/blogs\/webservices\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/apps.lib.ua.edu\/blogs\/webservices\/wp-json\/wp\/v2\/users\/489"}],"replies":[{"embeddable":true,"href":"https:\/\/apps.lib.ua.edu\/blogs\/webservices\/wp-json\/wp\/v2\/comments?post=397"}],"version-history":[{"count":77,"href":"https:\/\/apps.lib.ua.edu\/blogs\/webservices\/wp-json\/wp\/v2\/posts\/397\/revisions"}],"predecessor-version":[{"id":482,"href":"https:\/\/apps.lib.ua.edu\/blogs\/webservices\/wp-json\/wp\/v2\/posts\/397\/revisions\/482"}],"wp:attachment":[{"href":"https:\/\/apps.lib.ua.edu\/blogs\/webservices\/wp-json\/wp\/v2\/media?parent=397"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/apps.lib.ua.edu\/blogs\/webservices\/wp-json\/wp\/v2\/categories?post=397"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/apps.lib.ua.edu\/blogs\/webservices\/wp-json\/wp\/v2\/tags?post=397"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}