Travailler avec les formules

Aspose.Tasks for .NET API prend en charge la lecture et l’écriture de formules dans les fichiers de projet MPP. La propriété Formula de la ExtendedAttributeDefinition fournit l’interface pour lire la valeur de la formule. Cet article décrit comment lire les formules des Extended Attributes locaux ainsi que des Extended Attributes Enterprise à partir du fichier MPP. Il montre également comment écrire des formules dans un fichier MPP.

Écriture de formules dans les Extended Attributes au format de fichier MPP

Vous pouvez définir des formules personnalisées et les affecter aux Extended Attributes d’un projet. Aspose.Tasks écrit ces formules dans des fichiers MPP tout en préservant la compatibilité avec Microsoft Project.

Project project = new Project("New Project.mpp");
project.Set(Prj.NewTasksAreManual, false);

// Create new custom field (Task Text1) with formula which will double task cost
ExtendedAttributeDefinition attr = ExtendedAttributeDefinition.CreateTaskDefinition(CustomFieldType.Text, ExtendedAttributeTask.Text1, "Custom");
attr.Alias = "Double Costs";
attr.Formula = "[Cost]*2";
project.ExtendedAttributes.Add(attr);

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

// Set task cost
task.Set(Tsk.Cost, 100);

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

Lecture des formules dans les Extended Attributes locaux et Enterprise à partir d’un fichier MPP

Aspose.Tasks permet d’accéder aux formules définies dans les Extended Attributes locaux et Enterprise. Cela permet d’extraire et d’analyser de manière programmatique la logique métier personnalisée intégrée dans les fichiers MPP.

Project project = new Project("New Project.mpp"); // Attached test mpp
// Read extended attribute formula
ExtendedAttributeDefinition attr = project.ExtendedAttributes[0];
Console.WriteLine("Attribute Formula: " + attr.Formula);

Accès en lecture seule aux valeurs des champs personnalisés lors de l’utilisation de formules

Lorsque des formules sont appliquées aux Extended Attributes, les valeurs résultantes des champs personnalisés sont en lecture seule. Aspose.Tasks garantit que les valeurs calculées restent cohérentes avec les formules définies dans le fichier MPP.

// Create new project and extended attribute definition
Project project = new Project();

ExtendedAttributeDefinition attribute = ExtendedAttributeDefinition.CreateTaskDefinition(CustomFieldType.Cost, ExtendedAttributeTask.Cost1, "");
attribute.Formula  = "[Cost]-[Actual Cost]";

project.ExtendedAttributes.Add(attribute);

// Add task
Task task = project.RootTask.Children.Add("Task");

// Create extended attribute
ExtendedAttribute extendedAttribute = attribute.CreateExtendedAttribute();
task.ExtendedAttributes.Add(extendedAttribute);

// Display if extended attributes are read only or not
Console.WriteLine(extendedAttribute.ValueReadOnly == true ? "Value is Read only" : "Value is not read only");
extendedAttribute.NumericValue = -1000000M;
Console.WriteLine(extendedAttribute.NumericValue == -1000000M ? "Formula values are read-only" : "Values are not read-only");