rt-crontool man page

rt-crontool — a tool to act on tickets from an external scheduling tool

Synopsis

# find all active tickets in the queue 'general' and set their priority to 99 if they are overdue:
rt-crontool \
  --search RT::Search::ActiveTicketsInQueue  --search-arg general \
  --condition RT::Condition::Overdue \
  --action RT::Action::SetPriority --action-arg 99 \
  --verbose
# Escalate tickets
  rt-crontool \
    --search RT::Search::ActiveTicketsInQueue  --search-arg general \
    --action RT::Action::EscalatePriority

Description

This script is a tool to act on tickets from an external scheduling tool, such as cron.

Security:

This tool allows the user to run arbitrary perl modules from within RT. If this tool were setgid, a hostile local user could use this tool to gain administrative access to RT. It is incredibly important that nonprivileged users not be allowed to run this tool. It is suggested that you create a non-privileged unix user with the correct group membership and RT access to run this tool.

Options

search
Specify the search module you want to use
search-arg
An argument to pass to --search
condition
Specify the condition module you want to use
condition-arg
An argument to pass to --condition
action
Specify the action module you want to use. This option may be repeated to apply multiple actions to found tickets.
action-arg
An argument to pass to --action. This option may be repeated to pass corresponding arguments to multiple calls of --action.
template
Specify name or id of template(s) you want to use
transaction
Specify if you want to use either 'first', 'last' or 'all' transactions
transaction-type
Specify the comma separated list of transactions' types you want to use
log
Adjust LogToSTDERR config option
verbose
Output status updates to STDOUT

Info

2016-07-28 perl v5.24.0 User Contributed Perl Documentation