NAME

RT::Condition::NotStartedInBusinessHours - Check for unstarted tickets within business hours

DESCRIPTION

This RT condition will check for tickets which are not started within business hours.

SYNOPSIS

CLI

    rt-crontool
        --search RT::Search::ModuleName
        --search-arg 'The Search Argument'
        --condition RT::Condition::NotStartedInBusinessHours
        --condition-arg 'The Condition Argument'
        --action RT::Action:ActionModule
        --template 'Template Name or ID'

INSTALLATION

This condition based on the following modules:

    RT >= 4.0.0
    Date::Manip >= 6.34

To install this condition run the following commands:

    perl Makefile.PL
    make
    make test
    make install

or place this script under

    $RT_HOME/local/lib/RT/Condition/

where $RT_HOME is the path to your RT installation, for example /opt/rt4.

You may additionally make this condition available in RT's web UI as a Scrip Condition:

    make initdb

Another way to install the latest release is via CPAN:

    cpan RT::Condition::NotStartedInBusinessHours
    $RT_HOME/sbin/rt-setup-database --action insert --datafile /opt/rt4/local/plugins/RT-Condition-NotStartedInBusinessHours/etc/initialdata

The second command is equivalent to make initdb, but is unfortunately not executed automatically.

CONFIGURATION

RT SITE CONFIGURATION

To enabled this condition edit the RT site configuration located under $RT_HOME/etc/RT_SiteConfig.pm:

    Set(@Plugins,qw(RT::Condition::NotStartedInBusinessHours));

To change the standard behavior of Date::Manip you may add to the site configuration:

    Set(%DateManipConfig, (
        'WorkDayBeg', '9:00',
        'WorkDayEnd', '17:00', 
        #'WorkDay24Hr', '0',
        'WorkWeekBeg', '1',
        'WorkWeekEnd', '5'
    ));

For more information see http://search.cpan.org/~sbeck/Date-Manip-6.34/lib/Date/Manip/Config.pod#BUSINESS_CONFIGURATION_VARIABLES.

CONDITION ARGUMENT

This condition needs exactly 1 argument to work.

    --condition RT::Condition::NotStartedInBusinessHours 
    --condition-arg 1

1 is the time in hours for escalation.

EXAMPLE CRON JOB

    rt-crontool 
        --search RT::Search::FromSQL 
        --search-arg "Queue = 'General' AND ( Status = 'new' ) AND Owner = 'Nobody'" 
        --condition RT::Condition::NotStartedInBusinessHours 
        --condition-arg 1 
        --action RT::Action::RecordComment 
        --template 'Unowned tickets'

AUTHOR

Benjamin Heisig, <bheisig@synetics.de>

SUPPORT AND DOCUMENTATION

You can find documentation for this module with the perldoc command.

    perldoc RT::Condition::NotStartedInBusinessHours

You can also look for information at:

Search CPAN

http://search.cpan.org/dist/RT-Condition-NotStartedInBusinessHours/

RT: CPAN's request tracker

http://rt.cpan.org/NoAuth/Bugs.html?Dist=RT-Condition-NotStartedInBusinessHours

AnnoCPAN: Annotated CPAN documentation

http://annocpan.org/dist/RT-Condition-NotStartedInBusinessHours

CPAN Ratings

http://cpanratings.perl.org/d/RT-Condition-NotStartedInBusinessHours

Repository

https://github.com/bheisig/rt-condition-notstartedinbusinesshours

BUGS

Please report any bugs or feature requests to the author.

ACKNOWLEDGEMENTS

This script is a fork from RT::Condition::UntouchedInBusinessHours written by Torsten Brumm.

COPYRIGHT AND LICENSE

Copyright 2012 synetics GmbH, <http://i-doit.org/>

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

Request Tracker (RT) is Copyright Best Practical Solutions, LLC.

SEE ALSO

    RT
    Date::Manip

cpanm RT::Condition::NotStartedInBusinessHours

perl -MCPAN -e shell
install RT::Condition::NotStartedInBusinessHours