Trabajar con atributos extendidos de tarea

Atributos extendidos de tarea en Microsoft Project le permiten definir campos personalizados y capturar información adicional sobre las tareas. Aspose.Tasks for .NET admite completamente la creación, lectura y gestión de atributos extendidos para tareas tanto en MPP y XML formatos en todas las versiones de Microsoft Project (2003–2019).

¿Qué son los atributos extendidos de tarea?

En Microsoft Project, un atributo extendido es un campo personalizado (como Text1, Cost2, o Flag5) que puede usar para almacenar información empresarial específica no cubierta por los campos estándar. Estos atributos son extremadamente útiles para:

• Seguimiento de metadatos adicionales sobre las tareas (por ejemplo, categoría de la tarea, nivel de riesgo, código de presupuesto).
• Agregar información específica del proyecto requerida para informes.
• Hacer cumplir los estándares de gestión de proyectos de la empresa.

Aspose.Tasks expone esta funcionalidad a través de dos clases principales:

• ExtendedAttributeDefinition – define el campo personalizado (nombre, tipo, reglas de cálculo, valores de búsqueda).
• ExtendedAttribute – almacena el valor real de ese campo personalizado para una tarea específica.

Agregar información de atributo extendido a una tarea

Para agregar un atributo extendido a una tarea mediante programación:

1. Crear un ExtendedAttributeDefinition que defina el tipo de campo personalizado.
2. Crear un ExtendedAttribute objeto basado en esa definición.
3. Asigne el atributo a la tarea deseada.

Ejemplo: Agregar atributos extendidos

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

Explicación:

• Primero, definimos un Texto campo personalizado (por ejemplo, Text1).
• Luego creamos una instancia de ExtendedAttribute con un valor específico.
• Finalmente, lo adjuntamos a la tarea, permitiendo el almacenamiento de información personalizada.

Lectura de atributos extendidos de tarea

Una vez asignados los atributos extendidos, puede leerlos usando la ExtendedAttributes colección de la Task clase. Esta propiedad devuelve una lista de ExtendedAttribute objetos, cada uno con detalles sobre los campos personalizados de la tarea.

Ejemplo: Lectura de atributos extendidos

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

Explicación:

• Cada tarea puede contener múltiples atributos extendidos.
• Puede recorrerlos para extraer datos personalizados (por ejemplo, etiquetas de texto, valores numéricos, indicadores).
• Esto permite la integración con informes, paneles de control o la lógica empresarial.

Notas clave

• Los atributos extendidos proporcionan flexibilidad para personalizar los datos del proyecto.
• Puede definir, asignar y leer atributos extendidos programáticamente.
• La ExtendedAttributeDefinition clase se utiliza para definir el esquema de un campo personalizado.
• La ExtendedAttribute clase almacena los valores reales por tarea.
• Compatible con todas las versiones principales de MS Project (MPP 2003–2019) y formato XML.

Preguntas frecuentes

P: ¿Puedo crear una tabla de búsqueda para un atributo extendido?

• Sí. La ExtendedAttributeDefinition clase admite valores de búsqueda, al igual que en Microsoft Project.

P: ¿Qué tipos de atributos extendidos son compatibles?

• Texto, Número, Costo, Indicador, Fecha, Duración y campos de Inicio/Fin.

P: ¿Puedo modificar los atributos extendidos después de crear la tarea?

• Por supuesto. Puede actualizar o eliminar los atributos extendidos en cualquier momento.

P: ¿Los atributos extendidos se guardan en archivos MPP/XML?

• Sí. Aspose.Tasks preserva los atributos extendidos al guardar los archivos de proyecto modificados.

P: ¿Está esta función disponible tanto en .NET Framework como en .NET Core?

• Sí. Aspose.Tasks for .NET admite ambas plataformas.