1 package SL::ReportGenerator;
13 $self->{myconfig} = shift;
14 $self->{form} = shift;
18 'std_column_visibility' => 0,
19 'output_format' => 'HTML',
20 'allow_pdf_export' => 1,
21 'allow_csv_export' => 1,
24 'orientation' => 'landscape',
28 'margin_bottom' => 1.5,
29 'margin_right' => 1.5,
42 'variable_list' => '',
45 $self->set_options(@_) if (@_);
47 return bless $self, $type;
54 $self->{columns} = \%columns;
56 foreach my $column (values %{ $self->{columns} }) {
57 $column->{visible} = $self->{options}->{std_column_visibility} unless defined $column->{visible};
60 $self->set_column_order(sort keys %{ $self->{columns} });
63 sub set_column_order {
67 my %columns = map { $order++; ($_, $order) } @_;
69 foreach my $column (sort keys %{ $self->{columns} }) {
70 next if $columns{$column};
73 $columns{$column} = $order;
76 $self->{column_order} = [ sort { $columns{$a} <=> $columns{$b} } keys %columns ];
79 sub set_sort_indicator {
82 $self->{options}->{sort_indicator_column} = shift;
83 $self->{options}->{sort_indicator_direction} = shift;
89 while (my $arg = shift) {
90 if ('ARRAY' eq ref $arg) {
91 push @{ $self->{data} }, $arg;
93 } elsif ('HASH' eq ref $arg) {
94 push @{ $self->{data} }, [ $arg ];
97 $self->{form}->error('Incorrect usage -- expecting hash or array ref');
112 map { $self->{options}->{$_} = $options{$_} } keys %options;
115 sub set_options_from_form {
118 my $form = $self->{form};
119 my $myconfig = $self->{myconfig};
121 foreach my $key (qw(output_format)) {
122 my $full_key = "report_generator_${key}";
123 $self->{options}->{$key} = $form->{$full_key} if (defined $form->{$full_key});
126 foreach my $format (qw(pdf csv)) {
127 my $opts = $self->{options}->{"${format}_export"};
128 foreach my $key (keys %{ $opts }) {
129 my $full_key = "report_generator_${format}_options_${key}";
130 $opts->{$key} = $key =~ /^margin/ ? $form->parse_amount($myconfig, $form->{$full_key}) : $form->{$full_key};
135 sub set_export_options {
140 'variable_list' => join(" ", @_),
144 sub generate_content {
146 my $format = lc $self->{options}->{output_format};
148 if (!$self->{columns}) {
149 $self->{form}->error('Incorrect usage -- no columns specified');
152 if ($format eq 'html') {
153 return $self->generate_html_content();
155 } elsif ($format eq 'csv') {
156 return $self->generate_csv_content();
158 } elsif ($format eq 'pdf') {
159 return $self->generate_pdf_content();
162 $self->{form}->error('Incorrect usage -- unknown format (supported are HTML, CSV, PDF)');
166 sub generate_with_headers {
168 my $format = lc $self->{options}->{output_format};
170 if (!$self->{columns}) {
171 $self->{form}->error('Incorrect usage -- no columns specified');
174 my $filename = $self->{options}->{attachment_basename} || 'report';
175 $filename =~ s|.*\\||;
176 $filename =~ s|.*/||;
178 if ($format eq 'html') {
179 $self->{form}->{title} = $self->{title};
180 $self->{form}->header();
181 print $self->generate_html_content();
183 } elsif ($format eq 'csv') {
184 print qq|content-type: text/csv\n|;
185 print qq|content-disposition: attachment; filename=${filename}.csv\n\n|;
186 $self->generate_csv_content();
188 } elsif ($format eq 'pdf') {
189 print qq|content-type: application/pdf\n|;
190 print qq|content-disposition: attachment; filename=${filename}.pdf\n\n|;
191 $self->generate_pdf_content();
194 $self->{form}->error('Incorrect usage -- unknown format (supported are HTML, CSV, PDF)');
198 sub get_visible_columns {
202 return grep { my $c = $self->{columns}->{$_}; $c && $c->{visible} && (($c->{visible} == 1) || ($c->{visible} =~ /${format}/i)) } @{ $self->{column_order} };
209 $value = $self->{form}->quote_html($value);
211 $value =~ s/\n/<br>/g;
216 sub prepare_html_content {
219 my ($column, $name, @column_headers);
221 my $opts = $self->{options};
222 my @visible_columns = $self->get_visible_columns('HTML');
224 foreach $name (@visible_columns) {
225 $column = $self->{columns}->{$name};
229 'link' => $column->{link},
230 'text' => $column->{text},
231 'show_sort_indicator' => $name eq $opts->{sort_indicator_column},
232 'sort_indicator_direction' => $opts->{sort_indicator_direction},
235 push @column_headers, $header;
238 my ($outer_idx, $inner_idx) = (0, 0);
241 foreach my $row_set (@{ $self->{data} }) {
244 foreach my $row (@{ $row_set }) {
247 map { $row->{$_}->{data} = $self->html_format($row->{$_}->{data}) } @visible_columns;
250 'COLUMNS' => [ map { $row->{$_} } @visible_columns ],
251 'outer_idx' => $outer_idx,
252 'outer_idx_odd' => $outer_idx % 2,
253 'inner_idx' => $inner_idx,
256 push @rows, $row_data;
260 my @export_variables;
261 foreach my $key (split m/ +/, $self->{export}->{variable_list}) {
262 push @export_variables, { 'key' => $key, 'value' => $self->{form}->{$key} };
265 my $allow_pdf_export = $opts->{allow_pdf_export} && (-x $main::html2ps_bin) && (-x $main::ghostscript_bin);
268 'TITLE' => $opts->{title},
269 'TOP_INFO_TEXT' => $self->html_format($opts->{top_info_text}),
270 'RAW_TOP_INFO_TEXT' => $opts->{raw_top_info_text},
271 'BOTTOM_INFO_TEXT' => $self->html_format($opts->{bottom_info_text}),
272 'RAW_BOTTOM_INFO_TEXT' => $opts->{raw_bottom_info_text},
273 'ALLOW_PDF_EXPORT' => $allow_pdf_export,
274 'ALLOW_CSV_EXPORT' => $opts->{allow_csv_export},
275 'SHOW_EXPORT_BUTTONS' => $allow_pdf_export || $opts->{allow_csv_export},
276 'COLUMN_HEADERS' => \@column_headers,
277 'NUM_COLUMNS' => scalar @column_headers,
279 'EXPORT_VARIABLES' => \@export_variables,
280 'EXPORT_VARIABLE_LIST' => $self->{export}->{variable_list},
281 'EXPORT_NEXTSUB' => $self->{export}->{nextsub},
287 sub generate_html_content {
289 my $variables = $self->prepare_html_content();
291 return $self->{form}->parse_html_template('report_generator/html_report', $variables);
294 sub verify_paper_size {
296 my $requested_paper_size = lc shift;
297 my $default_paper_size = shift;
299 my %allowed_paper_sizes = map { $_ => 1 } qw(a3 a4 letter legal);
301 return $allowed_paper_sizes{$requested_paper_size} ? $requested_paper_size : $default_paper_size;
304 sub generate_pdf_content {
306 my $variables = $self->prepare_html_content();
307 my $form = $self->{form};
308 my $myconfig = $self->{myconfig};
309 my $opt = $self->{options}->{pdf_export};
311 my $opt_number = $opt->{number} ? 'number : 1' : '';
312 my $opt_landscape = $opt->{orientation} eq 'landscape' ? 'landscape : 1' : '';
314 my $opt_paper_size = $self->verify_paper_size($opt->{paper_size}, 'a4');
316 my $html2ps_config = <<"END"
326 type: ${opt_paper_size};
332 margin-top: $opt->{margin_top}cm;
333 margin-left: $opt->{margin_left}cm;
334 margin-bottom: $opt->{margin_bottom}cm;
335 margin-right: $opt->{margin_right}cm;
339 font-family: Helvetica;
340 font-size: $opt->{font_size}pt;
346 my $cfg_file_name = Common::tmpname() . '-html2ps-config';
347 my $cfg_file = IO::File->new($cfg_file_name, 'w') || $form->error($locale->text('Could not write the html2ps config file.'));
349 $cfg_file->print($html2ps_config);
352 my $html_file_name = Common::tmpname() . '.html';
353 my $html_file = IO::File->new($html_file_name, 'w');
356 unlink $cfg_file_name;
357 $form->error($locale->text('Could not write the temporary HTML file.'));
360 $html_file->print($form->parse_html_template('report_generator/pdf_report', $variables));
363 my $gs = IO::File->new("\"${main::html2ps_bin}\" -f \"${cfg_file_name}\" \"${html_file_name}\" | " .
364 "\"${main::ghostscript_bin}\" -q -dSAFER -dNOPAUSE -dBATCH -sDEVICE=pdfwrite -sPAPERSIZE=${opt_paper_size} -sOutputFile=- -c .setpdfwrite - |");
366 while (my $line = <$gs>) {
370 unlink $cfg_file_name, $html_file_name;
373 unlink $cfg_file_name, $html_file_name;
374 $form->error($locale->text('Could not spawn html2ps or GhostScript.'));
378 sub generate_csv_content {
381 my %valid_sep_chars = (';' => ';', ',' => ',', ':' => ':', 'TAB' => "\t");
382 my %valid_escape_chars = ('"' => 1, "'" => 1);
383 my %valid_quote_chars = ('"' => 1, "'" => 1);
385 my $opts = $self->{options}->{csv_export};
386 my $eol = $opts->{eol_style} eq 'DOS' ? "\r\n" : "\n";
387 my $sep_char = $valid_sep_chars{$opts->{sep_char}} ? $valid_sep_chars{$opts->{sep_char}} : ';';
388 my $escape_char = $valid_escape_chars{$opts->{escape_char}} ? $opts->{escape_char} : '"';
389 my $quote_char = $valid_quote_chars{$opts->{quote_char}} ? $opts->{quote_char} : '"';
391 $escape_char = $quote_char if ($opts->{escape_char} eq 'QUOTE_CHAR');
393 my $csv = Text::CSV_XS->new({ 'binary' => 1,
394 'sep_char' => $sep_char,
395 'escape_char' => $escape_char,
396 'quote_char' => $quote_char,
399 my $stdout = wraphandle(\*STDOUT);
400 my @visible_columns = $self->get_visible_columns('CSV');
402 if ($opts->{headers}) {
403 $csv->print($stdout, [ map { $self->{columns}->{$_}->{text} } @visible_columns ]);
406 foreach my $row_set (@{ $self->{data} }) {
407 foreach my $row (@{ $row_set }) {
408 $csv->print($stdout, [ map { $row->{$_}->{data} } @visible_columns ]);