.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "RT::Extension::ElapsedBusinessTime 3pm"
.TH RT::Extension::ElapsedBusinessTime 3pm "2023-03-05" "perl v5.36.0" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
RT\-Extension\-ElapsedBusinessTime \- Calculate the elapsed business time that tickets are open
.SH "DESCRIPTION"
.IX Header "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.
.SH "RT VERSION"
.IX Header "RT VERSION"
Works with \s-1RT 4.4\s0.x and \s-1RT 5.0\s0.x.
.SH "INSTALLATION"
.IX Header "INSTALLATION"
.ie n .IP """perl Makefile.PL""" 4
.el .IP "\f(CWperl Makefile.PL\fR" 4
.IX Item "perl Makefile.PL"
.PD 0
.ie n .IP """make""" 4
.el .IP "\f(CWmake\fR" 4
.IX Item "make"
.ie n .IP """make install""" 4
.el .IP "\f(CWmake install\fR" 4
.IX Item "make install"
.PD
May need root permissions
.IP "Edit your \fI/opt/rt4/etc/RT_SiteConfig.pm\fR" 4
.IX Item "Edit your /opt/rt4/etc/RT_SiteConfig.pm"
Add this line:
.Sp
.Vb 1
\&    Plugin(\*(AqRT::Extension::ElapsedBusinessTime\*(Aq);
.Ve
.IP "Clear your mason cache" 4
.IX Item "Clear your mason cache"
.Vb 1
\&    rm \-rf /opt/rt4/var/mason_data/obj
.Ve
.IP "Restart your webserver" 4
.IX Item "Restart your webserver"
.SH "CONFIGURATION"
.IX Header "CONFIGURATION"
The available configuration options, with their defaults are given here.
.PP
.Vb 8
\&    Set( %ElapsedBusinessTime,
\&        Start   => \*(Aq08:30\*(Aq,
\&        End     => \*(Aq17:30\*(Aq,
\&        Country => undef,
\&        Region  => undef,
\&        \*(AqExclude Days\*(Aq   => [6, 7],
\&        \*(AqExclude States\*(Aq => [\*(Aqstalled\*(Aq, \*(Aqblocked\*(Aq, \*(Aqresolved\*(Aq, \*(Aqrejected\*(Aq, \*(Aqdeleted\*(Aq],
\&    );
.Ve
.PP
Options are:
.IP "Start" 4
.IX Item "Start"
The start of the business day.
.IP "End" 4
.IX Item "End"
The end of the business day.
.IP "Country" 4
.IX Item "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 '\s-1NZ\s0' for New Zealand.
.IP "Region" 4
.IX Item "Region"
Some country modules for Date::Holidays include regions for regional holidays.
For example 'Wellington' within New Zealand for Wellington Anniversary Day.
.IP "Excluded Days" 4
.IX Item "Excluded Days"
Days which should not be considered working days. The day numbers are from
DateTime. For reference they are:
.Sp
.Vb 7
\&    1: Monday
\&    2: Tuesday
\&    3: Wednesday
\&    4: Thursday
\&    5: Friday
\&    6: Saturday
\&    7: Sunday
.Ve
.IP "Excluded States" 4
.IX Item "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.
.SH "DISPLAY COLUMNS"
.IX Header "DISPLAY COLUMNS"
There are three display columns which this extension adds, which all show
the same information, just in different formats:
.IP "ElapsedBussinessHours" 4
.IX Item "ElapsedBussinessHours"
.PD 0
.IP "ElapsedBussinessMinutes" 4
.IX Item "ElapsedBussinessMinutes"
.IP "ElapsedBussinessTime" 4
.IX Item "ElapsedBussinessTime"
.PD
.SH "AUTHOR"
.IX Header "AUTHOR"
Andrew Ruthven, Catalyst Cloud Ltd <puck@catalystcloud.nz>
.SH "LICENSE AND COPYRIGHT"
.IX Header "LICENSE AND COPYRIGHT"
This software is Copyright (c) 2019\-2020 by Catalyst Cloud Ltd
.PP
This is free software, licensed under:
.PP
.Vb 1
\&  The GNU General Public License, Version 2, June 1991
.Ve