Trabajar con calendarios

Crear un calendario

Los calendarios en Microsoft Project definen el tiempo laborable y no laborable, lo que impacta directamente en la programación de tareas y disponibilidad de recursos. En Aspose.Tasks para .NET, los calendarios pueden crearse utilizando la clase Calendar, que ofrece tres sobrecargas de constructor:

• Calendar() – Inicializa un calendario por defecto.
• Calendar(int id) – Inicializa un calendario con un ID específico.
• Calendar(string name) – Inicializa un calendario con un nombre determinado.

El siguiente ejemplo muestra cómo instanciar calendarios usando cada constructor. Una vez generados, los calendarios pueden visualizarse en Microsoft Project accediendo a Proyecto > Información del proyecto.

Información del proyecto mostrando los calendarios

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

// New calendar can be added to a project's calendar collection using the collection's Add method.
Calendar cal1 = project.Calendars.Add("New Info");
Calendar cal2 = project.Calendars.Add("no name");
Calendar cal3 = project.Calendars.Add("cal3");

project.Save("CreatingCalendar_out.Xml", SaveFileFormat.XML);

Definir días laborables para un calendario

La colección Days de la clase Calendar representa los días laborables y sus intervalos de tiempo asociados. Las definiciones de los días laborables se modelan mediante las clases WeekDay y WorkingTime.

Los desarrolladores pueden usar CreateDefaultWorkingDay() para establecer el horario estándar para un día específico, o definir intervalos personalizados con las propiedades FromTime y ToTime.

El siguiente ejemplo define de lunes a jueves como días laborables estándar y el viernes con un horario personalizado. Para verificar el resultado en Microsoft Project, vaya a Herramientas > Cambiar tiempo laborable.

Definir días laborables en Microsoft Project

// This example shows how Aspose.Tasks API can be used to define a new Calendar, add week days to it and define working times for days
// Create a project instance
Project project = new Project();

// Define Calendar
Calendar cal = project.Calendars.Add("Calendar1");

// Add working days monday through thursday with default timings
cal.WeekDays.Add(WeekDay.CreateDefaultWorkingDay(DayType.Monday));
cal.WeekDays.Add(WeekDay.CreateDefaultWorkingDay(DayType.Tuesday));
cal.WeekDays.Add(WeekDay.CreateDefaultWorkingDay(DayType.Wednesday));
cal.WeekDays.Add(WeekDay.CreateDefaultWorkingDay(DayType.Thursday));
cal.WeekDays.Add(new WeekDay(DayType.Saturday));
cal.WeekDays.Add(new WeekDay(DayType.Sunday));

// Set friday as short working day
WeekDay myWeekDay = new WeekDay(DayType.Friday);

// Sets working time. Only time part of DateTime is important
WorkingTime wt1 = new WorkingTime();
wt1.FromTime = new DateTime(1, 1, 1, 9, 0, 0, 0);
wt1.ToTime = new DateTime(1, 1, 1, 12, 0, 0, 0);
WorkingTime wt2 = new WorkingTime();
wt2.FromTime = new DateTime(1, 1, 1, 13, 0, 0, 0);
wt2.ToTime = new DateTime(1, 1, 1, 16, 0, 0, 0);
myWeekDay.WorkingTimes.Add(wt1);
myWeekDay.WorkingTimes.Add(wt2);
myWeekDay.DayWorking = true;
cal.WeekDays.Add(myWeekDay);

project.Save("Project_DefineCalendarWeekdays_out.xml", SaveFileFormat.XML);

Reemplazar un calendario

Los calendarios base sirven como plantillas para la planificación de tareas y recursos. Aspose.Tasks permite reemplazar un calendario existente accediendo a CalendarCollection a través del objeto Project.

Los tipos de calendario base compatibles incluyen:

• Estándar: lunes a viernes, de 08:00 a 17:00.
• 24 horas: utilizado para horarios de trabajo continuos.
• Turno nocturno: de lunes por la noche a sábado por la mañana, de 23:00 a 08:00.

El siguiente ejemplo muestra cómo eliminar un calendario existente y agregar uno nuevo estándar a la colección.

// Create project
Project project = new Project("New Project.mpp");

// Access project calendars
CalendarCollection calColl = project.Calendars;
foreach (Calendar myCalendar in calColl)
{
    if (myCalendar.Name == "TestCalendar")
    {
        // Remove calendar
        calColl.Remove(myCalendar);
    }
}

// Add new calendar
Calendar newCalendar = calColl.Add("TestCalendar");
project.Save("ReplaceCalendar_out.mpp", SaveFileFormat.MPP);

Crear un calendario estándar

Un calendario estándar define los días y horas laborales por defecto comúnmente utilizados en cronogramas de proyectos. Aspose.Tasks proporciona dos métodos estáticos para facilitar esto:

• MakeStandardCalendar() – Crea un nuevo calendario con configuración estándar.
• MakeStandardCalendar(Calendar cal) – Convierte un calendario existente a estándar.

Para ver el resultado en Microsoft Project, utilice Herramientas > Cambiar tiempo laborable.

El cuadro de diálogo Cambiar tiempos laborables muestra el calendario estándar utilizado por el proyecto

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

// Define Calendar and make it standard
Calendar cal1 = project.Calendars.Add("My Cal");
Calendar.MakeStandardCalendar(cal1);

project.Save("Project_MakeStandardCalendar_out.xml", SaveFileFormat.XML);

Guardar los datos de calendario actualizados en MPP

Aspose.Tasks permite actualizar las definiciones de calendario y guardarlas nuevamente en un archivo MPP. El proceso implica:

1. Cargar el archivo MPP existente.
2. Modificar la colección de calendarios (agregar, actualizar).
3. Guardar el proyecto actualizado en disco.

El siguiente ejemplo demuestra cómo agregar un nuevo calendario y escribirlo de nuevo en el archivo MPP original.

Project project = new Project("New Project.mpp");
Calendar cal = project.Calendars.GetByUid(3);

// Update the calendar information
Calendar.MakeStandardCalendar(cal);
cal.Name = "Test calendar";
CalendarException exc = new CalendarException();
exc.FromDate = DateTime.Now;
exc.ToDate = DateTime.Now.AddDays(2);
exc.DayWorking = true;

WorkingTime wt1 = new WorkingTime();
wt1.FromTime = new DateTime(10, 1, 1, 9, 0, 0);
wt1.ToTime = new DateTime(10, 1, 1, 13, 0, 0);

WorkingTime wt2 = new WorkingTime();
wt2.FromTime = new DateTime(10, 1, 1, 14, 0, 0);
wt2.ToTime = new DateTime(10, 1, 1, 19, 0, 0);

WorkingTime wt3 = new WorkingTime();
wt3.FromTime = new DateTime(10, 1, 1, 20, 0, 0);
wt3.ToTime = new DateTime(10, 1, 1, 21, 0, 0);

exc.WorkingTimes.Add(wt1);
exc.WorkingTimes.Add(wt2);
exc.WorkingTimes.Add(wt3);
cal.Exceptions.Add(exc);

CalendarException exc2 = new CalendarException();
exc2.FromDate = DateTime.Now.AddDays(7);
exc2.ToDate = exc2.FromDate;
exc2.DayWorking = false;
cal.Exceptions.Add(exc2);

project.Set(Prj.Calendar, cal);

project.Save("WriteUpdatedCalendarDataToMPP_out.mpp", SaveFileFormat.MPP);