]> git.evergreen-ils.org Git - working/Evergreen.git/blob - docs/admin/lsa-statcat.adoc
docs: Statcat updates
[working/Evergreen.git] / docs / admin / lsa-statcat.adoc
1 Statistical Categories Editor
2 -----------------------------
3
4 This is where you configure your statistical categories (stat cats).  Stat cats are a way to save and report on additional information that doesn't fit elsewhere in Evergreen's default records.  It is possible to have stat cats for copies or patrons.
5
6 1. Click *Administration -> Local Administration ->  Statistical Categories Editor.*
7
8 2. To create a new stat cat, enter the name of the category and select either _patron_ or _copy_ from the *Type* dropdown menu. Each category type has a number of options you may set.
9
10 *Copy Statistical Categories*
11
12 Copy stat cats appear in the _Holdings Editor_. You might use copy stat cats to track books you have bought from a specific vendor, or donations.
13
14 An example of the _Create a new statistical category_ controls for copies:
15
16 image::media/lsa-statcat-1.png[Create copy stat cat]
17
18 * _OPAC Visibility_:  Should the category be displayed in the OPAC?
19 * _Required_:  Must the category be assigned a value when editing the item attributes?
20 * _Archive with Circs_:  Should the category and its values for the copy be archived with aged circulation data?
21 * _SIP Field_:  Select the SIP field identifier that will contain the category and its value
22 * _SIP Format_:  Specify the SIP format string
23
24 Some sample copy stat cats:
25
26 image::media/lsa-statcat-2.png[Sample copy stat cats]
27
28 To add an entry, select _Add_.  Due to a known bug, individual entries for stat cats cannot be edited in the web client.  
29
30 Stat cats can be edited or deleted by clicking on _Edit_.  
31
32 This is how the copy stat cats appear in the _Holdings Editor_:
33
34 image::media/lsa-statcat-3.png[Stat cats in Holdings Editor]
35
36 You can use the _Filter by Library_ selector to display copy stat cats owned by a particular library:
37
38 image::media/lsa-statcat-3a.png[Stat cat library selector]
39
40 *Patron Statistical Categories*
41
42 Patron stat cats can be used to keep track of information such as a patron's school affiliation, membership in a group like the Friends of the Library, or patron preferences. They appear in the fourth section of the _Patron Registration_ or _Edit Patron_ screen, under the label _Statistical Categories_.
43
44 An example of the _Create a new statistical category_ controls for patrons:
45
46 image::media/lsa-statcat-4.png[Create patron stat cat]
47
48 * _OPAC Visibility_:  Should the category be displayed in the OPAC?
49 * _Required_:  Must the category be assigned a value when registering a new patron or editing an existing one?
50 * _Archive with Circs_:  Should the category and its values for the patron be archived with aged circulation data?
51 * _Allow Free Text_:  May the person registering/editing the patron information supply their own value for the category?
52 * _Show in Summary_:  Display the category and its value in the patron summary view?
53 * _SIP Field_:  Select the SIP field identifier that will contain the category and its value
54 * _SIP Format_:  Specify the SIP format string
55
56 [WARNING]
57 .WARNING
58 =====================================
59 If you make a category *required* and also *disallow free text*, make sure that you populate an entry list for the category so that the user may select a value.  Failure to do so will result in an unsubmittable patron registration/edit form!
60 =====================================
61
62 Some sample patron stat cats:
63
64 image::media/lsa-statcat-5.png[Sample patron stat cats]
65
66 To add an entry, click on _Add_ in the category row under the _Add Entry_ column:
67
68 image::media/lsa-statcat-6.png[Add patron category entry]  
69
70 Stat cats can be edited or deleted by clicking on _Edit_.  
71
72 Due to a known bug, individual entries for stat cats cannot be edited in the web client.  
73
74 An *organizational unit* (consortium, library system branch library, sub library, etc.) may create their own categories and entries, or supplement categories defined by a higher-level org unit with their own entries.
75
76 An entry can be set as the *default* entry for a category and for an org unit.  If an entry is set as the default, it will be automatically selected in the patron edit screen, provided no other value has been previously set for the patron. Only one default may be set per category for any given org unit.
77
78 Lower-level org unit defaults override defaults set for higher-level org units;  but in the absence of a default set for a given org unit, the nearest parent org unit default will be selected.
79
80 Default entries for the focus location org unit are marked with an asterisk in the entry dropdowns.
81
82 This is how patron stat cats appear in the patron registration/edit screen:
83
84 image::media/lsa-statcat-8.png[Patron stat cats in registration screen]
85
86 The yellow highlight denotes a stat cat that is required, and you will not be allowed to save or create a patron unless a value is entered.
87
88 To remove a stat cat value, select the text in the right-hand box and use your keyboard's backspace or delete key.