Cómo crear modos de cálculo de proyecto en Aspose.Tasks

Al trabajar con proyectos, distintos escenarios pueden requerir enfoques diferentes para recalcular cronogramas, costos o recursos. Aspose.Tasks for .NET proporciona modos de cálculo flexibles, por lo que puede decidir si las propiedades del proyecto se deben actualizar automáticamente, manualmente o no recalcular en absoluto. Esto garantiza que tenga control total sobre el rendimiento, la precisión y el comportamiento de sus archivos de proyecto.

Modos de cálculo del proyecto

Aspose.Tasks for .NET API proporciona tres modos de cálculo de proyecto que definen cómo se calculan los valores de las propiedades dependientes cuando se establece el valor de una propiedad.
Elegir el modo correcto le permite equilibrar la eficiencia y la precisión según su caso de uso.

Estos modos de cálculo son:

• Ninguno – Establece solo las propiedades necesarias y no realiza ningún cálculo. Útil cuando desea ajustar valores rápidamente sin recalcular todo el proyecto.
• Manual – Establece las propiedades de los objetos dependientes sin desencadenar una recalculación completa de otros datos del proyecto. Este modo es útil cuando se necesitan actualizaciones parciales.
• Automático – Recalcula fechas, trabajo y propiedades de costo inmediatamente después de los cambios. Recomendado cuando la precisión y la coherencia son críticas.

Los ejemplos a continuación muestran cómo se puede aplicar cada modo en el código.

Modo de cálculo del proyecto - Ninguno

En este modo, el proyecto omite la recalculación. Es eficiente al realizar actualizaciones por lotes o cuando solo necesita cambiar valores sin que se ajusten las dependencias.

// 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));

Modo de cálculo del proyecto - Manual

El modo Manual actualiza las propiedades de los objetos dependientes pero evita desencadenar recalculaciones globales.
Esto logra un equilibrio entre el rendimiento y mantener alineados los valores relacionados.

// 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)));

Modo de cálculo del proyecto - Automático

El modo Automático garantiza que todas las fechas, los costos y los valores de trabajo se mantengan consistentes tan pronto como cambie cualquier propiedad relacionada.
Proporciona la máxima precisión y es el más parecido a cómo Microsoft Project maneja las recalculaciones por defecto.

// 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))); 

Al ofrecer tres modos de cálculo — Ninguno, Manual y Automático — Aspose.Tasks for .NET brinda a los desarrolladores la flexibilidad para elegir cómo deben procesarse los datos del proyecto.
Ya sea que priorice rendimiento, control, o precisión, el modo de cálculo adecuado le permite manejar las actualizaciones del proyecto de la manera más eficiente para su escenario.