Java API управления проектами для создания и конвертации файлов Microsoft Project

Начало работы с Aspose.Tasks for Java

Рекомендуемый способ установки Aspose.Tasks for Java — через репозиторий Maven. Вы можете легко использовать Aspose.Words for Java API напрямую в своих Maven‑проектах, используя простые настройки.

 //Define the Aspose.Tasks for Java API dependency in your pom.xml as follows
<dependencies>
	<dependency>
	<groupId>com.aspose</groupId>
	<artifactId>aspose-tasks</artifactId>
	<version>20.10</version>
	<classifier>jdk18</classifier>
	</dependency>
</dependencies>

Создание нового файла проекта на Java

Разработчики могут создавать новые пустые проекты с нуля, используя Aspose.Tasks for Java. Это полезно, когда необходимо динамически генерировать файлы проектов. Библиотека поддерживает широкий спектр форматов файлов Microsoft Project, включая MPP, XML и MPX. В текущей версии Aspose.Tasks for Java доступно только создание XML‑файлов проектов. Ниже приведён пример кода, показывающий, как разработчики могут создать простой проектный файл в формате XML.

 
public class CreateEmptyProjectFile {
    public static void main(String[] args) {
        // ExStart: CreateEmptyProjectFile
        // 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(CreateEmptyProjectFile.class);

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

        newProject.save(dataDir + "project1.xml", SaveFileFormat.Xml);

        //Display result of conversion.
        System.out.println("Project file generated Successfully");
        // ExEnd: CreateEmptyProjectFile
    }
}

Чтение файлов проекта через Java API

Одна из ключевых возможностей Aspose.Tasks for Java — чтение файлов Microsoft Project. Библиотека позволяет разработчикам загрузить существующий файл проекта, используя всего несколько строк кода, и извлечь ценную информацию из файлов проекта. Класс Project можно использовать для выполнения этих задач: необходимо указать путь к файлу MPP или XML, после чего будет возвращён объект Project, которым можно управлять данными проекта. Ниже приведён пример, показывающий, как разработчики могут читать файл проекта онлайн в Java‑приложениях.

 
String sharepointDomainAddress = "https://contoso.sharepoint.com";
String userName = "admin@contoso.onmicrosoft.com";
String password = "MyPassword";

ProjectServerCredentials credentials = new ProjectServerCredentials(sharepointDomainAddress, userName, password);
ProjectServerManager reader = new ProjectServerManager(credentials);

for (ProjectInfo p : (Iterable)reader.getProjectList())
{
    System.out.println("Project Name:" + p.getName());
    System.out.println("Project Created Date:" + p.getCreatedDate());
    System.out.println("Project Last Saved Date:" + p.getLastSavedDate());
}

for (ProjectInfo p : (Iterable)reader.getProjectList())
{
    Project project = reader.getProject(p.getId());
    System.out.println("Project " + p.getName() + " loaded.");
    System.out.println("Resources count:" + project.getResources().size());
}

Обработка задач и планирование в Java‑приложениях

Aspose.Tasks for Java поддерживает создание новых задач, планирование задач и позволяет разработчикам эффективно управлять зависимостями задач. Это даёт возможность легко изменять данные проекта. Вы можете программно обновлять задачи, ресурсы и другие детали. В библиотеке реализовано несколько важных функций, позволяющих работать с задачами проекта: добавление новых задач, получение и установка свойств задач, привязка календарей к конкретным задачам, управление длительностью задач, управление критическими и трудоёмкими задачами и многое другое. Ниже приведён пример, увеличивающий и уменьшающий длительность задачи до одной недели и половины недели соответственно.

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

// Task duration in days (default time unit)
Duration duration = task.get(Tsk.DURATION);
System.out.println("Duration equals 1 day:" + duration.toString().equals("1 day"));

// Convert to hours time unit
duration = duration.convert(TimeUnitType.Hour);
System.out.println("Duration equals 8 hrs: "+ duration.toString().equals("8 hrs"));

// Increase task duration to 1 week and display if duration is updated successfully
task.set(Tsk.DURATION, project.getDuration(1, TimeUnitType.Week));
System.out.println("Duration equals 1 wk: " + task.get(Tsk.DURATION).toString().equals("1 wk"));

// Decrease task duration and display if duration is updated successfully
task.set(Tsk.DURATION, task.get(Tsk.DURATION).subtract(0.5));
System.out.println("Duration equals 0.5 wks: " + task.get(Tsk.DURATION).toString().equals("0.5 wks"));

Конвертация данных проекта в PDF через Java API

Aspose.Tasks for Java упрощает загрузку и сохранение данных проекта в различные важные форматы файлов внутри Java‑приложений. Класс Project предоставляет метод Save, который позволяет сохранять проект в разных форматах. Метод Save даёт возможность загружать и рендерить данные проекта в формат PDF, используя всего несколько строк кода Java. Ниже показан пример, демонстрирующий, как отобразить данные проекта в PDF с помощью Java‑команд.

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

// Read the input Project file
Project project = new Project(dataDir + "project6.mpp");

project.save(dataDir + "Project5.pdf", SaveFileFormat.PDF);

// Fitting contents to cell size
Project project1 = new Project(dataDir + "project6.mpp");
SaveOptions o = new PdfSaveOptions();

// Set the LegendOnEachPage property to false to hide legends

// Set the row height to fit cell content
o.setFitContent(true);
o.setTimescale(Timescale.Months);
o.setPresentationFormat(PresentationFormat.TaskUsage);
project1.save("result_months.pdf", o);
o.setLegendOnEachPage(false);
project1.save(dataDir + "result_months_WithoutLegend.pdf", o);

// Display result of conversion.
System.out.println("Process completed Successfully");