1 package SL::Controller::DeliveryOrder;
4 use parent qw(SL::Controller::Base);
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;
14 use SL::Util qw(trim);
21 use SL::DB::PartClassification;
22 use SL::DB::PartsGroup;
25 use SL::DB::RecordLink;
27 use SL::DB::Translation;
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;
35 use SL::Controller::Helper::GetModels;
37 use List::Util qw(first sum0);
38 use List::UtilsBy qw(sort_by uniq_by);
39 use List::MoreUtils qw(any none pairwise first_index);
40 use English qw(-no_match_vars);
45 use Rose::Object::MakeMethods::Generic
47 scalar => [ qw(item_ids_to_delete is_custom_shipto_to_delete) ],
48 'scalar --get_set_init' => [ qw(order valid_types type cv p all_price_factors search_cvpartnumber show_update_button part_picker_classification_ids) ],
53 __PACKAGE__->run_before('check_auth');
55 __PACKAGE__->run_before('get_unalterable_data',
56 only => [ qw(save save_as_new save_and_delivery_order save_and_invoice save_and_ap_transaction
67 $self->order->transdate(DateTime->now_local());
68 my $extra_days = $self->type eq sales_quotation_type() ? $::instance_conf->get_reqdate_interval :
69 $self->type eq sales_order_type() ? $::instance_conf->get_delivery_date_interval : 1;
71 if ( ($self->type eq sales_order_type() && $::instance_conf->get_deliverydate_on)
72 || ($self->type eq sales_quotation_type() && $::instance_conf->get_reqdate_on)
73 && (!$self->order->reqdate)) {
74 $self->order->reqdate(DateTime->today_local->next_workday(extra_days => $extra_days));
80 'delivery_order/form',
81 title => $self->get_title_for('add'),
82 %{$self->{template_args}}
86 # edit an existing order
94 # this is to edit an order from an unsaved order object
96 # set item ids to new fake id, to identify them as new items
97 foreach my $item (@{$self->order->items_sorted}) {
98 $item->{new_fake_id} = join('_', 'new', Time::HiRes::gettimeofday(), int rand 1000000000000);
100 # trigger rendering values for second row as hidden, because they
101 # are loaded only on demand. So we need to keep the values from
103 $_->{render_second_row} = 1 for @{ $self->order->items_sorted };
108 'delivery_order/form',
109 title => $self->get_title_for('edit'),
110 %{$self->{template_args}}
114 # edit a collective order (consisting of one or more existing orders)
115 sub action_edit_collective {
119 my @multi_ids = map {
120 $_ =~ m{^multi_id_(\d+)$} && $::form->{'multi_id_' . $1} && $::form->{'trans_id_' . $1} && $::form->{'trans_id_' . $1}
121 } grep { $_ =~ m{^multi_id_\d+$} } keys %$::form;
123 # fall back to add if no ids are given
124 if (scalar @multi_ids == 0) {
129 # fall back to save as new if only one id is given
130 if (scalar @multi_ids == 1) {
131 $self->order(SL::DB::DeliveryOrder->new(id => $multi_ids[0])->load);
132 $self->action_save_as_new();
136 # make new order from given orders
137 my @multi_orders = map { SL::DB::DeliveryOrder->new(id => $_)->load } @multi_ids;
138 $self->{converted_from_oe_id} = join ' ', map { $_->id } @multi_orders;
139 $self->order(SL::DB::DeliveryOrder->new_from_multi(\@multi_orders, sort_sources_by => 'transdate'));
141 $self->action_edit();
148 my $errors = $self->delete();
150 if (scalar @{ $errors }) {
151 $self->js->flash('error', $_) foreach @{ $errors };
152 return $self->js->render();
155 my $text = $self->type eq sales_order_type() ? $::locale->text('The order has been deleted')
156 : $self->type eq purchase_order_type() ? $::locale->text('The order has been deleted')
157 : $self->type eq sales_quotation_type() ? $::locale->text('The quotation has been deleted')
158 : $self->type eq request_quotation_type() ? $::locale->text('The rfq has been deleted')
160 flash_later('info', $text);
162 my @redirect_params = (
167 $self->redirect_to(@redirect_params);
174 my $errors = $self->save();
176 if (scalar @{ $errors }) {
177 $self->js->flash('error', $_) foreach @{ $errors };
178 return $self->js->render();
181 my $text = $self->type eq sales_order_type() ? $::locale->text('The order has been saved')
182 : $self->type eq purchase_order_type() ? $::locale->text('The order has been saved')
183 : $self->type eq sales_quotation_type() ? $::locale->text('The quotation has been saved')
184 : $self->type eq request_quotation_type() ? $::locale->text('The rfq has been saved')
186 flash_later('info', $text);
188 my @redirect_params = (
191 id => $self->order->id,
194 $self->redirect_to(@redirect_params);
197 # save the order as new document an open it for edit
198 sub action_save_as_new {
201 my $order = $self->order;
204 $self->js->flash('error', t8('This object has not been saved yet.'));
205 return $self->js->render();
208 # load order from db to check if values changed
209 my $saved_order = SL::DB::DeliveryOrder->new(id => $order->id)->load;
212 # Lets assign a new number if the user hasn't changed the previous one.
213 # If it has been changed manually then use it as-is.
214 $new_attrs{number} = (trim($order->number) eq $saved_order->number)
216 : trim($order->number);
218 # Clear transdate unless changed
219 $new_attrs{transdate} = ($order->transdate == $saved_order->transdate)
220 ? DateTime->today_local
223 # Set new reqdate unless changed if it is enabled in client config
224 if ($order->reqdate == $saved_order->reqdate) {
225 my $extra_days = $self->type eq sales_quotation_type() ? $::instance_conf->get_reqdate_interval :
226 $self->type eq sales_order_type() ? $::instance_conf->get_delivery_date_interval : 1;
228 if ( ($self->type eq sales_order_type() && !$::instance_conf->get_deliverydate_on)
229 || ($self->type eq sales_quotation_type() && !$::instance_conf->get_reqdate_on)) {
230 $new_attrs{reqdate} = '';
232 $new_attrs{reqdate} = DateTime->today_local->next_workday(extra_days => $extra_days);
235 $new_attrs{reqdate} = $order->reqdate;
239 $new_attrs{employee} = SL::DB::Manager::Employee->current;
241 # Create new record from current one
242 $self->order(SL::DB::DeliveryOrder->new_from($order, destination_type => $order->type, attributes => \%new_attrs));
244 # no linked records on save as new
245 delete $::form->{$_} for qw(converted_from_oe_id converted_from_orderitems_ids);
248 $self->action_save();
253 # This is called if "print" is pressed in the print dialog.
254 # If PDF creation was requested and succeeded, the pdf is offered for download
255 # via send_file (which uses ajax in this case).
259 my $errors = $self->save();
261 if (scalar @{ $errors }) {
262 $self->js->flash('error', $_) foreach @{ $errors };
263 return $self->js->render();
266 $self->js_reset_order_and_item_ids_after_save;
268 my $format = $::form->{print_options}->{format};
269 my $media = $::form->{print_options}->{media};
270 my $formname = $::form->{print_options}->{formname};
271 my $copies = $::form->{print_options}->{copies};
272 my $groupitems = $::form->{print_options}->{groupitems};
273 my $printer_id = $::form->{print_options}->{printer_id};
275 # only pdf and opendocument by now
276 if (none { $format eq $_ } qw(pdf opendocument opendocument_pdf)) {
277 return $self->js->flash('error', t8('Format \'#1\' is not supported yet/anymore.', $format))->render;
280 # only screen or printer by now
281 if (none { $media eq $_ } qw(screen printer)) {
282 return $self->js->flash('error', t8('Media \'#1\' is not supported yet/anymore.', $media))->render;
285 # create a form for generate_attachment_filename
286 my $form = Form->new;
287 $form->{$self->nr_key()} = $self->order->number;
288 $form->{type} = $self->type;
289 $form->{format} = $format;
290 $form->{formname} = $formname;
291 $form->{language} = '_' . $self->order->language->template_code if $self->order->language;
292 my $pdf_filename = $form->generate_attachment_filename();
295 my @errors = generate_pdf($self->order, \$pdf, { format => $format,
296 formname => $formname,
297 language => $self->order->language,
298 printer_id => $printer_id,
299 groupitems => $groupitems });
300 if (scalar @errors) {
301 return $self->js->flash('error', t8('Conversion to PDF failed: #1', $errors[0]))->render;
304 if ($media eq 'screen') {
306 $self->js->flash('info', t8('The PDF has been created'));
309 type => SL::MIME->mime_type_from_ext($pdf_filename),
310 name => $pdf_filename,
314 } elsif ($media eq 'printer') {
316 my $printer_id = $::form->{print_options}->{printer_id};
317 SL::DB::Printer->new(id => $printer_id)->load->print_document(
322 $self->js->flash('info', t8('The PDF has been printed'));
325 my @warnings = store_pdf_to_webdav_and_filemanagement($self->order, $pdf, $pdf_filename);
326 if (scalar @warnings) {
327 $self->js->flash('warning', $_) for @warnings;
330 $self->save_history('PRINTED');
333 ->run('kivi.ActionBar.setEnabled', '#save_and_email_action')
336 sub action_preview_pdf {
339 my $errors = $self->save();
340 if (scalar @{ $errors }) {
341 $self->js->flash('error', $_) foreach @{ $errors };
342 return $self->js->render();
345 $self->js_reset_order_and_item_ids_after_save;
348 my $media = 'screen';
349 my $formname = $self->type;
352 # create a form for generate_attachment_filename
353 my $form = Form->new;
354 $form->{$self->nr_key()} = $self->order->number;
355 $form->{type} = $self->type;
356 $form->{format} = $format;
357 $form->{formname} = $formname;
358 $form->{language} = '_' . $self->order->language->template_code if $self->order->language;
359 my $pdf_filename = $form->generate_attachment_filename();
362 my @errors = generate_pdf($self->order, \$pdf, { format => $format,
363 formname => $formname,
364 language => $self->order->language,
366 if (scalar @errors) {
367 return $self->js->flash('error', t8('Conversion to PDF failed: #1', $errors[0]))->render;
369 $self->save_history('PREVIEWED');
370 $self->js->flash('info', t8('The PDF has been previewed'));
374 type => SL::MIME->mime_type_from_ext($pdf_filename),
375 name => $pdf_filename,
380 # open the email dialog
381 sub action_save_and_show_email_dialog {
384 my $errors = $self->save();
386 if (scalar @{ $errors }) {
387 $self->js->flash('error', $_) foreach @{ $errors };
388 return $self->js->render();
391 my $cv_method = $self->cv;
393 if (!$self->order->$cv_method) {
394 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'))
399 $email_form->{to} = $self->order->contact->cp_email if $self->order->contact;
400 $email_form->{to} ||= $self->order->$cv_method->email;
401 $email_form->{cc} = $self->order->$cv_method->cc;
402 $email_form->{bcc} = join ', ', grep $_, $self->order->$cv_method->bcc, SL::DB::Default->get->global_bcc;
403 # Todo: get addresses from shipto, if any
405 my $form = Form->new;
406 $form->{$self->nr_key()} = $self->order->number;
407 $form->{cusordnumber} = $self->order->cusordnumber;
408 $form->{formname} = $self->type;
409 $form->{type} = $self->type;
410 $form->{language} = '_' . $self->order->language->template_code if $self->order->language;
411 $form->{language_id} = $self->order->language->id if $self->order->language;
412 $form->{format} = 'pdf';
413 $form->{cp_id} = $self->order->contact->cp_id if $self->order->contact;
415 $email_form->{subject} = $form->generate_email_subject();
416 $email_form->{attachment_filename} = $form->generate_attachment_filename();
417 $email_form->{message} = $form->generate_email_body();
418 $email_form->{js_send_function} = 'kivi.Order.send_email()';
420 my %files = $self->get_files_for_email_dialog();
421 $self->{all_employees} = SL::DB::Manager::Employee->get_all(query => [ deleted => 0 ]);
422 my $dialog_html = $self->render('common/_send_email_dialog', { output => 0 },
423 email_form => $email_form,
424 show_bcc => $::auth->assert('email_bcc', 'may fail'),
426 is_customer => $self->cv eq 'customer',
427 ALL_EMPLOYEES => $self->{all_employees},
431 ->run('kivi.Order.show_email_dialog', $dialog_html)
438 # Todo: handling error messages: flash is not displayed in dialog, but in the main form
439 sub action_send_email {
442 my $errors = $self->save();
444 if (scalar @{ $errors }) {
445 $self->js->run('kivi.Order.close_email_dialog');
446 $self->js->flash('error', $_) foreach @{ $errors };
447 return $self->js->render();
450 $self->js_reset_order_and_item_ids_after_save;
452 my $email_form = delete $::form->{email_form};
453 my %field_names = (to => 'email');
455 $::form->{ $field_names{$_} // $_ } = $email_form->{$_} for keys %{ $email_form };
457 # for Form::cleanup which may be called in Form::send_email
458 $::form->{cwd} = getcwd();
459 $::form->{tmpdir} = $::lx_office_conf{paths}->{userspath};
461 $::form->{$_} = $::form->{print_options}->{$_} for keys %{ $::form->{print_options} };
462 $::form->{media} = 'email';
464 if (($::form->{attachment_policy} // '') !~ m{^(?:old_file|no_file)$}) {
466 my @errors = generate_pdf($self->order, \$pdf, {media => $::form->{media},
467 format => $::form->{print_options}->{format},
468 formname => $::form->{print_options}->{formname},
469 language => $self->order->language,
470 printer_id => $::form->{print_options}->{printer_id},
471 groupitems => $::form->{print_options}->{groupitems}});
472 if (scalar @errors) {
473 return $self->js->flash('error', t8('Conversion to PDF failed: #1', $errors[0]))->render($self);
476 my @warnings = store_pdf_to_webdav_and_filemanagement($self->order, $pdf, $::form->{attachment_filename});
477 if (scalar @warnings) {
478 flash_later('warning', $_) for @warnings;
481 my $sfile = SL::SessionFile::Random->new(mode => "w");
482 $sfile->fh->print($pdf);
485 $::form->{tmpfile} = $sfile->file_name;
486 $::form->{tmpdir} = $sfile->get_path; # for Form::cleanup which may be called in Form::send_email
489 $::form->{id} = $self->order->id; # this is used in SL::Mailer to create a linked record to the mail
490 $::form->send_email(\%::myconfig, 'pdf');
493 my $intnotes = $self->order->intnotes;
494 $intnotes .= "\n\n" if $self->order->intnotes;
495 $intnotes .= t8('[email]') . "\n";
496 $intnotes .= t8('Date') . ": " . $::locale->format_date_object(DateTime->now_local, precision => 'seconds') . "\n";
497 $intnotes .= t8('To (email)') . ": " . $::form->{email} . "\n";
498 $intnotes .= t8('Cc') . ": " . $::form->{cc} . "\n" if $::form->{cc};
499 $intnotes .= t8('Bcc') . ": " . $::form->{bcc} . "\n" if $::form->{bcc};
500 $intnotes .= t8('Subject') . ": " . $::form->{subject} . "\n\n";
501 $intnotes .= t8('Message') . ": " . $::form->{message};
503 $self->order->update_attributes(intnotes => $intnotes);
505 $self->save_history('MAILED');
507 flash_later('info', t8('The email has been sent.'));
509 my @redirect_params = (
512 id => $self->order->id,
515 $self->redirect_to(@redirect_params);
518 # save the order and redirect to the frontend subroutine for a new
520 sub action_save_and_delivery_order {
523 $self->save_and_redirect_to(
524 controller => 'oe.pl',
525 action => 'oe_delivery_order_from_order',
529 # save the order and redirect to the frontend subroutine for a new
531 sub action_save_and_invoice {
534 $self->save_and_redirect_to(
535 controller => 'oe.pl',
536 action => 'oe_invoice_from_order',
540 # workflow from sales order to sales quotation
541 sub action_sales_quotation {
542 $_[0]->workflow_sales_or_request_for_quotation();
545 # workflow from sales order to sales quotation
546 sub action_request_for_quotation {
547 $_[0]->workflow_sales_or_request_for_quotation();
550 # workflow from sales quotation to sales order
551 sub action_sales_order {
552 $_[0]->workflow_sales_or_purchase_order();
555 # workflow from rfq to purchase order
556 sub action_purchase_order {
557 $_[0]->workflow_sales_or_purchase_order();
560 # workflow from purchase order to ap transaction
561 sub action_save_and_ap_transaction {
564 $self->save_and_redirect_to(
565 controller => 'ap.pl',
566 action => 'add_from_purchase_order',
570 # set form elements in respect to a changed customer or vendor
572 # This action is called on an change of the customer/vendor picker.
573 sub action_customer_vendor_changed {
576 setup_order_from_cv($self->order);
578 my $cv_method = $self->cv;
580 if ($self->order->$cv_method->contacts && scalar @{ $self->order->$cv_method->contacts } > 0) {
581 $self->js->show('#cp_row');
583 $self->js->hide('#cp_row');
586 if ($self->order->$cv_method->shipto && scalar @{ $self->order->$cv_method->shipto } > 0) {
587 $self->js->show('#shipto_selection');
589 $self->js->hide('#shipto_selection');
592 $self->js->val( '#order_salesman_id', $self->order->salesman_id) if $self->order->is_sales;
595 ->replaceWith('#order_cp_id', $self->build_contact_select)
596 ->replaceWith('#order_shipto_id', $self->build_shipto_select)
597 ->replaceWith('#shipto_inputs ', $self->build_shipto_inputs)
598 ->replaceWith('#business_info_row', $self->build_business_info_row)
599 ->val( '#order_taxzone_id', $self->order->taxzone_id)
600 ->val( '#order_taxincluded', $self->order->taxincluded)
601 ->val( '#order_currency_id', $self->order->currency_id)
602 ->val( '#order_payment_id', $self->order->payment_id)
603 ->val( '#order_delivery_term_id', $self->order->delivery_term_id)
604 ->val( '#order_intnotes', $self->order->intnotes)
605 ->val( '#order_language_id', $self->order->$cv_method->language_id)
606 ->focus( '#order_' . $self->cv . '_id')
607 ->run('kivi.Order.update_exchangerate');
609 $self->js_redisplay_cvpartnumbers;
613 # open the dialog for customer/vendor details
614 sub action_show_customer_vendor_details_dialog {
617 my $is_customer = 'customer' eq $::form->{vc};
620 $cv = SL::DB::Customer->new(id => $::form->{vc_id})->load;
622 $cv = SL::DB::Vendor->new(id => $::form->{vc_id})->load;
625 my %details = map { $_ => $cv->$_ } @{$cv->meta->columns};
626 $details{discount_as_percent} = $cv->discount_as_percent;
627 $details{creditlimt} = $cv->creditlimit_as_number;
628 $details{business} = $cv->business->description if $cv->business;
629 $details{language} = $cv->language_obj->description if $cv->language_obj;
630 $details{delivery_terms} = $cv->delivery_term->description if $cv->delivery_term;
631 $details{payment_terms} = $cv->payment->description if $cv->payment;
632 $details{pricegroup} = $cv->pricegroup->pricegroup if $is_customer && $cv->pricegroup;
634 foreach my $entry (@{ $cv->shipto }) {
635 push @{ $details{SHIPTO} }, { map { $_ => $entry->$_ } @{$entry->meta->columns} };
637 foreach my $entry (@{ $cv->contacts }) {
638 push @{ $details{CONTACTS} }, { map { $_ => $entry->$_ } @{$entry->meta->columns} };
641 $_[0]->render('common/show_vc_details', { layout => 0 },
642 is_customer => $is_customer,
647 # called if a unit in an existing item row is changed
648 sub action_unit_changed {
651 my $idx = first_index { $_ eq $::form->{item_id} } @{ $::form->{orderitem_ids} };
652 my $item = $self->order->items_sorted->[$idx];
654 my $old_unit_obj = SL::DB::Unit->new(name => $::form->{old_unit})->load;
655 $item->sellprice($item->unit_obj->convert_to($item->sellprice, $old_unit_obj));
658 ->run('kivi.Order.update_sellprice', $::form->{item_id}, $item->sellprice_as_number);
659 $self->js_redisplay_line_values;
663 # add an item row for a new item entered in the input row
664 sub action_add_item {
667 delete $::form->{add_item}->{create_part_type};
669 my $form_attr = $::form->{add_item};
671 return unless $form_attr->{parts_id};
673 my $item = new_item($self->order, $form_attr);
675 $self->order->add_items($item);
677 $self->get_item_cvpartnumber($item);
679 my $item_id = join('_', 'new', Time::HiRes::gettimeofday(), int rand 1000000000000);
680 my $row_as_html = $self->p->render('delivery_order/tabs/_row',
686 if ($::form->{insert_before_item_id}) {
688 ->before ('.row_entry:has(#item_' . $::form->{insert_before_item_id} . ')', $row_as_html);
691 ->append('#row_table_id', $row_as_html);
694 if ( $item->part->is_assortment ) {
695 $form_attr->{qty_as_number} = 1 unless $form_attr->{qty_as_number};
696 foreach my $assortment_item ( @{$item->part->assortment_items} ) {
697 my $attr = { parts_id => $assortment_item->parts_id,
698 qty => $assortment_item->qty * $::form->parse_amount(\%::myconfig, $form_attr->{qty_as_number}), # TODO $form_attr->{unit}
699 unit => $assortment_item->unit,
700 description => $assortment_item->part->description,
702 my $item = new_item($self->order, $attr);
704 # set discount to 100% if item isn't supposed to be charged, overwriting any customer discount
705 $item->discount(1) unless $assortment_item->charge;
707 $self->order->add_items( $item );
708 $self->get_item_cvpartnumber($item);
709 my $item_id = join('_', 'new', Time::HiRes::gettimeofday(), int rand 1000000000000);
710 my $row_as_html = $self->p->render('delivery_order/tabs/_row',
715 if ($::form->{insert_before_item_id}) {
717 ->before ('.row_entry:has(#item_' . $::form->{insert_before_item_id} . ')', $row_as_html);
720 ->append('#row_table_id', $row_as_html);
726 ->val('.add_item_input', '')
727 ->run('kivi.Order.init_row_handlers')
728 ->run('kivi.Order.renumber_positions')
729 ->focus('#add_item_parts_id_name');
731 $self->js->run('kivi.Order.row_table_scroll_down') if !$::form->{insert_before_item_id};
736 # add item rows for multiple items at once
737 sub action_add_multi_items {
740 my @form_attr = grep { $_->{qty_as_number} } @{ $::form->{add_items} };
741 return $self->js->render() unless scalar @form_attr;
744 foreach my $attr (@form_attr) {
745 my $item = new_item($self->order, $attr);
747 if ( $item->part->is_assortment ) {
748 foreach my $assortment_item ( @{$item->part->assortment_items} ) {
749 my $attr = { parts_id => $assortment_item->parts_id,
750 qty => $assortment_item->qty * $item->qty, # TODO $form_attr->{unit}
751 unit => $assortment_item->unit,
752 description => $assortment_item->part->description,
754 my $item = new_item($self->order, $attr);
756 # set discount to 100% if item isn't supposed to be charged, overwriting any customer discount
757 $item->discount(1) unless $assortment_item->charge;
762 $self->order->add_items(@items);
764 foreach my $item (@items) {
765 $self->get_item_cvpartnumber($item);
766 my $item_id = join('_', 'new', Time::HiRes::gettimeofday(), int rand 1000000000000);
767 my $row_as_html = $self->p->render('delivery_order/tabs/_row',
773 if ($::form->{insert_before_item_id}) {
775 ->before ('.row_entry:has(#item_' . $::form->{insert_before_item_id} . ')', $row_as_html);
778 ->append('#row_table_id', $row_as_html);
783 ->run('kivi.Part.close_picker_dialogs')
784 ->run('kivi.Order.init_row_handlers')
785 ->run('kivi.Order.renumber_positions')
786 ->focus('#add_item_parts_id_name');
788 $self->js->run('kivi.Order.row_table_scroll_down') if !$::form->{insert_before_item_id};
793 sub action_update_exchangerate {
797 is_standard => $self->order->currency_id == $::instance_conf->get_currency_id,
798 currency_name => $self->order->currency->name,
801 $self->render(\SL::JSON::to_json($data), { type => 'json', process => 0 });
804 # redisplay item rows if they are sorted by an attribute
805 sub action_reorder_items {
809 partnumber => sub { $_[0]->part->partnumber },
810 description => sub { $_[0]->description },
811 qty => sub { $_[0]->qty },
812 sellprice => sub { $_[0]->sellprice },
813 discount => sub { $_[0]->discount },
814 cvpartnumber => sub { $_[0]->{cvpartnumber} },
817 $self->get_item_cvpartnumber($_) for @{$self->order->items_sorted};
819 my $method = $sort_keys{$::form->{order_by}};
820 my @to_sort = map { { old_pos => $_->position, order_by => $method->($_) } } @{ $self->order->items_sorted };
821 if ($::form->{sort_dir}) {
822 if ( $::form->{order_by} =~ m/qty|sellprice|discount/ ){
823 @to_sort = sort { $a->{order_by} <=> $b->{order_by} } @to_sort;
825 @to_sort = sort { $a->{order_by} cmp $b->{order_by} } @to_sort;
828 if ( $::form->{order_by} =~ m/qty|sellprice|discount/ ){
829 @to_sort = sort { $b->{order_by} <=> $a->{order_by} } @to_sort;
831 @to_sort = sort { $b->{order_by} cmp $a->{order_by} } @to_sort;
835 ->run('kivi.Order.redisplay_items', \@to_sort)
839 # show the popup to choose a price/discount source
840 sub action_price_popup {
843 my $idx = first_index { $_ eq $::form->{item_id} } @{ $::form->{orderitem_ids} };
844 my $item = $self->order->items_sorted->[$idx];
846 $self->render_price_dialog($item);
849 # save the order in a session variable and redirect to the part controller
850 sub action_create_part {
853 my $previousform = $::auth->save_form_in_session(non_scalars => 1);
855 my $callback = $self->url_for(
856 action => 'return_from_create_part',
857 type => $self->type, # type is needed for check_auth on return
858 previousform => $previousform,
861 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.'));
863 my @redirect_params = (
864 controller => 'Part',
866 part_type => $::form->{add_item}->{create_part_type},
867 callback => $callback,
871 $self->redirect_to(@redirect_params);
874 sub action_return_from_create_part {
877 $self->{created_part} = SL::DB::Part->new(id => delete $::form->{new_parts_id})->load if $::form->{new_parts_id};
879 $::auth->restore_form_from_session(delete $::form->{previousform});
881 # set item ids to new fake id, to identify them as new items
882 foreach my $item (@{$self->order->items_sorted}) {
883 $item->{new_fake_id} = join('_', 'new', Time::HiRes::gettimeofday(), int rand 1000000000000);
886 $self->get_unalterable_data();
889 # trigger rendering values for second row/longdescription as hidden,
890 # because they are loaded only on demand. So we need to keep the values
892 $_->{render_second_row} = 1 for @{ $self->order->items_sorted };
893 $_->{render_longdescription} = 1 for @{ $self->order->items_sorted };
896 'delivery_order/form',
897 title => $self->get_title_for('edit'),
898 %{$self->{template_args}}
903 # load the second row for one or more items
905 # This action gets the html code for all items second rows by rendering a template for
906 # the second row and sets the html code via client js.
907 sub action_load_second_rows {
910 foreach my $item_id (@{ $::form->{item_ids} }) {
911 my $idx = first_index { $_ eq $item_id } @{ $::form->{orderitem_ids} };
912 my $item = $self->order->items_sorted->[$idx];
914 $self->js_load_second_row($item, $item_id, 0);
917 $self->js->run('kivi.Order.init_row_handlers') if $self->order->is_sales; # for lastcosts change-callback
922 # update description, notes and sellprice from master data
923 sub action_update_row_from_master_data {
926 foreach my $item_id (@{ $::form->{item_ids} }) {
927 my $idx = first_index { $_ eq $item_id } @{ $::form->{orderitem_ids} };
928 my $item = $self->order->items_sorted->[$idx];
929 my $texts = get_part_texts($item->part, $self->order->language_id);
931 $item->description($texts->{description});
932 $item->longdescription($texts->{longdescription});
934 my $price_source = SL::PriceSource->new(record_item => $item, record => $self->order);
937 if ($item->part->is_assortment) {
938 # add assortment items with price 0, as the components carry the price
939 $price_src = $price_source->price_from_source("");
940 $price_src->price(0);
942 $price_src = $price_source->best_price
943 ? $price_source->best_price
944 : $price_source->price_from_source("");
945 $price_src->price($::form->round_amount($price_src->price / $self->order->exchangerate, 5)) if $self->order->exchangerate;
946 $price_src->price(0) if !$price_source->best_price;
950 $item->sellprice($price_src->price);
951 $item->active_price_source($price_src);
954 ->run('kivi.Order.update_sellprice', $item_id, $item->sellprice_as_number)
955 ->html('.row_entry:has(#item_' . $item_id . ') [name = "partnumber"] a', $item->part->partnumber)
956 ->val ('.row_entry:has(#item_' . $item_id . ') [name = "order.orderitems[].description"]', $item->description)
957 ->val ('.row_entry:has(#item_' . $item_id . ') [name = "order.orderitems[].longdescription"]', $item->longdescription);
959 if ($self->search_cvpartnumber) {
960 $self->get_item_cvpartnumber($item);
961 $self->js->html('.row_entry:has(#item_' . $item_id . ') [name = "cvpartnumber"]', $item->{cvpartnumber});
965 $self->js_redisplay_line_values;
970 sub js_load_second_row {
971 my ($self, $item, $item_id, $do_parse) = @_;
974 # Parse values from form (they are formated while rendering (template)).
975 # Workaround to pre-parse number-cvars (parse_custom_variable_values does not parse number values).
976 # This parsing is not necessary at all, if we assure that the second row/cvars are only loaded once.
977 foreach my $var (@{ $item->cvars_by_config }) {
978 $var->unparsed_value($::form->parse_amount(\%::myconfig, $var->{__unparsed_value})) if ($var->config->type eq 'number' && exists($var->{__unparsed_value}));
980 $item->parse_custom_variable_values;
983 my $row_as_html = $self->p->render('delivery_order/tabs/_second_row', ITEM => $item, TYPE => $self->type);
986 ->html('#second_row_' . $item_id, $row_as_html)
987 ->data('#second_row_' . $item_id, 'loaded', 1);
990 sub js_redisplay_line_values {
993 my $is_sales = $self->order->is_sales;
995 # sales orders with margins
1000 $::form->format_amount(\%::myconfig, $_->{linetotal}, 2, 0),
1001 $::form->format_amount(\%::myconfig, $_->{marge_total}, 2, 0),
1002 $::form->format_amount(\%::myconfig, $_->{marge_percent}, 2, 0),
1003 ]} @{ $self->order->items_sorted };
1007 $::form->format_amount(\%::myconfig, $_->{linetotal}, 2, 0),
1008 ]} @{ $self->order->items_sorted };
1012 ->run('kivi.Order.redisplay_line_values', $is_sales, \@data);
1015 sub js_redisplay_cvpartnumbers {
1018 $self->get_item_cvpartnumber($_) for @{$self->order->items_sorted};
1020 my @data = map {[$_->{cvpartnumber}]} @{ $self->order->items_sorted };
1023 ->run('kivi.Order.redisplay_cvpartnumbers', \@data);
1026 sub js_reset_order_and_item_ids_after_save {
1030 ->val('#id', $self->order->id)
1031 ->val('#converted_from_oe_id', '')
1032 ->val('#order_' . $self->nr_key(), $self->order->number);
1035 foreach my $form_item_id (@{ $::form->{orderitem_ids} }) {
1036 next if !$self->order->items_sorted->[$idx]->id;
1037 next if $form_item_id !~ m{^new};
1039 ->val ('[name="orderitem_ids[+]"][value="' . $form_item_id . '"]', $self->order->items_sorted->[$idx]->id)
1040 ->val ('#item_' . $form_item_id, $self->order->items_sorted->[$idx]->id)
1041 ->attr('#item_' . $form_item_id, "id", 'item_' . $self->order->items_sorted->[$idx]->id);
1045 $self->js->val('[name="converted_from_orderitems_ids[+]"]', '');
1052 sub init_valid_types {
1053 [ sales_order_type(), purchase_order_type(), sales_quotation_type(), request_quotation_type() ];
1059 if (none { $::form->{type} eq $_ } @{$self->valid_types}) {
1060 die "Not a valid type for order";
1063 $self->type($::form->{type});
1069 my $cv = (any { $self->type eq $_ } (sales_order_type(), sales_quotation_type())) ? 'customer'
1070 : (any { $self->type eq $_ } (purchase_order_type(), request_quotation_type())) ? 'vendor'
1071 : die "Not a valid type for order";
1076 sub init_search_cvpartnumber {
1079 my $user_prefs = SL::Helper::UserPreferences::PartPickerSearch->new();
1080 my $search_cvpartnumber;
1081 $search_cvpartnumber = !!$user_prefs->get_sales_search_customer_partnumber() if $self->cv eq 'customer';
1082 $search_cvpartnumber = !!$user_prefs->get_purchase_search_makemodel() if $self->cv eq 'vendor';
1084 return $search_cvpartnumber;
1087 sub init_show_update_button {
1090 !!SL::Helper::UserPreferences::UpdatePositions->new()->get_show_update_button();
1101 sub init_all_price_factors {
1102 SL::DB::Manager::PriceFactor->get_all;
1105 sub init_part_picker_classification_ids {
1107 my $attribute = 'used_for_' . ($self->type =~ m{sales} ? 'sale' : 'purchase');
1109 return [ map { $_->id } @{ SL::DB::Manager::PartClassification->get_all(where => [ $attribute => 1 ]) } ];
1115 my $right_for = { map { $_ => $_.'_edit' } @{$self->valid_types} };
1117 my $right = $right_for->{ $self->type };
1118 $right ||= 'DOES_NOT_EXIST';
1120 $::auth->assert($right);
1123 # build the selection box for contacts
1125 # Needed, if customer/vendor changed.
1126 sub build_contact_select {
1129 select_tag('order.cp_id', [ $self->order->{$self->cv}->contacts ],
1130 value_key => 'cp_id',
1131 title_key => 'full_name_dep',
1132 default => $self->order->cp_id,
1134 style => 'width: 300px',
1138 # build the selection box for shiptos
1140 # Needed, if customer/vendor changed.
1141 sub build_shipto_select {
1144 select_tag('order.shipto_id',
1145 [ {displayable_id => t8("No/individual shipping address"), shipto_id => ''}, $self->order->{$self->cv}->shipto ],
1146 value_key => 'shipto_id',
1147 title_key => 'displayable_id',
1148 default => $self->order->shipto_id,
1150 style => 'width: 300px',
1154 # build the inputs for the cusom shipto dialog
1156 # Needed, if customer/vendor changed.
1157 sub build_shipto_inputs {
1160 my $content = $self->p->render('common/_ship_to_dialog',
1161 vc_obj => $self->order->customervendor,
1162 cs_obj => $self->order->custom_shipto,
1163 cvars => $self->order->custom_shipto->cvars_by_config,
1164 id_selector => '#order_shipto_id');
1166 div_tag($content, id => 'shipto_inputs');
1169 # render the info line for business
1171 # Needed, if customer/vendor changed.
1172 sub build_business_info_row
1174 $_[0]->p->render('delivery_order/tabs/_business_info_row', SELF => $_[0]);
1181 return if !$::form->{id};
1183 $self->order(SL::DB::DeliveryOrder->new(id => $::form->{id})->load);
1185 # Add an empty custom shipto to the order, so that the dialog can render the cvar inputs.
1186 # You need a custom shipto object to call cvars_by_config to get the cvars.
1187 $self->order->custom_shipto(SL::DB::Shipto->new(module => 'OE', custom_variables => [])) if !$self->order->custom_shipto;
1189 return $self->order;
1192 # load or create a new order object
1194 # And assign changes from the form to this object.
1195 # If the order is loaded from db, check if items are deleted in the form,
1196 # remove them form the object and collect them for removing from db on saving.
1197 # Then create/update items from form (via make_item) and add them.
1201 # add_items adds items to an order with no items for saving, but they cannot
1202 # be retrieved via items until the order is saved. Adding empty items to new
1203 # order here solves this problem.
1205 $order = SL::DB::DeliveryOrder->new(id => $::form->{id})->load(with => [ 'orderitems', 'orderitems.part' ]) if $::form->{id};
1206 $order ||= SL::DB::DeliveryOrder->new(orderitems => [],
1207 quotation => (any { $self->type eq $_ } (sales_quotation_type(), request_quotation_type())),
1208 currency_id => $::instance_conf->get_currency_id(),);
1210 my $cv_id_method = $self->cv . '_id';
1211 if (!$::form->{id} && $::form->{$cv_id_method}) {
1212 $order->$cv_id_method($::form->{$cv_id_method});
1213 setup_order_from_cv($order);
1216 my $form_orderitems = delete $::form->{order}->{orderitems};
1218 $order->assign_attributes(%{$::form->{order}});
1220 $self->setup_custom_shipto_from_form($order, $::form);
1222 # remove deleted items
1223 $self->item_ids_to_delete([]);
1224 foreach my $idx (reverse 0..$#{$order->orderitems}) {
1225 my $item = $order->orderitems->[$idx];
1226 if (none { $item->id == $_->{id} } @{$form_orderitems}) {
1227 splice @{$order->orderitems}, $idx, 1;
1228 push @{$self->item_ids_to_delete}, $item->id;
1234 foreach my $form_attr (@{$form_orderitems}) {
1235 my $item = make_item($order, $form_attr);
1236 $item->position($pos);
1240 $order->add_items(grep {!$_->id} @items);
1245 # create or update items from form
1247 # Make item objects from form values. For items already existing read from db.
1248 # Create a new item else. And assign attributes.
1250 my ($record, $attr) = @_;
1253 $item = first { $_->id == $attr->{id} } @{$record->items} if $attr->{id};
1255 my $is_new = !$item;
1257 # add_custom_variables adds cvars to an orderitem with no cvars for saving, but
1258 # they cannot be retrieved via custom_variables until the order/orderitem is
1259 # saved. Adding empty custom_variables to new orderitem here solves this problem.
1260 $item ||= SL::DB::DeliveryOrderItem->new(custom_variables => []);
1262 $item->assign_attributes(%$attr);
1265 my $texts = get_part_texts($item->part, $record->language_id);
1266 $item->longdescription($texts->{longdescription}) if !defined $attr->{longdescription};
1267 $item->project_id($record->globalproject_id) if !defined $attr->{project_id};
1268 $item->lastcost($record->is_sales ? $item->part->lastcost : 0) if !defined $attr->{lastcost_as_number};
1276 # This is used to add one item
1278 my ($record, $attr) = @_;
1280 my $item = SL::DB::DeliveryOrderItem->new;
1282 # Remove attributes where the user left or set the inputs empty.
1283 # So these attributes will be undefined and we can distinguish them
1284 # from zero later on.
1285 for (qw(qty_as_number sellprice_as_number discount_as_percent)) {
1286 delete $attr->{$_} if $attr->{$_} eq '';
1289 $item->assign_attributes(%$attr);
1291 my $part = SL::DB::Part->new(id => $attr->{parts_id})->load;
1292 my $price_source = SL::PriceSource->new(record_item => $item, record => $record);
1294 $item->unit($part->unit) if !$item->unit;
1297 if ( $part->is_assortment ) {
1298 # add assortment items with price 0, as the components carry the price
1299 $price_src = $price_source->price_from_source("");
1300 $price_src->price(0);
1301 } elsif (defined $item->sellprice) {
1302 $price_src = $price_source->price_from_source("");
1303 $price_src->price($item->sellprice);
1305 $price_src = $price_source->best_price
1306 ? $price_source->best_price
1307 : $price_source->price_from_source("");
1308 $price_src->price(0) if !$price_source->best_price;
1312 if (defined $item->discount) {
1313 $discount_src = $price_source->discount_from_source("");
1314 $discount_src->discount($item->discount);
1316 $discount_src = $price_source->best_discount
1317 ? $price_source->best_discount
1318 : $price_source->discount_from_source("");
1319 $discount_src->discount(0) if !$price_source->best_discount;
1323 $new_attr{part} = $part;
1324 $new_attr{description} = $part->description if ! $item->description;
1325 $new_attr{qty} = 1.0 if ! $item->qty;
1326 $new_attr{price_factor_id} = $part->price_factor_id if ! $item->price_factor_id;
1327 $new_attr{sellprice} = $price_src->price;
1328 $new_attr{discount} = $discount_src->discount;
1329 $new_attr{active_price_source} = $price_src;
1330 $new_attr{active_discount_source} = $discount_src;
1331 $new_attr{longdescription} = $part->notes if ! defined $attr->{longdescription};
1332 $new_attr{project_id} = $record->globalproject_id;
1333 $new_attr{lastcost} = $record->is_sales ? $part->lastcost : 0;
1335 # add_custom_variables adds cvars to an orderitem with no cvars for saving, but
1336 # they cannot be retrieved via custom_variables until the order/orderitem is
1337 # saved. Adding empty custom_variables to new orderitem here solves this problem.
1338 $new_attr{custom_variables} = [];
1340 my $texts = get_part_texts($part, $record->language_id, description => $new_attr{description}, longdescription => $new_attr{longdescription});
1342 $item->assign_attributes(%new_attr, %{ $texts });
1347 sub setup_order_from_cv {
1350 $order->$_($order->customervendor->$_) for (qw(taxzone_id payment_id delivery_term_id currency_id));
1352 $order->intnotes($order->customervendor->notes);
1354 if ($order->is_sales) {
1355 $order->salesman_id($order->customer->salesman_id || SL::DB::Manager::Employee->current->id);
1356 $order->taxincluded(defined($order->customer->taxincluded_checked)
1357 ? $order->customer->taxincluded_checked
1358 : $::myconfig{taxincluded_checked});
1363 # setup custom shipto from form
1365 # The dialog returns form variables starting with 'shipto' and cvars starting
1366 # with 'shiptocvar_'.
1367 # Mark it to be deleted if a shipto from master data is selected
1368 # (i.e. order has a shipto).
1369 # Else, update or create a new custom shipto. If the fields are empty, it
1370 # will not be saved on save.
1371 sub setup_custom_shipto_from_form {
1372 my ($self, $order, $form) = @_;
1374 if ($order->shipto) {
1375 $self->is_custom_shipto_to_delete(1);
1377 my $custom_shipto = $order->custom_shipto || $order->custom_shipto(SL::DB::Shipto->new(module => 'OE', custom_variables => []));
1379 my $shipto_cvars = {map { my ($key) = m{^shiptocvar_(.+)}; $key => delete $form->{$_}} grep { m{^shiptocvar_} } keys %$form};
1380 my $shipto_attrs = {map { $_ => delete $form->{$_}} grep { m{^shipto} } keys %$form};
1382 $custom_shipto->assign_attributes(%$shipto_attrs);
1383 $custom_shipto->cvar_by_name($_)->value($shipto_cvars->{$_}) for keys %$shipto_cvars;
1387 # get data for saving, printing, ..., that is not changed in the form
1389 # Only cvars for now.
1390 sub get_unalterable_data {
1393 foreach my $item (@{ $self->order->items }) {
1394 # autovivify all cvars that are not in the form (cvars_by_config can do it).
1395 # workaround to pre-parse number-cvars (parse_custom_variable_values does not parse number values).
1396 foreach my $var (@{ $item->cvars_by_config }) {
1397 $var->unparsed_value($::form->parse_amount(\%::myconfig, $var->{__unparsed_value})) if ($var->config->type eq 'number' && exists($var->{__unparsed_value}));
1399 $item->parse_custom_variable_values;
1405 # And remove related files in the spool directory
1410 my $db = $self->order->db;
1412 $db->with_transaction(
1414 my @spoolfiles = grep { $_ } map { $_->spoolfile } @{ SL::DB::Manager::Status->get_all(where => [ trans_id => $self->order->id ]) };
1415 $self->order->delete;
1416 my $spool = $::lx_office_conf{paths}->{spool};
1417 unlink map { "$spool/$_" } @spoolfiles if $spool;
1419 $self->save_history('DELETED');
1422 }) || push(@{$errors}, $db->error);
1429 # And delete items that are deleted in the form.
1434 my $db = $self->order->db;
1436 $db->with_transaction(sub {
1437 # delete custom shipto if it is to be deleted or if it is empty
1438 if ($self->order->custom_shipto && ($self->is_custom_shipto_to_delete || $self->order->custom_shipto->is_empty)) {
1439 $self->order->custom_shipto->delete if $self->order->custom_shipto->shipto_id;
1440 $self->order->custom_shipto(undef);
1443 SL::DB::DeliveryOrderItem->new(id => $_)->delete for @{$self->item_ids_to_delete || []};
1444 $self->order->save(cascade => 1);
1447 if ($::form->{converted_from_oe_id}) {
1448 my @converted_from_oe_ids = split ' ', $::form->{converted_from_oe_id};
1449 foreach my $converted_from_oe_id (@converted_from_oe_ids) {
1450 my $src = SL::DB::DeliveryOrder->new(id => $converted_from_oe_id)->load;
1451 $src->update_attributes(closed => 1) if $src->type =~ /_quotation$/;
1452 $src->link_to_record($self->order);
1454 if (scalar @{ $::form->{converted_from_orderitems_ids} || [] }) {
1456 foreach (@{ $self->order->items_sorted }) {
1457 my $from_id = $::form->{converted_from_orderitems_ids}->[$idx];
1459 SL::DB::RecordLink->new(from_table => 'orderitems',
1460 from_id => $from_id,
1461 to_table => 'orderitems',
1469 $self->save_history('SAVED');
1472 }) || push(@{$errors}, $db->error);
1477 sub workflow_sales_or_request_for_quotation {
1481 my $errors = $self->save();
1483 if (scalar @{ $errors }) {
1484 $self->js->flash('error', $_) for @{ $errors };
1485 return $self->js->render();
1488 my $destination_type = $::form->{type} eq sales_order_type() ? sales_quotation_type() : request_quotation_type();
1490 $self->order(SL::DB::DeliveryOrder->new_from($self->order, destination_type => $destination_type));
1491 $self->{converted_from_oe_id} = delete $::form->{id};
1493 # set item ids to new fake id, to identify them as new items
1494 foreach my $item (@{$self->order->items_sorted}) {
1495 $item->{new_fake_id} = join('_', 'new', Time::HiRes::gettimeofday(), int rand 1000000000000);
1499 $::form->{type} = $destination_type;
1500 $self->type($self->init_type);
1501 $self->cv ($self->init_cv);
1504 $self->get_unalterable_data();
1505 $self->pre_render();
1507 # trigger rendering values for second row as hidden, because they
1508 # are loaded only on demand. So we need to keep the values from the
1510 $_->{render_second_row} = 1 for @{ $self->order->items_sorted };
1513 'delivery_order/form',
1514 title => $self->get_title_for('edit'),
1515 %{$self->{template_args}}
1519 sub workflow_sales_or_purchase_order {
1523 my $errors = $self->save();
1525 if (scalar @{ $errors }) {
1526 $self->js->flash('error', $_) foreach @{ $errors };
1527 return $self->js->render();
1530 my $destination_type = $::form->{type} eq sales_quotation_type() ? sales_order_type()
1531 : $::form->{type} eq request_quotation_type() ? purchase_order_type()
1532 : $::form->{type} eq purchase_order_type() ? sales_order_type()
1533 : $::form->{type} eq sales_order_type() ? purchase_order_type()
1536 # check for direct delivery
1537 # copy shipto in custom shipto (custom shipto will be copied by new_from() in case)
1539 if ( $::form->{type} eq sales_order_type() && $destination_type eq purchase_order_type()
1540 && $::form->{use_shipto} && $self->order->shipto) {
1541 $custom_shipto = $self->order->shipto->clone('SL::DB::DeliveryOrder');
1544 $self->order(SL::DB::DeliveryOrder->new_from($self->order, destination_type => $destination_type));
1545 $self->{converted_from_oe_id} = delete $::form->{id};
1547 # set item ids to new fake id, to identify them as new items
1548 foreach my $item (@{$self->order->items_sorted}) {
1549 $item->{new_fake_id} = join('_', 'new', Time::HiRes::gettimeofday(), int rand 1000000000000);
1552 if ($::form->{type} eq sales_order_type() && $destination_type eq purchase_order_type()) {
1553 if ($::form->{use_shipto}) {
1554 $self->order->custom_shipto($custom_shipto) if $custom_shipto;
1556 # remove any custom shipto if not wanted
1557 $self->order->custom_shipto(SL::DB::Shipto->new(module => 'OE', custom_variables => []));
1562 $::form->{type} = $destination_type;
1563 $self->type($self->init_type);
1564 $self->cv ($self->init_cv);
1567 $self->get_unalterable_data();
1568 $self->pre_render();
1570 # trigger rendering values for second row as hidden, because they
1571 # are loaded only on demand. So we need to keep the values from the
1573 $_->{render_second_row} = 1 for @{ $self->order->items_sorted };
1576 'delivery_order/form',
1577 title => $self->get_title_for('edit'),
1578 %{$self->{template_args}}
1586 $self->{all_taxzones} = SL::DB::Manager::TaxZone->get_all_sorted();
1587 $self->{all_currencies} = SL::DB::Manager::Currency->get_all_sorted();
1588 $self->{all_departments} = SL::DB::Manager::Department->get_all_sorted();
1589 $self->{all_languages} = SL::DB::Manager::Language->get_all_sorted();
1590 $self->{all_employees} = SL::DB::Manager::Employee->get_all(where => [ or => [ id => $self->order->employee_id,
1593 $self->{all_salesmen} = SL::DB::Manager::Employee->get_all(where => [ or => [ id => $self->order->salesman_id,
1596 $self->{all_payment_terms} = SL::DB::Manager::PaymentTerm->get_all_sorted(where => [ or => [ id => $self->order->payment_id,
1598 $self->{all_delivery_terms} = SL::DB::Manager::DeliveryTerm->get_all_sorted();
1599 $self->{current_employee_id} = SL::DB::Manager::Employee->current->id;
1600 $self->{order_probabilities} = [ map { { title => ($_ * 10) . '%', id => $_ * 10 } } (0..10) ];
1601 $self->{positions_scrollbar_height} = SL::Helper::UserPreferences::PositionsScrollbar->new()->get_height();
1603 my $print_form = Form->new('');
1604 $print_form->{type} = $self->type;
1605 $print_form->{printers} = SL::DB::Manager::Printer->get_all_sorted;
1606 $self->{print_options} = SL::Helper::PrintOptions->get_print_options(
1607 form => $print_form,
1608 options => {dialog_name_prefix => 'print_options.',
1612 no_opendocument => 0,
1616 foreach my $item (@{$self->order->orderitems}) {
1617 my $price_source = SL::PriceSource->new(record_item => $item, record => $self->order);
1618 $item->active_price_source( $price_source->price_from_source( $item->active_price_source ));
1619 $item->active_discount_source($price_source->discount_from_source($item->active_discount_source));
1622 if (any { $self->type eq $_ } (sales_order_type(), purchase_order_type())) {
1623 # Calculate shipped qtys here to prevent calling calculate for every item via the items method.
1624 # Do not use write_to_objects to prevent order->delivered to be set, because this should be
1625 # the value from db, which can be set manually or is set when linked delivery orders are saved.
1626 SL::Helper::ShippedQty->new->calculate($self->order)->write_to(\@{$self->order->items});
1629 if ($self->order->number && $::instance_conf->get_webdav) {
1630 my $webdav = SL::Webdav->new(
1631 type => $self->type,
1632 number => $self->order->number,
1634 my @all_objects = $webdav->get_all_objects;
1635 @{ $self->{template_args}->{WEBDAV} } = map { { name => $_->filename,
1637 link => File::Spec->catfile($_->full_filedescriptor),
1641 $self->get_item_cvpartnumber($_) for @{$self->order->items_sorted};
1643 $::request->{layout}->use_javascript("${_}.js") for qw(kivi.SalesPurchase kivi.Order kivi.File ckeditor/ckeditor ckeditor/adapters/jquery
1644 calculate_qty kivi.Validator follow_up show_history);
1645 $self->setup_edit_action_bar;
1648 sub setup_edit_action_bar {
1649 my ($self, %params) = @_;
1651 my $deletion_allowed = (any { $self->type eq $_ } (sales_quotation_type(), request_quotation_type()))
1652 || (($self->type eq sales_order_type()) && $::instance_conf->get_sales_order_show_delete)
1653 || (($self->type eq purchase_order_type()) && $::instance_conf->get_purchase_order_show_delete);
1655 for my $bar ($::request->layout->get('actionbar')) {
1660 call => [ 'kivi.Order.save', 'save', $::instance_conf->get_order_warn_duplicate_parts,
1661 $::instance_conf->get_order_warn_no_deliverydate,
1666 call => [ 'kivi.Order.save', 'save_as_new', $::instance_conf->get_order_warn_duplicate_parts ],
1667 disabled => !$self->order->id ? t8('This object has not been saved yet.') : undef,
1669 ], # end of combobox "Save"
1676 t8('Save and Quotation'),
1677 submit => [ '#order_form', { action => "DeliveryOrder/sales_quotation" } ],
1678 only_if => (any { $self->type eq $_ } (sales_order_type())),
1682 submit => [ '#order_form', { action => "DeliveryOrder/request_for_quotation" } ],
1683 only_if => (any { $self->type eq $_ } (purchase_order_type())),
1686 t8('Save and Sales Order'),
1687 submit => [ '#order_form', { action => "DeliveryOrder/sales_order" } ],
1688 only_if => (any { $self->type eq $_ } (sales_quotation_type(), purchase_order_type())),
1691 t8('Save and Purchase Order'),
1692 call => [ 'kivi.Order.purchase_order_check_for_direct_delivery' ],
1693 only_if => (any { $self->type eq $_ } (sales_order_type(), request_quotation_type())),
1696 t8('Save and Delivery Order'),
1697 call => [ 'kivi.Order.save', 'save_and_delivery_order', $::instance_conf->get_order_warn_duplicate_parts,
1698 $::instance_conf->get_order_warn_no_deliverydate,
1700 only_if => (any { $self->type eq $_ } (sales_order_type(), purchase_order_type()))
1703 t8('Save and Invoice'),
1704 call => [ 'kivi.Order.save', 'save_and_invoice', $::instance_conf->get_order_warn_duplicate_parts ],
1707 t8('Save and AP Transaction'),
1708 call => [ 'kivi.Order.save', 'save_and_ap_transaction', $::instance_conf->get_order_warn_duplicate_parts ],
1709 only_if => (any { $self->type eq $_ } (purchase_order_type()))
1712 ], # end of combobox "Workflow"
1719 t8('Save and preview PDF'),
1720 call => [ 'kivi.Order.save', 'preview_pdf', $::instance_conf->get_order_warn_duplicate_parts,
1721 $::instance_conf->get_order_warn_no_deliverydate,
1725 t8('Save and print'),
1726 call => [ 'kivi.Order.show_print_options', $::instance_conf->get_order_warn_duplicate_parts,
1727 $::instance_conf->get_order_warn_no_deliverydate,
1731 t8('Save and E-mail'),
1732 id => 'save_and_email_action',
1733 call => [ 'kivi.Order.save', 'save_and_show_email_dialog', $::instance_conf->get_order_warn_duplicate_parts,
1734 $::instance_conf->get_order_warn_no_deliverydate,
1736 disabled => !$self->order->id ? t8('This object has not been saved yet.') : undef,
1739 t8('Download attachments of all parts'),
1740 call => [ 'kivi.File.downloadOrderitemsFiles', $::form->{type}, $::form->{id} ],
1741 disabled => !$self->order->id ? t8('This object has not been saved yet.') : undef,
1742 only_if => $::instance_conf->get_doc_storage,
1744 ], # end of combobox "Export"
1748 call => [ 'kivi.Order.delete_order' ],
1749 confirm => $::locale->text('Do you really want to delete this object?'),
1750 disabled => !$self->order->id ? t8('This object has not been saved yet.') : undef,
1751 only_if => $deletion_allowed,
1760 call => [ 'kivi.Order.follow_up_window' ],
1761 disabled => !$self->order->id ? t8('This object has not been saved yet.') : undef,
1762 only_if => $::auth->assert('productivity', 1),
1766 call => [ 'set_history_window', $self->order->id, 'id' ],
1767 disabled => !$self->order->id ? t8('This record has not been saved yet.') : undef,
1769 ], # end of combobox "more"
1775 my ($order, $pdf_ref, $params) = @_;
1779 my $print_form = Form->new('');
1780 $print_form->{type} = $order->type;
1781 $print_form->{formname} = $params->{formname} || $order->type;
1782 $print_form->{format} = $params->{format} || 'pdf';
1783 $print_form->{media} = $params->{media} || 'file';
1784 $print_form->{groupitems} = $params->{groupitems};
1785 $print_form->{printer_id} = $params->{printer_id};
1786 $print_form->{media} = 'file' if $print_form->{media} eq 'screen';
1788 $order->language($params->{language});
1789 $order->flatten_to_form($print_form, format_amounts => 1);
1793 if ($print_form->{format} =~ /(opendocument|oasis)/i) {
1794 $template_ext = 'odt';
1795 $template_type = 'OpenDocument';
1798 # search for the template
1799 my ($template_file, @template_files) = SL::Helper::CreatePDF->find_template(
1800 name => $print_form->{formname},
1801 extension => $template_ext,
1802 email => $print_form->{media} eq 'email',
1803 language => $params->{language},
1804 printer_id => $print_form->{printer_id},
1807 if (!defined $template_file) {
1808 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);
1811 return @errors if scalar @errors;
1813 $print_form->throw_on_error(sub {
1815 $print_form->prepare_for_printing;
1817 $$pdf_ref = SL::Helper::CreatePDF->create_pdf(
1818 format => $print_form->{format},
1819 template_type => $template_type,
1820 template => $template_file,
1821 variables => $print_form,
1822 variable_content_types => {
1823 longdescription => 'html',
1824 partnotes => 'html',
1829 } || push @errors, ref($EVAL_ERROR) eq 'SL::X::FormError' ? $EVAL_ERROR->error : $EVAL_ERROR;
1835 sub get_files_for_email_dialog {
1838 my %files = map { ($_ => []) } qw(versions files vc_files part_files);
1840 return %files if !$::instance_conf->get_doc_storage;
1842 if ($self->order->id) {
1843 $files{versions} = [ SL::File->get_all_versions(object_id => $self->order->id, object_type => $self->order->type, file_type => 'document') ];
1844 $files{files} = [ SL::File->get_all( object_id => $self->order->id, object_type => $self->order->type, file_type => 'attachment') ];
1845 $files{vc_files} = [ SL::File->get_all( object_id => $self->order->{$self->cv}->id, object_type => $self->cv, file_type => 'attachment') ];
1846 $files{project_files} = [ SL::File->get_all( object_id => $self->order->globalproject_id, object_type => 'project', file_type => 'attachment') ];
1850 uniq_by { $_->{id} }
1852 +{ id => $_->part->id,
1853 partnumber => $_->part->partnumber }
1854 } @{$self->order->items_sorted};
1856 foreach my $part (@parts) {
1857 my @pfiles = SL::File->get_all(object_id => $part->{id}, object_type => 'part');
1858 push @{ $files{part_files} }, map { +{ %{ $_ }, partnumber => $part->{partnumber} } } @pfiles;
1861 foreach my $key (keys %files) {
1862 $files{$key} = [ sort_by { lc $_->{db_file}->{file_name} } @{ $files{$key} } ];
1869 my ($self, $action) = @_;
1871 return '' if none { lc($action)} qw(add edit);
1874 # $::locale->text("Add Sales Order");
1875 # $::locale->text("Add Purchase Order");
1876 # $::locale->text("Add Quotation");
1877 # $::locale->text("Add Request for Quotation");
1878 # $::locale->text("Edit Sales Order");
1879 # $::locale->text("Edit Purchase Order");
1880 # $::locale->text("Edit Quotation");
1881 # $::locale->text("Edit Request for Quotation");
1883 $action = ucfirst(lc($action));
1884 return $self->type eq sales_order_type() ? $::locale->text("$action Sales Order")
1885 : $self->type eq purchase_order_type() ? $::locale->text("$action Purchase Order")
1886 : $self->type eq sales_quotation_type() ? $::locale->text("$action Quotation")
1887 : $self->type eq request_quotation_type() ? $::locale->text("$action Request for Quotation")
1891 sub get_item_cvpartnumber {
1892 my ($self, $item) = @_;
1894 return if !$self->search_cvpartnumber;
1895 return if !$self->order->customervendor;
1897 if ($self->cv eq 'vendor') {
1898 my @mms = grep { $_->make eq $self->order->customervendor->id } @{$item->part->makemodels};
1899 $item->{cvpartnumber} = $mms[0]->model if scalar @mms;
1900 } elsif ($self->cv eq 'customer') {
1901 my @cps = grep { $_->customer_id eq $self->order->customervendor->id } @{$item->part->customerprices};
1902 $item->{cvpartnumber} = $cps[0]->customer_partnumber if scalar @cps;
1906 sub get_part_texts {
1907 my ($part_or_id, $language_or_id, %defaults) = @_;
1909 my $part = ref($part_or_id) ? $part_or_id : SL::DB::Part->load_cached($part_or_id);
1910 my $language_id = ref($language_or_id) ? $language_or_id->id : $language_or_id;
1912 description => $defaults{description} // $part->description,
1913 longdescription => $defaults{longdescription} // $part->notes,
1916 return $texts unless $language_id;
1918 my $translation = SL::DB::Manager::Translation->get_first(
1920 parts_id => $part->id,
1921 language_id => $language_id,
1924 $texts->{description} = $translation->translation if $translation && $translation->translation;
1925 $texts->{longdescription} = $translation->longdescription if $translation && $translation->longdescription;
1930 sub sales_order_type {
1934 sub purchase_order_type {
1938 sub sales_quotation_type {
1942 sub request_quotation_type {
1943 'request_quotation';
1947 return $_[0]->type eq sales_order_type() ? 'ordnumber'
1948 : $_[0]->type eq purchase_order_type() ? 'ordnumber'
1949 : $_[0]->type eq sales_quotation_type() ? 'quonumber'
1950 : $_[0]->type eq request_quotation_type() ? 'quonumber'
1954 sub save_and_redirect_to {
1955 my ($self, %params) = @_;
1957 my $errors = $self->save();
1959 if (scalar @{ $errors }) {
1960 $self->js->flash('error', $_) foreach @{ $errors };
1961 return $self->js->render();
1964 my $text = $self->type eq sales_order_type() ? $::locale->text('The order has been saved')
1965 : $self->type eq purchase_order_type() ? $::locale->text('The order has been saved')
1966 : $self->type eq sales_quotation_type() ? $::locale->text('The quotation has been saved')
1967 : $self->type eq request_quotation_type() ? $::locale->text('The rfq has been saved')
1969 flash_later('info', $text);
1971 $self->redirect_to(%params, id => $self->order->id);
1975 my ($self, $addition) = @_;
1977 my $number_type = $self->order->type =~ m{order} ? 'ordnumber' : 'quonumber';
1978 my $snumbers = $number_type . '_' . $self->order->$number_type;
1980 SL::DB::History->new(
1981 trans_id => $self->order->id,
1982 employee_id => SL::DB::Manager::Employee->current->id,
1983 what_done => $self->order->type,
1984 snumbers => $snumbers,
1985 addition => $addition,
1989 sub store_pdf_to_webdav_and_filemanagement {
1990 my($order, $content, $filename) = @_;
1994 # copy file to webdav folder
1995 if ($order->number && $::instance_conf->get_webdav_documents) {
1996 my $webdav = SL::Webdav->new(
1997 type => $order->type,
1998 number => $order->number,
2000 my $webdav_file = SL::Webdav::File->new(
2002 filename => $filename,
2005 $webdav_file->store(data => \$content);
2008 push @errors, t8('Storing PDF to webdav folder failed: #1', $@);
2011 if ($order->id && $::instance_conf->get_doc_storage) {
2013 SL::File->save(object_id => $order->id,
2014 object_type => $order->type,
2015 mime_type => 'application/pdf',
2016 source => 'created',
2017 file_type => 'document',
2018 file_name => $filename,
2019 file_contents => $content);
2022 push @errors, t8('Storing PDF in storage backend failed: #1', $@);
2037 SL::Controller::Order - controller for orders
2041 This is a new form to enter orders, completely rewritten with the use
2042 of controller and java script techniques.
2044 The aim is to provide the user a better experience and a faster workflow. Also
2045 the code should be more readable, more reliable and better to maintain.
2053 One input row, so that input happens every time at the same place.
2057 Use of pickers where possible.
2061 Possibility to enter more than one item at once.
2065 Item list in a scrollable area, so that the workflow buttons stay at
2070 Reordering item rows with drag and drop is possible. Sorting item rows is
2071 possible (by partnumber, description, qty, sellprice and discount for now).
2075 No C<update> is necessary. All entries and calculations are managed
2076 with ajax-calls and the page only reloads on C<save>.
2080 User can see changes immediately, because of the use of java script
2091 =item * C<SL/Controller/Order.pm>
2095 =item * C<template/webpages/delivery_order/form.html>
2099 =item * C<template/webpages/delivery_order/tabs/basic_data.html>
2101 Main tab for basic_data.
2103 This is the only tab here for now. "linked records" and "webdav" tabs are
2104 reused from generic code.
2108 =item * C<template/webpages/delivery_order/tabs/_business_info_row.html>
2110 For displaying information on business type
2112 =item * C<template/webpages/delivery_order/tabs/_item_input.html>
2114 The input line for items
2116 =item * C<template/webpages/delivery_order/tabs/_row.html>
2118 One row for already entered items
2120 =item * C<template/webpages/delivery_order/tabs/_tax_row.html>
2122 Displaying tax information
2126 =item * C<js/kivi.Order.js>
2128 java script functions
2138 =item * price sources: little symbols showing better price / better discount
2140 =item * select units in input row?
2142 =item * check for direct delivery (workflow sales order -> purchase order)
2144 =item * access rights
2146 =item * display weights
2150 =item * optional client/user behaviour
2152 (transactions has to be set - department has to be set -
2153 force project if enabled in client config - transport cost reminder)
2157 =head1 KNOWN BUGS AND CAVEATS
2163 Customer discount is not displayed as a valid discount in price source popup
2164 (this might be a bug in price sources)
2166 (I cannot reproduce this (Bernd))
2170 No indication that <shift>-up/down expands/collapses second row.
2174 Inline creation of parts is not currently supported
2178 Table header is not sticky in the scrolling area.
2182 Sorting does not include C<position>, neither does reordering.
2184 This behavior was implemented intentionally. But we can discuss, which behavior
2185 should be implemented.
2189 =head1 To discuss / Nice to have
2195 How to expand/collapse second row. Now it can be done clicking the icon or
2200 Possibility to select PriceSources in input row?
2204 This controller uses a (changed) copy of the template for the PriceSource
2205 dialog. Maybe there could be used one code source.
2209 Rounding-differences between this controller (PriceTaxCalculator) and the old
2210 form. This is not only a problem here, but also in all parts using the PTC.
2211 There exists a ticket and a patch. This patch should be testet.
2215 An indicator, if the actual inputs are saved (like in an
2216 editor or on text processing application).
2220 A warning when leaving the page without saveing unchanged inputs.
2227 Bernd Bleßmann E<lt>bernd@kivitendo-premium.deE<gt>