2 * Copyright (C) 2008 Equinox Software, Inc.
3 * Bill Erickson <erickson@esilibrary.com>
5 * This program is free software; you can redistribute it and/or
6 * modify it under the terms of the GNU General Public License
7 * as published by the Free Software Foundation; either version 2
8 * of the License, or (at your option) any later version.
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
17 CREATE OR REPLACE FUNCTION actor.usr_merge_rows( table_name TEXT, col_name TEXT, src_usr INT, dest_usr INT ) RETURNS VOID AS $$
24 sel := 'SELECT id::BIGINT FROM ' || table_name || ' WHERE ' || quote_ident(col_name) || ' = ' || quote_literal(src_usr);
25 upd := 'UPDATE ' || table_name || ' SET ' || quote_ident(col_name) || ' = ' || quote_literal(dest_usr) || ' WHERE id = ';
26 del := 'DELETE FROM ' || table_name || ' WHERE id = ';
27 FOR cur_row IN EXECUTE sel LOOP
29 --RAISE NOTICE 'Attempting to merge % %', table_name, cur_row.id;
30 EXECUTE upd || cur_row.id;
31 EXCEPTION WHEN unique_violation THEN
32 --RAISE NOTICE 'Deleting conflicting % %', table_name, cur_row.id;
33 EXECUTE del || cur_row.id;
39 COMMENT ON FUNCTION actor.usr_merge_rows(TEXT, TEXT, INT, INT) IS $$
40 Attempts to move each row of the specified table from src_user to dest_user.
41 Where conflicts exist, the conflicting "source" row is deleted.
45 CREATE OR REPLACE FUNCTION actor.usr_merge( src_usr INT, dest_usr INT, del_addrs BOOLEAN, del_cards BOOLEAN, deactivate_cards BOOLEAN ) RETURNS VOID AS $$
54 -- do some initial cleanup
55 UPDATE actor.usr SET card = NULL WHERE id = src_usr;
56 UPDATE actor.usr SET mailing_address = NULL WHERE id = src_usr;
57 UPDATE actor.usr SET billing_address = NULL WHERE id = src_usr;
61 DELETE FROM actor.card where usr = src_usr;
63 IF deactivate_cards THEN
64 UPDATE actor.card SET active = 'f' WHERE usr = src_usr;
66 UPDATE actor.card SET usr = dest_usr WHERE usr = src_usr;
71 DELETE FROM actor.usr_address WHERE usr = src_usr;
73 UPDATE actor.usr_address SET usr = dest_usr WHERE usr = src_usr;
76 UPDATE actor.usr_note SET usr = dest_usr WHERE usr = src_usr;
77 -- dupes are technically OK in actor.usr_standing_penalty, should manually delete them...
78 UPDATE actor.usr_standing_penalty SET usr = dest_usr WHERE usr = src_usr;
79 PERFORM actor.usr_merge_rows('actor.usr_org_unit_opt_in', 'usr', src_usr, dest_usr);
80 PERFORM actor.usr_merge_rows('actor.usr_setting', 'usr', src_usr, dest_usr);
83 PERFORM actor.usr_merge_rows('permission.usr_perm_map', 'usr', src_usr, dest_usr);
84 PERFORM actor.usr_merge_rows('permission.usr_object_perm_map', 'usr', src_usr, dest_usr);
85 PERFORM actor.usr_merge_rows('permission.usr_grp_map', 'usr', src_usr, dest_usr);
86 PERFORM actor.usr_merge_rows('permission.usr_work_ou_map', 'usr', src_usr, dest_usr);
91 -- For each *_bucket table: transfer every bucket belonging to src_usr
92 -- into the custody of dest_usr.
94 -- In order to avoid colliding with an existing bucket owned by
95 -- the destination user, append the source user's id (in parenthesese)
96 -- to the name. If you still get a collision, add successive
97 -- spaces to the name and keep trying until you succeed.
101 FROM container.biblio_record_entry_bucket
102 WHERE owner = src_usr
104 suffix := ' (' || src_usr || ')';
107 UPDATE container.biblio_record_entry_bucket
108 SET owner = dest_usr, name = name || suffix
109 WHERE id = bucket_row.id;
110 EXCEPTION WHEN unique_violation THEN
111 suffix := suffix || ' ';
120 FROM container.call_number_bucket
121 WHERE owner = src_usr
123 suffix := ' (' || src_usr || ')';
126 UPDATE container.call_number_bucket
127 SET owner = dest_usr, name = name || suffix
128 WHERE id = bucket_row.id;
129 EXCEPTION WHEN unique_violation THEN
130 suffix := suffix || ' ';
139 FROM container.copy_bucket
140 WHERE owner = src_usr
142 suffix := ' (' || src_usr || ')';
145 UPDATE container.copy_bucket
146 SET owner = dest_usr, name = name || suffix
147 WHERE id = bucket_row.id;
148 EXCEPTION WHEN unique_violation THEN
149 suffix := suffix || ' ';
158 FROM container.user_bucket
159 WHERE owner = src_usr
161 suffix := ' (' || src_usr || ')';
164 UPDATE container.user_bucket
165 SET owner = dest_usr, name = name || suffix
166 WHERE id = bucket_row.id;
167 EXCEPTION WHEN unique_violation THEN
168 suffix := suffix || ' ';
175 UPDATE container.user_bucket_item SET target_user = dest_usr WHERE target_user = src_usr;
178 -- transfer queues the same way we transfer buckets (see above)
182 WHERE owner = src_usr
184 suffix := ' (' || src_usr || ')';
187 UPDATE vandelay.queue
188 SET owner = dest_usr, name = name || suffix
189 WHERE id = queue_row.id;
190 EXCEPTION WHEN unique_violation THEN
191 suffix := suffix || ' ';
199 PERFORM actor.usr_merge_rows('money.collections_tracker', 'usr', src_usr, dest_usr);
200 PERFORM actor.usr_merge_rows('money.collections_tracker', 'collector', src_usr, dest_usr);
201 UPDATE money.billable_xact SET usr = dest_usr WHERE usr = src_usr;
202 UPDATE money.billing SET voider = dest_usr WHERE voider = src_usr;
203 UPDATE money.bnm_payment SET accepting_usr = dest_usr WHERE accepting_usr = src_usr;
206 UPDATE action.circulation SET usr = dest_usr WHERE usr = src_usr;
207 UPDATE action.circulation SET circ_staff = dest_usr WHERE circ_staff = src_usr;
208 UPDATE action.circulation SET checkin_staff = dest_usr WHERE checkin_staff = src_usr;
210 UPDATE action.hold_request SET usr = dest_usr WHERE usr = src_usr;
211 UPDATE action.hold_request SET fulfillment_staff = dest_usr WHERE fulfillment_staff = src_usr;
212 UPDATE action.hold_request SET requestor = dest_usr WHERE requestor = src_usr;
213 UPDATE action.hold_notification SET notify_staff = dest_usr WHERE notify_staff = src_usr;
215 UPDATE action.in_house_use SET staff = dest_usr WHERE staff = src_usr;
216 UPDATE action.non_cataloged_circulation SET staff = dest_usr WHERE staff = src_usr;
217 UPDATE action.non_cataloged_circulation SET patron = dest_usr WHERE patron = src_usr;
218 UPDATE action.non_cat_in_house_use SET staff = dest_usr WHERE staff = src_usr;
219 UPDATE action.survey_response SET usr = dest_usr WHERE usr = src_usr;
222 UPDATE acq.fund_allocation SET allocator = dest_usr WHERE allocator = src_usr;
223 UPDATE acq.fund_transfer SET transfer_user = dest_usr WHERE transfer_user = src_usr;
225 -- transfer picklists the same way we transfer buckets (see above)
229 WHERE owner = src_usr
231 suffix := ' (' || src_usr || ')';
235 SET owner = dest_usr, name = name || suffix
236 WHERE id = picklist_row.id;
237 EXCEPTION WHEN unique_violation THEN
238 suffix := suffix || ' ';
245 UPDATE acq.purchase_order SET owner = dest_usr WHERE owner = src_usr;
246 UPDATE acq.po_note SET creator = dest_usr WHERE creator = src_usr;
247 UPDATE acq.po_note SET editor = dest_usr WHERE editor = src_usr;
248 UPDATE acq.provider_note SET creator = dest_usr WHERE creator = src_usr;
249 UPDATE acq.provider_note SET editor = dest_usr WHERE editor = src_usr;
250 UPDATE acq.lineitem_note SET creator = dest_usr WHERE creator = src_usr;
251 UPDATE acq.lineitem_note SET editor = dest_usr WHERE editor = src_usr;
252 UPDATE acq.lineitem_usr_attr_definition SET usr = dest_usr WHERE usr = src_usr;
255 UPDATE asset.copy SET creator = dest_usr WHERE creator = src_usr;
256 UPDATE asset.copy SET editor = dest_usr WHERE editor = src_usr;
257 UPDATE asset.copy_note SET creator = dest_usr WHERE creator = src_usr;
258 UPDATE asset.call_number SET creator = dest_usr WHERE creator = src_usr;
259 UPDATE asset.call_number SET editor = dest_usr WHERE editor = src_usr;
260 UPDATE asset.call_number_note SET creator = dest_usr WHERE creator = src_usr;
263 UPDATE serial.record_entry SET creator = dest_usr WHERE creator = src_usr;
264 UPDATE serial.record_entry SET editor = dest_usr WHERE editor = src_usr;
267 -- It's not uncommon to define the reporter schema in a replica
268 -- DB only, so don't assume these tables exist in the write DB.
270 UPDATE reporter.template SET owner = dest_usr WHERE owner = src_usr;
271 EXCEPTION WHEN undefined_table THEN
275 UPDATE reporter.report SET owner = dest_usr WHERE owner = src_usr;
276 EXCEPTION WHEN undefined_table THEN
280 UPDATE reporter.schedule SET runner = dest_usr WHERE runner = src_usr;
281 EXCEPTION WHEN undefined_table THEN
285 -- transfer folders the same way we transfer buckets (see above)
288 FROM reporter.template_folder
289 WHERE owner = src_usr
291 suffix := ' (' || src_usr || ')';
294 UPDATE reporter.template_folder
295 SET owner = dest_usr, name = name || suffix
296 WHERE id = folder_row.id;
297 EXCEPTION WHEN unique_violation THEN
298 suffix := suffix || ' ';
304 EXCEPTION WHEN undefined_table THEN
308 -- transfer folders the same way we transfer buckets (see above)
311 FROM reporter.report_folder
312 WHERE owner = src_usr
314 suffix := ' (' || src_usr || ')';
317 UPDATE reporter.report_folder
318 SET owner = dest_usr, name = name || suffix
319 WHERE id = folder_row.id;
320 EXCEPTION WHEN unique_violation THEN
321 suffix := suffix || ' ';
327 EXCEPTION WHEN undefined_table THEN
331 -- transfer folders the same way we transfer buckets (see above)
334 FROM reporter.output_folder
335 WHERE owner = src_usr
337 suffix := ' (' || src_usr || ')';
340 UPDATE reporter.output_folder
341 SET owner = dest_usr, name = name || suffix
342 WHERE id = folder_row.id;
343 EXCEPTION WHEN unique_violation THEN
344 suffix := suffix || ' ';
350 EXCEPTION WHEN undefined_table THEN
354 -- Finally, delete the source user
355 DELETE FROM actor.usr WHERE id = src_usr;
360 COMMENT ON FUNCTION actor.usr_merge(INT, INT, BOOLEAN, BOOLEAN, BOOLEAN) IS $$
361 Merges all user date from src_usr to dest_usr. When collisions occur,
362 keep dest_usr's data and delete src_usr's data.
366 CREATE OR REPLACE FUNCTION actor.usr_purge_data(
368 specified_dest_usr IN INTEGER
372 renamable_row RECORD;
376 IF specified_dest_usr IS NULL THEN
377 dest_usr := 1; -- Admin user on stock installs
379 dest_usr := specified_dest_usr;
385 mailing_address = NULL,
386 billing_address = NULL
390 UPDATE acq.fund_allocation SET allocator = dest_usr WHERE allocator = src_usr;
391 UPDATE acq.lineitem SET creator = dest_usr WHERE creator = src_usr;
392 UPDATE acq.lineitem SET editor = dest_usr WHERE editor = src_usr;
393 UPDATE acq.lineitem SET selector = dest_usr WHERE selector = src_usr;
394 UPDATE acq.lineitem_note SET creator = dest_usr WHERE creator = src_usr;
395 UPDATE acq.lineitem_note SET editor = dest_usr WHERE editor = src_usr;
396 DELETE FROM acq.lineitem_usr_attr_definition WHERE usr = src_usr;
398 -- Update with a rename to avoid collisions
402 WHERE owner = src_usr
404 suffix := ' (' || src_usr || ')';
408 SET owner = dest_usr, name = name || suffix
409 WHERE id = renamable_row.id;
410 EXCEPTION WHEN unique_violation THEN
411 suffix := suffix || ' ';
418 UPDATE acq.picklist SET creator = dest_usr WHERE creator = src_usr;
419 UPDATE acq.picklist SET editor = dest_usr WHERE editor = src_usr;
420 UPDATE acq.po_note SET creator = dest_usr WHERE creator = src_usr;
421 UPDATE acq.po_note SET editor = dest_usr WHERE editor = src_usr;
422 UPDATE acq.purchase_order SET owner = dest_usr WHERE owner = src_usr;
423 UPDATE acq.purchase_order SET creator = dest_usr WHERE creator = src_usr;
424 UPDATE acq.purchase_order SET editor = dest_usr WHERE editor = src_usr;
425 UPDATE acq.claim_event SET creator = dest_usr WHERE creator = src_usr;
428 DELETE FROM action.circulation WHERE usr = src_usr;
429 UPDATE action.circulation SET circ_staff = dest_usr WHERE circ_staff = src_usr;
430 UPDATE action.circulation SET checkin_staff = dest_usr WHERE checkin_staff = src_usr;
431 UPDATE action.hold_notification SET notify_staff = dest_usr WHERE notify_staff = src_usr;
432 UPDATE action.hold_request SET fulfillment_staff = dest_usr WHERE fulfillment_staff = src_usr;
433 UPDATE action.hold_request SET requestor = dest_usr WHERE requestor = src_usr;
434 DELETE FROM action.hold_request WHERE usr = src_usr;
435 UPDATE action.in_house_use SET staff = dest_usr WHERE staff = src_usr;
436 UPDATE action.non_cat_in_house_use SET staff = dest_usr WHERE staff = src_usr;
437 DELETE FROM action.non_cataloged_circulation WHERE patron = src_usr;
438 UPDATE action.non_cataloged_circulation SET staff = dest_usr WHERE staff = src_usr;
439 DELETE FROM action.survey_response WHERE usr = src_usr;
440 UPDATE action.fieldset SET owner = dest_usr WHERE owner = src_usr;
443 DELETE FROM actor.card WHERE usr = src_usr;
444 DELETE FROM actor.stat_cat_entry_usr_map WHERE target_usr = src_usr;
446 -- The following update is intended to avoid transient violations of a foreign
447 -- key constraint, whereby actor.usr_address references itself. It may not be
448 -- necessary, but it does no harm.
449 UPDATE actor.usr_address SET replaces = NULL
450 WHERE usr = src_usr AND replaces IS NOT NULL;
451 DELETE FROM actor.usr_address WHERE usr = src_usr;
452 DELETE FROM actor.usr_note WHERE usr = src_usr;
453 UPDATE actor.usr_note SET creator = dest_usr WHERE creator = src_usr;
454 DELETE FROM actor.usr_org_unit_opt_in WHERE usr = src_usr;
455 UPDATE actor.usr_org_unit_opt_in SET staff = dest_usr WHERE staff = src_usr;
456 DELETE FROM actor.usr_setting WHERE usr = src_usr;
457 DELETE FROM actor.usr_standing_penalty WHERE usr = src_usr;
458 UPDATE actor.usr_standing_penalty SET staff = dest_usr WHERE staff = src_usr;
461 UPDATE asset.call_number SET creator = dest_usr WHERE creator = src_usr;
462 UPDATE asset.call_number SET editor = dest_usr WHERE editor = src_usr;
463 UPDATE asset.call_number_note SET creator = dest_usr WHERE creator = src_usr;
464 UPDATE asset.copy SET creator = dest_usr WHERE creator = src_usr;
465 UPDATE asset.copy SET editor = dest_usr WHERE editor = src_usr;
466 UPDATE asset.copy_note SET creator = dest_usr WHERE creator = src_usr;
469 DELETE FROM auditor.actor_usr_address_history WHERE id = src_usr;
470 DELETE FROM auditor.actor_usr_history WHERE id = src_usr;
471 UPDATE auditor.asset_call_number_history SET creator = dest_usr WHERE creator = src_usr;
472 UPDATE auditor.asset_call_number_history SET editor = dest_usr WHERE editor = src_usr;
473 UPDATE auditor.asset_copy_history SET creator = dest_usr WHERE creator = src_usr;
474 UPDATE auditor.asset_copy_history SET editor = dest_usr WHERE editor = src_usr;
475 UPDATE auditor.biblio_record_entry_history SET creator = dest_usr WHERE creator = src_usr;
476 UPDATE auditor.biblio_record_entry_history SET editor = dest_usr WHERE editor = src_usr;
479 UPDATE biblio.record_entry SET creator = dest_usr WHERE creator = src_usr;
480 UPDATE biblio.record_entry SET editor = dest_usr WHERE editor = src_usr;
481 UPDATE biblio.record_note SET creator = dest_usr WHERE creator = src_usr;
482 UPDATE biblio.record_note SET editor = dest_usr WHERE editor = src_usr;
485 -- Update buckets with a rename to avoid collisions
488 FROM container.biblio_record_entry_bucket
489 WHERE owner = src_usr
491 suffix := ' (' || src_usr || ')';
494 UPDATE container.biblio_record_entry_bucket
495 SET owner = dest_usr, name = name || suffix
496 WHERE id = renamable_row.id;
497 EXCEPTION WHEN unique_violation THEN
498 suffix := suffix || ' ';
507 FROM container.call_number_bucket
508 WHERE owner = src_usr
510 suffix := ' (' || src_usr || ')';
513 UPDATE container.call_number_bucket
514 SET owner = dest_usr, name = name || suffix
515 WHERE id = renamable_row.id;
516 EXCEPTION WHEN unique_violation THEN
517 suffix := suffix || ' ';
526 FROM container.copy_bucket
527 WHERE owner = src_usr
529 suffix := ' (' || src_usr || ')';
532 UPDATE container.copy_bucket
533 SET owner = dest_usr, name = name || suffix
534 WHERE id = renamable_row.id;
535 EXCEPTION WHEN unique_violation THEN
536 suffix := suffix || ' ';
545 FROM container.user_bucket
546 WHERE owner = src_usr
548 suffix := ' (' || src_usr || ')';
551 UPDATE container.user_bucket
552 SET owner = dest_usr, name = name || suffix
553 WHERE id = renamable_row.id;
554 EXCEPTION WHEN unique_violation THEN
555 suffix := suffix || ' ';
562 DELETE FROM container.user_bucket_item WHERE target_user = src_usr;
565 DELETE FROM money.billable_xact WHERE usr = src_usr;
566 DELETE FROM money.collections_tracker WHERE usr = src_usr;
567 UPDATE money.collections_tracker SET collector = dest_usr WHERE collector = src_usr;
570 DELETE FROM permission.usr_grp_map WHERE usr = src_usr;
571 DELETE FROM permission.usr_object_perm_map WHERE usr = src_usr;
572 DELETE FROM permission.usr_perm_map WHERE usr = src_usr;
573 DELETE FROM permission.usr_work_ou_map WHERE usr = src_usr;
576 -- Update with a rename to avoid collisions
580 FROM reporter.output_folder
581 WHERE owner = src_usr
583 suffix := ' (' || src_usr || ')';
586 UPDATE reporter.output_folder
587 SET owner = dest_usr, name = name || suffix
588 WHERE id = renamable_row.id;
589 EXCEPTION WHEN unique_violation THEN
590 suffix := suffix || ' ';
596 EXCEPTION WHEN undefined_table THEN
601 UPDATE reporter.report SET owner = dest_usr WHERE owner = src_usr;
602 EXCEPTION WHEN undefined_table THEN
606 -- Update with a rename to avoid collisions
610 FROM reporter.report_folder
611 WHERE owner = src_usr
613 suffix := ' (' || src_usr || ')';
616 UPDATE reporter.report_folder
617 SET owner = dest_usr, name = name || suffix
618 WHERE id = renamable_row.id;
619 EXCEPTION WHEN unique_violation THEN
620 suffix := suffix || ' ';
626 EXCEPTION WHEN undefined_table THEN
631 UPDATE reporter.schedule SET runner = dest_usr WHERE runner = src_usr;
632 EXCEPTION WHEN undefined_table THEN
637 UPDATE reporter.template SET owner = dest_usr WHERE owner = src_usr;
638 EXCEPTION WHEN undefined_table THEN
642 -- Update with a rename to avoid collisions
646 FROM reporter.template_folder
647 WHERE owner = src_usr
649 suffix := ' (' || src_usr || ')';
652 UPDATE reporter.template_folder
653 SET owner = dest_usr, name = name || suffix
654 WHERE id = renamable_row.id;
655 EXCEPTION WHEN unique_violation THEN
656 suffix := suffix || ' ';
662 EXCEPTION WHEN undefined_table THEN
667 -- Update with a rename to avoid collisions
671 WHERE owner = src_usr
673 suffix := ' (' || src_usr || ')';
676 UPDATE vandelay.queue
677 SET owner = dest_usr, name = name || suffix
678 WHERE id = renamable_row.id;
679 EXCEPTION WHEN unique_violation THEN
680 suffix := suffix || ' ';
690 COMMENT ON FUNCTION actor.usr_purge_data(INT, INT) IS $$
691 Finds rows dependent on a given row in actor.usr and either deletes them
692 or reassigns them to a different user.
697 CREATE OR REPLACE FUNCTION actor.usr_delete(
702 old_profile actor.usr.profile%type;
703 old_home_ou actor.usr.home_ou%type;
704 new_profile actor.usr.profile%type;
705 new_home_ou actor.usr.home_ou%type;
707 new_dob actor.usr.dob%type;
710 id || '-PURGED-' || now(),
724 -- Quit if no such user
726 IF old_profile IS NULL THEN
730 perform actor.usr_purge_data( src_usr, dest_usr );
732 -- Find the root grp_tree and the root org_unit. This would be simpler if we
733 -- could assume that there is only one root. Theoretically, someday, maybe,
734 -- there could be multiple roots, so we take extra trouble to get the right ones.
741 permission.grp_ancestors( old_profile )
750 actor.org_unit_ancestors( old_home_ou )
754 -- Truncate date of birth
756 IF new_dob IS NOT NULL THEN
757 new_dob := date_trunc( 'year', new_dob );
764 profile = new_profile,
767 passwd = random()::text,
772 FROM config.identification_type
777 net_access_level = DEFAULT,
780 first_given_name = new_name,
781 second_given_name = NULL,
782 family_name = new_name,
786 evening_phone = NULL,
788 mailing_address = NULL,
789 billing_address = NULL,
790 home_ou = new_home_ou,
793 master_account = DEFAULT,
794 super_user = DEFAULT,
799 claims_returned_count = DEFAULT,
800 credit_forward_balance = DEFAULT,
801 last_xact_id = DEFAULT,
802 alert_message = NULL,
810 COMMENT ON FUNCTION actor.usr_delete(INT, INT) IS $$
811 Logically deletes a user. Removes personally identifiable information,
812 and purges associated data in other tables.
817 CREATE OR REPLACE FUNCTION actor.approve_pending_address(pending_id INT) RETURNS BIGINT AS $$
821 SELECT INTO old_id replaces FROM actor.usr_address where id = pending_id;
822 IF old_id IS NULL THEN
823 UPDATE actor.usr_address SET pending = 'f' WHERE id = pending_id;
826 -- address replaces an existing address
827 DELETE FROM actor.usr_address WHERE id = -old_id;
828 UPDATE actor.usr_address SET id = -id WHERE id = old_id;
829 UPDATE actor.usr_address SET replaces = NULL, id = old_id, pending = 'f' WHERE id = pending_id;
834 COMMENT ON FUNCTION actor.approve_pending_address(INT) IS $$
835 Replaces an address with a pending address. This is done by giving the pending
836 address the ID of the old address. The replaced address is retained with -id.
839 CREATE OR REPLACE FUNCTION container.clear_expired_circ_history_items(
843 -- Delete old circulation bucket items for a specified user.
844 -- "Old" means older than the interval specified by a
845 -- user-level setting, if it is so specified.
848 threshold TIMESTAMP WITH TIME ZONE;
851 IF ac_usr IS NULL THEN
854 -- Determine the threshold date that defines "old". Subtract the
855 -- interval from the system date, then truncate to midnight.
859 now() - CAST( translate( value, '"', '' ) AS INTERVAL )
867 AND name = 'patron.max_reading_list_interval';
869 IF threshold is null THEN
870 -- No interval defined; don't delete anything
871 -- RAISE NOTICE 'No interval defined for user %', ac_usr;
875 -- RAISE NOTICE 'Date threshold: %', threshold;
877 -- Threshold found; do the delete
878 delete from container.copy_bucket_item
885 container.copy_bucket
888 and btype = 'circ_history'
890 and create_time < threshold;
896 COMMENT ON FUNCTION container.clear_expired_circ_history_items( INTEGER ) IS $$
897 Delete old circulation bucket items for a specified user.
898 "Old" means older than the interval specified by a
899 user-level setting, if it is so specified.
902 CREATE OR REPLACE FUNCTION container.clear_all_expired_circ_history_items( )
905 -- Delete expired circulation bucket items for all users that have
906 -- a setting for patron.max_reading_list_interval.
909 today TIMESTAMP WITH TIME ZONE;
910 threshold TIMESTAMP WITH TIME ZONE;
913 SELECT date_trunc( 'day', now() ) INTO today;
922 name = 'patron.max_reading_list_interval'
925 -- Make sure the setting is a valid interval
928 threshold := today - CAST( translate( usr_setting.value, '"', '' ) AS INTERVAL );
931 RAISE NOTICE 'Invalid setting patron.max_reading_list_interval for user %: ''%''',
932 usr_setting.usr, usr_setting.value;
936 --RAISE NOTICE 'User % threshold %', usr_setting.usr, threshold;
938 DELETE FROM container.copy_bucket_item
945 container.copy_bucket
947 owner = usr_setting.usr
948 AND btype = 'circ_history'
950 AND create_time < threshold;
956 COMMENT ON FUNCTION container.clear_all_expired_circ_history_items( ) IS $$
957 Delete expired circulation bucket items for all users that have
958 a setting for patron.max_reading_list_interval.
961 CREATE OR REPLACE FUNCTION asset.merge_record_assets( target_record BIGINT, source_record BIGINT ) RETURNS INT AS $func$
963 moved_objects INT := 0;
964 source_cn asset.call_number%ROWTYPE;
965 target_cn asset.call_number%ROWTYPE;
966 metarec metabib.metarecord%ROWTYPE;
967 hold action.hold_request%ROWTYPE;
968 ser_rec serial.record_entry%ROWTYPE;
975 -- move any 856 entries on records that have at least one MARC-mapped URI entry
976 SELECT INTO uri_count COUNT(*)
977 FROM asset.uri_call_number_map m
978 JOIN asset.call_number cn ON (m.call_number = cn.id)
979 WHERE cn.record = source_record;
981 IF uri_count > 0 THEN
983 SELECT COUNT(*) INTO counter
984 FROM oils_xpath_table(
987 'biblio.record_entry',
989 'id=' || source_record
990 ) as t(i int,c text);
992 FOR i IN 1 .. counter LOOP
993 SELECT '<datafield xmlns="http://www.loc.gov/MARC21/slim"' ||
995 ' ind1="' || FIRST(ind1) || '"' ||
996 ' ind2="' || FIRST(ind2) || '">' ||
999 '<subfield code="' || subfield || '">' ||
1002 regexp_replace(data,'&','&','g'),
1008 ) || '</datafield>' INTO uri_datafield
1009 FROM oils_xpath_table(
1012 'biblio.record_entry',
1013 '//*[@tag="856"][position()=' || i || ']/@ind1|' ||
1014 '//*[@tag="856"][position()=' || i || ']/@ind2|' ||
1015 '//*[@tag="856"][position()=' || i || ']/*/@code|' ||
1016 '//*[@tag="856"][position()=' || i || ']/*[@code]',
1017 'id=' || source_record
1018 ) as t(id int,ind1 text, ind2 text,subfield text,data text);
1020 uri_text := uri_text || uri_datafield;
1023 IF uri_text <> '' THEN
1024 UPDATE biblio.record_entry
1025 SET marc = regexp_replace(marc,'(</[^>]*record>)', uri_text || E'\\1')
1026 WHERE id = target_record;
1031 -- Find and move metarecords to the target record
1032 SELECT INTO metarec *
1033 FROM metabib.metarecord
1034 WHERE master_record = source_record;
1037 UPDATE metabib.metarecord
1038 SET master_record = target_record,
1040 WHERE id = metarec.id;
1042 moved_objects := moved_objects + 1;
1045 -- Find call numbers attached to the source ...
1046 FOR source_cn IN SELECT * FROM asset.call_number WHERE record = source_record LOOP
1048 SELECT INTO target_cn *
1049 FROM asset.call_number
1050 WHERE label = source_cn.label
1051 AND owning_lib = source_cn.owning_lib
1052 AND record = target_record;
1054 -- ... and if there's a conflicting one on the target ...
1057 -- ... move the copies to that, and ...
1059 SET call_number = target_cn.id
1060 WHERE call_number = source_cn.id;
1062 -- ... move V holds to the move-target call number
1063 FOR hold IN SELECT * FROM action.hold_request WHERE target = source_cn.id AND hold_type = 'V' LOOP
1065 UPDATE action.hold_request
1066 SET target = target_cn.id
1069 moved_objects := moved_objects + 1;
1074 -- ... just move the call number to the target record
1075 UPDATE asset.call_number
1076 SET record = target_record
1077 WHERE id = source_cn.id;
1080 moved_objects := moved_objects + 1;
1083 -- Find T holds targeting the source record ...
1084 FOR hold IN SELECT * FROM action.hold_request WHERE target = source_record AND hold_type = 'T' LOOP
1086 -- ... and move them to the target record
1087 UPDATE action.hold_request
1088 SET target = target_record
1091 moved_objects := moved_objects + 1;
1094 -- Find serial records targeting the source record ...
1095 FOR ser_rec IN SELECT * FROM serial.record_entry WHERE record = source_record LOOP
1096 -- ... and move them to the target record
1097 UPDATE serial.record_entry
1098 SET record = target_record
1099 WHERE id = ser_rec.id;
1101 moved_objects := moved_objects + 1;
1104 -- Finally, "delete" the source record
1105 DELETE FROM biblio.record_entry WHERE id = source_record;
1107 -- That's all, folks!
1108 RETURN moved_objects;
1110 $func$ LANGUAGE plpgsql;
1112 -- copy OPAC visibility materialized view
1113 CREATE OR REPLACE FUNCTION asset.refresh_opac_visible_copies_mat_view () RETURNS VOID AS $$
1115 TRUNCATE TABLE asset.opac_visible_copies;
1117 INSERT INTO asset.opac_visible_copies (copy_id, circ_lib, record)
1118 SELECT cp.id, cp.circ_lib, cn.record
1120 JOIN asset.call_number cn ON (cn.id = cp.call_number)
1121 JOIN actor.org_unit a ON (cp.circ_lib = a.id)
1122 JOIN asset.copy_location cl ON (cp.location = cl.id)
1123 JOIN config.copy_status cs ON (cp.status = cs.id)
1124 JOIN biblio.record_entry b ON (cn.record = b.id)
1125 WHERE NOT cp.deleted
1133 SELECT cp.id, cp.circ_lib, pbcm.peer_record AS record
1135 JOIN biblio.peer_bib_copy_map pbcm ON (pbcm.target_copy = cp.id)
1136 JOIN actor.org_unit a ON (cp.circ_lib = a.id)
1137 JOIN asset.copy_location cl ON (cp.location = cl.id)
1138 JOIN config.copy_status cs ON (cp.status = cs.id)
1139 WHERE NOT cp.deleted
1146 COMMENT ON FUNCTION asset.refresh_opac_visible_copies_mat_view() IS $$
1147 Rebuild the copy OPAC visibility cache. Useful during migrations.
1150 CREATE OR REPLACE FUNCTION asset.cache_copy_visibility () RETURNS TRIGGER as $func$
1154 do_add BOOLEAN := false;
1155 do_remove BOOLEAN := false;
1158 INSERT INTO asset.opac_visible_copies (copy_id, circ_lib, record)
1159 SELECT id, circ_lib, record FROM (
1160 SELECT cp.id, cp.circ_lib, cn.record, cn.id AS call_number
1162 JOIN asset.call_number cn ON (cn.id = cp.call_number)
1163 JOIN actor.org_unit a ON (cp.circ_lib = a.id)
1164 JOIN asset.copy_location cl ON (cp.location = cl.id)
1165 JOIN config.copy_status cs ON (cp.status = cs.id)
1166 JOIN biblio.record_entry b ON (cn.record = b.id)
1167 WHERE NOT cp.deleted
1175 SELECT cp.id, cp.circ_lib, pbcm.peer_record AS record, NULL AS call_number
1177 JOIN biblio.peer_bib_copy_map pbcm ON (pbcm.target_copy = cp.id)
1178 JOIN actor.org_unit a ON (cp.circ_lib = a.id)
1179 JOIN asset.copy_location cl ON (cp.location = cl.id)
1180 JOIN config.copy_status cs ON (cp.status = cs.id)
1181 WHERE NOT cp.deleted
1190 remove_query := $$ DELETE FROM asset.opac_visible_copies WHERE copy_id IN ( SELECT id FROM asset.copy WHERE $$;
1192 IF TG_TABLE_NAME = 'peer_bib_copy_map' THEN
1193 IF TG_OP = 'INSERT' THEN
1194 add_query := add_query || 'WHERE x.id = ' || NEW.target_copy || ' AND x.record = ' || NEW.peer_record || ';';
1198 remove_query := 'DELETE FROM asset.opac_visible_copies WHERE copy_id = ' || OLD.target_copy || ' AND record = ' || OLD.peer_record || ';';
1199 EXECUTE remove_query;
1204 IF TG_OP = 'INSERT' THEN
1206 IF TG_TABLE_NAME IN ('copy', 'unit') THEN
1207 add_query := add_query || 'WHERE x.id = ' || NEW.id || ';';
1215 -- handle items first, since with circulation activity
1216 -- their statuses change frequently
1217 IF TG_TABLE_NAME IN ('copy', 'unit') THEN
1219 IF OLD.location <> NEW.location OR
1220 OLD.call_number <> NEW.call_number OR
1221 OLD.status <> NEW.status OR
1222 OLD.circ_lib <> NEW.circ_lib THEN
1223 -- any of these could change visibility, but
1224 -- we'll save some queries and not try to calculate
1225 -- the change directly
1230 IF OLD.deleted <> NEW.deleted THEN
1238 IF OLD.opac_visible <> NEW.opac_visible THEN
1239 IF OLD.opac_visible THEN
1241 ELSIF NOT do_remove THEN -- handle edge case where deleted item
1242 -- is also marked opac_visible
1250 DELETE FROM asset.opac_visible_copies WHERE copy_id = NEW.id;
1253 add_query := add_query || 'WHERE x.id = ' || NEW.id || ';';
1261 IF TG_TABLE_NAME IN ('call_number', 'record_entry') THEN -- these have a 'deleted' column
1263 IF OLD.deleted AND NEW.deleted THEN -- do nothing
1267 ELSIF NEW.deleted THEN -- remove rows
1269 IF TG_TABLE_NAME = 'call_number' THEN
1270 DELETE FROM asset.opac_visible_copies WHERE copy_id IN (SELECT id FROM asset.copy WHERE call_number = NEW.id);
1271 ELSIF TG_TABLE_NAME = 'record_entry' THEN
1272 DELETE FROM asset.opac_visible_copies WHERE record = NEW.id;
1277 ELSIF OLD.deleted THEN -- add rows
1279 IF TG_TABLE_NAME IN ('copy','unit') THEN
1280 add_query := add_query || 'WHERE x.id = ' || NEW.id || ';';
1281 ELSIF TG_TABLE_NAME = 'call_number' THEN
1282 add_query := add_query || 'WHERE x.call_number = ' || NEW.id || ';';
1283 ELSIF TG_TABLE_NAME = 'record_entry' THEN
1284 add_query := add_query || 'WHERE x.record = ' || NEW.id || ';';
1294 IF TG_TABLE_NAME = 'call_number' THEN
1296 IF OLD.record <> NEW.record THEN
1297 -- call number is linked to different bib
1298 remove_query := remove_query || 'call_number = ' || NEW.id || ');';
1299 EXECUTE remove_query;
1300 add_query := add_query || 'WHERE x.call_number = ' || NEW.id || ';';
1308 IF TG_TABLE_NAME IN ('record_entry') THEN
1309 RETURN NEW; -- don't have 'opac_visible'
1312 -- actor.org_unit, asset.copy_location, asset.copy_status
1313 IF NEW.opac_visible = OLD.opac_visible THEN -- do nothing
1317 ELSIF NEW.opac_visible THEN -- add rows
1319 IF TG_TABLE_NAME = 'org_unit' THEN
1320 add_query := add_query || 'AND cp.circ_lib = ' || NEW.id || ';';
1321 ELSIF TG_TABLE_NAME = 'copy_location' THEN
1322 add_query := add_query || 'AND cp.location = ' || NEW.id || ';';
1323 ELSIF TG_TABLE_NAME = 'copy_status' THEN
1324 add_query := add_query || 'AND cp.status = ' || NEW.id || ';';
1331 IF TG_TABLE_NAME = 'org_unit' THEN
1332 remove_query := 'DELETE FROM asset.opac_visible_copies WHERE circ_lib = ' || NEW.id || ';';
1333 ELSIF TG_TABLE_NAME = 'copy_location' THEN
1334 remove_query := remove_query || 'location = ' || NEW.id || ');';
1335 ELSIF TG_TABLE_NAME = 'copy_status' THEN
1336 remove_query := remove_query || 'status = ' || NEW.id || ');';
1339 EXECUTE remove_query;
1345 $func$ LANGUAGE PLPGSQL;
1346 COMMENT ON FUNCTION asset.cache_copy_visibility() IS $$
1347 Trigger function to update the copy OPAC visiblity cache.
1349 CREATE TRIGGER a_opac_vis_mat_view_tgr AFTER INSERT OR DELETE ON biblio.peer_bib_copy_map FOR EACH ROW EXECUTE PROCEDURE asset.cache_copy_visibility();
1350 CREATE TRIGGER a_opac_vis_mat_view_tgr AFTER INSERT OR UPDATE ON biblio.record_entry FOR EACH ROW EXECUTE PROCEDURE asset.cache_copy_visibility();
1351 CREATE TRIGGER a_opac_vis_mat_view_tgr AFTER INSERT OR UPDATE ON asset.copy FOR EACH ROW EXECUTE PROCEDURE asset.cache_copy_visibility();
1352 CREATE TRIGGER a_opac_vis_mat_view_tgr AFTER INSERT OR UPDATE ON asset.call_number FOR EACH ROW EXECUTE PROCEDURE asset.cache_copy_visibility();
1353 CREATE TRIGGER a_opac_vis_mat_view_tgr AFTER INSERT OR UPDATE ON asset.copy_location FOR EACH ROW EXECUTE PROCEDURE asset.cache_copy_visibility();
1354 CREATE TRIGGER a_opac_vis_mat_view_tgr AFTER INSERT OR UPDATE ON serial.unit FOR EACH ROW EXECUTE PROCEDURE asset.cache_copy_visibility();
1355 CREATE TRIGGER a_opac_vis_mat_view_tgr AFTER INSERT OR UPDATE ON config.copy_status FOR EACH ROW EXECUTE PROCEDURE asset.cache_copy_visibility();
1356 CREATE TRIGGER a_opac_vis_mat_view_tgr AFTER INSERT OR UPDATE ON actor.org_unit FOR EACH ROW EXECUTE PROCEDURE asset.cache_copy_visibility();
1358 -- Authority ingest routines
1359 CREATE OR REPLACE FUNCTION authority.propagate_changes (aid BIGINT, bid BIGINT) RETURNS BIGINT AS $func$
1360 UPDATE biblio.record_entry
1361 SET marc = vandelay.merge_record_xml( marc, authority.generate_overlay_template( $1 ) )
1364 $func$ LANGUAGE SQL;
1366 CREATE OR REPLACE FUNCTION authority.propagate_changes (aid BIGINT) RETURNS SETOF BIGINT AS $func$
1367 SELECT authority.propagate_changes( authority, bib ) FROM authority.bib_linking WHERE authority = $1;
1368 $func$ LANGUAGE SQL;
1370 CREATE OR REPLACE FUNCTION authority.flatten_marc ( TEXT ) RETURNS SETOF authority.full_rec AS $func$
1373 use MARC::File::XML (BinaryEncoding => 'UTF-8');
1376 my $r = MARC::Record->new_from_xml( $xml );
1378 return_next( { tag => 'LDR', value => $r->leader } );
1380 for my $f ( $r->fields ) {
1381 if ($f->is_control_field) {
1382 return_next({ tag => $f->tag, value => $f->data });
1384 for my $s ($f->subfields) {
1387 ind1 => $f->indicator(1),
1388 ind2 => $f->indicator(2),
1389 subfield => $s->[0],
1399 $func$ LANGUAGE PLPERLU;
1401 CREATE OR REPLACE FUNCTION authority.flatten_marc ( rid BIGINT ) RETURNS SETOF authority.full_rec AS $func$
1403 auth authority.record_entry%ROWTYPE;
1404 output authority.full_rec%ROWTYPE;
1407 SELECT INTO auth * FROM authority.record_entry WHERE id = rid;
1409 FOR field IN SELECT * FROM authority.flatten_marc( auth.marc ) LOOP
1410 output.record := rid;
1411 output.ind1 := field.ind1;
1412 output.ind2 := field.ind2;
1413 output.tag := field.tag;
1414 output.subfield := field.subfield;
1415 IF field.subfield IS NOT NULL THEN
1416 output.value := naco_normalize(field.value, field.subfield);
1418 output.value := field.value;
1421 CONTINUE WHEN output.value IS NULL;
1426 $func$ LANGUAGE PLPGSQL;
1428 -- authority.rec_descriptor appears to be unused currently
1429 CREATE OR REPLACE FUNCTION authority.reingest_authority_rec_descriptor( auth_id BIGINT ) RETURNS VOID AS $func$
1431 DELETE FROM authority.rec_descriptor WHERE record = auth_id;
1432 -- INSERT INTO authority.rec_descriptor (record, record_status, char_encoding)
1433 -- SELECT auth_id, ;
1437 $func$ LANGUAGE PLPGSQL;
1439 CREATE OR REPLACE FUNCTION authority.reingest_authority_full_rec( auth_id BIGINT ) RETURNS VOID AS $func$
1441 DELETE FROM authority.full_rec WHERE record = auth_id;
1442 INSERT INTO authority.full_rec (record, tag, ind1, ind2, subfield, value)
1443 SELECT record, tag, ind1, ind2, subfield, value FROM authority.flatten_marc( auth_id );
1447 $func$ LANGUAGE PLPGSQL;
1449 -- AFTER UPDATE OR INSERT trigger for authority.record_entry
1450 CREATE OR REPLACE FUNCTION authority.indexing_ingest_or_delete () RETURNS TRIGGER AS $func$
1453 IF NEW.deleted IS TRUE THEN -- If this authority is deleted
1454 DELETE FROM authority.bib_linking WHERE authority = NEW.id; -- Avoid updating fields in bibs that are no longer visible
1455 DELETE FROM authority.full_rec WHERE record = NEW.id; -- Avoid validating fields against deleted authority records
1456 -- Should remove matching $0 from controlled fields at the same time?
1457 RETURN NEW; -- and we're done
1460 IF TG_OP = 'UPDATE' THEN -- re-ingest?
1461 PERFORM * FROM config.internal_flag WHERE name = 'ingest.reingest.force_on_same_marc' AND enabled;
1463 IF NOT FOUND AND OLD.marc = NEW.marc THEN -- don't do anything if the MARC didn't change
1466 -- Propagate these updates to any linked bib records
1467 PERFORM authority.propagate_changes(NEW.id) FROM authority.record_entry WHERE id = NEW.id;
1470 -- Flatten and insert the afr data
1471 PERFORM * FROM config.internal_flag WHERE name = 'ingest.disable_authority_full_rec' AND enabled;
1473 PERFORM authority.reingest_authority_full_rec(NEW.id);
1474 -- authority.rec_descriptor is not currently used
1475 -- PERFORM * FROM config.internal_flag WHERE name = 'ingest.disable_authority_rec_descriptor' AND enabled;
1476 -- IF NOT FOUND THEN
1477 -- PERFORM authority.reingest_authority_rec_descriptor(NEW.id);
1483 $func$ LANGUAGE PLPGSQL;
1486 CREATE TRIGGER fingerprint_tgr BEFORE INSERT OR UPDATE ON biblio.record_entry FOR EACH ROW EXECUTE PROCEDURE biblio.fingerprint_trigger ('eng','BKS');
1487 CREATE TRIGGER aaa_indexing_ingest_or_delete AFTER INSERT OR UPDATE ON biblio.record_entry FOR EACH ROW EXECUTE PROCEDURE biblio.indexing_ingest_or_delete ();
1488 CREATE TRIGGER bbb_simple_rec_trigger AFTER INSERT OR UPDATE OR DELETE ON biblio.record_entry FOR EACH ROW EXECUTE PROCEDURE reporter.simple_rec_trigger ();
1490 CREATE TRIGGER aaa_auth_ingest_or_delete AFTER INSERT OR UPDATE ON authority.record_entry FOR EACH ROW EXECUTE PROCEDURE authority.indexing_ingest_or_delete ();
1492 -- Utility routines, callable via cstore
1494 CREATE OR REPLACE FUNCTION config.interval_to_seconds( interval_val INTERVAL )
1495 RETURNS INTEGER AS $$
1497 RETURN EXTRACT( EPOCH FROM interval_val );
1499 $$ LANGUAGE plpgsql;
1501 CREATE OR REPLACE FUNCTION config.interval_to_seconds( interval_string TEXT )
1502 RETURNS INTEGER AS $$
1504 RETURN config.interval_to_seconds( interval_string::INTERVAL );
1506 $$ LANGUAGE plpgsql;