X-Git-Url: http://wagnertech.de/git?a=blobdiff_plain;f=SL%2FDB%2FRequirementSpecItem.pm;h=0e35ff9056534fd6b8ff8990b531c1195191c62f;hb=3782a90c336bc6c506f572e607c8526cb5e79ea3;hp=072b59b09abdb2c15c143df2a38f44e9759abfe2;hpb=1f592a0f4f88893b5c2cb29b2d10e2d07b444ac0;p=kivitendo-erp.git diff --git a/SL/DB/RequirementSpecItem.pm b/SL/DB/RequirementSpecItem.pm index 072b59b09..0e35ff905 100644 --- a/SL/DB/RequirementSpecItem.pm +++ b/SL/DB/RequirementSpecItem.pm @@ -2,54 +2,184 @@ package SL::DB::RequirementSpecItem; use strict; +use Carp; +use List::MoreUtils qw(any); +use Rose::DB::Object::Helpers; +use Rose::DB::Object::Util; + +use SL::Common (); use SL::DB::MetaSetup::RequirementSpecItem; use SL::DB::Manager::RequirementSpecItem; use SL::DB::Helper::ActsAsList; +use SL::DB::Helper::AttrDuration; +use SL::DB::Helper::AttrHTML; +use SL::DB::Default; +use SL::Locale::String; +use SL::PrefixedNumber; __PACKAGE__->meta->add_relationship( - children => { - type => 'one to many', - class => 'SL::DB::RequirementSpecItem', - column_map => { id => 'parent_id' }, + children => { + type => 'one to many', + class => 'SL::DB::RequirementSpecItem', + column_map => { id => 'parent_id' }, + }, + dependencies => { + map_class => 'SL::DB::RequirementSpecDependency', + map_from => 'depending_item', + map_to => 'depended_item', + type => 'many to many', + }, + dependents => { + map_class => 'SL::DB::RequirementSpecDependency', + map_from => 'depended_item', + map_to => 'depending_item', + type => 'many to many', }, ); __PACKAGE__->meta->initialize; __PACKAGE__->configure_acts_as_list(group_by => [qw(requirement_spec_id parent_id)]); +__PACKAGE__->attr_duration(qw(time_estimation)); +__PACKAGE__->attr_html('description'); -__PACKAGE__->before_delete(\&_before_delete_delete_children); +__PACKAGE__->before_save(\&_before_save_create_fb_number); +__PACKAGE__->before_save(\&_before_save_invalidate_requirement_spec_version); +__PACKAGE__->before_delete(\&_before_delete_invalidate_requirement_spec_version); -sub _before_delete_delete_children { +sub _before_save_create_fb_number { my ($self) = @_; - foreach my $child (@{ SL::DB::Manager::RequirementSpecItem->get_all(where => [ parent_id => $self->id ]) }) { - my $result = $child->delete; - return $result if !$result; + return 1 if $self->fb_number; + return 0 if !$self->requirement_spec_id; + + my $method = 'previous_' . ($self->parent_id ? 'fb' : 'section') . '_number'; + my $next_number = $self->requirement_spec->$method + 1; + + $self->requirement_spec->update_attributes($method => $next_number) || return 0; + + $method = ($self->parent_id ? 'function_block' : 'section') . '_number_format'; + my $format = $self->requirement_spec->type->$method; + + $self->fb_number(SL::PrefixedNumber->new(number => $format || 0)->set_to($next_number)); + + return 1; +} + +sub _before_save_invalidate_requirement_spec_version { + my ($self, %params) = @_; + + return 1 if !$self->requirement_spec_id || $self->requirement_spec->working_copy_id; + + my %changed_columns = map { $_ => 1 } (Rose::DB::Object::Helpers::dirty_columns($self)); + my $has_changed = !Rose::DB::Object::Util::is_in_db($self); + $has_changed ||= any { $changed_columns{$_} } qw(requirement_spec_id parent_id position fb_number title description); + + if (!$has_changed && $self->id) { + my $old_item = SL::DB::RequirementSpecItem->new(id => $self->id)->load; + $has_changed = join(':', sort map { $_->id } @{ $self->dependencies }) ne join(':', sort map { $_->id } @{ $old_item->dependencies }); } - 1; + $self->requirement_spec->invalidate_version if $has_changed; + + return 1; } -sub sorted_children { - my ($self) = @_; +sub _before_delete_invalidate_requirement_spec_version { + my ($self, %params) = @_; - return [ sort { $a->position <=> $b->position } @{ $self->children } ]; + $self->requirement_spec->invalidate_version if $self->requirement_spec_id; + + return 1; } -sub get_section { +sub validate { my ($self) = @_; + my @errors; + push @errors, t8('The title is missing.') if !$self->parent_id && !$self->title; + + return @errors; +} + +sub children_sorted { + my ($self, @args) = @_; + + croak "Not a writer" if @args; + + return [ sort { $a->position <=> $b->position } $self->children ]; +} + +sub section { + my ($self, @args) = @_; + + croak "Not a writer" if @args; $self = $self->parent while $self->parent_id; return $self; } -sub get_type { +sub child_type { + my ($self, @args) = @_; + + croak "Not a writer" if @args; + + return $self->item_type eq 'section' ? 'function-block' : 'sub-function-block'; +} + +sub content_excerpt { my ($self) = @_; - return 'section' if !$self->parent_id; - return $self->parent->parent_id ? 'sub-function-block' : 'function-block'; + return Common::truncate($self->description_as_stripped_html // '', at => 200); } + 1; +__END__ + +=pod + +=encoding utf8 + +=head1 NAME + +SL::DB::RequirementSpecItem - Items for requirement specs + +=head1 OVERVIEW + +Please see L for the architectual overview. + +=head1 FUNCTIONS + +=over 4 + +=item C + +Returns the C for children of C<$self>. + +=item C + +Returns an array reference of direct children (not of grandchildren) +for C<$self> ordered by their positional column in ascending order. + +=item C
+ +Returns the section this item belongs to. It can be C<$self> if +C<$self> is already a section, its parent or grandparent. + +=item C + +Validates before saving and returns an array of human-readable error +messages in case of an error. + +=back + +=head1 BUGS + +Nothing here yet. + +=head1 AUTHOR + +Moritz Bunkus Em.bunkus@linet-services.deE + +=cut