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.