Робота з виразами

Робота з виразами в Aspose.Tasks

Aspose.Tasks for .NET дозволяє вам використовувати поля завдань, ресурсів і проєкту у виразах формул.
Ви можете створювати власні обчислення з полями, такими як:

• Work
• Cost
• Числові поля
• DateTime
• Boolean-значення
• Поля на рівні проєкту (наприклад, Task Count, Resource Count)

Ці формули можна застосовувати в Extended Attributes, що дає змогу розширено налаштовувати проєкт і формувати звіти.

Використання полів завдань і ресурсів у формульних обчисленнях

У наступному прикладі показано, як поля завдань і ресурсів можуть використовуватися у формульних обчисленнях:

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

Використання числових полів завдань

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

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

Формула з полями проєкту

Поля на рівні проєкту, такі як загальна кількість завдань або кількість ресурсів, також можуть включатися до формул:

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