X-Git-Url: http://wagnertech.de/git?a=blobdiff_plain;f=SL%2FDB%2FOrderItem.pm;h=d46fdcc369191340fe0712a71b7a15efb06c86ab;hb=1b9a64fa292f375c82b4af788d0606354bc4e8ff;hp=81e6cd39e5b58c019bf158a9571771484a6f0cb5;hpb=3b7bda404f28890a4c3796d76619fc5b0c4a26bb;p=kivitendo-erp.git diff --git a/SL/DB/OrderItem.pm b/SL/DB/OrderItem.pm index 81e6cd39e..d46fdcc36 100644 --- a/SL/DB/OrderItem.pm +++ b/SL/DB/OrderItem.pm @@ -7,6 +7,9 @@ use List::Util qw(sum); use SL::DB::MetaSetup::OrderItem; use SL::DB::Manager::OrderItem; use SL::DB::DeliveryOrderItemsStock; +use SL::DB::Helper::ActsAsList; +use SL::DB::Helper::LinkedRecords; +use SL::DB::Helper::RecordItem; use SL::DB::Helper::CustomVariables ( sub_module => 'orderitems', cvars_alias => 1, @@ -20,6 +23,8 @@ use SL::DB::Helper::CustomVariables ( __PACKAGE__->meta->initialize; +__PACKAGE__->configure_acts_as_list(group_by => [qw(trans_id)]); + sub is_price_update_available { my $self = shift; return $self->origprice > $self->part->sellprice; @@ -35,55 +40,149 @@ sub shipped_qty { return sum(map { AM->convert_unit($_->unit => $self->unit) * $_->qty } @doi); } -sub delivered_qty { +sub linked_delivery_order_items { my ($self) = @_; - return $self->_delivered_qty; + return $self->linked_records(direction => 'to', to => 'SL::DB::DeliveryOrderItem'); } -sub _delivered_qty { +sub delivered_qty { + # checks for delivery_order_stock_id entries, which have been converted to inventory entries + # uses several rose relationships + # doesn't differentiate between sales and orders + + my ($self) = @_; + my $delivered_qty = 0; + foreach my $doi ( @{$self->linked_delivery_order_items} ) { + next unless scalar @{$doi->delivery_order_stock_entries}; + $delivered_qty += sum map { $_->inventory ? $_->qty : 0 } @{$doi->delivery_order_stock_entries}; + }; + return $delivered_qty; +}; + +sub delivered_qty_sql { + # checks for delivery_order_stock_id entries, which have been converted to inventory entries my ($self) = @_; - return $self->{delivered_qty} if $self->{delivered_qty}; +my $query = <db->dbh, $query, $self->id); + + return $delivered_qty; +}; + +sub delivered_qty_sql_multi { + # checks for delivery_order_stock_id entries, which have been converted to inventory entries + my ($self) = @_; - my $d_orders = $self->order->linked_records(direction => 'to', to => 'SL::DB::DeliveryOrder'); +my $query = <db->dbh, $query, $self->id); + + return $delivered_qty; +}; + +sub record { goto &order } - my @d_orders_delivered = grep { $_->delivered } @$d_orders; +1; - my @doi_delivered = grep { $_->parts_id == $self->parts_id } map { $_->orderitems } @d_orders_delivered; +__END__ - require SL::AM; - $self->{delivered_qty} = sum(map { AM->convert_unit($_->unit => $self->unit) * $_->qty } @doi_delivered); +=pod - return $self->{delivered_qty}; -} +=head1 NAME -sub value_of_goods { - my ($self) = @_; +SL::DB::OrderItems: Rose model for orderitems - my $price_factor = $self->price_factor || 1; +=head1 FUNCTIONS - $self->_delivered_qty; - return ($self->_delivered_qty * $self->sellprice * (1 - $self->discount ) / $price_factor); -} +=over 4 -sub stocked_qty { - my ($self) = @_; +=item C - my $d_orders = $self->order->linked_records(direction => 'to', to => 'SL::DB::DeliveryOrder'); - my @doi = grep { $_->parts_id == $self->parts_id } map { $_->orderitems } @$d_orders; +=item C - return 0 if !@doi; +returns the number of orderitems which are already linked to Delivery Orders. +The linked key is parts_id and not orderitems (id) -> delivery_order_items (id). +Therefore this function is not safe for identical parts_id. +Sample call: +C<$::form-Eformat_amount(\%::myconfig, $_[0]-Eshipped_qty);> - my $doi_stocks = SL::DB::Manager::DeliveryOrderItemsStock->get_all(query => [delivery_order_item_id => [ map {$_->id} @doi ]]); +=item C - require SL::AM; - return sum(map { AM->convert_unit($_->unit => $self->unit) * $_->qty } @{ $doi_stocks }); -} +Returns the amount of this orderitem that has been delivered, meaning it +appears in a delivery order AND has been transferred. The delivery order items +are found by direct record_links from orderitems to delivery order items. +Delivery order items that were added manually and not via the record workflow +will therefore not be calculated correctly. + +Orders that were created before the individual items were linked (this feature +was added in kivitendo 3.2.0) will therefore return incorrect results. + +=item C + +Does the same as delivered_qty, but via sql. + + + +=item C + +Returns the amount of the orderitem that has actually been shipped, not just where delivery_order_items exist (how delivered_qty works). + +Doesn't deal with different units yet. + +=back + +=head1 TODO + +Older versions of OrderItem.pm had more functions which where used for calculating the +qty for the different states of the Delivery Order. +For example to get the qty in already marked as delivered Delivery Orders: + +C + +return $self-E_delivered_qty; + + sub _delivered_qty { + (..) + my @d_orders_delivered = grep { $_-Edelivered } @$d_orders; + my @doi_delivered = grep { $_-Eparts_id == $self-Eparts_id } map { $_-Eorderitems } @d_orders_delivered; + } + +In general the function C and all (project) related functions should be marked deprecate, + because of the better linked item to item data in the record_links table. + +=head1 AUTHORS + +G. Richardson Egrichardson@kivitendo-premium.deE + +=cut -sub taxincluded { - my ($self) = @_; - return SL::DB::Manager::Order->find_by(id => $self->trans_id)->taxincluded ? $::locale->text('WARN: Tax included value!') : ''; -} -1;