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

          Jon Dunn made changes -
          Field Original Value New Value
          Link This issue depends on SAK-13441 [ SAK-13441 ]
          Jon Dunn made changes -
          Issue Type Feature Request [ 2 ] Task [ 3 ]
          Jon Dunn made changes -
          Fix Version/s 2.6 [Tentative] [ 10801 ]
          Jon Dunn made changes -
          Summary Add preferred URL configuration option for Sirsi SingleSearch Web2 OSID implementation Add preferred URL configuration option for Sirsi SingleSearch Web2 and 360 Search OSID implementation
          Description Add a configuration option for the Sirsi SingleSearch Web2 OSID implementation to enable returning preferred URLs via the mechanism implemented in SAK-13441. Add a configuration option for the Sirsi SingleSearch Web2 and Serials Solutions 360 Search OSID implementations to enable returning preferred URLs via the mechanism implemented in SAK-13441.
          Jon Dunn made changes -
          Link This issue relates to SAK-14323 [ SAK-14323 ]
          Steve Smail made changes -
          Description Add a configuration option for the Sirsi SingleSearch Web2 and Serials Solutions 360 Search OSID implementations to enable returning preferred URLs via the mechanism implemented in SAK-13441. Add a configuration option for the Sirsi SingleSearch Web2 and Serials Solutions 360 Search 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).

          Minor updates to the Web2 Bridge and 360 Search componets. These are covered as sub-tasks.
          Steve Smail made changes -
          Description Add a configuration option for the Sirsi SingleSearch Web2 and Serials Solutions 360 Search 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).

          Minor updates to the Web2 Bridge and 360 Search componets. These are covered as sub-tasks.
          Add a configuration option for the Sirsi SingleSearch Web2 and Serials Solutions 360 Search 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).

          Minor updates to the Web2 Bridge and 360 Search components are required. These are covered as sub-tasks.
          Steve Smail made changes -
          Description Add a configuration option for the Sirsi SingleSearch Web2 and Serials Solutions 360 Search 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).

          Minor updates to the Web2 Bridge and 360 Search components are required. These are covered as sub-tasks.
          Add a configuration option for the Sirsi SingleSearch Web2 and Serials Solutions 360 Search 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, ninor updates to the Web2 Bridge and 360 Search components are required as well These are covered as sub-tasks.
          Steve Smail made changes -
          Description Add a configuration option for the Sirsi SingleSearch Web2 and Serials Solutions 360 Search 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, ninor updates to the Web2 Bridge and 360 Search components are required as well These are covered as sub-tasks.
          Add a configuration option for the Sirsi SingleSearch Web2 and Serials Solutions 360 Search 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.
          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.
          Steve Smail made changes -
          Summary Add preferred URL configuration option for Sirsi SingleSearch Web2 and 360 Search OSID implementation Add preferred URL configuration option for Sirsi SingleSearch Web2, 360 Search and ExLibris MetaLib OSID implementation
          Description Add a configuration option for the Sirsi SingleSearch Web2 and Serials Solutions 360 Search 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.
          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.
          Steve Smail made changes -
          Affects Version/s 2.6 [Tentative] [ 10801 ]
          Affects Version/s trunk [DO NOT USE] [ 10090 ]
          Repository Revision Date User Message
          Trunk #52001 Mon Sep 08 14:57:34 CDT 2008 ssmail@indiana.edu SAK-14322: Initial support: Use the "provide-preferred-url" configuration option to enable/disable the use of direct vendor URLs as the title link.
          Files Changed
          Commit graph MODIFY /citations/trunk/citations-impl/impl/src/java/org/sakaiproject/citation/impl/BaseConfigurationService.java
          Commit graph MODIFY /citations/trunk/citations-impl/impl/src/java/org/sakaiproject/citation/impl/BaseCitationService.java
          Commit graph MODIFY /citations/trunk/citations-api/api/src/java/org/sakaiproject/citation/api/ConfigurationService.java
          Commit graph MODIFY /citations/trunk/citations-api/api/src/java/org/sakaiproject/citation/cover/ConfigurationService.java
          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.
          Repository Revision Date User Message
          Trunk #52403 Wed Sep 17 15:16:15 CDT 2008 ssmail@indiana.edu SAK-14322: preferred URLs can be omitted, used as the title link, or provided as a related link
          Files Changed
          Commit graph MODIFY /citations/trunk/citations-impl/impl/src/java/org/sakaiproject/citation/impl/BaseConfigurationService.java
          Commit graph MODIFY /citations/trunk/citations-impl/impl/src/java/org/sakaiproject/citation/impl/BaseCitationService.java
          Commit graph MODIFY /citations/trunk/citations-api/api/src/java/org/sakaiproject/citation/api/ConfigurationService.java
          Commit graph MODIFY /citations/trunk/citations-api/api/src/java/org/sakaiproject/citation/cover/ConfigurationService.java
          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.
          Steve Smail made changes -
          Status Open [ 1 ] Resolved [ 5 ]
          Resolution Fixed [ 1 ]
          Peter A. Knoop made changes -
          Fix Version/s 2.6.0-alpha-01 [ 11279 ]
          Fix Version/s 2.6.0 [ 10801 ]
          Filter Maintainer made changes -
          2.6.x Status None
          Steve Smail made changes -
          Link This issue is related to SAK-14821 [ SAK-14821 ]
          Anthony Whyte made changes -
          Fix Version/s 2.6.0-rc01 [ 11470 ]
          Fix Version/s 2.6.0-beta03 [ 11441 ]
          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.
          Steve Smail made changes -
          Affects Version/s 2.5.0 [ 10784 ]
          Affects Version/s 2.5.x [ 10960 ]
          Affects Version/s 2.5.2 [ 11114 ]
          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.
          Steve Smail made changes -
          Status Resolved [ 5 ] Closed [ 6 ]
          Anthony Whyte made changes -
          Fix Version/s 2.6.0 [ 10801 ]
          Fix Version/s 2.6.0-rc01 [ 11470 ]
          Aaron Zeckoski made changes -
          Workflow jira [ 48301 ] Sakai CLE workflow [ 102504 ]

            People

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

              Dates

              • Created:
                Updated:
                Resolved: