]> git.evergreen-ils.org Git - working/Evergreen.git/blob - docs/RELEASE_NOTES_2_2.txt
036eef91733738a20e0559376e035ab1d5acca01
[working/Evergreen.git] / 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 Cataloging
77 ~~~~~~~~~~
78
79 Prevent bibliographic records from having attached copies
80 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
81 To enable libraries to designate specific sets of records as only for use
82 as electronic resources, it is possible to configure a bibliographic source
83 such that physical copies or MFHD records may not be attached to records
84 from that source. The `config.bib_source` table now includes a new Boolean
85 column, `can_have_copies`, that controls this behavior. If `can_have_copies`
86 for a given bibliographic source is `TRUE`, then the staff client will prevent
87 a cataloger from adding volumes or MFHD records to records belonging to that
88 source.
89
90 Switch copy location name and library short name in copy editor
91 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
92 By default, the copy editor shows the library shortname ('BR1' or 'CONS')
93 followed by the copy location name ('Stacks', 'Reference').  A new workstation
94 setting, under *Admin -> Workstation Administration -> Copy Editor: Copy
95 Location Name First*, enables staff to change the display so that the copy
96 location name is displayed first, followed by the library shortname. This
97 may be particularly useful for libraries that have defined one set of copy
98 locations at the consortial level and want to enable quick keyboard navigation
99 to copy locations by typing just the first letters of the copy location.
100
101 Reports
102 ~~~~~~~
103
104 New views for reporting sources
105 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
106 To support the creation of collection development reports, the following
107 reporting sources have been added:
108
109   * 'Last Circulation or Creation Date' is a source that offers the copy ID,
110     the last circulation date or creation date, and the last circulation date
111   * 'Hold/Copy Ratio per Bib and Pickup Library' is a source that calculates
112     the number of holds per copy per bibliographic record, with granularity
113     by pickup library.
114
115 License
116 -------
117 This work is licensed under the Creative Commons Attribution-ShareAlike 3.0
118 Unported License. To view a copy of this license, visit
119 http://creativecommons.org/licenses/by-sa/3.0/ or send a letter to Creative
120 Commons, 444 Castro Street, Suite 900, Mountain View, California, 94041, USA.