Bug 24603: Allow to cancel charges in patron accounting
[koha.git] / C4 / ImportBatch.pm
blob6c60c675a82489f02739abea224a0048c53cc619
1 package C4::ImportBatch;
3 # Copyright (C) 2007 LibLime, 2012 C & P Bibliography Services
5 # This file is part of Koha.
7 # Koha is free software; you can redistribute it and/or modify it
8 # under the terms of the GNU General Public License as published by
9 # the Free Software Foundation; either version 3 of the License, or
10 # (at your option) any later version.
12 # Koha is distributed in the hope that it will be useful, but
13 # WITHOUT ANY WARRANTY; without even the implied warranty of
14 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 # GNU General Public License for more details.
17 # You should have received a copy of the GNU General Public License
18 # along with Koha; if not, see <http://www.gnu.org/licenses>.
20 use strict;
21 use warnings;
23 use C4::Context;
24 use C4::Koha;
25 use C4::Biblio;
26 use C4::Items;
27 use C4::Charset;
28 use C4::AuthoritiesMarc;
29 use C4::MarcModificationTemplates;
30 use Koha::Items;
31 use Koha::Plugins::Handler;
32 use Koha::Logger;
34 use vars qw(@ISA @EXPORT @EXPORT_OK %EXPORT_TAGS);
36 BEGIN {
37 require Exporter;
38 @ISA = qw(Exporter);
39 @EXPORT = qw(
40 GetZ3950BatchId
41 GetWebserviceBatchId
42 GetImportRecordMarc
43 GetImportRecordMarcXML
44 AddImportBatch
45 GetImportBatch
46 AddAuthToBatch
47 AddBiblioToBatch
48 AddItemsToImportBiblio
49 ModAuthorityInBatch
50 ModBiblioInBatch
52 BatchStageMarcRecords
53 BatchFindDuplicates
54 BatchCommitRecords
55 BatchRevertRecords
56 CleanBatch
57 DeleteBatch
59 GetAllImportBatches
60 GetStagedWebserviceBatches
61 GetImportBatchRangeDesc
62 GetNumberOfNonZ3950ImportBatches
63 GetImportBiblios
64 GetImportRecordsRange
65 GetItemNumbersFromImportBatch
67 GetImportBatchStatus
68 SetImportBatchStatus
69 GetImportBatchOverlayAction
70 SetImportBatchOverlayAction
71 GetImportBatchNoMatchAction
72 SetImportBatchNoMatchAction
73 GetImportBatchItemAction
74 SetImportBatchItemAction
75 GetImportBatchMatcher
76 SetImportBatchMatcher
77 GetImportRecordOverlayStatus
78 SetImportRecordOverlayStatus
79 GetImportRecordStatus
80 SetImportRecordStatus
81 GetImportRecordMatches
82 SetImportRecordMatches
86 =head1 NAME
88 C4::ImportBatch - manage batches of imported MARC records
90 =head1 SYNOPSIS
92 use C4::ImportBatch;
94 =head1 FUNCTIONS
96 =head2 GetZ3950BatchId
98 my $batchid = GetZ3950BatchId($z3950server);
100 Retrieves the ID of the import batch for the Z39.50
101 reservoir for the given target. If necessary,
102 creates the import batch.
104 =cut
106 sub GetZ3950BatchId {
107 my ($z3950server) = @_;
109 my $dbh = C4::Context->dbh;
110 my $sth = $dbh->prepare("SELECT import_batch_id FROM import_batches
111 WHERE batch_type = 'z3950'
112 AND file_name = ?");
113 $sth->execute($z3950server);
114 my $rowref = $sth->fetchrow_arrayref();
115 $sth->finish();
116 if (defined $rowref) {
117 return $rowref->[0];
118 } else {
119 my $batch_id = AddImportBatch( {
120 overlay_action => 'create_new',
121 import_status => 'staged',
122 batch_type => 'z3950',
123 file_name => $z3950server,
124 } );
125 return $batch_id;
130 =head2 GetWebserviceBatchId
132 my $batchid = GetWebserviceBatchId();
134 Retrieves the ID of the import batch for webservice.
135 If necessary, creates the import batch.
137 =cut
139 my $WEBSERVICE_BASE_QRY = <<EOQ;
140 SELECT import_batch_id FROM import_batches
141 WHERE batch_type = 'webservice'
142 AND import_status = 'staged'
144 sub GetWebserviceBatchId {
145 my ($params) = @_;
147 my $dbh = C4::Context->dbh;
148 my $sql = $WEBSERVICE_BASE_QRY;
149 my @args;
150 foreach my $field (qw(matcher_id overlay_action nomatch_action item_action)) {
151 if (my $val = $params->{$field}) {
152 $sql .= " AND $field = ?";
153 push @args, $val;
156 my $id = $dbh->selectrow_array($sql, undef, @args);
157 return $id if $id;
159 $params->{batch_type} = 'webservice';
160 $params->{import_status} = 'staged';
161 return AddImportBatch($params);
164 =head2 GetImportRecordMarc
166 my ($marcblob, $encoding) = GetImportRecordMarc($import_record_id);
168 =cut
170 sub GetImportRecordMarc {
171 my ($import_record_id) = @_;
173 my $dbh = C4::Context->dbh;
174 my ( $marc, $encoding ) = $dbh->selectrow_array(q|
175 SELECT marc, encoding
176 FROM import_records
177 WHERE import_record_id = ?
178 |, undef, $import_record_id );
180 return $marc, $encoding;
183 sub GetRecordFromImportBiblio {
184 my ( $import_record_id, $embed_items ) = @_;
186 my ($marc) = GetImportRecordMarc($import_record_id);
187 my $record = MARC::Record->new_from_usmarc($marc);
189 EmbedItemsInImportBiblio( $record, $import_record_id ) if $embed_items;
191 return $record;
194 sub EmbedItemsInImportBiblio {
195 my ( $record, $import_record_id ) = @_;
196 my ( $itemtag, $itemsubfield ) = GetMarcFromKohaField( "items.itemnumber" );
197 my $dbh = C4::Context->dbh;
198 my $import_items = $dbh->selectall_arrayref(q|
199 SELECT import_items.marcxml
200 FROM import_items
201 WHERE import_record_id = ?
202 |, { Slice => {} }, $import_record_id );
203 my @item_fields;
204 for my $import_item ( @$import_items ) {
205 my $item_marc = MARC::Record::new_from_xml($import_item->{marcxml}, 'UTF-8');
206 push @item_fields, $item_marc->field($itemtag);
208 $record->append_fields(@item_fields);
209 return $record;
212 =head2 GetImportRecordMarcXML
214 my $marcxml = GetImportRecordMarcXML($import_record_id);
216 =cut
218 sub GetImportRecordMarcXML {
219 my ($import_record_id) = @_;
221 my $dbh = C4::Context->dbh;
222 my $sth = $dbh->prepare("SELECT marcxml FROM import_records WHERE import_record_id = ?");
223 $sth->execute($import_record_id);
224 my ($marcxml) = $sth->fetchrow();
225 $sth->finish();
226 return $marcxml;
230 =head2 AddImportBatch
232 my $batch_id = AddImportBatch($params_hash);
234 =cut
236 sub AddImportBatch {
237 my ($params) = @_;
239 my (@fields, @vals);
240 foreach (qw( matcher_id template_id branchcode
241 overlay_action nomatch_action item_action
242 import_status batch_type file_name comments record_type )) {
243 if (exists $params->{$_}) {
244 push @fields, $_;
245 push @vals, $params->{$_};
248 my $dbh = C4::Context->dbh;
249 $dbh->do("INSERT INTO import_batches (".join( ',', @fields).")
250 VALUES (".join( ',', map '?', @fields).")",
251 undef,
252 @vals);
253 return $dbh->{'mysql_insertid'};
256 =head2 GetImportBatch
258 my $row = GetImportBatch($batch_id);
260 Retrieve a hashref of an import_batches row.
262 =cut
264 sub GetImportBatch {
265 my ($batch_id) = @_;
267 my $dbh = C4::Context->dbh;
268 my $sth = $dbh->prepare_cached("SELECT * FROM import_batches WHERE import_batch_id = ?");
269 $sth->bind_param(1, $batch_id);
270 $sth->execute();
271 my $result = $sth->fetchrow_hashref;
272 $sth->finish();
273 return $result;
277 =head2 AddBiblioToBatch
279 my $import_record_id = AddBiblioToBatch($batch_id, $record_sequence,
280 $marc_record, $encoding, $update_counts);
282 =cut
284 sub AddBiblioToBatch {
285 my $batch_id = shift;
286 my $record_sequence = shift;
287 my $marc_record = shift;
288 my $encoding = shift;
289 my $update_counts = @_ ? shift : 1;
291 my $import_record_id = _create_import_record($batch_id, $record_sequence, $marc_record, 'biblio', $encoding, C4::Context->preference('marcflavour'));
292 _add_biblio_fields($import_record_id, $marc_record);
293 _update_batch_record_counts($batch_id) if $update_counts;
294 return $import_record_id;
297 =head2 ModBiblioInBatch
299 ModBiblioInBatch($import_record_id, $marc_record);
301 =cut
303 sub ModBiblioInBatch {
304 my ($import_record_id, $marc_record) = @_;
306 _update_import_record_marc($import_record_id, $marc_record, C4::Context->preference('marcflavour'));
307 _update_biblio_fields($import_record_id, $marc_record);
311 =head2 AddAuthToBatch
313 my $import_record_id = AddAuthToBatch($batch_id, $record_sequence,
314 $marc_record, $encoding, $update_counts, [$marc_type]);
316 =cut
318 sub AddAuthToBatch {
319 my $batch_id = shift;
320 my $record_sequence = shift;
321 my $marc_record = shift;
322 my $encoding = shift;
323 my $update_counts = @_ ? shift : 1;
324 my $marc_type = shift || C4::Context->preference('marcflavour');
326 $marc_type = 'UNIMARCAUTH' if $marc_type eq 'UNIMARC';
328 my $import_record_id = _create_import_record($batch_id, $record_sequence, $marc_record, 'auth', $encoding, $marc_type);
329 _add_auth_fields($import_record_id, $marc_record);
330 _update_batch_record_counts($batch_id) if $update_counts;
331 return $import_record_id;
334 =head2 ModAuthInBatch
336 ModAuthInBatch($import_record_id, $marc_record);
338 =cut
340 sub ModAuthInBatch {
341 my ($import_record_id, $marc_record) = @_;
343 my $marcflavour = C4::Context->preference('marcflavour');
344 _update_import_record_marc($import_record_id, $marc_record, $marcflavour eq 'UNIMARC' ? 'UNIMARCAUTH' : 'USMARC');
348 =head2 BatchStageMarcRecords
350 ( $batch_id, $num_records, $num_items, @invalid_records ) =
351 BatchStageMarcRecords(
352 $record_type, $encoding,
353 $marc_records, $file_name,
354 $marc_modification_template, $comments,
355 $branch_code, $parse_items,
356 $leave_as_staging, $progress_interval,
357 $progress_callback
360 =cut
362 sub BatchStageMarcRecords {
363 my $record_type = shift;
364 my $encoding = shift;
365 my $marc_records = shift;
366 my $file_name = shift;
367 my $marc_modification_template = shift;
368 my $comments = shift;
369 my $branch_code = shift;
370 my $parse_items = shift;
371 my $leave_as_staging = shift;
373 # optional callback to monitor status
374 # of job
375 my $progress_interval = 0;
376 my $progress_callback = undef;
377 if ($#_ == 1) {
378 $progress_interval = shift;
379 $progress_callback = shift;
380 $progress_interval = 0 unless $progress_interval =~ /^\d+$/ and $progress_interval > 0;
381 $progress_interval = 0 unless 'CODE' eq ref $progress_callback;
384 my $batch_id = AddImportBatch( {
385 overlay_action => 'create_new',
386 import_status => 'staging',
387 batch_type => 'batch',
388 file_name => $file_name,
389 comments => $comments,
390 record_type => $record_type,
391 } );
392 if ($parse_items) {
393 SetImportBatchItemAction($batch_id, 'always_add');
394 } else {
395 SetImportBatchItemAction($batch_id, 'ignore');
399 my $marc_type = C4::Context->preference('marcflavour');
400 $marc_type .= 'AUTH' if ($marc_type eq 'UNIMARC' && $record_type eq 'auth');
401 my @invalid_records = ();
402 my $num_valid = 0;
403 my $num_items = 0;
404 # FIXME - for now, we're dealing only with bibs
405 my $rec_num = 0;
406 foreach my $marc_record (@$marc_records) {
407 $rec_num++;
408 if ($progress_interval and (0 == ($rec_num % $progress_interval))) {
409 &$progress_callback($rec_num);
412 ModifyRecordWithTemplate( $marc_modification_template, $marc_record ) if ( $marc_modification_template );
414 my $import_record_id;
415 if (scalar($marc_record->fields()) == 0) {
416 push @invalid_records, $marc_record;
417 } else {
419 # Normalize the record so it doesn't have separated diacritics
420 SetUTF8Flag($marc_record);
422 $num_valid++;
423 if ($record_type eq 'biblio') {
424 $import_record_id = AddBiblioToBatch($batch_id, $rec_num, $marc_record, $encoding, int(rand(99999)), 0);
425 if ($parse_items) {
426 my @import_items_ids = AddItemsToImportBiblio($batch_id, $import_record_id, $marc_record, 0);
427 $num_items += scalar(@import_items_ids);
429 } elsif ($record_type eq 'auth') {
430 $import_record_id = AddAuthToBatch($batch_id, $rec_num, $marc_record, $encoding, int(rand(99999)), 0, $marc_type);
434 unless ($leave_as_staging) {
435 SetImportBatchStatus($batch_id, 'staged');
437 # FIXME branch_code, number of bibs, number of items
438 _update_batch_record_counts($batch_id);
439 return ($batch_id, $num_valid, $num_items, @invalid_records);
442 =head2 AddItemsToImportBiblio
444 my @import_items_ids = AddItemsToImportBiblio($batch_id,
445 $import_record_id, $marc_record, $update_counts);
447 =cut
449 sub AddItemsToImportBiblio {
450 my $batch_id = shift;
451 my $import_record_id = shift;
452 my $marc_record = shift;
453 my $update_counts = @_ ? shift : 0;
455 my @import_items_ids = ();
457 my $dbh = C4::Context->dbh;
458 my ($item_tag,$item_subfield) = &GetMarcFromKohaField( "items.itemnumber" );
459 foreach my $item_field ($marc_record->field($item_tag)) {
460 my $item_marc = MARC::Record->new();
461 $item_marc->leader("00000 a "); # must set Leader/09 to 'a'
462 $item_marc->append_fields($item_field);
463 $marc_record->delete_field($item_field);
464 my $sth = $dbh->prepare_cached("INSERT INTO import_items (import_record_id, status, marcxml)
465 VALUES (?, ?, ?)");
466 $sth->bind_param(1, $import_record_id);
467 $sth->bind_param(2, 'staged');
468 $sth->bind_param(3, $item_marc->as_xml("USMARC"));
469 $sth->execute();
470 push @import_items_ids, $dbh->{'mysql_insertid'};
471 $sth->finish();
474 if ($#import_items_ids > -1) {
475 _update_batch_record_counts($batch_id) if $update_counts;
476 _update_import_record_marc($import_record_id, $marc_record, C4::Context->preference('marcflavour'));
478 return @import_items_ids;
481 =head2 BatchFindDuplicates
483 my $num_with_matches = BatchFindDuplicates($batch_id, $matcher,
484 $max_matches, $progress_interval, $progress_callback);
486 Goes through the records loaded in the batch and attempts to
487 find duplicates for each one. Sets the matching status
488 of each record to "no_match" or "auto_match" as appropriate.
490 The $max_matches parameter is optional; if it is not supplied,
491 it defaults to 10.
493 The $progress_interval and $progress_callback parameters are
494 optional; if both are supplied, the sub referred to by
495 $progress_callback will be invoked every $progress_interval
496 records using the number of records processed as the
497 singular argument.
499 =cut
501 sub BatchFindDuplicates {
502 my $batch_id = shift;
503 my $matcher = shift;
504 my $max_matches = @_ ? shift : 10;
506 # optional callback to monitor status
507 # of job
508 my $progress_interval = 0;
509 my $progress_callback = undef;
510 if ($#_ == 1) {
511 $progress_interval = shift;
512 $progress_callback = shift;
513 $progress_interval = 0 unless $progress_interval =~ /^\d+$/ and $progress_interval > 0;
514 $progress_interval = 0 unless 'CODE' eq ref $progress_callback;
517 my $dbh = C4::Context->dbh;
519 my $sth = $dbh->prepare("SELECT import_record_id, record_type, marc
520 FROM import_records
521 WHERE import_batch_id = ?");
522 $sth->execute($batch_id);
523 my $num_with_matches = 0;
524 my $rec_num = 0;
525 while (my $rowref = $sth->fetchrow_hashref) {
526 $rec_num++;
527 if ($progress_interval and (0 == ($rec_num % $progress_interval))) {
528 &$progress_callback($rec_num);
530 my $marc_record = MARC::Record->new_from_usmarc($rowref->{'marc'});
531 my @matches = ();
532 if (defined $matcher) {
533 @matches = $matcher->get_matches($marc_record, $max_matches);
535 if (scalar(@matches) > 0) {
536 $num_with_matches++;
537 SetImportRecordMatches($rowref->{'import_record_id'}, @matches);
538 SetImportRecordOverlayStatus($rowref->{'import_record_id'}, 'auto_match');
539 } else {
540 SetImportRecordMatches($rowref->{'import_record_id'}, ());
541 SetImportRecordOverlayStatus($rowref->{'import_record_id'}, 'no_match');
544 $sth->finish();
545 return $num_with_matches;
548 =head2 BatchCommitRecords
550 my ($num_added, $num_updated, $num_items_added, $num_items_replaced, $num_items_errored, $num_ignored) =
551 BatchCommitRecords($batch_id, $framework,
552 $progress_interval, $progress_callback);
554 =cut
556 sub BatchCommitRecords {
557 my $batch_id = shift;
558 my $framework = shift;
560 # optional callback to monitor status
561 # of job
562 my $progress_interval = 0;
563 my $progress_callback = undef;
564 if ($#_ == 1) {
565 $progress_interval = shift;
566 $progress_callback = shift;
567 $progress_interval = 0 unless $progress_interval =~ /^\d+$/ and $progress_interval > 0;
568 $progress_interval = 0 unless 'CODE' eq ref $progress_callback;
571 my $record_type;
572 my $num_added = 0;
573 my $num_updated = 0;
574 my $num_items_added = 0;
575 my $num_items_replaced = 0;
576 my $num_items_errored = 0;
577 my $num_ignored = 0;
578 # commit (i.e., save, all records in the batch)
579 SetImportBatchStatus('importing');
580 my $overlay_action = GetImportBatchOverlayAction($batch_id);
581 my $nomatch_action = GetImportBatchNoMatchAction($batch_id);
582 my $item_action = GetImportBatchItemAction($batch_id);
583 my $item_tag;
584 my $item_subfield;
585 my $dbh = C4::Context->dbh;
586 my $sth = $dbh->prepare("SELECT import_records.import_record_id, record_type, status, overlay_status, marc, encoding
587 FROM import_records
588 LEFT JOIN import_auths ON (import_records.import_record_id=import_auths.import_record_id)
589 LEFT JOIN import_biblios ON (import_records.import_record_id=import_biblios.import_record_id)
590 WHERE import_batch_id = ?");
591 $sth->execute($batch_id);
592 my $marcflavour = C4::Context->preference('marcflavour');
593 my $rec_num = 0;
594 while (my $rowref = $sth->fetchrow_hashref) {
595 $record_type = $rowref->{'record_type'};
596 $rec_num++;
597 if ($progress_interval and (0 == ($rec_num % $progress_interval))) {
598 &$progress_callback($rec_num);
600 if ($rowref->{'status'} eq 'error' or $rowref->{'status'} eq 'imported') {
601 $num_ignored++;
602 next;
605 my $marc_type;
606 if ($marcflavour eq 'UNIMARC' && $record_type eq 'auth') {
607 $marc_type = 'UNIMARCAUTH';
608 } elsif ($marcflavour eq 'UNIMARC') {
609 $marc_type = 'UNIMARC';
610 } else {
611 $marc_type = 'USMARC';
613 my $marc_record = MARC::Record->new_from_usmarc($rowref->{'marc'});
615 if ($record_type eq 'biblio') {
616 # remove any item tags - rely on BatchCommitItems
617 ($item_tag,$item_subfield) = &GetMarcFromKohaField( "items.itemnumber" );
618 foreach my $item_field ($marc_record->field($item_tag)) {
619 $marc_record->delete_field($item_field);
623 my ($record_result, $item_result, $record_match) =
624 _get_commit_action($overlay_action, $nomatch_action, $item_action,
625 $rowref->{'overlay_status'}, $rowref->{'import_record_id'}, $record_type);
627 my $recordid;
628 my $query;
629 if ($record_result eq 'create_new') {
630 $num_added++;
631 if ($record_type eq 'biblio') {
632 my $biblioitemnumber;
633 ($recordid, $biblioitemnumber) = AddBiblio($marc_record, $framework);
634 $query = "UPDATE import_biblios SET matched_biblionumber = ? WHERE import_record_id = ?";
635 if ($item_result eq 'create_new' || $item_result eq 'replace') {
636 my ($bib_items_added, $bib_items_replaced, $bib_items_errored) = BatchCommitItems($rowref->{'import_record_id'}, $recordid, $item_result);
637 $num_items_added += $bib_items_added;
638 $num_items_replaced += $bib_items_replaced;
639 $num_items_errored += $bib_items_errored;
641 } else {
642 $recordid = AddAuthority($marc_record, undef, GuessAuthTypeCode($marc_record));
643 $query = "UPDATE import_auths SET matched_authid = ? WHERE import_record_id = ?";
645 my $sth = $dbh->prepare_cached($query);
646 $sth->execute($recordid, $rowref->{'import_record_id'});
647 $sth->finish();
648 SetImportRecordStatus($rowref->{'import_record_id'}, 'imported');
649 } elsif ($record_result eq 'replace') {
650 $num_updated++;
651 $recordid = $record_match;
652 my $oldxml;
653 if ($record_type eq 'biblio') {
654 my $oldbiblio = Koha::Biblios->find( $recordid );
655 $oldxml = GetXmlBiblio($recordid);
657 # remove item fields so that they don't get
658 # added again if record is reverted
659 # FIXME: GetXmlBiblio output should not contain item info any more! So the next foreach should not be needed. Does not hurt either; may remove old 952s that should not have been there anymore.
660 my $old_marc = MARC::Record->new_from_xml(StripNonXmlChars($oldxml), 'UTF-8', $rowref->{'encoding'}, $marc_type);
661 foreach my $item_field ($old_marc->field($item_tag)) {
662 $old_marc->delete_field($item_field);
664 $oldxml = $old_marc->as_xml($marc_type);
666 ModBiblio($marc_record, $recordid, $oldbiblio->frameworkcode);
667 $query = "UPDATE import_biblios SET matched_biblionumber = ? WHERE import_record_id = ?";
669 if ($item_result eq 'create_new' || $item_result eq 'replace') {
670 my ($bib_items_added, $bib_items_replaced, $bib_items_errored) = BatchCommitItems($rowref->{'import_record_id'}, $recordid, $item_result);
671 $num_items_added += $bib_items_added;
672 $num_items_replaced += $bib_items_replaced;
673 $num_items_errored += $bib_items_errored;
675 } else {
676 $oldxml = GetAuthorityXML($recordid);
678 ModAuthority($recordid, $marc_record, GuessAuthTypeCode($marc_record));
679 $query = "UPDATE import_auths SET matched_authid = ? WHERE import_record_id = ?";
681 my $sth = $dbh->prepare_cached("UPDATE import_records SET marcxml_old = ? WHERE import_record_id = ?");
682 $sth->execute($oldxml, $rowref->{'import_record_id'});
683 $sth->finish();
684 my $sth2 = $dbh->prepare_cached($query);
685 $sth2->execute($recordid, $rowref->{'import_record_id'});
686 $sth2->finish();
687 SetImportRecordOverlayStatus($rowref->{'import_record_id'}, 'match_applied');
688 SetImportRecordStatus($rowref->{'import_record_id'}, 'imported');
689 } elsif ($record_result eq 'ignore') {
690 $recordid = $record_match;
691 $num_ignored++;
692 $recordid = $record_match;
693 if ($record_type eq 'biblio' and defined $recordid and ( $item_result eq 'create_new' || $item_result eq 'replace' ) ) {
694 my ($bib_items_added, $bib_items_replaced, $bib_items_errored) = BatchCommitItems($rowref->{'import_record_id'}, $recordid, $item_result);
695 $num_items_added += $bib_items_added;
696 $num_items_replaced += $bib_items_replaced;
697 $num_items_errored += $bib_items_errored;
698 # still need to record the matched biblionumber so that the
699 # items can be reverted
700 my $sth2 = $dbh->prepare_cached("UPDATE import_biblios SET matched_biblionumber = ? WHERE import_record_id = ?");
701 $sth2->execute($recordid, $rowref->{'import_record_id'});
702 SetImportRecordOverlayStatus($rowref->{'import_record_id'}, 'match_applied');
704 SetImportRecordStatus($rowref->{'import_record_id'}, 'ignored');
707 $sth->finish();
708 SetImportBatchStatus($batch_id, 'imported');
709 return ($num_added, $num_updated, $num_items_added, $num_items_replaced, $num_items_errored, $num_ignored);
712 =head2 BatchCommitItems
714 ($num_items_added, $num_items_errored) =
715 BatchCommitItems($import_record_id, $biblionumber);
717 =cut
719 sub BatchCommitItems {
720 my ( $import_record_id, $biblionumber, $action ) = @_;
722 my $dbh = C4::Context->dbh;
724 my $num_items_added = 0;
725 my $num_items_errored = 0;
726 my $num_items_replaced = 0;
728 my $sth = $dbh->prepare( "
729 SELECT import_items_id, import_items.marcxml, encoding
730 FROM import_items
731 JOIN import_records USING (import_record_id)
732 WHERE import_record_id = ?
733 ORDER BY import_items_id
734 " );
735 $sth->bind_param( 1, $import_record_id );
736 $sth->execute();
738 while ( my $row = $sth->fetchrow_hashref() ) {
739 my $item_marc = MARC::Record->new_from_xml( StripNonXmlChars( $row->{'marcxml'} ), 'UTF-8', $row->{'encoding'} );
741 # Delete date_due subfield as to not accidentally delete item checkout due dates
742 my ( $MARCfield, $MARCsubfield ) = GetMarcFromKohaField( 'items.onloan' );
743 $item_marc->field($MARCfield)->delete_subfield( code => $MARCsubfield );
745 my $item = TransformMarcToKoha( $item_marc );
747 my $duplicate_barcode = exists( $item->{'barcode'} ) && Koha::Items->find({ barcode => $item->{'barcode'} });
748 my $duplicate_itemnumber = exists( $item->{'itemnumber'} );
750 my $updsth = $dbh->prepare("UPDATE import_items SET status = ?, itemnumber = ? WHERE import_items_id = ?");
751 if ( $action eq "replace" && $duplicate_itemnumber ) {
752 # Duplicate itemnumbers have precedence, that way we can update barcodes by overlaying
753 ModItemFromMarc( $item_marc, $biblionumber, $item->{itemnumber} );
754 $updsth->bind_param( 1, 'imported' );
755 $updsth->bind_param( 2, $item->{itemnumber} );
756 $updsth->bind_param( 3, $row->{'import_items_id'} );
757 $updsth->execute();
758 $updsth->finish();
759 $num_items_replaced++;
760 } elsif ( $action eq "replace" && $duplicate_barcode ) {
761 my $itemnumber = $duplicate_barcode->itemnumber;
762 ModItemFromMarc( $item_marc, $biblionumber, $itemnumber );
763 $updsth->bind_param( 1, 'imported' );
764 $updsth->bind_param( 2, $item->{itemnumber} );
765 $updsth->bind_param( 3, $row->{'import_items_id'} );
766 $updsth->execute();
767 $updsth->finish();
768 $num_items_replaced++;
769 } elsif ($duplicate_barcode) {
770 $updsth->bind_param( 1, 'error' );
771 $updsth->bind_param( 2, 'duplicate item barcode' );
772 $updsth->bind_param( 3, $row->{'import_items_id'} );
773 $updsth->execute();
774 $num_items_errored++;
775 } else {
776 my ( $item_biblionumber, $biblioitemnumber, $itemnumber ) = AddItemFromMarc( $item_marc, $biblionumber );
777 if( $itemnumber ) {
778 $updsth->bind_param( 1, 'imported' );
779 $updsth->bind_param( 2, $itemnumber );
780 $updsth->bind_param( 3, $row->{'import_items_id'} );
781 $updsth->execute();
782 $updsth->finish();
783 $num_items_added++;
788 return ( $num_items_added, $num_items_replaced, $num_items_errored );
791 =head2 BatchRevertRecords
793 my ($num_deleted, $num_errors, $num_reverted, $num_items_deleted,
794 $num_ignored) = BatchRevertRecords($batch_id);
796 =cut
798 sub BatchRevertRecords {
799 my $batch_id = shift;
801 my $logger = Koha::Logger->get( { category => 'C4.ImportBatch' } );
803 $logger->trace("C4::ImportBatch::BatchRevertRecords( $batch_id )");
805 my $record_type;
806 my $num_deleted = 0;
807 my $num_errors = 0;
808 my $num_reverted = 0;
809 my $num_ignored = 0;
810 my $num_items_deleted = 0;
811 # commit (i.e., save, all records in the batch)
812 SetImportBatchStatus('reverting');
813 my $overlay_action = GetImportBatchOverlayAction($batch_id);
814 my $nomatch_action = GetImportBatchNoMatchAction($batch_id);
815 my $dbh = C4::Context->dbh;
816 my $sth = $dbh->prepare("SELECT import_records.import_record_id, record_type, status, overlay_status, marcxml_old, encoding, matched_biblionumber, matched_authid
817 FROM import_records
818 LEFT JOIN import_auths ON (import_records.import_record_id=import_auths.import_record_id)
819 LEFT JOIN import_biblios ON (import_records.import_record_id=import_biblios.import_record_id)
820 WHERE import_batch_id = ?");
821 $sth->execute($batch_id);
822 my $marc_type;
823 my $marcflavour = C4::Context->preference('marcflavour');
824 while (my $rowref = $sth->fetchrow_hashref) {
825 $record_type = $rowref->{'record_type'};
826 if ($rowref->{'status'} eq 'error' or $rowref->{'status'} eq 'reverted') {
827 $num_ignored++;
828 next;
830 if ($marcflavour eq 'UNIMARC' && $record_type eq 'auth') {
831 $marc_type = 'UNIMARCAUTH';
832 } elsif ($marcflavour eq 'UNIMARC') {
833 $marc_type = 'UNIMARC';
834 } else {
835 $marc_type = 'USMARC';
838 my $record_result = _get_revert_action($overlay_action, $rowref->{'overlay_status'}, $rowref->{'status'});
840 if ($record_result eq 'delete') {
841 my $error = undef;
842 if ($record_type eq 'biblio') {
843 $num_items_deleted += BatchRevertItems($rowref->{'import_record_id'}, $rowref->{'matched_biblionumber'});
844 $error = DelBiblio($rowref->{'matched_biblionumber'});
845 } else {
846 DelAuthority({ authid => $rowref->{'matched_authid'} });
848 if (defined $error) {
849 $num_errors++;
850 } else {
851 $num_deleted++;
852 SetImportRecordStatus($rowref->{'import_record_id'}, 'reverted');
854 } elsif ($record_result eq 'restore') {
855 $num_reverted++;
856 my $old_record = MARC::Record->new_from_xml(StripNonXmlChars($rowref->{'marcxml_old'}), 'UTF-8', $rowref->{'encoding'}, $marc_type);
857 if ($record_type eq 'biblio') {
858 my $biblionumber = $rowref->{'matched_biblionumber'};
859 my $oldbiblio = Koha::Biblios->find( $biblionumber );
861 $logger->info("C4::ImportBatch::BatchRevertRecords: Biblio record $biblionumber does not exist, restoration of this record was skipped") unless $oldbiblio;
862 next unless $oldbiblio; # Record has since been deleted. Deleted records should stay deleted.
864 $num_items_deleted += BatchRevertItems($rowref->{'import_record_id'}, $rowref->{'matched_biblionumber'});
865 ModBiblio($old_record, $biblionumber, $oldbiblio->frameworkcode);
866 } else {
867 my $authid = $rowref->{'matched_authid'};
868 ModAuthority($authid, $old_record, GuessAuthTypeCode($old_record));
870 SetImportRecordStatus($rowref->{'import_record_id'}, 'reverted');
871 } elsif ($record_result eq 'ignore') {
872 if ($record_type eq 'biblio') {
873 $num_items_deleted += BatchRevertItems($rowref->{'import_record_id'}, $rowref->{'matched_biblionumber'});
875 SetImportRecordStatus($rowref->{'import_record_id'}, 'reverted');
877 my $query;
878 if ($record_type eq 'biblio') {
879 # remove matched_biblionumber only if there is no 'imported' item left
880 $query = "UPDATE import_biblios SET matched_biblionumber = NULL WHERE import_record_id = ?";
881 $query = "UPDATE import_biblios SET matched_biblionumber = NULL WHERE import_record_id = ? AND NOT EXISTS (SELECT * FROM import_items WHERE import_items.import_record_id=import_biblios.import_record_id and status='imported')";
882 } else {
883 $query = "UPDATE import_auths SET matched_authid = NULL WHERE import_record_id = ?";
885 my $sth2 = $dbh->prepare_cached($query);
886 $sth2->execute($rowref->{'import_record_id'});
889 $sth->finish();
890 SetImportBatchStatus($batch_id, 'reverted');
891 return ($num_deleted, $num_errors, $num_reverted, $num_items_deleted, $num_ignored);
894 =head2 BatchRevertItems
896 my $num_items_deleted = BatchRevertItems($import_record_id, $biblionumber);
898 =cut
900 sub BatchRevertItems {
901 my ($import_record_id, $biblionumber) = @_;
903 my $dbh = C4::Context->dbh;
904 my $num_items_deleted = 0;
906 my $sth = $dbh->prepare_cached("SELECT import_items_id, itemnumber
907 FROM import_items
908 JOIN items USING (itemnumber)
909 WHERE import_record_id = ?");
910 $sth->bind_param(1, $import_record_id);
911 $sth->execute();
912 while (my $row = $sth->fetchrow_hashref()) {
913 my $item = Koha::Items->find($row->{itemnumber});
914 my $error = $item->safe_delete;
915 if ($error eq '1'){
916 my $updsth = $dbh->prepare("UPDATE import_items SET status = ? WHERE import_items_id = ?");
917 $updsth->bind_param(1, 'reverted');
918 $updsth->bind_param(2, $row->{'import_items_id'});
919 $updsth->execute();
920 $updsth->finish();
921 $num_items_deleted++;
923 else {
924 next;
927 $sth->finish();
928 return $num_items_deleted;
931 =head2 CleanBatch
933 CleanBatch($batch_id)
935 Deletes all staged records from the import batch
936 and sets the status of the batch to 'cleaned'. Note
937 that deleting a stage record does *not* affect
938 any record that has been committed to the database.
940 =cut
942 sub CleanBatch {
943 my $batch_id = shift;
944 return unless defined $batch_id;
946 C4::Context->dbh->do('DELETE FROM import_records WHERE import_batch_id = ?', {}, $batch_id);
947 SetImportBatchStatus($batch_id, 'cleaned');
950 =head2 DeleteBatch
952 DeleteBatch($batch_id)
954 Deletes the record from the database. This can only be done
955 once the batch has been cleaned.
957 =cut
959 sub DeleteBatch {
960 my $batch_id = shift;
961 return unless defined $batch_id;
963 my $dbh = C4::Context->dbh;
964 my $sth = $dbh->prepare('DELETE FROM import_batches WHERE import_batch_id = ?');
965 $sth->execute( $batch_id );
968 =head2 GetAllImportBatches
970 my $results = GetAllImportBatches();
972 Returns a references to an array of hash references corresponding
973 to all import_batches rows (of batch_type 'batch'), sorted in
974 ascending order by import_batch_id.
976 =cut
978 sub GetAllImportBatches {
979 my $dbh = C4::Context->dbh;
980 my $sth = $dbh->prepare_cached("SELECT * FROM import_batches
981 WHERE batch_type IN ('batch', 'webservice')
982 ORDER BY import_batch_id ASC");
984 my $results = [];
985 $sth->execute();
986 while (my $row = $sth->fetchrow_hashref) {
987 push @$results, $row;
989 $sth->finish();
990 return $results;
993 =head2 GetStagedWebserviceBatches
995 my $batch_ids = GetStagedWebserviceBatches();
997 Returns a references to an array of batch id's
998 of batch_type 'webservice' that are not imported
1000 =cut
1002 my $PENDING_WEBSERVICE_BATCHES_QRY = <<EOQ;
1003 SELECT import_batch_id FROM import_batches
1004 WHERE batch_type = 'webservice'
1005 AND import_status = 'staged'
1007 sub GetStagedWebserviceBatches {
1008 my $dbh = C4::Context->dbh;
1009 return $dbh->selectcol_arrayref($PENDING_WEBSERVICE_BATCHES_QRY);
1012 =head2 GetImportBatchRangeDesc
1014 my $results = GetImportBatchRangeDesc($offset, $results_per_group);
1016 Returns a reference to an array of hash references corresponding to
1017 import_batches rows (sorted in descending order by import_batch_id)
1018 start at the given offset.
1020 =cut
1022 sub GetImportBatchRangeDesc {
1023 my ($offset, $results_per_group) = @_;
1025 my $dbh = C4::Context->dbh;
1026 my $query = "SELECT * FROM import_batches
1027 WHERE batch_type IN ('batch', 'webservice')
1028 ORDER BY import_batch_id DESC";
1029 my @params;
1030 if ($results_per_group){
1031 $query .= " LIMIT ?";
1032 push(@params, $results_per_group);
1034 if ($offset){
1035 $query .= " OFFSET ?";
1036 push(@params, $offset);
1038 my $sth = $dbh->prepare_cached($query);
1039 $sth->execute(@params);
1040 my $results = $sth->fetchall_arrayref({});
1041 $sth->finish();
1042 return $results;
1045 =head2 GetItemNumbersFromImportBatch
1047 my @itemsnos = GetItemNumbersFromImportBatch($batch_id);
1049 =cut
1051 sub GetItemNumbersFromImportBatch {
1052 my ($batch_id) = @_;
1053 my $dbh = C4::Context->dbh;
1054 my $sql = q|
1055 SELECT itemnumber FROM import_items
1056 INNER JOIN items USING (itemnumber)
1057 INNER JOIN import_records USING (import_record_id)
1058 WHERE import_batch_id = ?|;
1059 my $sth = $dbh->prepare( $sql );
1060 $sth->execute($batch_id);
1061 my @items ;
1062 while ( my ($itm) = $sth->fetchrow_array ) {
1063 push @items, $itm;
1065 return @items;
1068 =head2 GetNumberOfImportBatches
1070 my $count = GetNumberOfImportBatches();
1072 =cut
1074 sub GetNumberOfNonZ3950ImportBatches {
1075 my $dbh = C4::Context->dbh;
1076 my $sth = $dbh->prepare("SELECT COUNT(*) FROM import_batches WHERE batch_type != 'z3950'");
1077 $sth->execute();
1078 my ($count) = $sth->fetchrow_array();
1079 $sth->finish();
1080 return $count;
1083 =head2 GetImportBiblios
1085 my $results = GetImportBiblios($importid);
1087 =cut
1089 sub GetImportBiblios {
1090 my ($import_record_id) = @_;
1092 my $dbh = C4::Context->dbh;
1093 my $query = "SELECT * FROM import_biblios WHERE import_record_id = ?";
1094 return $dbh->selectall_arrayref(
1095 $query,
1096 { Slice => {} },
1097 $import_record_id
1102 =head2 GetImportRecordsRange
1104 my $results = GetImportRecordsRange($batch_id, $offset, $results_per_group);
1106 Returns a reference to an array of hash references corresponding to
1107 import_biblios/import_auths/import_records rows for a given batch
1108 starting at the given offset.
1110 =cut
1112 sub GetImportRecordsRange {
1113 my ( $batch_id, $offset, $results_per_group, $status, $parameters ) = @_;
1115 my $dbh = C4::Context->dbh;
1117 my $order_by = $parameters->{order_by} || 'import_record_id';
1118 ( $order_by ) = grep( { $_ eq $order_by } qw( import_record_id title status overlay_status ) ) ? $order_by : 'import_record_id';
1120 my $order_by_direction =
1121 uc( $parameters->{order_by_direction} // 'ASC' ) eq 'DESC' ? 'DESC' : 'ASC';
1123 $order_by .= " $order_by_direction, authorized_heading" if $order_by eq 'title';
1125 my $query = "SELECT title, author, isbn, issn, authorized_heading, import_records.import_record_id,
1126 record_sequence, status, overlay_status,
1127 matched_biblionumber, matched_authid, record_type
1128 FROM import_records
1129 LEFT JOIN import_auths ON (import_records.import_record_id=import_auths.import_record_id)
1130 LEFT JOIN import_biblios ON (import_records.import_record_id=import_biblios.import_record_id)
1131 WHERE import_batch_id = ?";
1132 my @params;
1133 push(@params, $batch_id);
1134 if ($status) {
1135 $query .= " AND status=?";
1136 push(@params,$status);
1139 $query.=" ORDER BY $order_by $order_by_direction";
1141 if($results_per_group){
1142 $query .= " LIMIT ?";
1143 push(@params, $results_per_group);
1145 if($offset){
1146 $query .= " OFFSET ?";
1147 push(@params, $offset);
1149 my $sth = $dbh->prepare_cached($query);
1150 $sth->execute(@params);
1151 my $results = $sth->fetchall_arrayref({});
1152 $sth->finish();
1153 return $results;
1157 =head2 GetBestRecordMatch
1159 my $record_id = GetBestRecordMatch($import_record_id);
1161 =cut
1163 sub GetBestRecordMatch {
1164 my ($import_record_id) = @_;
1166 my $dbh = C4::Context->dbh;
1167 my $sth = $dbh->prepare("SELECT candidate_match_id
1168 FROM import_record_matches
1169 JOIN import_records ON ( import_record_matches.import_record_id = import_records.import_record_id )
1170 LEFT JOIN biblio ON ( candidate_match_id = biblio.biblionumber )
1171 LEFT JOIN auth_header ON ( candidate_match_id = auth_header.authid )
1172 WHERE import_record_matches.import_record_id = ? AND
1173 ( (import_records.record_type = 'biblio' AND biblio.biblionumber IS NOT NULL) OR
1174 (import_records.record_type = 'auth' AND auth_header.authid IS NOT NULL) )
1175 ORDER BY score DESC, candidate_match_id DESC");
1176 $sth->execute($import_record_id);
1177 my ($record_id) = $sth->fetchrow_array();
1178 $sth->finish();
1179 return $record_id;
1182 =head2 GetImportBatchStatus
1184 my $status = GetImportBatchStatus($batch_id);
1186 =cut
1188 sub GetImportBatchStatus {
1189 my ($batch_id) = @_;
1191 my $dbh = C4::Context->dbh;
1192 my $sth = $dbh->prepare("SELECT import_status FROM import_batches WHERE import_batch_id = ?");
1193 $sth->execute($batch_id);
1194 my ($status) = $sth->fetchrow_array();
1195 $sth->finish();
1196 return $status;
1200 =head2 SetImportBatchStatus
1202 SetImportBatchStatus($batch_id, $new_status);
1204 =cut
1206 sub SetImportBatchStatus {
1207 my ($batch_id, $new_status) = @_;
1209 my $dbh = C4::Context->dbh;
1210 my $sth = $dbh->prepare("UPDATE import_batches SET import_status = ? WHERE import_batch_id = ?");
1211 $sth->execute($new_status, $batch_id);
1212 $sth->finish();
1216 =head2 GetImportBatchOverlayAction
1218 my $overlay_action = GetImportBatchOverlayAction($batch_id);
1220 =cut
1222 sub GetImportBatchOverlayAction {
1223 my ($batch_id) = @_;
1225 my $dbh = C4::Context->dbh;
1226 my $sth = $dbh->prepare("SELECT overlay_action FROM import_batches WHERE import_batch_id = ?");
1227 $sth->execute($batch_id);
1228 my ($overlay_action) = $sth->fetchrow_array();
1229 $sth->finish();
1230 return $overlay_action;
1235 =head2 SetImportBatchOverlayAction
1237 SetImportBatchOverlayAction($batch_id, $new_overlay_action);
1239 =cut
1241 sub SetImportBatchOverlayAction {
1242 my ($batch_id, $new_overlay_action) = @_;
1244 my $dbh = C4::Context->dbh;
1245 my $sth = $dbh->prepare("UPDATE import_batches SET overlay_action = ? WHERE import_batch_id = ?");
1246 $sth->execute($new_overlay_action, $batch_id);
1247 $sth->finish();
1251 =head2 GetImportBatchNoMatchAction
1253 my $nomatch_action = GetImportBatchNoMatchAction($batch_id);
1255 =cut
1257 sub GetImportBatchNoMatchAction {
1258 my ($batch_id) = @_;
1260 my $dbh = C4::Context->dbh;
1261 my $sth = $dbh->prepare("SELECT nomatch_action FROM import_batches WHERE import_batch_id = ?");
1262 $sth->execute($batch_id);
1263 my ($nomatch_action) = $sth->fetchrow_array();
1264 $sth->finish();
1265 return $nomatch_action;
1270 =head2 SetImportBatchNoMatchAction
1272 SetImportBatchNoMatchAction($batch_id, $new_nomatch_action);
1274 =cut
1276 sub SetImportBatchNoMatchAction {
1277 my ($batch_id, $new_nomatch_action) = @_;
1279 my $dbh = C4::Context->dbh;
1280 my $sth = $dbh->prepare("UPDATE import_batches SET nomatch_action = ? WHERE import_batch_id = ?");
1281 $sth->execute($new_nomatch_action, $batch_id);
1282 $sth->finish();
1286 =head2 GetImportBatchItemAction
1288 my $item_action = GetImportBatchItemAction($batch_id);
1290 =cut
1292 sub GetImportBatchItemAction {
1293 my ($batch_id) = @_;
1295 my $dbh = C4::Context->dbh;
1296 my $sth = $dbh->prepare("SELECT item_action FROM import_batches WHERE import_batch_id = ?");
1297 $sth->execute($batch_id);
1298 my ($item_action) = $sth->fetchrow_array();
1299 $sth->finish();
1300 return $item_action;
1305 =head2 SetImportBatchItemAction
1307 SetImportBatchItemAction($batch_id, $new_item_action);
1309 =cut
1311 sub SetImportBatchItemAction {
1312 my ($batch_id, $new_item_action) = @_;
1314 my $dbh = C4::Context->dbh;
1315 my $sth = $dbh->prepare("UPDATE import_batches SET item_action = ? WHERE import_batch_id = ?");
1316 $sth->execute($new_item_action, $batch_id);
1317 $sth->finish();
1321 =head2 GetImportBatchMatcher
1323 my $matcher_id = GetImportBatchMatcher($batch_id);
1325 =cut
1327 sub GetImportBatchMatcher {
1328 my ($batch_id) = @_;
1330 my $dbh = C4::Context->dbh;
1331 my $sth = $dbh->prepare("SELECT matcher_id FROM import_batches WHERE import_batch_id = ?");
1332 $sth->execute($batch_id);
1333 my ($matcher_id) = $sth->fetchrow_array();
1334 $sth->finish();
1335 return $matcher_id;
1340 =head2 SetImportBatchMatcher
1342 SetImportBatchMatcher($batch_id, $new_matcher_id);
1344 =cut
1346 sub SetImportBatchMatcher {
1347 my ($batch_id, $new_matcher_id) = @_;
1349 my $dbh = C4::Context->dbh;
1350 my $sth = $dbh->prepare("UPDATE import_batches SET matcher_id = ? WHERE import_batch_id = ?");
1351 $sth->execute($new_matcher_id, $batch_id);
1352 $sth->finish();
1356 =head2 GetImportRecordOverlayStatus
1358 my $overlay_status = GetImportRecordOverlayStatus($import_record_id);
1360 =cut
1362 sub GetImportRecordOverlayStatus {
1363 my ($import_record_id) = @_;
1365 my $dbh = C4::Context->dbh;
1366 my $sth = $dbh->prepare("SELECT overlay_status FROM import_records WHERE import_record_id = ?");
1367 $sth->execute($import_record_id);
1368 my ($overlay_status) = $sth->fetchrow_array();
1369 $sth->finish();
1370 return $overlay_status;
1375 =head2 SetImportRecordOverlayStatus
1377 SetImportRecordOverlayStatus($import_record_id, $new_overlay_status);
1379 =cut
1381 sub SetImportRecordOverlayStatus {
1382 my ($import_record_id, $new_overlay_status) = @_;
1384 my $dbh = C4::Context->dbh;
1385 my $sth = $dbh->prepare("UPDATE import_records SET overlay_status = ? WHERE import_record_id = ?");
1386 $sth->execute($new_overlay_status, $import_record_id);
1387 $sth->finish();
1391 =head2 GetImportRecordStatus
1393 my $status = GetImportRecordStatus($import_record_id);
1395 =cut
1397 sub GetImportRecordStatus {
1398 my ($import_record_id) = @_;
1400 my $dbh = C4::Context->dbh;
1401 my $sth = $dbh->prepare("SELECT status FROM import_records WHERE import_record_id = ?");
1402 $sth->execute($import_record_id);
1403 my ($status) = $sth->fetchrow_array();
1404 $sth->finish();
1405 return $status;
1410 =head2 SetImportRecordStatus
1412 SetImportRecordStatus($import_record_id, $new_status);
1414 =cut
1416 sub SetImportRecordStatus {
1417 my ($import_record_id, $new_status) = @_;
1419 my $dbh = C4::Context->dbh;
1420 my $sth = $dbh->prepare("UPDATE import_records SET status = ? WHERE import_record_id = ?");
1421 $sth->execute($new_status, $import_record_id);
1422 $sth->finish();
1426 =head2 GetImportRecordMatches
1428 my $results = GetImportRecordMatches($import_record_id, $best_only);
1430 =cut
1432 sub GetImportRecordMatches {
1433 my $import_record_id = shift;
1434 my $best_only = @_ ? shift : 0;
1436 my $dbh = C4::Context->dbh;
1437 # FIXME currently biblio only
1438 my $sth = $dbh->prepare_cached("SELECT title, author, biblionumber,
1439 candidate_match_id, score, record_type
1440 FROM import_records
1441 JOIN import_record_matches USING (import_record_id)
1442 LEFT JOIN biblio ON (biblionumber = candidate_match_id)
1443 WHERE import_record_id = ?
1444 ORDER BY score DESC, biblionumber DESC");
1445 $sth->bind_param(1, $import_record_id);
1446 my $results = [];
1447 $sth->execute();
1448 while (my $row = $sth->fetchrow_hashref) {
1449 if ($row->{'record_type'} eq 'auth') {
1450 $row->{'authorized_heading'} = C4::AuthoritiesMarc::GetAuthorizedHeading( { authid => $row->{'candidate_match_id'} } );
1452 next if ($row->{'record_type'} eq 'biblio' && not $row->{'biblionumber'});
1453 push @$results, $row;
1454 last if $best_only;
1456 $sth->finish();
1458 return $results;
1462 =head2 SetImportRecordMatches
1464 SetImportRecordMatches($import_record_id, @matches);
1466 =cut
1468 sub SetImportRecordMatches {
1469 my $import_record_id = shift;
1470 my @matches = @_;
1472 my $dbh = C4::Context->dbh;
1473 my $delsth = $dbh->prepare("DELETE FROM import_record_matches WHERE import_record_id = ?");
1474 $delsth->execute($import_record_id);
1475 $delsth->finish();
1477 my $sth = $dbh->prepare("INSERT INTO import_record_matches (import_record_id, candidate_match_id, score)
1478 VALUES (?, ?, ?)");
1479 foreach my $match (@matches) {
1480 $sth->execute($import_record_id, $match->{'record_id'}, $match->{'score'});
1484 =head2 RecordsFromISO2709File
1486 my ($errors, $records) = C4::ImportBatch::RecordsFromISO2709File($input_file, $record_type, $encoding);
1488 Reads ISO2709 binary porridge from the given file and creates MARC::Record-objects out of it.
1490 @PARAM1, String, absolute path to the ISO2709 file.
1491 @PARAM2, String, see stage_file.pl
1492 @PARAM3, String, should be utf8
1494 Returns two array refs.
1496 =cut
1498 sub RecordsFromISO2709File {
1499 my ($input_file, $record_type, $encoding) = @_;
1500 my @errors;
1502 my $marc_type = C4::Context->preference('marcflavour');
1503 $marc_type .= 'AUTH' if ($marc_type eq 'UNIMARC' && $record_type eq 'auth');
1505 open my $fh, '<', $input_file or die "$0: cannot open input file $input_file: $!\n";
1506 my @marc_records;
1507 $/ = "\035";
1508 while (<$fh>) {
1509 s/^\s+//;
1510 s/\s+$//;
1511 next unless $_; # skip if record has only whitespace, as might occur
1512 # if file includes newlines between each MARC record
1513 my ($marc_record, $charset_guessed, $char_errors) = MarcToUTF8Record($_, $marc_type, $encoding);
1514 push @marc_records, $marc_record;
1515 if ($charset_guessed ne $encoding) {
1516 push @errors,
1517 "Unexpected charset $charset_guessed, expecting $encoding";
1520 close $fh;
1521 return ( \@errors, \@marc_records );
1524 =head2 RecordsFromMARCXMLFile
1526 my ($errors, $records) = C4::ImportBatch::RecordsFromMARCXMLFile($input_file, $encoding);
1528 Creates MARC::Record-objects out of the given MARCXML-file.
1530 @PARAM1, String, absolute path to the ISO2709 file.
1531 @PARAM2, String, should be utf8
1533 Returns two array refs.
1535 =cut
1537 sub RecordsFromMARCXMLFile {
1538 my ( $filename, $encoding ) = @_;
1539 my $batch = MARC::File::XML->in( $filename );
1540 my ( @marcRecords, @errors, $record );
1541 do {
1542 eval { $record = $batch->next( $encoding ); };
1543 if ($@) {
1544 push @errors, $@;
1546 push @marcRecords, $record if $record;
1547 } while( $record );
1548 return (\@errors, \@marcRecords);
1551 =head2 RecordsFromMarcPlugin
1553 Converts text of input_file into array of MARC records with to_marc plugin
1555 =cut
1557 sub RecordsFromMarcPlugin {
1558 my ($input_file, $plugin_class, $encoding) = @_;
1559 my ( $text, @return );
1560 return \@return if !$input_file || !$plugin_class;
1562 # Read input file
1563 open my $fh, '<', $input_file or die "$0: cannot open input file $input_file: $!\n";
1564 $/ = "\035";
1565 while (<$fh>) {
1566 s/^\s+//;
1567 s/\s+$//;
1568 next unless $_;
1569 $text .= $_;
1571 close $fh;
1573 # Convert to large MARC blob with plugin
1574 $text = Koha::Plugins::Handler->run({
1575 class => $plugin_class,
1576 method => 'to_marc',
1577 params => { data => $text },
1578 }) if $text;
1580 # Convert to array of MARC records
1581 if( $text ) {
1582 my $marc_type = C4::Context->preference('marcflavour');
1583 foreach my $blob ( split(/\x1D/, $text) ) {
1584 next if $blob =~ /^\s*$/;
1585 my ($marcrecord) = MarcToUTF8Record($blob, $marc_type, $encoding);
1586 push @return, $marcrecord;
1589 return \@return;
1592 # internal functions
1594 sub _create_import_record {
1595 my ($batch_id, $record_sequence, $marc_record, $record_type, $encoding, $marc_type) = @_;
1597 my $dbh = C4::Context->dbh;
1598 my $sth = $dbh->prepare("INSERT INTO import_records (import_batch_id, record_sequence, marc, marcxml, marcxml_old,
1599 record_type, encoding)
1600 VALUES (?, ?, ?, ?, ?, ?, ?)");
1601 $sth->execute($batch_id, $record_sequence, $marc_record->as_usmarc(), $marc_record->as_xml($marc_type), '',
1602 $record_type, $encoding);
1603 my $import_record_id = $dbh->{'mysql_insertid'};
1604 $sth->finish();
1605 return $import_record_id;
1608 sub _update_import_record_marc {
1609 my ($import_record_id, $marc_record, $marc_type) = @_;
1611 my $dbh = C4::Context->dbh;
1612 my $sth = $dbh->prepare("UPDATE import_records SET marc = ?, marcxml = ?
1613 WHERE import_record_id = ?");
1614 $sth->execute($marc_record->as_usmarc(), $marc_record->as_xml($marc_type), $import_record_id);
1615 $sth->finish();
1618 sub _add_auth_fields {
1619 my ($import_record_id, $marc_record) = @_;
1621 my $controlnumber;
1622 if ($marc_record->field('001')) {
1623 $controlnumber = $marc_record->field('001')->data();
1625 my $authorized_heading = C4::AuthoritiesMarc::GetAuthorizedHeading({ record => $marc_record });
1626 my $dbh = C4::Context->dbh;
1627 my $sth = $dbh->prepare("INSERT INTO import_auths (import_record_id, control_number, authorized_heading) VALUES (?, ?, ?)");
1628 $sth->execute($import_record_id, $controlnumber, $authorized_heading);
1629 $sth->finish();
1632 sub _add_biblio_fields {
1633 my ($import_record_id, $marc_record) = @_;
1635 my ($title, $author, $isbn, $issn) = _parse_biblio_fields($marc_record);
1636 my $dbh = C4::Context->dbh;
1637 # FIXME no controlnumber, originalsource
1638 $isbn = C4::Koha::GetNormalizedISBN($isbn);
1639 my $sth = $dbh->prepare("INSERT INTO import_biblios (import_record_id, title, author, isbn, issn) VALUES (?, ?, ?, ?, ?)");
1640 $sth->execute($import_record_id, $title, $author, $isbn, $issn) or die $sth->errstr;
1641 $sth->finish();
1645 sub _update_biblio_fields {
1646 my ($import_record_id, $marc_record) = @_;
1648 my ($title, $author, $isbn, $issn) = _parse_biblio_fields($marc_record);
1649 my $dbh = C4::Context->dbh;
1650 # FIXME no controlnumber, originalsource
1651 # FIXME 2 - should regularize normalization of ISBN wherever it is done
1652 $isbn =~ s/\(.*$//;
1653 $isbn =~ tr/ -_//;
1654 $isbn = uc $isbn;
1655 my $sth = $dbh->prepare("UPDATE import_biblios SET title = ?, author = ?, isbn = ?, issn = ?
1656 WHERE import_record_id = ?");
1657 $sth->execute($title, $author, $isbn, $issn, $import_record_id);
1658 $sth->finish();
1661 sub _parse_biblio_fields {
1662 my ($marc_record) = @_;
1664 my $dbh = C4::Context->dbh;
1665 my $bibliofields = TransformMarcToKoha($marc_record, '');
1666 return ($bibliofields->{'title'}, $bibliofields->{'author'}, $bibliofields->{'isbn'}, $bibliofields->{'issn'});
1670 sub _update_batch_record_counts {
1671 my ($batch_id) = @_;
1673 my $dbh = C4::Context->dbh;
1674 my $sth = $dbh->prepare_cached("UPDATE import_batches SET
1675 num_records = (
1676 SELECT COUNT(*)
1677 FROM import_records
1678 WHERE import_batch_id = import_batches.import_batch_id),
1679 num_items = (
1680 SELECT COUNT(*)
1681 FROM import_records
1682 JOIN import_items USING (import_record_id)
1683 WHERE import_batch_id = import_batches.import_batch_id
1684 AND record_type = 'biblio')
1685 WHERE import_batch_id = ?");
1686 $sth->bind_param(1, $batch_id);
1687 $sth->execute();
1688 $sth->finish();
1691 sub _get_commit_action {
1692 my ($overlay_action, $nomatch_action, $item_action, $overlay_status, $import_record_id, $record_type) = @_;
1694 if ($record_type eq 'biblio') {
1695 my ($bib_result, $bib_match, $item_result);
1697 if ($overlay_status ne 'no_match') {
1698 $bib_match = GetBestRecordMatch($import_record_id);
1699 if ($overlay_action eq 'replace') {
1700 $bib_result = defined($bib_match) ? 'replace' : 'create_new';
1701 } elsif ($overlay_action eq 'create_new') {
1702 $bib_result = 'create_new';
1703 } elsif ($overlay_action eq 'ignore') {
1704 $bib_result = 'ignore';
1706 if($item_action eq 'always_add' or $item_action eq 'add_only_for_matches'){
1707 $item_result = 'create_new';
1709 elsif($item_action eq 'replace'){
1710 $item_result = 'replace';
1712 else {
1713 $item_result = 'ignore';
1715 } else {
1716 $bib_result = $nomatch_action;
1717 $item_result = ($item_action eq 'always_add' or $item_action eq 'add_only_for_new') ? 'create_new' : 'ignore';
1719 return ($bib_result, $item_result, $bib_match);
1720 } else { # must be auths
1721 my ($auth_result, $auth_match);
1723 if ($overlay_status ne 'no_match') {
1724 $auth_match = GetBestRecordMatch($import_record_id);
1725 if ($overlay_action eq 'replace') {
1726 $auth_result = defined($auth_match) ? 'replace' : 'create_new';
1727 } elsif ($overlay_action eq 'create_new') {
1728 $auth_result = 'create_new';
1729 } elsif ($overlay_action eq 'ignore') {
1730 $auth_result = 'ignore';
1732 } else {
1733 $auth_result = $nomatch_action;
1736 return ($auth_result, undef, $auth_match);
1741 sub _get_revert_action {
1742 my ($overlay_action, $overlay_status, $status) = @_;
1744 my $bib_result;
1746 if ($status eq 'ignored') {
1747 $bib_result = 'ignore';
1748 } else {
1749 if ($overlay_action eq 'create_new') {
1750 $bib_result = 'delete';
1751 } else {
1752 $bib_result = ($overlay_status eq 'match_applied') ? 'restore' : 'delete';
1755 return $bib_result;
1759 __END__
1761 =head1 AUTHOR
1763 Koha Development Team <http://koha-community.org/>
1765 Galen Charlton <galen.charlton@liblime.com>
1767 =cut