RBdigital integration

[Terran McCanna]

PINES is working with Recorded Books, Inc. on integrating their RBdigital e-resources with Evergreen. The intention is to allow searching of RBdigital resources from the Evergreen catalog without needing to import and maintain bibliographic records for the RBdigital resources.

Because some members of the PINES consortium have access to RBdigital through another consortium called GADD, and some members of the PINES consortium have access to RBdigital through independent non-GADD contracts, and some members do not have access to RBdigital at all, the integration will require that the patron is logged into their My Account, and it will only show RBdigital resources that the patron has access to.

The RBdigital search results will appear in the OPAC on a different tab - a search in basic or advanced Evergreen search will carry over to the RBdigital tab (along with filters when mapping is feasible) so that the user can type in a search once and see both sets of results. The design of the RBdigital tab will make use of the OPAC styling for consistency (see screenshot).

The overall framework could also be leveraged for integration of Overdrive or other vendor products.

All of the code, of course, will be released for broader testing and consideration for inclusion in Master.

We are looking forward to being able to post screenshots here soon!

[Diane Disbro (ddisbro)]

This is exciting!

Diane Disbro
Branch Manager/Circulation Coordinator
Union Branch
Scenic Regional Library
308 Hawthorne Drive
Union, MO 63084
[phone]
<email address hidden>

On Tue, May 22, 2018 at 10:21 AM, Terran McCanna <
<email address hidden>> wrote:

> Public bug reported:
>
> PINES is working with Recorded Books, Inc. on integrating their
> RBdigital e-resources with Evergreen. The intention is to allow
> searching of RBdigital resources from the Evergreen catalog without
> needing to import and maintain bibliographic records for the RBdigital
> resources.
>
> Because some members of the PINES consortium have access to RBdigital
> through another consortium called GADD, and some members of the PINES
> consortium have access to RBdigital through independent non-GADD
> contracts, and some members do not have access to RBdigital at all, the
> integration will require that the patron is logged into their My
> Account, and it will only show RBdigital resources that the patron has
> access to.
>
> The RBdigital search results will appear in the OPAC on a different tab
> - a search in basic or advanced Evergreen search will carry over to the
> RBdigital tab (along with filters when mapping is feasible) so that the
> user can type in a search once and see both sets of results. The design
> of the RBdigital tab will make use of the OPAC styling for consistency
> (see screenshot).
>
> The overall framework could also be leveraged for integration of
> Overdrive or other vendor products.
>
> All of the code, of course, will be released for broader testing and
> consideration for inclusion in Master.
>
> We are looking forward to being able to post screenshots here soon!
>
> ** Affects: evergreen
> Importance: Wishlist
> Status: New
>
> --
> You received this bug notification because you are subscribed to
> Evergreen.
> Matching subscriptions: EV bug mail
> https://bugs.launchpad.net/bugs/1772680
>
> Title:
> RBdigital integration
>
> Status in Evergreen:
> New
>
> Bug description:
> PINES is working with Recorded Books, Inc. on integrating their
> RBdigital e-resources with Evergreen. The intention is to allow
> searching of RBdigital resources from the Evergreen catalog without
> needing to import and maintain bibliographic records for the RBdigital
> resources.
>
> Because some members of the PINES consortium have access to RBdigital
> through another consortium called GADD, and some members of the PINES
> consortium have access to RBdigital through independent non-GADD
> contracts, and some members do not have access to RBdigital at all,
> the integration will require that the patron is logged into their My
> Account, and it will only show RBdigital resources that the patron has
> access to.
>
> The RBdigital search results will appear in the OPAC on a different
> tab - a search in basic or advanced Evergreen search will carry over
> to the RBdigital tab (along with filters when mapping is feasible) so
> that the user can type in a search once and see both sets of results.
> The design of the RBdigital tab will make use of the OPAC styling for
> consistency (see scree...

[Jeff Davis (jdavis-sitka)]

Very exciting!

Is it safe to say this will build on the existing RBdigital API integration in Evergreen?

For those who wish to have a single integrated result set and/or the ability to show ebook results for non-logged-in patrons, will the current approach (MARC record imports + overlay on EG search results) continue to be supported?

[Terran McCanna (tmccanna)]

Hi Jeff,

This development is completely separate from the existing RBdigital API integration. If libraries wish to import and maintain those bib records in the Evergreen database, then sticking with the existing method and not implementing the new method would be best.

This new approach will work for those of us who do not wish to import those records and who do not want to show materials to patron groups who will not be able to access those materials.

You could theoretically implement both methods if you wished to, but that might be confusing for patrons because they might see different result sets on the regular search results tab than they would on the new RBdigital tab - it would be worth testing once we get to that point, though!

[Terran McCanna (tmccanna)]

Attached are a few screenshots of the progress so far (keep in mind that wording / links / etc. will likely change as progress continues).

[Terran McCanna (tmccanna)]

Jeff - actually, it looks like it *will* be leveraging the existing integration pieces.

[Galen Charlton (gmc)]

A series of patches are available in the collab/gmcharlt/lp1772680_rbdigital_enhancements branch:

http://git.evergreen-ils.org/?p=working/Evergreen.git;a=shortlog;h=refs/heads/collab/gmcharlt/lp1772680_rbdigital_enhancements

This represents code developed primarily by RBDigital for the GADD and PINES project, with some adjustments for master. The pull request is ready for general testing, but a number of tweaks are anticipated before the final 3.2 cutoff.

[Chris Sharp (chrissharp123)]

I'm unable to get this working, first on a realistic PINES test server, then on a stock server. Here's the perl error I'm seeing:

OpenSRF Listener [open-ils.ebook_api]: [ERR :1479:Application.pm:116:] Error loading application_implementation: OpenILS::Application::EbookAPI -> Can't locate object method "json_hint" via package "Fieldmapper::extra::rbdigital_:digital_services" (perhaps you forgot to load "Fieldmapper::extra::rbdigital_:digital_services"?) at /usr/local/share/perl/5.22.1/OpenILS/Utils/Fieldmapper.pm line 228.

And so far I'm unable to track down the problem.

[Terran McCanna (tmccanna)]

Removing pullrequest, as it needs further work.

[Galen Charlton (gmc)]

Sorry about that; I've corrected typos in fm_IDL.xml, rebased against master, and force-pushed to the collab branch.

[Galen Charlton (gmc)]

Force-pushed to collab/gmcharlt/lp1772680_rbdigital_enhancements with some additional updates, including some release notes.

[Jason Stephenson (jstephenson)]

Moved the target to 3.next because this is definitely a new feature.

[Galen Charlton (gmc)]

I've force-pushed to collab/gmcharlt/lp1772680_rbdigital_enhancements again to reflect additional updates.

[Jane Sandberg (sandbergja)]

One quick question about this branch: there appear to be two new files in live_t: 100-ebookapi-rbdigital.t and 101-ebookapi-rbdigital.t. I am all for more automated tests, but I'm wondering if both of these are supposed to be added? One appears to be a more extensive version of the other.

[Jessica Woolford (jwoolford)]

Curious about the state of this development, since RBDigital is no longer going to be a thing. Any plans to transfer the work to the OverDrive APIs?

[Elaine Hardy (ehardy)]

We have reached out to the RB Digital team behind the development for more information and have not received a response.

[Jennifer Pringle (jpringle-u)]

Marked as invalid as RBDigital doesn't exist anymore.