]> git.evergreen-ils.org Git - Evergreen.git/blob - docs/modules/admin/pages/library_groups_admin.adoc
Docs: Library Groups
[Evergreen.git] / docs / modules / admin / pages / library_groups_admin.adoc
1 = Library Groups Administration
2
3 indexterm:[Library Groups,Searching]
4
5 The xref:opac:using_the_public_access_catalog.adoc#library_groups[Library Groups] search feature revives a longstanding internal concept in Evergreen called “Lassos,” which allows an administrator to define a group of organizational units for searching outside of the standard organizational unit hierarchy.
6
7 Use case examples include creating a group of law or science libraries
8 within a university consortium, or grouping all school libraries
9 together within a mixed school/public library.
10
11 == Creating a new Library Group
12
13 To create a new Library Group, you must have the ADMIN_LIBRARY_GROUPS
14 permission. This permission will need to be assigned as needed to staff
15 accounts and/or permission groups by an administrator. No permission
16 groups will have this permission by default.
17
18 Navigate to *Administration -> Server Administration* and select *Library
19 Groups*.
20
21 Select *New Library Group*.
22
23 image::media/new_library_group.png[New Library Group]
24
25 Name your Library Group.
26
27 image::media/new_library_group_2.png[Naming Your New Library Group]
28
29 [NOTE]
30 ==== 
31 If you want the Library Group to be visible at all locations,
32 check the *Global* checkbox. By default this is unchecked and therefore
33 the Library Group will be visible only at locations that belong to the
34 Library Group.
35
36 Global Library Groups should only be used in Consortia using catalogs
37 WITHOUT a locg parameter or its equivalent (org hiding, separate
38 hostnames) to start at a particular context location.
39
40 Consortia that allow all users to search all locations should, as a
41 matter of best practice, make all Library Groups global.
42 ====
43
44 When you are finished, click *Save*.
45
46 Return to *Server Administration* and select *Library Group Maps*.
47
48 . Select *New Library Group Map*.
49 +
50 image::media/new_group_map.png[New Library Group Map]
51 +
52 . Choose a *Library Group* from the dropdown.
53 +
54 image::media/group_map_dropdown.png[Library Group Dropdown]
55 +
56 . Choose an Organizational Unit from the selector.
57 +
58 image::media/group_map_ou_dropdown.png[Organizational Unit Selector]
59 +
60 . Click *Save*.
61
62 Repeat steps 1-4 until all desired Organizational Units are assigned to
63 the Library Group.
64
65 [NOTE]
66 ====
67 Descendant Organizational Units are NOT automatically included
68 and each must be specifically added to the Library Group.
69 ====
70
71 After all Library Groups are created and assigned, you must run autogen and restart Apache in order for the changes to be reflected.