1 -- Copyright 2009-2012, Equinox Software, Inc.
3 -- This program is free software; you can redistribute it and/or
4 -- modify it under the terms of the GNU General Public License
5 -- as published by the Free Software Foundation; either version 2
6 -- of the License, or (at your option) any later version.
8 -- This program is distributed in the hope that it will be useful,
9 -- but WITHOUT ANY WARRANTY; without even the implied warranty of
10 -- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11 -- GNU General Public License for more details.
13 -- You should have received a copy of the GNU General Public License
14 -- along with this program; if not, write to the Free Software
15 -- Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
17 --------------------------------------------------------------------------
18 -- An example of how to use:
20 -- DROP SCHEMA foo CASCADE; CREATE SCHEMA foo;
22 -- SELECT migration_tools.init('foo');
23 -- SELECT migration_tools.build('foo');
24 -- SELECT * FROM foo.fields_requiring_mapping;
26 -- create some incoming ILS specific staging tables, like CREATE foo.legacy_items ( l_barcode TEXT, .. ) INHERITS foo.asset_copy;
27 -- Do some mapping, like UPDATE foo.legacy_items SET barcode = TRIM(BOTH ' ' FROM l_barcode);
28 -- Then, to move into production, do: select migration_tools.insert_base_into_production('foo')
30 CREATE SCHEMA migration_tools;
32 CREATE OR REPLACE FUNCTION migration_tools.production_tables (TEXT) RETURNS TEXT[] AS $$
34 migration_schema ALIAS FOR $1;
38 EXECUTE 'SELECT string_to_array(value,'','') AS tables FROM ' || migration_schema || '.config WHERE key = ''production_tables'';'
43 $$ LANGUAGE PLPGSQL STRICT STABLE;
45 CREATE OR REPLACE FUNCTION migration_tools.country_code (TEXT) RETURNS TEXT AS $$
47 migration_schema ALIAS FOR $1;
51 EXECUTE 'SELECT value FROM ' || migration_schema || '.config WHERE key = ''country_code'';'
56 $$ LANGUAGE PLPGSQL STRICT STABLE;
59 CREATE OR REPLACE FUNCTION migration_tools.log (TEXT,TEXT,INTEGER) RETURNS VOID AS $$
61 migration_schema ALIAS FOR $1;
65 EXECUTE 'INSERT INTO ' || migration_schema || '.sql_log ( sql, row_count ) VALUES ( ' || quote_literal(sql) || ', ' || nrows || ' );';
67 $$ LANGUAGE PLPGSQL STRICT VOLATILE;
69 CREATE OR REPLACE FUNCTION migration_tools.exec (TEXT,TEXT) RETURNS VOID AS $$
71 migration_schema ALIAS FOR $1;
75 EXECUTE 'UPDATE ' || migration_schema || '.sql_current SET sql = ' || quote_literal(sql) || ';';
76 --RAISE INFO '%', sql;
78 GET DIAGNOSTICS nrows = ROW_COUNT;
79 PERFORM migration_tools.log(migration_schema,sql,nrows);
82 RAISE EXCEPTION '!!!!!!!!!!! state = %, msg = %, sql = %', SQLSTATE, SQLERRM, sql;
84 $$ LANGUAGE PLPGSQL STRICT VOLATILE;
86 CREATE OR REPLACE FUNCTION migration_tools.debug_exec (TEXT,TEXT) RETURNS VOID AS $$
88 migration_schema ALIAS FOR $1;
92 EXECUTE 'UPDATE ' || migration_schema || '.sql_current SET sql = ' || quote_literal(sql) || ';';
93 RAISE INFO 'debug_exec sql = %', sql;
95 GET DIAGNOSTICS nrows = ROW_COUNT;
96 PERFORM migration_tools.log(migration_schema,sql,nrows);
99 RAISE EXCEPTION '!!!!!!!!!!! state = %, msg = %, sql = %', SQLSTATE, SQLERRM, sql;
101 $$ LANGUAGE PLPGSQL STRICT VOLATILE;
103 CREATE OR REPLACE FUNCTION migration_tools.init (TEXT) RETURNS VOID AS $$
105 migration_schema ALIAS FOR $1;
108 EXECUTE 'DROP TABLE IF EXISTS ' || migration_schema || '.sql_current;';
109 EXECUTE 'CREATE TABLE ' || migration_schema || '.sql_current ( sql TEXT);';
110 EXECUTE 'INSERT INTO ' || migration_schema || '.sql_current ( sql ) VALUES ( '''' );';
112 SELECT 'CREATE TABLE ' || migration_schema || '.sql_log ( time TIMESTAMP NOT NULL DEFAULT NOW(), row_count INTEGER, sql TEXT );' INTO STRICT sql;
116 RAISE INFO '!!!!!!!!!!! state = %, msg = %, sql = %', SQLSTATE, SQLERRM, sql;
118 PERFORM migration_tools.exec( $1, 'DROP TABLE IF EXISTS ' || migration_schema || '.config;' );
119 PERFORM migration_tools.exec( $1, 'CREATE TABLE ' || migration_schema || '.config ( key TEXT UNIQUE, value TEXT);' );
120 PERFORM migration_tools.exec( $1, 'INSERT INTO ' || migration_schema || '.config (key,value) VALUES ( ''production_tables'', ''asset.call_number,asset.copy_location,asset.copy,asset.stat_cat,asset.stat_cat_entry,asset.stat_cat_entry_copy_map,asset.copy_note,actor.usr,actor.card,actor.usr_address,actor.stat_cat,actor.stat_cat_entry,actor.stat_cat_entry_usr_map,actor.usr_note,action.circulation,action.hold_request,action.hold_notification,money.grocery,money.billing,money.cash_payment,money.forgive_payment'' );' );
121 PERFORM migration_tools.exec( $1, 'INSERT INTO ' || migration_schema || '.config (key,value) VALUES ( ''country_code'', ''USA'' );' );
122 PERFORM migration_tools.exec( $1, 'DROP TABLE IF EXISTS ' || migration_schema || '.fields_requiring_mapping;' );
123 PERFORM migration_tools.exec( $1, 'CREATE TABLE ' || migration_schema || '.fields_requiring_mapping( table_schema TEXT, table_name TEXT, column_name TEXT, data_type TEXT);' );
124 PERFORM migration_tools.exec( $1, 'DROP TABLE IF EXISTS ' || migration_schema || '.base_profile_map;' );
125 PERFORM migration_tools.exec( $1, 'CREATE TABLE ' || migration_schema || E'.base_profile_map (
128 transcribed_perm_group TEXT,
136 PERFORM migration_tools.exec( $1, 'INSERT INTO ' || migration_schema || '.config (key,value) VALUES ( ''base_profile_map'', ''base_profile_map'' );' );
137 PERFORM migration_tools.exec( $1, 'DROP TABLE IF EXISTS ' || migration_schema || '.base_item_dynamic_field_map;' );
138 PERFORM migration_tools.exec( $1, 'CREATE TABLE ' || migration_schema || E'.base_item_dynamic_field_map (
140 evergreen_field TEXT,
141 evergreen_value TEXT,
142 evergreen_datatype TEXT,
150 PERFORM migration_tools.exec( $1, 'CREATE INDEX ' || migration_schema || '_item_dynamic_lf1_idx ON ' || migration_schema || '.base_item_dynamic_field_map (legacy_field1,legacy_value1);' );
151 PERFORM migration_tools.exec( $1, 'CREATE INDEX ' || migration_schema || '_item_dynamic_lf2_idx ON ' || migration_schema || '.base_item_dynamic_field_map (legacy_field2,legacy_value2);' );
152 PERFORM migration_tools.exec( $1, 'CREATE INDEX ' || migration_schema || '_item_dynamic_lf3_idx ON ' || migration_schema || '.base_item_dynamic_field_map (legacy_field3,legacy_value3);' );
153 PERFORM migration_tools.exec( $1, 'INSERT INTO ' || migration_schema || '.config (key,value) VALUES ( ''base_item_dynamic_field_map'', ''base_item_dynamic_field_map'' );' );
154 PERFORM migration_tools.exec( $1, 'DROP TABLE IF EXISTS ' || migration_schema || '.base_copy_location_map;' );
155 PERFORM migration_tools.exec( $1, 'CREATE TABLE ' || migration_schema || E'.base_copy_location_map (
158 holdable BOOLEAN NOT NULL DEFAULT TRUE,
159 hold_verify BOOLEAN NOT NULL DEFAULT FALSE,
160 opac_visible BOOLEAN NOT NULL DEFAULT TRUE,
161 circulate BOOLEAN NOT NULL DEFAULT TRUE,
162 transcribed_location TEXT,
170 PERFORM migration_tools.exec( $1, 'CREATE INDEX ' || migration_schema || '_base_copy_location_lf1_idx ON ' || migration_schema || '.base_copy_location_map (legacy_field1,legacy_value1);' );
171 PERFORM migration_tools.exec( $1, 'CREATE INDEX ' || migration_schema || '_base_copy_location_lf2_idx ON ' || migration_schema || '.base_copy_location_map (legacy_field2,legacy_value2);' );
172 PERFORM migration_tools.exec( $1, 'CREATE INDEX ' || migration_schema || '_base_copy_location_lf3_idx ON ' || migration_schema || '.base_copy_location_map (legacy_field3,legacy_value3);' );
173 PERFORM migration_tools.exec( $1, 'CREATE INDEX ' || migration_schema || '_base_copy_location_loc_idx ON ' || migration_schema || '.base_copy_location_map (transcribed_location);' );
174 PERFORM migration_tools.exec( $1, 'INSERT INTO ' || migration_schema || '.config (key,value) VALUES ( ''base_copy_location_map'', ''base_copy_location_map'' );' );
175 PERFORM migration_tools.exec( $1, 'DROP TABLE IF EXISTS ' || migration_schema || '.base_circ_field_map;' );
176 PERFORM migration_tools.exec( $1, 'CREATE TABLE ' || migration_schema || E'.base_circ_field_map (
194 PERFORM migration_tools.exec( $1, 'CREATE INDEX ' || migration_schema || '_circ_dynamic_lf1_idx ON ' || migration_schema || '.base_circ_field_map (item_field1,item_value1);' );
195 PERFORM migration_tools.exec( $1, 'CREATE INDEX ' || migration_schema || '_circ_dynamic_lf2_idx ON ' || migration_schema || '.base_circ_field_map (item_field2,item_value2);' );
196 PERFORM migration_tools.exec( $1, 'CREATE INDEX ' || migration_schema || '_circ_dynamic_lf3_idx ON ' || migration_schema || '.base_circ_field_map (patron_field1,patron_value1);' );
197 PERFORM migration_tools.exec( $1, 'CREATE INDEX ' || migration_schema || '_circ_dynamic_lf4_idx ON ' || migration_schema || '.base_circ_field_map (patron_field2,patron_value2);' );
198 PERFORM migration_tools.exec( $1, 'INSERT INTO ' || migration_schema || '.config (key,value) VALUES ( ''base_circ_field_map'', ''base_circ_field_map'' );' );
201 PERFORM migration_tools.exec( $1, 'INSERT INTO ' || migration_schema || '.config (key,value) VALUES ( ''last_init'', now() );' );
203 WHEN OTHERS THEN PERFORM migration_tools.exec( $1, 'UPDATE ' || migration_schema || '.config SET value = now() WHERE key = ''last_init'';' );
206 $$ LANGUAGE PLPGSQL STRICT VOLATILE;
208 CREATE OR REPLACE FUNCTION migration_tools.build (TEXT) RETURNS VOID AS $$
210 migration_schema ALIAS FOR $1;
211 production_tables TEXT[];
213 --RAISE INFO 'In migration_tools.build(%)', migration_schema;
214 SELECT migration_tools.production_tables(migration_schema) INTO STRICT production_tables;
215 PERFORM migration_tools.build_base_staging_tables(migration_schema,production_tables);
216 PERFORM migration_tools.exec( $1, 'CREATE UNIQUE INDEX ' || migration_schema || '_patron_barcode_key ON ' || migration_schema || '.actor_card ( barcode );' );
217 PERFORM migration_tools.exec( $1, 'CREATE UNIQUE INDEX ' || migration_schema || '_patron_usrname_key ON ' || migration_schema || '.actor_usr ( usrname );' );
218 PERFORM migration_tools.exec( $1, 'CREATE UNIQUE INDEX ' || migration_schema || '_copy_barcode_key ON ' || migration_schema || '.asset_copy ( barcode );' );
219 PERFORM migration_tools.exec( $1, 'CREATE UNIQUE INDEX ' || migration_schema || '_copy_id_key ON ' || migration_schema || '.asset_copy ( id );' );
220 PERFORM migration_tools.exec( $1, 'CREATE INDEX ' || migration_schema || '_callnum_record_idx ON ' || migration_schema || '.asset_call_number ( record );' );
221 PERFORM migration_tools.exec( $1, 'CREATE INDEX ' || migration_schema || '_callnum_upper_label_id_lib_idx ON ' || migration_schema || '.asset_call_number ( UPPER(label),id,owning_lib );' );
222 PERFORM migration_tools.exec( $1, 'CREATE UNIQUE INDEX ' || migration_schema || '_callnum_label_once_per_lib ON ' || migration_schema || '.asset_call_number ( record,owning_lib,label );' );
224 $$ LANGUAGE PLPGSQL STRICT VOLATILE;
226 CREATE OR REPLACE FUNCTION migration_tools.build_base_staging_tables (TEXT,TEXT[]) RETURNS VOID AS $$
228 migration_schema ALIAS FOR $1;
229 production_tables ALIAS FOR $2;
231 --RAISE INFO 'In migration_tools.build_base_staging_tables(%,%)', migration_schema, production_tables;
232 FOR i IN array_lower(production_tables,1) .. array_upper(production_tables,1) LOOP
233 PERFORM migration_tools.build_specific_base_staging_table(migration_schema,production_tables[i]);
236 $$ LANGUAGE PLPGSQL STRICT VOLATILE;
238 CREATE OR REPLACE FUNCTION migration_tools.build_specific_base_staging_table (TEXT,TEXT) RETURNS VOID AS $$
240 migration_schema ALIAS FOR $1;
241 production_table ALIAS FOR $2;
242 base_staging_table TEXT;
245 base_staging_table = REPLACE( production_table, '.', '_' );
246 --RAISE INFO 'In migration_tools.build_specific_base_staging_table(%,%) -> %', migration_schema, production_table, base_staging_table;
247 PERFORM migration_tools.exec( $1, 'CREATE TABLE ' || migration_schema || '.' || base_staging_table || ' ( LIKE ' || production_table || ' INCLUDING DEFAULTS EXCLUDING CONSTRAINTS );' );
248 PERFORM migration_tools.exec( $1, '
249 INSERT INTO ' || migration_schema || '.fields_requiring_mapping
250 SELECT table_schema, table_name, column_name, data_type
251 FROM information_schema.columns
252 WHERE table_schema = ''' || migration_schema || ''' AND table_name = ''' || base_staging_table || ''' AND is_nullable = ''NO'' AND column_default IS NULL;
255 SELECT table_schema, table_name, column_name, data_type
256 FROM information_schema.columns
257 WHERE table_schema = migration_schema AND table_name = base_staging_table AND is_nullable = 'NO' AND column_default IS NULL
259 PERFORM migration_tools.exec( $1, 'ALTER TABLE ' || columns.table_schema || '.' || columns.table_name || ' ALTER COLUMN ' || columns.column_name || ' DROP NOT NULL;' );
262 $$ LANGUAGE PLPGSQL STRICT VOLATILE;
264 CREATE OR REPLACE FUNCTION migration_tools.insert_base_into_production (TEXT) RETURNS VOID AS $$
266 migration_schema ALIAS FOR $1;
267 production_tables TEXT[];
269 --RAISE INFO 'In migration_tools.insert_into_production(%)', migration_schema;
270 SELECT migration_tools.production_tables(migration_schema) INTO STRICT production_tables;
271 FOR i IN array_lower(production_tables,1) .. array_upper(production_tables,1) LOOP
272 PERFORM migration_tools.insert_into_production(migration_schema,production_tables[i]);
275 $$ LANGUAGE PLPGSQL STRICT VOLATILE;
277 CREATE OR REPLACE FUNCTION migration_tools.insert_into_production (TEXT,TEXT) RETURNS VOID AS $$
279 migration_schema ALIAS FOR $1;
280 production_table ALIAS FOR $2;
281 base_staging_table TEXT;
284 base_staging_table = REPLACE( production_table, '.', '_' );
285 --RAISE INFO 'In migration_tools.insert_into_production(%,%) -> %', migration_schema, production_table, base_staging_table;
286 PERFORM migration_tools.exec( $1, 'INSERT INTO ' || production_table || ' SELECT * FROM ' || migration_schema || '.' || base_staging_table || ';' );
288 $$ LANGUAGE PLPGSQL STRICT VOLATILE;
290 CREATE OR REPLACE FUNCTION migration_tools.name_parse_out_last_comma_prefix_first_middle_suffix (TEXT) RETURNS TEXT[] AS $$
292 full_name TEXT := $1;
294 family_name TEXT := '';
295 first_given_name TEXT := '';
296 second_given_name TEXT := '';
301 -- Use values, not structure, for prefix/suffix, unless we come up with a better idea
302 IF temp ilike '%MR.%' THEN
304 temp := REGEXP_REPLACE( temp, E'MR\.\\s*', '', 'i' );
306 IF temp ilike '%MRS.%' THEN
308 temp := REGEXP_REPLACE( temp, E'MRS\.\\s*', '', 'i' );
310 IF temp ilike '%MS.%' THEN
312 temp := REGEXP_REPLACE( temp, E'MS\.\\s*', '', 'i' );
314 IF temp ilike '%DR.%' THEN
316 temp := REGEXP_REPLACE( temp, E'DR\.\\s*', '', 'i' );
318 IF temp ilike '%JR%' THEN
320 temp := REGEXP_REPLACE( temp, E'JR\.?\\s*', '', 'i' );
322 IF temp ilike '%JR,%' THEN
324 temp := REGEXP_REPLACE( temp, E'JR,\\s*', ',', 'i' );
326 IF temp ilike '%SR%' THEN
328 temp := REGEXP_REPLACE( temp, E'SR\.?\\s*', '', 'i' );
330 IF temp ilike '%SR,%' THEN
332 temp := REGEXP_REPLACE( temp, E'SR,\\s*', ',', 'i' );
334 IF temp ~ E'\\sII$' THEN
336 temp := REGEXP_REPLACE( temp, E'II$', '', 'i' );
338 IF temp ~ E'\\sIII$' THEN
340 temp := REGEXP_REPLACE( temp, E'III$', '', 'i' );
342 IF temp ~ E'\\sIV$' THEN
344 temp := REGEXP_REPLACE( temp, E'IV$', '', 'i' );
347 family_name := BTRIM( REGEXP_REPLACE(temp,E'^([^,]*)\\s*,.*$',E'\\1') );
348 first_given_name := BTRIM( CASE WHEN temp ~ ',' THEN REGEXP_REPLACE(temp,E'^[^,]*\\s*,\\s*([^,\\s]*)\\s*.*$',E'\\1') ELSE 'N/A' END );
349 second_given_name := BTRIM( CASE WHEN temp ~ ',' THEN REGEXP_REPLACE(temp,E'^[^,]*\\s*,\\s*[^,\\s]*\\s*(.*)$',E'\\1') ELSE '' END );
351 RETURN ARRAY[ family_name, prefix, first_given_name, second_given_name, suffix ];
353 $$ LANGUAGE PLPGSQL STRICT IMMUTABLE;
355 CREATE OR REPLACE FUNCTION migration_tools.address_parse_out_citystatezip (TEXT) RETURNS TEXT[] AS $$
357 city_state_zip TEXT := $1;
362 zip := CASE WHEN city_state_zip ~ E'\\d\\d\\d\\d\\d' THEN REGEXP_REPLACE( city_state_zip, E'^.*(\\d\\d\\d\\d\\d-?\\d*).*$', E'\\1' ) ELSE '' END;
363 city_state_zip := REGEXP_REPLACE( city_state_zip, E'^(.*)\\d\\d\\d\\d\\d-?\\d*(.*)$', E'\\1\\2');
364 IF city_state_zip ~ ',' THEN
365 state := REGEXP_REPLACE( city_state_zip, E'^(.*),(.*)$', E'\\2');
366 city := REGEXP_REPLACE( city_state_zip, E'^(.*),(.*)$', E'\\1');
368 IF city_state_zip ~ E'\\s+[A-Z][A-Z]\\s*' THEN
369 state := REGEXP_REPLACE( city_state_zip, E'^.*,?\\s+([A-Z][A-Z])\\s*.*$', E'\\1' );
370 city := REGEXP_REPLACE( city_state_zip, E'^(.*?),?\\s+[A-Z][A-Z](\\s*.*)$', E'\\1\\2' );
372 IF city_state_zip ~ E'^\\S+$' THEN
373 city := city_state_zip;
376 state := REGEXP_REPLACE( city_state_zip, E'^(.*?),?\\s*(\\S+)\\s*$', E'\\2');
377 city := REGEXP_REPLACE( city_state_zip, E'^(.*?),?\\s*(\\S+)\\s*$', E'\\1');
381 RETURN ARRAY[ TRIM(BOTH ' ' FROM city), TRIM(BOTH ' ' FROM state), TRIM(BOTH ' ' FROM zip) ];
383 $$ LANGUAGE PLPGSQL STRICT VOLATILE;
385 CREATE OR REPLACE FUNCTION migration_tools.rebarcode (o TEXT, t BIGINT) RETURNS TEXT AS $$
389 IF o ~ E'^\\d+$' AND o !~ E'^0' AND length(o) < 19 THEN -- for reference, the max value for a bigint is 9223372036854775807. May also want to consider the case where folks want to add prefixes to non-numeric barcodes
390 IF o::BIGINT < t THEN
397 $$ LANGUAGE PLPGSQL STRICT IMMUTABLE;
399 CREATE OR REPLACE FUNCTION migration_tools.base_profile_map (TEXT) RETURNS TEXT AS $$
401 migration_schema ALIAS FOR $1;
405 EXECUTE 'SELECT ''' || migration_schema || '.'' || value FROM ' || migration_schema || '.config WHERE key = ''base_profile_map'';'
410 $$ LANGUAGE PLPGSQL STRICT STABLE;
412 CREATE OR REPLACE FUNCTION migration_tools.base_item_dynamic_field_map (TEXT) RETURNS TEXT AS $$
414 migration_schema ALIAS FOR $1;
418 EXECUTE 'SELECT ''' || migration_schema || '.'' || value FROM ' || migration_schema || '.config WHERE key = ''base_item_dynamic_field_map'';'
423 $$ LANGUAGE PLPGSQL STRICT STABLE;
425 CREATE OR REPLACE FUNCTION migration_tools.base_copy_location_map (TEXT) RETURNS TEXT AS $$
427 migration_schema ALIAS FOR $1;
431 EXECUTE 'SELECT ''' || migration_schema || '.'' || value FROM ' || migration_schema || '.config WHERE key = ''base_copy_location_map'';'
436 $$ LANGUAGE PLPGSQL STRICT STABLE;
438 CREATE OR REPLACE FUNCTION migration_tools.base_circ_field_map (TEXT) RETURNS TEXT AS $$
440 migration_schema ALIAS FOR $1;
444 EXECUTE 'SELECT ''' || migration_schema || '.'' || value FROM ' || migration_schema || '.config WHERE key = ''base_circ_field_map'';'
449 $$ LANGUAGE PLPGSQL STRICT STABLE;
451 CREATE OR REPLACE FUNCTION migration_tools.map_base_patron_profile (TEXT,TEXT,INTEGER) RETURNS VOID AS $$
453 migration_schema ALIAS FOR $1;
455 patron_table ALIAS FOR $2;
456 default_patron_profile ALIAS FOR $3;
459 sql_where1 TEXT := '';
460 sql_where2 TEXT := '';
461 sql_where3 TEXT := '';
464 SELECT migration_tools.base_profile_map(migration_schema) INTO STRICT profile_map;
466 EXECUTE 'SELECT * FROM ' || profile_map || E' ORDER BY id;'
468 sql_update := 'UPDATE ' || patron_table || ' AS u SET profile = perm_grp_id FROM ' || profile_map || ' AS m WHERE ';
469 sql_where1 := NULLIF(output.legacy_field1,'') || ' = ' || quote_literal( output.legacy_value1 ) || ' AND legacy_field1 = ' || quote_literal(output.legacy_field1) || ' AND legacy_value1 = ' || quote_literal(output.legacy_value1);
470 sql_where2 := NULLIF(output.legacy_field2,'') || ' = ' || quote_literal( output.legacy_value2 ) || ' AND legacy_field2 = ' || quote_literal(output.legacy_field2) || ' AND legacy_value2 = ' || quote_literal(output.legacy_value2);
471 sql_where3 := NULLIF(output.legacy_field3,'') || ' = ' || quote_literal( output.legacy_value3 ) || ' AND legacy_field3 = ' || quote_literal(output.legacy_field3) || ' AND legacy_value3 = ' || quote_literal(output.legacy_value3);
472 sql := sql_update || COALESCE(sql_where1,'') || CASE WHEN sql_where1 <> '' AND sql_where2<> '' THEN ' AND ' ELSE '' END || COALESCE(sql_where2,'') || CASE WHEN sql_where2 <> '' AND sql_where3 <> '' THEN ' AND ' ELSE '' END || COALESCE(sql_where3,'') || ';';
473 --RAISE INFO 'sql = %', sql;
474 PERFORM migration_tools.exec( $1, sql );
476 PERFORM migration_tools.exec( $1, 'UPDATE ' || patron_table || ' AS u SET profile = ' || quote_literal(default_patron_profile) || ' WHERE profile IS NULL;' );
478 PERFORM migration_tools.exec( $1, 'INSERT INTO ' || migration_schema || '.config (key,value) VALUES ( ''last_base_patron_mapping_profile'', now() );' );
480 WHEN OTHERS THEN PERFORM migration_tools.exec( $1, 'UPDATE ' || migration_schema || '.config SET value = now() WHERE key = ''last_base_patron_mapping_profile'';' );
483 $$ LANGUAGE PLPGSQL STRICT STABLE;
485 CREATE OR REPLACE FUNCTION migration_tools.map_base_item_table_dynamic (TEXT,TEXT) RETURNS VOID AS $$
487 migration_schema ALIAS FOR $1;
489 item_table ALIAS FOR $2;
492 sql_where1 TEXT := '';
493 sql_where2 TEXT := '';
494 sql_where3 TEXT := '';
497 SELECT migration_tools.base_item_dynamic_field_map(migration_schema) INTO STRICT field_map;
499 EXECUTE 'SELECT * FROM ' || field_map || E' ORDER BY id;'
501 sql_update := 'UPDATE ' || item_table || ' AS i SET ' || output.evergreen_field || E' = ' || quote_literal(output.evergreen_value) || '::' || output.evergreen_datatype || E' FROM ' || field_map || ' AS m WHERE ';
502 sql_where1 := NULLIF(output.legacy_field1,'') || ' = ' || quote_literal( output.legacy_value1 ) || ' AND legacy_field1 = ' || quote_literal(output.legacy_field1) || ' AND legacy_value1 = ' || quote_literal(output.legacy_value1);
503 sql_where2 := NULLIF(output.legacy_field2,'') || ' = ' || quote_literal( output.legacy_value2 ) || ' AND legacy_field2 = ' || quote_literal(output.legacy_field2) || ' AND legacy_value2 = ' || quote_literal(output.legacy_value2);
504 sql_where3 := NULLIF(output.legacy_field3,'') || ' = ' || quote_literal( output.legacy_value3 ) || ' AND legacy_field3 = ' || quote_literal(output.legacy_field3) || ' AND legacy_value3 = ' || quote_literal(output.legacy_value3);
505 sql := sql_update || COALESCE(sql_where1,'') || CASE WHEN sql_where1 <> '' AND sql_where2<> '' THEN ' AND ' ELSE '' END || COALESCE(sql_where2,'') || CASE WHEN sql_where2 <> '' AND sql_where3 <> '' THEN ' AND ' ELSE '' END || COALESCE(sql_where3,'') || ';';
506 --RAISE INFO 'sql = %', sql;
507 PERFORM migration_tools.exec( $1, sql );
510 PERFORM migration_tools.exec( $1, 'INSERT INTO ' || migration_schema || '.config (key,value) VALUES ( ''last_base_item_mapping_dynamic'', now() );' );
512 WHEN OTHERS THEN PERFORM migration_tools.exec( $1, 'UPDATE ' || migration_schema || '.config SET value = now() WHERE key = ''last_base_item_mapping_dynamic'';' );
515 $$ LANGUAGE PLPGSQL STRICT VOLATILE;
517 CREATE OR REPLACE FUNCTION migration_tools.map_base_item_table_locations (TEXT,TEXT) RETURNS VOID AS $$
519 migration_schema ALIAS FOR $1;
520 base_copy_location_map TEXT;
521 item_table ALIAS FOR $2;
524 sql_where1 TEXT := '';
525 sql_where2 TEXT := '';
526 sql_where3 TEXT := '';
529 SELECT migration_tools.base_copy_location_map(migration_schema) INTO STRICT base_copy_location_map;
531 EXECUTE 'SELECT * FROM ' || base_copy_location_map || E' ORDER BY id;'
533 sql_update := 'UPDATE ' || item_table || ' AS i SET location = m.location FROM ' || base_copy_location_map || ' AS m WHERE ';
534 sql_where1 := NULLIF(output.legacy_field1,'') || ' = ' || quote_literal( output.legacy_value1 ) || ' AND legacy_field1 = ' || quote_literal(output.legacy_field1) || ' AND legacy_value1 = ' || quote_literal(output.legacy_value1);
535 sql_where2 := NULLIF(output.legacy_field2,'') || ' = ' || quote_literal( output.legacy_value2 ) || ' AND legacy_field2 = ' || quote_literal(output.legacy_field2) || ' AND legacy_value2 = ' || quote_literal(output.legacy_value2);
536 sql_where3 := NULLIF(output.legacy_field3,'') || ' = ' || quote_literal( output.legacy_value3 ) || ' AND legacy_field3 = ' || quote_literal(output.legacy_field3) || ' AND legacy_value3 = ' || quote_literal(output.legacy_value3);
537 sql := sql_update || COALESCE(sql_where1,'') || CASE WHEN sql_where1 <> '' AND sql_where2<> '' THEN ' AND ' ELSE '' END || COALESCE(sql_where2,'') || CASE WHEN sql_where2 <> '' AND sql_where3 <> '' THEN ' AND ' ELSE '' END || COALESCE(sql_where3,'') || ';';
538 --RAISE INFO 'sql = %', sql;
539 PERFORM migration_tools.exec( $1, sql );
542 PERFORM migration_tools.exec( $1, 'INSERT INTO ' || migration_schema || '.config (key,value) VALUES ( ''last_base_item_mapping_locations'', now() );' );
544 WHEN OTHERS THEN PERFORM migration_tools.exec( $1, 'UPDATE ' || migration_schema || '.config SET value = now() WHERE key = ''last_base_item_mapping_locations'';' );
547 $$ LANGUAGE PLPGSQL STRICT VOLATILE;
549 -- circulate loan period max renewals max out fine amount fine interval max fine item field 1 item value 1 item field 2 item value 2 patron field 1 patron value 1 patron field 2 patron value 2
550 CREATE OR REPLACE FUNCTION migration_tools.map_base_circ_table_dynamic (TEXT,TEXT,TEXT,TEXT) RETURNS VOID AS $$
552 migration_schema ALIAS FOR $1;
554 circ_table ALIAS FOR $2;
555 item_table ALIAS FOR $3;
556 patron_table ALIAS FOR $4;
559 sql_where1 TEXT := '';
560 sql_where2 TEXT := '';
561 sql_where3 TEXT := '';
562 sql_where4 TEXT := '';
565 SELECT migration_tools.base_circ_field_map(migration_schema) INTO STRICT field_map;
567 EXECUTE 'SELECT * FROM ' || field_map || E' ORDER BY id;'
569 sql_update := 'UPDATE ' || circ_table || ' AS c SET duration = ' || quote_literal(output.loan_period) || '::INTERVAL, renewal_remaining = ' || quote_literal(output.max_renewals) || '::INTEGER, recuring_fine = ' || quote_literal(output.fine_amount) || '::NUMERIC(6,2), fine_interval = ' || quote_literal(output.fine_interval) || '::INTERVAL, max_fine = ' || quote_literal(output.max_fine) || '::NUMERIC(6,2) FROM ' || field_map || ' AS m, ' || item_table || ' AS i, ' || patron_table || ' AS u WHERE c.usr = u.id AND c.target_copy = i.id AND ';
570 sql_where1 := NULLIF(output.item_field1,'') || ' = ' || quote_literal( output.item_value1 ) || ' AND item_field1 = ' || quote_literal(output.item_field1) || ' AND item_value1 = ' || quote_literal(output.item_value1);
571 sql_where2 := NULLIF(output.item_field2,'') || ' = ' || quote_literal( output.item_value2 ) || ' AND item_field2 = ' || quote_literal(output.item_field2) || ' AND item_value2 = ' || quote_literal(output.item_value2);
572 sql_where3 := NULLIF(output.patron_field1,'') || ' = ' || quote_literal( output.patron_value1 ) || ' AND patron_field1 = ' || quote_literal(output.patron_field1) || ' AND patron_value1 = ' || quote_literal(output.patron_value1);
573 sql_where4 := NULLIF(output.patron_field2,'') || ' = ' || quote_literal( output.patron_value2 ) || ' AND patron_field2 = ' || quote_literal(output.patron_field2) || ' AND patron_value2 = ' || quote_literal(output.patron_value2);
574 sql := sql_update || COALESCE(sql_where1,'') || CASE WHEN sql_where1 <> '' AND sql_where2<> '' THEN ' AND ' ELSE '' END || COALESCE(sql_where2,'') || CASE WHEN sql_where2 <> '' AND sql_where3 <> '' THEN ' AND ' ELSE '' END || COALESCE(sql_where3,'') || CASE WHEN sql_where3 <> '' AND sql_where4 <> '' THEN ' AND ' ELSE '' END || COALESCE(sql_where4,'') || ';';
575 --RAISE INFO 'sql = %', sql;
576 PERFORM migration_tools.exec( $1, sql );
579 PERFORM migration_tools.exec( $1, 'INSERT INTO ' || migration_schema || '.config (key,value) VALUES ( ''last_base_circ_field_mapping'', now() );' );
581 WHEN OTHERS THEN PERFORM migration_tools.exec( $1, 'UPDATE ' || migration_schema || '.config SET value = now() WHERE key = ''last_base_circ_field_mapping'';' );
584 $$ LANGUAGE PLPGSQL STRICT VOLATILE;
587 -- $barcode source barcode
588 -- $prefix prefix to add to barcode, NULL = add no prefix
589 -- $maxlen maximum length of barcode; default to 14 if left NULL
590 -- $pad padding string to apply to left of source barcode before adding
591 -- prefix and suffix; set to NULL or '' if no padding is desired
592 -- $suffix suffix to add to barcode, NULL = add no suffix
594 -- Returns a new string consisting of prefix concatenated with padded barcode and suffix.
595 -- If new barcode would be longer than $maxlen, the original barcode is returned instead.
597 CREATE OR REPLACE FUNCTION migration_tools.expand_barcode (TEXT, TEXT, INTEGER, TEXT, TEXT) RETURNS TEXT AS $$
598 my ($barcode, $prefix, $maxlen, $pad, $suffix) = @_;
601 return unless defined $barcode;
603 $prefix = '' unless defined $prefix;
605 $pad = '0' unless defined $pad;
606 $suffix = '' unless defined $suffix;
608 # bail out if adding prefix and suffix would bring new barcode over max length
609 return $barcode if (length($prefix) + length($barcode) + length($suffix)) > $maxlen;
611 my $new_barcode = $barcode;
613 my $pad_length = $maxlen - length($prefix) - length($suffix);
614 if (length($barcode) < $pad_length) {
615 # assuming we always want padding on the left
616 # also assuming that it is possible to have the pad string be longer than 1 character
617 $new_barcode = substr($pad x ($pad_length - length($barcode)), 0, $pad_length - length($barcode)) . $new_barcode;
621 # bail out if adding prefix and suffix would bring new barcode over max length
622 return $barcode if (length($prefix) + length($new_barcode) + length($suffix)) > $maxlen;
624 return "$prefix$new_barcode$suffix";
625 $$ LANGUAGE PLPERL STABLE;
627 CREATE OR REPLACE FUNCTION migration_tools.attempt_cast (TEXT,TEXT,TEXT) RETURNS RECORD AS $$
629 attempt_value ALIAS FOR $1;
630 datatype ALIAS FOR $2;
631 fail_value ALIAS FOR $3;
635 EXECUTE 'SELECT ' || quote_literal(attempt_value) || '::' || datatype || ' AS a;'
642 EXECUTE 'SELECT ' || quote_literal(fail_value) || '::' || datatype || ' AS a;'
647 $$ LANGUAGE PLPGSQL STRICT STABLE;
649 CREATE OR REPLACE FUNCTION migration_tools.attempt_date (TEXT,TEXT) RETURNS DATE AS $$
651 attempt_value ALIAS FOR $1;
652 fail_value ALIAS FOR $2;
656 EXECUTE 'SELECT ' || quote_literal(attempt_value) || '::date AS a;'
663 EXECUTE 'SELECT ' || quote_literal(fail_value) || '::date AS a;'
668 $$ LANGUAGE PLPGSQL STRICT STABLE;
670 CREATE OR REPLACE FUNCTION migration_tools.attempt_timestamptz (TEXT,TEXT) RETURNS TIMESTAMPTZ AS $$
672 attempt_value ALIAS FOR $1;
673 fail_value ALIAS FOR $2;
677 EXECUTE 'SELECT ' || quote_literal(attempt_value) || '::TIMESTAMPTZ AS a;'
684 EXECUTE 'SELECT ' || quote_literal(fail_value) || '::TIMESTAMPTZ AS a;'
689 $$ LANGUAGE PLPGSQL STRICT STABLE;
691 CREATE OR REPLACE FUNCTION migration_tools.attempt_money (TEXT,TEXT) RETURNS NUMERIC(8,2) AS $$
693 attempt_value ALIAS FOR $1;
694 fail_value ALIAS FOR $2;
698 EXECUTE 'SELECT ' || quote_literal(attempt_value) || '::NUMERIC(8,2) AS a;'
705 EXECUTE 'SELECT ' || quote_literal(fail_value) || '::NUMERIC(8,2) AS a;'
710 $$ LANGUAGE PLPGSQL STRICT STABLE;
712 -- add_codabar_checkdigit
713 -- $barcode source barcode
715 -- If the source string is 13 or 14 characters long and contains only digits, adds or replaces the 14
716 -- character with a checkdigit computed according to the usual algorithm for library barcodes
717 -- using the Codabar symbology - see <http://www.makebarcode.com/specs/codabar.html>. If the
718 -- input string does not meet those requirements, it is returned unchanged.
720 CREATE OR REPLACE FUNCTION migration_tools.add_codabar_checkdigit (TEXT) RETURNS TEXT AS $$
723 return $barcode if $barcode !~ /^\d{13,14}$/;
724 $barcode = substr($barcode, 0, 13); # ignore 14th digit
725 my @digits = split //, $barcode;
727 $total += $digits[$_] foreach (1, 3, 5, 7, 9, 11);
728 $total += (2 * $digits[$_] >= 10) ? (2 * $digits[$_] - 9) : (2 * $digits[$_]) foreach (0, 2, 4, 6, 8, 10, 12);
729 my $remainder = $total % 10;
730 my $checkdigit = ($remainder == 0) ? $remainder : 10 - $remainder;
731 return $barcode . $checkdigit;
732 $$ LANGUAGE PLPERL STRICT STABLE;
734 CREATE OR REPLACE FUNCTION migration_tools.attempt_phone (TEXT,TEXT) RETURNS TEXT AS $$
740 n_digits INTEGER := 0;
743 temp := REGEXP_REPLACE(temp, '^1*[^0-9]*(?=[0-9])', '');
744 temp := REGEXP_REPLACE(temp, '[^0-9]*([0-9]{3})[^0-9]*([0-9]{3})[^0-9]*([0-9]{4})', E'\\1-\\2-\\3');
745 n_digits := LENGTH(REGEXP_REPLACE(REGEXP_REPLACE(temp, '(.*)?[a-zA-Z].*', E'\\1') , '[^0-9]', '', 'g'));
746 IF n_digits = 7 AND areacode <> '' THEN
747 temp := REGEXP_REPLACE(temp, '[^0-9]*([0-9]{3})[^0-9]*([0-9]{4})', E'\\1-\\2');
748 output := (areacode || '-' || temp);
755 $$ LANGUAGE PLPGSQL STRICT VOLATILE;
757 CREATE OR REPLACE FUNCTION migration_tools.set_leader (TEXT, INT, TEXT) RETURNS TEXT AS $$
758 my ($marcxml, $pos, $value) = @_;
765 my $marc = MARC::Record->new_from_xml($marcxml, 'UTF-8');
766 my $leader = $marc->leader();
767 substr($leader, $pos, 1) = $value;
768 $marc->leader($leader);
769 $xml = $marc->as_xml_record;
770 $xml =~ s/^<\?.+?\?>$//mo;
772 $xml =~ s/>\s+</></sgo;
775 $$ LANGUAGE PLPERLU STABLE;
777 CREATE OR REPLACE FUNCTION migration_tools.set_008 (TEXT, INT, TEXT) RETURNS TEXT AS $$
778 my ($marcxml, $pos, $value) = @_;
785 my $marc = MARC::Record->new_from_xml($marcxml, 'UTF-8');
786 my $f008 = $marc->field('008');
789 my $field = $f008->data();
790 substr($field, $pos, 1) = $value;
791 $f008->update($field);
792 $xml = $marc->as_xml_record;
793 $xml =~ s/^<\?.+?\?>$//mo;
795 $xml =~ s/>\s+</></sgo;
799 $$ LANGUAGE PLPERLU STABLE;
802 CREATE OR REPLACE FUNCTION migration_tools.is_staff_profile (INT) RETURNS BOOLEAN AS $$
804 profile ALIAS FOR $1;
806 RETURN CASE WHEN 'Staff' IN (select (permission.grp_ancestors(profile)).name) THEN TRUE ELSE FALSE END;
808 $$ LANGUAGE PLPGSQL STRICT STABLE;
811 CREATE OR REPLACE FUNCTION migration_tools.is_blank (TEXT) RETURNS BOOLEAN AS $$
813 RETURN CASE WHEN $1 = '' THEN TRUE ELSE FALSE END;
815 $$ LANGUAGE PLPGSQL STRICT STABLE;
818 CREATE OR REPLACE FUNCTION migration_tools.insert_tags (TEXT, TEXT) RETURNS TEXT AS $$
820 my ($marcxml, $tags) = @_;
828 my $marc = MARC::Record->new_from_xml($marcxml, 'UTF-8');
829 my $to_insert = MARC::Record->new_from_xml("<record>$tags</record>", 'UTF-8');
833 foreach my $field ( $marc->fields() ) {
834 push @incumbents, $field->as_formatted();
837 foreach $field ( $to_insert->fields() ) {
838 if (!grep {$_ eq $field->as_formatted()} @incumbents) {
839 $marc->insert_fields_ordered( ($field) );
843 $xml = $marc->as_xml_record;
844 $xml =~ s/^<\?.+?\?>$//mo;
846 $xml =~ s/>\s+</></sgo;
851 $$ LANGUAGE PLPERLU STABLE;
853 CREATE OR REPLACE FUNCTION migration_tools.apply_circ_matrix( tablename TEXT ) RETURNS VOID AS $$
857 -- First make sure the circ matrix is loaded and the circulations
858 -- have been staged to the extent possible (but at the very least
859 -- circ_lib, target_copy, usr, and *_renewal). User profiles and
860 -- circ modifiers must also be in place.
862 -- SELECT migration_tools.apply_circ_matrix('m_pioneer.action_circulation');
870 this_duration_rule INT;
872 this_max_fine_rule INT;
873 rcd config.rule_circ_duration%ROWTYPE;
874 rrf config.rule_recurring_fine%ROWTYPE;
875 rmf config.rule_max_fine%ROWTYPE;
882 EXECUTE 'SELECT COUNT(*) FROM ' || tablename || ';' INTO n_circs;
884 FOR circ IN EXECUTE ('SELECT id FROM ' || tablename) LOOP
886 -- Fetch the correct rules for this circulation
893 WHEN phone_renewal OR desk_renewal OR opac_renewal THEN TRUE
896 FROM ' || tablename || ' WHERE id = ' || circ || ';')
897 INTO circ_lib, target_copy, usr, is_renewal ;
899 INTO this_duration_rule,
905 FROM action.find_circ_matrix_matchpoint(
911 SELECT INTO rcd * FROM config.rule_circ_duration
912 WHERE id = this_duration_rule;
913 SELECT INTO rrf * FROM config.rule_recurring_fine
914 WHERE id = this_fine_rule;
915 SELECT INTO rmf * FROM config.rule_max_fine
916 WHERE id = this_max_fine_rule;
918 -- Apply the rules to this circulation
919 EXECUTE ('UPDATE ' || tablename || ' c
921 duration_rule = rcd.name,
922 recurring_fine_rule = rrf.name,
923 max_fine_rule = rmf.name,
924 duration = rcd.normal,
925 recurring_fine = rrf.normal,
928 WHEN TRUE THEN (rmf.amount / 100.0) * ac.price
931 renewal_remaining = rcd.max_renewals
933 config.rule_circ_duration rcd,
934 config.rule_recurring_fine rrf,
935 config.rule_max_fine rmf,
938 rcd.id = ' || this_duration_rule || ' AND
939 rrf.id = ' || this_fine_rule || ' AND
940 rmf.id = ' || this_max_fine_rule || ' AND
941 ac.id = c.target_copy AND
942 c.id = ' || circ || ';');
944 -- Keep track of where we are in the process
946 IF (n % 100 = 0) THEN
947 RAISE INFO '%', n || ' of ' || n_circs
948 || ' (' || (100*n/n_circs) || '%) circs updated.';
958 CREATE OR REPLACE FUNCTION migration_tools.apply_circ_matrix_before_20( tablename TEXT ) RETURNS VOID AS $$
962 -- First make sure the circ matrix is loaded and the circulations
963 -- have been staged to the extent possible (but at the very least
964 -- circ_lib, target_copy, usr, and *_renewal). User profiles and
965 -- circ modifiers must also be in place.
967 -- SELECT migration_tools.apply_circ_matrix('m_pioneer.action_circulation');
975 this_duration_rule INT;
977 this_max_fine_rule INT;
978 rcd config.rule_circ_duration%ROWTYPE;
979 rrf config.rule_recurring_fine%ROWTYPE;
980 rmf config.rule_max_fine%ROWTYPE;
987 EXECUTE 'SELECT COUNT(*) FROM ' || tablename || ';' INTO n_circs;
989 FOR circ IN EXECUTE ('SELECT id FROM ' || tablename) LOOP
991 -- Fetch the correct rules for this circulation
998 WHEN phone_renewal OR desk_renewal OR opac_renewal THEN TRUE
1001 FROM ' || tablename || ' WHERE id = ' || circ || ';')
1002 INTO circ_lib, target_copy, usr, is_renewal ;
1004 INTO this_duration_rule,
1010 FROM action.find_circ_matrix_matchpoint(
1016 SELECT INTO rcd * FROM config.rule_circ_duration
1017 WHERE id = this_duration_rule;
1018 SELECT INTO rrf * FROM config.rule_recurring_fine
1019 WHERE id = this_fine_rule;
1020 SELECT INTO rmf * FROM config.rule_max_fine
1021 WHERE id = this_max_fine_rule;
1023 -- Apply the rules to this circulation
1024 EXECUTE ('UPDATE ' || tablename || ' c
1026 duration_rule = rcd.name,
1027 recuring_fine_rule = rrf.name,
1028 max_fine_rule = rmf.name,
1029 duration = rcd.normal,
1030 recuring_fine = rrf.normal,
1033 WHEN TRUE THEN (rmf.amount / 100.0) * ac.price
1036 renewal_remaining = rcd.max_renewals
1038 config.rule_circ_duration rcd,
1039 config.rule_recuring_fine rrf,
1040 config.rule_max_fine rmf,
1043 rcd.id = ' || this_duration_rule || ' AND
1044 rrf.id = ' || this_fine_rule || ' AND
1045 rmf.id = ' || this_max_fine_rule || ' AND
1046 ac.id = c.target_copy AND
1047 c.id = ' || circ || ';');
1049 -- Keep track of where we are in the process
1051 IF (n % 100 = 0) THEN
1052 RAISE INFO '%', n || ' of ' || n_circs
1053 || ' (' || (100*n/n_circs) || '%) circs updated.';
1061 $$ LANGUAGE plpgsql;
1063 CREATE OR REPLACE FUNCTION migration_tools.apply_circ_matrix_after_20( tablename TEXT ) RETURNS VOID AS $$
1067 -- First make sure the circ matrix is loaded and the circulations
1068 -- have been staged to the extent possible (but at the very least
1069 -- circ_lib, target_copy, usr, and *_renewal). User profiles and
1070 -- circ modifiers must also be in place.
1072 -- SELECT migration_tools.apply_circ_matrix('m_pioneer.action_circulation');
1080 this_duration_rule INT;
1082 this_max_fine_rule INT;
1083 rcd config.rule_circ_duration%ROWTYPE;
1084 rrf config.rule_recurring_fine%ROWTYPE;
1085 rmf config.rule_max_fine%ROWTYPE;
1092 EXECUTE 'SELECT COUNT(*) FROM ' || tablename || ';' INTO n_circs;
1094 FOR circ IN EXECUTE ('SELECT id FROM ' || tablename) LOOP
1096 -- Fetch the correct rules for this circulation
1103 WHEN phone_renewal OR desk_renewal OR opac_renewal THEN TRUE
1106 FROM ' || tablename || ' WHERE id = ' || circ || ';')
1107 INTO circ_lib, target_copy, usr, is_renewal ;
1109 INTO this_duration_rule,
1112 (matchpoint).duration_rule,
1113 (matchpoint).recurring_fine_rule,
1114 (matchpoint).max_fine_rule
1115 FROM action.find_circ_matrix_matchpoint(
1121 SELECT INTO rcd * FROM config.rule_circ_duration
1122 WHERE id = this_duration_rule;
1123 SELECT INTO rrf * FROM config.rule_recurring_fine
1124 WHERE id = this_fine_rule;
1125 SELECT INTO rmf * FROM config.rule_max_fine
1126 WHERE id = this_max_fine_rule;
1128 -- Apply the rules to this circulation
1129 EXECUTE ('UPDATE ' || tablename || ' c
1131 duration_rule = rcd.name,
1132 recurring_fine_rule = rrf.name,
1133 max_fine_rule = rmf.name,
1134 duration = rcd.normal,
1135 recurring_fine = rrf.normal,
1138 WHEN TRUE THEN (rmf.amount / 100.0) * ac.price
1141 renewal_remaining = rcd.max_renewals
1143 config.rule_circ_duration rcd,
1144 config.rule_recurring_fine rrf,
1145 config.rule_max_fine rmf,
1148 rcd.id = ' || this_duration_rule || ' AND
1149 rrf.id = ' || this_fine_rule || ' AND
1150 rmf.id = ' || this_max_fine_rule || ' AND
1151 ac.id = c.target_copy AND
1152 c.id = ' || circ || ';');
1154 -- Keep track of where we are in the process
1156 IF (n % 100 = 0) THEN
1157 RAISE INFO '%', n || ' of ' || n_circs
1158 || ' (' || (100*n/n_circs) || '%) circs updated.';
1166 $$ LANGUAGE plpgsql;
1171 CREATE OR REPLACE FUNCTION migration_tools.stage_not_applicable_asset_stat_cats( schemaname TEXT ) RETURNS VOID AS $$
1173 -- USAGE: Make sure the stat_cat and stat_cat_entry tables are populated, including exactly one 'Not Applicable' entry per stat cat.
1174 -- Then SELECT migration_tools.stage_not_applicable_asset_stat_cats('m_foo');
1176 -- TODO: Make a variant that will go directly to production tables -- which would be useful for retrofixing the absence of N/A cats.
1177 -- TODO: Add a similar tool for actor stat cats, which behave differently.
1180 c TEXT := schemaname || '.asset_copy_legacy';
1181 sc TEXT := schemaname || '.asset_stat_cat';
1182 sce TEXT := schemaname || '.asset_stat_cat_entry';
1183 scecm TEXT := schemaname || '.asset_stat_cat_entry_copy_map';
1189 FOR stat_cat IN EXECUTE ('SELECT id FROM ' || sc) LOOP
1191 EXECUTE ('SELECT id FROM ' || sce || ' WHERE stat_cat = ' || stat_cat || E' AND value = \'Not Applicable\';') INTO stat_cat_entry;
1193 EXECUTE ('INSERT INTO ' || scecm || ' (owning_copy, stat_cat, stat_cat_entry)
1194 SELECT c.id, ' || stat_cat || ', ' || stat_cat_entry || ' FROM ' || c || ' c WHERE c.id NOT IN
1195 (SELECT owning_copy FROM ' || scecm || ' WHERE stat_cat = ' || stat_cat || ');');
1202 $$ LANGUAGE plpgsql;
1204 CREATE OR REPLACE FUNCTION migration_tools.assign_standing_penalties ( ) RETURNS VOID AS $$
1206 -- USAGE: Once circulation data has been loaded, and group penalty thresholds have been set up, run this.
1207 -- This will assign standing penalties as needed.
1215 FOR org_unit IN EXECUTE ('SELECT DISTINCT org_unit FROM permission.grp_penalty_threshold;') LOOP
1217 FOR usr IN EXECUTE ('SELECT id FROM actor.usr WHERE NOT deleted;') LOOP
1219 EXECUTE('SELECT actor.calculate_system_penalties(' || usr || ', ' || org_unit || ');');
1229 $$ LANGUAGE plpgsql;
1232 CREATE OR REPLACE FUNCTION migration_tools.insert_metarecords_for_pristine_database () RETURNS VOID AS $$
1235 INSERT INTO metabib.metarecord (fingerprint, master_record)
1236 SELECT DISTINCT ON (b.fingerprint) b.fingerprint, b.id
1237 FROM biblio.record_entry b
1239 AND b.id IN (SELECT r.id FROM biblio.record_entry r LEFT JOIN metabib.metarecord_source_map k ON (k.source = r.id) WHERE k.id IS NULL AND r.fingerprint IS NOT NULL)
1240 AND NOT EXISTS ( SELECT 1 FROM metabib.metarecord WHERE fingerprint = b.fingerprint )
1241 ORDER BY b.fingerprint, b.quality DESC;
1242 INSERT INTO metabib.metarecord_source_map (metarecord, source)
1244 FROM biblio.record_entry r
1245 JOIN metabib.metarecord m USING (fingerprint)
1246 WHERE NOT r.deleted;
1249 $$ LANGUAGE plpgsql;
1252 CREATE OR REPLACE FUNCTION migration_tools.insert_metarecords_for_incumbent_database () RETURNS VOID AS $$
1255 INSERT INTO metabib.metarecord (fingerprint, master_record)
1256 SELECT DISTINCT ON (b.fingerprint) b.fingerprint, b.id
1257 FROM biblio.record_entry b
1259 AND b.id IN (SELECT r.id FROM biblio.record_entry r LEFT JOIN metabib.metarecord_source_map k ON (k.source = r.id) WHERE k.id IS NULL AND r.fingerprint IS NOT NULL)
1260 AND NOT EXISTS ( SELECT 1 FROM metabib.metarecord WHERE fingerprint = b.fingerprint )
1261 ORDER BY b.fingerprint, b.quality DESC;
1262 INSERT INTO metabib.metarecord_source_map (metarecord, source)
1264 FROM biblio.record_entry r
1265 JOIN metabib.metarecord m USING (fingerprint)
1267 AND r.id IN (SELECT b.id FROM biblio.record_entry b LEFT JOIN metabib.metarecord_source_map k ON (k.source = b.id) WHERE k.id IS NULL);
1270 $$ LANGUAGE plpgsql;
1273 CREATE OR REPLACE FUNCTION migration_tools.create_cards( schemaname TEXT ) RETURNS VOID AS $$
1275 -- USAGE: Make sure the patrons are staged in schemaname.actor_usr_legacy and have 'usrname' assigned.
1276 -- Then SELECT migration_tools.create_cards('m_foo');
1279 u TEXT := schemaname || '.actor_usr_legacy';
1280 c TEXT := schemaname || '.actor_card';
1284 EXECUTE ('DELETE FROM ' || c || ';');
1285 EXECUTE ('INSERT INTO ' || c || ' (usr, barcode) SELECT id, usrname FROM ' || u || ';');
1286 EXECUTE ('UPDATE ' || u || ' u SET card = c.id FROM ' || c || ' c WHERE c.usr = u.id;');
1292 $$ LANGUAGE plpgsql;
1295 CREATE OR REPLACE FUNCTION migration_tools.insert_856_9 (TEXT, TEXT) RETURNS TEXT AS $$
1297 ## USAGE: UPDATE biblio.record_entry SET marc = migration_tools.insert_856_9(marc, 'ABC') WHERE [...];
1299 my ($marcxml, $shortname) = @_;
1302 use MARC::File::XML;
1307 my $marc = MARC::Record->new_from_xml($marcxml, 'UTF-8');
1309 foreach my $field ( $marc->field('856') ) {
1310 if ( scalar(grep( /(contentreserve|netlibrary|overdrive)\.com/i, $field->subfield('u'))) > 0 &&
1311 ! ( $field->as_string('9') =~ m/$shortname/ ) ) {
1312 $field->add_subfields( '9' => $shortname );
1313 $field->update( ind2 => '0');
1317 $xml = $marc->as_xml_record;
1318 $xml =~ s/^<\?.+?\?>$//mo;
1320 $xml =~ s/>\s+</></sgo;
1325 $$ LANGUAGE PLPERLU STABLE;
1327 CREATE OR REPLACE FUNCTION migration_tools.change_call_number(copy_id BIGINT, new_label TEXT) RETURNS VOID AS $$
1339 -- Bail out if asked to change the label to ##URI##
1340 IF new_label = '##URI##' THEN
1344 -- Gather information
1345 SELECT call_number INTO old_volume FROM asset.copy WHERE id = copy_id;
1346 SELECT record INTO bib FROM asset.call_number WHERE id = old_volume;
1347 SELECT owning_lib, label INTO owner, old_label FROM asset.call_number WHERE id = old_volume;
1349 -- Bail out if the label already is ##URI##
1350 IF old_label = '##URI##' THEN
1354 -- Bail out if the call number label is already correct
1355 IF new_volume = old_volume THEN
1359 -- Check whether we already have a destination volume available
1360 SELECT id INTO new_volume FROM asset.call_number
1363 owning_lib = owner AND
1364 label = new_label AND
1367 -- Create destination volume if needed
1369 INSERT INTO asset.call_number (creator, editor, record, owning_lib, label)
1370 VALUES (1, 1, bib, owner, new_label);
1371 SELECT id INTO new_volume FROM asset.call_number
1374 owning_lib = owner AND
1375 label = new_label AND
1379 -- Move copy to destination
1380 UPDATE asset.copy SET call_number = new_volume WHERE id = copy_id;
1382 -- Delete source volume if it is now empty
1383 SELECT id INTO remainder FROM asset.copy WHERE call_number = old_volume AND NOT deleted;
1385 DELETE FROM asset.call_number WHERE id = old_volume;
1390 $$ LANGUAGE plpgsql;
1392 CREATE OR REPLACE FUNCTION migration_tools.zip_to_city_state_county (TEXT) RETURNS TEXT[] AS $$
1397 open (FH, '<', '/openils/var/data/zips.txt') or return ('No File Found', 'No File Found', 'No File Found');
1401 my ($junk, $state, $city, $zip, $foo, $bar, $county, $baz, $morejunk) = split(/\|/);
1402 $zipdata{$zip} = [$city, $state, $county];
1405 if (defined $zipdata{$input}) {
1406 my ($city, $state, $county) = @{$zipdata{$input}};
1407 return [$city, $state, $county];
1408 } elsif (defined $zipdata{substr $input, 0, 5}) {
1409 my ($city, $state, $county) = @{$zipdata{substr $input, 0, 5}};
1410 return [$city, $state, $county];
1412 return ['ZIP not found', 'ZIP not found', 'ZIP not found'];
1415 $$ LANGUAGE PLPERLU STABLE;
1417 CREATE OR REPLACE FUNCTION migration_tools.check_ou_depth ( ) RETURNS VOID AS $$
1424 errors_found BOOLEAN;
1426 parent_shortname TEXT;
1432 type_parent_depth INT;
1437 errors_found := FALSE;
1439 -- Checking actor.org_unit_type
1441 FOR type_id IN EXECUTE ('SELECT id FROM actor.org_unit_type ORDER BY id;') LOOP
1443 SELECT depth FROM actor.org_unit_type WHERE id = type_id INTO type_depth;
1444 SELECT parent FROM actor.org_unit_type WHERE id = type_id INTO type_parent;
1446 IF type_parent IS NOT NULL THEN
1448 SELECT depth FROM actor.org_unit_type WHERE id = type_parent INTO type_parent_depth;
1450 IF type_depth - type_parent_depth <> 1 THEN
1451 SELECT name FROM actor.org_unit_type WHERE id = type_id INTO ou_type_name;
1452 SELECT name FROM actor.org_unit_type WHERE id = type_parent INTO parent_type;
1453 RAISE INFO 'The % org unit type has a depth of %, but its parent org unit type, %, has a depth of %.',
1454 ou_type_name, type_depth, parent_type, type_parent_depth;
1455 errors_found := TRUE;
1463 -- Checking actor.org_unit
1465 FOR ou IN EXECUTE ('SELECT id FROM actor.org_unit ORDER BY shortname;') LOOP
1467 SELECT parent_ou FROM actor.org_unit WHERE id = ou INTO ou_parent;
1468 SELECT t.depth FROM actor.org_unit_type t, actor.org_unit o WHERE o.ou_type = t.id and o.id = ou INTO org_unit_depth;
1469 SELECT t.depth FROM actor.org_unit_type t, actor.org_unit o WHERE o.ou_type = t.id and o.id = ou_parent INTO parent_depth;
1470 SELECT shortname FROM actor.org_unit WHERE id = ou INTO ou_shortname;
1471 SELECT shortname FROM actor.org_unit WHERE id = ou_parent INTO parent_shortname;
1472 SELECT t.name FROM actor.org_unit_type t, actor.org_unit o WHERE o.ou_type = t.id and o.id = ou INTO ou_type_name;
1473 SELECT t.name FROM actor.org_unit_type t, actor.org_unit o WHERE o.ou_type = t.id and o.id = ou_parent INTO parent_type;
1475 IF ou_parent IS NOT NULL THEN
1477 IF (org_unit_depth - parent_depth <> 1) OR (
1478 (SELECT parent FROM actor.org_unit_type WHERE name = ou_type_name) <> (SELECT id FROM actor.org_unit_type WHERE name = parent_type)
1480 RAISE INFO '% (org unit %) is a % (depth %) but its parent, % (org unit %), is a % (depth %).',
1481 ou_shortname, ou, ou_type_name, org_unit_depth, parent_shortname, ou_parent, parent_type, parent_depth;
1482 errors_found := TRUE;
1489 IF NOT errors_found THEN
1490 RAISE INFO 'No errors found.';
1497 $$ LANGUAGE plpgsql;
1500 CREATE OR REPLACE FUNCTION migration_tools.refresh_opac_visible_copies ( ) RETURNS VOID AS $$
1504 DELETE FROM asset.opac_visible_copies;
1506 INSERT INTO asset.opac_visible_copies (id, circ_lib, record)
1508 cp.id, cp.circ_lib, cn.record
1511 JOIN asset.call_number cn ON (cn.id = cp.call_number)
1512 JOIN actor.org_unit a ON (cp.circ_lib = a.id)
1513 JOIN asset.copy_location cl ON (cp.location = cl.id)
1514 JOIN config.copy_status cs ON (cp.status = cs.id)
1515 JOIN biblio.record_entry b ON (cn.record = b.id)
1524 cp.id NOT IN (SELECT id FROM asset.opac_visible_copies);
1528 $$ LANGUAGE plpgsql;
1531 CREATE OR REPLACE FUNCTION migration_tools.change_owning_lib(copy_id BIGINT, new_owning_lib INTEGER) RETURNS VOID AS $$
1537 old_owning_lib INTEGER;
1543 -- Gather information
1544 SELECT call_number INTO old_volume FROM asset.copy WHERE id = copy_id;
1545 SELECT record INTO bib FROM asset.call_number WHERE id = old_volume;
1546 SELECT owning_lib, label INTO old_owning_lib, old_label FROM asset.call_number WHERE id = old_volume;
1548 -- Bail out if the new_owning_lib is not the ID of an org_unit
1549 IF new_owning_lib NOT IN (SELECT id FROM actor.org_unit) THEN
1551 '% is not a valid actor.org_unit ID; no change made.',
1556 -- Bail out discreetly if the owning_lib is already correct
1557 IF new_owning_lib = old_owning_lib THEN
1561 -- Check whether we already have a destination volume available
1562 SELECT id INTO new_volume FROM asset.call_number
1565 owning_lib = new_owning_lib AND
1566 label = old_label AND
1569 -- Create destination volume if needed
1571 INSERT INTO asset.call_number (creator, editor, record, owning_lib, label)
1572 VALUES (1, 1, bib, new_owning_lib, old_label);
1573 SELECT id INTO new_volume FROM asset.call_number
1576 owning_lib = new_owning_lib AND
1577 label = old_label AND
1581 -- Move copy to destination
1582 UPDATE asset.copy SET call_number = new_volume WHERE id = copy_id;
1584 -- Delete source volume if it is now empty
1585 SELECT id INTO remainder FROM asset.copy WHERE call_number = old_volume AND NOT deleted;
1587 DELETE FROM asset.call_number WHERE id = old_volume;
1592 $$ LANGUAGE plpgsql;
1595 CREATE OR REPLACE FUNCTION migration_tools.change_owning_lib(copy_id BIGINT, new_owner TEXT) RETURNS VOID AS $$
1597 -- You can use shortnames with this function, which looks up the org unit ID and passes it to change_owning_lib(BIGINT,INTEGER).
1600 new_owning_lib INTEGER;
1604 -- Parse the new_owner as an org unit ID or shortname
1605 IF new_owner IN (SELECT shortname FROM actor.org_unit) THEN
1606 SELECT id INTO new_owning_lib FROM actor.org_unit WHERE shortname = new_owner;
1607 PERFORM migration_tools.change_owning_lib(copy_id, new_owning_lib);
1608 ELSIF new_owner ~ E'^[0-9]+$' THEN
1609 IF new_owner::INTEGER IN (SELECT id FROM actor.org_unit) THEN
1612 E'You don\'t need to put the actor.org_unit ID in quotes; '
1613 || E'if you put it in quotes, I\'m going to try to parse it as a shortname first.';
1614 new_owning_lib := new_owner::INTEGER;
1615 PERFORM migration_tools.change_owning_lib(copy_id, new_owning_lib);
1619 '% is not a valid actor.org_unit shortname or ID; no change made.',
1626 $$ LANGUAGE plpgsql;
1628 CREATE OR REPLACE FUNCTION migration_tools.marc_parses( TEXT ) RETURNS BOOLEAN AS $func$
1631 use MARC::File::XML (BinaryEncoding => 'UTF-8');
1634 MARC::Charset->assume_unicode(1);
1638 eval { my $r = MARC::Record->new_from_xml( $xml ); };
1645 $func$ LANGUAGE PLPERLU;
1646 COMMENT ON FUNCTION migration_tools.marc_parses(TEXT) IS 'Return boolean indicating if MARCXML string is parseable by MARC::File::XML';