1 package SL::Controller::DeliveryOrder;
4 use parent qw(SL::Controller::Base);
6 use SL::Helper::Flash qw(flash_later);
7 use SL::Helper::Number qw(_format_number_units);
8 use SL::Presenter::Tag qw(select_tag hidden_tag div_tag);
9 use SL::Locale::String qw(t8);
10 use SL::SessionFile::Random;
15 use SL::Util qw(trim);
22 use SL::DB::PartClassification;
23 use SL::DB::PartsGroup;
26 use SL::DB::RecordLink;
28 use SL::DB::Translation;
30 use SL::Helper::CreatePDF qw(:all);
31 use SL::Helper::PrintOptions;
32 use SL::Helper::ShippedQty;
33 use SL::Helper::UserPreferences::PositionsScrollbar;
34 use SL::Helper::UserPreferences::UpdatePositions;
36 use SL::Controller::Helper::GetModels;
37 use SL::Controller::DeliveryOrder::TypeData;
39 use List::Util qw(first sum0);
40 use List::UtilsBy qw(sort_by uniq_by);
41 use List::MoreUtils qw(any none pairwise first_index);
42 use English qw(-no_match_vars);
47 use Rose::Object::MakeMethods::Generic
49 scalar => [ qw(item_ids_to_delete is_custom_shipto_to_delete) ],
50 'scalar --get_set_init' => [ qw(order valid_types type cv p all_price_factors search_cvpartnumber show_update_button part_picker_classification_ids type_data) ],
55 __PACKAGE__->run_before('check_auth');
57 __PACKAGE__->run_before('get_unalterable_data',
58 only => [ qw(save save_as_new save_and_delivery_order save_and_invoice save_and_ap_transaction
69 $self->order->transdate(DateTime->now_local());
70 $self->type_data->set_reqdate_by_type;
75 'delivery_order/form',
76 title => $self->get_title_for('add'),
77 %{$self->{template_args}}
81 # edit an existing order
89 # this is to edit an order from an unsaved order object
91 # set item ids to new fake id, to identify them as new items
92 foreach my $item (@{$self->order->items_sorted}) {
93 $item->{new_fake_id} = join('_', 'new', Time::HiRes::gettimeofday(), int rand 1000000000000);
95 # trigger rendering values for second row as hidden, because they
96 # are loaded only on demand. So we need to keep the values from
98 $_->{render_second_row} = 1 for @{ $self->order->items_sorted };
103 'delivery_order/form',
104 title => $self->get_title_for('edit'),
105 %{$self->{template_args}}
109 # edit a collective order (consisting of one or more existing orders)
110 sub action_edit_collective {
114 my @multi_ids = map {
115 $_ =~ m{^multi_id_(\d+)$} && $::form->{'multi_id_' . $1} && $::form->{'trans_id_' . $1} && $::form->{'trans_id_' . $1}
116 } grep { $_ =~ m{^multi_id_\d+$} } keys %$::form;
118 # fall back to add if no ids are given
119 if (scalar @multi_ids == 0) {
124 # fall back to save as new if only one id is given
125 if (scalar @multi_ids == 1) {
126 $self->order(SL::DB::DeliveryOrder->new(id => $multi_ids[0])->load);
127 $self->action_save_as_new();
131 # make new order from given orders
132 my @multi_orders = map { SL::DB::DeliveryOrder->new(id => $_)->load } @multi_ids;
133 $self->{converted_from_oe_id} = join ' ', map { $_->id } @multi_orders;
134 $self->order(SL::DB::DeliveryOrder->new_from_multi(\@multi_orders, sort_sources_by => 'transdate'));
136 $self->action_edit();
143 my $errors = $self->delete();
145 if (scalar @{ $errors }) {
146 $self->js->flash('error', $_) foreach @{ $errors };
147 return $self->js->render();
150 flash_later('info', $self->type_data->text("delete"));
152 my @redirect_params = (
157 $self->redirect_to(@redirect_params);
164 my $errors = $self->save();
166 if (scalar @{ $errors }) {
167 $self->js->flash('error', $_) foreach @{ $errors };
168 return $self->js->render();
171 flash_later('info', $self->type_data->text("saved"));
173 my @redirect_params = (
176 id => $self->order->id,
179 $self->redirect_to(@redirect_params);
182 # save the order as new document an open it for edit
183 sub action_save_as_new {
186 my $order = $self->order;
189 $self->js->flash('error', t8('This object has not been saved yet.'));
190 return $self->js->render();
193 # load order from db to check if values changed
194 my $saved_order = SL::DB::DeliveryOrder->new(id => $order->id)->load;
197 # Lets assign a new number if the user hasn't changed the previous one.
198 # If it has been changed manually then use it as-is.
199 $new_attrs{number} = (trim($order->number) eq $saved_order->number)
201 : trim($order->number);
203 # Clear transdate unless changed
204 $new_attrs{transdate} = ($order->transdate == $saved_order->transdate)
205 ? DateTime->today_local
208 # Set new reqdate unless changed if it is enabled in client config
209 $new_attrs{reqdate} = $self->type_data->get_reqdate_by_type($order->reqdate, $saved_order->reqdate);
212 $new_attrs{employee} = SL::DB::Manager::Employee->current;
214 # Create new record from current one
215 $self->order(SL::DB::DeliveryOrder->new_from($order, destination_type => $order->type, attributes => \%new_attrs));
217 # no linked records on save as new
218 delete $::form->{$_} for qw(converted_from_oe_id converted_from_orderitems_ids);
221 $self->action_save();
226 # This is called if "print" is pressed in the print dialog.
227 # If PDF creation was requested and succeeded, the pdf is offered for download
228 # via send_file (which uses ajax in this case).
232 my $errors = $self->save();
234 if (scalar @{ $errors }) {
235 $self->js->flash('error', $_) foreach @{ $errors };
236 return $self->js->render();
239 $self->js_reset_order_and_item_ids_after_save;
241 my $format = $::form->{print_options}->{format};
242 my $media = $::form->{print_options}->{media};
243 my $formname = $::form->{print_options}->{formname};
244 my $copies = $::form->{print_options}->{copies};
245 my $groupitems = $::form->{print_options}->{groupitems};
246 my $printer_id = $::form->{print_options}->{printer_id};
248 # only pdf and opendocument by now
249 if (none { $format eq $_ } qw(pdf opendocument opendocument_pdf)) {
250 return $self->js->flash('error', t8('Format \'#1\' is not supported yet/anymore.', $format))->render;
253 # only screen or printer by now
254 if (none { $media eq $_ } qw(screen printer)) {
255 return $self->js->flash('error', t8('Media \'#1\' is not supported yet/anymore.', $media))->render;
258 # create a form for generate_attachment_filename
259 my $form = Form->new;
260 $form->{$self->nr_key()} = $self->order->number;
261 $form->{type} = $self->type;
262 $form->{format} = $format;
263 $form->{formname} = $formname;
264 $form->{language} = '_' . $self->order->language->template_code if $self->order->language;
265 my $pdf_filename = $form->generate_attachment_filename();
268 my @errors = generate_pdf($self->order, \$pdf, { format => $format,
269 formname => $formname,
270 language => $self->order->language,
271 printer_id => $printer_id,
272 groupitems => $groupitems });
273 if (scalar @errors) {
274 return $self->js->flash('error', t8('Conversion to PDF failed: #1', $errors[0]))->render;
277 if ($media eq 'screen') {
279 $self->js->flash('info', t8('The PDF has been created'));
282 type => SL::MIME->mime_type_from_ext($pdf_filename),
283 name => $pdf_filename,
287 } elsif ($media eq 'printer') {
289 my $printer_id = $::form->{print_options}->{printer_id};
290 SL::DB::Printer->new(id => $printer_id)->load->print_document(
295 $self->js->flash('info', t8('The PDF has been printed'));
298 my @warnings = store_pdf_to_webdav_and_filemanagement($self->order, $pdf, $pdf_filename);
299 if (scalar @warnings) {
300 $self->js->flash('warning', $_) for @warnings;
303 $self->save_history('PRINTED');
306 ->run('kivi.ActionBar.setEnabled', '#save_and_email_action')
309 sub action_preview_pdf {
312 my $errors = $self->save();
313 if (scalar @{ $errors }) {
314 $self->js->flash('error', $_) foreach @{ $errors };
315 return $self->js->render();
318 $self->js_reset_order_and_item_ids_after_save;
321 my $media = 'screen';
322 my $formname = $self->type;
325 # create a form for generate_attachment_filename
326 my $form = Form->new;
327 $form->{$self->nr_key()} = $self->order->number;
328 $form->{type} = $self->type;
329 $form->{format} = $format;
330 $form->{formname} = $formname;
331 $form->{language} = '_' . $self->order->language->template_code if $self->order->language;
332 my $pdf_filename = $form->generate_attachment_filename();
335 my @errors = generate_pdf($self->order, \$pdf, { format => $format,
336 formname => $formname,
337 language => $self->order->language,
339 if (scalar @errors) {
340 return $self->js->flash('error', t8('Conversion to PDF failed: #1', $errors[0]))->render;
342 $self->save_history('PREVIEWED');
343 $self->js->flash('info', t8('The PDF has been previewed'));
347 type => SL::MIME->mime_type_from_ext($pdf_filename),
348 name => $pdf_filename,
353 # open the email dialog
354 sub action_save_and_show_email_dialog {
357 my $errors = $self->save();
359 if (scalar @{ $errors }) {
360 $self->js->flash('error', $_) foreach @{ $errors };
361 return $self->js->render();
364 my $cv_method = $self->cv;
366 if (!$self->order->$cv_method) {
367 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'))
372 $email_form->{to} = $self->order->contact->cp_email if $self->order->contact;
373 $email_form->{to} ||= $self->order->$cv_method->email;
374 $email_form->{cc} = $self->order->$cv_method->cc;
375 $email_form->{bcc} = join ', ', grep $_, $self->order->$cv_method->bcc, SL::DB::Default->get->global_bcc;
376 # Todo: get addresses from shipto, if any
378 my $form = Form->new;
379 $form->{$self->nr_key()} = $self->order->number;
380 $form->{cusordnumber} = $self->order->cusordnumber;
381 $form->{formname} = $self->type;
382 $form->{type} = $self->type;
383 $form->{language} = '_' . $self->order->language->template_code if $self->order->language;
384 $form->{language_id} = $self->order->language->id if $self->order->language;
385 $form->{format} = 'pdf';
386 $form->{cp_id} = $self->order->contact->cp_id if $self->order->contact;
388 $email_form->{subject} = $form->generate_email_subject();
389 $email_form->{attachment_filename} = $form->generate_attachment_filename();
390 $email_form->{message} = $form->generate_email_body();
391 $email_form->{js_send_function} = 'kivi.Order.send_email()';
393 my %files = $self->get_files_for_email_dialog();
394 $self->{all_employees} = SL::DB::Manager::Employee->get_all(query => [ deleted => 0 ]);
395 my $dialog_html = $self->render('common/_send_email_dialog', { output => 0 },
396 email_form => $email_form,
397 show_bcc => $::auth->assert('email_bcc', 'may fail'),
399 is_customer => $self->cv eq 'customer',
400 ALL_EMPLOYEES => $self->{all_employees},
404 ->run('kivi.Order.show_email_dialog', $dialog_html)
411 # Todo: handling error messages: flash is not displayed in dialog, but in the main form
412 sub action_send_email {
415 my $errors = $self->save();
417 if (scalar @{ $errors }) {
418 $self->js->run('kivi.Order.close_email_dialog');
419 $self->js->flash('error', $_) foreach @{ $errors };
420 return $self->js->render();
423 $self->js_reset_order_and_item_ids_after_save;
425 my $email_form = delete $::form->{email_form};
426 my %field_names = (to => 'email');
428 $::form->{ $field_names{$_} // $_ } = $email_form->{$_} for keys %{ $email_form };
430 # for Form::cleanup which may be called in Form::send_email
431 $::form->{cwd} = getcwd();
432 $::form->{tmpdir} = $::lx_office_conf{paths}->{userspath};
434 $::form->{$_} = $::form->{print_options}->{$_} for keys %{ $::form->{print_options} };
435 $::form->{media} = 'email';
437 if (($::form->{attachment_policy} // '') !~ m{^(?:old_file|no_file)$}) {
439 my @errors = generate_pdf($self->order, \$pdf, {media => $::form->{media},
440 format => $::form->{print_options}->{format},
441 formname => $::form->{print_options}->{formname},
442 language => $self->order->language,
443 printer_id => $::form->{print_options}->{printer_id},
444 groupitems => $::form->{print_options}->{groupitems}});
445 if (scalar @errors) {
446 return $self->js->flash('error', t8('Conversion to PDF failed: #1', $errors[0]))->render($self);
449 my @warnings = store_pdf_to_webdav_and_filemanagement($self->order, $pdf, $::form->{attachment_filename});
450 if (scalar @warnings) {
451 flash_later('warning', $_) for @warnings;
454 my $sfile = SL::SessionFile::Random->new(mode => "w");
455 $sfile->fh->print($pdf);
458 $::form->{tmpfile} = $sfile->file_name;
459 $::form->{tmpdir} = $sfile->get_path; # for Form::cleanup which may be called in Form::send_email
462 $::form->{id} = $self->order->id; # this is used in SL::Mailer to create a linked record to the mail
463 $::form->send_email(\%::myconfig, 'pdf');
466 my $intnotes = $self->order->intnotes;
467 $intnotes .= "\n\n" if $self->order->intnotes;
468 $intnotes .= t8('[email]') . "\n";
469 $intnotes .= t8('Date') . ": " . $::locale->format_date_object(DateTime->now_local, precision => 'seconds') . "\n";
470 $intnotes .= t8('To (email)') . ": " . $::form->{email} . "\n";
471 $intnotes .= t8('Cc') . ": " . $::form->{cc} . "\n" if $::form->{cc};
472 $intnotes .= t8('Bcc') . ": " . $::form->{bcc} . "\n" if $::form->{bcc};
473 $intnotes .= t8('Subject') . ": " . $::form->{subject} . "\n\n";
474 $intnotes .= t8('Message') . ": " . $::form->{message};
476 $self->order->update_attributes(intnotes => $intnotes);
478 $self->save_history('MAILED');
480 flash_later('info', t8('The email has been sent.'));
482 my @redirect_params = (
485 id => $self->order->id,
488 $self->redirect_to(@redirect_params);
491 # save the order and redirect to the frontend subroutine for a new
493 sub action_save_and_delivery_order {
496 $self->save_and_redirect_to(
497 controller => 'oe.pl',
498 action => 'oe_delivery_order_from_order',
502 # save the order and redirect to the frontend subroutine for a new
504 sub action_save_and_invoice {
507 $self->save_and_redirect_to(
508 controller => 'oe.pl',
509 action => 'oe_invoice_from_order',
513 # workflow from sales order to sales quotation
514 sub action_sales_quotation {
515 $_[0]->workflow_sales_or_request_for_quotation();
518 # workflow from sales order to sales quotation
519 sub action_request_for_quotation {
520 $_[0]->workflow_sales_or_request_for_quotation();
523 # workflow from sales quotation to sales order
524 sub action_sales_order {
525 $_[0]->workflow_sales_or_purchase_order();
528 # workflow from rfq to purchase order
529 sub action_purchase_order {
530 $_[0]->workflow_sales_or_purchase_order();
533 # workflow from purchase order to ap transaction
534 sub action_save_and_ap_transaction {
537 $self->save_and_redirect_to(
538 controller => 'ap.pl',
539 action => 'add_from_purchase_order',
543 # set form elements in respect to a changed customer or vendor
545 # This action is called on an change of the customer/vendor picker.
546 sub action_customer_vendor_changed {
549 setup_order_from_cv($self->order);
551 my $cv_method = $self->cv;
553 if ($self->order->$cv_method->contacts && scalar @{ $self->order->$cv_method->contacts } > 0) {
554 $self->js->show('#cp_row');
556 $self->js->hide('#cp_row');
559 if ($self->order->$cv_method->shipto && scalar @{ $self->order->$cv_method->shipto } > 0) {
560 $self->js->show('#shipto_selection');
562 $self->js->hide('#shipto_selection');
565 $self->js->val( '#order_salesman_id', $self->order->salesman_id) if $self->order->is_sales;
568 ->replaceWith('#order_cp_id', $self->build_contact_select)
569 ->replaceWith('#order_shipto_id', $self->build_shipto_select)
570 ->replaceWith('#shipto_inputs ', $self->build_shipto_inputs)
571 ->replaceWith('#business_info_row', $self->build_business_info_row)
572 ->val( '#order_taxzone_id', $self->order->taxzone_id)
573 ->val( '#order_taxincluded', $self->order->taxincluded)
574 ->val( '#order_currency_id', $self->order->currency_id)
575 ->val( '#order_payment_id', $self->order->payment_id)
576 ->val( '#order_delivery_term_id', $self->order->delivery_term_id)
577 ->val( '#order_intnotes', $self->order->intnotes)
578 ->val( '#order_language_id', $self->order->$cv_method->language_id)
579 ->focus( '#order_' . $self->cv . '_id')
580 ->run('kivi.Order.update_exchangerate');
582 $self->js_redisplay_cvpartnumbers;
586 # open the dialog for customer/vendor details
587 sub action_show_customer_vendor_details_dialog {
590 my $is_customer = 'customer' eq $::form->{vc};
593 $cv = SL::DB::Customer->new(id => $::form->{vc_id})->load;
595 $cv = SL::DB::Vendor->new(id => $::form->{vc_id})->load;
598 my %details = map { $_ => $cv->$_ } @{$cv->meta->columns};
599 $details{discount_as_percent} = $cv->discount_as_percent;
600 $details{creditlimt} = $cv->creditlimit_as_number;
601 $details{business} = $cv->business->description if $cv->business;
602 $details{language} = $cv->language_obj->description if $cv->language_obj;
603 $details{delivery_terms} = $cv->delivery_term->description if $cv->delivery_term;
604 $details{payment_terms} = $cv->payment->description if $cv->payment;
605 $details{pricegroup} = $cv->pricegroup->pricegroup if $is_customer && $cv->pricegroup;
607 foreach my $entry (@{ $cv->shipto }) {
608 push @{ $details{SHIPTO} }, { map { $_ => $entry->$_ } @{$entry->meta->columns} };
610 foreach my $entry (@{ $cv->contacts }) {
611 push @{ $details{CONTACTS} }, { map { $_ => $entry->$_ } @{$entry->meta->columns} };
614 $_[0]->render('common/show_vc_details', { layout => 0 },
615 is_customer => $is_customer,
620 # called if a unit in an existing item row is changed
621 sub action_unit_changed {
624 my $idx = first_index { $_ eq $::form->{item_id} } @{ $::form->{orderitem_ids} };
625 my $item = $self->order->items_sorted->[$idx];
627 my $old_unit_obj = SL::DB::Unit->new(name => $::form->{old_unit})->load;
628 $item->sellprice($item->unit_obj->convert_to($item->sellprice, $old_unit_obj));
631 ->run('kivi.Order.update_sellprice', $::form->{item_id}, $item->sellprice_as_number);
632 $self->js_redisplay_line_values;
636 # add an item row for a new item entered in the input row
637 sub action_add_item {
640 delete $::form->{add_item}->{create_part_type};
642 my $form_attr = $::form->{add_item};
644 return unless $form_attr->{parts_id};
646 my $item = new_item($self->order, $form_attr);
648 $self->order->add_items($item);
650 $self->get_item_cvpartnumber($item);
652 my $item_id = join('_', 'new', Time::HiRes::gettimeofday(), int rand 1000000000000);
653 my $row_as_html = $self->p->render('delivery_order/tabs/_row',
659 if ($::form->{insert_before_item_id}) {
661 ->before ('.row_entry:has(#item_' . $::form->{insert_before_item_id} . ')', $row_as_html);
664 ->append('#row_table_id', $row_as_html);
667 if ( $item->part->is_assortment ) {
668 $form_attr->{qty_as_number} = 1 unless $form_attr->{qty_as_number};
669 foreach my $assortment_item ( @{$item->part->assortment_items} ) {
670 my $attr = { parts_id => $assortment_item->parts_id,
671 qty => $assortment_item->qty * $::form->parse_amount(\%::myconfig, $form_attr->{qty_as_number}), # TODO $form_attr->{unit}
672 unit => $assortment_item->unit,
673 description => $assortment_item->part->description,
675 my $item = new_item($self->order, $attr);
677 # set discount to 100% if item isn't supposed to be charged, overwriting any customer discount
678 $item->discount(1) unless $assortment_item->charge;
680 $self->order->add_items( $item );
681 $self->get_item_cvpartnumber($item);
682 my $item_id = join('_', 'new', Time::HiRes::gettimeofday(), int rand 1000000000000);
683 my $row_as_html = $self->p->render('delivery_order/tabs/_row',
688 if ($::form->{insert_before_item_id}) {
690 ->before ('.row_entry:has(#item_' . $::form->{insert_before_item_id} . ')', $row_as_html);
693 ->append('#row_table_id', $row_as_html);
699 ->val('.add_item_input', '')
700 ->run('kivi.Order.init_row_handlers')
701 ->run('kivi.Order.renumber_positions')
702 ->focus('#add_item_parts_id_name');
704 $self->js->run('kivi.Order.row_table_scroll_down') if !$::form->{insert_before_item_id};
709 # add item rows for multiple items at once
710 sub action_add_multi_items {
713 my @form_attr = grep { $_->{qty_as_number} } @{ $::form->{add_items} };
714 return $self->js->render() unless scalar @form_attr;
717 foreach my $attr (@form_attr) {
718 my $item = new_item($self->order, $attr);
720 if ( $item->part->is_assortment ) {
721 foreach my $assortment_item ( @{$item->part->assortment_items} ) {
722 my $attr = { parts_id => $assortment_item->parts_id,
723 qty => $assortment_item->qty * $item->qty, # TODO $form_attr->{unit}
724 unit => $assortment_item->unit,
725 description => $assortment_item->part->description,
727 my $item = new_item($self->order, $attr);
729 # set discount to 100% if item isn't supposed to be charged, overwriting any customer discount
730 $item->discount(1) unless $assortment_item->charge;
735 $self->order->add_items(@items);
737 foreach my $item (@items) {
738 $self->get_item_cvpartnumber($item);
739 my $item_id = join('_', 'new', Time::HiRes::gettimeofday(), int rand 1000000000000);
740 my $row_as_html = $self->p->render('delivery_order/tabs/_row',
746 if ($::form->{insert_before_item_id}) {
748 ->before ('.row_entry:has(#item_' . $::form->{insert_before_item_id} . ')', $row_as_html);
751 ->append('#row_table_id', $row_as_html);
756 ->run('kivi.Part.close_picker_dialogs')
757 ->run('kivi.Order.init_row_handlers')
758 ->run('kivi.Order.renumber_positions')
759 ->focus('#add_item_parts_id_name');
761 $self->js->run('kivi.Order.row_table_scroll_down') if !$::form->{insert_before_item_id};
766 sub action_update_exchangerate {
770 is_standard => $self->order->currency_id == $::instance_conf->get_currency_id,
771 currency_name => $self->order->currency->name,
774 $self->render(\SL::JSON::to_json($data), { type => 'json', process => 0 });
777 # redisplay item rows if they are sorted by an attribute
778 sub action_reorder_items {
782 partnumber => sub { $_[0]->part->partnumber },
783 description => sub { $_[0]->description },
784 qty => sub { $_[0]->qty },
785 sellprice => sub { $_[0]->sellprice },
786 discount => sub { $_[0]->discount },
787 cvpartnumber => sub { $_[0]->{cvpartnumber} },
790 $self->get_item_cvpartnumber($_) for @{$self->order->items_sorted};
792 my $method = $sort_keys{$::form->{order_by}};
793 my @to_sort = map { { old_pos => $_->position, order_by => $method->($_) } } @{ $self->order->items_sorted };
794 if ($::form->{sort_dir}) {
795 if ( $::form->{order_by} =~ m/qty|sellprice|discount/ ){
796 @to_sort = sort { $a->{order_by} <=> $b->{order_by} } @to_sort;
798 @to_sort = sort { $a->{order_by} cmp $b->{order_by} } @to_sort;
801 if ( $::form->{order_by} =~ m/qty|sellprice|discount/ ){
802 @to_sort = sort { $b->{order_by} <=> $a->{order_by} } @to_sort;
804 @to_sort = sort { $b->{order_by} cmp $a->{order_by} } @to_sort;
808 ->run('kivi.Order.redisplay_items', \@to_sort)
812 # show the popup to choose a price/discount source
813 sub action_price_popup {
816 my $idx = first_index { $_ eq $::form->{item_id} } @{ $::form->{orderitem_ids} };
817 my $item = $self->order->items_sorted->[$idx];
819 $self->render_price_dialog($item);
822 # save the order in a session variable and redirect to the part controller
823 sub action_create_part {
826 my $previousform = $::auth->save_form_in_session(non_scalars => 1);
828 my $callback = $self->url_for(
829 action => 'return_from_create_part',
830 type => $self->type, # type is needed for check_auth on return
831 previousform => $previousform,
834 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.'));
836 my @redirect_params = (
837 controller => 'Part',
839 part_type => $::form->{add_item}->{create_part_type},
840 callback => $callback,
844 $self->redirect_to(@redirect_params);
847 sub action_return_from_create_part {
850 $self->{created_part} = SL::DB::Part->new(id => delete $::form->{new_parts_id})->load if $::form->{new_parts_id};
852 $::auth->restore_form_from_session(delete $::form->{previousform});
854 # set item ids to new fake id, to identify them as new items
855 foreach my $item (@{$self->order->items_sorted}) {
856 $item->{new_fake_id} = join('_', 'new', Time::HiRes::gettimeofday(), int rand 1000000000000);
859 $self->get_unalterable_data();
862 # trigger rendering values for second row/longdescription as hidden,
863 # because they are loaded only on demand. So we need to keep the values
865 $_->{render_second_row} = 1 for @{ $self->order->items_sorted };
866 $_->{render_longdescription} = 1 for @{ $self->order->items_sorted };
869 'delivery_order/form',
870 title => $self->get_title_for('edit'),
871 %{$self->{template_args}}
876 # load the second row for one or more items
878 # This action gets the html code for all items second rows by rendering a template for
879 # the second row and sets the html code via client js.
880 sub action_load_second_rows {
883 foreach my $item_id (@{ $::form->{item_ids} }) {
884 my $idx = first_index { $_ eq $item_id } @{ $::form->{orderitem_ids} };
885 my $item = $self->order->items_sorted->[$idx];
887 $self->js_load_second_row($item, $item_id, 0);
890 $self->js->run('kivi.Order.init_row_handlers') if $self->order->is_sales; # for lastcosts change-callback
895 # update description, notes and sellprice from master data
896 sub action_update_row_from_master_data {
899 foreach my $item_id (@{ $::form->{item_ids} }) {
900 my $idx = first_index { $_ eq $item_id } @{ $::form->{orderitem_ids} };
901 my $item = $self->order->items_sorted->[$idx];
902 my $texts = get_part_texts($item->part, $self->order->language_id);
904 $item->description($texts->{description});
905 $item->longdescription($texts->{longdescription});
907 my $price_source = SL::PriceSource->new(record_item => $item, record => $self->order);
910 if ($item->part->is_assortment) {
911 # add assortment items with price 0, as the components carry the price
912 $price_src = $price_source->price_from_source("");
913 $price_src->price(0);
915 $price_src = $price_source->best_price
916 ? $price_source->best_price
917 : $price_source->price_from_source("");
918 $price_src->price($::form->round_amount($price_src->price / $self->order->exchangerate, 5)) if $self->order->exchangerate;
919 $price_src->price(0) if !$price_source->best_price;
923 $item->sellprice($price_src->price);
924 $item->active_price_source($price_src);
927 ->run('kivi.Order.update_sellprice', $item_id, $item->sellprice_as_number)
928 ->html('.row_entry:has(#item_' . $item_id . ') [name = "partnumber"] a', $item->part->partnumber)
929 ->val ('.row_entry:has(#item_' . $item_id . ') [name = "order.orderitems[].description"]', $item->description)
930 ->val ('.row_entry:has(#item_' . $item_id . ') [name = "order.orderitems[].longdescription"]', $item->longdescription);
932 if ($self->search_cvpartnumber) {
933 $self->get_item_cvpartnumber($item);
934 $self->js->html('.row_entry:has(#item_' . $item_id . ') [name = "cvpartnumber"]', $item->{cvpartnumber});
938 $self->js_redisplay_line_values;
943 sub js_load_second_row {
944 my ($self, $item, $item_id, $do_parse) = @_;
947 # Parse values from form (they are formated while rendering (template)).
948 # Workaround to pre-parse number-cvars (parse_custom_variable_values does not parse number values).
949 # This parsing is not necessary at all, if we assure that the second row/cvars are only loaded once.
950 foreach my $var (@{ $item->cvars_by_config }) {
951 $var->unparsed_value($::form->parse_amount(\%::myconfig, $var->{__unparsed_value})) if ($var->config->type eq 'number' && exists($var->{__unparsed_value}));
953 $item->parse_custom_variable_values;
956 my $row_as_html = $self->p->render('delivery_order/tabs/_second_row', ITEM => $item, TYPE => $self->type);
959 ->html('#second_row_' . $item_id, $row_as_html)
960 ->data('#second_row_' . $item_id, 'loaded', 1);
963 sub js_redisplay_line_values {
966 my $is_sales = $self->order->is_sales;
968 # sales orders with margins
973 $::form->format_amount(\%::myconfig, $_->{linetotal}, 2, 0),
974 $::form->format_amount(\%::myconfig, $_->{marge_total}, 2, 0),
975 $::form->format_amount(\%::myconfig, $_->{marge_percent}, 2, 0),
976 ]} @{ $self->order->items_sorted };
980 $::form->format_amount(\%::myconfig, $_->{linetotal}, 2, 0),
981 ]} @{ $self->order->items_sorted };
985 ->run('kivi.Order.redisplay_line_values', $is_sales, \@data);
988 sub js_redisplay_cvpartnumbers {
991 $self->get_item_cvpartnumber($_) for @{$self->order->items_sorted};
993 my @data = map {[$_->{cvpartnumber}]} @{ $self->order->items_sorted };
996 ->run('kivi.Order.redisplay_cvpartnumbers', \@data);
999 sub js_reset_order_and_item_ids_after_save {
1003 ->val('#id', $self->order->id)
1004 ->val('#converted_from_oe_id', '')
1005 ->val('#order_' . $self->nr_key(), $self->order->number);
1008 foreach my $form_item_id (@{ $::form->{orderitem_ids} }) {
1009 next if !$self->order->items_sorted->[$idx]->id;
1010 next if $form_item_id !~ m{^new};
1012 ->val ('[name="orderitem_ids[+]"][value="' . $form_item_id . '"]', $self->order->items_sorted->[$idx]->id)
1013 ->val ('#item_' . $form_item_id, $self->order->items_sorted->[$idx]->id)
1014 ->attr('#item_' . $form_item_id, "id", 'item_' . $self->order->items_sorted->[$idx]->id);
1018 $self->js->val('[name="converted_from_orderitems_ids[+]"]', '');
1028 if (none { $::form->{type} eq $_ } @{$self->valid_types}) {
1029 die "Not a valid type for delivery order";
1032 $self->type($::form->{type});
1038 return $self->type_data->customervendor;
1041 sub init_search_cvpartnumber {
1044 my $user_prefs = SL::Helper::UserPreferences::PartPickerSearch->new();
1045 my $search_cvpartnumber;
1046 $search_cvpartnumber = !!$user_prefs->get_sales_search_customer_partnumber() if $self->cv eq 'customer';
1047 $search_cvpartnumber = !!$user_prefs->get_purchase_search_makemodel() if $self->cv eq 'vendor';
1049 return $search_cvpartnumber;
1052 sub init_show_update_button {
1055 !!SL::Helper::UserPreferences::UpdatePositions->new()->get_show_update_button();
1066 sub init_all_price_factors {
1067 SL::DB::Manager::PriceFactor->get_all;
1070 sub init_part_picker_classification_ids {
1073 return [ map { $_->id } @{ SL::DB::Manager::PartClassification->get_all(where => $self->type_data->part_classification_query) } ];
1079 $::auth->assert($self->type_data->access || 'DOES_NOT_EXIST');
1082 # build the selection box for contacts
1084 # Needed, if customer/vendor changed.
1085 sub build_contact_select {
1088 select_tag('order.cp_id', [ $self->order->{$self->cv}->contacts ],
1089 value_key => 'cp_id',
1090 title_key => 'full_name_dep',
1091 default => $self->order->cp_id,
1093 style => 'width: 300px',
1097 # build the selection box for shiptos
1099 # Needed, if customer/vendor changed.
1100 sub build_shipto_select {
1103 select_tag('order.shipto_id',
1104 [ {displayable_id => t8("No/individual shipping address"), shipto_id => ''}, $self->order->{$self->cv}->shipto ],
1105 value_key => 'shipto_id',
1106 title_key => 'displayable_id',
1107 default => $self->order->shipto_id,
1109 style => 'width: 300px',
1113 # build the inputs for the cusom shipto dialog
1115 # Needed, if customer/vendor changed.
1116 sub build_shipto_inputs {
1119 my $content = $self->p->render('common/_ship_to_dialog',
1120 vc_obj => $self->order->customervendor,
1121 cs_obj => $self->order->custom_shipto,
1122 cvars => $self->order->custom_shipto->cvars_by_config,
1123 id_selector => '#order_shipto_id');
1125 div_tag($content, id => 'shipto_inputs');
1128 # render the info line for business
1130 # Needed, if customer/vendor changed.
1131 sub build_business_info_row
1133 $_[0]->p->render('delivery_order/tabs/_business_info_row', SELF => $_[0]);
1140 return if !$::form->{id};
1142 $self->order(SL::DB::DeliveryOrder->new(id => $::form->{id})->load);
1144 # Add an empty custom shipto to the order, so that the dialog can render the cvar inputs.
1145 # You need a custom shipto object to call cvars_by_config to get the cvars.
1146 $self->order->custom_shipto(SL::DB::Shipto->new(module => 'OE', custom_variables => [])) if !$self->order->custom_shipto;
1148 return $self->order;
1151 # load or create a new order object
1153 # And assign changes from the form to this object.
1154 # If the order is loaded from db, check if items are deleted in the form,
1155 # remove them form the object and collect them for removing from db on saving.
1156 # Then create/update items from form (via make_item) and add them.
1160 # add_items adds items to an order with no items for saving, but they cannot
1161 # be retrieved via items until the order is saved. Adding empty items to new
1162 # order here solves this problem.
1164 $order = SL::DB::DeliveryOrder->new(id => $::form->{id})->load(with => [ 'orderitems', 'orderitems.part' ]) if $::form->{id};
1165 $order ||= SL::DB::DeliveryOrder->new(orderitems => [], currency_id => $::instance_conf->get_currency_id(), order_type => $self->type_data->validate($::form->{type}));
1167 my $cv_id_method = $self->cv . '_id';
1168 if (!$::form->{id} && $::form->{$cv_id_method}) {
1169 $order->$cv_id_method($::form->{$cv_id_method});
1170 setup_order_from_cv($order);
1173 my $form_orderitems = delete $::form->{order}->{orderitems};
1175 $order->assign_attributes(%{$::form->{order}});
1177 $self->setup_custom_shipto_from_form($order, $::form);
1179 # remove deleted items
1180 $self->item_ids_to_delete([]);
1181 foreach my $idx (reverse 0..$#{$order->orderitems}) {
1182 my $item = $order->orderitems->[$idx];
1183 if (none { $item->id == $_->{id} } @{$form_orderitems}) {
1184 splice @{$order->orderitems}, $idx, 1;
1185 push @{$self->item_ids_to_delete}, $item->id;
1191 foreach my $form_attr (@{$form_orderitems}) {
1192 my $item = make_item($order, $form_attr);
1193 $item->position($pos);
1197 $order->add_items(grep {!$_->id} @items);
1202 # create or update items from form
1204 # Make item objects from form values. For items already existing read from db.
1205 # Create a new item else. And assign attributes.
1207 my ($record, $attr) = @_;
1210 $item = first { $_->id == $attr->{id} } @{$record->items} if $attr->{id};
1212 my $is_new = !$item;
1214 # add_custom_variables adds cvars to an orderitem with no cvars for saving, but
1215 # they cannot be retrieved via custom_variables until the order/orderitem is
1216 # saved. Adding empty custom_variables to new orderitem here solves this problem.
1217 $item ||= SL::DB::DeliveryOrderItem->new(custom_variables => []);
1219 $item->assign_attributes(%$attr);
1222 my $texts = get_part_texts($item->part, $record->language_id);
1223 $item->longdescription($texts->{longdescription}) if !defined $attr->{longdescription};
1224 $item->project_id($record->globalproject_id) if !defined $attr->{project_id};
1225 $item->lastcost($record->is_sales ? $item->part->lastcost : 0) if !defined $attr->{lastcost_as_number};
1233 # This is used to add one item
1235 my ($record, $attr) = @_;
1237 my $item = SL::DB::DeliveryOrderItem->new;
1239 # Remove attributes where the user left or set the inputs empty.
1240 # So these attributes will be undefined and we can distinguish them
1241 # from zero later on.
1242 for (qw(qty_as_number sellprice_as_number discount_as_percent)) {
1243 delete $attr->{$_} if $attr->{$_} eq '';
1246 $item->assign_attributes(%$attr);
1248 my $part = SL::DB::Part->new(id => $attr->{parts_id})->load;
1249 my $price_source = SL::PriceSource->new(record_item => $item, record => $record);
1251 $item->unit($part->unit) if !$item->unit;
1254 if ( $part->is_assortment ) {
1255 # add assortment items with price 0, as the components carry the price
1256 $price_src = $price_source->price_from_source("");
1257 $price_src->price(0);
1258 } elsif (defined $item->sellprice) {
1259 $price_src = $price_source->price_from_source("");
1260 $price_src->price($item->sellprice);
1262 $price_src = $price_source->best_price
1263 ? $price_source->best_price
1264 : $price_source->price_from_source("");
1265 $price_src->price(0) if !$price_source->best_price;
1269 if (defined $item->discount) {
1270 $discount_src = $price_source->discount_from_source("");
1271 $discount_src->discount($item->discount);
1273 $discount_src = $price_source->best_discount
1274 ? $price_source->best_discount
1275 : $price_source->discount_from_source("");
1276 $discount_src->discount(0) if !$price_source->best_discount;
1280 $new_attr{part} = $part;
1281 $new_attr{description} = $part->description if ! $item->description;
1282 $new_attr{qty} = 1.0 if ! $item->qty;
1283 $new_attr{price_factor_id} = $part->price_factor_id if ! $item->price_factor_id;
1284 $new_attr{sellprice} = $price_src->price;
1285 $new_attr{discount} = $discount_src->discount;
1286 $new_attr{active_price_source} = $price_src;
1287 $new_attr{active_discount_source} = $discount_src;
1288 $new_attr{longdescription} = $part->notes if ! defined $attr->{longdescription};
1289 $new_attr{project_id} = $record->globalproject_id;
1290 $new_attr{lastcost} = $record->is_sales ? $part->lastcost : 0;
1292 # add_custom_variables adds cvars to an orderitem with no cvars for saving, but
1293 # they cannot be retrieved via custom_variables until the order/orderitem is
1294 # saved. Adding empty custom_variables to new orderitem here solves this problem.
1295 $new_attr{custom_variables} = [];
1297 my $texts = get_part_texts($part, $record->language_id, description => $new_attr{description}, longdescription => $new_attr{longdescription});
1299 $item->assign_attributes(%new_attr, %{ $texts });
1304 sub setup_order_from_cv {
1307 $order->$_($order->customervendor->$_) for (qw(taxzone_id payment_id delivery_term_id currency_id));
1309 $order->intnotes($order->customervendor->notes);
1311 if ($order->is_sales) {
1312 $order->salesman_id($order->customer->salesman_id || SL::DB::Manager::Employee->current->id);
1313 $order->taxincluded(defined($order->customer->taxincluded_checked)
1314 ? $order->customer->taxincluded_checked
1315 : $::myconfig{taxincluded_checked});
1320 # setup custom shipto from form
1322 # The dialog returns form variables starting with 'shipto' and cvars starting
1323 # with 'shiptocvar_'.
1324 # Mark it to be deleted if a shipto from master data is selected
1325 # (i.e. order has a shipto).
1326 # Else, update or create a new custom shipto. If the fields are empty, it
1327 # will not be saved on save.
1328 sub setup_custom_shipto_from_form {
1329 my ($self, $order, $form) = @_;
1331 if ($order->shipto) {
1332 $self->is_custom_shipto_to_delete(1);
1334 my $custom_shipto = $order->custom_shipto || $order->custom_shipto(SL::DB::Shipto->new(module => 'OE', custom_variables => []));
1336 my $shipto_cvars = {map { my ($key) = m{^shiptocvar_(.+)}; $key => delete $form->{$_}} grep { m{^shiptocvar_} } keys %$form};
1337 my $shipto_attrs = {map { $_ => delete $form->{$_}} grep { m{^shipto} } keys %$form};
1339 $custom_shipto->assign_attributes(%$shipto_attrs);
1340 $custom_shipto->cvar_by_name($_)->value($shipto_cvars->{$_}) for keys %$shipto_cvars;
1344 # get data for saving, printing, ..., that is not changed in the form
1346 # Only cvars for now.
1347 sub get_unalterable_data {
1350 foreach my $item (@{ $self->order->items }) {
1351 # autovivify all cvars that are not in the form (cvars_by_config can do it).
1352 # workaround to pre-parse number-cvars (parse_custom_variable_values does not parse number values).
1353 foreach my $var (@{ $item->cvars_by_config }) {
1354 $var->unparsed_value($::form->parse_amount(\%::myconfig, $var->{__unparsed_value})) if ($var->config->type eq 'number' && exists($var->{__unparsed_value}));
1356 $item->parse_custom_variable_values;
1362 # And remove related files in the spool directory
1367 my $db = $self->order->db;
1369 $db->with_transaction(
1371 my @spoolfiles = grep { $_ } map { $_->spoolfile } @{ SL::DB::Manager::Status->get_all(where => [ trans_id => $self->order->id ]) };
1372 $self->order->delete;
1373 my $spool = $::lx_office_conf{paths}->{spool};
1374 unlink map { "$spool/$_" } @spoolfiles if $spool;
1376 $self->save_history('DELETED');
1379 }) || push(@{$errors}, $db->error);
1386 # And delete items that are deleted in the form.
1391 my $db = $self->order->db;
1393 $db->with_transaction(sub {
1394 # delete custom shipto if it is to be deleted or if it is empty
1395 if ($self->order->custom_shipto && ($self->is_custom_shipto_to_delete || $self->order->custom_shipto->is_empty)) {
1396 $self->order->custom_shipto->delete if $self->order->custom_shipto->shipto_id;
1397 $self->order->custom_shipto(undef);
1400 SL::DB::DeliveryOrderItem->new(id => $_)->delete for @{$self->item_ids_to_delete || []};
1401 $self->order->save(cascade => 1);
1404 if ($::form->{converted_from_oe_id}) {
1405 my @converted_from_oe_ids = split ' ', $::form->{converted_from_oe_id};
1406 foreach my $converted_from_oe_id (@converted_from_oe_ids) {
1407 my $src = SL::DB::DeliveryOrder->new(id => $converted_from_oe_id)->load;
1408 $src->update_attributes(closed => 1) if $src->type =~ /_quotation$/;
1409 $src->link_to_record($self->order);
1411 if (scalar @{ $::form->{converted_from_orderitems_ids} || [] }) {
1413 foreach (@{ $self->order->items_sorted }) {
1414 my $from_id = $::form->{converted_from_orderitems_ids}->[$idx];
1416 SL::DB::RecordLink->new(from_table => 'orderitems',
1417 from_id => $from_id,
1418 to_table => 'orderitems',
1426 $self->save_history('SAVED');
1429 }) || push(@{$errors}, $db->error);
1434 sub workflow_sales_or_request_for_quotation {
1438 my $errors = $self->save();
1440 if (scalar @{ $errors }) {
1441 $self->js->flash('error', $_) for @{ $errors };
1442 return $self->js->render();
1445 my $destination_type = $self->type_data->workflow("to_quotation_type");
1447 $self->order(SL::DB::DeliveryOrder->new_from($self->order, destination_type => $destination_type));
1448 $self->{converted_from_oe_id} = delete $::form->{id};
1450 # set item ids to new fake id, to identify them as new items
1451 foreach my $item (@{$self->order->items_sorted}) {
1452 $item->{new_fake_id} = join('_', 'new', Time::HiRes::gettimeofday(), int rand 1000000000000);
1456 $::form->{type} = $destination_type;
1457 $self->type($self->init_type);
1458 $self->cv ($self->init_cv);
1461 $self->get_unalterable_data();
1462 $self->pre_render();
1464 # trigger rendering values for second row as hidden, because they
1465 # are loaded only on demand. So we need to keep the values from the
1467 $_->{render_second_row} = 1 for @{ $self->order->items_sorted };
1470 'delivery_order/form',
1471 title => $self->get_title_for('edit'),
1472 %{$self->{template_args}}
1476 sub workflow_sales_or_purchase_order {
1480 my $errors = $self->save();
1482 if (scalar @{ $errors }) {
1483 $self->js->flash('error', $_) foreach @{ $errors };
1484 return $self->js->render();
1487 my $destination_type = $self->type_data->workflow("to_order_type");
1489 # check for direct delivery
1490 # copy shipto in custom shipto (custom shipto will be copied by new_from() in case)
1492 if ($self->type_data->workflow("to_order_copy_shipto") && $::form->{use_shipto} && $self->order->shipto) {
1493 $custom_shipto = $self->order->shipto->clone('SL::DB::DeliveryOrder');
1496 $self->order(SL::DB::DeliveryOrder->new_from($self->order, destination_type => $destination_type));
1497 $self->{converted_from_oe_id} = delete $::form->{id};
1499 # set item ids to new fake id, to identify them as new items
1500 foreach my $item (@{$self->order->items_sorted}) {
1501 $item->{new_fake_id} = join('_', 'new', Time::HiRes::gettimeofday(), int rand 1000000000000);
1504 if ($self->type_data->workflow("to_order_copy_shipto")) {
1505 if ($::form->{use_shipto}) {
1506 $self->order->custom_shipto($custom_shipto) if $custom_shipto;
1508 # remove any custom shipto if not wanted
1509 $self->order->custom_shipto(SL::DB::Shipto->new(module => 'OE', custom_variables => []));
1514 $::form->{type} = $destination_type;
1515 $self->type($self->init_type);
1516 $self->cv ($self->init_cv);
1519 $self->get_unalterable_data();
1520 $self->pre_render();
1522 # trigger rendering values for second row as hidden, because they
1523 # are loaded only on demand. So we need to keep the values from the
1525 $_->{render_second_row} = 1 for @{ $self->order->items_sorted };
1528 'delivery_order/form',
1529 title => $self->get_title_for('edit'),
1530 %{$self->{template_args}}
1538 $self->{all_taxzones} = SL::DB::Manager::TaxZone->get_all_sorted();
1539 $self->{all_currencies} = SL::DB::Manager::Currency->get_all_sorted();
1540 $self->{all_departments} = SL::DB::Manager::Department->get_all_sorted();
1541 $self->{all_languages} = SL::DB::Manager::Language->get_all_sorted();
1542 $self->{all_employees} = SL::DB::Manager::Employee->get_all(where => [ or => [ id => $self->order->employee_id,
1545 $self->{all_salesmen} = SL::DB::Manager::Employee->get_all(where => [ or => [ id => $self->order->salesman_id,
1548 $self->{all_payment_terms} = SL::DB::Manager::PaymentTerm->get_all_sorted(where => [ or => [ id => $self->order->payment_id,
1550 $self->{all_delivery_terms} = SL::DB::Manager::DeliveryTerm->get_all_sorted();
1551 $self->{current_employee_id} = SL::DB::Manager::Employee->current->id;
1552 $self->{order_probabilities} = [ map { { title => ($_ * 10) . '%', id => $_ * 10 } } (0..10) ];
1553 $self->{positions_scrollbar_height} = SL::Helper::UserPreferences::PositionsScrollbar->new()->get_height();
1555 my $print_form = Form->new('');
1556 $print_form->{type} = $self->type;
1557 $print_form->{printers} = SL::DB::Manager::Printer->get_all_sorted;
1558 $self->{print_options} = SL::Helper::PrintOptions->get_print_options(
1559 form => $print_form,
1560 options => {dialog_name_prefix => 'print_options.',
1564 no_opendocument => 0,
1568 foreach my $item (@{$self->order->orderitems}) {
1569 my $price_source = SL::PriceSource->new(record_item => $item, record => $self->order);
1570 $item->active_price_source( $price_source->price_from_source( $item->active_price_source ));
1571 $item->active_discount_source($price_source->discount_from_source($item->active_discount_source));
1574 if ($self->order->${\ $self->type_data->nr_key } && $::instance_conf->get_webdav) {
1575 my $webdav = SL::Webdav->new(
1576 type => $self->type,
1577 number => $self->order->number,
1579 my @all_objects = $webdav->get_all_objects;
1580 @{ $self->{template_args}->{WEBDAV} } = map { { name => $_->filename,
1582 link => File::Spec->catfile($_->full_filedescriptor),
1586 $self->{template_args}{inout} = $self->type_data->properties('transfer');
1588 $self->get_item_cvpartnumber($_) for @{$self->order->items_sorted};
1590 $::request->{layout}->use_javascript("${_}.js") for qw(kivi.SalesPurchase kivi.DeliveryOrder kivi.File ckeditor/ckeditor ckeditor/adapters/jquery
1591 calculate_qty kivi.Validator follow_up show_history);
1592 $self->setup_edit_action_bar;
1595 sub setup_edit_action_bar {
1596 my ($self, %params) = @_;
1598 my $deletion_allowed = $self->type_data->show_menu("delete");
1600 for my $bar ($::request->layout->get('actionbar')) {
1605 call => [ 'kivi.DeliveryOrder.save', 'save', $::instance_conf->get_order_warn_duplicate_parts,
1606 $::instance_conf->get_order_warn_no_deliverydate,
1611 call => [ 'kivi.DeliveryOrder.save', 'save_as_new', $::instance_conf->get_order_warn_duplicate_parts ],
1612 disabled => !$self->order->id ? t8('This object has not been saved yet.') : undef,
1614 ], # end of combobox "Save"
1621 t8('Save and Quotation'),
1622 submit => [ '#order_form', { action => "DeliveryOrder/sales_quotation" } ],
1623 only_if => $self->type_data->show_menu("save_and_quotation"),
1627 submit => [ '#order_form', { action => "DeliveryOrder/request_for_quotation" } ],
1628 only_if => $self->type_data->show_menu("save_and_rfq"),
1631 t8('Save and Sales Order'),
1632 submit => [ '#order_form', { action => "DeliveryOrder/sales_order" } ],
1633 only_if => $self->type_data->show_menu("save_and_sales_order"),
1636 t8('Save and Purchase Order'),
1637 call => [ 'kivi.DeliveryOrder.purchase_order_check_for_direct_delivery' ],
1638 only_if => $self->type_data->show_menu("save_and_purchase_order"),
1641 t8('Save and Delivery Order'),
1642 call => [ 'kivi.DeliveryOrder.save', 'save_and_delivery_order', $::instance_conf->get_order_warn_duplicate_parts,
1643 $::instance_conf->get_order_warn_no_deliverydate,
1645 only_if => $self->type_data->show_menu("save_and_delivery_order"),
1648 t8('Save and Invoice'),
1649 call => [ 'kivi.DeliveryOrder.save', 'save_and_invoice', $::instance_conf->get_order_warn_duplicate_parts ],
1650 only_if => $self->type_data->show_menu("save_and_invoice"),
1653 t8('Save and AP Transaction'),
1654 call => [ 'kivi.DeliveryOrder.save', 'save_and_ap_transaction', $::instance_conf->get_order_warn_duplicate_parts ],
1655 only_if => $self->type_data->show_menu("save_and_ap_transaction"),
1658 ], # end of combobox "Workflow"
1665 t8('Save and preview PDF'),
1666 call => [ 'kivi.DeliveryOrder.save', 'preview_pdf', $::instance_conf->get_order_warn_duplicate_parts,
1667 $::instance_conf->get_order_warn_no_deliverydate,
1671 t8('Save and print'),
1672 call => [ 'kivi.DeliveryOrder.show_print_options', $::instance_conf->get_order_warn_duplicate_parts,
1673 $::instance_conf->get_order_warn_no_deliverydate,
1677 t8('Save and E-mail'),
1678 id => 'save_and_email_action',
1679 call => [ 'kivi.DeliveryOrder.save', 'save_and_show_email_dialog', $::instance_conf->get_order_warn_duplicate_parts,
1680 $::instance_conf->get_order_warn_no_deliverydate,
1682 disabled => !$self->order->id ? t8('This object has not been saved yet.') : undef,
1685 t8('Download attachments of all parts'),
1686 call => [ 'kivi.File.downloadOrderitemsFiles', $::form->{type}, $::form->{id} ],
1687 disabled => !$self->order->id ? t8('This object has not been saved yet.') : undef,
1688 only_if => $::instance_conf->get_doc_storage,
1690 ], # end of combobox "Export"
1694 call => [ 'kivi.DeliveryOrder.delete_order' ],
1695 confirm => $::locale->text('Do you really want to delete this object?'),
1696 disabled => !$self->order->id ? t8('This object has not been saved yet.') : undef,
1697 only_if => $self->type_data->show_menu("delete"),
1706 call => [ 'kivi.DeliveryOrder.follow_up_window' ],
1707 disabled => !$self->order->id ? t8('This object has not been saved yet.') : undef,
1708 only_if => $::auth->assert('productivity', 1),
1712 call => [ 'set_history_window', $self->order->id, 'id' ],
1713 disabled => !$self->order->id ? t8('This record has not been saved yet.') : undef,
1715 ], # end of combobox "more"
1721 my ($order, $pdf_ref, $params) = @_;
1725 my $print_form = Form->new('');
1726 $print_form->{type} = $order->type;
1727 $print_form->{formname} = $params->{formname} || $order->type;
1728 $print_form->{format} = $params->{format} || 'pdf';
1729 $print_form->{media} = $params->{media} || 'file';
1730 $print_form->{groupitems} = $params->{groupitems};
1731 $print_form->{printer_id} = $params->{printer_id};
1732 $print_form->{media} = 'file' if $print_form->{media} eq 'screen';
1734 $order->language($params->{language});
1735 $order->flatten_to_form($print_form, format_amounts => 1);
1739 if ($print_form->{format} =~ /(opendocument|oasis)/i) {
1740 $template_ext = 'odt';
1741 $template_type = 'OpenDocument';
1744 # search for the template
1745 my ($template_file, @template_files) = SL::Helper::CreatePDF->find_template(
1746 name => $print_form->{formname},
1747 extension => $template_ext,
1748 email => $print_form->{media} eq 'email',
1749 language => $params->{language},
1750 printer_id => $print_form->{printer_id},
1753 if (!defined $template_file) {
1754 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);
1757 return @errors if scalar @errors;
1759 $print_form->throw_on_error(sub {
1761 $print_form->prepare_for_printing;
1763 $$pdf_ref = SL::Helper::CreatePDF->create_pdf(
1764 format => $print_form->{format},
1765 template_type => $template_type,
1766 template => $template_file,
1767 variables => $print_form,
1768 variable_content_types => {
1769 longdescription => 'html',
1770 partnotes => 'html',
1775 } || push @errors, ref($EVAL_ERROR) eq 'SL::X::FormError' ? $EVAL_ERROR->error : $EVAL_ERROR;
1781 sub get_files_for_email_dialog {
1784 my %files = map { ($_ => []) } qw(versions files vc_files part_files);
1786 return %files if !$::instance_conf->get_doc_storage;
1788 if ($self->order->id) {
1789 $files{versions} = [ SL::File->get_all_versions(object_id => $self->order->id, object_type => $self->order->type, file_type => 'document') ];
1790 $files{files} = [ SL::File->get_all( object_id => $self->order->id, object_type => $self->order->type, file_type => 'attachment') ];
1791 $files{vc_files} = [ SL::File->get_all( object_id => $self->order->{$self->cv}->id, object_type => $self->cv, file_type => 'attachment') ];
1792 $files{project_files} = [ SL::File->get_all( object_id => $self->order->globalproject_id, object_type => 'project', file_type => 'attachment') ];
1796 uniq_by { $_->{id} }
1798 +{ id => $_->part->id,
1799 partnumber => $_->part->partnumber }
1800 } @{$self->order->items_sorted};
1802 foreach my $part (@parts) {
1803 my @pfiles = SL::File->get_all(object_id => $part->{id}, object_type => 'part');
1804 push @{ $files{part_files} }, map { +{ %{ $_ }, partnumber => $part->{partnumber} } } @pfiles;
1807 foreach my $key (keys %files) {
1808 $files{$key} = [ sort_by { lc $_->{db_file}->{file_name} } @{ $files{$key} } ];
1815 my ($self, $action) = @_;
1817 return '' if none { lc($action)} qw(add edit);
1818 return $self->type_data->text($action);
1821 sub get_item_cvpartnumber {
1822 my ($self, $item) = @_;
1824 return if !$self->search_cvpartnumber;
1825 return if !$self->order->customervendor;
1827 if ($self->cv eq 'vendor') {
1828 my @mms = grep { $_->make eq $self->order->customervendor->id } @{$item->part->makemodels};
1829 $item->{cvpartnumber} = $mms[0]->model if scalar @mms;
1830 } elsif ($self->cv eq 'customer') {
1831 my @cps = grep { $_->customer_id eq $self->order->customervendor->id } @{$item->part->customerprices};
1832 $item->{cvpartnumber} = $cps[0]->customer_partnumber if scalar @cps;
1836 sub get_part_texts {
1837 my ($part_or_id, $language_or_id, %defaults) = @_;
1839 my $part = ref($part_or_id) ? $part_or_id : SL::DB::Part->load_cached($part_or_id);
1840 my $language_id = ref($language_or_id) ? $language_or_id->id : $language_or_id;
1842 description => $defaults{description} // $part->description,
1843 longdescription => $defaults{longdescription} // $part->notes,
1846 return $texts unless $language_id;
1848 my $translation = SL::DB::Manager::Translation->get_first(
1850 parts_id => $part->id,
1851 language_id => $language_id,
1854 $texts->{description} = $translation->translation if $translation && $translation->translation;
1855 $texts->{longdescription} = $translation->longdescription if $translation && $translation->longdescription;
1861 return $_[0]->type_data->nr_key;
1864 sub save_and_redirect_to {
1865 my ($self, %params) = @_;
1867 my $errors = $self->save();
1869 if (scalar @{ $errors }) {
1870 $self->js->flash('error', $_) foreach @{ $errors };
1871 return $self->js->render();
1874 flash_later('info', $self->type_data->text("saved"));
1876 $self->redirect_to(%params, id => $self->order->id);
1880 my ($self, $addition) = @_;
1882 my $number_type = $self->nr_key;
1883 my $snumbers = $number_type . '_' . $self->order->$number_type;
1885 SL::DB::History->new(
1886 trans_id => $self->order->id,
1887 employee_id => SL::DB::Manager::Employee->current->id,
1888 what_done => $self->order->type,
1889 snumbers => $snumbers,
1890 addition => $addition,
1894 sub store_pdf_to_webdav_and_filemanagement {
1895 my($order, $content, $filename) = @_;
1899 # copy file to webdav folder
1900 if ($order->number && $::instance_conf->get_webdav_documents) {
1901 my $webdav = SL::Webdav->new(
1902 type => $order->type,
1903 number => $order->number,
1905 my $webdav_file = SL::Webdav::File->new(
1907 filename => $filename,
1910 $webdav_file->store(data => \$content);
1913 push @errors, t8('Storing PDF to webdav folder failed: #1', $@);
1916 if ($order->id && $::instance_conf->get_doc_storage) {
1918 SL::File->save(object_id => $order->id,
1919 object_type => $order->type,
1920 mime_type => 'application/pdf',
1921 source => 'created',
1922 file_type => 'document',
1923 file_name => $filename,
1924 file_contents => $content);
1927 push @errors, t8('Storing PDF in storage backend failed: #1', $@);
1934 sub calculate_stock_in_out {
1935 my ($self, $item) = @_;
1937 return "" if !$item->part || !$item->part->unit;
1939 my $in_out = $self->type_data->properties("transfer");
1941 my $do_qty = $item->qty;
1942 my $sum = sum0 map { $_->unit_obj->convert_to($_->qty, $item->unit_obj) } @{ $item->delivery_order_stock_entries };
1944 my $matches = $do_qty == $sum;
1945 my $content = _format_number_units($sum, 2, $item->unit_obj, $item->part->unit_obj);
1950 sub init_type_data {
1951 SL::Controller::DeliveryOrder::TypeData->new($_[0]);
1954 sub init_valid_types {
1955 $_[0]->type_data->valid_types;
1966 SL::Controller::Order - controller for orders
1970 This is a new form to enter orders, completely rewritten with the use
1971 of controller and java script techniques.
1973 The aim is to provide the user a better experience and a faster workflow. Also
1974 the code should be more readable, more reliable and better to maintain.
1982 One input row, so that input happens every time at the same place.
1986 Use of pickers where possible.
1990 Possibility to enter more than one item at once.
1994 Item list in a scrollable area, so that the workflow buttons stay at
1999 Reordering item rows with drag and drop is possible. Sorting item rows is
2000 possible (by partnumber, description, qty, sellprice and discount for now).
2004 No C<update> is necessary. All entries and calculations are managed
2005 with ajax-calls and the page only reloads on C<save>.
2009 User can see changes immediately, because of the use of java script
2020 =item * C<SL/Controller/Order.pm>
2024 =item * C<template/webpages/delivery_order/form.html>
2028 =item * C<template/webpages/delivery_order/tabs/basic_data.html>
2030 Main tab for basic_data.
2032 This is the only tab here for now. "linked records" and "webdav" tabs are
2033 reused from generic code.
2037 =item * C<template/webpages/delivery_order/tabs/_business_info_row.html>
2039 For displaying information on business type
2041 =item * C<template/webpages/delivery_order/tabs/_item_input.html>
2043 The input line for items
2045 =item * C<template/webpages/delivery_order/tabs/_row.html>
2047 One row for already entered items
2049 =item * C<template/webpages/delivery_order/tabs/_tax_row.html>
2051 Displaying tax information
2055 =item * C<js/kivi.DeliveryOrder.js>
2057 java script functions
2067 =item * price sources: little symbols showing better price / better discount
2069 =item * select units in input row?
2071 =item * check for direct delivery (workflow sales order -> purchase order)
2073 =item * access rights
2075 =item * display weights
2079 =item * optional client/user behaviour
2081 (transactions has to be set - department has to be set -
2082 force project if enabled in client config - transport cost reminder)
2086 =head1 KNOWN BUGS AND CAVEATS
2092 Customer discount is not displayed as a valid discount in price source popup
2093 (this might be a bug in price sources)
2095 (I cannot reproduce this (Bernd))
2099 No indication that <shift>-up/down expands/collapses second row.
2103 Inline creation of parts is not currently supported
2107 Table header is not sticky in the scrolling area.
2111 Sorting does not include C<position>, neither does reordering.
2113 This behavior was implemented intentionally. But we can discuss, which behavior
2114 should be implemented.
2118 =head1 To discuss / Nice to have
2124 How to expand/collapse second row. Now it can be done clicking the icon or
2129 Possibility to select PriceSources in input row?
2133 This controller uses a (changed) copy of the template for the PriceSource
2134 dialog. Maybe there could be used one code source.
2138 Rounding-differences between this controller (PriceTaxCalculator) and the old
2139 form. This is not only a problem here, but also in all parts using the PTC.
2140 There exists a ticket and a patch. This patch should be testet.
2144 An indicator, if the actual inputs are saved (like in an
2145 editor or on text processing application).
2149 A warning when leaving the page without saveing unchanged inputs.
2156 Bernd Bleßmann E<lt>bernd@kivitendo-premium.deE<gt>