Работа с выражениями

Работа с выражениями в Aspose.Tasks

Aspose.Tasks для .NET позволяет использовать поля Task, Resource и Project в выражениях формул.
Вы можете создавать пользовательские вычисления с полями, такими как:

• Work
• Cost
• числовые поля
• DateTime
• логические значения
• поля уровня проекта (например, Task Count, Resource Count)

Эти формулы можно применять в Extended Attributes, что обеспечивает расширенную настройку проекта и формирование отчетов.

Использование полей Task и Resource в вычислениях формул

В следующем примере показано, как поля Task и Resource могут использоваться в вычислениях на основе формул:

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

Формулы также могут обращаться к числовым полям для гибких вычислений:

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

Формула с логическими значениями

Логические выражения позволяют использовать условную логику в формулах:

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

Поля уровня проекта, такие как 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;
}