NAME

       RT-Extension-ElapsedBusinessTime - Calculate the elapsed business time that tickets are open

DESCRIPTION

       This extension provides for new colummns in reports that display the elapsed business time that a ticket
       has been open. Various items are configurable to define what constitutes a business day.

RT VERSION

       Works with RT 4.4.x and RT 5.0.x.

INSTALLATION

       "perl Makefile.PL"
       "make"
       "make install"
           May need root permissions

       Edit your /opt/rt4/etc/RT_SiteConfig.pm
           Add this line:

               Plugin('RT::Extension::ElapsedBusinessTime');

       Clear your mason cache
               rm -rf /opt/rt4/var/mason_data/obj

       Restart your webserver

CONFIGURATION

       The available configuration options, with their defaults are given here.

           Set( %ElapsedBusinessTime,
               Start   => '08:30',
               End     => '17:30',
               Country => undef,
               Region  => undef,
               'Exclude Days'   => [6, 7],
               'Exclude States' => ['stalled', 'blocked', 'resolved', 'rejected', 'deleted'],
           );

       Options are:

       Start
           The start of the business day.

       End The end of the business day.

       Country
           A  country  for which there is a Date::Holidays module which describes the holidays for that country.
           If there isn't one, please consider writing one!  For example 'NZ' for New Zealand.

       Region
           Some country  modules  for  Date::Holidays  include  regions  for  regional  holidays.   For  example
           'Wellington' within New Zealand for Wellington Anniversary Day.

       Excluded Days
           Days  which  should  not be considered working days. The day numbers are from DateTime. For reference
           they are:

               1: Monday
               2: Tuesday
               3: Wednesday
               4: Thursday
               5: Friday
               6: Saturday
               7: Sunday

       Excluded States
           Which a ticket is in one of these states, then it is considered inactive and the counter stops.  This
           is  to  allow  when  a  ticket is waiting on a customers feedback, and for some businesses, that time
           shouldn't be added to their ticket duration time.

DISPLAY COLUMNS

       There are three display columns which this extension adds, which all show the same information,  just  in
       different formats:

       ElapsedBussinessHours
       ElapsedBussinessMinutes
       ElapsedBussinessTime

AUTHOR

       Andrew Ruthven, Catalyst Cloud Ltd <puck@catalystcloud.nz>

LICENSE AND COPYRIGHT

       This software is Copyright (c) 2019-2020 by Catalyst Cloud Ltd

       This is free software, licensed under:

         The GNU General Public License, Version 2, June 1991

perl v5.36.0                                       2023-09-26             RT::Extension::...sedBusinessTime(3pm)