Как создать режимы расчёта проекта в Aspose.Tasks

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

Режимы расчёта проекта

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

Эти режимы расчёта:

• Отключено — Устанавливает только необходимые свойства и не выполняет никаких вычислений. Полезно, когда нужно быстро изменить значения без пересчёта всего проекта.
• Ручной — Устанавливает свойства зависимых объектов без запуска полного пересчёта других данных проекта. Этот режим полезен при необходимости частичных обновлений.
• Автоматический — Немедленно пересчитывает даты, значения работ и затрат после изменений. Рекомендуется, когда критичны точность и согласованность.

Примеры ниже демонстрируют, как каждый режим может применяться в коде.

Режим расчёта проекта — Отключено

В этом режиме проект пропускает пересчёт. Это эффективно при пакетных обновлениях или когда нужно изменить только исходные значения без корректировки зависимостей.

// Create empty project and set calculation mode to None
Project project = new Project();
project.CalculationMode = CalculationMode.None;

// Add a new task
Task task = project.RootTask.Children.Add("Task");

// Note that even ids were not calculated
Console.WriteLine("Task.Id Equals 0 : {0} ",  task.Get(Tsk.Id).Equals(0));
Console.WriteLine("Task.OutlineLevel Equals 0 : {0} ", task.Get(Tsk.OutlineLevel).Equals(0));
Console.WriteLine("Task Start Equals DateTime.MinValue : {0} ", task.Get(Tsk.Start).Equals(DateTime.MinValue));
Console.WriteLine("Task Finish Equals DateTime.MinValue : {0} ", task.Get(Tsk.Finish).Equals(DateTime.MinValue));
Console.WriteLine("Task Duration Equals 0 mins : {0} ", task.Get(Tsk.Duration).ToString().Equals("0 mins"));

// Set duration property
task.Set(Tsk.Duration, project.GetDuration(2, TimeUnitType.Day));
Console.WriteLine("Task Duration Equals 2 days : {0} ", task.Get(Tsk.Duration).ToString().Equals("2 days"));
Console.WriteLine("Task Start Equals DateTime.MinValue  : {0} ", task.Get(Tsk.Start).Equals(DateTime.MinValue));
Console.WriteLine("Task Finish Equals DateTime.MinValue  : {0} ", task.Get(Tsk.Finish).Equals(DateTime.MinValue));

Режим расчёта проекта — Ручной

Ручной режим обновляет свойства зависимых объектов, но не вызывает глобальные пересчёты.
Это позволяет сбалансировать производительность и согласованность связанных значений.

// Create empty project and set calculation mode to Manual
Project project = new Project();
project.CalculationMode = CalculationMode.Manual;

// Set project start date and add new tasks
project.Set(Prj.StartDate, new DateTime(2015, 4, 15));
Task task1 = project.RootTask.Children.Add("Task 1");
Task task2 = project.RootTask.Children.Add("Task 2");

// The necessary properties are set in manual mode
Console.WriteLine("Task1.Id Equals 1 : {0} ", task1.Get(Tsk.Id).Equals(1));
Console.WriteLine("Task1 OutlineLevel Equals 1 : {0} ", task1.Get(Tsk.OutlineLevel).Equals(1));
Console.WriteLine("Task1 Start Equals 15/04/2015 08:00 AM : {0} ", task1.Get(Tsk.Start).Equals(new DateTime(2015, 4, 15, 8, 0, 0)));
Console.WriteLine("Task1 Finish Equals 15/04/2015 05:00 PM : {0} ", task1.Get(Tsk.Finish).Equals(new DateTime(2015, 4, 15, 17, 0, 0)));
Console.WriteLine("Task1 Duration Equals 1 day : {0} ", task1.Get(Tsk.Duration).ToString().Equals("1 day"));
Console.WriteLine("Task2 Start Equals 15/04/2015 08:00 AM : {0} ", task2.Get(Tsk.Start).Equals(new DateTime(2015, 4, 15, 8, 0, 0)));
Console.WriteLine("Task2 Finish Equals 15/04/2015 05:00 PM : {0} ", task2.Get(Tsk.Finish).Equals(new DateTime(2015, 4, 15, 17, 0, 0)));
Console.WriteLine("Task2 Duration Equals 1 day : {0} ", task2.Get(Tsk.Duration).ToString().Equals("1 day"));

// When we link two tasks together their dates are not recalculated in manual mode
TaskLink link = project.TaskLinks.Add(task1, task2, TaskLinkType.FinishToStart);

// Task 2 Start has not been changed
Console.WriteLine("Task1 Start Equals Task2 Start : {0} ", task1.Get(Tsk.Start).Equals(task2.Get(Tsk.Start)));
Console.WriteLine("Task1 Finish Equals Task2 Finish : {0} ", task1.Get(Tsk.Finish).Equals(task2.Get(Tsk.Finish)));

Режим расчёта проекта — Автоматический

Автоматический режим обеспечивает согласованность всех дат, затрат и значений работ сразу после изменения любой связанной величины.
Он обеспечивает максимальную точность и наиболее близок к тому, как Microsoft Project по умолчанию выполняет пересчёты.

// Create empty project and set calculation mode to Automatic
Project project = new Project();
project.CalculationMode = CalculationMode.Automatic;

// Set project start date and add new tasks
project.Set(Prj.StartDate, new DateTime(2015, 4, 15));
Task task1 = project.RootTask.Children.Add("Task 1");
Task task2 = project.RootTask.Children.Add("Task 2");

// Link tasks
TaskLink link = project.TaskLinks.Add(task1, task2, TaskLinkType.FinishToStart);

// Verify dates have been recalculated
Console.WriteLine("Task1 Start + 1 Equals Task2 Start : {0} ", task1.Get(Tsk.Start).AddDays(1).Equals(task2.Get(Tsk.Start)));
Console.WriteLine("Task1 Finish + 1 Equals Task2 Finish : {0} ", task1.Get(Tsk.Finish).AddDays(1).Equals(task2.Get(Tsk.Finish)));
Console.WriteLine("RootTask Finish Equals Task2 Finish : {0} ", task2.Get(Tsk.Finish).Equals(project.RootTask.Get(Tsk.Finish)));
Console.WriteLine("Project Finish Date Equals Task2 Finish : {0} ", task2.Get(Tsk.Finish).Equals(project.Get(Prj.FinishDate))); 

Предоставляя три режима расчёта — Отключено, Ручной и Автоматический — Aspose.Tasks for .NET даёт разработчикам гибкость в выборе способа обработки данных проекта.
Будь то производительность, контроль, или точность, правильный режим расчёта позволяет вам обрабатывать обновления проекта наиболее эффективно для вашего сценария.