Docs: documenting copy locations
[Evergreen.git] / docs / admin / copy_locations.adoc
1 Administering copy locations
2 ----------------------------
3
4 Creating new copy locations
5 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
6
7 . Click _Administration_.
8 . Click _Local Administration_.
9 . Click _Copy Locations Editor_.
10 . Type the name of the copy location.
11 . In _OPAC Visible_, choose whether you would like items in this copy location
12   to appear in the catalog.
13 . In _Hold Verify_, 
14 . In _Checkin Alert_, choose whether you would like a routing alert to appear
15   when a copy in this location is checked in. This is intended for special
16   locations, such as 'Display', that may require special handling, or that
17   temporarily contain items that are not normally in that location.
18 +
19 NOTE: By default, these alerts will only display when a copy is checked in, _not_
20 when it is used to record an in-house use.
21 +
22 To also display these alerts when a copy in your location is scanned for in-house
23 use, go to Administration > Local Administration > Library Settings Editor and
24 set _Display copy location check in alert for in-house-use_ to True.
25 +
26 . If you would like a prefix or suffix to be added to the call numbers of every
27   volume in this location, enter it.
28 . If you would like, add a URL to the _URL_ field.  When a URL is entered in
29   this field, the associated copy location will display as a link in the Public
30   Catalog summary display. This link can be useful for retrieving maps or other
31   directions to the copy location to aid users in finding material.
32 . If you would like to override any copy-level circulation/hold policies to
33   make sure that copies in your new location can't circulate or be holdable,
34   choose _No_ in the appropriate field.  If you choose _Yes_, Evergreen will
35   use the typical circulation and hold policies to determine circulation
36   abilities.
37
38 Deleting copy locations
39 ~~~~~~~~~~~~~~~~~~~~~~~
40
41 You may only delete a copy location if:
42 . it doesn't contain any copies, or
43 . it only contains deleted copies.
44
45 Evergreen preserves copy locations in the database, so no statistical information
46 is lost when a copy location is deleted.
47
48 Modifying copy location order
49 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
50
51 . Go to _Administration_.
52 . Go to _Local Administration_.
53 . Click _Copy Location Order_.
54 . Drag and drop the locations until you are satisfied with their order.
55 . Click _Apply changes_.
56
57
58 Copy location groups
59 ~~~~~~~~~~~~~~~~~~~~
60
61 .Use case
62 ****
63 Mayberry Public Library provides a scope allowing users to search for all
64 children's materials in their library. The library's children's scope
65 incorporates several copy locations used at the library, including Picture
66 Books, Children's Fiction, Children's Non-Fiction, Easy Readers, and Children's
67 DVDs. The library also builds a similar scope for YA materials that incorporates
68 several copy locations.
69 ****
70
71 This feature allows staff to create and name sets of copy locations to use as
72 a search filter in the catalog.  OPAC-visible groups will display within the
73 library selector in the Public Catalog.  When a user selects a group
74 and performs a search, the set of results will be limited to records that have
75 copies in one of the copy locations within the group.  Groups can live at any
76 level of the library hierarchy and may include copy locations from any parent
77 org unit or child org unit.
78
79 NOTE: To work with Copy Location Groups, you will need the ADMIN_COPY_LOCATION_GROUP
80 permission.
81
82 Create a Copy Location Group
83 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
84
85 . Click Administration ->  Local Administration -> Copy Location Groups.
86 . At the top of the screen is a drop down menu that displays the org unit tree.
87   Select the unit within the org tree to which you want to add a copy location group.
88   The copy locations associated with the org unit appear in the Copy Locations column.
89 . In the column called _Location Groups_, click _New_.
90 . Choose how you want the copy location group to display to patrons in the catalog's
91   org unit tree in the OPAC. By default, when you add a new copy location group, the
92   group displays in the org unit tree beneath any branches or sub-libraries of its
93   parental org unit.  If you check the box adjacent to Display above orgs, then the
94   group will appear above the branches or sub-libraries of its parental org unit.
95 . To make the copy location group visible to users searching the public catalog, check
96   the box adjacent to Is OPAC visible?
97 . Enter a _Name_ for the copy location group.
98 . Click Save. The name of the Copy Location Group appears in the Location Groups.
99 . Select the copy locations that you want to add to the group, and click Add. The copy
100   locations will populate the middle column, Group Entries.
101 . The copy location group is now visible in the org unit tree in the catalog. Search
102   the catalog to retrieve results from any of the copy locations that you added to
103   the copy location group.
104
105 Order Copy Location Groups
106 ^^^^^^^^^^^^^^^^^^^^^^^^^^
107
108 If you create more than one copy location group, then you can order the groups in the
109 org unit tree.
110
111 . Click Administration -> Local Administration -> Copy Location Groups.
112 . Three icons appear next to each location group. Click on the icons to drag the copy
113   location groups into the order in which you would like them to appear in the catalog.
114 . Search the catalog to view the reorder of the copy location groups.
115