Allgemeine Projekteigenschaften

Arbeiten mit allgemeinen Projekteigenschaften

Microsoft Project speichert für jedes Projekt Projekteigenschaften, Metadaten. Die Eigenschaften umfassen die Start- und Enddaten des Projekts, das aktuelle Datum und das Statusdatum, die Art des verwendeten Kalenders und wenn ein Projekt geplant ist. Mit ASSOSPE.Beaks für C ++ können Sie Projekteigenschaften wie nachstehend beschrieben lesen und festlegen.

Projektinformationen lesen

Die Projekt Klasse hat eine Reihe von Eigenschaften, die sich mit Projekteigenschaften befassen:

• StartDate: Das Startdatum des Projekts des Datentyps DateTime.

• FinishDate: Das Enddatum des Projekts des Datentyps DateTime.

• CurrentDate: Das aktuelle Datum des Datentyps DateTime.

• Statusdate: Das Datum, an dem der Fortschritt des Projekts gemeldet wird, vom Datentyp der DateTime.

• ScheduleFromStart: defines whether the project is scheduled from the start or end data and takes a Boolean value.

• Calendar: the type of calendar used by the project, managed through the Aspose.Tasks.Calendar class.

To read project properties in Microsoft Project, click Project Information on the Project menu.

The code example given below demonstrates how to read and output the project start and end date, whether the project is scheduled from the start or end, author, last author, revision, keywords and comments.

// The path to the documents directory.
System::String dataDir = RunExamples::GetDataDir(System::Reflection::MethodBase::GetCurrentMethod(ASPOSE_CURRENT_FUNCTION)->get_DeclaringType().get_FullName());
    
// Create a project reader instance
System::SharedPtr<Project> project = System::MakeObject<Project>(dataDir + u"ReadProjectInfo.mpp");
    
// Display project information
if (NullableBool::to_Boolean(project->Get<NullableBool>(Prj::ScheduleFromStart())))
{
    System::Console::WriteLine(System::String(u"Project Finish Date : ") + project->Get<System::DateTime>(Prj::StartDate()).ToShortDateString());
}
else
{
    System::Console::WriteLine(System::String(u"Project Finish Date : ") + project->Get<System::DateTime>(Prj::FinishDate()).ToShortDateString());
}
System::Console::WriteLine(project->Get<System::String>(Prj::Author()));
System::Console::WriteLine(project->Get<System::String>(Prj::LastAuthor()));
System::Console::WriteLine(project->Get<int32_t>(Prj::Revision()));
System::Console::WriteLine(project->Get<System::String>(Prj::Keywords()));
System::Console::WriteLine(project->Get<System::String>(Prj::Comments()));
System::Console::WriteLine(u"The program has run successfully");

Writing Project Information

Aspose.Tasks for C++ can write as well as read project information. The code example given below demonstrates how to set author, last author, revision, keywords and comments.

try
{
    // The path to the documents directory.
    System::String dataDir = RunExamples::GetDataDir(System::Reflection::MethodBase::GetCurrentMethod(ASPOSE_CURRENT_FUNCTION)->get_DeclaringType().get_FullName());
    
    // Create project from template file
    System::SharedPtr<Project> project = System::MakeObject<Project>(dataDir + u"WriteProjectInfo.mpp");
    
    // Set project information
    project->Set<System::String>(Prj::Author(), u"Author");
    project->Set<System::String>(Prj::LastAuthor(), u"Last Author");
    project->Set<int32_t>(Prj::Revision(), 15);
    project->Set<System::String>(Prj::Keywords(), u"MSP Aspose");
    project->Set<System::String>(Prj::Comments(), u"Comments");
    project->Save(dataDir + u"WriteProjectInfo_out.mpp", Aspose::Tasks::Saving::SaveFileFormat::MPP);
}
catch (System::Exception& 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.");
}
    

Determining Project Version

Aspose.Tasks for C++ API provides the capability to retrieve project file information with simple API calls. The Project class’s Get method facilitates users to retrieve information using the static class Prj that exposes a number of properties related to the Project class. This topic shows how to retrieve version information.

The SaveVersion and LastSaved properties exposed by the Prj class are used to determine the project version and the date when the project was last saved. SaveVersion supports the Integer datatype, whereas LastSaved supports the DateTime datatype.

// The path to the documents directory.
System::String dataDir = RunExamples::GetDataDir(System::Reflection::MethodBase::GetCurrentMethod(ASPOSE_CURRENT_FUNCTION)->get_DeclaringType().get_FullName());
    
// Read project from template file
System::SharedPtr<Project> project = System::MakeObject<Project>(dataDir + u"DetermineProjectVersion.mpp");
    
// Display project version
System::Console::WriteLine(System::String(u"Project Version : ") + System::Convert::ToString(project->Get<int32_t>(Prj::SaveVersion())));
System::Console::WriteLine(System::String(u"Last Saved : ") + project->Get<System::DateTime>(Prj::LastSaved()).ToShortDateString());

Writing Project Summary Information

Most programs save summary information with the files they save. Microsoft Project is no different. As well as the name of the author, the date the project was created and the last time it was edited and saved, it saves keywords, subject, comments and more. Aspose.Tasks for C++ lets you both read and write this type of information.

The Project’s class Set method can be used to write and Get method can be used to read Project summary information using the Prj class’s members. The file can be saved back after updating the summary information. To update the project summary information of an existing MPP file:

1. Create an instance of Project class

2. Set the various properties exposed by the Prj class to define summary information.

3. Save the Project using the Save method of Project class

To see the file’s summary information:

1. Find the file in a file browser.

2. Right-click the file and select Properties.

3. Go to the Details tab.

The code example given below demonstrates how to write a project summary information to the MPP file.

// The path to the documents directory.
System::String dataDir = RunExamples::GetDataDir(System::Reflection::MethodBase::GetCurrentMethod(ASPOSE_CURRENT_FUNCTION)->get_DeclaringType().get_FullName());
        
// Instantiate Project class
System::SharedPtr<Project> project = System::MakeObject<Project>(dataDir + u"WriteMPPProjectSummary.mpp");
        
// Set project summary
project->Set<System::String>(Prj::Author(), u"Author");
project->Set<System::String>(Prj::LastAuthor(), u"Last Author");
project->Set<int32_t>(Prj::Revision(), 15);
project->Set<System::String>(Prj::Keywords(), u"MSP Aspose");
project->Set<System::String>(Prj::Comments(), u"Comments");
project->Save(dataDir + u"WriteMPPProjectSummary_out.mpp", Aspose::Tasks::Saving::SaveFileFormat::MPP);