Travailler avec des attributs étendus d'un projet

Microsoft Project dispose d’un vaste schéma d’interchange de données XML qui facilite l’échange d’informations entre les applications et la programmation avec des fichiers de projet. Le schéma vous permet d’ajouter des attributs étendus aux tâches, aux ressources et aux affectations. Cet article montre comment travailler avec des attributs étendus dans Aspose.Tasks.

Travailler avec des champs personnalisés à l’aide du projet Microsoft

Dans cet exemple, nous montrerons comment travailler avec Text1 Extended Attribut d’un projet pour associer les informations à une tâche.

1. Dans MSP, accédez à Project-> Fields personnalisés.
2. De là, sélectionnez la tâche.
3. Sélectionnez le texte en tant que type de champ personnalisé dans la boîte combinée de type.
4. Sélectionnez Text1 comme champ personnalisé avec lequel vous souhaitez travailler
5. Utilisez le bouton “Renommer” pour renommer l’alias du champ si elle est souhaitée et appuyez sur le bouton OK
6. Ajoutez une nouvelle tâche et insérez une nouvelle colonne à la ligne de tâche avec le champ personnalisé que vous avez utilisé dans l’étape ci-dessus

Travailler avec des champs personnalisés / attributs étendus en utilisant Aspose.Tasks pour .net

Aspose.Tasks pour .NET L’API offre la capacité de créer de nouveaux attributs étendus ainsi que de travailler avec des attributs étendus déjà présents dans un document. Les champs personnalisés ou les attributs étendus sont représentés par la collection ExtendAttributes d’un projet dans Aspose.Tasks. Il contient toute la définition des attributs étendus d’un document de projet. Certains des mappages de la définition du champ personnalisé MSP sont comme indiqué dans l’image ci-dessous.

Création d’un nouvel attribut étendu et l’ajout à la tâche

Pour ajouter un nouvel attribut étendu pour la tâche ou la ressource, nous devons d’abord définir et ajouter la définition d’attribut étendu à la collection ExtendAttributes. ExtendedAttributeDefinition La classe est utilisée pour définir un nouveau prolongation d’extension dans un projet. Le FieldID doit être défini pour la définition appropriée d’un attribut étendu qui est lié à ExtendedAttributeTask (en cas de tâche) ou ExtendedAttributeResource (en cas de ressource). L’exemple de code suivant montre comment définir un nouvel attribut étendu pour le champ de projet text1. Une fois la définition d’attribut étendue terminée, vous pouvez désormais créer un nouvel attribut étendu et l’attribuer à une tâche.

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);

Writing Updated Extended Attribute Definitions and Values to MPP

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

The example code below adds 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.

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);