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

= Add support for inter-Trac ticket dependencies and summary tickets

== Description

This plugin provides support for ticket dependencies and summary tickets among projects.

=== Why does this plugin provide support for intertrac?

The custom field that the ticket needs is different in each ticket type.
Custom fields that the summary ticket needs and custom fields that a sub-ticket needs are different.

[[Image(TracDependency.png)]]

=== Limitations

 1. Data as follows are on MS-Project side, if you need them:
  * Resource
  * Calendar

== Roadmap

 1. Extend XMLRPC plugin suitable to this plugin and VisualBasicTracConnectorIntegration.
 1. Import/update tickets from MS-Project.
 1. When ticket's status is changed, add comment to dependency tickets. 
 1. Edit custom fields' change time for creating burndown chart in Excel.

== Bugs/Feature Requests

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

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

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

あまりテストしていませんので、何かあれば報告してください。

== Download

Download the zipped source from [export:tracdependencyplugin here].

== Source

You can check out TracDependencyPlugin from [/svn/tracdependencyplugin here] using Subversion, or [source:tracdependencyplugin browse the source] with Trac.

== Installation and Configuration

 1. Create an egg:
{{{#!sh
$ tracdependencyplugin\0.11>python setup.py bdist_egg
}}}
 1. Install the egg file.
 1. Add InterTrac settings to your `trac.ini` file:
{{{#!ini
[intertrac]
test1.title = Test 1
test1.url = http://192.168.1.13/trac/Test1
test2.title = Test 2
test2.url = http://192.168.1.13/trac/Test2
}}}
 1. Add Trac Dependency settings to your `trac.ini` file:
{{{#!ini
[tracdependency]
label = Test1
}}}
 1. Add extended InterTrac settings to your `trac.ini` file:
{{{#!ini
[intertrac]
test1.label = Test1
test1.path = C:\TracLight\projects\trac\Test1
test1.title = Test 1
test1.url = http://192.168.1.13/trac/Test1
test2.label = Test2
test2.path = C:\TracLight\projects\trac\Test2
test2.title = Test 2
test2.url = http://192.168.1.13/trac/Test2
}}}
 1. Add custom fields to your `trac.ini` file:
{{{#!ini
[ticket-custom]
due_assign = text
due_assign.label = Start
due_assign.order = 1
due_close = text
due_close.label = Finish
due_close.order = 2
complete = text
complete.label = Complete
complete.order = 3
baseline_start = text
baseline_start.label = Baseline Start
baseline_start.order = 4
baseline_finish = text
baseline_finish.label = Baseline Finish
baseline_finish.order = 5
# for TracDependencyPlugin
summary_ticket = text
summary_ticket.label = Summary Ticket
summary_ticket.order = 6
dependencies = text
dependencies.label = Preceding Tickets
dependencies.order = 7
}}}
 1. Enable this plugin in your `trac.ini` file:
{{{#!ini
[components]
tracdependency.* = enabled
}}}

== Screenshots

'''Imported Gantt chart from Trac'''

Suppose there are the following dependencies and outline in an MS-Project plan that has 3 tickets:

[[Image(TicketDepGantt.png)]]

Please see the [VisualBasicTracConnectorIntegration#MS-Projectconnector MS-Project connector plugin].

With this plugin, these tickets would be managed and shown as follows:

'''Test1:#1''': the overarching ticket has two sub-tickets: 

[[Image(t1-1.png)]]

'''Test2:#1''': the first sub-ticket has no dependency other than its parent Test1:

[[Image(t2-1.png)]]

'''Test2:#2''': the second sub-ticket has both a parent Test1 and a dependency of sub-ticket Test2:#1:

[[Image(t2-2.png)]]

'''Dependencies page of Test2:#1'''

[[Image(t2-1-dep.png)]]

'''InterTrac setting admin page'''

[[Image(InterTracSetting.png)]]

== Recent Changes

[[ChangeLog(tracdependencyplugin, 3)]]

== Author/Contributors

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