2 * Copyright (C) 2004-2008 Georgia Public Library Service
3 * Copyright (C) 2008 Equinox Software, Inc.
4 * Mike Rylander <miker@esilibrary.com>
6 * This program is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU General Public License
8 * as published by the Free Software Foundation; either version 2
9 * of the License, or (at your option) any later version.
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
22 CREATE OR REPLACE FUNCTION oils_xml_transform ( TEXT, TEXT ) RETURNS TEXT AS $_$
23 SELECT CASE WHEN (SELECT COUNT(*) FROM config.xml_transform WHERE name = $2 AND xslt = '---') > 0 THEN $1
24 ELSE xslt_process($1, (SELECT xslt FROM config.xml_transform WHERE name = $2))
26 $_$ LANGUAGE SQL STRICT IMMUTABLE;
28 CREATE OR REPLACE FUNCTION public.extract_marc_field ( TEXT, BIGINT, TEXT, TEXT ) RETURNS TEXT AS $$
29 SELECT regexp_replace(array_to_string( array_accum( output ),' ' ),$4,'','g') FROM oils_xpath_table('id', 'marc', $1, $3, 'id='||$2)x(id INT, output TEXT);
32 CREATE OR REPLACE FUNCTION oils_xml_uncache (xml TEXT) RETURNS BOOL AS $func$
33 delete $_SHARED{'_xslt_process'}{docs}{shift()};
35 $func$ LANGUAGE PLPERLU;
37 CREATE OR REPLACE FUNCTION oils_xml_cache (xml TEXT) RETURNS BOOL AS $func$
43 # The following approach uses the older XML::LibXML 1.69 / XML::LibXSLT 1.68
44 # methods of parsing XML documents and stylesheets, in the hopes of broader
45 # compatibility with distributions
46 my $parser = $_SHARED{'_xslt_process'}{parsers}{xml} || XML::LibXML->new();
48 # Cache the XML parser, if we do not already have one
49 $_SHARED{'_xslt_process'}{parsers}{xml} = $parser
50 unless ($_SHARED{'_xslt_process'}{parsers}{xml});
52 # Parse and cache the doc
53 eval { $_SHARED{'_xslt_process'}{docs}{$doc} = $parser->parse_string($doc) };
57 $func$ LANGUAGE PLPERLU;
59 -- if we use these, we need to ...
60 drop function oils_xpath(text, text, anyarray);
62 CREATE OR REPLACE FUNCTION oils_xpath (xpath TEXT, xml TEXT, ns TEXT[][]) RETURNS TEXT[] AS $func$
68 my $ns_string = shift || '';
69 #elog(NOTICE,"ns_string: $ns_string");
71 my %ns_list = $ns_string =~ m/\{([^{,]+),([^}]+)\}/g;
72 #elog(NOTICE,"NS Prefix $_: $ns_list{$_}") for (keys %ns_list);
74 # The following approach uses the older XML::LibXML 1.69 / XML::LibXSLT 1.68
75 # methods of parsing XML documents and stylesheets, in the hopes of broader
76 # compatibility with distributions
77 my $parser = eval { $_SHARED{'_xslt_process'}{parsers}{xml} || XML::LibXML->new() };
81 # Cache the XML parser, if we do not already have one
82 $_SHARED{'_xslt_process'}{parsers}{xml} = $parser
83 unless ($_SHARED{'_xslt_process'}{parsers}{xml});
85 # Look for a cached version of the doc, or parse it if none
86 my $dom = eval { $_SHARED{'_xslt_process'}{docs}{$doc} || $parser->parse_string($doc) };
90 # Cache the parsed XML doc, if already there
91 $_SHARED{'_xslt_process'}{docs}{$doc} = $dom
92 unless ($_SHARED{'_xslt_process'}{docs}{$doc});
94 # Register the requested namespaces
95 $dom->documentElement->setNamespace( $ns_list{$_} => $_ ) for ( keys %ns_list );
97 # Gather and return nodes
98 my @nodes = $dom->findnodes($xpath);
99 #elog(NOTICE,"nodes found by $xpath: ". scalar(@nodes));
101 return [ map { $_->toString } @nodes ];
102 $func$ LANGUAGE PLPERLU;
104 CREATE OR REPLACE FUNCTION oils_xpath ( TEXT, TEXT ) RETURNS TEXT[] AS $$SELECT oils_xpath( $1, $2, '{}'::TEXT[] );$$ LANGUAGE SQL IMMUTABLE;
108 CREATE FUNCTION version_specific_xpath () RETURNS TEXT AS $wrapper_function$
113 IF REGEXP_REPLACE(VERSION(),E'^.+?(\\d+\\.\\d+).*?$',E'\\1')::FLOAT < 8.3 THEN
114 out_text := 'Creating XPath functions that work like the native XPATH function in 8.3+';
116 EXECUTE $create_82_funcs$
118 CREATE OR REPLACE FUNCTION oils_xpath ( xpath TEXT, xml TEXT, ns ANYARRAY ) RETURNS TEXT[] AS $func$
125 munged_xpath := xpath;
127 IF ns IS NOT NULL AND array_upper(ns, 1) IS NOT NULL THEN
128 FOR namespace IN 1 .. array_upper(ns, 1) LOOP
129 munged_xpath := REGEXP_REPLACE(
131 E'(' || ns[namespace][1] || E'):(\\w+)',
132 E'*[local-name() = "\\2" and namespace-uri() = "' || ns[namespace][2] || E'"]',
137 munged_xpath := REGEXP_REPLACE( munged_xpath, E'\\]\\[(\\D)',E' and \\1', 'g');
140 -- RAISE NOTICE 'munged xpath: %', munged_xpath;
142 node_text := xpath_nodeset(xml, munged_xpath, 'XXX_OILS_NODESET');
143 -- RAISE NOTICE 'node_text: %', node_text;
145 IF munged_xpath ~ $re$/[^/[]*@[^/]+$$re$ THEN
146 node_text := REGEXP_REPLACE(node_text,'<XXX_OILS_NODESET>[^"]+"', '<XXX_OILS_NODESET>', 'g');
147 node_text := REGEXP_REPLACE(node_text,'"</XXX_OILS_NODESET>', '</XXX_OILS_NODESET>', 'g');
150 node_text := REGEXP_REPLACE(node_text,'^<XXX_OILS_NODESET>', '');
151 node_text := REGEXP_REPLACE(node_text,'</XXX_OILS_NODESET>$', '');
153 RETURN STRING_TO_ARRAY(node_text, '</XXX_OILS_NODESET><XXX_OILS_NODESET>');
155 $func$ LANGUAGE PLPGSQL IMMUTABLE;
157 CREATE OR REPLACE FUNCTION oils_xpath ( TEXT, TEXT ) RETURNS TEXT[] AS $$SELECT oils_xpath( $1, $2, '{}'::TEXT[] );$$ LANGUAGE SQL IMMUTABLE;
159 CREATE OR REPLACE FUNCTION oils_xslt_process(TEXT, TEXT) RETURNS TEXT AS $$
160 SELECT xslt_process( $1, $2 );
161 $$ LANGUAGE SQL IMMUTABLE;
164 ELSIF REGEXP_REPLACE(VERSION(),E'^.+?(\\d+\\.\\d+).*?$',E'\\1')::FLOAT = 8.3 THEN
165 out_text := 'Creating XPath wrapper functions around the native XPATH function in 8.3. contrib/xml2 still required!';
167 EXECUTE $create_83_funcs$
169 CREATE OR REPLACE FUNCTION oils_xpath ( TEXT, TEXT, ANYARRAY ) RETURNS TEXT[] AS 'SELECT XPATH( $1, $2::XML, $3 )::TEXT[];' LANGUAGE SQL IMMUTABLE;
170 CREATE OR REPLACE FUNCTION oils_xpath ( TEXT, TEXT ) RETURNS TEXT[] AS 'SELECT XPATH( $1, $2::XML )::TEXT[];' LANGUAGE SQL IMMUTABLE;
172 CREATE OR REPLACE FUNCTION oils_xslt_process(TEXT, TEXT) RETURNS TEXT AS $$
173 SELECT xslt_process( $1, $2 );
174 $$ LANGUAGE SQL IMMUTABLE;
179 out_text := 'Creating XPath wrapper functions around the native XPATH function in 8.4+, and plperlu-based xslt processor. No contrib/xml2 needed!';
181 EXECUTE $create_84_funcs$
183 CREATE OR REPLACE FUNCTION oils_xpath ( TEXT, TEXT, ANYARRAY ) RETURNS TEXT[] AS 'SELECT XPATH( $1, $2::XML, $3 )::TEXT[];' LANGUAGE SQL IMMUTABLE;
184 CREATE OR REPLACE FUNCTION oils_xpath ( TEXT, TEXT ) RETURNS TEXT[] AS 'SELECT XPATH( $1, $2::XML )::TEXT[];' LANGUAGE SQL IMMUTABLE;
186 CREATE OR REPLACE FUNCTION oils_xslt_process(TEXT, TEXT) RETURNS TEXT AS $func$
195 # The following approach uses the older XML::LibXML 1.69 / XML::LibXSLT 1.68
196 # methods of parsing XML documents and stylesheets, in the hopes of broader
197 # compatibility with distributions
198 my $parser = $_SHARED{'_xslt_process'}{parsers}{xml} || XML::LibXML->new();
200 # Cache the XML parser, if we do not already have one
201 $_SHARED{'_xslt_process'}{parsers}{xml} = $parser
202 unless ($_SHARED{'_xslt_process'}{parsers}{xml});
204 my $xslt_parser = $_SHARED{'_xslt_process'}{parsers}{xslt} || XML::LibXSLT->new();
206 # Cache the XSLT processor, if we do not already have one
207 $_SHARED{'_xslt_process'}{parsers}{xslt} = $xslt_parser
208 unless ($_SHARED{'_xslt_process'}{parsers}{xslt});
210 my $stylesheet = $_SHARED{'_xslt_process'}{stylesheets}{$xslt} ||
211 $xslt_parser->parse_stylesheet( $parser->parse_string($xslt) );
213 $_SHARED{'_xslt_process'}{stylesheets}{$xslt} = $stylesheet
214 unless ($_SHARED{'_xslt_process'}{stylesheets}{$xslt});
216 return $stylesheet->output_string(
217 $stylesheet->transform(
218 $parser->parse_string($doc)
222 $func$ LANGUAGE 'plperlu' STRICT IMMUTABLE;
230 $wrapper_function$ LANGUAGE PLPGSQL;
232 SELECT version_specific_xpath();
233 DROP FUNCTION version_specific_xpath();
236 CREATE OR REPLACE FUNCTION oils_xpath_string ( TEXT, TEXT, TEXT, ANYARRAY ) RETURNS TEXT AS $func$
237 SELECT ARRAY_TO_STRING(
240 CASE WHEN $1 ~ $re$/[^/[]*@[^]]+$$re$ OR $1 ~ $re$text\(\)$$re$ THEN '' ELSE '//text()' END,
246 $func$ LANGUAGE SQL IMMUTABLE;
248 CREATE OR REPLACE FUNCTION oils_xpath_string ( TEXT, TEXT, TEXT ) RETURNS TEXT AS $func$
249 SELECT oils_xpath_string( $1, $2, $3, '{}'::TEXT[] );
250 $func$ LANGUAGE SQL IMMUTABLE;
252 CREATE OR REPLACE FUNCTION oils_xpath_string ( TEXT, TEXT, ANYARRAY ) RETURNS TEXT AS $func$
253 SELECT oils_xpath_string( $1, $2, '', $3 );
254 $func$ LANGUAGE SQL IMMUTABLE;
256 CREATE OR REPLACE FUNCTION oils_xpath_string ( TEXT, TEXT ) RETURNS TEXT AS $func$
257 SELECT oils_xpath_string( $1, $2, '{}'::TEXT[] );
258 $func$ LANGUAGE SQL IMMUTABLE;
261 CREATE OR REPLACE FUNCTION oils_xpath_table ( key TEXT, document_field TEXT, relation_name TEXT, xpaths TEXT, criteria TEXT ) RETURNS SETOF RECORD AS $func$
270 xpath_list := STRING_TO_ARRAY( xpaths, '|' );
272 select_list := ARRAY_APPEND( select_list, key || '::INT AS key' );
274 FOR i IN 1 .. ARRAY_UPPER(xpath_list,1) LOOP
275 select_list := ARRAY_APPEND(
285 WHEN xpath_list[i] ~ $re$/[^/[]*@[^/]+$$re$ OR xpath_list[i] ~ $re$text\(\)$$re$ THEN xpath_list[i]
286 ELSE xpath_list[i] || '//text()'
290 $sel$ || document_field || $sel$
298 where_list := ARRAY_APPEND(
300 'c_' || i || ' IS NOT NULL'
306 SELECT $q$ || ARRAY_TO_STRING( select_list, ', ' ) || $q$ FROM $q$ || relation_name || $q$ WHERE ($q$ || criteria || $q$)
307 )x WHERE $q$ || ARRAY_TO_STRING( where_list, ' AND ' );
308 -- RAISE NOTICE 'query: %', q;
310 FOR out_record IN EXECUTE q LOOP
311 RETURN NEXT out_record;
316 $func$ LANGUAGE PLPGSQL IMMUTABLE;
319 CREATE OR REPLACE FUNCTION extract_marc_field ( TEXT, BIGINT, TEXT, TEXT ) RETURNS TEXT AS $$
325 SELECT regexp_replace(
327 $q$ || quote_literal($3) || $q$,
331 $q$ || quote_literal($4) || $q$,
334 FROM $q$ || $1 || $q$
335 WHERE id = $q$ || $2;
337 EXECUTE query INTO output;
339 -- RAISE NOTICE 'query: %, output; %', query, output;
343 $$ LANGUAGE PLPGSQL IMMUTABLE;
345 CREATE OR REPLACE FUNCTION extract_marc_field ( TEXT, BIGINT, TEXT ) RETURNS TEXT AS $$
346 SELECT extract_marc_field($1,$2,$3,'');
347 $$ LANGUAGE SQL IMMUTABLE;
351 CREATE OR REPLACE FUNCTION oils_i18n_xlate ( keytable TEXT, keyclass TEXT, keycol TEXT, identcol TEXT, keyvalue TEXT, raw_locale TEXT ) RETURNS TEXT AS $func$
353 locale TEXT := REGEXP_REPLACE( REGEXP_REPLACE( raw_locale, E'[;, ].+$', '' ), E'_', '-', 'g' );
354 language TEXT := REGEXP_REPLACE( locale, E'-.+$', '' );
355 result config.i18n_core%ROWTYPE;
357 keyfield TEXT := keyclass || '.' || keycol;
360 -- Try the full locale
362 FROM config.i18n_core
363 WHERE fq_field = keyfield
364 AND identity_value = keyvalue
365 AND translation = locale;
367 -- Try just the language
370 FROM config.i18n_core
371 WHERE fq_field = keyfield
372 AND identity_value = keyvalue
373 AND translation = language;
376 -- Fall back to the string we passed in in the first place
381 ' FROM ' || keytable ||
382 ' WHERE ' || identcol || ' = ' || quote_literal(keyvalue)
387 RETURN result.string;
389 $func$ LANGUAGE PLPGSQL STABLE;
391 -- Functions for marking translatable strings in SQL statements
392 -- Parameters are: primary key, string, class hint, property
393 CREATE OR REPLACE FUNCTION oils_i18n_gettext( INT, TEXT, TEXT, TEXT ) RETURNS TEXT AS $$
397 CREATE OR REPLACE FUNCTION oils_i18n_gettext( TEXT, TEXT, TEXT, TEXT ) RETURNS TEXT AS $$
401 CREATE OR REPLACE FUNCTION is_json( TEXT ) RETURNS BOOL AS $f$
404 eval { JSON::XS->new->allow_nonref->decode( $json ) };
406 $f$ LANGUAGE PLPERLU;
408 -- turn a JSON scalar into an SQL TEXT value
409 CREATE OR REPLACE FUNCTION oils_json_to_text( TEXT ) RETURNS TEXT AS $f$
413 eval { $txt = JSON::XS->new->allow_nonref->decode( $json ) };
414 return undef if ($@);
416 $f$ LANGUAGE PLPERLU;
418 CREATE OR REPLACE FUNCTION maintain_901 () RETURNS TRIGGER AS $func$
420 -- Remove any existing 901 fields before we insert the authoritative one
421 NEW.marc := REGEXP_REPLACE(NEW.marc, E'<datafield\s*[^<>]*?\s*tag="901".+?</datafield>', '', 'g');
422 IF TG_TABLE_SCHEMA = 'biblio' THEN
423 NEW.marc := REGEXP_REPLACE(
425 E'(</(?:[^:]*?:)?record>)',
426 E'<datafield tag="901" ind1=" " ind2=" ">' ||
427 '<subfield code="a">' || NEW.tcn_value || E'</subfield>' ||
428 '<subfield code="b">' || NEW.tcn_source || E'</subfield>' ||
429 '<subfield code="c">' || NEW.id || E'</subfield>' ||
430 '<subfield code="t">' || TG_TABLE_SCHEMA || E'</subfield>' ||
431 CASE WHEN NEW.owner IS NOT NULL THEN '<subfield code="o">' || NEW.owner || E'</subfield>' ELSE '' END ||
432 CASE WHEN NEW.share_depth IS NOT NULL THEN '<subfield code="d">' || NEW.share_depth || E'</subfield>' ELSE '' END ||
435 ELSIF TG_TABLE_SCHEMA = 'authority' THEN
436 NEW.marc := REGEXP_REPLACE(
438 E'(</(?:[^:]*?:)?record>)',
439 E'<datafield tag="901" ind1=" " ind2=" ">' ||
440 '<subfield code="c">' || NEW.id || E'</subfield>' ||
441 '<subfield code="t">' || TG_TABLE_SCHEMA || E'</subfield>' ||
444 ELSIF TG_TABLE_SCHEMA = 'serial' THEN
445 NEW.marc := REGEXP_REPLACE(
447 E'(</(?:[^:]*?:)?record>)',
448 E'<datafield tag="901" ind1=" " ind2=" ">' ||
449 '<subfield code="c">' || NEW.id || E'</subfield>' ||
450 '<subfield code="t">' || TG_TABLE_SCHEMA || E'</subfield>' ||
451 '<subfield code="o">' || NEW.owning_lib || E'</subfield>' ||
452 CASE WHEN NEW.record IS NOT NULL THEN '<subfield code="r">' || NEW.record || E'</subfield>' ELSE '' END ||
456 NEW.marc := REGEXP_REPLACE(
458 E'(</(?:[^:]*?:)?record>)',
459 E'<datafield tag="901" ind1=" " ind2=" ">' ||
460 '<subfield code="c">' || NEW.id || E'</subfield>' ||
461 '<subfield code="t">' || TG_TABLE_SCHEMA || E'</subfield>' ||
468 $func$ LANGUAGE PLPGSQL;
470 CREATE OR REPLACE FUNCTION maintain_control_numbers() RETURNS TRIGGER AS $func$
473 use MARC::File::XML (BinaryEncoding => 'UTF-8');
475 use Unicode::Normalize;
477 my $record = MARC::Record->new_from_xml($_TD->{new}{marc});
478 my $schema = $_TD->{table_schema};
479 my $rec_id = $_TD->{new}{id};
481 # Short-circuit if maintaining control numbers per MARC21 spec is not enabled
482 my $enable = spi_exec_query("SELECT enabled FROM config.global_flag WHERE name = 'cat.maintain_control_numbers'");
483 if (!($enable->{processed}) or $enable->{rows}[0]->{enabled} eq 'f') {
487 # Get the control number identifier from an OU setting based on $_TD->{new}{owner}
488 my $ou_cni = 'EVRGRN';
491 if ($schema eq 'serial') {
492 $owner = $_TD->{new}{owning_lib};
494 # are.owner and bre.owner can be null, so fall back to the consortial setting
495 $owner = $_TD->{new}{owner} || 1;
498 my $ous_rv = spi_exec_query("SELECT value FROM actor.org_unit_ancestor_setting('cat.marc_control_number_identifier', $owner)");
499 if ($ous_rv->{processed}) {
500 $ou_cni = $ous_rv->{rows}[0]->{value};
501 $ou_cni =~ s/"//g; # Stupid VIM syntax highlighting"
503 # Fall back to the shortname of the OU if there was no OU setting
504 $ous_rv = spi_exec_query("SELECT shortname FROM actor.org_unit WHERE id = $owner");
505 if ($ous_rv->{processed}) {
506 $ou_cni = $ous_rv->{rows}[0]->{shortname};
510 my ($create, $munge) = (0, 0);
511 my ($orig_001, $orig_003) = ('', '');
513 # Incoming MARC records may have multiple 001s or 003s, despite the spec
514 my @control_ids = $record->field('003');
515 my @scns = $record->field('035');
517 foreach my $id_field ('001', '003') {
519 my @controls = $record->field($id_field);
521 if ($id_field eq '001') {
522 $spec_value = $rec_id;
524 $spec_value = $ou_cni;
527 # Create the 001/003 if none exist
528 if (scalar(@controls) == 0) {
529 $record->insert_fields_ordered(MARC::Field->new($id_field, $spec_value));
531 } elsif (scalar(@controls) > 1) {
532 # Do we already have the right 001/003 value in the existing set?
533 unless (grep $_->data() eq $spec_value, @controls) {
537 # Delete the other fields, as with more than 1 001/003 we do not know which 003/001 to match
538 foreach my $control (@controls) {
539 unless ($control->data() eq $spec_value) {
540 $record->delete_field($control);
544 # Only one field; check to see if we need to munge it
545 unless (grep $_->data() eq $spec_value, @controls) {
551 # Now, if we need to munge the 001, we will first push the existing 001/003 into the 035
553 my $scn = "(" . $record->field('003')->data() . ")" . $record->field('001')->data();
555 # Do not create duplicate 035 fields
556 unless (grep $_->subfield('a') eq $scn, @scns) {
557 $record->insert_fields_ordered(MARC::Field->new('035', '', '', 'a' => $scn));
561 # Set the 001/003 and update the MARC
562 if ($create or $munge) {
563 $record->field('001')->data($rec_id);
564 $record->field('003')->data($ou_cni);
566 my $xml = $record->as_xml_record();
568 $xml =~ s/^<\?xml.+\?\s*>//go;
569 $xml =~ s/>\s+</></go;
570 $xml =~ s/\p{Cc}//go;
572 # Embed a version of OpenILS::Application::AppUtils->entityize()
573 # to avoid having to set PERL5LIB for PostgreSQL as well
575 # If we are going to convert non-ASCII characters to XML entities,
576 # we had better be dealing with a UTF8 string to begin with
577 $xml = decode_utf8($xml);
581 # Convert raw ampersands to entities
582 $xml =~ s/&(?!\S+;)/&/gso;
584 # Convert Unicode characters to entities
585 $xml =~ s/([\x{0080}-\x{fffd}])/sprintf('&#x%X;',ord($1))/sgoe;
587 $xml =~ s/[\x00-\x1f]//go;
588 $_TD->{new}{marc} = $xml;
594 $func$ LANGUAGE PLPERLU;