]> git.evergreen-ils.org Git - Evergreen.git/blob - docs/modules/admin/pages/hold_groups_admin.adoc
Docs: corrections to Hold Groups Admin doc
[Evergreen.git] / docs / modules / admin / pages / hold_groups_admin.adoc
1 [[hold_groups_admin]]
2 = Hold Groups Administration
3
4 indexterm:[Hold Groups]
5
6 There are several administrative elements described below which relate to the xref:circulation:basic_holds.adoc#hold_groups[Hold Groups] feature
7
8 A new Library Setting allows for hold placement times to be randomized
9 among list members for fair distribution. It can be found at *Administration -> Local
10 Administration -> Library Settings Editor -> Randomize group hold
11 order*. If unset this will default to TRUE.
12
13 New Action Triggers allow for Evergreen to generate email or SMS
14 notifications to patrons when a new hold is placed through Hold Groups.
15
16 New tables in the database store the batch place hold events occurring
17 on a particular Hold Group (action.batch_hold_event) and the
18 relationship between the batch hold request and successfully placed
19 holds (action.batch_hold_event_map).
20
21 A new staff permission for MANAGE_BATCH_HOLDS allows applicable users to
22 place and cancel batch holds through Hold Groups.
23
24 A new user bucket type was created for this feature, adding a row in the
25 container.user_bucket_type with a unique code value to segregate new
26 Hold Group user buckets.
27
28 The Hold Group feature relies on the open-ils.circ.holds.create.batch
29 API methods to facilitate the batch creation of holds. A new API method
30 processes the Hold Group user bucket each time a staff user requests it,
31 optionally randomize the hold request creation times, and create a hold
32 request for a specified title for a Hold Group member that does not
33 already have an active hold on that title.