]> git.evergreen-ils.org Git - Evergreen.git/blob - docs/RELEASE_NOTES_NEXT/Circulation/standing_penalty_ignore_proximity.txt
08ef46af076f72d9233a971d0a98fdafd33aa539
[Evergreen.git] / docs / RELEASE_NOTES_NEXT / Circulation / standing_penalty_ignore_proximity.txt
1 Standing Penalty Ignore Proximity
2 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
3
4 Standing penalties now have an ignore_proximity field that takes an
5 integer value.  When set, the value of this field represents the
6 proximity from the user's home organizational unit where this penalty
7 will be ignored for purposes of circulation and holds.  Typical values
8 for this field would be 0, 1, or 2 when using a standard hierarchy of
9 Consortium -> System -> Branch -> Sublibrary/Bookmoblie.  A value of 1
10 would cause the penalty to be ignored at the user's home organization
11 unit, it's parent and/or immediate child.  A value of 2 should cause
12 it to be ignored at the above as well as all sibling organizational
13 units to the user's home.  In all cases, a value of zero causes the
14 penalty to be ignored at the user's home and to apply at all other
15 organizational units.  If the value of this field is left unset (or
16 set to a negative value), the penalty will still take effect
17 everywhere using the normal organizational unit and depth values.  If
18 you use a custom hierarchy, you will need to figure out any values
19 greater than 0 on your own.
20
21 The ignore_proximity does not affect where penalties are applied. It
22 is used when determining whether or not a penalty blocks an activity
23 at the current organizational unit or the organizational unit that
24 owns the copy involved in the current transaction.  For instance, if
25 you set the ignore_proximity to 0 on patron exceeds overdue fines,
26 then the patron will still be able to place holds on and checkout
27 copies owned by their home organizational unit at their home
28 organizational unit.  They will not, however, be able to receive
29 copies from other organizational units, nor use other organizational
30 units as a patron.