수식에서 함수 평가 지원

Aspose.Tasks for .NET API는 다음을 지원합니다 수식으로 정의된 함수 평가 프로젝트의 확장 속성 내에서.
이를 통해 개발자는 Microsoft Project에서 제공되는 것과 유사한 계산을 수행할 수 있으며, 사용자 지정 논리에 따라 달라지는 동적 필드를 구현할 수 있습니다.

이 API는 다음 범주의 함수에 대한 평가를 제공합니다:

• 수학 함수
• 일반 함수
• 문자열 함수
• 날짜/시간 함수

이 기능은 다음과 같은 경우에 특히 유용합니다:

• 프로젝트 계산 자동화,
• 사용자 지정 업무 규칙 구현,
• MS Project와 Aspose.Tasks 간의 수식 호환성 보장.

수학식 계산

다음의 수학 함수들이 지원됩니다:

1. Abs( number )
2. Atn( number )
3. Cos( number )
4. Exp( number )
5. Fix( number )
6. Int( number )
7. Log( number )
8. Rnd( number )
9. Sgn( number )
10. Sin( number )
11. Sqr( number )
12. Tan( number )

static void EvaluateSine()
{
    Project project = CreateTestProjectWithCustomField();
    
    // Set formula Sin(pi/2)
    project.ExtendedAttributes[0].Formula = "Sin(3.1415926/2)";

    // Print Calculated value
    Task task = project.RootTask.Children.GetById(1);
    Console.WriteLine("Sin(pi/2): {0}", task.ExtendedAttributes[0].NumericValue);
}

static Project CreateTestProjectWithCustomField()
{
    Project project = new Project();
    ExtendedAttributeDefinition attr = ExtendedAttributeDefinition.CreateTaskDefinition(CustomFieldType.Number, ExtendedAttributeTask.Number1, "Sine");
    project.ExtendedAttributes.Add(attr);

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

    ExtendedAttribute a = attr.CreateExtendedAttribute();
    task.ExtendedAttributes.Add(a);
    return project;
}

일반 함수 계산

다음 함수들은 논리 및 조건 평가를 제공합니다:

1. Choose( index, choice-1, choice-2, ... , choice-n ) – 목록에서 값을 선택합니다.
2. IIf( expr, truepart, falsepart ) – 조건에 따라 두 값 중 하나를 반환합니다.
3. IsNumeric( expression ) – 표현식이 숫자인지 확인합니다.
4. IsNull( expression ) – 표현식이 null인지 확인합니다.
5. Switch( expr-1, value-1, expr-2, value-2, ... ) – 표현식을 순서대로 평가하여 첫 번째로 일치하는 값을 반환합니다.

static void EvaluateChoose()
{    
    Project project = CreateTestProjectWithCustomField();
    
    // Set Formula
    project.ExtendedAttributes[0].Formula = "Choose(3, \"This is a\", \"right\", \"choice\")";
    
    // Print extended attribute value
    Task task = project.RootTask.Children.GetById(1);
    Console.WriteLine(task.ExtendedAttributes[0].TextValue);
}

static void EvaluateIsNumeric()
{
    string[] numericFormulas = { "IsNumeric('AAA')", "IsNumeric(1)", "IsNumeric(1<0)", "IsNumeric(\"1.1\")", "IsNumeric(Choose((2 + Sgn(2^-3)), 123, \"one two three\"))" };
    
    Project project = CreateTestProjectWithCustomField();
    
    foreach (string numericFormula in numericFormulas)    
    {
        // Set Formula
        project.ExtendedAttributes[0].Formula = numericFormula;

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

static void EvaluateSwitch()
{    
    Project project = CreateTestProjectWithCustomField();

    // Set Formula
    project.ExtendedAttributes[0].Formula = "Switch( 0 < 1, \"0 is lesser than 1\", 0 > 1, \"0 is greater than 1\")";

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

문자열 함수 계산

문자열 조작 함수는 서식 지정 및 비교를 허용합니다:

1. Asc( string ) – 첫 번째 문자에 대한 ASCII 코드를 반환합니다.
2. Chr( charcode ) – ASCII 코드에 해당하는 문자를 반환합니다.
3. Format( expression, format, firstdayofweek, firstweekofyear ) – 숫자/날짜를 서식화합니다.
4. Instr( start, string1, string2, compare ) – 한 문자열 내에서 다른 문자열의 위치를 찾습니다.
5. LCase( string ) – 소문자로 변환합니다.
6. Left( string, length ) – 왼쪽에서부터 문자열을 추출합니다.
7. Len( string ) – 문자열 길이를 반환합니다.
8. LTrim( string ) – 앞쪽 공백을 제거합니다.
9. Mid( string, start, length ) – 부분 문자열을 추출합니다.
10. Right( string, length ) – 오른쪽에서부터 문자열을 추출합니다.
11. RTrim( string ) – 뒤쪽 공백을 제거합니다.
12. Space( number ) – 공백이 포함된 문자열을 반환합니다.
13. StrComp( string1, string2, compare ) – 두 문자열을 비교합니다.
14. StrConv( string, conversion, LCID ) – 로케일에 따라 문자열을 변환합니다.
15. String( number, character ) – 문자열을 지정된 횟수만큼 반복하여 반환합니다 n 회.
16. Trim( string ) – 앞뒤 공백을 제거합니다.
17. UCase( string ) – 대문자로 변환합니다.

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

    // Set formulas and print extended attribute value
    project.ExtendedAttributes[0].Formula = "StrConv(\"sTring and sTRINg\",3)";
    Console.WriteLine(task.ExtendedAttributes[0].TextValue);
    project.ExtendedAttributes[0].Formula = "StrConv(\"sTring and sTRINg\",1)";
    Console.WriteLine(task.ExtendedAttributes[0].TextValue);
    project.ExtendedAttributes[0].Formula = "StrConv(\"sTring and sTRINg\",2)";
    Console.WriteLine(task.ExtendedAttributes[0].TextValue);
}

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

    // Set formulas and print extended attribute value
    project.ExtendedAttributes[0].Formula = "String(5, 40)";
    Console.WriteLine(task.ExtendedAttributes[0].TextValue);
    project.ExtendedAttributes[0].Formula = "String(5, \"A\")";
    Console.WriteLine(task.ExtendedAttributes[0].TextValue);
    project.ExtendedAttributes[0].Formula = "String(-5, \"A\")";
    // #Error
    Console.WriteLine(task.ExtendedAttributes[0].TextValue);
}

날짜/시간 함수 계산

Aspose.Tasks는 표준 VB 스타일 날짜 함수와 MS Project에 특화된 스케줄링 함수를 모두 지원합니다:

1. CDate( expression ) – 표현식을 날짜로 변환합니다.
2. Date() – 현재 시스템 날짜를 반환합니다.
3. DateAdd( interval, number, date ) – 날짜에 간격을 추가합니다.
4. DateDiff( interval, date1, date2 ) – 두 날짜 간의 차이를 구합니다.
5. DatePart( interval, date ) – 날짜의 일부(연, 월, 일 등)를 추출합니다.
6. DateSerial( year, month, day ) – 구성요소로부터 날짜를 생성합니다.
7. DateValue( date ) – 문자열을 날짜로 변환합니다.
8. Day( date ) – 월의 일자.
9. Hour( time ) – 시(시간)를 추출합니다.
10. IsDate( expression ) – 표현식이 유효한 날짜인지 확인합니다.
11. Minute( time ) – 분을 추출합니다.
12. Month( date ) – 월을 추출합니다.
13. Now() – 현재 날짜와 시간을 반환합니다.
14. ProjDateAdd( date, duration, calendar ) – 프로젝트 캘린더를 고려하여 기간을 추가합니다.
15. ProjDateConv( expression, dateformat ) – 날짜를 프로젝트 형식으로 변환합니다.
16. ProjDateDiff( date1, date2, calendar ) – 프로젝트 캘린더를 고려한 차이를 구합니다.
17. ProjDateSub( date, duration, calendar ) – 기간을 빼줍니다.
18. ProjDateValue( expression ) – 날짜 표현식을 평가합니다.
19. ProjDurConv( expression, durationunits ) – 단위 간 기간을 변환합니다.
20. ProjDurValue( duration ) – 기간 표현식을 평가합니다.
21. Second( time ) – 초를 추출합니다.
22. Time() – 현재 시스템 시간을 반환합니다.
23. Timer() – 자정 이후 경과된 초 수.
24. TimeSerial( hour, minute, second ) – 시간 값을 생성합니다.
25. TimeValue( time ) – 시간을 변환합니다.
26. Weekday( date, firstdayofweek ) – 요일을 반환합니다.
27. Year( date ) – 연도를 추출합니다.

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

ExtendedAttributeDefinition numberDefinition = ExtendedAttributeDefinition.CreateTaskDefinition(ExtendedAttributeTask.Number1, null);
project.ExtendedAttributes.Add(numberDefinition);

ExtendedAttribute numberAttribute = numberDefinition.CreateExtendedAttribute();
task.ExtendedAttributes.Add(numberAttribute);

// Set ProjDateDiff formula and print extended attribute value
numberDefinition.Formula = "ProjDateDiff(\"03/23/2015\",\"03/18/2015\")";
Console.WriteLine(numberAttribute.NumericValue);
numberDefinition.Formula = "ProjDateDiff(\"03/23/2015\",\"03/25/2015\")";
Console.WriteLine(numberAttribute.NumericValue);

ExtendedAttributeDefinition dateDefinition = ExtendedAttributeDefinition.CreateTaskDefinition(ExtendedAttributeTask.Date1, null);
project.ExtendedAttributes.Add(dateDefinition);
ExtendedAttribute dateAttribute = dateDefinition.CreateExtendedAttribute();
task.ExtendedAttributes.Add(dateAttribute);

ExtendedAttributeDefinition durationDefinition = ExtendedAttributeDefinition.CreateTaskDefinition(ExtendedAttributeTask.Duration4, "Custom duration field");
project.ExtendedAttributes.Add(durationDefinition);
ExtendedAttribute durationAttribute = durationDefinition.CreateExtendedAttribute();
task.ExtendedAttributes.Add(durationAttribute);

ExtendedAttributeDefinition textDefinition = ExtendedAttributeDefinition.CreateTaskDefinition(ExtendedAttributeTask.Text5, "Custom text field");
project.ExtendedAttributes.Add(textDefinition);
ExtendedAttribute textAttribute = textDefinition.CreateExtendedAttribute();
task.ExtendedAttributes.Add(textAttribute);

// Set ProjDateSub formula and print extended attribute value
dateDefinition.Formula = "ProjDateSub(\"3/19/2015\", \"1d\")";
Console.WriteLine(dateAttribute.DateValue);

// We can set ProjDurConv formula to duration-valued attribute as well as to text-valued attribute.

// Set ProjDurConv formula to duration-valued extended attribute and print its value.
durationDefinition.Formula = "ProjDurConv([Duration], pjHours)";
Console.WriteLine(durationAttribute.DurationValue);

// Set ProjDurConv formula to text-valued extended attribute and print its value.
textDefinition.Formula = "ProjDurConv([Duration], pjHours)";
Console.WriteLine(textAttribute.TextValue);

textDefinition.Formula = "ProjDurConv([Duration], pjWeeks)";
Console.WriteLine(textAttribute.TextValue);

// Set Second formula and print entended attribute value
numberDefinition.Formula = "Second(\"4/21/2015 2:53:41 AM\")";
Console.WriteLine(numberAttribute.NumericValue);

// Set Weekday formula and print entended attribute value
numberDefinition.Formula = "Weekday(\"24/3/2015\", 1)";
Console.WriteLine(numberAttribute.NumericValue);
numberDefinition.Formula = "Weekday(\"24/3/2015\", 2)";
Console.WriteLine(numberAttribute.NumericValue);
numberDefinition.Formula = "Weekday(\"24/3/2015\", 3)";
Console.WriteLine(numberAttribute.NumericValue);

실무 예제

다음은 수식을 사용하는 실제 시나리오입니다:

    var project = new Project();
    var task = project.RootTask.Children.Add("Task 1");

    // Create an extended attribute with a custom formula
    ExtendedAttributeDefinition attrDef = ExtendedAttributeDefinition.CreateTaskDefinition(
        ExtendedAttributeTask.Text1, "Custom Formula");
        attrDef.Formula = "IIf([Duration] > 480, \"Long Task\", \"Short Task\")";
        project.ExtendedAttributes.Add(attrDef);

    var attr = attrDef.CreateExtendedAttribute();
    task.ExtendedAttributes.Add(attr);

    // The formula is automatically evaluated by Aspose.Tasks
    Console.WriteLine(task.Get(Tsk.Name) + " -> " + task.ExtendedAttributes[0].TextValue);

수식 지원의 주요 이점

• MS Project 수식과의 완전한 호환성.
• 자동화 기능 동적 필드 및 조건부 논리.
• 내장 지원 프로젝트 캘린더 인식 함수 (ProjDateAdd, ProjDateDiff 등).
• 사용자 지정 C# 코드를 작성하지 않고 복잡한 계산을 단순화합니다.

참고

• 확장 속성 작업
• 수식 작업
• 프로젝트 계산 작업