マトリックス列と数式
Last updated
Last updated
Mashmatrix Sheetの数式では、通常の列と同様に、マトリックス列内の内部列および系列値を列変数として参照することが可能です。また、数式をマトリックス列の内部列で利用し、計算結果を系列内に表示することも可能です。
通常の列の場合、数式テキスト内では[@列の参照名]といった記法で列値（現在数式が評価されているレコードにおける列の値）を、あるいは[#列の参照名]といった記法で列参照（シートに含まれている列全体）を変数として利用しますが、マトリックス列の内部列の場合は、それぞれ以下の形式で列を参照する変数を表現します。
列値 - [マトリックス列の参照名].[系列の参照名].[@内部列の参照名]
列参照 - [マトリックス列の参照名].[系列の参照名].[#内部列の参照名]
マトリックス列の参照名、系列の参照名、および内部列の参照名は、それぞれ列の設定画面から確認できます。系列の参照名は、$1、$2、$3、…といった形式で1から始まるインデックス番号つきの名前が系列順どおりに自動的に割り当てられます。
外部のシートにあるマトリックス列の内部列を列参照の変数として参照する場合には、先頭にそのシートのシートIDをつけて記述します。
[シートID].[マトリックス列の参照名].[系列の参照名].[#内部列の参照名]
以下の画像は、マトリックス列 SalesPlans__r 内に内部列として Planned__c および Actual__c という列が存在する場合、あるレコードの数式評価において各列変数が表す対象を視覚的に表現した例となります。
数式エディタでは、マトリックス列内の各系列ごとに階層ツリーで内部列が表示されます。適切な系列の内部列を選択して数式テキスト内に変数を挿入します。
マトリックス列の内部の数式から同じマトリックス列の内部列を参照する場合、特定の系列を指定するのではなく、現在評価されている数式が含まれる系列から相対的な位置にある系列に含まれている内部列を参照することが可能です。
列値 - [マトリックス列の参照名].[系列の相対参照名].[@内部列の参照名]
列参照 - [マトリックス列の参照名].[系列の相対参照名].[#内部列の参照名]
系列の相対参照名に指定できる値は以下の形式となります。
$ - 数式が評価される列が属している系列（現在の系列）
$-n - 現在の系列からみて n ステップ前の系列（ n は正整数値）
$+n - 現在の系列からみて n ステップ後の系列（ n は正整数値）
相対的な系列位置を指定した結果、参照先が現在のマトリックス列の系列の範囲を超えた場合、変数の値は空白値として扱われます。
以下の画像は、マトリックス列 SalesPlans__r 内に内部列として Planned__c および Actual__c という列が存在する場合、あるレコードの２番目の系列における内部列での数式評価において各列変数が表す対象を視覚的に表現した例となります。
マトリックス列内部の数式を編集する場合、数式エディタではマトリックス列の階層ツリー内で内部列の一覧が表示されます。系列ノードのドロップダウンメニューから適切な相対位置を選択した上で、内部列を選択して数式テキスト内に変数を挿入します。
数式では、マトリックス列内の系列の値を変数として参照可能です。系列値は、それぞれの時系列における開始日の日付値となります。数式テキスト内では以下のような形式の記法となります。
[マトリックス列の参照名].[@系列の参照名]
例えば、マトリックス列 SalesPlans__r が2020/1/1を開始日として月ごとの表示間隔でマトリックス変換表示するように設定されている場合、それぞれの列変数が返す日付値は以下となります。
[SalesPlans__r].[@$1] ⇒ "2020-01-01"
[SalesPlans__r].[@$2] ⇒ "2020-02-01"
[SalesPlans__r].[@$3] ⇒ "2020-03-01"
[SalesPlans__r].[@$4] ⇒ "2020-04-01"
...
同じマトリックス列の内部の数式の場合、系列の参照名には相対的な記法が利用できます。系列の相対参照名で指定できる値は内部列の場合と同様です。
[マトリックス列の参照名].[@系列の相対参照名]
例えば、マトリックス列 SalesPlans__r が2020/1/1を開始日として月ごとの表示間隔でマトリックス変換表示するように設定されている場合、2020/4の系列内において数式を評価した際のそれぞれの列変数が返す日付値は以下となります。
[SalesPlans__r].[@$] ⇒ "2020-04-01"
[SalesPlans__r].[@$-1] ⇒ "2020-03-01"
[SalesPlans__r].[@$-2] ⇒ "2020-02-01"
[SalesPlans__r].[@$+1] ⇒ "2020-05-01"
[SalesPlans__r].[@$+2] ⇒ "2020-06-01"
...
マトリックス列内部の数式を編集する場合、系列値への参照はマトリックス列の階層ツリー内に表示されます。
相対参照の場合は系列ノードのドロップダウンメニューから適切な相対位置を選択した上で、「（系列値）」ノードを選択して数式テキスト内に変数を挿入します。
以下の数式の例では、商品の一覧を表示するシートs1に、SalesPlans__rという参照名を持つマトリックス列が追加されており、2020/1/1を開始日として月ごとの表示間隔で12ヶ月間のデータを表示するように設定されているものとします。また、SalesPlans__rの内部列として、Planned__cおよびActual__cという参照名を持つ計画金額および実績金額を格納する通貨型の列が表示されているものとします。
シート内に以下の数式テキストを持つ通貨型の数式列を追加します。この数式ではマトリックス列内の系列をすべて指定して計画金額値を参照し、足し合わせています。
マトリックス列SalesPlans__rの内部列として、以下の数式テキストを持つ通貨型の数式列を追加します。この数式では現在の系列の実績金額および計画金額を参照し、差分を計算しています。
マトリックス列SalesPlans__rの内部列として、以下の数式テキストを持つ通貨型の数式列を追加します。この数式では現在の系列の実績金額および１ステップ前の系列の実績金額を参照し、差分を計算して正であれば”+"を、負であれば"-"を返しています。数式の空白項目の処理設定では「空白項目を空白として処理」にチェックを入れておきます。
まず、マトリックス列SalesPlans__rを2019/1/1を開始日として24ヶ月間表示するように再設定し、最初の2019/1〜2019/12までの系列は非表示にしておきます。
その後、マトリックス列SalesPlans__rの内部列として、以下の数式テキストを持つ通貨型の数式列を追加します。この数式では現在の系列から12ステップ前（=12ヶ月前)の実績金額を参照しています。
マトリックス列SalesPlans__rの内部列として、以下の数式テキストを持つパーセント型の数式列を追加します。この数式では同じ系列内の計画金額の合計を計算し、現在のレコードの計画金額をその合計金額で割ることで、全体金額に占める比率を計算しています。
