TM1SET

TM1SET は、 IBM® Planning Analytics for Microsoft Excel および IBM Planning Analytics TM1® Webで代替階層をサポートする強力な機能です。

TM1SET は、関数がセット式の入力を持ち、セットのメンバーを戻すことができるという意味で、DBRW および SUBNM に類似したタイプの関数です。 TM1SET 階層は認識するだけでなく、その中で使用されているセル参照も認識します。 他のセルを参照する TM1SET 内の引数を変更すると、参照されるセルも更新されます。

TM1SET の出力は構成可能であり、動的かつ強力になります。 TM1SET 関数を新規および既存のレポートに組み込むことで、汎用性とカスタマイズを向上させることができます。

メンバー・セレクターとセット・エディターの統合

使用している Planning Analytics コンポーネントに応じて、 TM1SET セルをクリックすると、セットの定義を変更できるドロップダウン・メンバー・セレクターまたはセット・エディターが表示されます。 TM1SET 式を手動で編集することもできます。

注: Planning Analytics Workspace 2.0.85 および TM1 Web 2.0.85を使用している場合は、 TM1SET セルの新しいエクスペリエンス・メンバー・セット・メニューを使用してメンバーを選択し、セット・エディターを開くことができます。 メンバー・セット・メニューを使用するには、 features.json ファイルでフィーチャー・フラグ EnableCarbonMemberSelector を有効にします。

ドロップダウン・メンバー・セレクター、セット・エディター、またはメンバー・セット・メニューは、 TM1SET セルが追跡対象領域の名前付き範囲内にある (適用 tm2\\_tracked) 場合にのみ使用できます。 追跡されていない TM1SET セルから、以下のいずれのアイテムも開くことはできません： Planning Analytics for Excel、 TM1 Web、またはWorkspaceウェブシート用の Planning Analytics。 また、 TM1 Web で Web シートをエクスポートするときに、追跡対象外のセルに TM1SET タイトル・ディメンションを表示することもできません。

追跡対象領域の名前付き範囲を TM1SETに適用する方法については、 TM1SET 関数の組み込み を参照してください。

真の参照トラバーサル

TM1SET Planning Analytics for Excel および TM1 Web において、真の参照トラバーサル機能を有しています。 TM1SET’s 引数は、インラインで作成することも、他のセルに書き込み、 TM1SET 関数で参照することもできます。 セット・エディターで TM1SET 関数を変更した場合 (例えば、別の階層を選択した場合)、その変更は TM1SET’s 出力値 および 数式で参照される可能性があるすべてのセルに適用されます。

構文

以下の構文の引数は、表 1 の対応する引数の説明にリンクしています。

=@TM1SET(Host, Server, Dimension, Hierarchy, SetExpression, SelectedElement, SessionSetOut, ActiveDisplay, DisplayModeEnum)
表 1. TM1SET の引数
引数 説明
ホスト

データ・ソース URI を入力します。

ホスト引数を使用すると、データベース名が競合する場合でも、複数のシステムを同時に使用することができます。
サーバー

TM1 サーバー名を入力します。
Dimension

ディメンション名を入力します。
階層

階層名を入力します。
SetExpression

MDX ベースの動的セット式を入力します。
SelectedElement

表示するセット内の選択した要素を入力します。
SessionSetOut

セッション・セット ID に指定された出力範囲。 この値は、セット・エディターでセット式が変更された後にサーバーによって生成されます。

これはオプションの引数であり、"" にすることができます。 または NULL。
ActiveDisplay

メンバー・エレメントに対応する別名を入力します。

これはオプションの引数であり、"" にすることができます。 または NULL。
DisplayModeEnum
出力タイプは、数式の出力値に影響します。 以下のいずれかの出力タイプを入力します。
  • SESSIONSET- TM1 サーバーで作成されるセットのセッション・セット ID を表示します。
  • MUN-MDX メンバーの一意の名前を表示します
  • MEMBERDISPLAY-エレメント名または別名の表示

これはオプションの引数であり、"" にすることができます。 または NULL。
EnableURExpandAbove

ユニバーサルレポート内で統合メンバーをダブルクリックした際に、その子要素を親要素の上に展開するかどうかを指定します。 これは 「上部に展開」 設定に対応します。

親要素の上にある子要素を展開するには を、子要素を truefalse 折りたたんだままにするには を指定してください。

これはオプションの引数であり、指定されない場合、デフォルト値は. です false。
注: TM1Set が機能するには、 ActiveDisplay 引数で定義された値が以下のガイドラインに従っている必要があります。
  • 名前は 128 文字以下でなければなりません。
  • 名前は、英字、カテゴリー L または Nl の Unicode 文字、または下線のいずれかで開始する必要があります。
  • 名前には、英数字、カテゴリー L、Nl、Nd、Mn、Mc、Pc、Cf のユニコード文字、または下線のみを含める必要があります。

    詳細については、 TM1 オブジェクトの命名規則を参照してください。

例

=@TM1SET("http://mydatasource.ibm.com","Planning Sample", "plan_business_unit","plan_business_unit","{Filter( {TM1SUBSETALL( [plan_business_unit] )}, [plan_business_unit].CurrentMember.Level.Ordinal = 1)}", "10100","","BusinessUnit", "memberdisplay")

TM1SET 関数の組込み

TM1SET 関数は、 Planning Analytics for Excel からレポートに追加できます

  1. Planning Analytics for Excel でデータソースに接続します。
  2. セルを選択し、 TM1SET 式を入力します。
    注: 引数のガイダンスについては、セルに =TM1SET() と入力して、 Enterを押してください。 「関数の挿入」 をクリックして、 TM1SETに入力する必要があるすべての引数を表示します。
    TM1SET 関数引数

追跡対象領域の名前付き範囲をレポート内のセルに適用することにより、 TM1SET セルを追跡できます。 TM1SET セルのジェスチャー・サポート (セルをダブルクリックしてセット・エディターを開くなど) は、セルが追跡されている場合にのみ使用できます。

ジェスチャーサポートを Planning Analytics for Excel、 TM1 Web、および Planning Analytics Workspace のWebシートで機能させるには、 TM1SETtm2\\_tracked セルに名前付き範囲を適用してください。
  1. Planning Analytics for Microsoft Excelで、 「式」 に移動し、 「Name Manager」をクリックします。
  2. 「新規」 をクリックして、以下の情報を入力します。
    1. 名前: tm2\\_tracked
    2. スコープ: セルが配置されているシートを選択します。
    3. 参照先: セル参照を入力します。
  3. 「OK」をクリックします。
追跡対象エリアの名前付き範囲の作成