렌더링 된 간트 차트 이미지에 여러 열을 표시합니다

개요

Microsoft 프로젝트에서 프로젝트 데이터는 텍스트 형식과 그래픽으로 차트로 표시 될 수 있습니다. 가장 일반적인 차트 유형에는 Gantt 차트, 작업 사용 및 리소스 사용이 포함됩니다. aspose.net의 tasks는 렌더링 프로젝트 데이터를 그래픽 차트로 지원합니다.

이 기사에서는 Gantt 차트에 표시된 프로젝트 열을 사용자 정의하기위한 두 가지 방법을 설명하고 차트를 이미지로 렌더링하는 방법을 보여줍니다.

간트 차트

Gantt 차트는 프로젝트 작업의 타임 라인 기반 그래픽 표현으로, 며칠, 몇 주 또는 몇 달으로 분류됩니다. 프로젝트는 일반적으로 리소스에 할당 된 작업으로 구성됩니다. 개별 작업은 하위 작업으로 나눌 수 있습니다. 각 작업에는 지속 시간을 정의하는 시작 및 종료 날짜가 있습니다. Microsoft Project의 Gantt 차트는이 정보에 대한 시각적 개요를 제공합니다.

다음 스크린 샷은 Microsoft Project의 일반적인 Gantt 차트를 보여줍니다.

aspose.tasks in gantt 차트 이미지 .net

aspose.tasks. 프로젝트 데이터를 다양한 형식으로 내보내기 위해 ‘저장’방법의 여러 과부하가 노출됩니다.

예를 들어,save (string, saveoptions)과부하 :

• 첫 번째 매개 변수는 출력 파일 이름을 지정합니다.
• 두 번째 매개 변수는 PDF 형식의`pdfsaveoptions ‘와 같은’saveOptions ‘에서 파생 된 클래스의 인스턴스를 수용합니다.

SaveOptions 유형

``SaveOptions ‘클래스의 속성 또는 상속자 중 하나의 속성을 사용하여 렌더링 동작을 사용자 정의 할 수 있습니다. 예를 들어:

• 출력 페이지 크기를 정의하려면saveoptions.custompagesize를 사용하십시오.
• saveoptions.legendoneachpage를 사용하여 각 페이지에 전설이 나타나는지 여부를 제어하십시오.

PdfSaveOptions saveOptions = new PdfSaveOptions()
{
    CustomPageSize = new SizeF(800, 600),
    LegendOnEachPage = false
};

렌더링된 간트 차트의 모양을 사용자 지정하는 방법은 최소 두 가지가 있습니다.

ProjectView를 사용하여 간트 차트 열 사용자 지정

이 방법은 더 이상 사용되지 않으며 향후 릴리스에서 확장될 가능성이 낮습니다. ProjectView 클래스는 제한된 기능을 제공하며 출력 이미지에 포함될 열 집합을 지정할 수 있습니다.

이 클래스를 사용하려면 GanttChartColumn 인스턴스 목록을 생성하여 ProjectView 생성자에 전달합니다. 그런 다음 이 뷰를 SaveOptions.View 속성에 할당합니다.

// Create the view columns
var columns = new List<GanttChartColumn>();
columns.Add(new GanttChartColumn("Name", 100, new TaskToColumnTextConverter(TaskName)));
columns.Add(new GanttChartColumn("Notes", 100, new TaskToColumnTextConverter(TaskNotes)));
columns.Add(new GanttChartColumn("Resources", 200, new TaskToColumnTextConverter(TaskResources)));

// Create the view
ProjectView projectView = new ProjectView(columns);

// Create SaveOptions
PdfSaveOptions saveOptions = new PdfSaveOptions()
{
    CustomPageSize = new SizeF(800, 600),
    View = projectView
};

// Save the project to PDF
project.Save("output.pdf", saveOptions);

The GanttChartColumn constructor accepts three arguments: the column name, column width, and a TaskToColumnTextConverter delegate that converts task data to display text. Example implementations:

private string TaskName(Task task)
{
    StringBuilder res = new StringBuilder();
    for (int i = 1; i < task.OutlineLevel; i++)
    {
        res.Append("  ");
    }

    res.AppendFormat("{0}. {1}", task.Id, task.Name);
    return res.ToString();
}

private string TaskNameHtml(Task task)
{
    StringBuilder res = new StringBuilder();
    for (int i = 1; i < task.OutlineLevel; i++)
    {
        res.Append("&nbsp;&nbsp;");
    }

    res.AppendFormat("{0}. {1}", task.Id, task.Name);
    return res.ToString();
}

private string TaskNotes(Task task)
{
    return task.NotesText ?? string.Empty;
}

private string TaskResources(Task task)
{
    StringBuilder res = new StringBuilder();
    Project project = task.ParentProject;
    bool bFirst = true;
    foreach (ResourceAssignment assignment in project.GetResourceAssignmentsByTask(task))
    {
        if (assignment.Resource != null)
        {
            if (!bFirst)
            {
                res.Append(", ");
            }

            res.Append(assignment.Resource.Name);
            bFirst = false;
        }
    }

    return res.ToString();
}

Below are examples of resulting images exported using the above code:

View를 사용하여 간트 차트 열 사용자 지정

View 클래스와 그 상속자를 사용하는 것이 차트 출력을 사용자 지정하는 데 권장되는 방법입니다. View 클래스는 Microsoft Project의 뷰 설정에 해당하며 ProjectView보다 더 풍부한 API를 제공합니다.

기존 뷰는 Views 컬렉션(MPP 파일용)에서 가져와 사용자 지정하고, SaveOptions.ViewSettings 속성을 통해 Project.Save 메서드에 전달할 수 있습니다.

다음 예제는 MPP 파일에서 기존 뷰를 가져와 새 열을 삽입하고, 이 뷰를 사용하여 간트 차트를 렌더링하는 방법을 보여줍니다.

Project project = new Project("input.mpp");

// Get existing view
var view = (GanttChartView) project.Views.GetByName("&Gantt Chart");

// Define and insert new column
TableField field = new TableField()
{
    AlignData = StringAlignment.Far,
    Width = 50,
    Field = Field.TaskName,
    Title = "Task name"
};

view.Table.TableFields.Insert(1, field);

PdfSaveOptions saveOptions = new PdfSaveOptions()
{
    ViewSettings = view
};

project.Save("output.pdf", saveOptions);

Conclusion

Aspose.Tasks for .NET provides multiple options for customizing Gantt chart rendering. Although ProjectView allows basic configuration, its functionality is limited and it is considered deprecated.

For more advanced control and alignment with Microsoft Project’s visual structure, the use of View and its associated classes is recommended. This approach provides better flexibility and is suitable for working with views defined in MPP files or for programmatically configuring new view layouts.