SL/Controller/Order.pm

   1 package SL::Controller::Order;
   2
   3 use strict;
   4 use parent qw(SL::Controller::Base);
   5
   6 use SL::Helper::Flash qw(flash_later);
   7 use SL::Presenter;
   8 use SL::Locale::String qw(t8);
   9 use SL::SessionFile::Random;
  10 use SL::PriceSource;
  11 use SL::Webdav;
  12
  13 use SL::DB::Order;
  14 use SL::DB::Default;
  15 use SL::DB::Unit;
  16 use SL::DB::Part;
  17 use SL::DB::Printer;
  18 use SL::DB::Language;
  19
  20 use SL::Helper::CreatePDF qw(:all);
  21 use SL::Helper::PrintOptions;
  22
  23 use SL::Controller::Helper::GetModels;
  24
  25 use List::Util qw(first);
  26 use List::MoreUtils qw(none pairwise first_index);
  27 use English qw(-no_match_vars);
  28 use File::Spec;
  29
  30 use Rose::Object::MakeMethods::Generic
  31 (
  32  scalar => [ qw(item_ids_to_delete) ],
  33  'scalar --get_set_init' => [ qw(order valid_types type cv p multi_items_models all_price_factors) ],
  34 );
  35
  36
  37 # safety
  38 __PACKAGE__->run_before('_check_auth');
  39
  40 __PACKAGE__->run_before('_recalc',
  41                         only => [ qw(save save_and_delivery_order print create_pdf send_email) ]);
  42
  43 __PACKAGE__->run_before('_get_unalterable_data',
  44                         only => [ qw(save save_and_delivery_order print create_pdf send_email) ]);
  45
  46 #
  47 # actions
  48 #
  49
  50 # add a new order
  51 sub action_add {
  52   my ($self) = @_;
  53
  54   $self->order->transdate(DateTime->now_local());
  55   $self->order->reqdate(DateTime->today_local->next_workday) if !$self->order->reqdate;
  56
  57   $self->_pre_render();
  58   $self->render(
  59     'order/form',
  60     title => $self->type eq _sales_order_type()    ? $::locale->text('Add Sales Order')
  61            : $self->type eq _purchase_order_type() ? $::locale->text('Add Purchase Order')
  62            : '',
  63     %{$self->{template_args}}
  64   );
  65 }
  66
  67 # edit an existing order
  68 sub action_edit {
  69   my ($self) = @_;
  70
  71   $self->_load_order;
  72   $self->_recalc();
  73   $self->_pre_render();
  74   $self->render(
  75     'order/form',
  76     title => $self->type eq _sales_order_type()    ? $::locale->text('Edit Sales Order')
  77            : $self->type eq _purchase_order_type() ? $::locale->text('Edit Purchase Order')
  78            : '',
  79     %{$self->{template_args}}
  80   );
  81 }
  82
  83 # delete the order
  84 sub action_delete {
  85   my ($self) = @_;
  86
  87   my $errors = $self->_delete();
  88
  89   if (scalar @{ $errors }) {
  90     $self->js->flash('error', $_) foreach @{ $errors };
  91     return $self->js->render();
  92   }
  93
  94   flash_later('info', $::locale->text('The order has been deleted'));
  95   my @redirect_params = (
  96     action => 'add',
  97     type   => $self->type,
  98   );
  99
 100   $self->redirect_to(@redirect_params);
 101 }
 102
 103 # save the order
 104 sub action_save {
 105   my ($self) = @_;
 106
 107   my $errors = $self->_save();
 108
 109   if (scalar @{ $errors }) {
 110     $self->js->flash('error', $_) foreach @{ $errors };
 111     return $self->js->render();
 112   }
 113
 114   flash_later('info', $::locale->text('The order has been saved'));
 115   my @redirect_params = (
 116     action => 'edit',
 117     type   => $self->type,
 118     id     => $self->order->id,
 119   );
 120
 121   $self->redirect_to(@redirect_params);
 122 }
 123
 124 # print the order
 125 #
 126 # This is called if "print" is pressed in the print dialog.
 127 # If PDF creation was requested and succeeded, the pdf is stored in a session
 128 # file and the filename is stored as session value with an unique key. A
 129 # javascript function with this key is then called. This function calls the
 130 # download action below (action_download_pdf), which offers the file for
 131 # download.
 132 sub action_print {
 133   my ($self) = @_;
 134
 135   my $format      = $::form->{print_options}->{format};
 136   my $media       = $::form->{print_options}->{media};
 137   my $formname    = $::form->{print_options}->{formname};
 138   my $copies      = $::form->{print_options}->{copies};
 139   my $groupitems  = $::form->{print_options}->{groupitems};
 140
 141   # only pdf by now
 142   if (none { $format eq $_ } qw(pdf)) {
 143     return $self->js->flash('error', t8('Format \'#1\' is not supported yet/anymore.', $format))->render;
 144   }
 145
 146   # only screen or printer by now
 147   if (none { $media eq $_ } qw(screen printer)) {
 148     return $self->js->flash('error', t8('Media \'#1\' is not supported yet/anymore.', $media))->render;
 149   }
 150
 151   my $language;
 152   $language = SL::DB::Language->new(id => $::form->{print_options}->{language_id})->load if $::form->{print_options}->{language_id};
 153
 154   my $form = Form->new;
 155   $form->{ordnumber} = $self->order->ordnumber;
 156   $form->{type}      = $self->type;
 157   $form->{format}    = $format;
 158   $form->{formname}  = $formname;
 159   $form->{language}  = '_' . $language->template_code if $language;
 160   my $pdf_filename   = $form->generate_attachment_filename();
 161
 162   my $pdf;
 163   my @errors = _create_pdf($self->order, \$pdf, { format     => $format,
 164                                                   formname   => $formname,
 165                                                   language   => $language,
 166                                                   groupitems => $groupitems });
 167   if (scalar @errors) {
 168     return $self->js->flash('error', t8('Conversion to PDF failed: #1', $errors[0]))->render;
 169   }
 170
 171   if ($media eq 'screen') {
 172     # screen/download
 173     my $sfile = SL::SessionFile::Random->new(mode => "w");
 174     $sfile->fh->print($pdf);
 175     $sfile->fh->close;
 176
 177     my $key = join('_', Time::HiRes::gettimeofday(), int rand 1000000000000);
 178     $::auth->set_session_value("Order::create_pdf-${key}" => $sfile->file_name);
 179
 180     $self->js
 181     ->run('kivi.Order.download_pdf', $pdf_filename, $key)
 182     ->flash('info', t8('The PDF has been created'));
 183
 184   } elsif ($media eq 'printer') {
 185     # printer
 186     my $printer_id = $::form->{print_options}->{printer_id};
 187     SL::DB::Printer->new(id => $printer_id)->load->print_document(
 188       copies  => $copies,
 189       content => $pdf,
 190     );
 191
 192     $self->js->flash('info', t8('The PDF has been printed'));
 193   }
 194
 195   # copy file to webdav folder
 196   if ($self->order->ordnumber && $::instance_conf->get_webdav_documents) {
 197     my $webdav = SL::Webdav->new(
 198       type     => $self->type,
 199       number   => $self->order->ordnumber,
 200     );
 201     my $webdav_file = SL::Webdav::File->new(
 202       webdav   => $webdav,
 203       filename => $pdf_filename,
 204     );
 205     eval {
 206       $webdav_file->store(data => \$pdf);
 207       1;
 208     } or do {
 209       $self->js->flash('error', t8('Storing PDF to webdav folder failed: #1', $@));
 210     }
 211   }
 212
 213   $self->js->render;
 214 }
 215
 216 # offer pdf for download
 217 #
 218 # It needs to get the key for the session value to get the pdf file.
 219 sub action_download_pdf {
 220   my ($self) = @_;
 221
 222   my $key = $::form->{key};
 223   my $tmp_filename = $::auth->get_session_value("Order::create_pdf-${key}");
 224   return $self->send_file(
 225     $tmp_filename,
 226     type => 'application/pdf',
 227     name => $::form->{pdf_filename},
 228   );
 229 }
 230
 231 # open the email dialog
 232 sub action_show_email_dialog {
 233   my ($self) = @_;
 234
 235   my $cv_method = $self->cv;
 236
 237   if (!$self->order->$cv_method) {
 238     return $self->js->flash('error', $self->cv eq 'customer' ? t8('Cannot send E-mail without customer given') : t8('Cannot send E-mail without vendor given'))
 239                     ->render($self);
 240   }
 241
 242   $self->{email}->{to}   = $self->order->contact->cp_email if $self->order->contact;
 243   $self->{email}->{to} ||= $self->order->$cv_method->email;
 244   $self->{email}->{cc}   = $self->order->$cv_method->cc;
 245   $self->{email}->{bcc}  = join ', ', grep $_, $self->order->$cv_method->bcc, SL::DB::Default->get->global_bcc;
 246   # Todo: get addresses from shipto, if any
 247
 248   my $form = Form->new;
 249   $form->{ordnumber} = $self->order->ordnumber;
 250   $form->{formname}  = $self->type;
 251   $form->{type}      = $self->type;
 252   $form->{language} = 'de';
 253   $form->{format}   = 'pdf';
 254
 255   $self->{email}->{subject}             = $form->generate_email_subject();
 256   $self->{email}->{attachment_filename} = $form->generate_attachment_filename();
 257   $self->{email}->{message}             = $form->create_email_signature();
 258
 259   my $dialog_html = $self->render('order/tabs/_email_dialog', { output => 0 });
 260   $self->js
 261       ->run('kivi.Order.show_email_dialog', $dialog_html)
 262       ->reinit_widgets
 263       ->render($self);
 264 }
 265
 266 # send email
 267 #
 268 # Todo: handling error messages: flash is not displayed in dialog, but in the main form
 269 sub action_send_email {
 270   my ($self) = @_;
 271
 272   my $mail      = Mailer->new;
 273   $mail->{from} = qq|"$::myconfig{name}" <$::myconfig{email}>|;
 274   $mail->{$_}   = $::form->{email}->{$_} for qw(to cc bcc subject message);
 275
 276   my $pdf;
 277   my @errors = _create_pdf($self->order, \$pdf, {media => 'email'});
 278   if (scalar @errors) {
 279     return $self->js->flash('error', t8('Conversion to PDF failed: #1', $errors[0]))->render($self);
 280   }
 281
 282   $mail->{attachments} = [{ "content" => $pdf,
 283                             "name"    => $::form->{email}->{attachment_filename} }];
 284
 285   if (my $err = $mail->send) {
 286     return $self->js->flash('error', t8('Sending E-mail: ') . $err)
 287                     ->render($self);
 288   }
 289
 290   # internal notes
 291   my $intnotes = $self->order->intnotes;
 292   $intnotes   .= "\n\n" if $self->order->intnotes;
 293   $intnotes   .= t8('[email]')                                                                                        . "\n";
 294   $intnotes   .= t8('Date')       . ": " . $::locale->format_date_object(DateTime->now_local, precision => 'seconds') . "\n";
 295   $intnotes   .= t8('To (email)') . ": " . $mail->{to}                                                                . "\n";
 296   $intnotes   .= t8('Cc')         . ": " . $mail->{cc}                                                                . "\n"    if $mail->{cc};
 297   $intnotes   .= t8('Bcc')        . ": " . $mail->{bcc}                                                               . "\n"    if $mail->{bcc};
 298   $intnotes   .= t8('Subject')    . ": " . $mail->{subject}                                                           . "\n\n";
 299   $intnotes   .= t8('Message')    . ": " . $mail->{message};
 300
 301   $self->js
 302       ->val('#order_intnotes', $intnotes)
 303       ->run('kivi.Order.close_email_dialog')
 304       ->render($self);
 305 }
 306
 307 # save the order and redirect to the frontend subroutine for a new
 308 # delivery order
 309 sub action_save_and_delivery_order {
 310   my ($self) = @_;
 311
 312   my $errors = $self->_save();
 313
 314   if (scalar @{ $errors }) {
 315     $self->js->flash('error', $_) foreach @{ $errors };
 316     return $self->js->render();
 317   }
 318   flash_later('info', $::locale->text('The order has been saved'));
 319
 320   my @redirect_params = (
 321     controller => 'oe.pl',
 322     action     => 'oe_delivery_order_from_order',
 323     id         => $self->order->id,
 324   );
 325
 326   $self->redirect_to(@redirect_params);
 327 }
 328
 329 # set form elements in respect to a changed customer or vendor
 330 #
 331 # This action is called on an change of the customer/vendor picker.
 332 sub action_customer_vendor_changed {
 333   my ($self) = @_;
 334
 335   my $cv_method = $self->cv;
 336
 337   if ($self->order->$cv_method->contacts && scalar @{ $self->order->$cv_method->contacts } > 0) {
 338     $self->js->show('#cp_row');
 339   } else {
 340     $self->js->hide('#cp_row');
 341   }
 342
 343   if ($self->order->$cv_method->shipto && scalar @{ $self->order->$cv_method->shipto } > 0) {
 344     $self->js->show('#shipto_row');
 345   } else {
 346     $self->js->hide('#shipto_row');
 347   }
 348
 349   $self->order->taxzone_id($self->order->$cv_method->taxzone_id);
 350
 351   if ($self->order->is_sales) {
 352     $self->order->taxincluded(defined($self->order->$cv_method->taxincluded_checked)
 353                               ? $self->order->$cv_method->taxincluded_checked
 354                               : $::myconfig{taxincluded_checked});
 355   }
 356
 357   $self->order->payment_id($self->order->$cv_method->payment_id);
 358   $self->order->delivery_term_id($self->order->$cv_method->delivery_term_id);
 359
 360   $self->_recalc();
 361
 362   $self->js
 363     ->replaceWith('#order_cp_id',            $self->build_contact_select)
 364     ->replaceWith('#order_shipto_id',        $self->build_shipto_select)
 365     ->val(        '#order_taxzone_id',       $self->order->taxzone_id)
 366     ->val(        '#order_taxincluded',      $self->order->taxincluded)
 367     ->val(        '#order_payment_id',       $self->order->payment_id)
 368     ->val(        '#order_delivery_term_id', $self->order->delivery_term_id)
 369     ->val(        '#order_intnotes',         $self->order->$cv_method->notes)
 370     ->focus(      '#order_' . $self->cv . '_id');
 371
 372   $self->_js_redisplay_amounts_and_taxes;
 373   $self->js->render();
 374 }
 375
 376 # called if a unit in an existing item row is changed
 377 sub action_unit_changed {
 378   my ($self) = @_;
 379
 380   my $idx  = first_index { $_ eq $::form->{item_id} } @{ $::form->{orderitem_ids} };
 381   my $item = $self->order->items_sorted->[$idx];
 382
 383   my $old_unit_obj = SL::DB::Unit->new(name => $::form->{old_unit})->load;
 384   $item->sellprice($item->unit_obj->convert_to($item->sellprice, $old_unit_obj));
 385
 386   $self->_recalc();
 387
 388   $self->js
 389     ->run('kivi.Order.update_sellprice', $::form->{item_id}, $item->sellprice_as_number);
 390   $self->_js_redisplay_line_values;
 391   $self->_js_redisplay_amounts_and_taxes;
 392   $self->js->render();
 393 }
 394
 395 # add an item row for a new item entered in the input row
 396 sub action_add_item {
 397   my ($self) = @_;
 398
 399   my $form_attr = $::form->{add_item};
 400
 401   return unless $form_attr->{parts_id};
 402
 403   my $item = _new_item($self->order, $form_attr);
 404
 405   $self->order->add_items($item);
 406
 407   $self->_recalc();
 408
 409   my $item_id = join('_', 'new', Time::HiRes::gettimeofday(), int rand 1000000000000);
 410   my $row_as_html = $self->p->render('order/tabs/_row',
 411                                      ITEM              => $item,
 412                                      ID                => $item_id,
 413                                      ALL_PRICE_FACTORS => $self->all_price_factors
 414   );
 415
 416   $self->js
 417     ->append('#row_table_id', $row_as_html);
 418
 419   if ( $item->part->is_assortment ) {
 420     $form_attr->{qty_as_number} = 1 unless $form_attr->{qty_as_number};
 421     foreach my $assortment_item ( @{$item->part->assortment_items} ) {
 422       my $attr = { parts_id => $assortment_item->parts_id,
 423                    qty      => $assortment_item->qty * $::form->parse_amount(\%::myconfig, $form_attr->{qty_as_number}), # TODO $form_attr->{unit}
 424                    unit     => $assortment_item->unit,
 425                    description => $assortment_item->part->description,
 426                  };
 427       my $item = _new_item($self->order, $attr);
 428
 429       # set discount to 100% if item isn't supposed to be charged, overwriting any customer discount
 430       $item->discount(1) unless $assortment_item->charge;
 431
 432       $self->order->add_items( $item );
 433       $self->_recalc();
 434       my $item_id = join('_', 'new', Time::HiRes::gettimeofday(), int rand 1000000000000);
 435       my $row_as_html = $self->p->render('order/tabs/_row',
 436                                          ITEM              => $item,
 437                                          ID                => $item_id,
 438                                          ALL_PRICE_FACTORS => $self->all_price_factors
 439       );
 440       $self->js
 441         ->append('#row_table_id', $row_as_html);
 442     };
 443   };
 444
 445   $self->js
 446     ->val('.add_item_input', '')
 447     ->run('kivi.Order.init_row_handlers')
 448     ->run('kivi.Order.row_table_scroll_down')
 449     ->run('kivi.Order.renumber_positions')
 450     ->focus('#add_item_parts_id_name');
 451
 452   $self->_js_redisplay_amounts_and_taxes;
 453   $self->js->render();
 454 }
 455
 456 # open the dialog for entering multiple items at once
 457 sub action_show_multi_items_dialog {
 458   require SL::DB::PartsGroup;
 459   $_[0]->render('order/tabs/_multi_items_dialog', { layout => 0 },
 460                 all_partsgroups => SL::DB::Manager::PartsGroup->get_all);
 461 }
 462
 463 # update the filter results in the multi item dialog
 464 sub action_multi_items_update_result {
 465   my $max_count = 100;
 466
 467   $::form->{multi_items}->{filter}->{obsolete} = 0;
 468
 469   my $count = $_[0]->multi_items_models->count;
 470
 471   if ($count == 0) {
 472     my $text = SL::Presenter::EscapedText->new(text => $::locale->text('No results.'));
 473     $_[0]->render($text, { layout => 0 });
 474   } elsif ($count > $max_count) {
 475     my $text = SL::Presenter::EscapedText->new(text => $::locale->text('Too many results (#1 from #2).', $count, $max_count));
 476     $_[0]->render($text, { layout => 0 });
 477   } else {
 478     my $multi_items = $_[0]->multi_items_models->get;
 479     $_[0]->render('order/tabs/_multi_items_result', { layout => 0 },
 480                   multi_items => $multi_items);
 481   }
 482 }
 483
 484 # add item rows for multiple items at once
 485 sub action_add_multi_items {
 486   my ($self) = @_;
 487
 488   my @form_attr = grep { $_->{qty_as_number} } @{ $::form->{add_multi_items} };
 489   return $self->js->render() unless scalar @form_attr;
 490
 491   my @items;
 492   foreach my $attr (@form_attr) {
 493     my $item = _new_item($self->order, $attr);
 494     push @items, $item;
 495     if ( $item->part->is_assortment ) {
 496       foreach my $assortment_item ( @{$item->part->assortment_items} ) {
 497         my $attr = { parts_id => $assortment_item->parts_id,
 498                      qty      => $assortment_item->qty * $item->qty, # TODO $form_attr->{unit}
 499                      unit     => $assortment_item->unit,
 500                      description => $assortment_item->part->description,
 501                    };
 502         my $item = _new_item($self->order, $attr);
 503
 504         # set discount to 100% if item isn't supposed to be charged, overwriting any customer discount
 505         $item->discount(1) unless $assortment_item->charge;
 506         push @items, $assortment_item;
 507       }
 508     }
 509   }
 510   $self->order->add_items(@items);
 511
 512   $self->_recalc();
 513
 514   foreach my $item (@items) {
 515     my $item_id = join('_', 'new', Time::HiRes::gettimeofday(), int rand 1000000000000);
 516     my $row_as_html = $self->p->render('order/tabs/_row',
 517                                        ITEM              => $item,
 518                                        ID                => $item_id,
 519                                        ALL_PRICE_FACTORS => $self->all_price_factors
 520     );
 521
 522     $self->js->append('#row_table_id', $row_as_html);
 523   }
 524
 525   $self->js
 526     ->run('kivi.Order.close_multi_items_dialog')
 527     ->run('kivi.Order.init_row_handlers')
 528     ->run('kivi.Order.row_table_scroll_down')
 529     ->run('kivi.Order.renumber_positions')
 530     ->focus('#add_item_parts_id_name');
 531
 532   $self->_js_redisplay_amounts_and_taxes;
 533   $self->js->render();
 534 }
 535
 536 # recalculate all linetotals, amounts and taxes and redisplay them
 537 sub action_recalc_amounts_and_taxes {
 538   my ($self) = @_;
 539
 540   $self->_recalc();
 541
 542   $self->_js_redisplay_line_values;
 543   $self->_js_redisplay_amounts_and_taxes;
 544   $self->js->render();
 545 }
 546
 547 # redisplay item rows if they are sorted by an attribute
 548 sub action_reorder_items {
 549   my ($self) = @_;
 550
 551   my %sort_keys = (
 552     partnumber  => sub { $_[0]->part->partnumber },
 553     description => sub { $_[0]->description },
 554     qty         => sub { $_[0]->qty },
 555     sellprice   => sub { $_[0]->sellprice },
 556     discount    => sub { $_[0]->discount },
 557   );
 558
 559   my $method = $sort_keys{$::form->{order_by}};
 560   my @to_sort = map { { old_pos => $_->position, order_by => $method->($_) } } @{ $self->order->items_sorted };
 561   if ($::form->{sort_dir}) {
 562     @to_sort = sort { $a->{order_by} cmp $b->{order_by} } @to_sort;
 563   } else {
 564     @to_sort = sort { $b->{order_by} cmp $a->{order_by} } @to_sort;
 565   }
 566   $self->js
 567     ->run('kivi.Order.redisplay_items', \@to_sort)
 568     ->render;
 569 }
 570
 571 # show the popup to choose a price/discount source
 572 sub action_price_popup {
 573   my ($self) = @_;
 574
 575   my $idx  = first_index { $_ eq $::form->{item_id} } @{ $::form->{orderitem_ids} };
 576   my $item = $self->order->items_sorted->[$idx];
 577
 578   $self->render_price_dialog($item);
 579 }
 580
 581 # get the longdescription for an item if the dialog to enter/change the
 582 # longdescription was opened and the longdescription is empty
 583 #
 584 # If this item is new, get the longdescription from Part.
 585 # Otherwise get it from OrderItem.
 586 sub action_get_item_longdescription {
 587   my $longdescription;
 588
 589   if ($::form->{item_id}) {
 590     $longdescription = SL::DB::OrderItem->new(id => $::form->{item_id})->load->longdescription;
 591   } elsif ($::form->{parts_id}) {
 592     $longdescription = SL::DB::Part->new(id => $::form->{parts_id})->load->notes;
 593   }
 594   $_[0]->render(\ $longdescription, { type => 'text' });
 595 }
 596
 597 # load the second row for one or more items
 598 #
 599 # This action gets the html code for all items second rows by rendering a template for
 600 # the second row and sets the html code via client js.
 601 sub action_load_second_rows {
 602   my ($self) = @_;
 603
 604   $self->_recalc() if $self->order->is_sales; # for margin calculation
 605
 606   foreach my $item_id (@{ $::form->{item_ids} }) {
 607     my $idx  = first_index { $_ eq $item_id } @{ $::form->{orderitem_ids} };
 608     my $item = $self->order->items_sorted->[$idx];
 609
 610     $self->_js_load_second_row($item, $item_id, 0);
 611   }
 612
 613   $self->js->run('kivi.Order.init_row_handlers') if $self->order->is_sales; # for lastcosts change-callback
 614
 615   $self->js->render();
 616 }
 617
 618 sub _js_load_second_row {
 619   my ($self, $item, $item_id, $do_parse) = @_;
 620
 621   if ($do_parse) {
 622     # Parse values from form (they are formated while rendering (template)).
 623     # Workaround to pre-parse number-cvars (parse_custom_variable_values does not parse number values).
 624     # This parsing is not necessary at all, if we assure that the second row/cvars are only loaded once.
 625     foreach my $var (@{ $item->cvars_by_config }) {
 626       $var->unparsed_value($::form->parse_amount(\%::myconfig, $var->{__unparsed_value})) if ($var->config->type eq 'number' && exists($var->{__unparsed_value}));
 627     }
 628     $item->parse_custom_variable_values;
 629   }
 630
 631   my $row_as_html = $self->p->render('order/tabs/_second_row', ITEM => $item);
 632
 633   $self->js
 634     ->html('.row_entry:has(#item_' . $item_id . ') [name = "second_row"]', $row_as_html)
 635     ->data('.row_entry:has(#item_' . $item_id . ') [name = "second_row"]', 'loaded', 1);
 636 }
 637
 638 sub _js_redisplay_line_values {
 639   my ($self) = @_;
 640
 641   my $is_sales = $self->order->is_sales;
 642
 643   # sales orders with margins
 644   my @data;
 645   if ($is_sales) {
 646     @data = map {
 647       [
 648        $::form->format_amount(\%::myconfig, $_->{linetotal},     2, 0),
 649        $::form->format_amount(\%::myconfig, $_->{marge_total},   2, 0),
 650        $::form->format_amount(\%::myconfig, $_->{marge_percent}, 2, 0),
 651       ]} @{ $self->order->items_sorted };
 652   } else {
 653     @data = map {
 654       [
 655        $::form->format_amount(\%::myconfig, $_->{linetotal},     2, 0),
 656       ]} @{ $self->order->items_sorted };
 657   }
 658
 659   $self->js
 660     ->run('kivi.Order.redisplay_line_values', $is_sales, \@data);
 661 }
 662
 663 sub _js_redisplay_amounts_and_taxes {
 664   my ($self) = @_;
 665
 666   if (scalar @{ $self->{taxes} }) {
 667     $self->js->show('#taxincluded_row_id');
 668   } else {
 669     $self->js->hide('#taxincluded_row_id');
 670   }
 671
 672   if ($self->order->taxincluded) {
 673     $self->js->hide('#subtotal_row_id');
 674   } else {
 675     $self->js->show('#subtotal_row_id');
 676   }
 677
 678   $self->js
 679     ->html('#netamount_id', $::form->format_amount(\%::myconfig, $self->order->netamount, -2))
 680     ->html('#amount_id',    $::form->format_amount(\%::myconfig, $self->order->amount,    -2))
 681     ->remove('.tax_row')
 682     ->insertBefore($self->build_tax_rows, '#amount_row_id');
 683 }
 684
 685 #
 686 # helpers
 687 #
 688
 689 sub init_valid_types {
 690   [ _sales_order_type(), _purchase_order_type() ];
 691 }
 692
 693 sub init_type {
 694   my ($self) = @_;
 695
 696   if (none { $::form->{type} eq $_ } @{$self->valid_types}) {
 697     die "Not a valid type for order";
 698   }
 699
 700   $self->type($::form->{type});
 701 }
 702
 703 sub init_cv {
 704   my ($self) = @_;
 705
 706   my $cv = $self->type eq _sales_order_type()    ? 'customer'
 707          : $self->type eq _purchase_order_type() ? 'vendor'
 708          : die "Not a valid type for order";
 709
 710   return $cv;
 711 }
 712
 713 sub init_p {
 714   SL::Presenter->get;
 715 }
 716
 717 sub init_order {
 718   $_[0]->_make_order;
 719 }
 720
 721 # model used to filter/display the parts in the multi-items dialog
 722 sub init_multi_items_models {
 723   SL::Controller::Helper::GetModels->new(
 724     controller     => $_[0],
 725     model          => 'Part',
 726     with_objects   => [ qw(unit_obj) ],
 727     disable_plugin => 'paginated',
 728     source         => $::form->{multi_items},
 729     sorted         => {
 730       _default    => {
 731         by  => 'partnumber',
 732         dir => 1,
 733       },
 734       partnumber  => t8('Partnumber'),
 735       description => t8('Description')}
 736   );
 737 }
 738
 739 sub init_all_price_factors {
 740   SL::DB::Manager::PriceFactor->get_all;
 741 }
 742
 743 sub _check_auth {
 744   my ($self) = @_;
 745
 746   my $right_for = { map { $_ => $_.'_edit' } @{$self->valid_types} };
 747
 748   my $right   = $right_for->{ $self->type };
 749   $right    ||= 'DOES_NOT_EXIST';
 750
 751   $::auth->assert($right);
 752 }
 753
 754 # build the selection box for contacts
 755 #
 756 # Needed, if customer/vendor changed.
 757 sub build_contact_select {
 758   my ($self) = @_;
 759
 760   $self->p->select_tag('order.cp_id', [ $self->order->{$self->cv}->contacts ],
 761                        value_key  => 'cp_id',
 762                        title_key  => 'full_name_dep',
 763                        default    => $self->order->cp_id,
 764                        with_empty => 1,
 765                        style      => 'width: 300px',
 766   );
 767 }
 768
 769 # build the selection box for shiptos
 770 #
 771 # Needed, if customer/vendor changed.
 772 sub build_shipto_select {
 773   my ($self) = @_;
 774
 775   $self->p->select_tag('order.shipto_id', [ $self->order->{$self->cv}->shipto ],
 776                        value_key  => 'shipto_id',
 777                        title_key  => 'displayable_id',
 778                        default    => $self->order->shipto_id,
 779                        with_empty => 1,
 780                        style      => 'width: 300px',
 781   );
 782 }
 783
 784 # build the rows for displaying taxes
 785 #
 786 # Called if amounts where recalculated and redisplayed.
 787 sub build_tax_rows {
 788   my ($self) = @_;
 789
 790   my $rows_as_html;
 791   foreach my $tax (sort { $a->{tax}->rate cmp $b->{tax}->rate } @{ $self->{taxes} }) {
 792     $rows_as_html .= $self->p->render('order/tabs/_tax_row', TAX => $tax, TAXINCLUDED => $self->order->taxincluded);
 793   }
 794   return $rows_as_html;
 795 }
 796
 797
 798 sub render_price_dialog {
 799   my ($self, $record_item) = @_;
 800
 801   my $price_source = SL::PriceSource->new(record_item => $record_item, record => $self->order);
 802
 803   $self->js
 804     ->run(
 805       'kivi.io.price_chooser_dialog',
 806       t8('Available Prices'),
 807       $self->render('order/tabs/_price_sources_dialog', { output => 0 }, price_source => $price_source)
 808     )
 809     ->reinit_widgets;
 810
 811 #   if (@errors) {
 812 #     $self->js->text('#dialog_flash_error_content', join ' ', @errors);
 813 #     $self->js->show('#dialog_flash_error');
 814 #   }
 815
 816   $self->js->render;
 817 }
 818
 819 sub _load_order {
 820   my ($self) = @_;
 821
 822   return if !$::form->{id};
 823
 824   $self->order(SL::DB::Manager::Order->find_by(id => $::form->{id}));
 825 }
 826
 827 # load or create a new order object
 828 #
 829 # And assign changes from the for to this object.
 830 # If the order is loaded from db, check if items are deleted in the form,
 831 # remove them form the object and collect them for removing from db on saving.
 832 # Then create/update items from form (via _make_item) and add them.
 833 sub _make_order {
 834   my ($self) = @_;
 835
 836   # add_items adds items to an order with no items for saving, but they cannot
 837   # be retrieved via items until the order is saved. Adding empty items to new
 838   # order here solves this problem.
 839   my $order;
 840   $order   = SL::DB::Manager::Order->find_by(id => $::form->{id}) if $::form->{id};
 841   $order ||= SL::DB::Order->new(orderitems => []);
 842
 843   my $form_orderitems = delete $::form->{order}->{orderitems};
 844   $order->assign_attributes(%{$::form->{order}});
 845
 846   # remove deleted items
 847   $self->item_ids_to_delete([]);
 848   foreach my $idx (reverse 0..$#{$order->orderitems}) {
 849     my $item = $order->orderitems->[$idx];
 850     if (none { $item->id == $_->{id} } @{$form_orderitems}) {
 851       splice @{$order->orderitems}, $idx, 1;
 852       push @{$self->item_ids_to_delete}, $item->id;
 853     }
 854   }
 855
 856   my @items;
 857   my $pos = 1;
 858   foreach my $form_attr (@{$form_orderitems}) {
 859     my $item = _make_item($order, $form_attr);
 860     $item->position($pos);
 861     push @items, $item;
 862     $pos++;
 863   }
 864   $order->add_items(grep {!$_->id} @items);
 865
 866   return $order;
 867 }
 868
 869 # create or update items from form
 870 #
 871 # Make item objects from form values. For items already existing read from db.
 872 # Create a new item else. And assign attributes.
 873 sub _make_item {
 874   my ($record, $attr) = @_;
 875
 876   my $item;
 877   $item = first { $_->id == $attr->{id} } @{$record->items} if $attr->{id};
 878
 879   my $is_new = !$item;
 880
 881   # add_custom_variables adds cvars to an orderitem with no cvars for saving, but
 882   # they cannot be retrieved via custom_variables until the order/orderitem is
 883   # saved. Adding empty custom_variables to new orderitem here solves this problem.
 884   $item ||= SL::DB::OrderItem->new(custom_variables => []);
 885
 886   $item->assign_attributes(%$attr);
 887   $item->longdescription($item->part->notes)   if $is_new && !defined $attr->{longdescription};
 888   $item->project_id($record->globalproject_id) if $is_new && !defined $attr->{project_id};
 889   $item->lastcost($item->part->lastcost)       if $is_new && !defined $attr->{lastcost_as_number};
 890
 891   return $item;
 892 }
 893
 894 # create a new item
 895 #
 896 # This is used to add one item
 897 sub _new_item {
 898   my ($record, $attr) = @_;
 899
 900   my $item = SL::DB::OrderItem->new;
 901   $item->assign_attributes(%$attr);
 902
 903   my $part         = SL::DB::Part->new(id => $attr->{parts_id})->load;
 904   my $price_source = SL::PriceSource->new(record_item => $item, record => $record);
 905
 906   $item->unit($part->unit) if !$item->unit;
 907
 908   my $price_src;
 909   if ( $part->is_assortment ) {
 910     # add assortment items with price 0, as the components carry the price
 911     $price_src = $price_source->price_from_source("");
 912     $price_src->price(0);
 913   } elsif ($item->sellprice) {
 914     $price_src = $price_source->price_from_source("");
 915     $price_src->price($item->sellprice);
 916   } else {
 917     $price_src = $price_source->best_price
 918            ? $price_source->best_price
 919            : $price_source->price_from_source("");
 920     $price_src->price(0) if !$price_source->best_price;
 921   }
 922
 923   my $discount_src;
 924   if ($item->discount) {
 925     $discount_src = $price_source->discount_from_source("");
 926     $discount_src->discount($item->discount);
 927   } else {
 928     $discount_src = $price_source->best_discount
 929                   ? $price_source->best_discount
 930                   : $price_source->discount_from_source("");
 931     $discount_src->discount(0) if !$price_source->best_discount;
 932   }
 933
 934   my %new_attr;
 935   $new_attr{part}                   = $part;
 936   $new_attr{description}            = $part->description     if ! $item->description;
 937   $new_attr{qty}                    = 1.0                    if ! $item->qty;
 938   $new_attr{price_factor_id}        = $part->price_factor_id if ! $item->price_factor_id;
 939   $new_attr{sellprice}              = $price_src->price;
 940   $new_attr{discount}               = $discount_src->discount;
 941   $new_attr{active_price_source}    = $price_src;
 942   $new_attr{active_discount_source} = $discount_src;
 943   $new_attr{longdescription}        = $part->notes           if ! defined $attr->{longdescription};
 944   $new_attr{project_id}             = $record->globalproject_id;
 945   $new_attr{lastcost}               = $part->lastcost;
 946
 947   # add_custom_variables adds cvars to an orderitem with no cvars for saving, but
 948   # they cannot be retrieved via custom_variables until the order/orderitem is
 949   # saved. Adding empty custom_variables to new orderitem here solves this problem.
 950   $new_attr{custom_variables} = [];
 951
 952   $item->assign_attributes(%new_attr);
 953
 954   return $item;
 955 }
 956
 957 # recalculate prices and taxes
 958 #
 959 # Using the PriceTaxCalculator. Store linetotals in the item objects.
 960 sub _recalc {
 961   my ($self) = @_;
 962
 963   # bb: todo: currency later
 964   $self->order->currency_id($::instance_conf->get_currency_id());
 965
 966   my %pat = $self->order->calculate_prices_and_taxes();
 967   $self->{taxes} = [];
 968   foreach my $tax_chart_id (keys %{ $pat{taxes} }) {
 969     my $tax = SL::DB::Manager::Tax->find_by(chart_id => $tax_chart_id);
 970
 971     my @amount_keys = grep { $pat{amounts}->{$_}->{tax_id} == $tax->id } keys %{ $pat{amounts} };
 972     push(@{ $self->{taxes} }, { amount    => $pat{taxes}->{$tax_chart_id},
 973                                 netamount => $pat{amounts}->{$amount_keys[0]}->{amount},
 974                                 tax       => $tax });
 975   }
 976
 977   pairwise { $a->{linetotal} = $b->{linetotal} } @{$self->order->items}, @{$pat{items}};
 978 }
 979
 980 # get data for saving, printing, ..., that is not changed in the form
 981 #
 982 # Only cvars for now.
 983 sub _get_unalterable_data {
 984   my ($self) = @_;
 985
 986   foreach my $item (@{ $self->order->items }) {
 987     # autovivify all cvars that are not in the form (cvars_by_config can do it).
 988     # workaround to pre-parse number-cvars (parse_custom_variable_values does not parse number values).
 989     foreach my $var (@{ $item->cvars_by_config }) {
 990       $var->unparsed_value($::form->parse_amount(\%::myconfig, $var->{__unparsed_value})) if ($var->config->type eq 'number' && exists($var->{__unparsed_value}));
 991     }
 992     $item->parse_custom_variable_values;
 993   }
 994 }
 995
 996 # delete the order
 997 #
 998 # And remove related files in the spool directory
 999 sub _delete {
1000   my ($self) = @_;
1001
1002   my $errors = [];
1003   my $db     = $self->order->db;
1004
1005   $db->with_transaction(
1006     sub {
1007       my @spoolfiles = grep { $_ } map { $_->spoolfile } @{ SL::DB::Manager::Status->get_all(where => [ trans_id => $self->order->id ]) };
1008       $self->order->delete;
1009       my $spool = $::lx_office_conf{paths}->{spool};
1010       unlink map { "$spool/$_" } @spoolfiles if $spool;
1011
1012       1;
1013   }) || push(@{$errors}, $db->error);
1014
1015   return $errors;
1016 }
1017
1018 # save the order
1019 #
1020 # And delete items that are deleted in the form.
1021 sub _save {
1022   my ($self) = @_;
1023
1024   my $errors = [];
1025   my $db     = $self->order->db;
1026
1027   $db->with_transaction(sub {
1028     SL::DB::OrderItem->new(id => $_)->delete for @{$self->item_ids_to_delete};
1029     $self->order->save(cascade => 1);
1030   }) || push(@{$errors}, $db->error);
1031
1032   return $errors;
1033 }
1034
1035
1036 sub _pre_render {
1037   my ($self) = @_;
1038
1039   $self->{all_taxzones}        = SL::DB::Manager::TaxZone->get_all_sorted();
1040   $self->{all_departments}     = SL::DB::Manager::Department->get_all_sorted();
1041   $self->{all_employees}       = SL::DB::Manager::Employee->get_all(where => [ or => [ id => $self->order->employee_id,
1042                                                                                        deleted => 0 ] ],
1043                                                                     sort_by => 'name');
1044   $self->{all_salesmen}        = SL::DB::Manager::Employee->get_all(where => [ or => [ id => $self->order->salesman_id,
1045                                                                                        deleted => 0 ] ],
1046                                                                     sort_by => 'name');
1047   $self->{all_projects}        = SL::DB::Manager::Project->get_all(where => [ or => [ id => $self->order->globalproject_id,
1048                                                                                       active => 1 ] ],
1049                                                                    sort_by => 'projectnumber');
1050   $self->{all_payment_terms}   = SL::DB::Manager::PaymentTerm->get_all_sorted(where => [ or => [ id => $self->order->payment_id,
1051                                                                                                  obsolete => 0 ] ]);
1052
1053   $self->{all_delivery_terms}  = SL::DB::Manager::DeliveryTerm->get_all_sorted();
1054
1055   $self->{current_employee_id} = SL::DB::Manager::Employee->current->id;
1056
1057   my $print_form = Form->new('');
1058   $print_form->{type}      = $self->type;
1059   $print_form->{printers}  = SL::DB::Manager::Printer->get_all_sorted;
1060   $print_form->{languages} = SL::DB::Manager::Language->get_all_sorted;
1061   $self->{print_options}   = SL::Helper::PrintOptions->get_print_options(
1062     form => $print_form,
1063     options => {dialog_name_prefix => 'print_options.',
1064                 show_headers       => 1,
1065                 no_queue           => 1,
1066                 no_postscript      => 1,
1067                 no_opendocument    => 1,
1068                 no_html            => 1},
1069   );
1070
1071   foreach my $item (@{$self->order->orderitems}) {
1072     my $price_source = SL::PriceSource->new(record_item => $item, record => $self->order);
1073     $item->active_price_source(   $price_source->price_from_source(   $item->active_price_source   ));
1074     $item->active_discount_source($price_source->discount_from_source($item->active_discount_source));
1075   }
1076
1077   if ($self->order->ordnumber && $::instance_conf->get_webdav) {
1078     my $webdav = SL::Webdav->new(
1079       type     => $self->type,
1080       number   => $self->order->ordnumber,
1081     );
1082     my $webdav_path = $webdav->webdav_path;
1083     my @all_objects = $webdav->get_all_objects;
1084     @{ $self->{template_args}->{WEBDAV} } = map { { name => $_->filename,
1085                                                     type => t8('File'),
1086                                                     link => File::Spec->catfile($_->full_filedescriptor),
1087                                                 } } @all_objects;
1088   }
1089
1090   $::request->{layout}->use_javascript("${_}.js")  for qw(kivi.SalesPurchase kivi.Order ckeditor/ckeditor ckeditor/adapters/jquery);
1091 }
1092
1093 sub _create_pdf {
1094   my ($order, $pdf_ref, $params) = @_;
1095
1096   my @errors = ();
1097
1098   my $print_form = Form->new('');
1099   $print_form->{type}        = $order->type;
1100   $print_form->{formname}    = $params->{formname} || $order->type;
1101   $print_form->{format}      = $params->{format}   || 'pdf';
1102   $print_form->{media}       = $params->{media}    || 'file';
1103   $print_form->{groupitems}  = $params->{groupitems};
1104   $print_form->{media}       = 'file'                             if $print_form->{media} eq 'screen';
1105   $print_form->{language}    = $params->{language}->template_code if $print_form->{language};
1106   $print_form->{language_id} = $params->{language}->id            if $print_form->{language};
1107
1108   $order->flatten_to_form($print_form, format_amounts => 1);
1109
1110   # search for the template
1111   my ($template_file, @template_files) = SL::Helper::CreatePDF->find_template(
1112     name        => $print_form->{formname},
1113     email       => $print_form->{media} eq 'email',
1114     language    => $params->{language},
1115     printer_id  => $print_form->{printer_id},  # todo
1116   );
1117
1118   if (!defined $template_file) {
1119     push @errors, $::locale->text('Cannot find matching template for this print request. Please contact your template maintainer. I tried these: #1.', join ', ', map { "'$_'"} @template_files);
1120   }
1121
1122   return @errors if scalar @errors;
1123
1124   $print_form->throw_on_error(sub {
1125     eval {
1126       $print_form->prepare_for_printing;
1127
1128       $$pdf_ref = SL::Helper::CreatePDF->create_pdf(
1129         template  => $template_file,
1130         variables => $print_form,
1131         variable_content_types => {
1132           longdescription => 'html',
1133           partnotes       => 'html',
1134           notes           => 'html',
1135         },
1136       );
1137       1;
1138     } || push @errors, ref($EVAL_ERROR) eq 'SL::X::FormError' ? $EVAL_ERROR->getMessage : $EVAL_ERROR;
1139   });
1140
1141   return @errors;
1142 }
1143
1144 sub _sales_order_type {
1145   'sales_order';
1146 }
1147
1148 sub _purchase_order_type {
1149   'purchase_order';
1150 }
1151
1152 1;
1153
1154 __END__
1155
1156 =encoding utf-8
1157
1158 =head1 NAME
1159
1160 SL::Controller::Order - controller for orders
1161
1162 =head1 SYNOPSIS
1163
1164 This is a new form to enter orders, completely rewritten with the use
1165 of controller and java script techniques.
1166
1167 The aim is to provide the user a better expirience and a faster flow
1168 of work. Also the code should be more readable, more reliable and
1169 better to maintain.
1170
1171 =head2 Key Features
1172
1173 =over 4
1174
1175 =item *
1176
1177 One input row, so that input happens every time at the same place.
1178
1179 =item *
1180
1181 Use of pickers where possible.
1182
1183 =item *
1184
1185 Possibility to enter more than one item at once.
1186
1187 =item *
1188
1189 Save order only on "save" (and "save and delivery order"-workflow). No
1190 hidden save on "print" or "email".
1191
1192 =item *
1193
1194 Item list in a scrollable area, so that the workflow buttons stay at
1195 the bottom.
1196
1197 =item *
1198
1199 Reordering item rows with drag and drop is possible. Sorting item rows is
1200 possible (by partnumber, description, qty, sellprice and discount for now).
1201
1202 =item *
1203
1204 No C<update> is necessary. All entries and calculations are managed
1205 with ajax-calls and the page does only reload on C<save>.
1206
1207 =item *
1208
1209 User can see changes immediately, because of the use of java script
1210 and ajax.
1211
1212 =back
1213
1214 =head1 CODE
1215
1216 =head2 Layout
1217
1218 =over 4
1219
1220 =item * C<SL/Controller/Order.pm>
1221
1222 the controller
1223
1224 =item * C<template/webpages/order/form.html>
1225
1226 main form
1227
1228 =item * C<template/webpages/order/tabs/basic_data.html>
1229
1230 Main tab for basic_data.
1231
1232 This is the only tab here for now. "linked records" and "webdav" tabs are
1233 reused from generic code.
1234
1235 =over 4
1236
1237 =item * C<template/webpages/order/tabs/_item_input.html>
1238
1239 The input line for items
1240
1241 =item * C<template/webpages/order/tabs/_row.html>
1242
1243 One row for already entered items
1244
1245 =item * C<template/webpages/order/tabs/_tax_row.html>
1246
1247 Displaying tax information
1248
1249 =item * C<template/webpages/order/tabs/_multi_items_dialog.html>
1250
1251 Dialog for entering more than one item at once
1252
1253 =item * C<template/webpages/order/tabs/_multi_items_result.html>
1254
1255 Results for the filter in the multi items dialog
1256
1257 =item * C<template/webpages/order/tabs/_price_sources_dialog.html>
1258
1259 Dialog for selecting price and discount sources
1260
1261 =item * C<template/webpages/order/tabs/_email_dialog.html>
1262
1263 Email dialog
1264
1265 =back
1266
1267 =item * C<js/kivi.Order.js>
1268
1269 java script functions
1270
1271 =back
1272
1273 =head1 TODO
1274
1275 =over 4
1276
1277 =item * testing
1278
1279 =item * currency
1280
1281 =item * customer/vendor details ('D'-button)
1282
1283 =item * credit limit
1284
1285 =item * more workflows (save as new / invoice)
1286
1287 =item * price sources: little symbols showing better price / better discount
1288
1289 =item * custom shipto address
1290
1291 =item * periodic invoices
1292
1293 =item * language / part translations
1294
1295 =item * access rights
1296
1297 =item * preset salesman from customer
1298
1299 =item * display weights
1300
1301 =item * force project if enabled in client config
1302
1303 =item * history
1304
1305 =item * mtime check
1306
1307 =back
1308
1309 =head1 KNOWN BUGS AND CAVEATS
1310
1311 =over 4
1312
1313 =item *
1314
1315 Customer discount is not displayed as a valid discount in price source popup
1316 (this might be a bug in price sources)
1317
1318 =item *
1319
1320 No indication that <shift>-up/down expands/collapses second row.
1321
1322 =item *
1323
1324 Inline creation of parts is not currently supported
1325
1326 =item *
1327
1328 Table header is not sticky in the scrolling area.
1329
1330 =item *
1331
1332 Sorting does not include C<position>, neither does reordering.
1333
1334 This behavior was implemented intentionally. But we can discuss, which behavior
1335 should be implemented.
1336
1337 =item *
1338
1339 C<show_multi_items_dialog> does not use the currently inserted string for
1340 filtering.
1341
1342 =back
1343
1344 =head1 AUTHOR
1345
1346 Bernd Bleßmann E<lt>bernd@kivitendo-premium.deE<gt>
1347
1348 =cut