Bug 24151: Copy info to the pseudonymized table when a transaction is done
[koha.git] / C4 / Breeding.pm
1 package C4::Breeding;
2
3 # Copyright 2000-2002 Katipo Communications
4 # Parts Copyright 2013 Prosentient Systems
5 #
6 # This file is part of Koha.
7 #
8 # Koha is free software; you can redistribute it and/or modify it
9 # under the terms of the GNU General Public License as published by
10 # the Free Software Foundation; either version 3 of the License, or
11 # (at your option) any later version.
12 #
13 # Koha is distributed in the hope that it will be useful, but
14 # WITHOUT ANY WARRANTY; without even the implied warranty of
15 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 # GNU General Public License for more details.
17 #
18 # You should have received a copy of the GNU General Public License
19 # along with Koha; if not, see <http://www.gnu.org/licenses>.
20
21 use strict;
22 use warnings;
23
24 use C4::Biblio;
25 use C4::Koha;
26 use C4::Charset;
27 use MARC::File::USMARC;
28 use MARC::Field;
29 use C4::ImportBatch;
30 use C4::AuthoritiesMarc; #GuessAuthTypeCode, FindDuplicateAuthority
31 use C4::Languages;
32 use Koha::Database;
33 use Koha::XSLT::Base;
34
35 use vars qw(@ISA @EXPORT @EXPORT_OK %EXPORT_TAGS);
36
37 BEGIN {
38         require Exporter;
39         @ISA = qw(Exporter);
40     @EXPORT = qw(&BreedingSearch &Z3950Search &Z3950SearchAuth);
41 }
42
43 =head1 NAME
44
45 C4::Breeding : module to add biblios to import_records via
46                the breeding/reservoir API.
47
48 =head1 SYNOPSIS
49
50     Z3950Search($pars, $template);
51     ($count, @results) = &BreedingSearch($title,$isbn);
52
53 =head1 DESCRIPTION
54
55 This module contains routines related to Koha's Z39.50 search into
56 cataloguing reservoir features.
57
58 =head2 BreedingSearch
59
60 ($count, @results) = &BreedingSearch($title,$isbn);
61 C<$title> contains the title,
62 C<$isbn> contains isbn or issn,
63
64 C<$count> is the number of items in C<@results>. C<@results> is an
65 array of references-to-hash; the keys are the items from the C<import_records> and
66 C<import_biblios> tables of the Koha database.
67
68 =cut
69
70 sub BreedingSearch {
71     my ($search,$isbn) = @_;
72     my $dbh   = C4::Context->dbh;
73     my $count = 0;
74     my ($query,@bind);
75     my $sth;
76     my @results;
77
78     # normalise ISBN like at import
79     $isbn = C4::Koha::GetNormalizedISBN($isbn);
80
81     $query = "SELECT import_record_id, file_name, isbn, title, author
82               FROM  import_biblios 
83               JOIN import_records USING (import_record_id)
84               JOIN import_batches USING (import_batch_id)
85               WHERE ";
86     @bind=();
87     if (defined($search) && length($search)>0) {
88         $search =~ s/(\s+)/\%/g;
89         $query .= "title like ? OR author like ?";
90         push(@bind,"%$search%", "%$search%");
91     }
92     if ($#bind!=-1 && defined($isbn) && length($isbn)>0) {
93         $query .= " and ";
94     }
95     if (defined($isbn) && length($isbn)>0) {
96         $query .= "isbn like ?";
97         push(@bind,"$isbn%");
98     }
99     $sth = $dbh->prepare($query);
100     $sth->execute(@bind);
101     while (my $data = $sth->fetchrow_hashref) {
102             $results[$count] = $data;
103             # FIXME - hack to reflect difference in name 
104             # of columns in old marc_breeding and import_records
105             # There needs to be more separation between column names and 
106             # field names used in the templates </soapbox>
107             $data->{'file'} = $data->{'file_name'};
108             $data->{'id'} = $data->{'import_record_id'};
109             $count++;
110     } # while
111
112     $sth->finish;
113     return($count, @results);
114 } # sub breedingsearch
115
116
117 =head2 Z3950Search
118
119 Z3950Search($pars, $template);
120
121 Parameters for Z3950 search are all passed via the $pars hash. It may contain isbn, title, author, dewey, subject, lccall, controlnumber, stdid, srchany.
122 Also it should contain an arrayref id that points to a list of id's of the z3950 targets to be queried (see z3950servers table).
123 This code is used in acqui/z3950_search and cataloging/z3950_search.
124 The second parameter $template is a Template object. The routine uses this parameter to store the found values into the template.
125
126 =cut
127
128 sub Z3950Search {
129     my ($pars, $template)= @_;
130
131     my @id= @{$pars->{id}};
132     my $page= $pars->{page};
133     my $biblionumber= $pars->{biblionumber};
134
135     my $show_next       = 0;
136     my $total_pages     = 0;
137     my @results;
138     my @breeding_loop = ();
139     my @oConnection;
140     my @oResult;
141     my @errconn;
142     my $s = 0;
143     my $imported=0;
144
145     my ( $zquery, $squery ) = _bib_build_query( $pars );
146
147     my $schema = Koha::Database->new()->schema();
148     my $rs = $schema->resultset('Z3950server')->search(
149         { id => [ @id ] },
150         { result_class => 'DBIx::Class::ResultClass::HashRefInflator' },
151     );
152     my @servers = $rs->all;
153     foreach my $server ( @servers ) {
154         my $server_zquery = $zquery;
155         if(my $attributes = $server->{attributes}){
156             $server_zquery = "$attributes $zquery";
157         }
158         $oConnection[$s] = _create_connection( $server );
159         $oResult[$s] =
160             $server->{servertype} eq 'zed'?
161                 $oConnection[$s]->search_pqf( $server_zquery ):
162                 $oConnection[$s]->search(new ZOOM::Query::CQL(
163                     _translate_query( $server, $squery )));
164         $s++;
165     }
166     my $xslh = Koha::XSLT::Base->new;
167
168     my $nremaining = $s;
169     while ( $nremaining-- ) {
170         my $k;
171         my $event;
172         while ( ( $k = ZOOM::event( \@oConnection ) ) != 0 ) {
173             $event = $oConnection[ $k - 1 ]->last_event();
174             last if $event == ZOOM::Event::ZEND;
175         }
176
177         if ( $k != 0 ) {
178             $k--;
179             my ($error)= $oConnection[$k]->error_x(); #ignores errmsg, addinfo, diagset
180             if ($error) {
181                 if ($error =~ m/^(10000|10007)$/ ) {
182                     push(@errconn, { server => $servers[$k]->{host}, error => $error } );
183                 }
184             }
185             else {
186                 my $numresults = $oResult[$k]->size();
187                 my $i;
188                 my $res;
189                 if ( $numresults > 0  and $numresults >= (($page-1)*20)) {
190                     $show_next = 1 if $numresults >= ($page*20);
191                     $total_pages = int($numresults/20)+1 if $total_pages < ($numresults/20);
192                     for ($i = ($page-1)*20; $i < (($numresults < ($page*20)) ? $numresults : ($page*20)); $i++) {
193                         if ( $oResult[$k]->record($i) ) {
194                             undef $error;
195                             ( $res, $error ) = _handle_one_result( $oResult[$k]->record($i), $servers[$k], ++$imported, $biblionumber, $xslh ); #ignores error in sequence numbering
196                             push @breeding_loop, $res if $res;
197                             push @errconn, { server => $servers[$k]->{servername}, error => $error, seq => $i+1 } if $error;
198                         }
199                         else {
200                             push @errconn, { 'server' => $servers[$k]->{servername}, error => ( ( $oConnection[$k]->error_x() )[0] ), seq => $i+1 };
201                         }
202                     }
203                 }    #if $numresults
204             }
205         }    # if $k !=0
206
207         $template->param(
208             numberpending => $nremaining,
209             current_page => $page,
210             total_pages => $total_pages,
211             show_nextbutton => $show_next?1:0,
212             show_prevbutton => $page!=1,
213         );
214     } # while nremaining
215
216     #close result sets and connections
217     foreach(0..$s-1) {
218         $oResult[$_]->destroy();
219         $oConnection[$_]->destroy();
220     }
221
222     $template->param(
223         breeding_loop => \@breeding_loop,
224         servers => \@servers,
225         errconn       => \@errconn
226     );
227 }
228
229 sub _auth_build_query {
230     my ( $pars ) = @_;
231
232     my $qry_build = {
233         nameany           => '@attr 1=1002 "#term" ',
234         authorany         => '@attr 1=1003 "#term" ',
235         authorcorp        => '@attr 1=2 "#term" ',
236         authorpersonal    => '@attr 1=1 "#term" ',
237         authormeetingcon  => '@attr 1=3 "#term" ',
238         subject           => '@attr 1=21 "#term" ',
239         subjectsubdiv     => '@attr 1=47 "#term" ',
240         title             => '@attr 1=4 "#term" ',
241         uniformtitle      => '@attr 1=6 "#term" ',
242         srchany           => '@attr 1=1016 "#term" ',
243         controlnumber     => '@attr 1=12 "#term" ',
244     };
245
246     return _build_query( $pars, $qry_build );
247 }
248
249 sub _bib_build_query {
250
251     my ( $pars ) = @_;
252
253     my $qry_build = {
254         isbn    => '@attr 1=7 @attr 5=1 "#term" ',
255         issn    => '@attr 1=8 @attr 5=1 "#term" ',
256         title   => '@attr 1=4 "#term" ',
257         author  => '@attr 1=1003 "#term" ',
258         dewey   => '@attr 1=16 "#term" ',
259         subject => '@attr 1=21 "#term" ',
260         lccall  => '@attr 1=16 @attr 2=3 @attr 3=1 @attr 4=1 @attr 5=1 '.
261                    '@attr 6=1 "#term" ',
262         controlnumber => '@attr 1=12 "#term" ',
263         srchany => '@attr 1=1016 "#term" ',
264         stdid   => '@attr 1=1007 "#term" ',
265         publicationyear => '@attr 1=31 "#term" '
266     };
267
268     return _build_query( $pars, $qry_build );
269 }
270
271 sub _build_query {
272
273     my ( $pars, $qry_build ) = @_;
274
275     my $zquery='';
276     my $squery='';
277     my $nterms=0;
278     foreach my $k ( sort keys %$pars ) {
279     #note that the sort keys forces an identical result under Perl 5.18
280     #one of the unit tests is based on that assumption
281         if( ( my $val=$pars->{$k} ) && $qry_build->{$k} ) {
282             $qry_build->{$k} =~ s/#term/$val/g;
283             $zquery .= $qry_build->{$k};
284             $squery .= "[$k]=\"$val\" and ";
285             $nterms++;
286         }
287     }
288     $zquery = "\@and " . $zquery for 2..$nterms;
289     $squery =~ s/ and $//;
290     return ( $zquery, $squery );
291 }
292
293 sub _handle_one_result {
294     my ( $zoomrec, $servhref, $seq, $bib, $xslh )= @_;
295
296     my $raw= $zoomrec->raw();
297     my $marcrecord;
298     if( $servhref->{servertype} eq 'sru' ) {
299         $marcrecord= MARC::Record->new_from_xml( $raw, 'UTF-8',
300             $servhref->{syntax} );
301     } else {
302         ($marcrecord) = MarcToUTF8Record($raw, C4::Context->preference('marcflavour'), $servhref->{encoding} // "iso-5426" ); #ignores charset return values
303     }
304     SetUTF8Flag($marcrecord);
305     my $error;
306     ( $marcrecord, $error ) = _do_xslt_proc($marcrecord, $servhref, $xslh);
307
308     my $batch_id = GetZ3950BatchId($servhref->{servername});
309     my $breedingid = AddBiblioToBatch($batch_id, $seq, $marcrecord, 'UTF-8', 0);
310         #Last zero indicates: no update for batch record counts
311
312
313     #call to TransformMarcToKoha replaced by next call
314     #we only need six fields from the marc record
315     my $row;
316     $row = _add_rowdata(
317         {
318             biblionumber => $bib,
319             server       => $servhref->{servername},
320             breedingid   => $breedingid,
321         }, $marcrecord) if $breedingid;
322     return ( $row, $error );
323 }
324
325 sub _do_xslt_proc {
326     my ( $marc, $server, $xslh ) = @_;
327     return $marc if !$server->{add_xslt};
328
329     my $htdocs = C4::Context->config('intrahtdocs');
330     my $theme = C4::Context->preference("template"); #staff
331     my $lang = C4::Languages::getlanguage() || 'en';
332
333     my @files= split ',', $server->{add_xslt};
334     my $xml = $marc->as_xml;
335     foreach my $f ( @files ) {
336         $f =~ s/^\s+//; $f =~ s/\s+$//; next if !$f;
337         $f = C4::XSLT::_get_best_default_xslt_filename(
338             $htdocs, $theme, $lang, $f ) unless $f =~ /^\//;
339         $xml = $xslh->transform( $xml, $f );
340         last if $xslh->err; #skip other files
341     }
342     if( !$xslh->err ) {
343         return MARC::Record->new_from_xml($xml, 'UTF-8');
344     } else {
345         return ( $marc, $xslh->err ); #original record in case of errors
346     }
347 }
348
349 sub _add_rowdata {
350     my ($row, $record)=@_;
351     my %fetch= (
352         title => 'biblio.title',
353         author => 'biblio.author',
354         isbn =>'biblioitems.isbn',
355         lccn =>'biblioitems.lccn', #LC control number (not call number)
356         edition =>'biblioitems.editionstatement'
357     );
358     $fetch{date} = C4::Context->preference('marcflavour') eq "MARC21" ? 'biblio.copyrightdate' : 'biblioitems.publicationyear';
359
360     foreach my $k (keys %fetch) {
361         $row->{$k} = C4::Biblio::TransformMarcToKohaOneField( $fetch{$k}, $record );
362     }
363     $row->{date}//= $row->{date2};
364     $row->{isbn}=_isbn_replace($row->{isbn});
365
366     $row = _add_custom_field_rowdata($row, $record);
367
368     return $row;
369 }
370
371 sub _add_custom_field_rowdata
372 {
373     my ( $row, $record ) = @_;
374     my $pref_newtags = C4::Context->preference('AdditionalFieldsInZ3950ResultSearch');
375     my $pref_flavour = C4::Context->preference('MarcFlavour');
376
377     $pref_newtags =~ s/^\s+|\s+$//g;
378     $pref_newtags =~ s/\h+/ /g;
379
380     my @addnumberfields;
381
382     foreach my $field (split /\,/, $pref_newtags) {
383         $field =~ s/^\s+|\s+$//g ;  # trim whitespace
384         my ($tag, $subtags) = split(/\$/, $field);
385
386         if ( $record->field($tag) ) {
387             my @content = ();
388
389             for my $marcfield ($record->field($tag)) {
390                 if ( $subtags ) {
391                     my $str = '';
392                     for my $code (split //, $subtags) {
393                         if ( $marcfield->subfield($code) ) {
394                             $str .= $marcfield->subfield($code) . ' ';
395                         }
396                     }
397                     if ( not $str eq '') {
398                         push @content, $str;
399                     }
400                 } elsif ( $tag == 10 ) {
401                     push @content, ( $pref_flavour eq "MARC21" ? $marcfield->data : $marcfield->as_string );
402                 } elsif ( $tag < 10 ) {
403                     push @content, $marcfield->data();
404                 } else {
405                     push @content, $marcfield->as_string();
406                 }
407             }
408
409             if ( @content ) {
410                 $row->{$field} = \@content;
411                 push( @addnumberfields, $field );
412             }
413         }
414     }
415
416     $row->{'addnumberfields'} = \@addnumberfields;
417
418     return $row;
419 }
420
421 sub _isbn_replace {
422     my ($isbn) = @_;
423     return unless defined $isbn;
424     $isbn =~ s/ |-|\.//g;
425     $isbn =~ s/\|/ \| /g;
426     $isbn =~ s/\(/ \(/g;
427     return $isbn;
428 }
429
430 sub _create_connection {
431     my ( $server ) = @_;
432     my $option1= new ZOOM::Options();
433     $option1->option( 'async' => 1 );
434     $option1->option( 'elementSetName', 'F' );
435     $option1->option( 'preferredRecordSyntax', $server->{syntax} );
436     $option1->option( 'timeout', $server->{timeout} ) if $server->{timeout};
437
438     if( $server->{servertype} eq 'sru' ) {
439         foreach( split ',', $server->{sru_options}//'' ) {
440             #first remove surrounding spaces at comma and equals-sign
441             s/^\s+|\s+$//g;
442             my @temp= split '=', $_, 2;
443             @temp= map { my $c=$_; $c=~s/^\s+|\s+$//g; $c; } @temp;
444             $option1->option( $temp[0] => $temp[1] ) if @temp;
445         }
446     } elsif( $server->{servertype} eq 'zed' ) {
447         $option1->option( 'databaseName',   $server->{db} );
448         $option1->option( 'user', $server->{userid} ) if $server->{userid};
449         $option1->option( 'password', $server->{password} ) if $server->{password};
450     }
451     my $obj= ZOOM::Connection->create($option1);
452     if( $server->{servertype} eq 'sru' ) {
453         my $host= $server->{host};
454         if( $host !~ /^https?:\/\// ) {
455             #Normally, host will not be prefixed by protocol.
456             #In that case we can (safely) assume http.
457             #In case someone prefixed with https, give it a try..
458             $host = 'http://' . $host;
459         }
460         $obj->connect( $host.':'.$server->{port}.'/'.$server->{db} );
461     } else {
462         $obj->connect( $server->{host}, $server->{port} );
463     }
464     return $obj;
465 }
466
467 sub _translate_query { #SRU query adjusted per server cf. srufields column
468     my ($server, $query) = @_;
469
470     #sru_fields is in format title=field,isbn=field,...
471     #if a field doesn't exist, try anywhere or remove [field]=
472     my @parts= split(',', $server->{sru_fields} );
473     my %trans= map { if( /=/ ) { ( $`,$' ) } else { () } } @parts;
474     my $any= $trans{srchany}?$trans{srchany}.'=':'';
475
476     my $q=$query;
477     foreach my $key (keys %trans) {
478         my $f=$trans{$key};
479         if( $f ) {
480             $q=~s/\[$key\]/$f/g;
481         } else {
482             $q=~s/\[$key\]=/$any/g;
483         }
484     }
485     $q=~s/\[\w+\]=/$any/g; # remove remaining fields (not found in field list)
486     return $q;
487 }
488
489 =head2 ImportBreedingAuth
490
491 ImportBreedingAuth( $marcrecord, $filename, $encoding, $heading );
492
493     ImportBreedingAuth imports MARC records in the reservoir (import_records table) or returns their id if they already exist.
494
495 =cut
496
497 sub ImportBreedingAuth {
498     my ( $marcrecord, $filename, $encoding, $heading ) = @_;
499     my $dbh = C4::Context->dbh;
500
501     my $batch_id = GetZ3950BatchId($filename);
502     my $searchbreeding = $dbh->prepare("select import_record_id from import_auths where control_number=? and authorized_heading=?");
503
504     my $controlnumber = $marcrecord->field('001')->data;
505
506     # Normalize the record so it doesn't have separated diacritics
507     SetUTF8Flag($marcrecord);
508
509     $searchbreeding->execute($controlnumber,$heading);
510     my ($breedingid) = $searchbreeding->fetchrow;
511
512     return $breedingid if $breedingid;
513     $breedingid = AddAuthToBatch($batch_id, 0, $marcrecord, $encoding);
514     return $breedingid;
515 }
516
517 =head2 Z3950SearchAuth
518
519 Z3950SearchAuth($pars, $template);
520
521 Parameters for Z3950 search are all passed via the $pars hash. It may contain nameany, namepersonal, namecorp, namemeetingcon,
522 title, uniform title, subject, subjectsubdiv, srchany.
523 Also it should contain an arrayref id that points to a list of IDs of the z3950 targets to be queried (see z3950servers table).
524 This code is used in cataloging/z3950_auth_search.
525 The second parameter $template is a Template object. The routine uses this parameter to store the found values into the template.
526
527 =cut
528
529 sub Z3950SearchAuth {
530     my ($pars, $template)= @_;
531
532     my $dbh   = C4::Context->dbh;
533     my @id= @{$pars->{id}};
534     my $page= $pars->{page};
535
536
537     my $show_next       = 0;
538     my $total_pages     = 0;
539     my @encoding;
540     my @results;
541     my @serverhost;
542     my @breeding_loop = ();
543     my @oConnection;
544     my @oResult;
545     my @errconn;
546     my @servers;
547     my $s = 0;
548     my $query;
549     my $nterms=0;
550
551     my $marcflavour = C4::Context->preference('marcflavour');
552     my $marc_type = $marcflavour eq 'UNIMARC' ? 'UNIMARCAUTH' : $marcflavour;
553     my $authid= $pars->{authid};
554     my ( $zquery, $squery ) = _auth_build_query( $pars );
555     foreach my $servid (@id) {
556         my $sth = $dbh->prepare("select * from z3950servers where id=?");
557         $sth->execute($servid);
558         while ( my $server = $sth->fetchrow_hashref ) {
559             $oConnection[$s] = _create_connection( $server );
560
561             if ( $server->{servertype} eq 'zed' ) {
562                 my $server_zquery = $zquery;
563                 if ( my $attributes = $server->{attributes} ) {
564                     $server_zquery = "$attributes $zquery";
565                 }
566                 $oResult[$s] = $oConnection[$s]->search_pqf( $server_zquery );
567             }
568             else {
569                 $oResult[$s] = $oConnection[$s]->search(
570                     new ZOOM::Query::CQL(_translate_query( $server, $squery ))
571                 );
572             }
573             $encoding[$s]   = ($server->{encoding}?$server->{encoding}:"iso-5426");
574             $servers[$s] = $server;
575             $s++;
576         }   ## while fetch
577     }    # foreach
578     my $nremaining  = $s;
579
580     while ( $nremaining-- ) {
581         my $k;
582         my $event;
583         while ( ( $k = ZOOM::event( \@oConnection ) ) != 0 ) {
584             $event = $oConnection[ $k - 1 ]->last_event();
585             last if $event == ZOOM::Event::ZEND;
586         }
587
588         if ( $k != 0 ) {
589             $k--;
590             my ($error )= $oConnection[$k]->error_x(); #ignores errmsg, addinfo, diagset
591             if ($error) {
592                 if ($error =~ m/^(10000|10007)$/ ) {
593                     push(@errconn, {'server' => $serverhost[$k]});
594                 }
595             }
596             else {
597                 my $numresults = $oResult[$k]->size();
598                 my $i;
599                 my $result = '';
600                 if ( $numresults > 0  and $numresults >= (($page-1)*20)) {
601                     $show_next = 1 if $numresults >= ($page*20);
602                     $total_pages = int($numresults/20)+1 if $total_pages < ($numresults/20);
603                     for ($i = ($page-1)*20; $i < (($numresults < ($page*20)) ? $numresults : ($page*20)); $i++) {
604                         my $rec = $oResult[$k]->record($i);
605                         if ($rec) {
606                             my $marcrecord;
607                             my $marcdata;
608                             $marcdata   = $rec->raw();
609
610                             my ($charset_result, $charset_errors);
611                             if( $servers[$k]->{servertype} eq 'sru' ) {
612                                 $marcrecord = MARC::Record->new_from_xml( $marcdata, 'UTF-8', $servers[$k]->{syntax} );
613                             } else {
614                                 ( $marcrecord, $charset_result, $charset_errors ) = MarcToUTF8Record( $marcdata, $marc_type, $encoding[$k] );
615                             }
616                             my $heading;
617                             my $heading_authtype_code;
618                             $heading_authtype_code = GuessAuthTypeCode($marcrecord);
619                             $heading = C4::AuthoritiesMarc::GetAuthorizedHeading({ record => $marcrecord });
620
621                             my $breedingid = ImportBreedingAuth( $marcrecord, $serverhost[$k], $encoding[$k], $heading );
622                             my %row_data;
623                             $row_data{server}       = $servers[$k]->{'servername'};
624                             $row_data{breedingid}   = $breedingid;
625                             $row_data{heading}      = $heading;
626                             $row_data{authid}       = $authid;
627                             $row_data{heading_code}      = $heading_authtype_code;
628                             push( @breeding_loop, \%row_data );
629                         }
630                         else {
631                             push(@breeding_loop,{'server'=>$servers[$k]->{'servername'},'title'=>join(': ',$oConnection[$k]->error_x()),'breedingid'=>-1,'authid'=>-1});
632                         }
633                     }
634                 }    #if $numresults
635             }
636         }    # if $k !=0
637
638         $template->param(
639             numberpending => $nremaining,
640             current_page => $page,
641             total_pages => $total_pages,
642             show_nextbutton => $show_next?1:0,
643             show_prevbutton => $page!=1,
644         );
645     } # while nremaining
646
647     #close result sets and connections
648     foreach(0..$s-1) {
649         $oResult[$_]->destroy();
650         $oConnection[$_]->destroy();
651     }
652
653     @servers = ();
654     foreach my $id (@id) {
655         push @servers, {id => $id};
656     }
657     $template->param(
658         breeding_loop => \@breeding_loop,
659         servers => \@servers,
660         errconn       => \@errconn
661     );
662 }
663
664 1;
665 __END__
666