docs/RELEASE_NOTES_2_2.txt

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