ダッシュボードの設定:生データ(リターナル)レンダリング
生のLTEL出力は、クエリ出力からの直接データを使用し、それらのデータをテキストテーブルに表示します。
構成設定に応じて、いくつかの表示モードが可能です。一部のモードでは、アクセサリフォームセクションに追加の設定が必要になります。
内容
行データ出力の共通設定
データ出力としての列の選択
実行する最初の絶対的な選択は、クエリからどのカラムをテーブルに表示するかを選択することです。多くの場合、生データには有効な結果データセットの一部しか表示されません。ここに列の別名のリストを書くことによって列を順番に選択します。もちろん、エイリアス名はクエリに含まれるべきです!
例:
このようなクエリを入力したとします。
SELECT firstname as fn, lastname as ln, username as login ...
次の名前が列選択テキストフィールドに表示されます。ln; fn; login
出力フィールド表示名
エイリアストークンは、エンドユーザーにとってめったに見られない名前です。列名のtexfieldは効果的な表示で列の識別情報を分かりやすい名前に変換することを可能にします。表示される名前をセミコラム(;)で区切って、宣言された各列に同じ順序で同じ数の名前を入力します。
前の例では、次のように設定できます。
出力フィールド:fn; ln; login出力フィールド名:名、姓、ユーザID
出力フィールドフォーマット
SQL構文でデータを直接フォーマットするのは、SQLの読みやすさには向いていないかもしれません。この設定は、sprintf()構文に基づいて、データに適用できるフォーマット後のフィルタをいくつか定義します。 sprintfのフォーマットコードを使用すると、データの再フォーマットが簡単になります。数値出力の場合はfeです。
%s : string %d : integer (floored) %03d : integer with 3 digits, 0-filled (001, 002, etc.) %.2f : 2 digit decimals etc. (check the PHP sprintf documentation for the complete formatting syntax).
結果ページサイズ
この設定は、リニアテーブルのページ制限を出力として設定します。
Big Resultsのセキュリティを上書きする
このチェックボックスは、このブロックインスタンスに対して、大きな結果のデータページングを強制する "Big Result"セキュリティ設定(グローバル設定)を無効にします。これは多くのデータを表示するグラフ化された出力に役立ちます。
クエリキャッシング
クエリキャッシュを有効にする
クエリキャッシュを有効にすると、ダッシュボードブロックはクエリ結果をキャッシュに保存し、TTL中にこのデータを使用します。
TTL(存続時間)
TTLは数分でセットアップされます。キャッシングは、有効になっていてTTLが0より大きく設定されている場合に有効です。
注:ファイルに結果を出力するには、キャッシュが有効になっている必要があります。
データクリーンアップ(リニアテーブル出力のみ)
データのクリーニングが有効になっていると、上のセルと同じ値を含むセルが表示されないままになり、見やすくなります。
ソート可能テーブル(リニアテーブルのみ)
tableがsortableに設定されている場合、列名はソートリンクを有効にします。
小計
いくつかの集計機能が設定されている場合( "集計機能"を参照)、指定された集計機能の小計は、指定された列の値の変更時に取得できます。小計を出力に表示すると、小計駆動列を使用して表がソートされることも想定されます。
出力動的フィルタ
この重要な設定の章では、エンドユーザーが結果データセットのどの部分を表示するかを選択するために使用する動的フィルタの設定方法について説明します。
フィルタは、出力の表示の上に「セレクタ」(選択リスト)を追加する基準定義です。フィルタは通常、最初のクエリの単一列に一致します。元の結果からこの列に含まれるすべての値がフィルタリングセットとして使用されます。
例:
qクエリを取りましょう。
SELECT firstname as fn, lastname as ln, city as ct
....
そしてPARIS、SANTA CLARA(CA)そしてPRAGUEに住んでいるユーザー。
フィルタとして「city as ct」が指定されている場合は、「*、PARIS、SANTA CLARA、PRAGUE」の中から選択して選択が表示に追加されます。 '*'は "フィルタなし"を表します。表示時に任意の値を選択しても、対応するデータのみが保持されます。
フィルタリングは追加のSQL WHERE句を生成しますが、それらは最初のクエリに明示的に配置する必要があります。
これには<%% FILTERS %%>プレースホルダーを使用します。
SELECT firstname as fn, lastname as ln, city as ct FROM mdl_user <%%FILTERS%%>
この場合、フィルタの関係者はWHERE句全体を追加します。クエリにすでにWHERE文が含まれている場合は、Flters関係者は追加のフィルタリングテストのみを追加します。
SELECT firstname as fn, lastname as ln, city as ct FROM mdl_user WHERE country = 'AU' <%%FILTERS%%>
上記のサンプルでは、オーストラリアのユーザーを事前フィルタ処理していますが、フィルタに必要なものを追加しています。
以下は有効なlcoationではありません。
SELECT data1,data2 FROM table1 t1, table2 t2 GROUP BY data2 <%%FILTERS%%> ORDER BY data1
WHERE句はGROUP BYの後には実行できません。
フィルター
フィルターは、SQL列定義のセミコラム(;)区切りリストとして定義されます。
フィルタ定義には、aliasを含むSQLフィールド句全体が必要です。したがって、上記の例では、正しい表現は「city as ct」であり、「city」または「ct」ではありません。
フィルター名
出力列に関しては、フィルター基準には表示のための包括的なラベルがあります。
各フィルタに名前を付けるためのセミコラム(;)で区切られたラベルのリストを、フィルタ定義リストと同じ順序と量で入力できます。
注:litteral ";"をエスケープするための規定はありません。したがって、名前やラベルにセミコラムを使用しないでください。
デフォルトのフィルタ
フィルタは、最後のWHERE文にいくつかの句を追加します。デフォルト値を指定しないと、ブラウジングセッションでダッシュボード要素が初めて表示されたときにフィルタリングが無効になります。この設定により、デフォルトでフィルタリング用の値を強制的に選択できます。可能な選択は次のとおりです。
- FIRST:フィルタリングセットにある最初のフィルタリング値を選択します
- LAST:フィルタリングセットにある最後のフィルタリング値を選択します
- <空>:デフォルト値なし、 '*'を使用。
すべてのデフォルトは、セミコラム(;)で区切られたリストとして、フィルタ宣言と同じ順序と量で設定されます。
例:
フィルタ:部署はdpt、市区町村はctフィルタのデフォルト:; FIRST
この例では、departmentのデフォルトは '*'(フィルタなし)です。
フィルタオプション
一部のオプションは、フィルタの動作を大幅に変更したり、同じページレイアウト上の複数のダッシュボード要素に影響を与えることがあります。このオプションは「1文字のマーカー」であり、任意の順序で並べることができます。
- g:グローバルフィルタリングを有効にします。他のDashboard Elementsからの他のフィルタがページ上で同じ列定義を使用している場合、1つのDashboardでフィルタ値を変更するよりも他のすべての同一のグローバルフィルタに影響を与えようとします。
- s:Force "Single":存在する場合、これはfitler値セットに "*"(フィルタ処理されていない)オプションを提供することを避け、デフォルトとしてフィルタ処理値を選択することを強制します。これは塗りつぶしの範囲で表示しようとする価値がないだろう「大きいサイズの結果」のために役に立ちます。 "Filterdéfaut"の明示的な設定が指定されていない場合は、最初が強制されます。
- m:Allow "Multiple":存在する場合、この評定者はフィルタ値セットで複数の値を選択することを許可します。したがって、範囲またはサブセットを定義できます。フィルター選択は複数選択ウィジェットになります。
- x: "Crossover":通常、データをフィルタ処理すると句が追加され、複雑なクエリの整理と処理が必要になる場合があります。場合によっては、これらのクリーンアップ操作で構文安全なクエリを生成できないことがあります(共用体、サブクエリ、複数のネストした句ORDER BYなどを使用する場合)。この評定者は、これらのクリーンアップ操作を無効にします。これは場合によっては状況を保存することがあります。
複数のフィルタを使う
注意してください:2つ以上のフィルタを使用するとき、それらの各々は独立してそのモダリティリストを提供します。そのため、フィルタリングの組み合わせによっては、「値がない」可能性があります。
テーブルタイプ
データ編成に応じて、生データは複数のテーブルレイアウトを使用して表示される場合があります。
- 線形表示:データは単純な表として表示され、各レコードは行として表示され、出力フィールドはセルとして表示されます。
(サンプルの元のクエリ)
- 表クロステーブル:データは、マトリックスクロステーブルとして2次元にレイアウトされます。この出力モードを制御するためにいくつかの追加パラメータが必要です。
- ツリー型表示:このモードは、クエリ自体の制約によって異なります。このモードを使用するには、抽出されたデータは階層的な基礎となる組織を持っていなければなりません。そのような組織は以下を提供するでしょう:
- ファイレーションの原則(レコードはIDによってマッピングされた親を持ちます)
- ノードID(ノードは、ノード名としての値によって識別できます)
- ツリー内の各ノードのノード値(または一連の値)。
このモードでは追加のパラメータを設定する必要があります。