DeliveryOrder: type data zentralisiert um das verhalten besser generalisieren zu...
[kivitendo-erp.git] / SL / Controller / DeliveryOrder.pm
1 package SL::Controller::DeliveryOrder;
2
3 use strict;
4 use parent qw(SL::Controller::Base);
5
6 use SL::Helper::Flash qw(flash_later);
7 use SL::Presenter::Tag qw(select_tag hidden_tag div_tag);
8 use SL::Locale::String qw(t8);
9 use SL::SessionFile::Random;
10 use SL::PriceSource;
11 use SL::Webdav;
12 use SL::File;
13 use SL::MIME;
14 use SL::Util qw(trim);
15 use SL::YAML;
16 use SL::DB::History;
17 use SL::DB::Order;
18 use SL::DB::Default;
19 use SL::DB::Unit;
20 use SL::DB::Part;
21 use SL::DB::PartClassification;
22 use SL::DB::PartsGroup;
23 use SL::DB::Printer;
24 use SL::DB::Language;
25 use SL::DB::RecordLink;
26 use SL::DB::Shipto;
27 use SL::DB::Translation;
28
29 use SL::Helper::CreatePDF qw(:all);
30 use SL::Helper::PrintOptions;
31 use SL::Helper::ShippedQty;
32 use SL::Helper::UserPreferences::PositionsScrollbar;
33 use SL::Helper::UserPreferences::UpdatePositions;
34
35 use SL::Controller::Helper::GetModels;
36 use SL::Controller::DeliveryOrder::TypeData;
37
38 use List::Util qw(first sum0);
39 use List::UtilsBy qw(sort_by uniq_by);
40 use List::MoreUtils qw(any none pairwise first_index);
41 use English qw(-no_match_vars);
42 use File::Spec;
43 use Cwd;
44 use Sort::Naturally;
45
46 use Rose::Object::MakeMethods::Generic
47 (
48  scalar => [ qw(item_ids_to_delete is_custom_shipto_to_delete) ],
49  'scalar --get_set_init' => [ qw(order valid_types type cv p all_price_factors search_cvpartnumber show_update_button part_picker_classification_ids) ],
50 );
51
52
53 # safety
54 __PACKAGE__->run_before('check_auth');
55
56 __PACKAGE__->run_before('get_unalterable_data',
57                         only => [ qw(save save_as_new save_and_delivery_order save_and_invoice save_and_ap_transaction
58                                      print send_email) ]);
59
60 #
61 # actions
62 #
63
64 # add a new order
65 sub action_add {
66   my ($self) = @_;
67
68   $self->order->transdate(DateTime->now_local());
69   $self->set_reqdate_by_type;
70
71
72   $self->pre_render();
73   $self->render(
74     'delivery_order/form',
75     title => $self->get_title_for('add'),
76     %{$self->{template_args}}
77   );
78 }
79
80 # edit an existing order
81 sub action_edit {
82   my ($self) = @_;
83
84   if ($::form->{id}) {
85     $self->load_order;
86
87   } else {
88     # this is to edit an order from an unsaved order object
89
90     # set item ids to new fake id, to identify them as new items
91     foreach my $item (@{$self->order->items_sorted}) {
92       $item->{new_fake_id} = join('_', 'new', Time::HiRes::gettimeofday(), int rand 1000000000000);
93     }
94     # trigger rendering values for second row as hidden, because they
95     # are loaded only on demand. So we need to keep the values from
96     # the source.
97     $_->{render_second_row} = 1 for @{ $self->order->items_sorted };
98   }
99
100   $self->pre_render();
101   $self->render(
102     'delivery_order/form',
103     title => $self->get_title_for('edit'),
104     %{$self->{template_args}}
105   );
106 }
107
108 # edit a collective order (consisting of one or more existing orders)
109 sub action_edit_collective {
110   my ($self) = @_;
111
112   # collect order ids
113   my @multi_ids = map {
114     $_ =~ m{^multi_id_(\d+)$} && $::form->{'multi_id_' . $1} && $::form->{'trans_id_' . $1} && $::form->{'trans_id_' . $1}
115   } grep { $_ =~ m{^multi_id_\d+$} } keys %$::form;
116
117   # fall back to add if no ids are given
118   if (scalar @multi_ids == 0) {
119     $self->action_add();
120     return;
121   }
122
123   # fall back to save as new if only one id is given
124   if (scalar @multi_ids == 1) {
125     $self->order(SL::DB::DeliveryOrder->new(id => $multi_ids[0])->load);
126     $self->action_save_as_new();
127     return;
128   }
129
130   # make new order from given orders
131   my @multi_orders = map { SL::DB::DeliveryOrder->new(id => $_)->load } @multi_ids;
132   $self->{converted_from_oe_id} = join ' ', map { $_->id } @multi_orders;
133   $self->order(SL::DB::DeliveryOrder->new_from_multi(\@multi_orders, sort_sources_by => 'transdate'));
134
135   $self->action_edit();
136 }
137
138 # delete the order
139 sub action_delete {
140   my ($self) = @_;
141
142   my $errors = $self->delete();
143
144   if (scalar @{ $errors }) {
145     $self->js->flash('error', $_) foreach @{ $errors };
146     return $self->js->render();
147   }
148
149   flash_later('info', $self->type_data->text("delete"));
150
151   my @redirect_params = (
152     action => 'add',
153     type   => $self->type,
154   );
155
156   $self->redirect_to(@redirect_params);
157 }
158
159 # save the order
160 sub action_save {
161   my ($self) = @_;
162
163   my $errors = $self->save();
164
165   if (scalar @{ $errors }) {
166     $self->js->flash('error', $_) foreach @{ $errors };
167     return $self->js->render();
168   }
169
170   flash_later('info', $self->type_data->text("saved"));
171
172   my @redirect_params = (
173     action => 'edit',
174     type   => $self->type,
175     id     => $self->order->id,
176   );
177
178   $self->redirect_to(@redirect_params);
179 }
180
181 # save the order as new document an open it for edit
182 sub action_save_as_new {
183   my ($self) = @_;
184
185   my $order = $self->order;
186
187   if (!$order->id) {
188     $self->js->flash('error', t8('This object has not been saved yet.'));
189     return $self->js->render();
190   }
191
192   # load order from db to check if values changed
193   my $saved_order = SL::DB::DeliveryOrder->new(id => $order->id)->load;
194
195   my %new_attrs;
196   # Lets assign a new number if the user hasn't changed the previous one.
197   # If it has been changed manually then use it as-is.
198   $new_attrs{number}    = (trim($order->number) eq $saved_order->number)
199                         ? ''
200                         : trim($order->number);
201
202   # Clear transdate unless changed
203   $new_attrs{transdate} = ($order->transdate == $saved_order->transdate)
204                         ? DateTime->today_local
205                         : $order->transdate;
206
207   # Set new reqdate unless changed if it is enabled in client config
208   $new_attrs{reqdate} = $self->get_reqdate_by_type($order->reqdate, $saved_order->reqdate);
209
210   # Update employee
211   $new_attrs{employee}  = SL::DB::Manager::Employee->current;
212
213   # Create new record from current one
214   $self->order(SL::DB::DeliveryOrder->new_from($order, destination_type => $order->type, attributes => \%new_attrs));
215
216   # no linked records on save as new
217   delete $::form->{$_} for qw(converted_from_oe_id converted_from_orderitems_ids);
218
219   # save
220   $self->action_save();
221 }
222
223 # print the order
224 #
225 # This is called if "print" is pressed in the print dialog.
226 # If PDF creation was requested and succeeded, the pdf is offered for download
227 # via send_file (which uses ajax in this case).
228 sub action_print {
229   my ($self) = @_;
230
231   my $errors = $self->save();
232
233   if (scalar @{ $errors }) {
234     $self->js->flash('error', $_) foreach @{ $errors };
235     return $self->js->render();
236   }
237
238   $self->js_reset_order_and_item_ids_after_save;
239
240   my $format      = $::form->{print_options}->{format};
241   my $media       = $::form->{print_options}->{media};
242   my $formname    = $::form->{print_options}->{formname};
243   my $copies      = $::form->{print_options}->{copies};
244   my $groupitems  = $::form->{print_options}->{groupitems};
245   my $printer_id  = $::form->{print_options}->{printer_id};
246
247   # only pdf and opendocument by now
248   if (none { $format eq $_ } qw(pdf opendocument opendocument_pdf)) {
249     return $self->js->flash('error', t8('Format \'#1\' is not supported yet/anymore.', $format))->render;
250   }
251
252   # only screen or printer by now
253   if (none { $media eq $_ } qw(screen printer)) {
254     return $self->js->flash('error', t8('Media \'#1\' is not supported yet/anymore.', $media))->render;
255   }
256
257   # create a form for generate_attachment_filename
258   my $form   = Form->new;
259   $form->{$self->nr_key()}  = $self->order->number;
260   $form->{type}             = $self->type;
261   $form->{format}           = $format;
262   $form->{formname}         = $formname;
263   $form->{language}         = '_' . $self->order->language->template_code if $self->order->language;
264   my $pdf_filename          = $form->generate_attachment_filename();
265
266   my $pdf;
267   my @errors = generate_pdf($self->order, \$pdf, { format     => $format,
268                                                    formname   => $formname,
269                                                    language   => $self->order->language,
270                                                    printer_id => $printer_id,
271                                                    groupitems => $groupitems });
272   if (scalar @errors) {
273     return $self->js->flash('error', t8('Conversion to PDF failed: #1', $errors[0]))->render;
274   }
275
276   if ($media eq 'screen') {
277     # screen/download
278     $self->js->flash('info', t8('The PDF has been created'));
279     $self->send_file(
280       \$pdf,
281       type         => SL::MIME->mime_type_from_ext($pdf_filename),
282       name         => $pdf_filename,
283       js_no_render => 1,
284     );
285
286   } elsif ($media eq 'printer') {
287     # printer
288     my $printer_id = $::form->{print_options}->{printer_id};
289     SL::DB::Printer->new(id => $printer_id)->load->print_document(
290       copies  => $copies,
291       content => $pdf,
292     );
293
294     $self->js->flash('info', t8('The PDF has been printed'));
295   }
296
297   my @warnings = store_pdf_to_webdav_and_filemanagement($self->order, $pdf, $pdf_filename);
298   if (scalar @warnings) {
299     $self->js->flash('warning', $_) for @warnings;
300   }
301
302   $self->save_history('PRINTED');
303
304   $self->js
305     ->run('kivi.ActionBar.setEnabled', '#save_and_email_action')
306     ->render;
307 }
308 sub action_preview_pdf {
309   my ($self) = @_;
310
311   my $errors = $self->save();
312   if (scalar @{ $errors }) {
313     $self->js->flash('error', $_) foreach @{ $errors };
314     return $self->js->render();
315   }
316
317   $self->js_reset_order_and_item_ids_after_save;
318
319   my $format      = 'pdf';
320   my $media       = 'screen';
321   my $formname    = $self->type;
322
323   # only pdf
324   # create a form for generate_attachment_filename
325   my $form   = Form->new;
326   $form->{$self->nr_key()}  = $self->order->number;
327   $form->{type}             = $self->type;
328   $form->{format}           = $format;
329   $form->{formname}         = $formname;
330   $form->{language}         = '_' . $self->order->language->template_code if $self->order->language;
331   my $pdf_filename          = $form->generate_attachment_filename();
332
333   my $pdf;
334   my @errors = generate_pdf($self->order, \$pdf, { format     => $format,
335                                                    formname   => $formname,
336                                                    language   => $self->order->language,
337                                                  });
338   if (scalar @errors) {
339     return $self->js->flash('error', t8('Conversion to PDF failed: #1', $errors[0]))->render;
340   }
341   $self->save_history('PREVIEWED');
342   $self->js->flash('info', t8('The PDF has been previewed'));
343   # screen/download
344   $self->send_file(
345     \$pdf,
346     type         => SL::MIME->mime_type_from_ext($pdf_filename),
347     name         => $pdf_filename,
348     js_no_render => 0,
349   );
350 }
351
352 # open the email dialog
353 sub action_save_and_show_email_dialog {
354   my ($self) = @_;
355
356   my $errors = $self->save();
357
358   if (scalar @{ $errors }) {
359     $self->js->flash('error', $_) foreach @{ $errors };
360     return $self->js->render();
361   }
362
363   my $cv_method = $self->cv;
364
365   if (!$self->order->$cv_method) {
366     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'))
367                     ->render($self);
368   }
369
370   my $email_form;
371   $email_form->{to}   = $self->order->contact->cp_email if $self->order->contact;
372   $email_form->{to} ||= $self->order->$cv_method->email;
373   $email_form->{cc}   = $self->order->$cv_method->cc;
374   $email_form->{bcc}  = join ', ', grep $_, $self->order->$cv_method->bcc, SL::DB::Default->get->global_bcc;
375   # Todo: get addresses from shipto, if any
376
377   my $form = Form->new;
378   $form->{$self->nr_key()}  = $self->order->number;
379   $form->{cusordnumber}     = $self->order->cusordnumber;
380   $form->{formname}         = $self->type;
381   $form->{type}             = $self->type;
382   $form->{language}         = '_' . $self->order->language->template_code if $self->order->language;
383   $form->{language_id}      = $self->order->language->id                  if $self->order->language;
384   $form->{format}           = 'pdf';
385   $form->{cp_id}            = $self->order->contact->cp_id if $self->order->contact;
386
387   $email_form->{subject}             = $form->generate_email_subject();
388   $email_form->{attachment_filename} = $form->generate_attachment_filename();
389   $email_form->{message}             = $form->generate_email_body();
390   $email_form->{js_send_function}    = 'kivi.Order.send_email()';
391
392   my %files = $self->get_files_for_email_dialog();
393   $self->{all_employees} = SL::DB::Manager::Employee->get_all(query => [ deleted => 0 ]);
394   my $dialog_html = $self->render('common/_send_email_dialog', { output => 0 },
395                                   email_form  => $email_form,
396                                   show_bcc    => $::auth->assert('email_bcc', 'may fail'),
397                                   FILES       => \%files,
398                                   is_customer => $self->cv eq 'customer',
399                                   ALL_EMPLOYEES => $self->{all_employees},
400   );
401
402   $self->js
403       ->run('kivi.Order.show_email_dialog', $dialog_html)
404       ->reinit_widgets
405       ->render($self);
406 }
407
408 # send email
409 #
410 # Todo: handling error messages: flash is not displayed in dialog, but in the main form
411 sub action_send_email {
412   my ($self) = @_;
413
414   my $errors = $self->save();
415
416   if (scalar @{ $errors }) {
417     $self->js->run('kivi.Order.close_email_dialog');
418     $self->js->flash('error', $_) foreach @{ $errors };
419     return $self->js->render();
420   }
421
422   $self->js_reset_order_and_item_ids_after_save;
423
424   my $email_form  = delete $::form->{email_form};
425   my %field_names = (to => 'email');
426
427   $::form->{ $field_names{$_} // $_ } = $email_form->{$_} for keys %{ $email_form };
428
429   # for Form::cleanup which may be called in Form::send_email
430   $::form->{cwd}    = getcwd();
431   $::form->{tmpdir} = $::lx_office_conf{paths}->{userspath};
432
433   $::form->{$_}     = $::form->{print_options}->{$_} for keys %{ $::form->{print_options} };
434   $::form->{media}  = 'email';
435
436   if (($::form->{attachment_policy} // '') !~ m{^(?:old_file|no_file)$}) {
437     my $pdf;
438     my @errors = generate_pdf($self->order, \$pdf, {media      => $::form->{media},
439                                                     format     => $::form->{print_options}->{format},
440                                                     formname   => $::form->{print_options}->{formname},
441                                                     language   => $self->order->language,
442                                                     printer_id => $::form->{print_options}->{printer_id},
443                                                     groupitems => $::form->{print_options}->{groupitems}});
444     if (scalar @errors) {
445       return $self->js->flash('error', t8('Conversion to PDF failed: #1', $errors[0]))->render($self);
446     }
447
448     my @warnings = store_pdf_to_webdav_and_filemanagement($self->order, $pdf, $::form->{attachment_filename});
449     if (scalar @warnings) {
450       flash_later('warning', $_) for @warnings;
451     }
452
453     my $sfile = SL::SessionFile::Random->new(mode => "w");
454     $sfile->fh->print($pdf);
455     $sfile->fh->close;
456
457     $::form->{tmpfile} = $sfile->file_name;
458     $::form->{tmpdir}  = $sfile->get_path; # for Form::cleanup which may be called in Form::send_email
459   }
460
461   $::form->{id} = $self->order->id; # this is used in SL::Mailer to create a linked record to the mail
462   $::form->send_email(\%::myconfig, 'pdf');
463
464   # internal notes
465   my $intnotes = $self->order->intnotes;
466   $intnotes   .= "\n\n" if $self->order->intnotes;
467   $intnotes   .= t8('[email]')                                                                                        . "\n";
468   $intnotes   .= t8('Date')       . ": " . $::locale->format_date_object(DateTime->now_local, precision => 'seconds') . "\n";
469   $intnotes   .= t8('To (email)') . ": " . $::form->{email}                                                           . "\n";
470   $intnotes   .= t8('Cc')         . ": " . $::form->{cc}                                                              . "\n"    if $::form->{cc};
471   $intnotes   .= t8('Bcc')        . ": " . $::form->{bcc}                                                             . "\n"    if $::form->{bcc};
472   $intnotes   .= t8('Subject')    . ": " . $::form->{subject}                                                         . "\n\n";
473   $intnotes   .= t8('Message')    . ": " . $::form->{message};
474
475   $self->order->update_attributes(intnotes => $intnotes);
476
477   $self->save_history('MAILED');
478
479   flash_later('info', t8('The email has been sent.'));
480
481   my @redirect_params = (
482     action => 'edit',
483     type   => $self->type,
484     id     => $self->order->id,
485   );
486
487   $self->redirect_to(@redirect_params);
488 }
489
490 # save the order and redirect to the frontend subroutine for a new
491 # delivery order
492 sub action_save_and_delivery_order {
493   my ($self) = @_;
494
495   $self->save_and_redirect_to(
496     controller => 'oe.pl',
497     action     => 'oe_delivery_order_from_order',
498   );
499 }
500
501 # save the order and redirect to the frontend subroutine for a new
502 # invoice
503 sub action_save_and_invoice {
504   my ($self) = @_;
505
506   $self->save_and_redirect_to(
507     controller => 'oe.pl',
508     action     => 'oe_invoice_from_order',
509   );
510 }
511
512 # workflow from sales order to sales quotation
513 sub action_sales_quotation {
514   $_[0]->workflow_sales_or_request_for_quotation();
515 }
516
517 # workflow from sales order to sales quotation
518 sub action_request_for_quotation {
519   $_[0]->workflow_sales_or_request_for_quotation();
520 }
521
522 # workflow from sales quotation to sales order
523 sub action_sales_order {
524   $_[0]->workflow_sales_or_purchase_order();
525 }
526
527 # workflow from rfq to purchase order
528 sub action_purchase_order {
529   $_[0]->workflow_sales_or_purchase_order();
530 }
531
532 # workflow from purchase order to ap transaction
533 sub action_save_and_ap_transaction {
534   my ($self) = @_;
535
536   $self->save_and_redirect_to(
537     controller => 'ap.pl',
538     action     => 'add_from_purchase_order',
539   );
540 }
541
542 # set form elements in respect to a changed customer or vendor
543 #
544 # This action is called on an change of the customer/vendor picker.
545 sub action_customer_vendor_changed {
546   my ($self) = @_;
547
548   setup_order_from_cv($self->order);
549
550   my $cv_method = $self->cv;
551
552   if ($self->order->$cv_method->contacts && scalar @{ $self->order->$cv_method->contacts } > 0) {
553     $self->js->show('#cp_row');
554   } else {
555     $self->js->hide('#cp_row');
556   }
557
558   if ($self->order->$cv_method->shipto && scalar @{ $self->order->$cv_method->shipto } > 0) {
559     $self->js->show('#shipto_selection');
560   } else {
561     $self->js->hide('#shipto_selection');
562   }
563
564   $self->js->val( '#order_salesman_id',      $self->order->salesman_id)        if $self->order->is_sales;
565
566   $self->js
567     ->replaceWith('#order_cp_id',            $self->build_contact_select)
568     ->replaceWith('#order_shipto_id',        $self->build_shipto_select)
569     ->replaceWith('#shipto_inputs  ',        $self->build_shipto_inputs)
570     ->replaceWith('#business_info_row',      $self->build_business_info_row)
571     ->val(        '#order_taxzone_id',       $self->order->taxzone_id)
572     ->val(        '#order_taxincluded',      $self->order->taxincluded)
573     ->val(        '#order_currency_id',      $self->order->currency_id)
574     ->val(        '#order_payment_id',       $self->order->payment_id)
575     ->val(        '#order_delivery_term_id', $self->order->delivery_term_id)
576     ->val(        '#order_intnotes',         $self->order->intnotes)
577     ->val(        '#order_language_id',      $self->order->$cv_method->language_id)
578     ->focus(      '#order_' . $self->cv . '_id')
579     ->run('kivi.Order.update_exchangerate');
580
581   $self->js_redisplay_cvpartnumbers;
582   $self->js->render();
583 }
584
585 # open the dialog for customer/vendor details
586 sub action_show_customer_vendor_details_dialog {
587   my ($self) = @_;
588
589   my $is_customer = 'customer' eq $::form->{vc};
590   my $cv;
591   if ($is_customer) {
592     $cv = SL::DB::Customer->new(id => $::form->{vc_id})->load;
593   } else {
594     $cv = SL::DB::Vendor->new(id => $::form->{vc_id})->load;
595   }
596
597   my %details = map { $_ => $cv->$_ } @{$cv->meta->columns};
598   $details{discount_as_percent} = $cv->discount_as_percent;
599   $details{creditlimt}          = $cv->creditlimit_as_number;
600   $details{business}            = $cv->business->description      if $cv->business;
601   $details{language}            = $cv->language_obj->description  if $cv->language_obj;
602   $details{delivery_terms}      = $cv->delivery_term->description if $cv->delivery_term;
603   $details{payment_terms}       = $cv->payment->description       if $cv->payment;
604   $details{pricegroup}          = $cv->pricegroup->pricegroup     if $is_customer && $cv->pricegroup;
605
606   foreach my $entry (@{ $cv->shipto }) {
607     push @{ $details{SHIPTO} },   { map { $_ => $entry->$_ } @{$entry->meta->columns} };
608   }
609   foreach my $entry (@{ $cv->contacts }) {
610     push @{ $details{CONTACTS} }, { map { $_ => $entry->$_ } @{$entry->meta->columns} };
611   }
612
613   $_[0]->render('common/show_vc_details', { layout => 0 },
614                 is_customer => $is_customer,
615                 %details);
616
617 }
618
619 # called if a unit in an existing item row is changed
620 sub action_unit_changed {
621   my ($self) = @_;
622
623   my $idx  = first_index { $_ eq $::form->{item_id} } @{ $::form->{orderitem_ids} };
624   my $item = $self->order->items_sorted->[$idx];
625
626   my $old_unit_obj = SL::DB::Unit->new(name => $::form->{old_unit})->load;
627   $item->sellprice($item->unit_obj->convert_to($item->sellprice, $old_unit_obj));
628
629   $self->js
630     ->run('kivi.Order.update_sellprice', $::form->{item_id}, $item->sellprice_as_number);
631   $self->js_redisplay_line_values;
632   $self->js->render();
633 }
634
635 # add an item row for a new item entered in the input row
636 sub action_add_item {
637   my ($self) = @_;
638
639   delete $::form->{add_item}->{create_part_type};
640
641   my $form_attr = $::form->{add_item};
642
643   return unless $form_attr->{parts_id};
644
645   my $item = new_item($self->order, $form_attr);
646
647   $self->order->add_items($item);
648
649   $self->get_item_cvpartnumber($item);
650
651   my $item_id = join('_', 'new', Time::HiRes::gettimeofday(), int rand 1000000000000);
652   my $row_as_html = $self->p->render('delivery_order/tabs/_row',
653                                      ITEM => $item,
654                                      ID   => $item_id,
655                                      SELF => $self,
656   );
657
658   if ($::form->{insert_before_item_id}) {
659     $self->js
660       ->before ('.row_entry:has(#item_' . $::form->{insert_before_item_id} . ')', $row_as_html);
661   } else {
662     $self->js
663       ->append('#row_table_id', $row_as_html);
664   }
665
666   if ( $item->part->is_assortment ) {
667     $form_attr->{qty_as_number} = 1 unless $form_attr->{qty_as_number};
668     foreach my $assortment_item ( @{$item->part->assortment_items} ) {
669       my $attr = { parts_id => $assortment_item->parts_id,
670                    qty      => $assortment_item->qty * $::form->parse_amount(\%::myconfig, $form_attr->{qty_as_number}), # TODO $form_attr->{unit}
671                    unit     => $assortment_item->unit,
672                    description => $assortment_item->part->description,
673                  };
674       my $item = new_item($self->order, $attr);
675
676       # set discount to 100% if item isn't supposed to be charged, overwriting any customer discount
677       $item->discount(1) unless $assortment_item->charge;
678
679       $self->order->add_items( $item );
680       $self->get_item_cvpartnumber($item);
681       my $item_id = join('_', 'new', Time::HiRes::gettimeofday(), int rand 1000000000000);
682       my $row_as_html = $self->p->render('delivery_order/tabs/_row',
683                                          ITEM => $item,
684                                          ID   => $item_id,
685                                          SELF => $self,
686       );
687       if ($::form->{insert_before_item_id}) {
688         $self->js
689           ->before ('.row_entry:has(#item_' . $::form->{insert_before_item_id} . ')', $row_as_html);
690       } else {
691         $self->js
692           ->append('#row_table_id', $row_as_html);
693       }
694     };
695   };
696
697   $self->js
698     ->val('.add_item_input', '')
699     ->run('kivi.Order.init_row_handlers')
700     ->run('kivi.Order.renumber_positions')
701     ->focus('#add_item_parts_id_name');
702
703   $self->js->run('kivi.Order.row_table_scroll_down') if !$::form->{insert_before_item_id};
704
705   $self->js->render();
706 }
707
708 # add item rows for multiple items at once
709 sub action_add_multi_items {
710   my ($self) = @_;
711
712   my @form_attr = grep { $_->{qty_as_number} } @{ $::form->{add_items} };
713   return $self->js->render() unless scalar @form_attr;
714
715   my @items;
716   foreach my $attr (@form_attr) {
717     my $item = new_item($self->order, $attr);
718     push @items, $item;
719     if ( $item->part->is_assortment ) {
720       foreach my $assortment_item ( @{$item->part->assortment_items} ) {
721         my $attr = { parts_id => $assortment_item->parts_id,
722                      qty      => $assortment_item->qty * $item->qty, # TODO $form_attr->{unit}
723                      unit     => $assortment_item->unit,
724                      description => $assortment_item->part->description,
725                    };
726         my $item = new_item($self->order, $attr);
727
728         # set discount to 100% if item isn't supposed to be charged, overwriting any customer discount
729         $item->discount(1) unless $assortment_item->charge;
730         push @items, $item;
731       }
732     }
733   }
734   $self->order->add_items(@items);
735
736   foreach my $item (@items) {
737     $self->get_item_cvpartnumber($item);
738     my $item_id = join('_', 'new', Time::HiRes::gettimeofday(), int rand 1000000000000);
739     my $row_as_html = $self->p->render('delivery_order/tabs/_row',
740                                        ITEM => $item,
741                                        ID   => $item_id,
742                                        SELF => $self,
743     );
744
745     if ($::form->{insert_before_item_id}) {
746       $self->js
747         ->before ('.row_entry:has(#item_' . $::form->{insert_before_item_id} . ')', $row_as_html);
748     } else {
749       $self->js
750         ->append('#row_table_id', $row_as_html);
751     }
752   }
753
754   $self->js
755     ->run('kivi.Part.close_picker_dialogs')
756     ->run('kivi.Order.init_row_handlers')
757     ->run('kivi.Order.renumber_positions')
758     ->focus('#add_item_parts_id_name');
759
760   $self->js->run('kivi.Order.row_table_scroll_down') if !$::form->{insert_before_item_id};
761
762   $self->js->render();
763 }
764
765 sub action_update_exchangerate {
766   my ($self) = @_;
767
768   my $data = {
769     is_standard   => $self->order->currency_id == $::instance_conf->get_currency_id,
770     currency_name => $self->order->currency->name,
771   };
772
773   $self->render(\SL::JSON::to_json($data), { type => 'json', process => 0 });
774 }
775
776 # redisplay item rows if they are sorted by an attribute
777 sub action_reorder_items {
778   my ($self) = @_;
779
780   my %sort_keys = (
781     partnumber   => sub { $_[0]->part->partnumber },
782     description  => sub { $_[0]->description },
783     qty          => sub { $_[0]->qty },
784     sellprice    => sub { $_[0]->sellprice },
785     discount     => sub { $_[0]->discount },
786     cvpartnumber => sub { $_[0]->{cvpartnumber} },
787   );
788
789   $self->get_item_cvpartnumber($_) for @{$self->order->items_sorted};
790
791   my $method = $sort_keys{$::form->{order_by}};
792   my @to_sort = map { { old_pos => $_->position, order_by => $method->($_) } } @{ $self->order->items_sorted };
793   if ($::form->{sort_dir}) {
794     if ( $::form->{order_by} =~ m/qty|sellprice|discount/ ){
795       @to_sort = sort { $a->{order_by} <=> $b->{order_by} } @to_sort;
796     } else {
797       @to_sort = sort { $a->{order_by} cmp $b->{order_by} } @to_sort;
798     }
799   } else {
800     if ( $::form->{order_by} =~ m/qty|sellprice|discount/ ){
801       @to_sort = sort { $b->{order_by} <=> $a->{order_by} } @to_sort;
802     } else {
803       @to_sort = sort { $b->{order_by} cmp $a->{order_by} } @to_sort;
804     }
805   }
806   $self->js
807     ->run('kivi.Order.redisplay_items', \@to_sort)
808     ->render;
809 }
810
811 # show the popup to choose a price/discount source
812 sub action_price_popup {
813   my ($self) = @_;
814
815   my $idx  = first_index { $_ eq $::form->{item_id} } @{ $::form->{orderitem_ids} };
816   my $item = $self->order->items_sorted->[$idx];
817
818   $self->render_price_dialog($item);
819 }
820
821 # save the order in a session variable and redirect to the part controller
822 sub action_create_part {
823   my ($self) = @_;
824
825   my $previousform = $::auth->save_form_in_session(non_scalars => 1);
826
827   my $callback     = $self->url_for(
828     action       => 'return_from_create_part',
829     type         => $self->type, # type is needed for check_auth on return
830     previousform => $previousform,
831   );
832
833   flash_later('info', t8('You are adding a new part while you are editing another document. You will be redirected to your document when saving the new part or aborting this form.'));
834
835   my @redirect_params = (
836     controller => 'Part',
837     action     => 'add',
838     part_type  => $::form->{add_item}->{create_part_type},
839     callback   => $callback,
840     show_abort => 1,
841   );
842
843   $self->redirect_to(@redirect_params);
844 }
845
846 sub action_return_from_create_part {
847   my ($self) = @_;
848
849   $self->{created_part} = SL::DB::Part->new(id => delete $::form->{new_parts_id})->load if $::form->{new_parts_id};
850
851   $::auth->restore_form_from_session(delete $::form->{previousform});
852
853   # set item ids to new fake id, to identify them as new items
854   foreach my $item (@{$self->order->items_sorted}) {
855     $item->{new_fake_id} = join('_', 'new', Time::HiRes::gettimeofday(), int rand 1000000000000);
856   }
857
858   $self->get_unalterable_data();
859   $self->pre_render();
860
861   # trigger rendering values for second row/longdescription as hidden,
862   # because they are loaded only on demand. So we need to keep the values
863   # from the source.
864   $_->{render_second_row}      = 1 for @{ $self->order->items_sorted };
865   $_->{render_longdescription} = 1 for @{ $self->order->items_sorted };
866
867   $self->render(
868     'delivery_order/form',
869     title => $self->get_title_for('edit'),
870     %{$self->{template_args}}
871   );
872
873 }
874
875 # load the second row for one or more items
876 #
877 # This action gets the html code for all items second rows by rendering a template for
878 # the second row and sets the html code via client js.
879 sub action_load_second_rows {
880   my ($self) = @_;
881
882   foreach my $item_id (@{ $::form->{item_ids} }) {
883     my $idx  = first_index { $_ eq $item_id } @{ $::form->{orderitem_ids} };
884     my $item = $self->order->items_sorted->[$idx];
885
886     $self->js_load_second_row($item, $item_id, 0);
887   }
888
889   $self->js->run('kivi.Order.init_row_handlers') if $self->order->is_sales; # for lastcosts change-callback
890
891   $self->js->render();
892 }
893
894 # update description, notes and sellprice from master data
895 sub action_update_row_from_master_data {
896   my ($self) = @_;
897
898   foreach my $item_id (@{ $::form->{item_ids} }) {
899     my $idx   = first_index { $_ eq $item_id } @{ $::form->{orderitem_ids} };
900     my $item  = $self->order->items_sorted->[$idx];
901     my $texts = get_part_texts($item->part, $self->order->language_id);
902
903     $item->description($texts->{description});
904     $item->longdescription($texts->{longdescription});
905
906     my $price_source = SL::PriceSource->new(record_item => $item, record => $self->order);
907
908     my $price_src;
909     if ($item->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     } else {
914       $price_src = $price_source->best_price
915                  ? $price_source->best_price
916                  : $price_source->price_from_source("");
917       $price_src->price($::form->round_amount($price_src->price / $self->order->exchangerate, 5)) if $self->order->exchangerate;
918       $price_src->price(0) if !$price_source->best_price;
919     }
920
921
922     $item->sellprice($price_src->price);
923     $item->active_price_source($price_src);
924
925     $self->js
926       ->run('kivi.Order.update_sellprice', $item_id, $item->sellprice_as_number)
927       ->html('.row_entry:has(#item_' . $item_id . ') [name = "partnumber"] a', $item->part->partnumber)
928       ->val ('.row_entry:has(#item_' . $item_id . ') [name = "order.orderitems[].description"]', $item->description)
929       ->val ('.row_entry:has(#item_' . $item_id . ') [name = "order.orderitems[].longdescription"]', $item->longdescription);
930
931     if ($self->search_cvpartnumber) {
932       $self->get_item_cvpartnumber($item);
933       $self->js->html('.row_entry:has(#item_' . $item_id . ') [name = "cvpartnumber"]', $item->{cvpartnumber});
934     }
935   }
936
937   $self->js_redisplay_line_values;
938
939   $self->js->render();
940 }
941
942 sub js_load_second_row {
943   my ($self, $item, $item_id, $do_parse) = @_;
944
945   if ($do_parse) {
946     # Parse values from form (they are formated while rendering (template)).
947     # Workaround to pre-parse number-cvars (parse_custom_variable_values does not parse number values).
948     # This parsing is not necessary at all, if we assure that the second row/cvars are only loaded once.
949     foreach my $var (@{ $item->cvars_by_config }) {
950       $var->unparsed_value($::form->parse_amount(\%::myconfig, $var->{__unparsed_value})) if ($var->config->type eq 'number' && exists($var->{__unparsed_value}));
951     }
952     $item->parse_custom_variable_values;
953   }
954
955   my $row_as_html = $self->p->render('delivery_order/tabs/_second_row', ITEM => $item, TYPE => $self->type);
956
957   $self->js
958     ->html('#second_row_' . $item_id, $row_as_html)
959     ->data('#second_row_' . $item_id, 'loaded', 1);
960 }
961
962 sub js_redisplay_line_values {
963   my ($self) = @_;
964
965   my $is_sales = $self->order->is_sales;
966
967   # sales orders with margins
968   my @data;
969   if ($is_sales) {
970     @data = map {
971       [
972        $::form->format_amount(\%::myconfig, $_->{linetotal},     2, 0),
973        $::form->format_amount(\%::myconfig, $_->{marge_total},   2, 0),
974        $::form->format_amount(\%::myconfig, $_->{marge_percent}, 2, 0),
975       ]} @{ $self->order->items_sorted };
976   } else {
977     @data = map {
978       [
979        $::form->format_amount(\%::myconfig, $_->{linetotal},     2, 0),
980       ]} @{ $self->order->items_sorted };
981   }
982
983   $self->js
984     ->run('kivi.Order.redisplay_line_values', $is_sales, \@data);
985 }
986
987 sub js_redisplay_cvpartnumbers {
988   my ($self) = @_;
989
990   $self->get_item_cvpartnumber($_) for @{$self->order->items_sorted};
991
992   my @data = map {[$_->{cvpartnumber}]} @{ $self->order->items_sorted };
993
994   $self->js
995     ->run('kivi.Order.redisplay_cvpartnumbers', \@data);
996 }
997
998 sub js_reset_order_and_item_ids_after_save {
999   my ($self) = @_;
1000
1001   $self->js
1002     ->val('#id', $self->order->id)
1003     ->val('#converted_from_oe_id', '')
1004     ->val('#order_' . $self->nr_key(), $self->order->number);
1005
1006   my $idx = 0;
1007   foreach my $form_item_id (@{ $::form->{orderitem_ids} }) {
1008     next if !$self->order->items_sorted->[$idx]->id;
1009     next if $form_item_id !~ m{^new};
1010     $self->js
1011       ->val ('[name="orderitem_ids[+]"][value="' . $form_item_id . '"]', $self->order->items_sorted->[$idx]->id)
1012       ->val ('#item_' . $form_item_id, $self->order->items_sorted->[$idx]->id)
1013       ->attr('#item_' . $form_item_id, "id", 'item_' . $self->order->items_sorted->[$idx]->id);
1014   } continue {
1015     $idx++;
1016   }
1017   $self->js->val('[name="converted_from_orderitems_ids[+]"]', '');
1018 }
1019
1020 #
1021 # helpers
1022 #
1023
1024 sub init_type {
1025   my ($self) = @_;
1026
1027   if (none { $::form->{type} eq $_ } @{$self->valid_types}) {
1028     die "Not a valid type for order";
1029   }
1030
1031   $self->type($::form->{type});
1032 }
1033
1034 sub init_cv {
1035   my ($self) = @_;
1036
1037   return $self->type_data->customervendor;
1038 }
1039
1040 sub init_search_cvpartnumber {
1041   my ($self) = @_;
1042
1043   my $user_prefs = SL::Helper::UserPreferences::PartPickerSearch->new();
1044   my $search_cvpartnumber;
1045   $search_cvpartnumber = !!$user_prefs->get_sales_search_customer_partnumber() if $self->cv eq 'customer';
1046   $search_cvpartnumber = !!$user_prefs->get_purchase_search_makemodel()        if $self->cv eq 'vendor';
1047
1048   return $search_cvpartnumber;
1049 }
1050
1051 sub init_show_update_button {
1052   my ($self) = @_;
1053
1054   !!SL::Helper::UserPreferences::UpdatePositions->new()->get_show_update_button();
1055 }
1056
1057 sub init_p {
1058   SL::Presenter->get;
1059 }
1060
1061 sub init_order {
1062   $_[0]->make_order;
1063 }
1064
1065 sub init_all_price_factors {
1066   SL::DB::Manager::PriceFactor->get_all;
1067 }
1068
1069 sub init_part_picker_classification_ids {
1070   my ($self)    = @_;
1071
1072   return [ map { $_->id } @{ SL::DB::Manager::PartClassification->get_all(where => $self->type_date->part_classification_query) } ];
1073 }
1074
1075 sub check_auth {
1076   my ($self) = @_;
1077
1078   $::auth->assert($self->type_data->access || 'DOES_NOT_EXIST');
1079 }
1080
1081 # build the selection box for contacts
1082 #
1083 # Needed, if customer/vendor changed.
1084 sub build_contact_select {
1085   my ($self) = @_;
1086
1087   select_tag('order.cp_id', [ $self->order->{$self->cv}->contacts ],
1088     value_key  => 'cp_id',
1089     title_key  => 'full_name_dep',
1090     default    => $self->order->cp_id,
1091     with_empty => 1,
1092     style      => 'width: 300px',
1093   );
1094 }
1095
1096 # build the selection box for shiptos
1097 #
1098 # Needed, if customer/vendor changed.
1099 sub build_shipto_select {
1100   my ($self) = @_;
1101
1102   select_tag('order.shipto_id',
1103              [ {displayable_id => t8("No/individual shipping address"), shipto_id => ''}, $self->order->{$self->cv}->shipto ],
1104              value_key  => 'shipto_id',
1105              title_key  => 'displayable_id',
1106              default    => $self->order->shipto_id,
1107              with_empty => 0,
1108              style      => 'width: 300px',
1109   );
1110 }
1111
1112 # build the inputs for the cusom shipto dialog
1113 #
1114 # Needed, if customer/vendor changed.
1115 sub build_shipto_inputs {
1116   my ($self) = @_;
1117
1118   my $content = $self->p->render('common/_ship_to_dialog',
1119                                  vc_obj      => $self->order->customervendor,
1120                                  cs_obj      => $self->order->custom_shipto,
1121                                  cvars       => $self->order->custom_shipto->cvars_by_config,
1122                                  id_selector => '#order_shipto_id');
1123
1124   div_tag($content, id => 'shipto_inputs');
1125 }
1126
1127 # render the info line for business
1128 #
1129 # Needed, if customer/vendor changed.
1130 sub build_business_info_row
1131 {
1132   $_[0]->p->render('delivery_order/tabs/_business_info_row', SELF => $_[0]);
1133 }
1134
1135
1136 sub load_order {
1137   my ($self) = @_;
1138
1139   return if !$::form->{id};
1140
1141   $self->order(SL::DB::DeliveryOrder->new(id => $::form->{id})->load);
1142
1143   # Add an empty custom shipto to the order, so that the dialog can render the cvar inputs.
1144   # You need a custom shipto object to call cvars_by_config to get the cvars.
1145   $self->order->custom_shipto(SL::DB::Shipto->new(module => 'OE', custom_variables => [])) if !$self->order->custom_shipto;
1146
1147   return $self->order;
1148 }
1149
1150 # load or create a new order object
1151 #
1152 # And assign changes from the form to this object.
1153 # If the order is loaded from db, check if items are deleted in the form,
1154 # remove them form the object and collect them for removing from db on saving.
1155 # Then create/update items from form (via make_item) and add them.
1156 sub make_order {
1157   my ($self) = @_;
1158
1159   # add_items adds items to an order with no items for saving, but they cannot
1160   # be retrieved via items until the order is saved. Adding empty items to new
1161   # order here solves this problem.
1162   my $order;
1163   $order   = SL::DB::DeliveryOrder->new(id => $::form->{id})->load(with => [ 'orderitems', 'orderitems.part' ]) if $::form->{id};
1164   $order ||= SL::DB::DeliveryOrder->new(orderitems  => [],
1165                                 quotation   => $self->type_data->is_quotation,
1166                                 currency_id => $::instance_conf->get_currency_id(),);
1167
1168   my $cv_id_method = $self->cv . '_id';
1169   if (!$::form->{id} && $::form->{$cv_id_method}) {
1170     $order->$cv_id_method($::form->{$cv_id_method});
1171     setup_order_from_cv($order);
1172   }
1173
1174   my $form_orderitems                  = delete $::form->{order}->{orderitems};
1175
1176   $order->assign_attributes(%{$::form->{order}});
1177
1178   $self->setup_custom_shipto_from_form($order, $::form);
1179
1180   # remove deleted items
1181   $self->item_ids_to_delete([]);
1182   foreach my $idx (reverse 0..$#{$order->orderitems}) {
1183     my $item = $order->orderitems->[$idx];
1184     if (none { $item->id == $_->{id} } @{$form_orderitems}) {
1185       splice @{$order->orderitems}, $idx, 1;
1186       push @{$self->item_ids_to_delete}, $item->id;
1187     }
1188   }
1189
1190   my @items;
1191   my $pos = 1;
1192   foreach my $form_attr (@{$form_orderitems}) {
1193     my $item = make_item($order, $form_attr);
1194     $item->position($pos);
1195     push @items, $item;
1196     $pos++;
1197   }
1198   $order->add_items(grep {!$_->id} @items);
1199
1200   return $order;
1201 }
1202
1203 # create or update items from form
1204 #
1205 # Make item objects from form values. For items already existing read from db.
1206 # Create a new item else. And assign attributes.
1207 sub make_item {
1208   my ($record, $attr) = @_;
1209
1210   my $item;
1211   $item = first { $_->id == $attr->{id} } @{$record->items} if $attr->{id};
1212
1213   my $is_new = !$item;
1214
1215   # add_custom_variables adds cvars to an orderitem with no cvars for saving, but
1216   # they cannot be retrieved via custom_variables until the order/orderitem is
1217   # saved. Adding empty custom_variables to new orderitem here solves this problem.
1218   $item ||= SL::DB::DeliveryOrderItem->new(custom_variables => []);
1219
1220   $item->assign_attributes(%$attr);
1221
1222   if ($is_new) {
1223     my $texts = get_part_texts($item->part, $record->language_id);
1224     $item->longdescription($texts->{longdescription})              if !defined $attr->{longdescription};
1225     $item->project_id($record->globalproject_id)                   if !defined $attr->{project_id};
1226     $item->lastcost($record->is_sales ? $item->part->lastcost : 0) if !defined $attr->{lastcost_as_number};
1227   }
1228
1229   return $item;
1230 }
1231
1232 # create a new item
1233 #
1234 # This is used to add one item
1235 sub new_item {
1236   my ($record, $attr) = @_;
1237
1238   my $item = SL::DB::DeliveryOrderItem->new;
1239
1240   # Remove attributes where the user left or set the inputs empty.
1241   # So these attributes will be undefined and we can distinguish them
1242   # from zero later on.
1243   for (qw(qty_as_number sellprice_as_number discount_as_percent)) {
1244     delete $attr->{$_} if $attr->{$_} eq '';
1245   }
1246
1247   $item->assign_attributes(%$attr);
1248
1249   my $part         = SL::DB::Part->new(id => $attr->{parts_id})->load;
1250   my $price_source = SL::PriceSource->new(record_item => $item, record => $record);
1251
1252   $item->unit($part->unit) if !$item->unit;
1253
1254   my $price_src;
1255   if ( $part->is_assortment ) {
1256     # add assortment items with price 0, as the components carry the price
1257     $price_src = $price_source->price_from_source("");
1258     $price_src->price(0);
1259   } elsif (defined $item->sellprice) {
1260     $price_src = $price_source->price_from_source("");
1261     $price_src->price($item->sellprice);
1262   } else {
1263     $price_src = $price_source->best_price
1264                ? $price_source->best_price
1265                : $price_source->price_from_source("");
1266     $price_src->price(0) if !$price_source->best_price;
1267   }
1268
1269   my $discount_src;
1270   if (defined $item->discount) {
1271     $discount_src = $price_source->discount_from_source("");
1272     $discount_src->discount($item->discount);
1273   } else {
1274     $discount_src = $price_source->best_discount
1275                   ? $price_source->best_discount
1276                   : $price_source->discount_from_source("");
1277     $discount_src->discount(0) if !$price_source->best_discount;
1278   }
1279
1280   my %new_attr;
1281   $new_attr{part}                   = $part;
1282   $new_attr{description}            = $part->description     if ! $item->description;
1283   $new_attr{qty}                    = 1.0                    if ! $item->qty;
1284   $new_attr{price_factor_id}        = $part->price_factor_id if ! $item->price_factor_id;
1285   $new_attr{sellprice}              = $price_src->price;
1286   $new_attr{discount}               = $discount_src->discount;
1287   $new_attr{active_price_source}    = $price_src;
1288   $new_attr{active_discount_source} = $discount_src;
1289   $new_attr{longdescription}        = $part->notes           if ! defined $attr->{longdescription};
1290   $new_attr{project_id}             = $record->globalproject_id;
1291   $new_attr{lastcost}               = $record->is_sales ? $part->lastcost : 0;
1292
1293   # add_custom_variables adds cvars to an orderitem with no cvars for saving, but
1294   # they cannot be retrieved via custom_variables until the order/orderitem is
1295   # saved. Adding empty custom_variables to new orderitem here solves this problem.
1296   $new_attr{custom_variables} = [];
1297
1298   my $texts = get_part_texts($part, $record->language_id, description => $new_attr{description}, longdescription => $new_attr{longdescription});
1299
1300   $item->assign_attributes(%new_attr, %{ $texts });
1301
1302   return $item;
1303 }
1304
1305 sub setup_order_from_cv {
1306   my ($order) = @_;
1307
1308   $order->$_($order->customervendor->$_) for (qw(taxzone_id payment_id delivery_term_id currency_id));
1309
1310   $order->intnotes($order->customervendor->notes);
1311
1312   if ($order->is_sales) {
1313     $order->salesman_id($order->customer->salesman_id || SL::DB::Manager::Employee->current->id);
1314     $order->taxincluded(defined($order->customer->taxincluded_checked)
1315                         ? $order->customer->taxincluded_checked
1316                         : $::myconfig{taxincluded_checked});
1317   }
1318
1319 }
1320
1321 # setup custom shipto from form
1322 #
1323 # The dialog returns form variables starting with 'shipto' and cvars starting
1324 # with 'shiptocvar_'.
1325 # Mark it to be deleted if a shipto from master data is selected
1326 # (i.e. order has a shipto).
1327 # Else, update or create a new custom shipto. If the fields are empty, it
1328 # will not be saved on save.
1329 sub setup_custom_shipto_from_form {
1330   my ($self, $order, $form) = @_;
1331
1332   if ($order->shipto) {
1333     $self->is_custom_shipto_to_delete(1);
1334   } else {
1335     my $custom_shipto = $order->custom_shipto || $order->custom_shipto(SL::DB::Shipto->new(module => 'OE', custom_variables => []));
1336
1337     my $shipto_cvars  = {map { my ($key) = m{^shiptocvar_(.+)}; $key => delete $form->{$_}} grep { m{^shiptocvar_} } keys %$form};
1338     my $shipto_attrs  = {map {                                  $_   => delete $form->{$_}} grep { m{^shipto}      } keys %$form};
1339
1340     $custom_shipto->assign_attributes(%$shipto_attrs);
1341     $custom_shipto->cvar_by_name($_)->value($shipto_cvars->{$_}) for keys %$shipto_cvars;
1342   }
1343 }
1344
1345 # get data for saving, printing, ..., that is not changed in the form
1346 #
1347 # Only cvars for now.
1348 sub get_unalterable_data {
1349   my ($self) = @_;
1350
1351   foreach my $item (@{ $self->order->items }) {
1352     # autovivify all cvars that are not in the form (cvars_by_config can do it).
1353     # workaround to pre-parse number-cvars (parse_custom_variable_values does not parse number values).
1354     foreach my $var (@{ $item->cvars_by_config }) {
1355       $var->unparsed_value($::form->parse_amount(\%::myconfig, $var->{__unparsed_value})) if ($var->config->type eq 'number' && exists($var->{__unparsed_value}));
1356     }
1357     $item->parse_custom_variable_values;
1358   }
1359 }
1360
1361 # delete the order
1362 #
1363 # And remove related files in the spool directory
1364 sub delete {
1365   my ($self) = @_;
1366
1367   my $errors = [];
1368   my $db     = $self->order->db;
1369
1370   $db->with_transaction(
1371     sub {
1372       my @spoolfiles = grep { $_ } map { $_->spoolfile } @{ SL::DB::Manager::Status->get_all(where => [ trans_id => $self->order->id ]) };
1373       $self->order->delete;
1374       my $spool = $::lx_office_conf{paths}->{spool};
1375       unlink map { "$spool/$_" } @spoolfiles if $spool;
1376
1377       $self->save_history('DELETED');
1378
1379       1;
1380   }) || push(@{$errors}, $db->error);
1381
1382   return $errors;
1383 }
1384
1385 # save the order
1386 #
1387 # And delete items that are deleted in the form.
1388 sub save {
1389   my ($self) = @_;
1390
1391   my $errors = [];
1392   my $db     = $self->order->db;
1393
1394   $db->with_transaction(sub {
1395     # delete custom shipto if it is to be deleted or if it is empty
1396     if ($self->order->custom_shipto && ($self->is_custom_shipto_to_delete || $self->order->custom_shipto->is_empty)) {
1397       $self->order->custom_shipto->delete if $self->order->custom_shipto->shipto_id;
1398       $self->order->custom_shipto(undef);
1399     }
1400
1401     SL::DB::DeliveryOrderItem->new(id => $_)->delete for @{$self->item_ids_to_delete || []};
1402     $self->order->save(cascade => 1);
1403
1404     # link records
1405     if ($::form->{converted_from_oe_id}) {
1406       my @converted_from_oe_ids = split ' ', $::form->{converted_from_oe_id};
1407       foreach my $converted_from_oe_id (@converted_from_oe_ids) {
1408         my $src = SL::DB::DeliveryOrder->new(id => $converted_from_oe_id)->load;
1409         $src->update_attributes(closed => 1) if $src->type =~ /_quotation$/;
1410         $src->link_to_record($self->order);
1411       }
1412       if (scalar @{ $::form->{converted_from_orderitems_ids} || [] }) {
1413         my $idx = 0;
1414         foreach (@{ $self->order->items_sorted }) {
1415           my $from_id = $::form->{converted_from_orderitems_ids}->[$idx];
1416           next if !$from_id;
1417           SL::DB::RecordLink->new(from_table => 'orderitems',
1418                                   from_id    => $from_id,
1419                                   to_table   => 'orderitems',
1420                                   to_id      => $_->id
1421           )->save;
1422           $idx++;
1423         }
1424       }
1425     }
1426
1427     $self->save_history('SAVED');
1428
1429     1;
1430   }) || push(@{$errors}, $db->error);
1431
1432   return $errors;
1433 }
1434
1435 sub workflow_sales_or_request_for_quotation {
1436   my ($self) = @_;
1437
1438   # always save
1439   my $errors = $self->save();
1440
1441   if (scalar @{ $errors }) {
1442     $self->js->flash('error', $_) for @{ $errors };
1443     return $self->js->render();
1444   }
1445
1446   my $destination_type = $self->type_data->workflow("to_quotation_type");
1447
1448   $self->order(SL::DB::DeliveryOrder->new_from($self->order, destination_type => $destination_type));
1449   $self->{converted_from_oe_id} = delete $::form->{id};
1450
1451   # set item ids to new fake id, to identify them as new items
1452   foreach my $item (@{$self->order->items_sorted}) {
1453     $item->{new_fake_id} = join('_', 'new', Time::HiRes::gettimeofday(), int rand 1000000000000);
1454   }
1455
1456   # change form type
1457   $::form->{type} = $destination_type;
1458   $self->type($self->init_type);
1459   $self->cv  ($self->init_cv);
1460   $self->check_auth;
1461
1462   $self->get_unalterable_data();
1463   $self->pre_render();
1464
1465   # trigger rendering values for second row as hidden, because they
1466   # are loaded only on demand. So we need to keep the values from the
1467   # source.
1468   $_->{render_second_row} = 1 for @{ $self->order->items_sorted };
1469
1470   $self->render(
1471     'delivery_order/form',
1472     title => $self->get_title_for('edit'),
1473     %{$self->{template_args}}
1474   );
1475 }
1476
1477 sub workflow_sales_or_purchase_order {
1478   my ($self) = @_;
1479
1480   # always save
1481   my $errors = $self->save();
1482
1483   if (scalar @{ $errors }) {
1484     $self->js->flash('error', $_) foreach @{ $errors };
1485     return $self->js->render();
1486   }
1487
1488   my $destination_type = $self->type_data->workflow("to_order_type");
1489
1490   # check for direct delivery
1491   # copy shipto in custom shipto (custom shipto will be copied by new_from() in case)
1492   my $custom_shipto;
1493   if ($self->type_data->workflow("to_order_copy_shipto") && $::form->{use_shipto} && $self->order->shipto) {
1494     $custom_shipto = $self->order->shipto->clone('SL::DB::DeliveryOrder');
1495   }
1496
1497   $self->order(SL::DB::DeliveryOrder->new_from($self->order, destination_type => $destination_type));
1498   $self->{converted_from_oe_id} = delete $::form->{id};
1499
1500   # set item ids to new fake id, to identify them as new items
1501   foreach my $item (@{$self->order->items_sorted}) {
1502     $item->{new_fake_id} = join('_', 'new', Time::HiRes::gettimeofday(), int rand 1000000000000);
1503   }
1504
1505   if ($self->type_data->workflow("to_order_copy_shipto")) {
1506     if ($::form->{use_shipto}) {
1507       $self->order->custom_shipto($custom_shipto) if $custom_shipto;
1508     } else {
1509       # remove any custom shipto if not wanted
1510       $self->order->custom_shipto(SL::DB::Shipto->new(module => 'OE', custom_variables => []));
1511     }
1512   }
1513
1514   # change form type
1515   $::form->{type} = $destination_type;
1516   $self->type($self->init_type);
1517   $self->cv  ($self->init_cv);
1518   $self->check_auth;
1519
1520   $self->get_unalterable_data();
1521   $self->pre_render();
1522
1523   # trigger rendering values for second row as hidden, because they
1524   # are loaded only on demand. So we need to keep the values from the
1525   # source.
1526   $_->{render_second_row} = 1 for @{ $self->order->items_sorted };
1527
1528   $self->render(
1529     'delivery_order/form',
1530     title => $self->get_title_for('edit'),
1531     %{$self->{template_args}}
1532   );
1533 }
1534
1535
1536 sub pre_render {
1537   my ($self) = @_;
1538
1539   $self->{all_taxzones}               = SL::DB::Manager::TaxZone->get_all_sorted();
1540   $self->{all_currencies}             = SL::DB::Manager::Currency->get_all_sorted();
1541   $self->{all_departments}            = SL::DB::Manager::Department->get_all_sorted();
1542   $self->{all_languages}              = SL::DB::Manager::Language->get_all_sorted();
1543   $self->{all_employees}              = SL::DB::Manager::Employee->get_all(where => [ or => [ id => $self->order->employee_id,
1544                                                                                               deleted => 0 ] ],
1545                                                                            sort_by => 'name');
1546   $self->{all_salesmen}               = SL::DB::Manager::Employee->get_all(where => [ or => [ id => $self->order->salesman_id,
1547                                                                                               deleted => 0 ] ],
1548                                                                            sort_by => 'name');
1549   $self->{all_payment_terms}          = SL::DB::Manager::PaymentTerm->get_all_sorted(where => [ or => [ id => $self->order->payment_id,
1550                                                                                                         obsolete => 0 ] ]);
1551   $self->{all_delivery_terms}         = SL::DB::Manager::DeliveryTerm->get_all_sorted();
1552   $self->{current_employee_id}        = SL::DB::Manager::Employee->current->id;
1553   $self->{order_probabilities}        = [ map { { title => ($_ * 10) . '%', id => $_ * 10 } } (0..10) ];
1554   $self->{positions_scrollbar_height} = SL::Helper::UserPreferences::PositionsScrollbar->new()->get_height();
1555
1556   my $print_form = Form->new('');
1557   $print_form->{type}        = $self->type;
1558   $print_form->{printers}    = SL::DB::Manager::Printer->get_all_sorted;
1559   $self->{print_options}     = SL::Helper::PrintOptions->get_print_options(
1560     form => $print_form,
1561     options => {dialog_name_prefix => 'print_options.',
1562                 show_headers       => 1,
1563                 no_queue           => 1,
1564                 no_postscript      => 1,
1565                 no_opendocument    => 0,
1566                 no_html            => 1},
1567   );
1568
1569   foreach my $item (@{$self->order->orderitems}) {
1570     my $price_source = SL::PriceSource->new(record_item => $item, record => $self->order);
1571     $item->active_price_source(   $price_source->price_from_source(   $item->active_price_source   ));
1572     $item->active_discount_source($price_source->discount_from_source($item->active_discount_source));
1573   }
1574
1575   if ($self->order->number && $::instance_conf->get_webdav) {
1576     my $webdav = SL::Webdav->new(
1577       type     => $self->type,
1578       number   => $self->order->number,
1579     );
1580     my @all_objects = $webdav->get_all_objects;
1581     @{ $self->{template_args}->{WEBDAV} } = map { { name => $_->filename,
1582                                                     type => t8('File'),
1583                                                     link => File::Spec->catfile($_->full_filedescriptor),
1584                                                 } } @all_objects;
1585   }
1586
1587   $self->get_item_cvpartnumber($_) for @{$self->order->items_sorted};
1588
1589   $::request->{layout}->use_javascript("${_}.js") for qw(kivi.SalesPurchase kivi.Order kivi.File ckeditor/ckeditor ckeditor/adapters/jquery
1590                                                          calculate_qty kivi.Validator follow_up show_history);
1591   $self->setup_edit_action_bar;
1592 }
1593
1594 sub setup_edit_action_bar {
1595   my ($self, %params) = @_;
1596
1597   my $deletion_allowed = $self->type_data->show_menu("delete");
1598
1599   for my $bar ($::request->layout->get('actionbar')) {
1600     $bar->add(
1601       combobox => [
1602         action => [
1603           t8('Save'),
1604           call      => [ 'kivi.Order.save', 'save', $::instance_conf->get_order_warn_duplicate_parts,
1605                                                     $::instance_conf->get_order_warn_no_deliverydate,
1606                                                                                                       ],
1607         ],
1608         action => [
1609           t8('Save as new'),
1610           call      => [ 'kivi.Order.save', 'save_as_new', $::instance_conf->get_order_warn_duplicate_parts ],
1611           disabled  => !$self->order->id ? t8('This object has not been saved yet.') : undef,
1612         ],
1613       ], # end of combobox "Save"
1614
1615       combobox => [
1616         action => [
1617           t8('Workflow'),
1618         ],
1619         action => [
1620           t8('Save and Quotation'),
1621           submit   => [ '#order_form', { action => "DeliveryOrder/sales_quotation" } ],
1622           only_if  => $self->type_data->show_menu("save_and_quotation"),
1623         ],
1624         action => [
1625           t8('Save and RFQ'),
1626           submit   => [ '#order_form', { action => "DeliveryOrder/request_for_quotation" } ],
1627           only_if  => $self->type_data->show_menu("save_and_rfq"),
1628         ],
1629         action => [
1630           t8('Save and Sales Order'),
1631           submit   => [ '#order_form', { action => "DeliveryOrder/sales_order" } ],
1632           only_if  => $self->type_data->show_menu("save_and_sales_order"),
1633         ],
1634         action => [
1635           t8('Save and Purchase Order'),
1636           call      => [ 'kivi.Order.purchase_order_check_for_direct_delivery' ],
1637           only_if  => $self->type_data->show_menu("save_and_purchase_order"),
1638         ],
1639         action => [
1640           t8('Save and Delivery Order'),
1641           call      => [ 'kivi.Order.save', 'save_and_delivery_order', $::instance_conf->get_order_warn_duplicate_parts,
1642                                                                        $::instance_conf->get_order_warn_no_deliverydate,
1643                                                                                                                         ],
1644           only_if  => $self->type_data->show_menu("save_and_delivery_order"),
1645         ],
1646         action => [
1647           t8('Save and Invoice'),
1648           call      => [ 'kivi.Order.save', 'save_and_invoice', $::instance_conf->get_order_warn_duplicate_parts ],
1649         ],
1650         action => [
1651           t8('Save and AP Transaction'),
1652           call      => [ 'kivi.Order.save', 'save_and_ap_transaction', $::instance_conf->get_order_warn_duplicate_parts ],
1653           only_if  => $self->type_data->show_menu("save_and_ap_transaction"),
1654         ],
1655
1656       ], # end of combobox "Workflow"
1657
1658       combobox => [
1659         action => [
1660           t8('Export'),
1661         ],
1662         action => [
1663           t8('Save and preview PDF'),
1664            call => [ 'kivi.Order.save', 'preview_pdf', $::instance_conf->get_order_warn_duplicate_parts,
1665                                                        $::instance_conf->get_order_warn_no_deliverydate,
1666                                                                                                          ],
1667         ],
1668         action => [
1669           t8('Save and print'),
1670           call => [ 'kivi.Order.show_print_options', $::instance_conf->get_order_warn_duplicate_parts,
1671                                                      $::instance_conf->get_order_warn_no_deliverydate,
1672                                                                                                       ],
1673         ],
1674         action => [
1675           t8('Save and E-mail'),
1676           id   => 'save_and_email_action',
1677           call => [ 'kivi.Order.save', 'save_and_show_email_dialog', $::instance_conf->get_order_warn_duplicate_parts,
1678                                                                      $::instance_conf->get_order_warn_no_deliverydate,
1679                   ],
1680           disabled => !$self->order->id ? t8('This object has not been saved yet.') : undef,
1681         ],
1682         action => [
1683           t8('Download attachments of all parts'),
1684           call     => [ 'kivi.File.downloadOrderitemsFiles', $::form->{type}, $::form->{id} ],
1685           disabled => !$self->order->id ? t8('This object has not been saved yet.') : undef,
1686           only_if  => $::instance_conf->get_doc_storage,
1687         ],
1688       ], # end of combobox "Export"
1689
1690       action => [
1691         t8('Delete'),
1692         call     => [ 'kivi.Order.delete_order' ],
1693         confirm  => $::locale->text('Do you really want to delete this object?'),
1694         disabled => !$self->order->id ? t8('This object has not been saved yet.') : undef,
1695         only_if  => $self->type_data->show_menu("delete"),
1696       ],
1697
1698       combobox => [
1699         action => [
1700           t8('more')
1701         ],
1702         action => [
1703           t8('Follow-Up'),
1704           call     => [ 'kivi.Order.follow_up_window' ],
1705           disabled => !$self->order->id ? t8('This object has not been saved yet.') : undef,
1706           only_if  => $::auth->assert('productivity', 1),
1707         ],
1708         action => [
1709           t8('History'),
1710           call     => [ 'set_history_window', $self->order->id, 'id' ],
1711           disabled => !$self->order->id ? t8('This record has not been saved yet.') : undef,
1712         ],
1713       ], # end of combobox "more"
1714     );
1715   }
1716 }
1717
1718 sub generate_pdf {
1719   my ($order, $pdf_ref, $params) = @_;
1720
1721   my @errors = ();
1722
1723   my $print_form = Form->new('');
1724   $print_form->{type}        = $order->type;
1725   $print_form->{formname}    = $params->{formname} || $order->type;
1726   $print_form->{format}      = $params->{format}   || 'pdf';
1727   $print_form->{media}       = $params->{media}    || 'file';
1728   $print_form->{groupitems}  = $params->{groupitems};
1729   $print_form->{printer_id}  = $params->{printer_id};
1730   $print_form->{media}       = 'file'                             if $print_form->{media} eq 'screen';
1731
1732   $order->language($params->{language});
1733   $order->flatten_to_form($print_form, format_amounts => 1);
1734
1735   my $template_ext;
1736   my $template_type;
1737   if ($print_form->{format} =~ /(opendocument|oasis)/i) {
1738     $template_ext  = 'odt';
1739     $template_type = 'OpenDocument';
1740   }
1741
1742   # search for the template
1743   my ($template_file, @template_files) = SL::Helper::CreatePDF->find_template(
1744     name        => $print_form->{formname},
1745     extension   => $template_ext,
1746     email       => $print_form->{media} eq 'email',
1747     language    => $params->{language},
1748     printer_id  => $print_form->{printer_id},
1749   );
1750
1751   if (!defined $template_file) {
1752     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);
1753   }
1754
1755   return @errors if scalar @errors;
1756
1757   $print_form->throw_on_error(sub {
1758     eval {
1759       $print_form->prepare_for_printing;
1760
1761       $$pdf_ref = SL::Helper::CreatePDF->create_pdf(
1762         format        => $print_form->{format},
1763         template_type => $template_type,
1764         template      => $template_file,
1765         variables     => $print_form,
1766         variable_content_types => {
1767           longdescription => 'html',
1768           partnotes       => 'html',
1769           notes           => 'html',
1770         },
1771       );
1772       1;
1773     } || push @errors, ref($EVAL_ERROR) eq 'SL::X::FormError' ? $EVAL_ERROR->error : $EVAL_ERROR;
1774   });
1775
1776   return @errors;
1777 }
1778
1779 sub get_files_for_email_dialog {
1780   my ($self) = @_;
1781
1782   my %files = map { ($_ => []) } qw(versions files vc_files part_files);
1783
1784   return %files if !$::instance_conf->get_doc_storage;
1785
1786   if ($self->order->id) {
1787     $files{versions} = [ SL::File->get_all_versions(object_id => $self->order->id,              object_type => $self->order->type, file_type => 'document') ];
1788     $files{files}    = [ SL::File->get_all(         object_id => $self->order->id,              object_type => $self->order->type, file_type => 'attachment') ];
1789     $files{vc_files} = [ SL::File->get_all(         object_id => $self->order->{$self->cv}->id, object_type => $self->cv,          file_type => 'attachment') ];
1790     $files{project_files} = [ SL::File->get_all(    object_id => $self->order->globalproject_id, object_type => 'project',         file_type => 'attachment') ];
1791   }
1792
1793   my @parts =
1794     uniq_by { $_->{id} }
1795     map {
1796       +{ id         => $_->part->id,
1797          partnumber => $_->part->partnumber }
1798     } @{$self->order->items_sorted};
1799
1800   foreach my $part (@parts) {
1801     my @pfiles = SL::File->get_all(object_id => $part->{id}, object_type => 'part');
1802     push @{ $files{part_files} }, map { +{ %{ $_ }, partnumber => $part->{partnumber} } } @pfiles;
1803   }
1804
1805   foreach my $key (keys %files) {
1806     $files{$key} = [ sort_by { lc $_->{db_file}->{file_name} } @{ $files{$key} } ];
1807   }
1808
1809   return %files;
1810 }
1811
1812 sub get_title_for {
1813   my ($self, $action) = @_;
1814
1815   return '' if none { lc($action)} qw(add edit);
1816   return $self->type_data->text($action);
1817 }
1818
1819 sub get_item_cvpartnumber {
1820   my ($self, $item) = @_;
1821
1822   return if !$self->search_cvpartnumber;
1823   return if !$self->order->customervendor;
1824
1825   if ($self->cv eq 'vendor') {
1826     my @mms = grep { $_->make eq $self->order->customervendor->id } @{$item->part->makemodels};
1827     $item->{cvpartnumber} = $mms[0]->model if scalar @mms;
1828   } elsif ($self->cv eq 'customer') {
1829     my @cps = grep { $_->customer_id eq $self->order->customervendor->id } @{$item->part->customerprices};
1830     $item->{cvpartnumber} = $cps[0]->customer_partnumber if scalar @cps;
1831   }
1832 }
1833
1834 sub get_part_texts {
1835   my ($part_or_id, $language_or_id, %defaults) = @_;
1836
1837   my $part        = ref($part_or_id)     ? $part_or_id         : SL::DB::Part->load_cached($part_or_id);
1838   my $language_id = ref($language_or_id) ? $language_or_id->id : $language_or_id;
1839   my $texts       = {
1840     description     => $defaults{description}     // $part->description,
1841     longdescription => $defaults{longdescription} // $part->notes,
1842   };
1843
1844   return $texts unless $language_id;
1845
1846   my $translation = SL::DB::Manager::Translation->get_first(
1847     where => [
1848       parts_id    => $part->id,
1849       language_id => $language_id,
1850     ]);
1851
1852   $texts->{description}     = $translation->translation     if $translation && $translation->translation;
1853   $texts->{longdescription} = $translation->longdescription if $translation && $translation->longdescription;
1854
1855   return $texts;
1856 }
1857
1858 sub nr_key {
1859   return $_[0]->type_data->nr_key;
1860 }
1861
1862 sub save_and_redirect_to {
1863   my ($self, %params) = @_;
1864
1865   my $errors = $self->save();
1866
1867   if (scalar @{ $errors }) {
1868     $self->js->flash('error', $_) foreach @{ $errors };
1869     return $self->js->render();
1870   }
1871
1872   flash_later('info', $self->type_data->text("saved"));
1873
1874   $self->redirect_to(%params, id => $self->order->id);
1875 }
1876
1877 sub save_history {
1878   my ($self, $addition) = @_;
1879
1880   my $number_type = $self->nr_key;
1881   my $snumbers    = $number_type . '_' . $self->order->$number_type;
1882
1883   SL::DB::History->new(
1884     trans_id    => $self->order->id,
1885     employee_id => SL::DB::Manager::Employee->current->id,
1886     what_done   => $self->order->type,
1887     snumbers    => $snumbers,
1888     addition    => $addition,
1889   )->save;
1890 }
1891
1892 sub store_pdf_to_webdav_and_filemanagement {
1893   my($order, $content, $filename) = @_;
1894
1895   my @errors;
1896
1897   # copy file to webdav folder
1898   if ($order->number && $::instance_conf->get_webdav_documents) {
1899     my $webdav = SL::Webdav->new(
1900       type     => $order->type,
1901       number   => $order->number,
1902     );
1903     my $webdav_file = SL::Webdav::File->new(
1904       webdav   => $webdav,
1905       filename => $filename,
1906     );
1907     eval {
1908       $webdav_file->store(data => \$content);
1909       1;
1910     } or do {
1911       push @errors, t8('Storing PDF to webdav folder failed: #1', $@);
1912     };
1913   }
1914   if ($order->id && $::instance_conf->get_doc_storage) {
1915     eval {
1916       SL::File->save(object_id     => $order->id,
1917                      object_type   => $order->type,
1918                      mime_type     => 'application/pdf',
1919                      source        => 'created',
1920                      file_type     => 'document',
1921                      file_name     => $filename,
1922                      file_contents => $content);
1923       1;
1924     } or do {
1925       push @errors, t8('Storing PDF in storage backend failed: #1', $@);
1926     };
1927   }
1928
1929   return @errors;
1930 }
1931
1932 sub init_type_data {
1933   SL::Controller::DeliveryOrder::TypeData->new($_[0]);
1934 }
1935
1936 sub init_valid_types {
1937   $_[0]->type_data->valid_types;
1938 }
1939
1940 1;
1941
1942 __END__
1943
1944 =encoding utf-8
1945
1946 =head1 NAME
1947
1948 SL::Controller::Order - controller for orders
1949
1950 =head1 SYNOPSIS
1951
1952 This is a new form to enter orders, completely rewritten with the use
1953 of controller and java script techniques.
1954
1955 The aim is to provide the user a better experience and a faster workflow. Also
1956 the code should be more readable, more reliable and better to maintain.
1957
1958 =head2 Key Features
1959
1960 =over 4
1961
1962 =item *
1963
1964 One input row, so that input happens every time at the same place.
1965
1966 =item *
1967
1968 Use of pickers where possible.
1969
1970 =item *
1971
1972 Possibility to enter more than one item at once.
1973
1974 =item *
1975
1976 Item list in a scrollable area, so that the workflow buttons stay at
1977 the bottom.
1978
1979 =item *
1980
1981 Reordering item rows with drag and drop is possible. Sorting item rows is
1982 possible (by partnumber, description, qty, sellprice and discount for now).
1983
1984 =item *
1985
1986 No C<update> is necessary. All entries and calculations are managed
1987 with ajax-calls and the page only reloads on C<save>.
1988
1989 =item *
1990
1991 User can see changes immediately, because of the use of java script
1992 and ajax.
1993
1994 =back
1995
1996 =head1 CODE
1997
1998 =head2 Layout
1999
2000 =over 4
2001
2002 =item * C<SL/Controller/Order.pm>
2003
2004 the controller
2005
2006 =item * C<template/webpages/delivery_order/form.html>
2007
2008 main form
2009
2010 =item * C<template/webpages/delivery_order/tabs/basic_data.html>
2011
2012 Main tab for basic_data.
2013
2014 This is the only tab here for now. "linked records" and "webdav" tabs are
2015 reused from generic code.
2016
2017 =over 4
2018
2019 =item * C<template/webpages/delivery_order/tabs/_business_info_row.html>
2020
2021 For displaying information on business type
2022
2023 =item * C<template/webpages/delivery_order/tabs/_item_input.html>
2024
2025 The input line for items
2026
2027 =item * C<template/webpages/delivery_order/tabs/_row.html>
2028
2029 One row for already entered items
2030
2031 =item * C<template/webpages/delivery_order/tabs/_tax_row.html>
2032
2033 Displaying tax information
2034
2035 =back
2036
2037 =item * C<js/kivi.Order.js>
2038
2039 java script functions
2040
2041 =back
2042
2043 =head1 TODO
2044
2045 =over 4
2046
2047 =item * testing
2048
2049 =item * price sources: little symbols showing better price / better discount
2050
2051 =item * select units in input row?
2052
2053 =item * check for direct delivery (workflow sales order -> purchase order)
2054
2055 =item * access rights
2056
2057 =item * display weights
2058
2059 =item * mtime check
2060
2061 =item * optional client/user behaviour
2062
2063 (transactions has to be set - department has to be set -
2064  force project if enabled in client config - transport cost reminder)
2065
2066 =back
2067
2068 =head1 KNOWN BUGS AND CAVEATS
2069
2070 =over 4
2071
2072 =item *
2073
2074 Customer discount is not displayed as a valid discount in price source popup
2075 (this might be a bug in price sources)
2076
2077 (I cannot reproduce this (Bernd))
2078
2079 =item *
2080
2081 No indication that <shift>-up/down expands/collapses second row.
2082
2083 =item *
2084
2085 Inline creation of parts is not currently supported
2086
2087 =item *
2088
2089 Table header is not sticky in the scrolling area.
2090
2091 =item *
2092
2093 Sorting does not include C<position>, neither does reordering.
2094
2095 This behavior was implemented intentionally. But we can discuss, which behavior
2096 should be implemented.
2097
2098 =back
2099
2100 =head1 To discuss / Nice to have
2101
2102 =over 4
2103
2104 =item *
2105
2106 How to expand/collapse second row. Now it can be done clicking the icon or
2107 <shift>-up/down.
2108
2109 =item *
2110
2111 Possibility to select PriceSources in input row?
2112
2113 =item *
2114
2115 This controller uses a (changed) copy of the template for the PriceSource
2116 dialog. Maybe there could be used one code source.
2117
2118 =item *
2119
2120 Rounding-differences between this controller (PriceTaxCalculator) and the old
2121 form. This is not only a problem here, but also in all parts using the PTC.
2122 There exists a ticket and a patch. This patch should be testet.
2123
2124 =item *
2125
2126 An indicator, if the actual inputs are saved (like in an
2127 editor or on text processing application).
2128
2129 =item *
2130
2131 A warning when leaving the page without saveing unchanged inputs.
2132
2133
2134 =back
2135
2136 =head1 AUTHOR
2137
2138 Bernd Bleßmann E<lt>bernd@kivitendo-premium.deE<gt>
2139
2140 =cut