1 package SL::Controller::RequirementSpec;
6 use parent qw(SL::Controller::Base);
9 use SL::Controller::Helper::GetModels;
10 use SL::Controller::Helper::Filtered;
11 use SL::Controller::Helper::Paginated;
12 use SL::Controller::Helper::Sorted;
13 use SL::Controller::Helper::ParseFilter;
14 use SL::Controller::Helper::ReportGenerator;
15 use SL::Controller::Helper::RequirementSpec;
18 use SL::DB::RequirementSpecComplexity;
19 use SL::DB::RequirementSpecRisk;
20 use SL::DB::RequirementSpecStatus;
21 use SL::DB::RequirementSpecType;
22 use SL::DB::RequirementSpec;
23 use SL::Helper::Flash;
24 use SL::Locale::String;
25 use SL::Template::LaTeX;
27 use Rose::Object::MakeMethods::Generic
29 scalar => [ qw(requirement_spec_item customers types statuses visible_item visible_section) ],
30 'scalar --get_set_init' => [ qw(requirement_spec complexities risks projects copy_source js current_text_block_output_position) ],
33 __PACKAGE__->run_before('setup');
34 __PACKAGE__->run_before('load_select_options', only => [ qw(new ajax_edit create update list) ]);
36 __PACKAGE__->make_filtered(
37 MODEL => 'RequirementSpec',
38 LAUNDER_TO => 'filter'
40 __PACKAGE__->make_paginated(
41 MODEL => 'RequirementSpec',
44 __PACKAGE__->make_sorted(
45 MODEL => 'RequirementSpec',
48 DEFAULT_BY => 'customer',
51 customer => t8('Customer'),
53 type => t8('Requirement Spec Type'),
54 status => t8('Requirement Spec Status'),
55 projectnumber => t8('Project Number'),
56 version => t8('Version'),
57 mtime => t8('Last modification'),
68 my $requirement_specs = $self->get_models(
71 working_copy_id => undef,
72 is_template => $::form->{is_template} ? 1 : 0,
74 with_objects => [ 'customer', 'type', 'status', 'project' ],
77 $self->prepare_report;
78 $self->report_generator_list_objects(report => $self->{report}, objects => $requirement_specs);
84 $self->requirement_spec(SL::DB::RequirementSpec->new(is_template => $::form->{is_template}));
86 if ($self->copy_source) {
87 $self->requirement_spec->$_($self->copy_source->$_) for qw(type_id status_id customer_id title hourly_rate)
90 $self->render('requirement_spec/new', title => $self->requirement_spec->is_template ? t8('Create a new requirement spec template') : t8('Create a new requirement spec'));
93 sub action_ajax_show_basic_settings {
96 $self->render('requirement_spec/_show_basic_settings', { layout => 0 });
99 sub action_ajax_edit {
102 my $html = $self->render('requirement_spec/_form', { output => 0 }, submit_as => 'ajax');
105 ->hide('#basic_settings')
106 ->after('#basic_settings', $html)
110 sub action_ajax_show_time_and_cost_estimate {
113 $self->render('requirement_spec/_show_time_and_cost_estimate', { layout => 0 });
116 sub action_ajax_edit_time_and_cost_estimate {
119 my $html = $self->render('requirement_spec/_edit_time_and_cost_estimate', { output => 0 });
122 ->hide('#time_cost_estimate')
123 ->after('#time_cost_estimate', $html)
124 ->on('#time_cost_estimate INPUT[type=text]', 'keydown', 'kivi.requirement_spec.time_cost_estimate_input_key_down')
128 sub action_ajax_save_time_and_cost_estimate {
131 $self->requirement_spec->db->do_transaction(sub {
134 foreach my $attributes (@{ $::form->{requirement_spec_items} || [] }) {
135 SL::DB::RequirementSpecItem
136 ->new(id => delete $attributes->{id})
138 ->update_attributes(%{ $attributes });
144 $self->requirement_spec(SL::DB::RequirementSpec->new(id => $self->requirement_spec->id)->load);
146 my $html = $self->render('requirement_spec/_show_time_and_cost_estimate', { output => 0 });
147 $self->js->replaceWith('#time_cost_estimate', $html)
148 ->remove('#time_cost_estimate_form_container');
150 if ($self->visible_section) {
151 $html = $self->render('requirement_spec_item/_section', { output => 0 }, requirement_spec_item => $self->visible_section);
152 $self->js->html('#column-content', $html);
155 $self->js->render($self);
161 my $title = $self->requirement_spec->is_template ? t8('Show requirement spec template') : t8('Show requirement spec');
162 my $item = $::form->{requirement_spec_item_id} ? SL::DB::RequirementSpecItem->new(id => $::form->{requirement_spec_item_id})->load : @{ $self->requirement_spec->sections }[0];
163 $self->requirement_spec_item($item);
165 $self->render('requirement_spec/show', title => $title);
171 $self->requirement_spec(SL::DB::RequirementSpec->new);
172 $self->create_or_update;
177 $self->create_or_update;
183 if (eval { $self->requirement_spec->delete; 1; }) {
184 flash_later('info', t8('The requirement spec has been deleted.'));
186 flash_later('error', t8('The requirement spec is in use and cannot be deleted.'));
189 $self->redirect_to(action => 'list');
192 sub action_revert_to {
193 my ($self, %params) = @_;
195 return $self->js->error(t8('Cannot revert a versioned copy.'))->render($self) if $self->requirement_spec->working_copy_id;
197 my $versioned_copy = SL::DB::RequirementSpec->new(id => $::form->{versioned_copy_id})->load;
199 $self->requirement_spec->copy_from($versioned_copy);
200 my $version = $versioned_copy->versions->[0];
201 $version->update_attributes(working_copy_id => $self->requirement_spec->id);
203 flash_later('info', t8('The requirement spec has been reverted to version #1.', $self->requirement_spec->version->version_number));
204 $self->js->redirect_to($self->url_for(action => 'show', id => $self->requirement_spec->id))->render($self);
207 sub action_create_pdf {
208 my ($self, %params) = @_;
210 my $base_name = $self->requirement_spec->type->template_file_name || 'requirement_spec';
211 my %result = SL::Template::LaTeX->parse_and_create_pdf("${base_name}.tex", SELF => $self, rspec => $self->requirement_spec);
213 $::form->error(t8('Conversion to PDF failed: #1', $result{error})) if $result{error};
215 my $attachment_name = $self->requirement_spec->type->description . ' ' . ($self->requirement_spec->working_copy_id || $self->requirement_spec->id);
216 $attachment_name .= ' (v' . $self->requirement_spec->version->version_number . ')' if $self->requirement_spec->version;
217 $attachment_name .= '.pdf';
218 $attachment_name =~ s/[^\wäöüÄÖÜß \-\+\(\)\[\]\{\}\.,]+/_/g;
220 $self->send_file($result{file_name}, type => 'application/pdf', name => $attachment_name);
221 unlink $result{file_name};
224 sub action_select_template_to_paste {
227 my @templates = grep { @{ $_->sections } || @{ $_->text_blocks } } @{ SL::DB::Manager::RequirementSpec->get_all(where => [ is_template => 1 ], sort_by => 'lower(title)') };
228 $self->render('requirement_spec/select_template_to_paste', { layout => 0 }, TEMPLATES => \@templates);
231 sub action_paste_template {
232 my ($self, %params) = @_;
234 my $template = SL::DB::RequirementSpec->new(id => $::form->{template_id})->load;
235 my %result = $self->requirement_spec->paste_template($template);
237 return $self->js->error($self->requirement_spec->error)->render($self) if !%result;
239 $self->render_pasted_text_block($_) for sort { $a->position <=> $b->position } @{ $result{text_blocks} };
240 $self->render_pasted_section($_) for sort { $a->position <=> $b->position } @{ $result{sections} };
242 if (@{ $result{sections} } && (($::form->{current_content_type} || 'sections') eq 'sections') && !$::form->{current_content_id}) {
243 $self->render_first_pasted_section_as_list($result{sections}->[0]);
246 $self->invalidate_version->render($self);
256 $::auth->assert('sales_quotation_edit');
257 $::request->{layout}->use_stylesheet("${_}.css") for qw(jquery.contextMenu requirement_spec);
258 $::request->{layout}->use_javascript("${_}.js") for qw(jquery.jstree jquery/jquery.contextMenu client_js requirement_spec);
259 $self->init_visible_section;
264 sub init_complexities {
266 return SL::DB::Manager::RequirementSpecComplexity->get_all_sorted;
271 return SL::DB::Manager::RequirementSpecRisk->get_all_sorted;
276 $self->projects(SL::DB::Manager::Project->get_all_sorted);
279 sub init_requirement_spec {
281 $self->requirement_spec(SL::DB::RequirementSpec->new(id => $::form->{id})->load || die "No such requirement spec") if $::form->{id};
284 sub init_copy_source {
286 $self->copy_source(SL::DB::RequirementSpec->new(id => $::form->{copy_source_id})->load) if $::form->{copy_source_id};
291 $self->js(SL::ClientJS->new);
294 sub init_current_text_block_output_position {
296 $self->current_text_block_output_position($::form->{current_content_type} !~ m/^(?:text-blocks|tb)-(front|back)/ ? -1 : $1 eq 'front' ? 0 : 1);
299 sub load_select_options {
302 my @filter = ('!obsolete' => 1);
303 @filter = ( or => [ @filter, id => $self->requirement_spec->customer_id ] ) if $self->requirement_spec && $self->requirement_spec->customer_id;
305 $self->customers(SL::DB::Manager::Customer->get_all_sorted(where => \@filter));
306 $self->statuses( SL::DB::Manager::RequirementSpecStatus->get_all_sorted);
307 $self->types( SL::DB::Manager::RequirementSpecType->get_all_sorted);
314 sub create_or_update {
316 my $is_new = !$self->requirement_spec->id;
317 my $params = delete($::form->{requirement_spec}) || { };
319 $self->requirement_spec->assign_attributes(%{ $params });
321 my $title = $is_new && $self->requirement_spec->is_template ? t8('Create a new requirement spec template')
322 : $is_new ? t8('Create a new requirement spec')
323 : $self->requirement_spec->is_template ? t8('Edit requirement spec template')
324 : t8('Edit requirement spec');
326 my @errors = $self->requirement_spec->validate;
329 return $self->js->error(@errors)->render($self) if $::request->is_ajax;
331 flash('error', @errors);
332 $self->render('requirement_spec/new', title => $title);
336 my $db = $self->requirement_spec->db;
337 if (!$db->do_transaction(sub {
338 if ($self->copy_source) {
339 $self->requirement_spec($self->copy_source->create_copy(%{ $params }));
341 $self->requirement_spec->save;
344 $::lxdebug->message(LXDebug::WARN(), "Error: " . $db->error);
345 @errors = ($::locale->text('Saving failed. Error message from the database: #1'), $db->error);
346 return $self->js->error(@errors)->render($self) if $::request->is_ajax;
348 $self->requirement_spec->id(undef) if $is_new;
349 flash('error', @errors);
350 return $self->render('requirement_spec/new', title => $title);
353 my $info = $self->requirement_spec->is_template ? t8('The requirement spec template has been saved.') : t8('The requirement spec has been saved.');
355 if ($::request->is_ajax) {
356 my $header_html = $self->render('requirement_spec/_header', { output => 0 });
357 my $basics_html = $self->render('requirement_spec/_show_basic_settings', { output => 0 });
358 return $self->invalidate_version
359 ->replaceWith('#requirement-spec-header', $header_html)
360 ->replaceWith('#basic_settings', $basics_html)
361 ->remove('#basic_settings_form')
362 ->flash('info', $info)
366 flash_later('info', $info);
367 $self->redirect_to(action => 'show', id => $self->requirement_spec->id);
373 my $callback = $self->get_callback;
375 my $is_template = $::form->{is_template};
376 my $report = SL::ReportGenerator->new(\%::myconfig, $::form);
377 $self->{report} = $report;
379 my @columns = $is_template ? qw(title mtime) : qw(title customer status type projectnumber mtime version);
380 my @sortable = $is_template ? qw(title mtime) : qw(title customer status type projectnumber mtime);
383 title => { obj_link => sub { $self->url_for(action => 'show', id => $_[0]->id, callback => $callback) } },
384 mtime => { sub => sub { ($_[0]->mtime || $_[0]->itime)->to_kivitendo(precision => 'minute') } },
390 customer => { raw_data => sub { $self->presenter->customer($_[0]->customer, display => 'table-cell', callback => $callback) },
391 sub => sub { $_[0]->customer->name } },
392 projectnumber => { raw_data => sub { $self->presenter->project($_[0]->project, display => 'table-cell', callback => $callback) },
393 sub => sub { $_[0]->project_id ? $_[0]->project->projectnumber : '' } },
394 status => { sub => sub { $_[0]->status->description } },
395 type => { sub => sub { $_[0]->type->description } },
396 version => { sub => sub { $_[0]->version ? $_[0]->version->version_number : t8('Working copy without version') } },
400 map { $column_defs{$_}->{text} ||= $::locale->text( $self->get_sort_spec->{$_}->{title} ) } keys %column_defs;
402 $report->set_options(
403 std_column_visibility => 1,
404 controller_class => 'RequirementSpec',
405 output_format => 'HTML',
406 raw_top_info_text => $self->render('requirement_spec/report_top', { output => 0 }, is_template => $is_template),
407 raw_bottom_info_text => $self->render('requirement_spec/report_bottom', { output => 0 }),
408 title => $is_template ? t8('Requirement Spec Templates') : t8('Requirement Specs'),
409 allow_pdf_export => 1,
410 allow_csv_export => 1,
412 $report->set_columns(%column_defs);
413 $report->set_column_order(@columns);
414 $report->set_export_options(qw(list filter));
415 $report->set_options_from_form;
416 $self->set_report_generator_sort_options(report => $report, sortable_columns => \@sortable);
418 $self->disable_pagination if $report->{options}{output_format} =~ /^(pdf|csv)$/i;
421 sub invalidate_version {
424 my $rspec = SL::DB::RequirementSpec->new(id => $self->requirement_spec->id)->load;
425 return $self->js if $rspec->is_template;
427 $rspec->invalidate_version;
429 my $html = $self->render('requirement_spec/_version', { output => 0 }, requirement_spec => $rspec);
430 return $self->js->html('#requirement_spec_version', $html);
433 sub render_pasted_text_block {
434 my ($self, $text_block, %params) = @_;
436 if ($self->current_text_block_output_position == $text_block->output_position) {
437 my $html = $self->render('requirement_spec_text_block/_text_block', { output => 0 }, text_block => $text_block);
439 ->appendTo($html, '#text-block-list')
440 ->hide('#text-block-list-empty');
443 my $node = $self->presenter->requirement_spec_text_block_jstree_data($text_block);
444 my $front_back = $text_block->output_position == 0 ? 'front' : 'back';
446 ->jstree->create_node('#tree', "#tb-${front_back}", 'last', $node)
447 ->jstree->open_node( '#tree', "#tb-${front_back}");
450 sub render_pasted_section {
451 my ($self, $item, $parent_id) = @_;
453 my $node = $self->presenter->requirement_spec_item_jstree_data($item);
455 ->jstree->create_node('#tree', $parent_id ? "#fb-${parent_id}" : '#sections', 'last', $node)
456 ->jstree->open_node( '#tree', $parent_id ? "#fb-${parent_id}" : '#sections');
458 $self->render_pasted_section($_, $item->id) for @{ $item->children_sorted };
461 sub render_first_pasted_section_as_list {
462 my ($self, $section, %params) = @_;
464 my $html = $self->render('requirement_spec_item/_section', { output => 0 }, requirement_spec_item => $section);
466 ->html('#column-content', $html)
467 ->val( '#current_content_type', $section->item_type)
468 ->val( '#current_content_id', $section->id)
469 ->jstree->select_node('#tree', '#fb-' . $section->id);