docs/admin/hold_driven_recalls.adoc

   1 Hold-driven recalls
   2 ===================
   3
   4 indexterm:[hold-driven recalls]
   5 indexterm:[circulation, recalls, hold-driven]
   6
   7 In academic libraries, it is common for groups like faculty and graduate
   8 students to have extended loan periods (for example, 120 days), while
   9 others have more common loan periods such as 3 weeks. In these environments,
  10 it is desirable to have a hold placed on an item that has been loaned out
  11 for an extended period to trigger a 'recall', which:
  12
  13   . Truncates the loan period
  14   . Sets the remaining available renewals to 0
  15   . 'Optionally': Changes the fines associated with overdues for the new due
  16     date
  17   . 'Optionally': Notifies the current patron of the recall, including the
  18     new due date and fine level
  19
  20 Enabling hold-driven recalls
  21 ----------------------------
  22
  23 By default, holds do not trigger recalls. To enable hold-driven recalls
  24 of circulating items, library settings must be changed as follows:
  25
  26   . Click *Administration* -> *Local Administration* ->  *Library Settings Editor.*
  27   . Set the *Recalls: Circulation duration that triggers a recall
  28     (recall threshold)* setting. The recall threshold is specified as an
  29     interval (for example, "21 days"); any items with a loan duration of
  30     less that this interval are not considered for a recall.
  31   . Set the *Recalls: Truncated loan period (return interval)* setting.
  32     The return interval is specified as an interval (for example, "7 days").
  33     The due date on the recalled item is changed to be the greater of either
  34     the recall threshold or the return interval.
  35   . 'Optionally': Set the *Recalls: An array of fine amount, fine interval,
  36     and maximum fine* setting. If set, this applies the specified fine rules
  37     to the current circulation period for the recalled item.
  38
  39 When a hold is placed and no available copies are found by the hold targeter,
  40 the recall logic checks to see if the recall threshold and return interval
  41 settings are set; if so, then the hold targeter checks the currently
  42 checked-out copies to determine if any of the currently circulating items at
  43 the designated pickup library have a loan duration longer than the recall
  44 threshold. If so, then the eligible item with the due date nearest to the
  45 current date is recalled.
  46
  47 Editing the item recall notification email template
  48 ---------------------------------------------------
  49 The template for the item recall notification email is contained in the
  50 'Item Recall Email Notice' template, found under *Administration* -> *Local
  51 Administration* -> *Notifications / Action Triggers*.