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 Administration
  46 ~~~~~~~~~~~~
  47
  48 Custom Org Unit Trees
  49 ^^^^^^^^^^^^^^^^^^^^^
  50 Evergreen enables you to create an organizational tree that describes the systems, branches, or other units that comprise your organization. By default, the org unit tree that appears to patrons in the OPAC is identical to the one that appears to users of the staff client. Using this feature, you can condense or re-order the organizational tree into a simpler structure for patrons using the OPAC while maintaining the complex organizational tree that is available to users of the staff client.
  51
  52 As a further enhancement, you can hide a parental org unit yet still make its child org units visible in the OPAC. In previous versions of Evergreen, child org units inherited the visibility setting of their parents.  Documentation for this feature is available in the Book of Evergreen at http://docs.evergreen-ils.org/2.2/
  53
  54
  55 Fine Accrual on Closed Dates
  56 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  57 By default, fines accrue only on dates that the library is open. This feature enables you to charge patrons fines on dates the library is closed. Fines accrue during scheduled closings as well as during normal weekly closed dates.  Documentation for this feature is available in the Book of Evergreen at http://docs.evergreen-ils.org/2.2/
  58
  59
  60 Target Copies for Holds at Closed Libraries
  61 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  62 By default, when a patron places a hold on a title, the hold targeter will search for copies to fill the hold only at circulating libraries that are open. Copies at closed libraries are not targeted to fill holds. When turned on, this feature enables Evergreen to target copies that have closed circulating libraries to fill holds. Two new org unit settings control this feature.  Documentation for this feature is available in the Book of Evergreen at http://docs.evergreen-ils.org/2.2/
  63
  64
  65 OPAC
  66 ~~
  67
  68 Auto Suggest in Catalog Search
  69 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  70 The auto suggest feature suggests the completion of search terms as the user enters his query.  By default, the user will see ten suggestions although this number is configurable at the database level.  Scroll through suggestions with your mouse, or use the arrow keys to scroll through the suggestions. Select a suggestion to view records that are linked to this suggestion.
  71
  72 This feature is not turned on by default. You must turn it on in the Admin module.  Documentation for this feature is available in the Book of Evergreen at http://docs.evergreen-ils.org/2.2/
  73
  74
  75 Copy Location Groups
  76 ^^^^^^^^^^^^^^^^^^^^
  77 This feature allows staff to create and name sets of copy locations to use as
  78 a search filter in the catalog.  OPAC-visible groups will display within the
  79 library selector in the template toolkit OPAC.  When a user selects a group
  80 and performs a search, the set of results will be limited to records that have
  81 copies in one of the copy locations within the group.  Groups can live at any
  82 level of the library hierarchy and may include copy locations from any parent
  83 org unit or child org unit.
  84
  85 For advanced users, this change includes a new Query Parser filter called
  86 location_groups().
  87
  88 My Lists
  89 ^^^^^^^^
  90 The My Lists feature replaces the bookbag feature that was available in versions proior to 2.2. This feature enables you to create temporary and permanent lists; create and edit notes for items in lists; place holds on items in lists; and share lists via RSS feeds and CSV files.  Documentation for this feature is available in the Book of Evergreen at http://docs.evergreen-ils.org/2.2/
  91
  92 SMS Text Messaging
  93 ^^^^^^^^^^^^^^^^^^
  94 The SMS Text Messaging feature enables users to receive hold notices via text message. Users can opt-in to this hold notification as their default setting for all holds, or they can receive specific hold notifications via text message. Users can also send call numbers and copy locations via text message.  Documentation for this feature is available in the Book of Evergreen at http://docs.evergreen-ils.org/2.2/
  95
  96
  97
  98 Acquisitions
  99 ~~~~~~~~~~
 100
 101 Vandelay Integration into Acquisitions
 102 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 103 The Acquisitions Load MARC Order Record interface enables you to add MARC records to selection lists and purchase orders and upload the records into the catalog. The Vandelay interface enables you to create specific match points between incoming MARC records and exisiting catalog records. Combining these two features enables you to track on order MARC records through the Acquisitions interface and to utilize the record matching mechanisms available in Vandelay when importing acquisitions records.  Documentation for this feature is available in the Book of Evergreen at http://docs.evergreen-ils.org/2.2/
 104
 105
 106 Receive Items from an Invoice
 107 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 108 This feature enables users to receive items from an invoice. Staff can receive individual copies, or they can receive items in batch.  Documentation for this feature is available in the Book of Evergreen at http://docs.evergreen-ils.org/2.2/
 109
 110
 111 Cataloging
 112 ~~~~~~~~
 113
 114 Authority Control Sets
 115 ^^^^^^^^^^^^^^^^^^^^^^
 116 The tags and subfields that display in authority records in Evergreen are proscribed by control sets. The Library of Congress control set is the default control set in all versions of Evergreen. However, in Evergreen release 2.2, you can create customized control sets for authority records, and you can define thesauri and authority fields for these control sets.
 117
 118 Patrons and staff will be able to browse authorities in the OPAC. The following fields are browsable by default: author, series, subject, title, and topic. You will be able to add custom browse axes in addition to these default fields.  Documentation for this feature is available in the Book of Evergreen at http://docs.evergreen-ils.org/2.2/
 119
 120
 121 Batch Importing MARC Records
 122 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 123 The MARC Batch Import interface features improved matching of records and managing of your import queue. In version 2.2, you can specify match points between incoming and existing records to better detect matching records and prevent record duplication. You can also create quality controls to ensure that incoming matching records are superior in quality to existing catalog records.
 124
 125 You also have new options for managing your queue.  You can apply filters to your queue, and you can generate a list of import errors. You can also print your queue, email your queue, or export your queue as a CSV file.  Documentation for this feature is available in the Book of Evergreen at http://docs.evergreen-ils.org/2.2/
 126
 127
 128 Hide Fields in Copy Editor
 129 ^^^^^^^^^^^^^^^^^^^^^^^^^^
 130 Customize the Copy Editor for your staff by hiding fields in the Copy Editor that are not relevant to your staff.  You can set these fields by org unit(s).  Select the top level org unit that will use these settings, and the descendant org units will also recieve these settings.  Documentation for this feature is available in the Book of Evergreen at http://docs.evergreen-ils.org/2.2/
 131
 132
 133 Prevent bibliographic records from having attached copies
 134 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 135 To enable libraries to designate specific sets of records as only for use
 136 as electronic resources, it is possible to configure a bibliographic source
 137 such that physical copies or MFHD records may not be attached to records
 138 from that source. The `config.bib_source` table now includes a new Boolean
 139 column, `can_have_copies`, that controls this behavior. If `can_have_copies`
 140 for a given bibliographic source is `TRUE`, then the staff client will prevent
 141 a cataloger from adding volumes or MFHD records to records belonging to that
 142 source.  Documentation for this feature is available in the Book of Evergreen at http://docs.evergreen-ils.org/2.2/
 143
 144
 145 Overlay Existing Catalog Record via Z39.50 Import
 146 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 147 This feature enables you to replace a catalog record with a record obtained through a Z39.50 search. No new permissions or administrative settings are needed to use this feature.  Documentation for this feature is available in the Book of Evergreen at http://docs.evergreen-ils.org/2.2/
 148
 149
 150 Restrict Z39.50 sources by permission group
 151 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 152 This new feature enables you to use a permission to restrict users' access to Z39.50 servers. You can apply a permission to the Z39.50 servers to restrict access to that server, and then assign that permission to users or groups so that they can access the restricted servers.  Documentation for this feature is available in the Book of Evergreen at http://docs.evergreen-ils.org/2.2/
 153
 154
 155 Switch copy location name and library short name in copy editor
 156 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 157 By default, the copy editor shows the library shortname ('BR1' or 'CONS')
 158 followed by the copy location name ('Stacks', 'Reference').  A new workstation
 159 setting, under *Admin -> Workstation Administration -> Copy Editor: Copy
 160 Location Name First*, enables staff to change the display so that the copy
 161 location name is displayed first, followed by the library shortname. This
 162 may be particularly useful for libraries that have defined one set of copy
 163 locations at the consortial level and want to enable quick keyboard navigation
 164 to copy locations by typing just the first letters of the copy location.  Documentation for this feature is available in the Book of Evergreen at http://docs.evergreen-ils.org/2.2/
 165
 166
 167 User Activity Types
 168 ^^^^^^^^^^^^^^^^^^^
 169 The User Activity Types feature enables you to specify the user activity that you want to record in the database. You can use this feature for reporting purposes. This function will also display a last activity date in a user's account.  Documentation for this feature is available in the Book of Evergreen at http://docs.evergreen-ils.org/2.2/
 170
 171
 172 Authentication proxy
 173 ~~~~~~~~~~~~~~~~~~
 174 To support integration of Evergreen with organizational authentication systems,
 175 and to reduce the proliferation of user names and passwords, Evergreen offers
 176 a new service called `open-ils.auth_proxy`. If you enable the service,
 177 `open-ils.auth_proxy` supports different authentication mechanisms
 178 that implement the `authenticate` method. You can define a chain of these
 179 authentication mechanisms to be tried in order within the `<authenticators>`
 180 element of the `opensrf.xml` configuration file, with the option of falling
 181 back to the `native` mode that uses Evergreen's internal method of password
 182 authentication.
 183
 184 This service only provides authentication; there is no support for automatic
 185 provisioning of accounts. To authenticate against any authentication system,
 186 the user account must first be defined within the Evergreen system, and
 187 authentication will be based on the user name as it exists in Evergreen.
 188
 189 A sample authentication mechanism for LDAP is provided in
 190 `Open-ILS::Application::AuthProxy::LDAP_AUTH`, and corresponding sample
 191 attributes can be found in `opensrf.xml.example`.
 192
 193 Reports
 194 ~~~~~
 195
 196 New views for reporting sources
 197 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 198 To support the creation of collection development reports, the following
 199 reporting sources have been added:
 200
 201   * 'Last Circulation or Creation Date' is a source that offers the copy ID,
 202     the last circulation date or creation date, and the last circulation date
 203   * 'Hold/Copy Ratio per Bib and Pickup Library' is a source that calculates
 204     the number of holds per copy per bibliographic record, with granularity
 205     by pickup library.
 206
 207
 208 Staff Client Navigation
 209 ~~~~~~~~~~~~~~~~~~~~~
 210
 211 Customizable Toolbar
 212 ^^^^^^^^^^^^^^^^^^^^
 213 By default, two toolbars are available in the staff client: circulation and cataloging. This feature enables you to customize toolbars in the staff client. You can add buttons that will enable quick access to a variety of features.  You can create toolbars for specific org unit(s), workstation(s), or login(s).  Documentation for this feature is available in the Book of Evergreen at http://docs.evergreen-ils.org/2.2/
 214
 215
 216 Double Clicking in the Staff Client
 217 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 218 You can search for a patron's record, and double click on a result to access that record. You can double click on an item in the Holdings Maintenance screen to access copy information. The item is linked to the Volume/Copy Creator, if you turned it on in the staff client's org unit settings. If you did not turn on the Volume/Copy Creator, then the item links to the Item Attributes.  Documentation for this feature is available in the Book of Evergreen at http://docs.evergreen-ils.org/2.2/
 219
 220
 221 Recent Staff Searches
 222 ^^^^^^^^^^^^^^^^^^^^^
 223 This feature enables you to view your recent searches as you perform them in the staff client. By default, staff can view then recent searches although the number is configurable.  This feature is only available through the staff client; it is not available to patrons in the OPAC.  Documentation for this feature is available in the Book of Evergreen at http://docs.evergreen-ils.org/2.2/
 224
 225
 226 Return to Search Results from MARC Record
 227 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 228 This feature enables you to return to your title search results directly from any view of the MARC record, including the OPAC View, MARC Record, MARC Edit, and Holdings Maintenance. You can use this feature to page through records in the MARC Record View or Edit interfaces. You do not have to return to the OPAC View to access title results.  Documentation for this feature is available in the Book of Evergreen at http://docs.evergreen-ils.org/2.2/
 229
 230
 231 Sorting Columns
 232 ^^^^^^^^^^^^^^^
 233 This feature enables you to sort display columns so that you can find easily the information that you need on a screen that contains multiple columns. You can sort display columns on any screen that is built on a grid, such as the Check In screen or the On Shelf Pull List.
 234
 235 You can also sort the columns on the following Administration screens: Circulation Policies, Hold Policies, Circulation Limit Sets, Barcode Completion, Acquisitions User Request List, and Vandelay Import Errors.
 236
 237 You can sort items in an ascending or descending order, and you can prioritize the order in which columns will sort. Documentation for this feature is available in the Book of Evergreen at http://docs.evergreen-ils.org/2.2/
 238
 239
 240 Tab Button
 241 ^^^^^^^^^^
 242 This feature enables you to add a new tab to the Evergreen staff client by clicking the + sign adjacent to the tab that you currently have opened. As in previous versions, you can also add new tabs by clicking File -> New Tab, or use the hotkey, Ctrl+T.  Documentation for this feature is available in the Book of Evergreen at http://docs.evergreen-ils.org/2.2/
 243
 244
 245 License
 246 -------
 247 This work is licensed under the Creative Commons Attribution-ShareAlike 3.0
 248 Unported License. To view a copy of this license, visit
 249 http://creativecommons.org/licenses/by-sa/3.0/ or send a letter to Creative
 250 Commons, 444 Castro Street, Suite 900, Mountain View, California, 94041, USA.