Робота з розширеними атрибутами завдань

Розширені атрибути завдань у Microsoft Project дозволяють визначати користувальницькі поля та зберігати додаткову інформацію про завдання. Aspose.Tasks for .NET повністю підтримує створення, читання та керування розширеними атрибутами для завдань у обох MPP та XML форматах для всіх версій Microsoft Project (2003–2019).

Що таке розширені атрибути завдань?

У Microsoft Project, Розширений атрибут є користувальницьким полем (наприклад Text1, Cost2, або Flag5), які можна використовувати для збереження інформації, специфічної для бізнесу, що не охоплюється стандартними полями. Ці атрибути надзвичайно корисні для:

• Відстеження додаткових метаданих про завдання (наприклад, категорія завдання, рівень ризику, код бюджету).
• Додавання інформації, специфічної для проекту, що потрібна для звітності.
• Забезпечення дотримання загальнокорпоративних стандартів управління проектами.

Aspose.Tasks надає цю функціональність через два основні класи:

• ExtendedAttributeDefinition – визначає користувальницьке поле (назва, тип, правила обчислення, значення довідника).
• ExtendedAttribute – зберігає фактичне значення цього користувальницького поля для конкретного завдання.

Додавання інформації про розширений атрибут до завдання

Щоб додати розширений атрибут до завдання програмно:

1. Створіть ExtendedAttributeDefinition який визначає тип користувальницького поля.
2. Створіть ExtendedAttribute об’єкт на основі цього визначення.
3. Призначте атрибут потрібному завданню.

Приклад: додавання розширених атрибутів

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

Пояснення:

• Спочатку ми визначаємо текстове користувальницьке поле (наприклад, Text1).
• Потім ми створюємо екземпляр ExtendedAttribute з певним значенням.
• Нарешті, ми прикріплюємо його до завдання, що дозволяє зберігати користувальницьку інформацію.

Читання розширених атрибутів завдань

Після призначення розширених атрибутів їх можна прочитати за допомогою ExtendedAttributes колекції Task класу. Це властивість повертає список ExtendedAttribute об’єктів, кожен з яких містить відомості про користувальницькі поля завдання.

Приклад: читання розширених атрибутів

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

Пояснення:

• Кожне завдання може містити кілька розширених атрибутів.
• Ви можете перебрати їх, щоб витягти користувальницькі дані (наприклад, текстові мітки, числові значення, прапорці).
• Це дозволяє інтегруватися зі звітністю, інформаційними панелями або бізнес-логікою.

Ключові моменти

• Розширені атрибути забезпечують гнучкість для налаштування даних проекту.
• Ви можете визначати, призначати та читати розширені атрибути програмно.
• Клас ExtendedAttributeDefinition використовується для визначення схеми користувальницького поля.
• Клас ExtendedAttribute зберігає фактичні значення для кожного завдання.
• Підтримується для всіх основних версій MS Project (MPP 2003–2019) та формат XML.

Поширені запитання

П: Чи можу я створити таблицю пошуку для розширеного атрибута?

• Так. ExtendedAttributeDefinition клас підтримує значення довідника, так само як у Microsoft Project.

П: Які типи розширених атрибутів підтримуються?

• Текстові, числові, поля вартості, прапорці, дати, тривалості та поля Початок/Завершення.

П: Чи можу я змінювати розширені атрибути після створення завдання?

• Звичайно. Ви можете оновлювати або видаляти розширені атрибути в будь-який момент.

П: Чи зберігаються розширені атрибути у файлах MPP/XML?

• Так. Aspose.Tasks зберігає розширені атрибути при збереженні змінених файлів проекту.

П: Чи доступна ця функція і в .NET Framework, і в .NET Core?

• Так. Aspose.Tasks for .NET підтримує обидві платформи.