Tabular Editor 2 Docs
こちらはTabular Editor 2 Docs Advent Calendar 2022への投稿記事です。
2022年11月下旬ごろのDocsを日本語訳しています。
最新情報は公式ページ・公式リポジトリをご確認ください。
高度なオブジェクトフィルタリング
この記事では、複雑なモデルを操作する際に非常に便利な機能である、Tabular Editorの「フィルター」テキストボックスの使用方法について説明します。
Filtering Mode
2.7.4より、Tabular Editorでは、階層内のオブジェクトにどのようにフィルターを適用するか、また検索結果をどのように表示するかを設定できるようになりました。これは、Filterボタンの隣にある3つの右端のツールバーボタンを使ってコントロールします。
-
Hierarchical by parent: 検索は、_parent_オブジェクト、つまりテーブルとディスプレイフォルダ（これらが有効な場合）に適用されます。親アイテムが検索条件に一致すると、すべての子アイテムが表示されます。 -
Hierarchical by children: この検索は、_child_オブジェクト（メジャー、カラム、階層など）に適用されます。親オブジェクトは、検索条件に一致する子オブジェクトを少なくとも1つ持っている場合にのみ表示されます。 -
Flat: 検索はすべてのオブジェクトに適用され、結果はフラットなリストで表示されます。子項目を含むオブジェクトは、引き続き階層的に表示されます。
簡易検索
[Filter]テキストボックスに何かを入力して[Enter]を押すと、オブジェクト名の中で大文字と小文字を区別しないシンプルな検索が行われます。例えば、Filterテキストボックスに「sales」と入力し、「By Parent」フィルタリングモードを使用すると、次のような結果が得られます。
いずれかのテーブルを展開すると、そのテーブルのすべてのメジャー、列、階層、およびパーティションが表示されます。フィルタリングモードを「By Child」に変更すると、結果は次のようになります。
[Employee」テーブルは、「sales」という単語を含むいくつかの子項目（この場合は列）を持っているため、リストに表示されていることに注目してください。
ワイルドカード検索
テキストボックスに文字列を入力する際、ワイルドカードとして ? を使用すると任意の1文字を、 * を使用すると任意の連続した文字（0文字以上）を表すことができます。しかし、sales*と入力すると、名前が "sales" という単語で始まるオブジェクトのみが表示されます（繰り返しますが、これは大文字と小文字を区別しません）。
Searching for sales* by parent:
Searching for sales* by child:
フラット検索で sales* を検索（情報欄の切り替え [Ctrl]+[F1] で各オブジェクトの詳細情報が表示されます）。
ワイルドカードは文字列のどこにでも入れることができ、必要な数だけ入れることができます。これでもまだ複雑でないなら、続きを読んでください...
動的なLINQ検索
Dynamic LINQ を使ってオブジェクトを検索することもできます。これは Best Practice Analyzer rules を作成するときに行うのと同じことです。フィルタボックスでDynamic LINQモードを有効にするには、検索文字列の前に : (コロン) を置くだけです。たとえば、名前が "Key" で終わるすべてのオブジェクトを表示するには、次のように記述します (大文字と小文字を区別します)。
:Name.EndsWith("Key")
...そして[Enter]キーを押します。フラット」フィルタリングモードでは、以下のような結果になります。
Dynamic LINQで大文字小文字を区別しない検索を行うには、以下のような方法で入力文字列を変換できます。
:Name.ToUpper().EndsWith("KEY")
下のように、StringComparison という引数を与えることもできます。
:Name.EndsWith("Key", StringComparison.InvariantCultureIgnoreCase)
検索対象はオブジェクトの名前に限定されるわけではありません。動的LINQ検索文字列は、オブジェクトのあらゆるプロパティ（およびサブプロパティ）を評価するために、好きなだけ複雑にできます。たとえば、"TODO "という単語を含む式を持つすべてのオブジェクトを検索したい場合、次のような検索フィルターを使用することになります。
:Expression.ToUpper().Contains("TODO")
別の例として、以下では、他の何からも参照されていないモデル内のすべての非表示メジャーが表示されます。
:ObjectType="Measure" and (IsHidden or Table.IsHidden) and ReferencedBy.Count=0
また、正規表現を使うこともできます。以下は、名前に「Number」または「Amount」という単語が含まれるすべてのカラムを検索します。
:ObjectType="Column" and RegEx.IsMatch(Name,"(Number)|(Amount)")
表示オプション（ツリーの真上にあるツールバーボタン）は、"By Parent" と "By Child" フィルタリングモードを使用した場合の結果に影響を与える可能性があることに注意してください。たとえば、上記のLINQフィルターは列のみを返しますが、表示オプションが現在、列を表示しないように設定されている場合、何も表示されません。