Arbeiten mit Extended Attributes eines Projekts

Microsoft Project bietet ein erweiterbares XML-Datenschema das einen reibungslosen Datenaustausch zwischen Anwendungen ermöglicht und leistungsstarke Optionen zur Anpassung von Projektinformationen bietet. Eines seiner flexibelsten Merkmale ist Extended Attributes, mit denen Benutzer benutzerdefinierte Felder zu Aufgaben, Ressourcen und Zuweisungen hinzufügen können. Diese benutzerdefinierten Felder werden häufig verwendet, um geschäftsspezifische Metadaten wie Kostenstellen, Risikokategorien, Genehmigungszustände oder andere für die Organisation erforderliche Klassifizierungen zu speichern. Mit Aspose.Tasks for .NETkönnen Entwickler programmgesteuert erstellen, lesen, aktualisieren und speichern von Extended Attributes ohne dass Microsoft Project installiert sein muss. Dadurch ist es möglich, Arbeitsabläufe zu automatisieren, Projektdaten mit benutzerdefinierten Informationen anzureichern und Microsoft Project-Dateien in umfassendere Unternehmenssysteme zu integrieren.

Arbeiten mit benutzerdefinierten Feldern unter Verwendung von Microsoft Project

In diesem Beispiel zeigen wir, wie man mit dem Text1 extended attribute eines Projekts arbeitet, um die Informationen mit einer Aufgabe zu verknüpfen.

1. In MSP gehen Sie zu Project → Custom Fields.
2. Von hier aus wählen Sie Task.
3. Wählen Sie Text als Typ für benutzerdefinierte Felder im Kombinationsfeld „Type“.
4. Wählen Sie Text1 als das benutzerdefinierte Feld, mit dem Sie arbeiten möchten.
5. Verwenden Sie die Umbenennen -Schaltfläche, um bei Bedarf das Alias des Feldes zu ändern; drücken Sie anschließend OK.
6. Fügen Sie eine neue Aufgabe hinzu und fügen Sie der Aufgabenzeile eine neue Spalte mit dem benutzerdefinierten Feld hinzu.

Arbeiten mit benutzerdefinierten Feldern/Extended Attributes mit Aspose.Tasks for .NET

Aspose.Tasks for .NET API bietet die Möglichkeit, neue Extended Attributes zu erstellen sowie mit bereits in einem Dokument vorhandenen Extended Attributes zu arbeiten. Benutzerdefinierte Felder oder Extended Attributes werden in Aspose.Tasks durch die ExtendedAttributes-Sammlung eines Projekts dargestellt. Sie enthält alle Definitionen der Extended Attributes eines Projektdokuments. Einige der Zuordnungen der MSP-Definition eines benutzerdefinierten Feldes sind in der untenstehenden Abbildung dargestellt.

Erstellen eines neuen Extended Attributes und Hinzufügen zu einer Aufgabe

Um ein neues Extended Attribute für eine Aufgabe oder eine Ressource hinzuzufügen, müssen wir zuerst die Definition des Extended Attributes definieren und zur ExtendedAttributes-Sammlung hinzufügen. ExtendedAttributeDefinition -Klasse wird verwendet, um ein neues ExtendedAttribute in einem Projekt zu definieren. Die FieldId muss gesetzt werden, um ein Extended Attribute korrekt zu definieren, das verknüpft ist mit ExtendedAttributeTask (im Fall einer Aufgabe) oder ExtendedAttributeResource (im Fall einer Ressource). Der folgende Beispielcode zeigt, wie man ein neues Extended Attribute für das Feld Text1 eines Projekts definiert. Sobald die Definition des Extended Attributes abgeschlossen ist, können Sie daraus ein neues Extended Attribute erstellen und es einer Aufgabe zuweisen.

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

ExtendedAttributeDefinition myTextAttributeDefinition = project.ExtendedAttributes.GetById((int)ExtendedAttributeTask.Text1);

// If the Custom field doesn't exist in Project, create it
if (myTextAttributeDefinition == null)
{
    myTextAttributeDefinition = ExtendedAttributeDefinition.CreateTaskDefinition(ExtendedAttributeTask.Text1, "My text field");
    project.ExtendedAttributes.Add(myTextAttributeDefinition);
}

// Generate Extended Attribute from definition
ExtendedAttribute text1TaskAttribute = myTextAttributeDefinition.CreateExtendedAttribute();

text1TaskAttribute.TextValue = "Text attribute value";

// Add extended attribute to task
Task task = project.RootTask.Children.Add("Task 1");
task.ExtendedAttributes.Add(text1TaskAttribute);

project.Save("CreateExtendedAttributes_out.mpp", SaveFileFormat.MPP);

Aktualisierte Extended-Attribute-Definitionen und -Werte in MPP schreiben

Aspose.Tasks for .NET unterstützt das Aktualisieren von Extended-Attribute-Daten in einer Microsoft Project MPP-Datei und das anschließende Speichern.

Der folgende Beispielcode fügt neue Extended Attributes der Resource und Task Typen zur Quell-MPP-Datei hinzu. Die Schritte, die in diesem Vorgang durchgeführt werden, sind:

1. Erstellen Sie eine Instanz von Project Reader.
2. Laden Sie die Quell- MPP Datei.
3. Definieren Sie ein neues Extended Attribute und aktualisieren Sie dessen Werte.
4. Speichern Sie das Projekt mithilfe des Project Writer.

Das folgende Beispiel zeigt das Festlegen der Extended Attributes einer Ressource.

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

// Add new text3 extended attribute with lookup and one lookup value
ExtendedAttributeDefinition taskTextAttributeDefinition = ExtendedAttributeDefinition.CreateLookupTaskDefinition(ExtendedAttributeTask.Text3, "New text3 attribute");
taskTextAttributeDefinition.ElementType = ElementType.Task;
project.ExtendedAttributes.Add(taskTextAttributeDefinition);

Value textVal = new Value();
textVal.Id = 1;
textVal.Description = "Text value descr";
textVal.Val = "Text value1";

taskTextAttributeDefinition.AddLookupValue(textVal);

// Add new cost1 extended attribute with lookup and two cost values
ExtendedAttributeDefinition taskCostAttributeDefinition = ExtendedAttributeDefinition.CreateLookupTaskDefinition(ExtendedAttributeTask.Cost1, "New cost1 attribute");
project.ExtendedAttributes.Add(taskCostAttributeDefinition);

Value costVal1 = new Value();
costVal1.Id = 2;
costVal1.Description = "Cost value 1 descr";
costVal1.Val = "99900";

Value costVal2 = new Value();
costVal2.Id = 3;
costVal2.Description = "Cost value 2 descr";
costVal2.Val = "11100";

taskCostAttributeDefinition.AddLookupValue(costVal1);
taskCostAttributeDefinition.AddLookupValue(costVal2);

// Add new task and assign attribute lookup value.
Task task = project.RootTask.Children.Add("New task");

ExtendedAttribute taskAttr = taskCostAttributeDefinition.CreateExtendedAttribute(costVal1);
task.ExtendedAttributes.Add(taskAttr);

ExtendedAttributeDefinition taskStartAttributeDefinition = ExtendedAttributeDefinition.CreateLookupTaskDefinition(ExtendedAttributeTask.Start7, "New start 7 attribute");

Value startVal = new Value();
startVal.Id = 4;
startVal.DateTimeValue = DateTime.Now;
startVal.Description = "Start 7 value description";

taskStartAttributeDefinition.AddLookupValue(startVal);

project.ExtendedAttributes.Add(taskStartAttributeDefinition);

ExtendedAttributeDefinition taskFinishAttributeDefinition = ExtendedAttributeDefinition.CreateLookupTaskDefinition(ExtendedAttributeTask.Finish4, "New finish 4 attribute");

Value finishVal = new Value();
finishVal.Id = 5;
finishVal.DateTimeValue = DateTime.Now;
finishVal.Description = "Finish 4 value description";

taskFinishAttributeDefinition.ValueList.Add(finishVal);

project.ExtendedAttributes.Add(taskFinishAttributeDefinition);

ExtendedAttributeDefinition numberAttributeDefinition = ExtendedAttributeDefinition.CreateLookupTaskDefinition(ExtendedAttributeTask.Number20, "New number attribute");

Value val1 = new Value();
val1.Id = 6;
val1.Val = "1";
val1.Description = "Number 1 value";
Value val2 = new Value();
val2.Id = 7;
val2.Val = "2";
val2.Description = "Number 2 value";
Value val3 = new Value();
val2.Id = 8;
val3.Val = "3";
val3.Description = "Number 3 value";

numberAttributeDefinition.AddLookupValue(val1);
numberAttributeDefinition.AddLookupValue(val2);
numberAttributeDefinition.AddLookupValue(val3);

project.ExtendedAttributes.Add(numberAttributeDefinition);

ExtendedAttributeDefinition resourceStartAttributeDefinition = ExtendedAttributeDefinition.CreateLookupResourceDefinition(ExtendedAttributeResource.Start5, "New start5 attribute");

Value startVal2 = new Value();
startVal2.Id = 9;
startVal2.DateTimeValue = DateTime.Now;
startVal2.Description = "this is start5 value descr";

resourceStartAttributeDefinition.AddLookupValue(startVal2);

project.ExtendedAttributes.Add(resourceStartAttributeDefinition);

// Define a duration attribute without lookup.
ExtendedAttributeDefinition taskDurationAttributeDefinition = ExtendedAttributeDefinition.CreateTaskDefinition(ExtendedAttributeTask.Duration1, "New Duration");
project.ExtendedAttributes.Add(taskDurationAttributeDefinition);

// Add new task and assign duration value to the previously defined duration attribute.
Task timeTask = project.RootTask.Children.Add("New task");

ExtendedAttribute durationExtendedAttribute = taskDurationAttributeDefinition.CreateExtendedAttribute();

durationExtendedAttribute.DurationValue = project.GetDuration(3.0, TimeUnitType.Hour);
timeTask.ExtendedAttributes.Add(durationExtendedAttribute);

MPPSaveOptions mppSaveOptions = new MPPSaveOptions();
mppSaveOptions.WriteViewData = true;

project.Save("WriteUpdatedExtendedAttributeDefinitions_out.mpp", mppSaveOptions);

Extended Attributes sind eine entscheidende Funktion für Organisationen, die benutzerdefinierte Projektmetadaten über die integrierten Felder von Microsoft Project hinaus benötigen. Sie bieten die Flexibilität, Projektdateien an spezifische geschäftliche Anforderungen anzupassen — von der Verfolgung finanzieller Kennungen bis zur Erfassung von Workflow-Genehmigungen. Durch die Nutzung von Aspose.Tasks for .NET, können Entwickler die Erstellung und Verwaltung von Extended Attributes vollständig automatisieren, wodurch eine konsistente, zuverlässige und standardskonforme Datenverarbeitung über Unternehmenssysteme hinweg sichergestellt wird. Diese Fähigkeit hilft Teams, Microsoft Project-Daten in Reporting-Pipelines, ERP-Systeme und andere Anwendungen zu integrieren, ohne manuelles Eingreifen.