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