数式内の関数評価のサポート

Aspose.Tasks for .NET API はサポートしています 数式として定義された関数の評価 プロジェクトのExtended Attributes内で。
これにより開発者は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 ) – 条件に応じて2つの値のうちいずれかを返します。
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 ) – 2つの文字列を比較します。
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 ) – 2つの日付の差を計算します。
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 ) – project calendarを考慮して期間を加算します。
15. ProjDateConv( expression, dateformat ) – 日付をプロジェクト形式に変換します。
16. ProjDateDiff( date1, date2, calendar ) – project 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, etc.).
• カスタムのC#コードを書かずに複雑な計算を簡素化します。

関連項目

• Extended Attributesの操作
• 数式の操作
• プロジェクト計算の操作