Trabajar con Extended Attributes de un Proyecto

Microsoft Project proporciona un esquema de datos XML extensible que permite un intercambio fluido de datos entre aplicaciones y ofrece potentes opciones para personalizar la información del proyecto. Una de sus características más flexibles es Extended Attributes, que permiten a los usuarios agregar campos personalizados a tareas, recursos y asignaciones. Estos campos personalizados se utilizan a menudo para almacenar metadatos específicos del negocio, tales como códigos de coste, categorías de riesgo, estados de aprobación, o cualquier otra clasificación que la organización necesite. Con Aspose.Tasks for .NET, los desarrolladores pueden programáticamente crear, leer, actualizar y guardar extended attributes sin requerir que Microsoft Project esté instalado. Esto hace posible automatizar flujos de trabajo, enriquecer los datos del proyecto con información personalizada e integrar los archivos de Microsoft Project en sistemas empresariales más amplios.

Trabajar con Campos Personalizados usando Microsoft Project

En este ejemplo, mostraremos cómo trabajar con el Text1 extended attribute de un proyecto para asociar la información con una Task.

1. En MSP, vaya a Project → Custom Fields.
2. Desde aquí, seleccione Task.
3. Seleccione Text como Custom Field Type desde el Type Combo Box.
4. Seleccione Text1 como un campo personalizado con el que desea trabajar.
5. Use el Rename botón para cambiar el alias del campo si es necesario, luego pulse OK.
6. Agregue una nueva tarea e inserte una nueva columna en la fila de la tarea con el campo personalizado.

Trabajando con Custom Fields/Extended Attributes usando Aspose.Tasks for .NET

La API de Aspose.Tasks for .NET proporciona la capacidad de crear nuevos extended attributes así como de trabajar con Extended Attributes ya presentes en un documento. Los campos personalizados o Extended Attributes están representados por la colección ExtendedAttributes de un proyecto en Aspose.Tasks. Contiene todas las definiciones de extended attributes de un documento de proyecto. Algunas de las asignaciones de la definición de Custom Field de MSP se muestran en la imagen a continuación.

Creando un nuevo Extended Attribute y agregándolo a Task

Para agregar un nuevo extended attribute para task o resource, primero necesitamos definir y añadir la definición del extended attribute a la colección ExtendedAttributes. ExtendedAttributeDefinition clase se usa para definir un nuevo ExtendedAttribute en un proyecto. El FieldId debe establecerse para definir correctamente un Extended attribute que esté vinculado a ExtendedAttributeTask (en el caso de Task) o ExtendedAttributeResource (en el caso de Resource). El código de ejemplo siguiente muestra cómo definir un nuevo Extended Attribute para el campo Text1 del proyecto. Una vez que la definición del Extended Attribute esté completa, ahora puede crear un nuevo Extended Attribute a partir de ella y asignarlo a una task.

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

Escribir definiciones y valores actualizados de Extended Attribute en MPP

Aspose.Tasks for .NET admite actualizar datos de extended attribute en un archivo MPP de Microsoft Project y guardarlo de nuevo.

El código de ejemplo a continuación agrega nuevos extended attributes del Resource y Task tipos al archivo MPP de origen. Los pasos involucrados en esta actividad son:

1. Crear una instancia de Project Reader.
2. Cargar la fuente MPP archivo.
3. Defina un nuevo extended attribute y actualice sus valores.
4. Guarde el proyecto usando el Project Writer.

El siguiente ejemplo muestra cómo establecer los extended attributes de un 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);

Los Extended Attributes son una característica crítica para las organizaciones que requieren metadatos personalizados del proyecto más allá de los campos integrados de Microsoft Project. Proporcionan la flexibilidad para adaptar los archivos de proyecto a necesidades comerciales específicas — desde el seguimiento de identificadores financieros hasta la captura de aprobaciones de flujo de trabajo. Aprovechando Aspose.Tasks for .NET, los desarrolladores pueden automatizar completamente la creación y gestión de extended attributes, asegurando un manejo de datos consistente, fiable y conforme a estándares en los sistemas empresariales. Esta capacidad ayuda a los equipos a integrar los datos de Microsoft Project en canalizaciones de informes, sistemas ERP y otras aplicaciones sin intervención manual.