ADD_FILTERプロシージャのシグネチャ2

このプロシージャは、レポート名を使用して、対話グリッドにフィルタを作成します。

ノート:

ページ・レンダリング・プロセスでこのプロシージャを使用すると、レポートのダウンロード問題(CSV、HTML、電子メールなど)が発生します。ユーザーがレポートをダウンロードすると、対話グリッドでは、REQUEST値のダウンロード形式でページがリロードされます。対話グリッドの設定の変更(フィルタの追加やレポートのリセットなど)は、Ajaxリクエストで実行されます。したがって、ダウンロード・データがユーザーが参照しているレポート・データと一致しないことがあります。このため、ページ送信プロセスでのみこのプロシージャを使用することをお薦めします。

構文

APEX_IG.ADD_FILTER (
    p_page_id           IN NUMBER,
    p_region_id         IN NUMBER,
    p_filter_value      IN VARCHAR2,
    p_column_name       IN VARCHAR2 DEFAULT NULL,
    p_operator_abbr     IN VARCHAR2 DEFAULT NULL, 
    p_is_case_sensitive IN BOOLEAN  DEFAULT FALSE,
    p_report_name       IN VARCHAR2 DEFAULT NULL );

パラメータ

表25-2 ADD_FILTERのパラメータ

パラメータ	説明
`p_page_id`	対話グリッドが含まれている現在のOracle APEXアプリケーションのページ。
`p_region_id`	対話グリッド・リージョン(ID)。
`p_filter_value`	これはフィルタ値です。この値は`N`および`NN`には使用されません。
`p_column_name`	フィルタ処理されるレポートSQL列名または列の別名。
`p_operator_abbr`	フィルタ・タイプ。有効な値は次のとおりです。 `EQ` = 等しい `NEQ` = 等しくない `LT` = より小さい `LTE` = より小さいか、等しい `GT` = より大きい `GTE` = 以上 `N` = NULL `NN` = NULLではない `C` = 含む `NC` = 含まない `IN` = SQLのIn演算子 `NIN` = SQLのNot In演算子
`p_is_case_sensitive`	行検索フィルタの大/小文字の区別。この値は、`p_report_column`が設定されている列フィルタには使用されません。有効な値は次のとおりです。 `TRUE` `FALSE` (これはデフォルト値です。)
p_report_name	カレント・アプリケーション・ページ内の保存されたレポート名。`p_report_name`がNULLの場合、最後に表示されたレポート設定にフィルタが追加されます。

例1

次の例では、ADD_FILTERプロシージャを使用して、カレント・アプリケーションのページ1、リージョン3335704029884222でレポート名がStatisticsの対話グリッドを、DEPTNOが30でフィルタ処理する方法を示します。

BEGIN
    APEX_IG.ADD_FILTER(
        p_page_id           => 1,
        p_region_id         => 3335704029884222,
        p_filter_value      => '30',
        p_column_name       => 'DEPTNO',
        p_operator_abbr     => 'EQ', 
        p_report_name       => 'Statistics');
END;

例2

次の例では、ADD_FILTERプロシージャを使用して、カレント・アプリケーションのページ1、リージョン3335704029884222でレポート名がStatisticsの対話グリッドを、大/小文字が区別される単語Salaryが格納される行でフィルタ処理する方法を示します。

BEGIN
    APEX_IG.ADD_FILTER(
        p_page_id           => 1,
        p_region_id         => 3335704029884222,
        p_filter_value      => 'Salary', 
        p_is_case_sensitive => true, 
        p_report_name       => 'Statistics');
END;