Page History
...
Table of Contents | ||
---|---|---|
|
概要
Styleclass | ||
---|---|---|
| ||
...
- データソース上でアクセスフィルターを作成します。
作成したアクセスフィルターを、ビュー上のフィールドに適用します。
ビュー上で、デフォルトのアクセスフィルターを定義します。
レポートにアクセスフィルターを適用します。
参照タイプの設定
作成したすべてのソースフィルターは、参照タイプを使用して、カテゴライズをする必要があります。これは、ソースシステム内のデータを、Yellowfinのメタデータとリンクさせる時に使用します。また、対象のビューに対して、利用可能にすることのできるフィルターのタイプを、カテゴライズする方法も提供します。
Section | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
|
Section | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
|
アクセスフィルターの作成
Styleclass | ||
---|---|---|
| ||
Section | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
|
Section | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
|
Section | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
|
フィルターパラメーター
各アクセスフィルターには、Yellowfinユーザーの参照IDと一致する1つ以上のレコードが一覧に含まれています。これらのレコードは、次の3つの方法でシステムに登録することができます。手動入力、CSVファイル、ソースデータベース上でのクエリーのスケジュール実行です。各アクセスフィルターには、Yellowfin ユーザーの参照IDと一致する1つ以上のレコードが一覧に含まれています。これらのレコードは、次の4つの方法でシステムに登録することができます。手動入力、CSVファイル、Yellowfin レポートから、ソースデータベース上でのSQLクエリーのスケジュール実行です。
どの方法を選択した場合でも、以下の4つのフィールドを1レコードとして、この順序通りに登録する必要があります。
識別子のタイプ | 識別子 | フィルタータイプ | 参照ID |
識別子のタイプと識別子は、Yellowfinユーザーを特定するために使用します。 識別子のタイプは、以下のいずれかになります |
識別子のタイプは、「電子メールアドレス」、「YellowfinユーザーID」、「ユーザーID」のいずれかを使用することができます。
ユーザーIDはYellowfinで管理している内部IDです。
| 識別子フィールドは、識別子のタイプで指定したユーザー識別子(電子メールアドレス、YellowfinユーザーID、ユーザーIDのいずれか)を使用します。 |
識別子
識別子フィールドは、識別子のタイプで指定したユーザー識別子(電子メールアドレス、YellowfinユーザーID、ユーザーIDのいずれか)を使用します。
フィルタータイプフィールドは、どのようなタイプのフィルターなのかを定義するために使用します。これは、ユーザーがビューやレポートを作成する際に表示される名称です。そのため、ユーザーに分かりやすい名称を使用してください。 フィルタータイプを追加したり、削除したりする場合は、接続ページで参照タイプの設定ボタンをクリックしてください。 |
参照IDフィールドは、ユーザーに付随する値を指定します。参照IDで指定した値をフィルターの値として使用します。 |
手動アクセスフィルター
Styleclass | ||
---|---|---|
| ||
設定
Section | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
ユーザー
Section | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
|
値
Section | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
|
レコード
Section | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
|
使用
Section | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
|
レポートアクセスフィルター
Styleclass | ||
---|---|---|
| ||
設定
Section | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
レポート
Section | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
|
Section | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
|
レコード
Section | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
|
使用
Section | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
|
SQLクエリーアクセスフィルター
Styleclass | ||
---|---|---|
| ||
設定
Section | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Section | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
|
Section | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
レコード
Section | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
|
使用
Section | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
|
CSVアクセスフィルター
Styleclass | ||
---|---|---|
| ||
使用するCSVファイルは、上記に表示した通り、4つのフィールドでレコードが構成されていなくてはなりません。ファイルは、ヘッダー行を含み、タイトルは「Identifier Type」、「Identifier」、「Reference Type」、「Reference Id」でなければなりません。
設定
Section | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
レコード
Section | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
|
使用
Section | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
|
インラインSQLクエリーアクセスフィルター
このタイプのアクセスフィルターの適用は、ユーザーとフィルター値の組み合わせが膨大な量になるお客様向けに導入されました。インラインSQLクエリーアクセスフィルターは、クエリー実行時に動的に実行され、より効率的です。SQLクエリーは、現在のユーザーのIDなどのパラメーター値を受け入れることができます。一致する値を返すために、SQLクエリー断片がクエリーに挿入されます。この方法では、アクセスフィルターが作成される対象のデータベースを使用するため、データベース接続は必要ありません。また、クエリーは毎回動的に実行されるため、この方法では値はキャッシュされません。
設定
アクセスフィルターレコードをどのように指定し、更新するのかを定義するために、すべての設定をおこなう必要があります。
設定 | 説明 |
名前 | 接続やタスク画面でこのアクセスフィルターを識別しやすい名前を提供します。 |
SQLクエリー | アクセスフィルター値を返すために使用されるクエリーを定義します。フィルタークエリーは、単一のユーザーのデータを返します。フィルターパラメーターには、以下のトークンのいずれかを使用してください。 ?USERID? ?EMAIL? ?YFPERSONID? ?FILTERTOKEN? |
SQLを定義したら、これをテストしなくてはいけません。テストボタンをクリックし、任意のパラメーターに値を入力します。これらのパラメーターはテスト用であり、実行時に実際の値に置き換えられます。データベースから返されたエラーが表示されるか、有効なメッセージが表示されます。完了したら、送信・実行ボタンをクリックして、アクセスフィルターを保存します。
この方法に関するその他の注意事項:
- SQLクエリーの代わりに、カスタムデータベース関数/プロシージャを使用することもできます(SQLで直接呼び出せる場合)。
例: getCountriesForUser({USERID}) - インラインSQLクエリーに基づくソースフィルターを実装したビューは、シグナルおよびキャッシュされたフィルターと互換性がありません。
- フィルタートークンは、SSOプロセスを介してユーザーセッションに渡すことができます。これは、SSOペイロードのパラメーターオプションで設定され、FILTERTOKEN=value という形式である必要があります。SQLに ?FILTERTOKEN? 参照が含まれ、フィルタートークンがセッションに渡されていない場合、レポートを実行しようとするとエラーメッセージが表示されます。FILTERTOKENは、バックグラウンドレポート実行シナリオでは動作しない場合があります。
- インラインSQLアクセスフィルターが有効な場合、一部のレポートフィルターオプションは利用できません。
- この方法は、以下では使用できません。
- サブセレクトまたはIN ステートメントのクエリーをサポートしていないデータソース
- 非リレーショナルデータソース
- ストアドプロシージャに基づくビュー
ビューへのアクセスフィルターの適用
Styleclass | ||
---|---|---|
| ||
データベース上で設定したアクセスフィルターは、そのソースに対して作成されるすべてのビューに適用することができます。
- ビューを作成し、ステップ2.ビューフィールドページで、作成した参照タイプの1つと一致するフィールドを選択します。
- アクセスタブを開き、アクセスフィルター項目から対応するタイプを選択します。フィルターレコードを持たない参照タイプを選択することはできません。
- アクセスフィルターを選択したら、フィールドを保存します。必要に応じて、複数のフィールドに、異なるアクセスフィルタータイプを適用することができます。
- ビュー上でフィールドにアクセスフィルタータイプを適用したら、ビューセキュリティページに移動します。このビューから作成するレポートに適用するアクセスフィルターのデフォルトを選択することができます。必要無い場合は、選択しなくても構いません。デフォルト設定でフィルターを適用した場合、このビューを使用して作成されるすべてのレポートに、対象のフィルターが適用されます。適切なアクセス権限を持つレポート作成者のみ、レポート単位でこのフィルターの変更をしたり、設定を解除したりすることができます。
レポートへのアクセスフィルターの適用
Styleclass | ||
---|---|---|
| ||
...
注意:アクセスフィルターが適用されたレポートでは、スクリーンショットを取得することができません。
アクセスフィルターの上書き
こちらの設定は、管理者など、特定のユーザーがアクセスフィルターを上書きすることで、すべての結果を表示できるようにします。これは、上書きコードを定義し、特定のユーザーのソースフィルターエントリーに追加することで実現できます。これにより、Yellowfinは設定されたユーザーにアクセスフィルターを適用せず、すべての結果を提供します。
アクセスフィルターのOn/Off切り替えができるのは管理者ユーザーのみで、設定が適用されたユーザー自身は、自らこれを制御することはできません。
上書き機能の有効化
アクセスフィルターを上書きするコードを使用する前に、この機能を有効化する必要があります。これは、データベース内の構成テーブルに、以下のSQLクエリーを追加することで実行できます。
Code Block | ||||
---|---|---|---|---|
| ||||
INSERT INTO Configuration VALUES (1,'SYSTEM','SOURCEFILTERWILDCARD','%'); |
上記の例で、「1」はプライマリー組織IDを、「%」が上書きコードを示します。コードを定義するために、任意の文字、または文字シークエンスでコード値を指定します。例:「no_filters」
注意:こちらのクエリーを追加後、Yellowfinを再起動してこの機能を有効化します。
horizontalrule |
---|
Styleclass | ||
---|---|---|
| ||
...