Bug 14383: misc: Fix some typos in comments and documentation
[koha.git] / tools / stage-marc-import.pl
1 #!/usr/bin/perl
2
3 # Script for handling import of MARC data into Koha db
4 #   and Z39.50 lookups
5
6 # Koha library project  www.koha-community.org
7
8 # Licensed under the GPL
9
10 # Copyright 2000-2002 Katipo Communications
11 #
12 # This file is part of Koha.
13 #
14 # Koha is free software; you can redistribute it and/or modify it
15 # under the terms of the GNU General Public License as published by
16 # the Free Software Foundation; either version 3 of the License, or
17 # (at your option) any later version.
18 #
19 # Koha is distributed in the hope that it will be useful, but
20 # WITHOUT ANY WARRANTY; without even the implied warranty of
21 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
22 # GNU General Public License for more details.
23 #
24 # You should have received a copy of the GNU General Public License
25 # along with Koha; if not, see <http://www.gnu.org/licenses>.
26
27 use strict;
28 #use warnings; FIXME - Bug 2505
29
30 # standard or CPAN modules used
31 use CGI qw ( -utf8 );
32 use CGI::Cookie;
33 use MARC::File::USMARC;
34
35 # Koha modules used
36 use C4::Context;
37 use C4::Auth;
38 use C4::Output;
39 use C4::Biblio;
40 use C4::ImportBatch;
41 use C4::Matcher;
42 use C4::UploadedFile;
43 use C4::BackgroundJob;
44 use C4::MarcModificationTemplates;
45 use Koha::Plugins;
46
47 my $input = new CGI;
48
49 my $fileID                     = $input->param('uploadedfileid');
50 my $runinbackground            = $input->param('runinbackground');
51 my $completedJobID             = $input->param('completedJobID');
52 my $matcher_id                 = $input->param('matcher');
53 my $overlay_action             = $input->param('overlay_action');
54 my $nomatch_action             = $input->param('nomatch_action');
55 my $parse_items                = $input->param('parse_items');
56 my $item_action                = $input->param('item_action');
57 my $comments                   = $input->param('comments');
58 my $record_type                = $input->param('record_type');
59 my $encoding                   = $input->param('encoding');
60 my $to_marc_plugin             = $input->param('to_marc_plugin');
61 my $marc_modification_template = $input->param('marc_modification_template_id');
62
63 my ( $template, $loggedinuser, $cookie ) = get_template_and_user(
64     {
65         template_name   => "tools/stage-marc-import.tt",
66         query           => $input,
67         type            => "intranet",
68         authnotrequired => 0,
69         flagsrequired   => { tools => 'stage_marc_import' },
70         debug           => 1,
71     }
72 );
73
74 $template->param(
75     SCRIPT_NAME => $ENV{'SCRIPT_NAME'},
76     uploadmarc  => $fileID,
77     record_type => $record_type,
78 );
79
80 my %cookies = parse CGI::Cookie($cookie);
81 my $sessionID = $cookies{'CGISESSID'}->value;
82 if ($completedJobID) {
83     my $job = C4::BackgroundJob->fetch($sessionID, $completedJobID);
84     my $results = $job->results();
85     $template->param(map { $_ => $results->{$_} } keys %{ $results });
86 } elsif ($fileID) {
87     my $uploaded_file = C4::UploadedFile->fetch($sessionID, $fileID);
88     my $fh = $uploaded_file->fh();
89         my $marcrecord='';
90     $/ = "\035";
91         while (<$fh>) {
92         s/^\s+//;
93         s/\s+$//;
94                 $marcrecord.=$_;
95         }
96
97     my $filename = $uploaded_file->name();
98     my $job = undef;
99     my $dbh;
100     if ($runinbackground) {
101         my $job_size = () = $marcrecord =~ /\035/g;
102         # if we're matching, job size is doubled
103         $job_size *= 2 if ($matcher_id ne "");
104         $job = C4::BackgroundJob->new($sessionID, $filename, $ENV{'SCRIPT_NAME'}, $job_size);
105         my $jobID = $job->id();
106
107         # fork off
108         if (my $pid = fork) {
109             # parent
110             # return job ID as JSON
111             my $reply = CGI->new("");
112             print $reply->header(-type => 'text/html');
113             print '{"jobID":"' . $jobID . '"}';
114             exit 0;
115         } elsif (defined $pid) {
116             # child
117             # close STDOUT to signal to Apache that
118             # we're now running in the background
119             close STDOUT;
120             # close STDERR; # there is no good reason to close STDERR
121         } else {
122             # fork failed, so exit immediately
123             warn "fork failed while attempting to run $ENV{'SCRIPT_NAME'} as a background job: $!";
124             exit 0;
125         }
126
127         # if we get here, we're a child that has detached
128         # itself from Apache
129
130     }
131
132     # New handle, as we're a child.
133     $dbh = C4::Context->dbh({new => 1});
134     $dbh->{AutoCommit} = 0;
135     # FIXME branch code
136     my ( $batch_id, $num_valid, $num_items, @import_errors ) =
137       BatchStageMarcRecords(
138         $record_type,    $encoding,
139         $marcrecord,     $filename,
140         $to_marc_plugin, $marc_modification_template,
141         $comments,       '',
142         $parse_items,    0,
143         50, staging_progress_callback( $job, $dbh )
144       );
145
146     my $num_with_matches = 0;
147     my $checked_matches = 0;
148     my $matcher_failed = 0;
149     my $matcher_code = "";
150     if ($matcher_id ne "") {
151         my $matcher = C4::Matcher->fetch($matcher_id);
152         if (defined $matcher) {
153             $checked_matches = 1;
154             $matcher_code = $matcher->code();
155             $num_with_matches =
156               BatchFindDuplicates( $batch_id, $matcher, 10, 50,
157                 matching_progress_callback( $job, $dbh ) );
158             SetImportBatchMatcher($batch_id, $matcher_id);
159             SetImportBatchOverlayAction($batch_id, $overlay_action);
160             SetImportBatchNoMatchAction($batch_id, $nomatch_action);
161             SetImportBatchItemAction($batch_id, $item_action);
162             $dbh->commit();
163         } else {
164             $matcher_failed = 1;
165         }
166     } else {
167         $dbh->commit();
168     }
169
170     my $results = {
171         staged          => $num_valid,
172         matched         => $num_with_matches,
173         num_items       => $num_items,
174         import_errors   => scalar(@import_errors),
175         total           => $num_valid + scalar(@import_errors),
176         checked_matches => $checked_matches,
177         matcher_failed  => $matcher_failed,
178         matcher_code    => $matcher_code,
179         import_batch_id => $batch_id
180     };
181     if ($runinbackground) {
182         $job->finish($results);
183     } else {
184             $template->param(staged => $num_valid,
185                              matched => $num_with_matches,
186                          num_items => $num_items,
187                          import_errors => scalar(@import_errors),
188                          total => $num_valid + scalar(@import_errors),
189                          checked_matches => $checked_matches,
190                          matcher_failed => $matcher_failed,
191                          matcher_code => $matcher_code,
192                          import_batch_id => $batch_id
193                         );
194     }
195
196 } else {
197     # initial form
198     if ( C4::Context->preference("marcflavour") eq "UNIMARC" ) {
199         $template->param( "UNIMARC" => 1 );
200     }
201     my @matchers = C4::Matcher::GetMatcherList();
202     $template->param( available_matchers => \@matchers );
203
204     my @templates = GetModificationTemplates();
205     $template->param( MarcModificationTemplatesLoop => \@templates );
206
207     if ( C4::Context->preference('UseKohaPlugins') &&
208          C4::Context->config('enable_plugins') ) {
209
210         my @plugins = Koha::Plugins->new()->GetPlugins('to_marc');
211         $template->param( plugins => \@plugins );
212     }
213 }
214
215 output_html_with_http_headers $input, $cookie, $template->output;
216
217 exit 0;
218
219 sub staging_progress_callback {
220     my $job = shift;
221     my $dbh = shift;
222     return sub {
223         my $progress = shift;
224         $job->progress($progress);
225     }
226 }
227
228 sub matching_progress_callback {
229     my $job = shift;
230     my $dbh = shift;
231     my $start_progress = $job->progress();
232     return sub {
233         my $progress = shift;
234         $job->progress($start_progress + $progress);
235     }
236 }