[[PageOutline(2-5,Contents,pullout)]]

= Scheduled workflow

== Description

This plugin provides a new subcommand for `trac-admin` that makes it easy to automatically transition tickets after a certain period of time.

The new `trac-admin` subcommand is `transition`, and you can run it with either `check` (to see what's affected) or `do` (to carry out a transition).

{{{
Trac [/srv/trac]> transition check new 14
13: rotate does not work losslessly with png files (new)
Trac [/srv/trac]> transition do new idle 14 robot "ticket has been new for two weeks; auto-transitioning to idle"
Trac [/srv/trac]>
}}}

You might want to consider invoking it from a cronjob.

== Bugs/Feature Requests

Existing bugs and feature requests for ScheduledWorkflowPlugin are 
[report:9?COMPONENT=ScheduledWorkflowPlugin here].

If you have any issues, create a 
[/newticket?component=ScheduledWorkflowPlugin new ticket].

[[TicketQuery(component=ScheduledWorkflowPlugin&group=type,format=progress)]]

== Download

Download the zipped source from [download:scheduledworkflowplugin here].

== Source

You can check out ScheduledWorkflowPlugin from [http://trac-hacks.org/svn/scheduledworkflowplugin here] using Subversion, or [source:scheduledworkflowplugin browse the source] with Trac.

== Example

Add the following to your crontab:

{{{
0 0 * * * trac-admin /srv/tracenv transition do new idle 14 automatic "This ticket has been new for 2 weeks; marking as idle."
}}}

== Recent Changes

[[ChangeLog(scheduledworkflowplugin, 3)]]

== Author/Contributors

'''Author:''' [wiki:dkgdkg] [[BR]]
'''Maintainer:''' [[Maintainer]] [[BR]]
'''Contributors:'''