Skip to main content
OCLC Support

Discovery 3.0 switchover

Find a checklist of updates required when switching to Discovery 3.0.

 Caution:  Current methods for accessing Discovery (via URL) and all current authentication options will continue to be supported.

There are no changes to NCIP.

Directing users to Discovery from local web pages, Libguides etc.

Update the hostname of the URL you pass to Discovery to point to your Discovery 3.0 hostname

  • This will need to be done if you currently collect and pass through patron credentials from your local web pages into Discovery.
    • e.g. <form action="https://e-zborrow.relaisd2d.com/service-proxy/" method="POST" name="gateway"> ...
             to
      <form action="https://ezb.relaisd2d.com/ ...

 Caution:  Discovery 3.0 does not require/support the method POST so this element will need to be removed from your form code.

Update the entire URL you pass to Discovery to point to your new Discovery 3.0 login page

  • This will need to be done if you currently point your users to a Relais D2D gateway login page
    • e.g.  https://e-zborrow.relaisd2d.com/gateway/library symbol.html
               to
              https://ezb.relaisd2d.com/?LS=library symbol
  • If you direct your users to Discovery via the portal pages you have the option of keeping your URL the same as it is now
    • e.g.     https://e-zborrow.relais-host.com/user/login.html?group=patron&LS=library symbol&dest=discovery
    • OR update it to the corresponding Discovery 3.0 login page which recreates the same behavior as the above URL
                         https://ezb.relaisd2d.com/?LS=library symbol 

Searches redirected from other Discovery environments

Update the URL you pass to Discovery to point to Discovery 3.0

  • This will need to be done if you redirect searches from other Discovery environments using the CCL query parameter directly to your D2D Discovery
  • e.g. https://borrow-direct.relaisd2d.com/service-proxy/?command=mkauth&LS=library symbol&PI=patron id&query=#{complex query}
                           to
                           https://bd.relaisd2d.com/?LS=library symbol&PI=patron id&query=#{complex query}

 Caution:  With Discovery 3.0, when forming the CCL query (query parameter value) all special characters must be percent-encoded as per RFC 3986 URI Generic Syntax. See URL encoding for more details on coding special characters when forming the CCL query. 

Have OCLC Relais update the hostname in your configuration for OpenURL redirects

  • This will need to be done if your redirects send bib parameter information via OpenURL, which we convert to a CCL query to pass to Discovery

3rd party system interaction with Discovery

Update the URL you pass to Discovery in your ILLiad client side addon configuration

  • e.g. https://borrow-direct.relaisd2d.com/service-proxy/?command=mkauth&LS=library symbol&PI=patron id
             to
             https://bd.relaisd2d.com/?LS=library symbol&PI=patron id

NO changes are required for the ILLiad server side addon. The server side addon utilizes the suite of discovery web services on the servers at relais-host.com and those addresses did not change with the hardware migration in the summer of 2018.

Hostname changes

 

D2D group Current Discovery hostname Discovery 3.0 hostname
Borrow Direct https://borrow-direct.relaisd2d.com https://bd.relaisd2d.com
E-ZBorrow     
https://e-zborrow.relaisd2d.com
https://ezb.relaisd2d.com
UBorrow https://uborrow.relaisd2d.com https://ub.relaisd2d.com
Marina https://marina.relaisd2d.com https://maryland.relaisd2d.com
TRLN https://trln-direct.relaisd2d.com https://trln.relaisd2d.com
CCRLS https://ccrls.relaisd2d.com https://chemeketa.relaisd2d.com

 

  • Was this article helpful?