式の操作

Aspose.Tasksでの式の操作

Aspose.Tasks for .NETでは使用できます Task, Resource, and Project fields 式の中で。
次のようなフィールドを使用してカスタム計算を構築できます：

• Work
• Cost
• Number fields
• DateTime
• Boolean values
• Project-level fields （例： Task Count、 Resource Count）

これらの式は Extended Attributesで適用できます。 Extended Attributesこれにより、高度なプロジェクトのカスタマイズとレポート作成が可能になります。

式計算における Tasks と Resource Fields の使用

次の例は、式ベースの計算で task and resource fields をどのように使用できるかを示しています：

static void Run()
{
    Project project = CreateTestProjectWithCustomField();
    Task task = project.RootTask.Children.GetById(1);

    // Set formula for extended attribute
    ExtendedAttributeDefinition extendedAttributeDefinition1 = project.ExtendedAttributes[0];
    extendedAttributeDefinition1.Alias = "Days from finish to deadline";
    extendedAttributeDefinition1.Formula = "[Deadline] - [Finish]";

    // Set Task Deadline and save project
    Task task = project.RootTask.Children.GetById(1);
    task.Set(Tsk.Deadline, new DateTime(2015, 3, 20, 17, 0, 0));
    project.Save("UsingTasksAndResourceFields_out.mpp", SaveFileFormat.MPP);
}

// Helper method to create project
static Project CreateTestProjectWithCustomField()
{
    // Create new project instance
    Project project = new Project("New Project.mpp");
    project.Set(Prj.StartDate, new DateTime(2015, 3, 6, 8, 0, 0));

    // Add new task with extended attribute
    Task task = project.RootTask.Children.Add("Task");
    ExtendedAttributeDefinition extendedAttributeDefinition = ExtendedAttributeDefinition.CreateTaskDefinition(CustomFieldType.Text, ExtendedAttributeTask.Text5, "My Ext Attr");
    project.ExtendedAttributes.Add(extendedAttributeDefinition);
    ExtendedAttribute extendedAttribute = extendedAttributeDefinition.CreateExtendedAttribute();
    task.ExtendedAttributes.Add(extendedAttribute);

    // Add resource and resource assignment
    Resource resource = project.Resources.Add("Rsc");
    ResourceAssignment assignment = project.ResourceAssignments.Add(task, resource);
    return project;
}

算術式の使用

フィールド間の計算を行う算術式を定義できます：

Project project = CreateTestProjectWithCustomField();

// Set arithmetic formula for extended attribute
ExtendedAttributeDefinition attr = project.ExtendedAttributes[0];
attr.Alias = "Arithmetic Expression";
attr.Formula = "(1+3*(2+ -5)+8/2)^3";

// Display extended attribute value
Task task = project.RootTask.Children.GetById(1);
Console.WriteLine(task.ExtendedAttributes[0].NumericValue);

Task Number Fields の使用

式は柔軟な計算のために number fields を参照することもできます：

Project project = CreateTestProjectWithCustomField();

// Set formula
ExtendedAttributeDefinition attr = project.ExtendedAttributes[0];
attr.Alias = "Task number fields";
attr.Formula = "([Outline Level] + [Priority] + [% Complete])/2";

Task task = project.RootTask.Children.GetById(1);

// Print extended attribute value before and after updating task percent complete
Console.WriteLine(task.ExtendedAttributes[0].NumericValue);
task.Set(Tsk.PercentComplete, 50);
Console.WriteLine(task.ExtendedAttributes[0].NumericValue);

Boolean 値を用いた式

Boolean 式は式内で条件ロジックを可能にします：

Project project = CreateTestProjectWithCustomField();

// Set formula for extended attribute
project.ExtendedAttributes[0].Formula = "[Critical]-[Marked]+4+[Active]-Not [Active]";

// Print value of extended attribute
Task task = project.RootTask.Children.GetById(1);
Console.WriteLine("Formula with boolean values: " + task.ExtendedAttributes[0].TextValue);

Project フィールドを用いた式

Project-level fields、例えば total task count や resource count は式に含めることもできます：

static void Run()
{
    Project project = CreateTestProjectWithCustomFieldWithoutResource();

    // Set formula
    project.ExtendedAttributes[0].Formula = "\"Total tasks: \" & [Task Count] & \" Total resources: \" & [Resource Count]";
    
    // Print if formula value is computed correctly
    Task task = project.RootTask.Children.GetById(1);
    Console.WriteLine("Check Total tasks: 1 Total resources: 0 - {0}", task.ExtendedAttributes[0].TextValue.Equals("Total tasks: 1 Total resources: 0"));
}

static Project CreateTestProjectWithCustomFieldWithoutResource()
{
    Project project = new Project();
    project.Set(Prj.StartDate, new DateTime(2015, 3, 6, 8, 0, 0));
    ExtendedAttributeDefinition attr = ExtendedAttributeDefinition.CreateTaskDefinition(CustomFieldType.Text, ExtendedAttributeTask.Text1, "Custom");
    project.ExtendedAttributes.Add(attr);
 
    Task task = project.RootTask.Children.Add("Task");
    ExtendedAttribute a = attr.CreateExtendedAttribute();
    task.ExtendedAttributes.Add(a);
    return project;
}