Putting 4.2.0 on top of 4.0.17
[usit-rt.git] / lib / RT / Report / Tickets.pm
CommitLineData
84fb5b46
MKG
1# BEGIN BPS TAGGED BLOCK {{{
2#
3# COPYRIGHT:
4#
403d7b0b 5# This software is Copyright (c) 1996-2013 Best Practical Solutions, LLC
84fb5b46
MKG
6# <sales@bestpractical.com>
7#
8# (Except where explicitly superseded by other copyright notices)
9#
10#
11# LICENSE:
12#
13# This work is made available to you under the terms of Version 2 of
14# the GNU General Public License. A copy of that license should have
15# been provided with this software, but in any event can be snarfed
16# from www.gnu.org.
17#
18# This work is distributed in the hope that it will be useful, but
19# WITHOUT ANY WARRANTY; without even the implied warranty of
20# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
21# General Public License for more details.
22#
23# You should have received a copy of the GNU General Public License
24# along with this program; if not, write to the Free Software
25# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
26# 02110-1301 or visit their web page on the internet at
27# http://www.gnu.org/licenses/old-licenses/gpl-2.0.html.
28#
29#
30# CONTRIBUTION SUBMISSION POLICY:
31#
32# (The following paragraph is not intended to limit the rights granted
33# to you to modify and distribute this software under the terms of
34# the GNU General Public License and is only of importance to you if
35# you choose to contribute your changes and enhancements to the
36# community by submitting them to Best Practical Solutions, LLC.)
37#
38# By intentionally submitting any modifications, corrections or
39# derivatives to this work, or any other work intended for use with
40# Request Tracker, to Best Practical Solutions, LLC, you confirm that
41# you are the copyright holder for those contributions and you grant
42# Best Practical Solutions, LLC a nonexclusive, worldwide, irrevocable,
43# royalty-free, perpetual, license to use, copy, create derivative
44# works based on those contributions, and sublicense and distribute
45# those contributions and any derivatives thereof.
46#
47# END BPS TAGGED BLOCK }}}
48
49package RT::Report::Tickets;
50
51use base qw/RT::Tickets/;
52use RT::Report::Tickets::Entry;
53
54use strict;
55use warnings;
56
af59614d
MKG
57use Scalar::Util qw(weaken);
58
59our @GROUPINGS = (
60 Status => 'Enum', #loc_left_pair
61
62 Queue => 'Queue', #loc_left_pair
63
64 Owner => 'User', #loc_left_pair
65 Creator => 'User', #loc_left_pair
66 LastUpdatedBy => 'User', #loc_left_pair
67
68 Requestor => 'Watcher', #loc_left_pair
69 Cc => 'Watcher', #loc_left_pair
70 AdminCc => 'Watcher', #loc_left_pair
71 Watcher => 'Watcher', #loc_left_pair
72
73 Created => 'Date', #loc_left_pair
74 Starts => 'Date', #loc_left_pair
75 Started => 'Date', #loc_left_pair
76 Resolved => 'Date', #loc_left_pair
77 Due => 'Date', #loc_left_pair
78 Told => 'Date', #loc_left_pair
79 LastUpdated => 'Date', #loc_left_pair
80
81 CF => 'CustomField', #loc_left_pair
82);
83our %GROUPINGS;
84
85our %GROUPINGS_META = (
86 Queue => {
87 Display => sub {
88 my $self = shift;
89 my %args = (@_);
90
91 my $queue = RT::Queue->new( $self->CurrentUser );
92 $queue->Load( $args{'VALUE'} );
93 return $queue->Name;
94 },
95 Localize => 1,
96 },
97 User => {
98 SubFields => [grep RT::User->_Accessible($_, "public"), qw(
99 Name RealName NickName
100 EmailAddress
101 Organization
102 Lang City Country Timezone
103 )],
104 Function => 'GenerateUserFunction',
105 },
106 Watcher => {
107 SubFields => [grep RT::User->_Accessible($_, "public"), qw(
108 Name RealName NickName
109 EmailAddress
110 Organization
111 Lang City Country Timezone
112 )],
113 Function => 'GenerateWatcherFunction',
114 },
115 Date => {
116 SubFields => [qw(
117 Time
118 Hourly Hour
119 Date Daily
120 DayOfWeek Day DayOfMonth DayOfYear
121 Month Monthly
122 Year Annually
123 WeekOfYear
124 )],
125 Function => 'GenerateDateFunction',
126 Display => sub {
127 my $self = shift;
128 my %args = (@_);
129
130 my $raw = $args{'VALUE'};
131 return $raw unless defined $raw;
132
133 if ( $args{'SUBKEY'} eq 'DayOfWeek' ) {
134 return $self->loc($RT::Date::DAYS_OF_WEEK[ int $raw ]);
135 }
136 elsif ( $args{'SUBKEY'} eq 'Month' ) {
137 return $self->loc($RT::Date::MONTHS[ int($raw) - 1 ]);
138 }
139 return $raw;
140 },
141 Sort => 'raw',
142 },
143 CustomField => {
144 SubFields => sub {
145 my $self = shift;
146 my $args = shift;
147
148
149 my $queues = $args->{'Queues'};
150 if ( !$queues && $args->{'Query'} ) {
151 require RT::Interface::Web::QueryBuilder::Tree;
152 my $tree = RT::Interface::Web::QueryBuilder::Tree->new('AND');
153 $tree->ParseSQL( Query => $args->{'Query'}, CurrentUser => $self->CurrentUser );
154 $queues = $args->{'Queues'} = $tree->GetReferencedQueues;
155 }
156 return () unless $queues;
157
158 my @res;
159
160 my $CustomFields = RT::CustomFields->new( $self->CurrentUser );
161 foreach my $id (keys %$queues) {
162 my $queue = RT::Queue->new( $self->CurrentUser );
163 $queue->Load($id);
164 next unless $queue->id;
165
166 $CustomFields->LimitToQueue($queue->id);
167 }
168 $CustomFields->LimitToGlobal;
169 while ( my $CustomField = $CustomFields->Next ) {
170 push @res, ["Custom field", $CustomField->Name], "CF.{". $CustomField->id ."}";
171 }
172 return @res;
173 },
174 Function => 'GenerateCustomFieldFunction',
175 Label => sub {
176 my $self = shift;
177 my %args = (@_);
178
179 my ($cf) = ( $args{'SUBKEY'} =~ /^\{(.*)\}$/ );
180 if ( $cf =~ /^\d+$/ ) {
181 my $obj = RT::CustomField->new( $self->CurrentUser );
182 $obj->Load( $cf );
183 $cf = $obj->Name;
184 }
185
186 return 'Custom field [_1]', $self->CurrentUser->loc( $cf );
187 },
188 },
189 Enum => {
190 Localize => 1,
191 },
192);
193
194# loc'able strings below generated with:
195# perl -MRT=-init -MRT::Report::Tickets -E 'say qq{\# loc("$_->[0]")} while $_ = splice @RT::Report::Tickets::STATISTICS, 0, 2'
196#
197# loc("Ticket count")
198# loc("Summary of time worked")
199# loc("Total time worked")
200# loc("Average time worked")
201# loc("Minimum time worked")
202# loc("Maximum time worked")
203# loc("Summary of time estimated")
204# loc("Total time estimated")
205# loc("Average time estimated")
206# loc("Minimum time estimated")
207# loc("Maximum time estimated")
208# loc("Summary of time left")
209# loc("Total time left")
210# loc("Average time left")
211# loc("Minimum time left")
212# loc("Maximum time left")
213# loc("Summary of Created-Started")
214# loc("Total Created-Started")
215# loc("Average Created-Started")
216# loc("Minimum Created-Started")
217# loc("Maximum Created-Started")
218# loc("Summary of Created-Resolved")
219# loc("Total Created-Resolved")
220# loc("Average Created-Resolved")
221# loc("Minimum Created-Resolved")
222# loc("Maximum Created-Resolved")
223# loc("Summary of Created-LastUpdated")
224# loc("Total Created-LastUpdated")
225# loc("Average Created-LastUpdated")
226# loc("Minimum Created-LastUpdated")
227# loc("Maximum Created-LastUpdated")
228# loc("Summary of Starts-Started")
229# loc("Total Starts-Started")
230# loc("Average Starts-Started")
231# loc("Minimum Starts-Started")
232# loc("Maximum Starts-Started")
233# loc("Summary of Due-Resolved")
234# loc("Total Due-Resolved")
235# loc("Average Due-Resolved")
236# loc("Minimum Due-Resolved")
237# loc("Maximum Due-Resolved")
238# loc("Summary of Started-Resolved")
239# loc("Total Started-Resolved")
240# loc("Average Started-Resolved")
241# loc("Minimum Started-Resolved")
242# loc("Maximum Started-Resolved")
243
244our @STATISTICS = (
245 COUNT => ['Ticket count', 'Count', 'id'],
246);
247
248foreach my $field (qw(TimeWorked TimeEstimated TimeLeft)) {
249 my $friendly = lc join ' ', split /(?<=[a-z])(?=[A-Z])/, $field;
250 push @STATISTICS, (
251 "ALL($field)" => ["Summary of $friendly", 'TimeAll', $field ],
252 "SUM($field)" => ["Total $friendly", 'Time', 'SUM', $field ],
253 "AVG($field)" => ["Average $friendly", 'Time', 'AVG', $field ],
254 "MIN($field)" => ["Minimum $friendly", 'Time', 'MIN', $field ],
255 "MAX($field)" => ["Maximum $friendly", 'Time', 'MAX', $field ],
256 );
257}
258
259
260foreach my $pair (qw(
261 Created-Started
262 Created-Resolved
263 Created-LastUpdated
264 Starts-Started
265 Due-Resolved
266 Started-Resolved
267)) {
268 my ($from, $to) = split /-/, $pair;
269 push @STATISTICS, (
270 "ALL($pair)" => ["Summary of $pair", 'DateTimeIntervalAll', $from, $to ],
271 "SUM($pair)" => ["Total $pair", 'DateTimeInterval', 'SUM', $from, $to ],
272 "AVG($pair)" => ["Average $pair", 'DateTimeInterval', 'AVG', $from, $to ],
273 "MIN($pair)" => ["Minimum $pair", 'DateTimeInterval', 'MIN', $from, $to ],
274 "MAX($pair)" => ["Maximum $pair", 'DateTimeInterval', 'MAX', $from, $to ],
275 );
276}
277
278our %STATISTICS;
279
280our %STATISTICS_META = (
281 Count => {
282 Function => sub {
283 my $self = shift;
284 my $field = shift || 'id';
285
286 # UseSQLForACLChecks may add late joins
287 my $joined = ($self->_isJoined || RT->Config->Get('UseSQLForACLChecks')) ? 1 : 0;
288 return (
289 FUNCTION => ($joined ? 'DISTINCT COUNT' : 'COUNT'),
290 FIELD => 'id'
291 );
292 },
293 },
294 Simple => {
295 Function => sub {
296 my $self = shift;
297 my ($function, $field) = @_;
298 return (FUNCTION => $function, FIELD => $field);
299 },
300 },
301 Time => {
302 Function => sub {
303 my $self = shift;
304 my ($function, $field) = @_;
305 return (FUNCTION => "$function(?)*60", FIELD => $field);
306 },
307 Display => 'DurationAsString',
308 },
309 TimeAll => {
310 SubValues => sub { return ('Minimum', 'Average', 'Maximum', 'Total') },
311 Function => sub {
312 my $self = shift;
313 my $field = shift;
314 return (
315 Minimum => { FUNCTION => "MIN(?)*60", FIELD => $field },
316 Average => { FUNCTION => "AVG(?)*60", FIELD => $field },
317 Maximum => { FUNCTION => "MAX(?)*60", FIELD => $field },
318 Total => { FUNCTION => "SUM(?)*60", FIELD => $field },
319 );
320 },
321 Display => 'DurationAsString',
322 },
323 DateTimeInterval => {
324 Function => sub {
325 my $self = shift;
326 my ($function, $from, $to) = @_;
327
328 my $interval = $self->_Handle->DateTimeIntervalFunction(
329 From => { FUNCTION => $self->NotSetDateToNullFunction( FIELD => $from ) },
330 To => { FUNCTION => $self->NotSetDateToNullFunction( FIELD => $to ) },
331 );
332
333 return (FUNCTION => "$function($interval)");
334 },
335 Display => 'DurationAsString',
336 },
337 DateTimeIntervalAll => {
338 SubValues => sub { return ('Minimum', 'Average', 'Maximum', 'Total') },
339 Function => sub {
340 my $self = shift;
341 my ($from, $to) = @_;
342
343 my $interval = $self->_Handle->DateTimeIntervalFunction(
344 From => { FUNCTION => $self->NotSetDateToNullFunction( FIELD => $from ) },
345 To => { FUNCTION => $self->NotSetDateToNullFunction( FIELD => $to ) },
346 );
347
348 return (
349 Minimum => { FUNCTION => "MIN($interval)" },
350 Average => { FUNCTION => "AVG($interval)" },
351 Maximum => { FUNCTION => "MAX($interval)" },
352 Total => { FUNCTION => "SUM($interval)" },
353 );
354 },
355 Display => 'DurationAsString',
356 },
357);
358
84fb5b46
MKG
359sub Groupings {
360 my $self = shift;
361 my %args = (@_);
84fb5b46 362
af59614d 363 my @fields;
84fb5b46 364
af59614d
MKG
365 my @tmp = @GROUPINGS;
366 while ( my ($field, $type) = splice @tmp, 0, 2 ) {
367 my $meta = $GROUPINGS_META{ $type } || {};
368 unless ( $meta->{'SubFields'} ) {
369 push @fields, [$field, $field], $field;
84fb5b46 370 }
af59614d
MKG
371 elsif ( ref( $meta->{'SubFields'} ) eq 'ARRAY' ) {
372 push @fields, map { ([$field, $_], "$field.$_") } @{ $meta->{'SubFields'} };
373 }
374 elsif ( my $code = $self->FindImplementationCode( $meta->{'SubFields'} ) ) {
375 push @fields, $code->( $self, \%args );
84fb5b46 376 }
af59614d
MKG
377 else {
378 $RT::Logger->error(
379 "$type has unsupported SubFields."
380 ." Not an array, a method name or a code reference"
381 );
84fb5b46
MKG
382 }
383 }
384 return @fields;
385}
386
af59614d 387sub IsValidGrouping {
84fb5b46 388 my $self = shift;
af59614d
MKG
389 my %args = (@_);
390 return 0 unless $args{'GroupBy'};
391
392 my ($key, $subkey) = split /\./, $args{'GroupBy'}, 2;
393
394 %GROUPINGS = @GROUPINGS unless keys %GROUPINGS;
395 my $type = $GROUPINGS{$key};
396 return 0 unless $type;
397 return 1 unless $subkey;
398
399 my $meta = $GROUPINGS_META{ $type } || {};
400 unless ( $meta->{'SubFields'} ) {
401 return 0;
402 }
403 elsif ( ref( $meta->{'SubFields'} ) eq 'ARRAY' ) {
404 return 1 if grep $_ eq $subkey, @{ $meta->{'SubFields'} };
405 }
406 elsif ( my $code = $self->FindImplementationCode( $meta->{'SubFields'}, 'silent' ) ) {
407 return 1 if grep $_ eq "$key.$subkey", $code->( $self, \%args );
408 }
409 return 0;
84fb5b46
MKG
410}
411
af59614d 412sub Statistics {
84fb5b46 413 my $self = shift;
af59614d
MKG
414 return map { ref($_)? $_->[0] : $_ } @STATISTICS;
415}
84fb5b46 416
af59614d
MKG
417sub Label {
418 my $self = shift;
419 my $column = shift;
84fb5b46 420
af59614d
MKG
421 my $info = $self->ColumnInfo( $column );
422 unless ( $info ) {
423 $RT::Logger->error("Unknown column '$column'");
424 return $self->CurrentUser->loc('(Incorrect data)');
425 }
426
427 if ( $info->{'META'}{'Label'} ) {
428 my $code = $self->FindImplementationCode( $info->{'META'}{'Label'} );
429 return $self->CurrentUser->loc( $code->( $self, %$info ) )
430 if $code;
431 }
84fb5b46 432
af59614d
MKG
433 my $res = '';
434 if ( $info->{'TYPE'} eq 'statistic' ) {
435 $res = $info->{'INFO'}[0];
436 }
437 else {
438 $res = join ' ', grep defined && length, @{ $info }{'KEY', 'SUBKEY'};
439 }
440 return $self->CurrentUser->loc( $res );
84fb5b46
MKG
441}
442
af59614d 443sub ColumnInfo {
84fb5b46 444 my $self = shift;
af59614d 445 my $column = shift;
84fb5b46 446
af59614d
MKG
447 return $self->{'column_info'}{$column};
448}
84fb5b46 449
af59614d
MKG
450sub ColumnsList {
451 my $self = shift;
452 return sort { $self->{'column_info'}{$a}{'POSITION'} <=> $self->{'column_info'}{$b}{'POSITION'} }
453 keys %{ $self->{'column_info'} || {} };
84fb5b46
MKG
454}
455
af59614d 456sub SetupGroupings {
84fb5b46 457 my $self = shift;
af59614d
MKG
458 my %args = (
459 Query => undef,
460 GroupBy => undef,
461 Function => undef,
462 @_
463 );
464
465 $self->FromSQL( $args{'Query'} ) if $args{'Query'};
466
467 %GROUPINGS = @GROUPINGS unless keys %GROUPINGS;
468
469 my $i = 0;
470
471 my @group_by = grep defined && length,
472 ref( $args{'GroupBy'} )? @{ $args{'GroupBy'} } : ($args{'GroupBy'});
473 @group_by = ('Status') unless @group_by;
84fb5b46 474
af59614d
MKG
475 foreach my $e ( splice @group_by ) {
476 unless ($self->IsValidGrouping( Query => $args{Query}, GroupBy => $e )) {
477 RT->Logger->error("'$e' is not a valid grouping for reports; skipping");
478 next;
479 }
480 my ($key, $subkey) = split /\./, $e, 2;
481 $e = { $self->_FieldToFunction( KEY => $key, SUBKEY => $subkey ) };
482 $e->{'TYPE'} = 'grouping';
483 $e->{'INFO'} = $GROUPINGS{ $key };
484 $e->{'META'} = $GROUPINGS_META{ $e->{'INFO'} };
485 $e->{'POSITION'} = $i++;
486 push @group_by, $e;
487 }
488 $self->GroupBy( map { {
489 ALIAS => $_->{'ALIAS'},
490 FIELD => $_->{'FIELD'},
491 FUNCTION => $_->{'FUNCTION'},
492 } } @group_by );
493
494 my %res = (Groups => [], Functions => []);
495 my %column_info;
496
497 foreach my $group_by ( @group_by ) {
498 $group_by->{'NAME'} = $self->Column( %$group_by );
499 $column_info{ $group_by->{'NAME'} } = $group_by;
500 push @{ $res{'Groups'} }, $group_by->{'NAME'};
84fb5b46
MKG
501 }
502
af59614d
MKG
503 %STATISTICS = @STATISTICS unless keys %STATISTICS;
504
505 my @function = grep defined && length,
506 ref( $args{'Function'} )? @{ $args{'Function'} } : ($args{'Function'});
507 push @function, 'COUNT' unless @function;
508 foreach my $e ( @function ) {
509 $e = {
510 TYPE => 'statistic',
511 KEY => $e,
512 INFO => $STATISTICS{ $e },
513 META => $STATISTICS_META{ $STATISTICS{ $e }[1] },
514 POSITION => $i++,
515 };
516 unless ( $e->{'INFO'} && $e->{'META'} ) {
517 $RT::Logger->error("'". $e->{'KEY'} ."' is not valid statistic for report");
518 $e->{'FUNCTION'} = 'NULL';
519 $e->{'NAME'} = $self->Column( FUNCTION => 'NULL' );
520 }
521 elsif ( $e->{'META'}{'Function'} ) {
522 my $code = $self->FindImplementationCode( $e->{'META'}{'Function'} );
523 unless ( $code ) {
524 $e->{'FUNCTION'} = 'NULL';
525 $e->{'NAME'} = $self->Column( FUNCTION => 'NULL' );
526 }
527 elsif ( $e->{'META'}{'SubValues'} ) {
528 my %tmp = $code->( $self, @{ $e->{INFO} }[2 .. $#{$e->{INFO}}] );
529 $e->{'NAME'} = 'postfunction'. $self->{'postfunctions'}++;
530 while ( my ($k, $v) = each %tmp ) {
531 $e->{'MAP'}{ $k }{'NAME'} = $self->Column( %$v );
532 @{ $e->{'MAP'}{ $k } }{'FUNCTION', 'ALIAS', 'FIELD'} =
533 @{ $v }{'FUNCTION', 'ALIAS', 'FIELD'};
534 }
535 }
536 else {
537 my %tmp = $code->( $self, @{ $e->{INFO} }[2 .. $#{$e->{INFO}}] );
538 $e->{'NAME'} = $self->Column( %tmp );
539 @{ $e }{'FUNCTION', 'ALIAS', 'FIELD'} = @tmp{'FUNCTION', 'ALIAS', 'FIELD'};
540 }
541 }
542 elsif ( $e->{'META'}{'Calculate'} ) {
543 $e->{'NAME'} = 'postfunction'. $self->{'postfunctions'}++;
544 }
545 push @{ $res{'Functions'} }, $e->{'NAME'};
546 $column_info{ $e->{'NAME'} } = $e;
547 }
548
549 $self->{'column_info'} = \%column_info;
550
551 return %res;
84fb5b46
MKG
552}
553
554=head2 _DoSearch
555
556Subclass _DoSearch from our parent so we can go through and add in empty
557columns if it makes sense
558
559=cut
560
561sub _DoSearch {
562 my $self = shift;
563 $self->SUPER::_DoSearch( @_ );
564 if ( $self->{'must_redo_search'} ) {
565 $RT::Logger->crit(
566"_DoSearch is not so successful as it still needs redo search, won't call AddEmptyRows"
567 );
568 }
569 else {
af59614d 570 $self->PostProcessRecords;
84fb5b46
MKG
571 }
572}
573
574=head2 _FieldToFunction FIELD
575
576Returns a tuple of the field or a database function to allow grouping on that
577field.
578
579=cut
580
581sub _FieldToFunction {
582 my $self = shift;
583 my %args = (@_);
584
af59614d 585 $args{'FIELD'} ||= $args{'KEY'};
84fb5b46 586
af59614d
MKG
587 my $meta = $GROUPINGS_META{ $GROUPINGS{ $args{'KEY'} } };
588 return ('FUNCTION' => 'NULL') unless $meta;
84fb5b46 589
af59614d 590 return %args unless $meta->{'Function'};
84fb5b46 591
af59614d
MKG
592 my $code = $self->FindImplementationCode( $meta->{'Function'} );
593 return ('FUNCTION' => 'NULL') unless $code;
594
595 return $code->( $self, %args );
596}
597
598
599# Gotta skip over RT::Tickets->Next, since it does all sorts of crazy magic we
600# don't want.
601sub Next {
602 my $self = shift;
603 $self->RT::SearchBuilder::Next(@_);
604
605}
606
607sub NewItem {
608 my $self = shift;
609 my $res = RT::Report::Tickets::Entry->new($self->CurrentUser);
610 $res->{'report'} = $self;
611 weaken $res->{'report'};
612 return $res;
613}
614
615# This is necessary since normally NewItem (above) is used to intuit the
616# correct class. However, since we're abusing a subclass, it's incorrect.
617sub _RoleGroupClass { "RT::Ticket" }
618sub _SingularClass { "RT::Report::Tickets::Entry" }
619
620sub SortEntries {
621 my $self = shift;
84fb5b46 622
af59614d
MKG
623 $self->_DoSearch if $self->{'must_redo_search'};
624 return unless $self->{'items'} && @{ $self->{'items'} };
84fb5b46 625
af59614d
MKG
626 my @groups =
627 grep $_->{'TYPE'} eq 'grouping',
628 map $self->ColumnInfo($_),
629 $self->ColumnsList;
630 return unless @groups;
631
632 my @SORT_OPS;
633 my $by_multiple = sub ($$) {
634 for my $f ( @SORT_OPS ) {
635 my $r = $f->($_[0], $_[1]);
636 return $r if $r;
84fb5b46 637 }
af59614d
MKG
638 };
639 my @data = map [$_], @{ $self->{'items'} };
640
641 for ( my $i = 0; $i < @groups; $i++ ) {
642 my $group_by = $groups[$i];
643 my $idx = $i+1;
644 my $method;
645
646 my $order = $group_by->{'META'}{Sort} || 'label';
647 if ( $order eq 'label' ) {
648 push @SORT_OPS, sub { $_[0][$idx] cmp $_[1][$idx] };
649 $method = 'LabelValue';
84fb5b46 650 }
af59614d
MKG
651 elsif ( $order eq 'numeric label' ) {
652 push @SORT_OPS, sub { $_[0][$idx] <=> $_[1][$idx] };
653 $method = 'LabelValue';
84fb5b46 654 }
af59614d
MKG
655 elsif ( $order eq 'raw' ) {
656 push @SORT_OPS, sub { $_[0][$idx] cmp $_[1][$idx] };
657 $method = 'RawValue';
84fb5b46 658 }
af59614d
MKG
659 elsif ( $order eq 'numeric raw' ) {
660 push @SORT_OPS, sub { $_[0][$idx] <=> $_[1][$idx] };
661 $method = 'RawValue';
84fb5b46 662 } else {
af59614d
MKG
663 $RT::Logger->error("Unknown sorting function '$order'");
664 next;
84fb5b46 665 }
af59614d
MKG
666 $_->[$idx] = $_->[0]->$method( $group_by->{'NAME'} ) for @data;
667 }
668 $self->{'items'} = [
669 map $_->[0],
670 sort $by_multiple @data
671 ];
672}
673
674sub PostProcessRecords {
675 my $self = shift;
676
677 my $info = $self->{'column_info'};
678 foreach my $column ( values %$info ) {
679 next unless $column->{'TYPE'} eq 'statistic';
680 if ( $column->{'META'}{'Calculate'} ) {
681 $self->CalculatePostFunction( $column );
682 }
683 elsif ( $column->{'META'}{'SubValues'} ) {
684 $self->MapSubValues( $column );
685 }
686 }
687}
688
689sub CalculatePostFunction {
690 my $self = shift;
691 my $info = shift;
692
693 my $code = $self->FindImplementationCode( $info->{'META'}{'Calculate'} );
694 unless ( $code ) {
695 # TODO: fill in undefs
696 return;
697 }
698
699 my $column = $info->{'NAME'};
700
701 my $base_query = $self->Query;
702 foreach my $item ( @{ $self->{'items'} } ) {
703 $item->{'values'}{ lc $column } = $code->(
704 $self,
705 Query => join(
706 ' AND ', map "($_)", grep defined && length, $base_query, $item->Query,
707 ),
708 );
709 $item->{'fetched'}{ lc $column } = 1;
710 }
711}
712
713sub MapSubValues {
714 my $self = shift;
715 my $info = shift;
716
717 my $to = $info->{'NAME'};
718 my $map = $info->{'MAP'};
719
720 foreach my $item ( @{ $self->{'items'} } ) {
721 my $dst = $item->{'values'}{ lc $to } = { };
722 while (my ($k, $v) = each %{ $map } ) {
723 $dst->{ $k } = delete $item->{'values'}{ lc $v->{'NAME'} };
724 utf8::decode( $dst->{ $k } )
725 if defined $dst->{ $k }
726 and not utf8::is_utf8( $dst->{ $k } );
727 delete $item->{'fetched'}{ lc $v->{'NAME'} };
84fb5b46 728 }
af59614d
MKG
729 $item->{'fetched'}{ lc $to } = 1;
730 }
731}
732
733sub GenerateDateFunction {
734 my $self = shift;
735 my %args = @_;
736
737 my $tz;
738 if ( RT->Config->Get('ChartsTimezonesInDB') ) {
739 my $to = $self->CurrentUser->UserObj->Timezone
740 || RT->Config->Get('Timezone');
741 $tz = { From => 'UTC', To => $to }
742 if $to && lc $to ne 'utc';
84fb5b46 743 }
af59614d
MKG
744
745 $args{'FUNCTION'} = $RT::Handle->DateTimeFunction(
746 Type => $args{'SUBKEY'},
747 Field => $self->NotSetDateToNullFunction,
748 Timezone => $tz,
749 );
84fb5b46
MKG
750 return %args;
751}
752
af59614d
MKG
753sub GenerateCustomFieldFunction {
754 my $self = shift;
755 my %args = @_;
84fb5b46 756
af59614d
MKG
757 my ($name) = ( $args{'SUBKEY'} =~ /^\{(.*)\}$/ );
758 my $cf = RT::CustomField->new( $self->CurrentUser );
759 $cf->Load($name);
760 unless ( $cf->id ) {
761 $RT::Logger->error("Couldn't load CustomField #$name");
762 @args{qw(FUNCTION FIELD)} = ('NULL', undef);
763 } else {
764 my ($ticket_cf_alias, $cf_alias) = $self->_CustomFieldJoin($cf->id, $cf);
765 @args{qw(ALIAS FIELD)} = ($ticket_cf_alias, 'Content');
766 }
767 return %args;
768}
769
770sub GenerateUserFunction {
84fb5b46 771 my $self = shift;
af59614d
MKG
772 my %args = @_;
773
774 my $column = $args{'SUBKEY'} || 'Name';
775 my $u_alias = $self->{"_sql_report_$args{FIELD}_users_$column"}
776 ||= $self->Join(
777 TYPE => 'LEFT',
778 ALIAS1 => 'main',
779 FIELD1 => $args{'FIELD'},
780 TABLE2 => 'Users',
781 FIELD2 => 'id',
782 );
783 @args{qw(ALIAS FIELD)} = ($u_alias, $column);
784 return %args;
84fb5b46
MKG
785}
786
af59614d
MKG
787sub GenerateWatcherFunction {
788 my $self = shift;
789 my %args = @_;
84fb5b46 790
af59614d
MKG
791 my $type = $args{'FIELD'};
792 $type = '' if $type eq 'Watcher';
84fb5b46 793
af59614d 794 my $column = $args{'SUBKEY'} || 'Name';
84fb5b46 795
af59614d
MKG
796 my $u_alias = $self->{"_sql_report_watcher_users_alias_$type"};
797 unless ( $u_alias ) {
798 my ($g_alias, $gm_alias);
799 ($g_alias, $gm_alias, $u_alias) = $self->_WatcherJoin( Name => $type );
800 $self->{"_sql_report_watcher_users_alias_$type"} = $u_alias;
801 }
802 @args{qw(ALIAS FIELD)} = ($u_alias, $column);
803
804 return %args;
805}
806
807sub DurationAsString {
84fb5b46 808 my $self = shift;
af59614d
MKG
809 my %args = @_;
810 my $v = $args{'VALUE'};
811 unless ( ref $v ) {
812 return $self->loc("(no value)") unless defined $v && length $v;
813 return RT::Date->new( $self->CurrentUser )->DurationAsString(
814 $v, Show => 3, Short => 1
815 );
816 }
84fb5b46 817
af59614d
MKG
818 my $date = RT::Date->new( $self->CurrentUser );
819 my %res = %$v;
820 foreach my $e ( values %res ) {
821 $e = $date->DurationAsString( $e, Short => 1, Show => 3 )
822 if defined $e && length $e;
823 $e = $self->loc("(no value)") unless defined $e && length $e;
824 }
825 return \%res;
84fb5b46
MKG
826}
827
af59614d 828sub LabelValueCode {
84fb5b46 829 my $self = shift;
af59614d
MKG
830 my $name = shift;
831
832 my $display = $self->ColumnInfo( $name )->{'META'}{'Display'};
833 return undef unless $display;
834 return $self->FindImplementationCode( $display );
84fb5b46
MKG
835}
836
837
af59614d
MKG
838sub FindImplementationCode {
839 my $self = shift;
840 my $value = shift;
841 my $silent = shift;
84fb5b46 842
af59614d
MKG
843 my $code;
844 unless ( $value ) {
845 $RT::Logger->error("Value is not defined. Should be method name or code reference")
846 unless $silent;
847 return undef;
848 }
849 elsif ( !ref $value ) {
850 $code = $self->can( $value );
851 unless ( $code ) {
852 $RT::Logger->error("No method $value in ". (ref $self || $self) ." class" )
853 unless $silent;
854 return undef;
855 }
856 }
857 elsif ( ref( $value ) eq 'CODE' ) {
858 $code = $value;
859 }
860 else {
861 $RT::Logger->error("$value is not method name or code reference")
862 unless $silent;
863 return undef;
864 }
865 return $code;
866}
84fb5b46 867
af59614d
MKG
868sub Serialize {
869 my $self = shift;
870
871 my %clone = %$self;
872# current user, handle and column_info
873 delete @clone{'user', 'DBIxHandle', 'column_info'};
874 $clone{'items'} = [ map $_->{'values'}, @{ $clone{'items'} || [] } ];
875 $clone{'column_info'} = {};
876 while ( my ($k, $v) = each %{ $self->{'column_info'} } ) {
877 $clone{'column_info'}{$k} = { %$v };
878 delete $clone{'column_info'}{$k}{'META'};
879 }
880 return \%clone;
881}
84fb5b46 882
af59614d 883sub Deserialize {
84fb5b46 884 my $self = shift;
af59614d 885 my $data = shift;
84fb5b46 886
af59614d
MKG
887 $self->CleanSlate;
888 %$self = (%$self, %$data);
84fb5b46 889
af59614d
MKG
890 $self->{'items'} = [
891 map { my $r = $self->NewItem; $r->LoadFromHash( $_ ); $r }
892 @{ $self->{'items'} }
893 ];
894 foreach my $e ( values %{ $self->{column_info} } ) {
895 $e->{'META'} = $e->{'TYPE'} eq 'grouping'
896 ? $GROUPINGS_META{ $e->{'INFO'} }
897 : $STATISTICS_META{ $e->{'INFO'}[1] }
898 }
899}
900
901
902sub FormatTable {
903 my $self = shift;
904 my %columns = @_;
905
906 my (@head, @body, @footer);
907
908 @head = ({ cells => []});
909 foreach my $column ( @{ $columns{'Groups'} } ) {
910 push @{ $head[0]{'cells'} }, { type => 'head', value => $self->Label( $column ) };
911 }
912
913 my $i = 0;
914 while ( my $entry = $self->Next ) {
915 $body[ $i ] = { even => ($i+1)%2, cells => [] };
916 $i++;
917 }
918 @footer = ({ even => ++$i%2, cells => []});
919
920 my $g = 0;
921 foreach my $column ( @{ $columns{'Groups'} } ) {
922 $i = 0;
923 my $last;
924 while ( my $entry = $self->Next ) {
925 my $value = $entry->LabelValue( $column );
926 if ( !$last || $last->{'value'} ne $value ) {
927 push @{ $body[ $i++ ]{'cells'} }, $last = { type => 'label', value => $value };
928 $last->{even} = $g++ % 2
929 unless $column eq $columns{'Groups'}[-1];
930 }
931 else {
932 $i++;
933 $last->{rowspan} = ($last->{rowspan}||1) + 1;
934 }
84fb5b46
MKG
935 }
936 }
af59614d
MKG
937 push @{ $footer[0]{'cells'} }, {
938 type => 'label',
939 value => $self->loc('Total'),
940 colspan => scalar @{ $columns{'Groups'} },
941 };
942
943 my $pick_color = do {
944 my @colors = RT->Config->Get("ChartColors");
945 sub { $colors[ $_[0] % @colors - 1 ] }
946 };
947
948 my $function_count = 0;
949 foreach my $column ( @{ $columns{'Functions'} } ) {
950 $i = 0;
951
952 my $info = $self->ColumnInfo( $column );
953
954 my @subs = ('');
955 if ( $info->{'META'}{'SubValues'} ) {
956 @subs = $self->FindImplementationCode( $info->{'META'}{'SubValues'} )->(
957 $self
958 );
959 }
960
961 my %total;
962 unless ( $info->{'META'}{'NoTotals'} ) {
963 while ( my $entry = $self->Next ) {
964 my $raw = $entry->RawValue( $column ) || {};
965 $raw = { '' => $raw } unless ref $raw;
966 $total{ $_ } += $raw->{ $_ } foreach grep $raw->{$_}, @subs;
967 }
968 @subs = grep $total{$_}, @subs
969 unless $info->{'META'}{'NoHideEmpty'};
970 }
971
972 my $label = $self->Label( $column );
973
974 unless (@subs) {
975 while ( my $entry = $self->Next ) {
976 push @{ $body[ $i++ ]{'cells'} }, {
977 type => 'value',
978 value => undef,
979 query => $entry->Query,
980 };
981 }
982 push @{ $head[0]{'cells'} }, {
983 type => 'head',
984 value => $label,
985 rowspan => scalar @head,
986 color => $pick_color->(++$function_count),
987 };
988 push @{ $footer[0]{'cells'} }, { type => 'value', value => undef };
989 next;
990 }
991
992 if ( @subs > 1 && @head == 1 ) {
993 $_->{rowspan} = 2 foreach @{ $head[0]{'cells'} };
994 }
995
996 if ( @subs == 1 ) {
997 push @{ $head[0]{'cells'} }, {
998 type => 'head',
999 value => $label,
1000 rowspan => scalar @head,
1001 color => $pick_color->(++$function_count),
1002 };
1003 } else {
1004 push @{ $head[0]{'cells'} }, { type => 'head', value => $label, colspan => scalar @subs };
1005 push @{ $head[1]{'cells'} }, { type => 'head', value => $_, color => $pick_color->(++$function_count) }
1006 foreach @subs;
1007 }
1008
1009 while ( my $entry = $self->Next ) {
1010 my $query = $entry->Query;
1011 my $value = $entry->LabelValue( $column ) || {};
1012 $value = { '' => $value } unless ref $value;
1013 foreach my $e ( @subs ) {
1014 push @{ $body[ $i ]{'cells'} }, {
1015 type => 'value',
1016 value => $value->{ $e },
1017 query => $query,
1018 };
1019 }
1020 $i++;
1021 }
1022
1023 unless ( $info->{'META'}{'NoTotals'} ) {
1024 my $total_code = $self->LabelValueCode( $column );
1025 foreach my $e ( @subs ) {
1026 my $total = $total{ $e };
1027 $total = $total_code->( $self, %$info, VALUE => $total )
1028 if $total_code;
1029 push @{ $footer[0]{'cells'} }, { type => 'value', value => $total };
1030 }
1031 }
1032 else {
1033 foreach my $e ( @subs ) {
1034 push @{ $footer[0]{'cells'} }, { type => 'value', value => undef };
1035 }
1036 }
1037 }
1038
1039 return thead => \@head, tbody => \@body, tfoot => \@footer;
84fb5b46
MKG
1040}
1041
1042RT::Base->_ImportOverlays();
1043
10441;