Utilisation des attributs de tâche étendus

Attributs de tâche étendus dans Microsoft Project vous permettent de définir des champs personnalisés et de capturer des informations supplémentaires sur les tâches. Aspose.Tasks for .NET prend en charge la création, la lecture et la gestion des attributs étendus des tâches dans les deux MPP et XML formats pour toutes les versions de Microsoft Project (2003–2019).

Que sont les attributs de tâche étendus ?

Dans Microsoft Project, un Extended Attribute est un champ personnalisé (tel que Text1, Cost2, ou Flag5) que vous pouvez utiliser pour stocker des informations métier spécifiques non couvertes par les champs standard. Ces attributs sont extrêmement utiles pour :

• Suivi de métadonnées supplémentaires sur les tâches (par ex., catégorie de tâche, niveau de risque, code budgétaire).
• Ajout d’informations spécifiques au projet nécessaires pour les rapports.
• Application de normes de gestion de projet à l’échelle de l’entreprise.

Aspose.Tasks expose cette fonctionnalité via deux classes principales :

• ExtendedAttributeDefinition – définit le champ personnalisé (nom, type, règles de calcul, valeurs de recherche).
• ExtendedAttribute – stocke la valeur réelle de ce champ personnalisé pour une tâche spécifique.

Ajouter des informations d’attribut étendu à une tâche

Pour ajouter un attribut étendu à une tâche par programmation :

1. Créez un ExtendedAttributeDefinition qui définit le type de champ personnalisé.
2. Créez un ExtendedAttribute objet basé sur cette définition.
3. Assignez l’attribut à la tâche souhaitée.

Exemple : ajout d’attributs étendus

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

// Create an Extended Attribute Definition of Text1 type
var taskExtendedAttributeText1Definition = ExtendedAttributeDefinition.CreateTaskDefinition(CustomFieldType.Text, ExtendedAttributeTask.Text1, "Task City Name");

// Add it to the project's Extended Attributes collection
project.ExtendedAttributes.Add(taskExtendedAttributeText1Definition);

// Add a task to the project
Task task = project.RootTask.Children.Add("Task 1");

// Create an Extended Attribute from the Attribute Definition
var taskExtendedAttributeText1 = taskExtendedAttributeText1Definition.CreateExtendedAttribute();

// Assign a value to the generated Extended Attribute. The type of the attribute is "Text", the "TextValue" property should be used.
taskExtendedAttributeText1.TextValue = "London";

// Add the Extended Attribute to task
task.ExtendedAttributes.Add(taskExtendedAttributeText1);

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

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

// Create an Extended Attribute Definition of Text2 type
var taskExtendedAttributeText2Definition = ExtendedAttributeDefinition.CreateLookupTaskDefinition(CustomFieldType.Text, ExtendedAttributeTask.Text2, "Task Towns Name");

// Add lookup values for the extended attribute definition
taskExtendedAttributeText2Definition.AddLookupValue(new Value { Id = 1, StringValue = "Town1", Description = "This is Town1" });
taskExtendedAttributeText2Definition.AddLookupValue(new Value { Id = 2, StringValue = "Town2", Description = "This is Town2" });

// Add it to the project's Extended Attributes collection
project.ExtendedAttributes.Add(taskExtendedAttributeText2Definition);

// Add a task to the project
var task2 = project.RootTask.Children.Add("Task 2");

// Crate an Extended Attribute from the Text2 Lookup Definition for Id 1
var taskExtendedAttributeText2 = taskExtendedAttributeText2Definition.CreateExtendedAttribute(taskExtendedAttributeText2Definition.ValueList[1]);

// Add the Extended Attribute to task
task2.ExtendedAttributes.Add(taskExtendedAttributeText2);

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

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

// Create an Extended Attribute Definition of Duration2 type
var taskExtendedAttributeDuration2Definition = ExtendedAttributeDefinition.CreateLookupTaskDefinition(CustomFieldType.Duration, ExtendedAttributeTask.Duration2, "Some duration");

// Add lookup values for extended attribute definition
taskExtendedAttributeDuration2Definition.AddLookupValue(new Value { Id = 2, Duration = project2.GetDuration(4, TimeUnitType.Hour), Description = "4 hours" });
taskExtendedAttributeDuration2Definition.AddLookupValue(new Value { Id = 3, Duration = project2.GetDuration(1, TimeUnitType.Day), Description = "1 day" });
taskExtendedAttributeDuration2Definition.AddLookupValue(new Value { Id = 4, Duration = project2.GetDuration(1, TimeUnitType.Hour), Description = "1 hour" });
taskExtendedAttributeDuration2Definition.AddLookupValue(new Value { Id = 7, Duration = project2.GetDuration(10, TimeUnitType.Day), Description = "10 days" });

// Add the definition to the project's Extended Attributes collection
project2.ExtendedAttributes.Add(taskExtendedAttributeDuration2Definition);

// Add a task to the project
var task3 = project2.RootTask.Children.Add("Task 3");

// Create an Extended Attribute from the Duration2 Lookup Definition for Id 3
var taskExtendedAttributeDuration2 = taskExtendedAttributeDuration2Definition.CreateExtendedAttribute(taskExtendedAttributeDuration2Definition.ValueList[3]);

// Add the Extended Attribute to task
task3.ExtendedAttributes.Add(taskExtendedAttributeDuration2);

project2.Save("DurationExtendedAttributeWithLookup_out.mpp", SaveFileFormat.MPP);

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

// Create an Extended Attribute Definition of Finish2 Type
var taskExtendedAttributeFinish2Definition = ExtendedAttributeDefinition.CreateLookupTaskDefinition(CustomFieldType.Finish, ExtendedAttributeTask.Finish2, "Some finish");

// Add lookup values for extended attribute defintion
taskExtendedAttributeFinish2Definition.AddLookupValue(new Value { Id = 2, DateTimeValue = new DateTime(1984, 01, 01, 00, 00, 01), Description = "This is Value2" });
taskExtendedAttributeFinish2Definition.AddLookupValue(new Value { Id = 3, DateTimeValue = new DateTime(1994, 01, 01, 00, 01, 01), Description = "This is Value3" });
taskExtendedAttributeFinish2Definition.AddLookupValue(new Value { Id = 4, DateTimeValue = new DateTime(2009, 12, 31, 00, 00, 00), Description = "This is Value4" });
taskExtendedAttributeFinish2Definition.AddLookupValue(new Value { Id = 7, DateTimeValue = DateTime.Now, Description = "This is Value6" });

// Add the definition to the project's Extended Attributes collection
project3.ExtendedAttributes.Add(taskExtendedAttributeFinish2Definition);

// Add a task to the project
var task4 = project3.RootTask.Children.Add("Task 4");

// Create an Extended Attribute from the Finish2 Lookup Definition for Id 3
var taskExtendedAttributeFinish2 = taskExtendedAttributeFinish2Definition.CreateExtendedAttribute(taskExtendedAttributeFinish2Definition.ValueList[3]);

// Add the Extended Attribute to task
task4.ExtendedAttributes.Add(taskExtendedAttributeFinish2);

project3.Save("FinishExtendedAttributeWithLookup_out.mpp", SaveFileFormat.MPP);

Explication :

• Tout d’abord, nous définissons un Text champ personnalisé (par ex., Text1).
• Ensuite, nous créons une instance de ExtendedAttribute avec une valeur spécifique.
• Enfin, nous l’attachons à la tâche, permettant de stocker des informations personnalisées.

Lecture des attributs de tâche étendus

Une fois les attributs étendus affectés, vous pouvez les lire en utilisant la ExtendedAttributes collection de la Task classe. Cette propriété renvoie une liste de ExtendedAttribute objets, chacun contenant des détails sur les champs personnalisés de la tâche.

Exemple : lecture des attributs étendus

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

// Read extended attributes for tasks
foreach (Task task in project.RootTask.Children)
{
    foreach (ExtendedAttribute ea in task.ExtendedAttributes)
    {
        Console.WriteLine(ea.FieldId);
        Console.WriteLine(ea.ValueGuid);

        switch (ea.AttributeDefinition.CfType)
        {
            case CustomFieldType.Date:
            case CustomFieldType.Start:
            case CustomFieldType.Finish:
                Console.WriteLine(ea.DateValue);
                break;

            case CustomFieldType.Text:
                Console.WriteLine(ea.TextValue);
                break;

            case CustomFieldType.Duration:
                Console.WriteLine(ea.DurationValue.ToString());
                break;

            case CustomFieldType.Cost:
            case CustomFieldType.Number:
                Console.WriteLine(ea.NumericValue);
                break;

            case CustomFieldType.Flag:
                Console.WriteLine(ea.FlagValue);
                break;
        }
    }
}

Explication :

• Chaque tâche peut contenir plusieurs attributs étendus.
• Vous pouvez les parcourir pour extraire des données personnalisées (par ex., étiquettes textuelles, valeurs numériques, indicateurs).
• Cela permet l’intégration avec les rapports, les tableaux de bord ou la logique métier.

Points clés

• Les attributs étendus offrent une flexibilité pour personnaliser les données du projet.
• Vous pouvez définir, affecter et lire les attributs étendus par programmation.
• La ExtendedAttributeDefinition classe est utilisée pour définir le schéma d’un champ personnalisé.
• La ExtendedAttribute classe stocke les valeurs réelles par tâche.
• Pris en charge pour toutes les principales versions de MS Project (MPP 2003–2019) et format XML.

Foire aux questions

Q : Puis-je créer une table de recherche pour un attribut étendu ?

• Oui. La ExtendedAttributeDefinition classe prend en charge les valeurs de recherche, comme dans Microsoft Project.

Q : Quels types d’attributs étendus sont pris en charge ?

• Text, Number, Cost, Flag, Date, Duration, and Start/Finish fields.

Q : Puis-je modifier les attributs étendus après la création de la tâche ?

• Absolument. Vous pouvez mettre à jour ou supprimer les attributs étendus à tout moment.

Q : Les attributs étendus sont-ils enregistrés dans les fichiers MPP/XML ?

• Oui. Aspose.Tasks préserve les attributs étendus lors de l’enregistrement des fichiers de projet modifiés.

Q : Cette fonctionnalité est-elle disponible à la fois dans .NET Framework et .NET Core ?

• Oui. Aspose.Tasks for .NET prend en charge les deux plateformes.