NAME
RT::Extension::SummaryByUser - portlets to show ticket counters per user
DESCRIPTION
This extension ships with OwnerSummary and RequestorSummary portlets you
can use in a dashboard and/or RT at glance. Summary can be displayed not
only by user, but by users' organization or other fields. For example
RequestorSummary portlet displays summary by requestors' organization.
Read more about this below in "CONFIGURATION" section.
VERSION
This module works on RT 3.8 with patches (see below) or on RT 4.0. It is
not currently compatible with RT 4.2.
INSTALLATION
Installation goes as usual for RT extensions, but for older RT versions
you have to apply patches. For more correct results and work without
errors in any version prior to RT 3.8.5 you must apply patches that are
shipped with this distribution in the patches directory. First of all
apply RT-3.8.4-chart-improvements.patch then
RT-3.8-use_distinct_count_for_charts_when_required-2.patch. Also,
DBIx::SearchBuilder has been updated as well, and you need 1.56 or
newer.
CONFIGURATION
Don't forget to register plugin in the @Plugins config option.
To make a OwnerSummary or RequestorSummary available in the Web UI you
must register it in the RT config using $HomepageComponents option. Once
a portlet is registered in $HomepageComponents it can be added to your
homepage using the Edit link on RT at a Glance, or added to a Dashboard.
More portlets can be created using this extension. Look into the
RequestorSummary file, it just calls OwnerSummary with arguments:
<%INIT>
return $m->comp( 'OwnerSummary', Role => 'Requestor', Field => 'Organization' );
</%INIT>
As you can see there is two arguments: 'Role' and 'Field'. Role can be
'Owner', 'Creator', 'Requestor', 'Cc' and 'AdminCc'. Field can be any
column from Users table or empty. The following fields make sence:
'Organization', 'Country', 'State' or 'City'. Empty value means that the
report is groupped by particular users.
You can copy this file into local/html/Elements directory with different
name, for example with RequestorCountrySummary, change arguments,
register the new portlet in $HomepageComponents, restart server and use
new portlet.
REPOSITORY
http://github.com/ruz/RT-Extension-SummaryByUser
AUTHOR
Ruslan Zakirov <Ruslan.Zakirov@gmail.com>
Kevin Falcone <falcone@bestpractical.com>
LICENSE
Under the same terms as perl itself.