1 package SL::Controller::TimeRecording;
4 use parent qw(SL::Controller::Base);
7 use English qw(-no_match_vars);
8 use POSIX qw(strftime);
10 use SL::Controller::Helper::GetModels;
11 use SL::Controller::Helper::ReportGenerator;
15 use SL::DB::TimeRecording;
16 use SL::DB::TimeRecordingArticle;
17 use SL::Helper::Flash qw(flash);
18 use SL::Helper::UserPreferences::TimeRecording;
19 use SL::Locale::String qw(t8);
20 use SL::ReportGenerator;
22 use Rose::Object::MakeMethods::Generic
25 'scalar --get_set_init' => [ qw(time_recording models all_employees all_time_recording_articles can_view_all can_edit_all use_duration) ],
30 __PACKAGE__->run_before('check_auth');
31 __PACKAGE__->run_before('check_auth_edit', only => [ qw(edit save delete) ]);
35 start_time => t8('Start'),
36 end_time => t8('End'),
37 customer => t8('Customer'),
38 part => t8('Article'),
39 project => t8('Project'),
40 description => t8('Description'),
41 staff_member => t8('Mitarbeiter'),
42 duration => t8('Duration'),
43 booked => t8('Booked'),
51 my ($self, %params) = @_;
53 $::form->{filter} //= {
54 staff_member_id => SL::DB::Manager::Employee->current->id,
55 "date:date::ge" => DateTime->today_local->add(weeks => -2)->to_kivitendo,
58 $self->setup_list_action_bar;
59 $self->make_filter_summary;
60 $self->prepare_report;
62 $self->report_generator_list_objects(report => $self->{report}, objects => $self->models->get);
68 $::request->{layout}->use_javascript("${_}.js") for qw(kivi.TimeRecording ckeditor/ckeditor ckeditor/adapters/jquery kivi.Validator);
70 if ($self->use_duration) {
71 flash('warning', t8('This entry is using start and end time. This information will be overwritten on saving.')) if !$self->time_recording->is_duration_used;
73 flash('warning', t8('This entry is using date and duration. This information will be overwritten on saving.')) if $self->time_recording->is_duration_used;
76 if ($self->time_recording->start_time) {
77 $self->{start_date} = $self->time_recording->start_time->to_kivitendo;
78 $self->{start_time} = $self->time_recording->start_time->to_kivitendo_time;
80 if ($self->time_recording->end_time) {
81 $self->{end_date} = $self->time_recording->end_time->to_kivitendo;
82 $self->{end_time} = $self->time_recording->end_time->to_kivitendo_time;
85 $self->setup_edit_action_bar;
87 $self->render('time_recording/form',
88 title => t8('Time Recording'),
95 if ($self->use_duration) {
96 $self->time_recording->start_date(undef);
97 $self->time_recording->end_date(undef);
100 my @errors = $self->time_recording->validate;
102 $::form->error(t8('Saving the time recording entry failed: #1', join '<br>', @errors));
106 if ( !eval { $self->time_recording->save; 1; } ) {
107 $::form->error(t8('Saving the time recording entry failed: #1', $EVAL_ERROR));
111 $self->redirect_to(safe_callback());
117 $self->time_recording->delete;
119 $self->redirect_to(safe_callback());
122 sub init_time_recording {
125 my $is_new = !$::form->{id};
126 my $time_recording = !$is_new ? SL::DB::TimeRecording->new(id => $::form->{id})->load
127 : $self->use_duration ? SL::DB::TimeRecording->new(date => DateTime->today_local)
128 : SL::DB::TimeRecording->new(start_time => DateTime->now_local);
130 my %attributes = %{ $::form->{time_recording} || {} };
132 if (!$self->use_duration) {
133 foreach my $type (qw(start end)) {
134 if ($::form->{$type . '_date'}) {
135 my $date = DateTime->from_kivitendo($::form->{$type . '_date'});
136 $attributes{$type . '_time'} = $date->clone;
137 if ($::form->{$type . '_time'}) {
138 my ($hour, $min) = split ':', $::form->{$type . '_time'};
139 $attributes{$type . '_time'}->set_hour($hour) if $hour;
140 $attributes{$type . '_time'}->set_minute($min) if $min;
146 # do not overwrite staff member if you do not have the right
147 delete $attributes{staff_member_id} if !$_[0]->can_edit_all;
148 $attributes{staff_member_id} = SL::DB::Manager::Employee->current->id if $is_new;
150 $attributes{employee_id} = SL::DB::Manager::Employee->current->id;
152 $time_recording->assign_attributes(%attributes);
154 return $time_recording;
157 sub init_can_view_all {
158 $::auth->assert('time_recording_show_all', 1) || $::auth->assert('time_recording_edit_all', 1)
161 sub init_can_edit_all {
162 $::auth->assert('time_recording_edit_all', 1)
169 push @where, (staff_member_id => SL::DB::Manager::Employee->current->id) if !$self->can_view_all;
171 SL::Controller::Helper::GetModels->new(
173 sorted => \%sort_columns,
174 disable_plugin => 'paginated',
176 with_objects => [ 'customer', 'part', 'project', 'staff_member', 'employee' ],
180 sub init_all_employees {
181 SL::DB::Manager::Employee->get_all_sorted(query => [ deleted => 0 ]);
184 sub init_all_time_recording_articles {
185 my $selectable_parts = SL::DB::Manager::TimeRecordingArticle->get_all_sorted(
186 query => [or => [ 'part.obsolete' => 0, 'part.obsolete' => undef ]],
187 with_objects => ['part']);
189 my $res = [ map { {id => $_->part_id, description => $_->part->displayable_name} } @$selectable_parts];
190 my $curr_id = $_[0]->time_recording->part_id;
192 if ($curr_id && !grep { $curr_id == $_->{id} } @$res) {
193 unshift @$res, {id => $curr_id, description => $_[0]->time_recording->part->displayable_name};
199 sub init_use_duration {
200 return SL::Helper::UserPreferences::TimeRecording->new()->get_use_duration();
204 $::auth->assert('time_recording');
207 sub check_auth_edit {
210 if (!$self->can_edit_all && ($self->time_recording->staff_member_id != SL::DB::Manager::Employee->current->id)) {
211 $::form->error(t8('You do not have permission to access this entry.'));
218 my $report = SL::ReportGenerator->new(\%::myconfig, $::form);
219 $self->{report} = $report;
221 my @columns = qw(date start_time end_time customer part project description staff_member duration booked);
224 date => { text => t8('Date'), sub => sub { $_[0]->date_as_date },
225 obj_link => sub { $self->url_for(action => 'edit', 'id' => $_[0]->id, callback => $self->models->get_callback) } },
226 start_time => { text => t8('Start'), sub => sub { $_[0]->start_time_as_timestamp },
227 obj_link => sub { $self->url_for(action => 'edit', 'id' => $_[0]->id, callback => $self->models->get_callback) } },
228 end_time => { text => t8('End'), sub => sub { $_[0]->end_time_as_timestamp },
229 obj_link => sub { $self->url_for(action => 'edit', 'id' => $_[0]->id, callback => $self->models->get_callback) } },
230 customer => { text => t8('Customer'), sub => sub { $_[0]->customer->displayable_name } },
231 part => { text => t8('Article'), sub => sub { $_[0]->part && $_[0]->part->displayable_name } },
232 project => { text => t8('Project'), sub => sub { $_[0]->project && $_[0]->project->displayable_name } },
233 description => { text => t8('Description'), sub => sub { $_[0]->description_as_stripped_html },
234 raw_data => sub { $_[0]->description_as_restricted_html }, # raw_data only used for html(?)
235 obj_link => sub { $self->url_for(action => 'edit', 'id' => $_[0]->id, callback => $self->models->get_callback) } },
236 staff_member => { text => t8('Mitarbeiter'), sub => sub { $_[0]->staff_member->safe_name } },
237 duration => { text => t8('Duration'), sub => sub { $_[0]->duration_as_duration_string },
239 booked => { text => t8('Booked'), sub => sub { $_[0]->booked ? t8('Yes') : t8('No') } },
242 my $title = t8('Time Recordings');
243 $report->{title} = $title; # for browser titlebar (title-tag)
245 $report->set_options(
246 controller_class => 'TimeRecording',
247 std_column_visibility => 1,
248 output_format => 'HTML',
249 title => $title, # for heading
250 allow_pdf_export => 1,
251 allow_csv_export => 1,
254 $report->set_columns(%column_defs);
255 $report->set_column_order(@columns);
256 $report->set_export_options(qw(list filter));
257 $report->set_options_from_form;
259 $self->models->disable_plugin('paginated') if $report->{options}{output_format} =~ /^(pdf|csv)$/i;
260 $self->models->add_additional_url_params(filter => $::form->{filter});
261 $self->models->finalize;
262 $self->models->set_report_generator_sort_options(report => $report, sortable_columns => [keys %sort_columns]);
264 $report->set_options(
265 raw_top_info_text => $self->render('time_recording/report_top', { output => 0 }),
266 raw_bottom_info_text => $self->render('time_recording/report_bottom', { output => 0 }, models => $self->models),
267 attachment_basename => t8('time_recordings') . strftime('_%Y%m%d', localtime time),
271 sub make_filter_summary {
274 my $filter = $::form->{filter} || {};
277 my $staff_member = $filter->{staff_member_id} ? SL::DB::Employee->new(id => $filter->{staff_member_id})->load->safe_name : '';
280 [ $filter->{"date:date::ge"}, t8('From Date') ],
281 [ $filter->{"date:date::le"}, t8('To Date') ],
282 [ $filter->{"customer"}->{"name:substr::ilike"}, t8('Customer') ],
283 [ $filter->{"customer"}->{"customernumber:substr::ilike"}, t8('Customer Number') ],
284 [ $staff_member, t8('Mitarbeiter') ],
288 push @filter_strings, "$_->[1]: $_->[0]" if $_->[0];
291 $self->{filter_summary} = join ', ', @filter_strings;
294 sub setup_list_action_bar {
297 for my $bar ($::request->layout->get('actionbar')) {
301 submit => [ '#filter_form', { action => 'TimeRecording/list' } ],
302 accesskey => 'enter',
306 link => $self->url_for(action => 'edit', callback => $self->models->get_callback),
312 sub setup_edit_action_bar {
315 for my $bar ($::request->layout->get('actionbar')) {
319 submit => [ '#form', { action => 'TimeRecording/save' } ],
320 checks => [ 'kivi.validate_form' ],
324 submit => [ '#form', { action => 'TimeRecording/delete' } ],
325 only_if => $self->time_recording->id,
329 link => $self->url_for(safe_callback()),
336 $::form->{callback} || (action => 'list')