1 package OpenILS::Application::Cat::Authority;
2 use strict; use warnings;
3 use base qw/OpenILS::Application/;
4 use OpenILS::Utils::CStoreEditor q/:funcs/;
5 use OpenILS::Application::Cat::AuthCommon;
6 use OpenSRF::Utils::Logger qw($logger);
7 use OpenILS::Application::AppUtils;
8 use OpenILS::Utils::Fieldmapper;
9 use OpenILS::Const qw/:const/;
11 my $U = 'OpenILS::Application::AppUtils';
12 my $MARC_NAMESPACE = 'http://www.loc.gov/MARC21/slim';
15 # generate a MARC XML document from a MARC XML string
18 my $marc_doc = XML::LibXML->new->parse_string($xml);
19 $marc_doc->documentElement->setNamespace($MARC_NAMESPACE, 'marc', 1);
20 $marc_doc->documentElement->setNamespace($MARC_NAMESPACE);
25 __PACKAGE__->register_method(
26 method => 'import_authority_record',
27 api_name => 'open-ils.cat.authority.record.import',
30 sub import_authority_record {
31 my($self, $conn, $auth, $marc_xml, $source) = @_;
32 my $e = new_editor(authtoken=>$auth, xact=>1);
33 return $e->die_event unless $e->checkauth;
34 return $e->die_event unless $e->allowed('CREATE_AUTHORITY_RECORD');
35 my $rec = OpenILS::Application::Cat::AuthCommon->import_authority_record($marc_xml, $source);
36 $e->commit unless $U->event_code($rec);
40 __PACKAGE__->register_method(
41 method => 'create_authority_record_from_bib_field',
42 api_name => 'open-ils.cat.authority.record.create_from_bib',
44 desc => q/Create an authority record entry from a field in a bibliographic record/,
46 @param field A hash representing the field to control, consisting of: { tag: string, ind1: string, ind2: string, subfields: [ [code, value] ... ] }
47 @param identifier A MARC control number identifier
48 @param authtoken A valid authentication token
49 @returns The new record object
53 __PACKAGE__->register_method(
54 method => 'create_authority_record_from_bib_field',
55 api_name => 'open-ils.cat.authority.record.create_from_bib.readonly',
57 desc => q/Creates MARCXML for an authority record entry from a field in a bibliographic record/,
59 @param field A hash representing the field to control, consisting of: { tag: string, ind1: string, ind2: string, subfields: [ [code, value] ... ] }
60 @param identifier A MARC control number identifier
61 @returns The MARCXML for the authority record
65 sub create_authority_record_from_bib_field {
66 my($self, $conn, $field, $cni, $auth) = @_;
68 # Control number identifier should have been passed in
73 # Change the first character of the incoming bib field tag to a '1'
74 # for use in our authority record; close enough for now?
75 my $tag = $field->{'tag'};
78 my $ind1 = $field->{ind1} || ' ';
79 my $ind2 = $field->{ind2} || ' ';
81 my $control = qq{<datafield tag="$tag" ind1="$ind1" ind2="$ind2">};
82 foreach my $sf (@{$field->{subfields}}) {
84 my $val = $U->entityize($sf->[1]);
85 $control .= qq{<subfield code="$code">$val</subfield>};
87 $control .= '</datafield>';
89 # ARN, or "authority record number", used to need to be unique across the database.
90 # Of course, we have no idea what's in the database, and if the
91 # cat.maintain_control_numbers flag is set to "TRUE" then the 001 will
92 # be reset to the record ID anyway.
93 my $arn = 'AUTOGEN-' . time();
95 # Placeholder MARCXML;
96 # 001/003 can be be properly filled in via database triggers
97 # 005 will be filled in automatically at creation time
98 # 008 needs to be set by a cataloguer (could be some OU settings, I suppose)
99 # 040 should come from OU settings / OU shortname
101 my $marc_xml = <<MARCXML;
102 <record xmlns:marc="http://www.loc.gov/MARC21/slim" xmlns="http://www.loc.gov/MARC21/slim"><leader> nz a22 o 4500</leader>
103 <controlfield tag="001">$arn</controlfield>
104 <controlfield tag="008"> ||||||||||||||||||||||||||||||||||</controlfield>
105 <datafield tag="040" ind1=" " ind2=" "><subfield code="a">$cni</subfield><subfield code="c">$cni</subfield></datafield>
110 if ($self->api_name =~ m/readonly$/) {
113 my $e = new_editor(authtoken=>$auth, xact=>1);
114 return $e->die_event unless $e->checkauth;
115 return $e->die_event unless $e->allowed('CREATE_AUTHORITY_RECORD');
116 my $rec = OpenILS::Application::Cat::AuthCommon->import_authority_record($e, $marc_xml);
117 $e->commit unless $U->event_code($rec);
122 __PACKAGE__->register_method(
123 method => 'overlay_authority_record',
124 api_name => 'open-ils.cat.authority.record.overlay',
127 sub overlay_authority_record {
128 my($self, $conn, $auth, $rec_id, $marc_xml, $source) = @_;
129 my $e = new_editor(authtoken=>$auth, xact=>1);
130 return $e->die_event unless $e->checkauth;
131 return $e->die_event unless $e->allowed('UPDATE_AUTHORITY_RECORD');
132 my $rec = OpenILS::Application::Cat::AuthCommon->overlay_authority_record($rec_id, $marc_xml, $source);
133 $e->commit unless $U->event_code($rec);
138 __PACKAGE__->register_method(
139 method => 'retrieve_authority_record',
140 api_name => 'open-ils.cat.authority.record.retrieve',
142 desc => q/Retrieve an authority record entry/,
144 {desc => q/hash of options. Options include "clear_marc" which clears
145 the MARC xml from the record before it is returned/}
149 sub retrieve_authority_record {
150 my($self, $conn, $auth, $rec_id, $options) = @_;
151 my $e = new_editor(authtoken=>$auth);
152 return $e->die_event unless $e->checkauth;
153 my $rec = $e->retrieve_authority_record($rec_id) or return $e->event;
154 $rec->clear_marc if $$options{clear_marc};
158 __PACKAGE__->register_method(
159 method => 'batch_retrieve_authority_record',
160 api_name => 'open-ils.cat.authority.record.batch.retrieve',
163 desc => q/Retrieve a set of authority record entry objects/,
165 {desc => q/hash of options. Options include "clear_marc" which clears
166 the MARC xml from the record before it is returned/}
170 sub batch_retrieve_authority_record {
171 my($self, $conn, $auth, $rec_id_list, $options) = @_;
172 my $e = new_editor(authtoken=>$auth);
173 return $e->die_event unless $e->checkauth;
174 for my $rec_id (@$rec_id_list) {
175 my $rec = $e->retrieve_authority_record($rec_id) or return $e->event;
176 $rec->clear_marc if $$options{clear_marc};
177 $conn->respond($rec);
182 __PACKAGE__->register_method(
183 method => 'count_linked_bibs',
184 api_name => 'open-ils.cat.authority.records.count_linked_bibs',
186 Counts the number of bib records linked to each authority record in the input list
187 @param records Array of authority records to return counts
188 @return A list of hashes containing the authority record ID ("id") and linked bib count ("bibs")
192 sub count_linked_bibs {
193 my( $self, $conn, $records ) = @_;
195 my $editor = new_editor();
199 for my $auth ( @$records ) {
200 # Protection against SQL injection? Might be overkill.
201 my $intauth = int($auth);
203 push(@clean_records, $intauth);
206 return $link_count if !@clean_records;
208 $link_count = $editor->json_query({
212 "column" => "authority"
216 "transform" => "count",
223 "where" => { "authority" => \@clean_records }