docs/RELEASE_NOTES_2_2.txt

   1 Release notes
   2 =============
   3
   4 Upgrade notes
   5 -------------
   6
   7 Located URI search scope
   8 ~~~~~~~~~~~~~~~~~~~~~~~~
   9 Recognizing that electronic resources are often licensed for an entire library
  10 system rather than just a single library, the search scope for located URIs has
  11 changed to match from the highest point in the hierarchy down, rather than from
  12 the bottom up. In previous releases of Evergreen, if you had a MARC record with
  13 a URI located at 'BR1', a search for that record at the 'SYS1' scope would
  14 include the record in its results. The current release of Evergreen would not
  15 include the record in its results; the scope needs to be set at the level of
  16 'BR1' in the hierarchy or below.
  17
  18 Therefore, you may want to run a SQL statement like the following, edited to
  19 match the short names of your branches and systems, to change the located
  20 URIs so that searches at the system level continue to return results for
  21 located URIs:
  22
  23 ------------------------------------------------------------------------------
  24 UPDATE biblio.record_entry
  25     SET marc = replace(
  26         replace(
  27             marc,
  28             '<subfield code="9">BR1</subfield>',
  29             '<subfield code="9">SYS1</subfield>'
  30         ),
  31         '<subfield code="9">BR3</subfield>',
  32         '<subfield code="9">SYS2</subfield>'
  33     ) WHERE marc LIKE '<subfield code="9">BR1</subfield>'
  34         OR marc LIKE '<subfield code="9">BR3</subfield>'
  35 ;
  36 ------------------------------------------------------------------------------
  37
  38 Z39.50 server definitions
  39 ~~~~~~~~~~~~~~~~~~~~~~~~~
  40 Z39.50 server target definitions have been removed from the sample
  41 `opensrf.xml.example` file. To migrate existing settings from your
  42 `opensrf.xml` configuration file to the database, peform the
  43 following steps:
  44
  45     1. First, set up your custom Z39.50 sources in the database. For
  46       each entry in `z3950/services`, map the following XML paths to the
  47       corresponding `config.z3950_source` table column as follows:
  48 +
  49       ** `z3950/services/<entry>` = name
  50       ** `//<entry>/name` = label
  51       ** `//<entry>/host` = host
  52       ** `//<entry>/port` = port
  53       ** `//<entry>/db` = db
  54       ** `//<entry>/record_format` = record_format
  55       ** `//<entry>/transmission_format` = transmission_format
  56 +
  57     2. Then, for each attribute defined in the `<attrs>` element for
  58        a given service, map the following XML paths to the corresponding
  59        `config.z3950_attr` table column as follows:
  60 +
  61       ** `z3950/services/<entry>` = source
  62       ** `//<entry>/attrs/<attr>` = name
  63       ** `//<entry>/attrs/<attr>/code` = code
  64       ** `//<entry>/attrs/<attr>/format` = format
  65 +
  66     3. After adding the new Z39.50 sources and corresponding attributes,
  67        you will need to log out of the staff client and log back into the
  68        staff client to retrieve the new entry values. If a given Z39.50
  69        server does not work for a given attribute, pay attention to the
  70        `truncation` column for the attribute.
  71
  72
  73 New features
  74 ------------
  75
  76 OPAC
  77 ~~~~
  78
  79 Copy Location Groups
  80 ^^^^^^^^^^^^^^^^^^^^
  81 This feature allows staff to create and name sets of copy locations to use as
  82 a search filter in the catalog.  OPAC-visible groups will display within the
  83 library selector in the template toolkit OPAC.  When a user selects a group
  84 and performs a search, the set of results will be limited to records that have
  85 copies in one of the copy locations within the group.  Groups can live at any
  86 level of the library hierarchy and may include copy locations from any parent
  87 org unit or child org unit.
  88
  89 For advanced users, this change includes a new Query Parser filter called
  90 location_groups().
  91
  92 Cataloging
  93 ~~~~~~~~~~
  94
  95 Prevent bibliographic records from having attached copies
  96 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  97 To enable libraries to designate specific sets of records as only for use
  98 as electronic resources, it is possible to configure a bibliographic source
  99 such that physical copies or MFHD records may not be attached to records
 100 from that source. The `config.bib_source` table now includes a new Boolean
 101 column, `can_have_copies`, that controls this behavior. If `can_have_copies`
 102 for a given bibliographic source is `TRUE`, then the staff client will prevent
 103 a cataloger from adding volumes or MFHD records to records belonging to that
 104 source.
 105
 106 Switch copy location name and library short name in copy editor
 107 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 108 By default, the copy editor shows the library shortname ('BR1' or 'CONS')
 109 followed by the copy location name ('Stacks', 'Reference').  A new workstation
 110 setting, under *Admin -> Workstation Administration -> Copy Editor: Copy
 111 Location Name First*, enables staff to change the display so that the copy
 112 location name is displayed first, followed by the library shortname. This
 113 may be particularly useful for libraries that have defined one set of copy
 114 locations at the consortial level and want to enable quick keyboard navigation
 115 to copy locations by typing just the first letters of the copy location.
 116
 117 Authentication proxy
 118 ~~~~~~~~~~~~~~~~~~~~
 119 To support integration of Evergreen with organizational authentication systems,
 120 and to reduce the proliferation of user names and passwords, Evergreen offers
 121 a new service called `open-ils.auth_proxy`. If you enable the service,
 122 `open-ils.auth_proxy` supports different authentication mechanisms
 123 that implement the `authenticate` method. You can define a chain of these
 124 authentication mechanisms to be tried in order within the `<authenticators>`
 125 element of the `opensrf.xml` configuration file, with the option of falling
 126 back to the `native` mode that uses Evergreen's internal method of password
 127 authentication.
 128
 129 This service only provides authentication; there is no support for automatic
 130 provisioning of accounts. To authenticate against any authentication system,
 131 the user account must first be defined within the Evergreen system, and
 132 authentication will be based on the user name as it exists in Evergreen.
 133
 134 A sample authentication mechanism for LDAP is provided in
 135 `Open-ILS::Application::AuthProxy::LDAP_AUTH`, and corresponding sample
 136 attributes can be found in `opensrf.xml.example`.
 137
 138 Reports
 139 ~~~~~~~
 140
 141 New views for reporting sources
 142 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 143 To support the creation of collection development reports, the following
 144 reporting sources have been added:
 145
 146   * 'Last Circulation or Creation Date' is a source that offers the copy ID,
 147     the last circulation date or creation date, and the last circulation date
 148   * 'Hold/Copy Ratio per Bib and Pickup Library' is a source that calculates
 149     the number of holds per copy per bibliographic record, with granularity
 150     by pickup library.
 151
 152 License
 153 -------
 154 This work is licensed under the Creative Commons Attribution-ShareAlike 3.0
 155 Unported License. To view a copy of this license, visit
 156 http://creativecommons.org/licenses/by-sa/3.0/ or send a letter to Creative
 157 Commons, 444 Castro Street, Suite 900, Mountain View, California, 94041, USA.