TIMESUM

この例にはモジュールが二つあります。最初のモジュールでは列に時間ディメンション、行に「Revenue」ライン アイテムがあります。モジュールの名前は「Revenue 2021」で、この後に出てくる式で参照されています。

[Model Settings] → [Time] で定義したとおり、このモデルの現在の期間は「May 21」です。

二つ目のモジュールにはライン アイテムしかなく、それぞれのライン アイテムに式があります。これらの式は、Start period 引数と End period 引数 を使用して集計期間を指定する方法を示したものです。

それぞれの式を別々のモジュールに分けているのは、時間ディメンションのないモジュールで TIMESUM を使用してパフォーマンスを最適化する必要があるためです。

「Revenue for all periods」ライン アイテムにある最初の式では、Line item to aggregate 引数に「Revenue」ライン アイテムのみを使用しています。つまり、この式では TIMESUM のデフォルトの動作を使用してモジュール内のすべての値を合計しています。この動作は Weeks:General を [Model Settings] → [Time] で使用する場合に便利です (このカレンダー タイプにはすべての期間の集計が含まれていないため)。

「Revenue for 2 months ago」ライン アイテムにある二つ目の式では、Line item to aggregate 引数に「Revenue」ライン アイテムを使用しています。この式では Start period 引数に -2 を使用しています。つまり、この式では現在の期間である「May 21」の二つ前の期間の値のみが返されます。今回のケースでは「Mar 21」の「117,021」が返されます。

Polaris の場合、この式では「Mar 21」から対象の時間範囲の最後の期間までのすべての値が集計されます。

「Revenue from 2 months ago to current period」ライン アイテムにある三つ目の式では、Line item to aggregate 引数に「Revenue」ライン アイテムを使用しています。この式では、Start period 引数に -2、End period 引数に 0 を使用しています。つまり、この式では、現在の期間の二つ前の期間から現在の期間までの値を合計しています。今回のケースでは、「Mar 21」、「Apr 21」、「May 21」の値の合計である「362,737」となります。

「Revenue for duration of Spring campaign」ライン アイテムにある四つ目の式では、Line item to aggregate 引数に「Revenue」ライン アイテムを使用しています。この式では、Start period 引数と End period 引数で時間ディメンションへの参照を使用してます。それぞれ、「Time.'Jan 21'」と「Time.'Apr 21'」です。つまり、この式ではこれらの期間それぞれ、及びこれらの期間の間の「Revenue」ライン アイテムの値を合計しています。式では時間ディメンションへの参照を使用しているため、モデル カレンダーの現在の期間が変わっても式の値は変わりません。

この例にはモジュールが二つあります。最初のモジュールでは列に時間ディメンション、行に複数のライン アイテムがあります。モジュールの名前は「Initiative KPIs 2021」で、この後に出てくる式で参照されています。

[Model Settings] → [Time] で定義したとおり、このモデルの現在の期間は「Dec 21」です。

二つ目のモジュールにはライン アイテムしかなく、それぞれのライン アイテムに式があります。これらの式は、Aggregation method 引数の各キーワードの動作を示したものです。それぞれの式で Start period に -2、End period に 0 を使用しています。つまり、これらが Oct 21、Nov 21、Dec 21 の値に適用されます。

それぞれの式を別々のモジュールに分けているのは、時間ディメンションのないモジュールで TIMESUM を使用してパフォーマンスを最適化する必要があるためです。

最初の四つのライン アイテムには SUM、AVERAGE、MIN、MAX の各キーワードの動作を示した式がそれぞれにあります。これらの集計方法は数値形式の値でのみ使用できます。「Oct 21」、「Nov 21」、「Dec 21」では値がそれぞれ「117,279」、「128,835」、「108,029」で、式では次の処理が行われます。

• 三つの値が合計されて 354,143 となります。
• 三つの値の平均である 118,048 を返します。
• 三つの値の最低値である 108,029 を返します。
• 三つの値の最高値である 128,835 を返します。

五つ目のライン アイテムには ANY キーワードの動作を示した式、六つ目のライン アイテムには ALL キーワードの動作を示した式があります。これらの集計方法はブール値形式の値でのみ使用できます。「Oct 21」、「Nov 21」、「Dec 21」の値に対して、式では次の処理が行われます。

• ブール値のいずれかが TRUE になるかどうかをチェックします。三つのうちの二つが TRUE になるため、値として TRUE を返します。
• すべてのブール値が TRUE になるかどうかをチェックします。三つのうちの二つだけが TRUE になるため、値として FALSE を返します。

七つ目のライン アイテムには FIRSTNONBLANK キーワードの動作を示した式、八つ目のライン アイテムには LASTNONBLANK キーワードの動作を示した式があります。これらの集計方法は値の形式が数値、日付、リスト、又はテキストの場合に使用できます。こちらのケースでは、製品リリース日を表す日付がライン アイテムにあります。「Oct 21」、「Nov 21」、「Dec 21」の値に対して、式では次の処理が行われます。

• 最初の空白以外の日付形式値である 10/15/2021 を返します。
• 最後の空白以外の日付形式値である 11/1/2021 を返します。

九つ目のライン アイテムには TEXTLIST キーワードの動作を示した式があります。この集計方法はテキスト形式の値でのみ使用できます。この式は Oct 21、Nov 21、Dec 21 の値を連結して値ごとにカンマで区切ります。「Lemon meringue pie, Mille-feuille」が返されます。