Sakai
  1. Sakai
  2. SAK-14322

Add preferred URL configuration option for Sirsi SingleSearch Web2, 360 Search and ExLibris MetaLib OSID implementation

    Details

    • Type: Task Task
    • Status: Closed Closed
    • Priority: Major Major
    • Resolution: Fixed
    • Affects Version/s: 2.6.0
    • Fix Version/s: 2.6.0
    • Component/s: Citations, Citations Helper
    • Labels:
      None

      Description

      Add a configuration option for the Sirsi SingleSearch Web2, Serials Solutions 360 Search, and ExLibris MetaLib OSID implementations to enable returning preferred URLs via the mechanism implemented in SAK-13441.

      Details:

      This option modifies the behavior of the Citations Helper when handling search results provided by the "Search Library Resources" OSID components.

      The option itself is provided in the site specific XML configuration file for the Citations Helper:

        <provide-preferred-url> true | false </provide-preferred-url>

      If the <provide-preferred-url> option is not present in the configuration file, the feature is disabled (as if "false" had been supplied in the configuration file).

      The changes required to implement this are largley confined to BaseConfigurationService.java and BaseCitationService.java.

      However, minor updates to the Web2 Bridge and 360 Search components are required as well; these are addressed as sub-tasks.

        Issue Links

          Activity

          Hide
          Steve Smail added a comment -
          The "Search Library Resources" component of the Citations Helper must be correctly configured to test this change. Once that is done:

          - Update your XML configuration file (found in the Citations Admin project) to add or modify the newconfiguration directive (set the value to true):

             <provide-preferred-url>true</provide-preferred-url>

          Once that's done, here's a sample test scenerio:

          - From Resources, start the Citations Helper via the "Add Citation List" pulldown option.
          - Select "Search Library Resources".
          - Click "Search Library Resources" to begin the search process
          - Select one (or more) databases to search
          - Enter a search term and click "Search" - you'll see the search results page.

          Each search result displays the item title as a link. Verify that one (or more) of these title links leads directly to vendor supplied result information.

          - Click "Cancel Citation List" to discard the citation list

          Variations:

          1) Disable the use of preferred URLs:

             <provide-preferred-url>false</provide-preferred-url>

          Verify that each search result title link is an OpenURL (the link should take you page provided by your institutions link resolver - this page will display options for accessing the desired content)

          2) Remove the <provide-preferred-url> configuration item. Again, the title links should all be OpenURLs.


          Show
          Steve Smail added a comment - The "Search Library Resources" component of the Citations Helper must be correctly configured to test this change. Once that is done: - Update your XML configuration file (found in the Citations Admin project) to add or modify the newconfiguration directive (set the value to true):    <provide-preferred-url>true</provide-preferred-url> Once that's done, here's a sample test scenerio: - From Resources, start the Citations Helper via the "Add Citation List" pulldown option. - Select "Search Library Resources". - Click "Search Library Resources" to begin the search process - Select one (or more) databases to search - Enter a search term and click "Search" - you'll see the search results page. Each search result displays the item title as a link. Verify that one (or more) of these title links leads directly to vendor supplied result information. - Click "Cancel Citation List" to discard the citation list Variations: 1) Disable the use of preferred URLs:    <provide-preferred-url>false</provide-preferred-url> Verify that each search result title link is an OpenURL (the link should take you page provided by your institutions link resolver - this page will display options for accessing the desired content) 2) Remove the <provide-preferred-url> configuration item. Again, the title links should all be OpenURLs.
          Hide
          Steve Smail added a comment -
          I also want to note that this feature has been requested by several campuses during their evaluation of the "Search Library Resources" feature.

          The shared belief is that direct URLs provided by (at least some) metasearch engines will successfully find content more reliably than will the campus OpenURL resolver.
          Show
          Steve Smail added a comment - I also want to note that this feature has been requested by several campuses during their evaluation of the "Search Library Resources" feature. The shared belief is that direct URLs provided by (at least some) metasearch engines will successfully find content more reliably than will the campus OpenURL resolver.
          Hide
          Steve Smail added a comment -
          I've made a minor (and obvious) change to the functionality we're adding. Here's the new description:

          Add a configuration option for the Sirsi SingleSearch Web2, Serials Solutions 360 Search, and ExLibris MetaLib OSID implementations to enable returning preferred URLs via the mechanism implemented in SAK-13441.

          Details:

          This option modifies the behavior of the Citations Helper when handling search results provided by the "Search Library Resources" OSID components.

          The option itself is provided in the site specific XML configuration file for the Citations Helper:

            <provide-direct-url> false | related-link | title-link </provide-direct-url>

            -- "false" tells us to not to use the direct URL at all
                (this is the current Citations behavior)

            -- "related-url" tells us to provide the direct URL as a secondary, related link
                (the tite link is still an OpenURL)

            -- "title-link" tells us to provide the direct URL as the title link

          If the <provide-direct-url> option is not present in the configuration file, the feature is disabled (as if "false" had been supplied in the configuration file).

          The changes required to implement this are largley confined to BaseConfigurationService.java and BaseCitationService.java.
          Show
          Steve Smail added a comment - I've made a minor (and obvious) change to the functionality we're adding. Here's the new description: Add a configuration option for the Sirsi SingleSearch Web2, Serials Solutions 360 Search, and ExLibris MetaLib OSID implementations to enable returning preferred URLs via the mechanism implemented in SAK-13441 . Details: This option modifies the behavior of the Citations Helper when handling search results provided by the "Search Library Resources" OSID components. The option itself is provided in the site specific XML configuration file for the Citations Helper:   <provide-direct-url> false | related-link | title-link </provide-direct-url>   -- "false" tells us to not to use the direct URL at all       (this is the current Citations behavior)   -- "related-url" tells us to provide the direct URL as a secondary, related link       (the tite link is still an OpenURL)   -- "title-link" tells us to provide the direct URL as the title link If the <provide-direct-url> option is not present in the configuration file, the feature is disabled (as if "false" had been supplied in the configuration file). The changes required to implement this are largley confined to BaseConfigurationService.java and BaseCitationService.java.
          Hide
          Steve Smail added a comment -
          Due to change described in my previous comment, here's an updated test plan:

          The "Search Library Resources" component of the Citations Helper must be correctly configured to test this change. Once that is done:

          - Update your XML configuration file (found in the Citations Admin project) to add or modify the new configuration directive (set the value to title-link):

             <provide-direct-url>title-link</provide-direct-url>

          Here's a sample test scenerio:

          - From Resources, start the Citations Helper via the "Add Citation List" pulldown option.
          - Select "Search Library Resources".
          - Click "Search Library Resources" to begin the search process
          - Select one (or more) databases to search
          - Enter a search term and click "Search" - you'll see the search results page.

          Each search result displays the item title as a direct link. Verify that one (or more) of these title links leads directly to vendor supplied result information.

          - Click "Cancel Citation List" to discard the citation list

          Variations:

          1) Disable the use of direct URLs:

             <provide-direct-url>false</provide-direct-url>

          Verify that each search result title link is an OpenURL (the link should take you page provided by your institutions link resolver - this page will display options for accessing the desired content)

          2) Remove the <provide-direct-url> configuration item. Again, the title links should all be OpenURLs.

          3) Use the direct URL as a related link:

            <provide-direct-url>related-link</provide-direct-url>

          -- Click "Add" to save a few search results to your Citation List
          -- Click "Review Citations" to return to the Edit Citation List page

          Verify that the title links are OpenURLs, and that the Related Link is a direct, vendor URL. There won't be a related link if no direct URL was available.
          Show
          Steve Smail added a comment - Due to change described in my previous comment, here's an updated test plan: The "Search Library Resources" component of the Citations Helper must be correctly configured to test this change. Once that is done: - Update your XML configuration file (found in the Citations Admin project) to add or modify the new configuration directive (set the value to title-link):    <provide-direct-url>title-link</provide-direct-url> Here's a sample test scenerio: - From Resources, start the Citations Helper via the "Add Citation List" pulldown option. - Select "Search Library Resources". - Click "Search Library Resources" to begin the search process - Select one (or more) databases to search - Enter a search term and click "Search" - you'll see the search results page. Each search result displays the item title as a direct link. Verify that one (or more) of these title links leads directly to vendor supplied result information. - Click "Cancel Citation List" to discard the citation list Variations: 1) Disable the use of direct URLs:    <provide-direct-url>false</provide-direct-url> Verify that each search result title link is an OpenURL (the link should take you page provided by your institutions link resolver - this page will display options for accessing the desired content) 2) Remove the <provide-direct-url> configuration item. Again, the title links should all be OpenURLs. 3) Use the direct URL as a related link:   <provide-direct-url>related-link</provide-direct-url> -- Click "Add" to save a few search results to your Citation List -- Click "Review Citations" to return to the Edit Citation List page Verify that the title links are OpenURLs, and that the Related Link is a direct, vendor URL. There won't be a related link if no direct URL was available.
          Hide
          Steve Smail added a comment -
          The changes required for this new functionality have been tested and checked in.
          Show
          Steve Smail added a comment - The changes required for this new functionality have been tested and checked in.
          Hide
          Anthony Whyte added a comment -
          Both r 52001 and 52403 are in 2.6.0.
          Show
          Anthony Whyte added a comment - Both r 52001 and 52403 are in 2.6.0.
          Hide
          Steve Smail added a comment -
          This work was done as a new feature for Sakai 2.6.0, and it's included in that release.

          We've never intended to move this into the 2.5.x Citations code, so I've removed the various 2.5 versions from the "affects" list.

          Anthony - if there's a better way to handle this, just let me know.
          Show
          Steve Smail added a comment - This work was done as a new feature for Sakai 2.6.0, and it's included in that release. We've never intended to move this into the 2.5.x Citations code, so I've removed the various 2.5 versions from the "affects" list. Anthony - if there's a better way to handle this, just let me know.
          Hide
          Steve Smail added a comment -
          This work is included in the 2.6.0 release. It seems ok to close the issue now.
          Show
          Steve Smail added a comment - This work is included in the 2.6.0 release. It seems ok to close the issue now.

            People

            • Assignee:
              Steve Smail
              Reporter:
              Jon Dunn
            • Votes:
              0 Vote for this issue
              Watchers:
              0 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved: