Oracle® Fusion Middleware Oracle Reports ServicesレポートWeb公開ガイド 11g リリース 1 (11.1.1) B61375-04 |
|
![]() 前 |
![]() 次 |
この項では、Oracle Reportsコンポーネントについて簡単に説明するとともに、各コンポーネントでコマンドライン・キーワードを使用する方法の例を示します。
rwclient
(Reportsクライアント)は、コマンドラインを解析し、指定されたReports Serverに転送します。
クライアントのコマンドラインで指定されたすべてのファイル名とパスは、サーバー・マシン上のファイルとディレクトリを参照します。ただし、次のコマンドライン・キーワードに対して指定されたファイルはこれらを参照しません。
CMDFILE=
filename
。この場合は、指定されたCMDFILEが読み取られ、元のコマンドライン(CMDFILE
が記述されているコマンドライン)に追加されてから、Reports Serverに送信されます。ランタイム・エンジンによって、このコマンド・ファイルが再び読み取られることはありません。
DESNAME=
filename
DESTYPE=LOCALFILE
。この場合、DESNAME
はクライアント・マシンにあるファイルを参照します。
rwclient
とともに使用できるキーワードは、表A-1を参照してください。
例
例1: ペーパー・レポートを実行してキャッシュ
rwclient server=myrepserv report=test.rdf userid=scott/tiger@mydb
desformat=pdf
DESTYPE=cache
例2: レポート出力をファイルに送信
rwclient server=myrepserv report=test.rdf userid=scott/tiger@mydb desformat=pdf
DESTYPE=file
DESNAME=c:\mydir\test
例3: レポート出力をプリンタに送信
rwclient server=myrepserv report=test.rdf userid=scott/tiger@mydb
DESTYPE=printer
DESNAME=myprinter
例4: レポート出力を電子メールで送信
rwclient server=myrepserv report=test.rdf userid=scott/tiger@mydb desformat=pdf
DESTYPE=mail
DESNAME="emp1@comp.com, emp2@comp.com" cc="emp3@comp.com" bcc="mgr@comp.com" replyto="me@comp.com" from="me@comp.com"
例5: レポート出力をWebDAV(いずれかのWebDAVサーバーまたはOracle Portal WebDAV)に送信
rwclient server=myrepserv report=test.rdf userid=scott/tiger@mydb desformat=htmlcss
DESTYPE=webdav
DESNAME="http://myusername:mypassword@mywebdavserv.com/mydir/test.html"
例6: レポート出力をOracle Portalに送信
rwclient server=myrepserv report=test.rdf userid=scott/tiger@mydb
DESTYPE=oracleportal
desformat=PDF
PAGEGROUP=mypagegrp
OUTPUTPAGE=reports_output
ITEMTITLE=pushtoportal
STATUSPAGE=result
例7: XML PDSレポート出力をファイルに送信
rwclient server=myrepserv report=myxmlpdstest.rdf
DESTYPE=file desformat=PDF desname=c:\mydir\my.pdf
例8: JDBC PDSレポート出力をファイルに送信
rwclient server=myrepserv report=myjdbcpdstest.rdf
DESTYPE=file desformat=PDF desname=c:\mydir\myxml.pdf
p_jdbcpds=sybuser/sybpwd@server1.mydomain.com:1300
例9: レポート出力を複数の宛先に配布
rwclient server=myrepserv report=test.rdf userid=scott/tiger@mydb
DISTRIBUTE=yes
DESTINATION=c:\mydistribute.xml
例10: スケジュールされたレポートの実行
rwclient server=myrepserver report=test.rdf
SCHEDULE="every first fri of month from 15:53 Mar 25, 2009 retry 3 after 1 hour"
destype=file desformat=pdf desname=test.pdf
例11: 保護されたReports Serverの使用
rwclient server=myrepserv report=test.rdf userid=scott/tiger@mydb desformat=pdf destype=file desname=test.pdf
AUTHID=myadmin/myadmin
例12: レポートを電子メールによる通知で実行
rwclient server=myrepserver report=test.rdf userid=scott/tiger@mydb destype=file desformat=pdf desname=test.pdf
NOTIFYSUCCESS="emp@comp.com"
NOTIFYFAILURE="admin@comp.com"
例13: URLエンジンでフェッチするURLを指定するレポートの実行
rwclient server=myrepserver report=test.rdf userid=scott/tiger@mydb destype=file desformat=pdf desname=test.pdf
JOBTYPE=rwurl
URLPARAMETER="http://www.oracle.com"
rwrun
(Reports Runtime)では、各自のインプロセス・サーバー(デフォルトのインプロセスReports Serverと混同しないこと)を起動してレポートを実行します。これは、rwrun
プロセスと同じJVMで実行します。
このインプロセス・サーバーの構成ファイルはrwbuilder.conf
で、トレース・ファイルはrep_
machinename
-rwbuilder
ディレクトリに保存されます。
注意:
|
rwrun
とともに使用できるキーワードは、表A-1を参照してください。
例
例1: レポートのカスタマイズ
rwrun userid=scott/tiger@mydb report=emp.rdf
CUSTOMIZE=empcustomize.xml
destype=file desformat=pdf desname=emp.pdf
例2: レポート出力をファイルに送信
rwrun report=test.rdf userid=scott/tiger@mydb desformat=pdf
DESTYPE=file
DESNAME=c:\mydir\test.pdf
例3: レポート出力をプリンタに送信
rwrun report=test.rdf userid=scott/tiger@mydb
DESTYPE=printer
DESNAME=myprinter
例4: レポート出力を電子メールで送信
rwrun report=test.rdf userid=scott/tiger@mydb desformat=pdf
DESTYPE=mail
DESNAME="emp1@comp.com, emp2@comp.com" cc="emp3@comp.com" bcc="mgr@comp.com" replyto="me@comp.com" from="me@comp.com"
例5: レポート出力をWebDAV(いずれかのWebDAVサーバーまたはOracle Portal WebDAV)に送信
rwrun report=test.rdf userid=scott/tiger@mydb desformat=htmlcss
DESTYPE=webdav
"DESNAME"="http://myusername:mypassword@mywebdavserv.com/mydir/test.html"
例6: レポート出力をOracle Portalに送信
rwrun report=test.rdf userid=scott/tiger@mydb
DESTYPE=oracleportal desformat=PDF PAGEGROUP=mypagegrp OUTPUTPAGE=reports_output ITEMTITLE=pushtoportal STATUSPAGE=result
例7: XML PDSレポート出力をファイルに送信
rwrun report=myxmlpdstest.rdf destype=file desformat=PDF desname=c:\mydir\my.pdf
例8: JDBC PDSレポート出力をファイルに送信
rwrun report=myjdbcpdstest.rdf destype=file desformat=PDF desname=c:\mydir\myxml.pdf
P_JDBCPDS=sybuser/sybpwd@server1.mydomain.com:1300
例9: レポート出力を複数の宛先に配布
rwrun report=test.rdf userid=scott/tiger@mydb
DISTRIBUTE=yes
DESTINATION=c:\mydistribute.xml
例10: 保護されたReports Serverの使用
rwrun report=test.rdf userid=scott/tiger@mydb desformat=pdf destype=file desname=test.pdf
AUTHID=myadmin/myadmin
例11: レポートを電子メールによる通知で実行
rwrun report=test.rdf userid=scott/tiger@mydb destype=file desformat=pdf desname=test.pdf
NOTIFYSUCCESS="emp@comp.com"
NOTIFYFAILURE="admin@comp.com"
rwbuilder
により、Oracle Reports Builderを起動します。コマンドラインでrwbuilder
にREPORT|MODULE
キーワードを指定すると、Oracle Reports Builderが起動し、指定されたレポートがオブジェクト・ナビゲータ内で強調表示されます。指定されたレポートがないと、既存のレポートを開くか新規レポートを作成するかを選択する「ようこそ」ダイアログとともにOracle Reports Builderが起動します。
rwbuilder
とともに使用できるキーワードは、表A-1を参照してください。
例
rwbuilder report=myrep.rdf userid=scott/tiger@mydb
rwconverter
(Reports Converter)によって、1つ以上のレポート定義またはPL/SQLライブラリをある保存形式から別の保存形式に変換できます。たとえば、rwconverter
を使用して次のような処理ができます。
レポート・ファイルとXMLファイルの組合せによる新しいレポートの作成
.rdf
ファイルに格納されたレポートを.rep
、.rex
、.jsp
または.tdf
(テンプレート)ファイルに変換
注意: レポートをテンプレートに変換する場合、レポートのヘッダー・セクションとトレーラ・セクションおよびマージン領域にあるオブジェクトのみがテンプレートに使用されます。メイン・セクションにあるオブジェクトは無視されます。 |
.rex
ファイルに格納されたレポートを.rdf
またはテンプレート(.tdf
ファイル)に変換
データベースに格納されたライブラリを.pld
または.pll
ファイルに変換
.pld
ファイルに格納されたライブラリをデータベース・ライブラリまたは.pll
ファイルに変換
.pll
ファイルに格納されたライブラリを.pld
ファイルのデータベース・ライブラリに変換
注意: 連結ライブラリ付きのレポートを変換する場合、レポートに連結された |
Oracle Portalにレポートをバッチ登録するPL/SQLスクリプトの作成
rwconverter
によって、変換処理の一部として、レポートのPL/SQLが自動的にコンパイルされる場合もあります。変換先が.rexファイルでない場合、次の状況では、rwconverter
によってPL/SQLが自動的にコンパイルされます。
変換先が.rep
ファイルの場合。コンパイルでエラーが発生すると、rwconverter
によりエラー・メッセージが表示され、.repファイルは作成されません。
ソースとして.rex
ファイルを使用する場合。コンパイルでエラーが発生すると、rwconverter
により警告が表示されますが、変換処理は続行します。
ソースとして別のプラットフォーム上で作成されたレポートを使用する場合。コンパイルでエラーが発生すると、rwconverter
により警告が表示されますが、変換処理は続行します。
その他の状況では、各自でレポートのPL/SQLをコンパイルする必要があります(たとえば、Oracle Reports Builderで「プログラム」→「コンパイル」→「すべて」を使用)。
注意: フォントは、変換時ではなく、Oracle Reports BuilderやReports Runtimeでレポートを開くときにマップされます。 |
rwconverter
とともに使用できるキーワードは、表A-1を参照してください。
例:
rwconverter scott/tiger@mydb stype=rdffile source=inven1.rdf dtype=xmlfile dest=inven1_new.xml
rwservlet
(Oracle Reports Servlet)は、WebサーバーまたはJava EEコンテナ(Oracle WebLogic Serverなど)とReports Serverとの間で情報を変換して送信します。これにより、Webブラウザからレポートを動的に実行できます。オプションでインプロセスReports Serverも使用できます。これは、クライアントから最初のリクエストを受信するたびにサーバーを自動的に起動する手段になるので、Reports Serverのメンテナンスと管理が軽減されます。
rwservlet
とともに使用するキーワードは、Webコマンドとも呼ばれます。Oracle Reports 11g リリース1 (11.1.1)では、rwservlet
Webコマンドのセキュリティ・アクセス・レベルとして、次の2つのカテゴリが導入されています。
管理者専用Webコマンド: DELAUTH、GETSERVERINFO、KILLENGINE、PARSEQUERY、SHOWENV、SHOWJOBS、SHOWMAP、SHOWMYJOBS
管理者は、エンド・ユーザー用Webコマンドと管理者専用Webコマンドの両方を実行できます。セキュアでないサーバーの場合、管理者のユーザーIDとパスワードを、Reports Server構成ファイルのidentifier要素に設定できます。
第7.8.4項「Webコマンドのセキュリティ・ポリシーの定義」で説明されているように、セキュリティ・アクセス・レベルはOracle Enterprise Managerを使用して指定します。
注意:
|
注意: キーワードのSHOWENV、SHOWJOBS、SHOWMAP、SHOWMYJOBS、KILLJOBID、KILLENGINE、PARSEQUERY、DELAUTH、GETJOBIDおよびGETSERVERINFOは、keyword=valueのペアではなくコマンドです。つまり、対応する値を指定せずに、コマンドだけを入力します。 |
rwservlet
とともに使用できるキーワードは、表A-1を参照してください。
例
次の例では、myias.mycomp.com
は、Oracle Application Serverインスタンスであり、7779
はrwservlet
が実行されるポートです。
例1: ペーパー・レポートをブラウザ(キャッシュ)で実行
http://myias.mycomp.com:7779/reports/rwservlet?
DESTYPE
server=myrepserv+report=test.rdf+userid=scott/tiger@mydb+
desformat=pdf+=cache
例2: レポート出力をファイルに送信
http://myias.mycomp.com:7779/reports/rwservlet?
DESTYPE
server=myrepserv+report=test.rdf+userid=scott/tiger@mydb+
desformat=pdf+=file+
DESNAME=c:\mydir\test
例3: レポート出力をプリンタに送信
http://myias.mycomp.com:7779/reports/rwservlet?
DESTYPE
server=myrepserv+report=test.rdf+userid=scott/tiger@mydb+=printer+
DESNAME=myprinter
例4: レポート出力を電子メールで送信
http://myias.mycomp.com:7779/reports/rwservlet?
server=myrepserv+report=test.rdf+userid=scott/tiger@mydb+
DESTYPE
desformat=pdf+=mail+
DESNAME="emp1@co
mp.com,
CC=
emp2@comp.com"+"emp3@comp.com"+
BCC="mgr@comp.com"+
REPLYTO="me@comp.com"+
FROM=me@comp.com"
例5: レポート出力をWebDAV(いずれかのWebDAVサーバーまたはOracle Portal WebDAV)に送信
http://myias.mycomp.com:7779/reports/rwservlet?
server=myrepserv+report=test.rdf+userid=scott/tiger@mydb+
DESTYPE
desformat=htmlcss+=webdav+
DESNAME=
"http://myusername:mypassword@mywebdavserv.com/mydir/test.html"
例6: レポート出力をOracle Portalに送信
http://myias.mycomp.com:7779/reports/rwservlet?
server=myrepserv+report=test.rdf+userid=scott/tiger@mydb+
PAGEGROUP
destype=oracleportal+desformat=PDF+=
mypagegrp+
OUTPUTPAGE=reports_
output+
ITEMTITLE=pushtoportal+
STATUSPAGE=result
例7: XML PDSレポート出力をファイルに送信
http://myias.mycomp.com:7779/reports/rwservlet?
DESNAME
server=myrepserv+report=myxmlpdstest.rdf+destype=file+
desformat=PDF+=c:\mydir\my.pdf
例8: JDBC PDSレポート出力をファイルに送信
http://myias.mycomp.com:7779/reports/rwservlet?
server=myrepserv+report=myjdbcpdstest.rdf+destype=file+
desformat=PDF+desname=c:\mydir\myxml.pdf+
P_JDBCPDS=sybuser/sybpwd@server1.mydomain.com:1300
例9: レポート出力を複数の宛先に配布
http://myias.mycomp.com:7779/reports/rwservlet?
server=myrepserv+report=test.rdf+userid=scott/tiger@mydb+
DISTRIBUTE=yes+
DESTINATION=c:\mydistribute.xml
例10: スケジュールされたレポートの実行
http://myias.mycomp.com:7779/reports/rwservlet?
server=myrepserver+report=test.rdf+
SCHEDULE="every first fri of month from 15:53 Oct 23, 2007 retry 3 after 1 hour"
+destype=file+desformat=pdf+desname=test.pdf
例11: 保護されたReports Serverの使用
http://myias.mycomp.com:7779/reports/rwservlet?
AUTHID
server=myrepserv+report=test.rdf+userid=scott/tiger@mydb+
desformat=pdf+destype=file+desname=test.pdf+=myadmin/myadmin
例12: キー・マップ・ファイルの使用(詳細は、第18.13項「キー・マップ・ファイルの使用」を参照)
http://myias.mycomp.com:7779/reports/rwservlet?key1
説明:
key1
は、cgicmd.dat
ファイルで定義されたキーです(キー名は最初のパラメータです)。
または
http://myias.mycomp.com:7779/reports/rwservlet?
CMDKEY
server=myrepserv+userparam=12+=keyname
例13: レポートをパラメータ・フォームで実行
http://myias.mycomp.com:7779/reports/rwservlet?
PARAMFORM
server=myrepserver+report=test.rdf+userid=scott/tiger@mydb+
destype=cache+desformat=htmlcss+=html
例14: レポートを電子メールによる通知で実行
http://myias.mycomp.com:7779/reports/rwservlet?
server=myrepserver+report=test.rdf+userid=scott/tiger@mydb+
NOTIFYSUCCESS
destype=file+desformat=pdf+desname=test.pdf+="emp@comp.com"+
NOTIFYFAILURE="admin@comp"
例15: URLエンジンでフェッチするURLを指定するレポートの実行
http://myias.mycomp.com:7779/reports/rwservlet?
server=myrepserver+report=test.rdf+userid=scott/tiger@mydb+
JOBTYPE
destype=file+desformat=pdf+desname=test.pdf+=rw
url+
URLPARAMETER="http://www.oracle.com"
例16: サーバーmyrepserver
の環境情報の表示
http://myias.mycomp.com:7779/reports/rwservlet/
SHOWENV?
server=myrepserver+authid=myrepuser/myreppassword
例17: サーバーmyrepserver
の過去のジョブ情報の表示
http://myias.mycomp.com:7779/reports/rwservlet/
SHOWJOBS?server=myrepserver+authid=myrepuser/myreppassword
+queuetype=past
例18: cgicmd.dat
キー・マッピングの表示(詳細は、第18.13項「キー・マップ・ファイルの使用」を参照)
http://myias.mycomp.com:7779/reports/rwservlet/
SHOWMAP? authid=myrepuser/myreppassword
例19: ユーザーmyrepuser
の現行ジョブ情報の表示
http://myias.mycomp.com:7779/reports/rwservlet/
SHOWMYJOBS?
server=myrepserver+authid=myrepuser/myreppassword+
queuetype=current
例20: ジョブID 30
のジョブのステータスの取得
http://myias.mycomp.com:7779/reports/rwservlet/
SHOWJOBID30?
server=myrepserver+authid=myrepuser/myreppassword
例21: ジョブID 122
の現在実行中のジョブの取消し
http://myias.mycomp.com:7779/reports/rwservlet/
KILLJOBID122?
server=myrepserver+authid=myrepuser/myreppassword
例22: コマンドの解析済問合せの表示
http://myias.mycomp.com:7779/reports/rwservlet/
PARSEQUERY?
server=myrepserver+authid=myrepuser/myreppassword+
report=test.rdf+userid=scott/tiger@db+destype=cache+
desformat=htmlcss
例23: DB認証ページの表示
http://myias.mycomp.com:7779/reports/rwservlet/
SHOWAUTH?
server=myrepserver+authid=myrepuser/myreppassword+authtype=D
例24: rwservlet
によって設定されたCookieの削除
http://myias.mycomp.com:7779/reports/rwservlet/
DELAUTH?
server=myrepserver+authid=myrepuser/myreppassword
例25: サーバーmyrepserver
からのジョブID 87
のジョブの出力の取得
http://myias.mycomp.com:7779/reports/rwservlet/
GETJOBID87?
server=myrepserver+authid=myrepuser/myreppassword
例26: サーバーmyrepserver
のサーバー情報の表示
http://myias.mycomp.com:7779/reports/rwservlet/
GETSERVERINFO?
server=myrepserver+authid=myrepuser/myreppassword
例27: サーバーmyrepserver
のエンジンrwEng-1
の強制終了
http://myias.mycomp.com:7779/reports/rwservlet/
KILLENGINE1?
type=rwEng+server=myrepserver+authid=myrepuser/myreppassword
rwserver
(Reports Server)により、クライアント・リクエストを処理します。この処理では、認証と認可の確認、スケジューリング、キャッシュ処理、配布(プラガブル出力先への配布など)などの各種サービスにクライアント・リクエストを割り当てます。また、Reports Serverでは、リクエストされたレポートを生成するランタイム・エンジンを起動したり、生成されたレポートをReportsキャッシュから取り出したり、ジョブの準備が完了したことをクライアントに通知します。
rwserver
とともに使用できるキーワードは、表A-1を参照してください。
Oracle Enterprise Managerを使用してReports Serverを管理するには、第7章「Oracle Enterprise ManagerによるOracle Reports Servicesの管理」を参照してください。
手動で構成する場合は、第8.2項「Reports Server構成ファイル」を参照してください。
rwbridge
(Oracle Reports Bridge)はReports ServerとOracle Reports Clientが異なるファームにあるときに使用します。Oracle Reports Clientは、デフォルトのブロードキャスト・メカニズムを使用して、サーバーを検出します。このメカニズムではファーム内のみで転送できるパケットが送信されます。Oracle Reports Bridgeは、1つのネットワーク内の2つのファームをブリッジできます。これは、Reports ServerとOracle Reports Clientによってブロードキャストされたパケットを取得し、Oracle Reports Bridge構成ファイルで構成されたリモート・ブリッジに転送します。
rwbridge
には、コマンドライン・キーワードはありません。
Oracle Reports Bridgeを構成するには、第7.5項「Oracle Reportsコンポーネントの構成」を参照してください。
Oracle Reports Bridgeの起動や停止を行うには、第6章「Oracle Reports Servicesの起動と停止」を参照してください。