]> git.evergreen-ils.org Git - Evergreen.git/blob - docs/modules/cataloging/pages/record_buckets.adoc
Docs: fix antora build asciidoc warnings
[Evergreen.git] / docs / modules / cataloging / pages / record_buckets.adoc
1 = Record Buckets =
2 :toc:
3
4 == Introduction ==
5
6 Record buckets are containers for MARC records. Once records are in a bucket, you can take
7 various types of actions, including:
8
9 * Editing all the records at once using the MARC Batch Editor.
10 * Deleting all the records in the bucket.
11 * Merging all the records in the bucket.
12 * Downloading the MARC files for all records in the bucket, so you can edit them in another
13 program like http://marcedit.reeset.net[MARCEdit].
14
15 == Creating Record Buckets ==
16
17 . Click on _Cataloging_ -> _Record Buckets_.
18 . On the _Buckets_ menu, click _New Bucket_.
19 . Give the bucket a name and (optionally) a description.
20
21 == Adding Records to a Bucket ==
22
23 === From the Record Bucket Interface ===
24 . Click on _Cataloging_ -> _Record Buckets_.
25 . On the _Buckets_ menu, choose the bucket that you'd like to add records to.
26 . Go to the _Record Query_ tab.
27 . Enter your query into the _Record Query_ box.
28 . Select the records you would like to add.
29 . On the _Actions_ menu, click _Add to Bucket_.
30
31 .Advanced record queries
32 ****
33
34 The _Record Query_ tab allows some advanced search functionality through the use of search keys,
35 which can be combined with one another.
36
37 .Record Bucket search keys
38 [options="header"]
39 |===================
40 |Search key           |Abbreviated version |Usage example               |Description
41 |author:              |au:                 |au:Anzaldua                 |An author, creator, or contributor
42 |available:           |                    |available:yes               |Limits to available items. There is no way to limit to _unavailable_ items
43 |keyword:             |kw:                 |kw:Schirmer                 |A keyword
44 |lang:                |                    |lang:Spanish                |A language
45 |series:              |se:                 |se:avatar last airbender    |A series title
46 |site:                |                    |site:LIB3                   |The shortname of the library/system/consortium you'd like to search
47 |subject:             |su:                 |su:open source software     |A subject
48 |subject\|geographic: |                    |subject\|geographic:Uruguay |A geographic subject
49 |title:               |ti:                 |ti:Harry Potter             |Title proper or alternate title
50 |title\|proper:       |                    |title\|proper:Harry Potter  |Title proper taken from 245
51 |===================
52
53 You can combine these in the same query, e.g. `ti:borderlands au:anzaldua available:yes`.  However -- with the exception of the _lang_ search key,
54 you should not repeat the same search key twice.
55
56 ****
57
58 [TIP]
59 You can use the same boolean operator symbols that are used in the OPAC (_||_ for boolean OR, _&&_ for boolean AND, and _-_ for boolean NOT).
60
61
62 == Bibliographic Record Merging and Overlay ==
63
64 Catalogers can merge or overlay records in record buckets or using records obtained from a Z39.50 service.
65
66 === Merge Records in Record Buckets ===
67
68 . Click *Cataloging>Record Buckets*.
69 . Create and/or select a record bucket.
70 . Select the records that you want to merge, and click *Actions>Merge Selected Records*.
71 +
72 image::media/marcoverlay1.png[]
73 +
74 . The Merge Selected Records interface appears.
75 . The records to be merged appear on the right side of the screen.  Click *Use as Lead Record* to select a lead record from those that need to be merged.
76 +
77 image::media/marcoverlay2.png[]
78 +
79 . Select a merge profile from the drop down box.
80 +
81 image::media/marcoverlay3.png[]
82 +
83 . After you select the profile, you can preview the changes that will be made to the record.
84 +
85 image::media/marcoverlay4.png[]
86 +
87 . You can change the merge profile at any time; after doing so, the result of the merge will be recalculated. The merge result will also be recalculated after editing the lead record, changing which record is to be used as lead, or removing a record from consideration.
88 . When you are satisfied that you have selected the correct merge profile, click the *Merge* button in the bottom right corner.
89 . Note that merge profiles that contain a preserve field specification are not available to be chosen in this interface, as they would have the effect of reversing which bibliographic record is considered the target of the merge.
90
91 === Track Record Merges ===
92
93 When 2 or more bib records are merged in a record bucket, all records involved are stamped with a new merge_date value. For any bib record, this field indicates the last time it was involved in a merge. At the same time, all subordinate records (i.e. those deleted as a product of the merge) are stamped with a merged_to value indicating which bib record the source record was merged with.
94
95 In the browser client bib record display, a warning alert now appears along the top of the page (below the Deleted alert) indicating when a record was used in a merge, when it was merged, and which record it was merge with, rendered as a link to the target record.
96
97 image::media/merge_tracking.png[merge message with date]
98
99 === Merge Records Using Z39.50 ===
100
101 . Search for a record in the catalog that you want to overlay.
102 . Select the record, and click *MARC View*.
103 . Select *Mark for: Overlay Target*.
104 +
105 image::media/marcoverlay5.png[]
106 +
107 . Click *Cataloging>Import Record from Z39.50*.
108 . Search for the lead record that you want to overlay within the Z39.50 interface.
109 . Select the desired record, and click *Overlay*.
110 +
111 image::media/marcoverlay6.png[]
112 +
113 . The record that you have targeted to be overlaid, and the new record, appear side by side.
114 +
115 image::media/marcoverlay7.png[]
116 +
117 . You can edit the lead record before you overlay the target. To edit the record, click the *Edit Z39.50 Record* button above the lead record.
118 . The MARC editor will appear.  You can make your changes in the MARC editor, or you can select the *Flat Text Editor* to make changes.  After you have edited the record, click *Modify* in the top right corner, and then *Use Edits* in the bottom right corner. Note that the record you are editing is the version from the Z39.50 server not including any changes that would be made as a result of applying the selected merge file.
119 . You will return to the side-by-side comparison of the records and then can proceed with the overlay.
120 . Once you are satisfied with the record that you want to overlay, select a merge profile from the drop down box, *Choose merge profile*.
121 . Click *Overlay*. The overlay will occur, and you will be taken back to the Z39.50 interface.
122 . Note that the staff client remembers the last merge overlay profile that you selected, so the next time that you open the interface, it will default to that profile.  Simply change the profile to make a different selection.
123 . Also note when the merge profile is applied, the Z39.50 record acts as the target of the merge. For example, if your merge profile adds 650 fields, those 650 fields are brought over from the record that already exists in the Evergreen database (i.e., the one that you are overlaying from Z39.50).
124 . Also note that merge profiles that contain a preserve field specification are not available to be chosen in this interface, as they would have the effect of reversing which bibliographic record is considered the target of the merge.
125
126 === New Admin Settings ===
127
128 . Go to *Admin>Local Administration>Library Settings Editor>Upload Default Merge Profile (Z39.50 and Record Buckets)*.
129 . Select a default merge profile, and *click Update Setting*.  The merge profiles that appear in this drop down box are those that are created in *MARC Batch Import/Export*.  Note that catalogers will only see merge profiles that are allowed by their org unit and permissions.