Changes between Version 5 and Version 6 of 1.1/TracWorkflow

Timestamp:

Dec 5, 2014, 2:45:18 AM (9 years ago)

Author:

Ryan J Ollos

Comment:

Document ticket create actions. Refs #2045.

1.1/TracWorkflow

@@ -2 +2 @@
 [[TracGuideToc]]
 
-The Trac issue database provides a configurable workflow.
+The Trac ticket workflow is configurable.
 
 == The Default Ticket Workflow ==
@@ -14 +14 @@
 leave.operations = leave_status
 leave.default = 1
+
+create = <none> -> new
+create.default = 1
+
+create_and_assign = <none> -> assigned
+create_and_assign.label = assign
+create_and_assign.permissions = TICKET_MODIFY
+create_and_assign.operations = may_set_owner
+
 accept = new,assigned,accepted,reopened -> accepted
 accept.permissions = TICKET_MODIFY
 accept.operations = set_owner_to_self
+
 resolve = new,assigned,accepted,reopened -> closed
 resolve.permissions = TICKET_MODIFY
 resolve.operations = set_resolution
+
 reassign = new,assigned,accepted,reopened -> assigned
 reassign.permissions = TICKET_MODIFY
 reassign.operations = set_owner
+
 reopen = closed -> reopened
 reopen.permissions = TICKET_CREATE
@@ -36 +48 @@
 == Basic Ticket Workflow Customization ==
 
-Note: Ticket "statuses" or "states" are not separately defined. The states a ticket can be in are automatically generated by the transitions defined in a workflow. Therefore, creating a new ticket state simply requires defining a state transition in the workflow that starts or ends with that state.
+Note: Ticket "statuses" or "states" are not separately defined. The ticket states are automatically generated by the transitions defined in a workflow. Therefore, creating a new ticket state simply requires defining a state transition in the workflow that starts or ends with that state.
 
 Create a `[ticket-workflow]` section in `trac.ini`.
@@ -87 +99 @@
 If not specified for an action, `.default` is 0.  The value may be negative.
 
+The ticket create actions are specified by a transition from the special `<none>` state. At least one create action must be available to the user in order for tickets to be created. The create actions defined in the default workflow are:
+{{{#!ini
+create = <none> -> new
+create.default = 1
+
+create_and_assign = <none> -> assigned
+create_and_assign.label = assign
+create_and_assign.permissions = TICKET_MODIFY
+create_and_assign.operations = may_set_owner
+}}}
+
+
 There are a couple of hard-coded constraints to the workflow.  In particular, tickets are created with status `new`, and tickets are expected to have a `closed` state.  Further, the default reports/queries treat any state other than `closed` as an open state.
 
@@ -165 +189 @@
 {{{
 [ticket-workflow]
+create = <none> -> new
+create.default = 1
+create_and_assign = <none> -> assigned
+create_and_assign.label = assign
+create_and_assign.permissions = TICKET_MODIFY
+create_and_assign.operations = may_set_owner
 accept = new,reviewing -> assigned
 accept.operations = set_owner_to_self