/**
 * Get the history of all project time lines and their iterations.
 *
 * @param project : The project to get the time lines of.
 * @return True if successfull
 */
@SuppressWarnings("unchecked")
public boolean getTimeLineHistory(IProjectArea project) {
    boolean result = false;
    IProgressMonitor monitor = null;
   
    try {
        // get all time lines
        IDevelopmentLineHandle[] timeLines = project.getDevelopmentLines();
       
        for (IDevelopmentLineHandle timeLine : timeLines) {
            try {
                // get the history of the time line
                List<IDevelopmentLine> history = this.teamRepository.itemManager().fetchAllStateHandles(timeLine, monitor);
                history = this.teamRepository.itemManager().fetchCompleteStates(history, monitor); // the time lines in the list are random
               
                for (IDevelopmentLine preLine : history) {
                    ArrayList<String> preState = new ArrayList<String>();

                    // predecessor state of the time line
                    // ID
                    preState.add(preLine.getId());
                    // name
                    preState.add(preLine.getName());
                    // modified date
                    preState.add(DateFormater.format(preLine.modified())); // use any DateFormat.format() to get the String of the date
                   
                    // modified by contributor
                    IContributor modifier = (IContributor) this.teamRepository.itemManager().fetchCompleteItem(preLine.getModifiedBy(), 0, monitor);
                    preState.add(modifier.getUserId());
                   
                    // start date
                    if (preLine.getStartDate() != null) {
                        preState.add(DateFormat.format(preLine.getStartDate())); // use any DateFormat.format() to get the String of the date
                    } else {
                        preState.add("");
                    }
                    // end date
                    if (preLine.getEndDate() != null) {
                        preState.add(DateFormat.format(preLine.getEndDate())); // use any DateFormat.format() to get the String of the date
                    } else {
                        preState.add("");
                    }
                   
                    // child iterations
                    String iterations = "";
                    for (IIterationHandle iteration : preLine.getIterations()) {
                        IIteration iter = (IIteration) this.teamRepository.itemManager().fetchCompleteItem(iteration, 0, monitor);
                        iterations = iterations + iter.getName() + ",";
                    }
                    preState.add(iterations);
                   
                    // is archived?
                    String archived = preLine.isArchived() == true ? "archived" : "";
                    preState.add(archived);
                   
                    //
                    // Do anything with the values in the ArrayList 'preState'
                    //
                }
               
                // get the state history of the iterations
                IIterationHandle[] iterations = (IIterationHandle[])
                                                ((IDevelopmentLine)
                                                this.teamRepository.itemManager().fetchCompleteItem(timeLine, 0, monitor))
                                                .getIterations();
               
               
                for (IIterationHandle iteration : iterations) {
                    getIterationHistory(iteration, monitor);
                }
            } catch (TeamRepositoryException e) {
                e.getMessage();
            } catch (Exception e) {
                e.getMessage();
            }
        }
       
        result = true;
    } catch (Exception e) {
        e.getMessage();
    }
   
    return result;
}

/**
 * Get the history states of the iteration.
 *
 * @param iteration : The iteration to get the history states of.
 * @param monitor : The IProgressMonitor to work with.
 */
@SuppressWarnings("unchecked")
private void getIterationHistory(IIterationHandle iteration, IProgressMonitor monitor) {
   
    try {
        // get the history of the iteration
        List<IIteration> history = this.teamRepository.itemManager().fetchAllStateHandles(iteration, monitor);
        history = this.teamRepository.itemManager().fetchCompleteStates(history, monitor); // the iterations in the list are random
       
        for (IIteration preIteration : history) {
            ArrayList<String> preState = new ArrayList<String>();
           
            // predecessor state of the iteration
            // ID
            preState.add(preIteration.getId());
            // name
            preState.add(preIteration.getName());
            // modified date
            preState.add(DateFormater.format(preIteration.modified())); // use any DateFormat.format() to get the String of the date
           
            // modified by contributor
            IContributor modifier = (IContributor) this.teamRepository.itemManager().fetchCompleteItem(preIteration.getModifiedBy(), 0, monitor);
            preState.add(modifier.getUserId());
           
            // start
            if (preIteration.getStartDate() != null) {
                preState.add(DateFormater.format(preIteration.getStartDate())); // use any DateFormat.format() to get the String of the date
            } else {
                preState.add("");
            }
            // end
            if (preIteration.getEndDate() != null) {
                preState.add(DateFormater.format(preIteration.getEndDate())); // use any DateFormat.format() to get the String of the date
            } else {
                preState.add("");
            }
           
            // child iteration
            String children = "";
            for (IIterationHandle child : preIteration.getChildren()) {
                IIteration iter = (IIteration) this.teamRepository.itemManager().fetchCompleteItem(child, 0, monitor);
                children = children + iter.getName() + ",";
            }
            preState.add(children);
           
            // is archived?
            String archived = preIteration.isArchived() == true ? "archived" : "";
            preState.add(archived);
           
            //
            // Do anything with the values in the ArrayList 'preState'
            //
        }
       
        // get the state history of the child iterations
        IIterationHandle[] children = (IIterationHandle[])
                                        ((IIteration)
                                        this.teamRepository.itemManager().fetchCompleteItem(iteration, 0, monitor))
                                        .getChildren();
       
        for (IIterationHandle child : children) {
            getIterationHistory(child, monitor);
        }
    } catch (TeamRepositoryException e) {
        e.getMessage();
    }
}