Робота з поданнями

Зчитування даних конкретного подання

Подання надають графічне відображення проєкту або його елементів (ресурси, завдання тощо). Наприклад, діаграма Ганта наочно показує хід виконання та плани проєкту:

Microsoft Project дозволяє користувачам налаштовувати різні властивості подань, такі як стилі смуг, лінії сітки, лінії прогресу, інформація про шкалу часу та налаштування сторінки. Усі ці властивості зберігаються у файлі MPP. За допомогою Aspose.Tasks for .NET ви можете програмно отримувати доступ і змінювати їх через View class or its derived classes: GanttChartView, TaskUsageView, та ResourceUsageView.

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

GanttChartView view = project.Views.ToList()[0] as GanttChartView;
Console.WriteLine("Is Bar Rounding: " + view.BarRounding);
Console.WriteLine("Show Bar Splits? : " + view.ShowBarSplits);
Console.WriteLine("Show Drawings? : " + view.ShowDrawings);
Console.WriteLine("Roll Up Gantt Bars? " + view.RollUpGanttBars);
Console.WriteLine("Hide Rollup Bars When Summary Expa0nded: " + view.HideRollupBarsWhenSummaryExpanded);
Console.WriteLine("Bar Size: " + view.BarSize.ToString());
Console.WriteLine("Bar Style: " + view.BarStyles.Count);
Console.WriteLine("************************ RETREIVING BAR STYLES INFORMATION FROM THE VIEW *********************");
int i = 0;
foreach (GanttBarStyle barStyle in view.BarStyles)
{
    Console.WriteLine("Name: " + barStyle.Name);
    Console.WriteLine("ShowFor: " + barStyle.ShowFor.ToString());
    Console.WriteLine("Row: " + barStyle.Row);
    Console.WriteLine("From: " + barStyle.From);
    Console.WriteLine("To: " + barStyle.To);
    Console.WriteLine("MiddleShape: " + barStyle.MiddleShape);
    Console.WriteLine("MiddleShapeColor: " + barStyle.MiddleShapeColor);
    Console.WriteLine("StartShape: " + barStyle.StartShape);
    Console.WriteLine("EndShape: " + barStyle.EndShape);
    Console.WriteLine("EndShapeColor: " + barStyle.EndShapeColor);
    i++;
}

Console.WriteLine("Grid Lines Count: " + view.Gridlines.Count);
Gridlines gridlines = view.Gridlines[0];
Console.WriteLine("************************ RETREIVING GRID LINES PROPERTIES *********************");
Console.WriteLine("GridLine Type: " + gridlines.Type);
Console.WriteLine("Gridlines Internval: " + gridlines.Interval);
Console.WriteLine("Gridlines Color: " + gridlines.NormalColor);
Console.WriteLine("Gridlines NormalPattern: " + gridlines.NormalPattern);
Console.WriteLine("Gridlines IntervalPattern: " + gridlines.IntervalPattern);
Console.WriteLine("Gridlines IntervalColor: " + gridlines.IntervalColor);
Console.WriteLine("************************ RETREIVING PROGRESS LINES PROPERTIES *********************");
Console.WriteLine("ProgressLInes.BeginAtDate: ", view.ProgressLines.BeginAtDate);
Console.WriteLine("ProgressLines.isBaselinePlan: " + view.ProgressLines.IsBaselinePlan);
Console.WriteLine("ProgressLines.DisplaySelected: " + view.ProgressLines.DisplaySelected);
Console.WriteLine("ProgressLines.SelectedDates.Count: " + view.ProgressLines.SelectedDates.Count);
Console.WriteLine("ProgressLines.SelectedDates[0]: " + view.ProgressLines.SelectedDates[0]);
Console.WriteLine("ProgressLines.SelectedDates[1]: " + view.ProgressLines.SelectedDates[1]);
Console.WriteLine("ProgressLines.SelectedDates[2]: " + view.ProgressLines.SelectedDates[2]);
Console.WriteLine("ProgressLines.DisplayAtRecurringIntervals: " + view.ProgressLines.DisplayAtRecurringIntervals);
Console.WriteLine("ProgressLines.RecurringInterval.Interval: " + Interval.Weekly, view.ProgressLines.RecurringInterval.Interval);
Console.WriteLine("ProgressLines.RecurringInterval.WeeklyDays.Count" + view.ProgressLines.RecurringInterval.WeeklyDays.Count);
Console.WriteLine("Recurring Interval.WeeklyDays: " + view.ProgressLines.RecurringInterval.WeeklyDays);
Console.WriteLine("Recurring Interval.DayType.Saturday: " + view.ProgressLines.RecurringInterval.WeeklyDays);
Console.WriteLine("Recurring Interval.DayType.Sunday: " + view.ProgressLines.RecurringInterval.WeeklyDays);
Console.WriteLine("ProgressLines.ShowDate: " + view.ProgressLines.ShowDate);
Console.WriteLine("ProgressLines.ProgressPointShape: " + view.ProgressLines.ProgressPointShape.ToString());
Console.WriteLine("ProgressLines.ProgressPointColor: " + view.ProgressLines.ProgressPointColor);
Console.WriteLine("ProgressLines.LineColor: " + Color.Red, view.ProgressLines.LineColor);
Console.WriteLine("ProgressLines.LinePattern: " + LinePattern.Solid, view.ProgressLines.LinePattern);
Console.WriteLine("ProgressLines.OtherProgressPointShape: " + view.ProgressLines.OtherProgressPointShape.ToString());
Console.WriteLine("ProgressLines.OtherProgressPointColor: " + view.ProgressLines.OtherProgressPointColor.ToString());
Console.WriteLine("ProgressLines.OtherLineColor: " + view.ProgressLines.OtherLineColor);
Console.WriteLine("************************ BOTTOM TIMESCALE IFORMATION ******************");
Console.WriteLine("BottomTimescaleTier.Count:" + view.BottomTimescaleTier.Count);
Console.WriteLine("BottomTimescaleTier.Unit:" + TimescaleUnit.Days, view.BottomTimescaleTier.Unit.ToString());
Console.WriteLine("BottomTimescaleTier.UsesFiscalYear: " + view.BottomTimescaleTier.UsesFiscalYear);
Console.WriteLine("BottomTimescaleTier.Alignment: " + StringAlignment.Center, view.BottomTimescaleTier.Alignment.ToString());
Console.WriteLine("BottomTimescaleTier.ShowTicks: " + view.BottomTimescaleTier.ShowTicks.ToString());
Console.WriteLine("BottomTimescaleTier.Label:" + DateLabel.DayDi, view.BottomTimescaleTier.Label);
Console.WriteLine("************************ MIDDLE TIMESCALE IFORMATION ******************");
Console.WriteLine("MiddleTimescaleTier.Count:" + view.MiddleTimescaleTier.Count);
Console.WriteLine("MiddleTimescaleTier.Unit:" + TimescaleUnit.Days, view.MiddleTimescaleTier.Unit.ToString());
Console.WriteLine("MiddleTimescaleTier.UsesFiscalYear: " + view.MiddleTimescaleTier.UsesFiscalYear);
Console.WriteLine("MiddleTimescaleTier.Alignment: " + StringAlignment.Center, view.MiddleTimescaleTier.Alignment.ToString());
Console.WriteLine("MiddleTimescaleTier.ShowTicks: " + view.MiddleTimescaleTier.ShowTicks.ToString());
Console.WriteLine("MiddleTimescaleTier.Label:" + DateLabel.DayDi, view.MiddleTimescaleTier.Label);
Console.WriteLine("************************ TOP TIMESCALE IFORMATION ******************");
Console.WriteLine("TopTimescaleTier.Unit:" + TimescaleUnit.Days, view.TopTimescaleTier.Unit.ToString());
Console.WriteLine("TopTimescaleTier.UsesFiscalYear: " + view.TopTimescaleTier.UsesFiscalYear);
Console.WriteLine("TopTimescaleTier.Alignment: " + StringAlignment.Center, view.TopTimescaleTier.Alignment.ToString());
Console.WriteLine("TopTimescaleTier.ShowTicks: " + view.TopTimescaleTier.ShowTicks.ToString());
Console.WriteLine("TopTimescaleTier.Label: ", view.TopTimescaleTier.Label.ToString()); 

У цьому фрагменті коду безпосередньо отримується доступ до подання діаграми Ганта, що дозволяє читати та працювати з його збереженими властивостями, такими як шкала часу, форматування або правила відображення.

Налаштування подання діаграми Ганта для відображення вибраних користувацьких полів

Розширені атрибути можна додавати до завдань у проєкті. Іноді необхідно автоматично відображати певні користувацькі поля в поданні діаграми Ганта замість їх ручного вибору. Наведений нижче код показує, як налаштувати таблицю проєкту для досягнення цього.

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

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

// Define new custom attribute
ExtendedAttributeDefinition text1Definition = ExtendedAttributeDefinition.CreateTaskDefinition(ExtendedAttributeTask.Text1, null);
project.ExtendedAttributes.Add(text1Definition);
// Add custom text attribute to created task.
task.ExtendedAttributes.Add(text1Definition.CreateExtendedAttribute("Activity attribute"));

// Customize table by adding text attribute field
TableField attrField = new TableField();
attrField.Field = Field.TaskText1;
attrField.Width = 20;
attrField.Title = "Custom attribute";
attrField.AlignTitle = StringAlignment.Center;
attrField.AlignData = StringAlignment.Center;
Table table = project.Tables.ToList()[0];
table.TableFields.Insert(3, attrField);

project.Save("ConfigureTheGantChartViewShowSelectedColumnFields_out.mpp", new MPPSaveOptions() { WriteViewData = true });

Такий підхід забезпечує, що вибрані користувацькі поля відображаються за замовчуванням у експортованому поданні MPP.

Налаштування підписів рівнів шкали часу відповідно до поточних регіональних налаштувань

Aspose.Tasks for .NET дозволяє налаштовувати підписи рівнів шкали часу відповідно до системної інформації про культуру CultureInfo. DateTimeConverter delegate надає контроль над тим, як дати відображаються у рівнях шкали часу.

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

// Add task links
project.TaskLinks.Add(project.RootTask.Children.Add("Task 1"), project.RootTask.Children.Add("Task 2"));

GanttChartView view = (GanttChartView)project.DefaultView;

// This code is added for better visualization
view.MiddleTimescaleTier.Unit = TimescaleUnit.Months;
project.Set(Prj.TimescaleStart, new DateTime(2012, 8, 6));

// Customize middle tier dates
view.MiddleTimescaleTier.DateTimeConverter =
date => new[] { "Янв.", "Фев.", "Мар.", "Апр.", "Май", "Июнь", "Июль", "Авг.", "Сен.", "Окт.", "Ноя.", "Дек." }[date.Month - 1];
project.Save("CustomizeTimescaleTierLabels_out.pdf", SaveFileFormat.PDF);

Цей фрагмент демонструє, як динамічно форматувати підписи шкали часу, забезпечуючи дотримання локалізованих форматів дат у експортованих поданнях проєкту.

Налаштування параметрів шкали часу для конкретного подання

Клас TimescaleTier дозволяє розробникам визначати точні налаштування шкали часу для подання проєкту. Наведений нижче приклад показує, як відрегулювати нижній і середній рівні та відобразити проєкт із цими налаштуваннями.

	Project project = new Project();
	GanttChartView view = (GanttChartView)project.Views.First(v => v.Name == "&Gantt Chart");

	// Configure timescale tiers
	view.BottomTimescaleTier.Count = 2;
	view.BottomTimescaleTier.ShowTicks = false; 
	view.BottomTimescaleTier.Unit = TimescaleUnit.Days;
	view.BottomTimescaleTier.Label = DateLabel.DayDdd;

	view.MiddleTimescaleTier.Count = 1;
	view.MiddleTimescaleTier.Unit = TimescaleUnit.Weeks;
	view.MiddleTimescaleTier.Label = DateLabel.WeekDddDd;

	// Save with custom timescale settings
	PdfSaveOptions saveOptions = new PdfSaveOptions();
	saveOptions.ViewSettings = view;
	saveOptions.Timescale = Timescale.DefinedInView;
	project.Save("SetTimeScaleCount_out.pdf", saveOptions);

Це дозволяє генерувати вихідні дані проєкту, де гранулярність часу відповідає вимогам звітності.

Підтримка стилізації тексту

Стилізацію тексту можна застосувати до подань діаграми Ганта за допомогою TableTextStyle класу. Наведений нижче код демонструє, як задати власне форматування тексту:

Project project = new Project("New Project.mpp");
GanttChartView ganttChartView = project.Views.ToList()[0] as GanttChartView;
if (ganttChartView != null)
{
    ganttChartView.TableTextStyles.Clear();
    ganttChartView.TableTextStyles.Add(new TableTextStyle(1) { Color = Color.Red, Field = Field.TaskName });
    ganttChartView.TableTextStyles.Add(new TableTextStyle(1) { Color = Color.Gray, Field = Field.TaskDurationText });
    ganttChartView.TableTextStyles.Add(new TableTextStyle(2) { Color = Color.Blue, FontStyle = FontStyle.Bold | FontStyle.Italic | FontStyle.Underline });
}

Ця можливість корисна для виділення ключових полів або покращення читабельності експортованих документів проєкту.

Збереження MPP із використанням конкретного подання проєкту

Aspose.Tasks дозволяє зберігати файл MPP у графічні формати, використовуючи конкретне подання, визначене в проєкті. Ця можливість корисна, коли існує кілька подань і необхідно експортувати лише одне з них.

	Project project = new Project("TestViews.mpp");
	var view = project.Views.First(v => v.Name == "Customized Resource &Sheet");
	view.PageInfo.PageSettings.IsPortrait = false;

	PdfSaveOptions saveOptions = new PdfSaveOptions();
	saveOptions.ViewSettings = view;
	project.Save("output.pdf", saveOptions);

Це забезпечує гнучкість під час експорту адаптованих подань для різних зацікавлених сторін.

Робота зі стилями смуг у поданні діаграми Ганта

Подання діаграми Ганта підтримує як стилі смуг для конкретних завдань, так і стилі за категоріями.
Наведений код показує, як змінити їх для кращої візуалізації.

	Project project = new Project("TestGanttChartView.mpp");
	var ganttChartView = (GanttChartView)project.Views.First(v => v.Name == "Gantt &Chart");

	PdfSaveOptions saveOptions = new PdfSaveOptions();
	saveOptions.ViewSettings = ganttChartView;
	saveOptions.Timescale = Timescale.DefinedInView;

	// Modify custom bar styles
	foreach (GanttBarStyle ganttBarStyle in ganttChartView.CustomBarStyles)
	{
		if (ganttBarStyle.ShowForTaskUid == 11)
		{
			ganttBarStyle.LeftField = Field.TaskName;
			ganttBarStyle.InsideBarTextConverter = task => "Hours rem.: " + 
				(int)task.Get(Tsk.RemainingWork).TimeSpan.TotalHours;
		}
	}

Налаштовуючи стилі смуг, ви можете виділяти завдання, етапи та індикатори прогресу в експортованих поданнях проєкту.

Висновок

Aspose.Tasks for .NET надає широкі можливості для роботи з поданнями проєкту. Розробники можуть читати та налаштовувати діаграми Ганта, конфігурувати рівні шкали часу, застосовувати стилі тексту, зберігати файли MPP з конкретними поданнями та змінювати стилі смуг. Ці можливості дозволяють створювати високо налаштовані звіти й забезпечувати відповідність експортованих даних проєкту бізнес-вимогам та вимогам презентації.

Швидкі посилання

• Друк сторінок проєкту у окремі файли
• Видалити проміжок між списком завдань і нижнім колонтитулом
• Відтворення приміток під час конвертації подань проєкту

Часті запитання

П: Чи потрібно встановлювати Microsoft Project, щоб працювати з поданнями?

• Ні. Aspose.Tasks for .NET працює незалежно від Microsoft Project.

П: Чи можу я налаштувати, які поля відображаються на діаграмі Ганта?

• Так. Ви можете налаштувати таблиці так, щоб вони автоматично показували вибрані користувацькі поля.

П: Чи підтримує Aspose.Tasks локалізовані підписи шкали часу?

• Так. Підписи рівнів шкали часу можна налаштувати відповідно до поточної локалі CultureInfo.

П: Чи можливо експортувати лише одне подання з файлу проєкту?

• Так. Ви можете вибрати конкретне подання та експортувати його у формати PDF, зображення або HTML.

П: Чи можна програмно налаштовувати стилі смуг на діаграмах Ганта?

• Так. Як стилі смуг для окремих завдань, так і стилі за категоріями можна змінювати через API.