2
拡張概念

この章では、Oracle Reportsの上級者を対象に概要を説明します。この章の各項は、Oracle Reportsオンライン・ヘルプの「拡張概念」の項にも含まれています（第3.1.1項「Oracle Reportsオンライン・ヘルプの使用」を参照）。

トピックは次の各項に分類されています。

2.1 レポート

この項のトピックは、第1.2項「レポート」で説明した基本的な概念に基づいています。

2.1.1 レポートのタイトルについて

次のいずれかの方法で、レポートにタイトルを追加できます。

ペーパー・レイアウト・ビューのマージンに、ボイラープレート・テキスト・オブジェクトを手動で作成します。
レポート・ウィザードの「スタイル」ページで「タイトル」フィールドに入力します。

レポート・ウィザードを使用してタイトルを追加するときに、レポート出力用のテンプレートを選択しない場合は、Reports Builderに定義されているデフォルト属性を使用して、タイトルがレポートのマージンに挿入されます。これらの属性は、ペーパー・レイアウト・ビューで変更できます。

レポート・ウィザードを使用してタイトルを追加するときに、レポート出力用の事前定義テンプレートまたはユーザー定義テンプレート・ファイルを選択する場合は、選択したテンプレートに定義されているB_OR$REPORT_TITLEという名前のボイラープレート・テキスト・オブジェクトが検索されます。

B_OR$REPORT_TITLEがある場合は、レポート・ウィザードで入力したタイトルのテキストが、このオブジェクトの属性を使用して表示されます。
B_OR$REPORT_TITLEが見つからない場合、タイトルは、選択したテンプレートの「デフォルト」プロパティ（プロパティ・インスペクタの「タイトル」ノードの下）に定義されている属性を使用して表示されます。

注意
レポート・ウィザードでタイトルを指定しない場合、B_OR$REPORT_TITLEオブジェクトはレポートにコピーされません。

レポート・ブロック・ウィザードを使用して作成したレイアウトでは、タイトルはレポートのマージンに挿入されずに、グループ・タイトルとして新しいレイアウトに挿入されます。この場合、選択したテンプレートの「デフォルト」プロパティ（プロパティ・インスペクタの「タイトル」ノードの下）に従って属性が設定され、B_OR$REPORT_TITLEは無視されます。テンプレートを選択しない場合は、Reports Builderに定義されているデフォルト属性がタイトルに使用されます。

2.1.2 レポートのセクション分割と各セクションについて

レポートをセクション分割することで、1つのレポートに複数のレイアウトを定義でき、対象読者ごとにレイアウトを割り当てたり、異なる出力フォーマット、ページ・レイアウト、ページ・サイズ、方向などを指定したりできます。レポート・セクションは3つまで定義でき、各セクションには本体用の領域とマージン用の領域があります。これらのセクションを、ヘッダー、メイン、トレーラと呼びます。デフォルトでは、レポートはメイン・セクションに定義されます。他のセクションには、複数のレポートを別々に作成しなくても、異なるレイアウトを定義できます。必要に応じて、ヘッダー・セクションとトレーラ・セクションのマージンと本体を使用して、レポートにヘッダー・ページとトレーラ・ページを作成することもできます。

オブジェクト・ナビゲータでは、レポートの各セクションは「ペーパー・レイアウト」ノードの下に、「ヘッダー・セクション」、「メイン・セクション」および「トレーラ・セクション」として表示されます。

レポートの3つのセクション（ヘッダー、メイン、トレーラ）のフォーマット順序は、SRW.SET_FORMAT_ORDERまたは「セクションのフォーマット順序」プロパティを使用して指定できます。この機能により、Oracle Reportsでは、任意のセクションを最初にフォーマットし、フォーマット時にのみ認識される情報（ページ番号など）を作成して、その情報を別のセクションのフォーマットに使用できます。たとえば、このプロパティを使用して目次を作成できます。この目的でのSRW.SET_FORMAT_ORDERの使用例は、第35章「単純な目次と索引を使用したペーパー・レポートの作成」および第36章「複数階層の目次を使用したペーパー・レポートの作成」を参照してください。

セクションレベルの配布の使用例は、第37章「レポートの一括処理と配布」を参照してください。この章では、「繰返し」プロパティおよびサンプルの配布XMLファイルを使用して、1つのセクションに複数の配布先を定義する方法について説明します。高度なセクション・レベルの配布と、独自の配布XMLファイル作成の詳細は、『Oracle Application Server Reports ServicesレポートWeb公開ガイド』マニュアルの「拡張配布の作成」の章を参照してください。

例

例1

セクション分割と配布を使用することで、レポート出力をHTMLで公開したり、Postscriptバージョンでプリンタに送信したりできます。

例2

シニア・マネージャにはレポートの集計サマリーを送信し、個々のマネージャには詳細な分析を電子メールで送信できます。この例では、2つのレポート・セクションを持つレポートを1つ作成する必要があります。1つは縦長のサマリー・セクションで、もう1つは横長の詳細セクションにします。「繰返し」プロパティを使用して、マネージャをリストするデータ・モデル・グループに詳細セクションを関連付け、次にデータ・モデル・グループの各インスタンスの宛先を変更することで、適切なマネージャに出力を送信します。

2.1.3 レポートのサイズの単位について

レポートの定義には、インチ、センチメートルまたはポイントを使用できます。サイズの単位は、レポートを作成するデバイスに依存しません。つまり、Reports Builderを実行する任意のプラットフォームで動作するレポートを設計できます。レポートのサイズの単位は、次の方法で変更できます。

「サイズの単位」プロパティを設定します。
rwconverterを使用してレポートを変換します。DUNITキーワードで異なるサイズの単位を指定します。
異なる環境でレポートを開きます。たとえば、キャラクタ・モードのレポートを開くと、Reports Builderでは、レポートのサイズの単位がビットマップ環境のデフォルトに変更されます。レポートを保存する場合、新しいサイズの単位でレポートが保存されます。

2.1.4 レポートのディメンションについて

レポート・ページには、長さと幅を任意に設定できます。プリンタ・ページがペーパー・レポートのページよりも小さいまたは大きい可能性があるため、物理ページと論理ページという概念が使用されます。物理ページのサイズは、プリンタで出力される1ページ分です。論理ページとはレポートの1ページのサイズで、1つの論理ページは複数の物理ページから構成されることがあります。

レポートの各セクション（ヘッダー、メイン、トレーラ）で、次のように指定します。

物理ページ（マージンを含む）のディメンションを、「幅」プロパティと「高さ」プロパティを使用して指定します。
物理ページ（プリンタ・ページ）から構成される論理ページ（レポート・ページ）のディメンションを、「ページ当りの水平パネル」プロパティ（幅）と「ページ当りの垂直パネル」プロパティ（高さ）を使用して指定します。たとえば、「ページ当りの水平パネル」のサイズを1にすると各論理ページの幅が物理ページの幅になり、「ページ当りの垂直パネル」のサイズを2にすると、各論理ページの高さは2つの物理ページ分になります。

この例では、1つの論理ページが6つの物理ページから構成されています。この論理ページには、横方向に3つの物理ページが、高さ方向に2つの物理ページがあります。したがって、「ページ当りの水平パネル」のサイズは3に、「ページ当りの垂直パネル」のサイズは2になります。論理ページの横方向に2つの物理ページ、高さ方向に3つの物理ページを構成する場合は、「ページ当りの水平パネル」のサイズに2を、「ページ当りの垂直パネル」のサイズに3を指定します。

図2-1 レポートのディメンション

画像の説明

2.1.5 レポートのフォントについて

フォントの構成ファイル、フォントの別名の作成、フォントに関するトラブルシューティング、フォント・タイプなど、Oracle Reportsでのフォントの使用方法および追加方法の詳細は、『Oracle Application Server Reports ServicesレポートWeb公開ガイド』の「Oracle Reportsのフォント」の章を参照してください。このマニュアルは、Oracle Technology NetworkのOracle Reportsドキュメントのページ（http://www.oracle.com/technology/documentation/reports.html）から入手できます。

2.1.6 条件付き書式について

「条件付き書式」ダイアログ・ボックスおよび「書式の例外」ダイアログ・ボックスを使用すると、既存の条件に基づいて選択されるレイアウト・オブジェクトに対して、出力書式属性（フォント、カラーなど）を指定できます。定義する条件を、書式の例外と呼びます。

「条件付き書式」ダイアログ・ボックスは、次のいずれかの方法で、ペーパー・レイアウト・ビューまたはペーパー・デザイン・ビューから表示できます。

オブジェクトをダブルクリックして、プロパティ・インスペクタを表示します。「標準レイアウト」ノードで、「条件付き書式」の値フィールド（「...」とラベル付けされています）をクリックします。
オブジェクトのポップアップ・メニューを表示します（Windowsでは右クリックします）。
オブジェクトをクリックして、「書式」→「条件付き書式」を選択します。

「書式の例外」ダイアログ・ボックスは、「条件付き書式」ダイアログ・ボックスで「新規」または「編集」をクリックすると表示され、定義済の条件に基づいて選択されるレイアウト・オブジェクトに対して、出力書式属性を迅速かつ簡単に指定できます。「書式の例外」ダイアログ・ボックスで現行のレイアウト・オブジェクトに条件と書式を指定したら、その定義のすべてがPL/SQLフォーマット・トリガーにエクスポートされます。レイアウト・オブジェクトにフォーマット・トリガーがすでにある場合は、Reports Builderのプロンプトで確認してから、「書式の例外」ダイアログ・ボックスの定義で既存のトリガー・コードが上書きされます。

フォーマット・トリガーはPL/SQLエディタで手動編集できますが、その後に「書式の例外」ダイアログ・ボックスを使用して変更する場合は、Reports Builderによって、既存のフォーマット・トリガーに上書きするかどうかを確認するプロンプトが表示されます。

2.1.7 ネストしたマトリックス・レポートについて

ネストしたマトリックス・レポートとは、マトリックス・グリッド内に少なくとも1つの親子リレーションシップが表示されるマトリックス・レポートのことです。

ネストしたマトリックス・レポートには3つ以上のディメンションがあるため、複数のディメンションがページの水平方向または垂直方向に配置されます。たとえば、次のレポートのサンプルを見てください（図2-2）。年ごとに、関連部門の一覧がネストして表示されます。また、職種の一覧は（水平方向の値として）一度だけ表示されます。職種の値は一度だけ表示されるため、職種の項目ごとにサマリーを作成し、サマリー結果の値を1行で表示できます。

注意
ネストしたマトリックス・レポートで、子マトリックス問合せのあるマトリックス問合せを作成した場合、結合するフィールドはマスター・マトリックスの別のグループに分ける必要があります。それ以外の場合は、プラットフォームによっては最初のグル－プのみ印刷されます。

詳細な例は、第26章「ネストしたマトリックス・レポートの作成」を参照してください。

2.1.8 グループ別マトリックス・レポートについて

グループ別マトリックス・レポートとは、マスター・グループの値ごとに異なるマトリックスを持つグループ上レポートのことです。たとえば、次のレポートの各年（マスター）には、その年の部門と職種のみを含む一意のマトリックスがあります。つまり、マトリックス内の各職種項目の位置が各年で異なる場合があるため、各職種項目のサマリーはサマリー結果の値で1行に表示できません。

複数の問合せを使用したグループ別マトリックス・レポートは、3つ以上のディメンションを持つという点で、ネストしたマトリックス・レポートに似ています。たとえば、次のレポートでは、年ごとに、関連部門の一覧がネストして表示されます。

図2-2 グループ別およびネストしたマトリックス・レポートのサンプル

画像の説明

複数の問合せを使用する利点は、ネストしているグループに対して、実際のブレークまたはマスター/ディテール・リレーションを取得できることです（たとえば、前述の複数の問合せの例では、Year 80にレコード20のみが表示されます。1つの問合せでは、Year 80に該当するデータがあるかどうかに関係なく、すべてのレコードがYear 80に対して表示されます）。特定のマスター・レコードに対して、データを持たないディテール・レコードを非表示にする場合は、複数の問合せを使用する必要があります。

詳細な例は、第27章「グループ上マトリックス・レポートの作成」のサンプル・レポートを参照してください。

2.2 Webレポート

この項のトピックは、第1.2.2項「Webレポートについて」で説明した基本的な概念に基づいています。

2.2.1 JavaServer Pages（JSP）とサーブレットについて

JavaServer Pages（JSP）テクノロジは、Sun社のJavaサーブレット・テクノロジの拡張機能で、Webページ上に動的コンテンツを表示するための簡単なプログラミング手段を提供します。JSPは、Webまたはアプリケーション・サーバーで実行される埋込みのJavaソース・コードを持つHTMLページです。HTMLはWebブラウザに表示されるページ・レイアウトを提供し、Javaはビジネス・ロジックを提供します。

JSPでは、静的なページの表示と動的なコンテンツの生成が分離されています。JSPでは、動的なアプリケーション・ロジックが静的なHTMLコンテンツから完全に切り離されているため、Javaプログラミングの経験があまりないWebページ・デザイナや経験のないWebページ・デザイナでも、単純にHTMLタグまたはXMLタグを使用して、コンテンツの生成に影響を与えることなくJSPページの外観を変更し、動的に生成されるWebページを設計およびフォーマットできます。JSP固有のタグまたはJavaベースのスクリプレットは、Webページに動的なコンテンツを生成するコンポーネントをコールするために使用します。

JSPには.jsp拡張子があります。この拡張子によって、Web Serverに、ページの処理にJSPコンテナが必要なことが通知されます。JSPコンテナはJSPタグとスクリプレットを解析し、JSPをJavaサーブレットにコンパイルして実行します。それにより、必要なコンテンツが生成され、その結果がHTMLページまたはXMLページとしてブラウザに返信されます。

JSPは、一般的にインターネットまたは企業のイントラネット経由で、ブラウザベースのクライアントからアクセスおよび実行できます。JSPアプリケーションは、従来のクライアント/サーバー・アプリケーションと次の点で異なります。

幅広い種類のクライアント・マシンとブラウザで実行できます。
Thinクライアントで実行できるため、クライアント・マシンのリソース消費が軽減されます。
より多くの同時ユーザーに対応できます。
インストールおよび保守に必要な作業が少なくなります。

JSPが初めてコールされるときは、Javaサーブレット・クラスにコンパイルされ、Web Serverのメモリーに格納されます。JSPはメモリーに格納されるため、同じページへのコールは2回目以降速くなり、その結果、HTTPリクエストごとに新しいプロセスを起動するという、従来のCommon Gateway Interface（CGI）プログラムで見られたパフォーマンス上の制限が回避されます。

JSPテクノロジに関する他の一般的な情報は、Sun社のJavaおよびJ2EEに関するWebサイト（http://java.sun.com）を参照してください。

2.2.1.1 Oracle ReportsでのJSPの使用

Oracle Reportsでは、Reports Builderを使用して取得する情報でWebページを拡張できるように、基盤テクノロジとしてJavaServer Pages（JSP）がサポートされます。

Oracle Reportsでは、データ・モデルを使用して取得したデータをJSPにより既存のWebページに埋め込み、JSPベースのWebレポートを作成します。JSPレポートは新規作成することも、既存のレポートをJSPレポートとして保存することもできます。新しく作成するレポートは、デフォルトでJSPレポートとして保存されます。レポートをJSPとして保存する場合の利点は、JSPがテキスト・ファイルのため、バイナリの.rdfフォーマットなどに比べて簡単に編集できる点です。レポートをJSPファイルとして保存すると、そのデータ・モデルがXMLタグを使用して埋め込まれます。現在、レポート全体をXMLタグを使用して定義することも、XMLファイルとして保存することもできます。

Oracle ReportsのカスタムJSPタグを使用すると、既存のJSPファイルにレポート・ブロックやグラフを簡単に追加できます。これらのタグをテンプレートとして使用すれば、JSPベースのWebレポートに、独自のデータドリブンJavaコンポーネントを構築して挿入できます。JSPでは、レポート・ブロックをカプセル化しているHTMLまたはXMLコードの編集に加えて、本体と属性を変更、追加または削除することで、JSP自体でレポート・ブロックを編集することもできます。

レポート・エディタのWebソース・ビューには、HTMLタグ、XMLタグおよびJSPタグを含むWebレポートのソース・コードが表示されます。

デフォルトで、Reports Builderで作成した新規のJSPの内容は次のとおりです。
<%@ page contentType="text/html;charset=ISO-8859-1" %>
JSPをReports Builder以外で作成する場合は、必ず同様のエンコーディング情報を含める必要があります。

以前のリリースで、Oracle Reportsではペーパーベースのレポートに追加できるWebリンクが導入されました。このリンクは、ペーパー・レポートをWebブラウザまたはPDFビューアで表示するときにアクティブになります。JSPレポートでは、ハイパーリンクを手動で作成する必要があります。また、ハイパーリンクでデータ値を代入する必要がある場合は、データ値をrw:fieldというJSPタグで指定する必要があります。たとえば、次のように指定します。

<a href="http://server/path/rwservlet?report=department.jsp&p_deptno=<rw:field

  id="F_Deptno" src="Deptno"/>">
<rw:field id="F_Deptno" src="Deptno">10</rw:field>
</a>

2.2.1.2 エンコードされたJSPベースのWebレポートの起動または実行

JSPベースのWebレポートの文字コード（EUC-JPなど）が、NLS_LANG環境変数のキャラクタ・セット部分（JA16SJISなど）と異なる場合、次のエラーが表示されます。

JSPファイルを実行したとき:

REP-6106またはREP-6104（javax.servlet.jsp.JspException (multibyte)）
REP-0495 Unable to tokenize the query (singlebyte)
Reports Builderを使用してJSPファイルを起動したとき:

REP-0069 Internal ErrorまたはREP-6106

この問題に対処するには、JSPベースのWebレポートの文字コードが、Reports BuilderのNLS_LANG環境変数のキャラクタ・セット部分に対応するIANAエンコーディングに一致することを確認する必要があります。

次に例を示します。

JSPベースのWebレポート・エンコーディング:

<%@ page contentType="text/html;charset=EUC-JP" %> <META http-equiv="Content-Type" content="text/html;charset=EUC-JP">

このJSPファイルはキャラクタ・セット（EUC-JP）でエンコードする必要があります。
Reports Builderのエンコーディング:

NLS_LANG=JAPANESE_JAPAN.JA16EUC

この例では、JSPベースのWebレポートのエンコーディング（EUC-JP）が、Reports BuilderのNLS_LANGのキャラクタ・セット部分、つまりJA16EUCと一致しています。

2.2.1.3 JSPファイルへのキャラクタ・セットの動的な埋込み

Oracle Reportsでは、Webレポートのテンプレートはデフォルトで西欧文字コード用に構成されています。他の言語に関しては、<Meta>タグのcharset属性と<%@page%>ページ・ディレクティブの両方を使用して、すべてのJSPファイルに文字コードを指定できます。

適切な文字コードをJSPファイルに動的に関連付けるには、次の変更を行います。

rw*.htmlファイルおよびblank_template.jspファイルを次のように編集します。
- ページ・ディレクティブを次のように変更します。
 
 <%@ page contentType="text/html;charset=yourIANAencoding" %>
 
 前述のディレクティブ中にある変数の意味は次のとおりです。
 
 yourIANAencodingは、NLS_LANG変数のNLS_CHARACTERSET部分に対応するIANAエンコーディング名です。
- <Head>タグ内の<Meta>タグを次のように変更します。
 
 <meta http-equiv="Content-Type" content="text/html;charset=yourIANAencoding" />
template.xsl（ORACLE_HOME/reports/templates/）ファイルを次のように編集します。
- <xsl:output>タグを次のように変更します。
 
 <xsl:output method="jsp" indent="yes" encoding="yourIANAencoding" />
 
 前述のディレクティブ中にある変数の意味は次のとおりです。
 
 yourIANAencodingは、NLS_LANG変数のNLS_CHARACTERSET部分に対応するIANAエンコーディング名です。
- 次のページ・ディレクティブをファイルに追加します。
 
 <%@ page contentType="text/html;charset=yourIANAencoding" %>
- タグ内の<META>タグを追加または変更します。
 
 <meta http-equiv="Content-Type" content="text/html;charset=yourIANAencoding" />
 
 前述のディレクティブ中にある変数の意味は次のとおりです。
 
 yourIANAencodingは、NLS_LANG変数のNLS_CHARACTERSET部分に対応するIANAエンコーディング名です。

2.2.2 JSPベースのWebレポートのプレビューについて

JSPベースのWebレポートをプレビューするには、ツールバーの「Webレイアウトを実行」ボタンをクリックするか、「プログラム」→「Webレイアウトを実行」を選択してWebソースを実行します。Reports Builderによって、Webレポートがデフォルトのブラウザに表示されます。

注意

デフォルトのブラウザがNetscape 7.0で、ブラウザが表示されない場合、レジストリ・キーHKEY_CURRENT_USERS¥Software¥ Oracle¥Toolkit¥Tkbrowserをデフォルトのブラウザの場所に設定します。BrowserNameキーおよびBrowserPathキーが正しい値を反映していることを確認してください。たとえば、次のようになります。BrowserName=Netscape 7; BrowserPath=C:¥Program Files¥Netscape¥Netscape¥Netscp.exe

major.minorバージョン関連のエラーで「Webレイアウトを実行」が失敗した場合、CLASSPATH環境変数またはREPORTS_CLASSPATH環境変数を次のように更新する必要があります。oc4j.jarファイル・パス内の9.0.x ORACLE_HOMEの指定を削除します（oc4j.jarファイル・パスは10gリリース2（10.1.2）ORACLE_HOMEのみを指定している必要があります）。

この機能を使用するために、Reports Serverを構成する必要はありません。Reports Builderには、埋込みのOracle Container for Java（OC4J）サーバーが用意されています。Reports Builderの各インスタンスはそれぞれ専用のOC4Jサーバーを持ち、一意なポートをリスニングしています。そのため、同時に複数のReports Builderセッションが可能になります。ポートを指定しない場合、Reports Builderではデフォルトの範囲にある空のポートが自動的に検索されます。OC4Jオプションを使用してJSPレポートをローカルでプレビューする場合、JSPがイメージなどの外部ファイルに依存していたり、または生成されるJavaファイルを確認したりする場合は、Reports Builderによる一時ファイルの処理方法を理解しておく必要があります。

JSPは.javaファイルに変換され、クラス・ファイルにコンパイルされます。クラス・ファイルを実行すると、.htmlファイルとしてHTMLが返されます。この.htmlファイル、.javaファイルおよび.classファイルは、すべて$REPORTS_TMP/docrootディレクトリに置かれます。$REPORTS_TMPはコマンドライン・パラメータとしてReports Builderに渡すことができるので、docrootディレクトリのデフォルトの場所は変更できます。docrootディレクトリのファイルは、Reports Builderの終了時にクリーン・アップされます。

ドキュメント・ルート

デフォルトでは、Reports Builderのドキュメント・ルートは、$REPORTS_TMP環境変数で指定したディレクトリの下にあるdocrootディレクトリ（c:/temp/docrootなど）です。エンド・ユーザーは、このデフォルトのdocrootをコマンドラインから（WEBSERVER_DOCROOTコマンドライン・キーワードを使用して）変更できます。JSPがイメージやスタイル・シートなどの外部ファイルに依存している場合は、それらをdocrootディレクトリにコピーする必要があります。また、WEBSERVER_DOCROOTコマンドライン値を独自のドキュメント・ルート・ディレクトリに指定することもできます。

ドキュメント・ルートの構造

JSPは.javaファイルに変換され、.classファイルにコンパイルされます。.classファイルを実行すると、.htmlファイルとしてHTMLが返されます。この.htmlファイル、.javaファイルおよび.classファイルは、すべて$REPORTS_TMP/docrootディレクトリに置かれます。$REPORTS_TMPはコマンドライン・パラメータとしてReports Builderに渡すことができるので、docrootディレクトリのデフォルトの場所は変更できます。docrootディレクトリのファイルは、Reports Builderの終了時にクリーン・アップされます。

emp.jspを実行した後のdocrootディレクトリの構造は次のようになります（デフォルトのdocrootである$REPORTS_TMP/docrootを使用します）。

temp
  docroot
    3000                        working directory for instance of the Builder
      default
        defaultWebApp            temporary JSP working directory
          temp
            _pages
            _empxxx.class       compiled Java class
            _empxxx.java         translated Java file
      log                        OC4J log directory
        global-application.log
        server.log
        orion-conf               OC4J configuration files directory
      stderr.log                 debug log when WEBSERVER_LOG=yes
      stdout.log
    3002                         another instance's working directory
    css                          template style sheets
    images                       template images
    WEB-INF
      lib
      reports_tld.jar
    web.xml
    rwerror.jsp                  template error JSP
    empxxx.jsp                   working copy of emp.jsp
    empxxx.html                  resulting output

使用に関する注意

生成されたファイル名にある桁数の大きな数字は、単に一意のIDで特に意味はありません（たとえば、emp012345678.jsp）。
docrootディレクトリに作成された一時ファイルは、Reports Builderの終了時にクリーン・アップされます。

2.2.3 HTML出力のWebリンクについて

このトピックでは、ペーパーベースのレポートに追加できるWebリンクについて説明します。このリンクは、レポートをHTMLファイルに生成しWebブラウザで表示するときにアクティブになります。

多くの場合、Webリンクはオブジェクトのプロパティ・インスペクタで定義できます。実行時の動的リンクは、リンク値に列名とフィールド名を指定することで作成できます。条件付き設定など、さらに複雑なWebリンクを実装する必要がある場合は、PL/SQLおよびReports Builderのビルトイン・パッケージ・プロシージャSRW.SET_ATTRを使用して、リンクを指定する必要があります。

HTMLフォーマットのレポート出力には、次の種類のWebリンクを含めることができます。

同じレポート内でのオブジェクトから他のオブジェクトへのリンク、またはオブジェクトから別のHTMLやPDFドキュメントへのリンク（第2.2.5項「ハイパーリンクについて」を参照）。
Webリンクの参照先を示す識別子（第2.2.7項「ハイパーリンクの宛先について」を参照）。参照先には、レポート・レイアウト内にある印刷可能な任意のオブジェクト（フィールド、ボイラープレート、枠など）を指定できます。
関連するオブジェクトにリンクしているマスターHTMLドキュメントのフレーム内の文字列（第2.2.8項「ブックマークについて」を参照）。ブックマークは、レポート・レイアウト内にある印刷可能な任意のオブジェクト（フィールド、ボイラープレート、枠など）に関連付けることができます。フォーマット済のレポートで、ブックマークをクリックすると、ウィンドウの上部に関連オブジェクトが表示されます。
イメージ・リソースを指定するURL。URLは、ブラウザでHTML出力を表示するときにイメージを挿入できるように、Web Serverで使用可能なものにする必要があります。
指定した宛先にグラフの領域をリンクするハイパーリンク。

さらに、エスケープを使用する次のヘッダーおよびフッターを追加して、HTMLタグをペーパーベースのレポートに追加することができます。

HTMLドキュメントの先頭にロゴまたは標準リンクを挿入するためのドキュメント・ヘッダー（レポート前値）（第2.2.10項「前および後のエスケープについて」を参照）。
HTMLドキュメントの最後にロゴまたは標準リンクを挿入するためのドキュメント・フッター（レポート後値）。
HTMLドキュメントの特定のページまたはすべてのページの先頭にロゴまたは標準リンクを挿入するためのページ・ヘッダー（ページ前値）。
HTMLドキュメントの特定のページまたはすべてのページの最後にロゴまたは標準リンクを挿入するためのページ・フッター（ページ後値）。
HTMLパラメータ・フォームのヘッダーにロゴまたは標準リンクを挿入するためのパラメータ・フォーム・ヘッダー（フォーム前値）。
HTMLパラメータ・フォームのフッターにロゴまたは標準リンクを挿入するためのパラメータ・フォーム・フッター（フォーム後値）。

2.2.4 PDF出力のWebリンクについて

このトピックでは、ペーパーベースのレポートに追加できるWebリンクについて説明します。このリンクは、レポートをPDFファイルに実行しPDFビューアで表示するときにアクティブになります。

PDFフォーマットのレポート出力には、次の種類のWebリンクを含めることができます。

同じレポート内でのオブジェクトから他のオブジェクトへのリンク、またはオブジェクトから別のHTMLやPDFドキュメントへのリンク（第2.2.5項「ハイパーリンクについて」を参照）。
Webリンクの参照先を示す識別子（第2.2.7項「ハイパーリンクの宛先について」を参照）。参照先には、レポート・レイアウト内にある印刷可能な任意のオブジェクト（フィールド、ボイラープレート、枠など）を指定できます。
関連するオブジェクトにリンクしているPDFビューアのブックマーク領域の文字列（第2.2.8項「ブックマークについて」を参照）。ブックマークは、レポート・レイアウト内にある印刷可能な任意のオブジェクト（フィールド、ボイラープレート、枠など）に関連付けることができます。フォーマット済のレポートで、ブックマークをクリックすると、ウィンドウの上部に関連オブジェクトが表示されます。
クリックしたときにコマンドを実行するリンク（第2.2.9項「アプリケーション・コマンドライン・リンクについて」を参照）。コマンドは、レポート・レイアウト内にある印刷可能な任意のオブジェクト（フィールド、ボイラープレート、枠など）に関連付けることができます。フォーマット済のレポートで、オブジェクトをクリックすると、関連付けられているコマンドが実行されます。
指定した宛先にグラフの領域をリンクするハイパーリンク。

多くの場合、Webリンクはオブジェクトのプロパティ・インスペクタで定義できます。実行時の動的リンクは、リンク値に列名とフィールド名を指定することで作成できます。条件付き設定など、さらに複雑なWebリンクを実装する必要がある場合は、PL/SQLを使用してリンクを指定する必要があります。

2.2.5 ハイパーリンクについて

ハイパーリンクは、次のいずれかの宛先へのハイパー・テキスト・リンクを指定するオブジェクトの属性です。

同じレポート内にあり、ハイパーリンクの宛先で識別されているオブジェクト
同じマシンまたはリモートのWeb Serverにある他のHTMLドキュメントやPDFドキュメント

「追加のハイパーリンク属性」プロパティを設定すると、ハイパーリンクに適用するHTMLを追加指定できます。

2.2.6 グラフ・ハイパーリンクについて

グラフ・ハイパーリンクは、グラフの領域からWebレポート内の指定の場所へのアクティブ・リンクです。エンド・ユーザーは、Web（JSPベース、あるいはペーパーベースのPDFまたはHTML）にレポートを表示し、グラフの1つ以上の領域をクリックして、別のリンク情報にドリルダウンできます。

2.2.7 ハイパーリンクの宛先について

ハイパーリンクの宛先は、ハイパー・テキスト・リンクの宛先を識別するオブジェクトの属性です。

2.2.8 ブックマークについて

ブックマークは、オブジェクトへのリンクとなる文字列を指定するオブジェクトの属性です。

2.2.9 アプリケーション・コマンドライン・リンクについて

（PDF出力のみ）アプリケーション・コマンドライン・リンクは、オブジェクトがクリックされたときに実行するコマンドラインを指定するオブジェクトの属性です。

制限

アプリケーション・コマンドライン・リンクに関連付けられているオブジェクトを、さらにWebリンクのソース（ハイパーリンク）にすることはできません。

2.2.10 前および後のエスケープについて

レポート前値には、ドキュメントの先頭に配置する任意のテキスト、グラフィックまたはHTMLコマンドを指定します。
レポート後値には、ドキュメントの最後に配置する任意のテキスト、グラフィックまたはHTMLコマンドを指定します。
ページ前値には、ドキュメントの特定のページまたはすべてのページの先頭に配置する任意のテキスト、グラフィックまたはHTMLコマンドを指定します。
ページ後値には、ドキュメントの特定のページまたはすべてのページの最後に配置する任意のテキスト、グラフィックまたはHTMLコマンドを指定します。
フォーム前値には、HTMLパラメータ・フォームの上部に配置する任意のテキスト、グラフィックまたはHTMLコマンドを指定します。
フォーム後値には、HTMLパラメータ・フォームの下部に配置する任意のテキスト、グラフィックまたはHTMLコマンドを指定します。

制限

レポート後値（第2.2.10項「前および後のエスケープについて」を参照）では、本体の外にHTMLコマンドを追加しても、レポートをスプレッドシート出力に生成したときに反映されません。これは、出力でHTMLコマンドが適切に指定されている場合でも同様です。次に例を示します。

</body><table><tr><td> the text to be bolded </td><tr></table></html>

本文終了タグの前にHTMLコマンドを追加すると、レポートをスプレッドシート出力に生成したときに正常に反映されます。次に例を示します。

<table><tr><td> the text to be bolded </td><tr></table></body></html>

スプレッドシート出力の詳細は、第2.8.13項「スプレッドシート出力について」を参照してください。

2.2.11 スタイル・シートについて

スタイル・シート（またはカスケード・スタイル・シート）は、HTMLドキュメントの書式をきわめて柔軟に設定できるようにするHTMLの拡張書式です。スタイル・シートをサポートすることで、HTMLドキュメントで次のことが可能になります。

任意のフォント・サイズまたはフォント・スタイル
オーバーラップしたオブジェクト
任意のカラーと幅を持つ水平線、垂直線および四角形
ページ上でのオブジェクトの厳密な配置
ページ番号付け
Webブラウザからの印刷
インライン・イメージ・マップ

つまり、レポートをHTMLCSSドキュメントとしてフォーマットしたときに、レポート内の高度な書式がそのまま保持されます。スタイル・シートで拡張されていないHTMLドキュメントでは、基本的なテキスト書式とインポートされたイメージのみが表示されます。スタイル・シートでは、高度にフォーマットされたテキストのイメージは、同等のスタイル、カラーおよびフォントを持つテキスト・オブジェクトに置換されます。テキスト・オブジェクトとイメージ・オブジェクトは、オーバーラップさせて配置できます。すべてのテキストは完全に検索可能で、ダウンロードするイメージも少なくてすみます。

スタイル・シートを利用したHTMLドキュメントを表示するには、スタイル・シートをサポートしているブラウザが必要です。

HTMLCSS出力での外部スタイル・シートの使用方法

現在、どの企業のWebサイトでも、Webページ全体で企業のルック・アンド・フィールを実現するためにスタイル・シートが使用されています。外部スタイル・シートは、Webページが参照するカスケード・スタイル・シート（CSS）ファイルです。エンド・ユーザーは通常、Webサイト上のページで使用されているものと同じスタイルをWebレポートに適用することを望みます。

以前のリリースでは、スタイル・シートやユーザー定義のスタイルをレポートに適用する場合、HTMLCSS出力を手動で編集する必要がありました。

Oracle Reports 10gリリース2（10.1.2）からは、HTMLCSS出力用のユーザー定義スタイルおよびスタイル・シートを、Reports Builderを使用して指定できます。スタイルは、新しいプロパティである「スタイル・シート」、「CSSクラス名」および「CSS ID」（これらのプロパティの詳細は、Oracle Reportsオンライン・ヘルプを参照）を使用して、レポート、フィールド、テキスト、枠および繰返し枠の各オブジェクトに適用できます。生成されるHTMLCSS出力にはスタイル・シートへのリンクが含まれ、ユーザー定義のスタイルがオブジェクトに適用されます。

制限

次の要素は、HTMLのスタイル・シート拡張ではサポートされません。

楕円、円弧、多角形、折れ線、対角線
丸い四角形（単純な四角形として表現されます）
矢印線
破線、オブジェクトの境界線

2.3 データ・モデル・オブジェクト

この項のトピックは、第1.7項「データ・モデル・オブジェクト」で説明した基本的な概念に基づいています。

2.3.1 サマリー列について

サマリー列は、他の列にあるデータに対して計算を実行するときに使用します。レポート・ウィザードまたはデータ・ウィザードでは、合計、平均、件数、最小値、最大値および%合計のサマリーを作成できます。また、サマリー列はデータ・モデル・ビューで手動で作成することもでき、プロパティ・インスペクタを使用すると、最初、最後、標準偏差および分散のサマリーも作成できます。

消費税などのカスタマイズされた計算がレポートで必要な場合は、式列を作成します（第3.8.10項「式列の作成または編集」を参照）。

注意
グループ・レポートでは、レポート・ウィザードおよびデータ・ウィザードによって、定義するサマリー列のそれぞれに対して、n個のサマリー・フィールドがデータ・モデルに作成されます。つまり、サマリーを作成する列上の各グループに対してそれぞれ1つのサマリー・フィールドが作成され、レポートレベルで1つのサマリー・フィールドが作成されます。たとえば、部単位にグループ化され、さらに課単位にグループ化されているレポートの場合、給与合計用のサマリー列を定義すると、各部および各課の給与合計（グループレベルのサマリー）用フィールドと、すべての給与の合計（レポートレベルのサマリー）用フィールドが作成されます。

2.3.2 式列について

式列は、プレースホルダ列などの列にあるデータに対してユーザー定義の計算を実行するときに使用します。たとえば、:ITEMTOT *.07は1つの列に対して計算を実行する式で、:SAL + :COMMはレコード内の2つの列を使用して計算を実行する式です。式は、PL/SQLエディタを使用してPL/SQLで作成できます。

注意
パラメータの値を設定するために、式列を使用しないでください。

2.3.3 プレースホルダ列について

プレースホルダは、任意のPL/SQLでデータ型と値を設定する列です。プレースホルダ列は、列の値を選択的に設定するとき（たとえば、毎回n番目の値をフェッチする場合、または毎回特定の値を含むレコードをフェッチする場合など）に便利です。プレースホルダ列の値は、次の場所に設定できます。

Before Reportトリガー（プレースホルダがレポートレベルの列の場合）
レポートレベルの式列（プレースホルダがレポートレベルの列の場合）
プレースホルダのグループまたはその下のグループ内の式（値はグループの各レコードに一度ずつ設定します）

2.3.4 列参照とパラメータ参照について

ユーザー・パラメータ、システム・パラメータおよび列は、バインド参照または字句参照で参照できます。

2.3.4.1 バインド参照について

バインド参照（またはバインド変数）は、文字列、数字、日付などの、SQLまたはPL/SQL内の1つの値を置換するときに使用します。特に、問合せのSELECT、WHERE、GROUP BY、ORDER BY、HAVING、CONNECT BY、START WITHの各句で式を置換するときに、バインド参照を使用すると効果的です。バインド参照はFROM句では参照できず、予約語または予約句のかわりに使用することもできません。

バインド参照は、コロン（:）の後に対象の列名またはパラメータ名を入力して作成します。SELECT文でバインド参照を作成する前に、対象になる列またはパラメータを作成しないと、Reports Builderによってデフォルトでパラメータが作成されます。

制限

バインド参照に、予約済のSQLキーワードと同じ名前を使用することはできません。詳細は、『Oracle Database SQLリファレンス』を参照してください。

例

例1: SELECT句

次の例では、選択された行にあるCOMMPLANのNULL値がDFLTCOMMの値によって置換されます。

SELECT CUSTID, NVL(COMMPLAN, :DFLTCOMM) COMMPLAN
  FROM ORD;

例2: WHERE句

CUSTの値を使用して、特定の1人の顧客を選択します。

SELECT ORDID, TOTAL
  FROM ORD
  WHERE CUSTID = :CUST;

例3: GROUP BY句

SELECT句にあるNVL(COMMPLAN, :DFLTCOMM)のような非集計式はすべて、GROUP BY句でレプリケートする必要があります。

SELECT NVL(COMMPLAN, :DFLTCOMM) COMMPLAN, SUM(TOTAL) TOTAL
  FROM ORD
  GROUP BY NVL(COMMPLAN, :DFLTCOMM);

例4: HAVING句

MINTOTALの値を使用して、最小発注量の顧客を選択します。

SELECT CUSTID, SUM(TOTAL) TOTAL
  FROM ORD
  GROUP BY CUSTID HAVING SUM(TOTAL) > :MINTOTAL;

例5: ORDER BY句

SORTの値を使用して、ソート基準にSHIPDATEまたはORDERDATEを選択します。これはORDER BY 1とは異なることに注意してください。ここでは、:SORTは値として使用されており、SELECTリストでの式の位置を識別しているわけではありません。この例ではDECODEが必要になることにも注意してください。DECODEを伴わない場合は、ORDER BY句でバインド変数を使用できません。

SELECT ORDID, SHIPDATE, ORDERDATE, TOTAL
  FROM ORD
  ORDER BY DECODE(:SORT, 1, SHIPDATE, 2, ORDERDATE);

例6: CONNECT BY句およびSTART WITH句

CONNECT BY句およびSTART WITH句での参照の使用方法は、WHERE句およびHAVING句と同じです。

例7: PL/SQL

procedure double is begin; :my_param := :my_param*2; end;

my_paramの値は、2で乗算されmyparamに代入されます。

2.3.4.2 字句参照について

字句参照は、SELECT文に埋め込む列またはパラメータのプレースホルダです。字句参照を使用すると、SELECT、FROM、WHERE、GROUP BY、ORDER BY、HAVING、CONNECT BYおよびSTART WITHの後の句を置換できます。字句参照は、実行時にパラメータで複数の値を代入するときに使用してください。

PL/SQL文では、字句参照を作成できません。ただし、PL/SQLでバインド参照を使用すると、次の例に示すように、SQLで字句的に参照されるパラメータ値を設定できます。

字句参照は、アンパサンド（&）の後に対象の列名またはパラメータ名を入力して作成します。デフォルトの定義では、字句参照を使用できません。そのため、次のことを実行する必要があります。

問合せを作成する前に、問合せ内の各字句参照に対する列またはパラメータをデータ・モデルで定義します。列の場合は「NULL時の値」プロパティを、パラメータの場合は「初期値」プロパティを設定する必要があります。Reports Builderでは、これらの値を使用して、字句参照を含む問合せが有効になります。
字句参照を含む問合せを作成します。

制限

PL/SQL文では、字句参照を作成できません。
問合せで列またはパラメータを字句参照として使用する場合は、そのデータ型がCHARACTERである必要があります。
SELECT句で字句参照を使用する場合は、代入する列ごとに別々の字句参照を作成する必要があります。また、各字句参照に対して別名を割り当てることをお薦めします。これにより、ランタイム・パラメータ・フォームで字句参照に対して異なる値を入力しても、同じレイアウト・フィールドとボイラープレート・ラベルを使用できるようになります。
SELECT句で字句参照を使用する場合は、レポートのデータ・モデルに指定されている数と同じ数の項目を実行時に指定する必要があります。実行時に字句参照に対して指定する各値は、「初期値」と同じデータ型にする必要があります。
SELECT句で字句参照を使用する場合は、列幅がパラメータの「初期値」プロパティから取得されます。そのため、使用する最大幅の列にパラメータの「初期値」が対応していることを確認する必要があります。
Reports Builderのリンクは、字句参照に依存しないようにします。つまり、リンクの子列もその表名も、字句参照によって決めることはできません。この機能を可能にするには、列の指定されていないリンクを作成して、問合せにリンク用のSQL句（WHEREなど）を直接入力する必要があります。たとえば、親問合せと子問合せが次のように記述されているとします。

親問合せ:
```
SELECT DEPTNO FROM EMP
```
子問合せ:
```
SELECT &PARM_1 COL_1, &PARM2 COL_2
  FROM EMP
  WHERE &PARM_1 = :DEPTNO
```
WHERE句でのDEPTNOに対するバインド参照の作成方法に注意してください。このDEPTNOは親問合せで選択されています。また、この例では、データ・モデル・ビューで列を指定せずに、問合せ間にリンクが作成されていることを前提にしています。
字句参照を使用して、After Formトリガーの起動後に追加されるバインド変数を作成することはできません。たとえば、次のような問合せがあるとします（WHERE句が字句参照によって置換されることに注意してください）。
```
SELECT ENAME, SAL FROM EMP
&where_clause
```
where_clauseパラメータの値にバインド変数への参照が含まれる場合は、After Formトリガーでその値を指定するか、事前に指定する必要があります。Before Reportトリガーでパラメータに次の値を設定すると、エラーが発生します。
```
WHERE SAL = :new_bind
```
After Formトリガーで同じ値を設定すると、レポートが実行されます。

例

例1: SELECT句

SELECT &P_ENAME NAME, &P_EMPNO ENO, &P_JOB ROLE
  FROM EMP;

P_ENAME、P_EMPNOおよびP_JOBを使用して、実行時に選択する列を変更できます。たとえば、P_EMPNOの値としてDEPTNOをランタイム・パラメータ・フォームで入力します。この場合、列に別名を使用してください。別名を使用しないと、実行時に選択する列を変更する場合に、SELECTリストの列名がReports Builderの列と一致しなくなり、レポートが実行されなくなります。

例2: FROM句

SELECT ORDID, TOTAL
  FROM &ATABLE;

ATABLEを使用して、実行時に選択する列を基に表を変更できます。たとえば、実行時にATABLEにORDを入力します。この方法で表名を動的に変更するとき、列名が表によって異なる場合は、SELECT句にも字句参照を使用すると効果的です（前述の例を見てください）。

例3: WHERE句

SELECT ORDID, TOTAL
  FROM ORD
  WHERE &CUST;

CUSTを使用して、ORDから取得するデータを制限できます。実行時に、WHERE句を任意の形式で指定できます。

例4: GROUP BY句

SELECT NVL(COMMPLAN, DFLTCOMM) CPLAN, SUM(TOTAL) TOTAL
  FROM ORD
  GROUP BY &NEWCOMM;

NEWCOMMの値を使用して、GROUP BY句を定義できます。

例5: HAVING句

SELECT CUSTID, SUM(TOTAL) TOTAL
  FROM ORD
  GROUP BY CUSTID HAVING &MINTOTAL;

MINTOTALの値を使用して、最小発注量の顧客などを選択できます。

例6: ORDER BY句

SELECT ORDID, SHIPDATE, ORDERDATE, TOTAL
  FROM ORD
  ORDER BY &SORT;

SORTの値を使用して、ソート基準にSHIPDATE、ORDERDATE、ORDIDまたはこれらの任意の組合せを選択できます。また、問合せにCONNECT BY句やSTART WITH句などを追加するときにも使用できます。

例7: CONNECT BY句およびSTART WITH句

CONNECT BY句およびSTART WITH句でのパラメータの使用方法は、WHERE句およびHAVING句と同じです。

例8: 複数句

SELECT &COLSTABLE;

COLSTABLEを使用して、実行時にSELECT句とFROM句の両方を変更できます。たとえば、実行時にCOLSTABLEにDNAME ENAME, LOC SAL FROM DEPTを入力できます。

SELECT * FROM EMP &WHEREORD;

WHEREORDを使用して、実行時にWHERE句とORDER BY句の両方を変更できます。たとえば、実行時に&WHEREORDにWHERE SAL > 1000 ORDER BY DEPTNOを入力できます。

例9: PL/SQLとSQL

SELECT &BREAK_COL C1, MAX(SAL)
  FROM EMP
  GROUP BY &BREAK_COL;

BREAK_COLを使用して、実行時にSELECTリストとGROUP BY句の両方を変更します。パラメータ&BREAK_COLの「初期値」はJOBです。実行時に、レポートのユーザーはGROUP_BY_COLUMN（データ型はCHARACTER）というパラメータに値を指定できます。

GROUP_BY_COLUMNの妥当性チェック・トリガーで、次のPL/SQLプロシージャをコールして、GROUP_BY_COLUMNの値を渡します。

procedure conv_param (in_var IN char) is
begin
  if upper(in_var) in ('DEPTNO','EMPNO','HIREDATE') then
    :break_col := 'to_char('||in_var||')' ;
  else
    :break_col := in_var;
  end if;
end;

このPL/SQLでは、必要に応じて、1つのTO_CHARがユーザーが選択したブレーク列の箇所に挿入されています。SQLでBREAK_COLへの字句参照を作成する方法に注意してください。PL/SQLでは、字句参照は許可されていないため、BREAK_COLへのバインド参照を作成する必要があります。

2.3.4.3 バインド参照と字句参照の相違点

バインド参照は、SQLまたはPL/SQLで1つの値を置換するときに使用します。特に、問合せのSELECT、WHERE、GROUP BY、ORDER BY、HAVING、CONNECT BY、START WITHの各句で式を置換するときに、バインド参照を使用すると効果的です。バインド参照はFROM句では参照できません。次に例を示します。

SELECT ORDID,TOTAL
  FROM ORD
  WHERE CUSTID = :CUST

字句参照は、実行時にパラメータで複数の値を代入するときに、SELECT文に埋め込むテキストのプレースホルダです。字句参照を使用すると、SELECT、FROM、WHERE、GROUP BY、ORDER BY、HAVING、CONNECT BYおよびSTART WITHの後の句を置換できます。PL/SQLでは、字句参照を作成できません。列または表の字句パラメータを参照する前に、そのパラメータを事前定義して、初期値を指定する必要があります。次に例を示します。

SELECT ORDID, TOTAL
  FROM &ATABLE

2.3.5 リンク不可能な問合せについて

リンク不可能な問合せとは、列間のリンクを介して、その問合せにリンクできない列オブジェクトを含む詳細な問合せのことです（列間にリンクを作成すると、Reports Builderによって問合せにWHERE句が追加されます）。このようなリンクを作成しようとすると、メッセージ・ダイアログ・ボックスが表示され、グループ対グループの問合せ（親グループを使用）を作成するか、または操作を取り消すかのいずれかを選択するように求められます。リンク不可能な問合せには、そのタイトル・バーにリンク不可能な問合せのアイコンが表示されます。

かわりに、2つの問合せの間に、グループ対グループのリンクを作成して（グループ対グループのリンクを作成しても、問合せにWHERE句は追加されません）、親列を参照するバインド変数を使用し、子問合せのSELECT文にWHERE句を追加できます。第3.8.9項「データ・リンクの作成」を参照してください。

たとえば、子問合せのADDRESS.STREET列と親問合せのLOC1列の間に、列対列のリンクを作成するとします。この場合、グループ対グループのリンクを作成して、子問合せのSQL文を次のように変更します。

SELECT * FROM EMP E WHERE E.ADDRESS.STREET = :LOC1

2.3.6 リンクとグループの比較について

Reports Builderでは、データはフォーマット（レイアウト）とは無関係に定義されます。そのため、どのようなときにデータ・リンクを使用するか（グループではなく）を理解しておく必要があります。

2つの問合せと1つのデータ・リンクを使用するマスター/ディテール・レポートのレイアウトと、1つの問合せと2つのグループを使用するグループ・レポートのレイアウトは同じになります。次の例は、同じデータを問い合せているデフォルトのマスター/ディテール・レポートとグループ・レポートです。2つのレポート間の相違点に注意してください。グループ・レポートとは異なり、マスター/ディテール・レポートには部門40が表示されています。これは、マスター/ディテール・レポートのデータ・リンクが外部結合になり、このリンクにより自動的に無関係なデータがフェッチされるためです。外部結合を必要とするグループ・レポートを設計する場合は、(+)を使用してSELECT文に明示的に外部結合を指定します。

図2-3 同じデータを問い合せているデフォルトのマスター/ディテール・レポートとグループ・レポート

画像の説明

次の図に示すマスター/ディテール/ディテール・レポートは、3つのデータ・グループを含むレポートです。マスター・グループごとに、2つの無関係なディテール・グループが表示されています。マスター/ディテール/ディテール・レポートまたはその応用レポートを作成するには、データ・リンクを使用する必要があります。1つの問合せと3つのグループを使用して、コントロール・ブレークを持つこのレポートを作成する場合は、その問合せにより2つのディテール・グループ間にリレーションシップが構築されます。

図2-4 マスター/ディテール/ディテール・レポート

画像の説明

2.3.7 マトリックス・オブジェクトについて

マトリックス・オブジェクトは2つの繰返し枠の間にリレーションシップを定義するだけで、いずれかのオブジェクトに所有されているわけでも、マトリックス・オブジェクト自体がいずれかのオブジェクトを所有しているわけでもありません。マトリックス・オブジェクトは、「マトリックス」レイアウト・スタイルのレイアウトにのみ作成できます。データ・モデルに必要なグループが揃っていれば、レポートに複数のマトリックスを含めることができます。Reports Builderでは、垂直に交差する繰返し枠の各組合せに対して、1つのマトリックス・オブジェクトが作成されます。

繰返し枠はマトリックスのディメンションであり、マトリックス・オブジェクトにはセル・グループのフィラーまたは値を保持するフィールドが含まれます。マトリックスを形成するには、繰返し枠の1つの「印刷方向」プロパティが「縦」に設定され、他の繰返し枠の「印刷方向」プロパティが「横」に設定されている必要があります。

注意
マトリックス・オブジェクトが含まれているJSPベースのWebレポートを実行する場合、JSP <rw:include>タグは、そのマトリックス・オブジェクトが1ページのみにフォーマットされることを前提とします。ただし、交差した繰返し枠にあるセルが拡張されている場合、マトリックスの列のヘッダーは、ページのサイズに関係なく、次のページに移動する場合があります。したがって、これらのマトリックス・ヘッダーは、レポート出力に表示されません。さらにこの状況では、ヘッダー・フィールドは後続のページに移動しますが、セルの値は最初のページに残るので、ペーパー・レイアウトは正しく表示されません。これに対処するには、交差した繰返し枠で利用可能なスペースで最大値を表示できるようにし、交差した繰返し枠の「垂直拡張度」プロパティを「固定」に設定するよう、レポート・エディタで注意深く定義することが重要になります。

制限

マトリックスでは、縦繰返し枠は横繰返し枠より下にある必要があります。
マトリックス・オブジェクトは、常にそれを構成する繰返し枠の上にある必要があります（つまり、マトリックス・オブジェクトは、その水平繰返し枠と垂直繰返し枠より上の1つ以上のレイヤーである必要があります）。Reports Builderでは、マトリックスを水平繰返し枠と垂直繰返し枠より下に移動することはできません。
マトリックスを移動すると、その2つの繰返し枠も移動されます。
マトリックス・オブジェクトを他のオブジェクトにアンカーすることも、他のオブジェクトをマトリックス・オブジェクトにアンカーすることもできません（つまり、マトリックス・オブジェクトは、アンカーの親オブジェクトまたは子オブジェクトにはできません）。
マトリックスをコピーするには、マトリックスとその2つの繰返し枠を選択する必要があります。マトリックス・オブジェクト自体を選択しても、貼付け用のバッファには何もコピーされません。マトリックスとその繰返し枠の1つを選択した場合は、その繰返し枠のみが貼付け用のバッファに置かれます。
マトリックス・オブジェクトのサイズは、その関連する繰返し枠のサイズを変更することでのみ変更されます。
マトリックス・オブジェクトの「レイアウト」メニューからは、「整列」または「オブジェクト・サイズ設定」を使用できません。
マトリックスのディメンションを構成する繰返し枠のソース・グループは、同じクロス積グループにある必要があります。
ソース・グループが同じファミリ階層にある繰返し枠（つまり、お互いが子や親の場合）には、同じ「印刷方向」を設定する必要があります。クロス積グループ内の親子リレーションシップは、マトリックスにネストを作成するときに使用します。したがって、こうしたグループに関連する繰返し枠は、ページ上で同じ方向に印刷される必要があります。
マトリックス・オブジェクトでは、他のオブジェクトと同じように境界線を挿入できますが、その幅は常に可能な最小幅になります。マトリックス・レイアウト内のオブジェクトは密接に配置されるため、境界線を広くすることはできません。

例

Group1という名前のグループにC_DEPTNOという列があるとします。C_DEPTNO列は、その値をデータベース列DEPTNOから取得します。Group2という名前のグループには列C_JOBと列C_DEPTNO1があります。列C_JOBの値はデータベース列JOBから取得し、列C_DEPTNO1はGroup1の問合せへのリンクに使用します。Group3というグループにはSUMSALという列があり、データベース列SALのサマリーになっています。

                    Job
          Analyst  Clerk  Manager

      10           $1300   $2450
Dept  20    $6000  $1900   $2975
      30           $ 950   $2850

この例では、次のようになります。

垂直繰返し枠は、Group2（ジョブ・タイトル）を含む繰返し枠になります。
水平繰返し枠は、Group1（部門番号）を含む繰返し枠になります。
クロス積グループはGroup4（Group1とGroup2の親となるグループ）になります。

さらに複雑なマトリックスを構成する必要がある場合は、Group1とGroup2に列を追加します。たとえば、Group1に、部門番号を表す列以外に、部門の場所（LOC）を表す列を追加します。マトリックスは次のようになります。

                              Job
 Loc        Dept    Analyst  Clerk  Manager

 New York    10              $1300   $2450
 Dallas      20      $6000   $1900   $2975
 Chicago     30              $ 950   $2850

2.4 レイアウト・オブジェクト

この項のトピックは、第1.8項「レイアウト・オブジェクト」で説明した基本的な概念に基づいています。

2.4.1 レイアウト・オブジェクトについて

レイアウト・オブジェクトの概念と適用されるプロパティには、重要なものがいくつかあります。

レポートにオブジェクトを表示する頻度は、「オブジェクトの印刷」プロパティで指定します。
繰返し枠のインスタンスに対してReports Builderでデータをフェッチおよびフォーマットする方法は、「列モード」プロパティで指定します。
オブジェクトとそれがアンカーされているオブジェクトを同じ論理ページに保持するかどうかは、「アンカー・オブジェクトと連動」プロパティで指定します。
オブジェクト全体とそのコンテンツを同じ論理ページに保持するかどうかは、「ページ保護」プロパティで指定します。
フォーマット・トリガーはオブジェクトがフォーマットされる前に実行されるPL/SQLファンクションで、オブジェクトのフォーマット属性を動的に変更できます。
レポート・レイアウトはReports Builderに適用されているデフォルトにより作成されます。レポート・レイアウトはペーパー・レイアウト・ビューで変更することも、最初から作成することもできます。

2.4.2 レイアウトのデフォルトについて

レポート・ウィザードでデフォルトのレイアウト・スタイルの1つを選択すると、レポートのデータ・モデルに基づいて、Reports Builderによって必要なレイアウト・オブジェクトが作成されます。たとえば、メール・ラベル・レポートを作成する場合、適切なデータ・モデルが定義されていれば、単にメール・ラベルのデフォルト・スタイルを選択します。Reports Builderによって、レポートのレイアウト・オブジェクトが自動的に作成され、レイアウト・モデル・ビューに表示されます。作成したデフォルトのレイアウトは、必要に応じてカスタマイズできます。Reports Builderによって生成された各レイアウト・オブジェクトは、切取り、コピー、貼付け、サイズ変更および編集を行うことができます。

レイアウトのデフォルトには、次のルールが適用されます。

レイアウト・オブジェクトをまだ含んでいないレイアウトとして作成する領域を定義しないかぎり、レポートのすでに定義済のレイアウト・オブジェクトはフォーマット・トリガーも含めてすべて上書きされます。
1つのレポートに、任意の数のフォーマットを指定できます。たとえば、最初のページの上部に表形式フォーマットを持ち、同じページの下部にマトリックス・フォーマットを持つレポートを作成できます。これには、追加のレポート・レイアウトを作成します（第3.5.5項「追加のレポート・レイアウトの作成」を参照）。
レポート・レイアウトを作成した後は、データ・モデルを変更しても、それらはレイアウトに自動的に反映されません。たとえば、レポート・レイアウトを作成した後に、問合せを作成してレポートを実行しても、新しい問合せからのデータはレポート出力に表示されません。変更を取り込むには、レイアウトのデフォルトを再設定するか、レイアウトを変更する必要があります。

Reports Builderでは、次のルールに従って、レポート・レイアウトがデフォルト設定されます。

明記されていないかぎり、「印刷方向」が「横」のグループのデフォルトは、「印刷方向」が「縦」のグループのデフォルトと同じになります。ただし、そのデフォルト・フォーマットが変更されている場合は別です。「横」のグループのデフォルトを迅速に設定するには、次の操作を行います。
- 半透明のペーパーにグループ用の縦レイアウトを描画します。
- 本のページのようにそのページをめくります。
- ページを逆時計回りで90度回転させます。

フォーム・レター・レポートでは、すべてのデフォルト・フィールドが非表示で、その「水平拡張度」プロパティは「可変」に、「垂直拡張度」プロパティは「固定」に設定されています。他のすべてのレポートでは、すべてのデフォルト・フィールドの「水平拡張度」プロパティと「垂直拡張度」プロパティが「固定」に設定されています。

例外:表形式レポート、フォーム形式レポート、グループ左レポート、グループ上レポートおよびマトリックス・レポートでは、CHARフィールド（デフォルト幅を狭くした場合）およびLONGフィールドはデフォルトで、「水平拡張度」プロパティが「固定」に「垂直拡張度」プロパティが「可変」に設定されています。その結果、データの語が次の行に折り返され、すべてのフィールド値が切り捨てられることなく表示されます。

注意
フォーム・レター・レポートおよびメール・ラベル・レポートでは、CHARフィールド（デフォルト幅を狭くした場合）およびLONGフィールドはデフォルトで、「水平拡張度」および「垂直拡張度」プロパティが「固定」に設定されています。その結果、データのサイズがフィールドのサイズを超える場合、フィールド値は切り捨てられます。

グループではなくレポートによって所有されるサマリーは、すべてのレポート・レイアウト・スタイルで許可されます。サマリーは、すべて次のようにフォーマットされます。
- レイアウト・スタイルがフォーム形式、フォーム・レターまたはメール・ラベルの場合、サマリーはレポート列です。レポート列は、そのレポート・スタイルの他のデータベース列と同じようにフォーマットされます。
- レイアウト・スタイルが表形式、グループ左、グループ上またはマトリックスで、サマリーによって関数を実行する対象の列が選択されていない場合、サマリーはレポート列です（前述の説明と同じようにフォーマットされます）。それ以外の場合、サマリーはレポート・サマリーです。レポート・サマリーはレポートの最後に左揃えでフォーマットされ、フィールドの左にラベルが表示されます（余白がある場合）。
レイアウト・スタイルが表形式、グループ左、グループ上またはマトリックスで、サマリーを計算する対象の列が選択されていない場合、サマリーはデータベース列のようにデフォルト設定されます。それ以外の場合、サマリーは通常のサマリーのようにデフォルト設定されます（つまり、M_groupname_FTR枠内に表示されます）。
レイアウト・スタイルが表形式、グループ左、グループ上またはマトリックスの場合、Reports Builderによって、各行に1つのサマリー・タイプが次の順序で挿入されます。
- 合計
- 平均
- 最小値
- 最大値
- カウント
- 最初
- 最後
- 割合(%)
- 標準偏差
- 分散
レイアウト・スタイルが表形式、グループ左、グループ上またはマトリックスの場合、サマリー・ラベルはグループ・フッター枠（M_groupname_FTR）の一番左に表示されます。ラベル全体を表示する場所がない場合、ラベルは切り捨てられます。

2.4.3 イメージについて

次の方法で、イメージをレポートに追加できます。

ファイルからレポート・レイアウトにイメージをインポートします（ペーパーベースのレポートのみ）。第3.9.8.1.1項「イメージのインポート」を参照してください。
「ペーパー・レイアウト」でファイル・リンク・オブジェクトを作成します（ペーパーベースのレポートのみ）。次を参照してください。
- 第3.9.8.1.2項「イメージ・オブジェクトのファイルへのリンク」
- 第3.9.8.1.3項「イメージ・オブジェクトのURLへのリンク」（HTMLおよびHTMLCSS出力の場合）
問合せでデータベース列を選択します（ペーパーベースおよびJSPベースのWebレポート）。次を参照してください。
- 第3.8.5項「データベースからのイメージの選択」
- 第3.8.6項「データベースからのイメージURLの選択」（HTML出力の場合）

1つ目の方法（イメージ・インポート」ダイアログ・ボックスを使用）では、TIFF、JFIF、BMP、TGA、PCX、PICT、GIF、CALS、RAS、OIF、PCDのフォーマットのイメージを含めることができます。

その他の2つの方法（ファイル・リンク・オブジェクトを作成し、データベースで列を選択）では、Oracle Reportsでサポートされているその他のフォーマット（JPEG（Progressive JPEGやExif JPEGなどのすべてのタイプ）、PNG、BMP、TIFF、GIFおよびCGM）を含めることができます。

プレビューアのみでなく印刷レポートにもイメージが表示されるように、デフォルトでイメージはフィールドに表示されます。

REPORTS_OUTPUTIMAGEFORMAT環境変数およびOUTPUTIMAGEFORMATコマンドライン・キーワードにより、イメージングのサポートが強化されています。イメージングのサポートが強化されたことにより、複雑なグラフィックを多用するレポートを、より忠実にイメージを出力しながら生成できるようになりました。UNIXの場合はさらに、イメージを表示する際のウィンドウ・システムへの依存性が排除されています。PostScriptプリンタ・ドライバscreenprinter.ppdにより、イメージの画面解像度が決定されます。

非キャッシュ参照を使用することで、ローカルのディスク領域を使い切ることなく、イメージ・オブジェクトを無制限に含めることができます。非キャッシュ参照では、オブジェクトがレポート処理に必要なときのみデータベースから読み込まれます。

HTML出力用にレポートをフォーマットしていれば、イメージのURLを参照したときにイメージが表示されます。他の出力フォーマットでは、URLテキストがペーパー・デザイン・ビューに表示され、出力先（ファイルやPDFドキュメントなど）には何も表示されません。ユーザーは、URLが実際に有効かどうかを確認する必要があります。Reports Builderでは、リソースの有無やプロトコル構文の妥当性はチェックされません。URLを含むオブジェクトのサイズは、HTML出力でのイメージのサイズを定義します。オブジェクトに適用される拡張度のプロパティは、すべて無視されます。

制限

入力イメージの色数が256色を超える場合、出力イメージのフォーマットがOUTPUTIMAGEFORMATコマンドライン・キーワードまたはREPORTS_OUTPUTIMAGEFORMAT環境変数によってGIFに設定されていると、Oracle ReportsではGIFを正しく生成するために、色数が256色に減らされます。
UNIXでは、HTML出力ではCGMフォーマットはサポートされていません。この制限はWindowsプラットフォームには適用されません。

2.4.4 アンカーについて

アンカーは、オブジェクトの境界線の間を結び付けることで、オブジェクト間の相対的な位置を確定します。たとえば、可変サイズの繰返し枠の境界線にボイラープレート・テキストをアンカーすると、繰返し枠のサイズを変更しても、ボイラープレートと繰返し枠間の距離と位置関係は保持されます。

アンカーは、親オブジェクトに対する子オブジェクトの上下左右の相対的な位置関係を決定します。子オブジェクトは、親オブジェクトの内外どちらにも配置できます。

一部のレイアウト・オブジェクトのサイズは、レポートが実行されデータがフェッチされるときに変更されるため、アンカーを使用してオブジェクト間の相対的な位置関係を定義する必要があります。アンカーは、アンカー先のオブジェクトに対する子オブジェクトの相対的な位置を定義します。オブジェクトの位置は、データがフェッチされた後の両オブジェクトのサイズに基づいて決定され、エディタでのサイズには依存しません。また、ペーパー・レイアウト・ビューでのオブジェクトの位置がレポート出力での最終的な位置に反映されることに注意してください。レイアウト内の物理的なオフセットは、すべて「アンカー」プロパティのパーセントによる指定位置に組み込まれます。

アンカーには2種類あります。

暗黙的なアンカー。Reports Builderによって、実行時に、明示的なアンカーを持たない各レイアウト・オブジェクトに対して暗黙的なアンカーが作成されます。つまり、各レイアウト・オブジェクトに対して、そのレイアウト・オブジェクトを上書きすることになるオブジェクトがあるかどうかが判別され、そうしたオブジェクトがある場合は、そのレイアウト・オブジェクトからそれを上書きする最も近いオブジェクトに対してアンカーが作成されます。これによって、そのレイアウト・オブジェクトは上書きされなくなります。暗黙的なアンカーの機能によって、ユーザーはすべてのオブジェクトの位置を定義する必要がありません。暗黙的なアンカーは、ペーパー・レイアウト・ビューには表示されません。ただし、「オブジェクト・ナビゲータ・オプション」ダイアログ・ボックスで、オブジェクト・ナビゲータにアンカー情報が表示されるように指定できます。デフォルトで、オブジェクトは、そのインクローズ・オブジェクトの左上隅にアンカーされます。オブジェクト・ナビゲータのこのビューでオブジェクトのアンカー情報が表示されない場合でも、オブジェクトはそのインクローズ・オブジェクトにアンカーされていると想定できます。インクローズ・オブジェクトは、枠または本体と考えられます。
明示的なアンカー。明示的なアンカーは、レイアウト・エディタで「アンカー」ツールを使用して、子側の境界線から親側の境界線にドラッグすることで作成できます。オブジェクトに作成したアンカーは、暗黙的なアンカーより優先されます。明示的なアンカーは、「レイアウト・オプション」ダイアログ・ボックスで非表示を指定しないかぎり、常にペーパー・レイアウト・ビューに表示されます。

アンカーによる相対的な位置指定

子オブジェクトを親オブジェクトにアンカーするときは、アンカーの連結点になるX座標とY座標が重要です。

親オブジェクトが子オブジェクトの上または下にある場合:

2つのオブジェクト間の垂直距離は固定されます。たとえば、次の図では、親オブジェクトとObject 1との間の垂直間隔は固定されています。
子オブジェクト側のアンカーのX座標の水平位置は、親オブジェクト側のアンカーのX座標と関係があります。たとえば、次の図では、アンカーは親の左右境界線からは50%、Object 1の左境界線からは75%の位置にあります。そのため、このレポートを実行すると、Reports BuilderによってObject 1は親の中央から左側に25%シフトされます。

図2-5 子オブジェクトの上に位置する親オブジェクト

 画像の説明

親オブジェクトが子オブジェクトの右または左にある場合:

2つのオブジェクト間の垂直位置は相対的です。たとえば、次の図では、アンカーの両端の終点が2つのオブジェクトの上境界線から80%ほど下の位置にあります。したがって、レポートを実行すると、Reports Builderによって2つのオブジェクトの長さが計算され（拡張されている場合があるため）、両オブジェクトに対して80%下のY座標が計算されます。次に、ペーパー・レイアウト・ビューで配置されている距離でこれら2つのポイントが位置するように、2つのオブジェクトが配置されます。
2つのオブジェクト間の水平位置は固定されます。たとえば、次の図では、親オブジェクトとObject 1との間の水平間隔は固定されています。

図2-6 子オブジェクトの右に位置する親オブジェクト

 画像の説明

繰返し枠または枠の外にオブジェクトを配置する必要がありながら、繰返し枠または枠をオブジェクトの所有者にする場合は（つまり、その所有者のフォーマット時にフォーマットするために）、繰返し枠または枠の中でオブジェクトに連結するアンカーを作成します。

アンカーの縮小

作成したアンカーを縮小できます。アンカーの縮小によって、レポート内での不要な余白を回避できます。こうした余白は、親と子が同じページに出力されなかったり、設定されている「印刷条件」が原因で、親オブジェクトが子オブジェクトと同じページに入らない場合に生じる可能性があります。アンカーを縮小すると、出力時に、親オブジェクトのある場所に子オブジェクトを移動できます。子オブジェクトの相対位置は、アンカーで定義したとおりに保持されます。

2.4.4.1 暗黙的なアンカーのアルゴリズム

Reports Builderでは、実行時に暗黙的なアンカーが本体領域に作成されます。本体とマージンでは、そのアルゴリズムが少し異なります。

本体でのアルゴリズム

繰返し枠または枠に完全に囲まれていない（直接または間接的に）オブジェクト、あるいは繰返し枠または枠に囲まれている（直接または間接的に）オブジェクトに明示的にアンカーされているオブジェクトを判別します。以降、これらのオブジェクトをタイプAオブジェクトと呼びます（タイプAオブジェクトは一般的に、グループ枠、繰返し枠、作成したオブジェクトで枠または繰返し枠に所有されていない他のオブジェクトなどです）。オブジェクトは、次のすべてが該当する場合にかぎり、別のオブジェクトに囲まれていると判別されます。
- 両方のオブジェクトが同じ領域（本体またはマージン）に属する。
- 2つのオブジェクトの外側の方が枠または繰返し枠である。
- 2つのオブジェクトの外側の方が内側のオブジェクトの背後にある。
- 2つのオブジェクトの内側の方が外側のオブジェクトの境界線の中に完全に収まっている。
枠または繰返し枠のすべての子オブジェクトを判別します（これらは非タイプAオブジェクトです）。以降、これらのオブジェクトをタイプBオブジェクトと呼びます。
タイプAオブジェクトとタイプBオブジェクトで別々に次の手順を実行します。
- 同じタイプ（たとえば、タイプA）に属し、同じレイヤー上にあるすべてのオブジェクトを見つけます。
- それらのオブジェクトの中で、同じタイプのオブジェクトを「プッシュ」する可能性のあるものを判別します。オブジェクトは、その「水平拡張度」または「垂直拡張度」が「可変」または「拡張」に設定されており、2番目のオブジェクトがそのプッシュ・パス（最初のオブジェクトが拡張する可能性のある領域）にある場合に、同じタイプのオブジェクトをプッシュする可能性があります。また、「水平拡張度」または「垂直拡張度」が「固定」または「縮小」に設定されている繰返し枠にも、その「印刷方向」というプッシュ・パスがあります。
- オブジェクトの組合せを作成します。各組合せは、プッシュする側（拡張するオブジェクト）とプッシュされる側（プッシュされるオブジェクト）で構成する必要があります。これらの組合せを作成するとき、プッシュされる側のオブジェクトを明示的なアンカーの子オブジェクトにはできません。このようなオブジェクトは無視されます。
- 次に説明するループを実行します。組合せごとに、プッシュする側とプッシュされる側の間のプッシュ・パスの距離を測定します。次に、最も距離の短い組合せを見つけます。最後に、次のアルゴリズムを使用して、2つのオブジェクト間に暗黙的なアンカーを作成します。
  
  プッシュ・パスの方向が「縦」の場合は、プッシュされる側のオブジェクトの上0%をプッシュする側のオブジェクトの下0%にアンカーします。
  
  プッシュ・パスの方向が「横」の場合は、プッシュされる側のオブジェクトの左0%をプッシュする側のオブジェクトの右0%にアンカーします。
- この時点で、この組合せは1つのオブジェクトとして扱われます。このループを、すべてのオブジェクトが1つのアンカーを持つか、アンカーされていない残りのオブジェクトをプッシュするものがなくなるまで繰り返します。
- アンカーされていない残りの各オブジェクトには、オブジェクトの左上隅から本体領域の左上隅に暗黙的なアンカーを作成します。
- 次のレイヤーに移り、手順1から再度実行します。

ルール:

オブジェクトが他の2つのオブジェクトのプッシュ・パスにあり、その2つのオブジェクトから等距離の場合は、そのオブジェクトの暗黙的なアンカーはレポートを実行するたびに異なる可能性があります。たとえば、次の図は、こうした事象が生じる2つのケースを示しています。

図2-7 他の2つのオブジェクトのプッシュ・パスにあるオブジェクト

 画像の説明

ケース1では、M_SumsがB_Text1とR_Enameの両方のプッシュ・パスにあります。M_SumsはB_Text1とR_Enameから等距離にあるため、このケースでは、暗黙的なアンカーを決定する通常の基準（最も短い距離）を適用できません。その結果、このアルゴリズムでは、実行時に、暗黙的なアンカーがM_SumsとB_Text1の間またはM_SumsとR_Enameとの間にランダムに作成されます。この動作を回避するには、M_SumsとB_Text1またはR_Enameの間に、明示的なアンカーを作成します。

ケース2では、B_Text3がM_Empのプッシュ・パスにあります。M_EmpとR_Mgrの下境界線は実質的に同じ位置にあるため、B_Text3はM_EmpまたはR_Mgrのどちらかに暗黙的にアンカーされる可能性があります。その結果、このアルゴリズムでは、実行時に、暗黙的なアンカーがB_Text3とM_Empの間またはB_Text3とR_Mgrとの間にランダムに作成されます。この動作を回避するには、B_Text3からどちらかのオブジェクトに明示的なアンカーを作成するか、R_EnameとB_Text2の間の明示的なアンカーを削除します。明示的なアンカーを削除するとR_MgrはM_Empの子孫として扱われ、その結果、暗黙的なアンカーはB_Text3とM_Empの間にのみ作成されるようになります。

（ケース2が生じる可能性が最も高いのはキャラクタ・モードです。キャラクタ・モードでは、オブジェクトの境界線がペーパー・レイアウト・ビューでオーバーラップすることがよくあります。）

マージンでのアルゴリズム

Reports Builderでは、マージン領域のすべてのタイプBオブジェクトに対して、本体と同じアルゴリズムを使用して暗黙的なアンカーが作成されます。ただし、タイプAオブジェクトには、オブジェクトの左上隅からマージンの左上隅に暗黙的なアンカーが作成されます。タイプAオブジェクトが他のタイプAオブジェクトに暗黙的にアンカーされることはありません（これにより、タイプAオブジェクトはページから絶対にプッシュされなくなります。ただし、同じレイヤーに他のタイプAオブジェクトがある場合は、それによって上書きされる場合があります）。

2.4.5 カラーとパターンの変更について

選択したカラーとパターンは、オブジェクト全体に適用されます（オブジェクト内の全テキストに1つのカラーを適用することはできますが、テキストのセグメントごとには適用できません）。

レポート内のカラーとパターンは、次の方法で変更できます。

Reports Builderのユーザー・インタフェースで、ペーパー・レイアウト・ビューのツール・パレットにある次のツールを使用します。
- レイアウト・オブジェクトを囲む境界線のカラーのカスタマイズには、「線カラー」ツールを使用します。
  
  注意
  Windowsプラットフォームでは、境界線パターン（「線カラー」ツールのパターン）はサポートされません。
- レイアウト・オブジェクトをカラーとパターンで塗るときは、「塗りつぶしカラー」ツールを使用します。
- デフォルトのテキスト・カラーの変更には、「テキスト・カラー」ツールを使用します。
- 3つのカラー・ツールの真上にある「塗りつぶし/線/テキスト・サンプル」ボックスには、現在選択されている塗りつぶし、境界線およびテキストが表示されます。Reports Builderによって作成されたオブジェクトのデフォルトの塗りつぶしと境界線は透明ですが、ユーザーが作成するオブジェクトのデフォルト値は白の塗りつぶしのまわりに黒の1ポイント線です。
PL/SQLでは、次のSRWパッケージ・プロシージャを使用します。
- SRW.SET_BACKGROUND_BORDER_COLOR
- SRW.SET_BACKGROUND_FILL_COLOR
- SRW.SET_FOREGROUND_BORDER_COLOR
- SRW.SET_FOREGROUND_FILL_COLOR
- SRW.SET_TEXT_COLOR
- SRW.SET_FILL_PATTERN
- SRW.SET_BORDER_PATTERN
テンプレートの場合は、テンプレートのプロパティ・インスペクタで次のプロパティを設定します。
- 「塗りつぶしパターン」プロパティでは、オブジェクトで囲まれる領域に使用するパターンを定義します。「フォアグラウンド・カラー」プロパティと「バックグラウンド・カラー」プロパティを使用して、塗りつぶしパターンのバックグラウンド・カラーとフォアグラウンド・カラーを定義できます。
- 「枠のパターン」プロパティでは、オブジェクトの境界線に使用するパターンを定義します。「枠のフォアグラウンド・カラー」プロパティと「枠のバックグラウンド・カラー」プロパティを使用して、枠のパターンのバックグラウンド・カラーとフォアグラウンド・カラーを定義できます。
  
  注意
  Windowsプラットフォームでは、境界線パターンはサポートされません。
- 「テキスト・カラー」プロパティでは、オブジェクトに使用するテキスト・カラーを指定します。

さらに、カラー・パレットの環境設定を設定して、レポートでの使用方法を指定できます（第3.2.6項「カラー・パレットの環境設定の設定」を参照）。また、カラー・パレットを変更することで、パレットのカラー定義を変更できます（第3.9.6.5項「カラー・パレットの変更」を参照）。

現行のレポートで使用しているカラー・パレットを変更するには、新しいカラー・パレットをインポートします。また、現行のカラー・パレットを他のレポートで使用するためにエクスポートすることもできます（第3.9.6.6項「カラー・パレットのインポートまたはエクスポート」を参照）。

2.4.6 オブジェクトのサイズ変更について

問合せ、グループ、枠、繰返し枠、フィールド、マトリックス・オブジェクトおよびボイラープレート・オブジェクトのサイズを変更できます。アンカーのサイズは変更できません。ただし、アンカーされたオブジェクトの一方を移動した場合、アンカーのサイズは自動的に変更されます。

注意
ボイラープレート・テキストのサイズを変更するときは、すべてのテキストがオブジェクト内に収まるように注意が必要です。並び線よりも下のフォント部分（gやqなどの文字の下側に延びた領域）が収まらない場合、テキスト行はレポート・エディタのビューには表示されますが、レポート実行時の出力には表示されません。ハンドルをクリックしてドラッグすると、角で連結している縦横方向の2つの境界線によりサイズが変更されます。つまり、オブジェクトはX座標とY座標の両方向に拡張または縮小されます。

2.4.7 ペーパー・レイアウト・ビューでのオブジェクトの移動とレイヤーについて

ペーパー・レイアウト・ビューでは、オブジェクトはそれを囲むオブジェクトより上のレイヤーにある必要があります。たとえば、繰返し枠に属するフィールドであれば、ペーパー・レイアウト・ビューでは、繰返し枠より少なくとも1つ上のレイヤー上にする必要があります。そうしないと、フィールドが繰返し枠に囲まれていると判別されなくなり、実行時に頻繁にエラーが発生します。ペーパー・レイアウト・ビューでオブジェクトを移動またはグループ化するときは、そのレイヤーが変更される場合があり、それによってレポートの実行時に頻繁にエラーが発生します。この問題を回避するには、ペーパー・レイアウト・ビューでのオブジェクトの移動時に、制限モードまたはフレックス・モードを使用する必要があります。

2.5 パラメータ・フォーム・オブジェクト

この項のトピックは、第1.9項「パラメータ・フォーム・オブジェクト」で説明した基本的な概念に基づいています。

2.5.1 パラメータ・フォームのHTML拡張について

パラメータ・フォームをHTML拡張すると、Webでのペーパー・レポートの実行時に、ランタイム・パラメータ・フォームをHTMLタグ付きテキストとJavaScriptで拡張できます。ペーパー・パラメータ・フォームをWebでの表示用に拡張する場合、次のことが実行できます。

HTMLタグを使用してボイラープレート・テキストを作成し、パラメータ・フォームにハイパーリンクまたは他の任意のHTMLタグ付きテキストを追加します（第3.9.2.3項「HTMLタグのボイラープレート・テキスト・オブジェクトの作成」を参照）。
JavaScriptを使用してパラメータ・フィールドを挿入し、ユーザーがパラメータ・フィールドに無効なデータを入力したときにエラーを表示するなどの入力イベントまたは選択イベントを定義します（第3.11.12項「HTMLパラメータ・フォームの入力イベントまたは選択イベントの作成」を参照）。
パラメータ・フォーム・ヘッダー（フォーム前値）を作成し、HTMLパラメータ・フォームのヘッダーにロゴまたは標準リンクを挿入します（プロパティ・インスペクタを使用する場合は第3.6.10.1.5項「プロパティ・インスペクタを使用したHTMLパラメータ・フォーム・ヘッダーの作成」を参照、または第3.6.10.2.5項「PL/SQLを使用したHTMLパラメータ・フォーム・ヘッダーの作成」を参照）。
パラメータ・フォーム・フッター（フォーム後値）を作成し、HTMLパラメータ・フォームのフッターにロゴまたは標準リンクを挿入します（プロパティ・インスペクタを使用する場合は第3.6.10.1.6項「プロパティ・インスペクタを使用したHTMLパラメータ・フォーム・フッターの作成」を参照、または第3.6.10.2.6項「PL/SQLを使用したHTMLパラメータ・フォーム・フッターの作成」を参照）。

オブジェクト・ナビゲータから、または「ツール」→「パラメータ・フォーム・ビルダー」を選択して、「パラメータ・フォーム・ビルダー」にアクセスできます。

2.6 PL/SQL

この項の各トピックでは、Reports BuilderにおけるPL/SQLの使用について説明します。

2.6.1 PL/SQLエディタについて

PL/SQLエディタを使用すると、PL/SQLプログラム・ユニットを作成し、編集できます。

使用に関する注意

プログラム・ユニットを変更すると、依存するプログラム・ユニットのコンパイル済のステータスが失われ、オブジェクト・ナビゲータの「プログラム・ユニット」ノードの下にある名前の後にアスタリスク（*）が表示されます。「名前」リストを使用して、PL/SQLエディタで直接これらのプログラム・ユニットにナビゲートし、再コンパイルできます。

制限

PL/SQLパッケージ、ファンクションまたはプロシージャを削除する場合は、レポート内の参照もすべて削除する必要があります。参照を削除しないと、レポートをコンパイル、生成または実行するときにエラーが発生します。
PL/SQLパッケージ、ファンクションおよびプロシージャの名前は、レポート内で一意にする必要があります。列、グループ、問合せまたは印刷可能なオブジェクトの名前と重複しないようにしてください。

2.6.2 ストアドPL/SQLエディタについて

ストアドPL/SQLエディタを使用すると、データベースでストアドPL/SQLプログラム・ユニットを作成し、編集できます（データベースは、オブジェクト・ナビゲータの「データベース・オブジェクト」ノードの下に表示されます）。

2.6.3 構文パレットについて

構文パレットは、PL/SQLの言語要素やビルトイン・パッケージの構成メンバーを、PL/SQLエディタやストアドPL/SQLエディタに表示して、コピーできるようにするプログラミング・ツールです。

2.6.4 プログラム・ユニットについて

プログラム・ユニットは、現行のレポート内でPL/SQLから参照できるパッケージ、ファンクションまたはプロシージャです。

注意
プログラム・ユニットは、他のレポートから参照できません。複数のレポートから参照できるパッケージ、ファンクションまたはプロシージャを作成する場合は、外部PL/SQLライブラリを作成します（第3.13.5.1項「外部PL/SQLライブラリの作成」を参照）。

レポートでのPL/SQLの使用に関する詳細な例は、第39章「PL/SQLを含むレポートの作成」を参照してください。

制限

PL/SQLパッケージ、ファンクションまたはプロシージャを削除する場合は、レポート内の参照もすべて削除する必要があります。参照を削除しないと、レポートをコンパイル、生成または実行するときにエラーが発生します。
PL/SQLパッケージ、ファンクションおよびプロシージャの名前は、レポート内で一意にする必要があります。列、グループ、問合せまたは印刷可能なオブジェクトの名前と重複しないようにしてください。

例: 式におけるPL/SQLファンクションの参照

次のようなグループと列を含むレポートがあるとします。

Groups    Columns         Summary
-----------------------------------------
RGN       REGION
          RGNSUMSAL       SUM(DEPTSUMSAL)
          COSTOFLIVING
  
DEPT      DNAME
          DEPTNO
          DEPTSUMSAL      SUM(EMP.SAL)
  
JOB       JOB
          HEADCOUNT       COUNT(EMP.EMPNO)
  
EMP       ENAME
          EMPNO
          SAL
          COMM

これらのグループや列で、給与に生計費手当（COSTOFLIVING）を適用する複数の式を作成します。作業が重複しないように、次のようなPL/SQLファンクションを作成して式から参照することができます。

function CompSal(salary number) return number is
begin
  return (salary*CostofLiving);
end;

次の2つは、このPL/SQLファンクションを式で参照する例です。

CompSal(:RGNSUMSAL)

or

CompSal(:SAL) + COMM

2.6.5 ストアド・プログラム・ユニットについて

ストアド・プログラム・ユニット（ストアド・サブプログラムやストアド・プロシージャとも呼ばれます）は、個々にコンパイルし、いつでも実行できるようにOracleデータベースに永続的に格納しておくことができます。ストアド・プログラム・ユニットをコンパイルしてデータ・ディクショナリに格納すると、スキーマ・オブジェクトとなり、そのデータベースに接続されたどのアプリケーションからでも参照できます。

ストアド・プログラム・ユニットを使用すると、生産性、パフォーマンス、アプリケーションの整合性およびセキュリティが向上し、メモリーも節約できます。たとえば、ストアド・プロシージャやストアド・ファンクションのライブラリを使用してアプリケーションを設計すると、冗長なコーディングがなくなり、生産性を向上できます。

ストアド・プログラム・ユニットは、解析およびコンパイルされた形式で格納されます。そのため、ストアド・プログラム・ユニットがコールされると、ロード後すぐにPL/SQLエンジンに渡されます。また、ストアド・プログラム・ユニットには共有メモリーが使用されます。そのため、プログラム・ユニットのコピーを1つのみメモリーにロードしておけば、複数のユーザーがそのプログラムを実行できます。

ストアド・プログラム・ユニットはOracleデータベースで実行されるので、レポートのローカルのPL/SQLよりも速くデータベース処理を実行できます。そのため、データベース処理を実行するPL/SQLには、通常ストアド・プログラム・ユニットを使用します。データベース処理を実行しないPL/SQLの場合は、ローカル・プログラム・ユニットを使用します。ただし、ネットワークの負荷が高く、レスポンス時間が非常に遅い場合には、ストアド・プログラム・ユニットを使用しても、データベース処理が速くならないことがあります。同様に、サーバーがローカル・マシンよりも非常に速い場合、ローカル・プログラム・ユニットを使用しても、データベース以外の処理が速くならないことがあります。

2.6.6 外部PL/SQLライブラリについて

外部PL/SQLライブラリは、レポート定義に依存しないPL/SQLプロシージャ、ファンクションおよびパッケージの集まりです。外部ライブラリをレポートに連結すると、その内容を何度でも参照できます。たとえば、連結ライブラリのプロシージャは、Before Reportトリガーとフォーマット・トリガーのどちらからでも参照できます。このため、アプリケーションごとに同じPL/SQLを再入力する必要がありません。

レポートまたは別の外部ライブラリに関連付けられた外部PL/SQLライブラリは、連結ライブラリと呼ばれます。

2.6.7 連結ライブラリについて

連結ライブラリは、レポートまたは別の外部ライブラリに関連付けられた外部PL/SQLライブラリです。外部ライブラリを連結すると、レポート内からそのパッケージ、ファンクションおよびプロシージャを参照できます。たとえば、MYLIBという外部ライブラリをレポートに連結し、そのライブラリにADDXYというファンクションが含まれる場合、レポート内のどのPL/SQLからでもADDXYを参照できます。

外部PL/SQLライブラリは、レポート定義に依存しません。

使用に関する注意

ローカルPL/SQLは、外部PL/SQLライブラリのプロシージャまたはファンクションを参照するよりも速く実行されます。そのため、多数のアプリケーション間でコードを共有する方が、パフォーマンスのオーバーヘッドよりも重要である場合にのみ、外部PL/SQLライブラリを使用してください。

制限

Reports Builderでは、「連結ライブラリ」リストで指定したライブラリを検索できない場合、ダイアログ・ボックスを受け入れるときや、レポートを保存するとき、またはレポートを開くときに警告が表示されます。レポートを実行するか、レポートのPL/SQLをコンパイルしようとすると、エラーが表示されます。
「連結ライブラリ」リストは保存されます。次回レポートまたはライブラリを開くと、このリストにはレポートを最後に保存したときと同じ内容が含まれています。
外部ライブラリが別のライブラリを参照する場合、最初のライブラリに2つ目のライブラリがすでに連結されていても、レポートに両方のライブラリを連結する必要があります。

2.6.8 式について

式は、式列またはプレースホルダ列に移入するPL/SQLファンクションです。式のPL/SQLには、オブジェクト・ナビゲータ、PL/SQLエディタまたはプロパティ・インスペクタ（「PL/SQL式」プロパティ）からアクセスできます。

「データ型」プロパティがNUMBERに設定されている列は、データ型NUMBERの値を返す式のみを含めることができます。「データ型」プロパティがDATEに設定されている列は、データ型DATEの値を返す式のみを含めることができます。「データ型」プロパティがCHARACTERに設定されている列は、データ型CHARACTER、VARCHARまたはVARCHAR2の値を返す式のみを含めることができます。

制限

列がプレースホルダ列またはパラメータ列である場合は、式の列に値を読み込んだり、割り当てたりできますが、データベース列の値（データベースから取り出した値）は変更できません。たとえば、列COMPの値を条件に使用し（たとえば、IF :COMP = 10）、その値を直接代入文に設定することはできます（たとえば、:COMP:= 15）。
式は、グループ階層の中で同等以上のグループにある列のみを参照できます。たとえば、レポートレベルの列の式は、別のレポートレベルの列のみを参照できます。
式は、その式で参照される列が最初に処理されるように計算されます。Reports Builderでは依存性リストが作成され、計算が正しい順序で実行されることが保証されます。ただし、列が別の列を参照し、参照された列が直接または間接的に最初の列を参照するような循環依存は許可されません。
SRW.DO_SQLを使用する場合は、同じレポートで更新または挿入されたデータベースの値を読み込まないようにしてください。出力の書式設定のために、Reports Builderがデータベースからレコードをフェッチする正確な時間は確定されません。Reports Builder内部では、パフォーマンスを最適化するために、データの先読みが行われています。そのため、特定のレコードに更新が実行される前に、同じレコードがすでにアクセスされている可能性があります。Reports Builderでは、内部依存性リストを作成し、ユーザー・イグジットの起動、サマリーの計算などのイベントが正しい順序で実行されることが保証されています。ただし、Reports Builderでこれらのイベントと、内部データへのアクセスやデータの書式設定との同期を取ることは保証できません。

例

例1: 値の追加

次の例では、給与にコミッションを足した値を列に移入します。

function salcomm return NUMBER is
begin
  return(:sal + :comm);
end;

例2: 条件の使用

次のコードでは、コミッションの値がNULL以外の場合に、給与にコミッションを足します。

function calcomm return NUMBER is
temp number;
begin
  if :comm IS NOT NULL then
    temp := :sal + :comm;
  else
    temp := :sal;
  end if;
  return (temp);
end;

2.6.9 グループ・フィルタについて

グループ・フィルタは、グループに含めるレコードを決定します。パッケージされたフィルタの「最初」と「最後」を使用して、グループの最初のn個または最後のn個のレコードを表示できます。また、PL/SQLを使用して独自のフィルタを作成することもできます。グループ・フィルタには、オブジェクト・ナビゲータ、プロパティ・インスペクタ（「PL/SQLフィルタ」プロパティ）、またはPL/SQLエディタからアクセスできます。

このファンクションは、ブール値（TRUEまたはFALSE）を返す必要があります。ファンクションがTRUEを返すか、FALSEを返すかに応じて、現行レコードがレポートに含まれるか、レポートから除外されます。

グループ・フィルタと「フェッチする行の最大数」プロパティの相違点

「フェッチする行の最大数」プロパティでは、問合せによってフェッチする実際のレコード数が制限されます。グループ・フィルタでは、問合せによってすべてのレコードがフェッチされた後に、どのレコードを含めるか、または除外するかが判断されます。「フェッチする行の最大数」では、実際に取り出されるデータの量が制限されるため、通常、グループ・フィルタよりも実行速度が速くなります。「フィルタ・タイプ」プロパティを「最後」または「条件付」に設定する場合、Reports Builderでは、フィルタを適用する前に、グループ内のすべてのレコードを取り出す必要があります。問合せに対して「フェッチする行の最大数」を使用する場合も、このことを念頭に置いてください。その問合せに依存する他のグループのサマリーに影響を及ぼす可能性があります。たとえば、「フェッチする行の最大数」プロパティを8に設定すると、その問合せに基づいたサマリーには、取り出された8つのレコードのみ使用されます。

制限

「フィルタ・タイプ」プロパティが「最初」または「最後」に設定されている場合、グループ・フィルタをグループに追加できません。

グループ・フィルタはクロス積グループに追加できません。
グループ・フィルタに入力するファンクションは、次の列にのみ依存できます。
- グループの問合せまたはデータ・モデル階層でそれより上位にある問合せが所有するデータベース列
- 関連性のない問合せに依存する計算済列（式またはサマリー）（つまり、グループ、グループの親またはグループの子の列に依存しない計算済列）
グループ・フィルタでは、Reports Builder列の値と正しい頻度のパラメータを読み込むことができますが、それらの値は直接設定できません。たとえば、パラメータCOUNT1の値を条件に使用できますが（たとえば、IF :COUNT1 = 10）、その値を直接代入文には設定できません（たとえば、:COUNT1:= 10）。また、PL/SQLグローバル変数を使用して列またはパラメータの値を間接的に設定する機能はサポートされていません。このような設定を行うと、予期しない結果になることがあります。また、ページ依存列（つまり、「ページ」の「リセット位置」）またはグループ・フィルタのページ依存列に依存する列は参照できません。

例

function filter_comm return boolean is
begin
  if :comm IS NOT NULL then
    if :comm < 100 then
      return (FALSE);
    else
      return (TRUE);
    end if;
  else
    return (FALSE); -- for rows with NULL commissions
  end if;
end;

2.6.10 REFカーソル問合せについて

REFカーソル問合せは、PL/SQLを使用してデータをフェッチします。各REFカーソル問合せは、カーソル変数からカーソル値を返すPL/SQLファンクションに関連付けられています。このファンクションでは、REFカーソルがオープンされ、REFカーソル型と一致するSELECTリストが含まれたSELECT文と関連付けられている必要があります。

使用に関する注意

Oracle Reportsでは、強く型付けされたREFカーソルのみがサポートされています。次に例を示します。
```
type c1 is REF CURSOR RETURN emp%ROWTYPE;
```
データ・リンク内の子にREFカーソル問合せを作成する場合、リンクはグループ間リンクのみが有効です。列間リンクは使用できません。
REFカーソルの実装にストアド・プログラム・ユニットを使用する場合は、Oracleデータベースにそのプログラム・ユニットを同時に格納できるという利点があります。
次のことを行うときに問合せの基準としてREFカーソルを使用します。
1. より簡単なSQLの管理
2. レポート内での文字パラメータの使用の回避
3. Form Builderなどの他のアプリケーションとのデータ・ソースの共有
4. 制御とセキュリティの向上
5. サブプログラム内のロジックのカプセル化

さらに、REFカーソルの実装にストアド・プログラム・ユニットを使用する場合は、Oracleデータベースにそのプログラム・ユニットを同時に格納できるという利点があります。

REFカーソルとストアド・サブプログラムの詳細は、『PL/SQLユーザーズ・ガイドおよびリファレンス』を参照してください。

例

例1: `REF`カーソルが含まれるパッケージの例

/* This package spec defines a REF CURSOR
** type that could be referenced from a
** REF CURSOR query function.
** If creating this spec as a stored
** procedure in a tool such as SQL*Plus,
** you would need to use the CREATE
** PACKAGE command.
*/

PACKAGE cv IS
type comp_rec is RECORD
  (deptno number,
   ename varchar(10),
   compensation number);
type comp_cv is REF CURSOR return comp_rec;
END;

例2: `REF`カーソルとファンクションが含まれるパッケージ

/* This package spec and body define a ref
** cursor type as well as a function that
** uses the REF CURSOR to return data.
** The function could be referenced from
** the REF CURSOR query, which would
** greatly simplify the PL/SQL in the
** query itself. If creating this spec
** and body as a stored procedure in a
** tool such as SQL*Plus, you would need
** to use the CREATE PACKAGE and CREATE
** PACKAGE BODY commands.
*/

PACKAGE cv IS
type comp_rec is RECORD
  (deptno number,
   ename varchar(10),
   compensation number);
type comp_cv is REF CURSOR return comp_rec;
function emprefc(deptno1 number) return comp_cv;
END;

PACKAGE BODY cv IS
function emprefc(deptno1 number) return comp_cv is
  temp_cv cv.comp_cv;
begin
  if deptno1 > 20 then
    open temp_cv for select deptno, ename,
    1.25*(sal+nvl(comm,0)) compensation
    from emp where deptno = deptno1;
  else
    open temp_cv for select deptno, ename,
    1.15*(sal+nvl(comm,0)) compensation
    from emp where deptno = deptno1;
  end if;
  return temp_cv;
end;
END;

例3: `REF`カーソル問合せ

/* This REF CURSOR query function would be coded
** in the query itself. It uses the cv.comp_cv
** REF CURSOR from the cv package to return
** data for the query.
*/
function DS_3RefCurDS return cv.comp_cv is
  temp_cv cv.comp_cv;
begin
  if :deptno > 20 then
    open temp_cv for select deptno, ename,
    1.25*(sal+nvl(comm,0)) compensation
    from emp where deptno = :deptno;
  else
   open temp_cv for select deptno, ename,
   1.15*(sal+nvl(comm,0)) compensation
   from emp where deptno = :deptno;
  end if;
  return temp_cv;
end;

例4: `REF`カーソル問合せコール側ファンクション

/* This REF CURSOR query function would be coded
** in the query itself. It uses the cv.comp_cv
** REF CURSOR and the cv.emprefc function from
** the cv package to return data for the query.
** Because it uses the function from the cv
** package, the logic for the query resides
** mainly within the package. Query
** administration/maintenance can be
** done at the package level (for example,
** modifying SELECT clauses could be done
** by updating the package). You could also
** easily move the package to the database.
** Note this example assumes you have defined
** a user parameter named deptno.
*/

function DS_3RefCurDS return cv.comp_cv is
  temp_cv cv.comp_cv;
begin
  temp_cv := cv.emprefc(:deptno);
  return temp_cv;
end;

2.6.11 DMLとDDLについて

PL/SQLでデータ操作言語（DML）またはデータ定義言語（DDL）を使用する場合は、SRW.DO_SQLビルトイン・プロシージャを使用できます。SRW.DO_SQLは、DMLおよびDDLでのみ使用し、データのフェッチには使用しないでください。DMLおよびDDLの詳細は、『Oracle Database SQLリファレンス』を参照してください。

Oracle Reportsの処理モデルにより、DDLはBefore Parameter FormトリガーおよびAfter Parameter Formトリガーのみで使用することをお薦めします。DMLは、PL/SQLが受け入れられる場所ならどこにでも入力できます。

このレポートの処理で報告されるDMLまたはDDLは、After Parameter Formトリガーで（またはその前で）実行する必要があります。Before Reportトリガーでは整合性は保証できません。これは、Oracle Reportsが、レポートの定義に基づいて、そのトリガーの前にデータ・カーソルでの作業を開始する必要があるためです。Before Reportトリガーの前にReports Builderで必ず行われることは、関連する表を記述し、カーソルを開くことです。これ以降に表で行った変更は、レポートに表示されません。

2.6.12 ビルトイン・パッケージについて

ビルトイン・パッケージは、論理的に関連するPL/SQL型、オブジェクト、ファンクションやプロシージャの集まりです。これは通常、パッケージ仕様部（データ宣言を含む）とパッケージ本体という2つの部分で構成されます。パッケージを使用すると、グローバル変数を作成できるので非常に便利です。

複数のパッケージ・プロシージャが用意されており、PL/SQLベースのアプリケーションを構築またはデバッグするときに使用できます。PL/SQLコードでは、次に説明するように、Reports Builderビルトイン・パッケージ（SRW）と各種のツール・ビルトイン・パッケージのプロシージャ、ファンクションおよび例外を使用できます。

2.6.12.1 Reports Builderビルトイン・パッケージ（SRW）について

Reports Builderには、ビルトイン・パッケージ（SRW）が付属しています。ビルトイン・パッケージは、様々なファンクション、プロシージャおよび例外が含まれたPL/SQL構文の集まりで、ライブラリまたはレポートで参照できます。

SRWパッケージに含まれるPL/SQLでは、フィールドの書式設定の変更、他のレポートからのレポートの実行、レポート・エラー時に表示するカスタマイズ・メッセージの作成、およびSQL文の実行などのアクションを実行できます。

SRWパッケージの内容は、連結されていないくても、ライブラリまたはレポートから参照できます。ただし、SQL*Plusなどの別の製品からこの内容を参照することはできません。

パッケージに含まれる構文は通常、パッケージ・ファンクション、パッケージ・プロシージャおよびパッケージ例外のように「パッケージ」を付けて呼びます。

2.6.12.2 ツール・ビルトイン・パッケージについて

各種のPL/SQL構文を含むいくつかのクライアント側ビルトイン・パッケージが用意されており、アプリケーションの構築やアプリケーション・コードのデバッグ時に参照できます。これらのビルトイン・パッケージは、パッケージSTANDARDの拡張機能としてインストールされません。このため、いずれかのパッケージの構文を参照するたびに、その名前の前にパッケージ名を付ける必要があります（TEXT_IO.PUT_LINEなど）。

次のようなツール・ビルトイン・パッケージがあります。

DDE

Reports Builderコンポーネント内で動的データ交換（DDE）をサポートします。
DEBUG

PL/SQLプログラム・ユニットをデバッグする際のプロシージャ、ファンクションおよび例外が含まれます。これらのビルトイン・サブプログラムを使用すると、デバッグ・トリガーを作成し、トリガーでブレークポイントを設定できます。
EXEC_SQL

Reports Builderアプリケーションに作成したPL/SQLコード内で、動的SQLを実行するためのプロシージャとファンクションが含まれます。
LIST

文字列（VARCHAR2）のリストを作成および保守するために使用できるプロシージャ、ファンクションおよび例外が含まれます。これを使用すると、PL/SQLバージョン1で配列を作成できるようになります。
ORA_FFI

ダイナミック・ライブラリのC関数をコールする外部関数インタフェースが含まれます。
ORA_JAVA

PL/SQLからJavaクラスをコールするインタフェースが含まれます。
ORA_NLS

現行の言語環境に関する詳細な情報を取り出せるようにします。この情報を使用して、言語の属性を調べ、ローカルの日付と数値形式を使用してアプリケーションをカスタマイズできます。また、キャラクタ・セットの照合に関する情報と、一般的なキャラクタ・セットも取得できます。現行の言語名とキャラクタ・セットを検索する機能も用意されており、特殊なケースをテストし、利用するアプリケーションを作成できます。
ORA_PROF

PL/SQLプログラム・ユニットのチューニング（たとえば、特定のコード部分を実行するのにどれぐらいの時間がかかるか調べる）に使用できるプロシージャ、ファンクションおよび例外が含まれます。
TEXT_IO

ファイルからの情報の読込み、ファイルへの情報の書込みを可能にする構文が含まれます。Text_IOで使用可能なプロシージャやファンクションは、次のカテゴリに分類されます。
- ファイル操作。FILE_TYPEレコード、FOPENファンクションやIS_OPENファンクション、およびFCLOSEプロシージャを使用すると、FILE_TYPE変数を定義し、ファイルを開き、開いたファイルをチェックし、それらのファイルを閉じることができます。
- 出力（書込み）操作。PUT、PUTF、PUT_LINEおよびNEW_LINEの各プロシージャを使用すると、開いているファイルに情報を書き込んだり、PL/SQLインタプリタに情報を出力したりできます。
- 入力（読込み）操作。GET_LINEプロシージャを使用すると、開いているファイルから行を読み込むことができます。
TOOL_ENV

サブプログラムで使用する値を取り出して、Oracle環境変数と対話できるようにします。
TOOL_ERR

DEBUGなどの別のビルトイン・パッケージで作成したエラー・スタックにアクセスし、操作できるようにします。

一部のビルトイン・パッケージ（たとえば、DEBUGパッケージ）では、エラーを示すために例外を使用するだけでなく、追加のエラー情報も提供します。この情報は、エラー・スタックの形式で保持されます。

エラー・スタックには、詳細なエラー・コードと関連するエラー・メッセージが含まれます。スタック上のエラーには、ゼロ（最古）からn-1（最新）の番号が付けられます。nはスタック上に現在あるエラー数です。TOOL_ERRパッケージのサービスを使用すると、エラー・スタックにアクセスし、操作できます。
TOOL_RES

PL/SQLコードを移植しやすくするため、リソース・ファイルのすべてのテキスト・データを分離して、リソース・ファイルから文字列リソースを抽出します。

次のパッケージは、Oracle Reportsの内部でのみ使用されます。これらのパッケージには、外部で使用できるサブプログラムはありません。

ORA_DE

ReportsによりプライベートPL/SQLサービスで使用される構文が含まれます。
STPROC

データベースに格納されたサブプログラムをコールします。このパッケージへのコールは自動的に生成されます。
JNI

PL/SQLからJavaをコールしやすくします。

2.6.13 トリガーについて

トリガーではイベントをチェックします。イベントが発生すると、トリガーに関連付けられたPL/SQLコードが実行されます。

レポート・トリガーは、レポートに含まれるデータではなく、レポートを開いたり、閉じたりするレポート・イベントに対応してアクティブ化されます。アクティブ化される順序はどのレポートにもあらかじめ定義されています。

フォーマット・トリガーは、オブジェクトをフォーマットする前に実行されます。フォーマット・トリガーは、オブジェクトのフォーマット属性を動的に変更するときに使用できます。

妥当性チェック・トリガーは、コマンドラインでパラメータ値が指定された場合、およびランタイム・パラメータ・フォームを受け入れた場合に実行されるPL/SQLファンクションです。

データベース・トリガーは、データベースに暗黙的に格納され、INSERT、UPDATEまたはDELETEなどのトリガーを実行する文が関連付けられた表に発行されたときに実行されるプロシージャです。

2.6.13.1 レポート・トリガーについて

レポート・トリガーは、レポートの実行およびフォーマット時に、所定回数だけPL/SQLファンクションを実行します。これらのトリガーに、PL/SQLの条件付き処理機能を使用すると、レポート・フォーマットのカスタマイズ、初期化タスクの実行、およびデータベースへのアクセスなどを行うことができます。レポート・トリガーを作成または変更するには、オブジェクト・ナビゲータの「レポート・トリガー」ノードを使用します。レポート・トリガーは、明示的にTRUEまたはFALSEを返す必要があります。

Oracle Reportsには、次のような5つのグローバル・レポート・トリガーがあります。新しいグローバル・レポート・トリガーは作成できません。トリガー名は、トリガーをどの時点で起動するかを示します。

Before Reportトリガー: 問合せが解析された後、レポートが実行される前に起動します。
After Reportトリガー: ペーパー・デザイン・ビューを終了した後、またはレポート出力が指定の出力先（ファイル、プリンタ、電子メールIDなど）に送信された後に起動します。このトリガーを使用すると、表の削除など、完了した初期処理をクリーンアップできます。ただし、このトリガーは、レポートが正常に完了したかどうかにかかわらず、常に起動されることに注意してください。
Between Pagesトリガー: 最初のページを除き、レポートの各ページがフォーマットされる前に起動します。このトリガーは、カスタマイズされたページのフォーマットに使用できます。ペーパー・デザイン・ビューでは、このトリガーは任意のページに最初に移動したときにのみ起動します。後でそのページに戻っても、トリガーは再度起動されません。
Before Parameter Formトリガー: ランタイム・パラメータ・フォームが表示される前に起動します。このトリガーから、パラメータ、PL/SQLグローバル変数およびレポート・レベルの列の値にアクセスし、変更できます。ランタイム・パラメータ・フォームが表示されていない場合でも、このトリガーは起動します。そのため、このトリガーは、コマンドライン・パラメータの妥当性チェックに使用できます。
After Parameter Formトリガー: ランタイム・パラメータ・フォームが表示された後に起動します。このトリガーから、パラメータにアクセスして値をチェックできます。このトリガーを使用すると、パラメータの値を変更したり、エラーが発生した場合にランタイム・パラメータ・フォームに戻ることもできます。データ・モデルの列は、このトリガーからはアクセスできません。ランタイム・パラメータ・フォームが表示されていない場合でも、After Parameter Formトリガーは起動します。そのため、このトリガーは、コマンドライン・パラメータまたはその他のデータの妥当性チェックに使用できます。

レポート・トリガー実行の順序

レポート実行時のイベントの順序は次のとおりです。

Before Parameter Formトリガーが起動します。

注意
パラメータ・フォームがWeb上で使用されている場合、Before Parameter Formトリガーは2回起動します。1回はパラメータ・フォームが表示されたとき、もう1回はパラメータが送信されたときです。これは、Oracle Reportsがステートレスに実行されるためです。戻り先のセッションがないため、Before Parameter Formトリガーを2回起動することによって、パラメータ・フォームで選択されてコマンドラインに渡されたパラメータが有効であることを確認する必要があります。

ランタイム・パラメータ・フォームが表示されます（非表示になっていない場合）。
After Parameter Formトリガーが起動します（ユーザーがランタイム・パラメータ・フォームからキャンセルしない場合）。
レポートがコンパイルされます。
問合せが解析されます。
Before Reportトリガーが起動します。
SET TRANSACTION READONLYが実行されます（READONLYコマンドライン・キーワードまたは設定で指定されている場合）。
レポートが実行され、最初のページを除く各ページでBetween Pagesトリガーが起動します（データは、レポートのフォーマット中にいつでもフェッチできます）。この間に、SRW.DO_SQLをDDLで使用しているため、またはONFAILURE=COMMITでレポートが失敗した場合に、COMMITが発生することがあります。
COMMITが実行され（READONLYが指定されている場合）、トランザクションが終了します。
After Reportトリガーが起動します。
ONSUCCESSコマンドライン・キーワードまたは設定の指定に基づいて、COMMIT、ROLLBACK、NOACTIONのいずれかが実行されます。

使用に関する注意

手順4～9では、レポートのベースとなっている表を修正するDDL文は避けてください。手順3では、表のスナップショットがとられます。このスナップショットは、レポートを実行中は有効なままにする必要があります。手順7～9では、レポートのベースとなっている表の内容を修正するDML文は避けてください。問合せがどんな順序でも実行可能になり、DML文が信頼できなくなる場合があります（レポートで使用されていない表で実行する場合は除きます）。
コマンドラインでREADONLYを指定する場合は、DDLをすべて使用しないでください。DDL文（たとえば、SRW.DO_SQLで）を実行すると、COMMITが自動的に発行されます。READONLYを使用している場合、SET TRANSACTION READONLYによって開始したトランザクションが未完了のまま終了します。
通常は、レポートによって取得されるデータに影響する処理は、すべてBefore Parameter FormトリガーまたはAfter Parameter Formトリガーで実行する必要があります（これらの2つは、解析やフェッチが行われる前に起動するレポート・トリガーです）。レポートによって取得されるデータに影響しない処理は、他のトリガーで実行できます。
After Parameter Formトリガーで（または前に）DMLやDDLを使用した場合でも、整合性が確保されます。ただし、Before Reportトリガーでは整合性は確保されません。これは、Oracle Reportsが、レポートの定義に基づいて、そのトリガーの前にデータ・カーソルでの作業を開始する必要があるためです。Before Reportトリガーの前に、Oracle Reportsは関連する表を記述し、カーソルを開きます。これ以降に表で行った変更は、レポートに表示されません。

制限

レポート出力をペーパー・デザイン・ビューまたはプレビューアに送信する場合は、レポート出力が表示される前に一部またはすべてのレポート・トリガーが起動する場合があることに注意してください。たとえば、SRW.MESSAGEを使用して、条件が満たされたときにBetween Pagesトリガーでメッセージを発行するとします。レポートに前方参照がある場合（ページの合計数を最後のページの前に表示するなど）、Oracle Reportsでは事前にフォーマットして前方参照を計算する必要があります。したがって、まだ確認していないページでも、すでにフォーマットされトリガーが起動されている場合があります。
レポート・トリガーでは、レポート・レベルの列およびパラメータの値を使用できます。たとえば、COUNT1というパラメータの値が、ある条件（IF :COUNT1 = 10など）で必要な場合があります。ただし、ページ依存列（「リセット位置」プロパティが「ページ」に設定されている列）またはページ依存列に依存する列は参照できません。
Before Parameter FormトリガーとAfter Parameter Formトリガー、およびBefore ReportトリガーとAfter Reportトリガーでは、パラメータの値を設定できます（たとえば、代入文:COUNT1 = 15で値を指定できます）。Before ReportトリガーとAfter Reportトリガーでは、レポート・レベルのプレースホルダ列の値も設定できます。
Between Pagesトリガーでは、データ・モデル・オブジェクトの値は設定できません。また、PL/SQLグローバル変数を使用して列またはパラメータの値を間接的に設定する機能はお薦めしません。このような設定を行うと、予期しない結果になることがあります。
字句参照を使用して、After Parameter Formトリガーの起動後に追加されるバインド変数を作成することはできません。たとえば、次のような問合せがあるとします（WHERE句が字句参照によって置換されることに注意してください）。

SELECT ENAME, SAL FROM EMP &WHERE_CLAUSE

WHERE_CLAUSEパラメータの値にバインド変数への参照が含まれる場合は、After Parameter Formトリガーでその値を指定するか、事前に指定する必要があります。Before Reportトリガーでパラメータに次の値を設定すると、エラーが発生します。After Parameter Formトリガーで同じ値を設定すると、レポートが実行されます。

WHERE SAL = :new_bind

2.6.13.2 フォーマット・トリガーについて

フォーマット・トリガーは、オブジェクトがフォーマットされる前に実行されるPL/SQLファンクションです。トリガーは、オブジェクトのフォーマット属性を動的に変更するときに使用できます。たとえば、フォーマット・トリガーを使用して、値がゼロ未満の場合に太字で表示できます。また、フォーマット・トリガーを使用して、値が1,000,000より大きい場合にそのフィールドに科学表記法を使用できます。

フォーマット・トリガーは、Reports Builderが特定オブジェクトのフォーマットを試行するたびに、そのオブジェクトで起動できます。Reports Builderが、ページの一番下にあるオブジェクトのフォーマットを開始するとします。オブジェクトがそのページ上に収まらない場合、Reports Builderはフォーマットを中止し、次のページで再フォーマットを行います。この場合、フォーマット・トリガーは2回起動します。したがって、このトリガーでは、ロギングなどの永続的な処理を行うことはお薦めしません。

Reports Builder SRWビルトイン・パッケージには、オブジェクトのフォーマット属性を簡単に変更できるPL/SQLプロシージャが含まれています。これには、次のような処理を行うプロシージャがあります。

オブジェクトの境界線パターンとカラーを変更する
オブジェクトの内部パターンとカラーを変更する
フィールドまたはボイラープレート・テキストのフォント・サイズ、スタイル、太さ、間隔および文字間調整を変更する
フィールドの書式マスクを変更する
フィールドの値にアクセスする

例

Oracle Reportsオンライン・ヘルプの「リファレンス」の項のトピック「フォーマット・トリガー」を参照してください。

2.6.13.3 妥当性チェック・トリガーについて

注意
JSPベースのWebレポートの場合、Reports Builderでレポートを実行するとランタイム・パラメータ・フォームが表示されますが、Oracle Reports Servicesのランタイム環境では表示されません。ランタイム・パラメータ・フォームでパラメータを指定しないと、妥当性チェック・トリガーはFALSEを返し、エラー・メッセージ「REP-0546: 入力されたパラメータは無効です。」を出力します。このため、第1.9.4項「Webレポートのパラメータ・フォームについて」に記載されたように、別の方法でパラメータを指定する必要があります。

妥当性チェック・トリガーは、パラメータの「初期値」プロパティの妥当性チェックを行うときにも使用します。ファンクションがTRUEを返すか、FALSEを返すかに応じて、ランタイム・パラメータ・フォームに戻ります。

例

Oracle Reportsオンライン・ヘルプの「リファレンス」の項のトピック「妥当性チェック・トリガー」参照してください。

2.6.13.4 データベース・トリガーについて

データベース・トリガーは、データベースに暗黙的に格納され、INSERT、UPDATEまたはDELETEなどのトリガー文が関連付けられた表に発行されたときに実行されるプロシージャです。トリガーは、表でのみ定義でき、ビューでは定義できません。ただし、ビューの実表のトリガーは、INSERT、UPDATEまたはDELETE文がビューに対して発行された場合に起動します。

トリガーは、ユニットとして実行されるSQL文およびPL/SQL文を含めることができ、別のストアド・プロシージャをコールできます。トリガーは、必要な場合にのみ使用してください。トリガーを多用すると、カスケード・トリガーや再帰的トリガーが発生することがあります。たとえば、トリガーが起動されたときに、トリガー本体のSQL文が別のトリガーを起動することがあります。

データベース・トリガーを使用すると、複合ビジネス・ルールを規定し、すべてのアプリケーションを同じように動作させることができます。トリガーを作成する場合は、次のガイドラインに従います。

トリガーは、特定の操作が実行されたときに、関連するアクションを実行させる場合に使用します。
データベース・トリガーは、トリガーを実行する文で起動される集中化されたグローバル操作にのみ使用します。その際にどのユーザーまたはデータベース・アプリケーションがその文を発行したかは問いません。
Oracleデータベースにすでに組み込まれている機能と重複するトリガーは定義しないでください。たとえば、宣言整合性制約を使用して簡単に施行できるような、データ整合性規則を規定するトリガーは定義しないでください。
トリガーのサイズを制限します（目安として60行以下）。トリガーの論理で61行以上のPL/SQLコードが必要な場合、コードの大部分をストアド・プロシージャに含め、トリガーからそのプロシージャをコールすることをお薦めします。
再帰的トリガーは作成しないでください。たとえば、EMPでUPDATE文を発行するEMP表にAFTER UPDATE文トリガーを作成すると、メモリーがなくなるまでトリガーが繰り返して起動されます。

アプリケーションでのトリガーの使用方法の詳細は、『Oracleアプリケーション開発者ガイド』を参照してください。各種トリガーの詳細は、『Oracleデータベース概要』を参照してください。

2.7 テンプレート

この項のトピックでは、Reports Builderにおけるテンプレートの使用について説明します。

2.7.1 テンプレートについて

テンプレートでは、複数のペーパーベースのレポートに適用する共通特性とオブジェクトを定義します。たとえば、会社のロゴを含み、レポートの選択した領域にフォントやカラーを設定するテンプレートを定義できます。

レポート・ウィザードを使用してペーパーベースのレポートを作成する場合は、ウィザードの「テンプレート」ページで、テンプレート（.tdfファイル）をレポートに適用します。「テンプレート」ページには、デフォルトのテンプレートのほか、独自に作成したテンプレートが一覧されます。

注意
テンプレートの一覧が表示されない場合は、REPORTS_PATH環境変数にテンプレートの位置（ORACLE_HOME¥reports¥templatesなど）が指定されているかどうかを確認してください。

テンプレートを選択すると、テンプレートのマージン領域にあるオブジェクトが、現行のレポート・セクションの同じ位置にインポートされ、既存のオブジェクトがすべて上書きされます。テンプレートの本体領域内にあるオブジェクトの特性（書式設定、フォント、カラーなど）が、現行のレポート・セクションの本体領域にあるオブジェクトに適用されます。また、定義したテンプレート・プロパティ、パラメータ、レポート・トリガー、プログラム・ユニットおよび連結ライブラリも適用されます。レポートのセクション別に異なるテンプレートを適用できます。ただし、デフォルトのテンプレートを適用する場合、異なるデフォルトのテンプレートを使用した2つのレポート・ブロックを1つのレポートに組み合せることはできません。同一レポート内のすべてのレポート・ブロックで、同じデフォルトのテンプレートを使用する必要があります。

後でレポートに別のテンプレートを適用した場合、既存のテンプレート・オブジェクトは現行のレポート・セクションから削除されます。

2.7.2 テンプレート属性について

テンプレートのペーパー・レイアウト-ボディ領域では、オブジェクト・ナビゲータの次の各ノードの「デフォルト」および「上書き」属性を定義できます。

「枠」には次のノードがあります。
- 「セクション枠」ノード。現在選択されているセクションの周囲にある親枠の属性を定義します。
- 「ヘッダー枠」ノード。列ヘッダーの周囲にある親枠の属性を定義します。
- 「フィールド枠」ノード。フィールドの周囲にある親枠の属性を定義します。
- 「サマリー枠」ノード。サマリー（合計）の周囲にある親枠の属性を定義します。
「フィールドのラベル/ヘッダ」には次のノードがあります。
- 「Character」ノード。Characterフィールドのラベルまたは列ヘッダーの属性を定義します。
- 「Number」ノード。Numberフィールドのラベルまたは列ヘッダーの属性を定義します。
- 「Date」ノード。Dateフィールドのラベルまたは列ヘッダーの属性を定義します。
「フィールド」には次のノードがあります。
- 「Character」ノード。Characterフィールドの属性を定義します。
- 「Number」ノード。Numberフィールドの属性を定義します。
- 「Date」ノード。Dateフィールドの属性を定義します。
「サマリー・ラベル」には次のノードがあります。
- 「Character」ノード。Characterフィールドのサマリー・ラベルの属性を定義します。
- 「Number」ノード。Numberフィールドのサマリー・ラベルの属性を定義します。
- 「Date」ノード。Dateフィールドのサマリー・ラベルの属性を定義します。
「サマリー」には次のノードがあります。
- 「Character」ノード。Characterフィールドのサマリーの属性を定義します。
- 「Number」ノード。Numberフィールドのサマリーの属性を定義します。
- 「Date」ノード。Dateフィールドのサマリーの属性を定義します。

「デフォルト」属性

オブジェクト・ナビゲータの「デフォルト」ノードでは、すべてのレポート・スタイルに対するデフォルトの可視属性（書式設定、フォント、カラーなど）を定義します。個別のレポート・スタイルの属性を定義する場合は、「上書き」ノードを使用します。レポートにテンプレートを適用すると、「上書き」ノードでローカライズされた属性を除き、すべての「デフォルト」属性がレポートに適用されます。

「上書き」属性

オブジェクト・ナビゲータの「上書き」ノードで、個別のレポート・スタイルの属性を定義できます。各レポート・スタイルには、レポート内のグループにマッピングされる1つ以上のセクションが含まれます。

単一セクションのレポート・スタイル:表形式、フォーム、メール・ラベル、フォーム・レター

複数セクションのレポート・スタイル:グループ左、グループ上、マトリックス、グループ別マトリックス

複数のグループに対応するレポート・スタイルの場合、必要に応じて追加のセクションを作成できます。セクションは、次のようにグループにマッピングされます。

セクションとグループの数が同じ場合:1対1のマッピングが行われます（最初のセクションが最初のグループに、2番目のセクションが2番目のグループに、というようにマッピングされます）。

セクションよりグループの数が多い場合:最後の2つ前のセクションまで1対1のマッピングが行われます。この後のグループはすべて、最後の1つ前のセクションにマッピングされ、最後のグループが最後のセクションにマッピングされます。セクションが1つしかない場合、すべてのグループがそのセクションにマッピングされます。

グループよりセクションの数が多い場合:最後の前のグループまで1対1のマッピングが行われます。最後のグループは最後のセクションにマッピングされます。

2.7.3 テンプレートの適用について

レポートにテンプレートを適用する場合、次のオブジェクト、プロパティおよび属性がすべてテンプレートから現行のレポート・セクションに適用されます。

パラメータとその妥当性チェック・トリガー
物理ページ・サイズ
論理ページ・サイズ
キャラクタ/ビットマップ・モード
マージン位置
パネル印刷順序

また、テンプレートのマージン内にあるレイアウト・オブジェクトはすべて、現行のレポート・セクションの同じ位置にコピーされます。

使用に関する注意

デフォルトでは、レポートの現行のセクション（ペーパー・レイアウト・ビューに表示されているセクション）にテンプレートが適用されます。セクションが表示されていない場合、デフォルトで、レポートのメイン・セクションにテンプレートが適用されます。オブジェクト・ナビゲータでレポート全体のノードを選択すると、テンプレートがデフォルトでレポートのメイン・セクションに適用されます。レポートの特定のセクションにテンプレートを適用するには、オブジェクト・ナビゲータでそのセクションのノードを選択します。
レポートのセクション別に異なるテンプレートを適用できます。ただし、デフォルトのテンプレートを適用する場合、異なるデフォルトのテンプレートを使用した2つのレポート・ブロックを1つのレポートに組み合せることはできません。同一レポート内のすべてのレポート・ブロックで、同じデフォルトのテンプレートを使用する必要があります。

2.7.4 テンプレートでの継承について

テンプレートでは、「セクション」、「枠」、「フィールド」、「ラベル」、「ヘッダー」および「サマリー」の各プロパティがすべて、その値を継承できます。

「デフォルト」プロパティ

「デフォルト」プロパティは、Reports Builderであらかじめ設定された値を継承します。プロパティをReports Builderのデフォルトの値に設定すると、プロパティ・インスペクタでそのプロパティの横にあるアイコンが小さな円になります。「デフォルト」プロパティは、値を変更または選択して、ツールバーの「プロパティをローカライズ」ボタンをクリックするとローカライズされます。プロパティがローカライズされると、その横にあるアイコンが四角形になります。プロパティを継承した値に戻すには、プロパティを選択し、ツールバーの「プロパティを継承」ボタンをクリックします。

「上書き」プロパティ

「上書き」セクションのプロパティは、「デフォルト」プロパティから値を継承します。プロパティが「デフォルト」プロパティから値を継承した場合、プロパティ・インスペクタでプロパティの横にあるアイコンが矢印になります。「上書き」セクションのプロパティは、値を変更または選択して、ツールバーの「プロパティをローカライズ」ボタンをクリックするとローカライズされます。プロパティがローカライズされると、その横にあるアイコンが赤い×印が付いた矢印に変わります。「上書き」セクションのプロパティを継承した値に戻すには、プロパティを選択し、ツールバーの「プロパティを継承」ボタンをクリックします。

2.7.5 テンプレート・エディタについて

テンプレート・エディタは、テンプレートのオブジェクトおよび書式設定プロパティを定義できる作業領域です。これは、レポート・エディタのペーパー・レイアウト・ビューに似ています。このマージン領域で、オブジェクト（ページ番号、テキスト、グラフィックなど）を作成、削除および変更できます。本体領域ではオブジェクトを作成したり、削除したりできませんが、本体オブジェクトのプロパティはプロパティ・インスペクタで変更できます（「ツール」→「プロパティ・インスペクタ」）。

「レポート・スタイル」リストで、選択したレポート・スタイルのレイアウトを表示できます。すべてのレポート・スタイルに対してデフォルト設定を定義するには、「レポート・スタイル」リストから「デフォルト」を選択します。レポート・スタイルを個別に変更するには、「レポート・スタイル」リストからレポート・スタイルを選択し、デフォルトに上書きする設定を指定します。

アクセス

次の方法で、テンプレート・エディタにアクセスできます。

新しいテンプレートを作成する場合:

「ファイル」→「新規」→「テンプレート」を選択します。
オブジェクト・ナビゲータで、「テンプレート」ノードをクリックし、ツールバーの「作成」ボタンをクリックします。

既存のテンプレートを表示する場合:

「ウィンドウ」メニューから、テンプレート・エディタのペーパー・レイアウト・ビューを表示するウィンドウを選択します。
オブジェクト・ナビゲータで、テンプレートの「ペーパー・レイアウト」ノードの横にあるビュー・アイコンをダブルクリックします。

2.8 出力フォーマットと機能

この項のトピックでは、Reports Builderの様々な出力フォーマットと機能について説明します。

2.8.1 フォーマットの順序について

Oracle Reportsの以前のリリースでは、レポートの各セクションは、ヘッダー・セクション、メイン・セクション、トレーラ・セクションの順にフォーマットされました。このリリースには、3つのレポート・セクションのフォーマット順序を変更する機能が導入されています。

注意
レポート・セクションのフォーマット順序を変更しても、出力順序は変更されません。つまり、最初にヘッダー・セクション、次にメイン・セクション、最後にトレーラ・セクションが出力されます。

フォーマット順序は、次の方法で設定できます。

SRW.SET_FORMAT_ORDERビルトイン・プロシージャ。

この機能は、任意のレポート・セクションを最初にフォーマットして、フォーマット時にのみ認識できるページ番号などの情報を取得し、その情報を前のセクションのフォーマットに使用するような場合に便利です。

たとえば、レポートの目次（TOC）を作成するには、メイン・セクションを最初にフォーマットしてから、レポート・トリガーを使用して、TOCエントリが含まれる表を作成できます。TOCの最初の要素をフォーマットするとトリガーが起動され、そのTOCエントリとページ番号が含まれる行がTOC表に作成されます。メイン・セクションのフォーマット後に、ヘッダー・セクションがフォーマットされるようにフォーマット順序の設定を定義できます。ヘッダー・セクションには、TOC表に基づいたレポート・ブロックを含められます。フォーマットの終了後、レポートをTOC（ヘッダー・セクション）、レポート本体（メイン・セクション）、トレーラ・セクションの順に出力できます。

レポートのTOCを作成する手順は、第35章「単純な目次と索引を使用したペーパー・レポートの作成」および第36章「複数階層の目次を使用したペーパー・レポートの作成」のサンプル・レポートを参照してください。

ページ番号付けに関する注意

レポートのページ番号は、フォーマット順に付けられます。たとえば、ヘッダー・セクションが2ページ、メイン・セクションが8ページ、トレーラ・セクションが3ページあるレポートでは、フォーマット順序を「メイン-トレーラ-ヘッダー」に設定した場合、レポート出力には、12、13（最後にフォーマットされたヘッダーのページ）、1、2、3、4、5、6、7、8（最初にフォーマットされたメインのページ）、9、10、11（2番目にフォーマットされたトレーラのページ）というようにページ番号が付けられます。

2.8.2 バッチ・レポートについて

プレビューアでレポート出力を確認する必要がない場合（たとえば、完全にテストされたレポートから大量に出力する場合や、複数のレポートを連続して実行する必要がある場合）、rwrunを使用してレポートをバッチで実行することができます。これにより、レポートを実行している間に、別のタスクを処理することができます。

コマンドラインからバッチ・モードでレポートを実行することも、コマンド・ファイルを使用して引数を指定することもできます。同じ一連の引数を使用して複数のレポートを実行する場合、コマンド・ファイルによって入力の手間を大幅に省くことができます。

また、Reports Serverを使用して、コマンドラインでBACKGROUND=YESを指定し（rwclient、rwcgiまたはrwservletで有効）、レポートを非同期で実行することで、レポートをバッチ処理することもできます。つまり、クライアントはサーバーにコールを送り、レポート・ジョブが完了するのを待たずに別のプロセスへ進みます。クライアント・プロセスが削除されると、そのジョブも取り消されます。

2.8.3 レポートの配布について

レポートの配布により、複数の出力フォーマットを生成できるレポートを設計し、レポートを1回実行するのみで複数の宛先に配布できます。レポート全体に配布を作成することも、レポートの個々のセクションにのみ配布を作成することもできます。たとえば、レポートを1回実行するときに、HTML出力を生成し、プリンタへPostScriptバージョンを送信し、レポートの一部または全部のセクションを配布リストに電子メールで送信できます。

レポートを配布するには、第3.7.12項「複数の宛先へのレポートの配布」で説明しているように、最初に配布を定義してから、その配布を有効にします。

セクションレベルの配布の使用例は、第37章「レポートの一括処理と配布」を参照してください。この章では、「繰返し」プロパティおよび配布XMLファイルを使用して、1つのセクションに複数の配布先を定義する方法について説明します。

使用に関する注意

1つのレポートに、キャラクタ・モードとビットマップ出力を混在させることはできません。MODEシステム・パラメータは、レポート全体で1つの値のみに設定できます（DEFAULT、BITMAPまたはCHARACTER）。

例

例1

セクション分割と配布を使用することで、レポート出力をHTMLで公開したり、Postscriptバージョンでプリンタに送信したりできます。

例2

2.8.3.1 DSTファイルについて

「配布」ダイアログ・ボックスでレポートまたはレポート・セクションの配布を定義するかわりに、DSTファイルを作成し、DESTINATIONキーワードを使用してその名前をコマンドラインで指定し、レポートを配布することもできます。

注意
この方法は、下位互換性を維持するためにサポートされているので、「配布」ダイアログ・ボックスまたはXMLを使用してレポートを配布する方法をお薦めします。詳細は、『Oracle Application Server Reports ServicesレポートWeb公開ガイド』の「拡張配布の作成」の章を参照してください。このマニュアルは、Oracle Technology NetworkのOracle Reportsドキュメントのページ（http://www.oracle.com/technology/documentation/reports.html）から入手できます。

コマンドラインでDSTファイルを指定した場合、定義される配布は、「配布」ダイアログ・ボックスを使用して定義した配布を上書きします。

注意
配布エラーを識別するためにレポートの配布をトレースした場合（第3.14.19項「レポートの配布のトレース」を参照）、トレース・ファイル形式はDSTファイルによく似ているため、トレース・ファイルから切取りと貼付けを行ってDSTファイルを作成できます。

DSTファイルの各行の形式は次のとおりです。

dist_ID: output_def

意味は次のとおりです。

dist_IDは、配布の宛先の識別子です。

output_defは、配布の宛先を指定する一連のrwrunコマンドライン・キーワードまたはrwclientコマンドライン・キーワードです。また、次のパラメータが有効です。

LEVELは、配布の有効範囲を指定します。

LEVELの値

REPORTは、配布がレポート全体に適用されることを示します。

Header_Sectionは、配布がヘッダー・セクションにのみ適用されることを示します。

Main_Sectionは、配布がメイン（本体）セクションにのみ適用されることを示します。

Trailer_Sectionは、配布がトレーラ・セクションにのみ適用されることを示します。

デフォルト

REPORT

例

次の例は、レポート出力をHTMLファイルに、メイン・セクションのコピー3部をプリンタに、ヘッダー・セクションをPDFファイルに送信するよう定義しています。

;dst file (specified with the DESTINATION keyword on the command line)
DEST1: DESNAME=testdst1.HTM DESTYPE=file
DESFORMAT=HTML COPIES=1 LEVEL=Report
DEST2: DESNAME=¥¥luna¥2op813 DESTYPE=printer
DESFORMAT=BITMAP COPIES=3
LEVEL=Main_Section
DEST3: DESNAME=SECTION1.pdf DESTYPE=file
DESFORMAT=pdf COPIES=1
LEVEL=Header_Section

2.8.4 Pluggable Destinationsについて

Pluggable Destinationsは、エンジン（Oracle Reports以外のエンジンも含む）によりReports Serverのキャッシュで作成されたコンテンツの配布に使用できます。Oracle Reportsには、あらかじめ次の宛先が用意されています。

Web
プリンタ
電子メール
ファイル
OracleAS Portal
FTP
WebDAV

Oracle Reports Java APIを使用して、独自の宛先へのアクセスを定義し、Reports Serverに新しい宛先コンポーネントを実装することもできます。既定の宛先と独自にカスタマイズした宛先のどちらを使用するかを選択し、キャッシュ内の出力の宛先を決定してください。

宛先クラスの実装と登録方法、およびOracle Reportsでの宛先の使用方法は、『Oracle FTP Destination tutorial』を参照してください。このマニュアルは、Oracle Technology Network（OTN）のOracle Reports 10gのページ（http://www.oracle.com/technology/products/reports/index.html）で「Plugin Exchange」をクリックすると「Oracle Reports Plugin Exchange」から入手できます。

注意
現在、Reports Builder環境からのFTPやWebDAVの宛先に対するサポートはありません。ただし、これらの宛先は、Reports RuntimeおよびReports Serverの環境からはサポートされています。

2.8.5 イベント・ドリブンの公開について

イベント・ドリブンの公開を使用すると、特定のアクションが実行されたときにレポートを実行するように設定できます。たとえば、従業員が経費レポートを送信すると、データベースに新しいデータが挿入されます。このような挿入イベント（たとえば、データベース・トリガーまたはアドバンスト・キューイング（AQ）メッセージなど）が発生すると、レポートはポータル・ページまたは電子メールによって従業員の管理者に送られ、この経費レポートを承認/拒否するように通知します。

Oracle Reports 10g（9.0.4）では、イベント・ドリブンの公開機能が強化され、レポート・オブジェクトがOracle Workflow内で使用可能になっています。

詳細は、『Oracle Application Server Reports ServicesレポートWeb公開ガイド』のイベント・ドリブンの公開の使用方法に関する項を参照してください。このマニュアルは、Oracle Technology NetworkのOracle Reportsドキュメントのページ（http://www.oracle.com/technology/documentation/reports.html）から入手できます。

2.8.6 プリンタ・トレーの切替えについて

Before Reportトリガー、Between Pagesトリガーまたはフォーマット・トリガーを使用して、レポートのフォーマット時とは異なるプリンタ・トレーに切り替えることができます。これにより、同じレポートのページを簡単に別の用紙に印刷できます（レターヘッド、各種フォーム、カラー用紙など）。

プリンタに定義されたプリンタ・トレーの名前は、「ページ設定」ダイアログ・ボックスで判断できます。次に、SRW.SET_PRINTER_TRAYを使用して、必要なプリンタ・トレーを設定します。

2.8.7 レポートのXMLについて

Oracle Reportsでは、次のような方法でExtensible Markup Language（XML）を使用します。

XMLタグを使用して、Webベースのレポートを定義します（Oracle Reportsオンライン・ヘルプの「リファレンス」の項のトピック「Oracle Reports XMLタグ」を参照）。
XMLは、タグで区切られた構造化情報を定義するのに使用します。
XMLは、サポートされたPDS（プラッガブル・データ・ソース）です。詳細は、第44章「XMLプラッガブル・データ・ソースを使用したレポートの作成」を参照してください。

XMLは、多くの異なるアプリケーションで読み込むことができるエンコーディング・テキスト・フォーマットの形式です。XMLタグは、情報を出力するために使用するか、またはサードパーティ製アプリケーションと電子データを交換（EDI）するプラッガブル・データ・ソースを構築するベースとして使用します。

レポートのXML出力を制御するXMLプロパティは、レポート、グループおよび列という3つのレベルで変更できます。Reports Builderで生成されたXMLファイルでは、その出力は、グループと列で構造化されたデータ・モデルを擬似実行します。XML出力の変更を表示する方法は、第3.7.7項「XML出力の生成」を参照してください。

レポートの配布でのXMLの使用、およびXMLを使用したレポートのカスタマイズの詳細は、『Oracle Application Server Reports ServicesレポートWeb公開ガイド』の「拡張配布の作成」と「XMLによるレポートのカスタマイズ」の章を参照してください。このマニュアルは、Oracle Technology NetworkのOracle Reportsドキュメントのページ（http://www.oracle.com/technology/documentation/reports.html）から入手できます。

2.8.8 HTMLおよびHTMLCSS出力について

Reports Builderでは、レポート出力を、フォーマットされたデータとすべてのオブジェクトを含むHypertext Markup Language（HTML）ファイルおよびカスケード・スタイル・シートのHypertext Markup Language（HTMLCSS）ファイルに生成できます。HTMLは、Microsoft Front Pageなどの多くの異なるWebページ開発ソフトウェア・パッケージやWebブラウザで読み込むことができるエンコーディング・テキスト・フォーマットの形式です。ソフトウェアの編集およびグラフィック機能を使用して、レポート出力を変更および拡張できます。レポート出力をHTMLまたはHTMLCSSファイルに生成する場合、その出力を電子メール、プリンタ、OracleAS PortalおよびWebブラウザなどの、任意のHTML宛先に配布できます。

注意
このトピックでは、ペーパーベースのレポートをHTMLファイルまたはHTMLCSSファイルに実行したときに生成されるHTMLについて説明しています。これらは、JSPベースのWebレポートを実行（ツールバーの「Webレイアウトを実行」ボタンをクリックまたは「プログラム」→「Webレイアウトを実行」を選択）したときに生成されるHTMLとは関係ありません。

使用に関する注意

10gリリース2（10.1.2）ではHTMLCSS拡張機能が導入されています。これには、次の新しいプロパティを使用してHTMLCSS出力用にスタイル・シートおよびユーザー定義のスタイルをレポートまたはレポート・オブジェクトに適用する機能が含まれています。
- 「スタイル・シート」プロパティ
- 「CSSクラス名」プロパティ
- 「CSS ID」プロパティ
Oracle Reports 10gリリース2（10.1.2）の新機能には、Oracle Reportsでサポートされているすべてのビットマップ出力（PDF、RTF、HTML、HTMLCSSおよびPostScriptを含む）でのHTMLフォーマットのサポートもあります。詳細は、第2.8.9項「HTMLフォーマットについて」を参照してください。

Oracle Reports 10gリリース2（10.1.2）から、HTMLおよびHTMLCSS出力ではHTML 4.01構文チェッカが渡されます。

注意
レポートの「レポート前値」プロパティまたは「レポート後値」プロパティを変更する場合は、有効なHTMLを指定する必要があります。HTMLが無効な場合、生成されたHTMLレポート出力でHTML 4.01構文チェッカが渡されないことがあります。

WebブラウザでHTMLまたはHTMLCSS形式のレポート出力をプレビューするには、「ファイル」→「プレビュー・フォーマット」を選択し、「ページ番号付きHTML」または「ページ番号付きHTMLCSS」を選択します。
ブックマークがある場合は、複数のHTMLファイルが作成されます。この場合、2つのフレームを持つマスター・ファイルが1つ作成されます。1つのフレームはブックマーク用で、もう1つはレポート出力用です。これらのフレームのそれぞれに、1つのHTMLファイルが作成されます。マスター・ドキュメントのファイル名は、DESNAMEパラメータで指定した名前になります。ブックマークのファイル名は、desnameb.htmです。レポート出力のファイル名は、desnamed.htmです。
レポート内にリンクされたイメージ、イメージ・フィールドおよびグラフがある場合は、GIFファイルが作成されHTMLドキュメントから参照されます。リンクされたボイラープレートまたはイメージ・フィールドが外部のGIFファイルを参照している場合でも、新しいGIFファイルが作成される点に注意してください。
イメージがデータベースに格納されている場合は、レポート内にイメージが出現するたびに、新しいGIFファイルが作成される場合があります。イメージがファイルに格納されている場合は（たとえば、インポートしたイメージ、リンクされたボイラープレートまたはファイルを参照するイメージ・フィールド）、レポート内でのイメージの出現回数に関係なく、1つのイメージに対して1つのGIFファイルが作成されます。
HTML出力用に生成されるすべてのGIFイメージには、一連の番号が付けられます（たとえば、desname0.gif... desname17.gif）。
マスター・ドキュメントのコメント・ブロックには、マスター・ドキュメントに関連付けられているすべてのファイル名が含まれます。

HTMLには、7種類のテキスト・サイズがあります。レポート内のフォント・サイズは次の表に従ってマッピングされます。ユーザーは、HTMLファイルで指定されているサイズをブラウザから変更できます。

表2-1 レポートとHTMLのフォント・サイズ

レポートのフォント・サイズ	HTMLのフォント・サイズ
7以下	1
8～9	2
10～12	3
13～15	4
16～20	5
21～30	6
31以上	7

注意
レポートに使用されているフォントがプロポーショナル・フォントでない場合は、生成されたHTMLファイルでTeleTypeモードが有効になります。

HTMLにはページの概念がありません。レポートの各ページの区切りには、セパレータ線が挿入されます。ブラウザによっては、レポート・ページ全体を表示する際にスクロールが必要になることもあります。また、HTMLドキュメントをブラウザから印刷する場合、各ページの最下部にセパレータ線が印刷されないこともあります。セパレータ線が必要ない場合、または別のセパレータ線を使用する場合は、SRW.SET_AFTER_PAGE_HTMLを使用して変更できます。
HTMLCSSの場合、グラフィックとテキストがオーバーラップできます。
レポートをHTMLファイルまたはHTMLCSSファイルに出力すると、データ・モデルとループ・タグが削除され、データに置き換わります。Reorts BuilderでHTMLファイルまたはHTMLCSSファイルを開くことはできますが、レポートではなく、静的なテキスト・ファイルになります。
HTML出力およびHTMLCSS出力のページ番号付けの詳細は、第2.8.8.1項「HTMLページ・ストリーミングについて」を参照してください。

制限

オブジェクトは、相互にオーバーラップできません。たとえば、イメージの上にテキストを配置することはできません。
- オブジェクトがわずか（2文字以下）でもオーバーラップする場合は、オーバーラップを回避するために下側のオブジェクトが切り捨てられます。
- オブジェクトが大幅にオーバーラップする場合（またはオブジェクトが重なっている場合）は、下側のオブジェクトが完全に削除されます。この場合、削除されたオブジェクトにリンクされている情報は、枠と同じルールを使用して転送されます（次の枠に関するルールを参照）。
- テキストは、水平線がその上にある場合でも常に線より優先されます。これにより、ラベル・テキストが列ラベルの下にある線で排除されなくなります。
複数の出力ファイルが生成されるとき（ブックマークが使用されるときなど）は、マスター・ファイル以外のすべてのファイルが確認なしで上書きされます。たとえば、GIFファイルとブックマーク・ファイルは確認なしで上書きされます。
レポートの枠は、HTML出力では可視的に表示されません。枠の塗りつぶし属性または境界線属性は、HTML出力には表示されません。
レポート内の枠がリンクまたはブックマークの参照先の場合、HTML出力では、その属性が枠の左上隅に最も近い視覚的なオブジェクトに転送されます。枠オブジェクトがハイパーリンクの場合、その属性は、ハイパーリンクでないすべての子（内部）オブジェクトに転送されます。ハイパーリンク属性が子オブジェクトに転送できない場合、枠のハイパーリンクは失われます。
HTMLでサポートされている描画オブジェクトは黒の実線の水平線のみです。レポートで指定した線幅は、ブラウザに依存します。レポート・レイアウトの他のすべての描画オブジェクト（四角形や円など）は、HTML出力に表示されません。こうした描画オブジェクトの領域はそのまま残りますが、HTML出力には何も表示されません。
テキストのバックグラウンド（塗りつぶし）と境界線（線）のカラーおよびパターンは、HTMLでは使用できません。太字、イタリック、下線およびフォアグラウンド（テキスト）カラーは、ブラウザがそれらをサポートしていればサポートされます。
PDFアクション属性は、HTML出力では無視されます。
ブラウザをカスタマイズすると、生成されるHTMLの表示に影響します。

2.8.8.1 HTMLページ・ストリーミングについて

HTMLページ・ストリーミングを使用すると、レポート全体をダウンロードしなくても、HTML/HTMLCSSレポート出力のページを個別にWebブラウザに表示できます。レポートの第1ページから、残りのレポートの任意のページにナビゲートできます。ブックマークまたはハイパーリンクで宛先をクリックした場合、次のように処理されます。

レポート内で、現在のページを含むフレームが、宛先ページで更新されます。
レポート外で、（ブックマーク・フレーム、ページおよびナビゲーション・フレームを含む）ベースになっているフレーム全体がリロードされます。

ナビゲーション・コントロール

次のいずれかの方法で、レポートのナビゲーション・コントロール・スクリプトを指定できます。

PL/SQLを使用します（Before ReportトリガーのSRW.SET_PAGE_NAVIGATION_HTML）。
レポート・プロパティ・インスペクタで、「ページ・ナビゲーション・コントロール・タイプ」プロパティおよび「ページ・ナビゲーション・コントロール値」プロパティを使用して指定します。

出力ファイル名

HTMLページ・ストリーミングでは、各ページが個別のHTMLドキュメントとして書式設定されます。HTMLファイルの名前がmyreport.htmで、ブックマークがない場合、新しいファイルには次のような名前が付けられます。

myreport.htm（ベースになるフレーム）
myreportb.htm（ブックマーク・ファイル。ブックマークをHTMLファイルで使用している場合のみ）
myreport_1.htm～myreport_n.htm（ページ）
myreportj.htm（ナビゲーションJavaScript）

HTML出力の有効範囲

レポートの最初（ヘッダー）または最後（フッター）のページにのみ表示されるHTMLを指定するには、「Before Report」プロパティまたは「After Report」プロパティを設定するか、SRW.SET_BEFORE_REPORT_HTMLまたはSRW.SET_AFTER_REPORT_HTML PL/SQLプロシージャを使用します。バックグラウンド・カラーやイメージなど、グローバルHTMLをレポート全体に適用するように指定するには、「ページ前」プロパティまたはSRW.SET_BEFORE_PAGE_HTML PL/SQLプロシージャを設定します。Reports Builderで生成されたHTMLロゴは、レポートの最後のページにのみ表示されます。

ページ・ストリーミングされた出力の有効化

レポートをHTML出力またはHTMLCSS出力としてフォーマットするときにページ・ストリーミングを有効にするには、コマンドラインでPAGESTREAM=YESを指定する必要があります。このオプションは、Reports Builderユーザー・インタフェースでは設定できません。

2.8.9 HTMLフォーマットについて

Oracle Reportsでは、レポート内のテキスト・オブジェクトに様々なフォント、スタイルおよびカラーを指定できます。SRWビルトイン・プロシージャ（Oracle Reportsオンライン・ヘルプの「リファレンス」の項を参照）を使用すると、エンド・ユーザーが実行時にオブジェクト全体に対してテキスト属性を変更することはできますが、テキストのセクションごとに変更することはできません（テキスト・オブジェクトの部分ごとに別々のフォーマットを指定するなど）。以前のリリースでは、列にリッチ・テキスト・コンテンツが含まれていても（フォーマット命令がテキストに埋め込まれている場合など）、このフォーマットは解析されず、レポート出力に適用されませんでした。この制限は、HTMLタグを使用してフォーマットし、オブジェクトの「HTMLタグを含む」プロパティを「はい」に設定することによって対処できますが、こうして指定したフォーマットを表示できるのはHTML出力またはHTMLCSS出力のみでした。その他の出力フォーマット（PDF、RTF、PostScriptなど）で生成されたレポートでは、HTMLタグ自体が出力に表示されました。

Oracle Reports 10gリリース2（10.1.2）で導入されたテキスト・フォーマット拡張機能では、HTMLフォーマット・タグの定義済みのセットを使用してテキスト・スタイル（太字、イタリック、下線および取消し線）およびテキスト属性（フォント名、フォント・カラーおよびフォント・サイズ）をフォーマットし、オブジェクトの「HTMLタグを含む」プロパティを「はい」に設定すれば、Oracle Reportsでサポートされているすべてのビットマップ出力形式でフォーマット済のテキスト・オブジェクトを生成できます。

ボイラープレート・テキスト・オブジェクトにはスタティック値を指定し、フィールド・オブジェクトやテキスト・ファイル・リンク・オブジェクトには動的な値を指定できます。ボイラープレート・テキスト・オブジェクトでも、フィールド・オブジェクトやレポートレベルの列が参照先になっている場合は、動的な値を指定できます。ボイラープレート・テキストに関しては、設計時に指定された形式は、実行時に取得されるリッチ・テキスト形式とマージされます。この機能では、HTMLタグを含むマルチバイト・テキストもサポートされています。

ペーパー・デザイン・ビューまたはペーパー・レイアウト・ビューでは、「HTMLタグを含む」プロパティを「はい」に設定することにより、HTMLフォーマットを適用するオブジェクトを選択できます。CONTAINSHTMLTAGS=NOを使用して、コマンドラインからレポートを実行した場合、Oracle Reportsでは、オブジェクトの「HTMLタグを含む」プロパティの設定にかかわらず、レポートのHTMLタグが解析されません。HTML出力およびHTMLCSS出力では、ブラウザによってHTMLフォーマット・タグが解析されますが、その他の出力形式では、HTMLタグ自体がレポート出力にそのまま表示されます。

次のHTMLタグは、ボイラープレート・テキスト、テキスト・ファイル・リンクまたはフィールド・オブジェクトに表示されている場合にOracle Reportsで解析されます。記載されていないHTMLタグまたは属性は、HTML/HTMLCSS以外のレポート出力では、そのまま表示されます。

表2-2 サポートされているHTMLタグ

タグ結果

タグ	結果
`<b>` `<strong>`	このいずれかのタグで囲まれているテキストは太字になります。例: テキストが次のようにフォーマットされている場合: `<b>my format</b>` 出力は次のようになります。 my format
`<i>` `<em>`	このいずれかのタグで囲まれているテキストはイタリックになります。例: テキストが次のようにフォーマットされている場合: `<i>my format</i>` 出力は次のようになります。 my format
`<u>`	このタグで囲まれているテキストは下線付きになります。例: テキストが次のようにフォーマットされている場合: `<u>my format</u>` 出力は次のようになります。 my format
`<s>` `<strike>`	このいずれかのタグで囲まれているテキストは取消し線で消されます。例: テキストが次のようにフォーマットされている場合: `<s>my format</s>` 出力は、取消し線付きで表示されます。
`<span>`	フォント・ファミリ、サイズおよびカラーの属性を指定する汎用スタイル・コンテナ。詳細は表2-3を参照してください。例: `<span style="font-family:Times New Roman; font-size:10pt; color:rgb (255,0,0);">my format</span>` 出力は、Times New Romanフォントの10ポイント・サイズで赤色で表示されます。

このいずれかのタグで囲まれているテキストは太字になります。

例:

テキストが次のようにフォーマットされている場合:
my format

出力は次のようになります。
my format

このいずれかのタグで囲まれているテキストはイタリックになります。

例:

テキストが次のようにフォーマットされている場合:
my format

出力は次のようになります。
my format

このタグで囲まれているテキストは下線付きになります。

例:

テキストが次のようにフォーマットされている場合:
my format

出力は次のようになります。
my format

<s>

<strike>

このいずれかのタグで囲まれているテキストは取消し線で消されます。

例:

テキストが次のようにフォーマットされている場合:
<s>my format</s>

出力は、取消し線付きで表示されます。

フォント・ファミリ、サイズおよびカラーの属性を指定する汎用スタイル・コンテナ。詳細は表2-3を参照してください。

例:

my format

出力は、Times New Romanフォントの10ポイント・サイズで赤色で表示されます。

spanタグのstyle属性でサポートされているプロパティは次のとおりです。

表2-3 spanタグのstyle属性でサポートされているプロパティ

プロパティ 結果

プロパティ	結果
`font-family`	このプロパティではフォント名を指定します。Oracle Reportsで指定できるフォント名は1つだけです。カンマ区切りのリストで複数のフォント名を指定した場合、Oracle Reportsではシステムのデフォルト・フォント（通常はCourierかそれと同等のフォント）が使用され、警告が生成されることなくこのタグがレンダリングされます。例: `font-family: Arial`
`font-size`	このプロパティではフォントのサイズを指定します。 CSSレベル2では、このプロパティの次のオプションを指定します。 `absolute_size`\|`relative_size`\|`length`\|`percentage` Oracle Reportsでは、`absolute_size`および`length`のみを指定できます。前述のオプションの意味は次のとおりです。 `absolute-size`は次のとおりです。 `xx-small \| x-small \| small \| medium \| large \| x-large \| xx-large` `xx-small`: 7ポイント `x-small`: 8ポイント `small`: 10ポイント `medium`: 12ポイント `large`: 14ポイント `x-large`: 17ポイント `xx-large`: 20ポイント `length`は次のとおりです。 `font_size``px \|` `font_size``pt` 例: `font-size:xx-large font-size:12pt`
`カラー`	このプロパティでは、タグ内の要素のテキスト・コンテンツのカラーを指定します。 Oracle Reportsでは、このプロパティの次のオプションがサポートされています。 `color_name``\|#``rgb``\|#``rrggbb``\|rgb(``r_integer``,` `g_integer``,` `b_integer``)\|rgb(``r_value%``,` `g_value%``,` `b_value%)` カラー名とrgbは次のように対応しています。 aqua（淡緑青）: `#0FF` black（黒）: `#000` blue（青）: `#00F` fuchsia（紫紅）: `#F0F` gray（グレー）: `#7F7F7F` green（緑）: `#007F00` lime（黄緑）: `#0F0` maroon（葡萄茶）: `#7F0000` navy（紺）: `#00007F` olive（濃黄緑）: `#7F7F00` purple（紫）: `#7F007F` red（赤）: `#F00` silver（銀）: `#C0C0C0` teal（暗緑青）: `#007F7F` white（白）: `#FFF` yellow（黄）: `#FF0` 例: `color:aqua color:#FB0 color:#0FACED color:rgb(100, 245, 33) color:rgb(23%, 45%, 87%)` 注意: `rgb(x, x, x)`の指定では、カラー濃度をパーセンテージ（`0-100`）またはrgb整数（`0-255`）で指定する必要があります。指定可能な範囲を超える値を指定した場合は、最大値に設定されます。カラー濃度に負の値を指定すると無効になります。次のように、カラーのパーセント値とrgb整数値を混在させることができます。 `<span style="color:rgb(100%, 125, 3%)">` 前述の例は、次と同じです。 `<span style="color:rgb(255, 125, 8)">` または `<span style="color:rgb(100%, 49%, 3%)">`

font-family

このプロパティではフォント名を指定します。Oracle Reportsで指定できるフォント名は1つだけです。カンマ区切りのリストで複数のフォント名を指定した場合、Oracle Reportsではシステムのデフォルト・フォント（通常はCourierかそれと同等のフォント）が使用され、警告が生成されることなくこのタグがレンダリングされます。

例:

font-family: Arial

font-size

このプロパティではフォントのサイズを指定します。

CSSレベル2では、このプロパティの次のオプションを指定します。

absolute_size|relative_size|length|percentage

Oracle Reportsでは、absolute_sizeおよびlengthのみを指定できます。

前述のオプションの意味は次のとおりです。

xx-small: 7ポイント
x-small: 8ポイント
small: 10ポイント
medium: 12ポイント
large: 14ポイント
x-large: 17ポイント
xx-large: 20ポイント

lengthは次のとおりです。
font_sizepx | font_sizept

例:

font-size:xx-large font-size:12pt

カラー

このプロパティでは、タグ内の要素のテキスト・コンテンツのカラーを指定します。

Oracle Reportsでは、このプロパティの次のオプションがサポートされています。

color_name|#rgb|#rrggbb|rgb(r_integer, g_integer, b_integer)|rgb(r_value%, g_value%, b_value%)

カラー名とrgbは次のように対応しています。

aqua（淡緑青）: #0FF
black（黒）: #000
blue（青）: #00F
fuchsia（紫紅）: #F0F
gray（グレー）: #7F7F7F
green（緑）: #007F00
lime（黄緑）: #0F0
maroon（葡萄茶）: #7F0000
navy（紺）: #00007F
olive（濃黄緑）: #7F7F00
purple（紫）: #7F007F
red（赤）: #F00
silver（銀）: #C0C0C0
teal（暗緑青）: #007F7F
white（白）: #FFF
yellow（黄）: #FF0

例:

color:aqua color:#FB0 color:#0FACED color:rgb(100, 245, 33) color:rgb(23%, 45%, 87%)

注意: rgb(x, x, x)の指定では、カラー濃度をパーセンテージ（0-100）またはrgb整数（0-255）で指定する必要があります。指定可能な範囲を超える値を指定した場合は、最大値に設定されます。カラー濃度に負の値を指定すると無効になります。次のように、カラーのパーセント値とrgb整数値を混在させることができます。

前述の例は、次と同じです。


または


使用に関する注意

サポートされている出力形式は、PDF、RTF、HTML、HTMLCSSおよびPostScriptです。
HTMLフォーマットでは、タグのインタリーブおよびネストがサポートされています。たとえば、イタリックの開始タグを指定した場合、このフォーマットは対応する終了タグの位置まで適用されます。開始タグを複数指定した場合、適用範囲を終了するには、同じ数の終了タグを指定する必要があります。
フォーマット属性は、同じ名前またはタイプのテキスト・オブジェクトでも、インスタンス間で継承はされません（繰返し枠で囲まれている場合など）。ただし、複数行を含むテキスト・オブジェクトでは、このオブジェクト内でのみ、フォーマット命令が複数行で継承されます。
この機能では、ボイラープレート・テキスト・オブジェクトでハードコードまたは参照されているHTMLタグがサポートされています。タグは、フィールド・オブジェクトを含む表列からも取得できます。ファイル・リンク・オブジェクトも、ポイント先のテキスト・ファイルにHTMLタグが含まれている場合は、サポートされます。
Oracle Reportsでは、同じキャラクタ・セットのフォントに関して、次の条件に従って最も近い一致が検索されます。

フォント > フォント・サイズ > フォント・スタイル > フォントの太さ > フォントの幅

フォントが一致しない場合はフォント・サイズの一致を検索し、フォント・サイズが一致しない場合はフォント・スタイルの一致を検索し、以下同様に検索が行われます。フォント検索アルゴリズムの詳細は、『Oracle Application Server Reports ServicesレポートWeb公開ガイド』の「Oracle Reportsにおけるフォントの管理」の章を参照してください。このマニュアルは、Oracle Technology NetworkのOracle Reportsドキュメントのページ（http://www.oracle.com/technology/documentation/reports.html）から入手できます。フォント検索では、使用しているフォントに必要な属性（スタイル、サイズなど）の一部がデータに埋め込まれていない場合があります。その場合、使用できないフォント属性はレポート出力に表示されません。

制限

1つのタグは、全体を1行で指定する必要があります。次の行に続くタグはサポートされません。

例:

Myformat
spanタグのstyle属性font-familyプロパティで指定できるフォント名は1つだけです。

例:

font-family: Arial

カンマ区切りのリストで複数のフォント名を指定した場合、Oracle Reportsではシステムのデフォルト・フォント（通常はCourierかそれと同等のフォント）が使用され、警告が生成されることなくこのタグがレンダリングされます。
"などの要素はサポートされません。

例:

my format!

かわりに二重引用符（"）をそのまま使用する必要があります。

例

例1: インライン・フォント変更

ボイラープレート・テキスト・オブジェクトでは、テキスト・ボイラープレートを次のように指定できます。

Mytext

「HTMLタグを含む」プロパティを「はい」に設定すると、これは次のようなフォーマット出力になります。

My text

例2: 1行のテキストに複数のフォーマットの指定

次のような、1行でフォーマットされるテキストの範囲（ボイラープレート・オブジェクト内またはデータベース列内）があるとします。

My HTML Formats

「HTMLタグを含む」プロパティを「はい」に設定すると、これは次のようなフォーマット出力になります。

My HTML Formats

例3: 複数行のテキストに複数のフォーマットの指定

次のような、複数行でフォーマットされるテキストの範囲があるとします。

Line 1: My Line 2: HTML Line 3: Formatting.

「HTMLタグを含む」プロパティを「はい」に設定すると、これは次のようなフォーマット出力になります。

Line 1: My
Line 2: HTML
Line 3: Formatting.

前述の例で、複数の連続する行でフォーマットが維持されていることを確認してください。

2.8.10 PDF出力について

Reports Builderでは、レポート出力を、フォーマットされたデータとすべてのオブジェクトを含むPDFファイルに生成できます。レポート出力をPDFファイルに生成する場合、その出力を電子メール、プリンタ、OracleAS PortalおよびWebブラウザなどの、任意のPDFの宛先に配布できます。

PDF出力のドキュメントの分類（種別）は、「タイトル」、「作成者」、「件名」および「キーワード」のレポート・プロパティにより行われ、レポート・ドキュメントのカタログ化と検索に役立ちます。

フォントのサブ設定を使用すると、レポートを表示するマシンで該当するフォントが使用できるかどうかにかかわらず、PDFファイルのレンダリングに必要なフォント情報がPDFファイルに含まれます。PDFのフォントのサブ設定は、シングルバイト、マルチバイトおよびUnicodeのフォントでも機能するため、マルチバイト・レポートの作成に適しています。

Oracle Reports 10gリリース2（10.1.2）には、次のようなPDS出力の拡張機能が含まれています。

True Typeフォント（Type0フォントなど）を直接サブ設定可能で、Type3フォントへの変換は行われません。その結果、PDF出力がより明瞭で滑らかに表示され、検索やアクセスもしやすくなります。
True Type Collection（TTC）のサポートが改善され、ゼロベースの索引を使用して、特定のTTCフォント・ファイルを指定して選択できます。Oracle Reportsの以前のリリースでは、True Type Collection（TTC）内の最初のフォント・ファイルが選択されていました。

圧縮、フォントの別名の作成、フォントのサブ設定、フォントの埋込みとアクセス可能性を示すタグなど、Oracle ReportsにおけるPDFの拡張および各種機能の詳細は、『Oracle Application Server Reports ServicesレポートWeb公開ガイド』の「Oracle ReportsでのPDFの使用」の章を参照してください。このマニュアルは、Oracle Technology NetworkのOracle Reportsドキュメントのページ（http://www.oracle.com/technology/documentation/reports.html）から入手できます。

使用に関する注意

WebブラウザでPDFのレポート出力をプレビューするには、「ファイル」→「プレビュー・フォーマット」→「PDF」を選択します。
中国語や日本語などのマルチバイト言語でマルチバイト・レポートを作成していて、PDF出力のフォントに別名を付ける必要がある場合、Acrobat 4.0パック内で名前が付いたCIDフォントが必要になります。これ以外の場合は、Acrobat 4.0パックのCIDフォントは必要ありません。
Oracle Reportsでは、PDF出力用のWindows UDCはサポートされていません。印刷またはレンダリングするユーザー定義の文字では、絵文字はすべて1つのTTFまたはTTCファイルに含める必要があります。
グラフィックとテキストはオーバーラップできます。
オブジェクトのフォアグラウンド・カラーは、（指定したパターンには関係なく）塗りつぶしカラーとして使用されます。
次の条件を満たしている場合、PDFファイルを変更できます。
- レポートで使用しているフォントがマシンにインストールされている場合。
- PDFライターがある場合。

制限

PDF出力には、現在選択しているプリンタのビットマップ・ドライバ（PostScriptなど）が使用されます。

2.8.11 RTF出力について

Reports Builderでは、レポート出力を、フォーマットされたデータとすべてのオブジェクトを含むRich Text Format（RTF）ファイルに生成できます。RTFは、Microsoft Wordなどの多くの異なるワード・プロセッシング・ソフトウェア・パッケージで読み込むことができます。ソフトウェアの編集およびグラフィック機能を使用して、レポート出力を変更および拡張できます。レポート出力をRTFファイルに生成する場合、その出力を電子メール、プリンタ、OracleAS PortalおよびWebブラウザなどの、任意のRTFの宛先に配布できます。

使用に関する注意

グラフィックとテキストはオーバーラップできます。
テキストは、90度ずつ回転できます。

PDF出力の場合と同様に、オブジェクトのフォアグラウンド・カラーは、（指定したパターンには関係なく）塗りつぶしカラーとして使用されます。

注意
Office 95のMicrosoft Wordでレポートを表示する場合、レポート内のすべてのグラフィックとオブジェクトを表示するには、「表示」→「ページレイアウト」を選択する必要があります。

2.8.12 デリミタ付き出力について

Oracle Reportsでは、デリミタを含むレポート出力を、デリミタ付きファイル（カンマやタブで区切られたデータを含むファイルなど）に生成できます。これらのファイルは、簡単にスプレッドシートにインポートしたり、ワード・プロセッサで使用できます。

Oracle Reportsでデリミタ付き出力の生成には、次の2つのオプションがあります。

デリミタ付き: ペーパー・レイアウトを使用して出力を生成します。
DelimitedData（「デリミタ付き」を使用して大量のレポートを実行することに問題がある場合に使用）: ペーパー・レイアウトを考慮せず、データ・モデルから直接実行します（つまり、ペーパー・レイアウトに表示されるフィールドだけでなく、データ・モデルで使用可能なすべてのフィールドが出力に表示されます）。

次のいずれかの方法を使用して、レポート出力内のデータ（ボイラープレートまたはフィールド・オブジェクト）を区切るデリミタ（文字または文字列）を指定できます。

コマンドラインでDELIMITERキーワードを使用して指定します。
Reports Builderの「デリミタ付き出力」ダイアログ・ボックスまたは「DelimitedData出力」で指定します（「ファイル」→「ファイルへ出力」を選択し、「デリミタ付き」または「DelimitedData」を選択）。

注意
デリミタを指定しない場合のデフォルトのデリミタはタブです。

セルの囲みを使用してさらにセルを区別できます。セルの囲みは、カンマやカッコなどの一連の文字で構成されます。

たとえば、レポート出力のデータにデリミタと同じ文字（たとえば、カンマ）が含まれる場合、カッコをセルの囲みに使用して、それぞれのセルを区別できます。

(1,000,000),(3,6000),(543),(2,003,500)…

使用に関する注意

DelimitedData出力:

DelimitedData出力にレポートを生成すると、データのみ（レポート・データ・モデルで定義されているもの）が出力に表示されます。レイアウトで定義されているフォーマット変更は、DelimitedData出力では反映されません。

次の列プロパティを設定すると、DelimitedData出力ファイルで列名の変更や列の除外が可能です。

「XMLタグ」プロパティを使用すると列の別名を入力できます。
「XML出力から除外」プロパティを使用すると、DelimitedData出力から列を除外できます。

レポートのレイアウト情報を保持するレポート出力を生成するには、第2.8.13項「スプレッドシート出力について」を参照してください。

デリミタ付き出力:

デリミタ付き出力にレポートを生成した場合、データは、ペーパー・レイアウト・ビューのオブジェクトの位置に従って表示されます。

AをBの上または左に配置すると（AおよびBはボイラープレートまたはフィールド・オブジェクト）、Reports Builderでは、どの出力行でも、Aの各インスタンスがBの各インスタンスの前に表示されます。

図2-8 Bの上にAがある場合のデリミタ付き出力

 画像の説明
ボイラープレート・オブジェクト（A）を含む枠を作成し、フィールド・オブジェクト（B）を含む繰返し枠を囲んだ場合、Aの各インスタンスは、Bの各インスタンスとともに表示されます。

図2-9 繰返し枠を枠で囲んだ場合のデリミタ付き出力

 画像の説明
前述のレイアウトに、ボイラープレート・オブジェクト（C）を含む別の枠を追加し、フィールド・オブジェクト（D）を含む別の繰返し枠を囲んだ場合、BのすべてのインスタンスにAが表示され、DのすべてのインスタンスにCが表示されます。

図2-10 繰返し枠を2つの枠で囲んだ場合のデリミタ付き出力

 画像の説明
レポートでマトリックスを作成する場合、レイアウト・モデル・ビューの格子に基づいて正確にオブジェクトの位置を整列させます。オブジェクトの位置が整列していないと、Reports Builderでは、余分なスペースを別の行や列と解釈して、レポート出力に支障をきたす場合があります。
マトリックスの外にボイラープレート・オブジェクトを作成する場合、ボイラープレートの各インスタンスがマトリックスのすべての行（列ではない）に繰り返されます。マトリックスに含まれるボイラープレートは、マトリックスの外のフィールド・オブジェクトには繰り返されません。

図2-11 マトリックスの外にボイラープレートがある場合のデリミタ付き出力

 画像の説明

制限

テキスト・ファイルの最初のフィールドがID（大文字）というラベルのフィールドである場合、Microsoft Excelでそのファイルを開くことができません。次のようなデリミタ付き出力は、Excelでのエラーの原因になります。

ID, name, title, dept

IDフィールドが含まれるデリミタ付き出力を生成する場合は、データベース列名を小文字に変更するか（つまり、id）、フィールドの順序を並べ替えてください。
配布と一括処理は、デリミタ付き出力ではサポートされていません。DELIMITED出力フォーマットまたはDELIMITEDATA出力フォーマットは、distribution.xmlファイルや「配布」ダイアログ・ボックスでは指定できません。

2.8.13 スプレッドシート出力について

10gリリース2（10.1.2）からOracle Reportsに導入されている新しい出力フォーマットを使用すると、ペーパー・レイアウト・レポートからHTMLファイルへ出力を生成し、Microsoft Excel 2000で直接開くことができます。新しいDESFORMAT=SPREADSHEETを使用すると、次のことが可能です。

どんな形式（.rdf、.xml、.jsp）で保存されている既存のペーパー・レイアウト・レポートからでも、rwrunまたはReports Serverクライアント（rwcgi、rwclient、rwservlet）を使用して、レポート出力をスプレッドシート形式に生成できます。次の例を参照してください。

カラー、フォント、条件付き書式、グラフ、イメージなどのリッチ・レイアウト・フォーマットが保持されます。

注意
DESFORMAT=SPREADSHEETの動作は、rw:include JSPタグの機能と同じです。スプレッドシート出力にはページ番号が付けられません。ページ設定情報が出力に書き込まれないため、単一のワークシートとしてフォーマットされます。スプレッドシート出力はレイアウトによって決まります。レポート出力には、ペーパー・レイアウトの各セクション（ヘッダー、メイン、トレーラ」）の本体領域にあるオブジェクトが表示され、マージン、ヘッダーまたはフッターの領域にあるコンテンツはフォーマットされません。

前提条件

Microsoft Excel 2000（出力を表示するクライアント・マシン上）。このソフトウェアは、OracleAS Reports Serverを実行しているマシン上には必要ありません。

使用に関する注意

出力ワークシートの名前を変更するには、レポートの「タイトル」プロパティを設定します。
スプレッドシート出力に生成できるのはビットマップ・レポートのみです。キャラクタ・モードのレポートをスプレッドシート出力に生成することはできません。
スプレッドシート出力では次のペーパー・レイアウト・オブジェクトがサポートされています。
- テキスト（ボイラープレートおよびフィールド）
- 任意の形式のイメージ（インポートまたはリンクされているイメージ、データベースに格納されているイメージを含む）
- インポートした描画、およびCGMとOWFの描画
- グラフィック線
グラフィック円弧、多角形、四角形、丸い四角形、延長可能な線およびOLE外部オブジェクト（Oracle9i Reports（9.0.2）より前のリリースで開発されたレポートの場合）のペーパー・レイアウト・オブジェクトは、スプレッドシート出力ではサポートされていません。こうした描画オブジェクトの領域はそのまま残りますが、出力には何も表示されません。この制限は水平線には適用されません。
スプレッドシート出力では、サイズ、フォント、カラー、スタイル（イタリック、斜線、下線、打消し線、アウトライン、影）、太さ（太、標準、極太、超極太）のフォント属性がサポートされています。
スプレッドシート出力では、次のWebレポート・プロパティがサポートされています。
- 「ハイパーリンク」プロパティ
- 「ハイパーリンクの宛先」プロパティ
- 「追加属性(HTML)」プロパティ（パラメータ・フォーム・フィールド）
- 「表属性(HTML)」プロパティ（枠および繰返し枠）
- 「代替テキスト」プロパティ（イメージ）
- 「HTMLタグを含む」プロパティ（HTMLタグを含むボイラープレート・テキスト・オブジェクトまたはフィールド・オブジェクト）
スプレッドシート出力では次のレポート分類プロパティがサポートされています。
- 「タイトル」プロパティ
- 「作成者」プロパティ
- 「件名」プロパティ
- 「キーワード」プロパティ
スプレッドシート出力に埋め込まれるグラフは静的イメージ・ファイルであり、対話型ではありません。したがって、「グラフ・ハイパーリンク」プロパティは、スプレッドシート出力ではサポートされていません。
グローバリゼーションがサポートされるレポートでは、directionおよびcharsetのメタデータをレポート前値で指定する必要があります。これは、この情報が生成後の出力にデフォルトでは書き込まれないためです。たとえば、レポート前値は次のように定義できます。
```
<html>
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=&encoding">
<body dir=&Direction bgcolor="#ffffff">
```
ペーパー・レイアウトで定義されている枠および繰返し枠は、出力では表に変換されます。cellspacing、cellpaddingおよびwidthなどの表属性は、枠および繰返し枠の「表属性(HTML)」プロパティを使用して指定できます。
スプレッドシート出力のフォーマットを確実にするために、レイアウト領域全体を枠で囲んでください。これによって、複数のオブジェクトで、あるオブジェクトが別のオブジェクトの下にあるように平行して異なる垂直位置に表示されることがなくなります。
レポート・セクション（ヘッダー、メイン、トレーラ）の順序は、スプレッドシート出力で保持されます。つまり、ヘッダー・セクション出力が最初に表示され、続いてメイン・セクション、トレーラ・セクションの順に表示されます。
ボイラープレート・オブジェクトまたはフィールドが互いに連続していない場合、つまり、境界の間にギャップがある場合は、スプレッドシート出力に空のセルが存在することがあります。
レポート設計時には、Oracle Reportsカラー・パレットが使用されます。レポート出力をスプレッドシート出力に生成すると、Microsoft Excelのカラー・パレットにある、最も近いカラーが表示されます。
ペーパー・レイアウトでボイラープレート・オブジェクトを回転させても、スプレッドシート出力では水平に表示されます。
背景パターン、線カラーおよび線パターンのセル・プロパティは、スプレッドシート出力ではサポートされていません。
レポートのペーパー・レイアウトに含まれるイメージは、Reports Serverが非セキュア・モードで実行されている場合にのみ、スプレッドシート出力に表示されます。セキュアなReports Serverの場合、イメージはスプレッドシート出力に表示されません。これは、出力でイメージを生成する際に、Reports Serverに対して複数回コールを行う必要があるためです（イメージ1つにつき1コール）。ユーザーが認証されると、Oracle Reportsでは、ブラウザとセキュアなReports Serverとの間で、Cookieを使用してユーザーのIDが渡されます。ただし、ExcelではCookieがサポートされていません。その結果、セキュアなReports Serverに対するコールは、認証されていないユーザーからのコールのように見えます。したがって、Reports Serverでイメージを渡す処理が拒否されます。回避策として、WebDAVを使用すると、セキュアなReports ServerからURLにスプレッドシート出力を生成できます。
サマリー列および式列は、動的なExcel式としてではなく、値として表示されます。また、Excelにはページの概念がないため、ページレベルのサマリー列はレポートレベルのサマリー列になります。
枠の「垂直拡張度」プロパティを「固定」に設定すると、Excelの出力には、ペーパー出力の最初のページに表示可能な数のレコードのみが表示されます。Excelにはページの概念がないため、残りの行を次のページにオーバーフローさせることはできません。
スプレッドシート出力にはページ番号が付けられないため、レポート前値とレポート後値のみがサポートされています（第2.2.10項「前および後のエスケープについて」を参照）。
レポート後値では、本体の外にHTMLコマンドを追加しても、レポートをスプレッドシート出力に生成したときに反映されません。これは、出力でHTMLコマンドが適切に指定されている場合でも同様です。次に例を示します。

</body><table><tr><td> the text to be bolded </td><tr></table></html>

本文終了タグの前にHTMLコマンドを追加すると、レポートをスプレッドシート出力に生成したときに正常に反映されます。次に例を示します。

<table><tr><td> the text to be bolded </td><tr></table></body></html>
スプレッドシート形式は、rwservletコマンドやrwcgiコマンド（SHOWJOBSなど）でサポートされています。また、Enterprise Managerのジョブ・キューおよびOracle Portalのアクセス・オブジェクト定義でもサポートされています。

制限

スプレッドシート出力は、Reports Builderから直接生成することはできません。かわりに、コマンドラインで、rwrunまたはReports Serverクライアント（rwcgi、rwclient、rwservlet）とDESFORMAT=SPREADSHEETを使用してレポートを実行できます。DESFORMAT=SPREADSHEETを、システム・パラメータ値としてレポート定義（.rdfファイル）に格納することはできません。
配布と一括処理は、スプレッドシート出力ではサポートされていません。SPREADSHEET出力フォーマットは、distribution.xmlファイルや「配布」ダイアログ・ボックスでは指定できません。

例

URLを使用してレポートのペーパー・レイアウトをMicrosoft Excel出力に生成するには（rwservletを使用）、次の内容を含むコマンドをコマンドラインに入力します。

http://hostname:port/reports/rwservlet?report=report_name
  +server=server_name+userid=db_connect_string+destype=file
  +desformat=spreadsheet+desname=C:¥temp¥myexcel_output.htm

注意
Microsoft Office 2000/2002/2003では、Hypertext Markup Language（HTML）はネイティブのファイル形式としてサポートされています。スプレッドシート出力はHTML出力の生成に依存しているため、有効なExcelフォーマットとしてMicrosoft Excelで認識できます。

スプレッドシート出力生成のその他の機能

新しいスプレッドシート出力機能に加えて、Oracle Reports 10gリリース2（10.1.2）より前のリリースで実装される次の方法でも、スプレッドシート出力を生成できます。

レポートをデリミタ付き出力に生成: 第3.7.10項「デリミタ付き出力の生成」を参照してください。

長所: デリミタ付き出力は、どんな形式（.rdf、.xml、.jsp）で保存されている既存のペーパー・レイアウト・レポートからでも、Reports Builderから直接、またはコマンドラインからレポートを実行して生成できます。

短所: データのみ（レポート・データ・モデルで定義されているもの）が出力に表示され、レイアウト情報は表示されません。
OC4JでReports Serverを使用してレポートを配布し、Webブラウザ内でMicrosoft Excelに表示: 次のいずれかの方法を使用します。
- 既存のペーパー・レイアウトがない場合: Reports BuilderでExcel HTMLテンプレート・ファイルを開き、データを追加して、レポートをJSPファイルとして保存して、レポートを配布します。この方法では、JSPコーディングを使用して、動的なExcel式（レポートのサマリー列および式列のスタティック値だけでなく）、動的なグラフ（静的なレポート・グラフ・イメージだけでなく）を含めることができます。この方法の実装手順の詳細は、Oracle Technology Network（OTN）の例を参照してください。OTNのOracle Reports 10gのページ（http://www.oracle.com/technology/products/reports/index.html）で、「Getting Started」をクリックして「Getting Started with Oracle Reports」ホームページを表示します。左側にあるトピックのリストの中から「Index」をクリックします。「Collateral Type」リストで、「Demonstrations」を選択し、「Search」をクリックします。表示されたリストから、「Generating Excel Output with Oracle Reports」をクリックします。
- 既存のペーパー・レイアウトがない場合: ペーパー・レイアウト・レポートから、Webソース・ビューを編集し、rw:includeタグを追加してペーパー・レイアウトのグループ枠をJSPコードとしてWebソース・ビューに含め、レポートをJSPファイルとして保存して、レポートを配布します。この方法を実装する手順の詳細は、第29章「スプレッドシート出力のレポートの作成」を参照してください。
長所: カラーやフォントなどのフォーマットを使用して、データだけでなくレポート・レイアウトを、Webブラウザ内にMicrosoft Excel出力で生成できます。

短所: Excelで出力するには、カスタムJSPコーディングを追加する必要があります。レポートはJSPエンジンでのみ実行でき、rwservletでは実行できません。したがって、この方法では、Microsoft Excel出力はWebブラウザ内のみで表示できます。

2.8.14 テキスト出力について

Reports Builderでは、レポート出力を、フォーマットされたデータとすべてのオブジェクトを含むテキスト・ファイルに生成できます。レポート出力をテキストに生成し、その実行モードがキャラクタである場合（MODE=CHARACTER、またはMODEシステム・パラメータの「初期値」プロパティが「キャラクタ」に設定されている場合）、その結果は純粋なテキスト出力となり、様々なアプリケーションで読み取ることができます。実行モードがビットマップの場合（MODE=BITMAP、またはMODEシステム・パラメータの「初期値」プロパティが「ビットマップ」に設定されている場合）、その結果はPostScript出力となり、PostScript対応のアプリケーション（PostScriptプリンタなど）でのみ、読み取ったり、レンダリングしたりできます。

2.8.15 ASCII（キャラクタ・モード）レポートの作成について

キャラクタ・モードのレポートを作成するには、まずビットマップ・レポートを作成してから、そのレポートをASCII（キャラクタ・モード）レポートに変換します。この処理では、キャラクタ・モード・バージョンのビットマップ・レポートが新たに作成され、元のビットマップ・レポートはそのまま変更されません。

変換後、フィールドおよびテキスト・オブジェクトの多くをサイズ変更する必要があります。また、イメージや描画などのグラフィック・オブジェクトは、キャラクタ・モードのレポートには含まれません。次に、各出力フォーマットでサポートされているアイテムをまとめます。

表2-4 ビットマップおよびキャラクタ・モードのレポートでサポートされるアイテム

ビットマップ	キャラクタ・モード
イメージ	ボックス
カラー	水平線
描画	垂直線
楕円/円	ASCIIテキスト
イタリック・テキスト	太字テキスト
対角線	下線
ビットマップ・パターン
マルチメディア・オブジェクト

2.9 データ・ソース

Oracle Reportsでは、様々なデータ・ソースにアクセスできます。第3.15.2項「Oracle以外のデータ・ソースへのアクセス」を参照してください。

この項の各トピックでは、Reports Builderで他のデータ・ソースにアクセスする場合の情報を説明します。

2.9.1 データベース・ロールについて

データベース・ロールによって、エンド・ユーザーはアクセス権限を持たない表に問合せを行うレポートを実行できるようになります。たとえば、最終的なレポートには表示されなくても、給与データなどの機密情報が含まれた表にレポートが問合せを実行する場合があります。

データベース・ロールは、ランタイム環境でのみチェックされます。特別なアクセス権限を必要とする表の場合、このような権限を持たないエンド・ユーザーは、その表からデータを取り出すレポートを実行できません。しかし、レポートにデータベース・ロールを定義しておくと、そのロールの権限を持つエンド・ユーザーは、Reports Runtimeを使用してレポートを実行できます（rwrun）。

注意
データベース・ロールが定義されたレポートを実行するには、エンド・ユーザーが、.repファイルではなく.rdfファイルを実行する必要があります。複数のレポートを実行する場合、Reports Runtimeでは自動的に、現行のレポートに定義されたロールに切り替えられます。

データベース・ロールが定義されたレポートをReports Builderで開こうとすると、ロール・パスワードを入力するように求められます。一般に、この情報を所有しているのは、レポートの作成者とDBAのみです。

2.9.2 Oracle Net Servicesについて

Oracle Net Servicesは、Oracleのリモート・データ・アクセス・ソフトウェアで、任意のネットワークでクライアントとサーバー間およびサーバー間の通信を可能にします。分散処理と分散データベースの機能がサポートされます。Oracle Net Servicesは、多くの通信プロトコルで実行され、これらを相互接続します。Oracle Net Servicesは、Net8およびSQL*Netと下位互換性があります。

2.9.3 ユーザー・イグジットについて

以前のリリースでは、ユーザー・イグジットを使用して、Reports Builderからユーザーが記述したプログラムに制御を渡し、そこで何らかの機能を実行して、制御を再びReports Builderに戻しました。オペレーティング・システムのテキスト・ファイルからReports Builderにデータを渡したり、LONG RAWデータを操作したり、PL/SQLブロックをサポートしたり、プリンタやロボットなどのリアルタイム・デバイスを制御したりする複雑なデータ操作を実行するには、ORACLE Precompilerユーザー・イグジット、ORACLE Call Interface（OCI）ユーザー・イグジットまたは非ORACLEユーザー・イグジットを記述する必要がありました。

このリリースでは、ORA_JAVAビルトイン・パッケージとJava Importerを使用して、Javaメソッドをコールできます。これによってレポートでのユーザー・イグジットの必要性が軽減され、さらにオープンでポータブルな配置が可能になります。また、ORA_FFIビルトイン・パッケージを使用することもできます。これにより、ダイナミック・ライブラリにあるC関数をコールするための外部関数インタフェースを使用できます。これらの新しいビルトイン・パッケージが使用可能になったことにより、Oracle Reportsでは、ユーザー・イグジットの使用が推奨されなくなりました。ただし、既存のユーザー・イグジットを継続して使用できるように、現在でもメイクファイルは提供されています。

2.9.4 Oracle Call Interface（OCI）について

以前のリリースでは、Oracle Call Interface（OCI）により、Oracle Reportsの実行可能ファイルをコールするために、各自の3GLプログラムでコールする一連の標準プロシージャが提供されました。これらのCで書かれたプロシージャは、Reports Builder、Reports RuntimeおよびReports Converterの各実行可能ファイルに付属しています。そのため、たとえば、Pro*FORTRANプログラムからReports Builderレポートを実行するには、Reports Runtimeの実行可能ファイルを使用して、各自のプログラムにRWCRRBプロシージャのコールを追加し、レポートを実行していました。

このリリースでは、OCIが廃止されています。かわりに、rwclientコマンドライン・インタフェースまたはJSPタグ・ライブラリを使用します。

2.10 デバッグ・ツール

この項の各トピックでは、Reports Builderのデバッグ・レポートについて説明します。

2.10.1 デバッグ・プロセスについて

アプリケーションのデバッグは、アプリケーション・エラーを識別し、修正する反復プロセスです。一般に、アプリケーションのデバッグを適切に行うには、誤りのあるコードを素早く識別し、特定することが不可欠です。

2.10.2 PL/SQLインタプリタについて

PL/SQLインタプリタは、デバッグの作業領域で、ソース・コードを表示し、デバッグ・アクションを作成し、プログラム・ユニットを実行し、インタプリタ・コマンド、PL/SQLおよびSQL文を実行できます。

PL/SQLインタプリタでは、デフォルトで、2つのペイン（「ソース」ペインと「インタプリタ」ペイン）が常に開いています。

次のようなデバッグ機能があります。

直接操作のデバッグ: 表示されたソース・テキストを直接操作して、デバッグ・アクションを挿入し、プログラム・データを検査します。
動的実行のフィードバック: Reports Builderでは、プログラムの実行がデバッグ・アクションによって中断した場合、またはプログラムのステップ実行中に段階的に進められた場合に、現在のPL/SQLソースの位置を自動的に表示し、追跡します。
中断されたプログラム状態の参照: 実行が中断されると、現在のスタックを参照し、変数の状態を参照および変更し、任意のPL/SQL文を実行できます。すべての情報にはシンボリックに（つまり、アドレスや番号ではなく、名前で）アクセスします。

2.10.3 「ソース」ペインについて

PL/SQLインタプリタの「ソース」ペインには、現在「オブジェクト・ナビゲータ」ペインで選択されているプログラム・ユニットの読取り専用コピーが表示されます。

左側のマージンにある番号は、表示されているプログラム・ユニットの行番号に対応します。

また、マージンには、次に示す記号が表示されることもあります。

表2-5 「ソース」ペインのマージンに表示される記号

記号	説明
\|	現在のソース位置を指定します。
=>	現在のスコープ位置を指定します。
-	現在の実行位置を指定します（現在のスコープ位置と異なる場合）。
B(n)	ブレークポイントの位置を指定します。nは対応するデバッグ・アクションIDです。この記号は、行番号列に表示されます。
T(n)	トリガーの位置を指定します。nは対応するデバッグ・アクションIDです。この記号は、行番号列に表示されます。

2.10.4 PL/SQLインタプリタのデバッグ・コマンドについて

PL/SQLインタプリタを使用する場合、次のコマンドを実行できます。

表2-6 PL/SQLインタプリタのコマンド

コマンド	説明
CREATE	ファイル・システムまたは現在のデータベースに格納できる新しいライブラリを作成します。
DELETE	次のものを削除します。現在のデータベースに存在するライブラリライブラリのプログラム・ユニットプログラム・ユニット
DESCRIBE	現在のスコープ位置に対してローカルな変数またはパラメータを検査します。この説明には、指定したローカルの名前、タイプおよび値が含まれます。
EXPORT	1つ以上のプログラム・ユニットのソースをテキスト・ファイルに書き込みます。
LIST	プログラム・ユニットのソース・テキスト、トリガーおよびデバッグ・アクションを表示します。
LOG	PL/SQLインタプリタの入力および出力のトランスクリプトを、指定したログ・ファイルに保存します。
RESET	現在のデバッグ・レベルで実行を継続せずに、外部デバッグ・レベルに制御を戻します。
SET	現在のスコープ位置をスタックの指定した枠に変更します。現在のスタック枠から別の枠へ相対的な移動を指定することも、スタック上の特定のサブプログラムへ移動することもできます。次のような方法で、SETをコールします。オブジェクト・ナビゲータで枠エントリを選択します。 PL/SQLインタプリタでSETコマンドを入力します。
SHOW	現在のスコープ位置のすべての変数およびパラメータについて、名前、タイプおよび値を表示します。

2.10.5 デバッグ・アクションについて

PL/SQLインタプリタをレポート・コード（トリガー、ユーザー命名プログラム・ユニット、ライブラリなど）から起動するには、コードでデバッグ・アクションを作成します。これらは、PL/SQLプログラム・ユニットの実行を追跡して、それを監視できるようにする命令です。

作成した各デバッグ・アクションには、自動的に一意の数値IDが割り当てられます。デバッグ中に、このIDを参照して、Reports Builderのデバッグ・コマンドで特定のデバッグ・アクションを参照、表示または変更できます。

1つ以上のデバッグ・アクションに関する詳細情報を表示できます。詳細情報には、そのID、ソースの位置、および有効化されているかどうかなどの情報が含まれます。また、特定のデバッグ・アクションを一時的に無効化し、必要に応じて後でもう一度有効化できます。

デバッグ・アクションには、ブレークポイントとデバッグ・トリガーの2種類があります。

ブレークポイントは、プログラム・ユニットの特定のソース行で実行を中断し、PL/SQLインタプリタに制御を渡します。

ブレークポイントを作成して、特定のデバッグ領域を識別します。たとえば、ブレークポイントを行10と行20に作成すると、この領域内のコードがデバッグされます。

ブレークポイントでは、ブレーク・ポイントを指定した行に到達する直前に中断が発生します。この時点で、PL/SQLインタプリタの機能を使用して、プログラムの状態を検査または変更できます。完了したら、GOコマンドまたはSTEPコマンドで実行を再開するか、RESETコマンドを使用して実行を強制終了します。

デバッグ・トリガーは、一般的な形式のデバッグ・アクションで、PL/SQLコードのブロックをプログラム・ユニット内の特定のソース行に関連付けます。デバッグ・トリガーを検出すると、Reports Builderはデバッグ・トリガー・コードを実行します。

デバッグ・トリガーを作成して、次のいずれかの場合のデバッグ時にPL/SQLコードのブロックを実行します。

プログラムの実行がプログラム・ユニット内の単一行に到達したとき（たとえば、現在のソースの位置、行5、行23など）
PL/SQLインタプリタに制御が渡るとき（つまり、ブレークポイント、プログラムのステップ実行などによって、プログラムの実行が中断されるたび）
すべてのPL/SQLソース行が実行されているとき

デバッグ・トリガーは、特に条件付きブレークポイントとして有効です。トリガー内から例外DEBUG/BREAKをコールできます。たとえば、次のデバッグ・トリガーは、my_procの行10に条件付きブレークポイントを設定します。これは、ローカルNUMBER変数my_salが5,000を超えた場合にのみ条件と一致します。

PL/SQL>line 10 is
+> IF Debug.Getn('my_sal') > 5000 THEN
+> Raise Debug.Suspend;
+> END IF;

2.10.5.1 デバッグ・アクションの作成について

PL/SQLインタプリタでは、次の方法で、デバッグ・アクション（ブレーク・ポイントとデバッグ・トリガー）を作成できます。

PL/SQLインタプリタでプログラム・ユニットが開いているときに、Reports Builderメニュー・バーで「プログラム」の後に「ブレークポイント」または「デバッグ・トリガー」を選択します。
PL/SQLインタプリタの「ソース」ペインを右クリックし、「ブレークポイント」または「デバッグ・トリガー」を選択します。
「オブジェクト・ナビゲータ」ペインにデバッグ・アクションを挿入します。
「インタプリタ」ペインでコマンドを入力します。

デバッグ・アクションを作成する場合、実行可能なプログラム・ユニットのソース行に、ブレークポイントまたはデバッグ・トリガーを連結します。ソース行は、PL/SQLコンパイラがコードを生成する1つ以上の文が含まれる場合に実行可能とみなされます。たとえば、代入文とプロシージャ・コールが含まれたソース行は実行可能ですが、コメント、空白行、宣言またはNULL文が含まれたソース行は実行可能ではありません。

2.10.6 現在の実行位置について

現在の実行位置は、実行する次のPL/SQLソース行を指定します。これは、一般にプログラム・カウンタ（PC）と呼ばれているものに相当します。

プログラムの実行中に制御がPL/SQLインタプリタに渡された場合（たとえば、ブレークポイントに達した場合やステップ実行で行っている場合）、PL/SQLインタプリタの「ソース」ペインには、現在の実行位置に対応するソース行が自動的に表示されます。

現在の実行位置を手動で表示するには、「インタプリタ」ペインでLISTコマンドを使用します。

たとえば、次のように入力します。

.LIST PC

これで、「ソース」ペインに現在の実行位置が表示されます。

2.10.7 現在のスコープ位置について

現在のスコープ位置は、PL/SQLインタプリタがローカル変数およびパラメータを検索する場所を指示します。この位置は、スタック上での1つのPL/SQLサブプログラムの現在の実行位置に対応します。

プログラム・ユニットの実行が中断するたびに（たとえば、デバッグ・アクションによって）、スコープ位置はスタックの一番下にあるサブプログラムの実行位置に初期化されます。

実行が中断された後で、現在のスコープ位置を、スタック上の別の枠に変更できます。これにより、呼び出し連鎖内の別のサブプログラムのローカル変数を表示できます。

2.10.8 デバッグ・レベルについて

デバッグ・アクションがプログラムの実行を中断すると、PL/SQLインタプリタが制御を受け取り、デバッグ・レベルを設定します。デバッグ・レベルでは、コマンドやPL/SQL文を入力し、中断されたプログラムの状態を検査および変更したり、実行を再開したりできます。

デバッグ・レベルでインタラクティブに入力したPL/SQLコード自体も中断できるので（たとえば、別のブレークポイントを検出した場合）、デバッグ・レベルをネストすることができます。デバッグ・レベルを区別しやすくするため、レベルには番号が付けられます。最も深くネストされたレベルには、一番大きな番号が割り当てられます。番号は、最も外側のレベルでゼロから始まります。

0番または最も外側のレベルは通常、トップ・レベルと呼ばれます。トップ・レベルは、プログラム・ユニットが最初にコールされた最も外側のレベルであるため、関連付けられたプログラム状態はありません。トップ・レベルからコールされたコードが中断された場合、デバッグ・レベル1が設定されます。同様に、デバッグ・レベル1からコールされたコードが中断されると、デバッグ・レベル2が設定され、後に続きます。

PL/SQLインタプリタのコマンド・プロンプトには現在のデバッグ・レベルが反映されます。PL/SQLインタプリタがトップ・レベルより下のレベルへ入ると、プロンプトには、現在のデバッグ・レベル番号を含むプリフィックスが表示されます。たとえば、PL/SQLインタプリタのコマンド・プロンプトは、デバッグ・レベル1で次のように表示されます。

(debug 1)PL/SQL>

2.10.9 実行時のコード変更について

実行時に、現在のスタック上にない任意のプログラム・ユニット、メニュー項目コマンドまたはトリガーを変更し、コンパイルできます。

注意
現在のスタック上の項目を変更するには、最初にRESETコマンドを発行してスタックをクリアする必要があります。

実行時のコード変更はReports Builderには通知されませんが、最終的な修正の実装へ戻る前に、可能な修正をインタラクティブにテストすることができます。

2 拡張概念

2.1 レポート

2.1.1 レポートのタイトルについて

関連項目

2.1.2 レポートのセクション分割と各セクションについて

例

例1

例2

関連項目

2.1.3 レポートのサイズの単位について

2.1.4 レポートのディメンションについて

図2-1 レポートのディメンション

2.1.5 レポートのフォントについて

2.1.6 条件付き書式について

関連項目

2.1.7 ネストしたマトリックス・レポートについて

関連項目

2.1.8 グループ別マトリックス・レポートについて

図2-2 グループ別およびネストしたマトリックス・レポートのサンプル

関連項目

2.2 Webレポート

関連項目

2.2.1 JavaServer Pages（JSP）とサーブレットについて

2.2.1.1 Oracle ReportsでのJSPの使用

2.2.1.2 エンコードされたJSPベースのWebレポートの起動または実行

2.2.1.3 JSPファイルへのキャラクタ・セットの動的な埋込み

関連項目

2.2.2 JSPベースのWebレポートのプレビューについて

ドキュメント・ルート

ドキュメント・ルートの構造

使用に関する注意

関連項目

2.2.3 HTML出力のWebリンクについて

2.2.4 PDF出力のWebリンクについて

2.2.5 ハイパーリンクについて

関連項目

2.2.6 グラフ・ハイパーリンクについて

関連項目

2.2.7 ハイパーリンクの宛先について

関連項目

2.2.8 ブックマークについて

関連項目

2.2.9 アプリケーション・コマンドライン・リンクについて

制限

関連項目

2.2.10 前および後のエスケープについて

制限

関連項目

2.2.11 スタイル・シートについて

HTMLCSS出力での外部スタイル・シートの使用方法

制限

関連項目

2.3 データ・モデル・オブジェクト

2.3.1 サマリー列について

関連項目

2.3.2 式列について

関連項目

2.3.3 プレースホルダ列について

関連項目

2.3.4 列参照とパラメータ参照について

2.3.4.1 バインド参照について

制限

例

例1: SELECT句

例2: WHERE句

例3: GROUP BY句

例4: HAVING句

例5: ORDER BY句

例6: CONNECT BY句およびSTART WITH句

例7: PL/SQL

2.3.4.2 字句参照について

制限

例

例1: SELECT句

例2: FROM句

例3: WHERE句

例4: GROUP BY句

例5: HAVING句

例6: ORDER BY句

例7: CONNECT BY句およびSTART WITH句

2
拡張概念