Как добавить Extended Attributes к Resource Assignments

Как и Tasks и Resources, Extended Attributes также можно добавлять к Resource Assignments. Aspose.Tasks for .NET API позволяет расширять данные проекта, прикрепляя как обычные, так и lookup Extended Attributes к назначениям ресурсов. Это позволяет хранить дополнительные метаданные и сделать отчётность по проекту более гибкой.

Добавление Extended Attributes к Resource Assignment

В этом примере демонстрируется, как создать и назначить Extended Attribute непосредственно Resource Assignment. Такой подход полезен, когда нужно отслеживать пользовательские данные, не входящие в стандартные поля Microsoft Project.

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

// Add new task and resource
Task task = project.RootTask.Children.Add("Task");
Resource resource = project.Resources.Add("Rsc");

// Assign the resource to the desired task
ResourceAssignment assignment = project.ResourceAssignments.Add(task, resource);

// Custom attributes which is visible in "Resource Usage" view can be created with ExtendedAttributeDefinition.CreateResourceDefinition method.
{
    ExtendedAttributeDefinition resCostAttributeDefinition = ExtendedAttributeDefinition.CreateResourceDefinition(
        CustomFieldType.Cost,
        ExtendedAttributeResource.Cost5,
        "My cost");

    project.ExtendedAttributes.Add(resCostAttributeDefinition);

    var value = resCostAttributeDefinition.CreateExtendedAttribute();

    // The type of the attribute is "Cost", so we need to use "NumericValue" property.
    value.NumericValue = 1500;

    assignment.ExtendedAttributes.Add(value);
}

// Custom attributes which is visible in "Task Usage" view can be created with ExtendedAttributeDefinition.CreateTaskDefinition method
{
    ExtendedAttributeDefinition taskCostAttributeDefinition = ExtendedAttributeDefinition.CreateTaskDefinition(
        CustomFieldType.Cost,
        ExtendedAttributeTask.Cost5,
        "My cost for task");

    project.ExtendedAttributes.Add(taskCostAttributeDefinition);

    var value = taskCostAttributeDefinition.CreateExtendedAttribute();

    // The type of the attribute is "Cost", so we need to use "NumericValue" property.
    value.NumericValue = 2300;

    assignment.ExtendedAttributes.Add(value);
}

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

Добавление Lookup Extended Attributes к Resource Assignment

Следующий код показывает, как использовать lookup values для Extended Attributes. С помощью lookup атрибутов вы можете обеспечить соответствие данных Resource Assignment предопределённым спискам, снизить вероятность ошибок человека и поддерживать согласованность информации о проекте.

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

// Assign resource "1 TRG: Trade Group" to the "TASK 1" by creating a ResourceAssignment object.
Resource resource = project.Resources.GetById(1);
Task task = project.RootTask.Children.GetById(1);

ResourceAssignment assignment = project.ResourceAssignments.Add(task, resource);

// Create custom attribute definition with lookup.
ExtendedAttributeDefinition resCostAttr = ExtendedAttributeDefinition.CreateLookupResourceDefinition(
    CustomFieldType.Cost,
    ExtendedAttributeResource.Cost5,
    "My lookup resource cost");
project.ExtendedAttributes.Add(resCostAttr);

var value1 = new Value { NumberValue = 1500, Description = "Val 1", Id = 1, Val = "1500" };

resCostAttr.AddLookupValue(value1);

resCostAttr.AddLookupValue(new Value { NumberValue = 2500, Description = "Val 2", Id = 2 });

// This value can be seen in "Resource usage" view of MS Project.
var attributeValue = resCostAttr.CreateExtendedAttribute(value1);
assignment.ExtendedAttributes.Add(attributeValue);

// Create custom attribute definition with lookup.
ExtendedAttributeDefinition taskCostAttr = ExtendedAttributeDefinition.CreateLookupTaskDefinition(
    ExtendedAttributeTask.Cost4,
    "My lookup task cost");

project.ExtendedAttributes.Add(taskCostAttr);

var taskLookupValue1 = new Value { NumberValue = 18, Description = "Task val 1", Id = 3, Val = "18" };
taskCostAttr.AddLookupValue(taskLookupValue1);

resCostAttr.AddLookupValue(new Value { NumberValue = 30, Description = "Task val 2", Id = 4 });

// This value can be seen in "Task usage" view of MS Project.
assignment.ExtendedAttributes.Add(taskCostAttr.CreateExtendedAttribute(taskLookupValue1));

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

Часто задаваемые вопросы

В: Нужно ли устанавливать Microsoft Project, чтобы работать с Extended Attributes?

• Нет. Aspose.Tasks for .NET работает независимо от Microsoft Project.

В: Могу ли я задать одновременно обычные и lookup Extended Attributes в одном проекте?

• Да. Вы можете смешивать обычные и lookup Extended Attributes в зависимости от потребностей вашего проекта.

В: Отобразятся ли Extended Attributes, добавленные через Aspose.Tasks, при открытии проекта в Microsoft Project?

• Да. Extended Attributes полностью поддерживаются Microsoft Project и будут видны при открытии файла.

Заключение

Добавление Extended Attributes к Resource Assignments в Aspose.Tasks for .NET предоставляет гибкость для управления дополнительными данными проекта. Используя как обычные, так и lookup атрибуты, вы можете обогатить файлы проекта пользовательскими полями, обеспечить целостность данных и усилить возможности отчётности без необходимости установки Microsoft Project. Эта функциональность делает Aspose.Tasks надёжным выбором для профессиональной автоматизации управления проектами на C#.