Bug 31028: (follow-up) Fix notices whitespace
[koha-ffzg.git] / Koha / Report.pm
index a4b540d..937f10e 100644 (file)
@@ -2,26 +2,31 @@ package Koha::Report;
 
 # This file is part of Koha.
 #
-# Koha is free software; you can redistribute it and/or modify it under the
-# terms of the GNU General Public License as published by the Free Software
-# Foundation; either version 3 of the License, or (at your option) any later
-# version.
+# Koha is free software; you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 3 of the License, or
+# (at your option) any later version.
 #
-# Koha is distributed in the hope that it will be useful, but WITHOUT ANY
-# WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
-# A PARTICULAR PURPOSE.  See the GNU General Public License for more details.
+# Koha is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
 #
-# You should have received a copy of the GNU General Public License along
-# with Koha; if not, write to the Free Software Foundation, Inc.,
-# 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+# You should have received a copy of the GNU General Public License
+# along with Koha; if not, see <http://www.gnu.org/licenses>.
 
 use Modern::Perl;
 
-use Carp;
 
 use Koha::Database;
+use Koha::Reports;
+#use Koha::DateUtils qw( dt_from_string output_pref );
 
 use base qw(Koha::Object);
+#
+# FIXME We could only return an error code instead of the arrayref
+# Only 1 error is returned
+# TODO Koha::Report->store should check this before saving
 
 =head1 NAME
 
@@ -31,9 +36,160 @@ Koha::Report - Koha Report Object class
 
 =head2 Class Methods
 
+=head3 is_sql_valid
+
+my ( $is_sql_valid, $errors ) = $report->is_sql_valid;
+
+$errors is a arrayref of hashrefs, keys can be sqlerr or queryerr.
+
+Validate SQL query string so it only contains a select,
+not any of the harmful queries.
+
+=cut
+
+sub is_sql_valid {
+    my ($self) = @_;
+
+    my $sql = $self->savedsql;
+    $sql //= '';
+    my @errors = ();
+
+    if ($sql =~ /;?\W?(UPDATE|DELETE|DROP|INSERT|SHOW|CREATE)\W/i) {
+        push @errors, { sqlerr => $1 };
+    } elsif ($sql !~ /^\s*SELECT\b\s*/i) {
+        push @errors, { queryerr => 'Missing SELECT' };
+    }
+
+    return ( @errors ? 0 : 1, \@errors );
+}
+
+=head3 get_search_info
+
+Return search info
+
+=cut
+
+sub get_search_info {
+    my $self = shift;
+    my $sub_mana_info = { 'query' => shift };
+    return $sub_mana_info;
+}
+
+=head3 get_sharable_info
+
+Return properties that can be shared.
+
+=cut
+
+sub get_sharable_info {
+    my $self             = shift;
+    my $shared_report_id = shift;
+    my $report           = Koha::Reports->find($shared_report_id);
+    my $sub_mana_info    = {
+        'savedsql'     => $report->savedsql,
+        'report_name'  => $report->report_name,
+        'notes'        => $report->notes,
+        'report_group' => $report->report_group,
+        'type'         => $report->type,
+    };
+    return $sub_mana_info;
+}
+
+=head3 new_from_mana
+
+Clear a Mana report to be imported in Koha?
+
 =cut
 
-=head3 type
+sub new_from_mana {
+    my $self = shift;
+    my $data = shift;
+
+    $data->{mana_id} = $data->{id};
+
+    delete $data->{exportemail};
+    delete $data->{kohaversion};
+    delete $data->{creationdate};
+    delete $data->{lastimport};
+    delete $data->{id};
+    delete $data->{nbofusers};
+    delete $data->{language};
+
+    Koha::Report->new($data)->store;
+}
+
+=head3 prep_report
+
+Prep the report and return executable sql with parameters embedded and a list of header types
+for building batch action links in the template
+
+=cut
+
+sub prep_report {
+    my ( $self, $param_names, $sql_params ) = @_;
+    my $sql = $self->savedsql;
+
+    # First we split out the placeholders
+    # This part of the code supports using [[ table.field | alias ]] in the
+    # query and replaces it by table.field AS alias. This is used to build
+    # the batch action links foir cardnumbers, itemnumbers, and biblionumbers in the template
+    # while allowing the library to alter the column names
+    my @split = split /\[\[|\]\]/, $sql;
+    my $headers;
+    for ( my $i = 0 ; $i < $#split / 2 ; $i++ )
+    {    #The placeholders are always the odd elements of the array
+        my ( $type, $name ) = split /\|/,
+          $split[ $i * 2 + 1 ];    # We split them on '|'
+        $headers->{$name} = $type; # Store as a lookup for the template
+        $headers->{$name} =~
+          s/^\w*\.//;    # strip the table name just as in $sth->{NAME} array
+        $split[ $i * 2 + 1 ] =~ s/(\||\?|\.|\*|\(|\)|\%)/\\$1/g
+          ;    #Quote any special characters so we can replace the placeholders
+        $name = C4::Context->dbh->quote($name);
+        $sql =~ s/\[\[$split[$i*2+1]\]\]/$type AS $name/
+          ;    # Remove placeholders from SQL
+    }
+
+    my %lookup;
+    @lookup{@$param_names} = @$sql_params;
+    @split = split /<<|>>/, $sql;
+    for ( my $i = 0 ; $i < $#split / 2 ; $i++ ) {
+        my $quoted =
+          @$param_names ? $lookup{ $split[ $i * 2 + 1 ] } : @$sql_params[$i];
+
+        # if there are special regexp chars, we must \ them
+        $split[ $i * 2 + 1 ] =~ s/(\||\?|\.|\*|\(|\)|\%)/\\$1/g;
+        #if ( $split[ $i * 2 + 1 ] =~ /\|\s*date\s*$/ ) {
+        #    $quoted = output_pref(
+        #        {
+        #            dt         => dt_from_string($quoted),
+        #            dateformat => 'iso',
+        #            dateonly   => 1
+        #        }
+        #    ) if $quoted;
+        #}
+        unless ( $split[ $i * 2 + 1 ] =~ /\|\s*list\s*$/ && $quoted ) {
+            $quoted = C4::Context->dbh->quote($quoted);
+        }
+        else {
+            my @list = split /\n/, $quoted;
+            my @quoted_list;
+            foreach my $item (@list) {
+                $item =~ s/\r//;
+                push @quoted_list, C4::Context->dbh->quote($item);
+            }
+            $quoted = "(" . join( ",", @quoted_list ) . ")";
+        }
+        $sql =~ s/<<$split[$i*2+1]>>/$quoted/;
+    }
+
+    $sql = "$sql /* saved_sql.id: ${\( $self->id )} */";
+    return $sql, $headers;
+}
+
+=head3 _type
+
+Returns name of corresponding DBIC resultset
 
 =cut