Erweiterte Attribute eines Projekts

Microsoft Project verfügt über ein umfangreiches XML -Daten -Interchange -Schema, das den Austausch von Informationen zwischen Anwendungen und Programmieren mit Projektdateien erleichtert. Mit dem Schema können Sie Aufgaben, Ressourcen und Aufgaben erweiterte Attribute hinzufügen. Dieser Artikel zeigt, wie man mit erweiterten Attributen mit Aspose.Tasks arbeitet.

Arbeiten mit benutzerdefinierten Feldern mit Microsoft Project

In diesem Beispiel werden wir demonstrieren, wie mit Text1 erweitertes Attribut eines Projekts für die Verbindung der Informationen mit einer Aufgabe funktioniert.

1. Gehen Sie in MSP zu Projekt-> benutzerdefinierte Felder.
2. Wählen Sie hier die Aufgabe aus.
3. Wählen Sie Text als benutzerdefiniertes Feldtyp aus dem Kombinationstyp Typ.
4. Wählen Sie Text1 als benutzerdefiniertes Feld, mit dem Sie arbeiten möchten
5. Verwenden Sie die Schaltfläche “Umbenennen”, um den Alias ​​des Feldes umzubenennen, wenn es gewünscht ist, und drücken Sie die OK -Taste
6. Fügen Sie eine neue Aufgabe hinzu und fügen Sie eine neue Spalte in die Task -Zeile mit dem benutzerdefinierten Feld hinzu, das Sie im obigen Schritt verwendet haben

Arbeiten mit benutzerdefinierten Feldern/erweiterten Attributen mit Aspose.Tasks für c ++ api

Aspose.TasksS FÜR C ++ API bietet die Fähigkeit, neue erweiterte Attribute zu erstellen und mit erweiterten Attributen zu arbeiten, die bereits in einem Dokument vorhanden sind. Benutzerdefinierte Felder oder erweiterte Attribute werden durch die Erfassung eines Projekts in Aspose.Tasks dargestellt. Es enthält alle erweiterten Attribute Definition eines Projektdokuments. Einige der Zuordnungen der msp -benutzerdefinierten Felddefinition sind wie im folgenden Bild gezeigt.

Erstellen eines neuen erweiterten Attributs und Hinzufügen zu Aufgabe

Um ein neues erweitertes Attribut für Aufgabe oder Ressource hinzuzufügen, müssen wir zunächst die erweiterte Attributdefinition zur Erfassung von ExtendedAttributes definieren und hinzufügen. Die ExtendedAttributeDeFinition -Klasse wird verwendet, um eine neue ExtendedAttribute in einem Projekt zu definieren. Das FieldID muss für die ordnungsgemäße Definition eines erweiterten Attributs festgelegt werden, das mit ExtendedAttribUTETASK (im Falle von Aufgabe) oder ExtendedAttributeresource (im Fall von Ressource) verknüpft ist. Der folgende Beispielcode zeigt, wie ein neues erweitertes Attribut für Text1 -Projektfeld definiert wird. Sobald die erweiterte Attributdefinition abgeschlossen ist, können Sie nun ein neues erweitertes Attribut daraus erstellen und einer Aufgabe zuweisen.

System::SharedPtr<Project> project1 = System::MakeObject<Project>(dataDir + u"Blank2010.mpp");
        
System::SharedPtr<ExtendedAttributeDefinition> myTextAttributeDefinition = project1->get_ExtendedAttributes()->GetById((int32_t)Aspose::Tasks::ExtendedAttributeTask::Text1);
        
// If the Custom field doesn't exist in Project, create it
if (myTextAttributeDefinition == nullptr)
{
    myTextAttributeDefinition = ExtendedAttributeDefinition::CreateTaskDefinition(Aspose::Tasks::ExtendedAttributeTask::Text1, u"My text field");
    project1->get_ExtendedAttributes()->Add(myTextAttributeDefinition);
}
        
// Generate Extended Attribute from definition
System::SharedPtr<ExtendedAttribute> text1TaskAttribute = myTextAttributeDefinition->CreateExtendedAttribute();
        
text1TaskAttribute->set_TextValue(u"Text attribute value");
        
// Add extended attribute to task
System::SharedPtr<Task> tsk = project1->get_RootTask()->get_Children()->Add(u"Task 1");
tsk->get_ExtendedAttributes()->Add(text1TaskAttribute);
        
project1->Save(dataDir + u"CreateExtendedAttributes_out.mpp", Aspose::Tasks::Saving::SaveFileFormat::MPP);

Writing Updated Extended Attribute Definitions and Values to MPP

Aspose.Tasks for C++ API supports updating extended attribute data in a Microsoft Project MPP file and save it back.

The code example given below demonstrates how to add new extended attributes of the Resource and Task types to the source MPP file. The steps involved in this activity are:

1. Create an instance of Project Reader.
2. Read the source MPP file.
3. Define a new extended attribute and update its values.
4. Save the project using the Project Writer.

The following example shows setting the extended attributes of a resource.

System::SharedPtr<Project> project = System::MakeObject<Project>(dataDir + u"WriteUpdatedExtendedAttributeDefinitions.mpp");
        
        
// C# preprocessor directive: #region task attributes
        
        
// Add new text3 extended attribute with lookup and one lookup value
System::SharedPtr<ExtendedAttributeDefinition> taskTextAttributeDefinition = ExtendedAttributeDefinition::CreateLookupTaskDefinition(Aspose::Tasks::ExtendedAttributeTask::Text3, u"New text3 attribute");
taskTextAttributeDefinition->set_ElementType(Aspose::Tasks::ElementType::Task);
project->get_ExtendedAttributes()->Add(taskTextAttributeDefinition);
        
System::SharedPtr<Value> textVal = System::MakeObject<Value>();
textVal->set_Id(1);
textVal->set_Description(u"Text value descr");
textVal->set_Val(u"Text value1");
        
taskTextAttributeDefinition->AddLookupValue(textVal);
        
// Add new cost1 extended attribute with lookup and two cost values
System::SharedPtr<ExtendedAttributeDefinition> taskCostAttributeDefinition = ExtendedAttributeDefinition::CreateLookupTaskDefinition(Aspose::Tasks::ExtendedAttributeTask::Cost1, u"New cost1 attribute");
project->get_ExtendedAttributes()->Add(taskCostAttributeDefinition);
        
System::SharedPtr<Value> costVal1 = System::MakeObject<Value>();
costVal1->set_Id(2);
costVal1->set_Description(u"Cost value 1 descr");
costVal1->set_Val(u"99900");
        
System::SharedPtr<Value> costVal2 = System::MakeObject<Value>();
costVal2->set_Id(3);
costVal2->set_Description(u"Cost value 2 descr");
costVal2->set_Val(u"11100");
        
taskCostAttributeDefinition->AddLookupValue(costVal1);
taskCostAttributeDefinition->AddLookupValue(costVal2);
        
// Add new task and assign attribute lookup value.
System::SharedPtr<Task> task = project->get_RootTask()->get_Children()->Add(u"New task");
        
System::SharedPtr<ExtendedAttribute> taskAttr = taskCostAttributeDefinition->CreateExtendedAttribute(costVal1);
task->get_ExtendedAttributes()->Add(taskAttr);
        
System::SharedPtr<ExtendedAttributeDefinition> taskStartAttributeDefinition = ExtendedAttributeDefinition::CreateLookupTaskDefinition(Aspose::Tasks::ExtendedAttributeTask::Start7, u"New start 7 attribute");
        
System::SharedPtr<Value> startVal = System::MakeObject<Value>();
startVal->set_Id(4);
startVal->set_DateTimeValue(System::DateTime::get_Now());
startVal->set_Description(u"Start 7 value description");
        
taskStartAttributeDefinition->AddLookupValue(startVal);
        
project->get_ExtendedAttributes()->Add(taskStartAttributeDefinition);
        
System::SharedPtr<ExtendedAttributeDefinition> taskFinishAttributeDefinition = ExtendedAttributeDefinition::CreateLookupTaskDefinition(Aspose::Tasks::ExtendedAttributeTask::Finish4, u"New finish 4 attribute");
        
System::SharedPtr<Value> finishVal = System::MakeObject<Value>();
finishVal->set_Id(5);
finishVal->set_DateTimeValue(System::DateTime::get_Now());
finishVal->set_Description(u"Finish 4 value description");
        
taskFinishAttributeDefinition->get_ValueList()->Add(finishVal);
        
project->get_ExtendedAttributes()->Add(taskFinishAttributeDefinition);
        
System::SharedPtr<ExtendedAttributeDefinition> numberAttributeDefinition = ExtendedAttributeDefinition::CreateLookupTaskDefinition(Aspose::Tasks::ExtendedAttributeTask::Number20, u"New number attribute");
        
System::SharedPtr<Value> val1 = System::MakeObject<Value>();
val1->set_Id(6);
val1->set_Val(u"1");
val1->set_Description(u"Number 1 value");
System::SharedPtr<Value> val2 = System::MakeObject<Value>();
val2->set_Id(7);
val2->set_Val(u"2");
val2->set_Description(u"Number 2 value");
System::SharedPtr<Value> val3 = System::MakeObject<Value>();
val2->set_Id(8);
val3->set_Val(u"3");
val3->set_Description(u"Number 3 value");
        
numberAttributeDefinition->AddLookupValue(val1);
numberAttributeDefinition->AddLookupValue(val2);
numberAttributeDefinition->AddLookupValue(val3);
        
project->get_ExtendedAttributes()->Add(numberAttributeDefinition);
        
        
// C# preprocessor directive: #endregion
        
        
System::SharedPtr<ExtendedAttributeDefinition> rscStartAttributeDefinition = ExtendedAttributeDefinition::CreateLookupResourceDefinition(Aspose::Tasks::ExtendedAttributeResource::Start5, u"New start5 attribute");
        
System::SharedPtr<Value> startVal2 = System::MakeObject<Value>();
startVal2->set_Id(9);
startVal2->set_DateTimeValue(System::DateTime::get_Now());
startVal2->set_Description(u"this is start5 value descr");
        
rscStartAttributeDefinition->AddLookupValue(startVal2);
        
project->get_ExtendedAttributes()->Add(rscStartAttributeDefinition);
        
// Define a duration attribute without lookup.
System::SharedPtr<ExtendedAttributeDefinition> taskDurationAttributeDefinition = ExtendedAttributeDefinition::CreateTaskDefinition(Aspose::Tasks::ExtendedAttributeTask::Duration1, u"New Duration");
project->get_ExtendedAttributes()->Add(taskDurationAttributeDefinition);
        
// Add new task and assign duration value to the previously defined duration attribute.
System::SharedPtr<Task> timeTask = project->get_RootTask()->get_Children()->Add(u"New task");
        
System::SharedPtr<ExtendedAttribute> durationExtendedAttribute = taskDurationAttributeDefinition->CreateExtendedAttribute();
        
durationExtendedAttribute->set_DurationValue(project->GetDuration(3.0, Aspose::Tasks::TimeUnitType::Hour));
timeTask->get_ExtendedAttributes()->Add(durationExtendedAttribute);
        
System::SharedPtr<MPPSaveOptions> mppSaveOptions = System::MakeObject<MPPSaveOptions>();
mppSaveOptions->set_WriteViewData(true);
        
// Save the project as MPP project file
project->Save(dataDir + u"WriteUpdatedExtendedAttributeDefinitions_out.mpp", mppSaveOptions);