Oracle® Fusion Middleware Oracle Reports ServicesレポートWeb公開ガイド 11g リリース1(11.1.1) B61375-01 |
|
![]() 戻る |
![]() 次へ |
Oracle Portalでレポートをバッチ登録するには、次の手順を実行します。
SQL*Plusで実行可能なレポート登録用SQLスクリプトを生成する手順は、次のとおりです。
オペレーティング・システム・プロンプト(DOSまたはUNIX)から、rwconverter
コマンドをキーワードとともに入力して、レポート定義ファイルをバッチ登録します。
注意: 必要なロード関数を持つスクリプト・ファイルを作成するには、DTYPE 、STYPE 、SOURCE およびDEST キーワードを指定します。Oracle Portalで機能パッケージを作成するには、スクリプト・ファイルの作成に使用したキーワードに加え、P_SERVERS 、P_PRIVILEGE 、P_TYPES 、P_FORMATS の各キーワードを指定する必要があります。 |
次に、Microsoft Windowsでのrwconverter
コマンドラインの例を示します。
rwconverter.exe dtype="register" stype="rdffile" source="(security.rdf,earnings.rdf,acc_pay.rdf)" dest="(output.sql)" p_owner="PORTAL_APP" p_servers="(repserver,acct_server)" p_description="restricted report" p_privilege="(SCOTT,JABERS,ACCT)" p_availability="production" p_types="(Cache,printer)" p_formats="(HTMLCSS,PDF)" p_printers="(sales_printer,acct_printer)" p_pformTemplate="public.finance_template" p_trigger="Is begin IF UPPER(DESTYPE) = ''PRINTER'' AND EMPNAME = ''SMITH'' THEN RETURN(TRUE); ELSE RETURN(FALSE); END IF; end;"
前述のコマンドラインを指定すると、output.sql
という名前で、次の内容を含むSQLスクリプト・ファイルが生成されます。
SET SERVEROUTPUT ON VAR STATUS NUMBER; EXEC :STATUS := RWWWVREG.REGISTER_REPORT (P_NAME=>'Security', P_OWNER=>'PORTAL_APP', P_SERVERS=>'repserver,acct_server', P_FILENAME=>'security.rdf', P_DESCRIPTION=>'restricted report', P_PRIVILEGE=>'SCOTT,JABERS,ACCT', P_AVAILABILITY=>'production' P_TYPES=>'Cache,printer', P_FORMATS=>'HTMLCSS,PDF', P_PRINTERS=>'sales_printer,acct_printer P_PFORMTEMPLATE=>'public.finance_template' P_PARAMETERS=>'(P_LASTNAME) (P_SSN)', P_TRIGGER=>'Is begin IF UPPER(DESTYPE) = ''PRINTER'' AND EMPNAME = ''SMITH''THEN RETURN(TRUE); ELSE RETURN(FALSE); END IF; end;'); EXEC :STATUS := RWWWVREG.REGISTER_REPORT (P_NAME=>'Earnings', P_OWNER=>'PORTAL_APP', P_SERVERS=>'repserver,acct_server', P_FILENAME=>'earnings.rdf', P_DESCRIPTION=>'restricted report', P_PRIVILEGE=>'SCOTT,JABERS,ACCT', P_AVAILABILITY=>'production' P_TYPES=>'Cache,printer)', P_FORMATS=>'HTMLCSS,PDF', P_PRINTERS=>'sales_printer,acct_printer', P_PFORMTEMPLATE=>'public.finance_template', P_TRIGGER='Is begin IF UPPER(DESTYPE) = ''PRINTER'' AND EMPNAME = ''JABERS'' THEN RETURN(TRUE); ELSE RETURN(FALSE); END IF; end;'); EXEC :STATUS := RWWWVREG.REGISTER_REPORT (P_NAME=>'Acc_pay', P_OWNER=>'PORTAL_APP', P_SERVERS=>'repserver,acct_server', P_FILENAME=>'acc_pay.rdf', P_DESCRIPTION=>'restricted report', P_PRIVILEGE=>'SCOTT,JABERS,ACCT', P_AVAILABILITY=>'production' P_TYPES=>'Cache,printer', P_FORMATS=>'HTMLCSS,PDF', p_printers=>'sales_printer,acct_printer', P_PFORMTEMPLATE=>'public.finance_template' P_TRIGGER=>'Is begin IF UPPER(DESTYPE) = ''PRINTER'' AND EMPNAME = ''JABERS''THEN RETURN(TRUE); ELSE RETURN(FALSE); END IF; end;');
このSQLスクリプト・ファイルの内容の詳細は、第C.3項「PL/SQLバッチ登録ファンクション」を参照してください。
reports.log
ファイルで、変換処理中に発生したエラーがないかどうかを確認します。このファイルは通常、現在作業中のディレクトリに作成されます。reports.log
ファイルが生成されなかった場合、rwconverter
で発生したエラーがないことを示します。
ここで、システム・パラメータおよびユーザー・パラメータの値を必要に応じて編集できます。たとえば、前述のサンプル・スクリプトで最初のRWWWVREG
ファンクションにより、P_PARAMETERS
という追加パラメータが生成されました。この処理が行われた理由は、security.rdfファイルに、P_LASTNAME
とP_SSN
という2つのユーザー定義パラメータが次のように記述されているためです。
P_PARAMETERS=>'(P_LASTNAME)(P_SSN)',
この場合、デフォルト、下限、上限の各値をオプションで定義したり、各ユーザー・パラメータの値リストを定義して、実行時にユーザーが入力できる値を制限できます。同様に、システム・パラメータを制限する場合には(たとえば、COPIES
を使用してユーザーが作成できるコピーの数を制限する場合)、P_PARAMETERS
キーワードを使用します。編集後のP_PARAMETERS
キーワードは、次のようになります。
P_PARAMETERS=>'(P_LASTNAME, LOV=LASTNAME_LOV)(P_SSN)(COPIES, DEFAULT=1,LOW=1,HIGH=2)'
この修正後のコード・セグメントでは、レポートは次のように制限されます。
P_LASTNAME
ユーザー・パラメータは、LASTNAME_LOV
値リストに含まれる値に制限されます。
P_SSN
にユーザーが指定する値が必要です。
COPIES
システム・パラメータのデフォルト値は1、また印刷部数は1か2である必要があります。
output.sql
ファイルを保存して閉じます。
レポートをOracle Portalに実際に登録するには、rwconverter
により生成したスクリプトを実行する必要があります。
SQL*Plusを開始し、パッケージ・プロシージャを所有させるOracle Portalスキーマに接続します。
SQL*Plusコマンド・プロンプトから、rwconverter
で作成したスクリプトを実行します。
@ output.sql
このスクリプトにより、スクリプトに示された各レポートについて、指定されたパラメータを使用してOracle Portalでパッケージの実行と作成が行われます。
RW_ADMINISTRATOR
権限を持つユーザーとしてOracle Portalにログインします。
「企業ドキュメント」タブをクリックします。
「ビルダー」をクリックします。
「管理」タブをクリックします。
「Oracle Reportsセキュリティ」ポートレットで、「Oracle Reportsセキュリティの設定」をクリックします。
「レポート定義ファイル・アクセス」ポートレットで、SQLスクリプトでバッチ登録したいずれかのレポートのP_NAME
を入力します。
「編集」をクリックします。「コンポーネントの管理」ページが表示されます。
ページ下部の「編集」をクリックして、レポートのパラメータを編集します。
パラメータを必要に応じて編集します。
「OK」をクリックします。
「閉じる」をクリックします。
スクリプトでバッチ登録したレポートごとに手順8〜13を繰り返します。