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 add_base_query TEXT;
1155 add_peer_query TEXT;
1157 do_add BOOLEAN := false;
1158 do_remove BOOLEAN := false;
1160 add_base_query := $$
1161 SELECT cp.id, cp.circ_lib, cn.record, cn.id AS call_number, cp.location, cp.status
1163 JOIN asset.call_number cn ON (cn.id = cp.call_number)
1164 JOIN actor.org_unit a ON (cp.circ_lib = a.id)
1165 JOIN asset.copy_location cl ON (cp.location = cl.id)
1166 JOIN config.copy_status cs ON (cp.status = cs.id)
1167 JOIN biblio.record_entry b ON (cn.record = b.id)
1168 WHERE NOT cp.deleted
1176 add_peer_query := $$
1177 SELECT cp.id, cp.circ_lib, pbcm.peer_record AS record, NULL AS call_number, cp.location, cp.status
1179 JOIN biblio.peer_bib_copy_map pbcm ON (pbcm.target_copy = cp.id)
1180 JOIN actor.org_unit a ON (cp.circ_lib = a.id)
1181 JOIN asset.copy_location cl ON (cp.location = cl.id)
1182 JOIN config.copy_status cs ON (cp.status = cs.id)
1183 WHERE NOT cp.deleted
1190 INSERT INTO asset.opac_visible_copies (copy_id, circ_lib, record)
1191 SELECT id, circ_lib, record FROM (
1197 remove_query := $$ DELETE FROM asset.opac_visible_copies WHERE copy_id IN ( SELECT id FROM asset.copy WHERE $$;
1199 IF TG_TABLE_NAME = 'peer_bib_copy_map' THEN
1200 IF TG_OP = 'INSERT' THEN
1201 add_peer_query := add_peer_query || ' AND cp.id = ' || NEW.target_copy || ' AND pbcm.record = ' || NEW.peer_record;
1202 EXECUTE add_front || add_peer_query || add_back;
1205 remove_query := 'DELETE FROM asset.opac_visible_copies WHERE copy_id = ' || OLD.target_copy || ' AND record = ' || OLD.peer_record || ';';
1206 EXECUTE remove_query;
1211 IF TG_OP = 'INSERT' THEN
1213 IF TG_TABLE_NAME IN ('copy', 'unit') THEN
1214 add_base_query := add_base_query || ' AND cp.id = ' || NEW.id;
1215 EXECUTE add_front || add_basequery || add_back;
1222 -- handle items first, since with circulation activity
1223 -- their statuses change frequently
1224 IF TG_TABLE_NAME IN ('copy', 'unit') THEN
1226 IF OLD.location <> NEW.location OR
1227 OLD.call_number <> NEW.call_number OR
1228 OLD.status <> NEW.status OR
1229 OLD.circ_lib <> NEW.circ_lib THEN
1230 -- any of these could change visibility, but
1231 -- we'll save some queries and not try to calculate
1232 -- the change directly
1237 IF OLD.deleted <> NEW.deleted THEN
1245 IF OLD.opac_visible <> NEW.opac_visible THEN
1246 IF OLD.opac_visible THEN
1248 ELSIF NOT do_remove THEN -- handle edge case where deleted item
1249 -- is also marked opac_visible
1257 DELETE FROM asset.opac_visible_copies WHERE copy_id = NEW.id;
1260 add_base_query := add_base_query || ' AND cp.id = ' || NEW.id;
1261 add_peer_query := add_peer_query || ' AND cp.id = ' || NEW.id;
1262 EXECUTE add_front || add_base_query || ' UNION ' || add_peer_query || add_back;
1269 IF TG_TABLE_NAME IN ('call_number', 'record_entry') THEN -- these have a 'deleted' column
1271 IF OLD.deleted AND NEW.deleted THEN -- do nothing
1275 ELSIF NEW.deleted THEN -- remove rows
1277 IF TG_TABLE_NAME = 'call_number' THEN
1278 DELETE FROM asset.opac_visible_copies WHERE copy_id IN (SELECT id FROM asset.copy WHERE call_number = NEW.id);
1279 ELSIF TG_TABLE_NAME = 'record_entry' THEN
1280 DELETE FROM asset.opac_visible_copies WHERE record = NEW.id;
1285 ELSIF OLD.deleted THEN -- add rows
1287 IF TG_TABLE_NAME = 'call_number' THEN
1288 add_base_query := add_base_query || ' AND cn.id = ' || NEW.id;
1289 EXECUTE add_front || add_base_query || add_back;
1290 ELSIF TG_TABLE_NAME = 'record_entry' THEN
1291 add_base_query := add_base_query || ' AND cn.record = ' || NEW.id;
1292 add_peer_query := add_peer_query || ' AND pbcm.record = ' || NEW.id;
1293 EXECUTE add_front || add_base_query || ' UNION ' || add_peer_query || add_back;
1302 IF TG_TABLE_NAME = 'call_number' THEN
1304 IF OLD.record <> NEW.record THEN
1305 -- call number is linked to different bib
1306 remove_query := remove_query || 'call_number = ' || NEW.id || ');';
1307 EXECUTE remove_query;
1308 add_base_query := add_base_query || ' AND cn.id = ' || NEW.id;
1309 EXECUTE add_front || add_base_query || add_back;
1316 IF TG_TABLE_NAME IN ('record_entry') THEN
1317 RETURN NEW; -- don't have 'opac_visible'
1320 -- actor.org_unit, asset.copy_location, asset.copy_status
1321 IF NEW.opac_visible = OLD.opac_visible THEN -- do nothing
1325 ELSIF NEW.opac_visible THEN -- add rows
1327 IF TG_TABLE_NAME = 'org_unit' THEN
1328 add_base_query := add_base_query || ' AND cp.circ_lib = ' || NEW.id || ';';
1329 add_peer_query := add_peer_query || ' AND cp.circ_lib = ' || NEW.id || ';';
1330 ELSIF TG_TABLE_NAME = 'copy_location' THEN
1331 add_base_query := add_base_query || ' AND cp.location = ' || NEW.id || ';';
1332 add_peer_query := add_peer_query || ' AND cp.location = ' || NEW.id || ';';
1333 ELSIF TG_TABLE_NAME = 'copy_status' THEN
1334 add_base_query := add_base_query || ' AND cp.status = ' || NEW.id || ';';
1335 add_peer_query := add_peer_query || ' AND cp.status = ' || NEW.id || ';';
1338 EXECUTE add_front || add_base_query || ' UNION ' || add_peer_query || add_back;
1342 IF TG_TABLE_NAME = 'org_unit' THEN
1343 remove_query := 'DELETE FROM asset.opac_visible_copies WHERE circ_lib = ' || NEW.id || ';';
1344 ELSIF TG_TABLE_NAME = 'copy_location' THEN
1345 remove_query := remove_query || 'location = ' || NEW.id || ');';
1346 ELSIF TG_TABLE_NAME = 'copy_status' THEN
1347 remove_query := remove_query || 'status = ' || NEW.id || ');';
1350 EXECUTE remove_query;
1356 $func$ LANGUAGE PLPGSQL;
1357 COMMENT ON FUNCTION asset.cache_copy_visibility() IS $$
1358 Trigger function to update the copy OPAC visiblity cache.
1360 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();
1361 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();
1362 CREATE TRIGGER a_opac_vis_mat_view_tgr AFTER INSERT OR UPDATE ON asset.copy FOR EACH ROW EXECUTE PROCEDURE asset.cache_copy_visibility();
1363 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();
1364 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();
1365 CREATE TRIGGER a_opac_vis_mat_view_tgr AFTER INSERT OR UPDATE ON serial.unit FOR EACH ROW EXECUTE PROCEDURE asset.cache_copy_visibility();
1366 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();
1367 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();
1369 -- Authority ingest routines
1370 CREATE OR REPLACE FUNCTION authority.propagate_changes (aid BIGINT, bid BIGINT) RETURNS BIGINT AS $func$
1371 UPDATE biblio.record_entry
1372 SET marc = vandelay.merge_record_xml( marc, authority.generate_overlay_template( $1 ) )
1375 $func$ LANGUAGE SQL;
1377 CREATE OR REPLACE FUNCTION authority.propagate_changes (aid BIGINT) RETURNS SETOF BIGINT AS $func$
1378 SELECT authority.propagate_changes( authority, bib ) FROM authority.bib_linking WHERE authority = $1;
1379 $func$ LANGUAGE SQL;
1381 CREATE OR REPLACE FUNCTION authority.flatten_marc ( TEXT ) RETURNS SETOF authority.full_rec AS $func$
1384 use MARC::File::XML (BinaryEncoding => 'UTF-8');
1387 MARC::Charset->assume_unicode(1);
1390 my $r = MARC::Record->new_from_xml( $xml );
1392 return_next( { tag => 'LDR', value => $r->leader } );
1394 for my $f ( $r->fields ) {
1395 if ($f->is_control_field) {
1396 return_next({ tag => $f->tag, value => $f->data });
1398 for my $s ($f->subfields) {
1401 ind1 => $f->indicator(1),
1402 ind2 => $f->indicator(2),
1403 subfield => $s->[0],
1413 $func$ LANGUAGE PLPERLU;
1415 CREATE OR REPLACE FUNCTION authority.flatten_marc ( rid BIGINT ) RETURNS SETOF authority.full_rec AS $func$
1417 auth authority.record_entry%ROWTYPE;
1418 output authority.full_rec%ROWTYPE;
1421 SELECT INTO auth * FROM authority.record_entry WHERE id = rid;
1423 FOR field IN SELECT * FROM authority.flatten_marc( auth.marc ) LOOP
1424 output.record := rid;
1425 output.ind1 := field.ind1;
1426 output.ind2 := field.ind2;
1427 output.tag := field.tag;
1428 output.subfield := field.subfield;
1429 IF field.subfield IS NOT NULL THEN
1430 output.value := naco_normalize(field.value, field.subfield);
1432 output.value := field.value;
1435 CONTINUE WHEN output.value IS NULL;
1440 $func$ LANGUAGE PLPGSQL;
1442 -- authority.rec_descriptor appears to be unused currently
1443 CREATE OR REPLACE FUNCTION authority.reingest_authority_rec_descriptor( auth_id BIGINT ) RETURNS VOID AS $func$
1445 DELETE FROM authority.rec_descriptor WHERE record = auth_id;
1446 -- INSERT INTO authority.rec_descriptor (record, record_status, char_encoding)
1447 -- SELECT auth_id, ;
1451 $func$ LANGUAGE PLPGSQL;
1453 CREATE OR REPLACE FUNCTION authority.reingest_authority_full_rec( auth_id BIGINT ) RETURNS VOID AS $func$
1455 DELETE FROM authority.full_rec WHERE record = auth_id;
1456 INSERT INTO authority.full_rec (record, tag, ind1, ind2, subfield, value)
1457 SELECT record, tag, ind1, ind2, subfield, value FROM authority.flatten_marc( auth_id );
1461 $func$ LANGUAGE PLPGSQL;
1463 -- AFTER UPDATE OR INSERT trigger for authority.record_entry
1464 CREATE OR REPLACE FUNCTION authority.indexing_ingest_or_delete () RETURNS TRIGGER AS $func$
1467 IF NEW.deleted IS TRUE THEN -- If this authority is deleted
1468 DELETE FROM authority.bib_linking WHERE authority = NEW.id; -- Avoid updating fields in bibs that are no longer visible
1469 DELETE FROM authority.full_rec WHERE record = NEW.id; -- Avoid validating fields against deleted authority records
1470 -- Should remove matching $0 from controlled fields at the same time?
1471 RETURN NEW; -- and we're done
1474 IF TG_OP = 'UPDATE' THEN -- re-ingest?
1475 PERFORM * FROM config.internal_flag WHERE name = 'ingest.reingest.force_on_same_marc' AND enabled;
1477 IF NOT FOUND AND OLD.marc = NEW.marc THEN -- don't do anything if the MARC didn't change
1480 -- Propagate these updates to any linked bib records
1481 PERFORM authority.propagate_changes(NEW.id) FROM authority.record_entry WHERE id = NEW.id;
1484 -- Flatten and insert the afr data
1485 PERFORM * FROM config.internal_flag WHERE name = 'ingest.disable_authority_full_rec' AND enabled;
1487 PERFORM authority.reingest_authority_full_rec(NEW.id);
1488 -- authority.rec_descriptor is not currently used
1489 -- PERFORM * FROM config.internal_flag WHERE name = 'ingest.disable_authority_rec_descriptor' AND enabled;
1490 -- IF NOT FOUND THEN
1491 -- PERFORM authority.reingest_authority_rec_descriptor(NEW.id);
1497 $func$ LANGUAGE PLPGSQL;
1500 CREATE TRIGGER fingerprint_tgr BEFORE INSERT OR UPDATE ON biblio.record_entry FOR EACH ROW EXECUTE PROCEDURE biblio.fingerprint_trigger ('eng','BKS');
1501 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 ();
1502 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 ();
1504 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 ();
1506 -- Utility routines, callable via cstore
1508 CREATE OR REPLACE FUNCTION config.interval_to_seconds( interval_val INTERVAL )
1509 RETURNS INTEGER AS $$
1511 RETURN EXTRACT( EPOCH FROM interval_val );
1513 $$ LANGUAGE plpgsql;
1515 CREATE OR REPLACE FUNCTION config.interval_to_seconds( interval_string TEXT )
1516 RETURNS INTEGER AS $$
1518 RETURN config.interval_to_seconds( interval_string::INTERVAL );
1520 $$ LANGUAGE plpgsql;