数式の操作

Aspose.Tasks for .NET API は MPP プロジェクト ファイルへの数式の読み取りと書き込みをサポートします。Formula プロパティは ExtendedAttributeDefinition は数式値を読み取るためのインターフェースを提供します。本記事では、MPP ファイルからローカルおよび Enterprise Extended Attributes の数式を読み取る方法について説明します。また、MPP ファイルに数式を書き込む方法も示します。

Extended Attributes の数式を MPP ファイル形式に書き込む

プロジェクト内でカスタム数式を定義し、それを Extended Attributes に割り当てることができます。Aspose.Tasks はこれらの数式を Microsoft Project との互換性を保ったまま MPP ファイルに書き込みます。

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

MPP ファイルからのローカルおよび Enterprise Extended Attributes の数式の読み取り

Aspose.Tasks は、ローカルおよび Enterprise Extended Attributes に定義された数式へアクセスできます。これにより、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);

数式使用時のカスタムフィールド値の読み取り専用アクセス

数式が Extended Attributes に適用されると、結果として得られるカスタムフィールド値は 読み取り専用。Aspose.Tasks は、計算された値が 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");