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 authtoken A valid authentication token
48 @returns The new record object
52 __PACKAGE__->register_method(
53 method => 'create_authority_record_from_bib_field',
54 api_name => 'open-ils.cat.authority.record.create_from_bib.readonly',
56 desc => q/Creates MARCXML for an authority record entry from a field in a bibliographic record/,
58 @param field A hash representing the field to control, consisting of: { tag: string, ind1: string, ind2: string, subfields: [ [code, value] ... ] }
59 @returns The MARCXML for the authority record
63 sub create_authority_record_from_bib_field {
64 my($self, $conn, $field, $auth) = @_;
66 # Change the first character of the incoming bib field tag to a '1'
67 # for use in our authority record; close enough for now?
68 my $tag = $field->{'tag'};
71 my $ind1 = $field->{ind1} || ' ';
72 my $ind2 = $field->{ind2} || ' ';
74 my $control = qq{<datafield tag="$tag" ind1="$ind1" ind2="$ind2">};
75 foreach my $sf (@{$field->{subfields}}) {
77 my $val = $U->entityize($sf->[1]);
78 $control .= qq{<subfield code="$code">$val</subfield>};
80 $control .= '</datafield>';
82 # ARN, or "authority record number", used to need to be unique across the database.
83 # Of course, we have no idea what's in the database, and if the
84 # cat.maintain_control_numbers flag is set to "TRUE" then the 001 will
85 # be reset to the record ID anyway.
86 my $arn = 'AUTOGEN-' . time();
88 # Placeholder MARCXML;
89 # 001/003 can be be properly filled in via database triggers
90 # 005 will be filled in automatically at creation time
91 # 008 needs to be set by a cataloguer (could be some OU settings, I suppose)
92 # 040 should come from OU settings / OU shortname
94 my $marc_xml = <<MARCXML;
95 <record xmlns:marc="http://www.loc.gov/MARC21/slim" xmlns="http://www.loc.gov/MARC21/slim"><leader> nz a22 o 4500</leader>
96 <controlfield tag="001">$arn</controlfield>
97 <controlfield tag="008"> ||||||||||||||||||||||||||||||||||</controlfield>
98 <datafield tag="040" ind1=" " ind2=" "><subfield code="a">CONS</subfield><subfield code="c">CONS</subfield></datafield>
103 if ($self->api_name =~ m/readonly$/) {
106 my $e = new_editor(authtoken=>$auth, xact=>1);
107 return $e->die_event unless $e->checkauth;
108 return $e->die_event unless $e->allowed('CREATE_AUTHORITY_RECORD');
109 my $rec = OpenILS::Application::Cat::AuthCommon->import_authority_record($e, $marc_xml);
110 $e->commit unless $U->event_code($rec);
115 __PACKAGE__->register_method(
116 method => 'overlay_authority_record',
117 api_name => 'open-ils.cat.authority.record.overlay',
120 sub overlay_authority_record {
121 my($self, $conn, $auth, $rec_id, $marc_xml, $source) = @_;
122 my $e = new_editor(authtoken=>$auth, xact=>1);
123 return $e->die_event unless $e->checkauth;
124 return $e->die_event unless $e->allowed('UPDATE_AUTHORITY_RECORD');
125 my $rec = OpenILS::Application::Cat::AuthCommon->overlay_authority_record($rec_id, $marc_xml, $source);
126 $e->commit unless $U->event_code($rec);
131 __PACKAGE__->register_method(
132 method => 'retrieve_authority_record',
133 api_name => 'open-ils.cat.authority.record.retrieve',
135 desc => q/Retrieve an authority record entry/,
137 {desc => q/hash of options. Options include "clear_marc" which clears
138 the MARC xml from the record before it is returned/}
142 sub retrieve_authority_record {
143 my($self, $conn, $auth, $rec_id, $options) = @_;
144 my $e = new_editor(authtoken=>$auth);
145 return $e->die_event unless $e->checkauth;
146 my $rec = $e->retrieve_authority_record($rec_id) or return $e->event;
147 $rec->clear_marc if $$options{clear_marc};
151 __PACKAGE__->register_method(
152 method => 'batch_retrieve_authority_record',
153 api_name => 'open-ils.cat.authority.record.batch.retrieve',
156 desc => q/Retrieve a set of authority record entry objects/,
158 {desc => q/hash of options. Options include "clear_marc" which clears
159 the MARC xml from the record before it is returned/}
163 sub batch_retrieve_authority_record {
164 my($self, $conn, $auth, $rec_id_list, $options) = @_;
165 my $e = new_editor(authtoken=>$auth);
166 return $e->die_event unless $e->checkauth;
167 for my $rec_id (@$rec_id_list) {
168 my $rec = $e->retrieve_authority_record($rec_id) or return $e->event;
169 $rec->clear_marc if $$options{clear_marc};
170 $conn->respond($rec);
175 __PACKAGE__->register_method(
176 method => 'count_linked_bibs',
177 api_name => 'open-ils.cat.authority.records.count_linked_bibs',
179 Counts the number of bib records linked to each authority record in the input list
180 @param records Array of authority records to return counts
181 @return A list of hashes containing the authority record ID ("id") and linked bib count ("bibs")
185 sub count_linked_bibs {
186 my( $self, $conn, $records ) = @_;
188 my $editor = new_editor();
192 for my $auth ( @$records ) {
193 # Protection against SQL injection? Might be overkill.
194 my $intauth = int($auth);
196 push(@clean_records, $intauth);
199 return $link_count if !@clean_records;
201 $link_count = $editor->json_query({
205 "column" => "authority"
209 "transform" => "count",
216 "where" => { "authority" => \@clean_records }