1 #========= ===========================================================
 
   4 # Based on SQL-Ledger Version 2.1.9
 
   5 # Web http://www.lx-office.org
 
   7 #=====================================================================
 
   8 # SQL-Ledger Accounting
 
   9 # Copyright (C) 1998-2002
 
  11 #  Author: Dieter Simader
 
  12 #   Email: dsimader@sql-ledger.org
 
  13 #     Web: http://www.sql-ledger.org
 
  15 # Contributors: Thomas Bayen <bayen@gmx.de>
 
  16 #               Antti Kaihola <akaihola@siba.fi>
 
  17 #               Moritz Bunkus (tex code)
 
  19 # This program is free software; you can redistribute it and/or modify
 
  20 # it under the terms of the GNU General Public License as published by
 
  21 # the Free Software Foundation; either version 2 of the License, or
 
  22 # (at your option) any later version.
 
  24 # This program is distributed in the hope that it will be useful,
 
  25 # but WITHOUT ANY WARRANTY; without even the implied warranty of
 
  26 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 
  27 # GNU General Public License for more details.
 
  28 # You should have received a copy of the GNU General Public License
 
  29 # along with this program; if not, write to the Free Software
 
  30 # Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
 
  32 #======================================================================
 
  33 # Utilities for parsing forms
 
  34 # and supporting routines for linking account numbers
 
  35 # used in AR, AP and IS, IR modules
 
  37 #======================================================================
 
  63 use SL::DB::PaymentTerm;
 
  66 use SL::Helper::Flash qw();
 
  69 use SL::Layout::Dispatcher;
 
  71 use SL::Locale::String;
 
  74 use SL::MoreCommon qw(uri_encode uri_decode);
 
  76 use SL::PrefixedNumber;
 
  84 use List::Util qw(first max min sum);
 
  85 use List::MoreUtils qw(all any apply);
 
  93   open VERSION_FILE, "VERSION";                 # New but flexible code reads version from VERSION-file
 
  94   my $version =  <VERSION_FILE>;
 
  95   $version    =~ s/[^0-9A-Za-z\.\_\-]//g; # only allow numbers, letters, points, underscores and dashes. Prevents injecting of malicious code.
 
 102   $main::lxdebug->enter_sub();
 
 109   if ($LXDebug::watch_form) {
 
 110     require SL::Watchdog;
 
 111     tie %{ $self }, 'SL::Watchdog';
 
 116   $self->{version} = $self->read_version;
 
 118   $main::lxdebug->leave_sub();
 
 125   SL::Request::read_cgi_input($self);
 
 128 sub _flatten_variables_rec {
 
 129   $main::lxdebug->enter_sub(2);
 
 138   if ('' eq ref $curr->{$key}) {
 
 139     @result = ({ 'key' => $prefix . $key, 'value' => $curr->{$key} });
 
 141   } elsif ('HASH' eq ref $curr->{$key}) {
 
 142     foreach my $hash_key (sort keys %{ $curr->{$key} }) {
 
 143       push @result, $self->_flatten_variables_rec($curr->{$key}, $prefix . $key . '.', $hash_key);
 
 147     foreach my $idx (0 .. scalar @{ $curr->{$key} } - 1) {
 
 148       my $first_array_entry = 1;
 
 150       my $element = $curr->{$key}[$idx];
 
 152       if ('HASH' eq ref $element) {
 
 153         foreach my $hash_key (sort keys %{ $element }) {
 
 154           push @result, $self->_flatten_variables_rec($element, $prefix . $key . ($first_array_entry ? '[+].' : '[].'), $hash_key);
 
 155           $first_array_entry = 0;
 
 158         @result = ({ 'key' => $prefix . $key . ($first_array_entry ? '[+]' : '[]'), 'value' => $element });
 
 163   $main::lxdebug->leave_sub(2);
 
 168 sub flatten_variables {
 
 169   $main::lxdebug->enter_sub(2);
 
 177     push @variables, $self->_flatten_variables_rec($self, '', $_);
 
 180   $main::lxdebug->leave_sub(2);
 
 185 sub flatten_standard_variables {
 
 186   $main::lxdebug->enter_sub(2);
 
 189   my %skip_keys = map { $_ => 1 } (qw(login password header stylesheet titlebar version), @_);
 
 193   foreach (grep { ! $skip_keys{$_} } keys %{ $self }) {
 
 194     push @variables, $self->_flatten_variables_rec($self, '', $_);
 
 197   $main::lxdebug->leave_sub(2);
 
 203   $main::lxdebug->enter_sub();
 
 209   map { print "$_ = $self->{$_}\n" } (sort keys %{$self});
 
 211   $main::lxdebug->leave_sub();
 
 215   $main::lxdebug->enter_sub(2);
 
 218   my $password      = $self->{password};
 
 220   $self->{password} = 'X' x 8;
 
 222   local $Data::Dumper::Sortkeys = 1;
 
 223   my $output                    = Dumper($self);
 
 225   $self->{password} = $password;
 
 227   $main::lxdebug->leave_sub(2);
 
 233   my ($self, $str) = @_;
 
 235   return uri_encode($str);
 
 239   my ($self, $str) = @_;
 
 241   return uri_decode($str);
 
 245   $main::lxdebug->enter_sub();
 
 246   my ($self, $str) = @_;
 
 248   if ($str && !ref($str)) {
 
 249     $str =~ s/\"/"/g;
 
 252   $main::lxdebug->leave_sub();
 
 258   $main::lxdebug->enter_sub();
 
 259   my ($self, $str) = @_;
 
 261   if ($str && !ref($str)) {
 
 262     $str =~ s/"/\"/g;
 
 265   $main::lxdebug->leave_sub();
 
 271   $main::lxdebug->enter_sub();
 
 275     map({ print($::request->{cgi}->hidden("-name" => $_, "-default" => $self->{$_}) . "\n"); } @_);
 
 277     for (sort keys %$self) {
 
 278       next if (($_ eq "header") || (ref($self->{$_}) ne ""));
 
 279       print($::request->{cgi}->hidden("-name" => $_, "-default" => $self->{$_}) . "\n");
 
 282   $main::lxdebug->leave_sub();
 
 286   my ($self, $code) = @_;
 
 287   local $self->{__ERROR_HANDLER} = sub { die SL::X::FormError->new($_[0]) };
 
 292   $main::lxdebug->enter_sub();
 
 294   $main::lxdebug->show_backtrace();
 
 296   my ($self, $msg) = @_;
 
 298   if ($self->{__ERROR_HANDLER}) {
 
 299     $self->{__ERROR_HANDLER}->($msg);
 
 301   } elsif ($ENV{HTTP_USER_AGENT}) {
 
 303     $self->show_generic_error($msg);
 
 306     confess "Error: $msg\n";
 
 309   $main::lxdebug->leave_sub();
 
 313   $main::lxdebug->enter_sub();
 
 315   my ($self, $msg) = @_;
 
 317   if ($ENV{HTTP_USER_AGENT}) {
 
 319     print $self->parse_html_template('generic/form_info', { message => $msg });
 
 321   } elsif ($self->{info_function}) {
 
 322     &{ $self->{info_function} }($msg);
 
 327   $main::lxdebug->leave_sub();
 
 330 # calculates the number of rows in a textarea based on the content and column number
 
 331 # can be capped with maxrows
 
 333   $main::lxdebug->enter_sub();
 
 334   my ($self, $str, $cols, $maxrows, $minrows) = @_;
 
 338   my $rows   = sum map { int((length() - 2) / $cols) + 1 } split /\r/, $str;
 
 341   $main::lxdebug->leave_sub();
 
 343   return max(min($rows, $maxrows), $minrows);
 
 347   my ($self, $msg) = @_;
 
 349   die SL::X::DBError->new(
 
 351     error => $DBI::errstr,
 
 356   $main::lxdebug->enter_sub();
 
 358   my ($self, $name, $msg) = @_;
 
 361   foreach my $part (split m/\./, $name) {
 
 362     if (!$curr->{$part} || ($curr->{$part} =~ /^\s*$/)) {
 
 365     $curr = $curr->{$part};
 
 368   $main::lxdebug->leave_sub();
 
 371 sub _get_request_uri {
 
 374   return URI->new($ENV{HTTP_REFERER})->canonical() if $ENV{HTTP_X_FORWARDED_FOR};
 
 375   return URI->new                                  if !$ENV{REQUEST_URI}; # for testing
 
 377   my $scheme =  $ENV{HTTPS} && (lc $ENV{HTTPS} eq 'on') ? 'https' : 'http';
 
 378   my $port   =  $ENV{SERVER_PORT};
 
 379   $port      =  undef if (($scheme eq 'http' ) && ($port == 80))
 
 380                       || (($scheme eq 'https') && ($port == 443));
 
 382   my $uri    =  URI->new("${scheme}://");
 
 383   $uri->scheme($scheme);
 
 385   $uri->host($ENV{HTTP_HOST} || $ENV{SERVER_ADDR});
 
 386   $uri->path_query($ENV{REQUEST_URI});
 
 392 sub _add_to_request_uri {
 
 395   my $relative_new_path = shift;
 
 396   my $request_uri       = shift || $self->_get_request_uri;
 
 397   my $relative_new_uri  = URI->new($relative_new_path);
 
 398   my @request_segments  = $request_uri->path_segments;
 
 400   my $new_uri           = $request_uri->clone;
 
 401   $new_uri->path_segments(@request_segments[0..scalar(@request_segments) - 2], $relative_new_uri->path_segments);
 
 406 sub create_http_response {
 
 407   $main::lxdebug->enter_sub();
 
 412   my $cgi      = $::request->{cgi};
 
 415   if (defined $main::auth) {
 
 416     my $uri      = $self->_get_request_uri;
 
 417     my @segments = $uri->path_segments;
 
 419     $uri->path_segments(@segments);
 
 421     my $session_cookie_value = $main::auth->get_session_id();
 
 423     if ($session_cookie_value) {
 
 424       $session_cookie = $cgi->cookie('-name'   => $main::auth->get_session_cookie_name(),
 
 425                                      '-value'  => $session_cookie_value,
 
 426                                      '-path'   => $uri->path,
 
 427                                      '-secure' => $ENV{HTTPS});
 
 431   my %cgi_params = ('-type' => $params{content_type});
 
 432   $cgi_params{'-charset'} = $params{charset} if ($params{charset});
 
 433   $cgi_params{'-cookie'}  = $session_cookie  if ($session_cookie);
 
 435   map { $cgi_params{'-' . $_} = $params{$_} if exists $params{$_} } qw(content_disposition content_length);
 
 437   my $output = $cgi->header(%cgi_params);
 
 439   $main::lxdebug->leave_sub();
 
 445   $::lxdebug->enter_sub;
 
 447   my ($self, %params) = @_;
 
 450   $::lxdebug->leave_sub and return if !$ENV{HTTP_USER_AGENT} || $self->{header}++;
 
 452   if ($params{no_layout}) {
 
 453     $::request->{layout} = SL::Layout::Dispatcher->new(style => 'none');
 
 456   my $layout = $::request->{layout};
 
 458   # standard css for all
 
 459   # this should gradually move to the layouts that need it
 
 460   $layout->use_stylesheet("$_.css") for qw(
 
 461     common main menu list_accounts jquery.autocomplete
 
 462     jquery.multiselect2side
 
 463     ui-lightness/jquery-ui
 
 465     tooltipster themes/tooltipster-light
 
 468   $layout->use_javascript("$_.js") for (qw(
 
 469     jquery jquery-ui jquery.cookie jquery.checkall jquery.download
 
 470     jquery/jquery.form jquery/fixes client_js
 
 471     jquery/jquery.tooltipster.min
 
 472     common part_selection
 
 473   ), "jquery/ui/i18n/jquery.ui.datepicker-$::myconfig{countrycode}");
 
 475   $self->{favicon} ||= "favicon.ico";
 
 476   $self->{titlebar} = join ' - ', grep $_, $self->{title}, $self->{login}, $::myconfig{dbname}, $self->{version} if $self->{title} || !$self->{titlebar};
 
 479   if ($self->{refresh_url} || $self->{refresh_time}) {
 
 480     my $refresh_time = $self->{refresh_time} || 3;
 
 481     my $refresh_url  = $self->{refresh_url}  || $ENV{REFERER};
 
 482     push @header, "<meta http-equiv='refresh' content='$refresh_time;$refresh_url'>";
 
 485   my $auto_reload_resources_param = $layout->auto_reload_resources_param;
 
 487   push @header, map { qq|<link rel="stylesheet" href="${_}${auto_reload_resources_param}" type="text/css" title="Stylesheet">| } $layout->stylesheets;
 
 488   push @header, "<style type='text/css'>\@page { size:landscape; }</style> "                     if $self->{landscape};
 
 489   push @header, "<link rel='shortcut icon' href='$self->{favicon}' type='image/x-icon'>"         if -f $self->{favicon};
 
 490   push @header, map { qq|<script type="text/javascript" src="${_}${auto_reload_resources_param}"></script>| }                    $layout->javascripts;
 
 491   push @header, $self->{javascript} if $self->{javascript};
 
 492   push @header, map { $_->show_javascript } @{ $self->{AJAX} || [] };
 
 495     strict       => qq|<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">|,
 
 496     transitional => qq|<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">|,
 
 497     frameset     => qq|<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Frameset//EN" "http://www.w3.org/TR/html4/frameset.dtd">|,
 
 498     html5        => qq|<!DOCTYPE html>|,
 
 502   print $self->create_http_response(content_type => 'text/html', charset => 'UTF-8');
 
 503   print $doctypes{$params{doctype} || 'transitional'}, $/;
 
 507   <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 
 508   <title>$self->{titlebar}</title>
 
 510   print "  $_\n" for @header;
 
 512   <meta name="robots" content="noindex,nofollow">
 
 517   print $::request->{layout}->pre_content;
 
 518   print $::request->{layout}->start_content;
 
 520   $layout->header_done;
 
 522   $::lxdebug->leave_sub;
 
 526   return unless $::request->{layout}->need_footer;
 
 528   print $::request->{layout}->end_content;
 
 529   print $::request->{layout}->post_content;
 
 531   if (my @inline_scripts = $::request->{layout}->javascripts_inline) {
 
 532     print "<script type='text/javascript'>" . join("; ", @inline_scripts) . "</script>\n";
 
 541 sub ajax_response_header {
 
 542   $main::lxdebug->enter_sub();
 
 546   my $output = $::request->{cgi}->header('-charset' => 'UTF-8');
 
 548   $main::lxdebug->leave_sub();
 
 553 sub redirect_header {
 
 557   my $base_uri = $self->_get_request_uri;
 
 558   my $new_uri  = URI->new_abs($new_url, $base_uri);
 
 560   die "Headers already sent" if $self->{header};
 
 563   return $::request->{cgi}->redirect($new_uri);
 
 566 sub set_standard_title {
 
 567   $::lxdebug->enter_sub;
 
 570   $self->{titlebar}  = "kivitendo " . $::locale->text('Version') . " $self->{version}";
 
 571   $self->{titlebar} .= "- $::myconfig{name}"   if $::myconfig{name};
 
 572   $self->{titlebar} .= "- $::myconfig{dbname}" if $::myconfig{name};
 
 574   $::lxdebug->leave_sub;
 
 577 sub _prepare_html_template {
 
 578   $main::lxdebug->enter_sub();
 
 580   my ($self, $file, $additional_params) = @_;
 
 583   if (!%::myconfig || !$::myconfig{"countrycode"}) {
 
 584     $language = $::lx_office_conf{system}->{language};
 
 586     $language = $main::myconfig{"countrycode"};
 
 588   $language = "de" unless ($language);
 
 590   if (-f "templates/webpages/${file}.html") {
 
 591     $file = "templates/webpages/${file}.html";
 
 593   } elsif (ref $file eq 'SCALAR') {
 
 594     # file is a scalarref, use inline mode
 
 596     my $info = "Web page template '${file}' not found.\n";
 
 598     print qq|<pre>$info</pre>|;
 
 599     $::dispatcher->end_request;
 
 602   $additional_params->{AUTH}          = $::auth;
 
 603   $additional_params->{INSTANCE_CONF} = $::instance_conf;
 
 604   $additional_params->{LOCALE}        = $::locale;
 
 605   $additional_params->{LXCONFIG}      = \%::lx_office_conf;
 
 606   $additional_params->{LXDEBUG}       = $::lxdebug;
 
 607   $additional_params->{MYCONFIG}      = \%::myconfig;
 
 609   $main::lxdebug->leave_sub();
 
 614 sub parse_html_template {
 
 615   $main::lxdebug->enter_sub();
 
 617   my ($self, $file, $additional_params) = @_;
 
 619   $additional_params ||= { };
 
 621   my $real_file = $self->_prepare_html_template($file, $additional_params);
 
 622   my $template  = $self->template || $self->init_template;
 
 624   map { $additional_params->{$_} ||= $self->{$_} } keys %{ $self };
 
 627   $template->process($real_file, $additional_params, \$output) || die $template->error;
 
 629   $main::lxdebug->leave_sub();
 
 637   return $self->template if $self->template;
 
 639   # Force scripts/locales.pl to pick up the exception handling template.
 
 640   # parse_html_template('generic/exception')
 
 641   return $self->template(Template->new({
 
 646      'PLUGIN_BASE'  => 'SL::Template::Plugin',
 
 647      'INCLUDE_PATH' => '.:templates/webpages',
 
 648      'COMPILE_EXT'  => '.tcc',
 
 649      'COMPILE_DIR'  => $::lx_office_conf{paths}->{userspath} . '/templates-cache',
 
 650      'ERROR'        => 'templates/webpages/generic/exception.html',
 
 651      'ENCODING'     => 'utf8',
 
 657   $self->{template_object} = shift if @_;
 
 658   return $self->{template_object};
 
 661 sub show_generic_error {
 
 662   $main::lxdebug->enter_sub();
 
 664   my ($self, $error, %params) = @_;
 
 666   if ($self->{__ERROR_HANDLER}) {
 
 667     $self->{__ERROR_HANDLER}->($error);
 
 668     $main::lxdebug->leave_sub();
 
 672   if ($::request->is_ajax) {
 
 675       ->render(SL::Controller::Base->new);
 
 676     $::dispatcher->end_request;
 
 680     'title_error' => $params{title},
 
 681     'label_error' => $error,
 
 684   $self->{title} = $params{title} if $params{title};
 
 687   print $self->parse_html_template("generic/error", $add_params);
 
 689   print STDERR "Error: $error\n";
 
 691   $main::lxdebug->leave_sub();
 
 693   $::dispatcher->end_request;
 
 696 sub show_generic_information {
 
 697   $main::lxdebug->enter_sub();
 
 699   my ($self, $text, $title) = @_;
 
 702     'title_information' => $title,
 
 703     'label_information' => $text,
 
 706   $self->{title} = $title if ($title);
 
 709   print $self->parse_html_template("generic/information", $add_params);
 
 711   $main::lxdebug->leave_sub();
 
 713   $::dispatcher->end_request;
 
 716 sub _store_redirect_info_in_session {
 
 719   return unless $self->{callback} =~ m:^ ( [^\?/]+ \.pl ) \? (.+) :x;
 
 721   my ($controller, $params) = ($1, $2);
 
 722   my $form                  = { map { map { $self->unescape($_) } split /=/, $_, 2 } split m/\&/, $params };
 
 723   $self->{callback}         = "${controller}?RESTORE_FORM_FROM_SESSION_ID=" . $::auth->save_form_in_session(form => $form);
 
 727   $main::lxdebug->enter_sub();
 
 729   my ($self, $msg) = @_;
 
 731   if (!$self->{callback}) {
 
 735     SL::Helper::Flash::flash_later('info', $msg) if $msg;
 
 736     $self->_store_redirect_info_in_session;
 
 737     print $::form->redirect_header($self->{callback});
 
 740   $::dispatcher->end_request;
 
 742   $main::lxdebug->leave_sub();
 
 745 # sort of columns removed - empty sub
 
 747   $main::lxdebug->enter_sub();
 
 749   my ($self, @columns) = @_;
 
 751   $main::lxdebug->leave_sub();
 
 757   $main::lxdebug->enter_sub(2);
 
 759   my ($self, $myconfig, $amount, $places, $dash) = @_;
 
 762   my $neg = $amount < 0;
 
 763   my $force_places = defined $places && $places >= 0;
 
 765   $amount = $self->round_amount($amount, abs $places) if $force_places;
 
 766   $neg    = 0 if $amount == 0; # don't show negative zero
 
 767   $amount = sprintf "%.*f", ($force_places ? $places : 10), abs $amount; # 6 is default for %fa
 
 769   # before the sprintf amount was a number, afterwards it's a string. because of the dynamic nature of perl
 
 770   # this is easy to confuse, so keep in mind: before this comment no s///, m//, concat or other strong ops on
 
 771   # $amount. after this comment no +,-,*,/,abs. it will only introduce subtle bugs.
 
 773   $amount =~ s/0*$// unless defined $places && $places == 0;             # cull trailing 0s
 
 775   my @d = map { s/\d//g; reverse split // } my $tmp = $myconfig->{numberformat}; # get delim chars
 
 776   my @p = split(/\./, $amount);                                          # split amount at decimal point
 
 778   $p[0] =~ s/\B(?=(...)*$)/$d[1]/g if $d[1];                             # add 1,000 delimiters
 
 780   if ($places || $p[1]) {
 
 783             .  (0 x max(abs($places || 0) - length ($p[1]||''), 0));     # pad the fraction
 
 787     ($dash =~ /-/)    ? ($neg ? "($amount)"                            : "$amount" )                              :
 
 788     ($dash =~ /DRCR/) ? ($neg ? "$amount " . $main::locale->text('DR') : "$amount " . $main::locale->text('CR') ) :
 
 789                         ($neg ? "-$amount"                             : "$amount" )                              ;
 
 792   $main::lxdebug->leave_sub(2);
 
 796 sub format_amount_units {
 
 797   $main::lxdebug->enter_sub();
 
 802   my $myconfig         = \%main::myconfig;
 
 803   my $amount           = $params{amount} * 1;
 
 804   my $places           = $params{places};
 
 805   my $part_unit_name   = $params{part_unit};
 
 806   my $amount_unit_name = $params{amount_unit};
 
 807   my $conv_units       = $params{conv_units};
 
 808   my $max_places       = $params{max_places};
 
 810   if (!$part_unit_name) {
 
 811     $main::lxdebug->leave_sub();
 
 815   my $all_units        = AM->retrieve_all_units;
 
 817   if (('' eq ref $conv_units) && ($conv_units =~ /convertible/)) {
 
 818     $conv_units = AM->convertible_units($all_units, $part_unit_name, $conv_units eq 'convertible_not_smaller');
 
 821   if (!scalar @{ $conv_units }) {
 
 822     my $result = $self->format_amount($myconfig, $amount, $places, undef, $max_places) . " " . $part_unit_name;
 
 823     $main::lxdebug->leave_sub();
 
 827   my $part_unit  = $all_units->{$part_unit_name};
 
 828   my $conv_unit  = ($amount_unit_name && ($amount_unit_name ne $part_unit_name)) ? $all_units->{$amount_unit_name} : $part_unit;
 
 830   $amount       *= $conv_unit->{factor};
 
 835   foreach my $unit (@$conv_units) {
 
 836     my $last = $unit->{name} eq $part_unit->{name};
 
 838       $num     = int($amount / $unit->{factor});
 
 839       $amount -= $num * $unit->{factor};
 
 842     if ($last ? $amount : $num) {
 
 843       push @values, { "unit"   => $unit->{name},
 
 844                       "amount" => $last ? $amount / $unit->{factor} : $num,
 
 845                       "places" => $last ? $places : 0 };
 
 852     push @values, { "unit"   => $part_unit_name,
 
 857   my $result = join " ", map { $self->format_amount($myconfig, $_->{amount}, $_->{places}, undef, $max_places), $_->{unit} } @values;
 
 859   $main::lxdebug->leave_sub();
 
 865   $main::lxdebug->enter_sub(2);
 
 870   $input =~ s/(^|[^\#]) \#  (\d+)  /$1$_[$2 - 1]/gx;
 
 871   $input =~ s/(^|[^\#]) \#\{(\d+)\}/$1$_[$2 - 1]/gx;
 
 872   $input =~ s/\#\#/\#/g;
 
 874   $main::lxdebug->leave_sub(2);
 
 882   $main::lxdebug->enter_sub(2);
 
 884   my ($self, $myconfig, $amount) = @_;
 
 886   if (!defined($amount) || ($amount eq '')) {
 
 887     $main::lxdebug->leave_sub(2);
 
 891   if (   ($myconfig->{numberformat} eq '1.000,00')
 
 892       || ($myconfig->{numberformat} eq '1000,00')) {
 
 897   if ($myconfig->{numberformat} eq "1'000.00") {
 
 903   $main::lxdebug->leave_sub(2);
 
 905   # Make sure no code wich is not a math expression ends up in eval().
 
 906   return 0 unless $amount =~ /^ [\s \d \( \) \- \+ \* \/ \. ]* $/x;
 
 908   # Prevent numbers from being parsed as octals;
 
 909   $amount =~ s{ (?<! [\d.] ) 0+ (?= [1-9] ) }{}gx;
 
 911   return scalar(eval($amount)) * 1 ;
 
 915   my ($self, $amount, $places, $adjust) = @_;
 
 917   return 0 if !defined $amount;
 
 922     my $precision = $::instance_conf->get_precision || 0.01;
 
 923     return $self->round_amount( $self->round_amount($amount / $precision, 0) * $precision, $places);
 
 926   # We use Perl's knowledge of string representation for
 
 927   # rounding. First, convert the floating point number to a string
 
 928   # with a high number of places. Then split the string on the decimal
 
 929   # sign and use integer calculation for rounding the decimal places
 
 930   # part. If an overflow occurs then apply that overflow to the part
 
 931   # before the decimal sign as well using integer arithmetic again.
 
 933   my $int_amount = int(abs $amount);
 
 934   my $str_places = max(min(10, 16 - length("$int_amount") - $places), $places);
 
 935   my $amount_str = sprintf '%.*f', $places + $str_places, abs($amount);
 
 937   return $amount unless $amount_str =~ m{^(\d+)\.(\d+)$};
 
 939   my ($pre, $post)      = ($1, $2);
 
 940   my $decimals          = '1' . substr($post, 0, $places);
 
 942   my $propagation_limit = $Config{i32size} == 4 ? 7 : 18;
 
 943   my $add_for_rounding  = substr($post, $places, 1) >= 5 ? 1 : 0;
 
 945   if ($places > $propagation_limit) {
 
 946     $decimals = Math::BigInt->new($decimals)->badd($add_for_rounding);
 
 947     $pre      = Math::BigInt->new($decimals)->badd(1) if substr($decimals, 0, 1) eq '2';
 
 950     $decimals += $add_for_rounding;
 
 951     $pre      += 1 if substr($decimals, 0, 1) eq '2';
 
 954   $amount  = ("${pre}." . substr($decimals, 1)) * ($amount <=> 0);
 
 960   $main::lxdebug->enter_sub();
 
 962   my ($self, $myconfig) = @_;
 
 963   my ($out, $out_mode);
 
 967   my $defaults  = SL::DB::Default->get;
 
 968   my $userspath = $::lx_office_conf{paths}->{userspath};
 
 970   $self->{"cwd"} = getcwd();
 
 971   $self->{"tmpdir"} = $self->{cwd} . "/${userspath}";
 
 976   if ($self->{"format"} =~ /(opendocument|oasis)/i) {
 
 977     $template_type  = 'OpenDocument';
 
 978     $ext_for_format = $self->{"format"} =~ m/pdf/ ? 'pdf' : 'odt';
 
 980   } elsif ($self->{"format"} =~ /(postscript|pdf)/i) {
 
 981     $template_type    = 'LaTeX';
 
 982     $ext_for_format   = 'pdf';
 
 984   } elsif (($self->{"format"} =~ /html/i) || (!$self->{"format"} && ($self->{"IN"} =~ /html$/i))) {
 
 985     $template_type  = 'HTML';
 
 986     $ext_for_format = 'html';
 
 988   } elsif (($self->{"format"} =~ /xml/i) || (!$self->{"format"} && ($self->{"IN"} =~ /xml$/i))) {
 
 989     $template_type  = 'XML';
 
 990     $ext_for_format = 'xml';
 
 992   } elsif ( $self->{"format"} =~ /elster(?:winston|taxbird)/i ) {
 
 993     $template_type = 'XML';
 
 995   } elsif ( $self->{"format"} =~ /excel/i ) {
 
 996     $template_type  = 'Excel';
 
 997     $ext_for_format = 'xls';
 
 999   } elsif ( defined $self->{'format'}) {
 
1000     $self->error("Outputformat not defined. This may be a future feature: $self->{'format'}");
 
1002   } elsif ( $self->{'format'} eq '' ) {
 
1003     $self->error("No Outputformat given: $self->{'format'}");
 
1005   } else { #Catch the rest
 
1006     $self->error("Outputformat not defined: $self->{'format'}");
 
1009   my $template = SL::Template::create(type      => $template_type,
 
1010                                       file_name => $self->{IN},
 
1012                                       myconfig  => $myconfig,
 
1013                                       userspath => $userspath,
 
1014                                       %{ $self->{TEMPLATE_DRIVER_OPTIONS} || {} });
 
1016   # Copy the notes from the invoice/sales order etc. back to the variable "notes" because that is where most templates expect it to be.
 
1017   $self->{"notes"} = $self->{ $self->{"formname"} . "notes" } if exists $self->{ $self->{"formname"} . "notes" };
 
1019   if (!$self->{employee_id}) {
 
1020     $self->{"employee_${_}"} = $myconfig->{$_} for qw(email tel fax name signature);
 
1021     $self->{"employee_${_}"} = $defaults->$_   for qw(address businessnumber co_ustid company duns sepa_creditor_id taxnumber);
 
1024   $self->{"myconfig_${_}"} = $myconfig->{$_} for grep { $_ ne 'dbpasswd' } keys %{ $myconfig };
 
1025   $self->{$_}              = $defaults->$_   for qw(co_ustid);
 
1026   $self->{"myconfig_${_}"} = $defaults->$_   for qw(address businessnumber co_ustid company duns sepa_creditor_id taxnumber);
 
1027   $self->{AUTH}            = $::auth;
 
1028   $self->{INSTANCE_CONF}   = $::instance_conf;
 
1029   $self->{LOCALE}          = $::locale;
 
1030   $self->{LXCONFIG}        = $::lx_office_conf;
 
1031   $self->{LXDEBUG}         = $::lxdebug;
 
1032   $self->{MYCONFIG}        = \%::myconfig;
 
1034   $self->{copies} = 1 if (($self->{copies} *= 1) <= 0);
 
1036   # OUT is used for the media, screen, printer, email
 
1037   # for postscript we store a copy in a temporary file
 
1038   my ($temp_fh, $suffix);
 
1039   $suffix =  $self->{IN};
 
1040   $suffix =~ s/.*\.//;
 
1041   ($temp_fh, $self->{tmpfile}) = File::Temp::tempfile(
 
1042     'kivitendo-printXXXXXX',
 
1043     SUFFIX => '.' . ($suffix || 'tex'),
 
1045     UNLINK => ($::lx_office_conf{debug} && $::lx_office_conf{debug}->{keep_temp_files})? 0 : 1,
 
1048   (undef, undef, $self->{template_meta}{tmpfile}) = File::Spec->splitpath( $self->{tmpfile} );
 
1050   $out              = $self->{OUT};
 
1051   $out_mode         = $self->{OUT_MODE} || '>';
 
1052   $self->{OUT}      = "$self->{tmpfile}";
 
1053   $self->{OUT_MODE} = '>';
 
1056   my $command_formatter = sub {
 
1057     my ($out_mode, $out) = @_;
 
1058     return $out_mode eq '|-' ? SL::Template::create(type => 'ShellCommand', form => $self)->parse($out) : $out;
 
1062     $self->{OUT} = $command_formatter->($self->{OUT_MODE}, $self->{OUT});
 
1063     open(OUT, $self->{OUT_MODE}, $self->{OUT}) or $self->error("error on opening $self->{OUT} with mode $self->{OUT_MODE} : $!");
 
1065     *OUT = ($::dispatcher->get_standard_filehandles)[1];
 
1069   if (!$template->parse(*OUT)) {
 
1071     $self->error("$self->{IN} : " . $template->get_error());
 
1074   close OUT if $self->{OUT};
 
1075   # check only one flag (webdav_documents)
 
1076   # therefore copy to webdav, even if we do not have the webdav feature enabled (just archive)
 
1077   my $copy_to_webdav =  $::instance_conf->get_webdav_documents && !$self->{preview} && $self->{tmpdir} && $self->{tmpfile} && $self->{type};
 
1079   if ($self->{media} eq 'file') {
 
1080     copy(join('/', $self->{cwd}, $userspath, $self->{tmpfile}), $out =~ m|^/| ? $out : join('/', $self->{cwd}, $out)) if $template->uses_temp_file;
 
1081     Common::copy_file_to_webdav_folder($self)                                                                         if $copy_to_webdav;
 
1083     chdir("$self->{cwd}");
 
1085     $::lxdebug->leave_sub();
 
1090   Common::copy_file_to_webdav_folder($self) if $copy_to_webdav;
 
1092   if ($self->{media} eq 'email') {
 
1094     my $mail = Mailer->new;
 
1096     map { $mail->{$_} = $self->{$_} }
 
1097       qw(cc bcc subject message version format);
 
1098     $mail->{to} = $self->{EMAIL_RECIPIENT} ? $self->{EMAIL_RECIPIENT} : $self->{email};
 
1099     $mail->{from}   = qq|"$myconfig->{name}" <$myconfig->{email}>|;
 
1100     $mail->{fileid} = time() . '.' . $$ . '.';
 
1101     my $full_signature     =  $self->create_email_signature();
 
1102     $full_signature        =~ s/\r//g;
 
1104     # if we send html or plain text inline
 
1105     if (($self->{format} eq 'html') && ($self->{sendmode} eq 'inline')) {
 
1106       $mail->{contenttype}    =  "text/html";
 
1107       $mail->{message}        =~ s/\r//g;
 
1108       $mail->{message}        =~ s/\n/<br>\n/g;
 
1109       $full_signature         =~ s/\n/<br>\n/g;
 
1110       $mail->{message}       .=  $full_signature;
 
1112       open(IN, "<:encoding(UTF-8)", $self->{tmpfile})
 
1113         or $self->error($self->cleanup . "$self->{tmpfile} : $!");
 
1114       $mail->{message} .= $_ while <IN>;
 
1119       if (!$self->{"do_not_attach"}) {
 
1120         my $attachment_name  =  $self->{attachment_filename} || $self->{tmpfile};
 
1121         $attachment_name     =~ s/\.(.+?)$/.${ext_for_format}/ if ($ext_for_format);
 
1122         $mail->{attachments} =  [{ "filename" => $self->{tmpfile},
 
1123                                    "name"     => $attachment_name }];
 
1126       $mail->{message} .= $full_signature;
 
1129     my $err = $mail->send();
 
1130     $self->error($self->cleanup . "$err") if ($err);
 
1134     $self->{OUT}      = $out;
 
1135     $self->{OUT_MODE} = $out_mode;
 
1137     my $numbytes = (-s $self->{tmpfile});
 
1138     open(IN, "<", $self->{tmpfile})
 
1139       or $self->error($self->cleanup . "$self->{tmpfile} : $!");
 
1142     $self->{copies} = 1 unless $self->{media} eq 'printer';
 
1144     chdir("$self->{cwd}");
 
1145     #print(STDERR "Kopien $self->{copies}\n");
 
1146     #print(STDERR "OUT $self->{OUT}\n");
 
1147     for my $i (1 .. $self->{copies}) {
 
1149         $self->{OUT} = $command_formatter->($self->{OUT_MODE}, $self->{OUT});
 
1151         open  OUT, $self->{OUT_MODE}, $self->{OUT} or $self->error($self->cleanup . "$self->{OUT} : $!");
 
1152         print OUT $_ while <IN>;
 
1157         my %headers = ('-type'       => $template->get_mime_type,
 
1158                        '-connection' => 'close',
 
1159                        '-charset'    => 'UTF-8');
 
1161         $self->{attachment_filename} ||= $self->generate_attachment_filename;
 
1163         if ($self->{attachment_filename}) {
 
1166             '-attachment'     => $self->{attachment_filename},
 
1167             '-content-length' => $numbytes,
 
1172         print $::request->cgi->header(%headers);
 
1174         $::locale->with_raw_io(\*STDOUT, sub { print while <IN> });
 
1183   chdir("$self->{cwd}");
 
1184   $main::lxdebug->leave_sub();
 
1187 sub get_formname_translation {
 
1188   $main::lxdebug->enter_sub();
 
1189   my ($self, $formname) = @_;
 
1191   $formname ||= $self->{formname};
 
1193   $self->{recipient_locale} ||=  Locale->lang_to_locale($self->{language});
 
1194   local $::locale = Locale->new($self->{recipient_locale});
 
1196   my %formname_translations = (
 
1197     bin_list                => $main::locale->text('Bin List'),
 
1198     credit_note             => $main::locale->text('Credit Note'),
 
1199     invoice                 => $main::locale->text('Invoice'),
 
1200     pick_list               => $main::locale->text('Pick List'),
 
1201     proforma                => $main::locale->text('Proforma Invoice'),
 
1202     purchase_order          => $main::locale->text('Purchase Order'),
 
1203     request_quotation       => $main::locale->text('RFQ'),
 
1204     sales_order             => $main::locale->text('Confirmation'),
 
1205     sales_quotation         => $main::locale->text('Quotation'),
 
1206     storno_invoice          => $main::locale->text('Storno Invoice'),
 
1207     sales_delivery_order    => $main::locale->text('Delivery Order'),
 
1208     purchase_delivery_order => $main::locale->text('Delivery Order'),
 
1209     dunning                 => $main::locale->text('Dunning'),
 
1210     letter                  => $main::locale->text('Letter'),
 
1211     ic_supply               => $main::locale->text('Intra-Community supply'),
 
1214   $main::lxdebug->leave_sub();
 
1215   return $formname_translations{$formname};
 
1218 sub get_number_prefix_for_type {
 
1219   $main::lxdebug->enter_sub();
 
1223       (first { $self->{type} eq $_ } qw(invoice credit_note)) ? 'inv'
 
1224     : ($self->{type} =~ /_quotation$/)                        ? 'quo'
 
1225     : ($self->{type} =~ /_delivery_order$/)                   ? 'do'
 
1226     : ($self->{type} =~ /letter/)                             ? 'letter'
 
1229   # better default like this?
 
1230   # : ($self->{type} =~ /(sales|purcharse)_order/           :  'ord';
 
1231   # :                                                           'prefix_undefined';
 
1233   $main::lxdebug->leave_sub();
 
1237 sub get_extension_for_format {
 
1238   $main::lxdebug->enter_sub();
 
1241   my $extension = $self->{format} =~ /pdf/i          ? ".pdf"
 
1242                 : $self->{format} =~ /postscript/i   ? ".ps"
 
1243                 : $self->{format} =~ /opendocument/i ? ".odt"
 
1244                 : $self->{format} =~ /excel/i        ? ".xls"
 
1245                 : $self->{format} =~ /html/i         ? ".html"
 
1248   $main::lxdebug->leave_sub();
 
1252 sub generate_attachment_filename {
 
1253   $main::lxdebug->enter_sub();
 
1256   $self->{recipient_locale} ||=  Locale->lang_to_locale($self->{language});
 
1257   my $recipient_locale = Locale->new($self->{recipient_locale});
 
1259   my $attachment_filename = $main::locale->unquote_special_chars('HTML', $self->get_formname_translation());
 
1260   my $prefix              = $self->get_number_prefix_for_type();
 
1262   if ($self->{preview} && (first { $self->{type} eq $_ } qw(invoice credit_note))) {
 
1263     $attachment_filename .= ' (' . $recipient_locale->text('Preview') . ')' . $self->get_extension_for_format();
 
1265   } elsif ($attachment_filename && $self->{"${prefix}number"}) {
 
1266     $attachment_filename .=  "_" . $self->{"${prefix}number"} . $self->get_extension_for_format();
 
1268   } elsif ($attachment_filename) {
 
1269     $attachment_filename .=  $self->get_extension_for_format();
 
1272     $attachment_filename = "";
 
1275   $attachment_filename =  $main::locale->quote_special_chars('filenames', $attachment_filename);
 
1276   $attachment_filename =~ s|[\s/\\]+|_|g;
 
1278   $main::lxdebug->leave_sub();
 
1279   return $attachment_filename;
 
1282 sub generate_email_subject {
 
1283   $main::lxdebug->enter_sub();
 
1286   my $subject = $main::locale->unquote_special_chars('HTML', $self->get_formname_translation());
 
1287   my $prefix  = $self->get_number_prefix_for_type();
 
1289   if ($subject && $self->{"${prefix}number"}) {
 
1290     $subject .= " " . $self->{"${prefix}number"}
 
1293   $main::lxdebug->leave_sub();
 
1298   $main::lxdebug->enter_sub();
 
1300   my ($self, $application) = @_;
 
1302   my $error_code = $?;
 
1304   chdir("$self->{tmpdir}");
 
1307   if ((-1 == $error_code) || (127 == (($error_code) >> 8))) {
 
1308     push @err, $::locale->text('The application "#1" was not found on the system.', $application || 'pdflatex') . ' ' . $::locale->text('Please contact your administrator.');
 
1310   } elsif (-f "$self->{tmpfile}.err") {
 
1311     open(FH, "<:encoding(UTF-8)", "$self->{tmpfile}.err");
 
1316   if ($self->{tmpfile} && !($::lx_office_conf{debug} && $::lx_office_conf{debug}->{keep_temp_files})) {
 
1317     $self->{tmpfile} =~ s|.*/||g;
 
1319     $self->{tmpfile} =~ s/\.\w+$//g;
 
1320     my $tmpfile = $self->{tmpfile};
 
1321     unlink(<$tmpfile.*>);
 
1324   chdir("$self->{cwd}");
 
1326   $main::lxdebug->leave_sub();
 
1332   $main::lxdebug->enter_sub();
 
1334   my ($self, $date, $myconfig) = @_;
 
1337   if ($date && $date =~ /\D/) {
 
1339     if ($myconfig->{dateformat} =~ /^yy/) {
 
1340       ($yy, $mm, $dd) = split /\D/, $date;
 
1342     if ($myconfig->{dateformat} =~ /^mm/) {
 
1343       ($mm, $dd, $yy) = split /\D/, $date;
 
1345     if ($myconfig->{dateformat} =~ /^dd/) {
 
1346       ($dd, $mm, $yy) = split /\D/, $date;
 
1351     $yy = ($yy < 70) ? $yy + 2000 : $yy;
 
1352     $yy = ($yy >= 70 && $yy <= 99) ? $yy + 1900 : $yy;
 
1354     $dd = "0$dd" if ($dd < 10);
 
1355     $mm = "0$mm" if ($mm < 10);
 
1357     $date = "$yy$mm$dd";
 
1360   $main::lxdebug->leave_sub();
 
1365 # Database routines used throughout
 
1366 # DB Handling got moved to SL::DB, these are only shims for compatibility
 
1369   SL::DB->client->dbh;
 
1372 sub get_standard_dbh {
 
1373   my $dbh = SL::DB->client->dbh;
 
1375   if ($dbh && !$dbh->{Active}) {
 
1376     $main::lxdebug->message(LXDebug->INFO(), "get_standard_dbh: \$dbh is defined but not Active anymore");
 
1377     SL::DB->client->dbh(undef);
 
1380   SL::DB->client->dbh;
 
1383 sub disconnect_standard_dbh {
 
1384   SL::DB->client->dbh->rollback;
 
1390   $main::lxdebug->enter_sub();
 
1392   my ($self, $date, $myconfig) = @_;
 
1393   my $dbh = $self->get_standard_dbh;
 
1395   my $query = "SELECT 1 FROM defaults WHERE ? < closedto";
 
1396   my $sth = prepare_execute_query($self, $dbh, $query, conv_date($date));
 
1398   # Falls $date = '' - Fehlermeldung aus der Datenbank. Ich denke,
 
1399   # es ist sicher ein conv_date vorher IMMER auszuführen.
 
1400   # Testfälle ohne definiertes closedto:
 
1401   #   Leere Datumseingabe i.O.
 
1402   #     SELECT 1 FROM defaults WHERE '' < closedto
 
1403   #   normale Zahlungsbuchung über Rechnungsmaske i.O.
 
1404   #     SELECT 1 FROM defaults WHERE '10.05.2011' < closedto
 
1405   # Testfälle mit definiertem closedto (30.04.2011):
 
1406   #  Leere Datumseingabe i.O.
 
1407   #   SELECT 1 FROM defaults WHERE '' < closedto
 
1408   # normale Buchung im geschloßenem Zeitraum i.O.
 
1409   #   SELECT 1 FROM defaults WHERE '21.04.2011' < closedto
 
1410   #     Fehlermeldung: Es können keine Zahlungen für abgeschlossene Bücher gebucht werden!
 
1411   # normale Buchung in aktiver Buchungsperiode i.O.
 
1412   #   SELECT 1 FROM defaults WHERE '01.05.2011' < closedto
 
1414   my ($closed) = $sth->fetchrow_array;
 
1416   $main::lxdebug->leave_sub();
 
1421 # prevents bookings to the to far away future
 
1422 sub date_max_future {
 
1423   $main::lxdebug->enter_sub();
 
1425   my ($self, $date, $myconfig) = @_;
 
1426   my $dbh = $self->get_standard_dbh;
 
1428   my $query = "SELECT 1 FROM defaults WHERE ? - current_date > max_future_booking_interval";
 
1429   my $sth = prepare_execute_query($self, $dbh, $query, conv_date($date));
 
1431   my ($max_future_booking_interval) = $sth->fetchrow_array;
 
1433   $main::lxdebug->leave_sub();
 
1435   return $max_future_booking_interval;
 
1439 sub update_balance {
 
1440   $main::lxdebug->enter_sub();
 
1442   my ($self, $dbh, $table, $field, $where, $value, @values) = @_;
 
1444   # if we have a value, go do it
 
1447     # retrieve balance from table
 
1448     my $query = "SELECT $field FROM $table WHERE $where FOR UPDATE";
 
1449     my $sth = prepare_execute_query($self, $dbh, $query, @values);
 
1450     my ($balance) = $sth->fetchrow_array;
 
1456     $query = "UPDATE $table SET $field = $balance WHERE $where";
 
1457     do_query($self, $dbh, $query, @values);
 
1459   $main::lxdebug->leave_sub();
 
1462 sub update_exchangerate {
 
1463   $main::lxdebug->enter_sub();
 
1465   my ($self, $dbh, $curr, $transdate, $buy, $sell) = @_;
 
1467   # some sanity check for currency
 
1469     $main::lxdebug->leave_sub();
 
1472   $query = qq|SELECT name AS curr FROM currencies WHERE id=(SELECT currency_id FROM defaults)|;
 
1474   my ($defaultcurrency) = selectrow_query($self, $dbh, $query);
 
1476   if ($curr eq $defaultcurrency) {
 
1477     $main::lxdebug->leave_sub();
 
1481   $query = qq|SELECT e.currency_id FROM exchangerate e
 
1482                  WHERE e.currency_id = (SELECT cu.id FROM currencies cu WHERE cu.name=?) AND e.transdate = ?
 
1484   my $sth = prepare_execute_query($self, $dbh, $query, $curr, $transdate);
 
1493   $buy = conv_i($buy, "NULL");
 
1494   $sell = conv_i($sell, "NULL");
 
1497   if ($buy != 0 && $sell != 0) {
 
1498     $set = "buy = $buy, sell = $sell";
 
1499   } elsif ($buy != 0) {
 
1500     $set = "buy = $buy";
 
1501   } elsif ($sell != 0) {
 
1502     $set = "sell = $sell";
 
1505   if ($sth->fetchrow_array) {
 
1506     $query = qq|UPDATE exchangerate
 
1508                 WHERE currency_id = (SELECT id FROM currencies WHERE name = ?)
 
1512     $query = qq|INSERT INTO exchangerate (currency_id, buy, sell, transdate)
 
1513                 VALUES ((SELECT id FROM currencies WHERE name = ?), $buy, $sell, ?)|;
 
1516   do_query($self, $dbh, $query, $curr, $transdate);
 
1518   $main::lxdebug->leave_sub();
 
1521 sub save_exchangerate {
 
1522   $main::lxdebug->enter_sub();
 
1524   my ($self, $myconfig, $currency, $transdate, $rate, $fld) = @_;
 
1526   SL::DB->client->with_transaction(sub {
 
1527     my $dbh = SL::DB->client->dbh;
 
1531     $buy  = $rate if $fld eq 'buy';
 
1532     $sell = $rate if $fld eq 'sell';
 
1535     $self->update_exchangerate($dbh, $currency, $transdate, $buy, $sell);
 
1537   }) or do { die SL::DB->client->error };
 
1539   $main::lxdebug->leave_sub();
 
1542 sub get_exchangerate {
 
1543   $main::lxdebug->enter_sub();
 
1545   my ($self, $dbh, $curr, $transdate, $fld) = @_;
 
1548   unless ($transdate && $curr) {
 
1549     $main::lxdebug->leave_sub();
 
1553   $query = qq|SELECT name AS curr FROM currencies WHERE id = (SELECT currency_id FROM defaults)|;
 
1555   my ($defaultcurrency) = selectrow_query($self, $dbh, $query);
 
1557   if ($curr eq $defaultcurrency) {
 
1558     $main::lxdebug->leave_sub();
 
1562   $query = qq|SELECT e.$fld FROM exchangerate e
 
1563                  WHERE e.currency_id = (SELECT id FROM currencies WHERE name = ?) AND e.transdate = ?|;
 
1564   my ($exchangerate) = selectrow_query($self, $dbh, $query, $curr, $transdate);
 
1568   $main::lxdebug->leave_sub();
 
1570   return $exchangerate;
 
1573 sub check_exchangerate {
 
1574   $main::lxdebug->enter_sub();
 
1576   my ($self, $myconfig, $currency, $transdate, $fld) = @_;
 
1578   if ($fld !~/^buy|sell$/) {
 
1579     $self->error('Fatal: check_exchangerate called with invalid buy/sell argument');
 
1582   unless ($transdate) {
 
1583     $main::lxdebug->leave_sub();
 
1587   my ($defaultcurrency) = $self->get_default_currency($myconfig);
 
1589   if ($currency eq $defaultcurrency) {
 
1590     $main::lxdebug->leave_sub();
 
1594   my $dbh   = $self->get_standard_dbh($myconfig);
 
1595   my $query = qq|SELECT e.$fld FROM exchangerate e
 
1596                  WHERE e.currency_id = (SELECT id FROM currencies WHERE name = ?) AND e.transdate = ?|;
 
1598   my ($exchangerate) = selectrow_query($self, $dbh, $query, $currency, $transdate);
 
1600   $main::lxdebug->leave_sub();
 
1602   return $exchangerate;
 
1605 sub get_all_currencies {
 
1606   $main::lxdebug->enter_sub();
 
1609   my $myconfig = shift || \%::myconfig;
 
1610   my $dbh      = $self->get_standard_dbh($myconfig);
 
1612   my $query = qq|SELECT name FROM currencies|;
 
1613   my @currencies = map { $_->{name} } selectall_hashref_query($self, $dbh, $query);
 
1615   $main::lxdebug->leave_sub();
 
1620 sub get_default_currency {
 
1621   $main::lxdebug->enter_sub();
 
1623   my ($self, $myconfig) = @_;
 
1624   my $dbh      = $self->get_standard_dbh($myconfig);
 
1625   my $query = qq|SELECT name AS curr FROM currencies WHERE id = (SELECT currency_id FROM defaults)|;
 
1627   my ($defaultcurrency) = selectrow_query($self, $dbh, $query);
 
1629   $main::lxdebug->leave_sub();
 
1631   return $defaultcurrency;
 
1634 sub set_payment_options {
 
1635   my ($self, $myconfig, $transdate, $type) = @_;
 
1637   my $terms = $self->{payment_id} ? SL::DB::PaymentTerm->new(id => $self->{payment_id})->load : undef;
 
1640   my $is_invoice                = $type =~ m{invoice}i;
 
1642   $transdate                  ||= $self->{invdate} || $self->{transdate};
 
1643   my $due_date                  = $self->{duedate} || $self->{reqdate};
 
1645   $self->{$_}                   = $terms->$_ for qw(terms_netto terms_skonto percent_skonto);
 
1646   $self->{payment_description}  = $terms->description;
 
1647   $self->{netto_date}           = $terms->calc_date(reference_date => $transdate, due_date => $due_date, terms => 'net')->to_kivitendo;
 
1648   $self->{skonto_date}          = $terms->calc_date(reference_date => $transdate, due_date => $due_date, terms => 'discount')->to_kivitendo;
 
1650   my ($invtotal, $total);
 
1651   my (%amounts, %formatted_amounts);
 
1653   if ($self->{type} =~ /_order$/) {
 
1654     $amounts{invtotal} = $self->{ordtotal};
 
1655     $amounts{total}    = $self->{ordtotal};
 
1657   } elsif ($self->{type} =~ /_quotation$/) {
 
1658     $amounts{invtotal} = $self->{quototal};
 
1659     $amounts{total}    = $self->{quototal};
 
1662     $amounts{invtotal} = $self->{invtotal};
 
1663     $amounts{total}    = $self->{total};
 
1665   map { $amounts{$_} = $self->parse_amount($myconfig, $amounts{$_}) } keys %amounts;
 
1667   $amounts{skonto_in_percent}  = 100.0 * $self->{percent_skonto};
 
1668   $amounts{skonto_amount}      = $amounts{invtotal} * $self->{percent_skonto};
 
1669   $amounts{invtotal_wo_skonto} = $amounts{invtotal} * (1 - $self->{percent_skonto});
 
1670   $amounts{total_wo_skonto}    = $amounts{total}    * (1 - $self->{percent_skonto});
 
1672   foreach (keys %amounts) {
 
1673     $amounts{$_}           = $self->round_amount($amounts{$_}, 2);
 
1674     $formatted_amounts{$_} = $self->format_amount($myconfig, $amounts{$_}, 2);
 
1677   if ($self->{"language_id"}) {
 
1678     my $language             = SL::DB::Language->new(id => $self->{language_id})->load;
 
1680     $self->{payment_terms}   = $type =~ m{invoice}i ? $terms->translated_attribute('description_long_invoice', $language->id) : undef;
 
1681     $self->{payment_terms} ||= $terms->translated_attribute('description_long', $language->id);
 
1683     if ($language->output_dateformat) {
 
1684       foreach my $key (qw(netto_date skonto_date)) {
 
1685         $self->{$key} = $::locale->reformat_date($myconfig, $self->{$key}, $language->output_dateformat, $language->output_longdates);
 
1689     if ($language->output_numberformat && ($language->output_numberformat ne $myconfig->{numberformat})) {
 
1690       local $myconfig->{numberformat};
 
1691       $myconfig->{"numberformat"} = $language->output_numberformat;
 
1692       $formatted_amounts{$_} = $self->format_amount($myconfig, $amounts{$_}) for keys %amounts;
 
1696   $self->{payment_terms} =  $self->{payment_terms} || ($is_invoice ? $terms->description_long_invoice : undef) || $terms->description_long;
 
1698   $self->{payment_terms} =~ s/<%netto_date%>/$self->{netto_date}/g;
 
1699   $self->{payment_terms} =~ s/<%skonto_date%>/$self->{skonto_date}/g;
 
1700   $self->{payment_terms} =~ s/<%currency%>/$self->{currency}/g;
 
1701   $self->{payment_terms} =~ s/<%terms_netto%>/$self->{terms_netto}/g;
 
1702   $self->{payment_terms} =~ s/<%account_number%>/$self->{account_number}/g;
 
1703   $self->{payment_terms} =~ s/<%bank%>/$self->{bank}/g;
 
1704   $self->{payment_terms} =~ s/<%bank_code%>/$self->{bank_code}/g;
 
1705   $self->{payment_terms} =~ s/<\%bic\%>/$self->{bic}/g;
 
1706   $self->{payment_terms} =~ s/<\%iban\%>/$self->{iban}/g;
 
1707   $self->{payment_terms} =~ s/<\%mandate_date_of_signature\%>/$self->{mandate_date_of_signature}/g;
 
1708   $self->{payment_terms} =~ s/<\%mandator_id\%>/$self->{mandator_id}/g;
 
1710   map { $self->{payment_terms} =~ s/<%${_}%>/$formatted_amounts{$_}/g; } keys %formatted_amounts;
 
1712   $self->{skonto_in_percent} = $formatted_amounts{skonto_in_percent};
 
1716 sub get_template_language {
 
1717   $main::lxdebug->enter_sub();
 
1719   my ($self, $myconfig) = @_;
 
1721   my $template_code = "";
 
1723   if ($self->{language_id}) {
 
1724     my $dbh = $self->get_standard_dbh($myconfig);
 
1725     my $query = qq|SELECT template_code FROM language WHERE id = ?|;
 
1726     ($template_code) = selectrow_query($self, $dbh, $query, $self->{language_id});
 
1729   $main::lxdebug->leave_sub();
 
1731   return $template_code;
 
1734 sub get_printer_code {
 
1735   $main::lxdebug->enter_sub();
 
1737   my ($self, $myconfig) = @_;
 
1739   my $template_code = "";
 
1741   if ($self->{printer_id}) {
 
1742     my $dbh = $self->get_standard_dbh($myconfig);
 
1743     my $query = qq|SELECT template_code, printer_command FROM printers WHERE id = ?|;
 
1744     ($template_code, $self->{printer_command}) = selectrow_query($self, $dbh, $query, $self->{printer_id});
 
1747   $main::lxdebug->leave_sub();
 
1749   return $template_code;
 
1753   $main::lxdebug->enter_sub();
 
1755   my ($self, $myconfig) = @_;
 
1757   my $template_code = "";
 
1759   if ($self->{shipto_id}) {
 
1760     my $dbh = $self->get_standard_dbh($myconfig);
 
1761     my $query = qq|SELECT * FROM shipto WHERE shipto_id = ?|;
 
1762     my $ref = selectfirst_hashref_query($self, $dbh, $query, $self->{shipto_id});
 
1763     map({ $self->{$_} = $ref->{$_} } keys(%$ref));
 
1765     my $cvars = CVar->get_custom_variables(
 
1768       trans_id => $self->{shipto_id},
 
1770     $self->{"shiptocvar_$_->{name}"} = $_->{value} for @{ $cvars };
 
1773   $main::lxdebug->leave_sub();
 
1777   my ($self, $dbh, $id, $module) = @_;
 
1782   foreach my $item (qw(name department_1 department_2 street zipcode city country gln
 
1783                        contact cp_gender phone fax email)) {
 
1784     if ($self->{"shipto$item"}) {
 
1785       $shipto = 1 if ($self->{$item} ne $self->{"shipto$item"});
 
1787     push(@values, $self->{"shipto${item}"});
 
1792   my $shipto_id = $self->{shipto_id};
 
1794   if ($self->{shipto_id}) {
 
1795     my $query = qq|UPDATE shipto set
 
1797                      shiptodepartment_1 = ?,
 
1798                      shiptodepartment_2 = ?,
 
1805                      shiptocp_gender = ?,
 
1809                    WHERE shipto_id = ?|;
 
1810     do_query($self, $dbh, $query, @values, $self->{shipto_id});
 
1812     my $query = qq|SELECT * FROM shipto
 
1813                    WHERE shiptoname = ? AND
 
1814                      shiptodepartment_1 = ? AND
 
1815                      shiptodepartment_2 = ? AND
 
1816                      shiptostreet = ? AND
 
1817                      shiptozipcode = ? AND
 
1819                      shiptocountry = ? AND
 
1821                      shiptocontact = ? AND
 
1822                      shiptocp_gender = ? AND
 
1828     my $insert_check = selectfirst_hashref_query($self, $dbh, $query, @values, $module, $id);
 
1831         qq|INSERT INTO shipto (trans_id, shiptoname, shiptodepartment_1, shiptodepartment_2,
 
1832                                shiptostreet, shiptozipcode, shiptocity, shiptocountry, shiptogln,
 
1833                                shiptocontact, shiptocp_gender, shiptophone, shiptofax, shiptoemail, module)
 
1834            VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)|;
 
1835       do_query($self, $dbh, $insert_query, $id, @values, $module);
 
1837       $insert_check = selectfirst_hashref_query($self, $dbh, $query, @values, $module, $id);
 
1840     $shipto_id = $insert_check->{shipto_id};
 
1843   return unless $shipto_id;
 
1845   CVar->save_custom_variables(
 
1848     trans_id    => $shipto_id,
 
1850     name_prefix => 'shipto',
 
1855   $main::lxdebug->enter_sub();
 
1857   my ($self, $dbh) = @_;
 
1859   $dbh ||= $self->get_standard_dbh(\%main::myconfig);
 
1861   my $query = qq|SELECT id, name FROM employee WHERE login = ?|;
 
1862   ($self->{"employee_id"}, $self->{"employee"}) = selectrow_query($self, $dbh, $query, $self->{login});
 
1863   $self->{"employee_id"} *= 1;
 
1865   $main::lxdebug->leave_sub();
 
1868 sub get_employee_data {
 
1869   $main::lxdebug->enter_sub();
 
1873   my $defaults = SL::DB::Default->get;
 
1875   Common::check_params(\%params, qw(prefix));
 
1876   Common::check_params_x(\%params, qw(id));
 
1879     $main::lxdebug->leave_sub();
 
1883   my $myconfig = \%main::myconfig;
 
1884   my $dbh      = $params{dbh} || $self->get_standard_dbh($myconfig);
 
1886   my ($login, $deleted)  = selectrow_query($self, $dbh, qq|SELECT login,deleted FROM employee WHERE id = ?|, conv_i($params{id}));
 
1889     # login already fetched and still the same client (mandant) | same for both cases (delete|!delete)
 
1890     $self->{$params{prefix} . '_login'}   = $login;
 
1891     $self->{$params{prefix} . "_${_}"}    = $defaults->$_ for qw(address businessnumber co_ustid company duns taxnumber);
 
1894       # get employee data from auth.user_config
 
1895       my $user = User->new(login => $login);
 
1896       $self->{$params{prefix} . "_${_}"} = $user->{$_} for qw(email fax name signature tel);
 
1898       # get saved employee data from employee
 
1899       my $employee = SL::DB::Manager::Employee->find_by(id => conv_i($params{id}));
 
1900       $self->{$params{prefix} . "_${_}"} = $employee->{"deleted_$_"} for qw(email fax signature tel);
 
1901       $self->{$params{prefix} . "_name"} = $employee->name;
 
1904   $main::lxdebug->leave_sub();
 
1908   $main::lxdebug->enter_sub();
 
1910   my ($self, $dbh, $id, $key) = @_;
 
1912   $key = "all_contacts" unless ($key);
 
1916     $main::lxdebug->leave_sub();
 
1921     qq|SELECT cp_id, cp_cv_id, cp_name, cp_givenname, cp_abteilung | .
 
1922     qq|FROM contacts | .
 
1923     qq|WHERE cp_cv_id = ? | .
 
1924     qq|ORDER BY lower(cp_name)|;
 
1926   $self->{$key} = selectall_hashref_query($self, $dbh, $query, $id);
 
1928   $main::lxdebug->leave_sub();
 
1932   $main::lxdebug->enter_sub();
 
1934   my ($self, $dbh, $key) = @_;
 
1936   my ($all, $old_id, $where, @values);
 
1938   if (ref($key) eq "HASH") {
 
1941     $key = "ALL_PROJECTS";
 
1943     foreach my $p (keys(%{$params})) {
 
1945         $all = $params->{$p};
 
1946       } elsif ($p eq "old_id") {
 
1947         $old_id = $params->{$p};
 
1948       } elsif ($p eq "key") {
 
1949         $key = $params->{$p};
 
1955     $where = "WHERE active ";
 
1957       if (ref($old_id) eq "ARRAY") {
 
1958         my @ids = grep({ $_ } @{$old_id});
 
1960           $where .= " OR id IN (" . join(",", map({ "?" } @ids)) . ") ";
 
1961           push(@values, @ids);
 
1964         $where .= " OR (id = ?) ";
 
1965         push(@values, $old_id);
 
1971     qq|SELECT id, projectnumber, description, active | .
 
1974     qq|ORDER BY lower(projectnumber)|;
 
1976   $self->{$key} = selectall_hashref_query($self, $dbh, $query, @values);
 
1978   $main::lxdebug->leave_sub();
 
1982   $main::lxdebug->enter_sub();
 
1984   my ($self, $dbh, $vc_id, $key) = @_;
 
1986   $key = "all_shipto" unless ($key);
 
1989     # get shipping addresses
 
1990     my $query = qq|SELECT * FROM shipto WHERE trans_id = ?|;
 
1992     $self->{$key} = selectall_hashref_query($self, $dbh, $query, $vc_id);
 
1998   $main::lxdebug->leave_sub();
 
2002   $main::lxdebug->enter_sub();
 
2004   my ($self, $dbh, $key) = @_;
 
2006   $key = "all_printers" unless ($key);
 
2008   my $query = qq|SELECT id, printer_description, printer_command, template_code FROM printers|;
 
2010   $self->{$key} = selectall_hashref_query($self, $dbh, $query);
 
2012   $main::lxdebug->leave_sub();
 
2016   $main::lxdebug->enter_sub();
 
2018   my ($self, $dbh, $params) = @_;
 
2021   $key = $params->{key};
 
2022   $key = "all_charts" unless ($key);
 
2024   my $transdate = quote_db_date($params->{transdate});
 
2027     qq|SELECT c.id, c.accno, c.description, c.link, c.charttype, tk.taxkey_id, tk.tax_id | .
 
2029     qq|LEFT JOIN taxkeys tk ON | .
 
2030     qq|(tk.id = (SELECT id FROM taxkeys | .
 
2031     qq|          WHERE taxkeys.chart_id = c.id AND startdate <= $transdate | .
 
2032     qq|          ORDER BY startdate DESC LIMIT 1)) | .
 
2033     qq|ORDER BY c.accno|;
 
2035   $self->{$key} = selectall_hashref_query($self, $dbh, $query);
 
2037   $main::lxdebug->leave_sub();
 
2040 sub _get_taxcharts {
 
2041   $main::lxdebug->enter_sub();
 
2043   my ($self, $dbh, $params) = @_;
 
2045   my $key = "all_taxcharts";
 
2048   if (ref $params eq 'HASH') {
 
2049     $key = $params->{key} if ($params->{key});
 
2050     if ($params->{module} eq 'AR') {
 
2051       push @where, 'chart_categories ~ \'[ACILQ]\'';
 
2053     } elsif ($params->{module} eq 'AP') {
 
2054       push @where, 'chart_categories ~ \'[ACELQ]\'';
 
2061   my $where = @where ? ' WHERE ' . join(' AND ', map { "($_)" } @where) : '';
 
2063   my $query = qq|SELECT * FROM tax $where ORDER BY taxkey, rate|;
 
2065   $self->{$key} = selectall_hashref_query($self, $dbh, $query);
 
2067   $main::lxdebug->leave_sub();
 
2071   $main::lxdebug->enter_sub();
 
2073   my ($self, $dbh, $key) = @_;
 
2075   $key = "all_taxzones" unless ($key);
 
2077   $tzfilter = "WHERE obsolete is FALSE" if $key eq 'ALL_ACTIVE_TAXZONES';
 
2079   my $query = qq|SELECT * FROM tax_zones $tzfilter ORDER BY sortkey|;
 
2081   $self->{$key} = selectall_hashref_query($self, $dbh, $query);
 
2083   $main::lxdebug->leave_sub();
 
2086 sub _get_employees {
 
2087   $main::lxdebug->enter_sub();
 
2089   my ($self, $dbh, $params) = @_;
 
2094   if (ref $params eq 'HASH') {
 
2095     $key     = $params->{key};
 
2096     $deleted = $params->{deleted};
 
2102   $key     ||= "all_employees";
 
2103   my $filter = $deleted ? '' : 'WHERE NOT COALESCE(deleted, FALSE)';
 
2104   $self->{$key} = selectall_hashref_query($self, $dbh, qq|SELECT * FROM employee $filter ORDER BY lower(name)|);
 
2106   $main::lxdebug->leave_sub();
 
2109 sub _get_business_types {
 
2110   $main::lxdebug->enter_sub();
 
2112   my ($self, $dbh, $key) = @_;
 
2114   my $options       = ref $key eq 'HASH' ? $key : { key => $key };
 
2115   $options->{key} ||= "all_business_types";
 
2118   if (exists $options->{salesman}) {
 
2119     $where = 'WHERE ' . ($options->{salesman} ? '' : 'NOT ') . 'COALESCE(salesman)';
 
2122   $self->{ $options->{key} } = selectall_hashref_query($self, $dbh, qq|SELECT * FROM business $where ORDER BY lower(description)|);
 
2124   $main::lxdebug->leave_sub();
 
2127 sub _get_languages {
 
2128   $main::lxdebug->enter_sub();
 
2130   my ($self, $dbh, $key) = @_;
 
2132   $key = "all_languages" unless ($key);
 
2134   my $query = qq|SELECT * FROM language ORDER BY id|;
 
2136   $self->{$key} = selectall_hashref_query($self, $dbh, $query);
 
2138   $main::lxdebug->leave_sub();
 
2141 sub _get_dunning_configs {
 
2142   $main::lxdebug->enter_sub();
 
2144   my ($self, $dbh, $key) = @_;
 
2146   $key = "all_dunning_configs" unless ($key);
 
2148   my $query = qq|SELECT * FROM dunning_config ORDER BY dunning_level|;
 
2150   $self->{$key} = selectall_hashref_query($self, $dbh, $query);
 
2152   $main::lxdebug->leave_sub();
 
2155 sub _get_currencies {
 
2156 $main::lxdebug->enter_sub();
 
2158   my ($self, $dbh, $key) = @_;
 
2160   $key = "all_currencies" unless ($key);
 
2162   $self->{$key} = [$self->get_all_currencies()];
 
2164   $main::lxdebug->leave_sub();
 
2168 $main::lxdebug->enter_sub();
 
2170   my ($self, $dbh, $key) = @_;
 
2172   $key = "all_payments" unless ($key);
 
2174   my $query = qq|SELECT * FROM payment_terms ORDER BY sortkey|;
 
2176   $self->{$key} = selectall_hashref_query($self, $dbh, $query);
 
2178   $main::lxdebug->leave_sub();
 
2181 sub _get_customers {
 
2182   $main::lxdebug->enter_sub();
 
2184   my ($self, $dbh, $key) = @_;
 
2186   my $options        = ref $key eq 'HASH' ? $key : { key => $key };
 
2187   $options->{key}  ||= "all_customers";
 
2188   my $limit_clause   = $options->{limit} ? "LIMIT $options->{limit}" : '';
 
2191   push @where, qq|business_id IN (SELECT id FROM business WHERE salesman)| if  $options->{business_is_salesman};
 
2192   push @where, qq|NOT obsolete|                                            if !$options->{with_obsolete};
 
2193   my $where_str = @where ? "WHERE " . join(" AND ", map { "($_)" } @where) : '';
 
2195   my $query = qq|SELECT * FROM customer $where_str ORDER BY name $limit_clause|;
 
2196   $self->{ $options->{key} } = selectall_hashref_query($self, $dbh, $query);
 
2198   $main::lxdebug->leave_sub();
 
2202   $main::lxdebug->enter_sub();
 
2204   my ($self, $dbh, $key) = @_;
 
2206   $key = "all_vendors" unless ($key);
 
2208   my $query = qq|SELECT * FROM vendor WHERE NOT obsolete ORDER BY name|;
 
2210   $self->{$key} = selectall_hashref_query($self, $dbh, $query);
 
2212   $main::lxdebug->leave_sub();
 
2215 sub _get_departments {
 
2216   $main::lxdebug->enter_sub();
 
2218   my ($self, $dbh, $key) = @_;
 
2220   $key = "all_departments" unless ($key);
 
2222   my $query = qq|SELECT * FROM department ORDER BY description|;
 
2224   $self->{$key} = selectall_hashref_query($self, $dbh, $query);
 
2226   $main::lxdebug->leave_sub();
 
2229 sub _get_warehouses {
 
2230   $main::lxdebug->enter_sub();
 
2232   my ($self, $dbh, $param) = @_;
 
2234   my ($key, $bins_key);
 
2236   if ('' eq ref $param) {
 
2240     $key      = $param->{key};
 
2241     $bins_key = $param->{bins};
 
2244   my $query = qq|SELECT w.* FROM warehouse w
 
2245                  WHERE (NOT w.invalid) AND
 
2246                    ((SELECT COUNT(b.*) FROM bin b WHERE b.warehouse_id = w.id) > 0)
 
2247                  ORDER BY w.sortkey|;
 
2249   $self->{$key} = selectall_hashref_query($self, $dbh, $query);
 
2252     $query = qq|SELECT id, description FROM bin WHERE warehouse_id = ?
 
2253                 ORDER BY description|;
 
2254     my $sth = prepare_query($self, $dbh, $query);
 
2256     foreach my $warehouse (@{ $self->{$key} }) {
 
2257       do_statement($self, $sth, $query, $warehouse->{id});
 
2258       $warehouse->{$bins_key} = [];
 
2260       while (my $ref = $sth->fetchrow_hashref()) {
 
2261         push @{ $warehouse->{$bins_key} }, $ref;
 
2267   $main::lxdebug->leave_sub();
 
2271   $main::lxdebug->enter_sub();
 
2273   my ($self, $dbh, $table, $key, $sortkey) = @_;
 
2275   my $query  = qq|SELECT * FROM $table|;
 
2276   $query    .= qq| ORDER BY $sortkey| if ($sortkey);
 
2278   $self->{$key} = selectall_hashref_query($self, $dbh, $query);
 
2280   $main::lxdebug->leave_sub();
 
2284 #  $main::lxdebug->enter_sub();
 
2286 #  my ($self, $dbh, $key) = @_;
 
2288 #  $key ||= "all_groups";
 
2290 #  my $groups = $main::auth->read_groups();
 
2292 #  $self->{$key} = selectall_hashref_query($self, $dbh, $query);
 
2294 #  $main::lxdebug->leave_sub();
 
2298   $main::lxdebug->enter_sub();
 
2303   my $dbh = $self->get_standard_dbh(\%main::myconfig);
 
2304   my ($sth, $query, $ref);
 
2307   if ($params{contacts} || $params{shipto}) {
 
2308     $vc = 'customer' if $self->{"vc"} eq "customer";
 
2309     $vc = 'vendor'   if $self->{"vc"} eq "vendor";
 
2310     die "invalid use of get_lists, need 'vc'" unless $vc;
 
2311     $vc_id = $self->{"${vc}_id"};
 
2314   if ($params{"contacts"}) {
 
2315     $self->_get_contacts($dbh, $vc_id, $params{"contacts"});
 
2318   if ($params{"shipto"}) {
 
2319     $self->_get_shipto($dbh, $vc_id, $params{"shipto"});
 
2322   if ($params{"projects"} || $params{"all_projects"}) {
 
2323     $self->_get_projects($dbh, $params{"all_projects"} ?
 
2324                          $params{"all_projects"} : $params{"projects"},
 
2325                          $params{"all_projects"} ? 1 : 0);
 
2328   if ($params{"printers"}) {
 
2329     $self->_get_printers($dbh, $params{"printers"});
 
2332   if ($params{"languages"}) {
 
2333     $self->_get_languages($dbh, $params{"languages"});
 
2336   if ($params{"charts"}) {
 
2337     $self->_get_charts($dbh, $params{"charts"});
 
2340   if ($params{"taxcharts"}) {
 
2341     $self->_get_taxcharts($dbh, $params{"taxcharts"});
 
2344   if ($params{"taxzones"}) {
 
2345     $self->_get_taxzones($dbh, $params{"taxzones"});
 
2348   if ($params{"employees"}) {
 
2349     $self->_get_employees($dbh, $params{"employees"});
 
2352   if ($params{"salesmen"}) {
 
2353     $self->_get_employees($dbh, $params{"salesmen"});
 
2356   if ($params{"business_types"}) {
 
2357     $self->_get_business_types($dbh, $params{"business_types"});
 
2360   if ($params{"dunning_configs"}) {
 
2361     $self->_get_dunning_configs($dbh, $params{"dunning_configs"});
 
2364   if($params{"currencies"}) {
 
2365     $self->_get_currencies($dbh, $params{"currencies"});
 
2368   if($params{"customers"}) {
 
2369     $self->_get_customers($dbh, $params{"customers"});
 
2372   if($params{"vendors"}) {
 
2373     if (ref $params{"vendors"} eq 'HASH') {
 
2374       $self->_get_vendors($dbh, $params{"vendors"}{key}, $params{"vendors"}{limit});
 
2376       $self->_get_vendors($dbh, $params{"vendors"});
 
2380   if($params{"payments"}) {
 
2381     $self->_get_payments($dbh, $params{"payments"});
 
2384   if($params{"departments"}) {
 
2385     $self->_get_departments($dbh, $params{"departments"});
 
2388   if ($params{price_factors}) {
 
2389     $self->_get_simple($dbh, 'price_factors', $params{price_factors}, 'sortkey');
 
2392   if ($params{warehouses}) {
 
2393     $self->_get_warehouses($dbh, $params{warehouses});
 
2396 #  if ($params{groups}) {
 
2397 #    $self->_get_groups($dbh, $params{groups});
 
2400   if ($params{partsgroup}) {
 
2401     $self->get_partsgroup(\%main::myconfig, { all => 1, target => $params{partsgroup} });
 
2404   $main::lxdebug->leave_sub();
 
2407 # this sub gets the id and name from $table
 
2409   $main::lxdebug->enter_sub();
 
2411   my ($self, $myconfig, $table) = @_;
 
2413   # connect to database
 
2414   my $dbh = $self->get_standard_dbh($myconfig);
 
2416   $table = $table eq "customer" ? "customer" : "vendor";
 
2417   my $arap = $self->{arap} eq "ar" ? "ar" : "ap";
 
2419   my ($query, @values);
 
2421   if (!$self->{openinvoices}) {
 
2423     if ($self->{customernumber} ne "") {
 
2424       $where = qq|(vc.customernumber ILIKE ?)|;
 
2425       push(@values, like($self->{customernumber}));
 
2427       $where = qq|(vc.name ILIKE ?)|;
 
2428       push(@values, like($self->{$table}));
 
2432       qq~SELECT vc.id, vc.name,
 
2433            vc.street || ' ' || vc.zipcode || ' ' || vc.city || ' ' || vc.country AS address
 
2435          WHERE $where AND (NOT vc.obsolete)
 
2439       qq~SELECT DISTINCT vc.id, vc.name,
 
2440            vc.street || ' ' || vc.zipcode || ' ' || vc.city || ' ' || vc.country AS address
 
2442          JOIN $table vc ON (a.${table}_id = vc.id)
 
2443          WHERE NOT (a.amount = a.paid) AND (vc.name ILIKE ?)
 
2445     push(@values, like($self->{$table}));
 
2448   $self->{name_list} = selectall_hashref_query($self, $dbh, $query, @values);
 
2450   $main::lxdebug->leave_sub();
 
2452   return scalar(@{ $self->{name_list} });
 
2456   $main::lxdebug->enter_sub();
 
2458   my ($self, $table, $provided_dbh) = @_;
 
2460   my $dbh = $provided_dbh ? $provided_dbh : $self->get_standard_dbh;
 
2461   return                                       unless $self->{id};
 
2462   croak ("wrong call, no valid table defined") unless $table =~ /^(oe|ar|ap|delivery_orders|parts)$/;
 
2464   my $query       = "SELECT mtime, itime FROM " . $table . " WHERE id = ?";
 
2465   my $ref         = selectfirst_hashref_query($self, $dbh, $query, $self->{id});
 
2466   $ref->{mtime} ||= $ref->{itime};
 
2467   $self->{lastmtime} = $ref->{mtime};
 
2468   $main::lxdebug->message(LXDebug->DEBUG2(),"new lastmtime=".$self->{lastmtime});
 
2470   $main::lxdebug->leave_sub();
 
2473 sub mtime_ischanged {
 
2474   my ($self, $table, $option) = @_;
 
2476   return                                       unless $self->{id};
 
2477   croak ("wrong call, no valid table defined") unless $table =~ /^(oe|ar|ap|delivery_orders|parts)$/;
 
2479   my $query       = "SELECT mtime, itime FROM " . $table . " WHERE id = ?";
 
2480   my $ref         = selectfirst_hashref_query($self, $self->get_standard_dbh, $query, $self->{id});
 
2481   $ref->{mtime} ||= $ref->{itime};
 
2483   if ($self->{lastmtime} && $self->{lastmtime} ne $ref->{mtime} ) {
 
2484       $self->error(($option eq 'mail') ?
 
2485         t8("The document has been changed by another user. No mail was sent. Please reopen it in another window and copy the changes to the new window") :
 
2486         t8("The document has been changed by another user. Please reopen it in another window and copy the changes to the new window")
 
2488     $::dispatcher->end_request;
 
2492 # language_payment duplicates some of the functionality of all_vc (language,
 
2493 # printer, payment_terms), and at least in the case of sales invoices both
 
2494 # all_vc and language_payment are called when adding new invoices
 
2495 sub language_payment {
 
2496   $main::lxdebug->enter_sub();
 
2498   my ($self, $myconfig) = @_;
 
2500   my $dbh = $self->get_standard_dbh($myconfig);
 
2502   my $query = qq|SELECT id, description
 
2506   $self->{languages} = selectall_hashref_query($self, $dbh, $query);
 
2509   $query = qq|SELECT printer_description, id
 
2511               ORDER BY printer_description|;
 
2513   $self->{printers} = selectall_hashref_query($self, $dbh, $query);
 
2516   $query = qq|SELECT id, description
 
2518               WHERE ( obsolete IS FALSE OR id = ? )
 
2520   $self->{payment_terms} = selectall_hashref_query($self, $dbh, $query, $self->{payment_id} || undef);
 
2522   # get buchungsgruppen
 
2523   $query = qq|SELECT id, description
 
2524               FROM buchungsgruppen|;
 
2526   $self->{BUCHUNGSGRUPPEN} = selectall_hashref_query($self, $dbh, $query);
 
2528   $main::lxdebug->leave_sub();
 
2531 # this is only used for reports
 
2532 sub all_departments {
 
2533   $main::lxdebug->enter_sub();
 
2535   my ($self, $myconfig, $table) = @_;
 
2537   my $dbh = $self->get_standard_dbh($myconfig);
 
2539   my $query = qq|SELECT id, description
 
2541                  ORDER BY description|;
 
2542   $self->{all_departments} = selectall_hashref_query($self, $dbh, $query);
 
2544   delete($self->{all_departments}) unless (@{ $self->{all_departments} || [] });
 
2546   $main::lxdebug->leave_sub();
 
2550   $main::lxdebug->enter_sub();
 
2552   my ($self, $module, $myconfig, $table, $provided_dbh) = @_;
 
2555   if ($table eq "customer") {
 
2564   # get last customers or vendors
 
2565   my ($query, $sth, $ref);
 
2567   my $dbh = $provided_dbh ? $provided_dbh : $self->get_standard_dbh($myconfig);
 
2572     my $transdate = "current_date";
 
2573     if ($self->{transdate}) {
 
2574       $transdate = $dbh->quote($self->{transdate});
 
2577     # now get the account numbers
 
2579       SELECT c.accno, c.description, c.link, c.taxkey_id, c.id AS chart_id, tk2.tax_id
 
2581         -- find newest entries in taxkeys
 
2583           SELECT chart_id, MAX(startdate) AS startdate
 
2585           WHERE (startdate <= $transdate)
 
2587         ) tk ON (c.id = tk.chart_id)
 
2588         -- and load all of those entries
 
2589         INNER JOIN taxkeys tk2
 
2590            ON (tk.chart_id = tk2.chart_id AND tk.startdate = tk2.startdate)
 
2591        WHERE (c.link LIKE ?)
 
2594     $sth = $dbh->prepare($query);
 
2596     do_statement($self, $sth, $query, like($module));
 
2598     $self->{accounts} = "";
 
2599     while ($ref = $sth->fetchrow_hashref("NAME_lc")) {
 
2601       foreach my $key (split(/:/, $ref->{link})) {
 
2602         if ($key =~ /\Q$module\E/) {
 
2604           # cross reference for keys
 
2605           $xkeyref{ $ref->{accno} } = $key;
 
2607           push @{ $self->{"${module}_links"}{$key} },
 
2608             { accno       => $ref->{accno},
 
2609               chart_id    => $ref->{chart_id},
 
2610               description => $ref->{description},
 
2611               taxkey      => $ref->{taxkey_id},
 
2612               tax_id      => $ref->{tax_id} };
 
2614           $self->{accounts} .= "$ref->{accno} " unless $key =~ /tax/;
 
2620   # get taxkeys and description
 
2621   $query = qq|SELECT id, taxkey, taxdescription FROM tax|;
 
2622   $self->{TAXKEY} = selectall_hashref_query($self, $dbh, $query);
 
2624   if (($module eq "AP") || ($module eq "AR")) {
 
2625     # get tax rates and description
 
2626     $query = qq|SELECT * FROM tax|;
 
2627     $self->{TAX} = selectall_hashref_query($self, $dbh, $query);
 
2630   my $extra_columns = '';
 
2631   $extra_columns   .= 'a.direct_debit, ' if ($module eq 'AR') || ($module eq 'AP');
 
2636            a.cp_id, a.invnumber, a.transdate, a.${table}_id, a.datepaid,
 
2637            a.duedate, a.ordnumber, a.taxincluded, (SELECT cu.name FROM currencies cu WHERE cu.id=a.currency_id) AS currency, a.notes,
 
2639            a.intnotes, a.department_id, a.amount AS oldinvtotal,
 
2640            a.paid AS oldtotalpaid, a.employee_id, a.gldate, a.type,
 
2641            a.globalproject_id, ${extra_columns}
 
2643            d.description AS department,
 
2646          JOIN $table c ON (a.${table}_id = c.id)
 
2647          LEFT JOIN employee e ON (e.id = a.employee_id)
 
2648          LEFT JOIN department d ON (d.id = a.department_id)
 
2650     $ref = selectfirst_hashref_query($self, $dbh, $query, $self->{id});
 
2652     foreach my $key (keys %$ref) {
 
2653       $self->{$key} = $ref->{$key};
 
2655     $self->{mtime}   ||= $self->{itime};
 
2656     $self->{lastmtime} = $self->{mtime};
 
2657     my $transdate = "current_date";
 
2658     if ($self->{transdate}) {
 
2659       $transdate = $dbh->quote($self->{transdate});
 
2662     # now get the account numbers
 
2663     $query = qq|SELECT c.accno, c.description, c.link, c.taxkey_id, c.id AS chart_id, tk.tax_id
 
2665                 LEFT JOIN taxkeys tk ON (tk.chart_id = c.id)
 
2667                   AND (tk.id = (SELECT id FROM taxkeys WHERE taxkeys.chart_id = c.id AND startdate <= $transdate ORDER BY startdate DESC LIMIT 1)
 
2668                     OR c.link LIKE '%_tax%' OR c.taxkey_id IS NULL)
 
2671     $sth = $dbh->prepare($query);
 
2672     do_statement($self, $sth, $query, like($module));
 
2674     $self->{accounts} = "";
 
2675     while ($ref = $sth->fetchrow_hashref("NAME_lc")) {
 
2677       foreach my $key (split(/:/, $ref->{link})) {
 
2678         if ($key =~ /\Q$module\E/) {
 
2680           # cross reference for keys
 
2681           $xkeyref{ $ref->{accno} } = $key;
 
2683           push @{ $self->{"${module}_links"}{$key} },
 
2684             { accno       => $ref->{accno},
 
2685               chart_id    => $ref->{chart_id},
 
2686               description => $ref->{description},
 
2687               taxkey      => $ref->{taxkey_id},
 
2688               tax_id      => $ref->{tax_id} };
 
2690           $self->{accounts} .= "$ref->{accno} " unless $key =~ /tax/;
 
2696     # get amounts from individual entries
 
2699            c.accno, c.description,
 
2700            a.acc_trans_id, a.source, a.amount, a.memo, a.transdate, a.gldate, a.cleared, a.project_id, a.taxkey, a.chart_id,
 
2704          LEFT JOIN chart c ON (c.id = a.chart_id)
 
2705          LEFT JOIN project p ON (p.id = a.project_id)
 
2706          LEFT JOIN tax t ON (t.id= a.tax_id)
 
2707          WHERE a.trans_id = ?
 
2708          AND a.fx_transaction = '0'
 
2709          ORDER BY a.acc_trans_id, a.transdate|;
 
2710     $sth = $dbh->prepare($query);
 
2711     do_statement($self, $sth, $query, $self->{id});
 
2713     # get exchangerate for currency
 
2714     $self->{exchangerate} =
 
2715       $self->get_exchangerate($dbh, $self->{currency}, $self->{transdate}, $fld);
 
2718     # store amounts in {acc_trans}{$key} for multiple accounts
 
2719     while (my $ref = $sth->fetchrow_hashref("NAME_lc")) {
 
2720       $ref->{exchangerate} =
 
2721         $self->get_exchangerate($dbh, $self->{currency}, $ref->{transdate}, $fld);
 
2722       if (!($xkeyref{ $ref->{accno} } =~ /tax/)) {
 
2725       if (($xkeyref{ $ref->{accno} } =~ /paid/) && ($self->{type} eq "credit_note")) {
 
2726         $ref->{amount} *= -1;
 
2728       $ref->{index} = $index;
 
2730       push @{ $self->{acc_trans}{ $xkeyref{ $ref->{accno} } } }, $ref;
 
2737            d.closedto, d.revtrans,
 
2738            (SELECT cu.name FROM currencies cu WHERE cu.id=d.currency_id) AS defaultcurrency,
 
2739            (SELECT c.accno FROM chart c WHERE d.fxgain_accno_id = c.id) AS fxgain_accno,
 
2740            (SELECT c.accno FROM chart c WHERE d.fxloss_accno_id = c.id) AS fxloss_accno,
 
2741            (SELECT c.accno FROM chart c WHERE d.rndgain_accno_id = c.id) AS rndgain_accno,
 
2742            (SELECT c.accno FROM chart c WHERE d.rndloss_accno_id = c.id) AS rndloss_accno
 
2744     $ref = selectfirst_hashref_query($self, $dbh, $query);
 
2745     map { $self->{$_} = $ref->{$_} } keys %$ref;
 
2752             current_date AS transdate, d.closedto, d.revtrans,
 
2753             (SELECT cu.name FROM currencies cu WHERE cu.id=d.currency_id) AS defaultcurrency,
 
2754             (SELECT c.accno FROM chart c WHERE d.fxgain_accno_id = c.id) AS fxgain_accno,
 
2755             (SELECT c.accno FROM chart c WHERE d.fxloss_accno_id = c.id) AS fxloss_accno,
 
2756             (SELECT c.accno FROM chart c WHERE d.rndgain_accno_id = c.id) AS rndgain_accno,
 
2757             (SELECT c.accno FROM chart c WHERE d.rndloss_accno_id = c.id) AS rndloss_accno
 
2759     $ref = selectfirst_hashref_query($self, $dbh, $query);
 
2760     map { $self->{$_} = $ref->{$_} } keys %$ref;
 
2762     if ($self->{"$self->{vc}_id"}) {
 
2764       # only setup currency
 
2765       ($self->{currency}) = $self->{defaultcurrency} if !$self->{currency};
 
2769       $self->lastname_used($dbh, $myconfig, $table, $module);
 
2771       # get exchangerate for currency
 
2772       $self->{exchangerate} =
 
2773         $self->get_exchangerate($dbh, $self->{currency}, $self->{transdate}, $fld);
 
2779   $main::lxdebug->leave_sub();
 
2783   $main::lxdebug->enter_sub();
 
2785   my ($self, $dbh, $myconfig, $table, $module) = @_;
 
2789   $table         = $table eq "customer" ? "customer" : "vendor";
 
2790   my %column_map = ("a.${table}_id"           => "${table}_id",
 
2791                     "a.department_id"         => "department_id",
 
2792                     "d.description"           => "department",
 
2793                     "ct.name"                 => $table,
 
2794                     "cu.name"                 => "currency",
 
2797   if ($self->{type} =~ /delivery_order/) {
 
2798     $arap  = 'delivery_orders';
 
2799     delete $column_map{"cu.currency"};
 
2801   } elsif ($self->{type} =~ /_order/) {
 
2803     $where = "quotation = '0'";
 
2805   } elsif ($self->{type} =~ /_quotation/) {
 
2807     $where = "quotation = '1'";
 
2809   } elsif ($table eq 'customer') {
 
2817   $where           = "($where) AND" if ($where);
 
2818   my $query        = qq|SELECT MAX(id) FROM $arap
 
2819                         WHERE $where ${table}_id > 0|;
 
2820   my ($trans_id)   = selectrow_query($self, $dbh, $query);
 
2823   my $column_spec  = join(', ', map { "${_} AS $column_map{$_}" } keys %column_map);
 
2824   $query           = qq|SELECT $column_spec
 
2826                         LEFT JOIN $table     ct ON (a.${table}_id = ct.id)
 
2827                         LEFT JOIN department d  ON (a.department_id = d.id)
 
2828                         LEFT JOIN currencies cu ON (cu.id=ct.currency_id)
 
2830   my $ref          = selectfirst_hashref_query($self, $dbh, $query, $trans_id);
 
2832   map { $self->{$_} = $ref->{$_} } values %column_map;
 
2834   $main::lxdebug->leave_sub();
 
2838   $main::lxdebug->enter_sub();
 
2841   my $myconfig = shift || \%::myconfig;
 
2842   my ($thisdate, $days) = @_;
 
2844   my $dbh = $self->get_standard_dbh($myconfig);
 
2849     my $dateformat = $myconfig->{dateformat};
 
2850     $dateformat .= "yy" if $myconfig->{dateformat} !~ /^y/;
 
2851     $thisdate = $dbh->quote($thisdate);
 
2852     $query = qq|SELECT to_date($thisdate, '$dateformat') + $days AS thisdate|;
 
2854     $query = qq|SELECT current_date AS thisdate|;
 
2857   ($thisdate) = selectrow_query($self, $dbh, $query);
 
2859   $main::lxdebug->leave_sub();
 
2865   $main::lxdebug->enter_sub();
 
2867   my ($self, $flds, $new, $count, $numrows) = @_;
 
2871   map { push @ndx, { num => $new->[$_ - 1]->{runningnumber}, ndx => $_ } } 1 .. $count;
 
2876   foreach my $item (sort { $a->{num} <=> $b->{num} } @ndx) {
 
2878     my $j = $item->{ndx} - 1;
 
2879     map { $self->{"${_}_$i"} = $new->[$j]->{$_} } @{$flds};
 
2883   for $i ($count + 1 .. $numrows) {
 
2884     map { delete $self->{"${_}_$i"} } @{$flds};
 
2887   $main::lxdebug->leave_sub();
 
2891   $main::lxdebug->enter_sub();
 
2893   my ($self, $myconfig) = @_;
 
2897   SL::DB->client->with_transaction(sub {
 
2898     my $dbh = SL::DB->client->dbh;
 
2900     my $query = qq|DELETE FROM status
 
2901                    WHERE (formname = ?) AND (trans_id = ?)|;
 
2902     my $sth = prepare_query($self, $dbh, $query);
 
2904     if ($self->{formname} =~ /(check|receipt)/) {
 
2905       for $i (1 .. $self->{rowcount}) {
 
2906         do_statement($self, $sth, $query, $self->{formname}, $self->{"id_$i"} * 1);
 
2909       do_statement($self, $sth, $query, $self->{formname}, $self->{id});
 
2913     my $printed = ($self->{printed} =~ /\Q$self->{formname}\E/) ? "1" : "0";
 
2914     my $emailed = ($self->{emailed} =~ /\Q$self->{formname}\E/) ? "1" : "0";
 
2916     my %queued = split / /, $self->{queued};
 
2919     if ($self->{formname} =~ /(check|receipt)/) {
 
2921       # this is a check or receipt, add one entry for each lineitem
 
2922       my ($accno) = split /--/, $self->{account};
 
2923       $query = qq|INSERT INTO status (trans_id, printed, spoolfile, formname, chart_id)
 
2924                   VALUES (?, ?, ?, ?, (SELECT c.id FROM chart c WHERE c.accno = ?))|;
 
2925       @values = ($printed, $queued{$self->{formname}}, $self->{prinform}, $accno);
 
2926       $sth = prepare_query($self, $dbh, $query);
 
2928       for $i (1 .. $self->{rowcount}) {
 
2929         if ($self->{"checked_$i"}) {
 
2930           do_statement($self, $sth, $query, $self->{"id_$i"}, @values);
 
2936       $query = qq|INSERT INTO status (trans_id, printed, emailed, spoolfile, formname)
 
2937                   VALUES (?, ?, ?, ?, ?)|;
 
2938       do_query($self, $dbh, $query, $self->{id}, $printed, $emailed,
 
2939                $queued{$self->{formname}}, $self->{formname});
 
2942   }) or do { die SL::DB->client->error };
 
2944   $main::lxdebug->leave_sub();
 
2948   $main::lxdebug->enter_sub();
 
2950   my ($self, $dbh) = @_;
 
2952   my ($query, $printed, $emailed);
 
2954   my $formnames  = $self->{printed};
 
2955   my $emailforms = $self->{emailed};
 
2957   $query = qq|DELETE FROM status
 
2958                  WHERE (formname = ?) AND (trans_id = ?)|;
 
2959   do_query($self, $dbh, $query, $self->{formname}, $self->{id});
 
2961   # this only applies to the forms
 
2962   # checks and receipts are posted when printed or queued
 
2964   if ($self->{queued}) {
 
2965     my %queued = split / /, $self->{queued};
 
2967     foreach my $formname (keys %queued) {
 
2968       $printed = ($self->{printed} =~ /\Q$self->{formname}\E/) ? "1" : "0";
 
2969       $emailed = ($self->{emailed} =~ /\Q$self->{formname}\E/) ? "1" : "0";
 
2971       $query = qq|INSERT INTO status (trans_id, printed, emailed, spoolfile, formname)
 
2972                   VALUES (?, ?, ?, ?, ?)|;
 
2973       do_query($self, $dbh, $query, $self->{id}, $printed, $emailed, $queued{$formname}, $formname);
 
2975       $formnames  =~ s/\Q$self->{formname}\E//;
 
2976       $emailforms =~ s/\Q$self->{formname}\E//;
 
2981   # save printed, emailed info
 
2982   $formnames  =~ s/^ +//g;
 
2983   $emailforms =~ s/^ +//g;
 
2986   map { $status{$_}{printed} = 1 } split / +/, $formnames;
 
2987   map { $status{$_}{emailed} = 1 } split / +/, $emailforms;
 
2989   foreach my $formname (keys %status) {
 
2990     $printed = ($formnames  =~ /\Q$self->{formname}\E/) ? "1" : "0";
 
2991     $emailed = ($emailforms =~ /\Q$self->{formname}\E/) ? "1" : "0";
 
2993     $query = qq|INSERT INTO status (trans_id, printed, emailed, formname)
 
2994                 VALUES (?, ?, ?, ?)|;
 
2995     do_query($self, $dbh, $query, $self->{id}, $printed, $emailed, $formname);
 
2998   $main::lxdebug->leave_sub();
 
3002 # $main::locale->text('SAVED')
 
3003 # $main::locale->text('DELETED')
 
3004 # $main::locale->text('ADDED')
 
3005 # $main::locale->text('PAYMENT POSTED')
 
3006 # $main::locale->text('POSTED')
 
3007 # $main::locale->text('POSTED AS NEW')
 
3008 # $main::locale->text('ELSE')
 
3009 # $main::locale->text('SAVED FOR DUNNING')
 
3010 # $main::locale->text('DUNNING STARTED')
 
3011 # $main::locale->text('PRINTED')
 
3012 # $main::locale->text('MAILED')
 
3013 # $main::locale->text('SCREENED')
 
3014 # $main::locale->text('CANCELED')
 
3015 # $main::locale->text('invoice')
 
3016 # $main::locale->text('proforma')
 
3017 # $main::locale->text('sales_order')
 
3018 # $main::locale->text('pick_list')
 
3019 # $main::locale->text('purchase_order')
 
3020 # $main::locale->text('bin_list')
 
3021 # $main::locale->text('sales_quotation')
 
3022 # $main::locale->text('request_quotation')
 
3025   $main::lxdebug->enter_sub();
 
3028   my $dbh  = shift || SL::DB->client->dbh;
 
3029   SL::DB->client->with_transaction(sub {
 
3031     if(!exists $self->{employee_id}) {
 
3032       &get_employee($self, $dbh);
 
3036      qq|INSERT INTO history_erp (trans_id, employee_id, addition, what_done, snumbers) | .
 
3037      qq|VALUES (?, (SELECT id FROM employee WHERE login = ?), ?, ?, ?)|;
 
3038     my @values = (conv_i($self->{id}), $self->{login},
 
3039                   $self->{addition}, $self->{what_done}, "$self->{snumbers}");
 
3040     do_query($self, $dbh, $query, @values);
 
3042   }) or do { die SL::DB->client->error };
 
3044   $main::lxdebug->leave_sub();
 
3048   $main::lxdebug->enter_sub();
 
3050   my ($self, $dbh, $trans_id, $restriction, $order) = @_;
 
3051   my ($orderBy, $desc) = split(/\-\-/, $order);
 
3052   $order = " ORDER BY " . ($order eq "" ? " h.itime " : ($desc == 1 ? $orderBy . " DESC " : $orderBy . " "));
 
3055   if ($trans_id ne "") {
 
3057       qq|SELECT h.employee_id, h.itime::timestamp(0) AS itime, h.addition, h.what_done, emp.name, h.snumbers, h.trans_id AS id | .
 
3058       qq|FROM history_erp h | .
 
3059       qq|LEFT JOIN employee emp ON (emp.id = h.employee_id) | .
 
3060       qq|WHERE (trans_id = | . $trans_id . qq|) $restriction | .
 
3063     my $sth = $dbh->prepare($query) || $self->dberror($query);
 
3065     $sth->execute() || $self->dberror("$query");
 
3067     while(my $hash_ref = $sth->fetchrow_hashref()) {
 
3068       $hash_ref->{addition} = $main::locale->text($hash_ref->{addition});
 
3069       $hash_ref->{what_done} = $main::locale->text($hash_ref->{what_done});
 
3070       $hash_ref->{snumbers} =~ s/^.+_(.*)$/$1/g;
 
3071       $tempArray[$i++] = $hash_ref;
 
3073     $main::lxdebug->leave_sub() and return \@tempArray
 
3074       if ($i > 0 && $tempArray[0] ne "");
 
3076   $main::lxdebug->leave_sub();
 
3080 sub get_partsgroup {
 
3081   $main::lxdebug->enter_sub();
 
3083   my ($self, $myconfig, $p) = @_;
 
3084   my $target = $p->{target} || 'all_partsgroup';
 
3086   my $dbh = $self->get_standard_dbh($myconfig);
 
3088   my $query = qq|SELECT DISTINCT pg.id, pg.partsgroup
 
3090                  JOIN parts p ON (p.partsgroup_id = pg.id) |;
 
3093   if ($p->{searchitems} eq 'part') {
 
3094     $query .= qq|WHERE p.part_type = 'part'|;
 
3096   if ($p->{searchitems} eq 'service') {
 
3097     $query .= qq|WHERE p.part_type = 'service'|;
 
3099   if ($p->{searchitems} eq 'assembly') {
 
3100     $query .= qq|WHERE p.part_type = 'assembly'|;
 
3103   $query .= qq|ORDER BY partsgroup|;
 
3106     $query = qq|SELECT id, partsgroup FROM partsgroup
 
3107                 ORDER BY partsgroup|;
 
3110   if ($p->{language_code}) {
 
3111     $query = qq|SELECT DISTINCT pg.id, pg.partsgroup,
 
3112                   t.description AS translation
 
3114                 JOIN parts p ON (p.partsgroup_id = pg.id)
 
3115                 LEFT JOIN translation t ON ((t.trans_id = pg.id) AND (t.language_code = ?))
 
3116                 ORDER BY translation|;
 
3117     @values = ($p->{language_code});
 
3120   $self->{$target} = selectall_hashref_query($self, $dbh, $query, @values);
 
3122   $main::lxdebug->leave_sub();
 
3125 sub get_pricegroup {
 
3126   $main::lxdebug->enter_sub();
 
3128   my ($self, $myconfig, $p) = @_;
 
3130   my $dbh = $self->get_standard_dbh($myconfig);
 
3132   my $query = qq|SELECT p.id, p.pricegroup
 
3135   $query .= qq| ORDER BY pricegroup|;
 
3138     $query = qq|SELECT id, pricegroup FROM pricegroup
 
3139                 ORDER BY pricegroup|;
 
3142   $self->{all_pricegroup} = selectall_hashref_query($self, $dbh, $query);
 
3144   $main::lxdebug->leave_sub();
 
3148 # usage $form->all_years($myconfig, [$dbh])
 
3149 # return list of all years where bookings found
 
3152   $main::lxdebug->enter_sub();
 
3154   my ($self, $myconfig, $dbh) = @_;
 
3156   $dbh ||= $self->get_standard_dbh($myconfig);
 
3159   my $query = qq|SELECT (SELECT MIN(transdate) FROM acc_trans),
 
3160                    (SELECT MAX(transdate) FROM acc_trans)|;
 
3161   my ($startdate, $enddate) = selectrow_query($self, $dbh, $query);
 
3163   if ($myconfig->{dateformat} =~ /^yy/) {
 
3164     ($startdate) = split /\W/, $startdate;
 
3165     ($enddate) = split /\W/, $enddate;
 
3167     (@_) = split /\W/, $startdate;
 
3169     (@_) = split /\W/, $enddate;
 
3174   $startdate = substr($startdate,0,4);
 
3175   $enddate = substr($enddate,0,4);
 
3177   while ($enddate >= $startdate) {
 
3178     push @all_years, $enddate--;
 
3183   $main::lxdebug->leave_sub();
 
3187   $main::lxdebug->enter_sub();
 
3191   map { $self->{_VAR_BACKUP}->{$_} = $self->{$_} if exists $self->{$_} } @vars;
 
3193   $main::lxdebug->leave_sub();
 
3197   $main::lxdebug->enter_sub();
 
3202   map { $self->{$_} = $self->{_VAR_BACKUP}->{$_} if exists $self->{_VAR_BACKUP}->{$_} } @vars;
 
3204   $main::lxdebug->leave_sub();
 
3207 sub prepare_for_printing {
 
3210   my $defaults         = SL::DB::Default->get;
 
3212   $self->{templates} ||= $defaults->templates;
 
3213   $self->{formname}  ||= $self->{type};
 
3214   $self->{media}     ||= 'email';
 
3216   die "'media' other than 'email', 'file', 'printer' is not supported yet" unless $self->{media} =~ m/^(?:email|file|printer)$/;
 
3218   # Several fields that used to reside in %::myconfig (stored in
 
3219   # auth.user_config) are now stored in defaults. Copy them over for
 
3221   $self->{$_} = $defaults->$_ for qw(company address taxnumber co_ustid duns sepa_creditor_id);
 
3223   $self->{"myconfig_${_}"} = $::myconfig{$_} for grep { $_ ne 'dbpasswd' } keys %::myconfig;
 
3225   if (!$self->{employee_id}) {
 
3226     $self->{"employee_${_}"} = $::myconfig{$_} for qw(email tel fax name signature);
 
3227     $self->{"employee_${_}"} = $defaults->$_   for qw(address businessnumber co_ustid company duns sepa_creditor_id taxnumber);
 
3230   # Load shipping address from database. If shipto_id is set then it's
 
3231   # one from the customer's/vendor's master data. Otherwise look an a
 
3232   # customized address linking back to the current record.
 
3233   my $shipto_module = $self->{type} =~ /_delivery_order$/                                             ? 'DO'
 
3234                     : $self->{type} =~ /sales_order|sales_quotation|request_quotation|purchase_order/ ? 'OE'
 
3236   my $shipto        = $self->{shipto_id} ? SL::DB::Shipto->new(shipto_id => $self->{shipto_id})->load
 
3237                     :                      SL::DB::Manager::Shipto->get_first(where => [ module => $shipto_module, trans_id => $self->{id} ]);
 
3239     $self->{$_} = $shipto->$_ for grep { m{^shipto} } map { $_->name } @{ $shipto->meta->columns };
 
3240     $self->{"shiptocvar_" . $_->config->name} = $_->value_as_text for @{ $shipto->cvars_by_config };
 
3243   my $language = $self->{language} ? '_' . $self->{language} : '';
 
3245   my ($language_tc, $output_numberformat, $output_dateformat, $output_longdates);
 
3246   if ($self->{language_id}) {
 
3247     ($language_tc, $output_numberformat, $output_dateformat, $output_longdates) = AM->get_language_details(\%::myconfig, $self, $self->{language_id});
 
3250   $output_dateformat   ||= $::myconfig{dateformat};
 
3251   $output_numberformat ||= $::myconfig{numberformat};
 
3252   $output_longdates    //= 1;
 
3254   $self->{myconfig_output_dateformat}   = $output_dateformat   // $::myconfig{dateformat};
 
3255   $self->{myconfig_output_longdates}    = $output_longdates    // 1;
 
3256   $self->{myconfig_output_numberformat} = $output_numberformat // $::myconfig{numberformat};
 
3258   # Retrieve accounts for tax calculation.
 
3259   IC->retrieve_accounts(\%::myconfig, $self, map { $_ => $self->{"id_$_"} } 1 .. $self->{rowcount});
 
3261   if ($self->{type} =~ /_delivery_order$/) {
 
3262     DO->order_details(\%::myconfig, $self);
 
3263   } elsif ($self->{type} =~ /sales_order|sales_quotation|request_quotation|purchase_order/) {
 
3264     OE->order_details(\%::myconfig, $self);
 
3266     IS->invoice_details(\%::myconfig, $self, $::locale);
 
3269   # Chose extension & set source file name
 
3270   my $extension = 'html';
 
3271   if ($self->{format} eq 'postscript') {
 
3272     $self->{postscript}   = 1;
 
3274   } elsif ($self->{"format"} =~ /pdf/) {
 
3276     $extension            = $self->{'format'} =~ m/opendocument/i ? 'odt' : 'tex';
 
3277   } elsif ($self->{"format"} =~ /opendocument/) {
 
3278     $self->{opendocument} = 1;
 
3280   } elsif ($self->{"format"} =~ /excel/) {
 
3285   my $printer_code    = $self->{printer_code} ? '_' . $self->{printer_code} : '';
 
3286   my $email_extension = $self->{media} eq 'email' && -f ($defaults->templates . "/$self->{formname}_email${language}.${extension}") ? '_email' : '';
 
3287   $self->{IN}         = "$self->{formname}${email_extension}${language}${printer_code}.${extension}";
 
3290   $self->format_dates($output_dateformat, $output_longdates,
 
3291                       qw(invdate orddate quodate pldate duedate reqdate transdate shippingdate deliverydate validitydate paymentdate datepaid
 
3292                          transdate_oe deliverydate_oe employee_startdate employee_enddate),
 
3293                       grep({ /^(?:datepaid|transdate_oe|reqdate|deliverydate|deliverydate_oe|transdate)_\d+$/ } keys(%{$self})));
 
3295   $self->reformat_numbers($output_numberformat, 2,
 
3296                           qw(invtotal ordtotal quototal subtotal linetotal listprice sellprice netprice discount tax taxbase total paid),
 
3297                           grep({ /^(?:linetotal|listprice|sellprice|netprice|taxbase|discount|paid|subtotal|total|tax)_\d+$/ } keys(%{$self})));
 
3299   $self->reformat_numbers($output_numberformat, undef, qw(qty price_factor), grep({ /^qty_\d+$/} keys(%{$self})));
 
3301   my ($cvar_date_fields, $cvar_number_fields) = CVar->get_field_format_list('module' => 'CT', 'prefix' => 'vc_');
 
3303   if (scalar @{ $cvar_date_fields }) {
 
3304     $self->format_dates($output_dateformat, $output_longdates, @{ $cvar_date_fields });
 
3307   while (my ($precision, $field_list) = each %{ $cvar_number_fields }) {
 
3308     $self->reformat_numbers($output_numberformat, $precision, @{ $field_list });
 
3311   $self->{template_meta} = {
 
3312     formname  => $self->{formname},
 
3313     language  => SL::DB::Manager::Language->find_by_or_create(id => $self->{language_id} || undef),
 
3314     format    => $self->{format},
 
3315     media     => $self->{media},
 
3316     extension => $extension,
 
3317     printer   => SL::DB::Manager::Printer->find_by_or_create(id => $self->{printer_id} || undef),
 
3318     today     => DateTime->today,
 
3324 sub calculate_arap {
 
3325   my ($self,$buysell,$taxincluded,$exchangerate,$roundplaces) = @_;
 
3327   # this function is used to calculate netamount, total_tax and amount for AP and
 
3328   # AR transactions (Kreditoren-/Debitorenbuchungen) by going over all lines
 
3330   # Thus it needs a fully prepared $form to work on.
 
3331   # calculate_arap assumes $form->{amount_$i} entries still need to be parsed
 
3333   # The calculated total values are all rounded (default is to 2 places) and
 
3334   # returned as parameters rather than directly modifying form.  The aim is to
 
3335   # make the calculation of AP and AR behave identically.  There is a test-case
 
3336   # for this function in t/form/arap.t
 
3338   # While calculating the totals $form->{amount_$i} and $form->{tax_$i} are
 
3339   # modified and formatted and receive the correct sign for writing straight to
 
3340   # acc_trans, depending on whether they are ar or ap.
 
3343   die "taxincluded needed in Form->calculate_arap" unless defined $taxincluded;
 
3344   die "exchangerate needed in Form->calculate_arap" unless defined $exchangerate;
 
3345   die 'illegal buysell parameter, has to be \"buy\" or \"sell\" in Form->calculate_arap\n' unless $buysell =~ /^(buy|sell)$/;
 
3346   $roundplaces = 2 unless $roundplaces;
 
3348   my $sign = 1;  # adjust final results for writing amount to acc_trans
 
3349   $sign = -1 if $buysell eq 'buy';
 
3351   my ($netamount,$total_tax,$amount);
 
3355   # parse and round amounts, setting correct sign for writing to acc_trans
 
3356   for my $i (1 .. $self->{rowcount}) {
 
3357     $self->{"amount_$i"} = $self->round_amount($self->parse_amount(\%::myconfig, $self->{"amount_$i"}) * $exchangerate * $sign, $roundplaces);
 
3359     $amount += $self->{"amount_$i"} * $sign;
 
3362   for my $i (1 .. $self->{rowcount}) {
 
3363     next unless $self->{"amount_$i"};
 
3364     ($self->{"tax_id_$i"}) = split /--/, $self->{"taxchart_$i"};
 
3365     my $tax_id = $self->{"tax_id_$i"};
 
3367     my $selected_tax = SL::DB::Manager::Tax->find_by(id => "$tax_id");
 
3369     if ( $selected_tax ) {
 
3371       if ( $buysell eq 'sell' ) {
 
3372         $self->{AR_amounts}{"tax_$i"} = $selected_tax->chart->accno if defined $selected_tax->chart;
 
3374         $self->{AP_amounts}{"tax_$i"} = $selected_tax->chart->accno if defined $selected_tax->chart;
 
3377       $self->{"taxkey_$i"} = $selected_tax->taxkey;
 
3378       $self->{"taxrate_$i"} = $selected_tax->rate;
 
3381     ($self->{"amount_$i"}, $self->{"tax_$i"}) = $self->calculate_tax($self->{"amount_$i"},$self->{"taxrate_$i"},$taxincluded,$roundplaces);
 
3383     $netamount  += $self->{"amount_$i"};
 
3384     $total_tax  += $self->{"tax_$i"};
 
3387   $amount = $netamount + $total_tax;
 
3389   # due to $sign amount_$i und tax_$i already have the right sign for acc_trans
 
3390   # but reverse sign of totals for writing amounts to ar
 
3391   if ( $buysell eq 'buy' ) {
 
3397   return($netamount,$total_tax,$amount);
 
3401   my ($self, $dateformat, $longformat, @indices) = @_;
 
3403   $dateformat ||= $::myconfig{dateformat};
 
3405   foreach my $idx (@indices) {
 
3406     if ($self->{TEMPLATE_ARRAYS} && (ref($self->{TEMPLATE_ARRAYS}->{$idx}) eq "ARRAY")) {
 
3407       for (my $i = 0; $i < scalar(@{ $self->{TEMPLATE_ARRAYS}->{$idx} }); $i++) {
 
3408         $self->{TEMPLATE_ARRAYS}->{$idx}->[$i] = $::locale->reformat_date(\%::myconfig, $self->{TEMPLATE_ARRAYS}->{$idx}->[$i], $dateformat, $longformat);
 
3412     next unless defined $self->{$idx};
 
3414     if (!ref($self->{$idx})) {
 
3415       $self->{$idx} = $::locale->reformat_date(\%::myconfig, $self->{$idx}, $dateformat, $longformat);
 
3417     } elsif (ref($self->{$idx}) eq "ARRAY") {
 
3418       for (my $i = 0; $i < scalar(@{ $self->{$idx} }); $i++) {
 
3419         $self->{$idx}->[$i] = $::locale->reformat_date(\%::myconfig, $self->{$idx}->[$i], $dateformat, $longformat);
 
3425 sub reformat_numbers {
 
3426   my ($self, $numberformat, $places, @indices) = @_;
 
3428   return if !$numberformat || ($numberformat eq $::myconfig{numberformat});
 
3430   foreach my $idx (@indices) {
 
3431     if ($self->{TEMPLATE_ARRAYS} && (ref($self->{TEMPLATE_ARRAYS}->{$idx}) eq "ARRAY")) {
 
3432       for (my $i = 0; $i < scalar(@{ $self->{TEMPLATE_ARRAYS}->{$idx} }); $i++) {
 
3433         $self->{TEMPLATE_ARRAYS}->{$idx}->[$i] = $self->parse_amount(\%::myconfig, $self->{TEMPLATE_ARRAYS}->{$idx}->[$i]);
 
3437     next unless defined $self->{$idx};
 
3439     if (!ref($self->{$idx})) {
 
3440       $self->{$idx} = $self->parse_amount(\%::myconfig, $self->{$idx});
 
3442     } elsif (ref($self->{$idx}) eq "ARRAY") {
 
3443       for (my $i = 0; $i < scalar(@{ $self->{$idx} }); $i++) {
 
3444         $self->{$idx}->[$i] = $self->parse_amount(\%::myconfig, $self->{$idx}->[$i]);
 
3449   my $saved_numberformat    = $::myconfig{numberformat};
 
3450   $::myconfig{numberformat} = $numberformat;
 
3452   foreach my $idx (@indices) {
 
3453     if ($self->{TEMPLATE_ARRAYS} && (ref($self->{TEMPLATE_ARRAYS}->{$idx}) eq "ARRAY")) {
 
3454       for (my $i = 0; $i < scalar(@{ $self->{TEMPLATE_ARRAYS}->{$idx} }); $i++) {
 
3455         $self->{TEMPLATE_ARRAYS}->{$idx}->[$i] = $self->format_amount(\%::myconfig, $self->{TEMPLATE_ARRAYS}->{$idx}->[$i], $places);
 
3459     next unless defined $self->{$idx};
 
3461     if (!ref($self->{$idx})) {
 
3462       $self->{$idx} = $self->format_amount(\%::myconfig, $self->{$idx}, $places);
 
3464     } elsif (ref($self->{$idx}) eq "ARRAY") {
 
3465       for (my $i = 0; $i < scalar(@{ $self->{$idx} }); $i++) {
 
3466         $self->{$idx}->[$i] = $self->format_amount(\%::myconfig, $self->{$idx}->[$i], $places);
 
3471   $::myconfig{numberformat} = $saved_numberformat;
 
3474 sub create_email_signature {
 
3476   my $client_signature = $::instance_conf->get_signature;
 
3477   my $user_signature   = $::myconfig{signature};
 
3480   if ( $client_signature or $user_signature ) {
 
3481     $signature  = "\n\n-- \n";
 
3482     $signature .= $user_signature   . "\n" if $user_signature;
 
3483     $signature .= $client_signature . "\n" if $client_signature;
 
3491   $::lxdebug->enter_sub;
 
3493   my %style_to_script_map = (
 
3498   my $menu_script = $style_to_script_map{$::myconfig{menustyle}} || '';
 
3501   require "bin/mozilla/menu$menu_script.pl";
 
3503   require SL::Controller::FrameHeader;
 
3506   my $layout = SL::Controller::FrameHeader->new->action_header . ::render();
 
3508   $::lxdebug->leave_sub;
 
3513   # this function calculates the net amount and tax for the lines in ar, ap and
 
3514   # gl and is used for update as well as post. When used with update the return
 
3515   # value of amount isn't needed
 
3517   # calculate_tax should always work with positive values, or rather as the user inputs them
 
3518   # calculate_tax uses db/perl numberformat, i.e. parsed numbers
 
3519   # convert to negative numbers (when necessary) only when writing to acc_trans
 
3520   # the amount from $form for ap/ar/gl is currently always rounded to 2 decimals before it reaches here
 
3521   # for post_transaction amount already contains exchangerate and correct sign and is rounded
 
3522   # calculate_tax doesn't (need to) know anything about exchangerate
 
3524   my ($self,$amount,$taxrate,$taxincluded,$roundplaces) = @_;
 
3532     # calculate tax (unrounded), subtract from amount, round amount and round tax
 
3533     $tax       = $amount - ($amount / ($taxrate + 1)); # equivalent to: taxrate * amount / (taxrate + 1)
 
3534     $amount    = $self->round_amount($amount - $tax, $roundplaces);
 
3535     $tax       = $self->round_amount($tax, $roundplaces);
 
3537     $tax       = $amount * $taxrate;
 
3538     $tax       = $self->round_amount($tax, $roundplaces);
 
3541   $tax = 0 unless $tax;
 
3543   return ($amount,$tax);
 
3552 SL::Form.pm - main data object.
 
3556 This is the main data object of kivitendo.
 
3557 Unfortunately it also acts as a god object for certain data retrieval procedures used in the entry points.
 
3558 Points of interest for a beginner are:
 
3560  - $form->error            - renders a generic error in html. accepts an error message
 
3561  - $form->get_standard_dbh - returns a database connection for the
 
3563 =head1 SPECIAL FUNCTIONS
 
3565 =head2 C<redirect_header> $url
 
3567 Generates a HTTP redirection header for the new C<$url>. Constructs an
 
3568 absolute URL including scheme, host name and port. If C<$url> is a
 
3569 relative URL then it is considered relative to kivitendo base URL.
 
3571 This function C<die>s if headers have already been created with
 
3572 C<$::form-E<gt>header>.
 
3576   print $::form->redirect_header('oe.pl?action=edit&id=1234');
 
3577   print $::form->redirect_header('http://www.lx-office.org/');
 
3581 Generates a general purpose http/html header and includes most of the scripts
 
3582 and stylesheets needed. Stylesheets can be added with L<use_stylesheet>.
 
3584 Only one header will be generated. If the method was already called in this
 
3585 request it will not output anything and return undef. Also if no
 
3586 HTTP_USER_AGENT is found, no header is generated.
 
3588 Although header does not accept parameters itself, it will honor special
 
3589 hashkeys of its Form instance:
 
3597 If one of these is set, a http-equiv refresh is generated. Missing parameters
 
3598 default to 3 seconds and the refering url.
 
3602 Either a scalar or an array ref. Will be inlined into the header. Add
 
3603 stylesheets with the L<use_stylesheet> function.
 
3607 If true, a css snippet will be generated that sets the page in landscape mode.
 
3611 Used to override the default favicon.
 
3615 A html page title will be generated from this
 
3617 =item mtime_ischanged
 
3619 Tries to avoid concurrent write operations to records by checking the database mtime with a fetched one.
 
3621 Can be used / called with any table, that has itime and mtime attributes.
 
3622 Valid C<table> names are: oe, ar, ap, delivery_orders, parts.
 
3623 Can be called wit C<option> mail to generate a different error message.
 
3625 Returns undef if no save operation has been done yet ($self->{id} not present).
 
3626 Returns undef if no concurrent write process is detected otherwise a error message.