Docs: Update MARC_RAD_MVF_CRA.adoc for web client
[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 Multi Valued Fields and Composite Record Attributes
9 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
10
11 *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.
12
13 Multi Valued Fields
14 ^^^^^^^^^^^^^^^^^^^
15
16 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).
17
18 image::media/radmvcolumn_1.jpg[]
19
20 To edit an existing record attribute definition and set the *Multi-valued?* field to *True*:
21
22 .  Click *Administration* on the menu bar
23 .  Click *Server Administration*, then click *MARC Record Attributes*
24 .  Double-click on the row of the record attribute definition that needs to be edited
25 .  Select the *Multi-valued?* checkbox
26 .  Click *Save*
27
28 image::media/editrad_2.jpg[]
29
30 Composite Record Attributes
31 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
32
33 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.
34
35 image::media/radcvmcacolumns_3.jpg[]
36
37 Coded Value Maps
38 ^^^^^^^^^^^^^^^^
39
40 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.
41
42 image::media/cvmpage_4.jpg[]
43
44 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*.
45
46 To edit an existing record attribute definition and set the *Composite attribute?* field to True:
47
48 .   Click *Admininstration* on the menu bar
49 .   Click *Server Administration*, then click *MARC Record Attributes*
50 .   Double-click on the row of the record attribute definition that needs to be edited
51 .   Select the *Composite attribute?* checkbox
52 .   Click *Save*
53
54 image::media/radcatrue_5.jpg[]
55
56 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.
57
58 Composite Attribute Entry Definitions
59 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
60
61 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.
62
63 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.
64
65 image::media/caed_6.jpg[]
66
67 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.
68
69 To modify the *Composite Attribute Entry Definition*:
70
71 .  Click *Add Child* for the specific Boolean Operator that needs to be modified, and a new window will open
72 .  Select which *Record Attribute* needs to be represented in the structure under that particular Boolean Operator
73 .  Select the *Attribute Type* from the dropdown options
74 .  Select the *Value* of the Attribute Type from the dropdown options (dropdown options will be based on the Attribute Type selected)
75 .  Click *Submit*
76 .  The *Composite Data Expression* should now include the modification
77 .  Once all modifications have been made, click *Save Changes* on the Composite Attribute Entry Definitions page
78
79 image::media/modifycde_7.jpg[]
80
81 Search and Icon Formats
82 ^^^^^^^^^^^^^^^^^^^^^^^
83
84 Search and Icon Formats
85 +++++++++++++++++++++++
86
87 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.
88
89 In the table below "Icon Format Only" portions of the definition are italicized and in square brackets: [_Icon format only data_] 
90
91 The definitions use the <<anchor-1,fixed field types>> at the end of this document. 
92
93 [width="60%", cols="<,<,<"]
94 |====
95 |*Icon* |*Search Label/Icon Label* |*Definition*
96 |image:media/blu-ray.png[] | Blu-ray | VR Format:s
97 |image:media/book.png[] | All books/Book | Item Type: a,t
98
99 Bib Level: a,c,d,m
100
101 NOT: Item Form: a,b,c,f,o,q,r,s _[,d]_ 
102 |image:media/braille.png[] | Braille |  Item Type: a
103
104 Item Form: f 
105 |image:media/casaudiobook.png[] | Cassette audiobook |  Item Type: i
106
107 SR Format: l 
108 |image:media/casmusic.png[] | Audiocassette music recording | Item Type: j
109
110 SR Format: l 
111 |image:media/cdaudiobook.png[] | CD audiobook | Item Type: i
112
113 SR Format: f 
114 |image:media/cdmusic.png[] | CD music recording | Item Type: j
115
116 SR Format: f 
117 |image:media/dvd.png[] | DVD |  VR Format: v 
118 |image:media/eaudio.png[] | E-audio | Item Type: i
119
120 Item Form: o,q,s 
121 |image:media/ebook.png[]| E-book | Item Type: a,t
122
123 Bib Level: a,c,d,m
124
125 Item Form: o,q,s 
126 |image:media/equip.png[] | Equipment, games, toys |  Item Type: r 
127 |image:media/evideo.png[] | E-video | Item Type: g
128
129 Item Form: o,q,s 
130 |image:media/kit.png[] | Kit |  Item Type: o,p 
131 |image:media/lpbook.png[] | Large print book | Item Type: a,t
132
133 Bib Level: a,c,d,m
134
135 Item Form: d 
136 |image:media/map.png[] | Map |  Item Type: e,f 
137 |image:media/microform.png[] | Microform |  Item Form: a,b,c 
138 |image:media/music.png[] | All music/Music sound recording (unknown format) | Item Type: j
139
140 _[NOT: SR Format: a,b,c,d,e,f,l]_ 
141 |image:media/phonomusic.png[] | Phonograph music recording | Item Type: j
142
143 SR Format: a,b,c,d,e 
144 |image:media/phonospoken.png[] | Phonograph spoken recording | Item Type: i
145
146 SR Format: a,b,c,d,e 
147 |image:media/picture.png[] | Picture | Item type: k
148 |image:media/score.png[] | Music score | Item type: c,d
149 |image:media/serial.png[] | Serials and magazines |  Bib Level: b,s 
150 |image:media/software.png[] | Software and video games |  Item Type: m 
151 |image:media/vhs.png[] | VHS | VR Format: b
152 |====
153
154 [[anchor-2]]
155 Record Types
156 ++++++++++++
157
158 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. 
159
160 [width="30%", cols="<,<,<"]
161 |====
162 | *Record Type* | *LDR 06* | *LDR 07*
163 | BKS | a,t | a,c,d,m
164 | MAP | e,f | a,b,c,d,i,m,s
165 | MIX | p | c,d,i
166 | REC | i,j | a,b,c,d,i,m,s
167 | SCO | c,d | a,b,c,d,i,m,s
168 | SER | a | b,i,s
169 | VIS | g,k,r,o | a,b,c,d,i,m,s
170 |====
171
172 [[anchor-1]]
173 Fixed Field Types
174 +++++++++++++++++
175 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. 
176
177 [width="40%", cols="<,<,<,<"]
178 |====
179 | *Label* | *Record Type* | *Tag* | *Position*
180 |Item Type | ANY | LDR | 06 
181 |Bib Level | ANY | LDR | 07 
182 .14+^.^| Item Format  .2+^.^| BKS | 006 | 06
183 | 008 | 23
184 .2+^.^| MAP | 006 | 12
185 |008 | 29
186 .2+^.^| MIX | 006 | 06
187 | 008 | 23
188 .2+^.^| REC | 006 | 06
189 | 008 | 23
190 .2+^.^| SCO | 006 |06
191 | 008 | 23 
192 .2+^.^| SER | 006 | 06
193 | 008 | 23
194 .2+^.^| VIS | 006 | 12
195 | 008 | 29
196 | SR Format | ANY | 007s | 03 
197 | VR Format | ANY | 007v | 04 
198 |====
199