Aspose.Tasks 24.10.0

.NET API to Manipulate Project Files

---

---

Aspose.Tasks for .NET is a robust library designed for .NET developers, providing advanced tools for generating, editing, rendering, and converting Microsoft Project files. With this API, developers can work seamlessly with project properties, tasks, resources, assignments, baselines, custom fields, outline codes, and calendars, eliminating the need for Microsoft Project. It supports various project data manipulations, such as creating tasks, linking dependencies, managing resources, defining custom fields, applying calendar settings, handling baselines, and converting project data to different formats like PDF, Excel, CSV, HTML, and images. Aspose.Tasks empowers developers to build comprehensive project management solutions within their .NET applications.

Project Data

Project Properties Management

Enables reading and updating properties of a project to facilitate comprehensive project data managementk Data

Task Creation and Management

Allows the creation, manipulation, and management of tasks within a project structure, supporting project planning and tracking.

Resource Data

Resource Handling

Supports adding, updating, and managing resources, enabling project teams to allocate and monitor resources effectively.

Resource Assignment Data

Assignment Tracking

Manages assignments of resources to tasks, providing insights into workload distribution and resource usage.

Calendar Data

Calendar Creation

Enables creation and customization of calendars to define working days, hours, and exceptions specific to project needs.

Task Baseline Data

Task Configuration

Allows saving and tracking baseline data for tasks, facilitating variance analysis between planned and actual progress.

Resource Baseline Data

Resource Storage

Provides functionality to save baseline data for resources, aiding in budget and performance analysis.

Resource Assignment Baseline Data

Assignine Management

Supports baseline data storage for resource assignments, enabling comparison of planned vs. actual resource utilization.

Custom Field (Extended Attribute) Definition Data

Define and Access Extended Attributes

Create and manage extended attributes (custom fields) within project tasks and resources for data enrichment.

Extended Attribute Types

Define custom fields with specific data types (Text1, Number, etc.) to categorize and sort project data efficiently.

Custom Field Value Data

Assign Custom Field Values

Assign values to defined custom fields, enhancing task and resource information with custom metadata.

Custom Field Value Formats

Work with different formats and types for custom field values to fit diverse project requirements.

Outline Code Definition Data

Define Outline Codes

Create and structure outline codes for hierarchical categorization and organization within project tasks.

Assign Outline Code Levels

Set outline code levels to build structured classifications, aiding in project breakdown and detailed reporting.

Outline Code Value Data

Assign Values to Outline Codes

Input values to established outline codes, supporting detailed task grouping and classification.

Manage Outline Code Relationships

Establish relationships between outline code values for better hierarchical project management.

View Data

Customize Project Views

Configure views to display project data in specific formats, optimizing readability for various stakeholders.

Manage View Properties

Control view properties such as UID, Index, and Name for tailored project data presentation.

Table Data

Define Project Tables

Create tables for organizing and viewing project information in structured formats.

Table Field Customization

Adjust table fields within tables to display essential data points as per project needs.

TableField Data

Set TableField Properties

Define properties for individual table fields, including alignment and formatting for clear data display.

Control Data Display in Tables

Use TableField settings to show or hide specific data columns in project views.

Group Data

Define Project Groups

Group project data based on specific criteria for efficient organization and data analysis.

Grouping and Sorting Options

Set up grouping options for streamlined data categorization and sorting within project views.

GroupCriterion Data

Specify Grouping Criteria

Define criteria for data grouping, making it easier to manage complex projects with large datasets.

Advanced Grouping Options

Enable nested grouping for multi-level project data categorization.

Filter Data

Filter Definition Retrieval

Enables the extraction of filter definitions from MPP files, aiding in task and resource filtering for project data management.

Filter Criteria Access

Allows access to filter criteria details within MPP files, enabling precise data filtration based on project-specific requirements.

FilterCriteria Data

Filter Operations

Provides access to filter operations, supporting read and write for various project versions, enhancing filtering capabilities in project data.

GanttChartView Data

Bar Styles Customization

Supports customization of bar styles in Gantt chart views, allowing tailored visualization of project tasks.

Timescale Adjustment

Allows configuring timescales for Gantt chart views, facilitating detailed project time representation.

Text Styling in Gantt Charts

Enables text styling adjustments in Gantt chart views, supporting enhanced visual differentiation of task details.

Working with Primavera Formats

Import and Export Primavera Data

Supports importing and exporting Primavera file formats, enabling integration with popular project management tools.

Working with Projects

Project Creation

Enables the creation of project files with essential details like project start and end dates, task list, and resources.

Project Properties Access

Provides access to project properties, including title, author, and last saved date, for effective project tracking.

Working with Formulas

Define Custom Formulas

Allows defining custom formulas to automate calculations within the project plan, enhancing productivity.

Apply Formulas on Fields

Enables applying custom formulas on project, task, and resource fields, supporting dynamic data manipulation.

Working with Calendars

Calendar Management

Provides tools for creating and managing calendars associated with specific projects and tasks.

Set Work Weeks

Allows defining custom work weeks in calendars, enabling accurate scheduling and work tracking.

Working with Calendar Exceptions

Define Calendar Exceptions

Supports defining exceptions for holidays or non-working days, improving scheduling accuracy.

Apply Exceptions to Tasks

Enables assigning calendar exceptions to specific tasks, ensuring accurate project timelines.

Working with Tasks

Task Creation and Management

Provides capabilities for creating and managing tasks within a project, supporting complex project structures.

Task Duration Customization

Allows customizing task durations, including support for fixed duration and effort-driven tasks.

Working with Task Links

Define Task Dependencies

Allows defining dependencies between tasks using task links, improving scheduling accuracy.

Task Link Types

Supports setting different types of task links, such as Finish-to-Start, Start-to-Start, enhancing task relationships.

Working with Task Baselines

Task Baseline Creation

Enables creating task baselines to capture the initial project plan, supporting effective progress tracking.

Track Task Variance

Provides variance tracking between baseline and actual values, helping identify project deviations.

Working with Resources

Resource Allocation

Facilitates allocation of resources to tasks, supporting resource planning and utilization.

Resource Rate Definition

Enables setting custom rates for resources, assisting in project cost calculations.

Resource Overallocation Detection

Provides features to detect resource overallocation, aiding in resource management and optimization.

Working with Resource Assignments

Creating Resource Assignments

Supports creating resource assignments by linking resources with specific tasks.

General Resource Assignment Properties

Manage essential properties of resource assignments, such as cost and work allocations.

Managing Assignment Cost

Provides tools to track and manage the costs associated with resource assignments effectively.

Working with Resource Assignment Budgets

Enables budget tracking and assignment for resources, improving project financial control.

Handling Overtime, Remaining Costs, and Work

Offers management of overtime work, remaining cost calculations, and work estimates for assignments.

Calculating Percentages

Supports calculating work completion percentages for resource assignments to track progress.

Dealing with Variances

Provides variance calculation features to compare planned and actual data for assignments.

Stop or Resume an Assignment

Allows pausing or resuming assignments, offering flexibility in project scheduling.

Timephased Data Generation for Different Work Contours

Enables generation of time-phased data for various work contours, supporting detailed scheduling.

Saving Updated Resource Assignment to MPP

Supports saving modifications to resource assignments back into the MPP file format.

Read Write Rate Scale Information

Provides functionality to read and write rate scale information for resource assignments.

Adding Extended Attributes to Resource Assignments

Allows adding custom attributes to resource assignments for enhanced data tracking.

Working with Project Currencies

Managing Project Currency Codes

Supports setting and retrieving currency codes for projects, aligning with financial standards.

Managing Project Currency Digits

Allows setting the number of currency digits used in financial calculations for a project.

Managing Currency Symbols

Provides functionality for defining and managing currency symbols in project files.

Working with Views

Printing MS Project MPP files to Separate Image Files

Enables printing of project views to separate image files, supporting better visualization.

Remove Gap Between Tasks List and Footer

Provides an option to adjust layout and remove gaps between tasks list and footer during export.

Rendering Notes When Converting MS Project MPP file

Supports rendering task notes when converting MPP files to various formats.

Miscellaneous

Sorting Resources by Name

Offers functionality to sort project resources alphabetically by name for better organization.

Handling Exceptions using Aspose.Tasks

Provides robust error-handling mechanisms for managing exceptions within Aspose.Tasks.

Sorting Tasks by Name

Supports sorting project tasks by name, aiding in task organization and quick lookup.

Update Outline Code Definitions and Values

Allows updating outline code definitions and values to maintain structured project data.

Writing Metadata to MPP

Enables writing custom metadata to MPP files, improving project information management.

Working with VBA

Reading VBA Information from MPP Files

Enables reading VBA project details, including modules, references, and attributes directly from an MPP file.

Accessing VBA References

Provides access to VBA references, allowing you to retrieve library identifiers and names.

Extracting Module Details

Allows extraction of information about VBA modules, including names and source codes within a project.

Accessing Module Attributes

Retrieves attributes of VBA modules for in-depth analysis and management of project macros.

Converting MS Project MPP Files

Convert MPP to PDF

Allows conversion of Microsoft Project MPP files to PDF format with customization options, such as specifying views and date formats.

Convert MPP to Excel Formats

Supports conversion of MPP files to Excel formats (XLSX, Spreadsheet2003 XML) for easy data manipulation in Excel.

Convert MPP to CSV

Converts MPP files to CSV format with options to customize encoding, delimiter, and column headers.

Convert MPP to JPEG, PNG, TIFF

Provides the ability to convert MPP files to various image formats like JPEG, PNG, and TIFF with adjustable quality settings.

Convert MPP to SVG

Enables rendering of MPP files into SVG format for scalable, high-quality graphic representation of project data.

Export Jira Tasks to MPP

Facilitates exporting tasks from Jira to an MS Project MPP file format, bridging task management across platforms.

---

---

---

File Formats Supported by Aspose.Tasks for .NET

The following table indicates the input and output file formats supported by Aspose.Tasks for .NET.

Format	Description	Load	Save
MPP	Microsoft Project 2003/2007/2010/2013/2016/2019/2021 MPP and Microsoft Project Online formats are supported	✔️	✔️
XML	Microsoft Project XML Format	✔️	✔️
MPT	Microsoft Project Template	✔️	✔️
XER	Primavera XER Format	✔️	✔️
P6XML	Primavera P6XML Format	✔️	✔️
MPX	Primavera MPX	✔️	✔️
XLSX	Saving Project’s data (Tasks, Resources, or Assignments table) as Microsoft Excel spreadsheet		✔️
PDF	Saving the specific Project’s view as PDF		✔️
HTML	Saving the specific Project’s view as simplified HTM or HTML Formats		✔️
CSV	Saving Project’s data (Tasks, Resources, or Assignments table) as comma-separated file		✔️
TXT	Saving Project’s data (Tasks, Resources, or Assignments table) as a file with the specified delimiter		✔️
TIFF	Saving the specific Project’s view as TIFF image		✔️
PNG	Saving the specific Project’s view as PNG image		✔️
JPEG	Saving the specific Project’s view as JPEG image		✔️
BMP	Saving the specific Project’s view as BMP image		✔️
SVG	Saving the specific Project’s view as SVG file		✔️
XPS	Saving the specific Project’s view as XPS		✔️

Installation of Aspose.Tasks for .NET

Install Aspose.Tasks for .NET via NuGet

1. Open Visual Studio and go to NuGet Package Manager.
2. Search for Aspose.Tasks and click Install to add the API to your project.

Install or Update Aspose.Tasks via Package Manager Console

1. Open your project in Visual Studio.
2. Go to Tools -> NuGet Package Manager -> Package Manager Console.
3. Run the following command:

   Install-Package Aspose.Tasks
   

Code Sample 1: Creating and Saving a New Project

Easily create a new project instance, set basic properties, and save it in MPP format.

// Create a new project
Project project = new Project();

// Set project start date
project.Set(Prj.StartDate, new DateTime(2023, 1, 1));

// Save the project in MPP format
project.Save("NewProject_out.mpp", SaveFileFormat.MPP);

Code Sample 2: Adding Tasks with Dependencies

Define tasks and link them with dependencies, streamlining project scheduling.

// Initialize a project
Project project = new Project();

// Add tasks
Task task1 = project.RootTask.Children.Add("Task 1");
Task task2 = project.RootTask.Children.Add("Task 2");

// Link tasks with Finish-to-Start dependency
TaskLink link = project.TaskLinks.Add(task1, task2, TaskLinkType.FinishToStart);

// Save the project
project.Save("LinkedTasks_out.mpp", SaveFileFormat.MPP);

Code Sample 3: Defining and Applying Calendar Workdays

Set up a project calendar, specify workdays, and apply it to the project for accurate scheduling.

// Create project and calendar
Project project = new Project();
Calendar calendar = project.Calendars.Add("Custom Calendar");

// Set workdays
calendar.WeekDays.Add(WeekDay.CreateDefaultWorkingDay(DayType.Monday));
calendar.WeekDays.Add(WeekDay.CreateDefaultWorkingDay(DayType.Tuesday));
calendar.WeekDays.Add(WeekDay.CreateDefaultWorkingDay(DayType.Wednesday));

// Assign calendar to project
project.Set(Prj.Calendar, calendar);

// Save the project
project.Save("ProjectWithCalendar_out.mpp", SaveFileFormat.MPP);

Code Sample 4: Exporting Project to PDF

Render the project as a PDF document, including task details, for easy sharing and reporting.

// Load an existing project
Project project = new Project("ExistingProject.mpp");

// Save the project as PDF
project.Save("ProjectReport_out.pdf", SaveFileFormat.PDF);

---

---

Project Management API | Microsoft Project File Manipulation | ASP.NET | MPP File Conversion | Project Baseline Tracking | Resource Assignment Management | Gantt Chart Customization | VBA for Projects | Project Task Links | Calendar Exceptions | Custom Fields | Outline Code Definition | Reporting Services | Monte Carlo Simulation | Primavera Integration | PDF Export | CSV Export | SVG Rendering | Custom Formulas | Project Currency Management | Exception Handling | Task Sorting | Metadata to MPP | .NET API