Working with Project Views

Reading Specific Gantt Chart View Data

Gantt charts provide a graphical representation of project plans. Sometimes it is necessary to read particular data associated with a Gantt chart view such as the bar-style information, gridline properties, progress lines properties and time scale information. Aspose.Tasks for Java API provides the capability to access all the properties individually using the GanttChartView class that inherits from View. This feature is supported for Microsoft Project 2003, 2007, 2010, 2013, 2016 and 2019 MPP file formats.

// For complete examples and data files, please go to https://github.com/aspose-tasks/Aspose.Tasks-for-Java
// The path to the documents directory.
String dataDir = Utils.getDataDir(ReadSpecificGanttChartData.class);
Project project = new Project(dataDir + "Project2003.mpp");
GanttChartView view = (GanttChartView) project.getViews().toList().get(1);
System.out.println("View.BarRounding: " + view.getBarRounding());
System.out.println("view.ShowBarSplits: " + view.getShowBarSplits());
System.out.println("view.ShowDrawings: " + view.getShowDrawings());
System.out.println("view.RollUpGanttBars: " + view.getRollUpGanttBars());
System.out.println("view.HideRollupBarsWhenSummaryExpanded: " + view.getHideRollupBarsWhenSummaryExpanded());
System.out.println("view.BarSize: " + view.getBarSize());
System.out.println("view.BarStyles count: " + view.getBarStyles().size());

int i = 0;
for (GanttBarStyle barStyle : view.getBarStyles()) {
    System.out.println(barStylesNames[i] + ": " + barStyle.getName());
    System.out.println(barStylesShowFor[i] + ":" + barStyle.getShowFor());
    System.out.println(barStylesFrom[i] + ":" + barStyle.getFrom());
    System.out.println(barStylesTo[i] + ":" + barStyle.getTo());
    System.out.println(barStylesMiddleShape[i] + ":" + barStyle.getMiddleShape());
    System.out.println(barStylesMiddleColor[i] + ":" + barStyle.getMiddleShapeColor());
    System.out.println(barStylesStartShape[i] + ":" + barStyle.getStartShape());
    System.out.println(barStylesEndShape[i] + ":" + barStyle.getEndShape());
    System.out.println(barStylesEndShapeColor[i] + ":" + barStyle.getEndShapeColor());
    i++;
}

System.out.println("Gridlines count: " + view.getGridlines().size());
Gridlines gridlines = view.getGridlines().get(0);

System.out.println("Gridlines.Type: " + gridlines.getType());
System.out.println("Gridlines interval: " + gridlines.getInterval());
System.out.println("Gridlines.NormalColor: " + gridlines.getNormalColor());
System.out.println("Gridlines.NormalPattern: " + gridlines.getNormalPattern());
System.out.println("Gridlines.IntervalPattern: " + gridlines.getIntervalPattern());
System.out.println("Gridlines.IntervalColor: " + gridlines.getIntervalColor());

System.out.println("View Text Styles: " + view.getTextStyles());

System.out.println("ProgressLInes.BeginAtDate: " + view.getProgressLines().getBeginAtDate().toString());
System.out.println("ProgressLines.isBaselinePlan: " + view.getProgressLines().isBaselinePlan());
System.out.println("ProgressLines.DisplaySelected: " + view.getProgressLines().getDisplaySelected());
System.out.println("ProgressLines.SelectedDates.Count: " + view.getProgressLines().getSelectedDates().size());

System.out.println("ProgressLines.DisplayAtRecurringIntervals: "
        + view.getProgressLines().getDisplayAtRecurringIntervals());
System.out.println("ProgressLines.RecurringInterval.Interval: "
        + view.getProgressLines().getRecurringInterval().getInterval());
System.out.println("ProgressLines.RecurringInterval.WeeklyDays.Count"
        + view.getProgressLines().getRecurringInterval().getWeeklyDays().size());
System.out.println("RecurringInterval.DayType.Friday: "
        + (int) view.getProgressLines().getRecurringInterval().getWeeklyDays().get(1));
System.out.println("RecurringInterval.DayType.Saturday: "
        + (int) view.getProgressLines().getRecurringInterval().getWeeklyDays().get(2));
System.out.println("RecurringInterval.DayType.Sunday: "
        + (int) view.getProgressLines().getRecurringInterval().getWeeklyDays().get(0));

System.out.println("ProgressLines.ShowDate" + view.getProgressLines().getShowDate());

System.out.println("ProgressLines.ProgressPointShape: " + view.getProgressLines().getProgressPointShape());
System.out.println("ProgressLines.ProgressPointColor: " + view.getProgressLines().getProgressPointColor());
System.out.println("ProgressLines.LineColor: " + view.getProgressLines().getLineColor());
System.out.println("ProgressLines.LinePattern" + view.getProgressLines().getLinePattern());

System.out.println(
        "ProgressLines.OtherProgressPointShape: " + view.getProgressLines().getOtherProgressPointShape());
System.out.println("ProgressLines.OtherProgressPointColor: "
        + view.getProgressLines().getOtherProgressPointColor().toString());
System.out.println("ProgressLines.OtherLineColor: " + view.getProgressLines().getOtherLineColor());

System.out.println("BottomTimescaleTier" + view.getBottomTimescaleTier());

System.out.println("BottomTimescaleTier.Count: " + view.getBottomTimescaleTier().getCount());
System.out.println("BottomTimescaleTier.Unit: " + view.getBottomTimescaleTier().getUnit());
System.out.println("BottomTimescaleTier.UsesFiscalYear: " + view.getBottomTimescaleTier().getUsesFiscalYear());
System.out.println("BottomTimescaleTier.Alignment: " + view.getBottomTimescaleTier().getAlignment());
System.out.println("BottomTimescaleTier.ShowTicks: " + view.getBottomTimescaleTier().getShowTicks());
System.out.println("BottomTimescaleTier.Label: " + view.getBottomTimescaleTier().getLabel());

System.out.println("MiddleTimescaleTier.Count: " + view.getMiddleTimescaleTier().getCount());
System.out.println("TimescaleUnit.Weeks: " + view.getMiddleTimescaleTier().getUnit());
System.out.println("MiddleTimescaleTier.Alignment: " + view.getMiddleTimescaleTier().getAlignment());
System.out.println("MiddleTimescaleTier.ShowTicks: " + view.getMiddleTimescaleTier().getShowTicks());
System.out.println("MiddleTimescaleTier.Label: " + view.getMiddleTimescaleTier().getLabel());

System.out.println("TopTimescaleTier.Unit: " + view.getTopTimescaleTier().getUnit());
System.out.println("TopTimescaleTier.UsesFiscalYear: " + view.getTopTimescaleTier().getUsesFiscalYear());
System.out.println("TopTimescaleTier.Alignment: " + view.getTopTimescaleTier().getAlignment());
System.out.println("TopTimescaleTier.ShowTicks: " + view.getTopTimescaleTier().getShowTicks());
System.out.println("TopTimescaleTier.Label" + view.getTopTimescaleTier().getLabel());

Configure Gantt Chart View by Showing Selected Custom Fields

Extended attributes added to a project may be assigned to a task and it is often desirable to add custom fields to the default view of an MPP file, or you might want selected custom fields to be shown automatically rather than selected manually. This article describes how to achieve this by customizing a Project’s table.

The code below shows how to configure a Gantt chart view with custom fields.

// The path to the documents directory.
String dataDir = Utils.getDataDir(ConfigureGanttChartView.class);

Project project = new Project(dataDir + "New project 2010.mpp");

// Create a new project task
Task task = project.getRootTask().getChildren().add("New Activity");

// Define new custom attribute
ExtendedAttributeDefinition text1Definition = ExtendedAttributeDefinition.createTaskDefinition(ExtendedAttributeTask.Text1, null);
project.getExtendedAttributes().add(text1Definition);
// Add custom text attribute to created task.
task.getExtendedAttributes().add(text1Definition.createExtendedAttribute("Activity attribute"));

// Customize table by adding text attribute field
TableField attrField = new TableField();
attrField.setField(Field.TaskText1);
attrField.setWidth(20);
attrField.setTitle("Custom attribute");
attrField.setAlignTitle(StringAlignment.Center);
attrField.setAlignData(StringAlignment.Center);

Table table = project.getTables().toList().get(0);
table.getTableFields().add(3, attrField);

// The result of opening of saved project in MSP2010 is in attached screenshot
project.save("saved.mpp", SaveFileFormat.MPP);

Customize Timescale Tier Labels according to Local Culture

Aspose.Tasks for Java API can be used to customer timescale tier labels according to local culture information.

// For complete examples and data files, please go to https://github.com/aspose-tasks/Aspose.Tasks-for-Java
// The path to the documents directory.
String dataDir = Utils.getDataDir(DefaultProjectProperties.class);
Project project = new Project(dataDir + "New Project 2007.mpp");

project.getTaskLinks().add(project.getRootTask().getChildren()
        .add("Task 1"), project.getRootTask().getChildren()
        .add("Task 2"));

GanttChartView view = (GanttChartView)project.getDefaultView();
view.getMiddleTimescaleTier().setUnit(TimescaleUnit.Months);
project.set(Prj.TIMESCALE_START, new Date(112, 7, 6));

view.getMiddleTimescaleTier().setDateTimeConverter( new DateTimeConverter() {
          public String invoke(java.util.Date date)
        {
              Calendar cal = Calendar.getInstance();
              cal.setTime(date);
              int month = cal.get(Calendar.MONTH);
            return new String[] { "Jan.", "Feb.", "Mar.", "Apr.","May.", "Jun.", "July.","Aug.", "Sep.", "Oct.", "Nov.", "Dec." }[month];
        }
        });

project.save("saved.pdf", SaveFileFormat.PDF);

Setting TimeScale Count for Project

The TimeScaleTier class makes it possible to set the time scale count information for a Project. This topic shows how to achieve this objective using Aspose.Tasks for Java API.

The code below shows how to set the time scale count.

// For complete examples and data files, please go to https://github.com/aspose-tasks/Aspose.Tasks-for-Java
// The path to the documents directory.
String dataDir = Utils.getDataDir(SetTimeScaleCount.class);

Project project = new Project();
GanttChartView view = new GanttChartView();

view.getBottomTimescaleTier().setCount(2);
view.getBottomTimescaleTier().setShowTicks(false);

view.getMiddleTimescaleTier().setCount(2);
view.getMiddleTimescaleTier().setShowTicks(false);

project.getViews().add(view);

// Add some test data to project
Task task1 = project.getRootTask().getChildren().add("Task 1");
Task task2 = project.getRootTask().getChildren().add("Task 2");
task1.set(Tsk.DURATION, task1.getParentProject().getDuration(24, TimeUnitType.Hour));
task2.set(Tsk.DURATION, task1.getParentProject().getDuration(40, TimeUnitType.Hour));

project.save(dataDir + "temp.pdf", SaveFileFormat.PDF); // Result is in
// attached
// screenshot