Docs: configuring fixed field dropdown menus
[Evergreen.git] / docs / admin / MARC_RAD_MVF_CRA.adoc
1 MARC Record Attributes
2 ----------------------
3
4 The MARC Record Attribute Definitions support the ingesting, indexing, searching, filtering, and delivering of bibliographic record attributes.
5
6 To Access the MARC Record Attributes, click *Administration* -> *Server Administration* ->  *MARC Record Attributes*
7
8 Managing Fixed Field Drop-down Context Menus
9 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
10
11 indexterm:[Fixed fields]
12 indexterm:[MARC editor,configuring]
13
14 The MARC Editor includes Fixed Field Drop-down Context Menus, which make it easier for catalogers to select the right values for fixed fields
15 in both Bibliographic and Authority records.  You can use the MARC Record Attributes interface to modify these dropdowns to make them better
16 suited for catalogers in your consortium.
17
18 To edit these menus, you can follow these steps:
19
20 . Click *Administration -> Server Administration -> MARC Record Attributes*.
21 . If there's not already a dropdown for your fixed field, click *New Attr. Definition* and fill out the form using other fixed field
22 attribute definitions as a model.
23 . If you can find an attribute definition for your fixed field in the list, click the "Manage" link in the Coded Value Maps column.
24 . Click *New Map*.
25 . In the SVF Attribute field, type the name of the Attribute you identified in steps 2-3.
26 . In the code field, type the actual value that will go into the fixed field (typically 1-4 characters).  You can add an option to keep that fixed field empty by typing a space into this field.
27 . In the value field, type the short description you'd like your catalogers to see in the dropdown menu.
28 . Optional: add a longer description of this value in the Description field.
29 . Check the OPAC Visible checkbox.
30
31
32
33 Multi Valued Fields and Composite Record Attributes
34 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
35
36 *Multi Valued Fields* and *Composite Record Attributes* expands upon the Record Attribute Definitions feature to include capturing all occurrences of multi-valued elements in a record. *Multi Valued Fields* allows users to say that a bibliographic record contains multiple entries for a particular record attribute. *Composite Record Attributes* supports the application of a more complicated and nested form of structure to a record attribute definition.
37
38 Multi Valued Fields
39 ^^^^^^^^^^^^^^^^^^^
40
41 Multi Valued Fields allows for the capturing of multi-valued elements of a bibliographic record. Through the use of Multi Valued Fields, Evergreen recognizes that records are capable of storing multiple values. Multi Valued Fields are represented in the Record Attribute Definitions interface by a column named *Multi-valued?*. With *Multi-valued?* set to *True*, Evergreen will recognize the bibliographic records in the database that have multiple values mapping to the record attribute definition; it will also track and search on those values in the catalog. This feature will be particularly handy for bibliographic records representing a Blu-ray / DVD combo pack, since both format types can be displayed in the OPAC (if both formats were cataloged in the record).
42
43 image::media/radmvcolumn_1.jpg[]
44
45 To edit an existing record attribute definition and set the *Multi-valued?* field to *True*:
46
47 .  Click *Administration* on the menu bar
48 .  Click *Server Administration*, then click *MARC Record Attributes*
49 .  Double-click on the row of the record attribute definition that needs to be edited
50 .  Select the *Multi-valued?* checkbox
51 .  Click *Save*
52
53 image::media/editrad_2.jpg[]
54
55 Composite Record Attributes
56 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
57
58 Composite Record Attributes build on top of Evergreen’s ability to support record attributes that contain multiple entries. The Composite Record Attributes feature enables administrators to take a record attribute definition and apply a more complicated and nested form of structure to that particular record attribute. Two new Record Attribute Definitions columns have been added to facilitate the management of the Composite Record Attributes. The *Composite attribute?* column designates whether or not a particular record attribute definition is also a composite record attribute. The *Coded Value Maps* column contains a *Manage* link in each row that allows users to manage the Coded Value Maps for the record attributes.
59
60 image::media/radcvmcacolumns_3.jpg[]
61
62 Coded Value Maps
63 ^^^^^^^^^^^^^^^^
64
65 To manage the Coded Value Maps of a particular record attribute definition, click the *Manage* link located under the Coded Value Maps column for that record attribute. This will open the Coded Value Maps interface. What administrators see on the Coded Value Maps screen does not define the structure of the composite record attribute; they must go into the *Composite Attribute Entry Definitions* screen to view this information.
66
67 image::media/cvmpage_4.jpg[]
68
69 Within the Coded Value Maps screen, there is a column named *Composite Definition*. The *Composite Definition* column contains a *Manage* link that allows users to configure and to edit Composite Record Attribute definitions. In order to enable the *Manage* link (i.e. have the *Manage* link display as an option under the *Composite Definition* column), the *Composite attribute?* column (located back in the Record Attributes Definition page) must be set to *True*.
70
71 To edit an existing record attribute definition and set the *Composite attribute?* field to True:
72
73 .   Click *Administration* on the menu bar
74 .   Click *Server Administration*, then click *MARC Record Attributes*
75 .   Double-click on the row of the record attribute definition that needs to be edited
76 .   Select the *Composite attribute?* checkbox
77 .   Click *Save*
78
79 image::media/radcatrue_5.jpg[]
80
81 Now that the *Composite attribute?* value is set to *True*, click on the *Manage* link located under the *Coded Value Maps* column for the edited record attribute definition. Back in the Coded Value Maps screen, a *Manage* link should now be exposed under the *Composite Definition* column. Clicking on a specific coded value’s *Manage* link will take the user into the *Composite Attribute Entry Definitions* screen for that specified coded value.
82
83 Composite Attribute Entry Definitions
84 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
85
86 The Composite Attribute Entry Definitions screen is where administrators can locally define and edit Composite Record Attributes for specific coded values. For example: administrators can further refine and distinguish the way a “book” should be defined within their database, by bringing together the right combination of attributes together to truly define what a “book” is in their database.
87
88 The top of the Composite Attribute Entry Definitions screen shows a parenthetically defined view of the *Composite Data Expression*. Below the Composite Data Expression is the *Composite Data Tree*. The Composite Data Tree is structured off of Boolean Operators, including the support of NOT operations. This nested form can be as deeply defined as it needs to be within the site’s database.
89
90 image::media/caed_6.jpg[]
91
92 To modify the *Composite Attribute Entry Definition*, any Boolean Operator can be deleted or have a coded value appended to it. The appended coded value can be any number of Coded Value Maps from any other Record Attribute Definition. So, administrators can choose from all the other existing record attribute definitions and create new nested structures to define entirely new data types.
93
94 To modify the *Composite Attribute Entry Definition*:
95
96 .  Click *Add Child* for the specific Boolean Operator that needs to be modified, and a new window will open
97 .  Select which *Record Attribute* needs to be represented in the structure under that particular Boolean Operator
98 .  Select the *Attribute Type* from the dropdown options
99 .  Select the *Value* of the Attribute Type from the dropdown options (dropdown options will be based on the Attribute Type selected)
100 .  Click *Submit*
101 .  The *Composite Data Expression* should now include the modification
102 .  Once all modifications have been made, click *Save Changes* on the Composite Attribute Entry Definitions page
103
104 image::media/modifycde_7.jpg[]
105
106 Search and Icon Formats
107 ^^^^^^^^^^^^^^^^^^^^^^^
108
109 Search and Icon Formats
110 +++++++++++++++++++++++
111
112 The table below shows all the search and icon formats. In some cases they vary slightly, with the icon format being more restrictive. This is so that things such as a search for "All Books" will include Large Print books yet Large Print books will not show both a "Book" and "Large Print Book" icon.
113
114 In the table below "Icon Format Only" portions of the definition are italicized and in square brackets: [_Icon format only data_] 
115
116 The definitions use the <<anchor-1,fixed field types>> at the end of this document. 
117
118 [width="60%", cols="<,<,<"]
119 |====
120 |*Icon* |*Search Label/Icon Label* |*Definition*
121 |image:media/blu-ray.png[] | Blu-ray | VR Format:s
122 |image:media/book.png[] | All books/Book | Item Type: a,t
123
124 Bib Level: a,c,d,m
125
126 NOT: Item Form: a,b,c,f,o,q,r,s _[,d]_ 
127 |image:media/braille.png[] | Braille |  Item Type: a
128
129 Item Form: f 
130 |image:media/casaudiobook.png[] | Cassette audiobook |  Item Type: i
131
132 SR Format: l 
133 |image:media/casmusic.png[] | Audiocassette music recording | Item Type: j
134
135 SR Format: l 
136 |image:media/cdaudiobook.png[] | CD audiobook | Item Type: i
137
138 SR Format: f 
139 |image:media/cdmusic.png[] | CD music recording | Item Type: j
140
141 SR Format: f 
142 |image:media/dvd.png[] | DVD |  VR Format: v 
143 |image:media/eaudio.png[] | E-audio | Item Type: i
144
145 Item Form: o,q,s 
146 |image:media/ebook.png[]| E-book | Item Type: a,t
147
148 Bib Level: a,c,d,m
149
150 Item Form: o,q,s 
151 |image:media/equip.png[] | Equipment, games, toys |  Item Type: r 
152 |image:media/evideo.png[] | E-video | Item Type: g
153
154 Item Form: o,q,s 
155 |image:media/kit.png[] | Kit |  Item Type: o,p 
156 |image:media/lpbook.png[] | Large print book | Item Type: a,t
157
158 Bib Level: a,c,d,m
159
160 Item Form: d 
161 |image:media/map.png[] | Map |  Item Type: e,f 
162 |image:media/microform.png[] | Microform |  Item Form: a,b,c 
163 |image:media/music.png[] | All music/Music sound recording (unknown format) | Item Type: j
164
165 _[NOT: SR Format: a,b,c,d,e,f,l]_ 
166 |image:media/phonomusic.png[] | Phonograph music recording | Item Type: j
167
168 SR Format: a,b,c,d,e 
169 |image:media/phonospoken.png[] | Phonograph spoken recording | Item Type: i
170
171 SR Format: a,b,c,d,e 
172 |image:media/picture.png[] | Picture | Item type: k
173 |image:media/score.png[] | Music score | Item type: c,d
174 |image:media/serial.png[] | Serials and magazines |  Bib Level: b,s 
175 |image:media/software.png[] | Software and video games |  Item Type: m 
176 |image:media/vhs.png[] | VHS | VR Format: b
177 |====
178
179 [[anchor-2]]
180 Record Types
181 ++++++++++++
182
183 This table shows the record types currently used in determining elements of search and icon formats. They are based on a combination of the MARC Record Type (LDR 06) and Bibliographic Level (LDR 07) fixed fields. 
184
185 [width="30%", cols="<,<,<"]
186 |====
187 | *Record Type* | *LDR 06* | *LDR 07*
188 | BKS | a,t | a,c,d,m
189 | MAP | e,f | a,b,c,d,i,m,s
190 | MIX | p | c,d,i
191 | REC | i,j | a,b,c,d,i,m,s
192 | SCO | c,d | a,b,c,d,i,m,s
193 | SER | a | b,i,s
194 | VIS | g,k,r,o | a,b,c,d,i,m,s
195 |====
196
197 [[anchor-1]]
198 Fixed Field Types
199 +++++++++++++++++
200 This table details the fixed field types currently used for determining search and icon formats. See the <<anchor-2,record types>> section above for how the system determines them. 
201
202 [width="40%", cols="<,<,<,<"]
203 |====
204 | *Label* | *Record Type* | *Tag* | *Position*
205 |Item Type | ANY | LDR | 06 
206 |Bib Level | ANY | LDR | 07 
207 .14+^.^| Item Format  .2+^.^| BKS | 006 | 06
208 | 008 | 23
209 .2+^.^| MAP | 006 | 12
210 |008 | 29
211 .2+^.^| MIX | 006 | 06
212 | 008 | 23
213 .2+^.^| REC | 006 | 06
214 | 008 | 23
215 .2+^.^| SCO | 006 |06
216 | 008 | 23 
217 .2+^.^| SER | 006 | 06
218 | 008 | 23
219 .2+^.^| VIS | 006 | 12
220 | 008 | 29
221 | SR Format | ANY | 007s | 03 
222 | VR Format | ANY | 007v | 04 
223 |====
224