Вспомогательные возможности Aspose.Tasks for .NET

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

Расчет критического пути

Критический путь — это задачи (или задача), которые в конечном итоге определяют, когда завершится ваш проект. Отслеживание критического пути и ресурсов, назначенных на эти задачи, помогает своевременно завершать проект. Microsoft Project вычисляет критический путь на основе задач, не имеющих резерва времени, имеющих конкретные временные ограничения (начать в указанную дату, закончить в указанную дату, как можно раньше или как можно позже) либо имеющих дату окончания, совпадающую или более позднюю, чем у проекта. Aspose.Tasks позволяет вычислять критический путь.

Класс Project предоставляет CriticalPath свойство, которое используется для получения коллекции задач, составляющих критический путь проекта. Приведенный ниже фрагмент кода вычисляет и отображает задачи в критическом пути.

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

Task subtask1 = project.RootTask.Children.Add("1");
Task subtask2 = project.RootTask.Children.Add("2");
Task subtask3 = project.RootTask.Children.Add("3");
project.TaskLinks.Add(subtask1, subtask2, TaskLinkType.FinishToStart);

// Display the critical path now
foreach (Task task in project.CriticalPath)
{
    Console.WriteLine(task.Get(Tsk.Name));
}

Отображение TaskWritingException

Проект состоит из множества задач, и Aspose.Tasks for .NET API позволяет добавлять, удалять и обновлять информацию о задачах. Если при записи задач возникает проблема, используйте TasksWritingException для их перехвата.

Aspose.Tasks for .NET поддерживает вывод сообщения при возникновении исключения при записи задачи. Для этого используется TaskWritingException, аналогично тому, как применяется TaskReadingException.

Сообщение журнала содержится в публичном свойстве TasksWritingException.LogText, как показано в следующем примере кода.

try
{
    Project project = new Project("New Project.mpp");
    Console.Write("This example will only work if you apply a valid Aspose License. You can purchase full license or get 30 day temporary license from http://www.aspose.com/purchase/default.aspx.");
    project.Save("output.mpp", SaveFileFormat.MPP);
}
catch (TasksWritingException ex)
{
    Console.WriteLine(ex.LogText);
}
catch (NotSupportedException ex)
{
    Console.WriteLine(ex.Message + "\nThis example will only work if you apply a valid Aspose License. You can purchase full license or get 30 day temporary license from http://www.aspose.com/purchase/default.aspx.");
}

Работа с данными фильтров в файлах MPP

Aspose.Tasks позволяет разработчикам читать информацию о фильтрах, примененных к данным файлов MPP. В этой статье показано, как получить данные об определениях фильтров и критериях фильтров из файла Microsoft Project MPP.

Чтение данных об определениях фильтров

Определения фильтров в Microsoft Project описывают структуру фильтров — например их названия, типы и поля, к которым они применяются. С помощью Aspose.Tasks for .NET вы можете программно получить доступ к этим определениям фильтров и исследовать, как фильтры настроены в файле MPP.

// Instantiate project and access task filters
Project project = new Project("ReadFilterDefinitionData.mpp");
List<Filter> taskFilters = project.TaskFilters.ToList();
Console.WriteLine("Task Filters Count: " + taskFilters.Count);
Console.WriteLine("All Tasks: " + taskFilters[0].Name);
Console.WriteLine("Task Item: " + taskFilters[0].FilterType);
Console.WriteLine("Task Filters Show In Menu: " + taskFilters[0].ShowInMenu);
Console.WriteLine("Task filter ShowRelatedSummaryRows: " + taskFilters[0].ShowRelatedSummaryRows);

// Access resource filters
List<Filter> filters = project.ResourceFilters.ToList();
Console.WriteLine("Project.ResourceFilters count: " + filters.Count);
Console.WriteLine("Resource Filter Item Type: Item.ResourceType: " + filters[0].FilterType);
Console.WriteLine("Resource filter ShowInMenu" + filters[0].ShowInMenu);
Console.WriteLine("Resource filter ShowRelatedSummaryRows: " + filters[0].ShowRelatedSummaryRows);

Чтение данных критериев фильтра

Если определения описывают структуру фильтра, то критерии фильтра задают точные условия, применяемые к данным проекта (например, задачи с определенными датами или ресурсами). Aspose.Tasks позволяет читать эти критерии из файла MPP, что особенно полезно при воспроизведении или анализе пользовательских представлений, используемых в Microsoft Project.

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

Filter filter = project.TaskFilters.ToList()[1];
Console.WriteLine(filter.Criteria.CriteriaRows.Count);
Console.WriteLine(filter.Criteria.Operation.ToString());

FilterCriteria criteria1 = filter.Criteria.CriteriaRows[0];
Console.WriteLine(criteria1.Test.ToString());
Console.WriteLine(criteria1.Field.ToString());
Console.WriteLine(criteria1.Values[0].ToString());

FilterCriteria criteria2 = filter.Criteria.CriteriaRows[1];
Console.WriteLine(criteria2.Operation.ToString());
Console.WriteLine(criteria2.CriteriaRows.Count);

FilterCriteria criteria21 = criteria2.CriteriaRows[0];
Console.WriteLine(criteria21.Test.ToString());
Console.WriteLine(criteria21.Field.ToString());
Console.WriteLine(criteria21.Values[0].ToString());

FilterCriteria criteria22 = criteria2.CriteriaRows[1];
Console.WriteLine(criteria22.Test.ToString());
Console.WriteLine(criteria22.Field.ToString());
Console.WriteLine(criteria22.Values[0].ToString());
Console.WriteLine(filter.Criteria);

Чтение данных определений групп

Файл данных Microsoft Project может содержать данные, организованные в группы. Aspose.Tasks for .NET предоставляет возможность читать данные определений групп, как показано в примере ниже.

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

Console.WriteLine("Task Groups Count: " + project.TaskGroups.Count);

Group taskGroup = project.TaskGroups.ToList()[1];
Console.WriteLine("Group Name:", taskGroup.Name);
Console.WriteLine("Group Criteria count: " + taskGroup.GroupCriteria.Count);
Console.WriteLine("************* Retrieving Task Group's Criterion information *************");

GroupCriterion criterion = taskGroup.GroupCriteria.ToList()[0];
Console.WriteLine("Criterion Field: " + criterion.Field.ToString());
Console.WriteLine("Criterion GroupOn: " + criterion.GroupOn.ToString());
Console.WriteLine("Criterion Cell Color: " + criterion.CellColor);
Console.WriteLine("Criterion Pattern: " + criterion.Pattern.ToString());

if (taskGroup == criterion.ParentGroup)
{
    Console.WriteLine("Parent Group is equal to task Group.");
}

Console.WriteLine("*********** Retrieving Criterion's Font Information ***********");
Console.WriteLine("Font Name: " + criterion.Font.Name);
Console.WriteLine("Font Size: " + criterion.Font.Size);
Console.WriteLine("Font Style: " + criterion.Font.Style);
Console.WriteLine("Ascending/Descending: " + criterion.Ascending);

Чтение данных таблицы из файла MPP

Aspose.Tasks for .NET API поддерживает чтение данных таблиц из файлов данных Microsoft Project. Project.Tables реализует интерфейс ICollection для обеспечения доступа к данным таблиц в файле MPP. Функция поддерживается для всех версий файлов данных Microsoft Project, включая MPP 2003, 2007, 2010 и 2013.

Приведенный ниже пример показывает, как получить данные таблицы из файла Microsoft Project MPP. Здесь демонстрируются значения свойств таблицы, такие как ширина, заголовок, выравнивание заголовка и выравнивание данных.

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

// Access table
Table task1 = project.Tables.ToList()[0];
Console.WriteLine("Table Fields Count" + task1.TableFields.Count);

// Display all table fields information
foreach (TableField tableField in task1.TableFields)
{
    Console.WriteLine("Field width: " + tableField.Width);
    Console.WriteLine("Field Title: " + tableField.Title);
    Console.WriteLine("Field Title Alignment: " + tableField.AlignTitle.ToString());
    Console.WriteLine("Field Align Data: " + tableField.AlignData.ToString());
}

Извлечение встроенных объектов из формы задачи или обзора

Файлы данных Microsoft Project (MPP/XML) могут содержать встроенные объекты, такие как документы, листы Excel, PDF, изображения и т.д. в представлениях задач или ресурсов. Aspose.Tasks for .NET API предоставляет возможность извлечения этих объектов из представления задач или ресурсов проекта, как показано в приведенных ниже темах.

Извлечение встроенных объектов

Встроенные объекты (те, которые были созданы из файла путем выбора пути к файлу) упакованы в OLE Package внутри файла MPP. Для извлечения исходного файла можно использовать свойства Content и FullPath экземпляра класса OleObject.

Project project = new Project("ExtractEmbeddedObjects.mpp");
OleObject ole = project.OleObjects.ToList()[0];
// We have to check this property because it can be null if the embedded object was created inside the ms project application Or, alternatively, you can use this check: if (ole.FileFormat == "Package")
if (!string.IsNullOrEmpty(ole.FullPath))
{
    using (FileStream stream = new FileStream("out.ole", FileMode.Create))
    {
        stream.Write(ole.Content, 0, ole.Content.Length);
    }
}

Встроенные объекты, созданные внутри приложения Microsoft Project, можно извлечь следующим образом:

IDictionary<string, string> fileFormatExt = new Dictionary<string, string>();
fileFormatExt.Add("RTF", "_rtfFile_out.rtf");
fileFormatExt.Add("MSWordDoc", "_wordFile_out.docx");
fileFormatExt.Add("ExcelML12", "_excelFile_out.xlsx");
Project project = new Project("New Project.mpp"); 
foreach (OleObject oleObject in project.OleObjects)
{
    if (!string.IsNullOrEmpty(oleObject.FileFormat) && fileFormatExt.ContainsKey(oleObject.FileFormat))
    {
        using (FileStream stream = new FileStream("EmbeddedContent_" + fileFormatExt[oleObject.FileFormat], FileMode.Create))
        {
            stream.Write(oleObject.Content, 0, oleObject.Content.Length);
        }
    }
}

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