Aspose의 유틸리티 기능 C ++ 용 작업

중요한 경로 계산

중요한 경로는 궁극적으로 프로젝트가 종료 될시기를 결정하는 작업 또는 작업입니다. 중요한 경로와 그들에게 할당 된 자원을 추적하면 프로젝트를 제 시간에 유지하는 데 도움이됩니다. Microsoft Project는 슬랙이없는 작업에 따라 중요 경로를 계산하거나 특정 날짜 제약 조건 (가능한 빨리 또는 가능한 빨리 또는 가능한 한 빨리 또는 늦게 마무리해야 함) 또는 프로젝트와 동일하거나 그 날짜를 갖는 작업을 계산합니다. Aspose.Tasks 를 사용하면 중요한 경로를 계산할 수 있습니다.

프로젝트 클래스는 프로젝트의 중요한 경로를 구성하는 작업 모음을 검색하는 데 사용되는 Critical Path 속성을 제공합니다. 다음 코드 조각은 임계 경로에서 작업을 계산하고 표시합니다.

System::SharedPtr<Project> project = System::MakeObject<Project>(dataDir + u"CalculateCriticalPath.mpp");
project->set_CalculationMode(Aspose::Tasks::CalculationMode::Automatic);
    
System::SharedPtr<Task> subtask1 = project->get_RootTask()->get_Children()->Add(u"1");
System::SharedPtr<Task> subtask2 = project->get_RootTask()->get_Children()->Add(u"2");
System::SharedPtr<Task> subtask3 = project->get_RootTask()->get_Children()->Add(u"3");
project->get_TaskLinks()->Add(subtask1, subtask2, Aspose::Tasks::TaskLinkType::FinishToStart);
    
// Display the critical path now
    
{
    auto task_enumerator = (project->get_CriticalPath())->GetEnumerator();
    decltype(task_enumerator->get_Current()) task;
    while (task_enumerator->MoveNext() && (task = task_enumerator->get_Current(), true))
    {
        System::Console::WriteLine(task->Get(Tsk::Name()));
    }
}

Printing the TaskWritingException

A project consists of a number of tasks and Aspose.Tasks for C++ API allows adding, removing and updating task information. If there’s a problem when writing tasks, use TasksWritingException to catch them.

Aspose.Tasks for C++ supports printing a message when there’s an exception in writing a task. This is done with TaskWritingException, in a similar way to how TaskReadingException is used.

The log message is contained in the public property TasksWritingException.LogText, as shown in the following code example.

try
{
    System::SharedPtr<Project> project = System::MakeObject<Project>(dataDir + u"PrintTaskWritingException.mpp");
    System::Console::Write(u"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(dataDir + u"project_out.MPP", Aspose::Tasks::Saving::SaveFileFormat::MPP);
}
catch (TasksWritingException& ex)
{
    System::Console::WriteLine(ex->get_LogText());
}
catch (System::NotSupportedException& ex)
{
    System::Console::WriteLine(ex->get_Message() + u"\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.");
}
    

Working with Filter Data from MPP Files

Aspose.Tasks allows developers to read information about filters applied to MPP file data. This article shows how to retrieve filter definition and filter criteria data from a Microsoft Project MPP file.

Reading Filter Definition Data

// Instantiate project and access task filters
System::SharedPtr<Project> project = System::MakeObject<Project>(dataDir + u"ReadFilterDefinitionData.mpp");
System::SharedPtr<System::Collections::Generic::List<System::SharedPtr<Filter>>> taskFilters = project->get_TaskFilters()->ToList();
System::Console::WriteLine(System::String(u"Task Filters Count: ") + taskFilters->get_Count());
System::Console::WriteLine(System::String(u"All Tasks: ") + taskFilters->idx_get(0)->get_Name());
System::Console::WriteLine(System::String(u"Task Item: ") + System::ObjectExt::ToString(taskFilters->idx_get(0)->get_FilterType()));
System::Console::WriteLine(System::String(u"Task Filters Show In Menu: ") + taskFilters->idx_get(0)->get_ShowInMenu());
System::Console::WriteLine(System::String(u"Task filter ShowRelatedSummaryRows: ") + taskFilters->idx_get(0)->get_ShowRelatedSummaryRows());
    
// Access resource filters
System::SharedPtr<System::Collections::Generic::List<System::SharedPtr<Filter>>> rscFilters = project->get_ResourceFilters()->ToList();
System::Console::WriteLine(System::String(u"Project.ResourceFilters count: ") + rscFilters->get_Count());
System::Console::WriteLine(System::String(u"Resource Filter Item Type: Item.ResourceType: ") + System::ObjectExt::ToString(rscFilters->idx_get(0)->get_FilterType()));
System::Console::WriteLine(System::String(u"Resource filter ShowInMenu") + rscFilters->idx_get(0)->get_ShowInMenu());
System::Console::WriteLine(System::String(u"Resource filter ShowRelatedSummaryRows: ") + rscFilters->idx_get(0)->get_ShowRelatedSummaryRows());

Reading Filter Criteria Data

System::SharedPtr<Project> project = System::MakeObject<Project>(dataDir + u"Project2003.mpp");
    
System::SharedPtr<Filter> filter = project->get_TaskFilters()->ToList()->idx_get(1);
System::Console::WriteLine(filter->get_Criteria()->get_CriteriaRows()->get_Count());
System::Console::WriteLine(System::ObjectExt::ToString(filter->get_Criteria()->get_Operation()));
    
System::SharedPtr<FilterCriteria> criteria1 = filter->get_Criteria()->get_CriteriaRows()->idx_get(0);
System::Console::WriteLine(System::ObjectExt::ToString(criteria1->get_Test()));
System::Console::WriteLine(System::ObjectExt::ToString(criteria1->get_Field()));
System::Console::WriteLine(System::ObjectExt::ToString(criteria1->get_Values()[0]));
    
System::SharedPtr<FilterCriteria> criteria2 = filter->get_Criteria()->get_CriteriaRows()->idx_get(1);
System::Console::WriteLine(System::ObjectExt::ToString(criteria2->get_Operation()));
System::Console::WriteLine(criteria2->get_CriteriaRows()->get_Count());
    
System::SharedPtr<FilterCriteria> criteria21 = criteria2->get_CriteriaRows()->idx_get(0);
System::Console::WriteLine(System::ObjectExt::ToString(criteria21->get_Test()));
System::Console::WriteLine(System::ObjectExt::ToString(criteria21->get_Field()));
System::Console::WriteLine(System::ObjectExt::ToString(criteria21->get_Values()[0]));
    
System::SharedPtr<FilterCriteria> criteria22 = criteria2->get_CriteriaRows()->idx_get(1);
System::Console::WriteLine(System::ObjectExt::ToString(criteria22->get_Test()));
System::Console::WriteLine(System::ObjectExt::ToString(criteria22->get_Field()));
System::Console::WriteLine(System::ObjectExt::ToString(criteria22->get_Values()[0]));
System::Console::WriteLine(filter->get_Criteria());

Reading Group Definition Data

A Microsoft Project data file may contain data in groups. Aspose.Tasks provides the facility to read the group definition data as shown in the below example.

System::SharedPtr<Project> project = System::MakeObject<Project>(dataDir + u"ReadGroupDefinitionData.mpp");
    
System::Console::WriteLine(System::String(u"Task Groups Count: ") + project->get_TaskGroups()->get_Count());
System::SharedPtr<Group> taskGroup = project->get_TaskGroups()->ToList()->idx_get(1);
System::Console::WriteLine(u"Group Name:", System::ObjectExt::Box<System::String>(taskGroup->get_Name()));
System::Console::WriteLine(System::String(u"Group Criteria count: ") + taskGroup->get_GroupCriteria()->get_Count());
System::Console::WriteLine(u"\n************* Retrieving Task Group's Criterion information *************");
System::SharedPtr<GroupCriterion> criterion = taskGroup->get_GroupCriteria()->ToList()->idx_get(0);
System::Console::WriteLine(System::String(u"Criterion Field: ") + System::ObjectExt::ToString(criterion->get_Field()));
System::Console::WriteLine(System::String(u"Criterion GroupOn: ") + System::ObjectExt::ToString(criterion->get_GroupOn()));
System::Console::WriteLine(System::String(u"Criterion Cell Color: ") + criterion->get_CellColor());
System::Console::WriteLine(System::String(u"Criterion Pattern: ") + System::ObjectExt::ToString(criterion->get_Pattern()));
    
if (taskGroup == criterion->get_ParentGroup())
{
    System::Console::WriteLine(u"Parent Group is equval to task Group.");
}
    
System::Console::WriteLine(u"\n*********** Retreivnig Criterion's Font Information ***********");
System::Console::WriteLine(System::String(u"Font Name: ") + criterion->get_Font()->get_Name());
System::Console::WriteLine(System::String(u"Font Size: ") + criterion->get_Font()->get_Size());
System::Console::WriteLine(System::String(u"Font Style: ") + System::ObjectExt::ToString(criterion->get_Font()->get_Style()));
System::Console::WriteLine(System::String(u"Ascending/Dscending: ") + criterion->get_Ascending());

Reading Table Data from MPP File

The Aspose.Tasks for C++ API supports reading table data from Microsoft Project data files. Project.Tables implements the ICollection interface to provide access to an MPP file’s table data. The feature is supported for all versions of Microsoft Project data files, including MPP 2003, 2007, 2010 and 2013.

The below example shows how to retrieve table data from a Microsoft Project MPP file. The values of table properties such as width, title, title alignment and data alignment are displayed here for demonstration.

System::SharedPtr<Project> project = System::MakeObject<Project>(dataDir + u"ReadTableData.mpp");
    
// Access table
System::SharedPtr<Table> task1 = project->get_Tables()->ToList()->idx_get(0);
System::Console::WriteLine(System::String(u"Table Fields Count") + task1->get_TableFields()->get_Count());
    
// Display all table fields information
    
{
    auto tableField_enumerator = (task1->get_TableFields())->GetEnumerator();
    decltype(tableField_enumerator->get_Current()) tableField;
    while (tableField_enumerator->MoveNext() && (tableField = tableField_enumerator->get_Current(), true))
    {
        System::Console::WriteLine(System::String(u"Field width: ") + tableField->get_Width());
        System::Console::WriteLine(System::String(u"Field Title: ") + tableField->get_Title());
        System::Console::WriteLine(System::String(u"Field Title Alignment: ") + System::ObjectExt::ToString(tableField->get_AlignTitle()));
        System::Console::WriteLine(System::String(u"Field Align Data: ") + System::ObjectExt::ToString(tableField->get_AlignData()));
    }
}

Extracting Embedded Objects from Task or Review form

Microsoft Project data files (MPP/XML) may contain embedded objects such as documents, excel sheets, PDF, images etc. in Task or Resource views. Aspose.Tasks for C++ API provides the capability to extract these from a project’s Task or Resource view as shown in the below topics.

Extracting Embedded Objects

Embedded objects (those which were created from the file by selecting a file path) are packed into OLE Package inside MPP file. To extract the original file you can use Content and FullPath properties of an instance of the OleObject class.

System::SharedPtr<Project> project = System::MakeObject<Project>(dataDir + u"ExtractEmbeddedObjects.mpp");
System::SharedPtr<OleObject> ole = project->get_OleObjects()->ToList()->idx_get(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 (!System::String::IsNullOrEmpty(ole->get_FullPath()))
{
    {
        System::SharedPtr<System::IO::FileStream> fileStream = System::MakeObject<System::IO::FileStream>(dataDir, System::IO::FileMode::Create);
        // Clearing resources under 'using' statement
        System::Details::DisposeGuard<1> __dispose_guard_0({ fileStream});
        // ------------------------------------------
        
        try
        {
            fileStream->Write(ole->get_Content(), 0, ole->get_Content()->get_Length());
        }
        catch(...)
        {
            __dispose_guard_0.SetCurrentException(std::current_exception());
        }
    }
}

Embedded objects which were created inside Microsoft Project application can be extracted this way:

System::SharedPtr<System::Collections::Generic::IDictionary<System::String, System::String>> fileFormatExt = System::MakeObject<System::Collections::Generic::Dictionary<System::String, System::String>>();
fileFormatExt->Add(u"RTF", u"_rtfFile_out.rtf");
fileFormatExt->Add(u"MSWordDoc", u"_wordFile_out.docx");
fileFormatExt->Add(u"ExcelML12", u"_excelFile_out.xlsx");
        
System::SharedPtr<Project> project = System::MakeObject<Project>(dataDir + u"Embedded.mpp");
        
        
{
    auto oleObject_enumerator = (project->get_OleObjects())->GetEnumerator();
    decltype(oleObject_enumerator->get_Current()) oleObject;
    while (oleObject_enumerator->MoveNext() && (oleObject = oleObject_enumerator->get_Current(), true))
    {
        if (!System::String::IsNullOrEmpty(oleObject->get_FileFormat()) && fileFormatExt->ContainsKey(oleObject->get_FileFormat()))
        {
            System::String path = dataDir + u"EmbeddedContent_" + fileFormatExt->idx_get(oleObject->get_FileFormat());
            {
                System::SharedPtr<System::IO::FileStream> fileStream = System::MakeObject<System::IO::FileStream>(path, System::IO::FileMode::Create);
                // Clearing resources under 'using' statement
                System::Details::DisposeGuard<1> __dispose_guard_0({ fileStream});
                // ------------------------------------------
                
                try
                {
                    fileStream->Write(oleObject->get_Content(), 0, oleObject->get_Content()->get_Length());
                }
                catch(...)
                {
                    __dispose_guard_0.SetCurrentException(std::current_exception());
                }
            }
        }
    }
}