docs/RELEASE_NOTES_NEXT/Circulation/patron-guardian-field.adoc

   1 Patron Parent/Guardian Field
   2 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
   3
   4 Patrons now have a new dedicated parent/guardian field.  This field is
   5 editable in the patron edit interface, displays in the patron
   6 summary side bar on the browser client, and is search-able from the
   7 patron search interface in the browser client.
   8
   9 Patron Editor
  10 +++++++++++++
  11
  12 In addition to the standard "show" and "suggest" visibility settings,
  13 the new guardian field comes with a library setting
  14 'ui.patron.edit.guardian_required_for_juv' ("GUI: Juvenile account
  15 requires parent/guardian").  When this setting is applied, a value
  16 will be required in the patron editor when the juvenile flag is active.
  17
  18 Upgrade Notes
  19 +++++++++++++
  20
  21 Sites who traditionally store parent/guardian information in the
  22 patron 'Secondary Identification' field can migrate values from this
  23 field to the new guardian field with the following SQL:
  24
  25 [source,sql]
  26 -------------------------------------------------------------------------
  27 BEGIN;
  28
  29 -- 1. Find the local ID of the parent/guardian identification type
  30
  31 SELECT * FROM config.identification_type;
  32
  33 -- 2. On my test system, the id is "101".  It will vary!.
  34 -- Migrate the value from the ident2 field to the guardian field.
  35
  36 UPDATE actor.usr
  37     SET guardian = ident_value2
  38 WHERE
  39     ident_type2 = 101 -- !! CHANGE TO SUIT
  40     AND ident_value2 IS NOT NULL
  41     AND ident_value2 <> '';
  42
  43 -- 3. delete the original secondary identification data
  44
  45 UPDATE actor.usr
  46     SET ident_value2 = NULL, ident_type2 = NULL
  47 WHERE
  48     ident_type2 = 101; -- !! CHANGE TO SUIT
  49
  50 COMMIT;
  51 -------------------------------------------------------------------------
  52