X-Git-Url: http://wagnertech.de/git?a=blobdiff_plain;f=SL%2FDev%2FPart.pm;h=967a1f75b40c0a0cb1e1a05e24cdf41b3fa64df2;hb=0bd2b1386aa46b03e553610808d244572d7ac03f;hp=27261e91f55e690e3376111e49fd8f6d1ac3d4d9;hpb=17ef0d2b1398adeae988947c6065d3d6ba279f15;p=kivitendo-erp.git diff --git a/SL/Dev/Part.pm b/SL/Dev/Part.pm index 27261e91f..967a1f75b 100644 --- a/SL/Dev/Part.pm +++ b/SL/Dev/Part.pm @@ -2,13 +2,14 @@ package SL::Dev::Part; use strict; use base qw(Exporter); -our @EXPORT = qw(create_part create_service); +our @EXPORT_OK = qw(new_part new_service new_assembly new_assortment); +our %EXPORT_TAGS = (ALL => \@EXPORT_OK); use SL::DB::Part; use SL::DB::Unit; use SL::DB::Buchungsgruppe; -sub create_part { +sub new_part { my (%params) = @_; my $part = SL::DB::Part->new_part( @@ -22,7 +23,7 @@ sub create_part { return $part; } -sub create_service { +sub new_service { my (%params) = @_; my $part = SL::DB::Part->new_service( @@ -36,78 +37,74 @@ sub create_service { return $part; } -sub create_assembly { +sub new_assembly { my (%params) = @_; - my @parts; - my $part1 = SL::Dev::Part::create_part(partnumber => 'ap1', - description => 'Testpart', - )->save; - push(@parts, $part1); - - my $number_of_parts = delete $params{number_of_parts} || 3; - - for my $i ( 2 .. $number_of_parts ) { - my $part = $parts[0]->clone_and_reset; - $part->partnumber( $part->partnumber . " " . $i ); - $part->description( $part->description . " " . $i ); - $part->save; - push(@parts, $part); + my $assnumber = delete $params{assnumber}; + my $base_partnumber = delete $params{partnumber} || 'ap'; + + my $assembly_items = []; + + if ( $params{assembly_items} ) { + $assembly_items = delete $params{assembly_items}; + } else { + for my $i ( 1 .. delete $params{number_of_parts} || 3) { + my $part = new_part(partnumber => "$base_partnumber $i", + description => "Testpart $i", + )->save; + push( @{$assembly_items}, SL::DB::Assembly->new(parts_id => $part->id, + qty => 1, + position => $i, + )); + } } my $assembly = SL::DB::Part->new_assembly( - partnumber => 'as1', + partnumber => $assnumber, description => 'Test Assembly', sellprice => '10', lastcost => '5', + assemblies => $assembly_items, buchungsgruppen_id => _default_buchungsgruppe()->id, unit => _default_unit()->name ); - - foreach my $part ( @parts ) { - $assembly->add_assemblies( SL::DB::Assembly->new(parts_id => $part->id, qty => 1, bom => 1) ); - } $assembly->assign_attributes( %params ); return $assembly; } -sub create_assortment { +sub new_assortment { my (%params) = @_; - my @parts; - my $part1 = SL::Dev::Part::create_part(partnumber => 'sp1', - description => 'Testpart assortment', - )->save; - push(@parts, $part1); - - my $number_of_parts = delete $params{number_of_parts} || 3; - - for my $i ( 2 .. $number_of_parts ) { - my $part = $parts[0]->clone_and_reset; - $part->partnumber( $part->partnumber . " " . $i ); - $part->description( $part->description . " " . $i ); - $part->save; - push(@parts, $part); + my $assnumber = delete $params{assnumber}; + my $base_partnumber = delete $params{partnumber} || 'ap'; + + my $assortment_items = []; + + if ( $params{assortment_items} ) { + $assortment_items = delete $params{assortment_items}; + } else { + for my $i ( 1 .. delete $params{number_of_parts} || 3) { + my $part = new_part(partnumber => "$base_partnumber $i", + description => "Testpart $i", + )->save; + push( @{$assortment_items}, SL::DB::AssortmentItem->new(parts_id => $part->id, + qty => 1, + position => $i, + unit => $part->unit, + )); + } } my $assortment = SL::DB::Part->new_assortment( - partnumber => 'as1', + partnumber => $assnumber, description => 'Test Assortment', sellprice => '10', lastcost => '5', + assortment_items => $assortment_items, buchungsgruppen_id => _default_buchungsgruppe()->id, unit => _default_unit()->name ); - my $position = 0; - foreach my $part ( @parts ) { - $assortment->add_assortment_items( SL::DB::AssortmentItem->new(parts_id => $part->id, - qty => 1, - position => $position++, - charge => 1, - unit => $part->unit, - )); - } $assortment->assign_attributes( %params ); return $assortment; } @@ -130,57 +127,121 @@ __END__ SL::Dev::Part - create part objects for testing, with minimal defaults +=head1 SYNOPSIS + + use SL::Dev::Part qw(new_part new_assembly new_service new_assortment); + + # simple default objects + my $part = new_part()->save; + my $assembly = new_assembly()->save; + my $service = new_service()->save; + my $assortment = new_assortment()->save; + + # pass additional params to the generated object + # see individual functions for special parameters + my $part = new_part( + partnumber => 'Test 001', + warehouse_id => $bin->warehouse->id, + bin_id => $bin->id, + ); + =head1 FUNCTIONS -=head2 C +=head2 C Creates a new part (part_type = part). -Minimal usage, default values, without saving to database: +=head2 C - my $part = SL::Dev::Part::create_part(); +Creates a new service (part_type = service). -Create a test part with a default warehouse and bin and save it: +=head2 C - my $wh = SL::Dev::Inventory::create_warehouse_and_bins()->save; - my $part1 = SL::Dev::Part::create_part(partnumber => 'a123', - description => 'Testpart 1', - warehouse_id => $wh->id, - bin_id => $wh->bins->[0]->id, - )->save; +Create a new assembly (part_type = assembly). -=head2 C +Special params: -Creates a new service (part_type = service). +=over 2 -Minimal usage, default values, without saving to database: +=item * C - my $part = SL::Dev::Part::create_service(); +The number of automatically created assembly parts. -=head2 C +=item * C -Create a new assembly (part_type = assembly). +the partnumber of the assembly + +=item * C + +the partnumber of the first assembly part to be created + +=back By default 3 parts (p1, p2, p3) are created and saved as an assembly (as1). - my $assembly = SL::Dev::Part::create_assembly->save; +Create a new assembly with 10 parts, the assembly gets partnumber 'Ass1' and the +parts get partnumbers 'Testpart 1' to 'Testpart 10': -Create a new assembly with 10 parts: + my $assembly = SL::Dev::Part::new_assembly( + number_of_parts => 10, + partnumber => 'Testpart', + assnumber => 'Ass1' + )->save; - my $assembly = SL::Dev::Part::create_assembly(number_of_parts => 10)->save; +Create an assembly with specific parts: -=head2 C + my $assembly_item_1 = SL::DB::Assembly->new( parts_id => $part1->id, qty => 3, position => 1); + my $assembly_item_2 = SL::DB::Assembly->new( parts_id => $part2->id, qty => 3, position => 2); + my $assembly_part = new_assembly( + assnumber => 'Assembly 1', + description => 'Assembly test', + sellprice => $part1->sellprice + $part2->sellprice, + assembly_items => [ $assembly_item_1, $assembly_item_2 ], + ); + +=head2 C Create a new assortment (part_type = assortment). -By default 3 parts (p1, p2, p3) are created and saved as an assortment. +Special params: - my $assortment = SL::Dev::Part::create_assortment->save; +=over 2 -Create a new assortment with 10 parts: +=item * C - my $assortment = SL::Dev::Part::create_assortment(number_of_parts => 10)->save; +The number of automatically created assembly parts. + +=item * C + +the partnumber of the assortment + +=item * C + +the partnumber of the first assembly part to be created + +=back + +By default 3 parts (p1, p2, p3) are created and saved as an assortment. +Create a new assortment with 10 automatically created parts using the +number_of_parts param: + + my $assortment = new_assortment(number_of_parts => 10)->save; + +Create an assortment with a certain name and pass some assortment_item Objects +from newly created parts: + + my $part1 = new_part(sellprice => 7.77)->save; + my $part2 = new_part(sellprice => 6.66)->save; + my $assortment_item_1 = SL::DB::AssortmentItem->new( parts_id => $part1->id, qty => 3, unit => $part1->unit, position => 1); + my $assortment_item_2 = SL::DB::AssortmentItem->new( parts_id => $part2->id, qty => 3, unit => $part2->unit, position => 2); + my $assortment_part = SL::Dev::Part::new_assortment( + assnumber => 'Assortment 1', + description => 'assortment test', + sellprice => (3*$part1->sellprice + 3*$part2->sellprice), + lastcost => (3*$part1->lastcost + 3*$part2->lastcost), + assortment_items => [ $assortment_item_1, $assortment_item_2 ], + )->save; =head1 TODO