]> git.evergreen-ils.org Git - Evergreen.git/blob - docs/cataloging/cataloging_electronic_resources.adoc
Change all docs filenames to .adoc
[Evergreen.git] / docs / cataloging / cataloging_electronic_resources.adoc
1 Cataloging Electronic Resources -- Finding Them in Catalog Searches
2 -------------------------------------------------------------------
3 There are two ways to make electronic resources visible in the catalog without
4 adding copies to the record:
5
6 . Adding a Located URI to the record
7 . Attaching the record to a bib source that is transcendent
8
9 The Located URI approach is useful for Evergreen sites where libraries have
10 access to different electronic resources. The transcendent bib source approach
11 is useful if all libraries have access to the same electronic resources.
12
13 Another difference between the two approaches is that electronic resources with
14 Located URI's never appear in results where the search is limited to a specific
15 copy location(s). In contrast, transcendent electronic resources will appear in
16 results limited to any copy location.
17
18 Adding a Located URI to the Record
19 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
20 A Located URI allows you to add the short name for the owning library to the 856
21 field to indicate which organizational units should be able to find the
22 resource. The owning organizational unit can be a branch, system, or consortium.
23
24 A global flag called _When enabled, Located URIs will provide visibility
25 behavior identical to copies_ will determine where these resources will appear
26 in search results. This flag is available through *Admin* -> *Server
27 Administration* -> *Global Flags*.
28
29 If the _When enabled, Located URIs will provide visibility behavior identical
30 to copies_ flag is set to False (default behavior):
31
32 * When the user's search scope is set at the owning organizational unit or to
33 a child of the owning organizational unit, the record will appear in search
34 results.
35 * When a logged-in user's preferred search library is set to the owning
36 organizational unit or to a child of that owning organizational unit, the record
37 will appear regardless of search scope.
38
39 If the _When enabled, Located URIs will provide visibility behavior identical
40 to copies_ flag is set to True:
41
42 * When the user's search scope is set at the owning organizational unit, at a
43 child of the owning organizational unit, or at a parent of the owning
44 organizational unit, the record will appear in search results.
45 * When a logged-in user's preferred search library is set to the owning
46 organizational unit, to a child of the owning organizational unit, or to a
47 parent (with the exception of the consortium) of the owning organizational unit,
48 the record will appear regardless of search scope.
49
50
51 To add a located URI to the record:
52
53 . Open the record in _MARC Edit_
54 . Add a subfield 9 to the 856 field of the record and enter the short name of 
55 the organizational unit for the value. Make sure there is a 4 entered as the
56 first indicator and a 0 entered as the second indicator. 
57 For example:
58 +
59 '856 40 $u http://lwn.net $y Linux Weekly News $9 BR1'
60 +
61 would make this item visible to people searching in a library scope of BR1 or to
62 logged-in users who have set BR1 as their preferred search library.
63 +
64 [NOTE]
65 If multiple organizational units own the resource, you can enter more than one
66 subfield 9 to the 856 field or you can enter multiple 856 fields with a subfield
67 9 to the record 
68 +
69 . Save the record
70
71 Located URI Example 1
72 ^^^^^^^^^^^^^^^^^^^^^
73
74 The _When enabled, Located URIs will provide visibility behavior identical to
75 copies_ flag is set to False (default behavior)
76
77 The Record has two 856 fields: one with SYS1 in subfield 9 and the other with 
78 BR4 in subfield 9
79
80 * Any user searching SYS1 or any of its children (BR1, BR2, SL1) will find the 
81 record. These users will only see the URL belonging to SYS1.
82 * Any user searching BR4 will find the record. These users will only see the
83 URL belonging to BR4.
84 * A user searching SYS2 will NOT find the record because SYS2 is a parent of
85 an owning org unit, not a child. The same thing happens if the user is searching
86 the consortium. In this case, the system assumes the user is unlikely to
87 have access to this resource and therefore does not retrieve it.
88 * A logged-in user with a preferred search library of BR4 will find the record
89 at any search scope. This user will see the URL belonging to BR4. Because this
90 user previously identified a preference for using this library, the system
91 assumes the user is likely to have access to this resource.
92 * A logged-in user with a preferred search library of BR4 who is searching SYS1
93 or any of its children will also retrieve the record. In this case, the user
94 will see both URLs, the one belonging to SYS1 because the search library matches
95 or is a child of the owning organizational unit and the one belonging to BR4
96 because it matches or is a child of the preferred search library. The URL
97 belonging to the search library (if it is an exact match, not a child) will sort
98 to the top.
99
100 Located URI Example 2
101 ^^^^^^^^^^^^^^^^^^^^^
102
103 The _When enabled, Located URIs will provide visibility behavior identical to
104 copies_ flag is set to True
105
106 The Record has two 856 fields: one with SYS1 in subfield 9 and the other with
107 BR4 in subfield 9
108
109 * Any user searching SYS1 or any of its children (BR1, BR2, SL1) will find the
110 record. These users will only see the URL belonging to SYS1.
111 * Any user searching BR4 will find the record. These users will only see the
112 URL belonging to BR4.
113 * Any user searching the consortium will find the record. These users will see
114 both URLs in the record. In this case, the system sees this user as a potential
115 user of SYS2 or BR4 and therefore offers them the option of accessing the
116 resource through either URL.
117 * A user searching SYS2 will find the record because SYS2 is a parent of
118 an owning org unit. The user will see the URL belonging to BR4. Once again, 
119 the system sees this user as a potential user of BR4 and therefore offers
120 them the option of accessing this resource. 
121 * A user searching BR3 will NOT find the record because BR3 is neither a child
122 nor a parent of an owning organizational unit.
123 * A logged-in user with a preferred search library of BR4 who is searching BR3
124 will find the record. This user will see the URL belonging to BR4. Because this
125 user previously identified a preference for using this library, the system
126 assumes the user is likely to have access to this resource.
127 * A logged-in user with a preferred search library of BR4 who is searching SYS1
128 or any of its children will also retrieve the record. In this case, the user
129 will see both URLs, the one belonging to SYS1 because the search library matches
130 or is a child of the owning organizational unit and the one belonging to BR4
131 because it matches or is a child of the preferred search library. The URL
132 belonging to the search library (if it is an exact match, not a child) will sort
133 to the top.
134
135 Using Transcendent Bib Sources for Electronic Resources
136 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
137 Connecting a bib record to a transcendent bib source will make the record
138 visible in search results regardless of the user's search scope.
139
140 To start, you need to create a transcendent bib source by adding it to
141 'config.bib_source' in the Evergreen database and setting the _transcendant_ 
142 field to true. For example:
143
144 +# INSERT INTO config.bib_source(quality, source, transcendant, can_have_copies)
145 VALUES (50, `ebooks', TRUE, FALSE);+
146
147 [NOTE]
148 If you want to allow libraries to add copies to these records, set the
149 _can_have_copies_ field to _TRUE_. If you want to prevent libraries from adding
150 copies to these records, set the _can_have_copies_ field to _FALSE_.
151
152 When adding or uploading bib records for electronic resources, set the
153 bibliographic source for the record to the newly-created transcendent
154 bibliographic source. Using the staff client, the bibliographic source can be
155 selected in the _MARC Batch Import_ interface when importing new, non-matching
156 records or in the _MARC Edit_ interface when editing existing records.
157
158