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;
36 use SL::Controller::DeliveryOrder::TypeData;
38 use List::Util qw(first sum0);
39 use List::UtilsBy qw(sort_by uniq_by);
40 use List::MoreUtils qw(any none pairwise first_index);
41 use English qw(-no_match_vars);
46 use Rose::Object::MakeMethods::Generic
48 scalar => [ qw(item_ids_to_delete is_custom_shipto_to_delete) ],
49 'scalar --get_set_init' => [ qw(order valid_types type cv p all_price_factors search_cvpartnumber show_update_button part_picker_classification_ids) ],
54 __PACKAGE__->run_before('check_auth');
56 __PACKAGE__->run_before('get_unalterable_data',
57 only => [ qw(save save_as_new save_and_delivery_order save_and_invoice save_and_ap_transaction
68 $self->order->transdate(DateTime->now_local());
69 $self->set_reqdate_by_type;
74 'delivery_order/form',
75 title => $self->get_title_for('add'),
76 %{$self->{template_args}}
80 # edit an existing order
88 # this is to edit an order from an unsaved order object
90 # set item ids to new fake id, to identify them as new items
91 foreach my $item (@{$self->order->items_sorted}) {
92 $item->{new_fake_id} = join('_', 'new', Time::HiRes::gettimeofday(), int rand 1000000000000);
94 # trigger rendering values for second row as hidden, because they
95 # are loaded only on demand. So we need to keep the values from
97 $_->{render_second_row} = 1 for @{ $self->order->items_sorted };
102 'delivery_order/form',
103 title => $self->get_title_for('edit'),
104 %{$self->{template_args}}
108 # edit a collective order (consisting of one or more existing orders)
109 sub action_edit_collective {
113 my @multi_ids = map {
114 $_ =~ m{^multi_id_(\d+)$} && $::form->{'multi_id_' . $1} && $::form->{'trans_id_' . $1} && $::form->{'trans_id_' . $1}
115 } grep { $_ =~ m{^multi_id_\d+$} } keys %$::form;
117 # fall back to add if no ids are given
118 if (scalar @multi_ids == 0) {
123 # fall back to save as new if only one id is given
124 if (scalar @multi_ids == 1) {
125 $self->order(SL::DB::DeliveryOrder->new(id => $multi_ids[0])->load);
126 $self->action_save_as_new();
130 # make new order from given orders
131 my @multi_orders = map { SL::DB::DeliveryOrder->new(id => $_)->load } @multi_ids;
132 $self->{converted_from_oe_id} = join ' ', map { $_->id } @multi_orders;
133 $self->order(SL::DB::DeliveryOrder->new_from_multi(\@multi_orders, sort_sources_by => 'transdate'));
135 $self->action_edit();
142 my $errors = $self->delete();
144 if (scalar @{ $errors }) {
145 $self->js->flash('error', $_) foreach @{ $errors };
146 return $self->js->render();
149 flash_later('info', $self->type_data->text("delete"));
151 my @redirect_params = (
156 $self->redirect_to(@redirect_params);
163 my $errors = $self->save();
165 if (scalar @{ $errors }) {
166 $self->js->flash('error', $_) foreach @{ $errors };
167 return $self->js->render();
170 flash_later('info', $self->type_data->text("saved"));
172 my @redirect_params = (
175 id => $self->order->id,
178 $self->redirect_to(@redirect_params);
181 # save the order as new document an open it for edit
182 sub action_save_as_new {
185 my $order = $self->order;
188 $self->js->flash('error', t8('This object has not been saved yet.'));
189 return $self->js->render();
192 # load order from db to check if values changed
193 my $saved_order = SL::DB::DeliveryOrder->new(id => $order->id)->load;
196 # Lets assign a new number if the user hasn't changed the previous one.
197 # If it has been changed manually then use it as-is.
198 $new_attrs{number} = (trim($order->number) eq $saved_order->number)
200 : trim($order->number);
202 # Clear transdate unless changed
203 $new_attrs{transdate} = ($order->transdate == $saved_order->transdate)
204 ? DateTime->today_local
207 # Set new reqdate unless changed if it is enabled in client config
208 $new_attrs{reqdate} = $self->get_reqdate_by_type($order->reqdate, $saved_order->reqdate);
211 $new_attrs{employee} = SL::DB::Manager::Employee->current;
213 # Create new record from current one
214 $self->order(SL::DB::DeliveryOrder->new_from($order, destination_type => $order->type, attributes => \%new_attrs));
216 # no linked records on save as new
217 delete $::form->{$_} for qw(converted_from_oe_id converted_from_orderitems_ids);
220 $self->action_save();
225 # This is called if "print" is pressed in the print dialog.
226 # If PDF creation was requested and succeeded, the pdf is offered for download
227 # via send_file (which uses ajax in this case).
231 my $errors = $self->save();
233 if (scalar @{ $errors }) {
234 $self->js->flash('error', $_) foreach @{ $errors };
235 return $self->js->render();
238 $self->js_reset_order_and_item_ids_after_save;
240 my $format = $::form->{print_options}->{format};
241 my $media = $::form->{print_options}->{media};
242 my $formname = $::form->{print_options}->{formname};
243 my $copies = $::form->{print_options}->{copies};
244 my $groupitems = $::form->{print_options}->{groupitems};
245 my $printer_id = $::form->{print_options}->{printer_id};
247 # only pdf and opendocument by now
248 if (none { $format eq $_ } qw(pdf opendocument opendocument_pdf)) {
249 return $self->js->flash('error', t8('Format \'#1\' is not supported yet/anymore.', $format))->render;
252 # only screen or printer by now
253 if (none { $media eq $_ } qw(screen printer)) {
254 return $self->js->flash('error', t8('Media \'#1\' is not supported yet/anymore.', $media))->render;
257 # create a form for generate_attachment_filename
258 my $form = Form->new;
259 $form->{$self->nr_key()} = $self->order->number;
260 $form->{type} = $self->type;
261 $form->{format} = $format;
262 $form->{formname} = $formname;
263 $form->{language} = '_' . $self->order->language->template_code if $self->order->language;
264 my $pdf_filename = $form->generate_attachment_filename();
267 my @errors = generate_pdf($self->order, \$pdf, { format => $format,
268 formname => $formname,
269 language => $self->order->language,
270 printer_id => $printer_id,
271 groupitems => $groupitems });
272 if (scalar @errors) {
273 return $self->js->flash('error', t8('Conversion to PDF failed: #1', $errors[0]))->render;
276 if ($media eq 'screen') {
278 $self->js->flash('info', t8('The PDF has been created'));
281 type => SL::MIME->mime_type_from_ext($pdf_filename),
282 name => $pdf_filename,
286 } elsif ($media eq 'printer') {
288 my $printer_id = $::form->{print_options}->{printer_id};
289 SL::DB::Printer->new(id => $printer_id)->load->print_document(
294 $self->js->flash('info', t8('The PDF has been printed'));
297 my @warnings = store_pdf_to_webdav_and_filemanagement($self->order, $pdf, $pdf_filename);
298 if (scalar @warnings) {
299 $self->js->flash('warning', $_) for @warnings;
302 $self->save_history('PRINTED');
305 ->run('kivi.ActionBar.setEnabled', '#save_and_email_action')
308 sub action_preview_pdf {
311 my $errors = $self->save();
312 if (scalar @{ $errors }) {
313 $self->js->flash('error', $_) foreach @{ $errors };
314 return $self->js->render();
317 $self->js_reset_order_and_item_ids_after_save;
320 my $media = 'screen';
321 my $formname = $self->type;
324 # create a form for generate_attachment_filename
325 my $form = Form->new;
326 $form->{$self->nr_key()} = $self->order->number;
327 $form->{type} = $self->type;
328 $form->{format} = $format;
329 $form->{formname} = $formname;
330 $form->{language} = '_' . $self->order->language->template_code if $self->order->language;
331 my $pdf_filename = $form->generate_attachment_filename();
334 my @errors = generate_pdf($self->order, \$pdf, { format => $format,
335 formname => $formname,
336 language => $self->order->language,
338 if (scalar @errors) {
339 return $self->js->flash('error', t8('Conversion to PDF failed: #1', $errors[0]))->render;
341 $self->save_history('PREVIEWED');
342 $self->js->flash('info', t8('The PDF has been previewed'));
346 type => SL::MIME->mime_type_from_ext($pdf_filename),
347 name => $pdf_filename,
352 # open the email dialog
353 sub action_save_and_show_email_dialog {
356 my $errors = $self->save();
358 if (scalar @{ $errors }) {
359 $self->js->flash('error', $_) foreach @{ $errors };
360 return $self->js->render();
363 my $cv_method = $self->cv;
365 if (!$self->order->$cv_method) {
366 return $self->js->flash('error', $self->cv eq 'customer' ? t8('Cannot send E-mail without customer given') : t8('Cannot send E-mail without vendor given'))
371 $email_form->{to} = $self->order->contact->cp_email if $self->order->contact;
372 $email_form->{to} ||= $self->order->$cv_method->email;
373 $email_form->{cc} = $self->order->$cv_method->cc;
374 $email_form->{bcc} = join ', ', grep $_, $self->order->$cv_method->bcc, SL::DB::Default->get->global_bcc;
375 # Todo: get addresses from shipto, if any
377 my $form = Form->new;
378 $form->{$self->nr_key()} = $self->order->number;
379 $form->{cusordnumber} = $self->order->cusordnumber;
380 $form->{formname} = $self->type;
381 $form->{type} = $self->type;
382 $form->{language} = '_' . $self->order->language->template_code if $self->order->language;
383 $form->{language_id} = $self->order->language->id if $self->order->language;
384 $form->{format} = 'pdf';
385 $form->{cp_id} = $self->order->contact->cp_id if $self->order->contact;
387 $email_form->{subject} = $form->generate_email_subject();
388 $email_form->{attachment_filename} = $form->generate_attachment_filename();
389 $email_form->{message} = $form->generate_email_body();
390 $email_form->{js_send_function} = 'kivi.Order.send_email()';
392 my %files = $self->get_files_for_email_dialog();
393 $self->{all_employees} = SL::DB::Manager::Employee->get_all(query => [ deleted => 0 ]);
394 my $dialog_html = $self->render('common/_send_email_dialog', { output => 0 },
395 email_form => $email_form,
396 show_bcc => $::auth->assert('email_bcc', 'may fail'),
398 is_customer => $self->cv eq 'customer',
399 ALL_EMPLOYEES => $self->{all_employees},
403 ->run('kivi.Order.show_email_dialog', $dialog_html)
410 # Todo: handling error messages: flash is not displayed in dialog, but in the main form
411 sub action_send_email {
414 my $errors = $self->save();
416 if (scalar @{ $errors }) {
417 $self->js->run('kivi.Order.close_email_dialog');
418 $self->js->flash('error', $_) foreach @{ $errors };
419 return $self->js->render();
422 $self->js_reset_order_and_item_ids_after_save;
424 my $email_form = delete $::form->{email_form};
425 my %field_names = (to => 'email');
427 $::form->{ $field_names{$_} // $_ } = $email_form->{$_} for keys %{ $email_form };
429 # for Form::cleanup which may be called in Form::send_email
430 $::form->{cwd} = getcwd();
431 $::form->{tmpdir} = $::lx_office_conf{paths}->{userspath};
433 $::form->{$_} = $::form->{print_options}->{$_} for keys %{ $::form->{print_options} };
434 $::form->{media} = 'email';
436 if (($::form->{attachment_policy} // '') !~ m{^(?:old_file|no_file)$}) {
438 my @errors = generate_pdf($self->order, \$pdf, {media => $::form->{media},
439 format => $::form->{print_options}->{format},
440 formname => $::form->{print_options}->{formname},
441 language => $self->order->language,
442 printer_id => $::form->{print_options}->{printer_id},
443 groupitems => $::form->{print_options}->{groupitems}});
444 if (scalar @errors) {
445 return $self->js->flash('error', t8('Conversion to PDF failed: #1', $errors[0]))->render($self);
448 my @warnings = store_pdf_to_webdav_and_filemanagement($self->order, $pdf, $::form->{attachment_filename});
449 if (scalar @warnings) {
450 flash_later('warning', $_) for @warnings;
453 my $sfile = SL::SessionFile::Random->new(mode => "w");
454 $sfile->fh->print($pdf);
457 $::form->{tmpfile} = $sfile->file_name;
458 $::form->{tmpdir} = $sfile->get_path; # for Form::cleanup which may be called in Form::send_email
461 $::form->{id} = $self->order->id; # this is used in SL::Mailer to create a linked record to the mail
462 $::form->send_email(\%::myconfig, 'pdf');
465 my $intnotes = $self->order->intnotes;
466 $intnotes .= "\n\n" if $self->order->intnotes;
467 $intnotes .= t8('[email]') . "\n";
468 $intnotes .= t8('Date') . ": " . $::locale->format_date_object(DateTime->now_local, precision => 'seconds') . "\n";
469 $intnotes .= t8('To (email)') . ": " . $::form->{email} . "\n";
470 $intnotes .= t8('Cc') . ": " . $::form->{cc} . "\n" if $::form->{cc};
471 $intnotes .= t8('Bcc') . ": " . $::form->{bcc} . "\n" if $::form->{bcc};
472 $intnotes .= t8('Subject') . ": " . $::form->{subject} . "\n\n";
473 $intnotes .= t8('Message') . ": " . $::form->{message};
475 $self->order->update_attributes(intnotes => $intnotes);
477 $self->save_history('MAILED');
479 flash_later('info', t8('The email has been sent.'));
481 my @redirect_params = (
484 id => $self->order->id,
487 $self->redirect_to(@redirect_params);
490 # save the order and redirect to the frontend subroutine for a new
492 sub action_save_and_delivery_order {
495 $self->save_and_redirect_to(
496 controller => 'oe.pl',
497 action => 'oe_delivery_order_from_order',
501 # save the order and redirect to the frontend subroutine for a new
503 sub action_save_and_invoice {
506 $self->save_and_redirect_to(
507 controller => 'oe.pl',
508 action => 'oe_invoice_from_order',
512 # workflow from sales order to sales quotation
513 sub action_sales_quotation {
514 $_[0]->workflow_sales_or_request_for_quotation();
517 # workflow from sales order to sales quotation
518 sub action_request_for_quotation {
519 $_[0]->workflow_sales_or_request_for_quotation();
522 # workflow from sales quotation to sales order
523 sub action_sales_order {
524 $_[0]->workflow_sales_or_purchase_order();
527 # workflow from rfq to purchase order
528 sub action_purchase_order {
529 $_[0]->workflow_sales_or_purchase_order();
532 # workflow from purchase order to ap transaction
533 sub action_save_and_ap_transaction {
536 $self->save_and_redirect_to(
537 controller => 'ap.pl',
538 action => 'add_from_purchase_order',
542 # set form elements in respect to a changed customer or vendor
544 # This action is called on an change of the customer/vendor picker.
545 sub action_customer_vendor_changed {
548 setup_order_from_cv($self->order);
550 my $cv_method = $self->cv;
552 if ($self->order->$cv_method->contacts && scalar @{ $self->order->$cv_method->contacts } > 0) {
553 $self->js->show('#cp_row');
555 $self->js->hide('#cp_row');
558 if ($self->order->$cv_method->shipto && scalar @{ $self->order->$cv_method->shipto } > 0) {
559 $self->js->show('#shipto_selection');
561 $self->js->hide('#shipto_selection');
564 $self->js->val( '#order_salesman_id', $self->order->salesman_id) if $self->order->is_sales;
567 ->replaceWith('#order_cp_id', $self->build_contact_select)
568 ->replaceWith('#order_shipto_id', $self->build_shipto_select)
569 ->replaceWith('#shipto_inputs ', $self->build_shipto_inputs)
570 ->replaceWith('#business_info_row', $self->build_business_info_row)
571 ->val( '#order_taxzone_id', $self->order->taxzone_id)
572 ->val( '#order_taxincluded', $self->order->taxincluded)
573 ->val( '#order_currency_id', $self->order->currency_id)
574 ->val( '#order_payment_id', $self->order->payment_id)
575 ->val( '#order_delivery_term_id', $self->order->delivery_term_id)
576 ->val( '#order_intnotes', $self->order->intnotes)
577 ->val( '#order_language_id', $self->order->$cv_method->language_id)
578 ->focus( '#order_' . $self->cv . '_id')
579 ->run('kivi.Order.update_exchangerate');
581 $self->js_redisplay_cvpartnumbers;
585 # open the dialog for customer/vendor details
586 sub action_show_customer_vendor_details_dialog {
589 my $is_customer = 'customer' eq $::form->{vc};
592 $cv = SL::DB::Customer->new(id => $::form->{vc_id})->load;
594 $cv = SL::DB::Vendor->new(id => $::form->{vc_id})->load;
597 my %details = map { $_ => $cv->$_ } @{$cv->meta->columns};
598 $details{discount_as_percent} = $cv->discount_as_percent;
599 $details{creditlimt} = $cv->creditlimit_as_number;
600 $details{business} = $cv->business->description if $cv->business;
601 $details{language} = $cv->language_obj->description if $cv->language_obj;
602 $details{delivery_terms} = $cv->delivery_term->description if $cv->delivery_term;
603 $details{payment_terms} = $cv->payment->description if $cv->payment;
604 $details{pricegroup} = $cv->pricegroup->pricegroup if $is_customer && $cv->pricegroup;
606 foreach my $entry (@{ $cv->shipto }) {
607 push @{ $details{SHIPTO} }, { map { $_ => $entry->$_ } @{$entry->meta->columns} };
609 foreach my $entry (@{ $cv->contacts }) {
610 push @{ $details{CONTACTS} }, { map { $_ => $entry->$_ } @{$entry->meta->columns} };
613 $_[0]->render('common/show_vc_details', { layout => 0 },
614 is_customer => $is_customer,
619 # called if a unit in an existing item row is changed
620 sub action_unit_changed {
623 my $idx = first_index { $_ eq $::form->{item_id} } @{ $::form->{orderitem_ids} };
624 my $item = $self->order->items_sorted->[$idx];
626 my $old_unit_obj = SL::DB::Unit->new(name => $::form->{old_unit})->load;
627 $item->sellprice($item->unit_obj->convert_to($item->sellprice, $old_unit_obj));
630 ->run('kivi.Order.update_sellprice', $::form->{item_id}, $item->sellprice_as_number);
631 $self->js_redisplay_line_values;
635 # add an item row for a new item entered in the input row
636 sub action_add_item {
639 delete $::form->{add_item}->{create_part_type};
641 my $form_attr = $::form->{add_item};
643 return unless $form_attr->{parts_id};
645 my $item = new_item($self->order, $form_attr);
647 $self->order->add_items($item);
649 $self->get_item_cvpartnumber($item);
651 my $item_id = join('_', 'new', Time::HiRes::gettimeofday(), int rand 1000000000000);
652 my $row_as_html = $self->p->render('delivery_order/tabs/_row',
658 if ($::form->{insert_before_item_id}) {
660 ->before ('.row_entry:has(#item_' . $::form->{insert_before_item_id} . ')', $row_as_html);
663 ->append('#row_table_id', $row_as_html);
666 if ( $item->part->is_assortment ) {
667 $form_attr->{qty_as_number} = 1 unless $form_attr->{qty_as_number};
668 foreach my $assortment_item ( @{$item->part->assortment_items} ) {
669 my $attr = { parts_id => $assortment_item->parts_id,
670 qty => $assortment_item->qty * $::form->parse_amount(\%::myconfig, $form_attr->{qty_as_number}), # TODO $form_attr->{unit}
671 unit => $assortment_item->unit,
672 description => $assortment_item->part->description,
674 my $item = new_item($self->order, $attr);
676 # set discount to 100% if item isn't supposed to be charged, overwriting any customer discount
677 $item->discount(1) unless $assortment_item->charge;
679 $self->order->add_items( $item );
680 $self->get_item_cvpartnumber($item);
681 my $item_id = join('_', 'new', Time::HiRes::gettimeofday(), int rand 1000000000000);
682 my $row_as_html = $self->p->render('delivery_order/tabs/_row',
687 if ($::form->{insert_before_item_id}) {
689 ->before ('.row_entry:has(#item_' . $::form->{insert_before_item_id} . ')', $row_as_html);
692 ->append('#row_table_id', $row_as_html);
698 ->val('.add_item_input', '')
699 ->run('kivi.Order.init_row_handlers')
700 ->run('kivi.Order.renumber_positions')
701 ->focus('#add_item_parts_id_name');
703 $self->js->run('kivi.Order.row_table_scroll_down') if !$::form->{insert_before_item_id};
708 # add item rows for multiple items at once
709 sub action_add_multi_items {
712 my @form_attr = grep { $_->{qty_as_number} } @{ $::form->{add_items} };
713 return $self->js->render() unless scalar @form_attr;
716 foreach my $attr (@form_attr) {
717 my $item = new_item($self->order, $attr);
719 if ( $item->part->is_assortment ) {
720 foreach my $assortment_item ( @{$item->part->assortment_items} ) {
721 my $attr = { parts_id => $assortment_item->parts_id,
722 qty => $assortment_item->qty * $item->qty, # TODO $form_attr->{unit}
723 unit => $assortment_item->unit,
724 description => $assortment_item->part->description,
726 my $item = new_item($self->order, $attr);
728 # set discount to 100% if item isn't supposed to be charged, overwriting any customer discount
729 $item->discount(1) unless $assortment_item->charge;
734 $self->order->add_items(@items);
736 foreach my $item (@items) {
737 $self->get_item_cvpartnumber($item);
738 my $item_id = join('_', 'new', Time::HiRes::gettimeofday(), int rand 1000000000000);
739 my $row_as_html = $self->p->render('delivery_order/tabs/_row',
745 if ($::form->{insert_before_item_id}) {
747 ->before ('.row_entry:has(#item_' . $::form->{insert_before_item_id} . ')', $row_as_html);
750 ->append('#row_table_id', $row_as_html);
755 ->run('kivi.Part.close_picker_dialogs')
756 ->run('kivi.Order.init_row_handlers')
757 ->run('kivi.Order.renumber_positions')
758 ->focus('#add_item_parts_id_name');
760 $self->js->run('kivi.Order.row_table_scroll_down') if !$::form->{insert_before_item_id};
765 sub action_update_exchangerate {
769 is_standard => $self->order->currency_id == $::instance_conf->get_currency_id,
770 currency_name => $self->order->currency->name,
773 $self->render(\SL::JSON::to_json($data), { type => 'json', process => 0 });
776 # redisplay item rows if they are sorted by an attribute
777 sub action_reorder_items {
781 partnumber => sub { $_[0]->part->partnumber },
782 description => sub { $_[0]->description },
783 qty => sub { $_[0]->qty },
784 sellprice => sub { $_[0]->sellprice },
785 discount => sub { $_[0]->discount },
786 cvpartnumber => sub { $_[0]->{cvpartnumber} },
789 $self->get_item_cvpartnumber($_) for @{$self->order->items_sorted};
791 my $method = $sort_keys{$::form->{order_by}};
792 my @to_sort = map { { old_pos => $_->position, order_by => $method->($_) } } @{ $self->order->items_sorted };
793 if ($::form->{sort_dir}) {
794 if ( $::form->{order_by} =~ m/qty|sellprice|discount/ ){
795 @to_sort = sort { $a->{order_by} <=> $b->{order_by} } @to_sort;
797 @to_sort = sort { $a->{order_by} cmp $b->{order_by} } @to_sort;
800 if ( $::form->{order_by} =~ m/qty|sellprice|discount/ ){
801 @to_sort = sort { $b->{order_by} <=> $a->{order_by} } @to_sort;
803 @to_sort = sort { $b->{order_by} cmp $a->{order_by} } @to_sort;
807 ->run('kivi.Order.redisplay_items', \@to_sort)
811 # show the popup to choose a price/discount source
812 sub action_price_popup {
815 my $idx = first_index { $_ eq $::form->{item_id} } @{ $::form->{orderitem_ids} };
816 my $item = $self->order->items_sorted->[$idx];
818 $self->render_price_dialog($item);
821 # save the order in a session variable and redirect to the part controller
822 sub action_create_part {
825 my $previousform = $::auth->save_form_in_session(non_scalars => 1);
827 my $callback = $self->url_for(
828 action => 'return_from_create_part',
829 type => $self->type, # type is needed for check_auth on return
830 previousform => $previousform,
833 flash_later('info', t8('You are adding a new part while you are editing another document. You will be redirected to your document when saving the new part or aborting this form.'));
835 my @redirect_params = (
836 controller => 'Part',
838 part_type => $::form->{add_item}->{create_part_type},
839 callback => $callback,
843 $self->redirect_to(@redirect_params);
846 sub action_return_from_create_part {
849 $self->{created_part} = SL::DB::Part->new(id => delete $::form->{new_parts_id})->load if $::form->{new_parts_id};
851 $::auth->restore_form_from_session(delete $::form->{previousform});
853 # set item ids to new fake id, to identify them as new items
854 foreach my $item (@{$self->order->items_sorted}) {
855 $item->{new_fake_id} = join('_', 'new', Time::HiRes::gettimeofday(), int rand 1000000000000);
858 $self->get_unalterable_data();
861 # trigger rendering values for second row/longdescription as hidden,
862 # because they are loaded only on demand. So we need to keep the values
864 $_->{render_second_row} = 1 for @{ $self->order->items_sorted };
865 $_->{render_longdescription} = 1 for @{ $self->order->items_sorted };
868 'delivery_order/form',
869 title => $self->get_title_for('edit'),
870 %{$self->{template_args}}
875 # load the second row for one or more items
877 # This action gets the html code for all items second rows by rendering a template for
878 # the second row and sets the html code via client js.
879 sub action_load_second_rows {
882 foreach my $item_id (@{ $::form->{item_ids} }) {
883 my $idx = first_index { $_ eq $item_id } @{ $::form->{orderitem_ids} };
884 my $item = $self->order->items_sorted->[$idx];
886 $self->js_load_second_row($item, $item_id, 0);
889 $self->js->run('kivi.Order.init_row_handlers') if $self->order->is_sales; # for lastcosts change-callback
894 # update description, notes and sellprice from master data
895 sub action_update_row_from_master_data {
898 foreach my $item_id (@{ $::form->{item_ids} }) {
899 my $idx = first_index { $_ eq $item_id } @{ $::form->{orderitem_ids} };
900 my $item = $self->order->items_sorted->[$idx];
901 my $texts = get_part_texts($item->part, $self->order->language_id);
903 $item->description($texts->{description});
904 $item->longdescription($texts->{longdescription});
906 my $price_source = SL::PriceSource->new(record_item => $item, record => $self->order);
909 if ($item->part->is_assortment) {
910 # add assortment items with price 0, as the components carry the price
911 $price_src = $price_source->price_from_source("");
912 $price_src->price(0);
914 $price_src = $price_source->best_price
915 ? $price_source->best_price
916 : $price_source->price_from_source("");
917 $price_src->price($::form->round_amount($price_src->price / $self->order->exchangerate, 5)) if $self->order->exchangerate;
918 $price_src->price(0) if !$price_source->best_price;
922 $item->sellprice($price_src->price);
923 $item->active_price_source($price_src);
926 ->run('kivi.Order.update_sellprice', $item_id, $item->sellprice_as_number)
927 ->html('.row_entry:has(#item_' . $item_id . ') [name = "partnumber"] a', $item->part->partnumber)
928 ->val ('.row_entry:has(#item_' . $item_id . ') [name = "order.orderitems[].description"]', $item->description)
929 ->val ('.row_entry:has(#item_' . $item_id . ') [name = "order.orderitems[].longdescription"]', $item->longdescription);
931 if ($self->search_cvpartnumber) {
932 $self->get_item_cvpartnumber($item);
933 $self->js->html('.row_entry:has(#item_' . $item_id . ') [name = "cvpartnumber"]', $item->{cvpartnumber});
937 $self->js_redisplay_line_values;
942 sub js_load_second_row {
943 my ($self, $item, $item_id, $do_parse) = @_;
946 # Parse values from form (they are formated while rendering (template)).
947 # Workaround to pre-parse number-cvars (parse_custom_variable_values does not parse number values).
948 # This parsing is not necessary at all, if we assure that the second row/cvars are only loaded once.
949 foreach my $var (@{ $item->cvars_by_config }) {
950 $var->unparsed_value($::form->parse_amount(\%::myconfig, $var->{__unparsed_value})) if ($var->config->type eq 'number' && exists($var->{__unparsed_value}));
952 $item->parse_custom_variable_values;
955 my $row_as_html = $self->p->render('delivery_order/tabs/_second_row', ITEM => $item, TYPE => $self->type);
958 ->html('#second_row_' . $item_id, $row_as_html)
959 ->data('#second_row_' . $item_id, 'loaded', 1);
962 sub js_redisplay_line_values {
965 my $is_sales = $self->order->is_sales;
967 # sales orders with margins
972 $::form->format_amount(\%::myconfig, $_->{linetotal}, 2, 0),
973 $::form->format_amount(\%::myconfig, $_->{marge_total}, 2, 0),
974 $::form->format_amount(\%::myconfig, $_->{marge_percent}, 2, 0),
975 ]} @{ $self->order->items_sorted };
979 $::form->format_amount(\%::myconfig, $_->{linetotal}, 2, 0),
980 ]} @{ $self->order->items_sorted };
984 ->run('kivi.Order.redisplay_line_values', $is_sales, \@data);
987 sub js_redisplay_cvpartnumbers {
990 $self->get_item_cvpartnumber($_) for @{$self->order->items_sorted};
992 my @data = map {[$_->{cvpartnumber}]} @{ $self->order->items_sorted };
995 ->run('kivi.Order.redisplay_cvpartnumbers', \@data);
998 sub js_reset_order_and_item_ids_after_save {
1002 ->val('#id', $self->order->id)
1003 ->val('#converted_from_oe_id', '')
1004 ->val('#order_' . $self->nr_key(), $self->order->number);
1007 foreach my $form_item_id (@{ $::form->{orderitem_ids} }) {
1008 next if !$self->order->items_sorted->[$idx]->id;
1009 next if $form_item_id !~ m{^new};
1011 ->val ('[name="orderitem_ids[+]"][value="' . $form_item_id . '"]', $self->order->items_sorted->[$idx]->id)
1012 ->val ('#item_' . $form_item_id, $self->order->items_sorted->[$idx]->id)
1013 ->attr('#item_' . $form_item_id, "id", 'item_' . $self->order->items_sorted->[$idx]->id);
1017 $self->js->val('[name="converted_from_orderitems_ids[+]"]', '');
1027 if (none { $::form->{type} eq $_ } @{$self->valid_types}) {
1028 die "Not a valid type for order";
1031 $self->type($::form->{type});
1037 return $self->type_data->customervendor;
1040 sub init_search_cvpartnumber {
1043 my $user_prefs = SL::Helper::UserPreferences::PartPickerSearch->new();
1044 my $search_cvpartnumber;
1045 $search_cvpartnumber = !!$user_prefs->get_sales_search_customer_partnumber() if $self->cv eq 'customer';
1046 $search_cvpartnumber = !!$user_prefs->get_purchase_search_makemodel() if $self->cv eq 'vendor';
1048 return $search_cvpartnumber;
1051 sub init_show_update_button {
1054 !!SL::Helper::UserPreferences::UpdatePositions->new()->get_show_update_button();
1065 sub init_all_price_factors {
1066 SL::DB::Manager::PriceFactor->get_all;
1069 sub init_part_picker_classification_ids {
1072 return [ map { $_->id } @{ SL::DB::Manager::PartClassification->get_all(where => $self->type_date->part_classification_query) } ];
1078 $::auth->assert($self->type_data->access || 'DOES_NOT_EXIST');
1081 # build the selection box for contacts
1083 # Needed, if customer/vendor changed.
1084 sub build_contact_select {
1087 select_tag('order.cp_id', [ $self->order->{$self->cv}->contacts ],
1088 value_key => 'cp_id',
1089 title_key => 'full_name_dep',
1090 default => $self->order->cp_id,
1092 style => 'width: 300px',
1096 # build the selection box for shiptos
1098 # Needed, if customer/vendor changed.
1099 sub build_shipto_select {
1102 select_tag('order.shipto_id',
1103 [ {displayable_id => t8("No/individual shipping address"), shipto_id => ''}, $self->order->{$self->cv}->shipto ],
1104 value_key => 'shipto_id',
1105 title_key => 'displayable_id',
1106 default => $self->order->shipto_id,
1108 style => 'width: 300px',
1112 # build the inputs for the cusom shipto dialog
1114 # Needed, if customer/vendor changed.
1115 sub build_shipto_inputs {
1118 my $content = $self->p->render('common/_ship_to_dialog',
1119 vc_obj => $self->order->customervendor,
1120 cs_obj => $self->order->custom_shipto,
1121 cvars => $self->order->custom_shipto->cvars_by_config,
1122 id_selector => '#order_shipto_id');
1124 div_tag($content, id => 'shipto_inputs');
1127 # render the info line for business
1129 # Needed, if customer/vendor changed.
1130 sub build_business_info_row
1132 $_[0]->p->render('delivery_order/tabs/_business_info_row', SELF => $_[0]);
1139 return if !$::form->{id};
1141 $self->order(SL::DB::DeliveryOrder->new(id => $::form->{id})->load);
1143 # Add an empty custom shipto to the order, so that the dialog can render the cvar inputs.
1144 # You need a custom shipto object to call cvars_by_config to get the cvars.
1145 $self->order->custom_shipto(SL::DB::Shipto->new(module => 'OE', custom_variables => [])) if !$self->order->custom_shipto;
1147 return $self->order;
1150 # load or create a new order object
1152 # And assign changes from the form to this object.
1153 # If the order is loaded from db, check if items are deleted in the form,
1154 # remove them form the object and collect them for removing from db on saving.
1155 # Then create/update items from form (via make_item) and add them.
1159 # add_items adds items to an order with no items for saving, but they cannot
1160 # be retrieved via items until the order is saved. Adding empty items to new
1161 # order here solves this problem.
1163 $order = SL::DB::DeliveryOrder->new(id => $::form->{id})->load(with => [ 'orderitems', 'orderitems.part' ]) if $::form->{id};
1164 $order ||= SL::DB::DeliveryOrder->new(orderitems => [],
1165 quotation => $self->type_data->is_quotation,
1166 currency_id => $::instance_conf->get_currency_id(),);
1168 my $cv_id_method = $self->cv . '_id';
1169 if (!$::form->{id} && $::form->{$cv_id_method}) {
1170 $order->$cv_id_method($::form->{$cv_id_method});
1171 setup_order_from_cv($order);
1174 my $form_orderitems = delete $::form->{order}->{orderitems};
1176 $order->assign_attributes(%{$::form->{order}});
1178 $self->setup_custom_shipto_from_form($order, $::form);
1180 # remove deleted items
1181 $self->item_ids_to_delete([]);
1182 foreach my $idx (reverse 0..$#{$order->orderitems}) {
1183 my $item = $order->orderitems->[$idx];
1184 if (none { $item->id == $_->{id} } @{$form_orderitems}) {
1185 splice @{$order->orderitems}, $idx, 1;
1186 push @{$self->item_ids_to_delete}, $item->id;
1192 foreach my $form_attr (@{$form_orderitems}) {
1193 my $item = make_item($order, $form_attr);
1194 $item->position($pos);
1198 $order->add_items(grep {!$_->id} @items);
1203 # create or update items from form
1205 # Make item objects from form values. For items already existing read from db.
1206 # Create a new item else. And assign attributes.
1208 my ($record, $attr) = @_;
1211 $item = first { $_->id == $attr->{id} } @{$record->items} if $attr->{id};
1213 my $is_new = !$item;
1215 # add_custom_variables adds cvars to an orderitem with no cvars for saving, but
1216 # they cannot be retrieved via custom_variables until the order/orderitem is
1217 # saved. Adding empty custom_variables to new orderitem here solves this problem.
1218 $item ||= SL::DB::DeliveryOrderItem->new(custom_variables => []);
1220 $item->assign_attributes(%$attr);
1223 my $texts = get_part_texts($item->part, $record->language_id);
1224 $item->longdescription($texts->{longdescription}) if !defined $attr->{longdescription};
1225 $item->project_id($record->globalproject_id) if !defined $attr->{project_id};
1226 $item->lastcost($record->is_sales ? $item->part->lastcost : 0) if !defined $attr->{lastcost_as_number};
1234 # This is used to add one item
1236 my ($record, $attr) = @_;
1238 my $item = SL::DB::DeliveryOrderItem->new;
1240 # Remove attributes where the user left or set the inputs empty.
1241 # So these attributes will be undefined and we can distinguish them
1242 # from zero later on.
1243 for (qw(qty_as_number sellprice_as_number discount_as_percent)) {
1244 delete $attr->{$_} if $attr->{$_} eq '';
1247 $item->assign_attributes(%$attr);
1249 my $part = SL::DB::Part->new(id => $attr->{parts_id})->load;
1250 my $price_source = SL::PriceSource->new(record_item => $item, record => $record);
1252 $item->unit($part->unit) if !$item->unit;
1255 if ( $part->is_assortment ) {
1256 # add assortment items with price 0, as the components carry the price
1257 $price_src = $price_source->price_from_source("");
1258 $price_src->price(0);
1259 } elsif (defined $item->sellprice) {
1260 $price_src = $price_source->price_from_source("");
1261 $price_src->price($item->sellprice);
1263 $price_src = $price_source->best_price
1264 ? $price_source->best_price
1265 : $price_source->price_from_source("");
1266 $price_src->price(0) if !$price_source->best_price;
1270 if (defined $item->discount) {
1271 $discount_src = $price_source->discount_from_source("");
1272 $discount_src->discount($item->discount);
1274 $discount_src = $price_source->best_discount
1275 ? $price_source->best_discount
1276 : $price_source->discount_from_source("");
1277 $discount_src->discount(0) if !$price_source->best_discount;
1281 $new_attr{part} = $part;
1282 $new_attr{description} = $part->description if ! $item->description;
1283 $new_attr{qty} = 1.0 if ! $item->qty;
1284 $new_attr{price_factor_id} = $part->price_factor_id if ! $item->price_factor_id;
1285 $new_attr{sellprice} = $price_src->price;
1286 $new_attr{discount} = $discount_src->discount;
1287 $new_attr{active_price_source} = $price_src;
1288 $new_attr{active_discount_source} = $discount_src;
1289 $new_attr{longdescription} = $part->notes if ! defined $attr->{longdescription};
1290 $new_attr{project_id} = $record->globalproject_id;
1291 $new_attr{lastcost} = $record->is_sales ? $part->lastcost : 0;
1293 # add_custom_variables adds cvars to an orderitem with no cvars for saving, but
1294 # they cannot be retrieved via custom_variables until the order/orderitem is
1295 # saved. Adding empty custom_variables to new orderitem here solves this problem.
1296 $new_attr{custom_variables} = [];
1298 my $texts = get_part_texts($part, $record->language_id, description => $new_attr{description}, longdescription => $new_attr{longdescription});
1300 $item->assign_attributes(%new_attr, %{ $texts });
1305 sub setup_order_from_cv {
1308 $order->$_($order->customervendor->$_) for (qw(taxzone_id payment_id delivery_term_id currency_id));
1310 $order->intnotes($order->customervendor->notes);
1312 if ($order->is_sales) {
1313 $order->salesman_id($order->customer->salesman_id || SL::DB::Manager::Employee->current->id);
1314 $order->taxincluded(defined($order->customer->taxincluded_checked)
1315 ? $order->customer->taxincluded_checked
1316 : $::myconfig{taxincluded_checked});
1321 # setup custom shipto from form
1323 # The dialog returns form variables starting with 'shipto' and cvars starting
1324 # with 'shiptocvar_'.
1325 # Mark it to be deleted if a shipto from master data is selected
1326 # (i.e. order has a shipto).
1327 # Else, update or create a new custom shipto. If the fields are empty, it
1328 # will not be saved on save.
1329 sub setup_custom_shipto_from_form {
1330 my ($self, $order, $form) = @_;
1332 if ($order->shipto) {
1333 $self->is_custom_shipto_to_delete(1);
1335 my $custom_shipto = $order->custom_shipto || $order->custom_shipto(SL::DB::Shipto->new(module => 'OE', custom_variables => []));
1337 my $shipto_cvars = {map { my ($key) = m{^shiptocvar_(.+)}; $key => delete $form->{$_}} grep { m{^shiptocvar_} } keys %$form};
1338 my $shipto_attrs = {map { $_ => delete $form->{$_}} grep { m{^shipto} } keys %$form};
1340 $custom_shipto->assign_attributes(%$shipto_attrs);
1341 $custom_shipto->cvar_by_name($_)->value($shipto_cvars->{$_}) for keys %$shipto_cvars;
1345 # get data for saving, printing, ..., that is not changed in the form
1347 # Only cvars for now.
1348 sub get_unalterable_data {
1351 foreach my $item (@{ $self->order->items }) {
1352 # autovivify all cvars that are not in the form (cvars_by_config can do it).
1353 # workaround to pre-parse number-cvars (parse_custom_variable_values does not parse number values).
1354 foreach my $var (@{ $item->cvars_by_config }) {
1355 $var->unparsed_value($::form->parse_amount(\%::myconfig, $var->{__unparsed_value})) if ($var->config->type eq 'number' && exists($var->{__unparsed_value}));
1357 $item->parse_custom_variable_values;
1363 # And remove related files in the spool directory
1368 my $db = $self->order->db;
1370 $db->with_transaction(
1372 my @spoolfiles = grep { $_ } map { $_->spoolfile } @{ SL::DB::Manager::Status->get_all(where => [ trans_id => $self->order->id ]) };
1373 $self->order->delete;
1374 my $spool = $::lx_office_conf{paths}->{spool};
1375 unlink map { "$spool/$_" } @spoolfiles if $spool;
1377 $self->save_history('DELETED');
1380 }) || push(@{$errors}, $db->error);
1387 # And delete items that are deleted in the form.
1392 my $db = $self->order->db;
1394 $db->with_transaction(sub {
1395 # delete custom shipto if it is to be deleted or if it is empty
1396 if ($self->order->custom_shipto && ($self->is_custom_shipto_to_delete || $self->order->custom_shipto->is_empty)) {
1397 $self->order->custom_shipto->delete if $self->order->custom_shipto->shipto_id;
1398 $self->order->custom_shipto(undef);
1401 SL::DB::DeliveryOrderItem->new(id => $_)->delete for @{$self->item_ids_to_delete || []};
1402 $self->order->save(cascade => 1);
1405 if ($::form->{converted_from_oe_id}) {
1406 my @converted_from_oe_ids = split ' ', $::form->{converted_from_oe_id};
1407 foreach my $converted_from_oe_id (@converted_from_oe_ids) {
1408 my $src = SL::DB::DeliveryOrder->new(id => $converted_from_oe_id)->load;
1409 $src->update_attributes(closed => 1) if $src->type =~ /_quotation$/;
1410 $src->link_to_record($self->order);
1412 if (scalar @{ $::form->{converted_from_orderitems_ids} || [] }) {
1414 foreach (@{ $self->order->items_sorted }) {
1415 my $from_id = $::form->{converted_from_orderitems_ids}->[$idx];
1417 SL::DB::RecordLink->new(from_table => 'orderitems',
1418 from_id => $from_id,
1419 to_table => 'orderitems',
1427 $self->save_history('SAVED');
1430 }) || push(@{$errors}, $db->error);
1435 sub workflow_sales_or_request_for_quotation {
1439 my $errors = $self->save();
1441 if (scalar @{ $errors }) {
1442 $self->js->flash('error', $_) for @{ $errors };
1443 return $self->js->render();
1446 my $destination_type = $self->type_data->workflow("to_quotation_type");
1448 $self->order(SL::DB::DeliveryOrder->new_from($self->order, destination_type => $destination_type));
1449 $self->{converted_from_oe_id} = delete $::form->{id};
1451 # set item ids to new fake id, to identify them as new items
1452 foreach my $item (@{$self->order->items_sorted}) {
1453 $item->{new_fake_id} = join('_', 'new', Time::HiRes::gettimeofday(), int rand 1000000000000);
1457 $::form->{type} = $destination_type;
1458 $self->type($self->init_type);
1459 $self->cv ($self->init_cv);
1462 $self->get_unalterable_data();
1463 $self->pre_render();
1465 # trigger rendering values for second row as hidden, because they
1466 # are loaded only on demand. So we need to keep the values from the
1468 $_->{render_second_row} = 1 for @{ $self->order->items_sorted };
1471 'delivery_order/form',
1472 title => $self->get_title_for('edit'),
1473 %{$self->{template_args}}
1477 sub workflow_sales_or_purchase_order {
1481 my $errors = $self->save();
1483 if (scalar @{ $errors }) {
1484 $self->js->flash('error', $_) foreach @{ $errors };
1485 return $self->js->render();
1488 my $destination_type = $self->type_data->workflow("to_order_type");
1490 # check for direct delivery
1491 # copy shipto in custom shipto (custom shipto will be copied by new_from() in case)
1493 if ($self->type_data->workflow("to_order_copy_shipto") && $::form->{use_shipto} && $self->order->shipto) {
1494 $custom_shipto = $self->order->shipto->clone('SL::DB::DeliveryOrder');
1497 $self->order(SL::DB::DeliveryOrder->new_from($self->order, destination_type => $destination_type));
1498 $self->{converted_from_oe_id} = delete $::form->{id};
1500 # set item ids to new fake id, to identify them as new items
1501 foreach my $item (@{$self->order->items_sorted}) {
1502 $item->{new_fake_id} = join('_', 'new', Time::HiRes::gettimeofday(), int rand 1000000000000);
1505 if ($self->type_data->workflow("to_order_copy_shipto")) {
1506 if ($::form->{use_shipto}) {
1507 $self->order->custom_shipto($custom_shipto) if $custom_shipto;
1509 # remove any custom shipto if not wanted
1510 $self->order->custom_shipto(SL::DB::Shipto->new(module => 'OE', custom_variables => []));
1515 $::form->{type} = $destination_type;
1516 $self->type($self->init_type);
1517 $self->cv ($self->init_cv);
1520 $self->get_unalterable_data();
1521 $self->pre_render();
1523 # trigger rendering values for second row as hidden, because they
1524 # are loaded only on demand. So we need to keep the values from the
1526 $_->{render_second_row} = 1 for @{ $self->order->items_sorted };
1529 'delivery_order/form',
1530 title => $self->get_title_for('edit'),
1531 %{$self->{template_args}}
1539 $self->{all_taxzones} = SL::DB::Manager::TaxZone->get_all_sorted();
1540 $self->{all_currencies} = SL::DB::Manager::Currency->get_all_sorted();
1541 $self->{all_departments} = SL::DB::Manager::Department->get_all_sorted();
1542 $self->{all_languages} = SL::DB::Manager::Language->get_all_sorted();
1543 $self->{all_employees} = SL::DB::Manager::Employee->get_all(where => [ or => [ id => $self->order->employee_id,
1546 $self->{all_salesmen} = SL::DB::Manager::Employee->get_all(where => [ or => [ id => $self->order->salesman_id,
1549 $self->{all_payment_terms} = SL::DB::Manager::PaymentTerm->get_all_sorted(where => [ or => [ id => $self->order->payment_id,
1551 $self->{all_delivery_terms} = SL::DB::Manager::DeliveryTerm->get_all_sorted();
1552 $self->{current_employee_id} = SL::DB::Manager::Employee->current->id;
1553 $self->{order_probabilities} = [ map { { title => ($_ * 10) . '%', id => $_ * 10 } } (0..10) ];
1554 $self->{positions_scrollbar_height} = SL::Helper::UserPreferences::PositionsScrollbar->new()->get_height();
1556 my $print_form = Form->new('');
1557 $print_form->{type} = $self->type;
1558 $print_form->{printers} = SL::DB::Manager::Printer->get_all_sorted;
1559 $self->{print_options} = SL::Helper::PrintOptions->get_print_options(
1560 form => $print_form,
1561 options => {dialog_name_prefix => 'print_options.',
1565 no_opendocument => 0,
1569 foreach my $item (@{$self->order->orderitems}) {
1570 my $price_source = SL::PriceSource->new(record_item => $item, record => $self->order);
1571 $item->active_price_source( $price_source->price_from_source( $item->active_price_source ));
1572 $item->active_discount_source($price_source->discount_from_source($item->active_discount_source));
1575 if ($self->order->number && $::instance_conf->get_webdav) {
1576 my $webdav = SL::Webdav->new(
1577 type => $self->type,
1578 number => $self->order->number,
1580 my @all_objects = $webdav->get_all_objects;
1581 @{ $self->{template_args}->{WEBDAV} } = map { { name => $_->filename,
1583 link => File::Spec->catfile($_->full_filedescriptor),
1587 $self->get_item_cvpartnumber($_) for @{$self->order->items_sorted};
1589 $::request->{layout}->use_javascript("${_}.js") for qw(kivi.SalesPurchase kivi.Order kivi.File ckeditor/ckeditor ckeditor/adapters/jquery
1590 calculate_qty kivi.Validator follow_up show_history);
1591 $self->setup_edit_action_bar;
1594 sub setup_edit_action_bar {
1595 my ($self, %params) = @_;
1597 my $deletion_allowed = $self->type_data->show_menu("delete");
1599 for my $bar ($::request->layout->get('actionbar')) {
1604 call => [ 'kivi.Order.save', 'save', $::instance_conf->get_order_warn_duplicate_parts,
1605 $::instance_conf->get_order_warn_no_deliverydate,
1610 call => [ 'kivi.Order.save', 'save_as_new', $::instance_conf->get_order_warn_duplicate_parts ],
1611 disabled => !$self->order->id ? t8('This object has not been saved yet.') : undef,
1613 ], # end of combobox "Save"
1620 t8('Save and Quotation'),
1621 submit => [ '#order_form', { action => "DeliveryOrder/sales_quotation" } ],
1622 only_if => $self->type_data->show_menu("save_and_quotation"),
1626 submit => [ '#order_form', { action => "DeliveryOrder/request_for_quotation" } ],
1627 only_if => $self->type_data->show_menu("save_and_rfq"),
1630 t8('Save and Sales Order'),
1631 submit => [ '#order_form', { action => "DeliveryOrder/sales_order" } ],
1632 only_if => $self->type_data->show_menu("save_and_sales_order"),
1635 t8('Save and Purchase Order'),
1636 call => [ 'kivi.Order.purchase_order_check_for_direct_delivery' ],
1637 only_if => $self->type_data->show_menu("save_and_purchase_order"),
1640 t8('Save and Delivery Order'),
1641 call => [ 'kivi.Order.save', 'save_and_delivery_order', $::instance_conf->get_order_warn_duplicate_parts,
1642 $::instance_conf->get_order_warn_no_deliverydate,
1644 only_if => $self->type_data->show_menu("save_and_delivery_order"),
1647 t8('Save and Invoice'),
1648 call => [ 'kivi.Order.save', 'save_and_invoice', $::instance_conf->get_order_warn_duplicate_parts ],
1651 t8('Save and AP Transaction'),
1652 call => [ 'kivi.Order.save', 'save_and_ap_transaction', $::instance_conf->get_order_warn_duplicate_parts ],
1653 only_if => $self->type_data->show_menu("save_and_ap_transaction"),
1656 ], # end of combobox "Workflow"
1663 t8('Save and preview PDF'),
1664 call => [ 'kivi.Order.save', 'preview_pdf', $::instance_conf->get_order_warn_duplicate_parts,
1665 $::instance_conf->get_order_warn_no_deliverydate,
1669 t8('Save and print'),
1670 call => [ 'kivi.Order.show_print_options', $::instance_conf->get_order_warn_duplicate_parts,
1671 $::instance_conf->get_order_warn_no_deliverydate,
1675 t8('Save and E-mail'),
1676 id => 'save_and_email_action',
1677 call => [ 'kivi.Order.save', 'save_and_show_email_dialog', $::instance_conf->get_order_warn_duplicate_parts,
1678 $::instance_conf->get_order_warn_no_deliverydate,
1680 disabled => !$self->order->id ? t8('This object has not been saved yet.') : undef,
1683 t8('Download attachments of all parts'),
1684 call => [ 'kivi.File.downloadOrderitemsFiles', $::form->{type}, $::form->{id} ],
1685 disabled => !$self->order->id ? t8('This object has not been saved yet.') : undef,
1686 only_if => $::instance_conf->get_doc_storage,
1688 ], # end of combobox "Export"
1692 call => [ 'kivi.Order.delete_order' ],
1693 confirm => $::locale->text('Do you really want to delete this object?'),
1694 disabled => !$self->order->id ? t8('This object has not been saved yet.') : undef,
1695 only_if => $self->type_data->show_menu("delete"),
1704 call => [ 'kivi.Order.follow_up_window' ],
1705 disabled => !$self->order->id ? t8('This object has not been saved yet.') : undef,
1706 only_if => $::auth->assert('productivity', 1),
1710 call => [ 'set_history_window', $self->order->id, 'id' ],
1711 disabled => !$self->order->id ? t8('This record has not been saved yet.') : undef,
1713 ], # end of combobox "more"
1719 my ($order, $pdf_ref, $params) = @_;
1723 my $print_form = Form->new('');
1724 $print_form->{type} = $order->type;
1725 $print_form->{formname} = $params->{formname} || $order->type;
1726 $print_form->{format} = $params->{format} || 'pdf';
1727 $print_form->{media} = $params->{media} || 'file';
1728 $print_form->{groupitems} = $params->{groupitems};
1729 $print_form->{printer_id} = $params->{printer_id};
1730 $print_form->{media} = 'file' if $print_form->{media} eq 'screen';
1732 $order->language($params->{language});
1733 $order->flatten_to_form($print_form, format_amounts => 1);
1737 if ($print_form->{format} =~ /(opendocument|oasis)/i) {
1738 $template_ext = 'odt';
1739 $template_type = 'OpenDocument';
1742 # search for the template
1743 my ($template_file, @template_files) = SL::Helper::CreatePDF->find_template(
1744 name => $print_form->{formname},
1745 extension => $template_ext,
1746 email => $print_form->{media} eq 'email',
1747 language => $params->{language},
1748 printer_id => $print_form->{printer_id},
1751 if (!defined $template_file) {
1752 push @errors, $::locale->text('Cannot find matching template for this print request. Please contact your template maintainer. I tried these: #1.', join ', ', map { "'$_'"} @template_files);
1755 return @errors if scalar @errors;
1757 $print_form->throw_on_error(sub {
1759 $print_form->prepare_for_printing;
1761 $$pdf_ref = SL::Helper::CreatePDF->create_pdf(
1762 format => $print_form->{format},
1763 template_type => $template_type,
1764 template => $template_file,
1765 variables => $print_form,
1766 variable_content_types => {
1767 longdescription => 'html',
1768 partnotes => 'html',
1773 } || push @errors, ref($EVAL_ERROR) eq 'SL::X::FormError' ? $EVAL_ERROR->error : $EVAL_ERROR;
1779 sub get_files_for_email_dialog {
1782 my %files = map { ($_ => []) } qw(versions files vc_files part_files);
1784 return %files if !$::instance_conf->get_doc_storage;
1786 if ($self->order->id) {
1787 $files{versions} = [ SL::File->get_all_versions(object_id => $self->order->id, object_type => $self->order->type, file_type => 'document') ];
1788 $files{files} = [ SL::File->get_all( object_id => $self->order->id, object_type => $self->order->type, file_type => 'attachment') ];
1789 $files{vc_files} = [ SL::File->get_all( object_id => $self->order->{$self->cv}->id, object_type => $self->cv, file_type => 'attachment') ];
1790 $files{project_files} = [ SL::File->get_all( object_id => $self->order->globalproject_id, object_type => 'project', file_type => 'attachment') ];
1794 uniq_by { $_->{id} }
1796 +{ id => $_->part->id,
1797 partnumber => $_->part->partnumber }
1798 } @{$self->order->items_sorted};
1800 foreach my $part (@parts) {
1801 my @pfiles = SL::File->get_all(object_id => $part->{id}, object_type => 'part');
1802 push @{ $files{part_files} }, map { +{ %{ $_ }, partnumber => $part->{partnumber} } } @pfiles;
1805 foreach my $key (keys %files) {
1806 $files{$key} = [ sort_by { lc $_->{db_file}->{file_name} } @{ $files{$key} } ];
1813 my ($self, $action) = @_;
1815 return '' if none { lc($action)} qw(add edit);
1816 return $self->type_data->text($action);
1819 sub get_item_cvpartnumber {
1820 my ($self, $item) = @_;
1822 return if !$self->search_cvpartnumber;
1823 return if !$self->order->customervendor;
1825 if ($self->cv eq 'vendor') {
1826 my @mms = grep { $_->make eq $self->order->customervendor->id } @{$item->part->makemodels};
1827 $item->{cvpartnumber} = $mms[0]->model if scalar @mms;
1828 } elsif ($self->cv eq 'customer') {
1829 my @cps = grep { $_->customer_id eq $self->order->customervendor->id } @{$item->part->customerprices};
1830 $item->{cvpartnumber} = $cps[0]->customer_partnumber if scalar @cps;
1834 sub get_part_texts {
1835 my ($part_or_id, $language_or_id, %defaults) = @_;
1837 my $part = ref($part_or_id) ? $part_or_id : SL::DB::Part->load_cached($part_or_id);
1838 my $language_id = ref($language_or_id) ? $language_or_id->id : $language_or_id;
1840 description => $defaults{description} // $part->description,
1841 longdescription => $defaults{longdescription} // $part->notes,
1844 return $texts unless $language_id;
1846 my $translation = SL::DB::Manager::Translation->get_first(
1848 parts_id => $part->id,
1849 language_id => $language_id,
1852 $texts->{description} = $translation->translation if $translation && $translation->translation;
1853 $texts->{longdescription} = $translation->longdescription if $translation && $translation->longdescription;
1859 return $_[0]->type_data->nr_key;
1862 sub save_and_redirect_to {
1863 my ($self, %params) = @_;
1865 my $errors = $self->save();
1867 if (scalar @{ $errors }) {
1868 $self->js->flash('error', $_) foreach @{ $errors };
1869 return $self->js->render();
1872 flash_later('info', $self->type_data->text("saved"));
1874 $self->redirect_to(%params, id => $self->order->id);
1878 my ($self, $addition) = @_;
1880 my $number_type = $self->nr_key;
1881 my $snumbers = $number_type . '_' . $self->order->$number_type;
1883 SL::DB::History->new(
1884 trans_id => $self->order->id,
1885 employee_id => SL::DB::Manager::Employee->current->id,
1886 what_done => $self->order->type,
1887 snumbers => $snumbers,
1888 addition => $addition,
1892 sub store_pdf_to_webdav_and_filemanagement {
1893 my($order, $content, $filename) = @_;
1897 # copy file to webdav folder
1898 if ($order->number && $::instance_conf->get_webdav_documents) {
1899 my $webdav = SL::Webdav->new(
1900 type => $order->type,
1901 number => $order->number,
1903 my $webdav_file = SL::Webdav::File->new(
1905 filename => $filename,
1908 $webdav_file->store(data => \$content);
1911 push @errors, t8('Storing PDF to webdav folder failed: #1', $@);
1914 if ($order->id && $::instance_conf->get_doc_storage) {
1916 SL::File->save(object_id => $order->id,
1917 object_type => $order->type,
1918 mime_type => 'application/pdf',
1919 source => 'created',
1920 file_type => 'document',
1921 file_name => $filename,
1922 file_contents => $content);
1925 push @errors, t8('Storing PDF in storage backend failed: #1', $@);
1932 sub init_type_data {
1933 SL::Controller::DeliveryOrder::TypeData->new($_[0]);
1936 sub init_valid_types {
1937 $_[0]->type_data->valid_types;
1948 SL::Controller::Order - controller for orders
1952 This is a new form to enter orders, completely rewritten with the use
1953 of controller and java script techniques.
1955 The aim is to provide the user a better experience and a faster workflow. Also
1956 the code should be more readable, more reliable and better to maintain.
1964 One input row, so that input happens every time at the same place.
1968 Use of pickers where possible.
1972 Possibility to enter more than one item at once.
1976 Item list in a scrollable area, so that the workflow buttons stay at
1981 Reordering item rows with drag and drop is possible. Sorting item rows is
1982 possible (by partnumber, description, qty, sellprice and discount for now).
1986 No C<update> is necessary. All entries and calculations are managed
1987 with ajax-calls and the page only reloads on C<save>.
1991 User can see changes immediately, because of the use of java script
2002 =item * C<SL/Controller/Order.pm>
2006 =item * C<template/webpages/delivery_order/form.html>
2010 =item * C<template/webpages/delivery_order/tabs/basic_data.html>
2012 Main tab for basic_data.
2014 This is the only tab here for now. "linked records" and "webdav" tabs are
2015 reused from generic code.
2019 =item * C<template/webpages/delivery_order/tabs/_business_info_row.html>
2021 For displaying information on business type
2023 =item * C<template/webpages/delivery_order/tabs/_item_input.html>
2025 The input line for items
2027 =item * C<template/webpages/delivery_order/tabs/_row.html>
2029 One row for already entered items
2031 =item * C<template/webpages/delivery_order/tabs/_tax_row.html>
2033 Displaying tax information
2037 =item * C<js/kivi.Order.js>
2039 java script functions
2049 =item * price sources: little symbols showing better price / better discount
2051 =item * select units in input row?
2053 =item * check for direct delivery (workflow sales order -> purchase order)
2055 =item * access rights
2057 =item * display weights
2061 =item * optional client/user behaviour
2063 (transactions has to be set - department has to be set -
2064 force project if enabled in client config - transport cost reminder)
2068 =head1 KNOWN BUGS AND CAVEATS
2074 Customer discount is not displayed as a valid discount in price source popup
2075 (this might be a bug in price sources)
2077 (I cannot reproduce this (Bernd))
2081 No indication that <shift>-up/down expands/collapses second row.
2085 Inline creation of parts is not currently supported
2089 Table header is not sticky in the scrolling area.
2093 Sorting does not include C<position>, neither does reordering.
2095 This behavior was implemented intentionally. But we can discuss, which behavior
2096 should be implemented.
2100 =head1 To discuss / Nice to have
2106 How to expand/collapse second row. Now it can be done clicking the icon or
2111 Possibility to select PriceSources in input row?
2115 This controller uses a (changed) copy of the template for the PriceSource
2116 dialog. Maybe there could be used one code source.
2120 Rounding-differences between this controller (PriceTaxCalculator) and the old
2121 form. This is not only a problem here, but also in all parts using the PTC.
2122 There exists a ticket and a patch. This patch should be testet.
2126 An indicator, if the actual inputs are saved (like in an
2127 editor or on text processing application).
2131 A warning when leaving the page without saveing unchanged inputs.
2138 Bernd Bleßmann E<lt>bernd@kivitendo-premium.deE<gt>