ヘルプの項目がありません。オンライン･ヘルプのキーワードで関連項目を確認してください。


表レポートについて

  関連項目

表レポートは、レポートの最も基本的なタイプです。各列はデータベースから選択された列に対応します。


フォーム形式レポートについて

  関連項目

フォーム形式レポートは、フィールド・ラベルの右にフィールド値を挿入して、1ページにつき1レコードを表示します。


メール・ラベル・レポートについて

  関連項目

メール・ラベル・レポートは、各ページに複数列のメール・ラベルを印刷します。ラベルをページに対して横に印刷してから縦にまたは縦に印刷してから横に印刷できます。


フォーム・レター・レポートについて

  関連項目

フォーム・レター・レポートには、ボイラープレート・テキストに埋め込まれたデータベース値が含まれます（ボイラープレート・テキストとは、レポート・エディタに入力またはインポートした任意のテキストのことです）。


グループ左レポートについて

  関連項目

グループ左レポートは、列の1つの中の共通の値をもとにして、表の行を複数の"集合"に分割します。関連する列の値が変わるまで、列が何度も同じ値を繰り返すことを禁止するために、このタイプのレポートを使用します。


グループ上レポートについて

  関連項目

グループ上レポートには、2つ以上のデータのグループが含まれます。マスター・グループの各値に対して、詳細グループの関連する値をデータベースから取り出します。


マトリックス・レポートについて

  関連項目

マトリックス（クロスタブ）レポートには、1行のラベル、1列のラベル、行および列のラベルに関する格子形式の情報が含まれます。マトリックス・レポートでは、データベースからデータを取り出すまで列の数がわかりません。

マトリックス・レポートを作成するには、最低4つのグループが必要です。1つはクロス積グループである必要があります。 グループの内2つはラベルを付けるためのクロス積グループにあることが必要です。そして最低1つのグループは、セルを埋めるための情報を提供する必要があります。グループは、1つまたは複数の問合せに所属させることができます。


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

  関連項目

グループのマトリックス・レポートは、マスター・グループの各値に独立したマトリックスを持つグループ上レポートです。


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

  関連項目

ネストされたマトリックス（クロスタブ）レポートとは、グリッド内に最低1組の親/子リレーションがあるマトリックス・レポートです。

ネストされたグループの新規の「子ディメンション」プロパティを使用すると、1つの問合せによるネストされたマトリックス内の空の行または列（あるいはその両方）を排除できます。


マルチメディア・レポートについて

  関連項目

マルチメディア・レポートにはイメージおよびサウンド、ビデオを含めることができます。レポート内のフィールドにイメージを表示でき、ランタイム・プレビューア内でクリックしたときにイメージの表示、サウンドの再生またはビデオ・クリップを再生するボタンを作成できます。

サウンドおよびビデオをレポートに追加するために、サウンド・オブジェクトまたはビデオ・オブジェクトのファイル名を格納したデータベースの中の列を選択したりまたはレポート・レイアウトにボタンを作成したりできます。


OLE2レポートについて

  関連項目

OLE2レポートでは、OLE2対応のアプリケーションからスプレッドシート、図形およびサウンドなどのオブジェクトを表示できます。OLE2オブジェクトを含むレポートは、Windowsのプラットフォームでのみサポートされています。移植性を考慮して、マルチメディア・レポートを作成します。

OLE2オブジェクトをレポートに追加するには、OLE2オブジェクト（またはOLE2オブジェクトのファイル名）を含むデータベースの中の列を選択するかまたはファイルからOLE2オブジェクトをレポート・レイアウトに読込みます。

•	データベースからOLE2オブジェクトを選択すると、Report Builderは、各OLE2オブジェクトを格納するために、フィールドまたはボタン（たとえば、ビデオやサウンドに対する）を自動的に生成します。

•	「レイアウト・モデル」表示のOLE2オブジェクト・ツールを使用すると、OLE2サーバーを起動してただちにオブジェクトを作成するか、既存のファイルを使用できます。ファイルにオブジェクトを埋め込んだ後、ファイルの作成に使ったアプリケーションにアクセスできれば、ファイルをアクティブ化できます。


ドリルダウン・レポートについて

  関連項目

ドリルダウン・レポートとは、同時に動作する2つ以上のレポートです。トップ・レベルのレポートにより、現レコードのデータの詳細を提供するセカンダリ・レポートが起動されます。柔軟に詳細を選択できるように、ディテール・レポート･コールのPL/SQLを実行し、実行条件が作成されるトップ・レベルのレポートにボタンを作成できます。ディテール・レポートではシングル・レコードまたはレコードのグループ、レポート全体の詳細を提供できます。

ドリルダウン・ボタンをアクティブにするには、レポートを実行し、次にそれをランタイム・プレビューアに表示します。


Webレポートについて

  関連項目

レポート出力をHTMLファイルまたはPortable Document Format（PDF）ファイルに送ることができます。HTMLファイルは、Webブラウザで表示可能です。PDF ファイルは、PDFビューアで表示可能です。また、エンド・ユーザーに対話形式のレポートを提供するために、Webリンクを追加し、WWWで配布できます。

Webブラウザでレポート出力をプレビューするには、「ツール」 [image] 「Webウィザード」を使用します。これにより、HTMLやPDF出力への変更の効果をただちに確認できます。


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

  関連項目

PDF形式のレポート出力では、次のようなタイプのWebリンクを含むことが可能です。ヒント

•	同じレポートの1つのオブジェクトから、他のオブジェクトへの、あるいは他のHTMLまたはPDF文書へのリンク（ハイパーリンク）。

•	チャートから、ハイパーリンクの宛先、他のレポートやチャートまたはレポート出力のデータに、チャート・ハイパーリンクを作成することができます。

•	PDFビューアのブックマーク領域で、関連付けられたオブジェクトにリンクしている文字列（ブックマーク)。ブックマークを任意のプリント可能なオブジェクト（フィールド、ボイラープレート、フレームなど）に関連付けることが可能です。フォーマットされたレポートでブックマークをクリックすると、ウィンドウの上部に関連付けたオブジェクトを表示できます。

•	クリックするとコマンドを実行するリンク(アプリケーションのコマンド・ライン・リンク)。   レポート・レイアウトで、コマンドを任意のプリント可能なオブジェクト（フィールド、ボイラープレート、フレーム等）と関連付けることができます。フォーマットされたレポートでそのオブジェクトをクリックすると、関連付けたコマンドを実行できます。

•	Webリンクの宛先に対する識別子(ハイパーリンクの宛先)。宛先は、レポート・レイアウトの任意のオブジェクト（フィールド、ボイラープレート、フレームなど）に設定できます。

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


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

  関連項目

HTML形式のレポート出力には、次のようなタイプのWebリンクを挿入できます。ヒント

•	同じレポートの1つのオブジェクトから、他のオブジェクトへの、あるいは他のHTMLまたはPDF文書へのリンク（ハイパーリンク）。

•	関連付けたオブジェクトへリンクしているマスターHTML文書の、フレーム内文字 (ブックマーク)。ブックマークを任意のプリント可能なオブジェクト（フィールド、ボイラープレート、フレームなど）に関連付けることが可能です。フォーマットされたレポートでブックマークをクリックすると、ウィンドウの上部に関連付けたオブジェクトを表示できます。

•	Web linkの宛先に対する識別子(ハイパーリンクの宛先)。宛先は、レポート・レイアウトの任意のオブジェクト（フィールド、ボイラープレート、フレームなど）に設定できます。

•	文書ヘッダー(Beforeレポート)。この属性は、HTMLドキュメントの終りに、1つのロゴまたは複数の標準的なリンクを指定するのに便利です。

•	文書フッター(Afterレポート)。この属性は、HTMLドキュメントの終りに、1つのロゴまたは複数の標準的なリンクを指定するのに便利です。

•	ページ・ヘッダー（Beforeページ）。この属性は、HTMLドキュメントの1ページまたはすべてのページの始めに、1つのロゴまたは複数の標準リンクを指定するのに便利です。

•	ページ・フッター（Afterページ）。この属性は、HTMLドキュメントの1ページまたはすべてのページの終わりに、1つのロゴまたは複数の標準リンクを指定するのに便利です。

•	パラメータ・フォーム・ヘッダ（Beforeフォーム）。この属性は、HTMLパラメータ・フォームのヘッダーに、1つのロゴまたは複数の標準リンクを指定するのに便利です。

•	パラメータ・フォーム・フッター（Afterフォーム）。この属性は、HTMLパラメータ・フォームのフッターに、1つのロゴまたは複数の標準リンクを指定するのに便利です。

•	イメージ・リソースを指定するURL。HTML出力がサーバーで表示されたとき、イメージを配置できるように、WebサーバーでURLを使用できる必要があります。

•	サポートされている任意のHTMLタグ。

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


カラーの変更について

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


オブジェクトの回転について

回転できるのは、ボイラープレート・テキストおよび図形のみです。その他のレイアウト・オブジェクト（繰返し枠または枠、フィールド）は回転できません。


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

問合せ、グループ、繰返し枠、枠、フィールド、マトリックス・オブジェクトおよびボイラープレートのサイズを変更することが可能です。アンカーするオブジェクトの1つを移動すると、アンカーは自動的にサイズ変更されます。


イメージについて

  関連項目

次のようにしてイメージをレポートに追加します。

•	イメージを含むデータベースの列を選択します。

•	イメージをファイルからレポート・レイアウトにインポートします。

•	HTML出力の場合は、イメージへのURLリンクを参照します。

デフォルトでは、印刷されるレポートにイメージを表示するため、イメージはライブ・プレビューアにのみでなく、フィールドにも表示されます。イメージに対してボタンを作成できます。 プリントされたレポートには表示されませんが、ランタイム・プレビューア内をクリックすることでイメージを表示できます。

非キャッシュ参照機能を使用すると、ローカルなディスク領域を浪費することなく、イメージ・オブジェクトを無制限に挿入できます。非キャッシュ参照機能を使用すると、レポートの処理中に必要なときにのみ、データベースからオブジェクトが読み込まれます。この機能を使用するには、Oracle 7 Serverリリース7.1以降のデータベースに接続する必要があります。

イメージ対象のURLを参照すると、HTML出力用にレポートをフォーマットしたときに、そのイメージが表示されます。他の出力形式の場合は、URLテキストはライブプレビューアに表示されます。 出力の宛先（ファイルまたはPDF文書など）には、何も表示されません。URLが存在するかどうかは、ユーザーが責任をもって確認してください。 Report Builderでは、リソースの存在もプロトコルの構文も確認できません。URLを含むオブジェクトのサイズで、HTML出力イメージのサイズが決まります。オブジェクトに指定した拡張度プロパティは無視されます。


サウンドおよびビデオについて

  関連項目

サウンド・オブジェクトまたはビデオ・オブジェクトのファイル名を含むデータベースの列を選択するか、レポート・レイアウトにボタンを作成することによって、サウンドおよびビデオをレポートに追加できます。

データベースのサウンドまたはビデオの列を選択すると、Report Builderでは、オブジェクトのボタンが自動的に作成されます。ボタンをアクティブ化するには、レポートを実行し、次にそれをランタイム・プレビューアに表示します。

非キャッシュ参照機能を使用すると、ローカルなディスク領域を浪費することなく、サウンド・オブジェクトを無制限に挿入できます。非キャッシュ参照機能を使用すると、レポートの処理中に必要なときにのみ、データベースからオブジェクトが読み込まれます。この機能を使用するには、Oracle 7 Serverリリース7.1以降のデータベースに接続する必要があります。


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

  関連項目

時間を節約するために、Report Builderにはビルトイン・パッケージ（SRW）が付属しています。 これは、どのライブラリやレポートでも参照できるファンクションおよびプロシージャ、例外が多数入ったPL/SQL構成体を集めたものです。

Report Builderビルトイン・パッケージに加えて、Procedure Builderでは、プログラム単位のデバッグ中に参照できるPL/SQL構成体を多数含むビルトインPL/SQLパッケージも提供されています。


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

  制限      [image]  例      [image]  関連項目

レポート・トリガーを使って、レポートのフォーマット中や実行中に、PL/SQLファンクションを時刻指定して実行できます。これらのトリガーにPL/SQLの条件処理機能を使用すると、レポートの形式のカスタマイズ、タスクの初期化、データベースへのアクセスなどを実行できます。レポート・トリガーを作成または変更するには、オブジェクト・ナビゲータでレポート・トリガーを使用します。レポート・トリガーは、明示的にTRUEまたはFALSEを返す必要があります。Report Builderには5つのグローバル・レポート・トリガーがあります（新規のグローバル・レポート・トリガーを作成することはできません）。

After Parameter Formトリガー

After Reportトリガー

Before Parameter Formトリガー

Before Reportトリガー

Between Pagesトリガー


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

  例      [image]  関連項目

フォーマット・トリガーとは、オブジェクトをフォーマットする前に実行する、PL/SQLファンクションのことです。トリガーを使用するのは、オブジェクトのフォーマット属性を動的に変更するときです。


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

  制限 	  例	  関連項目

どのレコードをグループに挿入するか、グループ・フィルタで決定します。グループのレコードの最初のn個または最後のn個を表示するために、「フィルタ・タイプ」で「最初」および「最後」を使用できます。 または、「PL/SQL」を使って独自のフィルタを作成できます。


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

ユーザー・イグジットとは、ユーザーが記述し、Report Builder実行プログラムまたはユーザー・イグジットDLLファイルにリンクするプログラムです。ユーザー・イグジットは、Report Builderからユーザーが記述したプログラムに制御を移すときに作成します。 ユーザーが記述したプログラムは、目的の機能を果たすとReport Builderに制御を戻します。

次のタイプのユーザー・イグジットを作成できます。

•	Oracleプリコンパイラ・ユーザー・イグジット

•	OCI（Oracleコール・インタフェース）ユーザー・イグジット

•	Oracle以外のユーザー・イグジット

Oracleプリコンパイラ・インタフェースとOCIを結合するユーザー・イグジットを作成することもできます。

ユーザー・イグジットは次のタスクを行います。

•	複雑なデータ操作を行います。

•	オペレーティング・システム・テキスト・ファイルからReport Builderへデータを渡します。

•	LONG RAWデータを操作します。

•	PL/SQLブロックをサポートします。

•	プリンタまたはロボットなどのリアル・タイム・デバイスを制御します。

数学的な処理などの他のタスクにもユーザー・イグジットを使用できます。ただし、そのようなタスクを行う場合には、Report Builder内でPL/SQLを使用することをお薦めします。

使用上の注意

•	ここに述べたすべてのタスクを、あらゆるユーザー・イグジットで行えるわけではありません。これらのタスクのほとんどは、Oracleプリコンパイラ・ユーザー・イグジットでしか行えません。

•	ユーザー・イグジットの実現方法の詳細は、各オペレーティング・システム特有のものです。


コール・インタフェースについて

コール・インタフェースとは、作成した3GLプログラムにセットできる標準プロシージャの集合です。Report Builderにはそのようなプロシージャ（Cで記述されています）が、次の実行プログラムのそれぞれに対して標準装備されています。

実行プログラム	プロシージャ名

RWCON60	RWCCON, RW2CON

RWRUN60（ビットマップ）	RWCRRB、RW2RRB

RWRUN60（キャラクタ･モード）	RWCRUN、RW2RUN

RWBLD60（ビットマップ）	RWCSRB、RW2SRB

たとえば、Pro*FORTRANプログラムを記述して、そのプログラムにReport Builderレポートを（キャラクタ・モードのRWRUN60実行プログラムを使用して）実行させるとします。この場合は、RWCRUNまたはRW2RUNプロシージャ･コールをプログラムに追加する必要があります（プロシージャの選択の詳細は、この章の構文の部分を参照してください)。

コール･インタフェースの例は、$ORACLE_HOME\REPORT60\OCI\Samplesを参照してください。$ORACLE_HOME\REPORT60\OCIにあるoci_info.txtというファイルも参照してください。

使用上の注意

•	コール・インタフェースを使用するには、プログラムがOracleプログラム・インタフェース・ホスト言語（ADAまたはC、COBOL、FORTRAN、Pascal、PL/l）で記述する必要があります。コール・インタフェースでRWCON60を起動すると、プラットフォームに付属の実行プログラム（ビットマップまたはキャラクタ･モード）が稼働されます。

•	リリース2.5では、RWCSRVおよびRW2SRVという2つのプロシージャがありました。Report Builderリリース3.0以降では、BACKGROUND=YESと指定して、RWCRRBおよびRW2RRBを使用し、これらが使用されているプロシージャを置換する必要があります。


プログラム単位およびPL/SQLエディタについて

 例	 制限	  関連項目

プログラム単位とは、現行のレポートの任意のPL/SQLから参照できる、パッケージ、ファンクション、プロシージャのことです。

注意: プログラム単位は他の文書からは参照できません。複数の文書から参照できるパッケージ、ファンクションまたはプロシージャを作成する場合は、外部 PL/SQLライブラリを作成します。

PL/SQLエディタでは次のことができます。

•	「コンパイル」をクリックして、プログラム単位コードをコンパイルします。

•	「適用」をクリックして、最初にオープンした後または最後に適用あるいは回復操作を行った後の、プログラム単位への変更をすべて保存します。コンパイルは行いません。

•	「変更の破棄」をクリックして、最初にエディタをオープンした状態または最後に適用あるいは回復操作を行ったときの、プログラム単位の状態に復元します。

•	「作成」をクリックして、作成するプログラムの名前およびタイプを指定できる「新規プログラム単位」ダイアログ・ボックスを表示します。

•	「削除」をクリックして、現在エディタに表示されているプログラム単位を削除する。プログラム単位が実際に削除される前に、確認入力が求められます。

•	「クローズ」をクリックして、PL/SQLエディタをクローズします。

•	「名前」をドロップダウン・リストから選択して、すべての既存のプログラム単位間をナビゲートします。

プログラム単位を変更すると、依存するプログラム単位はコンパイル・ステータスを失います（オブジェクト・ナビゲータのプログラム単位ノードの名前の下にアスタリスク（*）で示されます）。それらを再コンパイルするために、「名前」ドロップダウン・リストを使って、PL/SQLエディタで直接プログラムにナビゲートできます。


PL/SQLの例（式からPL/SQLファンクションを参照）

  関連項目      [image]  すべての例

次のグループと列を持つレポートがあるとします。

グループ	列	サマリー
 ------------------------------------------------
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;

式の中でのPL/SQLファンクションの参照方法の例をいくつか次に示します。

CompSal(:RGNSUMSAL)

または

CompSal(:SAL) + COMM


プログラム単位の制限

•	PL/SQLパッケージ、ファンクションまたはプロシージャを削除する場合、レポートの中の対応するすべての参照も削除する必要があります。削除しないと、レポートのコンパイル、作成または実行時にエラーが発生します。

•	PL/SQLパッケージ、ファンクションまたはプロシージャの名前はレポート内で一意でなければならず、いずれの列、グループ、問合せまたは印刷可能なオブジェクトの名前とも重複できません。


デバッグ・アクションの使用可能と使用不可

オブジェクト・ナビゲータで使用不可ステータスを示すのは、「デバッグ・アクション」ノード下の、デバッグ・アクションの次にあるアスタリスクです。デバッグ・アクションの次にアスタリスクがない場合、そのアクションはアクティブです。


MAPIについて

  関連項目

mapinobatch

Windows動作環境で、Microsoft Messaging Application Programming Interface（MAPI）を介して、電子メールを送受信できます。ビットマップ・レポートは、カプセル化されたPostScript形式で書かれた、電子メールの添付書類として送信されます。キャラクタ・モードのレポートは、ASCIIテキスト形式の添付ファイルとして送られます。

前提条件: Windows 95、Windows for Workgroups 3.11またはWindows NTでインストールされた適切なMAPIメール・クライアント・アプリケーションが必要です。詳細は、使用しているオペレーティング・システムのマニュアルに記述されている、電子メール機能構成方法を参照してください。

注意: Reports Server (RWMTS60)をサービスとして実行する場合、レポート出力をメールに送れないというWindows NT上のエラーがあることがわかっています。Microsoft社は、これをMicrosoft Exchange Server 5.0で改善する予定です。当面はコマンドRWMTS60.EXE -listen tnsnameを使用して、フォアグラウンドでReports Serverを実行すれば、この問題を解決することが可能です。


アンカーについて

アンカーを使用すると、子オブジェクトの親オブジェクトに対する垂直および水平位置を判別できます。子オブジェクト上の記号で示されたアンカーの端が、親オブジェクトに連結されます。

  ここをクリックして、アンカーの部品を示すダイアグラムを表示します。

レポートの実行時（およびデータが実際に取り出されるとき）にレイアウト・オブジェクトによってはサイズが変わることがあるので、アンカーを使用して、他のオブジェクトとの相対位置でオブジェクトの表示位置を定義することが必要です。アンカーは、アンカーされるオブジェクトに対するオブジェクトの相対位置を定義します。位置はエディタ内でのサイズでなく、データが取り出された後のオブジェクトのサイズに基づいています。レイアウト・エディタ内のオブジェクトの位置は、レポート出力内の最終的な位置に作用することに注意してください。レイアウトのいずれの物理的オフセットでも、「アンカー」のプロパティ・パレットで指定された百分率位置に取り込めます。


ボイラープレート・オブジェクトについて

  関連項目

ボイラープレートは、毎回レポート内で実行され表示される任意のテキストまたはグラフィックスのことをさします。Report Builderは「レポート・ウィザード」で選択されたそれぞれのラベルに対して1つのボイラープレート・オブジェクト（B_columnnameという名前で）作成します。また、1つのボイラープレート・オブジェクトが各レポート・サマリーに対して作成されることもあります。ボイラープレート・オブジェクトは、通常それを囲んでいるオブジェクトによって所有されます。


ボタンについて

 関連項目

ボタンはレイアウト・オブジェクトで、エンド・ユーザーがクリックすると実行時に特定のアクションを実行できます。たとえば、ボタンはマルチメディア（イメージまたはサウンド、ビデオ）・オブジェクトにアクセスする方法を提供します。またPL/SQLを実行して、ディテール・レポートを起動するなどのいくつかのアクションを実行するために、ボタンを使用することもできます。マルチメディア・オブジェクトを含むまたは指し示す列を選択した場合、Report Builderでは、ボタン・オブジェクトが作成されます。


Graphics Builder図表について

  関連項目

次の方法で、Graphics Builderの図表をレポートに取り込むことができます。

•	チャート・ツールを使用して、既存の図表を埋め込む。

•	チャート・ウィザードを使用して、新しいチャートを作成する。

Graphics Builderの図表は、データベースからでなく、取り込まれるレポートから直接データおよびパラメータを受け取れます。このため、フィルタ処理を反映した図表またはレポートからの集計データを取り込むことができます。


Graphics Builder図表へのデータの受渡しについて

 関連項目

Graphics Builder図表を参照するときに、次の理由で、レポートから図表にデータを受け渡す場合があります。

•	レポートでデータがフィルタ処理される場合に、図表にフィルタ処理を反映させることができます。たとえば、グループのレコードを制限するためにレポート内でグループ･フィルタを使用する場合、データをレポートから図表に渡す必要があります。そうしないと、図表はデータそのものを取り出し、図表で使用されるデータにはレポートのグループ･フィルタが反映されません。

•	レポートが集計を取り込む場合に、図表にその集計を使用できます。たとえば、図表に使用する合計の割合(%)をレポートに取り込む場合、図表にその集計を渡す必要があります。さもなければ、図表に同じ集計をなんらかの方法で作成する必要があります。

•	図表で使用されるデータがすでにレポートによって取り出されている場合には、図表のデータを再度検索せずに済みます。


サマリー列について

  関連項目

サマリー列は、他の列のデータに対して計算を実行します。レポート・ウィザードまたはデータ・ウィザードを使用して、合計、平均、カウント、最小値、最大値および%合計の集計を作成できます。また、レイアウト・エディタのデータ・モデル表示では、手動でサマリー列を作成でき、さらに、プロパティ・パレットを使用して最初、最後、標準偏差および分散のサマリー列を作成できます。

注意: レポート・ウィザードとデータ・ウィザードは、グループ・レポートに対し、ユーザーが定義する各サマリー列のデータ・モデル内にn個のサマリー・フィールドを作成します。集計中の列の上にあるグループ・レベルごとに1つおよびレポート・レベルに1つ作成します。たとえば、レポートが部署別にグループ分けされ、さらに課別にグループ分けされる場合、給与合計について定義されたサマリー列によって、各部署および各課グループの給与小計（グループ・レベル・サマリー）および全給与の小計（レポート・レベル・サマリー）のフィールドが作成されます。


データベースの列について

データベースの列は問合せによって選択される列を表します。問合せで選択する各列に対して、Report Builderでは自動的にレポートのデータ・モデルに列が作成されます。


フィールドについて

  関連項目

フィールドとは、レイアウトの各列に対するレイアウト・コンテナです。フィールドが集計である場合（この場合は枠によって所有されます）を除いて、フィールドはそれを囲むオブジェクト（通常は繰返し枠）によって所有されます。


式列について

 関連項目

式列では、プレースホルダ列を含む他の列データに対してユーザー定義の計算が実行されます。注意


グループについて

  関連項目

グループはレポートの列を編成するために作成されます。問合せを作成すると、Report Builderでは問合せによって選択された列を含むグループが自動的に作成されます。レポートにブレーク・レベルを作成するために、追加のグループを作成できます。追加のグループは、直接作成することも、レポート・ウィザードを使用してグループ上レポートまたはグループ左レポートを作成することもできます。


データ・リンクについて

  関連項目

データ・リンクとは複数の問合せの結果に関係します。データ・リンク（つまり親子リレーション）により、親グループのレコードが処理されるたびに子問合せが実行されます。レポートのデータ・モデル・ビューでデータ・リンクを作成するとき、Report Builderでは実行時に子問合せのSELECT文に追加される句（「リンク」のプロパティ・パレットの設定によって指定される）が作成されます。SELECT文は、Report Builderで親または子のそれぞれの問合せについて表示できますが、定義したデータ・リンクによって作成された句を含むSELECT文は表示できません。注意


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

  関連項目

マトリックス・オブジェクトは、2つの繰返し枠の間のリレーションを定義します。実際に何かから所有されたり、何かを所有したりすることはありません。マトリックス・オブジェクトは、マトリックス・レイアウト・スタイルを持つレイアウトのためのみに作成されます。データ・モデルがグループを含む場合、レポートはその中に複数のマトリックスを持つことができます。Report Builderでは、垂直な繰返し枠の各交差部に対して1つのマトリックス・オブジェクトが作成されます。


OLE2オブジェクトについて

  関連項目

Report BuilderはOLE2コンテナです。データ・モデルまたはレイアウトを使用して、OLE2オブジェクトをレポートに取り込むことができます。


パラメータについて

  関連項目

パラメータとは実行時に値を設定できる変数です（たとえばランタイム・パラメータ・フォームまたはコマンド・ラインから）。ユーザー・パラメータはレポートに対してユーザー自身が作成します。システム・パラメータはReport Builderにより作成されます。ユーザー・パラメータは削除または改名できますが、システム･パラメータは削除または改名できないことに注意してください。


列およびパラメータの参照について

  関連項目

ユーザー・パラメータ、システム･パラメータおよび列をバインド参照 または字句参照のいずれかとして参照できます。


パラメータ・フォーム・ボイラープレートについて

  関連項目

パラメータ・フォーム・ボイラープレート・オブジェクトとは、レポートが実行されるたびにランタイム・パラメータ・フォームに表示されるテキストまたは図形オブジェクト（あるいはその両方）です。


パラメータ・フォーム・フィールドについて

  関連項目

パラメータ・フォーム・フィールドとは、ランタイム・パラメータ・フォーム上で使用されるパラメータに対するレイアウト・コンテナです。


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

  関連項目

プレースホルダは、ユーザー定義のPL/SQL内のデータ型および値を設定した列です。プレースホルダ列の値は、次の場所に設定できます。

•	BEFORE REPORTトリガー。プレースホルダがレポート・レベルの列である場合

•	プレースホルダがレポート・レベルの列である場合、レポート・レベルの「式列」

•	プレースホルダのグループまたはその下のグループ（グループの各レコードに一度、値が設定されます）


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

  関連項目

HTMLパラメータ・フォーム拡張を使用すると、Webからレポートを実行するときにHTMLタグ付きテキストおよびJavaScriptを指定したランタイム・パラメータ・フォームの機能を拡張させることができます。Webレポート用パラメータ・フォームの機能を向上をさせるには、次のことを行ないます。

•	HTMLタグ付きボイラープレート・テキストの作成 ハイパーリンクまたはその他のHTMLタグ付きテキストをパラメータ・フォームに追加します。

•	JavaScriptを使用したパラメータ・フィールドの挿入 ユーザーがパラメータ・フィールドに無効なデータを入力したときに表示されるエラーなどの入力イベントまたは選択イベントを定義します。

•	パラメータ・フォーム・ヘッダーの作成(Beforeフォーム) HTMLパラメータ・フォームのヘッダーに、1つのロゴまたは複数の標準リンクを配置します。

•	パラメータ・フォーム・フッターの作成(Afterフォーム) HTMLパラメータ・フォームのフッターに、1つのロゴまたは複数の標準リンクを配置します。

「ツール」 [image] 「パラメータ･フォーム作成」を選択またはオブジェクト・ナビゲータからパラメータ・フォーム・エディタにアクセスします。


問合せについて

  関連項目

問合せは、レポートに対してデータベースからデータを取り出すSQL SELECT文を含みます。


枠について

  関連項目

枠は他のオブジェクトを囲み、他のオブジェクトによる上書き、プッシュを防ぐために使用されます。たとえば、グループによって所有されるすべてのオブジェクト、列ヘッダー、集計などを囲むために使用できます。

レポートのデフォルト・レイアウトを作成する場合、Report Builderは必要に応じレポート・オブジェクトの周りに枠を作成します。枠は、レイアウト・モデル表示で手動で作成することもできます。


繰返し枠について

  関連項目

繰返し枠は、グループの列に対して作成されたすべてのフィールドを囲みます。繰返し枠は、そのグループの各レコードを1回のみ出力し（起動され）ます。

レポートのデフォルト・レイアウトを作成する場合、Report Builderでは必要に応じフィールドの周りに繰返し枠が作成されます。繰返し枠は、レイアウト・モデル表示で手動で作成することもできます。


レポート・オブジェクトについて

  関連項目

レポート・オブジェクトは、レポートの様々な部分を定義する作成ブロックです。これは3つの機能的なカテゴリ、つまりデータ・モデル・オブジェクトおよびレイアウト・モデル・オブジェクト、パラメータ・フォーム・オブジェクトに分けられます。

•	データ・モデル・オブジェクトはレポートに含まれるデータを定義します。問合せおよび列、グループ、パラメータ、データ・リンクが含まれます。

•	レイアウト・モデル・オブジェクトは、レポートの中のデータおよび他のオブジェクトの位置と外観を定義します。枠および繰返し枠、フィールド、ボイラープレート・オブジェクト、アンカー、ボタン、チャート（図表）、OLE2オブジェクトが含まれます。

•	パラメータ・フォーム・オブジェクトはランタイム・パラメータ・フォームの外観を定義します。パラメータ・フォーム・ボイラープレート・オブジェクトおよびパラメータ・フォーム・フィールドが含まれます。


ソート列について

  関連項目

(Oracle Expressのみ)ソート列は、Express Reportでディメンション値をソートするのに使用されます。Report Builderでは、Expressへの問合せで選択された各ディメンションに対して、対応するソート列が自動的にレポートのデータ・モデルに挿入されます。ソート列には、対応するディメンション値についてのExpress索引が含まれます。

たとえば、製品および月ごとにグループ化されている地域の売上げデータを取り出すExpressへの問合せを作成する場合、Expressレポートは次のようになります。

時間ディメンションは、アルファベット順ではなくその年の月ごとにソートされていることに注意してください。

セレクタのSortツールを使用して、Expressレポートでディメンション値をソートできます。データ・モデル表示およびオブジェクト・ナビゲータからソート列を表示できます。データ・ウィザードおよびレポート・ウィザードまたはレイアウト・モデル表示およびライブ・プレビューアからは、ソート列を参照できません。


レポート･エディタについて

  関連項目

レポート･エディタは、直接またはオブジェクトのプロパティ・パレットの設定を変更することによって、レポート内のオブジェクトを操作する作業領域です。レポート・エディタ・ウィンドウ内では、レポートの異なる4つの表示、つまりデータ・モデル、レイアウト・モデル、パラメータ・フォームおよびライブ・プレビューアの間をナビゲートできます。


データ・モデル・ビューについて

  関連項目

レポート･エディタのデータ・モデル・ビューを使用すると、レポートに対してデータ・モデル・オブジェクトを定義および変更できます。この表示では、オブジェクトおよびそのプロパティの設定は、タイプおよびリレーションをハイライト表示するために記号で表示されます。データ・モデルに対する問合せを作成するには、新規作成時ではレポート・ウィザードの「Query Builder」、新規作成以外ではデータ・モデル表示内の「問合せ」ツールを使用できます。


レイアウト・モデル・ビューについて

  関連項目

レポート･エディタのレイアウト・モデル・ビューを使用すると、レポートに対してレイアウト・モデル・オブジェクトの定義および変更ができます。この表示では、オブジェクトおよびプロパティの設定は、タイプおよびリレーションをハイライト表示するために記号で表示されます。


パラメータ・フォームについて

  関連項目

レポート･エディタのパラメータ・フォームを使用すると、レポートに対してランタイム・パラメータ・フォームを作成できます。Parameter Form Builderを使用して、フォームに対する事前定義済みシステム・パラメータの選択ができ、あるいはユーザー自身での作成もできます。


ライブ・プレビューアについて

  関連項目

レポート･エディタのライブ・プレビューアを使用すると、ページごとのレポート出力をプレビューし、検査することができます。カスタマイズするために、レポート出力を直接操作して、レポートの外観をより洗練させることが可能です。


ランタイム・プレビューアについて

  関連項目

ランタイム・プレビューアでは、レポート出力の1ページのスクロールおよびレポートの始めから終わりまでのページング、画面を分割して同じレポートの別々の部分を同時に表示することなどが可能です。

物理ページ（パネル）はプリンタで出力されるページのサイズです。論理ページは実際のレポートの1ページのサイズです（任意の数の物理ページの幅または長さに設定できます）。ランタイム・プレビューアには、レポート出力の論理ページが一度に1ページずつ表示されます。

ランタイム・プレビューアを使用して、次のことを行えます。

•	詳細なレポートへのドリルダウン: レポートには、PL/SQLアクションを関係付けたボタンを組み込むことができます。たとえば、パッケージ・プロシージャSRW.RUN_REPORTを使用して、他のレポートをコールするボタンに対してアクションを定義できます。この2番目の（つまりディテール）レポートは、それ自身のモーダル・ランタイム・プレビューアに表示されます。この方法でドリルダウン可能なレベル数について、制限はありません。

•	マルチメディア・オブジェクトへのアクセス: レポートは、マルチメディア・オブジェクト（たとえば、ビデオまたはサウンド）に対するボタンを含むことができます。これらのオブジェクトはランタイム・プレビューア内のボタンをクリックして起動できます。

•	OLE2準拠アプリケーションのオープン: レポートにOLE2オブジェクトが含まれる場合には、ランタイム・プレビューアでこれらのオブジェクトをダブルクリックすると関係付けられたサーバー・アプリケーションをオープンできます（オブジェクトがリンクされている場合には、そのソース・オブジェクトが表示されることに注意してください）。


テンプレートについて

  関連項目

テンプレートは複数のレポートに適用する共通の特性およびオブジェクトを定義します。たとえば、会社のロゴおよびフォント・セット、レポートの選択領域のカラーを含むテンプレートを定義できます。

レポート・ウィザードを使用してレポートを作成する場合、オプションでテンプレート（tdfファイル）をレポートに適用できます。テンプレートを選択すると、テンプレートのマージン領域が現行のレポート・セクションの同じ位置に上書きされます。テンプレートのボディ領域のオブジェクトの特性（書式、フォント、カラーなど）が、現行のレポート・セクションのボディ領域のオブジェクトに適用されます。ユーザーが定義したテンプレート・プロパティ、パラメータ、レポート・トリガー、プログラム単位および連結ライブラリを適用できます。レポートの各セクションに異なるテンプレートを適用することもできます。

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


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

  関連項目

テンプレート・エディタは、テンプレートに対してオブジェクトおよび書式プロパティを定義できる作業領域です。これは、レポート・エディタのレイアウト・モデルに似ています。マージン領域で、オブジェクト（ページ番号、テキスト、図形など）の作成、削除および変更ができます。ボディ領域では、オブジェクトの作成および削除はできませんが、プロパティ・パレット（「ツール」 [image] 「プロパティ・パレット」）でボディ・オブジェクトのプロパティを変更できます。

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


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

  関連項目

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

•	枠。次のものがあります。

•	「セクション枠」ノード。現在選択されているセクションを囲む親枠の属性を定義します。

•	「見出し」ノード。列ヘッダーを囲む親枠の属性を定義します。

•	「フィールド枠」ノード。フィールドを囲む親枠の属性を定義します。

•	「サマリー枠」ノード。サマリー（集計）を囲む親枠の属性を定義します。

•	フィールドのラベル/ヘッダー。次のものがあります。

•	「文字」ノード。文字フィールドのラベルまたは列ヘッダーの属性を定義します。

•	「数値」ノード。数値フィールドのラベルまたは列ヘッダーの属性を定義します。

•	「日付」ノード。日付フィールドのラベルまたは列ヘッダーの属性を定義します。

•	フィールド。次のものがあります。

•	「文字」ノード。文字フィールドの属性を定義します。

•	「数値」ノード。数値フィールドの属性を定義します。

•	「日付」ノード。日付フィールドの属性を定義します。

•	サマリー･ラベル。次のものがあります。

•	「文字」ノード。文字フィールド上の集計のラベルの属性を定義します。

•	「数値」ノード。数値フィールド上の集計のラベルの属性を定義します。

•	 「日付」ノード。日付フィールド上の集計のラベルの属性を定義します。

•	サマリー。次のものがあります。

•	「文字」ノード。文字フィールド上の集計の属性を定義します。

•	「数値」ノード。数値フィールド上の集計の属性を定義します。

•	「日付」ノード。日付フィールド上の集計の属性を定義します。

デフォルト属性

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

上書き属性

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

単一セクション・レポート・スタイル

複数セクション・レポート・スタイル

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

•	セクションと同数のグループ: 1対1のマップ（1番目のセクションが1番目のグループにマップされ、2番目のセクションが2番目のグループにマップされる）。

•	セクションよりグループが多い: 最後から2番目のセクションまでは1対1のマップ。すべての後続のグループは最後から2番目のセクションにマップされ、最後のグループが最後のセクションにマップされます。セクションが1つしかない場合、すべてのグループがそのセクションにマップされます。

•	グループよりセクションが多い: 最後から2番目のグループまでは1対1のマップ。最後のグループが最後のセクションにマップされます。


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

  関連項目

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

「デフォルト・セクション」プロパティ

「デフォルト・セクション」プロパティは、Report Builderにより事前に設定された値を継承します。プロパティがReport Builderのデフォルト値に設定されると、プロパティ・パレット内のその隣のアイコンは小さな円になります。「デフォルト・セクション」プロパティは、値が変更されたときまたはプロパティを選択し、ツールバーの [image] （「ローカライズ(L)」ボタン）をクリックしたときにローカライズされます。プロパティがローカライズされると、その隣のアイコンが四角になります。プロパティを継承した値に戻すには、プロパティを選択し、ツールバーの [image] （「継承(H)」ボタン）をクリックします。

「上書き」プロパティ

「上書き」プロパティは、「デフォルト・セクション」プロパティからその値を継承します。プロパティが「デフォルト・セクション」プロパティから継承を行うと、プロパティ・パレット内のその隣のアイコンが矢印になります。「上書き」プロパティは、値が変更されたときまたはプロパティを選択し、ツールバーの [image] （「ローカライズ(L)」ボタン）をクリックしたときにローカライズされます。プロパティがローカライズされると、その隣のアイコンが赤いバツが付いた矢印になります。「上書き」プロパティの値を継承した値に戻すためには、プロパティを選択し、ツールバーの [image] （「継承(H)」ボタン）をクリックします。


SQL*Netについて

SQL*Netを使用すると、リモート・マシン上のデータソースに短時間で効率よくアクセスできます。SQL*Netは、「クライアント」（たとえばReport Builder）を「サーバー」（たとえばOracle）に接続し、複数の同時接続を可能にします。リリース6.0以降ではSQL*NETは、Net8に置き換えられます。


Net8について

Net8は、どのようなネットワーク間においてもクライアント対サーバーおよびサーバー対サーバーの両方の通信を可能にする、Oracle社のリモート・データ・アクセス・ソフトウェアです。Net8では、分散処理および分散データベースの機能がサポートされています。Net8では数多くの通信プロトコルを実行および相互接続することが可能です。Net8は、SQL*NETと下位互換性があります。


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

  関連項目

データベース・ロールを使用することで、エンドユーザーは、アクセス権限がない表に対して問合せを行うレポートを実行することができます。たとえば、最終レポートがデータを表示しない場合でも、給与データなどの重要な情報を含む表を問い合わせることができます。

データベース・ロールはランタイム環境のみでチェックインされます。表に特別なアクセス権限が必要とされる場合、これらの権限がないエンド・ユーザーはその表からデータを取り出すレポートを実行できません。しかし、データベース・ロールがそのレポートに対して定義されている場合、そのロールに対する権限のあるエンド・ユーザーは、Reports Runtime（RWRUN60）を使用して、レポートを実行できます。複数のレポートを実行する場合、Reports Runtimeは現行のレポートに定義されたロールに自動的に切り替わります。

Report Builder内で、データベース・ロールが定義されているレポートをオープンする場合には、ロール・パスワードを入力するように求められます。通常、パスワードを知っているのはレポートの設計者およびDBAのみです。


データベース・ロールが定義されているレポートを実行するためには、エンド･ユーザーはrepファイルでなくrdfファイルを実行してください。


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

  関連項目

外部PL/SQLライブラリとは、レポート定義から独立したPL/SQLプロシージャ、ファンクションおよびパッケージのセットです。外部ライブラリをレポートに連結することによって、何回でもその内容を参照できます。たとえば、BEFORE REPORTトリガーおよびフォーマット・トリガーのどちらからでも連結ライブラリのプロシージャを参照できます。これにより、各アプリケーションに対して同じPL/SQLを再入力する必要がなくなります。


連結ライブラリについて

  制限      [image]  関連項目

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


連結ライブラリの制限について

•	「連結ライブラリ」リストで指定したライブラリをReport Builderが見つけられない場合、ダイアログ・ボックスを適用、レポートを保存またはレポートをオープンするときに警告が表示されます。その中でレポートを実行またはPL/SQLをコンパイルしようとすると、エラーが発生します。

•	「連結ライブラリ」リストは保存されます。次にレポートまたはライブラリをオープンするときも、リストは最後にレポートを保存したときと同じ内容です。

•	外部ライブラリが他のライブラリを参照する場合、最初のライブラリが2番目のライブラリに既に連結されていても、どちらもレポートに連結する必要があります。


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

  関連項目

Report Builderは、次のルールに従ってレポート・レイアウトをデフォルトに設定します。

1	特に指定がなく、デフォルトの書式が置き換えられている場合を除き、「横」方向のグループは、デフォルトで同じ「縦」方向のグループになります。「横」グループのデフォルト化を素早く判断するには、次のことを行ってください。

•	半透明の用紙にグループに対する縦レイアウトを描く。

•	本のページのようにページをめくる。

•	ページを反時計回りに90°回転する。

2	フォーム・レター・レポートでは、すべてのデフォルトのフィールドは隠され、「水平拡張度」設定が「可変」で、「垂直拡張度」設定が「固定」です。他のすべてのレポートでは、すべてのデフォルトのフィールドは「水平拡張度」および「垂直拡張度」設定が「固定」です。

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

注意: フォーム・レター・レポートおよびメール・ラベル・レポートに対して、CHAR（デフォルトの幅を減らす場合）およびLONGフィールドのデフォルト値は、「水平拡張度」および「垂直拡張度」設定が「固定」です。このため、データ・サイズがフィールド・サイズより大きい場合には、フィールド値は切り捨てられます。

3	1つ以上の選択フィールドの「水平拡張度」または「垂直拡張度」設定が「可変」の場合、Report Builderは「縦」レポートに対して次のことを行います。

•	可変サイズのフィールドを所有する繰返し枠と同じ幅で、1つのフィールドの長さのM_groupname_EXPという枠を作成する。

•	その右または左にあるすべての他のフィールドと可変幅フィールドの周りに枠を置く。これにより、「可変」フィールドが数行にまたがる場合でも、「可変」フィールドの左右のすべてのフィールドが確実に「同じ行から」印刷されます。

4	「横」レポートに対して、前述のルールを置き換えます。

5	グループでなく、レポートによって所有される集計は、すべてのレポート・レイアウト・スタイルで使用可能です。それらは次の方法でフォーマットされます。

•	レイアウトがフォーム形式、フォーム・レターまたはメール・ラベルのいずれかの場合、集計はサマリー列になります。サマリー列はそのレポート・スタイルに対する他のデータベースの列と同じようにフォーマットされます。

•	レイアウト・スタイルが表、グループ左/上またはマトリックスのいずれかの場合で、かつ集計によってそのファンクションを実行する列を選択していない場合、集計はサマリー列になります（前述のとおりフォーマットされます）。それ以外の場合、集計はレポート集計になります。この集計はレポートの終わりで、フィールドの左にラベルを付けて（空間があれば）左揃えにフォーマットされます。

6	レイアウト・スタイルが表、グループ左/上またはマトリックスのいずれかの場合、集計処理を行う列を選択していなければ、デフォルトによりサマリーはデータベースの列に似た形になります。それ以外の場合、サマリーはデフォルトの集計（つまりM_groupname_FTR枠内の表示）に似た形になります。

7	レイアウト・スタイルが表、グループ左/上またはマトリックスの場合、Report Builderでは次の順序で1行ごとに1つのサマリーが埋め込まれます。

•	合計

•	平均

•	最小値

•	最大値

•	カウント

•	最初

•	最後

•	割合（%）

•	標準偏差

•	分散

8	レイアウト・スタイルが表、グループ左/上またはマトリックスの場合、サマリー・ラベルはグループ・フッター枠（M_groupname_FTR）の左の端に表示されます。ラベルを完全に表示する空間がない場合、ラベルは切り捨てられます。


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

  関連項目

Report Builderでは実行時に暗黙的アンカーがボディ領域に作成されます。マージン・アルゴリズムは多少異なります。

ボディ・アルゴリズム

マージン・アルゴリズム


ボディ・アルゴリズム

  関連項目

1	どのオブジェクトが枠の繰返し枠に（直接または間接的に）完全に囲まれていないか、または枠、繰返し枠に（直接または間接的に）囲まれているオブジェクトに明示的にアンカーされていないかを判別します。これらのオブジェクトをタイプAオブジェクトと呼ぶことにします（タイプAオブジェクトは通常グループ枠および繰返し枠、枠または繰返し枠に所有されていないユーザーが作成したその他のオブジェクトなどです）。メニュー項目、ボタンなどが現行のコンテキストで使用できる（つまり、キーボードやカーソルおよびマウスの入力に応答する）ことを表すインタフェース要素の状態:

•	両方のオブジェクトが同じ領域に属する（ボディまたはマージン）。

•	2つのうち外側のオブジェクトが枠または繰返し枠である。

•	2つのうち外側のオブジェクトが他方のオブジェクトの後ろにある。

•	2つのうち内側のオブジェクトが完全に他方のオブジェクトの境界内にある。

2	枠または繰返し枠のすべての子オブジェクト（これらは非タイプAオブジェクトです）を判別します。これらのオブジェクトをタイプBオブジェクトと呼ぶことにします。

3	タイプAおよびタイプBオブジェクトに対して別々に次のことを行います。

•	同じタイプ（たとえばタイプA）で、同じレイヤーにあるすべてのオブジェクトを見つける。

•	それらのオブジェクトのうち、そのタイプの他のオブジェクトを"押し出す"可能性があるものを判別する。「水平拡張度」または「垂直拡張度」（あるいはその両方）の設定が「可変」または「拡張」、2番目のオブジェクトがその"押される領域"内（つまり、成長する領域内）に位置する場合に、そのタイプの他のオブジェクトを"押し出す"可能性があります。また、「水平拡張度」または「垂直拡張度」（あるいはその両方）の設定が「可変」または「縮小」である繰返し枠も"押される領域"（つまり、印刷方向）を持ちます。

•	オブジェクトの組を作成する。各組には押す側（つまり成長するオブジェクト）と押される側（つまり押し出される側のオブジェクト）を含める必要があります。これらの組を作成する場合、押される側のオブジェクトは明示的アンカーの子にはなれません（これらのオブジェクトは無視されます）。

•	次のループを実行する。各組に対して、押す側と押される側の間の"押される領域"内での距離を判断します。次に、最短距離の組を見つけます。最後に、このアルゴリズムを使用してこれらの2つのオブジェクトの間に暗黙的アンカーを作成します。

•	"押される領域"の方向が「縦」の場合、押される側のオブジェクトの上0%を押す側のオブジェクトの下0%にアンカーします。

•	"押される領域"の方向が「横」の場合、押される側のオブジェクトの左0%を押す側のオブジェクトの右0%にアンカーします。

•	これで、その組が1つのオブジェクトのように扱われます。他のすべてのオブジェクトが1つのアンカーを持つまで、または残りのアンカーされていないオブジェクトを押し出すものがなくなるまで、ループを続けます。

•	残りのアンカーされていない各オブジェクトに対して、オブジェクトの左上隅からボディ領域の左上隅に暗黙的アンカーを作成します。

•	次のレイヤーに移動し、手順のステップ1から行います。

ルール:

1	オブジェクトが2つの他のオブジェクトの"押される領域"の中にあり、他の2つのオブジェクトから等距離である場合、オブジェクトの暗黙的アンカーがレポートの実行の間に変わることがあります。たとえば、下の図ではこのような場合の例を2つ示します。

  ここをクリックしてください。

最初のケースでは、M_SumsがB_Text1およびR_Enameの"押される領域"の中にあります。M_SumsはB_Text1およびR_Enameから等距離なので、暗黙的アンカーの判別のための通常の基準（最短距離）はこの場合適用されません。このため、フォーマット・アルゴリズムでは、M_SumsとB_Text1または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またはR_Mgrのどちらかの間に実行時に無作為に暗黙的アンカーが作成されます。この動作を避けるために、B_Text3からオブジェクトの1つへ明示的アンカーを作成することもまたはR_EnameおよびB_Text2の間の明示的アンカーを削除することもできます。明示的アンカーを削除すると、R_MgrがM_Empの子孫として扱われるため、暗黙的アンカーが常にB_Text3とM_Empの間に作成されます。

（ケース2は、ほとんどの場合、レイアウト・エディタ内でオーバーラップするオブジェクトの枠を持つことが一般的なキャラクタ･モードで発生します)。


マージン・アルゴリズム

  関連項目

Report Builderは、ボディ・アルゴリズムを使用して、マージン領域にあるすべてのタイプBオブジェクトに対して暗黙的アンカーを作成します。ただし、各タイプAオブジェクトに対しては、Report Builderによりオブジェクトの左上隅からマージンの左上隅に暗黙的アンカーが作成されます。タイプAオブジェクトが暗黙的に他のタイプAオブジェクトにアンカーされることはありません（これにより、タイプAオブジェクトが確実にページから押し出されないようになります。ただし、同じレイヤーに他のタイプAオブジェクトがある場合には、それによって上書きされることがあります）。


印刷条件アルゴリズム

  関連項目

Report Builderは実行時にオブジェクトの「印刷オブジェクト・オン」プロパティを定義します。

1	オブジェクトに対して「印刷オブジェクト・オン」プロパティを指定した場合には、Report Builderはその設定を使用します。

2	「印刷オブジェクト・オン」プロパティに「デフォルト」を指定した場合には、Report Builderはそれを「第1ページ」または「最終ページ」に設定します。オブジェクトが暗黙または明示的アンカーの子であり、その親が「印刷オブジェクト・オン」プロパティの「全ページ」または「最初のページ以外の全ページ」、「最後のページ以外の全ページ」に設定されている場合には、Report Builderはそれを「第1ページ」に設定し、「基本印刷オン」プロパティを「インクローズ・オブジェクト」に設定します。オブジェクトが暗黙または明示的アンカーの子であり、その親がその他の「印刷オブジェクト・オン」プロパティに設定されている場合には、Report Builderはそれを「最終ページ」に設定します。そうでなければ、ボディ領域に暗黙的にアンカーされているオブジェクトに対して、Report Builderはそれを「第1ページ」に設定します。


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

  関連項目

プレビューアでレポート出力を検査する必要がない場合（十分にテストされたレポートから大量に出力する必要がある場合または複数のレポートを連続して実行する必要がある場合など）、レポートをバッチで実行できます。これにより、レポートを実行しながらその他の作業を自由に行うことができます。

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


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

  関連項目

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

•	パラメータおよびその有効化トリガー

•	物理ページ・サイズ

•	論理ページ・サイズ

•	キャラクタ/ビットマップ・モード

•	マージン位置

•	パネル印刷順序

•	「最大水平ボディ・ページ」プロパティ

•	「最大垂直ボディ・ページ」プロパティ

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

注意: テンプレートは、デフォルトで現行のレポート・セクション（レイアウト・モデル・ビューに表示されるセクション）に適用されます。どのセクションも表示されていない場合は、デフォルトでレポートのメイン・セクションに適用されます。オブジェクト・ナビゲータでレポート全体のノードを選択すると、テンプレートはデフォルトでレポートのメイン・セクションに適用されます。レポートの特定のセクションにテンプレートを適用するには、オブジェクト・ナビゲータで、そのセクションのノードを選択します。


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

  制限	  関連項目

スタイル・シート（すなわちカスケード・スタイル・シート）は、高度なフォーマットの柔軟性を提供するHTMLの拡張です。スタイル・シートをサポートしていることで、HTML文書では次のことができます。

•	任意のフォント・サイズまたはスタイルの挿入

•	部分的に重なり合うオブジェクトの挿入

•	任意の色または幅の水平および垂直な線と四角形の挿入

•	ページ上のオブジェクトの正確な位置設定

•	ページ区切りの挿入

•	Webブラウザからの印刷

•	インライン・イメージ・マップの挿入

つまり、レポートをHTML文書としてフォーマットすると、レポートを洗練された書式にできます。スタイル・シートで機能が拡張されていないと、HTML文書には、基本的なテキスト形式とインポートされたイメージしか表示されません。スタイル・シートを使用すると、高度なフォーマット形式のイメージは同等のスタイルおよびカラー、フォントのテキスト・オブジェクトになります。テキスト・オブジェクトは、イメージ・オブジェクトの上に重ねて配置できます。すべてのテキストは検索可能で、イメージをダウンロードする必要はほとんどありません。

スタイル・シートを利用したHTML文書を表示するには、スタイル・シートをサポートしているブラウザ（Microsoft Internet Explorer 3.01など）で表示してください。


スタイル・シートの制限

HTMLスタイル・シートの拡張でサポートされていない要素は次のとおりです。

•	楕円および円弧、多角形/折れ線、対角線

•	角の丸い四角形（四角形としてフォーマットされる）

•	矢線

•	破線とオブジェクトの輪郭


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

  制限 	  関連項目

「レポート前」、「レポートの間」またはフォーマット・トリガーを使用して、レポートの書式に従ってプリンタ・トレイを切り替えることができます。これにより、1つのレポートのページを簡単に別々の紙に印刷できます。

「ページ設定」ダイアログで、ご使用のプリンタ用に定義されているプリンタ・トレイの名前を確認し、SRW.SET_PRINTER_TRAY（PRINTER_INTRAY属性）を使用して希望のプリンタ・トレイを設定します。


プリンタ・トレイの制限

•	Motif版のPCLプリンタにレポートを出力する場合は、プリンタ・トレイの設定は無視されます。レポートは、デフォルトの設定を使用して処理されます。


参照カーソル問合せについて

  関連項目

参照カーソル問合せはPL/SQLを使用してデータをフェッチします。各参照カーソル問合せは、強分類型参照カーソルを戻すPL/SQL関数に関連付けられます。この関数は、参照カーソルがオープンされ、参照カーソルの型に一致するSELECTリストを持つSELECT文に関連付けられる必要があります。

以下のことを行う場合は、参照カーソルの問合せを基盤とします。

•	より簡単なSQL管理

•	レポート内で字句パラメータを使用

•	データソースをForm Builderなど他のアプリケーションと共有

•	コントロールおよびセキュリティの強化

•	論理をサブプログラム内にカプセル化

また、ストアド・プログラム単位を使用して参照カーソルをインプリメントする場合、Oracleデータベースにプログラム単位を格納できるという恩恵を受けます。

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


カーソル変数について

カーソルと同様に、カーソル変数は複数行問合せからの結果セットを指します。しかし、定数が変数と異なるように、カーソルはカーソル変数と異なります。カーソルがスタティックであるのに対して、カーソル変数は特定の問合せに拘束されないのでダイナミックです。型の互換があるどのような問合せに対してもカーソル変数をオープンできます。これにより、柔軟性が向上します。


ストアド・プログラム単位について

  関連項目

ストアド・プログラム単位(ストアド・サブプログラムとしても知られる)を個別にコンパイルし、すぐに実行できる形でOracleデータベースに永続的に格納できます。コンパイルされ、データ・ディクショナリに格納されると、ストアド・プログラム単位は、そのデータベースに接続されたアプリケーションが参照できるスキーマ・オブジェクトになります。

ストアド・プログラム単位は、高い生産性、高いパフォーマンス、メモリの節約、アプリケーションの整合性および確実なセキュリティを提供します。たとえば、ストアド・プロシージャおよびストアド・ファンクションのライブラリの近くにアプリケーションを設計することにより、冗長なコード化をなくし生産性を向上できます。

ストアド・プログラム単位は、解析済み、コンパイル済みのフォームで格納されます。したがって、ストアド・プログラム単位がコールされたときに、ロードされ、PL/SQLエンジンにすぐに渡されます。また、ストアド・プログラム単位は共有メモリーを利用します。したがって、複数ユーザーが実行する場合、プログラム単位のコピーを1つのみメモリーにロードする必要があります。


RTF出力について

  関連項目

Report Builderは、レポート出力用にリッチ・テキスト・フォーマット(RTF)をサポートしています。RTFは、Microsoft Wordなど多くのワープロ・ソフトウェア・パッケージで読み込めるコード化テキスト書式のフォームです。ソフトウェアの編集およびグラフィック機能を使用して、レポート出力を修正、拡張することができます。RTFファイルにレポート出力を生成する場合に、MAPI応諾ユーティリティを使用して、レポートを電子メール送信することもできます。

使用上の注意

•	グラフィックおよびテキストをオーバーラップできます。

•	テキストを90度回転のみできます。

•	PDF出力と同様に、オブジェクトのフォア・グラウンド・カラーは塗りカラーとして使用されます(指定したパターンとは無関係)。

注意: いったんレポートをRTFファイルに出力したら、同じファイルからレポートをインポートできません。また、Office 95のMicrosoft Wordでレポートを表示する場合、レポート内のすべてのグラフィックおよびオブジェクトを表示するには、「表示」 [image] 「ページ・レイアウト」を選択する必要があります。


条件付き書式について

  関連項目

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

以下のどれかの方法で、ライブ・プレビューア表示またはレイアウト・モデル表示から「条件付き書式」ダイアログ・ボックスを表示できます。

•	オブジェクトをダブルクリックしてプロパティ・パレットを表示する。「標準レイアウト」ノードで、（…というラベルが付いた）条件付き書式の値フィールドをクリックします。

•	オブジェクトのポップアップ・メニューを表示する(ウィンドウで右クリック)。

•	オブジェクトをクリックし、続いて「書式」 [image] 「条件付き書式」を選択します。

「書式の例外」ダイアログ・ボックスで現行のレイアウト・オブジェクトの条件および書式を指定した後、すべての定義がPL/SQLフォーマット・トリガーにエクスポートされます。レイアウト・オブジェクトのフォーマット・トリガーがすでに存在する場合、Report Builderプロンプトを確認するときに、「書式の例外」ダイアログ・ボックス内の定義は既存のトリガー・コードを上書きします。

PL/SQLエディタを使用してフォーマット・トリガーを手動で編集できます。 その後で「書式の例外」ダイアログ・ボックスを使用して定義を修正する場合、Report Builderでは既存のフォーマット・トリガーを上書きするためにプロンプトを表示します。


Webプレビューアについて

 関連項目

以下の書式で、Webブラウザでレポートをプレビューできます。

•	HTML

•	HTML、スタイル・シート拡張子付き

•	PDF

「表示」 [image] 「Web上でプレビュー」 [image] 「Webブラウザに生成」を選択すると、PDFまたはHTMLスタイル・シート・ファイルに生成することを選択していない場合には、Report Builderによりデフォルトで一時HTMLファイルにレポートが生成されます。一時ファイルをWebブラウザに表示する場合は、レポート出力をHTMLまたはPDFファイルとして保存できます。

現在コンピュータに複数のWebブラウザをインストールしている場合、「表示」 [image] 「Webプレビュー」 [image] 「Webブラウザに生成」を最初に選択するときに、Report Builderは使用するブラウザを選択するように促します。

レポート出力のすべてのページまたは現行ページのみを表示するように選択できます。Report Builderはレポートの現行ページを表示するようにデフォルト設定します。


レポート・タイトルについて

  関連項目

以下のどれかの方法で、レポートにタイトルを追加できます。

•	手動で、レイアウト・モデル表示のマージンでボイラープレート・テキスト・オブジェクトを作成します。

•	レポート・ウィザードのスタイル・ページの「タイトル」フィールドに入力します。

レポート・ウィザードを使用してタイトルを追加し、レポート出力のテンプレートを選択しない場合、Report Builderにより定義したデフォルト属性を持つタイトルがレポートのマージンに挿入されます。この属性はレイアウト・モデル表示で修正できます。

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

•	B_OR$REPORT_TITLEが存在する場合、レポート・ウィザードで入力したテキストを持つこのオブジェクトの属性を使用してタイトルが表示されます。

•	B_OR$REPORT_TITLEが存在しない場合、選択したテンプレートの（プロパティ・パレット内の「タイトル」ノード下の）デフォルト・プロパティにより定義された属性を使用してタイトルが表示されます。

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

追加デフォルト・レイアウト・ツールを使用して作成したレイアウトでは、タイトルがレポート・マージンにではなく、新規レイアウトにグループ・タイトルとして挿入されます。この場合、属性は選択したテンプレートの（プロパティ・パレット内の「タイトル」ノード下の）デフォルト・プロパティごとに設定され、B_OR$REPORT_TITLEは無視されます。テンプレートを選択しない場合は、タイトルにReport Builderが定義したデフォルト属性が使用されます。


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

  関連項目

リンク不可問合せとは、列対列リンクによる問合せのリンクを妨げる列オブジェクトを含む詳細問合せのことです。このようなリンクを作成しようとすると、メッセージ・ダイアログ・ボックスが表示され、グループ対グループ問合せを（親グループを使用して）作成するか、操作を取り消すかを選択するように求められます。リンク不可問合せでは、タイトル・バーに [image] が表示されます。

かわりに、2つの問合せの間でグループ対グループ・リンクを作成し、子問合せのSELECT文にWHERE句を追加して、バインド変数を使用して親列を参照することができます。

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

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


Report BuilderにおけるOracle8ラージ・オブジェクトについて

  関連項目

Oracle8ラージ・オブジェクト(LOB)を使用すると、Report Builderが使用する一時領域の量を低く抑えることができます。コマンド・ラインから、クライアント上でLOBをキャッシュするかどうかを指定できます。LOBをキャッシュしないように指定すると、Report BuilderはかわりにLOBへの参照を格納するようになり、LOBを一時ファイルにキャッシュしなくなります。これにより、必要となる一時領域の量は減少しますが、列の値を常にデータベースから取り出す必要があるため、パフォーマンスは低下します。

LOBのキャッシングは、コマンド・ラインからしか指定できません。


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

  制限 	  関連項目

デリミタ付き出力を使用すると、デリミタ（文字または文字列）を指定して、レポート出力のデータを区切ることができます。この機能を使用して、Microsoft Excelなどのスプレッドシート・ユーティリティに簡単にインポートできるレポート出力を作成できます。

デリミタは、次のどちらかの方法で指定します。

•	コマンド・ラインからDELIMITERパラメータを使用して指定する。

•	「デリミタ付き出力」ダイアログ・ボックスの「デリミタ」オプションを使って指定する。このダイアログ・ボックスは、Report Builderリリース6.0以降の米語版でのみ使用可能であることに注意してください。

デリミタ付き出力を生成するときに、セルの囲みを使用してセルをさらに区別することができます。セルの囲みは、カンマやカッコなどの一連の文字列から成ります。

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

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

使用上の注意

デリミタ付き出力を生成すると、データはレイアウト・モデル表示のオブジェクトの位置に従って表示されます。

•	AをBの上または左に配置すると（AとBをボイラープレート・オブジェクトまたはフィールド・オブジェクトとした場合）、出力のすべての行でAの各インスタンスがBの各インスタンスより前に表示されます。

  ここをクリックしてください。

•	ボイラープレート・オブジェクト(A)を含み、フィールド・オブジェクト(B)を含む繰返し枠を囲む枠を作成すると、Aの各インスタンスはBの各インスタンスとともに表示されます。

  ここをクリックしてください。

•	前のレイアウトで、ボイラープレート・オブジェクト(C)を含み、フィールド・オブジェクト(D)を含む別の繰返し枠を囲む枠をもう1つ追加すると、Bのすべてのインスタンスに対してAが表示され、Dのすべてのインスタンスに対してCが表示されます。

  ここをクリックしてください。

•	レポートにマトリックスを作成する場合は、レイアウト・モデル表示の格子に沿って慎重にオブジェクトを整列させてください。オブジェクトが整列していないと、Report Builderが余分なスペースを追加の行または列と解釈し、レポート出力が乱れる可能性があります。

•	ボイラープレート・オブジェクトをマトリックスの外側に作成すると、ボイラープレートの各インスタンスがマトリックスのすべての行（列ではなく）で繰り返されます。マトリックスに含まれるボイラープレートは、フィールド・オブジェクトがマトリックスの外側にあっても繰り返されないことに注意してください。

  ここをクリックしてください。


チャート・ハイパーリンクについて

  例      [image]  関連項目

HTML出力やPDF出力のチャート・セクションを、レポート出力内の任意のオブジェクト（フィールドや繰返し枠のインスタンスなど）や別のレポート、その他の有効なハイパーリンクの宛先に関連付けることができます。レポート出力で、ユーザーがチャート・セクションをクリックすると、そのセクションに関する詳細にアクセスしたり、別のレポートにドリルダウンできるようになります。

Webウィザードの「チャート・ハイパーリンク」ページを使用してチャート・ハイパーリンクを自動的に作成することも、プロパティ・パレットで「チャート・ハイパーリンク」プロパティを明示的に設定することもできます。


レポートのセクション化について

  関連項目

レポートのセクション化を使用すると、同じレポート内にそれぞれ異なる対象読者、出力書式、ページ・レイアウト、ページ･サイズまたは方向が設定された複数のレイアウトを定義できます。レポートにはセクションを3つまで定義でき、それぞれにボディとマージンの領域を設定できます。以前のリリースとの互換性を保つために、各セクションの名前はヘッダー、メイン、トレーラになっています。デフォルトでは、レポートはメイン・セクションに定義されます。他のセクションには、複数の個別のレポートを作成するよりも、むしろ異なるレイアウトを定義します。たとえば1つのレポートで、あるセクションには上級管理職向けのエグゼクティブ・サマリーを入れ、別のセクションには個々のマネージャ向けの詳細な内訳を入れることができます。

ヘッダー・セクションとトレーラ・セクションのマージンとボディを使用すると、以前のリリースと同じようにヘッダー・ページとトレーラ・ページを作成できます。今後のリリースでは、セクションの追加と削除が行えるようになります。

オブジェクト・ナビゲータでは、レポートの各セクションは「レイアウト・モデル」ノードの下に、「ヘッダー・セクション」、「メイン・セクション」、「トレーラ・セクション」として公開されます。


他の意思決定支援ツールとの統合について

Oracle DiscovererおよびOracle Expressとの組合せにより、Reportsは生産報告や非定型の問合せから高度な分析に至る、企業のあらゆる範囲の意思決定支援のニーズに対応する高品質な技術を提供します。この統合ソリューションは、開発および配置のコストを軽減すると同時に、卓越した使いやすさと比類のないパフォーマンスを実現します。

作成したDiscovererのワークシートは、動的Webレポートに即座に変換し、組織全体に公開することができます。ワークシートをレポートに変換する詳しい方法は、Discovererのマニュアルを参照してください。

Report Builderでは、Expressの単位とディメンションを基にレポートを作成できます。レポート・ウィザードでは、Expressへの問合せを作成するか、SQL問合せを作成するかを選択できます。「Express Query」ダイアログ・ボックスで、レポートで使用するデータベース、単位およびディメンションを選択します。Express Selectorなどの使い慣れたExpressツールを使って、問合せをさらに細かく設定できます。Expressへの問合せの作成が終了した後は、他のレポートと同じようにレポート・レイアウトをすばやく生成したり、修正したりできます。


レポートの配布について

  関連項目

レポートの配布を使用すると、レポートを1回実行するのみで、複数の出力書式を生成し、複数の宛先に配布できるレポートを設計できます。配布は、レポート全体に対して作成することも、レポートの個々のセクションに対して作成することもできます。

たとえば、レポートを1回実行するのみで、HTML出力を生成し、PostScript版をプリンタに送り、レポートの一部または全部のセクションを電子メールで配布リストに送信することができます。これまでのリリースでは、出力書式または宛先ごとにレポートを再実行する必要がありました。

レポートの配布は、次のどちらかの方法で指定します。

•	「配布」ダイアログ・ボックスを使用する。

•	コマンド・ラインから、.DSTファイルを指定するDESTINATIONキーワードを使用する。

注意: これらの方法で指定した配布を使用可能にするには、次の操作を行います。

•	「ファイル」 [image] 「配布」を選択します。

•	コマンド・ラインでDISTRIBUTE=YESを指定します。

実際にはレポートを配布せずにレポートの配布をチェックするには、どの配布リストが使用されたかを示すレポートの配布をトレースします。この情報を使用して、どのセクションがどの宛先に送られたかを調べることができます。

使用上の注意

•	1つのレポートにキャラクタ・モードとビットマップの出力を混在させることはできません。MODEパラメータには、レポート全体につき1つの値（DEFAULT、BITMAPまたはCHARACTER）しか設定できません。したがって、1つのレポート内に両方を設定することはできません。


.DSTファイルについて

  例      [image]  関連項目

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

コマンド・ラインから.DSTファイルを指定すると、このファイルで定義された配布が、「配布」ダイアログ・ボックスで定義された配布を上書きします。

レポートの配布をトレースすれば、トレース・ファイルの書式（「配布」チェックボックスがチェックありになっていると生成される）は.DSTファイルの書式と非常によく似ているので、トレース・ファイルからカット・アンド・ペーストで.DSTファイルを生成できます。

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

dist_IDoutput_def

ここで

dist_ID	配布先の識別子。
output_def	配布定義を指定する一連のRWRUN60またはRWCLI60コマンド・ライン・オプション。この他に、次のパラメータを指定できます。
	LEVEL	配布の範囲を指定します。 値 REPORTは、配布がレポート全体に適用されることを意味します。 HEADER_SECTIONは、配布がヘッダー・セクションのみに適用されることを意味します。 MAIN_SECTIONは、配布がメイン（ボディ）セクションのみに適用されることを意味します。 TRAILER_SECTIONは、配布がトレーラ・セクションのみに適用されることを意味します。 デフォルト REPORT


.DSTファイルの例

  関連項目

/* この例の定義は、レポート出力を
** HTMLファイルに送り、メイン・セクション3部を
** プリンタに送り、ヘッダー・セクションを
** PDFファイルに送ります。
*/

;dst file
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


HTMLページ・ストリームについて

  関連項目

HTMLページ・ストリームを使用すると、レポート全体をダウンロードすることなく、HTML/HTMLCSSレポート出力の個々のページをWebブラウザに表示できます。レポートの最初のページから、他のどのページにでも移動することができます。宛先が設定されたブックマークまたはハイパーリンクをクリックすると、次の処理が行われます。

•	レポート内では、現行のページを含む枠が宛先のページに更新されます。

•	レポート外では、基本枠全体（ブックマーク枠、ページおよびナビゲーション枠を含む）が再ロードされます。

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

ページ間のナビゲーション・コントロールを提供するには、次のどちらかの方法を用います。

•	Report Builderに備わっているビルトインのJavaScriptを使用します。

•	独自のJavaScript（または他のスクリプト）を提供します。

独自のスクリプトを提供する場合は、次の3つの変数をスクリプトに組み込む必要があります。

•	&TotalPages（合計ページ数）

•	&file_name（出力宛先ファイルの名前。 例 myreport）

•	&file_ext （ファイル拡張子。例 htm）

Report Builderによって、書式設定時にこれらの変数が割り当てられます。

ページ・ナビゲーション・コントロール枠の高さは、スクロール・バーなしで70ポイントにハードコードされます。枠の幅は可変です。この枠の中でアイコンやイメージを使用する場合は、これらの寸法を覚えておいてください。

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

•	PL/SQL（Before ReportトリガーのSRW.SET_PAGE_NAVIGATION_HTML）を使用します。

•	レポート・プロパティ・パレットで「ページ・ナビゲーション・コントロール・タイプ」および「ページ・ナビゲーション・コントロール値」プロパティを使用します。

出力ファイル名

HTMLページ・ストリームでは、各ページが個別のHTMLドキュメントとしてフォーマットされます。HTMLファイルの名前がmyreport.htmで、ブックマークが含まれていない場合、新しいファイルの名前は次のようになります。

•	myreport.htm（基本枠）

•	myreport_1.htmからmyreport_n.htm（ページ）

•	myreportj.htm（ナビゲーションJavaScript）

HTMLファイルにブックマークが含まれている場合は、新しいファイルの名前は次のようになります。

•	myreport.htm（基本枠）

•	myreportb.htm（ブックマーク・ファイル）

•	myreport_1.htmからmyreport_n.htm（ページ）

•	myreportj.htm（ナビゲーションJavaScript）

HTML出力の範囲

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

ページ・ストリーム出力を使用可能にする

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


デリミタ付き出力の制限

テキスト・ファイルに、最初のフィールドとして"ID" (大文字)というラベルが付いたフィールドが含まれている場合は、Microsoft Excelでそのファイルを開くことはできません。次のデリミタ付き出力は、Excelでエラーが発生します。

ID、名前、タイトル、部門など。

IDフィールドを含むデリミタ付き出力を生成する場合は、データベースの列名をidのように小文字に変更するか、フィールドの順序を再度調整してみてください。


XML出力について

 関連項目

XML (Extensible Markup Language) では、構造化情報を定義するタグ付きデリミタ出力が生成されます。XMLは、Webを介して公開するためのみでなく、電子データをサードパーティ・アプリケーション（EDI）と交換するために使用できます。

ユーザが編集可能なXMLタグは、デフォルトで、表、グループ左、グループ上およびマトリックス・レポート内のデータに割り当てられます。XML出力の構造化の詳細はXML プロパティを参照してください。

XMLファイル生成の詳細は、XML出力の生成を参照してください。


delim1_bmp


delim2_bmp


delim3_bmp


delim4_bmp


レポートの移動

オペレーティング・システムのファイルに保存されているレポートをデータベースに移動するかまたはその逆の移動を行うには、次のうちのいずれかを行います。

•	レポートをオープンしてから、「ファイル」 [image] 「別名保存...」を選択します。レポートをデータベースまたはファイルに保存します。希望する場合は、（ファイルの場合は）オペレーティング・システム・コマンドまたは（データベースの場合は）「ファイル」 [image] 「管理」 [image] 「削除」を使って、元のレポートを削除できます。

•	RWCON60を使用します。


モジュールの削除

オペレーティング・システムのファイルに保存されているモジュールを削除するには、適切なオペレーティング・システム・コマンドを使ってファイルを削除します。

データベースからモジュールを削除するには、次のいずれかを行います。

•	「ファイル」 [image] 「管理」 [image] 「削除」を選択してから、削除するモジュール（レポートまたは外部問合せ、外部PL/SQLライブラリ）を選択します。

•	droprep.sqlスクリプトを使用して、データベースからレポートを削除します。


レポートの文書化

1つ以上のレポートについて文書を印刷するには、「ファイル」 [image] 「管理」 [image] 「レポート文書」を選択します。これは、データベースに保存されたレポートに関してレポートを実行します。プロンプトが出たら、レポート名の全部または一部を入力して、実行対象とするレポートを指示します。%または_は、情報を得たいレポートを指示するためのワイルドカードとして使用できます。


Report Builderで使用されているファイル

作成するファイル

この表は、使用される実行プログラムおよび実行される操作によって、Report Builderにどのファイルを入力として与える必要があるかを示しています。

ファイルタイプ	RWBLD60	RWRUN60	RWCON60
レポート定義ファイル <report name>.rdf	STYPEが RDFILEの場合の「実行/印刷」および「変換」	必ずこのファイルまたは.REPファイルが必要	SOURCEでは、STYPEがRDFILEの場合
レポート実行ファイル <report name>.rep	-	必ずこのファイルまたは.RDFファイルが必要	-
レポート・テキスト・ ファイル <filename>.rex	STYPEが REXFILEの場合の「変換」	-	SOURCEでは、STYPEがREXFILEの場合
端末記述ファイル（キャラクタ・モードのみ）	常に	BATCHが「NO」の場合	-
キーストローク・ファイル（キャラクタ・モードのみ）	KEYINが指定されている場合	KEYINが指定されている場合	-
V2.0プリンタ記述 ファイル <dflt>	「実行」	常に	-
V1.1プリンタ定義 ファイル <printdef.dat>	-	-	-

Report Builderによって作成されるファイル

この表は、使用される実行プログラムおよび実行される操作によって、Report Builderがどのファイルを作成するかを示しています。

ファイルタイプ	RWBLD60	RWRUN60	RWCON60
レポート定義ファイル <report name>.rdf	DTYPEが RDFILEの場合の「保存」または「別名保存」、「変換」	-	DESTではDTYPEがRDFILEの場合
レポート実行ファイル <report name>.rep	DTYPEが REPFILEの場合の「生成」または「変換」	-	DESTではDTYPEがRDFILEの場合
レポート・テキスト・ ファイル <filename>.rex	DTYPEが REXFILEの場合の「保存」または「別名保存」、「変換」	-	DESTではDTYPEがRDFILEの場合
レポート出力ファイル <report name>.lis	DESTYPEが FILEの場合の「実行/印刷」	DESTYPEが FILEの場合	-
プロファイラ・ログ・ ファイル <temp>	PROFILERが YESの場合	PROFILERがYESの場合	-
エラー・ログ・ファイル <temp>	ERRFILEが指定されている場合	ERRFILEが指定されている場合	-
トレース・ログ・ ファイル <trace.dat>	TRACEFILEが指定されている場合	TRACEFILEが指定されている場合	-
プリンタ出力ファイル	DESTYPEが PRINTERの場合の「実行/印刷」	DESTYPEがPRINTERの場合	-
キーストローク・ファイル（キャラクタ・モードのみ）	KEYOUTが指定されている場合	KEYOUTが指定されている場合	-
印刷スクリーン・ログ・ファイル（キャラクタ・モードのみ）	PRINT SCREEN	PRINT SCREEN	-
V2.0プリンタ記述 ファイル <dflt>	-	-	-
レコード・キャッシュ・ファイルID<number>  およびdat<number> が必要） <temp>	「実行/印刷」	「実行/印刷」	-
メモリー・スワップ・ ファイル（必要な場合にのみ作成される） <temp>	「実行/印刷」	「実行/印刷」	-


ビルトイン・パッケージ

  関連項目 	  アルファベット順リスト

Oracleでは、PL/SQLベースのアプリケーションを作成したりデバッグする際に使用できるパッケージ・プロシージャをいくつか提供しています。

PL/SQLコードから、次のクライアント側ビルトイン・パッケージのプロシージャ、ファンクション、例外を利用できます。

Report Builderのビルトイン・パッケージ

その他のビルトイン・パッケージ


Report Builderビルトイン・パッケージ

  関連項目 	  すべてのビルトイン

Report Builderには、ビルトイン・パッケージが1つのみあります。

SRW


SRWのビルトイン・パッケージ

  ビルトイン

SRW.ADD_DEFINITION

SRW.APPLY_DEFINTION

SRW.BREAK

SRW.CONTEXT_FAILURE

SRW.DO_SQL

SRW.DO_SQL_FAILURE

SRW.GETTERR_RUN

SRW.GET_PAGE_NUM

SRW.INTEGER_ERROR

SRW.MAXROW_INERR

SRW.MAXROW_UNSET

SRW.MESSAGE

SRW.NULL_ARGUMENTS

SRW.PROGRAM_ABORT

SRW.REFERENCE

SRW.RUN_REPORT

SRW.RUN_REPORT_BATCHNO

SRW.RUN_REPORT_FAILURE

SRW.SETattributes

SRW.TRACE_ADD_OPTION

SRW.TRACE_END

SRW.TRACE_REM_OPTION

SRW.TRACE_START

SRW.TRACEOPTS.MASK

SRW.TRUNCATED_VALUE

SRW.UNKNOWN_QUERY

SRW.UNKNOWN_USER_EXIT

SRW.USER_EXIT

SRW.USER_EXIT20

SRW.USER_EXIT_FAILURE


属性(SRW.SET_ATTR)

  関連項目	  すべてのビルトイン

ACTION

AFTCODE

AFTFORM_ESCAPE

AFTPAGE_ESCAPE

AFTREPORT_ESCAPE

BBCOLOR

BEFCODE

BEFFORM_ESCAPE

BEFPAGE_ESCAPE

BEFREPORT_ESCAPE

BFCOLOR

BOOKMARK

BORDERWIDTH

BORDPATT

FACE

FBCOLOR

FFCOLOR

FILLPATT

FORMATMASK

GCOLOR

GSPACING

HJUST

HYPERLINK

LINKTAG

PRINTER_INTRAY

STYLE

SZ

TEXT

WEIGHT


ACTION

  例 	  制限	  関連項目	  属性(SRW.SET_ATTR)

新機能： この属性は、SRW.SET_PDF_ACTIONプロシージャを使用して設定するほうが適しています。互換性を保つために、SRW.SET_ATTRでもこの属性を設定できるようになっていますが、新しい簡素化されたプロシージャを使用することをお薦めします。

説明 PDFビューア内のオブジェクトがクリックされたとき、ローカル・マシン上で実行されるコマンドです。

注意: アクションに関連付けられたオブジェクトを、Webリンクのソースにすることはできません。

値

ローカル・マシン上の任意の有効なコマンド・ライン（c:\orawin95\bin\rwrun60 userid=scott/tiger report=example.rdfなど）


ACTIONの制限

•	ACTIONは、PDF出力専用です。

•	ACTIONの設定は、次のトリガーに限られます。

フォーマット・トリガー


ACTIONの例

  関連項目 	  すべての例

注意: この例では、ACTION属性の設定にSRW.SET ATTRが使用されています。この属性は、SRW.SET_PDF_ACTIONプロシージャを使用して設定するほうが適しています。互換性を保つために、SRW.SET_ATTRでもこの属性を設定できるようになっていますが、新しい簡素化されたプロシージャを使用することをお薦めします。

/* The format trigger below defines an "action" (in
** this case a call to the Reports Runtime) that
** should be executed when the user clicks on the
** boilerplate object B_2.
*/

function B_2FormatTrigger return boolean is
begin
  srw.attr.mask := srw.ACTION_ATTR;
  srw.attr.action  := 'c:\orawin\bin\rwrun60' ||
  'userid=scott/tiger ' ||
  'report=example.rdf';
  srw.set_attr(0,srw.attr);
  return (TRUE);
end;


AFTCODE

  属性(SRW.SET_ATTR)

新機能： この属性は、SRW.SET_AFTER_PRINTING_CODEプロシージャを使用して設定するほうが適しています。互換性を保つために、SRW.SET_ATTRでもこの属性を設定できるようになっていますが、新しい簡素化されたプロシージャを使用することをお薦めします。

説明  オブジェクトの各行の後で実行されるプリンタ・エスケープ・シーケンスを指します。オブジェクトの印刷がトリガーされた後、実際に印刷される前に、プリンタ・エスケープ・シーケンスが挿入されます。AFTCODEは、キャラクタ・モードでレポートを実行しているときにしか使用されません。

値

&番号形式の文字列。 番号は、パッケージReport Builderプリンタ・エスケープ・シーケンスかまたは自分で作成したプリンタ・エスケープ・シーケンスに割り当てられた番号です。


AFTFORM_ESCAPE

  関連項目	  属性(SRW.SET_ATTR)

新機能： この属性は、SRW.SET_AFTER_FORM_HTMLプロシージャを使用して設定するほうが適しています。互換性を保つために、SRW.SET_ATTRでもこの属性を設定できるようになっていますが、新しい簡素化されたプロシージャを使用することをお薦めします。

説明  HTMLパラメータ・フォームの下に表示する任意のテキスト、図形またはHTMLコマンドです。この属性は、ロゴまたは標準リンクをパラメータ・フォーム上に配置するのに便利です。

値

この属性には、次の2つの項目を指定する必要があります。

•	AFTFORM_ESCAPE_TYPE は、SRW.FILE_ESCAPEまたはSRW.TEXT_ESCAPEに設定されます。

•	AFTFORM_ESCAPE_VALUEには、AFTFORM_ESCAPE_TYPEに指定したものに応じて、ファイル名または有効HTMLを含むテキスト文字列を指定できます。ファイルを指定した場合、ファイル検索メソッドが検索に使用されます。


AFTPAGE_ESCAPE

  例	  制限	  関連項目	  属性(SRW.SET_ATTR)

新機能： この属性は、SRW.SET_AFTER_PAGE_HTMLプロシージャを使用して設定するほうが適しています。互換性を保つために、SRW.SET_ATTRでもこの属性を設定できるようになっていますが、新しい簡素化されたプロシージャを使用することをお薦めします。

説明  ドキュメントのページの最後に表示させたい任意のテキスト、図形またはHTMLコマンドです。この属性は、ロゴまたは標準リンクをHTML文書の各ページの下端に配置するのに便利です。

値

この属性には、次の2つの項目を指定する必要があります。

•	AFTPAGE_ESCAPE_TYPEは、SRW.FILE_ESCAPEまたはSRW.TEXT_ESCAPEに設定可能です。

•	AFTPAGE_ESCAPE_VALUEには、AFTPAGE_ESCAPE_TYPEに指定したものに応じて、ファイル名または有効HTMLを含むテキスト文字列を指定できます。ファイルを指定した場合、ファイル検索メソッドが検索に使用されます。


AFTPAGE_ESCAPEの制限

•	この属性のSRW.SET_ATTRを指定する場合、object_idとしてSRW.REPORT_IDを使用する必要があります。

SRW.SET_ATTR(SRW.REPORT_ID, SRW.ATTR);

•	ページの下端に含まれるデフォルトHTMLを以下に示します。ページ間に表示するデフォルトのセパレータ・ラインが不要な場合は、これは不要です。

<hr size=5 noshade>

•	AFTPAGE_ESCAPEをレポートのすべてのページに適用する場合は、Before Reportトリガーのように、レポートがフォーマットを開始する前に起動するトリガーの中で、それを指定する必要があります。

•	BEFPAGE_ESCAPEを現行のページのみに適用する場合は、そのページ上のオブジェクトに対してフォーマット・トリガーの中で指定する必要があります。


グラフィック・ページ・セパレータの例

  関連項目 	  すべての例

注意: この例では、AFTPAGE_ESCAPE属性の設定にSRW.SET_ATTRが使用されています。この属性は、SRW.SET_AFTER_PAGE_HTMLプロシージャを使用して設定するほうが適しています。互換性を保つために、SRW.SET_ATTRでもこの属性を設定できるようになっていますが、新しい簡素化されたプロシージャを使用することをお薦めします。

/* The example below inserts a GIF file as a
** page separator.
*/

function BeforeReport return boolean is
begin
if ((upper(:MODE) != 'CHARACTER') and
    (upper(:DESFORMAT) = 'HTML')) then
 SRW.ATTR.MASK := SRW.AFTPAGE_ESCAPE_ATTR;
 SRW.ATTR.AFTPAGE_ESCAPE_TYPE := SRW.TEXT_ESCAPE;
 SRW.ATTR.AFTPAGE_ESCAPE_VALUE := '<CENTER>' ||
 '<IMG ALT="Ruler" SRC="line.gif" VSPACE=10>' ||
 '<BR></CENTER>';
 SRW.SET_ATTR(SRW.REPORT_ID, SRW.ATTR);
end if;
return (TRUE);
end;


AFTREPORT_ESCAPE

  例	  制限 	  関連項目 [image]  属性(SRW.SET_ATTR)

新機能： この属性は、SRW.SET_AFTER_REPORT_HTMLプロシージャを使用して設定するほうが適しています。互換性を保つために、SRW.SET_ATTRでもこの属性を設定できるようになっていますが、新しい簡素化されたプロシージャを使用することをお薦めします。

説明  文書の終わりに表示する任意のテキストまたは図形、HTMLコマンドです。この属性は、ロゴまたは標準リンクをHTML文書の終わりに配置するのに便利です。

値

この属性には、次の2つの項目を指定する必要があります。

•	AFTREPORT_ESCAPE_TYPEは、SRW.FILE_ESCAPEまたはSRW.TEXT_ESCAPEに設定してください。

•	AFTREPORT_ESCAPE_VALUEには、AFTREPORT_ESCAPE_TYPEに指定したものに応じて、ファイル名または有効HTMLを含むテキスト文字列を指定できます。ファイルを指定した場合、ファイル検索メソッドが検索に使用されます。


AFTREPORT_ESCAPEの制限

•	この属性のSRW.SET_ATTRを指定する場合、object_idとしてSRW.REPORT_IDを使用する必要があります。

SRW.SET_ATTR(SRW.REPORT_ID, SRW.ATTR);

•	レポートの下端に含まれるデフォルトHTMLを以下に示します。AFTREPORT_ESCAPEを使用してこのテキストを置換する場合、等価のHTMLコマンドが含まれていることを確認する必要があります。

   </body></html>

•	Before Reportトリガーのように、レポートがフォーマットされる前に起動するトリガーの中で、AFTREPORT_ESCAPEを設定する必要があります。


ホーム・ページへのリンクの例

  関連項目 	  すべての例

注意: この例では、AFTREPORT_ESCAPE属性の設定にSRW.SET_ATTRが使用されています。この属性は、SRW.SET_AFTER_REPORT_HTMLプロシージャを使用して設定するほうが適しています。互換性を保つために、SRW.SET_ATTRでもこの属性を設定できるようになっていますが、新しい簡素化されたプロシージャを使用することをお薦めします。

/* The example below inserts two links to home pages
** at the end of the report output.
*/

function BeforeReport return boolean is
begin
if ((upper(:MODE) != 'CHARACTER') and
    (upper(:DESFORMAT) = 'HTML')) then
  SRW.ATTR.MASK := SRW.AFTREPORT_ESCAPE_ATTR;
  SRW.ATTR.AFTREPORT_ESCAPE_TYPE := SRW.TEXT_ESCAPE;
  SRW.ATTR.AFTREPORT_ESCAPE_VALUE := '<CENTER>' ||
  '<A HREF="http://www.oracle.com/">' ||
  'Oracle Corporation</A> -' ||
  chr(10) ||
  '<A HREF="http://home.netscape.com/">' ||
  'Netscape</A> </CENTER>' ||
  '</BODY> </HTML>';
  SRW.SET_ATTR(SRW.REPORT_ID, SRW.ATTR);
end if;
return (TRUE);
end;


BBCOLOR

  属性(SRW.SET_ATTR)

新機能： この属性は、SRW.SET_BACKGROUND_BORDER_COLOR プロシージャを使用して設定するほうが適しています。互換性を保つために、SRW.SET_ATTRでもこの属性を設定できるようになっていますが、新しい簡素化されたプロシージャを使用することをお薦めします。

説明  オブジェクトのバックグラウンド境界色です。この属性はキャラクタ・モードでは無視されます。

値

有効な色の名前。


BEFCODE

  属性(SRW.SET_ATTR)

新機能： この属性は、SRW.SET_BEFORE_PRINTING_CODE プロシージャを使用して設定するほうが適しています。互換性を保つために、SRW.SET_ATTRでもこの属性を設定できるようになっていますが、新しい簡素化されたプロシージャを使用することをお薦めします。

説明  オブジェクトの各行の前で実行されるプリンタ・エスケープ・シーケンスを指します。オブジェクトの印刷がトリガーされた後、実際に印刷される前に、プリンタ・エスケープ・シーケンスが挿入されます。BEFCODEは、キャラクタ・モードでレポートを実行しているときにしか使用されません。

値

&番号形式の文字列。 番号は、パッケージReport Builderプリンタ・エスケープ・シーケンスかまたは自分で作成したプリンタ・エスケープ・シーケンスに割り当てられた番号です。


BEFFORM_ESCAPE

  関連項目	  属性(SRW.SET_ATTR)

新機能： この属性は、SRW.SET_BEFORE_FORM_HTML プロシージャを使用して設定するほうが適しています。互換性を保つために、SRW.SET_ATTRでもこの属性を設定できるようになっていますが、新しい簡素化されたプロシージャを使用することをお薦めします。

説明  HTMLパラメータ・フォームの上に表示する任意のテキストまたは図形、HTMLコマンドです。この属性は、ロゴまたは標準リンクをパラメータ・フォーム上に配置するのに便利です。

値

この属性には、次の2つの項目を指定する必要があります。

•	BEFFORM_ESCAPE_TYPEは、SRW.FILE_ESCAPEまたはSRW.TEXT_ESCAPEに設定してください。

•	BEFFORM_ESCAPE_VALUEには、BEFFORM_ESCAPE_TYPEに指定したものに応じて、ファイル名または有効HTMLを含むテキスト文字列を指定できます。ファイルを指定した場合、ファイル検索メソッドが検索に使用されます。


BEFPAGE_ESCAPE

  例 	  制限 	  関連項目	  属性(SRW.SET_ATTR)

新機能： この属性は、SRW.SET_BEFORE_PAGE_HTML プロシージャを使用して設定するほうが適しています。互換性を保つために、SRW.SET_ATTRでもこの属性を設定できるようになっていますが、新しい簡素化されたプロシージャを使用することをお薦めします。

説明  ドキュメントにあるページの最初に表示する任意のテキスト、図形またはHTMLコマンドです。この属性は、ロゴまたは標準リンクをHTML文書の各ページの先頭に配置するのに便利です。

値

この属性には、次の2つの項目を指定する必要があります。

•	BEFPAGE_ESCAPE_TYPEは、SRW.FILE_ESCAPEまたはSRW.TEXT_ESCAPEに設定してください。

•	BEFPAGE_ESCAPE_VALUEには、BEFPAGE_ESCAPE_TYPEに指定したものに応じて、ファイル名または有効HTMLを含むテキスト文字列を指定できます。ファイルを指定した場合、ファイル検索メソッドが検索に使用されます。


BEFPAGE_ESCAPEの制限

•	この属性のSRW.SET_ATTRを指定する場合、object_idとしてSRW.REPORT_IDを使用する必要があります。

SRW.SET_ATTR(SRW.REPORT_ID, SRW.ATTR);

•	BEFPAGE_ESCAPEをレポートのすべてのページに適用する場合は、Before Reportトリガーのように、レポートがフォーマットを開始する前に起動するトリガーの中で、それを指定する必要があります。

•	AFTPAGE_ESCAPEを現行のページのみに適用する場合は、そのページ上のオブジェクトに対してフォーマット・トリガーの中で指定する必要があります。


BEFPAGE_ESCAPEとAFTPAGE_ESCAPEの例

  関連項目 	  すべての例

注意: この例では、BEFPAGE_ESCAPE属性およびAFTPAGE_ESCAPE属性の設定にSRW.SET_ATTRが使用されています。これらの属性は、SRW.SET_BEFORE_PAGE_HTMLプロシージャおよびSRW.SET_AFTER_PAGE_HTMLプロシージャを使用して設定するほうが適しています。互換性を保つために、SRW.SET_ATTRでもこの属性を設定できるようになっていますが、新しい簡素化されたプロシージャを使用することをお薦めします。

/* The example below centers the document in
** the browser.
*/

function BeforeReport return boolean is
begin
if ((upper(:MODE) != 'CHARACTER') and
    (upper(:DESFORMAT) = 'HTML')) then
  SRW.ATTR.MASK := SRW.BEFPAGE_ESCAPE_ATTR +
                   SRW.AFTPAGE_ESCAPE_ATTR;
  SRW.ATTR.BEFPAGE_ESCAPE_TYPE := SRW.TEXT_ESCAPE;
  SRW.ATTR.BEFPAGE_ESCAPE_VALUE := '<CENTER>';
  SRW.ATTR.AFTPAGE_ESCAPE_TYPE := SRW.TEXT_ESCAPE;
  SRW.ATTR.AFTPAGE_ESCAPE_VALUE := '</CENTER>';
  SRW.SET_ATTR(SRW.REPORT_ID, SRW.ATTR);
end if;
return (TRUE);
end;


BEFREPORT_ESCAPE

  例 	  制限 	  関連項目	  属性(SRW.SET_ATTR)

新機能： これらの属性は、SRW.SET_BEFORE_PAGE_HTMLプロシージャおよびSRW.SET_AFTER_PAGE_HTMLプロシージャを使用して設定するほうが適しています。互換性を保つために、SRW.SET_ATTRでもこの属性を設定できるようになっていますが、新しい簡素化されたプロシージャを使用することをお薦めします。

説明  文書の始めに表示する任意のテキストまたは図形、HTMLコマンドです。この属性は、ロゴまたは標準リンクをHTML文書の先頭に配置するのに便利です。

値

この属性には、次の2つの項目を指定する必要があります。

•	BEFREPORT_ESCAPE_TYPE は、SRW.FILE_ESCAPEまたはSRW.TEXT_ESCAPEに設定可能です。

•	BEFREPORT_ESCAPE_VALUEには、BEFREPORT_ESCAPE_TYPE用に指定したものに応じて、ファイル名または有効HTMLを含むテキスト文字列を指定できます。ファイルを指定した場合、ファイル検索メソッドが検索に使用されます。


BEFREPORT_ESCAPEの制限

•	この属性のSRW.SET_ATTRを指定する場合、object_idとしてSRW.REPORT_IDを使用する必要があります。

SRW.SET_ATTR(SRW.REPORT_ID, SRW.ATTR);

•	レポートの先頭に含まれるデフォルトHTMLを以下に示します。BEFREPORT_ESCAPEを使用してこのテキストを置換する場合、等価のHTMLコマンドが含まれていることを確認する必要があります。

<html>
   <body bgcolor="#ffffff">

•	Before Reportトリガーのように、レポートがフォーマットを開始する前に起動するトリガーの中で、BEFREPORT_ESCAPEを設定する必要があります。


BEFREPORT_ESCAPEとAFTREPORT_ESCAPEの例

  関連項目 	  すべての例

注意: この例では、BEFREPORT_ESCAPE属性およびAFTREPORT_ESCAPE属性の設定にSRW.SET_ATTRが使用されています。これらの属性は、SRW.SET_BEFORE_REPORT_HTMLプロシージャを使用して設定するほうが適しています。互換性を保つために、SRW.SET_ATTRでもこの属性を設定できるようになっていますが、新しい簡素化されたプロシージャを使用することをお薦めします。

/* The example below sets both BEFREPORT_ESCAPE and
** AFTREPORT_ESCAPE in the Before Report trigger.
** The HTML for BEFREPORT_ESCAPE is located in a file
** named logo.htm.The HTML for AFTREPORT_ESCAPE is
** specified within the PL/SQL itself.
*/

function BeforeReport return boolean is
begin
if ((upper(:MODE) != 'CHARACTER') and
    (upper(:DESFORMAT) = 'HTML')) then
  SRW.ATTR.MASK := SRW.BEFREPORT_ESCAPE_ATTR +
                   SRW.AFTREPORT_ESCAPE_ATTR;
  SRW.ATTR.BEFREPORT_ESCAPE_TYPE := SRW.FILE_ESCAPE;
  SRW.ATTR.BEFREPORT_ESCAPE_VALUE := 'logo.htm';
  SRW.ATTR.AFTREPORT_ESCAPE_TYPE := SRW.TEXT_ESCAPE;
  SRW.ATTR.AFTREPORT_ESCAPE_VALUE := '<ADDRESS>' ||
  ' Questions?- ' ||
  '<A HREF=mailto:webmaster@xyztech.com>' ||
  'webmaster@xyztech.com</A>' ||
  '</ADDRESS>' ||
  '</body></html>';
  SRW.SET_ATTR(SRW.REPORT_ID, SRW.ATTR);
end if;
return (TRUE);
end;


BFCOLOR

  属性(SRW.SET_ATTR)

新機能： この属性は、SRW.SET_BACKGROUND_FILL_COLORプロシージャを使用して設定するほうが適しています。互換性を保つために、SRW.SET_ATTRでもこの属性を設定できるようになっていますが、新しい簡素化されたプロシージャを使用することをお薦めします。

説明  オブジェクトの塗りカラーです。この属性はキャラクタ・モードでは無視されます。

値

有効な色の名前。


BOOKMARK

  例 	  制限 	  関連項目	  属性(SRW.SET_ATTR)

新機能： この属性は、SRW.SET_BOOKMARKプロシージャを使用して設定するほうが適しています。互換性を保つために、SRW.SET_ATTRでもこの属性を設定できるようになっていますが、新しい簡素化されたプロシージャを使用することをお薦めします。

説明  マスターHTMLドキュメントのフレーム内またはPDFビューア内に現れる文字列です。ブックマークをクリックすると、ウィンドウの一番上に対応付けられたオブジェクトが表示されます。

値

インデントおよび順序付けに関する情報がないテキスト文字列。ブックマークは、レポートがオブジェクトを渡す順に、ブックマーク・リストに表示されます。

順序付けおよびインデントを明示したx#book_mark_name形式のテキスト文字列で、xにはアウトライン番号が入ります。シャープ記号（#）とアウトライン番号は、「ブックマーク」ウィンドウには表示されませんが、順序とインデントを決めるのに使用されます。たとえば、次のように指定します。

1#Expense Summary Section
2#Expense Detail Section
2.1#Expenses for the Administration Department
2.2#Expenses for the Engineering Department
2.3#Expenses for the Sales Department
2.3.1#Expenses for the Eastern Sales Region
2.3.2#Expenses for the Northern Sales Region
2.3.3#Expenses for the Southern Sales Region
2.3.4#Expenses for the Western Sales Region


BOOKMARKの制限

•	同じアウトライン番号が何回も使用される場合、エントリはすべて表示されますが、順序はレポートがオブジェクトを渡した順で定義されます。

•	番号がとんでいる場合、次の2つのうちの1つが発生します。同等レベルの番号がとんでいる場合は、目に見える影響はありません（たとえば、1.3.1と1.3.3で、1.3.2がない場合、同じインデント・レベルで並んで表示されます）。上位の番号と低位の番号の間がとんでいる場合、中間のレベルが必要に応じて生成されます（たとえば、1.0の後が2.1.1ならば、見かけ上の2と2.1のエントリが定義されます。 そのタイトルは、後の実際のエントリと同じになります）。

•	BOOKMARKの設定は、次のトリガーに限られます。

フォーマット・トリガー


BOOKMARKの例

  関連項目 	  すべての例

注意: この例では、BOOKMARK属性の設定にSRW.SET ATTRが使用されています。この属性は、SRW.SET_BOOKMARKプロシージャを使用して設定するほうが適しています。互換性を保つために、SRW.SET_ATTRでもこの属性を設定できるようになっていますが、新しい簡素化されたプロシージャを使用することをお薦めします。

/* The format trigger below defines a bookmark for
** the boilerplate object B_2. Notice the use of
** explicit ordering information (1#) in this example.
** If you did not want the ordering information, you
** could omit 1#.
*/

function B_2FormatTrigger return boolean is
begin
  srw.attr.mask := srw.BOOKMARK_ATTR;
  srw.attr.bookmark  := '1#Expense Summary Section';
  srw.set_attr(0,srw.attr);
  return (TRUE);
end;


動的BOOKMARKの例

  関連項目 	  すべての例

注意: この例では、BOOKMARK属性の設定にSRW.SET ATTRが使用されています。この属性は、SRW.SET_BOOKMARKプロシージャを使用して設定するほうが適しています。互換性を保つために、SRW.SET_ATTRでもこの属性を設定できるようになっていますが、新しい簡素化されたプロシージャを使用することをお薦めします。

/* The format trigger below defines a bookmark for
** the boilerplate object B_2. Notice that the name
** of the bookmark is dynamic.CATEGORY is a column
** value that is concatenated with the string Expense
** Summary Section for each execution of the format
** trigger.In this case, CATEGORY could contain
** ordering information (e.g., 1#) or perhaps a string
** that makes the bookmark unique within the report.
*/

function B_2FormatTrigger return boolean is
begin
  srw.attr.mask := srw.BOOKMARK_ATTR;
  srw.attr.bookmark  := :category ||
  ' Expense Summary Section';
  srw.set_attr(0,srw.attr);
  return (TRUE);
end;


BORDERWIDTH

  属性(SRW.SET_ATTR)

新機能： この属性は、SRW.SET_BORDER_WIDTHプロシージャを使用して設定するほうが適しています。互換性を保つために、SRW.SET_ATTRでもこの属性を設定できるようになっていますが、新しい簡素化されたプロシージャを使用することをお薦めします。

説明  オブジェクトの枠幅。

値

0	境界線がないことを意味します。
任意の正の整数	ビットマップ・レポートの場合はそのパイカ数（1パイカは12ポイント）の、キャラクタ・モード・レポートの場合は1字の枠幅を意味します。


BORDPATT

  属性(SRW.SET_ATTR)

新機能： この属性は、SRW.SET_BORDER_PATTERNプロシージャを使用して設定するほうが適しています。互換性を保つために、SRW.SET_ATTRでもこの属性を設定できるようになっていますが、新しい簡素化されたプロシージャを使用することをお薦めします。

説明  オブジェクトの枠の塗りパターンです。この属性はキャラクタ・モードでは無視されます。

値

有効パターン名。


FACE

  属性(SRW.SET_ATTR)

新機能： この属性は、SRW.SET_FONT_FACEプロシージャを使用して設定するほうが適しています。互換性を保つために、SRW.SET_ATTRでもこの属性を設定できるようになっていますが、新しい簡素化されたプロシージャを使用することをお薦めします。

説明  CHARまたはDATE、NUMBER型フィールドのフェースです。この属性はキャラクタ・モードでは無視されます。

値

レポートが実行されるマシン上の有効フォント名。


FBCOLOR

  属性(SRW.SET_ATTR)

新機能： この属性は、SRW.SET_FOREGROUND_BORDER_COLORプロシージャを使用して設定するほうが適しています。互換性を保つために、SRW.SET_ATTRでもこの属性を設定できるようになっていますが、新しい簡素化されたプロシージャを使用することをお薦めします。

説明  オブジェクトのフォアグラウンドの境界色です。この属性はキャラクタ・モードでは無視されます。

値

有効な色の名前。


FFCOLOR

  属性(SRW.SET_ATTR)

新機能： この属性は、SRW.SET_FOREGROUND_FILL_COLORプロシージャを使用して設定するほうが適しています。互換性を保つために、SRW.SET_ATTRでもこの属性を設定できるようになっていますが、新しい簡素化されたプロシージャを使用することをお薦めします。

説明  オブジェクトのフォアグラウンドの塗りカラーです。この属性はキャラクタ・モードでは無視されます。

値

有効な色の名前。


FILLPATT

  属性(SRW.SET_ATTR)

新機能： この属性は、SRW.SET_FILL_PATTERNプロシージャを使用して設定するほうが適しています。互換性を保つために、SRW.SET_ATTRでもこの属性を設定できるようになっていますが、新しい簡素化されたプロシージャを使用することをお薦めします。

説明  オブジェクトの塗りパターンです。この属性はキャラクタ・モードでは無視されます。

値

有効パターン名。


FORMATMASK

  属性(SRW.SET_ATTR)

新機能： この属性は、SRW.SET_FORMAT_MASKプロシージャを使用して設定するほうが適しています。互換性を保つために、SRW.SET_ATTRでもこの属性を設定できるようになっていますが、新しい簡素化されたプロシージャを使用することをお薦めします。

説明  DATEまたはNUMBER型フィールドの書式マスクです。

値

任意の有効書式マスク。


GCOLOR

  属性(SRW.SET_ATTR)

新機能： この属性は、SRW.SET_TEXT_COLORプロシージャを使用して設定するほうが適しています。互換性を保つために、SRW.SET_ATTRでもこの属性を設定できるようになっていますが、新しい簡素化されたプロシージャを使用することをお薦めします。

説明  CHAR、DATEまたはNUMBER型フィールドのグローバルな文字色です。この属性はキャラクタ・モードでは無視されます。

値

有効な色の名前。


GSPACING

  属性(SRW.SET_ATTR)

新機能： この属性は、SRW.SET_CUSTOM_SPACINGプロシージャまたはSRW.SET_SPACINGプロシージャを使用して設定するほうが適しています。互換性を保つために、SRW.SET_ATTRでもこの属性を設定できるようになっていますが、新しい簡素化されたプロシージャを使用することをお薦めします。

説明  CHARまたはDATE、NUMBER型フィールドまたはボイラープレート・テキストのグローバルなテキスト行間。この属性はキャラクタ・モードでは無視されます。

値

srw.single_spacing

srw.onehlf_spacing

srw.double_spacing

srw.custom_spacing	非常に小さいVGS単位で間隔を指定します。srw.custom_spacingを使用する場合は、次にsrw.attr.customを使用してVGS単位のカスタム数を指定します。たとえば、次のように指定します。

srw.attr.mask        := SRW.GSPACING_ATTR;

srw.attr.gspacing    := SRW.CUSTOM_SPACING;

srw.attr.custom      := 200;

srw.set_attr (0, srw.attr);


HJUST

  属性(SRW.SET_ATTR)

新機能： この属性は、SRW.SET_JUSTIFICATIONプロシージャを使用して設定するほうが適しています。互換性を保つために、SRW.SET_ATTRでもこの属性を設定できるようになっていますが、新しい簡素化されたプロシージャを使用することをお薦めします。

説明  CHAR、DATEまたはNUMBER型フィールドの水平方向です。

値

srw.left_hjust

srw.center_hjust

srw.right_hjust

srw.flush_hjust	ビットマップ・レポートでは無視されます。


HYPERLINK

  例	  制限	  関連項目	  属性(SRW.SET_ATTR)

新機能： この属性は、SRW.SET_HYPERLINKプロシージャを使用して設定するほうが適しています。互換性を保つために、SRW.SET_ATTRでもこの属性を設定できるようになっていますが、新しい簡素化されたプロシージャを使用することをお薦めします。

説明  URL Webリンクの仕様です。

注意: Webリンクのソースであるオブジェクトをアクションに関連付けることもできません。

値

有効リンク:

同じマシン上の別の文書(たとえば、file:/private/mynewdoc.pdf または file:///C|/temp/mynewdoc.pdf)

別のマシン上の別の文書(たとえば、http://www.newmach.com/newdoc.pdf)

現行文書内の宛先(たとえば、#my_dest_name)

ローカル文書内の宛先(たとえば、file:/private/somedoc.pdf#a_dest_name)

リモート文書内の宛先(たとえば、http://www.newmach.com/newdoc.pdf#some_dest_name)

すべてのURL (たとえば、http://www.newmach.com/newdoc.html, ftp://www.reposit.com/filetoget.example, http://www.somemch.com/cgi-bin/webmenu?choice1)


HYPERLINKの制限

•	HYPERLINKの設定は、次のトリガーに限られます。

フォーマット・トリガー

•	PDFビューアからリモート・サーバーまたはHTML文書へのWebリンクをたどるには、Webブラウザと連動するようにPDFビューアを構成する必要があります(たとえば、ヘルパー・アプリケーションとして構成したり、プラグインとしてWebブラウザにインストールする)。


HYPERLINKの例

  関連項目 	  すべての例

注意: この例では、HYPERLINK属性の設定にSRW.SET_ATTRが使用されています。この属性は、SRW.SET_HYPERLINKプロシージャを使用して設定するほうが適しています。互換性を保つために、SRW.SET_ATTRでもこの属性を設定できるようになっていますが、新しい簡素化されたプロシージャを使用することをお薦めします。

/* The format trigger below defines a Web link
** to a destination (mytarget) in another document
** (newdoc.pdf) for the boilerplate object B_2.
** Note:If the target were in the same document,
** you would omit http://www.newmach.com/newdoc.pdf.
*/

function B_2FormatTrigger return boolean is
begin
  srw.attr.mask := srw.HYPERLINK_ATTR;
  srw.attr.hyperlink  :=
  'http://www.newmach.com/newdoc.pdf' ||
  '#mytarget';
  srw.set_attr(0,srw.attr);
  return (TRUE);
end;


動的HYPERLINKの例

  関連項目 	  すべての例

注意: この例では、HYPERLINK属性の設定にSRW.SET_ATTRが使用されています。この属性は、SRW.SET_HYPERLINKプロシージャを使用して設定するほうが適しています。互換性を保つために、SRW.SET_ATTRでもこの属性を設定できるようになっていますが、新しい簡素化されたプロシージャを使用することをお薦めします。

/* The format trigger below defines a Web link
** for the boilerplate object B_3. Notice how the
** destination of the link is determined dynamically
** based upon the values of SRCDIR and CF_PICKVIDEO.
** For example, if the value of SRCDIR were
** http://www.newmach.com and CF_PICKVIDEO were good.avi,
** this function would assign the following Web
** link to the object:
** http://www.newmach.com/webdemo/src/good.avi.
*/

function B_3FormatTrigger return boolean is
begin
  srw.attr.mask := srw.HYPERLINK_ATTR;
  srw.attr.hyperlink  := :srcdir||:cf_pickvideo;
  if ( upper(:cf_pickvideo) like '%GOOD%' ) then
    srw.attr.mask := srw.attr.mask +
                     srw.FBCOLOR_ATTR +
                     srw.BBCOLOR_ATTR;
    srw.attr.fbcolor := 'green';
    srw.attr.bbcolor := 'green';
  end if;
  srw.set_attr(0,srw.attr);
  return (TRUE);
end;

/* SRCDIR is a parameter whose value is determined at
** runtime by the following After Parameter Form trigger
*/

function AfterPForm return boolean is
begin
  :srcdir := :web_server || '/webdemo/src/';
  :docsdir := :web_server || '/webdemo/docs/';
  return (TRUE);
end;

/* CF_PICKVIDEO is a formula column whose value is
** determined by the following function
*/

function CF_pickvideoFormula return Char is
begin
  if ( :avg_h_div < .80 )
    then return ('bad.avi');
    else return ('good.avi');
  end if;
end;


LINKTAG

  例 	  制限 	  関連項目	  属性(SRW.SET_ATTR)

新機能： この属性は、SRW.SET_LINKTAGプロシージャを使用して設定するほうが適しています。互換性を保つために、SRW.SET_ATTRでもこの属性を設定できるようになっていますが、新しい簡素化されたプロシージャを使用することをお薦めします。

説明  オブジェクトの識別子であり、Webリンクの連結先として使用することが可能です。

値

ASCIIの26個の英文字(大文字および小文字)、数字またはアンダースコアのみを使った、有効で、一意の名前。他の特殊文字は、アンダースコア文字に自動的に変換されます。


LINKTAGの制限

•	LINKTAGの設定は、次のトリガーに限られます。

フォーマット・トリガー


LINKTAGの例

  関連項目 	  すべての例

注意: この例では、LINKTAG属性の設定にSRW.SET_ATTRが使用されています。この属性は、SRW.SET_LINKTAGプロシージャを使用して設定するほうが適しています。互換性を保つために、SRW.SET_ATTRでもこの属性を設定できるようになっていますが、新しい簡素化されたプロシージャを使用することをお薦めします。

/* The format trigger below assigns an identifier
** (mytarget) to the boilerplate object B_500.
** This means that the object can now be the destination
** of a Web link.
*/

function B_500FormatTrigger return boolean is
begin
  srw.attr.mask := SRW.LINKTAG_ATTR;
  srw.attr.linktag := 'mytarget';
  srw.set_attr(0, SRW.ATTR);
  return (TRUE);
end;


動的LINKTAGの例

  関連項目 	  すべての例

注意: この例では、LINKTAG属性の設定にSRW.SET_ATTRが使用されています。この属性は、SRW.SET_LINKTAGプロシージャを使用して設定するほうが適しています。互換性を保つために、SRW.SET_ATTRでもこの属性を設定できるようになっていますが、新しい簡素化されたプロシージャを使用することをお薦めします。

/* The format trigger below assigns an identifier to
** the field F_Dept by concatenating some static text
** (dept_details_) with the value of the source column
** (DEPTNO).This function ensures that a unique
** identifier is assigned to each instance of F_Dept.
*/

function F_DeptFormatTrigger return boolean is
begin
  srw.attr.mask := SRW.LINKTAG_ATTR;
  srw.attr.linktag := 'dept_details_' ||
  LTRIM(TO_CHAR(:deptno));
  srw.set_attr(0, SRW.ATTR);
  return (TRUE);
end;


PRINTER_INTRAY

  例 	  制限	  関連項目	  属性(SRW.SET_ATTR)

新機能: この属性は、SRW.SET_PRINTER_TRAYプロシージャを使用して設定するほうが適しています。互換性を保つために、SRW.SET_ATTRでもこの属性を設定できるようになっていますが、新しい簡素化されたプロシージャを使用することをお薦めします。

説明  有効なプリンタ・トレイ名で、レポートのフォーマットの際に、異なるプリンタ・トレイへ切り替えるのに使用されます。

値

「ページ設定」ダイアログで、プリンタに定義した有効で一意の名前。


PRINTER_INTRAYの制限

•	PRINTER_INTRAY設定は、次のトリガーに限られます。

Between Pagesトリガー

Before Reportトリガー

フォーマット・トリガー

•	Motif版のPCLプリンタにレポートを出力する場合、PRINTER_INTRAYは無視されます。


PRINTER_INTRAYの例

  関連項目 	  すべての例

注意: この例では、PRINTER_INTRAY属性の設定にSRW.SET_ATTRが使用されています。この属性は、SRW.SET_PRINTER_TRAYプロシージャを使用して設定するほうが適しています。互換性を保つために、SRW.SET_ATTRでもこの属性を設定できるようになっていますが、新しい簡素化されたプロシージャを使用することをお薦めします。

/* The example below sets the printer tray in the Between Pages trigger.
*/

function BetweenPages return boolean is
begin
   srw.attr.mask             := SRW.PRINTER_INTRAY_ATTR;
   srw.attr.printer_intray   := 'letterhead';
   srw.set_attr(SRW.REPORT_ID, srw.attr);
return (TRUE);
end;


STYLE

  属性(SRW.SET_ATTR)

新機能: この属性は、SRW.SET_FONT_STYLEプロシージャを使用して設定するほうが適しています。互換性を保つために、SRW.SET_ATTRでもこの属性を設定できるようになっていますが、新しい簡素化されたプロシージャを使用することをお薦めします。

説明  CHAR、DATEまたはNUMBER型フィールドのフォント・スタイルです。この属性はビットマップ・レポートでは無視されます。

値

srw.plain_style

srw.italic_style

srw.oblique_style

srw.underline_style

srw.outline_style

srw.shadow_style

srw.inverted_style

srw.overstrike_style

srw.blink_style


SZ

  属性(SRW.SET_ATTR)

新機能: この属性は、SRW.SET_FONT_SIZEプロシージャを使用して設定するほうが適しています。互換性を保つために、SRW.SET_ATTRでもこの属性を設定できるようになっていますが、新しい簡素化されたプロシージャを使用することをお薦めします。

説明  CHARまたはDATE、NUMBER型フィールドのフォント・サイズです。この属性はキャラクタ・モードでは無視されます。

値

レポートを実行するマシン上の指定フォントの有効サイズ。


TEXT

  属性(SRW.SET_ATTR)

新機能: この属性は、SRW.SET_CHARMODE_TEXTプロシージャを使用して設定するほうが適しています。互換性を保つために、SRW.SET_ATTRでもこの属性を設定できるようになっていますが、新しい簡素化されたプロシージャを使用することをお薦めします。

説明  CHARまたはDATE、NUMBER型フィールドのキャラクタ・モード・テキスト特性です。この属性はビットマップ・レポートでは無視されます。

値

srw.plain_texta

srw.reverse_texta

srw.bold_texta

srw.reversebold_texta

srw.underline_texta

srw.underlinereverse_texta

srw.underlinebold_texta

srw.reverseboldunderline_texta


WEIGHT

  属性(SRW.SET_ATTR)

新機能: この属性は、SRW.SET_FONT_WEIGHTプロシージャを使用して設定するほうが適しています。互換性を保つために、SRW.SET_ATTRでもこの属性を設定できるようになっていますが、新しい簡素化されたプロシージャを使用することをお薦めします。

説明  CHARまたはDATE、NUMBER型フィールドのフォントの太さです。この属性はキャラクタ・モードでは無視されます。

値

srw.ultralight_weight

srw.extralight_weight

srw.light_weight

srw.demilight_weight

srw.medium_weight

srw.demibold_weight

srw.bold_weight

srw.extrabold_weight


Adobe Acrobat Readerのように、PDFファイルを表示できるスタンドアロンまたはプラグイン・ソフトウェア。


HTML 3.0準拠のブラウザ（たとえば、Netscape 2.2）。


SRW.FILE_ESCAPE

HTMLがファイル内にあることを示します。SRW.FILE_ESCAPEを指定する場合は、SRW.xxxx_ESCAPE_VALUE（xxxxには、BEFREPORTなどのエスケープの名前が入ります）のファイル名を入力する必要があります。


SRW.TEXT_ESCAPE

HTMLがSRW.xxxx_ESCAPE_VALUE（xxxxには、BEFREPORTなどのエスケープの名前が入ります）で指定されていることを示します。SRW.TEXT_ESCAPEを指定する場合は、SRW.xxxx_ESCAPE_VALUEに引用符付き文字列を入力する必要があります。


この場合、ぺージとはレポート・ページのことです。


Report Builder PL/SQLパッケージ（SRW）
�Report Builder PL/SQLパッケージ（SRW）

時間を節約するために、Report Builderには、どのライブラリやレポートでも参照できるファンクションおよびプロシージャ、例外が多数入ったパッケージ（つまり、PL/SQL構成体を集めたもの）が付属しています。ReportBuilderのパッケージの名前はSRWです。そのため、SRWパッケージの構成体を参照するときには、「SRW.DO_SQL」のように、必ずその構成体の前に「SRW」を付ける必要があります。

注意: 別の製品（SQL*Plusなど）から、SRWパッケージ内の構成体を参照することはできません。

パッケージ内にある構成体は、「パッケージ・ファンクション」、「パッケージ・プロシージャ」、「パッケージ例外」というように、通常「パッケージ」を付けて呼ばれます。

  SRWパッケージ・プロシージャおよびファンクション、例外


SRW.ADD_DEFINITION

  関連項目	  すべてのビルトイン

説明  このプロシージャでは、列または変数内に保管されているXMLレポート定義が取り出され、文書バッファに追加されます。レポート定義をすべてバッファに入れるには、SRW.ADD_DEFINITIONを複数回実行する必要があります。バッファ内に定義が入ると、SRW.APPLY_DEFINITIONを使用してレポートに適用できます。

構文

SRW.ADD_DEFINITION(:column_name | variable);

使用上の注意

•	XMLレポート定義を適用するには、SRW.APPLY_DEFINITIONビルトインを使用します。たとえば、次のように指定します。

srw.add_definition (:xml_col);
srw.apply_definition;

•	XMLレポート定義がファイル内に配置されている場合は、SRW.APPLY_DEFINITIONのみを使用してファイルを参照できます。たとえば、次のように指定します。

srw.apply_definition('d:\xml_reps\web.xml');


SRW.APPLY_DEFINITION

  関連項目	  すべてのビルトイン

説明  このプロシージャでは、文書バッファまたはファイル・システムに保管されているXMLレポート定義が取り出され、レポートに追加されます。文書バッファからの定義が適用された場合、SRW.APPLY_DEFINITIONでは引数を使用しません。ファイルから定義が適用された場合、SRW.APPLY_DEFINITIONでは名前およびファイルのパス名が引数として使用されます。

構文

SRW.APPLY_DEFINITION[(filename.xml)];

使用上の注意

•	複数のXMLレポート定義を適用したい場合は、適用する順序でSRW.APPLY_DEFINITION文を別々に並べます。

•	XMLレポート定義がファイル内にある場合は、SRW.APPLY_DEFINITIONのみを使用してファイルを参照できます。たとえば、次のように指定します。

srw.apply_definition('d:\xml_reps\web.xml');

•	文書バッファからXMLレポートを適用するには、最初にSRW.ADD_DEFINITIONを使用してバッファ内に定義を入れておく必要があります。たとえば、次のように指定します。

srw.add_definition (:xml_col);
srw.apply_definition;


SRW.BREAK

  制限	  関連項目	  すべてのビルトイン

説明  このプロシージャは、レポートの実行を一時的に停止し、すべての列とパラメータの現在の設定値を表示します（読込み専用）。読込み専用画面を適用すると、レポートの実行が再開されます。

構文

SRW.BREAK;


SRW.BREAKの制限

•	このプロシージャは、フォーム前またはフォーム後トリガーでは無効です。 これは、レポートのデータが、Before Reportトリガー（フォーム後トリガー実行後に起動）が起動するまでフェッチされないからです。

•	すべての列とパラメータの値が、読込み専用スクリーンに表示されます。PL/SQL変数やその他のオブジェクトの値は表示されません。


SRW.CONTEXT_FAILURE
SRW.CONTEXT_FAILURE;

  例 	  関連項目	  すべてのビルトイン

説明  この例外は、レポートの実行を停止し、次のエラー・メッセージを呼び出します。

REP-1426: <construct_name>は無効なコンテキストから実行されています。

構文

SRW.CONTEXT_FAILURE;

使用上の注意  Report Builderでは、Report Builderのパッケージ・ファンクションまたはプロシージャが誤ったコンテキストで使用されると、この例外を呼び出します（下表を参照）。

この表では、「NO」はそのコンテキストではそのファンクションまたはプロシージャをコールできないことを、「YES」はコールできることを意味します。

名前	パラメータ・フォーム	データ・モデル	フォーマット・トリガー	レポート・トリガー
srw.break	NO	YES	YES	NO
srw.do_sql	YES	YES	YES	YES
srw.geterr_run	YES	YES	YES	YES
srw.get_page_num	NO	NO	YES	NO
srw.message	YES	YES	YES	YES
srw.reference	YES	YES	YES	YES
srw.run_report	YES	YES	YES	YES
srw.set_attr	NO	NO	YES	NO
srw.set_field_char	NO	NO	YES	NO
srw.set_field_date	NO	NO	YES	NO
srw.set_field_num	NO	NO	YES	NO
srw.set_maxrow	NO	YES	YES	YES
srw.user_exit	YES	YES	YES	YES


SRW.CONTEXT_FAILUREの例

  関連項目 	  すべての例

/* Suppose you want your own error message raised,
** instead of the default error message.
** You could handle this exception in the following way:
*/

EXCEPTION

when SRW.CONTEXT_FAILURE then

  srw.message(4000, 'Contact the Application

    Development group regarding SRW.CONTEXT_FAILURE.');

  raise srw.program_abort;


SRW.DO_SQL

  制限	  例	  関連項目	  すべてのビルトイン

説明  このプロシージャは、Report Builder内から指定したSQL文を実行します。SQL文はDDL（データを定義する文）でも、DML（データを操作する文）でもかまいません。DML文は、通常、SRW.DO_SQLよりもPL/SQLでのほうが高速に実行できます。

PL/SQLではDDL文を実行できないので、SRW.DO_SQLパッケージ・プロシージャは、ユーザー・イグジットを介さずにReport Builder内でDDL文を実行するのに特に便利です。DDLまたはDML文の詳細は、『Oracle8 Server SQLリファレンス』を参照してください。

構文

SRW.DO_SQL (sql_statement CHAR);

パラメータ

sql_statement	任意の有効SQL文。Report Builderオブジェクト名の前には、必ずコロン（:）を付けてください。


SRW.DO_SQLの制限

•	レポート・トリガーの実行順序で、SET TRANSACTION READONLYがどこで発生するかに注意してください。

•	バインド変数の値は、最大64,000バイトまで。（値がこの制限を超えると、最初の64,000バイト分を超過した分は切り捨てられます。)

•	INTO句に文字列の宛先としてパラメータを使用する場合、パラメータに選択値が入るだけの幅があることを確認する必要があります。たとえば、下に示すSRW.DO_SQL文の場合、宛先パラメータ（my_ename）には、ENAME列の最大幅に相当する幅が必要です。これは、選択値の後ろには、その値の仮定サイズまで空白が入るからです。パラメータの幅が十分でないと、切捨て例外が発生します。SELECTリスト項目の最大幅がわからない場合は、2000をパラメータの幅として使用してください。

srw.do_sql('SELECT ENAME INTO :my_ename FROM EMP');


SRW.DO_SQLの例

  関連項目      [image]  すべての例

/* Suppose you want your report to create a table named CHECK
** just before the Runtime Parameter Form is displayed.
** Because CREATE TABLE is a SQL DDL statement (and PL/SQL
** cannot perform DDL statements), you need to use SRW.DO_SQL.
** Therefore, your PL/SQL could look like this in the Before Form trigger:
*/

/* Additional Information:If you use a table created in this way for your
** report output, the table must exist before you create your query in the
** data model.Otherwise, Report Builder would not be able to parse your query.
*/

FUNCTION CREATETAB RETURN BOOLEAN IS

BEGIN

SRW.DO_SQL('CREATE TABLE CHECK (EMPNO NUMBER NOT NULL

            PRIMARY KEY, SAL NUMBER (10,2)) PCTFREE 5

            PCTUSED 75');

RETURN(TRUE);

EXCEPTION

WHEN SRW.DO_SQL_FAILURE THEN

 SRW.MESSAGE(100, 'ERROR WHILE CREATING CHECK TABLE.');

 SRW.MESSAGE(50, 'REPORT WAS STOPPED BEFORE THE RUNTIME

 PARAMETER FORM.');

 RAISE SRW.PROGRAM_ABORT;

END;

/* Suppose you want to create a "table of contents" by getting the
** first character of a column's value, and page number on which its
** field fires to print.Assume that you want to put the "table of contents"
** into a table named SHIP.You could write the following construct:
*/

DECLARE

  PAGE_NO      NUMBER;

  PAGE_FOR     INDEX NUMBER;

  SORT_CHAR    CHAR(1);

  CMD_LINE     CHAR(200);

BEGIN

  SORT_CHAR := :SORT_NAME ;

  IF :CALLED = 'Y' THEN

    SRW.GET_PAGE_NUM(PAGE_FOR);

    SRW.USER_EXIT('RWECOP PAGE_FOR

                   P_START_PAGENO');

    SRW.MESSAGE(2,TO_CHAR(:P_START_PAGENO));

  END IF;

  SRW.GET_PAGE_NUM(PAGE_NO);

  CMD_LINE := 'INSERT INTO SHIP VALUES

       ('''||SORT_CHAR||''','||TO_CHAR(PAGE_NO)||')';

  SRW.MESSAGE(2,CMD_LINE);

  SRW.DO_SQL(CMD_LINE);

  COMMIT;

EXCEPTION

  WHEN DUP_VAL_ON_INDEX THEN

       NULL;

  WHEN SRW.DO_SQL_FAILURE THEN

       SRW.MESSAGE(1,'FAILED TO INSERT ROW INTO SHIP

TABLE');

  WHEN OTHERS THEN

       COMMIT;

END;


SRW.DO_SQL_FAILURE
SRW.DO_SQL_FAILURE;

  例	  関連項目	  すべてのビルトインパッケージ

説明  この例外は、レポートの実行を停止し、次のエラー・メッセージを呼び出します。

REP-1425: DO_SQLパッケージ実行中にエラーが発生しました。- REP-msg ORA-msg

この場合:

REP-msg	Report Builderのメッセージ。

ORA-msg	オプションのOracleメッセージで、Report Builderメッセージに関する追加情報。

構文

SRW.DO_SQL_FAILURE;

使用上の注意  Report Builderでは、SRW.DO_SQLパッケージ・プロシージャに失敗したとき（ユーザーにDDL権限がないのに、SRW.DO_SQLで表を作成しようとした場合など）、この例外を呼び出します。


SRW.DO_SQL_FAILUREの例

  関連項目 	  すべての例

/* Suppose you want your own error message raised,
** instead of the default error message.
** You could handle this exception in the following way:
*/

EXCEPTION

when SRW.DO_SQL_FAILURE then

   srw.message(1000, 'Error occurred while creating

               table CHECKS.');


SRW.GETERR_RUN
SRW.GETERR_RUN;

  例 	  関連項目	  すべてのビルトイン

説明  このファンクションは、Report BuilderでSRW.RUN_REPORTプロシージャの実行中にエラーが検出された場合に、エラー･メッセージを戻します。

構文

SRW.GETERR_RUN;

戻り値  エラー・メッセージ。


SRW.GETERR_RUNの例

  関連項目 	  すべての例

/* Suppose you are sending parts of a report to users via Oracle*Mail.
** For more information, see "SRW.RUN_REPORT".   Also,
** suppose that if SRW.RUN_REPORT fails, you want to display a message
** that explains why it failed.Your PL/SQL could look like this:
*/

BEGIN

DECLARE TMP CHAR(100);

  begin

     srw.run_report('batch=yes report=send.rdf

     destype=file desname=send.lis desformat=dflt');

  exception when srw.run_report_failure then

     tmp := srw.geterr_run;

     srw.message(1000, tmp);

  end;

END;


SRW.GET_PAGE_NUM
SRW.GET_PAGE_NUM;

  制限	  例 	  関連項目	  すべてのビルトイン

説明  このプロシージャは、現行のページ番号を戻します。フィールドのフォーマット・トリガー・プロパティでそのページ番号を使用する場合に便利です。

構文

SRW.GET_PAGE_NUM (page_num);

パラメータ

page_num	現行のページ番号を取得する変数。
戻り値	 現行のページ番号


SRW.GET_PAGE_NUMの制限

•	SRW.GET_PAGE_NUMが有効なのは、フォーマット・トリガーにおいてのみです。他の場所に入力しても効果はありません。


SRW.GET_PAGE_NUMの例

  関連項目 	  すべての例

/* Suppose you want to perform a computation based upon a page number.
** In the field's Format Trigger, you could use SRW.GET_PAGE_NUM:
*/

BEGIN

DECLARE PAGE_NUM NUMBER;

  begin

     srw.get_page_num (page_num);

     srw.set_field_num (0, page_num + 3);

  end;

END;


設定属性プロシージャ

  制限	  関連項目	  すべてのビルトイン

SRW.SET_AFTER_FORM_HTML

SRW.SET_AFTER_PAGE_HTML

SRW.SET_AFTER_PRINTING_CODE

SRW.SET_AFTER_REPORT_HTML

SRW.SET_ATTR 属性

SRW.SET_BACKGROUND_BORDER_COLOR

SRW.SET_BACKGROUND_FILL_COLOR

SRW.SET_BEFORE_FORM_HTML

SRW.SET_BEFORE_PAGE_HTML

SRW.SET_BEFORE_PRINTING_CODE

SRW.SET_BEFORE_REPORT_HTML

SRW.SET_BOOKMARK

SRW.SET_BORDER_PATTERN

SRW.SET_BORDER_WIDTH

SRW.SET_CHARMODE_TEXT

SRW.SET_CUSTOM_SPACING

SRW.SET_DISPLAY_NAME

SRW.SET_FIELD

SRW.SET_FIELD_CHAR

SRW.SET_FIELD_DATE

SRW.SET_FIELD_NUM

SRW.SET_FILL_PATTERN

SRW.SET_FONT_FACE

SRW.SET_FONT_SIZE

SRW.SET_FONT_STYLE

SRW.SET_FONT_WEIGHT

SRW.SET_FOREGROUND_BORDER_COLOR

SRW.SET_FOREGROUND_FILL_COLOR

SRW.SET_FORMAT_MASK

SRW.SET_HYPERLINK

SRW.SET_HYPERLINK_ATTRS

SRW.SET_JUSTIFICATION

SRW.SET_LINKTAG

SRW.SET_MAXROW

SRW.SET_PAGE_NAVIGATION_HTML

SRW.SET_PDF_ACTION

SRW.SET_PRINTER_TRAY

SRW.SET_SPACING

SRW.SET_TEXT_COLOR


SRW.SET_AFTER_FORM_HTML

  制限 	  例 	  関連項目	  設定属性プロシージャ 	  すべてのビルトイン

説明  このプロシージャは、HTMLパラメータ・フォームの下端に表示するテキスト、グラフィックまたはHTMLコマンドを挿入します。この属性は、ロゴまたは標準リンクをパラメータ・フォーム上に配置するのに便利です。

構文

SRW.SET_AFTER_FORM_HTML(type,'string');

パラメータ

type	SRW.FILE_ESCAPE またはSRW.TEXT_ESCAPE.文字列パラメータがファイル名か挿入されるテキストかを示します。
文字列	typeパラメータの指定内容に依存した、ファイル名または挿入されるテキスト。
プロパティ・パレット  プロパティ・パレットを使用してこの属性を定義するには、「フォーム後型」および「フォーム後値」プロパティを設定します。


SRW.SET_AFTER_FORM_HTMLの例

  関連項目 	  すべての例

/* This example inserts two links to home pages
** at the bottom of the HTML Parameter Form.
*/

function BeforeForm return boolean is
begin
if ((upper(:MODE) != 'CHARACTER') and
    (upper(:DESFORMAT) = 'HTML')) then
  SRW.SET_AFTER_FORM_HTML(SRW.TEXT_ESCAPE,'<CENTER>' ||
  '<A HREF="http://www.oracle.com/">' ||
  'Oracle Corporation</A> -' ||
  '<BR>' ||
  '<A HREF="http://home.netscape.com/">' ||
  'Netscape</A> </CENTER>' ||
  '</BODY> </HTML>');
end if;
return (TRUE);
end;


SRW.SET_AFTER_PAGE_HTML

  制限 	  例 	  関連項目 	  設定属性プロシージャ 	  すべてのビルトイン

説明  このプロシージャは、文書のページの下端に表示するテキスト、グラフィックまたはHTMLコマンドを挿入します。この属性は、ロゴまたは標準リンクをHTML文書の各ページの先頭に配置するのに便利です。

HTMLページ・ストリームを使用する場合、このプロシージャはレポート出力のすべてのページに適用されます。レポートの最初（ヘッダー）または最後（フッター）のページにのみHTMLを指定するには、 SRW.SET_BEFORE_REPORT_HTML または SRW.SET_AFTER_REPORT_HTML PL/SQLプロシージャをそれぞれ使用します。

構文

SRW.SET_AFTER_PAGE_HTML(type,'string');

パラメータ

type	SRW.FILE_ESCAPE またはSRW.TEXT_ESCAPE.文字列パラメータがファイル名か挿入されるテキストかを示します。
string	typeパラメータの指定内容に依存した、ファイル名または挿入されるテキスト。
プロパティ・パレット  プロパティ・パレットを使用してこの属性を定義するには、「ページ後型」および「ページ後値」プロパティを設定します。


SRW.SET_AFTER_PAGE_HTMLの制限

•	ページの下端に含まれるデフォルトHTMLを以下に示します。ページ間に表示するデフォルトのセパレータ・ラインが不要な場合は、これは不要です。

<hr size=5 noshade>

•	SRW.SET_AFTER_PAGE_HTMLをレポートのすべてのページに適用する場合、Before Reportトリガーなど、レポートのフォーマットが始まる前に起動するトリガーに指定する必要があります。

•	SRW.SET_AFTER_PAGE_HTMLを現行ページのみに適用する場合、そのページのオブジェクトのフォーマット・トリガーに指定する必要があります。


SRW.SET_AFTER_PAGE_HTMLの例

  関連項目 	  すべての例

/* The example below inserts a GIF file as a
** page separator.
*/

function BeforeReport return boolean is
begin
if ((upper(:MODE) != 'CHARACTER') and
    (upper(:DESFORMAT) = 'HTML')) then
 SRW.SET_AFTER_PAGE_HTML(SRW.TEXT_ESCAPE,'<CENTER>' ||
 '<IMG ALT="Ruler" SRC="line.gif" VSPACE=10>' ||
 '<BR></CENTER>');
end if;
return (TRUE);
end;


SRW.SET_AFTER_PRINTING_CODE

  関連項目 [image]  設定属性プロシージャ 	  すべてのビルトイン

説明  このプロシージャは、オブジェクトの各行の後に実行されるプリンタ・エスケープ・シーケンスへの参照を挿入します。オブジェクトの印刷がトリガーされた後、実際に印刷される前に、プリンタ・エスケープ・シーケンスが挿入されます。プリンタ・コードは、キャラクタ・モードでレポートを実行しているときのみ使用します。

構文

SRW.SET_AFTER_PRINTING_CODE('code');

パラメータ

code	DESFORMAT用に指定された.prtファイルに定義された有効なプリンタ・コード。
プロパティ・パレット  プロパティ・パレットを使用してこの属性を定義するには、「後のプリンタ・コード」プロパティを設定します。


SRW.SET_AFTER_REPORT_HTML

  制限 	  例 	  関連項目 	  設定属性プロシージャ 	  すべてのビルトイン

説明  このプロシージャは、ＨＴＭＬ文書の終わりに表示するテキスト、グラフィックまたはHTMLコマンドを挿入します。この属性は、ロゴまたは標準リンクをHTML文書の各ページの先頭に配置するのに便利です。

HTMLページ・ストリームを使用する場合、このプロシージャはレポート出力の最初のページに適用されます。HTMLがレポート全体（バックグラウンド・カラーやイメージ、その他の <body> HTML属性）に適用されるように指定するには、SRW.SET_BEFORE_PAGE_HTML PL/SQL プロシージャを使用する必要があります。

構文

SRW.SET_AFTER_REPORT_HTML(type,'string');

パラメータ

type	SRW.FILE_ESCAPEまたはSRW.TEXT_ESCAPE。文字列パラメータがファイル名か挿入されるテキストかを示します。
string	typeパラメータの指定内容に依存した、ファイル名または挿入されるテキスト。
プロパティ・パレット  プロパティ・パレットを使用してこの属性を定義するには、「レポート後型」および「レポート後値」プロパティを設定します。


SRW.SET_AFTER_REPORT_HTMLの制限

•	レポートの下端に含まれるデフォルトHTMLを以下に示します。SRW.SET_AFTER_REPORT_HTMLを使用してこのテキストを置換する場合、等価なHTMLコマンドを必ず含んでいる必要があります。

</body></html>

•	SRW.SET_AFTER_REPORT_HTMLを、Before Reportトリガーなど、レポートのフォーマット前に起動するトリガーに設定する必要があります。


SRW.SET_AFTER_REPORT_HTMLの例

  関連項目 	  すべての例

/* The example below inserts two links to home pages
** at the end of the report output.
*/

function BeforeReport return boolean is
begin
if ((upper(:MODE) != 'CHARACTER') and
    (upper(:DESFORMAT) = 'HTML')) then
  SRW.SET_AFTER_REPORT_HTML(SRW.TEXT_ESCAPE,'<CENTER>' ||
  '<A HREF="http://www.oracle.com/">' ||
  'Oracle Corporation</A> -' ||
  chr(10) ||
  '<A HREF="http://home.netscape.com/">' ||
  'Netscape</A> </CENTER>' ||
  '</BODY> </HTML>');
end if;
return (TRUE);
end;


SRW.SET_BACKGROUND_BORDER_COLOR

  設定属性プロシージャ 	  関連項目	  すべてのビルトイン

説明  このプロシージャは、オブジェクトのバックグラウンド境界色を指定します。この属性はキャラクタ・モードでは無視されます。使用するパターンによっては、バックグラウンド塗りカラーを表示することができません。たとえば、パターンが実線の場合、バックグラウンド塗りカラーはパターン全体に表示されません。この場合、フォアグラウンド・カラーのみが全体表示されます。

構文

SRW.SET_BACKGROUND_BORDER_COLOR('color');

パラメータ

color	カラー・パレットからの有効なカラー。
使用上の注意

•	このプロシージャは枠のパターンをサポートしていないので、Windowsプラットフォームに適用されません。結果として、境界のフォアグラウンドのみがWindowsで示されます。

プロパティ・パレット  （テンプレートのみ）プロパティ・パレットを使用してテンプレートにこの属性を定義するには、「枠のバックグラウンド・カラー」プロパティを設定します。

ユーザー・インタフェース  バックグラウンド境界色をユーザー・インタフェースで設定する方法は、「カラーの変更」を参照してください。


SRW.SET_BACKGROUND_FILL_COLOR

  関連項目 [image]  設定属性プロシージャ 	  すべてのビルトイン

説明  このプロシージャは、オブジェクトの塗りカラーを指定します。この属性はキャラクタ・モードでは無視されます。使用するパターンによっては、バックグラウンド塗りカラーを表示することができません。たとえば、パターンが実線の場合、バックグラウンド塗りカラーはパターン全体に表示されません。この場合、フォアグラウンド・カラーのみが全体表示されます。

構文

SRW.SET_BACKGROUND_FILL_COLOR('color');

パラメータ

color	カラー・パレットからの有効なカラー。
プロパティ・パレット  （テンプレートのみ）プロパティ・パレットを使用してテンプレートにこの属性を定義するには、「バックグラウンド・カラー」プロパティを設定します。

ユーザー・インタフェース  バックグラウンド塗りカラーをユーザー・インタフェースで設定する方法は、「カラーの変更」を参照してください。


SRW.SET_BEFORE_FORM_HTML

  制限 	  例 	  関連項目 	  設定属性プロシージャ 	  すべてのビルトイン

説明  このプロシージャは、HTMLパラメータ・フォームの上端に表示するテキスト、グラフィックまたはHTMLコマンドを挿入します。この属性は、ロゴまたは標準リンクをパラメータ・フォーム上に配置するのに便利です。

構文

SRW.SET_BEFORE_FORM_HTML(type,'string');

パラメータ

type	SRW.FILE_ESCAPE またはSRW.TEXT_ESCAPE.文字列パラメータがファイル名か挿入されるテキストかを示します。
文字列	typeパラメータの指定内容に依存した、ファイル名または挿入されるテキスト。
プロパティ・パレット  プロパティ・パレットを使ってこの属性を定義するには、「フォーム前型」および「フォーム前値」プロパティを設定します。


SRW.SET_BEFORE_FORM_HTMLの例

  関連項目 	  すべての例

/* The example below sets both the before and after
** form escapes in the Before Form trigger.
** The HTML for the before escape is located in a file
** named logo.htm.The HTML for the after report escape
** is specified within the PL/SQL itself.
*/

function BeforeForm return boolean is
begin
if ((upper(:MODE) != 'CHARACTER') and
    (upper(:DESFORMAT) = 'HTML')) then
  SRW.SET_BEFORE_FORM_HTML(SRW.FILE_ESCAPE,'logo.htm');
  SRW.SET_AFTER_FORM_HTML(SRW.TEXT_ESCAPE, <B> ||
  '<FONT FACE="Arial, Helvetica">' ||
  '<FONT COLOR="#FF0000">' ||
  'Click <IMG SRC="RUN.GIF" HEIGHT=18 WIDTH=18>' ||
  'to run the report using the parameters you have' ||
  'specified above.' ||
  '</FONT></FONT></B>');
end if;
return (TRUE);
end;


SRW.SET_BEFORE_PAGE_HTML

  制限 	  例 	  関連項目 	  設定属性プロシージャ 	  すべてのビルトイン

説明  このプロシージャは、文書のページの先頭に表示するテキスト、グラフィックまたはHTMLコマンドを挿入します。この属性は、ロゴまたは標準リンクをHTML文書の各ページの先頭に配置するのに便利です。

HTMLページ・ストリームを使用する場合、このプロシージャはレポート出力のすべてのページ（バックグラウンド・カラーやイメージ、その他の <body> HTML属性）に適用されます。レポートの最初（ヘッダー）または最後（フッター）のページにのみHTMLを指定するには、 SRW.SET_BEFORE_REPORT_HTML または SRW.SET_AFTER_REPORT_HTML PL/SQLQLプロシージャをそれぞれ使用します。

構文

SRW.SET_BEFORE_PAGE_HTML(type,'string');

パラメータ

type	SRW.FILE_ESCAPE またはSRW.TEXT_ESCAPE.文字列パラメータがファイル名か挿入されるテキストかを示します。
string	typeパラメータの指定内容に依存した、ファイル名または挿入されるテキスト。
プロパティ・パレット  プロパティ・パレットを使用してこの属性を定義するには、「ページ前型」および「ページ前値」プロパティを設定します。


SRW.SET_BEFORE_PAGE_HTMLの制限

•	SRW.SET_BEFORE_PAGE_HTMLをレポートのすべてのページに適用する場合、Before Reportトリガーなど、レポートのフォーマットが始まる前に起動するトリガーに指定する必要があります。

•	SRW.SET_BEFORE_PAGE_HTMLを現行ページのみに適用する場合、そのページのオブジェクトのフォーマット・トリガーに指定する必要があります。


SRW.SET_BEFORE_PAGE_HTMLの例

  関連項目 	  すべての例

/* The example below centers the document in
** the browser.
*/

function BeforeReport return boolean is
begin
if ((upper(:MODE) != 'CHARACTER') and
    (upper(:DESFORMAT) = 'HTML')) then
  SRW.SET_BEFORE_PAGE_HTML(SRW.TEXT_ESCAPE,'<CENTER>');
  SRW.SET_AFTER_PAGE_HTML(SRW.TEXT_ESCAPE,'</CENTER>');
end if;
return (TRUE);
end;


SRW.SET_BEFORE_PRINTING_CODE

  関連項目 [image]  設定属性プロシージャ 	  すべてのビルトイン

説明  このプロシージャは、オブジェクトの各行の前に実行されるプリンタ・エスケープ・シーケンスへの参照を挿入します。オブジェクトの印刷がトリガーされた後、実際に印刷される前に、プリンタ・エスケープ・シーケンスが挿入されます。プリンタ・コードは、キャラクタ・モードでレポートを実行しているときのみ使用します。

構文

SRW.SET_BEFORE_PRINTING_CODE('code');

パラメータ

code	DESFORMAT用に指定された.prtファイルに定義された有効なプリンタ・コード。
プロパティ・パレット  プロパティ・パレットを使用してこの属性を定義するには、「前のプリンタ・コード」プロパティを設定します。


SRW.SET_BEFORE_REPORT_HTML

  制限 	  例 	  関連項目 	  設定属性プロシージャ 	  すべてのビルトイン

説明  このプロシージャは、文書の先頭に表示するテキスト、グラフィックまたはHTMLコマンドを挿入します。この属性は、ロゴまたは標準リンクをHTML文書の先頭に配置するのに便利です。

HTMLページ・ストリームを使用する場合、このプロシージャはレポート出力の最初のページに適用されます。HTMLがレポート全体（バックグラウンド・カラーやイメージ、その他の <body> HTML属性）に適用されるように指定するには、SRW.SET_BEFORE_PAGE_HTML PL/SQL プロシージャを使用する必要があります。

構文

SRW.SET_BEFORE_REPORT_HTML(type,'string');

パラメータ

type	SRW.FILE_ESCAPE またはSRW.TEXT_ESCAPE.文字列パラメータがファイル名か挿入されるテキストかを示します。
文字列	typeパラメータの指定内容に依存した、ファイル名または挿入されるテキスト。
プロパティ・パレット  プロパティ・パレットを使用してこの属性を定義するには、「レポート前型」および「レポート前値」プロパティを設定します。


SRW.SET_BEFORE_REPORT_HTMLの制限

•	レポートの先頭に含まれるデフォルトHTMLを以下に示します。SRW.SET_BEFORE_REPORT_HTMLを使用してこのテキストを置換する場合、等価なHTMLコマンドを必ず含んでいる必要があります。

<html>
   <body bgcolor="#ffffff">

•	SRW.SET_BEFORE_REPORT_HTMLを、Before Reportトリガーなど、レポートのフォーマットが始まる前に起動するトリガーに設定する必要があります。


SRW.SET_BEFORE_REPORT_HTMLの例

  関連項目 	  すべての例

/* The example below sets both the before and after
** report escapes in the Before Report trigger.
** The HTML for the before escape is located in a file
** named logo.htm.The HTML for the after report escape
** is specified within the PL/SQL itself.
*/

function BeforeReport return boolean is
begin
if ((upper(:MODE) != 'CHARACTER') and
    (upper(:DESFORMAT) = 'HTML')) then
  SRW.SET_BEFORE_REPORT_HTML(SRW.FILE_ESCAPE,'logo.htm');
  SRW.SET_AFTER_REPORT_HTML(SRW.TEXT_ESCAPE,'<ADDRESS>' ||
  ' Questions?- ' ||
  '<A HREF=mailto:webmaster@xyztech.com>' ||
  'webmaster@xyztech.com</A>' ||
  '</ADDRESS>' ||
  '</body></html>');
end if;
return (TRUE);
end;


SRW.SET_BOOKMARK

  制限 	  例 	  関連項目 	  設定属性プロシージャ 	  すべてのビルトイン

説明  このプロシージャは、ブックマークをオブジェクトに関連付けて、マスターHTML文書またはPDF文書のブックマーク枠に表示する文字列を指定します。ブックマーク領域をオープンし、ブックマークをクリックすると、ウィンドウ上端にオブジェクトが表示されます。

構文

SRW.SET_BOOKMARK('bookmark');

パラメータ

bookmark	次のどれかである: • インデント/順序の情報が指定されていないテキスト文字列。ブックマークは、レポートがオブジェクトを渡す順に、ブックマーク・リストに表示されます。 • 順序付けおよびインデントを明示したx#book_mark_name形式のテキスト文字列で、xにはアウトライン番号が入ります。シャープ記号（#）とアウトライン番号は、「ブックマーク」ウィンドウには表示されませんが、順序とインデントを決めるのに使用されます。たとえば、次のように指定します。 1#Expense Summary Section  2#Expense Detail Section 2.1#Expenses for the Administration Department 2.2#Expenses for the Engineering Department 2.3#Expenses for the Sales Department 2.3.1#Expenses for the Eastern Sales Region 2.3.2#Expenses for the Northern Sales Region 2.3.3#Expenses for the Southern Sales Region 2.3.4#Expenses for the Western Sales Region
プロパティ・パレット  プロパティ・パレットを使用してこの属性を定義するには、「ブックマーク」プロパティを設定します。


SRW.SET_BOOKMARKの制限

•	同じアウトライン番号が何回も使用する場合、エントリはすべて表示されますが、順序はレポートがオブジェクトを渡した順で定義されます。

•	番号がとんでいる場合、次の2つのうちの1つが発生します。同等レベルの番号がとんでいる場合は、目に見える影響はありません（たとえば、1.3.1と1.3.3で、1.3.2がない場合、同じインデント・レベルで並んで表示されます）。上位の番号と低位の番号の間がとんでいる場合、中間のレベルが必要に応じて生成されます（たとえば、1.0の後が2.1.1ならば、見かけ上の2と2.1のエントリが定義されます。 そのタイトルは、後の実際のエントリと同じになります）。

•	SRW.SET_BOOKMARKは次のトリガーのみに設定する必要があります。

Format


SRW.SET_BOOKMARKの例

  関連項目 	  すべての例

/* The format trigger below defines a bookmark for
** the boilerplate object B_2.  Notice the use of
** explicit ordering information (1#) in this example.
** If you did not want the ordering information, you
** could omit 1#.
*/

function B_2FormatTrigger return boolean is
begin
  srw.set_bookmark('1#Expense Summary Section');
  return (TRUE);
end;


動的SRW.SET_BOOKMARKの例

  関連項目 	  すべての例

/* The format trigger below defines a bookmark for
** the boilerplate object B_2.  Notice that the name
** of the bookmark is dynamic.CATEGORY is a column
** value that is concatenated with the string Expense
** Summary Section for each execution of the format
** trigger.In this case, CATEGORY could contain
** ordering information (e.g., 1#) or perhaps a string
** that makes the bookmark unique within the report.
*/

function B_2FormatTrigger return boolean is
begin
  srw.set_bookmark(:category ||
  ' Expense Summary Section');
  return (TRUE);
end;


SRW.SET_BORDER_PATTERN

  関連項目 [image]  設定属性プロシージャ 	  すべてのビルトイン

説明  このプロシージャは、オブジェクト境界線の塗りパターンを指定します。この属性はキャラクタ・モードでは無視されます。

構文

SRW.SET_BORDER_PATTERN('pattern');

パラメータ

pattern	境界線の塗りパターン(実線など)。
使用上の注意

•	このプロシージャは枠のパターンをサポートしていないので、Windowsプラットフォームに適用されません。

プロパティ・パレット  （テンプレートのみ）プロパティ・パレットを使ってテンプレートにこの属性を定義するには、「枠のパターン」プロパティを設定します。

ユーザー・インタフェース  境界線の属性をユーザー・インタフェースで設定する方法は、「オブジェクト境界線属性の変更」を参照してください。


SRW.SET_BORDER_WIDTH

  関連項目 [image]  設定属性プロシージャ 	  すべてのビルトイン

説明  このプロシージャは、オブジェクト境界線の幅をパイカ単位で指定します。

構文

SRW.SET_BORDER_WIDTH(width);

パラメータ

幅	0(ゼロ)または正の整数。ゼロは境界線がないことを示し、正の整数は境界線の幅をパイカ単位で示します。
ユーザー・インタフェース  境界線の属性をユーザー・インタフェースで設定する方法は、「オブジェクト境界線属性の変更」を参照してください。


SRW.SET_CHARMODE_TEXT

  関連項目 [image]  設定属性プロシージャ 	  すべてのビルトイン

説明  このプロシージャは、CHAR、DATEまたはNUMBERフィールドのフォント・スタイルを指定します。この属性はビットマップ・レポートでは無視されます。

構文

SRW.SET_CHARMODE_TEXT('style');

パラメータ

style	次のどれかである:   SRW.REVERSE_TEXTA SRW.BOLD_TEXTA SRW.REVERSEBOLD_TEXTA SRW.UNDERLINE_TEXTA SRW.UNDERLINEREVERSE_TEXTA SRW.REVERSEBOLDUNDERLINE_TEXTA SRW.PLAIN_TEXTA
ユーザー・インタフェース  フォントの属性をユーザー・インタフェースで設定する方法は、「テキストの属性の変更」を参照してください。


SRW.SET_CUSTOM_SPACING

  関連項目	  設定属性プロシージャ 	  すべてのビルトイン

説明  このプロシージャは、CHAR、DATEまたはNUMBERフィールドに先行するグローバル・テキストまたはボイラープレート・テキストを指定します。この属性はキャラクタ・モードでは無視されます。

構文

SRW.SET_CUSTOM_SPACING(spacing);

パラメータ

spacing	VGS単位で先行を示す数であり、非常に小さい。


SRW.SET_DISPLAY_NAME

  制限 	  例 	  関連項目	  設定属性プロシージャ 	  すべてのビルトイン

説明  このプロシージャは、HTMLまたはHTMLCSS形式のレポート出力のイメージ・オブジェクト上にカーソルが移動したときに、ポップアップとして表示されるテキストを指定します。

構文

SRW.SET_DISPLAY NAME('text_string');

パラメータ

text_string	ASCIIの26個の英文字（大文字および小文字）、数字またはアンダースコアのみを使った任意のテキスト文字列。他の特殊文字は、アンダースコア文字に自動的に変換されます。
プロパティ・パレット  プロパティ・パレットを使ってこの属性を定義するには、「ディスプレイ名」プロパティを設定します。


SRW.SET_DISPLAY_NAMEの制限

•	SRW.SET_DISPLAY_NAMEは、次のトリガーにのみ設定する必要があります。

フォーマット・トリガー


SRW.SET_DISPLAY_NAMEの例

  関連項目 	  すべての例

/* The format trigger below assigns a text string
** ('Click here to fill your shopping basket') to the image
** object BASKET.In the HTML report, this popup will display
** when the cursor moves over the BASKET object.
*/

function BASKETFormatTrigger return boolean is
begin
  SRW.SET_DISPLAY_NAME('Click here to fill your shopping basket');
  return (TRUE);
end;


SRW.SET_FIELD

  例 	  関連項目	  設定属性プロシージャ 	  すべてのビルトイン

説明  このプロシージャは、文字、数値または日付フィールドの値を設定します。これは、フィールドの値を条件付きで変更するのに便利です。

構文

SRW.SET_FIELD (object_id, text CHAR|number NUM|date DATE);

パラメータ

object_id	常に0(ゼロ)。 (オブジェクトは常に自身の属性を設定する必要があります。
text number date	フィールドに表示する文字、数値または日付の文字列。
使用上の注意

•	日付値の場合は、2番目の引数をTO_DATEファンクションで日付値に変換する必要があります。たとえば、次のように指定します。

srw.set_field(0, to_date('01-JAN-99'));

•	値の両側の引用符を省略すると、その値は数値と見なされます。たとえば、次のように指定します。

srw.set_field(0, 99);

あるいは、TO_NUMBERファンクションを使用すれば、引用符を使用することもできます。たとえば、次のように指定します。

srw.set_field(0, to_number('99'));

•	ファンクションなしで引用符を使用すると、その値は文字列と見なされます。あるいは、数値や日付値と統一するために、TO_CHARファンクションを使用することもできます。

srw.set_field(0, to_char('my string'));


SRW.SET_FIELDの例

/* Suppose you want to conditionally change the
** number of a field, based on each employee's salary.
** In the format trigger for the field, you could
** type the following:
*/

FUNCTION CHGFIELD RETURN BOOLEAN IS

TMP    NUMBER;

BEGIN

   if :sal >= 2000 then

     tmp := :sal * 1.08;

     srw.set_field (0, tmp);

else

     srw.set_field (0, 2500);

end if;

RETURN(TRUE);

END;


SRW.SET_FIELD_CHAR
SRW.SET_FIELD_CHAR;

  制限	  例	  関連項目	   設定属性プロシージャ 	  すべてのビルトイン

説明  このプロシージャは、文字フィールドの値を設定します。これは、フィールドの文字値を条件付きで変更するのに便利です。

構文

SRW.SET_FIELD_CHAR (object_id, text CHAR);

パラメータ

object_id	常に0(ゼロ)。 (オブジェクトは常に自身の属性を設定する必要があります。
text	フィールドに表示する文字列。


SRW.SET_FIELD_CHARの制限

•	SRW.SET_FIELD_CHARは、データ型が文字のフィールドのフォーマット・トリガーでのみ意味を持ちます。他の場所に入力しても影響はありません。


SRW.SET_FIELD_CHARの例

  関連項目 	  すべての例

/* Suppose you want to conditionally change the value of a
** Character field, based on each employee's salary.
** In the format trigger for the field, you could type the following:
*/

FUNCTION CHGFIELD RETURN BOOLEAN IS

BEGIN

   if :sal >= 2000000 then

     srw.set_field_char (0, 'HIGH SALARY');

end if;

RETURN(TRUE);

END;


SRW.SET_FIELD_DATE
SRW.SET_FIELD_DATE;

  制限 	  例	  関連項目	   設定属性プロシージャ 	  すべてのビルトイン

説明  このプロシージャは、日付フィールドの値を設定します。これは、フィールドの日付値を条件付きで変更するのに便利です。

構文

SRW.SET_FIELD_DATE (object_id, date DATE);

パラメータ:

object_id	常に0(ゼロ)。 (オブジェクトは常に自身の属性を設定する必要があります。
date	フィールドに表示する日付。


SRW.SET_FIELD_DATEの制限

•	SRW.SET_FIELD_DATEは、日付フィールドのフォーマット・トリガーでのみ意味を持ちます。他の場所に入力しても影響はありません。


SRW.SET_FIELD_DATEの例

  関連項目 	  すべての例

/* Suppose you want to conditionally change the date of the reunion
** invitation, based on each student's graduation year.In the format
** trigger for the field, you could type the following:
*/

FUNCTION CHGFIELD RETURN BOOLEAN IS

BEGIN

   if :graduation >= 1975 then

     srw.set_field_date (0, '02-JUL-95');

else

end if;

RETURN(TRUE);

END;


SRW.SET_FIELD_NUM
SRW.SET_FIELD_NUM;

  制限 	  例	  関連項目 	   設定属性プロシージャ 	  すべてのビルトイン

説明  このプロシージャは、数値フィールドの値を設定します。これは、フィールドの数値を条件付きで変更するのに便利です。

構文

SRW.SET_FIELD_NUM (object_id, number NUM);

パラメータ

object_id	常に0(ゼロ)。 (オブジェクトは常に自身の属性を設定する必要があります。
number	フィールドに表示する数値。


SRW.SET_FIELD_NUMの制限

•	SRW.SET_FIELD_NUMは、データ型がNUMBERのフィールドのフォーマット・トリガーでのみ意味を持ちます。他の場所に入力しても影響はありません。


SRW.SET_FIELD_NUMの例

  関連項目 	  すべての例

/* Suppose you want to conditionally change the number of a field,
** based on each employee's salary.In the format trigger for the
** field, you could type the following:
*/

FUNCTION CHGFIELD RETURN BOOLEAN IS

TMP    NUMBER;

BEGIN

   if :sal >= 2000 then

     tmp := :sal * 1.08;

     srw.set_field_num (0, tmp);

else

     srw.set_field_num (0, '2500');

end if;

RETURN(TRUE);

END;


SRW.SET_FILL_PATTERN

  関連項目 [image]  設定属性プロシージャ 	  すべてのビルトイン

説明  このプロシージャは、オブジェクトの塗りパターンを指定します。この属性はキャラクタ・モードでは無視されます。

構文

SRW.SET_FILL_PATTERN('pattern');

パラメータ

pattern	オブジェクトの塗りパターン(実線など)。
プロパティ・パレット  （テンプレートのみ）プロパティ・パレットを使用してテンプレートにこの属性を定義するには、「塗りパターン」プロパティを設定します。

ユーザー・インタフェース  パターンの属性をユーザー・インタフェースで設定する方法は、「パターンの変更」を参照してください。


SRW.SET_FONT_FACE

  関連項目 [image]  設定属性プロシージャ 	  すべてのビルトイン

説明  このプロシージャは、CHAR、DATEまたはNUMBERフィールドのフォントを指定します。この属性はキャラクタ・モードでは無視されます。

構文

SRW.SET_FONT_FACE('face');

パラメータ

face	フォント。 arialなど。
プロパティ・パレット  （テンプレートのみ）プロパティ・パレットを使用してテンプレートにこの属性を定義するには、「フォント」プロパティを設定します。

ユーザー・インタフェース  フォントの属性をユーザー・インタフェースで設定する方法は、「テキストの属性の変更」を参照してください。


SRW.SET_FONT_SIZE

  関連項目 [image]  設定属性プロシージャ 	  すべてのビルトイン

説明  このプロシージャは、CHAR、DATEまたはNUMBERフィールドのフォント・サイズを指定します。この属性はキャラクタ・モードでは無視されます。

構文

SRW.SET_FONT_SIZE(size);

パラメータ

size	フォント・サイズ。 9(ポイント)など。
プロパティ・パレット  （テンプレートのみ）プロパティ・パレットを使用してテンプレートにこの属性を定義するには、「フォント」プロパティを設定します。

ユーザー・インタフェース  フォントの属性をユーザー・インタフェースで設定する方法は、「テキストの属性の変更」を参照してください。


SRW.SET_FONT_STYLE

  関連項目 [image]  設定属性プロシージャ 	  すべてのビルトイン

説明  このプロシージャは、CHAR、DATEまたはNUMBERフィールドのフォント・スタイルを指定します。この属性はキャラクタ・モードでは無視されます。

構文

SRW.SET_FONT_STYLE(style);

パラメータ

style	次のどれかである: SRW.ITALIC_STYLE SRW.OBLIQUE_STYLE SRW.UNDERLINE_STYLE SRW.OUTLINE_STYLE SRW.SHADOW_STYLE SRW.INVERTED_STYLE SRW.BLINK_STYLE SRW.PLAIN_STYLE
使用上の注意

•	このプロシージャを同じフィールドで複数回使った場合、フォント・スタイルは蓄積されます。たとえば、次の場合はフィールドに下線が引かれイタリックに設定されます:

SRW.SET_FONT_STYLE(SRW.UNDERLINE_STYLE);
SRW.SET_FONT_STYLE(SRW.ITALIC_STYLE);

蓄積されたすべてのスタイルを否定するには、PLAIN_STYLE を使用します。

プロパティ・パレット  （テンプレートのみ）プロパティ・パレットを使用してテンプレートにこの属性を定義するには、「フォント」プロパティを設定します。

ユーザー・インタフェース  フォントの属性をユーザー・インタフェースで設定する方法は、「テキストの属性の変更」を参照してください。


SRW.SET_FONT_WEIGHT

  関連項目 [image]  設定属性プロシージャ 	  すべてのビルトイン

説明  このプロシージャは、CHAR、DATEまたはNUMBERフィールドのフォントの太さを指定します。この属性はキャラクタ・モードでは無視されます。

構文

SRW.SET_FONT_WEIGHT(weight);

パラメータ

weight	次のどれかである: SRW.ULTRALIGHT_WEIGHT SRW.EXTRALIGHT_WEIGHT SRW.LIGHT_WEIGHT SRW.DEMILIGHT_WEIGHT SRW.DEMIBOLD_WEIGHT SRW.BOLD_WEIGHT SRW.EXTRABOLD_WEIGHT SRW.MEDIUM_WEIGHT
プロパティ・パレット  （テンプレートのみ）プロパティ・パレットを使用してテンプレートにこの属性を定義するには、「フォント」プロパティを設定します。

ユーザー・インタフェース  フォントの属性をユーザー・インタフェースで設定する方法は、「テキストの属性の変更」を参照してください。


SRW.SET_FOREGROUND_BORDER_COLOR

  関連項目 [image]  設定属性プロシージャ 	  すべてのビルトイン

説明  このプロシージャは、オブジェクトのフォアグラウンド境界色を指定します。この属性はキャラクタ・モードでは無視されます。

構文

SRW.SET_FOREGROUND_BORDER_COLOR('color');

パラメータ

color	カラー・パレットからの有効なカラー。
プロパティ・パレット  （テンプレートのみ）プロパティ・パレットを使用してテンプレートにこの属性を定義するには、「枠のフォアグラウンド・カラー」プロパティを設定します。

ユーザー・インタフェース  フォアグラウンド境界色をユーザー・インタフェースで設定する方法は、「カラーの変更」を参照してください。


SRW.SET_FOREGROUND_FILL_COLOR

  関連項目 [image]  設定属性プロシージャ 	  すべてのビルトイン

説明  このプロシージャは、オブジェクトのフォアグラウンドのバックグランド色を指定します。この属性はキャラクタ・モードでは無視されます。

構文

SRW.SET_FOREGROUND_FILL_COLOR('color');

パラメータ

color	カラー・パレットからの有効なカラー。
プロパティ・パレット  （テンプレートのみ）プロパティ・パレットを使用してテンプレートにこの属性を定義するには、「フォアグラウンド・カラー」プロパティを設定します。

ユーザー・インタフェース  フォアグラウンド塗りカラーをユーザー・インタフェースで設定する方法は、「カラーの変更」を参照してください。


SRW.SET_FORMAT_MASK

  関連項目 [image]  設定属性プロシージャ 	  すべてのビルトイン

説明  このプロシージャは、DATEまたはNUMBERフィールドの書式マスクを指定します。

構文

SRW.SET_FORMAT_MASK('mask');

パラメータ

mask	有効な書式マスク。日付書式マスク構文または数値書式マスク構文を参照してください。
プロパティ・パレット  プロパティ・パレットを使用してこの属性を定義するには、「書式マスク」プロパティを設定します。


SRW.SET_HYPERLINK

  制限	  例	  関連項目 	  設定属性プロシージャ 	  すべてのビルトイン

説明  このプロシージャは、URL Webリンクを指定します。

注意: Webリンクのソースであるオブジェクトをアクションに関連付けることもできません。

構文

SRW.SET_HYPERLINK('hyperlink');

パラメータ

hyperlink	有効なリンク: • 同一マシン上の他の文書(たとえば、 file:/private/mynewdoc.pdf または file:///C|/temp/mynewdoc.pdf) • 別のマシン上の別の文書(たとえば、http://www.newmach.com/newdoc.pdf) • 現行文書内の宛先(たとえば、#my_dest_name) • ローカル文書内の宛先(たとえば、 file:/private/somedoc.pdf#a_dest_name) • リモート文書内の宛先(たとえば、 http://www.newmach.com/newdoc.pdf#some_dest_name) • すべてのURL (たとえば、 http://www.newmach.com/newdoc.html, ftp://www.reposit.com/filetoget.example, http://www.somemch.com/cgi-bin/webmenu?choice1)
プロパティ・パレット  プロパティ・パレットを使用してこの属性を定義するには、「ハイパーリンク」プロパティを設定します。


SRW.SET_HYPERLINKの制限

•	SRW.SET_HYPERLINKは次のトリガーのみに設定する必要があります:

フォーマット・トリガー

•	PDFビューアからリモート・サーバーまたはHTML文書へのWebリンクをたどるには、Webブラウザと連動するようにPDFビューアを構成する必要があります(たとえば、ヘルパー・アプリケーションとして構成したり、プラグインとしてWebブラウザにインストールします)。


SRW.SET_HYPERLINKの例

  関連項目 	  すべての例

/* The format trigger below defines a Web link
** to a destination (mytarget) in another document
** (newdoc.pdf) for the boilerplate object B_2.
** Note:If the target were in the same document,
** you would omit http://www.newmach.com/newdoc.pdf.
*/

function B_2FormatTrigger return boolean is
begin
  SRW.SET_HYPERLINK('http://www.newmach.com/newdoc.pdf' ||
  '#mytarget');
  return (TRUE);
end;


動的SRW.SET_HYPERLINKの例

  関連項目 	  すべての例

/* The format trigger below defines a Web link
** for the boilerplate object B_3.  Notice how the
** destination of the link is determined dynamically
** based upon the values of SRCDIR and CF_PICKVIDEO.
** For example, if the value of SRCDIR were
** http://www.newmach.com and CF_PICKVIDEO were good.avi,
** this function would assign the following Web
** link to the object:
** http://www.newmach.com/webdemo/src/good.avi.
*/

function B_3FormatTrigger return boolean is
begin
  SRW.SET_HYPERLINK(:srcdir||:cf_pickvideo);
  if ( upper(:cf_pickvideo) like '%GOOD%' ) then
    SRW.SET_FOREGROUND_BORDER_COLOR('green');
    SRW.SET_BACKGROUND_BORDER_COLOR('green');
  end if;
  return (TRUE);
end;

/* SRCDIR is a parameter whose value is determined at
** runtime by the following After Parameter Form trigger
*/

function AfterPForm return boolean is
begin
  :srcdir := :web_server || '/webdemo/src/';
  :docsdir := :web_server || '/webdemo/docs/';
  return (TRUE);
end;

/* CF_PICKVIDEO is a formula column whose value is
** determined by the following function
*/

function CF_pickvideoFormula return Char is
begin
  if ( :avg_h_div < .80 )
    then return ('bad.avi');
    else return ('good.avi');
  end if;
end;


SRW.SET_HYPERLINK_ATTRS

  制限 	  例	  関連項目	  設定属性プロシージャ 	  すべてのビルトイン

説明  このプロシージャは、プロパティ・パレットまたはSRW.SET HYPERLINKプロシージャで指定されたハイパーリンクに追加のHTMLコマンドを適用します。

構文

SRW.SET_HYPERLINK_ATTRS('string');

パラメータ

HTML_string	適用されるHTMLコマンドを含む文字列。
プロパティ・パレット  プロパティ・パレットを使ってこの属性を定義するには、「追加のハイパーリンク属性」プロパティを設定します。


SRW.SET_HYPERLINK_ATTRSの制限

•	SRW.SET_HYPERLINK_ATTRSは、次のトリガーにのみ設定する必要があります。

フォーマット・トリガー


SRW.SET_HYPERLINK_ATTRSの例

  関連項目 	  すべての例

/* The format trigger below generates a status
** of information at the bottom of your Web browser
** when the mouse cursor passes over a Shopping Basket
** object.
*/

function BASKETFormatTrigger return boolean is
begin
SRW.SET_HYPERLINK_ATTRS('onMouseover "window.status="Click here to see what is in your shopping basket";return true"'|| 'onMouseout ="window.status=" ";return true"');
  return (TRUE);
end;


SRW.SET_JUSTIFICATION

  関連項目 [image]  設定属性プロシージャ 	  すべてのビルトイン

説明  このプロシージャは、CHAR、DATEまたはNUMBERフィールドの水平文字位置を指定します。

構文

SRW.SET_JUSTIFICATION(justification);

パラメータ

justification	次のどれかである: SRW.LEFT_HJUST SRW.RIGHT_HJUST SRW.FLUSH_HJUST SRW.CENTER_HJUST.
プロパティ・パレット  （テンプレートのみ）プロパティ・パレットを使用してテンプレートにこの属性を定義する場合、文字フィールドでは「文字揃え」プロパティ、日付フィールドでは「日付揃え」プロパティ、数値フィールドでは「数値揃え」プロパティを設定します。

ユーザー・インタフェース  水平文字位置をユーザー・インタフェースで設定する方法は、「テキストの属性の変更」を参照してください。


SRW.SET_LINKTAG

  制限	  例	  関連項目 	  設定属性プロシージャ 	  すべてのビルトイン

説明  このプロシージャは、オブジェクトの識別子を指定したり、Webリンクの宛先として使用することができます。

構文

SRW.SET_LINKTAG('linktag');

パラメータ

linktag	ASCIIの26個の英文字(大文字および小文字)、数字またはアンダースコアのみを使用した、有効で、一意の名前。他の特殊文字は、アンダースコア文字に自動的に変換されます。
プロパティ・パレット  プロパティ・パレットを使用してこの属性を定義するには、「ハイパーリンクの宛先」プロパティを設定します。


SRW.SET_LINKTAGの制限

•	SRW.SET_LINKTAGは次のトリガーのみに設定する必要があります:

フォーマット・トリガー


SRW.SET_LINKTAGの例

  関連項目 	  すべての例

/* The format trigger below assigns an identifier
** (mytarget) to the boilerplate object B_500.
** This means that the object can now be the destination
** of a Web link.
*/

function B_500FormatTrigger return boolean is
begin
  SRW.SET_LINKTAG('mytarget');
  return (TRUE);
end;


動的SRW.SET_LINKTAGの例

  関連項目 	  すべての例

/* The format trigger below assigns an identifier to
** the field F_Dept by concatenating some static text
** (dept_details_) with the value of the source column
** (DEPTNO).This function ensures that a unique
** identifier is assigned to each instance of F_Dept.
*/

function F_DeptFormatTrigger return boolean is
begin
  SRW.SET_LINKTAG('dept_details_' ||
  LTRIM(TO_CHAR(:deptno)));
  return (TRUE);
end;


SRW.SET_MAXROW

  制限 	  例 	  関連項目	   設定属性プロシージャ 	  すべてのビルトイン

説明  このプロシージャは、指定した問合せの際にフェッチするレコードの最大数を設定します。これは、レポートが、フェッチする問合せ(1つ以上)よりも少ないレコードをフォーマットする(つまり、表示する)場合に便利です。したがって、SRW.SET_MAXROWを使用して、レポート用にフェッチするデータを条件付きで制限できるので、レポートのパフォーマンスが向上します。

構文

SRW.SET_MAXROW (query_name CHAR, maxnum PLS_INTEGER);

パラメータ

query_name	フェッチするレコードが制限される問合せ。
maxnum	問合せによりフェッチするレコードの最大数。
プロパティ・パレット  プロパティ・パレットを使用してこの属性を定義するには、「最大取出し行」プロパティを設定します。


SRW.SET_MAXROWの制限

•	SRW.SET_MAXROWは、Before Reportトリガーでのみ意味を持ちます(つまり、問合せが解析された後)。Before Reportトリガーの後にSRW.SET_MAXROW が呼び出された場合(つまり、問合せが実行された後)、SRW.MAXROW_UNSET パッケージ例外が発生します。

•	このプロシージャは指定した数のレコードのみをフェッチするので、問合せの"フェッチされない"レコードは計算などに使用されません。

•	レコードをフェッチしないように指定しても、問合せが解析されます。


SRW.SET_MAXROWの例

  関連項目 	  すべての例

/* Suppose your report has two queries, Q_Stocks and Q_Bonds.
** Suppose also, that you have a user-created parameter, named
** WHICHDATA, that enables users to specify which data they want
** the report to display:either stocks or bonds.In the
** Before Report trigger, you could use the SRW.SET_MAXROW
** procedure to ensure that only one query's data is fetched:
*/

FUNCTION FETCHIT RETURN BOOLEAN IS

BEGIN

   if :whichdata != 1 then

     srw.set_maxrow ('Q_Stocks', 0);

else

     srw.set_maxrow ('Q_Bonds', 0);

end if;

RETURN(TRUE);

END;


SRW.SET_PAGE_NAVIGATION_HTML

 関連項目	 設定属性プロシージャ 	  すべてのビルトイン

説明  このプロシージャは、ページ・ストリームHTML/HTMLCSSレポート出力のナビゲーション・コントロール用のスクリプトを指定します。

構文

SRW.SET_PAGE_NAVIGATION_HTML(type,'string');

パラメータ

type	SRW.FILE_ESCAPE またはSRW.TEXT_ESCAPE.stringパラメータがファイル名なのか、挿入するHTMLスクリプト・テキストなのかを示します。
文字列	ファイル名または挿入するHTMLスクリプト・コード。 typeパラメータに指定された値によって変わります。空白にした場合は、デフォルトのReport Builder JavaScriptを使って、レポート出力の各ページのナビゲーション・コントロールが定義されます。
使用上の注意

ナビゲーション・コントロールに自分で作成したスクリプトを使用する場合、スクリプトに次の3つの変数を含める必要があります。

•	&TotalPages（合計ページ数）

•	&file_name（出力宛先ファイルの名前。 例 myreport）

•	&file_ext （ファイル拡張子の名前。 例 htm）

Report Builderによって、書式設定時にこれらの変数が割り当てられます。

ページ・ナビゲーション・コントロール枠の高さは、スクロール・バーなしで70ポイントにハードコードされます。枠の幅は可変です。この枠の中でアイコンやイメージを使用する場合は、これらの寸法を覚えておいてください。

プロパティ・パレット  プロパティ・パレットを使用してこの属性を定義するには、「ページ・ナビゲーション・コントロール・タイプ」および「ページ・ナビゲーション・コントロール値」プロパティを設定します。


SRW.SET_PDF_ACTION

  制限 	  例	  関連項目 	   設定属性プロシージャ 	  すべてのビルトイン

説明  このプロシージャは、PDFビューアでオブジェクトがクリックされたときにローカル・マシンで実行されるコマンド行を指定します。

注意: アクションに関連付けられたオブジェクトを、Webリンクのソースにすることはできません。

構文

SRW.SET_PDF_ACTION('action');

パラメータ

action	ローカル・マシン上の任意の有効なコマンド行(たとえば、c:\orawin\bin\rwrun60 userid=scott/tiger report=example.rdfまたは/usr/local/bin/phone smith)。
プロパティ・パレット  プロパティ・パレットを使用してこの属性を定義するには、「アプリケーション・コマンド・ライン(PDF)」プロパティを設定します。


SRW.SET_PDF_ACTIONの制限

•	SRW.SET_PDF_ACTIONは、PDF出力でのみ使用できます。

•	SRW.SET_PDF_ACTIONは、次のトリガーのみに設定する必要があります:

Format


SRW.SET_PDF_ACTIONの例

  関連項目 	  すべての例

/* The format trigger below runs a
** report named example.rdf when the
** button object U_Report is clicked
** in the PDF viewer.
*/

function U_ReportFormatTrigger return boolean is
begin
  SRW.SET_PDF_ACTION ||
  ('c:\orawin\bin\rwrun60' ||
  'userid=scott/tiger ' ||
  'report=example.rdf');
end;


SRW.SET_PRINTER_TRAY

  制限 	  例 	  関連項目 	   設定属性プロシージャ 	  すべてのビルトイン

説明  このプロシージャは、有効なプリンタ・トレー名を指定したり、レポート書式に応じて異なるプリンタ・トレーに切り替えるために使用することができます。

構文

SRW.SET_PRINTER_TRAY('tray');

パラメータ

tray	有効なプリンタ・トレー名であり、レポート書式に応じて異なるプリンタ・トレーに切り替えるために使用することができる。
使用上の注意

•	オブジェクトのフォーマット・トリガーでSRW.SET_PRINTER_TRAYを使用する場合、オブジェクトが印刷されるページによってプリンタ・トレーは変更されます。次のトリガーで変更するまで、指定したプリンタ・トレーは維持されます。


SRW.SET_PRINTER_TRAYの制限

•	SRW.SET_PRINTER_TRAYは次のトリガーのみに設定する必要があります:

After Reportトリガー

Before Reportトリガー

Between Pagesトリガー

Formatトリガー

Before FormトリガーまたはAfter FormトリガーでSRW.SET_PRINTER_TRAYを使用する場合、無効コンテキスト・エラーが発生します。

•	Motif版のPCLプリンタにレポートを出力する場合、PRINTER_INTRAYは無視されます。


SRW.SET_PRINTER_TRAYの例

  関連項目 	  すべての例

/* The example below sets the printer
** tray in a Between Pages trigger.
*/

function BetweenPages return boolean is
begin
  SRW.SET_PRINTER_TRAY('letterhead');
  return (TRUE);
end;


SRW.SET_SPACING

  関連項目	  設定属性プロシージャ 	  すべてのビルトイン

説明  このプロシージャは、CHAR、DATEまたはNUMBERフィールドに先行するグローバル・テキストまたはボイラープレート・テキストを指定します。この属性はキャラクタ・モードでは無視されます。

構文

SRW.SET_SPACING(spacing);

パラメータ

spacing	次のどれかである:   SRW.SINGLE_SPACING SRW.DOUBLE_SPACING SRW.ONEHLF_SPACING


SRW.SET_TEXT_COLOR

   設定属性プロシージャ	  すべてのビルトイン

説明  このプロシージャは、CHAR、DATEまたはNUMBERフィールドのグローバル文字色を指定します。この属性はキャラクタ・モードでは無視されます。

構文

SRW.SET_TEXT_COLOR('color');

パラメータ

color	カラー・パレットからの有効なカラー。
プロパティ・パレット  （テンプレートのみ）プロパティ・パレットを使用してテンプレートにこの属性を定義するには、「テキスト・カラー」プロパティを設定します。

ユーザー・インタフェース  テキスト・カラーをユーザー・インタフェースで設定する方法は、「カラーの変更」を参照してください。


?


SRW.INTEGER_ERROR
SRW.INTEGER_ERROR;

  例 	  関連項目	  すべてのビルトイン

説明  この例外は、レポートの実行を停止し、次のエラー・メッセージを呼び出します。

REP-1417:  <SRW.MESSAGEまたはSRW.SET_MAXROW>に無効な整数引数が渡されました。

構文:

SRW.INTEGER_ERROR;

使用上の注意  Report Builderでは、内部エラーの結果、SRW.MESSAGEまたはSRW.SET_MAXROWが非整数によって使用された場合、この例外を呼び出します。（内部エラーがない場合は、PL/SQLがPL/SQL例外のVALUE_ERRORによって型の不一致を見つけます。


SRW.INTEGER_ERRORの例

  関連項目 	  すべての例

/* Suppose you want your own error message raised,
** instead of the default error message.
** You could handle this exception in the following way:
*/

EXCEPTION

when SRW.INTEGER_ERROR then

srw.message(4000, 'Contact the Application

Development group regarding SRW.INTEGER_ERROR.');

raise srw.program_abort;


SRW.MAXROW_INERR
SRW.MAXROW_INERR;

  例	  制限 	  関連項目 	  すべてのビルトイン

説明  この例外は、レポートの実行を停止し、次のエラー・メッセージを呼び出します。

REP-1424: SRW.SET_MAXROWの実行中に内部エラーが発生しました。

このエラーが発生した場合は、サポート担当に連絡してください。

構文

SRW.MAXROW_INERR;

使用上の注意  Report Builderでは、SRW.SET_MAXROWパッケージ・プロシージャの実行中に内部エラーを検出した場合、この例外を呼び出します。


SRW.MAXROW_INERRの制限

•	SRW.MAXROW_INERRを処理する場合、そのレポートには内部に問題があるので、必ずSRW.PROGRAM_ABORTを呼び出してレポートの実行を終了してください。


SRW.MAXROW_INERRの例

  関連項目 	  すべての例

/* Suppose you want your own error message raised,
** instead of the default error message.
** You could handle this exception in the following way:
*/

EXCEPTION

when SRW.MAXROW_INERR then

srw.message(1000, 'Contact Oracle''s customer

                support: SRW.MAXROW_INERR');

raise srw.program_abort;


SRW.MAXROW_UNSET
SRW.MAXROW_UNSET;

  例	  関連項目 	  すべてのビルトイン

説明  この例外は、一時的にレポートの実行を停止し、次のエラー・メッセージを呼び出します。メッセージが呼び出され、これをアクセプトすると、レポートは引き続き実行されます。

REP-1423: 問合せの実行開始後は、その最大行を変更できません。

構文

SRW.MAXROW_UNSET;

使用上の注意  Report Builderでは、問合せのレコードがフェッチされた後でSRW.SET_MAXROWパッケージ・プロシージャが使用された場合、この例外を呼び出します。


SRW.MAXROW_UNSETの例

  関連項目 	  すべての例

/* Suppose you want your own error message raised,
** instead of the default error message.
** You could handle this exception in the following way:
*/

EXCEPTION

when SRW.MAXROW_UNSET then

srw.message(1000, 'Data was fetched before

SRW.SET_MAXROW was called.');


SRW.MESSAGE

  制限	  例	  関連項目 	  すべてのビルトイン

説明  このプロシージャは、指定するメッセージ番号とテキストを持つメッセージを表示します。メッセージは、次の書式で表示されます。メッセージが呼び出され、これをアクセプトすると、レポートは引き続き実行されます。

MSG-msg_number:  msg_text.

構文

SRW.MESSAGE (msg_number NUMBER, msg_text CHAR);

パラメータ

msg_number	メッセージ・ラインに表示される1～10桁の番号。番号が5桁に満たないときは、5桁になるように0で埋められます。たとえば、123を指定すると、SRW-00123のように表示されます。
msg_text	メッセージ・ラインに表示される180バイト以下の文字。


SRW.MESSAGEの制限

•	Report Builderのエラー・メッセージの検出や変更はできません。

•	SRW.MESSAGEでは、レポートの実行を終了できません。メッセージを呼び出してからレポートを終了する場合は、SRW.PROGRAM_ABORTを使用します。

•	メッセージ文字列中に余分な空白があると、メッセージに表示されます。余分な空白は、Report Builderでは削除されません。


SRW.MESSAGEの例

  関連項目 	  すべての例

/* Suppose you have a user exit named MYEXIT to which you want to
** pass the values of the SAL column.Suppose, also, that you want
** to raise your own error if the user exit is not found (e.g., because
** it is not linked, compiled, etc.).To do these things, you could
** write the following PL/SQL in the Format Trigger of the F_SAL field:
*/

/* This trigger will raise your message as follows:
** MSG-1000: User exit MYEXIT failed.Call Karen Smith x3455.
*/

FUNCTION FOO RETURN BOOLEAN IS

BEGIN

srw.reference(:SAL);

srw.user_exit('myexit sal');

EXCEPTION

when srw.unknown_user_exit then

srw.message(1000, 'User exit MYEXIT failed.

Call Karen Smith x3455.');

raise srw.program_abort;

RETURN(TRUE);

END;


SRW.NULL_ARGUMENTS
SRW.NULL_ARGUMENTS;

  例	  関連項目	  すべてのビルトイン

説明  この例外は、レポートの実行を停止し、次のエラー・メッセージを呼び出します。

REP-1418: <SRW.DO_SQLまたはSRW.MESSAGE、SRW.RUN_REPORT、SRW.SET_MAXROW、SRW.USER_EXIT>にNULL引数が渡されました。

構文

SRW.NULL_ARGUMENTS;

使用上の注意  Report Builderでは、欠落引数でパッケージ・ファンクションまたはパッケージ・プロシージャが使用された場合、この例外を呼び出します。引数値をパッケージ･ファンクションまたはパッケージ ･プロシージャに渡すときや、渡された値がNULLでないことを確認するときに便利です（式列がSRW.USER_EXITをコールし、ユーザー･イグジット文字列が PL/SQLライブラリから渡された場合など）。

次の場合、この例外が呼び出される可能性があります。

•	SRW.DO_SQL

•	SRW.MESSAGE

•	SRW.RUN_REPORT;

•	SRW.SET_MAXROW

•	SRW.USER_EXIT;


SRW.NULL_ARGUMENTSの例

  関連項目 	  すべての例

/* Suppose you want your own error message raised,
** instead of the default error message.
** You could handle this exception in the following way:
*/

EXCEPTION

when SRW.NULL_ARGUMENTS then

srw.message(4000, 'Contact Application Development

regarding SRW.NULL_ARGUMENTS.');

raise srw.program_abort;


SRW.PROGRAM_ABORT
SRW.PROGRAM_ABORT;

  例 	  関連項目	  すべてのビルトイン

説明  この例外は、レポートの実行を停止し、次のエラー・メッセージを呼び出します。

REP-1419: PL/SQLプログラムが異常終了しました。

SRW.PROGRAM_ABORTを呼び出すと、レポートの実行が停止します。

構文

SRW.PROGRAM_ABORT;

使用上の注意  この例外は、PL/SQL内から呼び出す必要があります。


SRW.PROGRAM_ABORTの例

  関連項目 	  すべての例

/* Suppose you want to put a border around the salary if it is greater than 0.
** Suppose, also, that if the report fetches a salary less than 0, you want to
** raise a customized error message (i.e., "FOUND A NEGATIVE SALARY.. ."),
** then terminate the report execution.To do so, you could write the
** following format trigger for F_SAL.
*/

FUNCTION foo return boolean is

BEGIN

if :sal >= 0 then

srw.attr.mask         := SRW.BORDERWIDTH_ATTR;

   srw.attr.borderwidth := 1;

   srw.set_attr (0, srw.attr);

else

   srw.message(100, 'FOUND A NEGATIVE SALARY.

   CHECK THE EMP TABLE.');

   raise srw.program_abort;

end if;

RETURN(TRUE);

END;


SRW.REFERENCE

  制限	  例 	  関連項目	  すべてのビルトイン

説明  このプロシージャにより、ReportBuilderでは、参照オブジェクトをPL/SQL構成体の依存性リストに追加します。これによってReport Builderは、PL/SQL構成体を起動する直前に、参照オブジェクトの値を判断します。ユーザー・イグジットに渡された列値が、最後に計算またはフェッチされた値であることを確認するときに便利です。

構文

SRW.REFERENCE (:object CHAR|DATE|NUMBER);

パラメータ

object	Report Builderのパラメータあるいは列。PL/SQL構成体を起動させる前に、値を確認する必要があります。


SRW.REFERENCEの制限

•	オブジェクト名の前には、コロンが必要です。

•	SRW.REFERENCEは、オブジェクトがすでに現行のPL/SQL構造体内で参照されている場合には不要です。


SRW.REFERENCEの例

  関連項目 	  すべての例

/* Suppose you want to pass the temperature and pressure values
** to a user exit called SUPERHEAT.Suppose, also, that if the
** temperature is too low, you want to raise a customized error message.
** To do so, you could write the following formula:
*/

FUNCTION EXIT RETURN BOOLEAN IS

BEGIN

if :temp > 0 then

srw.reference (:temp); -- unnecessary reference

srw.reference (:pressure);

srw.user_exit('superheat temp pressure');

else srw.message(1000, 'Temperature is below

normal.Is machine off?');

raise srw.program_abort;

end if;

RETURN(TRUE);

END;


SRW.RUN_REPORT
SRW.RUN_REPORT;

  制限 	  例 	  関連項目	  すべてのビルトイン

説明  このプロシージャは、指定する文字列によってRWRUN60を起動します。このプロシージャは次の場合に便利です。

•	ドリルダウン・レポートを実行する（つまり、ボタンのアクション・トリガーからレポートをコールすること）。

•	レポートの一部を異なる受信者に送る（e-mailによって、各マネージャに、担当グループのデータのみを付けて、レポートを送る場合など）。

•	レポートの一部を異なるプリンタに送る（各マネージャのレポートを、各自のプリンタに送る場合など）。

•	1つのレポートから複数のレポートを実行する。

SRW.RUN_REPORTは指定したRWRUN60コマンドを実行します。

構文

SRW.RUN_REPORT (command_line CHAR);

パラメータ

command_line	有効なRWRUN60コマンド。


SRW.RUN_REPORTの制限

•	ランタイム・パラメータ・フォームに入力したパラメータ値をRWRUN60文字列に渡す場合は、フォーム前トリガーの後でSRW.RUN_REPORTをコールする必要があります。

•	このプロシージャに指定または渡される文字列は、ご使用のオペレーティング・システムの構文と大/小文字の区別のルールに従ってください。

•	SRW.RUN_REPORTプロシージャに対しては、ユーザーIDを指定しません。ユーザーIDは、「コール側」レポートによって継承されます。

•	SRW.RUN_REPORTを起動する親レポートがバッチで実行される場合、DESTYPEで指定できるのは「File」または,「Printer」、「Sysout」、「Mail」のみです。DESTYPEには、FileまたはPrinter、Sysout、Mailを指定することができます。

•	SRW.RUN_REPORTがPL/SQLでボタンに使用されている場合、そのボタンが選択されても、ランタイム・パラメータ・フォームはデフォルトでは表示されません。ランタイム・パラメータ・フォームを表示する場合は、SRW.RUN_REPORTの呼出しでPARAFORM=YESを指定する必要があります。

•	パスを指定しないと、Report Builderではファイル・パス検索順序 を使用して、レポートを検索します。


SRW.RUN_REPORTの例

  関連項目 	  すべての例

/* Suppose you have the following two reports:

** MGR_RUN, which queries manager names, and invokes a second report named MAIL_IT

** MAIL_IT, which queries employee names for the manager that MGR_RUN passes it,
**   and sends the report output to the manager via e-mail.

** The description of MGR_RUN could be as follows:

** Query:

SELECT ENAME, EMPNO FROM EMP WHERE JOB='MANAGER'

** Group Filter:
*/

FUNCTION FOO RETURN BOOLEAN IS

BEGIN

srw.run_report('report=MAIL_IT

desname='||:ename ||' desformat=dflt batch=yes

mgr_no='|| TO_CHAR(:empno) );

RETURN(TRUE);

EXCEPTION

when srw.run_report_failure then

srw.message(30, 'Error mailing reports.');

raise srw.program_abort;

END;

/* This PL/SQL invokes MAIL_IT, specifies that MAIL_IT's output
** should be sent to the manager via Oracle Mail, and passes the
** manager number, so that the MAIL_IT report can query only the
** manager's employees.

** Note:EMPNO's values must be converted to characters
** (TO_CHAR in the PL/SQL above), because SRW.RUN_REPORT
** requires a character string.

** Layout:None is needed, because this report only fetches data,
** then passes it to a second report.

** The description of MAIL_IT could be as follows:

** Query:

SELECT DEPTNO, ENAME, SAL FROM EMP WHERE MGR=:MGR_NO

** Layout:Master/Detail
*/

/* Suppose that you have three reports that you almost always run together.
** The reports are named SALARY, COMMISS, and TAXES.To run these reports
** with one RWRUN60 command, you create a driver report named PAYROLL.
** The description of PAYROLL could be as follows:

** Query:

SELECT DEPTNO FROM DEPT

** Before Report Trigger:
*/

FUNCTION FOO RETURN BOOLEAN IS

BEGIN

srw.run_report('batch=yes report=SALARY

destype=file desformat=dflt desname=salary.lis');

srw.run_report('batch=yes report=COMMISS

destype=file desformat=dflt desname=comiss.lis');

srw.run_report('batch=yes report=TAXES

destype=file desformat=dflt desname=comiss.lis');

RETURN(TRUE);

END;

/* Layout:   Tabular

** When you run PAYROLL from the designer or RWRUN60, the other three
** reports will all be run.(Note that, in this case, the query and
** the layout for Payroll could be anything.They are only used here
** in order to make it possible to run PAYROLL.)
*/


SRW.RUN_REPORT_BATCHNO

  例	  関連項目 	  すべてのビルトイン

説明  この例外は、レポートの実行を停止し、次のエラー・メッセージを呼び出します。

REP-1429:  <program unit name>: batch=noでは<procedure name>を起動できません。

構文

SRW.RUN_REPORT_BATCHNO;

使用上の注意  Report Builderでは、SRW.RUN_REPORTプロシージャがBATCH=NOを含むコマンド・ライン文字列によってコールされた場合、この例外を呼び出します。


SRW.RUN_REPORT_BATCHNOの例

  関連項目 	  すべての例

/* Suppose you want your own error message raised,
** instead of the default error message (above).
** You could handle this exception in the following way:
*/

EXCEPTION

when SRW.RUN_REPORT_BATCHNO then

srw.message(4000, 'Contact Application Dev.Services

regarding SRW.RUN_REPORT_BATCHNO.');

raise srw.program_abort;


SRW.RUN_REPORT_FAILURE

  例 	  関連項目 	  すべてのビルトイン

説明  SRW.RUN_REPORTパッケージ・プロシージャが失敗した場合、この例外はレポートの実行を停止し、次のエラー・メッセージを呼び出します。

REP-1428:  SRW.RUN_REPORTを実行中にエラーが発生しました。

構文

SRW.RUN_REPORT_FAILURE;

使用上の注意  SRW.RUN_REPORTパッケージ・プロシージャが失敗すると、Report Builderではこの例外を呼び出します。


SRW.RUN_REPORT_FAILUREの例

  関連項目 	  すべての例

/* Suppose you want your own error message raised, instead of the default
** error message (above).The following PL/SQL code raises a customized
** error message when SRW.RUN_REPORT_FAILURE is raised.
*/

EXCEPTION

WHEN srw.run_report_failure then

srw.message(30, 'Error mailing reports.');

raise srw.program_abort;


SRW.SET_ATTR

  属性のリスト	  制限 	  例	  関連項目	  すべてのビルトイン

新機能： Set Attributes Proceduresを使った属性の設定が、より便利になりました。互換性を保つため、まだSRW.SET_ATTRもサポートされています。しかし、この新しく簡単になったプロシージャの使用を強くお薦めします。

説明  SRW.SET_ATTRは、レイアウト・オブジェクトにフォントまたはサイズ、カラーなどの属性を設定します。SRW.SET_ATTRを使ってフォーマット属性を指定する手順は、次のとおりです:

1	SRW.ATTR.MASKを設定して、設定する属性（境界線など）を指定します。

2	1で指定した各属性（1文字の幅など）の値を指定します。

3	SRW.SET_ATTRプロシージャをコールして、オブジェクトにマスクを適用します。

注意: ほとんどの場合、オブジェクトのプロパティ・パレットでWebリンク(HTMLかPDF)とHTML属性を定義できます。条件付きの設定など、さらに複雑なインプリメントが必要な場合は、SRW.SET_ATTRを使用する必要があります。

•	Webリンクを指定するには、ACTIONおよびBOOKMARK、HYPERLINK、 LINKTAG属性を使用します。

•	HTML文書およびページ・ヘッダーとフッターを定義するには、BEFPAGE_ESCAPEおよびAFTPAGE_ESCAPE、BEFREPORT_ESCAPE、AFTREPORT_ESCAPE属性を使用します。

•	HTMLパラメータ・フォームのヘッダーとフッターを定義するには、BEFFORM_ESCAPEおよびAFTFORM_ESCAPEを使用します。

構文

SRW.ATTR.MASK := SRW.attr_ATTR [+ SRW.attr_ATTR.. .];
SRW.ATTR.attr := value; [SRW.ATTR.attr := value;.. .]
SRW.SET_ATTR (object_id, SRW.ATTR);

パラメータ

attr	設定する属性の名前(たとえば、BORDERWIDTH)。
object_id	またはSRW.REPORT_ID。BEFREPORT_ESCAPEおよびAFTREPORT_ESCAPE、BEFPAGE_ESCAPE、AFTPAGE_ESCAPEの値を設定する場合は、SRW.REPORT_IDです。その他の場合はすべて0です。
value	属性の有効値（たとえば、1はBORDERWIDTHの有効値になります）。


SRW.SET_ATTRの制限

•	属性（SRW.FILLPATT_ATTRなど）を指定する場合は、その値を指定する必要があります。指定しないと、その属性は予想できないものになります。

•	Report Builderパッケージにない値を指定する場合は、文字列（一重引用符で囲まれたもの）にしてください。たとえば、SRW.ATTR.FORMATMASKの値は、任意の値を指定できるので、引用符で囲む必要があります。SRW.ATTR.HJUSTの値は、Report Builderにある値から指定する必要があるので、引用符で囲まないでください。

•	SRW.SET_ATTRを使用しないと、フィールドにテキストの属性を設定することはできません。SRW.SET_ATTRは、ボイラープレート・テキストには使用できません。ボイラープレート・テキストのテキスト属性を変更するには、レイアウト・エディタの「書式」メニューまたはツール・パレットを使用します。


SRW.SET_ATTRキャラクタ・モードの例

  関連項目 	  すべての例

/* Here's an example of using all of the formatting
** attributes valid for character-mode reports.
** Notice that there are two values applied to the
** horizontal justification attribute (HJUST).
** Note:For the printer codes &1 and &2 to be
** meaningful, the printer definition file for
** this report must define what the printer should
** do for &1 and &2.
*/

function F_SALFormatTrigger return boolean is

begin

IF :SAL > 2000 THEN

SRW.ATTR.MASK        := SRW.BEFCODE_ATTR     +

SRW.AFTCODE_ATTR     +

SRW.TEXT_ATTR        +

SRW.FILLPATT_ATTR    +

SRW.BORDERWIDTH_ATTR +

SRW.FORMATMASK_ATTR  +

SRW.HJUST_ATTR;

SRW.ATTR.BEFCODE     := '&1';

SRW.ATTR.AFTCODE     := '&2';

SRW.ATTR.TEXT        := SRW.BOLD_TEXTA;

SRW.ATTR.FILLPATT    := 'TRANSPARENT';

SRW.ATTR.BORDERWIDTH := 1;

SRW.ATTR.FORMATMASK  := 'DD-MON-YY';

SRW.ATTR.HJUST       := SRW.CENTER_HJUST +

SRW.FLUSH_HJUST;

END IF;

SRW.SET_ATTR(0, SRW.ATTR);

RETURN(TRUE);

end;


SRW.SET_ATTR書式マスクの例

  関連項目 	  すべての例

/* If the salary is 2000, the following code
** segment sets the format mask to -99990.
*/

function F_SALFormatTrigger return boolean is

begin

if :sal = 2000 then

srw.attr.mask        := SRW.FORMATMASK_ATTR;

srw.attr.formatmask  := '-99990';

srw.set_attr (0, srw.attr);

end if;

RETURN(TRUE);

end;


SRW.SET_ATTRフィールド・カラー設定の例

  関連項目 	  すべての例

/* If the salary is 2000, this function sets the
** following attributes:border width to 1, foreground
** border color to "red," background border color
** to "blue," border pattern to "checker," foreground
** fill color to "yellow," background fill color to
** "green," and the fill pattern to "crisscross."
**
** Note: When you run the report with this PL/SQL
** construct in character mode, only the border width
** (of 1) and fill pattern (of solid) will be set;
** all other settings will be ignored.When you run
** the report with this PL/SQL construct in bitmap,
** all of the attributes will be set.(Be aware that
** the border background color cannot be set on some
** GUIs.)
*/

function F_SALFormatTrigger return boolean is

begin

if :sal = 2000 then

srw.attr.mask     := SRW.BORDERWIDTH_ATTR +

SRW.FBCOLOR_ATTR     +

SRW.BBCOLOR_ATTR     +

SRW.BORDPATT_ATTR    +

SRW.FFCOLOR_ATTR     +

SRW.BFCOLOR_ATTR     +

SRW.FILLPATT_ATTR;

srw.attr.borderwidth := 1;

srw.attr.fbcolor     := 'red';

srw.attr.bbcolor     := 'blue';

srw.attr.bordpatt    := 'checker';

srw.attr.ffcolor     := 'yellow';

srw.attr.bfcolor     := 'green';

srw.attr.fillpatt    := 'crisscross';

srw.set_attr (0, srw.attr);

end if;

RETURN(TRUE);

end;


SRW.SET_ATTRフィールド・テキスト属性設定の例

  関連項目	  すべての例

/* If the salary is 2000, this function
** sets the following text attributes:text
** to bold, font to TIMES, size to 18 points,
** style to underline, weight to bold, text color
** to "blue," and the justification to center.
**
** Note:When you run the report with this PL/SQL
** construct in character mode, only the text will
** be set to bold (SRW.TEXT_ ATTR); all other
** attributes will be ignored.When you run the
** report with this PL/SQL construct in bitmap,
** all of the attributes--except SRW.TEXT_ATTR-will
** be set.
*/

function F_SALFormatTrigger return boolean is

begin

if :sal = 2000 then

srw.attr.mask        := SRW.TEXT_ATTR       +

SRW.FACE_ATTR       +

SRW.SZ_ATTR         +

SRW.WEIGHT_ATTR     +

SRW.STYLE_ATTR      +

SRW.GCOLOR_ATTR     +

SRW.HJUST_ATTR;

srw.attr.text     := SRW.BOLD_TEXTA;

srw.attr.face     := 'times';

srw.attr.sz       := 18;

srw.attr.weight   := SRW.BOLD_WEIGHT;

srw.attr.style    := SRW.UNDERLINE_STYLE;

srw.attr.gcolor   := 'blue';

srw.attr.hjust    := SRW.CENTER_HJUST;

srw.set_attr (0, srw.attr);

end if;

RETURN(TRUE);

end;


SRW.SET_ATTR垂直間隔設定の例

  関連項目 	  すべての例

/* If the salary is 2000, this function sets
** the vertical spacing between lines to a custom
** size of 200 VGS units.(One inch is equivalent
** to 8192 VGS units.)
*/

function F_SALFormatTrigger return boolean is

begin

if :sal = 2000 then

srw.attr.mask        := SRW.GSPACING_ATTR;

srw.attr.gspacing    := SRW.CUSTOM_SPACING;

srw.attr.custom      := 200;

srw.set_attr (0, srw.attr);

end if;

RETURN(TRUE);

end;


SRW.SET_ATTRの例（プリンタ・トレイの切り替え）

  関連項目 	  すべての例

/* The example below sets the printer tray in a Between Pages trigger.
*/

function BetweenPages return boolean is
begin
   srw.attr.mask             := SRW.PRINTER_INTRAY_ATTR;
   srw.attr.printer_intray   := 'letterhead';
   srw.set_attr(SRW.REPORT_ID, srw.attr);
return (TRUE);
end;


SRW.TRACE_ADD_OPTION

  関連項目 	  すべてのビルトイン

説明  SRW.TRACE_ADD_OPTIONを使用すると、SRW.TRACE_STARTによるトレース情報のロギング開始後、新規のトレース・オプションの指定が可能になります。

次の例では、マスクに3つのトレース・オプションを指定してから、SRW.TRACE_ADD_OPTIONのコールの中でそのマスクを起動します。

SRW.TRACEOPTS.MASK := SRW.TRACE_ERR +
                      SRW.TRACE_BRK +
                      SRW.TRACE_PRF;
SRW.TRACE_ADD_OPTION(SRW.TRACEOPTS);

構文

SRW.TRACE_ADD_OPTION (SRW.TRACEOPTS);

パラメータ

SRW.TRACE OPTS	SRW.TRACEOPTS.MASKで前に定義したトレース・オプションのマスクを適用します。SRW.TRACE_APPENDとSRW.TRACE_REPLACEは、トレース・オプションではありません。SRW.TRACE_ADD_OPTIONと一緒に使用できないことに注意してください。


SRW.TRACE_END

  関連項目 	  すべてのビルトイン

説明  SRW.TRACE_ENDは、レポートの実行中に、トレース情報のファイルへのロギングを終了します。ロギングを開始するには、SRW.TRACE_STARTを使用します。

構文:

SRW.TRACE_END ();


SRW.TRACE_REM_OPTION

  関連項目 	  すべてのビルトイン

説明  SRW.TRACE_REM_OPTIONは、トレース・オプションを削除します。

次の例では、マスクに3つのトレース・オプションを指定してから、SRW.TRACE_REM_OPTIONのコールの中でそのマスクを起動します。

SRW.TRACEOPTS.MASK := SRW.TRACE_ERR +
                      SRW.TRACE_BRK +
                      SRW.TRACE_PRF;
SRW.TRACE_REM_OPTION(SRW.TRACEOPTS);

構文

SRW.TRACE_REM_OPTION (SRW.TRACEOPTS);

パラメータ

SRW.TRACE OPTS	SRW.TRACEOPTS.MASKによって前に定義したマスクにおけるトレース・オプションを削除します。SRW.TRACE_APPENDとSRW.TRACE_REPLACEは、トレース・オプションではありません。SRW.TRACE_REM_OPTIONと一緒に使用しないことに注意してください。


SRW.TRACE_START

  制限	  関連項目 	  すべてのビルトイン

説明  SRW.TRACE_STARTにより、レポートの実行中に、トレース情報のファイルへのロギングを開始することができます。ロギングを停止するには、SRW.TRACE_ENDを使用します。ログ・ファイルにどの情報を入れるかを指定することもできます。この情報は、レポートのデバッグやパフォーマンスのボトルネックを見つけ出すのに役立つ場合があります。マスクを定義して、どのトレース・オプションを適用するかを指定します。PL/SQLでトレース・オプションを設定するには、次の作業を行います。

1	起動させたいオプションを指定します。

2	SRW.TRACE_STARTプロシージャをコールするときに、SRW.TRACEOPTSを使用してオプションをオブジェクトに適用します。

次の例では、3つのトレース・オプションを指定してから、SRW.TRACE_STARTのコールでそれらのオプションを起動します。

SRW.TRACEOPTS.MASK := SRW.TRACE_ERR +
                 SRW.TRACE_BRK +
                 SRW.TRACE_PRF;
SRW.TRACE_START(test.dat, SRW.TRACE_APPEND, SRW.TRACEOPTS);

構文

SRW.TRACEOPTS.MASK := SRW.TRACE_opts [+ SRW.TRACE_opts . . .];

SRW.TRACE_START (filename,{SRW.TRACE_REPLACE|SRW.TRACE_APPEND}, SRW.TRACEOPTS);

パラメータ

filename	Report Builderがログ情報を格納するファイルの名前。
SRW.TRACE_APPEND	新しい情報を現在のファイルの内容と置き換えます。
SRW.TRACE_REPLACE	新しい情報を現在のファイルの内容と置き換えます。
SRW.TRACE OPTS	SRW.TRACEOPTS.MASKで前に定義したトレース・オプションのマスクを適用します。
Opts	有効トレース・オプション。


SRW.TRACEOPTS.MASK

  関連項目 	  すべてのビルトイン

トレース・マスクに適用可能なオプションとその意味は、次のとおりです。

マスク・オプション	説明
SRW.TRACE_ALL	ログ・ファイルに可能な限りのトレース情報を取得します。
SRW.TRACE_APP	ログ・ファイルにすべてのレポート・オブジェクトのトレース情報を取得します。
SRW.TRACE_BRK	ログ・ファイルにブレークポイントをリストします。
SRW.TRACE_DST	ログ・ファイルに配布リストをリストします。この情報を使って、どのセクションがどの宛先に送られたかを調べることができます。
SRW.TRACE_ERR	ログ・ファイルにエラー・メッセージと警告を取得します。
SRW.TRACE_PLS	ログ・ファイルにすべてのPL/SQLオブジェクトのトレース情報を取得します。
SRW.TRACE_PRF	ログ・ファイルにパフォーマンスの統計を取得します。
SRW.TRACE_SQL	ログ・ファイルにすべてのSQLのトレース情報を取得します。


SRW.TRACE_STARTの制限

•	ログ情報は、rdfファイルの実行時にのみ生成されます。repファイルの実行時に、ロギングの指定はできません。

•	一度に指定できるのは1つのログ・セッションのみです。SRW.TRACE_STARTを実行すると、自動的に他のログ・セッションは終了されます。


SRW.TRUNCATED_VALUE

  例 	  関連項目	  すべてのビルトイン

説明  この例外は、レポートの実行を停止し、2つのエラー・メッセージのうちのどちらかを呼び出します。エラーがPL/SQLの割当てが原因で発生した場合、次のメッセージが表示されます。

REP-1435: 列<parameter/column name>の値が切り捨てられました。

エラーがユーザー・イグジットIAF PUTが原因で発生した場合、次のメッセージが表示されます。

REP-1416: ユーザー・イグジット<name> IAF PUT:列<parameter/column name>の値が切り捨てられました。

SRW.TRUNCATED_VALUE例外が処理される場合、その値は切り捨てられ、パラメータまたは列に割り当てられたままになります。

構文

SRW.TRUNCATED_VALUE;

使用上の注意  ユーザー・イグジットまたはPL/SQL構成体が、オブジェクトの最大幅より大きい値をパラメータまたは列に割り当てようとすると、この例外が呼び出されます。


SRW.TRUNCATED_VALUEの例

  関連項目 	  すべての例

/* Suppose you want your own error message raised, instead of the
** default error message (above).You could handle this exception
** in the following way:
*/

EXCEPTION

when SRW.TRUNCATED_VALUE then

srw.message(2000, 'Contact Dan Brown:

SRW.TRUNCATED_VALUE.');


SRW.UNKNOWN_QUERY

  例	  関連項目 	  すべてのビルトイン

説明  この例外は、レポートの実行を停止し、次のエラー・メッセージを呼び出します。

REP-1427: SRW.SET_MAXROWで参照されている問合せ名が存在しません。

構文

SRW.UNKNOWN_QUERY;

使用上の注意  SRW.SET_MAXROWパッケージ・プロシージャが不明な問合せでコールされた場合に、この例外が呼び出されます。


SRW.UNKNOWN_QUERYの例

  関連項目 	  すべての例

/* Suppose you want your own error message raised,
** instead of the default error message (above).
** You could handle this exception in the following way:
*/

EXCEPTION

when SRW.UNKNOWN_QUERY then

srw.message(4000, 'Contact Per Jensen:

SRW.UNKNOWN_QUERY.');

raise srw.program_abort;


SRW.UNKNOWN_USER_EXIT

  例 	  関連項目	  すべてのビルトイン

説明  ユーザー・イグジットが不明な場合（リンクされていないなどの理由で）、この例外はレポートの実行を停止し、次のエラー・メッセージを呼び出します。

REP-1415: ユーザー・イグジットは不明です。

構文

SRW.UNKNOWN_USER_EXIT;

使用上の注意  SRW.USER_EXITまたはSRW.USER_EXIT20パッケージ・プロシージャに指定されたユーザー・イグジットが見つからない場合（ユーザー・イグジットがリンクされていなかったなどの理由で）、この例外が呼び出されます。


SRW.UNKNOWN_USER_EXITの例

  関連項目 	  すべての例

Suppose you want your own error message raised, instead of the default error message (above).The following PL/SQL will raise acustomized error message for SRW.UNKNOWN_USER_EXIT.

EXCEPTION

WHEN srw.unknown_user_exit then

srw.message(200, 'PASS USER EXIT WAS UNKNOWN.

CHECK IF IT''S LINKED.');


SRW.USER_EXIT

  制限	  例	  関連項目	  すべてのビルトイン

説明  このプロシージャは、user_exit_stringで指定したユーザー・イグジットをコールします。レポートの実行中に制御を3GLプログラムに渡すときに便利です。

構文

SRW.USER_EXIT (user_exit_string CHAR);

パラメータ

user_exit_string	コールするユーザー・イグジットの名前と、ユーザー・イグジット・プログラムに渡す任意の列またはパラメータです。


SRW.USER_EXITの制限

•	ユーザー・イグジットは、移植性がありません。レポートに移植性を持たせ、条件論理を追加する必要がある場合は、PL/SQLを使用します。

•	ユーザー・イグジット文字列により列またはパラメータをユーザー・イグジット・プログラムに渡す場合は、このプロシージャの前にSRW.REFERENCEをコールする必要があります。


SRW.USER_EXITの例

  関連項目 	  すべての例

/* Suppose you have a user exit named STORE to which you want
** to pass salary values from Report Builder.To do so, you
** could write the following formula.For more information on
** how to call user exits, see Calling a user exit.
*/

FUNCTION FOO RETURN BOOLEAN IS

BEGIN

IF :SAL >= 0 THEN

SRW.REFERENCE(:SAL);

SRW.USER_EXIT('STORE SAL');

ELSE

SRW.MESSAGE(100, 'FOUND A NEGATIVE SALARY.CHECK THE

EMP TABLE.');

END IF;

EXCEPTION

WHEN SRW.UNKNOWN_USER_EXIT THEN

SRW.MESSAGE(200, 'STORE USER EXIT WAS UNKNOWN.

CHECK IF IT''S LINKED.');

WHEN SRW.USER_EXIT_FAILURE THEN

SRW.MESSAGE(200, 'STORE USER EXIT FAILED.

CHECK ITS CODE.');

RETURN(TRUE);

END;


SRW.USER_EXIT20

  関連項目	  すべてのビルトイン

説明  このプロシージャは、コールするユーザー・イグジットの引数が2つではなく5つであるという点を除いて、SRW.USER_EXITと同じです。これにより、2つではなく5つの引数を渡すOracle Formsなどの他のOracle製品と、ユーザー・イグジットを共有することができます。

ユーザー・イグジットをコールするとき、SRW.USER_EXITによって次のものが渡されます。

•	指定した文字列

•	文字列の長さに対するポインタ

ユーザー・イグジットをコールするとき、SRW.USER_EXIT20によって次のものが渡されます。

•	指定した文字列

•	文字列の長さに対するポインタ

•	エラー文字列（この引数は、Report Builderでは使用されず、常に' 'の値を渡します）。

•	エラー文字列の長さに対するポインタ（この引数は、Report Builderでは使用されず、常に0の値を渡します）。

•	問合せ内引数（この引数は、Report Builderでは使用されず、常に0の値を渡します）。

構文

SRW.USER_EXIT20 (user_exit_string CHAR);

パラメータ

user_exit_string	コールするユーザー・イグジットの名前と、ユーザー・イグジット・プログラムに渡す任意の列またはパラメータです。


SRW.USER_EXIT_FAILURE

  例	  関連項目 	  すべてのビルトイン

説明  コールしたユーザー・イグジットが失敗したとき、この例外が呼び出されます。この例外が呼び出されると、レポートの実行を停止し、次のエラー・メッセージを呼び出します。

REP-1416: ユーザー・イグジット: <exit_name>が失敗しました。

構文

SRW.USER_EXIT_FAILURE;

使用上の注意  SRWERBバッファが空でない場合、この例外が呼び出されます。


SRW.USER_EXIT_FAILUREの例

  関連項目 	  すべての例

/* Suppose you want your own error message raised, instead of the
** default error message (above).The following PL/SQL code will
** raise a customized error message for SRW.USER_EXIT_FAILURE.
*/

EXCEPTION

when SRW.USER_EXIT_FAILURE then

SRW.MESSAGE(200, 'PASS user exit failed.

Check its code.');


パターン・パレット

Report Builderパターン・パレット内のパターンは、次の図解に表示されています。

  ここをクリックしてください。

  ここをクリックしてください。


デフォルト・カラー・パレット

デフォルトのカラー・パレットは、作業環境で他のパレットを指定していない場合にReport Builderが使用するカラー・パレットです。デフォルトのカラーパレット・ファイルの名前は、default.palです。使用しているシステムでのこのファイルの場所の詳細は、使用しているオペレーティング・システム用インストレーション・マニュアルを参照してください。

デフォルトのカラー・パレットは、次のルールで定義されています。

•	パレットの左上の領域には、次の名前のついた16の通常使用されているカラーが含まれています。

black    white        green      darkgreen

gray     darkgray     cyan       darkcyan

red      darkred      blue       darkblue

yellow   darkyellow   magenta    darkmagenta

•	パレットの左下の領域には、カスタム定義カラーを置く8個の空のセルが含まれています。

•	次の4個の列は、多様なグレー・シェードで構成されています。各カラーは、グレーの割合の値に従って、「gray<value>」という名前が付いています。この値は、増分値4で4から96の範囲にあります。たとえば、有効なカラー名には、「gray 96」および「gray 92」、「gray 4」があります。

•	パレットの残りの部分には、多様な割合の赤および緑、青（RGB）のコンポーネントで指定されているカラーが含まれています。

•	赤または緑のそれぞれのコンポーネントの割合値は、0、25、50、75、88または100です。

•	青のそれぞれのコンポーネントの割合値は、0、50、75、88または100です。

各カラーは、RGB値に従って「r<value>g<value>b<value>」の名前が付いています（たとえば、100%の赤および88%の青、0%の緑で構成されているカラーには「r100g0b88」という名前が付けられます）。

•	前述のカラー・セルを除いて、パレットは、5個の主要な領域で構成されており、各領域には6x6の配置で38のカラーが含まれています。これらのカラーは、次のルールで定義されます。

•	赤の値は、主要な各領域内でカラーが左から右に進むにつれて増加します。

•	緑の値は、主要な各領域内でカラーが上から下に進むにつれて増加します。

•	青の値は、同じ青の値を使用している1つの領域のすべてのカラーと一緒に、主要な領域が左から右に進むにつれて増加します。


グレースケール・カラー・パレット

グレースケール・カラー・パレットは、多様なグレー・シェードのみで構成されています。これは、次のルールで定義されています。

•	最初の2つのカラーには、「black」および「white」という名前が付いています。

•	パレットの残りの部分には、多様な割合のグレーで指定されているカラーが含まれています。各カラーは、グレーの割合の値に従って、「gray <value>」という名前が付きます。これらのカラーは、次のルールで定義されます。

•	最初のグレー・カラーのグレーの値（「white」の右側）は、100%で、「gray100」という名前が付けられています。

•	パレットの左から右へカラーが進むにつれて（1つの行の一番右側のセルから次の行の一番左側のセルに折り返して）、各カラーのグレーの値は1つ前の値より0.5小さくなります。

•	「gray12.5」以降は、各カラーのグレーの値は1つ前の値より0.25小さくなります。

•	グレーの値は、パレットの最後にある「gray0」という名前のカラーまで減少し続けます。


Oracle CDE1カラー・パレット

Oracle CDE1カラー・パレットは、リリース2.0のデフォルトのカラー・パレットです。これは、次のルールで定義されています。

•	パレットの最初の2列には、次のものが含まれています。

•	「blue」および「magenda」、「red」、「cyan」、「green」、「white」という名前の付いた通常使用するカラー

•	「black」および「gray60」、「gray45」、「gray30」、「gray15」、「yellow」という名前の付いたグレー・シェード

•	パレットの残りの部分には、多様な割合の赤および緑、青（RGB）のコンポーネントで指定されているカラーが含まれています。それぞれのコンポーネントの割合値は、0、40、55、70、85または100です。

各カラーは、RGB値に従って「r<value>g<value>b<value>」の名前が付いています（たとえば、100%の赤および40%の青、0%の緑で構成されているカラーには「r100b40g0」という名前が付けられます）。

最初の2列を除いて、パレットは、6個の主要な領域で構成されており、各領域には6x6の配置で36のカラーが含まれています。これらのカラーは、次のルールで定義されます。

•	赤の値は、主要な各領域内でカラーが左から右に進むにつれて増加します。

•	緑の値は、主要な各領域内でカラーが上から下に進むにつれて増加します。

•	青の値は、同じ青の値を使用している1つの領域のすべてのカラーと一緒に、主要な領域が左から右に進むにつれて増加します。


Query Builderメッセージ

  関連項目

メッセージ範囲をクリックし、「参照」ボタンを使用してページを検索することにより、目的のメッセージを探します。

BRW-15000～BRW-15092

BRW-15093～BRW-15146

BRW-15147～BRW-15196

BRW-15197～BRW-15390

BRW-15391～BRW-15424

BRW-15430～BRW-15520

BRW-15521～BRW-15569

BRW-15570～BRW-15912

BRW-15913～BRW-16551

BRW-16552～BRW-16660


BRW-15000: Query Builderのエラー・ハンドラで内部エラーが発生しました。

原因:	エラー・ハンドラを起動できませんでした。

処置:	サポート担当に連絡してください。


BRW-15001: <message number>

原因:	メッセージ・ファイルは見つかりませんでした。 またはこのバージョンのQuery Builderと互換性がありません。

処置:	Oracle HomeのQuery Builderディレクトリで適切なメッセージ・ファイルを確認してください。


BRW-15002: メモリーが足りません。

原因:	メモリー不足です。

処置:	文書を保存し、Oracle Query Builderを再始動してください。


BRW-15003: ファイル名: <name>が無効です。

原因:	ユーザーは無効なファイル名（たとえば、文字数が多い）を入力しました。

処置:	新しい、有効なファイル名を入力してください。


BRW-15004: 内部エラーです(<Value1>:<Value2>)。

原因:	内部エラーが発生しました。 Oracle Query Builderが信頼性のない状態にあります。

処置:	サポート担当に連絡してください。


BRW-15005: ファイル名が指定されていません。

原因:	「データをエクスポート」ダイアログ・ボックスでファイル名が入力されませんでした。

処置:	ファイル名を入力してください。


BRW-15006: データ表をDESCRIBEできません。

原因:	内部メッセージ。

処置:	サポート担当に連絡してください。


BRW-15007: SQL文が複雑すぎて表示できません。

原因:	MS Wｉｎｄｏｗｓで編集バッファ・サイズを超過しました.

処置:	問合せから列をいくつか除外して、SQL文のサイズを小さくしてください。


BRW-15009: Query Builderからログインする権限がありません。

原因:	接続権限がSYSTEM.BROWSER_PROFILE表で使用不可になっています。

処置:	DBAに連絡してください。


BRW-15065: 構文エラーです。

原因:	計算式を間違って入力しました。

処置:	式を入力し直してください。


BRW-15066: 式が複雑すぎます。

原因:	式が複雑すぎます。

処置:	式を簡単にしてください。


BRW-15068: ファンクション: <name>が無効です。

原因:	無効なファンクション名を入力しました。

処置:	有効なファンクションを指定してください。


BRW-15069: 列: <name>が無効です。

原因:	無効な列名を入力しました。

処置:	有効な列名を入力してください。


BRW-15070: 表: <name>が無効です。

原因:	無効な表名を入力しました。

処置:	有効な表名を入力してください。


BRW-15071: 所有者: <name>が無効です。

原因:	無効なユーザー名またはビジネス・エリア名を入力しました。

処置:	有効なユーザー名またはビジネス・エリア名を入力してください。


BRW-15072: 条件が無効です。

原因:	無効な条件を入力しました。

処置:	その条件を削除し、有効な条件を入力してください。


BRW-15073: 式が無効です。

原因:	無効な式を入力しました（通常スペース）。

処置:	有効な式を入力してください。


BRW-15074: 予約語: <name>は使用できません。

原因:	ユーザーは予約語を識別子として使用しました。

処置:	予約語を識別子にすることはできません。詳細は、ヘルプまたはドキュメンテーションを参照してください。


BRW-15075: ファンクション: <name>への引数の数が無効です。

原因:	ファンクションに入力した引数が、少なすぎるか多すぎます。

処置:	適切な引数を入力してください。詳細は、ヘルプまたはドキュメンテーションを参照してください。


BRW-15077: 名前があいまいです: <name>

原因:	あいまいな列名を入力しました。

処置:	固有の列名を入力してください。修飾子が必要である可能性があります。


BRW-15078: 名前: <name>が再定義されています。

原因:	すでに存在する名前を使用して列またはデータ表を再定義しました。

処置:	新しい名前を使用して列または表を定義してください。


BRW-15079: 問合せで選択された列がありません。

原因:	表示列を指定しないで問合せを作成または入力されました。

処置:	問合せを再実行する前に列を選択してください。


BRW-15080: 問合せで表が選択されていません。

原因:	表を指定せずに問合せを入力しました。

処置:	問合せを再実行する前に表を選択してください。


BRW-15081: START WITHにはCONNECT BYが必要です。

原因:	SQL文にSTART WITH句が入っていますが、CONNECT BY句がありません。

処置:	START WITH句を使用する場合、CONNECT BY句を指定してください。


BRW-15082: PRIORにはCONNECT BYが必要です。

原因:	SQL文にPRIOR句が入っていますが、CONNECT BY句がありません。

処置:	PRIOR句を使用する場合、CONNECT BY句を指定してください。


BRW-15083: ファンクション: <name>の引数の型が無効です。

原因:	入力した関数の引数の型が間違っています。

処置:	正しい引数の型を入力してください。


BRW-15084: コメントが終了していません。

原因:	読み込まれるバッファに、未終了のC型コメントが入っています。

処置:	ファイルを編集（正しく終了されているかどうか確認）し、Query Builderから再度オープンしてください。


BRW-15085: 定義列に循環参照があります。

原因:	定義済み列を修正すると循環参照になります。

処置:	列を再定義し、それ自身の定義内で自己を参照しないようにしてください。


BRW-15086: 相互関係のある副問合せファンクションへの引数は、列を指定する必要があります。

原因:	avg (sal, deptno*2)のような複雑な引数が与えられました。

処置:	副問合せには式ではなく有効な列のみを指定してください。


BRW-15087: ロケーション: <name>は無効です。

原因:	表に関して無効なデータベース・ロケーションを入力しました。

処置:	有効なデータベース・ロケーションを入力してください。


BRW-15088: 表: <表名>があいまいです。

原因:	あいまいなデータ表名を入力しました（この名前は複数の表が使用しています）。

処置:	データ表をさらに修飾する必要があります。詳細は、ヘルプまたはドキュメンテーションを参照してください。


BRW-15089: 式でPRIOR演算子は1つのみ使用できます。

原因:	1つの式に2つ上のPRIOR句を入力しました。

処置:	PRIOR句を1つ削除してください。


BRW-15090: 名前: <name>はすでに使用されています。

原因:	すでに使用されている名前を入力しました。

処置:	新しい名前を入力してください。


BRW-15091: 名前: <name>は無効です。

原因:	無効な名前を入力しました（スペースまたは印字不能のキャラクタがあります）。

処置:	新しい名前を入力してください。


BRW-15092: 外部リレーションの使用方法が無効です。

原因:	列以外の要素に外部リレーションを指定しました。

処置:	外部リレーションは列に対してのみ有効です。


BRW-15093: 対応レコードの要素の数が無効です。

原因:	ユーザーは要素数の異なる2つのレコードを入力しました。

処置:	条件を再入力してください。


BRW-15094: グループ・ファンクションのネストが深すぎます。

原因:	ユーザーは、二重（三重）の集約条件（式）を入力しました。

処置:	集約条件/式を簡単にしてください。


BRW-15096: 表名は<名前1>と重複しているので、<名前2>に改名されました。

原因:	問合せをオープン中に、表の別名が新しい列と重複します。

処置:	別名を改名してください。


BRW-15097: 名前が<名前1>と重複しているので、<名前2>に改名されました。

原因:	保存された問合せをロード中に、別名が新しい列と重複します。

処置:	別名を改名してください。


BRW-15098: FROM句に複製の表: <表名>があります。

原因:	FROM句にデータ表が（別名なしで）複数存在します。

処置:	FROM句の重複しているデータ表名を削除してください。


BRW-15099: 副問合せで不正な値数が戻されました。

原因:	副問合せで返された値が多すぎるか少なすぎます。

処置:	条件を再入力してください。


BRW-15100: 相関式はここでは使用できません。

原因:	ユーザーは、無効な相関式を入力しました。

処置:	条件/式を再入力してください。


BRW-15101: 表の別名<名前>は、同一のFROM句では使用できません。

原因:	別名をそれ自体が定義されたFROM句で使用しようとしました。

処置:	別名への参照を削除してください。


BRW-15102: レコードの要素が多すぎます。

原因:	レコードに、254より多くの要素数があります。

処置:	要素数を減らしてください。 条件をORに分解します。


BRW-15103: FROM句に名前のないSELECT文があります。

原因:	SQLには、名前のない問合せを指定したFROM句があります。

処置:	問合せ名を追加してから、再度解析してください。


BRW-15110: 数値が無効であるか、精度を超えています: <名前>

原因:	非英数字入力または数が、この列の精度を超えました。

処置:	有効な数と精度を再入力してください。


BRW-15111: 日付: <値>は無効です。

原因:	列の書式マスクまたはデフォルト・マスクを使用してフォーマットできませんでした。

処置:	有効な書式マスクを再入力してください。


BRW-15112: 入力値: <##>は、この列のサイズ制限を超えています。

原因:	入力された文字列が、列のサイズ制限を超えています。

処置:	文字列を短くしてください。


BRW-15113: 指定されていないパラメータがあります。

原因:	すべてのパラメータを定義しないで問合せを実行しようとしました。

処置:	パラメータを指定するか、パラメータ付き式を除外して、再試行してください。


BRW-15114: パラメータには必ず定数式を用いてください。

原因:	列値に依存するパラメータ値を入力しようとしました。

処置:	列値に依存しない有効なパラメータを指定してください。


BRW-15115: パラメータ:<名前>の使用方法が間違っています。

原因:	列または表のパラメータ名を入力しました。

処置:	有効なパラメータを指定してください。


BRW-15116: パラメータ名:<名前>は無効です。

原因:	無効なパラメータ名を入力しました。

処置:	有効なパラメータ名を指定してください。


BRW-15117: パラメータ:<名前>が無効です。

原因:	無効なパラメータを入力しました。

処置:	有効なパラメータを指定してください。


BRW-15128: パーサーの内部エラー:<値>が発生しました。

原因:	パーサー/スキャナに内部エラーが発生しました。

処置:	サポート担当に連絡してください。


BRW-15129: 定義済み列:<名前>は、相関副問合せでは使用できません。

原因:	相関副問合せで派生列（DQ4）が使用されています。

処置:	相関副問合せからその引数を削除してください。


BRW-15130: 問合せの実行に失敗しました。

原因:	データベース・アクセス・エラーです。

処置:	データベース・エラーをチェックし、問合せを再度実行してください。


BRW-15131: 関係演算子が無効です。

原因:	条件に無効な演算子を適用しました。

処置:	有効な演算子を入力してください。


BRW-15132: FROM句が指定された位置にありません。

原因:	FROM句が指定されていないか、またはFROM句の前にGROUP/HAVING句が指定されています。

処置:	SQL文を編集してください。


BRW-15133: SELECT句と対応していないFROM句が見つかりました。

原因:	SELECT句の前にFROM句があります。

処置:	SQL文を編集してください。


BRW-15135: 条件は変更できません。

原因:	ユーザーは、スキーマ・エディタでトップの条件を変更しようとしました。

処置:	子条件に対して操作を実行してください。


BRW-15136: SQLにSET演算子があります。

原因:	集合演算はサポートされていません。

処置:	SQL*Plusで問合せを実行してください。


BRW-15137: 式が複雑で名前を生成できません。

原因:	SQLファイルをオープン中に名前のない式を検出しました。

処置:	.sqlファイルの列名を定義してください。


BRW-15138: CONNECT BY句がありましたが、無視されました。

原因:	Connect Byはこの（トップ）レベルではサポートされていません。

処置:	CONNECT BYの結果が目的どおりかどうか、SQL*Plusで問合せを実行してください。


BRW-15139: 条件のグループ解除ができません。

原因:	トップの条件をグループ解除しようとしています。

処置:	この操作はサポートされていません。


BRW-15141: BRW-15141: 問合せ表にパラメータを含むことはできません。
BRW-15141: 問合せ表にパラメータを含むことはできません。

原因:	ビューを作成中に、1つ以上のパラメータを検出しました。

処置:	問合せからパラメータを除外するか、無視してください。


BRW-15142: 2以上の列が同じ名前:<名前>です。
BRW-15142: 2つ以上の列が同じ名前:<名前>です。

原因:	ビュー作成中に、重複する列名を検出しました。

処置:	「定義」コマンドを使用して、重複列を改名してください。


BRW-15143: <名前>はすでに表示列です。

原因:	重複する表示列を指定しようとしました。

処置:	重複列を指定するには、新しい名前を定義して再表示してください。


BRW-15144: <名前>はすでにソート列です。

原因:	重複ソート列を指定しようとしました。

処置:	重複列を指定するには、新しい名前を定義して再ソートしてください。


BRW-15145: <名前>はすでにグループ列です。

原因:	重複グループ列を指定しようとしました。

処置:	重複列を指定するには、新しい名前を定義して再グループ化してください。


BRW-15146: 問合せのオープンで内部エラーが発生しました。

原因:	問合せをオープン中に、内部エラーが発生しました。

処置:	サポート担当に連絡してください。


BRW-15147: 問合せの保存中に内部エラーが発生しました。

原因:	問合せを保存中に内部エラーが発生しました。

処置:	サポート担当に連絡してください。


BRW-15148: リレーションは互換性のあるデータ型/サイズ間でのみ成立します。

原因:	互換性のないデータ型を持つ2つの列を関係付けようとしました。

処置:	互換性のあるデータ型のみを関係付けてください。詳細は、ヘルプまたはドキュメントを参照してください。


BRW-15150: 自分自身に対するリレーションは定義できません。

原因:	一つのデータ表内にリレーションをしようとしました。

処置:	データ表に別名を付けてから、リレーションを定義してください。


BRW-15151: ユーザー定義のリレーションはすでに存在します。

原因:	すでに存在するリレーションを定義しようとしました。

処置:	処置は不要です。


BRW-15152: 定義済みリレーションの列が間違っています。

原因:	リレーションを定義中に不正な式を指定しました。

処置:	新しい列をもう一度入力してください。


BRW-15153: 表の別名を _A<数>で終わることはできません。

原因:	別名が無効です。

処置:	末尾が_A<数>でない新しい名前を入力してください。


BRW-15154: データベース・リレーションを削除できません。

原因:	データ・ディクショナリのリレーションを削除しようとしました。

処置:	ユーザーが定義したリレーションのみを削除できます。


BRW-15155:文書:<名前>が影響を受けている可能性があります。

原因:	保存された問合せが、他の問合せ文書でデータ表として使用されていました。

処置:	この問合せを変更または削除すると、その他の問合せに影響を与えます。


BRW-15156: 問合せと同じ名前の表を取り込めません。

原因:	データ表Dを問合せ文書Dに取り込もうとしました。

処置:	この表を取り込む前に問合せを改名してください。


BRW-15157: LONG列はSORT、GROUPまたはBREAKできません。

原因:	LONG列に対してソート、グループ化またはブレークしようとしています。

処置:	操作を取り消します。Oracleではこの操作はサポートされていません。


BRW-15158: RAW列はSORT、GROUP、BREAKできません。

原因:	RAW列に対してソート、グループ化またはブレークしようとしています。

処置:	操作を取り消します。Oracleではこの操作はサポートされていません。


BRW-15159: リモート・データベースからLONG列を表示できません。

原因:	リモート・データベース・データ表からLONG列を取り込もうとしています。

処置:	操作を取り消します。Oracleではこの操作はサポートされていません。


BRW-15160: 列の最大数: <##>を超えました。

原因:	サポートされる表示/グループ/ソート列の最大数を超過しました。

処置:	不要な列をいくつか削除してから、必要なものを再度取り込んでください。


BRW-15161: 表示列: <名前>をオープン中にエラーが発生しました。

原因:	保存後、データベースが変更されているのでDISPLAY列をオープンできません。

処置:	この列は変更されたか、データベースに存在していません。


BRW-15162: ソート列: <列名>1をオープン中にエラーが発生しました。

原因:	保存後、データベースが変更されているのでSORT列をオープンできません。

処置:	この列は変更されたか、データベースに存在していません。


BRW-15163: グループ列: <名前>をオープン中にエラーが発生しました。

原因:	保存後、データベースが変更されているのでGROUP列をオープンできません。

処置:	この列は変更されたか、データベースに存在していません。


BRW-15164: ブレーク列: <列名>をオープン中にエラーが発生しました。

原因:	保存後、データベースが変更されているのでBREAK列をオープンできません。

処置:	この列は変更されたか、データベースに存在していません。


BRW-15165: ブレーク列の最大数: <##>を超えました。

原因:	サポートされているブレーク列の最大数を超えました。

処置:	不要なブレーク列を削除してから、必要なものを再度取り込んでください。


BRW-15166: 条件: <値>のオープンでエラーが発生しました。

原因:	保存後、データベースが変更されているので条件をオープンできません。

処置:	この条件で使用される表または列は、データベースに存在していません。


BRW-15167: 別名は、<##>バイト以下にする必要があります: <名前>

原因:	別名が長すぎます。

処置:	30バイトかそれ以下の長さの別名を入力してください。


BRW-15168: 集約式に対してグループ化ができません。

原因:	集約式に対してグループ化しようとしました。

処置:	別の式に対してグループ化を実行してください。


BRW-15169: <名前>は、既にブレーク列として指定されています。

原因:	重複したブレーク列を指定しようとしました。

処置:	同じ列を指定するには、新しい名前を定義し、再度ブレークしてください。


BRW-15170: 表: <名前>の制約が無効です。

原因:	選択された表にとって無効な制約を入力しました。

処置:	制約を再入力してください。


BRW-15171: 表列: <名前>の制約が無効です。

原因:	選択された列にとって無効な制約を入力しました。

処置:	制約を再入力してください。


BRW-15172: 制約では副問合せは使用できません。

原因:	無効な制約を入力しました。

処置:	制約を再入力してください。


BRW-15173: 制約では集約条件は使用できません。

原因:	無効な制約を入力しました。

処置:	制約を再入力してください。


BRW-15174: 制約は、1つの表上でのみ使用できます。

原因:	無効な制約を入力しました。

処置:	制約を再入力してください。


BRW-15175: すべての列が非表示になっているため表がロードされませんでした。

原因:	すべての列が隠されています。少なくとも1つの列が表示されている必要があります。

処置:	Query Builder Administrator Utilityを使って隠し列を表示させてください。


BRW-15188: 問合せの戻り値は1行です。

原因:	1行Query Countのステータス・メッセージです。

処置:	処置は不要です。


BRW-15189: 問合せの戻り値は<##>行です。

原因:	n行Query Countのステータス・メッセージです。

処置:	処置は不要です。


BRW-15190: 問合せを実行しなければカウントできません。問合せの戻り値は<##>行以下です。

原因:	n行Query Count Distinctのステータス・メッセージです。

処置:	処置は不要です。


BRW-15192: 書式: <名前1>(列: <名前2>)が間違っています。

原因:	ある表示列にとって認識不能な書式をタイプしました。

処置:	別の書式をタイプしてください。


BRW-15193: 書式が無効です。

原因:	ある表示列にとって認識不能な書式を入力しました。

処置:	別の書式を入力してください。


BRW-15195: リレーション: <名前>は列に型の互換がありません。

原因:	不正なリレーションを作成しようとしています。

処置:	列タイプに互換性がありません。詳細は、ヘルプまたはドキュメントを参照してください。


BRW-15196: 表: <名前>をオープン中にエラーが発生しました。

原因:	データベースが修正されたか、オブジェクトが存在しないために、データ表をオープンできません。

処置:	接続文字列を調べてください（あるいはDBAに連絡してください）。


BRW-15197: 列: <名前>の位置の回復中にエラーが発生しました。

原因:	データベースが変更されたか、オブジェクトが存在しないために、列の再配置ができません。

処置:	接続文字列を調べてください（あるいはDBAに連絡してください）。


BRW-15198: 結合: <値>の回復中にエラーが発生しました。

原因:	データベースが変更されたか、オブジェクトが存在しないため、オープン中はリンクを回復できません。

処置:	接続文字列を調べてください（あるいはDBAに連絡してください）。


BRW-15199: 結合: <値>の内容の回復中にエラーが発生しました。

原因:	データベースが変更されたか、オブジェクトが存在しないために、オープン中は取込み状態を設定できません。

処置:	接続文字列を調べてください（あるいはDBAに連絡してください）。


BRW-15200: 結合: <値>の外部結合状態の回復中にエラーが発生しました。

原因:	データベースが変更されたか、オブジェクトが存在しないために、オープン中は外部結合を設定できません。

処置:	接続文字列を調べてください（あるいはDBAに連絡してください）。


BRW-15258: 文書名が無効です: <名前>

原因:	無効な文書名を入力しました。

処置:	有効な文書名を入力してください。


BRW-15259: 文書が64Kのサイズ制限を超えました。

原因:	64K以上の文書を保存/オープンしようとしました。

処置:	文書のサイズを減らしてください。


BRW-15260: 文書: <名前>は存在していません。

原因:	存在しない文書を指定しました。

処置:	別の文書を指定してください。


BRW-15261: 文書: <名前>はすでに存在しています。

原因:	すでに存在する文書名で保存しようとしました。

処置:	別の文書名を指定するか、既存文書を削除してください。


BRW-15262: <名前>という名前の文書が複数存在します。

原因:	同じ名前の文書が複数存在しています。

処置:	1つを除きすべてを削除してください。


BRW-15263: データベース・オブジェクト: <名前>はすでに存在しています。

原因:	すでに存在するオブジェクトの名前で保存しようとしました。

処置:	別の文書名を指定してください。


BRW-15264: 表: <名前>は存在していません。

原因:	保存文書に対応するビューが削除されています。

処置:	文書（もはや問合せビューとしては存在しません）を再保存してください。


BRW-15265: 表: <名前>は削除または変更されました。

原因:	保存文書に対応するデータ表ビューが変更されています。

処置:	文書を再保存してください。


BRW-15266: ファイル: <名前>は存在していません。

原因:	存在しないファイルを指定しました。

処置:	別のファイルを指定してください。


BRW-15267: ファイル: <名前>はすでに存在しています。

原因:	すでに存在するファイルの名前で保存しようとしました。

処置:	別のファイル名を指定してください。


BRW-15268: ファイル: <名前>をオープンできません。

原因:	I/Oコアがファイルをオープンできませんでした。

処置:	別のファイルを指定してください。


BRW-15269: ファイル: <名前>をロックできません。

原因:	I/Oコアがファイルをロックできませんでした。

処置:	別のファイルを指定してください。


BRW-15270: ファイル: <名前>の読込みでエラーが発生しました。

原因:	オペレーティング・システム・エラーまたはファイルが正しい形式ではありません。

処置:	別のファイルを指定してください。


BRW-15271: ファイル: <名前>の書込みでエラーが発生しました。

原因:	オペレーティング・システム・エラーまたはI/Oコア・エラーです。

処置:	再試行してください。


BRW-15272: Query Builder文書: <名前>は旧い文書です。

原因:	サポートされていない旧い文書をオープンしようとしました。

処置:	別の文書を指定してください。


BRW-15273: ファイル: <名前>はQuery Builderファイルではありません。

原因:	Query Builderファイルではない文書をオープンしようとしました。

処置:	別のファイルを指定してオープンしてください。


BRW-15274: SQLファイル: <名前>は有効ではありません。

原因:	無効なSQLファイルをインポートしようとしました。

処置:	別のファイルを指定してインポートしてください。


BRW-15275: エクスポート、または出力するデータがありません。

原因:	データのない問合せ（またはリージョン）をエクスポートまたは印刷しようとしました。

処置:	別のリージョンを指定するか、問合せを実行するか、問合せを変更してください。


BRW-15277: 作業中の表: <名前>を上書きできません。

原因:	保存されている旧データ表を削除/改名しようとしてエラーが発生しました。

処置:	データ表の問題を修正し、再度保存してください。


BRW-15278: 文書は保存されましたが、ビュー:<名前>を作成できませんでした。

原因:	問合せは有効なビューではありません。保存はされていますが、データベース・ビューとしてではありません。

処置:	問合せを有効なビューとして再定義するか、無視してください（問合せは保存されますが、ビューとしては保存されません）。


BRW-15279: SQL文'<名前>'は正しくありません。

原因:	ユーザーは、非SQL*Plusファイルをインポートしようとしました。

処置:	別のファイルを指定してインポートしてください。


BRW-15320: 内部I/Oコア･エラー(<値>,行<##>)。

原因:	内部ステートが無効です。

処置:	サポート担当に連絡してください。


BRW-15321: リソースが見つかりません(<名前>)。

原因:	リソース名がQuery Builderコードに一致しません（または、ファイルが壊れています）。

処置:	Query Builderリソース・ファイルの正しいバージョンを入手してください。


BRW-15322: リソース・ファイルが見つかりませんでした。

原因:	ディレクトリ構造が間違っています。 あるいは、何らかの理由でファイルが失われています。

処置:	リソース・ファイルの所在を確認してください（NLS_LANGファイル名をチェックしてください）。


BRW-15323: 問合せは、現アプリケーション(<名前>)ですでにオープンされています。

原因:	ユーザーは、複数の問合せを同じ名前でオープンしようとしました。

処置:	別のファイルを指定してください。


BRW-15324: ウィンドウ・システムを起動できません。

原因:	環境変数が不正かまたは失われています（例: DISPLAY、APIPATH）。

処置:	必要な環境変数がすべて正しく設定されている必要があります。


BRW-15342: スナップショット情報が見つかりません。

原因:	このデータベースではスナップショットはサポートされていません（もしくは、データベース・エラーです）。

処置:	スナップショット・ディクショナリ表が存在するかチェックしてください。


BRW-15387: ログインに失敗しました。

原因:	データベースまたはSQL*Netエラーが発生しました。

処置:	ログイン情報をチェックし、再試行してください。


BRW-15388: データベース・リレーションがロードできません。

原因:	データベース・リレーションをロード中にスキーマ内部エラーが発生しました。

処置:	このエラーを予期していなかった場合は、サポート担当に連絡してください。


BRW-15389: アクセスできる所有者のリストをロードできません。

原因:	アクセス可能な所有者のリストをロード中にスキーマ内部エラーが発生しました。

処置:	このエラーを予期していなかった場合は、サポート担当に連絡してください。


BRW-15390: アクセス可能な表のリストをロードできません。

原因:	データ表のリストをロード中にスキーマ内部エラーが発生しました。

処置:	このエラーを予期していなかった場合は、サポート担当に連絡してください。


BRW-15391: 表をロードできません。

原因:	データ表をロード中にスキーマ内部エラーが発生しました。

処置:	このエラーを予期していなかった場合は、サポート担当 に連絡してください。


BRW-15392: 表をロードできません。

原因:	表をロード中にスキーマ内部エラーが発生しました。

処置:	このエラーを予期していなかった場合は、サポート担当 に連絡してください。


BRW-15393: シノニムをロードできません。

原因:	シノニムをロード中にスキーマ内部エラーが発生しました。

処置:	このエラーを予期していなかった場合は、サポート担当 に連絡してください。


BRW-15394: 問合せをロードできません。

原因:	問合せをロード中にスキーマ内部エラーが発生しました。

処置:	このエラーを予期していなかった場合は、サポート担当 に連絡してください。


BRW-15395: 表の列情報をロードできません。

原因:	列情報をロード中にスキーマ内部エラーが発生しました。

処置:	このエラーを予期していなかった場合は、サポート担当 に連絡してください。


BRW-15396: シノニムの列情報をロードできません。

原因:	シノニム列情報をロード中にスキーマ内部エラーが発生しました。

処置:	このエラーを予期していなかった場合は、サポート担当 に連絡してください。


BRW-15397: 制約をロードできません。

原因:	制約をロード中にスキーマ内部エラーが発生しました。

処置:	このエラーを予期していなかった場合は、サポート担当 に連絡してください。


BRW-15398: 主キー情報が見つかりません。

原因:	主キーを探索中にスキーマ内部エラーが発生しました。

処置:	このエラーを予期していなかった場合は、サポート担当 に連絡してください。


BRW-15399:外部キー情報が見つかりません。

原因:	外部キーを探索中にスキーマ内部エラーが発生しました。

処置:	このエラーを予期していなかった場合は、サポート担当 に連絡してください。


BRW-15400: 表と列のコメントをロードできません。

原因:	コメント取得中にスキーマ内部エラーが発生しました。

処置:	このエラーを予期していなかった場合は、サポート担当 に連絡してください。


BRW-15401: データベース・リンク: <名前>のロードでエラーが発生しました。

原因:	データベース・リンクをロード中にスキーマ内部エラーが発生しました。

処置:	詳細については、後に続くエラー・メッセージを参照してください。


BRW-15402: 所有者: <名前>のロードでエラーが発生しました。

原因:	データベース・リンクをロード中にスキーマ内部エラーが発生しました。

処置:	詳細については、後に続くエラー・メッセージを参照してください。


BRW-15403:表: <名前>をロード中にエラーが発生しました。

原因:	データ表をロード中にスキーマ内部エラーが発生しました。

処置:	詳細については、後に続くエラー・メッセージを参照してください。


BRW-15404: <名前>の主キー制約:<名前>(<値>)のロードでエラーが発生しました。

原因:	主制約をロード中にスキーマ内部エラーが発生しました。

処置:	詳細については、後に続くエラー・メッセージを参照してください。


BRW-15405: 外部キー制約:<名前>のロードでエラーが発生しました。

原因:	外部キー制約をロード中にスキーマ内部エラーが発生しました。

処置:	詳細については、後に続くエラー・メッセージを参照してください。


1BRW-5406: シノニム: <名前>のロードでエラーが発生しました。
BRW-15406: シノニム: <名前>のロードでエラーが発生しました。

原因:	主制約をロード中にスキーマ内部エラーが発生しました。

処置:	詳細については、後に続くエラー・メッセージを参照してください。


BRW-15407:シノニム: <名前>によって参照されている表は存在しません。

原因:	存在しないデータ表のシノニムを作成しようとしました。

処置:	シノニムを再作成してください。


BRW-15408: <名前>の列情報のロードでエラーが発生しました。

原因:	Oracleエラーまたはデータ表が削除されています。

処置:	データ表を再作成してください。


BRW-15409: <名前>の制約情報: <値>のロードでエラーが発生しました。

原因:	Oracleエラーです。

処置:	再試行してください。


BRW-15410: 外部キー<名前>(<値>)が参照する表にアクセスできません。

原因:	外部キーが参照する表はアクセス不能です。

処置:	現ユーザーにその表へのアクセス権を付与してください。


BRW-15411: ログアウトに失敗しました。

原因:	ログアウト中に内部エラーが発生しました。

処置:	終了するか、文書をクローズしてください。


BRW-15412: 問合せ: <名前>の表が変更されました。問合せはビューとしてロードされました。

原因:	問合せが依存するビューに、最後の保存以降変更があります。

処置:	問合せをオープンして、データ表として使用するために再度保存してください。


BRW-15413: 問合せ: <名前>の表が削除されました。問合せはロードされません。

原因:	問合せが依存するビューは、削除されています。

処置:	問合せをオープンして、データ表として使用するために再度保存してください。


BRW-15414: 表: <名前>は存在していません。

原因:	このデータ表は、データベースに存在しません。

処置:	この表が必要な場合はシステム管理者に連絡してください。


BRW-15415: 表の最大列数(254)を超えています。

原因:	列が254以上あるデータ表をロードしようとしました。

処置:	システム管理者に連絡してください。


BRW-15416: ユーザー毎の最大表数(8192)を超えています。

原因:	ユーザーの所有するデータ表が多すぎます。

処置:	システム管理者に連絡してください。


BRW-15417: 所有者およびデータベースの最大数(1024)を超えました。

原因:	あまりにも多くのユーザー、所有者およびデータベース・リンクをロードしようとしました。

処置:	システム管理者に連絡してください。


BRW-15418: データベース・リンク情報が見つかりません。

原因:	このデータベースでは、データベース・リンクまたはデータベース・エラーをサポートされていません。

処置:	このエラーが予測外の場合は、後でもう一度試してください。


BRW-15419: シノニム情報が見つかりません。

原因:	このデータベースでは、シノニムまたはデータベース・エラーはサポートされていません。

処置:	このエラーが予測外の場合は、後でもう一度試してください。


BRW-15420: 制約情報が見つかりません。

原因:	このデータベースでは、制約またはデータベース・エラーはサポートされていません。

処置:	このエラーが予測外の場合は、後でもう一度試してください。


BRW-15421: 表のコメント表が見つかりません。

原因:	このデータベースでは、表についてのコメントはサポートされていません。 またはデータベース・エラーです。

処置:	このエラーが予測外の場合は、後でもう一度試してください。


BRW-15422:表の列のコメント表が見つかりません。

原因:	このデータベースでは、列についてのコメントはサポートされていません。 またはデータベース・エラーです。

処置:	このエラーが予測外の場合は、後でもう一度試してください。


BRW-15423: シーケンスへのシノニムは現在サポートされていません。

原因:	シーケンスを参照するシノニムをロードしようとしました。

処置:	処置はサポートされていません。


BRW-15424: ログインの試行回数が最大数(3)を超えました。

原因:	ログイン回数が多すぎます。

処置:	システム管理者に連絡して正しいユーザー名、パスワードおよび（または）接続文字列を取得してください。


BRW-15430: 索引情報がロードされていません。

原因:	索引表を見つけることができません。

処置:	これは非Oracleデータベースです。 ODBCドライバを試してください。


BRW-15434: 表の最大列数は、<##>です。

原因:	ユーザーは、1つの表で許されている最大列数を超えて、列を作成しようとしました。

処置:	作成する列の数を減らしてください。


BRW-15435: この操作を行う場合には管理者権限が必要です。

原因:	DBA権限が必要です。

処置:	システム管理者にDBA権限の付与を依頼してください。


BRW-15447: 問合せを削除できません。問合せウィンドウで「ファイル」>「削除...」を実行してください。

原因:	問合せを削除しようとしました。

処置:	この操作は、スキーマ・エディタからはできません。かわりに「問合せ」ウィンドウを使ってください。


BRW-15448: 問合せをコピーできません。問合せウィンドウで「別名保存...」を実行してください。

原因:	問合せをコピーしようとしました。

処置:	この操作は、スキーマ・エディタからはできません。かわりに「問合せ」ウィンドウを使ってください。


BRW-15449: LONG列のみの表からデータをコピーすることはできません。

原因:	LONG列を持つ表をコピーしようとしました。

処置:	データベースでは、サポートされていません。


BRW-15450: 削除された表での操作は許可されていません。

原因:	ユーザーは、削除済みのデータ表に対して処理を行おうとしました。

処置:	最初に削除を解除してください。


BRW-15451: 削除された列での操作は許可されていません。

原因:	ユーザーは、削除済みのデータ列に対して処理を行おうとしました。

処置:	最初に削除を解除してください。


BRW-15452: 別所有者の表を改名できません。

原因:	アクセス権を与えられたデータ表の名前を設定しようとしました。

処置:	この処理は、許可されていません。所有者に改名を依頼してください。


BRW-15466: 表名が長すぎます(最大<##>バイト)。

原因:	データ表名が長すぎます。

処置:	名前を短くして、もう1度試してください。


BRW-15467: 名前はすでに使用されています。別の名前を選択してください。

原因:	名前はすでに使用されています。

処置:	別の名前を選択してください。


BRW-15468: 列名が長すぎます(最大 <##>バイト)。

原因:	列名が長すぎます。

処置:	名前を短くして、もう1度試してください。


BRW-15493: この操作は現在サポートされていません。

原因:	内部エラーです。

処置:	サポート担当に連絡してください。


BRW-15494: ビューのSQLテキストをロード中にエラーが発生しました。

原因:	内部エラーです。

処置:	サポート担当に連絡してください。


BRW-15495: ビュー: <名前>用SQLテキストをロード中にエラーが発生しました。

原因:	内部エラーです。

処置:	サポート担当に連絡してください。


BRW-15496: 位取りは<##>から<##>の間で設定してください。

原因:	スケールには不正な値です。

処置:	スケールに正しい値を入力してください。


BRW-15498: 問合せを変更できません。

原因:	問合せを変更することは正しくありません。

処置:	問合せをオープンして、それをQuery Builder文書として変更してください。


BRW-15499: データ付きでコピーされた表の列属性を設定できません。

原因:	重複データを持つ表の列タイプを設定しようとしました。

処置:	まず表をコミットし、再試行してください。


BRW-15501: アプリケーション用の仮想メモリーが確保できません。

原因:	ディスクに空きスペースがないか、仮想メモリー・マネージャのシステム・メモリーがありません。

処置:	文書をクローズするか、ディスクに空き領域を作ってください。


BRW-15502: 文書あたり<##>行しか作成できません。

原因:	self-imposedのコンパイル時の最大行を超えました。

処置:	問合せの条件の付加を検討してください。


BRW-15504: データベースの文字設定を決定できません。

原因:	SELECT USERENV('LANGUAGE') FROM DUALに問題がありました。

処置:	非Oracleデータベースです。 サポートされていません。


BRW-15505: 仮想メモリー・ファイルをオープンできません。

原因:	書込み権限がないかまたはファイル・システムがいっぱいです。

処置:	ディレクトリに対する権限を変更するか、ファイルをいくつか削除してください。


BRW-15506: 仮想メモリー・ファイルをクローズできません。

原因:	オペレーティング・システム・エラーです。

処置:	システム管理者に問い合せてください。


BRW-15507: 仮想メモリー・ファイルからの読込みができません。

原因:	仮想メモリー・ファイルは存在しません。

処置:	仮想メモリー・ファイルがオープンされていることを確認してください。


BRW-15508: 仮想メモリー・ファイルへの書込みができません。

原因:	ファイル・システムがいっぱいか、仮想メモリー・ファイルがオープンされていません。

処置:	ファイルをいくつか削除してください。仮想メモリー・ファイルがオープンされていることを確認してください。


BRW-15509: 仮想メモリー・マネージャを作成できません。

原因:	内部エラーか、メモリー不足です。

処置:	システム管理者に問い合せてください。


BRW-15511: 仮想メモリーの最大サイズを超えました。

原因:	仮想メモリー・サイズが大きすぎます。

処置:	再試行してください。


BRW-15513: コマンド: <名前>にはNULL値があります。

原因:	コマンド行で、オプションを選択せずに<コマンド>=を入力しました。

処置:	<コマンド>のための値を追加してください。


BRW-15514: コマンド・ラインがNULLです。

原因:	コマンド行で=<値>を入力しましたが、コマンドを指定しませんでした。

処置:	コマンドを追加してください。


BRW-15515: コマンド・ラインのコマンド: <名前>を認識できません。

原因:	ユーザーはコマンド行で不正なコマンドを入力しました。

処置:	コマンドを変更してください。


BRW-15516: コマンド: <名前>は、コマンド・ラインで2度指定されています。

原因:	コマンド行で1つのコマンドを2回入力しました。

処置:	1つを削除してください。


BRW-15517: 指定されたコマンド: <名前1>とコマンド: <名前2>には互換性がありません。

原因:	ユーザーは、コマンド行で2つの互換性のないコマンドを入力しました。

処置:	1つを削除してください。


BRW-15518: オプション: <名前1>(コマンド: <名前2>中)が無効です。

原因:	コマンド行で、コマンドに不正なオプションを入力しました。

処置:	オプションを変更してください。


BRW-15519: コマンド・ラインで複数のログインが指定されました。

原因:	コマンド行で2つのログインを入力しました。

処置:	1つを削除してください。


BRW-15520: コマンド・ラインの文書名: <名前>が無効です。

原因:	ユーザーは、コマンド行で不正な文書名を入力しました。

処置:	文書名を変更してください。


BRW-15521: コマンド:'<名前>'は、文書なしで指定されています。

原因:	コマンド行で文書を指定せずにコマンドを入力しました。

処置:	文書を指定してください。


BRW-15522: コマンド: '<名前1>'は、'<名前2>'なしで指定されています。

原因:	必要なコマンドがありません。

処置:	コマンドを追加してください。


BRW-15523: コマンド: '<名前>'には一致しないカッコがあります。

原因:	コマンド行で入力したカッコが一致しません。

処置:	不一致のカッコを修正してください。


BRW-15530: 削除された行を編集することはできません。

原因:	削除のマークが付いた行を編集しようとしました。

処置:	最初に行の削除を解除してください。


BRW-15531: データベースから行が削除されました。

原因:	問合せを最後に実行した後、別のユーザーがこの行を削除しました。

処置:	サポート担当に連絡してください。これは発生してはならないことです。


BRW-15532: 他のユーザーが行を変更しました。

原因:	問合せを最後に実行した後、別のユーザーがこの行を更新しました。

処置:	再試行してください。


BRW-15533: 他のユーザーが行を現在ロックしています。

原因:	他の人がこの行を編集中です。

処置:	後で再試行してください。


BRW-15539:<##>行の挿入中にエラーが発生しました。

原因:	入力ファイルの1行以上の挿入に失敗しました。

処置:	入力ファイルを修正するか、無視します。


BRW-15540: この型のデータは操作できません。

原因:	編集不能な型のデータを持つセルを編集しようとしました。

処置:	不明です。


BRW-15541: 変更されたデータが多すぎます。コミットを実行してください。

原因:	1つの文書に、INSERT、UPDATEまたはDELETEの保留が多すぎます。

処置:	「コミット」または「戻し」を選択してください。


BRW-15545: QXFファイル読込み中にエラーが発生しました。解析処理は中止されました。

原因:	QXFファイル読込み中の構文エラー。

処置:	QXFファイルを修正します。


BRW-15546: 解析エラー: <##>行。

原因:	特定行で構文が不正です。

処置:	その行をデバッグしてください。


BRW-15547: リレーション・ブロック内に演算子が指定されていません。

原因:	QXFファイルのリレーション・ブロックで演算子が指定されていません。

処置:	ブロック内で演算子フィールドを指定してください。


BRW-15548: エラー: リレーション・ブロック: <名前>に引数がありません。

原因:	リレーション・ブロックの列フィールドに引数がありません。

処置:	そのフィールドに列名を指定してください。


BRW-15549: 条件ブロック内にCONDITION_TEXTがありません。

原因:	条件ブロックのCONDITION_TEXTフィールドに引数がありません。

処置:	CONDITION_TEXTフィールドを指定してください。


BRW-15550: INCLUSION_ORDER値(<名前1>)(式: <名前2>中)が無効です。

原因:	式のINCLUSION_ORDER値が不正です。

処置:	INCLUSION_ORDER値を修正してください。


BRW-15551: 式: <名前>は含まれていますが、INCLUSION_ORDERが指定されていません。

原因:	取り込まれる式ブロックのINCLUSION_ORDERが指定されていません。

処置:	INCLUSION_ORDERフィールドを指定してください。


BRW-15552:式: <名前>は含まれていませんが、INCLUSION_ORDERがNULLではありません。

原因:	式は含まれません（INCLUDED = FALSE）が、INCLUSION_ORDERがNULLではありません。

処置:	これらのフィールドの値を修正してください。


BRW-15553: エラー: 式: '<名前>'にテキストがありません。

原因:	テキスト文字列がQFX式ブロックに指定されていません。

処置:	テキスト文字列を指定してください。


BRW-15554: エラー: ソートされる式: '<名前>'のSORT_PRIORITYが指定されていません。

原因:	ソートされる式のSORT_PRIORITYが指定されていません。

処置:	SORT_PRIORITYを指定してください。


BRW-15555: フィールド: '<名前1>'(表: '<名前2>'中)のINCLUSION_ORDER値が間違っています。

原因:	フィールドのINCLUSION_ORDER値が不正です。

処置:	INCLUSION_ORDER値を修正してください。


BRW-15556: フィールド: '<名前1>'(表: '<名前2>'中)は含まれていますが、INCLUSION_ORDERがNULLです。

原因:	フィールドは含まれます（INCLUDED = FALSE）が、INCLUSION_ORDERが指定されていません。

処置:	これらのフィールドの値を修正してください。


BRW-15557: フィールド: '<名前1>'(表:'<名前2>')は除外されていますが、INCLUSION_ORDERは存在しています。

原因:	指定されたデータ表のフィールドは含まれませんが、INCLUSION_ORDERはNULLではありません。

処置:	これらのフィールドの値を修正してください。


BRW-15558: ソートされたフィールド: '<名前1>'(表: '<名前2>'中)のSORT_PRIORITYが指定されていません。

原因:	ソートされるフィールドのSORT_PRIORITYが指定されていません。

処置:	そのフィールドのSORT_PRIORITYを指定してください。


BRW-15559: エラー: 表: '<名前2>'のINCLUSION_ORDERの値('<名前1>')が間違っています。

原因:	取込み順序に負の値があります。

処置:	その値を修正してください。


BRW-15560: 表:'<名前>'は含まれていますが、INCLUSION_ORDERは指定されていません。

原因:	データ表は取り込まれます（INCLUDED = TRUE）が、INCLUSION_ORDERが指定されていません。

処置:	これらのフィールドの値を修正してください。


BRW-15561: 表:'<名前>'は除外されていますが、INCLUSION_ORDERは、NULLではありません。

原因:	データ表は取り込まれません（INCLUDED = FALSE）が、INCLUSION_ORDERはNULLではありません。

処置:	これらのフィールドの値を修正してください。


BRW-15562: エラー: メイン条件ブロックは2つ以上指定できません。

原因:	メイン（ルート）条件ブロックが複数存在します。

処置:	条件ブロックをいくつか排除するか、結合を使用してください。


BRW-15563: エラー: QXFファイル・バージョン1.0を使用してください。

原因:	VERSIONフィールドで指定されているバージョン番号が不正です。

処置:	バージョンを修正してください。


BRW-15564: 解析エラー: 行: <##>: フォント・スタイル:'<名前>'が無効です。

原因:	フォント・スタイルが無効です。

処置:	フォント・スタイルをチェックし、修正してください。


BRW-15565: 解析エラー: <##>行: フォント・スタイル引数が無効です。

原因:	無効なフォント・スタイル引数です。

処置:	フォント・スタイル文字列をチェックし、修正してください。


BRW-15566: 解析エラー: 行: <##>: 集計関数:'<名前>'が無効です。

原因:	集計関数名が無効です。

処置:	関数名を修正してください。


BRW-15567: 解析エラー: <##>行: サマリーの引数が無効です。

原因:	サマリーのフィールド引数が無効です。

処置:	フィールド引数を修正してください。


BRW-15568: 解析エラー: <##>行: フィールド引数が無効です。

原因:	フィールド引数が無効です。

処置:	フィールド引数を修正してください。


BRW-15569: 警告: エラーのため、QXFファイルは部分的にしかロードされていません。

原因:	QXFファイルをロード中のエラーです。

処置:	それらのエラーを修正してください。


BRW-15570: 解析エラー: 行: <##>: リレーション・ブロックの演算子: '<名前>'が無効です。

原因:	リレーション・ブロックの演算子が無効です。

処置:	演算子をチェックし、修正してください。


BRW-15571: 解析エラー: <##>行: フィールド引数の演算子が無効です。

原因:	派生項目式のオブジェクトIDが無効です。

処置:	ディクショナリのオブジェクトIDを修正してください。


BRW-15572: 派生項目式のオブジェクトIDが一貫していません。

原因:	リレーション・ブロックの演算子フィールド引数が無効です。

処置:	演算子文字列をチェックし、修正してください。


BRW-15580: アクセスできるビジネス・エリアのリストをロードできません。

原因:	エンド・ユーザー・レイヤーにビジネス・エリア表がありません。

処置:	エンド・ユーザー・レイヤーを再インストールしてください。システム管理者に問い合せてください。


BRW-15581: コピーされたデータで作成された表に列を追加できません。

原因:	コピーされたデータで作成された表に列を追加しようとしました。

処置:	コピーされた表をコミットしてから、再試行してください。


BRW-15582: 表の新規およびコピーは既存の表でだけ可能です。

原因:	新規/コピー/更新の表に対して新しい表を作成しようとしています。

処置:	まず、新規/コピー/更新の表をコミットしてください。


BRW-15583: 索引には1つ以上の列を指定する必要があります。

原因:	索引にある最後の列を削除しようとしました。

処置:	他の列を追加してから、削除してください。


BRW-15584: 列: <名前>はLONG型なので、コピーされません。

原因:	スナップショットの作成中に、LONG列をコピーすることはできません。

処置:	列はコピーできません。


BRW-15600: サポートされていない構文です。

原因:	サポートされていない構文を解析しようとしました。

処置:	代わりとなるOracle8構文を使用してください。


BRW-15601: 無効なOracle 8 SQLの構文です。

原因:	Oracle8言語構文を使用できません。

処置:	Oracle7 SQLを使用してください。


BRW-15602: Oracle 8 SQLのタイプ・コンストラクタはサポートされていません。

原因:	Oracle8 SQLのタイプ・コンストラクタがサポートされていません。

処置:	Oracle7に戻してください。


BRW-15603: Oracle 8 SQLのREFはサポートされていません。

原因:	Oracle8 SQLのREFがサポートされていません。

処置:	かわりに、Oracle7を使用してください。


BRW-15604: Oracle 8 SQLのCASTはサポートされていません。

原因:	Oracle8 SQLのCASTはサポートされていません。

処置:	かわりに、Oracle7を使用してください。


BRW-15605: Oracle 8 SQLのMULTISETはサポートされていません。

原因:	Oracle8 SQLのMULTISETはサポートされていません。

処置:	かわりに、Oracle7を使用してください。


BRW-15606: Oracle8 SQLのMETHODSはサポートされていません。

原因:	Oracle8 SQLのMETHODSはサポートされていません。

処置:	かわりに、Oracle7を使用してください。


BRW-15607: Oracle 8 SQLのTHE副問合せはサポートされていません。

原因:	Oracle8 SQLのTHE副問合せはサポートされていません。

処置:	かわりに、Oracle7を使用してください。


BRW-15608: Oracle 8 SQLの表のPARTITIONはサポートされていません。

原因:	Oracle8 SQLの表のPARTITIONはサポートされていません。

処置:	かわりに、Oracle7を使用してください。


BRW-15609: Oracle 8 SQLの副問合せのTABLEキーワードはサポートされていません。

原因:	副問合せ内のTABLEキーワードはサポートされていません。

処置:	かわりに、Oracle7を使用してください。


BRW-15610: 表の名前を表の別名として変更します。

原因:	表の別名のかわりに、表を使おうとしました。

処置:	別名を使用して表の名前を変更してください。


BRW-15641: ヘルプ・システムの初期化に失敗しました。ヘルプは使用できません。

原因:	ヘルプ・ドキュメントまたはヘルプ・リソース・ファイルの場所がわかりません。

処置:	継続できますが、ヘルプ・メニューは使用できません。オンラインまたはペーパー・ドキュメントを使用してください。


BRW-15643: リソース・ファイル(<名前>)が見つかりません、デフォルト・リソース・ファイルで再実行中です。

原因:	NLS_LANGは設定されていますが、ファイルが見つかりませんでした。

処置:	デフォルトの言語を使ってリソース・ファイルをオープンしてください。


BRW-15644: ヘルプ文書(<名前>)が保存できません、デフォルト・ヘルプ文書を再実行中です。

原因:	NLS_LANGは設定されていますが、ファイルが見つかりませんでした。

処置:	デフォルトの言語を使ってヘルプ・ドキュメントをオープンしてください。


BRW-15647: ヘルプ文書(<名前>)が見つかりません。

原因:	正しいディレクトリにヘルプ・ファイルを見つけることができませんでした。

処置:	Query Builderディクショナリ構造をチェックしてください。NLS_LANGが正しく設定されていることを確認してください。


BRW-15648: ヘルプ・システム作成エラーが発生しました。

原因:	ヘルプ・システムが起動できませんでした。

処置:	Query Builderではヘルプ・リソース・ファイルを見つけることができませんでした。 または、NLS_LANGが設定されていないか、メモリーが不十分です。


BRW-15649: <名前>に入力された値が小さすぎます。最小許容値は<##>です。

原因:	入力値が小さすぎました。

処置:	より大きい値でもう一度試してください。


BRW-15650: <名前>に入力された値は大きすぎます。最大許容値は<##>です。

原因:	入力値が大きすぎました。

処置:	より小さい値でもう一度試してください。


BRW-15651: <名前>に入力された値は範囲外です。<##>と<##>の間にする必要があります。

原因:	入力値が有効範囲外でした。

処置:	有効な値でもう一度試してください。


BRW-15652: 値は、<値>にリセットされました。

原因:	入力値は、有効範囲外だったため変更されました。

処置:	有効な値でもう一度試してください。 そうしないと、Query Builderは指定された値を使用します。


BRW-15653: 作業環境ファイル・エラー: 値: <値>が小さすぎます。最小許容値は<##>です。

原因:	入力値が小さすぎました。

処置:	より大きい値でもう一度試してください。


BRW-15654: 作業環境ファイル・エラー: 値: <値>が大きすぎます。最大許容値は<##>です。

原因:	入力値が大きすぎました。

処置:	より小さい値でもう一度試してください。


BRW-15655: 作業環境ファイル・エラー: 値: <値>が範囲外です。<##>と<##>の間にする必要があります。

原因:	入力値が有効範囲外でした。

処置:	有効な値でもう一度試してください。


BRW-15656: 作業環境ファイル・エラー: <値>の値が認識されていません。

原因:	作業環境ファイルに設定されている値は無効でした。

処置:	有効な値でもう一度試してください。


BRW-15657: OWNERLIST=NAMEの値には、少なくとも1つの名前があることが必要です。

原因:	OWNERLIST=NAMEの値はNULLでした。

処置:	有効な名前でもう一度試してください。


BRW-15900: 時間間隔の情報が見つかりません。

原因:	このデータベースでは時間がサポートされていないかまたはデータベース・エラーです。

処置:	このエラーが予測外の場合は、後でもう一度試してください。


BRW-15901: オブジェクト: <名前1>が関係しているデータソース: <名前2>は、もう存在していません。

原因:	オブジェクトのベース・データ・ソースが削除されています。

処置:	オブジェクトをリフレッシュ/削除してください。


BRW-15902: オブジェクト: <名前>に参照されていた表は存在していません。

原因:	オブジェクトのベース・データ・ソースが削除されています。

処置:	オブジェクトをリフレッシュ/削除してください。


BRW-15903: 対応する表: <名前>は、ビジネス・エリアにはありません。結合情報にアクセスできません。

原因:	リレーション: 対抗データ表/オブジェクトがどのグループにもありません。

処置:	グループにそのオブジェクトへのアクセス権を付与してください。


BRW-15904: <##>バイト以上のリレーション名を指定することはできません。

原因:	リレーション名が制限よりも長すぎます。

処置:	より短い名前を使用してください。


BRW-15905: <##>バイト以上の列見出しを指定することはできません。

原因:	項目の見出しが制限よりも長すぎます。

処置:	より短い見出しを使用してください。


BRW-15906: <##>バイト以上の列書式を指定することはできません。

原因:	項目の書式が制限よりも長すぎます。

処置:	より短い書式を使用してください。


BRW-15907: 列表示に<##>ディジット以上の数値を指定することはできません。

原因:	項目の表示幅の精度が制限よりも長すぎます。

処置:	より短い表示幅を使用してください。


BRW-15908: <##>バイト以上の時間間隔名を指定することはできません。

原因:	時間間隔名が長すぎます。

処置:	より短い時間間隔名を使ってください。


BRW-15909: 間隔列と時間間隔の順次列は同じです。

原因:	時間間隔および時間間隔の順次列が、同一列に設定されています。

処置:	時間間隔および順次列が異なることを確認してください。


BRW-15910: 時間間隔: <名前>をロードできません。

原因:	時間間隔をロード中にスキーマ内部エラーが発生しました。

処置:	詳細については、後に続くエラー・メッセージを参照してください。


BRW-15911: 時間間隔: <名前>はすでに存在しています。

原因:	時間間隔名は、一意にする必要があります。

処置:	別の名前で時間間隔を作成してください。


BRW-15912: 表示幅の値が間違っています。

原因:	表示幅の値が不正です。

処置:	正しい値を入力してください。


BRW-15913: <名前>キー・テキストを指定してください。

原因:	外部キーまたは主キーのテキストが空です。

処置:	主キーまたは外部キーのテキストを入力してください。


BRW-15914: リレーション名を指定してください。

原因:	リレーション名が、NULLです。

処置:	リレーション名を入力してください。


BRW-15924: ビジネス･エリア名を指定してください。

原因:	ビジネス・エリア名が空またはスペースです。

処置:	新しい名前を入力してください。


BRW-15925: 表: <名前1>は、<名前2>としてすでにインポートされています。

原因:	表は、与えられた名前で1度のみインポートできます。

処置:	異なる名前で表をインポートしてください。


BRW-15926: ビジネス･エリア: <名前>はすでに存在します。

原因:	ビジネス・エリア名は一意にする必要があります。

処置:	別の名前でビジネス・エリアを作成してください。


BRW-15927: ビジネス･エリア: <名前1>には、すでに<名前2>という名前の表があります。

原因:	表名は、ビジネス・エリア内で一意にする必要があります。

処置:	表を改名/再インポートして、ビジネス・エリアに追加してください。


BRW-15928: ビジネス・エリア名が長すぎます(最大<##>バイト)。

原因:	ビジネス・エリア名が長すぎます。

処置:	名前を短くして、もう1度試してください。


BRW-15929: ビジネス・エリアの記述が長すぎます(最大<##>バイト)。

原因:	ビジネス・エリアの記述が長すぎます。

処置:	記述を短くして、もう1度試してください。


BRW-15930: 表: <名前>をコミットしている間にエラーが発生しました。

原因:	表をコミットしている間にエラーが発生しました。

処置:	再試行してください。


BRW-15931: ビジネス･エリア: <名前>をコミットしている間にエラーが発生しました。

原因:	ビジネス・エリアをコミットしている間にエラーが発生しました。

処置:	再試行してください。


BRW-15932: 時間間隔: <名前>をコミットしている間にエラーが発生しました。

原因:	時間間隔をコミットしている間にエラーが発生しました。

処置:	再試行してください。


BRW-15933: リレーション: <名前>をコミットしている間にエラーが発生しました。

原因:	リレーションをコミットしている間にエラーが発生しました。

処置:	再試行してください。


BRW-15937: 表:<名前>のSQLを生成中にエラーが発生しました。

原因:	表のSQLを生成中にエラーが発生しました。

処置:	再試行してください。


BRW-15938: ビジネス･エリア: <名前>のSQLを生成中にエラーが発生しました。

原因:	ビジネス・エリアのSQLを生成している間にエラーが発生しました。

処置:	再試行してください。


BRW-15939: 時間間隔: <名前>のSQLを生成中にエラーが発生しました。

原因:	時間間隔のSQLを生成中にエラーが発生しました。

処置:	再試行してください。


BRW-15940: リレーション: <名前>のSQLを生成中にエラーが発生しました。

原因:	リレーションのSQLを生成中にエラーが発生しました。

処置:	再試行してください。


BRW-15950: Query Builderに表がありません--データベースのオープン/保存ができません。

原因:	データベースにQuery Builderのシステム問合せ表が1つもありません。

処置:	システム問合せ表を作成してください（Query Builderインストール・スクリプトを実行する）。


BRW-15951: 製品のユーザー・プロファイル情報をロードできません。

原因:	ユーザー・プロファイル表をロードできません。

処置:	システム管理者に作成を依頼してください。


BRW-15952: ユーザ権限表をロードできません。

原因:	USER_USERS表がありません（非OracleまたはOracle V7データベース）。

処置:	何も使用できません。


BRW-15953: 表権限表がロードされていません。

原因:	権限表を見つけることができません。

処置:	Oracle以外のデータベースか、Oracle V7データベースです。


BRW-15954: Oracle Query Builder 2.5の表が存在しないか、適切にインストールされていません。

原因:	QUERY BUILDER_DOCS_SQL表がありません。

処置:	Query Builder 2.5の表を再インストールしてください。


BRW-15955: 問合せで0行戻りました。

原因:	問合せが行を返しませんでした。

処置:	問合せを修正し、データベースに存在するデータをリクエストするようにしてください。


BRW-16000: 文書は標準ディクショナリではなく、エンド・ユーザ･レイヤーのディクショナリで保存されます。続行しますか?

原因:	エンド・ユーザー・レイヤーを使って保存した文書をネーティブ・モードでオープンしようとしました。

処置:	DICTIONARY=ENDUSERでQuery Builderを実行するか、続行してください（エンド・ユーザー・オブジェクトはアクセス不能になります）。


BRW-16001: 文書はエンド・ユーザ･レイヤーのディクショナリではなく、標準ディクショナリで保存されます。続行しますか?

原因:	ユーザーは、標準ディクショナリを使って保存した文書をENDUSERモードでオープンしようとしました。

処置:	DICTIONARY=NATIVEでQuery Builderを実行するか、続行してください（いくつかのデータベース・オブジェクトがアクセス不能になる可能性があります）。


BRW-16250: 文書はすでに存在しています。上書きしますか?

原因:	ユーザーは、既存の文書を「名前を指定して保存」しようとしました。

処置:	ユーザーは上書きするか、取り消すことができます。


BRW-16251: 表が変更されています。続行しますか?

原因:	ビューは削除され、再作成されました。文書と一貫していない可能性があります。

処置:	継続するか、保存を中止してください。


BRW-16500: ローカル・ソートにはメモリーが使用できません。再実行しますか?

原因:	ローカル・ソートにまだすべての行がフェッチされていません。

処置:	問合せを再実行してください。


BRW-16503: ローカル・ソートにはデータが使用できません。再実行しますか?

原因:	ローカル・ソートにまだすべての行がフェッチされていません。

処置:	問合せを再実行してください。


BRW-16504: ローカル・ブレークにはデータが使用できません。再実行しますか?

原因:	ローカル・ブレークにまだすべての行がフェッチされていません。

処置:	問合せを再実行してください。


BRW-16525: 問合せには直積演算が必要である可能性があります。続行しますか?

原因:	問合せでは関連付けられていない表の結果を結合します。

処置:	メッセージを無視するか、実行する前に表を関連付けてください。詳細はヘルプまたはドキュメントを参照してください。


BRW-16531: パラメータ: <名前>を再定義しますか？

原因:	式または条件に以前削除したパラメータを入力しました。

処置:	意図的に入力した場合は、「OK」を押してください。


BRW-16532: パラメータ: <名前>は存在していません。定義しますか?

原因:	式または条件に新しいパラメータを入力しました。

処置:	意図的に入力した場合は、「OK」を押してください。


BRW-16549: 「変更の破棄」は、これらの表のすべての変更を元に戻します。変更を破棄しますか?

原因:	データ表を戻す前に確認が必要です。

処置:	選択されているデータ表の変更をすべて戻す場合は、「OK」をクリックし、操作を取り消す場合は「取消」をクリックします。


BRW-16550: 表:<名前>には、他から参照されている主キー/一意キーがあります。削除しますか?

原因:	表には制約が含まれています。

処置:	データ表を削除する場合は「OK」をクリックし、操作を取り消す場合は「取消」をクリックします。


BRW-16551: 列には、主キー/一意キー、または索引があります。削除しますか?

原因:	列が制約または索引に使用されています。

処置:	列を削除する場合は「OK」をクリックし、操作を取り消す場合は「取消」をクリックします。


BRW-16552: 全ての制約を無効にしますか？

原因:	すべての制約を使用不可にすることを確認するメッセージです。

処置:	確定または取り消すことができます。


BRW-16553: 全ての制約を有効にしますか？

原因:	すべての制約を変更可能にすることを確認するメッセージです。

処置:	確定または取り消すことができます。


BRW-16575: コミットされていない変更は失われます。コミットしますか?

原因:	変更をコミットせずに、データ・エディタを終了しようとしました。

処置:	「コミット」をクリックします。コミットしない場合、変更は失われます。


BRW-16576: 定義済み列、サマリー値、ブレーク値が現在のものでない可能性があります。再実行しますか?

原因:	ブレーク列、サマリー列または定義済み列を表示中に値が編集されました。

処置:	問合せを実行して、値を更新します。


BRW-16623: この操作には使用できるデータがありません。

原因:	印刷に使用できる行または列の数がゼロの場合に警告されるメッセージです。

処置:	再実行または列の取り込みを行ってください。


BRW-16624: 問合せ定義が変更されました。データは最新のものでない可能性があります。続行しますか?

原因:	問合せドキュメントが、最後の実行以降変更されています。

処置:	問合せを再実行、エクスポートの継続または中止のいずれかを行ってください。


BRW-16625: プリンタはすべての必要フォントをサポートしているわけではありません。かわりのフォントを使用しますか?

原因:	選択されているプリンタについて、そのフォント、スタイルまたは太さは存在しません。

処置:	フォントを置き換えて続行するか、取り消すことができます。


BRW-16626: プレビューを表示するのにメモリーが足りません。

原因:	印刷プレビューのためのビットマップを作成できません。

処置:	処置は不要です。


BRW-16627: この操作には使用できるデータがありません。問合せを実行しますか?

原因:	エクスポート・データが空のワークシートでコールされる場合に警告されるメッセージです。

処置:	問合せの実行または取り消しをしてください。


BRW-16628: プリンタ装置を取得することができないため、印刷できません。続行しますか?

原因:	uiprc()を伴うツールキット・プリンタ・サーフィスの作成エラーです。

処置:	印刷せずに続行するか、取り消すことができます。


BRW-16629: 終了する前にコンテナを更新しますか?

原因:	OLEドキュメントをクローズ/終了するときに、変更を保存することを指示するメッセージです。

処置:	変更を保存、中止または操作を取り消すことができます。


BRW-16650: プリンタはすべての必要フォントをサポートしているわけではありません。かわりのフォントを使用しますか?

原因:	選択されているプリンタについて、そのフォント、スタイルまたは太さは存在しません。

処置:	フォントを置き換えて続行するか、取り消すことができます。


BRW-16651: プリンタが選択されていません。デフォルトのプリンタを使用しますか?

原因:	使用するプリンタを明示的に指定していません。

処置:	システムのデフォルト・プリンタで続行するか、取り消すことができます。


BRW-16652: この文書のマージンを大きく設定しすぎています。再設定してください。
BRW-16652: この文書の余白が広すぎます再設定してください。

原因:	マージンを大きく設定しすぎて、コンテンツに余裕が残されていません。

処置:	マージンを再設定する必要があります。


BRW-16653: プリンタが選択されていません。デフォルトのプリンタを使用しますか?

原因:	使用するプリンタを明示的に指定していません。

処置:	システムのデフォルト・プリンタで続行するか、取り消すことができます。


BRW-16654: 印刷されませんでした。

原因:	コピー数を0に設定したか、開始/終了ページを範囲外に設定しています。

処置:	ページ範囲を再設定してください。


BRW-16660: 問合せ定義が変更されました。データは最新のものでない可能性があります。再実行しますか?

原因:	問合せドキュメントが、最後のDDE更新以降変わっています。

処置:	DDE更新の前に問合せを再実行するか、実行せずに更新してください。


「データ表選択」ダイアログ・ボックス

  関連項目

説明  「データ表選択」ダイアログ・ボックスでは、接続したデータベースのデータ・ソース・オブジェクトを問合せにインクルードできます。

このダイアログ・ボックスの内容:

表示	表、ビュー、問合せ、スナップショット、シノニムのすべて、あるいはどれかをリスト・ボックスに表示するかどうかを指定します。
ドロップダウン・ボックス	オブジェクトを表示するデータ・ソースを指定します。別のアカウントやデータベースから表を選択することもできます。
データ表選択	問合せにインクルードできるデータ・ソース・オブジェクトをリストします。ヒント
情報	選択したオブジェクトに情報を表示します。種類、名前、所有者、作成日、コメントがあります。種類、名前、所有者、作成日、コメントがあります。
インクルード	選択した項目をQuery Builderの作業領域にインクルードします。
クローズ	データ・ソース・オブジェクトをインクルードせずにこのダイアログ・ボックスをクローズします。


現行のデータベースにある他のアカウントへのアクセス

  関連項目

現行のデータベースにある他のアカウントの表にアクセスするには:

1	現行のデータベース名をクリックします。「インクルード」ボタンが「オープン」ボタンに切り替わり、リスト・ボックスには現行のデータベース内のアカウントのリストが表示されます。

2	オープンするアカウントの名前をクリックします。

3	「オープン」ボタンをクリックするか、アカウント名をダブルクリックします。Query Builderにはそのアカウントにある表のリストが表示され、「オープン」ボタンは再び「インクルード」ボタンに切り替わって、通常の方法で表をインクルードできるようになります。


他のアカウントをオープンする

  関連項目

必要な表が現行のデータベース内にリストされていない場合、他のアカウントやデータベースを検索してそのアカウントから表を選択することができます。

他のアカウントおよびデータベースにナビゲートするには:

1	表のリストの上のボックスをクリックします。選択肢は2つあります。現行のデータベースの名前と「データベース」です。現行のデータベースの名前と「データベース」です。

2	現行のデータベースにある他のアカウントの表をコールするには、ここをクリックします。

リストされたデータベースと接続できない場合は、ネットワーク上の異常やリモート・パスワードの変更によってリンクが無効になっていると思われます。このような場合には、データベース管理者に連絡してください。


表の2回以上のインクルード

  関連項目

1つの問合せに同じ表を2回以上インクルードする場合、複製表に、実表の名前の次にアンダースコアと英数字が続く形式で命名されたシステム生成の別名が自動的に割り当てられます。


「リレーション表選択」ダイアログ・ボックス

説明  「リレーション表選択」ダイアログ・ボックスでは「問合せ」ウィンドウで選択した表に関係のある表をインクルードすることができます。

このダイアログ・ボックスの内容:

表示	このオプションは使用できません。
ドロップダウン・ボックス	すべてのリレーション表を指定するかどうかを指定します。
データ表選択	使用できるリレーション表をリストします。ヒント
情報	選択したオブジェクトに情報を表示します。種類、名前、所有者、作成日、コメントがあります。種類、名前、所有者、作成日、コメントがあります。
インクルード	選択した表をインクルードします。
クローズ	リレーション表をインクルードせずにこのダイアログ・ボックスをクローズします。


「表改名」ダイアログ・ボックス

  関連項目

説明  「表改名」ダイアログ・ボックスでは、現在アクティブな表の名前を変更できます。

このダイアログ・ボックスの内容:

デフォルト表名	表の現行名を指定します。
リスト・ボックス	改名のためにオープンした表をリストします。
新規名	新しい表名を指定します。
定義	ダイアログ・ボックスをオープンしたまま表名を更新します。


改名した表の識別

格納された問合せの中では、特定の表の名前がユーザー定義の名前か元の名前かは、すぐには見分けられません。

特定の表が改名されているかどうかを識別するには:

1	アイコン・バーの [image] をクリックします。

2	「処理可能な表」のリストで目的の表をクリックします。

表の名前が変更されている場合は、別名が「新しい名前」フィールドに表示され、別の名前（元の表名）が「デフォルト表名」フィールドに表示されます。

また、SQLを使用している場合でも、アイコン・バーの [image] をクリックすれば、改名された表を識別することができます。これによって、「SQL表示」ダイアログ・ボックスが表示され、表の別名を表す標準SQL構文内のSELECT文の中に、名前の変更が表示されます。


「表リレーション設定」ダイアログ・ボックス

  関連項目

説明  「表リレーション設定」ダイアログ・ボックスでは、2つの表の間に単純リレーション、自己リレーション、複合リレーション、不等価リレーションを設定します。

このダイアログ・ボックスの内容:

リレーション	起点(A->で)列と宛先(B->で)列の名前を指定します。
演算子	列間のリレーションの種類を指定します。
問合せでリレーションを使用	問合せにリレーションを使用するかどうかを指定します。チェックされている種類がデフォルトです。
「Bに一致しないA」ラジオ・ボタン	表Aにあり、表Bにないデータ以外に、両方の表ですべて共通のデータを検索することを指定します。
「Aに一致しないB」ラジオ・ボタン	表Bにあり、表Aにないデータ以外に、両方の表ですべて共通のデータを検索することを指定します。
「不一致を抑制」ラジオ・ボタン	デフォルト。両方に共通のデータを検索することを指定します。


リレーションについて

  関連項目

リレーショナル・データベースは、多くのリレーション表からなります。各表は縦方向に配置された列（フィールドともいいます)からなります。列には名前があり、一意の種類のデータを保存します。

リレーション、つまり結合は、1つの表の列と別の表の列との関係を定義します。必要なリレーションは、ほとんどデータベースに定義されています。リレーションにより、データの冗長性も少なくなります。異なる表の列にリレーションが設定してあれば、それらの表は問合せでまとめて処理できます。注意

リレーション列の名前がいつも同じであるとは限りません。同じデータ型はいつでも関係付けられます。 リレーションに意味があれば、ときには異なるデータ型でも関係付けることができます。たとえば、数値も文字として解釈できるため、通常、NUMBERデータ型の列はCHARACTER型の列と関係付けることができます。実際、ほとんどの列（長いテキストの列を除く）は、CHARACTER型の列と関係付けることができます。リレーションにはユーザー定義（一時）リレーションと、基本データ・ディクショナリに設定されたリレーションがあります。

リレーションにはユーザー定義（一時）リレーションと、基本データ・ディクショナリに設定されたリレーションがあります。データ・ディクショナリのリレーションは、リレーション表（主キー/外部キー関係を持った表）をインクルードすると自動的に表示されます。これらのリレーションはいつでも有効なので、特別な操作をしなくても利用できます。その作成や変更にはSchema Builderを使用します。

ユーザー定義リレーションは、それを作った問合せの中でのみ有効です。ユーザー定義リレーションを作っても基本表には対応する恒久的なリレーションは設定されません。両者の主な違いはユーザー定義リレーションの場合、ユーザーがリレーション線を引く必要がある点です。 データベースに保存されたリレーションの場合は、Query Builderによって自動的にリレーション線が引かれます。

注意（Report Builderのみ）:  Report Builderのデータ・リンクは、Query Builderのリレーションとは異なります。データ・リンクは2つ以上の問合せ間で作成されますが、Query Builderのリレーション（結合）は、1つの問合せ内で作成されます。詳細は、Report Builderのオンライン・ヘルプを参照してください。


リレーションのアクティブ化と非アクティブ化

  関連項目

マウスを使用して作成した関係は、問合せの中での必要に応じて、自動的にアクティブにされたり解除されたりします。アクティブな関係は、黒の太線で表示され、非アクティブな関係は、グレーの線で表示されます。

マウスを使用して手動で関係をアクティブにするには:

  非アクティブな関係線をダブルクリックします。

関係を解除するには:

  アクティブな関係線をダブルクリックします｡


「列定義」ダイアログ・ボックス

説明  「列定義」ダイアログ・ボックスでは、他列の値に基づいて、問合せ内に新しい列を作成できます。定義済みの列は、「データ・ソース」パネルと「結果」ウィンドウの両方に表示されます。

このダイアログ・ボックスの内容:

定義済み列	作成する列の名前を指定します。
リスト・ボックス	既存の定義済み列をリストします。
定義内容	選択した列の式を指定します。
定義	定義を列に適用します。
削除	選択した列を削除します。
列ペースト	「列ペースト」ダイアログ・ボックスを表示します。
関数ペースト	「関数ペースト」ダイアログ・ボックスを表示します。
注意: 定義済み列は問合せの一部にすぎず、データベースに保存された表定義を変更することはありません。


「ソート」ダイアログ・ボックス

説明  「ソート」ダイアログ・ボックスでは、表の列をもとに、問合せにあるデータをソートできます。

このダイアログ・ボックスの内容:

処理可能な列	ソートできる表列を「結果」ウィンドウに表示します。
ソート済み列	現在ソートされている表列を「結果」ウィンドウに表示します。
コピー	「処理可能な列」リストで選択した列を「ソート済み列」リストにコピーします。
削除	「ソート済み列」リストで選択した表列を削除します。
ソート順	選択した列を「昇順」や「降順」でソートします。デフォルトは「昇順」です。


Query Builderヘルプ

  関連項目

新規問合せの作成

問合せに条件を追加

単純関係の作成

列の定義

問合せデータのソート


Query Builderについて

  関連項目

Query Builderは、アナリスト、マネージャ、その他ビジネス・プロフェッショナルのために作成された簡単に使用できるデータ・アクセス・ツールです。社内データベースの情報に、論理的で直感的にアクセスでき、解析や報告に活用できます。

Query Builderはコンピュータのプログラミングやデータベースの基礎知識がないプロフェッショナルを対象に作成されています。また、Query Builderの強力な問合せ機能と構造化問合せ言語(SQL)文のサポートは、経験豊かなデータベース・ユーザーやプログラマにもさまざまな用途を提供します。

Query Builderの視覚的な「問合せ」ウィンドウで、社内データベースにあるデータに対する要求を指定できます。このデータに対する要求を問合せといいます。

Query Builderは、ユーザーがSQL SELECT文で作成するどのような問合せの定義にも対応できます。Query Builder作業領域に表示される列にもとづいて最適なSELECT FROM [table.column]句がQuery Builderにより、自動的に生成されます。


「列順序」ダイアログ・ボックス

説明  「列順序」ダイアログ・ボックスでは、Query Builder作業領域の問合せ結果を調整できます。

このダイアログ・ボックスの内容:

処理可能な列	Query Builder作業領域に表示できる表列をリストします。ヒント
表示中の列	Query Builder作業領域に現在表示されている表列をリストします。
コピー	「処理可能な列」リストから選択した列を「表示中の列」リストにコピーします。
削除	「表示中の列」リストから選択した列を削除します。
フォーマット	「フォーマット」ダイアログ・ボックスを表示します。
合計	「合計」ダイアログ・ボックスを表示します。
実行	問合せを実行します。


「列ペースト」ダイアログ・ボックス

  関連項目

説明  「列ペースト」ダイアログ・ボックスでは、既存の列を選択した表から問合せにペーストできます。

このダイアログ・ボックスの内容:

リスト・ボックス	ペーストできる列をリストします。ヒント


「関数ペースト」ダイアログ・ボックス

説明  「関数ペースト」ダイアログ・ボックスでは、関数を条件や問合せにペーストできます。

このダイアログ・ボックスの内容:

カテゴリ表示	リスト・ボックスに表示される関数の種類を指定します。数値、文字、日付、変換、グループその他があります。
リスト・ボックス	選択したカテゴリで利用できる関数をリストします。
引数ペースト	引数をインクルードするかどうかを指定します（使用する関数に情報を提供する関数のカッコ内の式）。


「SQL表示」ダイアログ・ボックス

  関連項目

「SQL表示」ダイアログ・ボックスでは、ユーザーの問合せ用のSQL文を表示するのみです。「SQL表示」ダイアログ・ボックスではSQL文の編集やコピーはできません。


表内の各行を一意に識別する1つ以上の列。主キーは太字で表示されます。


他の表の主キー値を参照する列。外部キーはイタリック体で表示されます。


問合せが表、ビュー、問合せ、シノニムおよびスナップショットを含むデータを取り出すソース。


1つの論理表を構成する1つまたは複数のデータベース表の列からなるデータ・ソース。


ファンクションまたは操作、および操作対象のデータベース列で構成される文字列(たとえば、SALARY+COMMISSION)。


命名規則に従う場合は、各問合せの名前は文字から始めるものとし、文字および数字で30字以内に収めます。命名規則を使用しないでデータベースの問合せを命名すると、Query Builderにより名前が（二重引用符で囲まれた）「リテラル」値に変換されます。


「条件」パネルについて

「条件」パネルは、「条件」フィールドを含む「問合せ」ウィンドウの1つのセクションであり、ここで式と条件を入力します。Query Builderの条件では、必要に応じてWHERE句やHAVING句が自動的に生成されます。

表名と列名は、条件内でフィルタリングされる列を示します。列名が一意の場合は、表名を省略できます。ヒント

注意: 「条件」フィールドをアクティブにするとカーソルにプラス記号(+)が表示され、クリックする項目が条件に追加されることを示します。これを非アクティブにするには、アイコン・バーの [image] をクリックします。


「問合せ」ウィンドウについて

問合せをオープンすると、Query Builderは次の2つのパネルに分割された「問合せ」ウィンドウにその問合せを表示します。

•	「条件」パネルには「条件」フィールドがあります。このフィールドを使って問合せの詳細を指定します。

•	「データ・ソース」パネルでは、問合せで使用される表（ビューやスナップショットなど）を表示します。

2つのパネルは、好みに応じて垂直または水平に分割できます。

それぞれの表は、表の名前と表内の列の名前を含むボックス内に表示されます。また、たくさんのアイコンがあり、現行のデータベース・オブジェクトを特定するときに使用すると便利です。説明のコメントが添付されているかどうか、データ・ソースのタイプ、列のデータ型、問合せ内の表について索引が定義されているかどうかなど、アイコンによってさまざまな情報が示されます。

リレーション線は、列間のリレーションを示します。リレーションは表間に設定され、ある表の列が別の表の列にどのように関連しているかを特定します。

列名の左にあるチェック・マークは、列が問合せにインクルードされていることを示します。これは、問合せを実行すると、Query Builderがその列名に対応するデータを検索することを意味します。チェック・マークがない場合は、列のデータがインクルードされていないことを示します。


「データ・ソース」パネルについて

  関連項目

「データ・ソース」パネルは、「問合せ」ウィンドウ内のセクションであり、表やリレーションなどの項目が表示されます。


アイコン・バーについて

  関連項目

アイコン・バーはQuery Builderウィンドウの一番上に表示されます。各アイコンをクリックすると説明が表示されます。


「保存」アイコン

指定したファイルに問合せを保存します。


「カット」アイコン

選択したテキストをカットし、オペレーティング・システムのクリップボードに移動します。


「コピー」アイコン

選択したテキストをオペレーティング・システムのクリップボードにコピーします。 元のテキストはそのまま残ります。


「ペースト」アイコン

現行のクリップボードのアイテムをアクティブな場所にペーストします。クリップボードに何もない保存されていない場合、ペーストは行われません。カットやコピーしたテキストは何でもペーストできます。


「消去」アイコン

選択したアイテム（テキストやテーブルなど）を消去します。「カット」コマンドと違って、「消去」で削除したアイテムはオペレーティング・システムのクリップボードには保存されません。


「すべて選択」アイコン

アクティブ・ウィンドウのすべてのアイテムを選択します。たとえば、「条件」パネルがアクティブな場合、パネル内のすべての条件が選択されます。


「データ表選択」アイコン

「データ表選択」ダイアログ・ボックスを表示します。


「リレーション表選択」アイコン

「リレーション表選択」ダイアログ・ボックスを表示します。このアイコンは選択した表と結合されたデータベースに、リレーション表がある場合にのみ使用できます。


「表改名」アイコン

「表改名」ダイアログ・ボックスを表示します。このアイコンは、Query Builder作業領域に少なくとも表が1つないと使用できません。


「情報」アイコン

「情報」ダイアログ・ボックスと、選択したデータベースのオブジェクトに関する情報を表示します。このアイコンはデータ・ソース・オブジェクトがアクティブでないと使用できません。


「表リレーション設定」アイコン

「表リレーション設定」ダイアログ・ボックスを表示します。このアイコンは、関係付ける「データ・ソース」パネルに、複数の表がないと使用できません。


「SQL表示」アイコン

「SQL表示」ダイアログ・ボックスと、アクティブな問合せのSQLを表示します。


「列順序」アイコン

「表示」ダイアログ・ボックスを表示します。


「列定義」アイコン

「列定義」ダイアログ・ボックスを表示します。


「ソート」アイコン

「ソート」ダイアログ・ボックスを表示します。


「And」アイコン

AND演算子を条件に挿入します。このアイコンは、「条件」フィールドがアクティブでないと使用できません。「条件」フィールドに直接ANDと入力することもできます。


「Or」アイコン

OR演算子を条件に挿入します。このアイコンは、「条件」フィールドがアクティブでないと使用できません。「条件」フィールドに直接ORと入力することもできます。


「Not」アイコン

NOT演算子を条件に挿入します。このアイコンは、「条件」フィールドがアクティブでないと使用できません。「条件」フィールドに直接NOTと入力することもできます。


「条件グループ解除」アイコン

AND、OR、NOTなどの論理演算子で結合された条件グループを解除します。このアイコンは、「条件」パネルで論理演算子を選択していないと使用できません。


「アクセプト」アイコン

アクティブな条件の妥当性を検査し、確定します。このアイコンは、「条件」フィールドがアクティブでないと使用できません。「条件」フィールドがアクティブな場合は、[Enter]キーや[Return]キーを押しても、妥当性の検査と確定の処理になります。


「取消」アイコン

現行の条件を取り消します。このアイコンは、「条件」フィールドがアクティブでないと使用できません。


「列ペースト」アイコン

「列ペースト」ダイアログ・ボックスを表示します。このアイコンは、「条件」フィールドがアクティブでないと使用できません。


「関数ペースト」アイコン

「関数ペースト」ダイアログ・ボックスを表示します。このアイコンは、「条件」フィールドがアクティブでないと使用できません。


データ型について

  関連項目

Query Builderの主なデータ型は、次のとおりです。

CHAR またはVARCHAR2	CHARは、固定長の文字データに使用します。 最大サイズで255バイト、デフォルト・サイズは1バイトです。VARCHAR2は、最大サイズ2000バイトの可変長の文字列に使用します。VARCHAR2の場合、サイズを指定してください。
NUMBER	データベース列に数値（整数、小数、その他の型の数値）があることを表します。NUMBER型の数字では計算ができますが、CHAR型の数字では計算できません。
DATE	データベース列に日付値があることを表します。日付の有効範囲は、西暦の紀元前9999年の1月1日から、西暦9999年の12月31日までです。デフォルト・フォーマットはDD-MON-YYです。'01-JAN-92'のように表します。
NUMBER(p,s)	p(小数の精度)の範囲は1から38です。s(スケール)の範囲は-84から127です。保存される桁数は小数の精度で決まります。スケールは小数点の右側の桁数を表します。スケールが負のとき実際のデータは、小数点の左側の指定桁数でまるめられます。たとえば、(10, -2)と指定すると結果は100の位で四捨五入されます。
その他、Query Builderでは、以下のOracleデータ型を一定の範囲でサポートしています。

LONG	LONG列には、2ギガバイト(または231-1)までの可変長英数字データを保存できます。Query Builderの問合せにLONGをインクルードすると、最初の2000文字が表示されます。
RAW	RAWバイナリ・データです。最大サイズは255バイトです。値は16進文字で入力します。値は16進値で表示されます。RAW型ではサイズを指定してください。
LONG RAW	LONG RAWでは、最大2ギガバイトのRAWバイナリ・データを表示します（「結果」ウィンドウには16進で表示される）。LONG RAW型の範囲はRAW型と同じです。
注意:Query Builderでは、条件と式が比較時に異なるデータ型を参照するデータ型の変換もできます。詳細は『Oracle8 Server SQLリファレンス』を参照してください。


「データ型」アイコン

  関連項目

以下に示すデータ型は、データ・ソース・オブジェクトのすべての列で使用できますが、これらはQuery Builder作業領域のオブジェクトの右側列にあるアイコンに表示されます。

データ型	アイコン	説明
文字		CHARACTER型は、固定長の文字データに使用します。最大サイズで255バイト、デフォルト・サイズは1バイトです。 注意: 数字はCHARACTER型でも表せますが、計算には数値データ型を使用してください。
Varchar2		VARCHAR2データ型は、最大サイズ2000バイトの可変長文字列に使用します。VARCHAR2型ではサイズを指定してください。
Number		NUMBER型は、整数や浮動小数点データに使用します。整数データの場合は、精度長（桁数）を指定します。浮動小数点データ型は、小数に使用します。データ型を列に指定するときは、精度とスケールの両方を指定してください。 精度（数値の合計桁数）の範囲は、1から38です。 スケール（小数点の右側の桁数）の範囲は、-84から127です。 スケールが負のとき、実際のデータは小数点の左側の指定桁数でまるめられます。  たとえば、(10, 2)は、小数点以下が2桁の10桁の数値を表します。(10, -2)と指定すると、10桁の整数が100の位で四捨五入されます。
Date		DATE型はどのような種類の日付にも使用できます。西暦の紀元前4712年の1月1日から、西暦4712年の12月31日までです。デフォルト・フォーマットはDD-MON-YY。 '01-JAN-92'のように表します。
Long		LONG型は、最大2ギガバイトの可変長の英数字データのロング・テキスト・フィールドに使用します。
Raw		RAW型はRAWバイナリ・データに使用します。最大サイズは255バイトです。値は16進の文字列で指定します。値は16進で表示されます。RAWデータにはサイズを指定してください。
Long Raw		LONG RAW型は、最大2ギガバイトのRAWバイナリ・データ（指定と表示は16進で行われる）に使用します。LONG RAW型ではサイズの指定は不要です。
MLSLABEL		MLSLABEL型は、機密性の高いオペレーティング・システムで使用するラベルのバイナリ・フォーマットの保存に使用します。Trusted Oracleでは、ラベルを媒体として情報にアクセスします。標準Oracle Serverを使用する場合は、このデータ型で列の定義もできます。Trusted Oracle、このデータ型およびラベルの詳細は、『Trusted Oracle8 Server管理者ガイド』を参照してください。


データ・ソース・オブジェクトの表記

  関連項目

以下に示したのは、リレーションでリンクされた2つのデータ・ソース・オブジェクトの例です。

アイコン、インジケータまたはこれらのオブジェクトの一部をクリックすると説明が表示されます。


オブジェクト型インジケータ

データ・ソース・オブジェクトの左上角のアイコンが、その種類を表します。

  表

  ビュー

  問合せ

  スナップショット

  シノニム


オブジェクト・タイトル

データ・ソース・オブジェクトの名前です。オブジェクト・タイトルをクリックすると名前を変更できます。


コメント・インジケータ

このアイコンは、このオブジェクト（あるいは列）に、コメントが添付されていることを表します。このアイコンをダブルクリックすると「情報」ダイアログ・ボックスがオープンします。 このダイアログ・ボックスにコメントが表示されます。


列名

このオブジェクトにある1つの列の名前です。列名をダブルクリックすると、問合せにその列がインクルードされます。


データ型インジケータ

これらのアイコンは、それぞれの列のデータ型を表します。 アイコンをクリックしたままにすると、ポップアップ・メニューが表示され、別のデータ型を選択できます。


リレーション線

2つの列の間に引かれる灰色の線です。 これは線で結ばれた列の間にリレーションが設定されていることを表します。線は外部キーから主キーに引かれます。


自己リレーション・インジケータ

このアイコンは、この列（外部キー）と同じ表にある別の列（主キー）との間に自己リレーションが設定されていることを表します。


主キー

太字で表示される列名。 列がオブジェクトの主キーであることを表します。


外部キー

イタリック体で表示される列名。 このキーが、別の列の主キーに関係付けられた外部キーであることを表します。外部キーを定義するには、2つの列の間にリレーションを設定する必要があります。


Query Builder関数について

例 	関連項目

関数は、データ項目を操作し結果を返す演算子に似ています。関数が演算子と異なる点は、引数を伴うということです。関数は任意数の引数を対象に（引数がなくても）操作できます。関数名を列に関連付けると、Query Builderでは列の値に対して定義された操作が行われます。

Query Builderにおいて、問合せで使用できる関数は次のとおりです。

•	数値関数

•	文字関数

•	数値を返す文字関数

•	変換関数

•	日付関数

•	グループ関数

•	その他の関数

追加情報: その他の関数の詳細は、『Oracle8 Server SQLリファレンス』を参照してください。


関数および引数

例 	関連項目

関数は特定の列でデータを操作するために使用します。各関数は1つ以上の引数を取ることができます。関数にはカッコが付いており、カッコ内の式が引数です。引数は、関数が使用する情報を提供します。

たとえば、ROUNDという関数があります。この関数は数値を指定された桁に四捨五入します。式ROUND (CREDIT_LIMIT, -2)を入力すると、Query Builderは、CREDIT_LIMITの各値を100の位に四捨五入します。ROUND(CREDIT_LIMIT, 1)を入力すると、CREDIT_LIMITの各値を小数1桁に四捨五入します。

引数で使用できる値は次のとおりです。

引数値	説明
char,set,search,	一重引用符で囲まれた文字定数。
replace	マーク、または式。文字データを返します。
d,e	一重引用符で囲まれた日付定数、または日付データを返す式。
m,n	数値定数、または数値データを返す式。
x	引数のデータ型は、関数の機能性によって変わります。
expr	任意のデータ型の式。
fmt	データの表示方法を変更したりSchema Builderのフィールドにデータを入力するために使用される書式、またはデフォルト以外の書式にする条件。


数値関数

関連項目

数値関数は、数値データを受け取り、数値データを返します。列および条件を定義する際に使用します。

関数(引数)	説明
ABS(n)	nの絶対値。
CEIL(n)	n以上の整数で最小の値を返します。
COS(n)	n（ラジアンで表される角度）のコサインを返します。
COSH(n)	nの双曲線余弦（ハイパーボリック・コサイン）を返します。
EXP(n)	指数表記。e (2.71828183...)のn乗を返します。
FLOOR(n)	n以下の整数で最大の値を返します。
LN(n)	n>0のとき、nの自然対数を返します。
LOG(m,n)	mを底として、nの対数を返します。底mは、0または1以外の正の整数、nは正の整数を返します。
MOD(m,n)	mをnで割った余りを返します。
POWER(m,n)	mのn乗を返します。nが整数でなければ、切り捨てられます。
ROUND(n[,m])	nを小数点以下m桁に四捨五入します。mが省略されると小数点以下桁数は0となります。mが負数であれば、小数点より左の桁で四捨五入されます。
SIGN(n)	n<0であれば-1。n=0であれば0、n>0であれば1を返します。
SIN(n)	n（ラジアンで表される角度）のサインを返します。
SINH(n)	nの双曲線正弦（ハイパーボリック・サイン）を返します。
SQRT(n)	nの平方根を返します。n<0ならばNULLを返します。
TAN(n)	n（ラジアンで表される角度）のタンジェントを返します。
TANH(n)	nの双曲線正接（ハイパーボリック・タンジェント）を返します。
TRUNC(n[,m])	nを小数点以下m桁に切り捨てます。mを省略すると小数点以下0桁となります。mが負ならば小数点より左側の桁で切り捨てられ、その桁は0となります。


文字関数

関連項目

文字関数は、文字データを受け取り、文字データを返します。列および条件を定義する際に使用します。

関数(引数)	説明
CHR(n)	データベース文字セットでバイナリnに対応する文字を返します。
CONCAT(char1, char2)	char1とchar2を連結した文字列を返します。この関数は、連結演算子（||）と同等の意味を持ちます。
INITCAP(char)	charで指定される各語の先頭文字を大文字にして返します。各語間はブランクまたは英数以外の文字で区切られます。
LOWER(char)	charの全文字を小文字にして返します。
LPAD(char1, n[,char2])	char1の左側に文字列char2を必要数追加して、n文字にします。char2の指定がなければ、ブランクが使用されます。
LTRIM(char[, set])	charの先頭から、setに含まれない文字が最初に出現する以前の文字を削除して返します。setのデフォルトは' '（1個のブランク）です。
NLS_INITCAP (char[, nlsparams])	charで指定される各語の先頭文字を大文字にして返します。各語間はブランクまたは英数以外の文字で区切られます。nlsparamsで指定するパラメータには、NLS_SORT=sort形式を使用できます。sortはセッションでの使用言語によるソート順序またはBINARYです。BINARYが指定されるとcharを返します。ソート順序の詳細は、『Oracle8 Server概要』を参照してください。
NLS_LOWER(char [,nlsparams])	charの全文字を小文字にして返します。 引数nlspa-ramsについては、NLS_INITCAPを参照してください。
NLS_UPPER(char [,nlsparams])	charの全文字を大文字にして返します。引数nlspa-ramsについては、NLS_INITCAPを参照してください。
REPLACE(char, search[, replace])	char内の文字定数searchをすべてreplaceに置き換えて返します。replaceを省略すると、searchはすべて削除されます。
RPAD(char1,n[, char2])	char1の右側に文字列char2を必要数追加して、n文字にします。char2の指定がなければ、ブランクが使用されます。
RTRIM(char[, set])	charから、setに含まれない文字が最後に出現した後の文字を末尾まで削除して返します。setのデフォルトは' '（1個のブランク）です。
SOUNDEX(char)	char内の単語の音を表す値を返します。
SUBSTR(char, m[,n])	charから、m文字目からn文字分を返します。nを省略すると、m文字目からcharの末尾までを返します。
SUBSTRB(char, m[,n])	引数mおよびnを文字数でなくバイト単位で指定する以外はSUBSTRと同じです。1バイトのデータベース文字セットの場合は、SUBSTRBとSUBSTRは同等の意味を持ちます。
UPPER(char)	charの全文字を大文字にして返します。


数値を返す文字関数

関連項目

文字関数で数値データを返すことができます。列および条件を定義する際に使用します。

省略形	説明
ASCII(char)	charの最初のキャラクタのASCII値を返します。
INSTR(char1, char2[,n[,m]])	char1内で、n文字目から検索を開始してm番目にchar2が出現する位置を返します。mを省略すると、1が指定されたとみなされます。nを省略すると、1が指定されたとみなされます。n>1の場合でも、char1の先頭文字を基準にした出現位置が返されます。
INSTRB(char1, char2[,n[,m]])	nおよび戻り値に文字数でなくバイト単位を使用する以外はINSTRと同じです。1バイトのデータベース文字セットの場合は、INSTRBとINSTRは同等の意味を持ちます。
LENGTH(char)	charの長さを文字数で返します。
LENGTHB(char)	charの長さを文字数でなくバイト単位で示す以外はLENGTHと同じです。charがNULLの場合、NULLを返します。1バイト・データベース・文字セットの場合は、LENGTHBとLENGTHは同等の意味を持ちます。
NLSSORT(char[, nlsparams])	charをソートするために使用する文字列を返します。nlsparamsで指定するパラメータには、NLS_SORT=sort形式を使用できます。sortはセッションでの使用言語によるソート順序またはBINARYです。BINARYが指定されるとcharを返します。ソート順序の詳細は、『Oracle8 Server概要』を参照してください。


変換関数

関連項目

変換関数は、列および条件を定義する際に、あるデータ型のデータを別のデータ型に変換するために使用します。

省略形	説明
TO_CHAR(d[,fmt])	dを、char値fmtで指定する書式のchar型に変換。fmtを省略すると、dはQuery Builderのデフォルトの日付書式YY-MM-DDのchar型に変換されます。
TO_CHAR(n[,fmt])	nを、char値fmtで指定する書式のchar型に変換。fmtを省略すると、nの桁数を格納するために必要な桁数分のchar型に変換されます。
TO_DATE(char[,fmt])	charで指定される日付を日付型に変換。fmtは、charの書式を指定するchar型です。fmtを省略すると、charはQuery Builderのデフォルトの日付書式YY-MM-DDになります。
TO_DATE(n,[fmt])	数値を日付に変換。fmtはTO_DATEで使用される場合には、日付型を生成する書式（例:JまたはMM）を指定する必要があります。
TO_LABEL(char[,fmt])	CHARデータ型またはVARCHAR2データ型で、fmtで示される書式のラベルを含むcharの文字値をMLSLABELデータ型の値に変換。fmtが指定されなければ、charはデフォルトのラベル書式を指定する必要があります。
TO_MULTI_BYTE(char)	char内の1バイト文字をすべて、対応するマルチバイト文字に変換した形でcharを返します。対応するマルチバイト文字のない1バイト文字は、出力文字中ですべて1バイト文字になります（この関数は、使用するデータベースのキャラクタ・セットに両方のタイプが含まれる場合のみ、利用価値があります）。
TO_NUMBER(char)	数値を含む文字データであるcharをnumber型に変換して返します。
TO_SINGLE_BYTE(char)	char内のマルチバイト文字をすべて、対応する1バイト文字に変換した形でcharを返します。対応する1バイト文字のないマルチバイト文字は、出力文字中ですべてマルチバイト文字になります（この関数は、使用するデータベースのキャラクタ・セットに両方のタイプが含まれる場合のみ、利用価値があります）。


日付関数

関連項目

日付関数は、数値データを返すMONTHS_BETWEEN以外はすべて日付データを返します。列および条件を定義する際に使用します。

省略形	説明
ADD_MONTHS(d,n)	日付dにnか月を加算します。
LAST_DAY(d)	日付dを含む月の末日。
MONTHS_BETWEEN (d,e)	日付dとeの間の月数。dがeより後であれば結果は正数、前であれば負数になります。
NEW_TIME(d,a,b)	タイムゾーンaにおける日時dをタイムゾーンbで示します。aおよびbは文字列で表され、その意味は次のとおりです。
AST,ADT:	大西洋標準時、大西洋夏時間
BST,BDT:	ベーリング標準時、ベーリング夏時間
CST,CDT:	中央標準時、中央夏時間
EST,EDT:	東部標準時、東部夏時間
GMT:	グリニッジ標準時
HST,HDT:	アラスカ・ハワイ標準時、アラスカ・ハワイ夏時間
MST,MDT:	山地標準時、山地夏時間
NST:	ニューファンドランド標準時
PST,PDT:	太平洋標準時、太平洋夏時間
YST,YDT:	ユーコン標準時、ユーコン夏時間
NEXT_DAY (d,char)	日付d以降に最初に来る、charで指定される曜日の日付。
ROUND(d[,fmt])	丸め単位fmtで指定される書式で丸めた値dを返します。fmtを省略すると、最も近い日を返します。
SYSDATE	現在の日付と時刻を返します。引数は不要です。
TRUNC(d[,fmt])	時刻を切り捨て単位fmtに切り捨てた値dを返します。fmtが指定されなければ、時刻が削除されます。
追加情報: ROUNDおよびTRUNC日付関数で使用する書式モデルの表については、『Oracle8 Server SQLリファレンス』を参照してください。


グループ関数

関連項目

グループ関数は、行ごとの1つ1つの結果ではなく、行のグループに基づくデータを取り出します。グループ関数は、平均、カウント、合計および標準偏差のような演算を行います。

またグループ関数を使用して新しい列を定義することもでき、他の列を表示しなければ、結果全体は1つのグループとして扱われます。他の列を表示すると、結果はより小さなグループに分割されます。グループ関数は条件で使用できる（ただし比較演算子を伴う場合のみ）ため、結果全体は1つのグループとして扱われます。たとえば、条件SALARY > AVG(SALARY)は、現在の行のSALARYの値がすべての行のSALARYの平均よりも大きい場合に真です。

グループ関数ではDISTINCTまたはALLオプションが使用できます。DISTINCTではグループ関数は表現の異なる関数のみを考慮します。たとえば、1、1、1、3の平均は1.5ですが、DISTINCTでの平均は2になります。ALLを使用すると、グループ関数は複製も含めてすべての値を考慮します。

以下のグループ関数ではすべて、COUNT(*)を除くNULL値をスキップします。exprがリストされていれば、引数のデータ型は、文字、数値、日付のいずれでもかまいません。

関数(引数)	説明
AVG([DISTINCT|ALL]n)	nの平均値、NULL値は無視します。
COUNT([DISTINCT|ALL]expr)	exprがNULLではない行の数。
COUNT(*)	表の行数。重複行およびNULL値を持つ行も含みます。
GLB([DISTINCT|ALL]label)	labelの最大下限を返します。
LUB([DISTINCT|ALL]label)	labelの最小上限を返します。
追加情報: GLBとLUBはMLSLABELデータ型の値を返します。GLBとLUB関数の詳細は、『Trusted Oracle8 Server管理者ガイド』を参照してください。

関数(引数)	説明
MAX([DISTINCT|ALL]expr)	exprの最大値。
MIN([DISTINCT|ALL]expr)	exprの最小値。
STDDEV([DISTINCT|ALL]n)	nの標準偏差、NULL値は無視。n-1（標本）計算を基にします。
SUM([DISTINCT|ALL]n)	nの値の合計。
VARIANCE([DISTINCT|ALL]n)	nの分散、NULL値は無視します。


その他の関数

関連項目

Query Builderは、以下の関数も使用できます。

関数(引数)	説明
USER	現在のOracleユーザーの名前を返します。引数は不要です。
DECODE(expr,search1, replace1[,search2, replace2,]...[default])	exprがいずれかのsearchと同等であれば、直後のreplaceを返します。同等でなければ、defaultを返します。defaultが指定されず、一致する値がなければ、NULLを返します。exprはいずれのデータ型でもかまいませんが、searchは、このデータ型と同じである必要があります。戻り値は、最初の戻り値と同じデータ型になります。
GREATEST(expr1,expr2,...)	リストの中で最大の値を返します。値expr1より後のすべてのexprは、比較が行われる前に、expr1と同じデータ型に変換されます。
GREATEST_LB(label[,label]...)	ラベルのリストの下限の最大値を返します。各labelは、MLSLABELまたはRAW MLSLABELのいずれかのデータ型であるか、デフォルトのラベル形式で引用符に囲まれたリテラルを指定する必要があります。戻り値のデータ型はRAW MLSLABELとなります。
LEAST(expr1,expr2,...)	リストで最小の値を返します。値expr1より後のすべてのexprは、比較が行われる前に、expr1と同じデータ型に変換されます。
LEAST_UB(label[,label]...)	ラベルのリストの上限の最小値を返します。各labelは、各labelは、MLSLABELまたはRAW MLSLABELのいずれかのデータ型であるか、デフォルトのラベル形式で引用符に囲まれたリテラルを指定する必要があります。戻り値のデータ型はRAW MLSLABELとなります。
NVL(x,expr)	XがNULLであればexprを返します。xがNULLでなければxを返します。xおよびexprはいずれのデータ型でもかまいません。戻り値は、xと同じデータ型になります。
追加情報: GREATEST_LBとLEAST_UBGLB関数の詳細は、『Trusted Oracle8 Server管理者ガイド』を参照してください。


 表をQuery Builderの作業領域に移動するには、目的の表を選択して「インクルード」をクリックする方法の他に、表をダブルクリックする方法があります。連続した範囲にある複数の表を指定するには、[Shift]キーを押しながら、その範囲にある最初と最後の表をクリックします。


リレーションはこのダイアログ・ボックスで設定できますが、できるだけマウスによる操作で作成してください。この方法で作成すると、Query Builderによってリレーション行が自動的にアクティブ化および非アクティブ化されます。


列に強調表示のチェック・マークが付いている場合には、その列がSELECT文の中にあり、問合せ結果の中に表示されることを示しています。また、列にグレー表示のチェック・マークが付いている場合は、列がソートまたはグループ検索条件として使用されることを示しています。


一般に、Query Builderでは、Oracleデータベースの暗黙的な変換機能を使用して解釈できる列を関連付けることができます。暗黙的な変換についての技術的な説明については、『Oracle8 Server SQLリファレンス』を参照してください。


「定義内容」フィールドの数式は、一般に関数または演算および操作の行われるデータベース列で構成されます。列名が複数の表にある場合、表の名前も必ず参照し、列名とはピリオドで区切ってください。列名が一意の場合、列名のみでかまいません。


表の名前を変更しても、データベースに登録してある名前は変更されません。新しい名前はアクティブな問合せにのみ有効であり、その問合せを保存するとその名前も保存されます。


「表リレーション設定」ダイアログ・ボックスを表示するには、アイコン・バーの [image] をクリックします。


「データ表選択」ダイアログ・ボックスを表示するには、アイコン・バーの [image] をクリックします。


「表を改名」ダイアログ・ボックスを表示するには、アイコン・バーの [image] をクリックします。


表から列オブジェクトを選択すると、Query Builderでは問合せで表の別名を自動的に使用します。同じように、「条件」フィールドに列オブジェクトを入れてその条件を受け入れると、Query Builderでは適切な表の別名を自動的に条件に挿入します。


列を選択（または選択解除）するには、次のいずれかの方法を使用します。

•	列の横のチェックボックスをチェックします（またはチェックを外します）。

または

列名をダブルクリックします。


Query Builderの例

  関連項目 	  すべての例

条件の例

定義済み（および計算済み）列の例

関数の例（30文字を超える名前の取出し）


 内部結合関係について

  関連項目

内部結合関係は、表を表自体に関係付けます。内部結合関係は、同じ表に含まれる2つの列の間に親子関係を確立するために、限定的かつ、固有に使用されます。たとえば、内部結合関係を使用して子会社を親会社に関係付けたり、社員をその上司に関係付けたりすることができます。

内部結合関係は、表の各列が相互に対応していなければ、有効ではありません。たとえば、サンプル・データベースのEmployee表では、Manager IDがそのマネージャのEmployee IDと同じになっています。このため、内部結合関係アイコンがManager ID列に表示されています。


内部結合関係の作成

  関連項目

内部結合関係を作成するには:

1	Query Builderの「リレーション設定」ダイアログ・ボックスに、選択した表とのリレーションが定義されている表のリストが表示されます。

2	表名をクリックします。

3	「インクルード」をクリックします。

4	「OK」をクリックします。

5	上記の手順を同じ表名に繰り返します。

6	関係付けられた表のコピーには、自動的に別名が割り当てられます。元の表名に適合するように、表名を変更します。

注意: データ・ディクショナリ内で、すでに内部結合関係が識別されていれば、表内で関係付けられた2つの列と別名はリレーション線で結合されています。データ・ディクショナリ内で内部結合関係が識別されていない場合は、一時的なリレーション線を引いて、表内の対応する2つの列と別名を結合し、内部結合関係を作成できます。


 単純関係の作成

  関連項目

マウスを使用して関係を作成するには:

1	問合せウィンドウで、関係付ける表をオープンします。

2	表が表示された状態で、関係付ける列を選択します（外部キー）。

3	マウス・ボタンを押しながら、2番目の表の関係付ける列（主キー）にカーソルをドラッグし、関係線を引きます。

4	ターゲット列が強調表示された後、マウス・ボタンを離して関係線をアンカーします。デフォルトでは、関係は非アクティブになっています（線は灰色で表示されます）。

「リレーション設定」ダイアログ・ボックスを使用して関係を作成するには:

1	「リレーション設定」ダイアログ・ボックスで、元の列（A->）とターゲット列（->B）の名前を入力します。注意 2つの列の間に関係線が引かれます。

2	「クローズ」をクリックします。

ショートカットを使用して関係を作成するには:

1	「リレーション設定」ダイアログ・ボックスで、フィールドAの内側をクリックします。

2	問合せウィンドウで、列を選択します。フィールドAに、表名と列名が自動的に配置されます。

3	この手順をフィールドBで繰り返します。


複合関係の作成

  関連項目

複合関係は、1つの表の複数の列を他の表の複数の列と結合します。たとえば、品目表にある受注番号のIDと品目IDの2つの列を、品目リスト表にある同名の2つの列と結合します。

複合関係を作成するには:

1	Query Builder作業領域で、アイコン・バーの [image] をクリックします。

2	結合する2つの表を組み込みます。

3	関係付ける列を選択します（外部キー）。

4	マウス・ボタンを押しながら、2番目の表の関係付ける列（主キー）にカーソルをドラッグします。カーソルの動きに合わせて、関係線が移動することに注意してください。

5	ターゲット列が強調表示された後、マウス・ボタンを離して関係線をアンカーします。デフォルトでは、関係は非アクティブになっています（線は灰色で表示されます）。

複合関係は、問合せの中で該当する数のみ使用することができます。また、複合関係には、他の関係で使用されている列も組み込むことができます。


完全な表名と列名を入力する必要があります（表名と列名はピリオドで区切ります）。A->は表の外部キーを表し、->Bは表の主キーを表します。追加の主キーと外部キーはカンマで区切ります。


不一致関係の作成

  関連項目

不一致関係（外部関係）を作成するには:

1	問合せウィンドウで、表を結合する関係線をクリックします。関係線がない場合は、2つの表の間に単純関係を作成します。

2	「リレーション設定」ダイアログ・ボックスで、単純関係に含まれるすべてのレコードを取り出すか、両方の表に対応する値を持つ行のみを取り出すかのどちらかの表示オプションを選択します。

注意: 0（ゼロ）の値を返す行は、不一致の行とは異なります。「不一致を抑制」はNULL値を返す行のみに作用し、0を返す行には作用しません。この機能は、販売品目のない注文、注文したことがない顧客、顧客を持たない営業部員など、表に値が入力されていないデータを表示するときに使用します。


不一致の行の削除

  関連項目

不一致関係を削除するには:

1	Query Builder作業領域で、ターゲット表を結合する関係線をクリックします。

2	「リレーション設定」ダイアログ・ボックスで、「不一致を抑制」ラジオ・ボタンを選択します。

3	「OK」をクリックします。


不等価関係の使用

  関連項目

「リレーション設定」ダイアログ・ボックスで、不等価関係を作成するには:

  演算子を選択します。

不等価関係を設定すると、Query Builderでは、関係線上にアイコン（不等号）が表示されます。


関係の削除

  関連項目

関係を削除するには:

1	問合せウィンドウで、2つの表列を結合する関係線をクリックします。

2	両方の列名と関係線がハイライト表示されたら、[Del]キーを押します。


不一致（NULL）の行について

  関連項目

Query Builderでは、問合せで関係を使用するときに、不一致の行を取り出すかどうかを選択できます。関係によって結合された表間で、1つの表の値に対してもう1つの表に対応する値がない場合、不一致の行が生じます。SQLのユーザーには、"外部結合"と呼ばれる問合せ条件としてよく知られています。通常、不一致の行はNULL値を戻します。

注意: 0（ゼロ）の値を返す行は、不一致の行とは異なります。「リレーション設定」ダイアログ・ボックスの「不一致を抑制」オプションはNULL値を返す行のみに作用し、0を返す行には作用しません。この機能は、品目のない注文など、表に値が入力されていないデータを表示するときに使用します。不一致関係を使用するときは、不一致のレコードを表示するための片方のみを選択できます。


新規問合せの作成

  関連項目

新規問合せを作成するには:

1	Query Builder作業領域で、アイコン・バーの [image] をクリックします。

2	データを取り出す表をダブルクリックします。

3	「クローズ」をクリックしてダイアログ・ボックスをクローズし、表を表示します。

4	各列を選択します。選択した各列の横のチェックボックスに、チェック・マークが表示されます。すべての列を組み込むには、表タイトル・バーのチェックボックスをチェックします。ヒント

5	1つ以上の条件を入力して、問合せを詳細化します。

6	「OK」をクリックしてQuery Builderをクローズします。


使用可能な表の表示

  関連項目

問合せの中で使用できる表を表示するには:

1	Query Builder作業領域で、アイコン・バーの [image] をクリックします。

2	「表示」チェックボックスを使用して、タイプ別に表をソートします。


表の消去

Query Builder作業領域から表を消去するには:

1	問合せウィンドウで表をクリックします。

2	アイコン・バーの [image] をクリックします。Query Builder作業領域から表が削除されます。をクリックすると、再び表を問合せに入れることができます。

表を削除または消去しても、データベースから表が削除されるわけではなく、単に問合せから表が削除されるのみです。


表の改名

  関連項目

表を改名するには:注意

1	アイコン・バーの [image] をクリックします。

2	「表改名」ダイアログ・ボックスで、改名する表を「処理可能な表」リストから選択します。

3	「新規名」フィールドの内側をクリックします。

4	不要な情報を削除します。

5	表の新規名を入力します。新規名の長さは30文字までです。

6	「定義」をクリックします。

7	「OK」をクリックします。

Query Builder作業領域で表を改名しても、その基礎となる表では対応する名前は変更されません。新規名は、アクティブな問合せのみ有効となります。


表および列に関する情報とコメントの表示

データベースに格納されている情報およびコメントを表示するには:

  Query Builder作業領域内で、表に関する情報を参照するには、表ヘッダーの右にあるアイコンをダブルクリックします。列に関する情報を参照するには、各列の最初のアイコンをダブルクリックします。


問合せからの列の削除

  関連項目

1つの問合せから1つの列を削除するには:

  Query Builder作業領域で、列を選択します。表内のチェック・マークが消えます。


問合せの行のカウント

問合せの実行前に問合せが返す行数をカウントするには:

  Query Builder作業領域で、アイコン・バーの [image] をクリックします。警告ボックスが表示され、取り出される行数が表示されます。


問合せに条件を追加

  例	  関連項目

問合せに条件を追加するには:

1	条件パネルのブランクの条件フィールドをクリックして、アクティブにします。プラス記号がカーソル矢印の隣に表示されます。マウス・ポインタを使用して、自動的にポイント、クリックして、フィールドの選択を行うことができます。

2	Query Builder作業領域で、条件を適用する列を選択します。使用可能なすべての列のリストを表示するには、アイコン・バーの [image] をクリックします。ヒント

3	アイコン・バーから、該当する「演算子」をクリックします。条件に関数を追加するには、アイコン・バーの [image] をクリックします。

4	演算子の後の条件式の右側に該当する値を入力します。その他の条件を追加するには、[Shift]キーを押しながら[Enter]キーを押し、カーソルを新規行に移動します。

5	式が完成したら、条件パネルの枠内で条件フィールド以外の場所をクリックして条件フィールドを非アクティブにするか、アイコン・バーの [image] をクリックします。条件パネルを消してやり直すには、アイコン・バーの [image] をクリックします。


条件について

  例 	  関連項目

条件は、必要な情報と不要な情報を選り分けるために、問合せの中に配置するテキスト句です。条件を使用すると表の列を取り出すことができるので、問合せに要する時間が短縮され、問合せを絞り込むことができます。ヒント

たとえば、問合せに従業員表を組み込み、従業員名、給与およびジョブ・タイトルの列を選択します。問合せに条件を組み込まない場合には、データベースに対して実際に「従業員表の従業員名、給与およびジョブの列からすべての従業員のデータを選択する」よう求めることになります。そこで、元の要求に次のような条件を追加できます。

•	月給が1000ドルを超え、2000ドル未満。

•	名字が「Smith」。

•	ジョブがマネージャ以外。

条件の中で、上記の例で示したワードをすべて入力するかわりに、「演算子」を使用すると、条件はほとんど1つの式のように表すことができます。たとえば、3000ドルを超える給与を得ている従業員を指定するには、次のように入力します。

SALARY > 3000

また、関数を使用して、複雑な条件を作成することもできます。


条件の例

  関連項目 	  すべての例

カリフォルニア州に関するデータのみを表示する問合せを作成すると仮定します。

1	条件フィールドをクリックしてアクティブにします。

2	Query Builder作業領域で、該当する表の「State」列を選択します。条件フィールドに「STATE」の表示が現れます。

3	等号（=）を入力します。

4	条件フィールド内の等号の右隣に'CA'を入力します。

条件は、STATE='CA'と表されているはずです。


演算子について

  関連項目

演算子とは、なんらかの演算を実行するときに使用する文字または予約語のことです。Query Builderでは、主に次の3種類の演算子が使用されます。

•	比較

•	算術

•	論理

注意: これらの演算子を基に、否定条件を作成することもできます。


比較演算子

  関連項目

比較演算子は、2つの値を比較するときに使用します。条件パネルで列名と値の間に演算子を挿入すると、Query Builderはその列のすべての項目を値と比較して、条件文が当てはまる行のみを返します。

たとえば、CREDIT_LIMIT列の値が6,000ドル未満の行のみを返すには、<（より小さい）演算子を次のように使用します。

CREDIT_LIMIT < 6000

Query Builderの比較演算子

演算子	使用方法
=	等しい
<>	等しくない
<	より小さい
<=	以下
>	より大きい
>=	以上
BETWEEN...AND...	2つの値の間
IN (LIST)	次のリストのいずれかのメンバーに等しい
IS NULL	NULL値。1つの列に値のない行は、NULL値を含む行と呼ばれます。


算術演算子

  関連項目

算術演算子は、数値および日付の列で計算を行うときに使用します。計算を処理する場合、Query Builderは最初に乗算または除算を評価し、次に加算または減算を評価します。

•	たとえば、式1+2x3では、最初に2と3を乗算し、その結果に1を足すので、最終的な結果は7になります。

このような優先順位のルールを上書きするには、式の一部をカッコの中に入れます。Query Builderは、カッコの中の式を最初に評価します。

•	たとえば、計算(1+2)x3では、(1+2)が最初に評価され、その結果に3を乗算するので、最終的な結果は9になります。

Query Builderの算術演算子

演算子	使用方法
+	加算
-	減算
*	乗算
/	除算


論理演算子

  関連項目

論理演算子（ブール演算子とも呼ばれます）には、AND、ORおよびNOTがあります。

•	ANDは、すべての条件に適合するデータのみを取り出すときに使用します。

•	ORは、指定した条件のうち少なくとも1つに適合するすべてのデータを取り出すときに使用します。

•	NOTは、演算子または条件を否定するときに使用します。

アイコン・バーには、論理演算子用のアイコンがあります。演算子のアイコンは、条件パネルがアクティブになっているとき、または「列定義」ダイアログ・ボックスがオープンしているときに使用できます。アイコン・バーの演算子をクリックすると、条件のテキストまたは定義済み列に演算子を挿入できます。


定義済み（および計算済み）列について

  例 	  関連項目

Query Builderがデータベースから取り出すデータを計算し、計算済みのデータを新規列（定義済みフィールドとも呼ばれます）として結果ウィンドウに表示することができます。これらの列は、問合せの他の列と同じように名前を付けたり、定義したり、表示したりできます。

Query Builderの問合せで定義済み列を使用すると、"もし～ならば（what if）"のシナリオ、予測、見積りおよび平方偏差や合計に対する割合などの分析を行うことができます。

注意: 集計関数を含む定義済み列（フィールド）を表示すると、Query Builderは対応するGROUP BY句を、集計関数を含まない他の表示される列に自動的に生成します。熟練したユーザーであれば、表示されない列でグループ化するためのGROUP BY列を手動で指定することもできます。

通常、列は「表に格納されたデータの列」と同義ですが、他の列の値から導出または算出された、1つの問合せ内のデータの新規列を表すこともあります。これらの算出された列は、導出済みフィールドまたは定義済みフィールドと呼ばれることがあります。たとえば、従業員表に、給与とコミッションという報酬を記述する2つの列を組み込む場合があります。これらの列の値を、給与とコミッションの合計を示す純支出（Net Pay）という新規列に組み合せる定義済み列を作成することができます。

定義済み列は、必要に応じて1つまたは複数のデータベース列の任意の組合せを基に作成できます。

定義済み列は問合せの中に存在し、データベースには存在しません。定義済み列を列として結果ウィンドウに表示することも、（他の定義済み列の作成に使用するときのように）非表示のままにしておくこともできます。

注意: 定義済み列は問合せの一部にすぎず、データベースに保存された表定義を変更することはありません。


定義済み列の削除

  関連項目

問合せから定義済み列を削除するには:

1	Query Builder作業領域で、アイコン・バーの [image] をクリックします。

2	削除する列名をクリックします。

3	「削除」をクリックします。


定義済み（および計算済み）列の例

  関連項目 	  すべての例

たとえば、10%の給与増加を見込んで、来年度の純支出（NET_PAY_NEXT）の予算を見積もるとします。「式」フィールドに次のように入力します。

(SALARY*1.1) + COMMISSION

また、給与とコミッションがそれぞれ10%増加した場合の純支出を検討したいときには、次のように入力します。

(SALARY+COMMISSION) * 1.1

NET_PAYは、SALARY+COMMISSIONなので、これは次の式と同じです。

NET_PAY * 1.1

現行の純支出と来年度の見込み予算の差額を表示する定義済み列を作成することもできます。この列をVARIANCEと名付け、次のように定義します。

NET_PAY_NEXT - NET_PAY

新規列を定義する場合、式に記述する基本列が、基礎となるデータベース内に存在しなくてもかまいません。ただし、最終的には、これらの列は基礎となる表内の列から導出されることになります。たとえば、VARIANCEは次の式と同じです。

((SALARY+COMMISSION) * 1.1) - (SALARY+COMMISSION)


ソート列の削除

  関連項目

ソート列を削除するには:

1	Query Builder作業領域で、「ソート」アイコンをクリックします。

2	「ソート済み列」リストで、削除する列名をダブルクリックします。


問合せデータのソート

  関連項目

問合せで取り出されたデータをソートするには:

1	Query Builder作業領域で、アイコン・バーの [image] をクリックします。

2	「使用可能列」リストで、ソートの基準にしたい列をダブルクリックします。ソート列は、問合せの中に組み込む必要はありません。

列のデフォルト（昇順）のソート順を変更するには:

1	「ソート済み列」リストで、強調表示する列をクリックします。

2	「降順」ラジオ・ボタンをクリックします。

3	「OK」をクリックします。


列の定義

  関連項目

表に新規列を定義するには:

1	列を定義する表をオープンします。

2	アイコン・バーの [image] をクリックします。

3	「定義済み列」ボックスの内側をクリックします。

4	新規列の名前を入力します。

5	「定義内容」ボックスの内側をクリックします。

6	列を定義する式を入力します。

7	「OK」をクリックします。


関数のペースト

  例 	  関連項目

条件に関数をペーストするには:

1	条件フィールドをアクティブにして、関数を挿入したい位置にカーソルを移動します。

2	アイコン・バーの [image] をクリックします。

3	「カテゴリ表示」チェックボックスを使用して、表示する関数のタイプをフィルタします。

4	リスト・ボックスから関数を選択します。

5	デフォルトの引数を組み込む場合は、「引数ペースト」チェックボックスをクリックします。

6	「OK」をクリックします。

7	条件フィールドで、使用する引数をデフォルトの引数の上から入力します。


関数の例（30文字を超える名前の取出し）

  関連項目 	  すべての例

メール・ラベルには長すぎる30文字以上の名前の全顧客名をリストしたいと希望しているとします。これらの名前をリストするには、LENGTH関数を使用して条件を作成します。LENGTHは、1つの文字列の文字数をカウントします。

この例では、LENGTH関数内の引数は、顧客表のNAME列です。したがって、関数は条件の中で次のように表されます。

LENGTH (NAME) > 30

Query Builderでは、この条件を使用してNAME列のすべての名前を評価し、フィールド長が30文字より大きい名前を戻します。


ネストした条件の作成

  関連項目

ネストした条件を作成するには:

1	「条件」フィールドに、比較演算子を使用して最初の式を入力します（例: TOTAL<1000）。ヒント

2	別の比較演算子を使用して2番目の式を入力します（例: EMP.LAST_NAME=SMITH）。

3	同じ比較演算子（=）を使用して3番目の式を入力します（例: EMP.LAST_NAME=JONES）。

4	2番目と3番目の式を選択します。

5	アイコン・バー.の [image] をクリックします。

6	アイコン・バーの [image] をクリックします。


条件パネルのサイズ設定

条件パネルをサイズ設定するには:

1	Query Builder作業領域スクロール・バーの左下にある黒い四角形をクリックし、カーソルをQuery Builder作業領域まで移動します。

2	条件パネルの幅を広げたり狭めたりするには、黒の太線を左または右にドラッグします。パネル全体が見えなくなると、スクロール・バーの左端に分割バーが表示されます。


条件の構文

  関連項目

条件の一般的な書式は次のとおりです。

[expression] [operator] [expression]

各項目の内容は次のとおりです。

expression	条件を定義する値を指定します。式には日付、文字、リテラル値、数字、列、関数およびデータベース列を指定できます。
operator	より大きい（>）、より小さい（<）、等しい（=）などの比較演算子を指定します。頻繁に使用される演算子は、「データ」メニューとアイコン・バーに表示されます。また、BETWEEN、LIKE、INなどの特殊な比較演算子も数多くあります。
日付値

日付を扱う場合、比較演算子は相対的な時間を表します。つまり、"より少ない"（<）は"より前"を意味します。

日付値は一重引用符で囲み、DD-MON-YY形式で指定する必要があります。DDはカレンダーの日付、MONは月、YYは年を表します。

文字値

文字の列では、演算子は英数字順を表します。（AはBより前にあるので、Aで始まる名前はBで始まる名前より"少なく"なります。それ以降も同様です。

リテラル値

リテラル値は、列名と区別するために一重引用符で囲む必要があります。データベース値と指定する値の間の比較には、大/小文字の区別があります。

数字値

入力する値がNUMBERデータ型の場合は、その数字のみを入力します。つまり、カンマや通貨記号（$）などの書式を使用することはできません。数字列の数字値を引用符で囲む必要はありません。

注意: 3種類の論理（ブール）演算子（AND、OR、NOT）を使用すると、複数または否定の条件を作ることもできます。

追加情報: さまざまなデータ型のOracle構文の詳細は、『Oracle8 Server SQLリファレンス』を参照してください。


否定条件の作成

  関連項目

否定条件を作成するには:

1	条件を作成します。

2	「条件」フィールドをクリックしてアクティブにします。

3	条件の論理演算子を選択します。

4	アイコン・バーの [image] をクリックします。

5	[Enter]または[Return]キーを押して、条件を確定します。

注意: NOT ANDは、すべての条件を満たす行を除く全行を戻します。NOT ORは、いずれかの条件を満たす行を除く全行を戻します。


問合せのSQL文の保存

  関連項目

問合せのSQL文を保存するには:

  問合せウィンドウで、「ファイル」 [image] 「保存」を選択して「別名保存」ダイアログ・ボックスを表示します。このダイアログ・ボックスで、ディレクトリとファイル名を指定できます。


列の順序の変更

 関連項目

問合せ結果内の列の表示順序を変更するには:

1	Query Builder作業領域で、アイコン・バーの [image] をクリックします。

2	「列順序」ダイアログ・ボックスで、「表示される列」リストの列をクリックし、目的の位置にドラッグします。先頭の列は一番左に、最後の列は一番右に表示されます。


問合せのSQL文の表示

  関連項目

問合せのSQL文を表示するには:

  Query Builder作業領域で、アイコン・バーの [image] をクリックします。

「SQLの表示」ダイアログ・ボックスは読込み専用です。SQL文を編集またはコピーすることはできません。


問合せへの列の追加

  関連項目

問合せに列を追加するには:

  問合せウィンドウで、表内の列を選択します。ヒント

チェックされた列は、SQL文および問合せ結果の両方に表示されることを示しています。SQL文に列を組み込み、表示結果の列を非表示にすることはできません。


データベース・トリガー・エディタ・インタフェース

  関連項目

データベース・トリガー・エディタを使用すると、表のBEFOREトリガーまたはAFTERトリガー、ビューとオブジェクト・ビュー(Oracle8に接続している場合)のINSTEAD OFトリガーを作成および編集できます。

新規トリガーを定義するには:

1	「表所有者」ドロップダウン・リストからユーザー名（スキーマ）を選択します。

2	「表」ドロップダウン・リストから表名を選択します。

「表」ドロップダウン・リストには、「表所有者」フィールドに表示されているユーザーが所有する表の名前リストが表示されます。「表所有者」フィールドで自分以外のユーザー名を選択すると、「表」ドロップダウン・リストには、アクセス権を付与されている表のみが表示されます。

(ビューの場合のみ。）オブジェクト・ビューについてINSTEAD OFトリガーを定義するには、「表」の横にある矢印をクリックしてドロップダウン・リストを表示し、「ビュー」を選択します。次に、「ビュー」ドロップダウン・リストからビュー名を選択します。

3	「新規作成」をクリックして、新しいデータベース・トリガーを作成します。

「名前」ドロップダウン・リストで、新しいトリガーに一意のトリガー名（同じスキーマ内の他のトリガーに対して）が自動的に割り当てられます。トリガー名は変更できます。

「名前」ドロップダウン・リストには、「表」（または「ビュー」）フィールドに表示されている表（またはビュー）に関連付けられているトリガー名のリストが表示されます。このドロップダウン・リストには、自分がアクセス権を持っている表に関連付けられているデータベース・トリガーの名前のみが表示されます。

4	トリガー・オプションを指定します。

次の項では、データベース・トリガーを定義するために、データベース・トリガー・エディタで使用できるさまざまなオプションに関する情報を記載しています。

5	トリガー・オプションとアクションを指定したら、「保存」をクリックしてトリガーをコンパイルします。

トリガー・オプション

BEFORE/AFTER	(表の場合のみ。）SQLコマンドCREATE TRIGGERのBEFOREオプションまたはAFTERオプションに対応します。 実行中のトリガー文(UPDATE、INSERTまたはDELETEなど)に関連して、トリガー本体をいつ起動するかを指定します。BEFOREトリガーは、トリガー文の実行前に起動します。AFTERトリガーは、トリガー文の実行後に起動します。 BEFOREトリガーとAFTERトリガーは、行トリガーと文トリガーの両方に適用します。
INSTEAD OF	(ビューの場合のみ。）SQLコマンドCREATE TRIGGERのINSTEAD OFオプションに対応します。 Oracleでは、トリガー文を実行するかわりに、トリガーを起動します。トリガーによって、挿入、更新または削除などのアクションがビューの実表に対して直接行われます。

「文」チェックボックス

UPDATE INSERT DELETE	トリガー本体を起動するSQL文（トリガー文）のタイプを指定します。指定できるオプションは、UPDATE、INSERTおよびDELETEです。  1つ以上のチェックボックスをチェックして、トリガー文にオプションを組み込みます。 トリガー文でUPDATEを指定した場合、オプションの列リストをトリガー文に組み込むことができます。詳細は、次の「列オプション」を参照してください。 複数のオプションをチェックした場合、条件述語のUPDATING、INSERTINGおよびDELETINGを使用して、トリガー本体に含まれる特定のコード・ブロックを実行できます。詳細は、後述の「トリガー本体」を参照してください。

列オプション

列	(表の場合のみ。）SQLコマンドCREATE TRIGGERのUPDATEトリガー文に含まれるOF句に対応します。 「表」フィールドで選択された表について、列のリストを表示します。このリストは、トリガー文でUPDATEが指定されたときにのみアクティブになります。 このリスト・ボックスの列を1つ以上クリックすると、選択した列のどれか1つが更新されたときにのみトリガーが起動するように指定されます。表の任意の列が更新されたときにトリガーを起動したい場合は、リスト内の列名をクリックしないでください。 このオプションは、INSTEAD OFトリガーでは使用できません。Oracleでは、UPDATEによってビューの任意の列に含まれる値が変更されるたびに、INSTEAD OFトリガーを起動します。 Oracle8オブジェクト:ネストされた表またはLOB列は指定できません。

各（文）オプション

文	SQLコマンドCREATE TRIGGERの各（文）オプションに対応します。  トリガーを文トリガーとして指定します。Oracleでは、WHEN句で定義されたオプションのトリガー制約が満たされている場合、トリガー文の発行時に1度のみ文トリガーを起動します（トリガー文の対象となる行の数に関係なく）。 このオプションは、INSTEAD OFトリガーでは使用できません。

各(行)オプション

行	SQLコマンドCREATE TRIGGERの各（行）オプションに対応します。  トリガーを行トリガーとして指定します。Oracleでは、トリガー文の対象となる行ごとに1度のみ行トリガーを起動し、WHEN句で定義されたオプションのトリガー制約を満たします。
相関名	相関名を指定します。行トリガーのトリガー本体およびWHEN句で相関名を使用して、現在行の古い値または新しい値のみを参照できます。デフォルトの相関名はOLDとNEWです。行トリガーが、OLDまたはNEWという名前の表に関連付けられている場合、このオプションを使用して別の相関名を指定し、表名と相関名が重複しないようにします。このオプションは、行トリガーでのみ使用できます。
OLDの相関名	OLDという名前の表と名前が重複しないように相関名を指定します。
NEWの相関名	NEWという名前の表と名前が重複しないように相関名を指定します。
WHEN句の論理式	(表の場合のみ。）SQLコマンドCREATE TRIGGERのWHEN句に含まれるブールSQL式に対応します。このオプションは、行トリガーでのみ使用できます。 オプションのトリガー制限を指定します。 WHEN句にブールSQL式が組み込まれると、その式はトリガーの対象となる各行について評価されます。1つの行について式がTRUEに評価されると、トリガー本体が起動します。1つの行について式がFALSEまたはNOT TRUE(つまり、NULLと同様に不明)に評価されると、トリガー本体は起動しません。 Oracle8オブジェクト:オブジェクト列やその属性、VARRAY、ネストされた表またはLOB列を参照できます。トリガー制限内でPL/SQL関数またはメソッドをコールすることはできません。

トリガー・アクションを次の場所で指定します

トリガー本体	トリガーを起動するためにOracleが実行するPL/SQLブロック。 PL/SQLブロックを入力および編集できる、スクロール可能な複数行のテキスト・ボックス。トリガー本体には、SQL文およびPL/SQL文を組み込むことができます。BEGINとENDの各キーワードは必須です。 行トリガーのトリガー本体には、相関名とREFERENCINGオプション、および条件述語のINSERTING、DELETING、UPDATINGを組み込むことができます。 行トリガーについて、INSERTおよびUPDATEなど複数のタイプのトリガー文が指定されている場合、次に示す条件を組み込むことによって、トリガー本体内の特定のコード・ブロックのみを実行できます。 IF INSERTING THEN�END IF; IF UPDATING THEN�END IF;

エディタ内のボタンを次に示します

新規作成	新しいデータベース・トリガーを作成します。 新しいトリガーの定義を始めるには、「新規作成」をクリックします。
保存	トリガー・オプションを保存し、「トリガー本体」フィールドのソースをコンパイルします。コンパイルの結果として生成されるすべてのメッセージが、別のメッセージ・ボックスに表示されます。
変更の破棄	データベース・トリガーを、最後の保存操作または変更の破棄操作を行ったときの状態に戻します。
削除	データベースから現行のデータベース・トリガーを削除します。 削除する場合には、確認が求められます。
クローズ	データベース・トリガー・エディタを終了します。
ヘルプ	このヘルプ・トピックが表示されます。


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

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

トリガーには、単位ごとに実行するSQL文またはPL/SQL文を組み込むことができ、他のプロシージャを起動できます。トリガーは必要な場合に限り使用します。トリガーを不必要に多く使用すると、トリガーのカスケード化または再帰化が発生します。たとえば、トリガーを起動すると、トリガー本体に含まれるSQL文によって他のトリガーが起動する可能性もあります。

データベース・トリガーを使用することにより、複雑な業務ルールを導入し、すべてのアプリケーションを画一化された方式で動作させることができます。トリガーを設計するときは、次のガイドラインに従います。

•	トリガーを使用するのは、特定の操作が実行されたときに、関連するアクションが確実に実行されるようにする場合です。

•	データベース・トリガーを使用するのは、トリガー文に対して起動する、一元管理された一括操作についてのみです。 この場合、文を発行するユーザーまたはアプリケーションの種類は関係ありません。

•	Oracle内にすでに組み込まれている機能と重複するトリガーは定義しないでください。たとえば、データ整合性ルールを導入するためのトリガーは定義しないでください。 このルールは、宣言整合性制約を使用して簡単に導入できます。

•	トリガーのサイズを制限します（目安は60行以下）。トリガーの論理で60行をはるかに超える数のPL/SQLコードが必要な場合は、大部分のコードをストアド・プロシージャに組み込み、トリガーからプロシージャをコールします。

•	再帰トリガーを作成しないように注意します。たとえば、それ自体がEMPに対してUPDATE文を発行するEMP表に対してAFTER UPDATE文トリガーを作成すると、トリガーは空きメモリーがなくなるまで、再帰的に起動を続けます。

トリガーをアプリケーションで使用する方法の詳細は、『Oracle8 Serverアプリケーション開発者ガイド』を参照してください。トリガーのさまざまなタイプの詳細は、『Oracle8 Server概要』を参照してください。


現行データベースの表所有者のユーザーIDを表示します。ユーザーのドロップダウン・リストを表示するには、このフィールドの右にある矢印をクリックします。


現行データベースの表またはビューの名前を表示します。「表所有者」フィールドに表示されるユーザーが所有する表またはビューのドロップダウン・リストを表示するには、このフィールドの右にある矢印をクリックします。表またはビューを選択するには、リスト内の表またはビューをクリックします。リストには、アクセス権限があるデータベースの表またはビューの名前のみが表示されます（ビューを使用できるのはOracle8のみです）。


現行データベース・トリガーの名前を表示します。「表/ビュー」フィールドに表示される表またはビューのトリガー名のドロップダウン・リストを表示するには、このフィールドの右にある矢印をクリックします。名前リストには、アクセス権限があるデータベース・トリガーの名前のみが表示されます。


トリガーを実行する文（UPDATE、INSERT、DELETEなど）の実行に対して、トリガー本体がいつ起動されるかを示します。このラジオ・ボタンのセットは、SQLコマンドCREATE TRIGGERのBEFORE、AFTERおよびINSTEAD OFオプションに対応しています。


トリガーが、トリガーを実行する文の前に起動されるように指定します。


トリガー本体が、トリガーを実行する文の後に起動されるように指定します。


トリガーを実行する文を実行するかわりに、トリガーがOracleによって起動されるように指定します。ビューの場合に限られます。


トリガー本体を起動するSQL文のタイプを指定します。指定できるオプションは、UPDATE、INSERTおよびDELETEです。オプションをアクティブにするには、1つ以上のチェックボックスをクリックします。表の場合に限られます。


トリガーが、INSERTイベントで起動されるように指定します。


トリガーが、DELETEイベントで起動されるように指定します。


トリガーが、UPDATEイベントで起動されるように指定します。


「表」フィールドで選択された表について、列のリストを表示します。このリストは、「トリガー文」フィールドでUPDATEオプションがアクティブになっている場合にのみ、アクティブになります。表の場合に限られます。


行トリガーを指定します。CREATE TRIGGERコマンドの各（行）オプションに対応しています。


文トリガーを指定します。CREATE TRIGGERコマンドの各（文）オプションに対応しています。


OLDと名付けられる更新前の表またはビューと名前が重複しないように、相関名を指定します。


OLDと名付けられる更新前の表またはビューと名前が重複しないように、相関名を指定します。


WHEN句のブールSQL式を指定します。WHEN句にブールSQL式が組み込まれると、その式はトリガーの対象となる各行について評価されます。1つの行について式がTRUEに評価されると、トリガー本体が起動します。1つの行について式がFALSEまたはNOT TRUE(つまり、NULLと同様に不明)に評価されると、トリガー本体は起動しません。表の場合に限られます。


スクロール可能な複数行のテキスト・ボックスで、PL/SQLデータベース・トリガー本体の入力や編集ができます。トリガー本体は、SQLおよびPL/SQL文を組み込めるPL/SQLブロックです。


名前の付いていない新しいデータベース・トリガーを作成します。


トリガー・オプションを保存し、「トリガー本体」フィールドのソースをコンパイルします。コンパイルの結果として生成されるすべてのメッセージが、メッセージ・ボックスに表示されます。


データベース・トリガーを、最後の保存操作または変更の破棄操作を行ったときの状態に戻します。保存操作または変更の破棄操作が行われなかった場合、データベース・トリガーは元の状態に戻ります。


データベースから現行のデータベース・トリガーを削除します。 削除する場合には、確認が求められます。


PL/SQLインタプリタ・インタフェース

PL/SQLインタプリタはデバッグ用の作業領域です。これを利用して、ソース・コードの表示、デバッグ・アクションの作成、プログラム単位の実行を行ったり、インタプリタ・コマンド、PL/SQL文およびSQL文を実行できます。

デフォルトでは、常にソース・ペインおよびインタプリタ・ペインの2つのペインがPL/SQLインタプリタで開いています。

標準ツールバー・ボタン  インタプリタ内のすべてのペインは、1つのツールバーを共有しています。「クローズ」を除く次のボタンは、プログラム単位の実行停止中のときのみアクティブになり、デバッグに使用されます。

ステップ・イン		停止中のプログラム単位の実行を再開して次の実行可能文に進みます。
ステップ・オーバー		停止中のプログラム単位の実行を再開して次の実行可能文に進み、ネストされたサブプログラムへのコールをスキップします。
ステップ・アウト		ネストされたサブプログラムの実行を再開して、コール側のプログラム単位内の次の実行可能文で実行を中断します。
実行		停止中のプログラム単位の実行を再開し、プログラム単位の終点または次のデバッグ・アクションに進みます。
リセット		現行のデバッグ・レベルを終了します。現行のデバッグ・レベルが1の場合、停止中の実行は放棄されます。
クローズ		PL/SQLインタプリタ・ウィンドウをクローズします。
ヘルプ		このヘルプ・トピックが表示されます。
ソース・ペイン  ソース・ペインでは、現在選択されているプログラム単位のソースが読込み専用で表示されます。キーワード、コメント、文字列および記号には、それぞれ別の色が付けられます。左マージンの第1列は、アイコンおよび記号用に予約されています。左マージンの第2列には、ソースの行番号が表示されます。

次のアイコンが表示される場合もあります。

黄色の矢印		現行の実行位置またはプログラム・カウンタ（program counter）(PC)を示します。
赤色のボール		使用可能なブレークポイントまたはトリガーを示します。
緑色のボール		使用不可のブレークポイントまたはトリガーを示します。

次の記号がソース・ペインに表示される場合もあります。

|	現行のソース位置を示します。  現行のソースの位置は、インタプリタ・コマンド（LISTなど）の結果、またはプログラム単位の実行がデバッグ・アクション（ブレークポイントなど）によって割り込まれたときに変わります。
B(n)	ブレーク・ポイントの位置を示します。 nは対応するデバッグ・アクションIDです。
T(n)	デバッグ・トリガーの位置を示します。 nは対応するデバック・アクションIDです。

ソース・ペインは、ポップアップ・メニュー（ウィンドウで右クリック）から次のコマンドを提供します。

ブレーク	新しいブレーク・ポイントを定義する「PL/SQLブレークポイント」ダイアログ・ボックスを表示します。
トリガー	「PL/SQLトリガー」ダイアログ・ボックスが表示され、新しいデバッグ・トリガーを定義できます。
編集	プログラム単位エディタが表示され、現行のプログラム単位を編集できます。
注意: 一部のシステムでは、ポップアップ・メニューをサポートしていません。前述のコマンドは、「デバッグ」メニューからも使用可能です。

分割バー  分割バーを使用して、インタプリタの各ペインが占める領域の相対量を変更できます。最初にインタプリタが表示されると、分割バーはソース・ペインとインタプリタ・ペインの間に置かれます。モーダル・インタプリタを使用しているか、またはモードレス・インタプリタにナビゲータ・ペインを挿入した場合、2次分割バーが表示されます。

インタプリタ・ペイン  インタプリタ・ペインは、PL/SQL、Procedure BuilderおよびSQLにコマンド・ライン・インタフェースを提供します。PL/SQL>プロンプトの後に、PL/SQL文やPL/SQLブロック、Procedure Builderのインタプリタ・コマンド、またはSQL文を入力できます（SQL*Plus文および構文はサポートされていません）。

マルチライン・コマンド  PL/SQL>プロンプトでのPL/SQL構文の入力時に、いつでも[Enter]キーを押し+>の形式で2つ目のプロンプトを表示できます。終了のセミコロン（;）付きコードを実行するまで、必要なだけ後続のプロンプトを表示することができます。

デバッグ・レベル  デバッグ・アクションによってプログラムの実行が中断された場合、インタプリタはデバッグ・レベルを確立します。デバッグ・レベルではコマンドおよびPL/SQL文を入力でき、それらが逆に割り込まれることによって、デバッグ・レベルがネストされる場合もあります。現行のデバッグ・レベルは、そのレベル番号を含む接頭辞が付いたインタプリタ・ペインの新規プロンプトに示されます。たとえば、デバッグ・レベル1では、インタプリタ・プロンプトが次のように表示されます。

（デバッグ 1）PL/SQL>

ポップアップ・メニュー  インタプリタ・ペインは、ポップアップ・メニュー（ウィンドウで右クリック）から次のコマンドを提供します。

消去	インタプリタ・ペインのすべてのテキストを廃棄し、新規プロンプトを発行します。
新規プロンプト	インタプリタ・ペインで新規プロンプトを発行します。前のプロンプトでの入力は、すべて無視されます。
注意: 一部のシステムでは、ポップアップ・メニューをサポートしていません。

ナビゲータ・ペイン  オブジェクト・ナビゲータ・ペインを使用して、現行のコール・スタックが表示できるほか、デバッグ中に現行の有効範囲の位置で、ローカル変数やパラメータの値を表示したり、任意に変更することもできます。

プログラム単位のデバッグ中に完全にインタプリタ内で作業したい場合は、ソース・ペインとインタプリタ・ペインの間に、オブジェクト・ナビゲータ・ペインを挿入できます。ナビゲータ・ペインを挿入するには、メニューから「表示」 [image] 「ナビゲータ・ペイン」を選択します。ナビゲータ・ペインを隠すには、同じコマンドをもう一度選択します。「表示」メニューから適切なコマンドを選択することにより、他のペインを隠すこともできます。

ナビゲータ・ツールバー　ナビゲータ・ペインが表示されると、以下の項目もボタン・バーに表示されます。

作成		現在選択されているオブジェクトまたはノードの新規インスタンスを作成します。
削除		選択されたオブジェクトを確認の上削除します。
拡張		現在選択されているノードのサブノードの最初のレベルを拡張します。
縮小		現在選択されているノードのサブノードの現行レベルを縮小します。
すべて拡張		現在選択されているノードのサブノードのすべてのレベルを拡張します。ただし、Oracle8のデータ型および属性のノードを再帰的に拡張はしません。
すべて縮小		現在選択されているノードのサブノードのすべてのレベルを縮小します。
検索（テキスト・ボックス）		オブジェクトの一部またはすべての名前を入力することにより、ナビゲータ内でオブジェクトを検索できます。
順方向検索		「検索」テキスト・ボックスに指定した検索条件の次に一致する項目を検索します。
逆方向検索		「検索」テキスト・ボックスに指定した検索条件の1つ前に一致する項目を検索します。


停止中のプログラム単位の実行を再開して次の実行可能文に進みます。


停止中のプログラム単位の実行を再開して次の実行可能文に進み、ネストされたサブプログラムへのコールを飛ばします。


ネストされたサブプログラムの実行を再開して、コール側のプログラム単位内の次の実行可能文で実行を中断します。


停止中のプログラム単位の実行を再開し、プログラム単位の終点または次のデバッグ・アクションに進みます。


現行のデバッグ・レベルを終了します。現行のデバッグ・レベルが1の場合、停止中の実行は放棄されます。


現在選択されているオブジェクトまたはノードの新規インスタンスを作成します。


選択されたオブジェクトを確認の上削除します。


現在選択されているノードのサブノードの最初のレベルを拡張します。


現在選択されているノードのサブノードの現行レベルを縮小します。


現在選択されているノードのサブノードのすべてのレベルを拡張します。Oracle8のデータ型および属性のノードは、再帰的に拡張されません。


現在選択されているノードのサブノードのすべてのレベルを縮小します。


ナビゲータ内で検索するオブジェクトの名前を入力します。


現行のプログラム単位の名前を指定し、それがクライアント上にあるかサーバー上にあるかを示します。


現在選択されているプログラム単位のソースを、ソースの第2列に行番号を付けて読込み専用で表示します。


インタプリタ内の各ペインが占める領域の相対量を変更できます。最初にインタプリタが表示されると、分割バーはソース・ペインとインタプリタ・ペインの間に置かれます。モーダル・インタプリタを使用しているか、またはモードレス・インタプリタにナビゲータ・シートンを挿入した場合、2次分割バーが表示されます。


現行のコール・スタックが表示できるほか、デバッグ中に現行の有効範囲の位置で、ローカル変数やパラメータの値を表示したり、任意に変更することもできます。


PL/SQL、Procedure BuilderおよびSQLにコマンド・ライン・インタフェースを提供します。PL/SQL>プロンプトの後に、PL/SQL文またはPL/SQLブロック、Procedure Builderのインタプリタ・コマンド、またはSQL文を入力できます。


エラー・メッセージについて

各コンポーネントには、次に示す一意のエラー・メッセージ接頭辞があります。

接頭辞	コンポーネント
FRM	Form Builder
OG	Graphics Builder
PDE	Procedure Builder
REP	Reports Builder
BRW	Query Builder
BRS	Schema Builder
NX, XBD	Translation Builder
注意: UNIXでは、Report Builderにより、いくつかのメッセージに表示される$status変数の値は0(正常終了)または1(異常終了)に設定されます。

Forms DeveloperおよびReports Developerのエラー・メッセージに加え、次に示す他のソースからのエラー・メッセージが発生する場合があります。

接頭辞	ソース	ヘルプ
ORA	Oracle Server	『Oracle8 Serverエラー・メッセージ』
PLS	PL/SQL	『Oracle8 Serverエラー･メッセージ』
『Oracle8 Serverエラー・メッセージ』には、SQL*DBA、SQL*Loader、SQL*Module、エクスポート、インポート、Oracleプリコンパイラなど、すべてのデータベース・ユーティリティのエラー・メッセージ・コードと説明が挙げられています。

システム固有のエラー・メッセージについては、オペレーティング・システムのマニュアルに記述されています。


サポート担当への連絡

エラーによっては（内部エラーなど）、エラー報告のためサポート担当に連絡が必要なものがあります。カスタマ・サポートに連絡する場合、次の情報を用意しておいてください。

1	氏名、会社名およびOracleサポートID番号。

2	ハードウェア、オペレーティング・システムおよび使用しているオペレーティング・システムのリリース番号。

3	エラー発生時に使用していたコンポーネントの完全なバージョン番号、および改訂番号とポート・リリース番号（存在する場合）。（コンポーネントのバージョン番号が不明な場合は、「ヘルプ」 [image] 「バージョン情報」を選択してください。）

4	エラー発生時に使用していたその他のすべてのコンポーネント（およびバージョン番号）（たとえば、Oracle 8.0.4）。

5	1つ以上のエラー・メッセージが発生した場合、それらが現れた順に、正確なメッセージ番号と説明。

6	問題の説明（異常な状態など）。

7	次のコードに基づいた、問題の重大度。

•	1:  プログラムが使用できない。操作に重大な影響がある。

•	2:  プログラムは使用できる。操作がかなり制限される。

•	3:  プログラムは使用できるが機能に制限がある。全体の操作に重大な影響はない。

•	4:  使用方法が限定される。操作にはわずかな影響しかない。


異常な状態

時々、異常な状態として知られているエラーが発生する場合があります。これは、次に挙げる原因から起きる可能性があります。

•	アプリケーションが要求されたタスクを完了できない事態が生じました。たとえば、誰かが標準のユーザー・インタフェースを使用せずに、データベースの表の中のデータを変更した場合、無効な値を入力する可能性があります。

•	ソフトウェアのバグが、要求されたタスクの完了を妨げました。

対策  まず、メッセージがForms DeveloperおよびReports Developer以外のものが原因で起きたかどうかを確認するため、システム管理者に連絡してください。メッセージがユーザー・エラーやシステム問題から発生したのではないことが確認された場合、サポート担当に連絡してください。


PL/SQL V1変換ユーティリティについて

  関連項目

PL/SQL V1変換ユーティリティは、PL/SQL V1またはV2で作成されたアプリケーションをアップグレードするプロセスを自動化するときに役立ちます。

フォーム、レポートおよび図表のトリガー、プログラム単位およびPL/SQLブロックが、PL/SQL V1またはV2で書かれている場合、コードはアップグレードする必要があります。アップグレードを行わないと、次の2種類の問題が発生する可能性があります。

•	PL/SQL V1またはV2コードの中には、それより後のバージョンでは構文上有効でないためにコンパイル・エラーを起こすものがあります。

•	PL/SQL V1またはV2コードの中には、それより後のバージョンでは構文上は正しいが、意味が異なるため、予期しない動作や不正な動作を起こすものがあります。

変換ユーティリティは、この両方の問題に対応します。


PL/SQL V1変換ユーティリティの実行方法

  関連項目

変換ユーティリティは、対話形式またはバッチ・モードで使用できます。いずれの場合も、ユーティリティによりコードを実際に更新するかどうかは、ユーザーが制御します。対話形式モードでは、ユーティリティによる変更も、手動での変更も可能なため、柔軟性があります。バッチ・モードでは、ユーティリティは可能な変換をすべて行うか、まったく行わないかのどちらかです。変換は対話形式モードまたはバッチ・モードのいずれかで行われても、変換処理の概略がmodule.plgというログ・ファイルに記録されます。

ユーティリティを対話形式で実行するには、対応するBuilderで、保存されたフォーム、レポート、図表、またはPL/SQL V1またはV2コードを含むライブラリをオープンします。

ユーティリティをバッチ・モードで実行する場合、次の項目を参照してください。

•	バッチ・モードでのフォームの変換

•	バッチ・モードでのレポートの変換

•	バッチ・モードでの図表の変換

ヒント

変換ユーティリティはコードをアップグレードし、V1またはV2の非互換性の一部を解決しますが、変換ユーティリティで対処できない場合もあります。その場合は、コンパイル・エラーとなります。 変換結果は「PL/SQL V1の変換サマリー」ダイアログ・ボックス（対話形式モード）またはログ・ファイルに表示されるので、手動でエラーに対処できます。詳細は、「PL/SQL V1変換ユーティリティでは変換されないもの」を参照してください。

変換ユーティリティによるアプリケーションの変換、保存後は、推奨される変換をすべて無視した場合でも、そのアプリケーションに対しユーティリティを再起動することはできません。これにより、手動で加えた変更がユーティリティにより上書きされることが防止されます。


使用するモードを決定する前に、各タイプのいくつかのモジュールを対話形式で変換してみます。これで、各タイプのモジュールで発生しているのが、どういう種類の問題なのかわかるので、今後の進め方を決定するのに役立ちます。たとえば、レポートおよびPL/SQLライブラリをバッチ・モードで確実に変換できても、フォームが対話モードで提供されるクローズ監視を必要としていることを発見できる可能性もあります。


対話形式によるPL/SQL V1変換ユーティリティの使用

  関連項目

変換ユーティリティを対話形式で実行するには、対応するBuilderで、保存されたフォーム、レポート、図表、またはPL/SQL V1またはV2コードを含むライブラリをオープンし、アプリケーションを保存します。

重要事項:

•	変換ユーティリティによるアプリケーションの変換、保存後は、推奨される変換をすべて無視した場合でも、そのアプリケーションに対しユーティリティを再起動することはできません。これにより、手動で加えた変更がユーティリティにより上書きされることが防止されます。

トリガー内の各PL/SQL V1またはV2文、PL/SQLブロックまたはプログラム単位は、「変換」ダイアログ・ボックス内に表示されます。このダイアログ・ボックスには、変換を選択した場合に変換ユーティリティによって実行されるアクションも表示されます。提示された変更の実行、提示された変更の無視、アプリケーション全体の変換またはプロセス全体の停止を行うかについては、自由に選択できます。（「PL/SQL V1の変換オプション」ダイアログ・ボックスを使用して、変換プロセスを制御するパラメータを設定することもできます。）

変換ユーティリティによって、変更（または変更しなかった部分）が追跡され、変換プロセスの最後にmodule.plgという名前のログ・ファイルに要約されます。次にPL/SQLエディタを起動して、アプリケーションを手動で更新できます。


バッチ・モードでのPL/SQL V1変換ユーティリティの使用

  関連項目

ユーティリティをバッチ・モードで実行する場合、次の項目を参照してください。

•	バッチ・モードでのフォームの変換

•	バッチ・モードでのレポートの変換

•	バッチ・モードでの図表の変換


バッチ・モードでのフォームの変換

  関連項目

フォームをバッチ・モードで変換する手順

1	フォームに関連したすべてのPL/SQLライブラリを変換したことを確認します。

2	次のいずれかの操作を行います。

•	Forms compilerのGUIバージョンを実行します。

•	Forms compilerをコマンド・ラインで実行します。

どちらを選択しても、変換処理の概略は自動的にログ・ファイルmodule.plg(moduleは変換されたフォーム・モジュールの名前)に書き込まれます。

使用上の注意

•	変換ユーティリティによるアプリケーションの変換、保存後は、推奨される変換をすべて無視した場合でも、そのアプリケーションに対しユーティリティを再起動することはできません。これにより、手動で加えた変更がユーティリティにより上書きされることが防止されます。


Form CompilerGUIバージョンを使用したフォームの変換

Forms CompilerのGUIバージョンを使用したフォームの変換手順

1	「Form Compiler」アイコンをダブルクリックします。

2	適切なモジュール・タイプとモジュール・アクセスを選択します。

3	「PL/SQLをV1からV2.3にアップグレードしますか?」と書かれたボックスを選択します。

4	「OK」をクリックします。


コマンド・ラインでのフォームの変換

  関連項目

コマンド・ラインでForm Compilerを使用しフォームを変換する手順

コマンドラインで次のコマンドを発行します。

<Form Compiler> MODULE=form BATCH=yes UPGRADE_PLSQL=yes UPGRADE=yes

パラメータの内容は次のとおりです。

<Form Compiler>	プラットフォーム上のForm Compilerの実行可能プログラムの名前。
form	変換するフォームの名前。
使用上の注意:

•	UPGRADE=YESを同時に指定せずにUPGRADE_PLSQL=YESを指定すると、エラー・メッセージが生成されます。すべてのフォームをForms 6.0に更新しておかないと、PL/SQLをフォーム内で変換できません。 このため、UPGRADE_PLSQL= YESの場合は、UPGRADE=YESを指定する必要があります。

•	大量の図表を一度に変換する場合は、Project Builderを使用します。Project Builderのヘルプ・トピックを参照してください。


接続されたPL/SQLライブラリのフォームへの変換

PL/SQLライブラリを対話形式で変換する手順

 Form Builder内でライブラリをオープンし、保存します。

Form CompilerのGUIバージョンを使用して、PL/SQLライブラリを変換する手順

1	「Form Compiler」アイコンをダブルクリックします。

2	「ファイル」フィールドで、変換するPL/SQLライブラリを選択します。

3	「出力内容の書き込み先ファイル」フィールドで、ターゲット・ファイルに拡張子.PLLが付いていることを確認します。

4	「OK」をクリックします。

コマンド・ラインでForm Compilerを使用しPL/SQLライブラリを変換する手順

コマンドラインで次のコマンドを発行します。

<Form Compiler> MODULE=library BATCH=yes UPGRADE_PLSQL=yes UPGRADE=yes

パラメータの内容は次のとおりです。

<Form Compiler>	プラットフォーム上のForm Compilerの実行可能プログラムの名前。
library	変換するライブラリの名前。
使用上の注意

•	UPGRADE=YESを同時に指定せずにUPGRADE_PLSQL=YESを指定すると、エラー・メッセージが生成されます。すべてのフォームをForms 6.0に更新しておかないと、PL/SQLをフォーム内で変換できません。 このため、UPGRADE_PLSQL= YESの場合は、UPGRADE=YESを指定する必要があります。

•	大量の図表を一度に変換する場合は、Project Builderを使用します。Project Builderのヘルプ・トピックを参照してください。


Form Compilerパラメータの指定

次の表は、BATCH、UPGRADEおよびUPGRADE_PLSQLのパラメータの組合せの違いにより、変換処理にどのような影響があるかを示しています。

BATCH	UPGRADE_PLSQL	UPGRADE	動作
NO	YES	YES	フォーム内のPL/SQLは、バッチ・モードで変換されます(BATCH=NOの場合も)。ユーティリティは、Builderの外から対話形式で起動できません。
YES	YES	YES	フォーム内のPL/SQLは、バッチ・モードで変換されます。
NO	NO	YES	フォーム内のPL/SQLは変換されませんが、推奨される変換の一覧がmodule.plgに書き込まれます。フォームは、Forms 6.iにアップグレードされます。
YES	NO	YES	フォーム内のPL/SQLは変換されませんが、推奨される変換の一覧がmodule.plgに書き込まれます。フォームは、Forms 6.iにアップグレードされます。
NO	NO	NO	FMBを変更することなく新規のFMXをコンパイルする場合に使用します。フォームにV1.3のPL/SQLが含まれる場合、コンパイラ・エラーが発生するか、コードが異なる動作を起こす場合があります。
YES	NO	NO	FMBを変更することなく新規のFMXをコンパイルする場合に使用します。フォームにV1.3のPL/SQLが含まれる場合、コンパイラ・エラーが発生するか、コードが異なる動作を起こす場合があります。
重要事項:

45FMTから60FMBへのアップグレードを、UPGRADE_PLSQLオプションを指定せずに行うと、フォーム内のPL/SQLは変換されません。ただし、変換されるべきフォームがログ・ファイルに記録されます。このログ・ファイルは現行のワーキング・ディレクトリに保存されるため、FMTファイルが保存されているディレクトリとは異なる場合があります。


バッチ・モードでのレポートの変換

レポートをバッチ・モードで変換する手順

1	レポートに接続したPL/SQLライブラリをすべて変換したことを確認します。

2	次のいずれかの操作を行います。

•	Report CompilerのGUIバージョンを実行します。

•	コマンド・ラインからReport Compilerを実行します。

どちらを選択しても、変換処理の概略は自動的にログ・ファイルmodule.plg(moduleは変換されたレポート・モジュールの名前)に書き込まれます。モジュールごとに個別のログが生成されます。

使用上の注意

•	変換ユーティリティによるアプリケーションの変換、保存後は、推奨される変換をすべて無視した場合でも、そのアプリケーションに対しユーティリティを再起動することはできません。これにより、手動で加えた変更がユーティリティにより上書きされることが防止されます。


Report CompilerのGUIバージョンを使用したレポートの変換

Report CompilerのGUIバージョンを使用し、1つ以上のレポートを変換する手順

1	「Report Compiler」アイコンをダブルクリックします。

2	「文書タイプ」フィールドで、「レポート」を選択します。

3	適切な「ソース・タイプ」および「宛先タイプ」を選択します。

4	「ソース」フィールドの「参照」ボタンを使用し、変換するレポートの位置を確認します。

5	「宛先」フィールドの「参照」ボタンを使用し、変換したレポートの宛先を選択します。

6	「OK」をクリックします。


コマンド・ラインでのレポートの変換

1つ以上のレポートをコマンド・ラインで変換する手順

コマンドラインで次のコマンドを発行します。

<Report Compiler> SOURCE=rep1,rep2, UPGRADE_PLSQL=yes

パラメータの内容は次のとおりです。

<Report Compiler>	プラットフォーム上のReport Compilerの実行可能プログラムの名前。
rep1,rep2,	変換するレポートの名前。


接続されたPL/SQLライブラリのレポートへの変換

PL/SQLライブラリを対話形式で変換する手順

 Report Builder内でライブラリをオープンし、保存します。

Report CompilerのGUIバージョンを使用して、PL/SQLライブラリを変換する手順

1	「Report Compiler」アイコンをダブルクリックします。

2	「文書タイプ」フィールドで、「PL/SQLライブラリ」を指定します。

3	「ソース・タイプ」フィールドで、.PLLを指定します。

4	「宛先タイプ」フィールドで、.PLLまたは.PLXを指定します。.PLDを指定すれば、V1またはV2のPL/SQLは変換されません。

コマンド・ラインでReport Compilerを使用してPL/SQLライブラリを変換する手順

 コマンドラインで次のコマンドを発行します。

<Report Compiler> SOURCE=lib1,lib2, UPGRADE_PLSQL=yes

パラメータの内容は次のとおりです。

<Report Compiler>	プラットフォーム上のReport Compilerの実行可能プログラムの名前。
lib1, lib2	変換するライブラリの名前。
使用上の注意

•	大量の図表を一度に変換する場合は、Project Builderを使用します。Project Builderのヘルプ・トピックを参照してください。


バッチ・モードでの図表の変換

バッチ・モードで図表を変換する手順

1	図表に関連するすべてのPL/SQLライブラリの変換が終了したことを確認します。

2	次のコマンドを発行します。

<Graphics Builder> openfile=temp.ogd upgrade_plsql=yes savefile=temp1.ogd quit=yes

パラメータの内容は次のとおりです。

<Graphics Builder>	プラットフォーム上のGraphics Builderの実行可能プログラムの名前。
openfile=temp.ogd	Graphics Builderで図表temp.ogdをオープンします。
upgrade_plsql=yes	V1またはV2のPL/SQLを変換します。
savefile=temp1.ogd	変換した図表をtemp1.ogdに保存します。
quit=yes	図表が変換された後、Graphics Builderをクローズします。
使用上の注意:

•	変換処理の概略は、ログファイルmodule.plg（moduleは変換された図表の名前）に自動的に書き込まれます。

•	大量の図表を一度に変換する場合は、Project Builderを使用します。Project Builderのヘルプ・トピックを参照してください。

•	変換ユーティリティによるアプリケーションの変換後は、推奨される変換をすべて無視した場合でも、そのアプリケーションに対しユーティリティを再起動することはできません。これにより、手動で加えた変更がユーティリティにより上書きされることが防止されます。


接続されたPL/SQLライブラリの図表への変換

PL/SQLライブラリを対話形式で変換する手順

 Graphics Builderでライブラリをオープンし、保存します。

PL/SQLライブラリをバッチ・モードで変換する手順

 次のコマンドを発行します。

<Graphics Builder> openfile=temp.lib upgrade_plsql=yes savefile=temp1.lib quit=yes

パラメータの内容は次のとおりです。

<Graphics Builder>	プラットフォーム上のGraphics Builderの実行可能プログラムの名前。
openfile=temp.lib	Graphics Builderでライブラリ temp.lib をオープンします。
upgrade_plsql=yes	V1またはV2のPL/SQLを変換します。
savefile=temp1.lib	変換されたライブラリを temp1.lib に保存します。
quit=yes	ライブラリが変換された後、Graphics Builderをクローズします。
使用上の注意:

•	変換処理の概略は、ログファイル module.plg（module は変換されたライブラリの名前）に自動的に書き込まれます。

•	変換ユーティリティによるアプリケーションの変換後は、推奨される変換をすべて無視した場合でも、そのアプリケーションに対しユーティリティを再起動することはできません。これにより、手動で加えた変更がユーティリティにより上書きされることが防止されます。

•	大量の図表を一度に変換する場合は、Project Builderを使用します。Project Builderのヘルプ・トピックを参照してください。


PL/SQL V1変換ユーティリティにより変換されるもの

  関連項目

次に、変換ユーティリティがアプリケーション内で解決できる場合を示します。

CHARをVARCHAR2に置換

VARCHAR2に必要な文字列の長さを設定

OUTおよびIN OUTのデフォルト式を削除

式に必須なRETURN文

廃止されたビルトインの置換

ファンクションlengthはゼロ長の文字列に対しNULLを返す

NULLを渡すオーバーロードしたサブプログラムへの対処

ファンクションにRETURN文を指定しないとランタイム・エラーが発生する

長さの制限を削除


CHARをVARCHAR2に置換

PL/SQL V1では、データ型CHARとVARCHAR2は、相互に交換して使用できました。V1より後のバージョンでは、CHARデータ型は右側にスペースが埋められます。

PL/SQL V1では、次の文は、

var1 CHAR(10) := 'hello';

'hello'に同じです。

しかしV1より後のバージョンでは、この文は'hello     '(合計で10文字)として解釈します。

CHAR変数のV1の動作を保つため、変換ユーティリティでは、すべてのCHAR(n)宣言を同義のVARCHAR2(n)文と置換します。上記の例では、var1はVARCHAR2(10)になります。

また、変換ユーティリティでは、VARCHAR文をすべて同義のVARCHAR2式と置換します。


VARCHAR2に必要な文字列の長さを設定

PL/SQL V1より後のバージョンでは、すべてのVARCHAR2変数に対して、長さの指定が必要です。CHARデータ型にすでに長さが指定されている場合、変換ユーティリティは宣言をVARCHAR2に置換する際、その長さを使用します（詳細は、「CHARをVARCHAR2に置換」を参照）。次に例を示します。

var1 CHAR(10);

は、次のように変換されます。

var1 VARCHAR2(10);

変換プログラムは、文字長のないCHARまたはVARCHAR2文を検出すると、1文字の長さを設定します。次に例を示します。

var2 CHAR;

は、次のように変換されます。

var2 VARCHAR2(1);

同様に、

var3 VARCHAR2;

は、次のように変換されます。

var3 VARCHAR2(1);

VARCHAR2宣言に対し長さを指定しないと、コンパイラで次のエラー・メッセージが生成されます。

エラー215: 文字長は1～32767の範囲に制限されています


OUTおよびIN OUTのデフォルト式を削除

  例

PL/SQL V1では、OUTパラメータとIN OUTパラメータの後にデフォルト式を続けることができましたが、この式は常に無視されていました。変換ユーティリティで、OUTパラメータとIN OUTパラメータのデフォルト式を削除します。

既存のコード（デフォルト式の付いたOUTパラメータとIN OUTパラメータを含みます）をコンパイルすると、次のエラー・メッセージが生成されます。

エラー230: OUTおよびIN OUT形式のパラメータに、デフォルト式を付けることはできません


デフォルト式の削除例

  関連項目 	   すべての例

変換ユーティリティは、次のPL/SQL V1コードを、

PROCEDURE p (p1 IN OUT NUMBER DEFAULT 25,
             p2 OUT NUMBER DEFAULT 16) IS

BEGIN
. . .
END;

次のように変換します。

PROCEDURE p (p1 IN OUT NUMBER, p2 OUT NUMBER) IS

BEGIN
. . .
END;


式に必須なRETURN文

  例

PL/SQL V1では、式のないRETURN文を使用して、NULL値を返すことができました。ファンクションはすべて値を返す必要があるため、V1より後のバージョンではRETURN文が必須となります。変換ユーティリティは、式が続いていないRETURN文をすべてRETURN NULLと置換します。

式のないRETURN文を含むPL/SQLをコンパイルすると、次のエラー・メッセージが生成されます。

エラー503:このファンクションからの戻り値にはRETURN文が必要です


NULLをRETURN文に追加する例

  関連項目 	   すべての例

変換ユーティリティは、次のPL/SQL V1コードを、

FUNCTION f RETURN NUMBER IS
x NUMBER;
BEGIN
x :=13;
IF .. . THEN
RETURN;
END IF;
RETURN x;
END;

次のように変換します。

FUNCTION f RETURN NUMBER IS
x NUMBER;
BEGIN
x :=13;
IF .. . THEN
RETURN NULL; ここでNULLが追加されます
END IF;
RETURN x;
END;


廃止されたビルトインの置換

  例

文字列をPL/SQLの整数に変換するTO_PLS_INTEGERビルトインは、V1より後のバージョンでは廃止されています。変換ユーティリティは、TO_PLS_INTEGERをビルトインTO_NUMBERに置換します。

TO_PLS_INTEGERビルトインを置換しないと、次のコンパイル・エラーが生成されます。

エラー201:識別されたTO_PLS_INTEGERを宣言する必要があります

注意: 廃止されているその他のビルトインは、手動で置換する必要があります。


廃止されたビルトインの置換例

  関連項目 	   すべての例

変換ユーティリティは、次のPL/SQL V1コードを、

PROCEDURE foo IS
     v INTEGER;
BEGIN
     v := TO_PLS_INTEGER(24);
END;

次のように変更します。

PROCEDURE foo IS
     v INTEGER;
BEGIN
     v := TO_NUMBER(24);     TO_PLS_INTEGERはTO_NUMBERで置換されます
END;


ファンクションlengthはゼロ長の文字列に対しNULLを返す

  例

PL/SQL V1では、NULL式に適用されたファンクションlengthは、ゼロを返しました。V1より後のバージョンでは、NULL式に適用されたファンクションlengthは、NULLを返します。

V1の動作を保つために、PL/SQL変換ユーティリティはNVL SQL述語を追加して、NULL式に適用されたファンクションlengthがゼロを返すようにします。


ファンクションlengthの例

  関連項目 	   すべての例

変換ユーティリティは、次のPL/SQL V1コードを、

c:=null;
l=LENGTH( c );         V1では、これが0に変わります

次のように変換します。

c:=null;
l=NVL(LENGTH( c ),0);  コンバータはNVL( )ビルトインでファンクションlength
                           をラップし、式がゼロを返すようにします


NULLを渡すオーバーロードしたサブプログラムへの対処

  例

PL/SQL V1では、パッケージ内の同じプログラム単位を2つの異なるデータ型、VARCHAR2型とRECORD型として定義できました。これをサブプログラムをオーバーロードするといいます。オーバーロードしたサブプログラムにNULL値を渡した場合、PL/SQLはデータ型をVARCHAR2と仮定しました。ただし、V1より後のバージョンでは、パッケージ内のオーバーロードしたサブプログラムにNULL値を渡す場合、そのデータ型を定義する必要があります。

V1の動作を保つために、PL/SQL変換ユーティリティは、オーバーロードしたサブプログラムに渡されたNULL値を検出すると、必要に応じて次のようなアクションを行います。

•	NULLをTO_CHAR( )でラップします。

•	NULLをTO_NUMBER( )でラップします。

•	NULLをTO_DATE( )でラップします。

•	NULLをNOTでラップします。

希望するデータ型を定義しないで、オーバーロードしたプログラム単位にNULL値を渡す場合、コンパイラで次のエラー・メッセージが生成されます。

エラー307:このコールと一致する'PU名'宣言が多すぎます...


オーバーロードしたサブプログラムにNULL値を渡す例

  関連項目 	   すべての例

変換ユーティリティは、次のPL/SQL V1コードを、

PACKAGE ps1 IS
  TYPE foo IS RECORD(id PLS_INTEGER);
                              サブプログラムpがオーバーロードされます
    PROCEDURE p(a VARCHAR2);    aはVARCHAR2型の変数として定義されます
  PROCEDURE p(a FOO);         aは他のデータ型の変数としても定義されます
END;

PROCEDURE foo2 IS
BEGIN
  ps1.p(NULL);                V1では、VARCHAR2データ型が仮定されます
END;

次のように変換します。

PACKAGE ps1 IS
  TYPE foo IS RECORD(id PLS_INTEGER);

  PROCEDURE p(a VARCHAR2);
  PROCEDURE p(a FOO);

END;

PROCEDURE foo2 IS
BEGIN
  ps1.p(TO_CHAR(NULL));      aはVARCHAR2型であるためNULL値は
                                 TO_CHAR( )によってラップされます
END;


ファンクションにRETURN文を指定しないとランタイム・エラーが発生する

  例

PL/SQL V1では、ファンクションでRETURN文を省略しても実行時に問題は発生しません。ただし、V1より後のバージョンでは、ランタイム・エラーが発生します。

V1の動作を保つために、PL/SQL変換ユーティリティは、引数にNULLを持つRETURN文を、RETURN文のないファンクションに追加します。

注意: ファンクションにRETURN文がない場合でもコンパイラ・エラーは発生しませんが、V1より後のバージョンではランタイム・エラーが発生します。


RETURN文が指定されていない例

  関連項目	 	   すべての例

変換ユーティリティは、次のPL/SQL V1コードを、

FUNCTION noreturn (arg IN NUMBER) RETURN char IS
BEGIN
  IF (arg > 100000) THEN
    TEXT_IO.PUT_LINE ('The point of no return.');
  ENDIF;
                         RETURN文が欠落しています。
END;

次のように変換します。

FUNCTION noreturn (arg IN NUMBER) RETURN char IS
BEGIN
  IF (arg > 100000) THEN
    TEXT_IO.PUT_LINE ('The point of no return.');
  ENDIF;
  RETURN NULL;             コンパータによってRETURN NULLが追加されました。
END;


長さの制限を削除

  例

PL/SQL V2では、DATE、BOOLEAN、MLSLABEL、ROWIDの長さの制限は無視されます。ただし、このためにV8でコンパイル・エラーが発生します。

V2の動作を保つため、PL/SQL変換ユーティリティは制限を削除します。


長さの制限の削除例

  関連項目 	   すべての例

変換ユーティリティは、次のコードを、

PROCEDURE badconstraint IS
d DATE(5);
b BOOLEAN(5);
d MLSLABEL(5); --V2 のみ
r ROWID(5); --V2 のみ
BEGIN
  null;
END;

次のように変換します。

PROCEDURE badconstraint IS
d DATE;
b BOOLEAN;
d MLSLABEL; --V2のみ
r ROWID; --V2のみ
BEGIN
  null;
END;


PL/SQL V1変換ユーティリティでは変換されないもの

  関連項目

PL/SQLの多くの非互換項目は変換ユーティリティにより変換できますが、次のものは手動で修正する必要があります。

パッケージ内で必要とされる一意名

標準パッケージ・ファンクションが使用されない場合への対処

PL/SQL V2.3以降における新規予約語

変数の宣言に必要な%ROWTYPEまたは%TYPE

致命的なコンパイラ・エラーが発生し、変換プロセスが継続できない場合は、警告 "Encountered a non-recoverable error; conversion aborted at line <line number> column <column>" が表示されます。


パッケージ内で必要とされる一意名

  例

PL/SQL V1では、同一パッケージ内で変数と同じ名前を持つプロシージャまたはファンクションを作成すると、変数が常に使用され、同一名が付けられたプロシージャやファンクションは無視されました。V1より後のバージョンでは、同一パッケージ内の変数、ファンクションおよびプロシージャは、他と重複しないでください。

エラーを防ぐには、パッケージ内のすべてのプロシージャが一意の名前を持つようにします。 明示的に異なる名前を付けるか、または「Unused」という語をプロシージャ名に付けます。

注意: V1では、Procedure Builderによってビルトイン・パッケージと同じ名前のプログラム単位を作成できます。V1より後のバージョンでは、これは許可されません。Procedure Builderは、ビルトイン・パッケージと同じ名前を持つプログラム単位を検出すると、プログラム単位名の末尾に2個のドル記号$$を追加することで、ロード時にプログラム単位の名前を変更します。したがって、DEBUGはDEBUG$$に変更されます。


パッケージのプロシージャ名を一意名に変更する例

  関連項目 	   すべての例

次の例では、まずコンパイラ・エラーを生成するPL/SQL V1コードを示します。 続いてエラーを防ぐ編集例を示します。

次のコードを、

PACKAGE pk1 IS
  v1 NUMBER;           v1は変数として確立されます
  PROCEDURE v1;        v1はプロシージャとしても確立されます
  PROCEDURE p2 (x OUT NUMBER);
END;

PACKAGE BODY pk1 IS
  PROCEDURE v1 IS
  BEGIN
   .. .
  END;

  PROCEDURE p2 (x OUT NUMBER) IS
  BEGIN
x := pk1.v1;
  END;

END;

次のように変換します。

PACKAGE pk1 IS
  v1 NUMBER;
  PROCEDURE v1Unused;	  プロシージャv1はUnusedと宣言されます
  PROCEDURE p2 (x OUT NUMBER);
END;

PACKAGE BODY pk1 IS
  PROCEDURE v1Unused IS
  BEGIN
   .. .
  END;

  PROCEDURE p2 (x OUT NUMBER) IS
  BEGIN
x := pk1.v1;
  END;

END;


標準パッケージ・ファンクションが使用されない場合への対処

  例

PL/SQL V1では、次に示すようにユーザー自身のパッケージp1からファンクションFLOORをコールできました。

v := p1.FLOOR(x).

パッケージp1にファンクションFLOORがないと、PL/SQLは標準パッケージ内のファンクションFLOORを使用していました。これは、PL/SQL V2.3以降では修正されている、PL/SQLコード・エラーです。したがって、PL/SQL V2.3では、コンパイラはそのファンクション名の標準パッケージをチェックしないで、エラーを報告します。

エラー302:コンポーネント'CCCCC'を宣言する必要があります

ここで'CCCCC'は、標準パッケージ・ファンクションまたは標準パッケージ拡張にあるファンクションまたはプロシージャです。

メッセージ "Incorrect references will resolve to built-in package V1" が、ログに書き込まれます。

コンパイラで標準パッケージのファンクションを指定するには、不正なパッケージ名を削除してください。


パッケージ接頭辞の削除例

  関連項目 	   すべての例

次の例では、まずコンパイラ・エラーを生成するPL/SQL V1コードを示します。続いてエラーを防ぐ編集例を示します。

次のコードを、

PACKAGE pk1 IS a NUMBER;
END;

PROCEDURE p IS v NUMBER;
BEGIN
v := pk1.FLOOR(20.5);
END;

次のように変換します。

PACKAGE pk1 IS a NUMBER;
END;

PROCEDURE p IS v NUMBER;
BEGIN
v := FLOOR(20.5);     接頭辞を削除します
END;


PL/SQL V2.3以降における新規予約語

  例

VARIANCEはPL/SQL V2.3以降の予約語なので、この語を使用するとコンパイラ・エラーが発生します。

エラーを生成せずにVARIANCEを使用する方法の詳細は、例を参照してください。


予約語の例

  関連項目 	   すべての例

次の例では、まずコンパイラ・エラーを生成するPL/SQL V1コードを示し、続いてエラーを防ぐ編集例を示します。

例1:

次のコードを、

FUNCTION variance (y IN NUMBER)
RETURN NUMBER IS

BEGIN
     .. .
     RETURN .. .;
END;

次のように変更します。

FUNCTION varianceUniqueName (y IN NUMBER)
          /* Varianceに一意名が付けられます*/
RETURN NUMBER IS

BEGIN
     .. .
     RETURN .. .;
END;

例2:

サブプログラムをコールするときに、次のコードを、

PROCEDURE foo IS
     x NUMBER;
     y NUMBER;
BEGIN
     .. .
     x := variance(someNumber);
END;

次のように変更します。

PROCEDURE foo IS
     x NUMBER;
     y NUMBER;
BEGIN
     .. .
     x := varianceUniqueName(someNumber);
END;


変数の宣言に必要な%ROWTYPEまたは%TYPE

  例

PL/SQL V8コンパイラは、次のような不正な構文に対してエラーを生成します(PL/SQL V2では、この構文は間違って認められてしまいます)。

return variable-expression

procedure (parameter IN <table_name>)

procedure (parameter IN <table_name>.<column_name>)

正しい構文は次のとおりです。

return variable-type

procedure (parameter IN <table_name>%ROWTYPE)

procedure (parameter IN <table_name>.<column_name>%TYPE)

エラーを防ぐために、式のデータ型を使用するか、表の名前に%ROWTYPEを追加するか、列名に%TYPEを追加します。


変数の宣言例

  関連項目 	   すべての例

次の例では、まずコンパイラ・エラーを生成するPL/SQL V2コードを示し、続いてエラーを防ぐ編集例を示しています。

例1:

次のコードを、

FUNCTION return_column RETURN dept.dname IS
. . .

次のように変更します。

FUNCTION return_column RETURN dept.dname%TYPE IS
. . .

次のコードを、

PROCEDURE foo (name IN dept.dname) IS
. . .

次のように変更します。

PROCEDURE foo (name IN dept.dname%TYPE) IS
. . .

例2:

次のコードを、

FUNCTION return_table RETURN dept IS
. . .

次のように変更します。

FUNCTION return_table RETURN dept.%ROWTYPE IS
. . .

次のコードを、

PROCEDURE foo (name IN dept) IS
. . .

次のように変更します。

PROCEDURE foo (name IN dept%ROWTYPE) IS
. . .

例3:

次の例は、例外的に%TYPEを使用できない場合を示しています。

パラメータを宣言する際に、次のコードを、

FUNCTION return_parm (x IN NUMBER)
  RETURN x IS
. . .

次のように変更します。

FUNCTION return_parm (x IN NUMBER)
  RETURN number IS
. . .


「データベース・ライブラリ」ダイアログ・ボックス

「データベース・ライブラリ」ダイアログ・ボックスは、現在データベースに格納されているライブラリを表示します。

ライブラリ	接続しているデータベースで使用可能なライブラリのリスト。アクセス権限があるライブラリのみがリストに表示されます。選択するライブラリの名前をクリックします。


接続しているデータベースで使用可能なライブラリのリストです。アクセス権限があるライブラリのみがリストに表示されます。選択するライブラリの名前をクリックします。


「新規プログラム単位」ダイアログ・ボックス

「新規プログラム単位」ダイアログ・ボックスは、作成するプログラム単位の名前とタイプを指定します。

名前	プログラム単位の名前を入力します。
タイプ	作成するプログラム単位のタイプを指定します。次のタイプを作成できます。
プロシージャ	指定されたアクション・シーケンスを実行するPL/SQLサブプログラム。
ファンクション	アクションの指定されたシーケンスを実行して値を返すPL/SQLサブプログラム。
パッケージ仕様部	他のプログラム単位によって参照できるデータ型およびサブプログラム。
パッケージ本体	パッケージのインプリメンテーション。固有のサブプログラムまたはデータ型が含まれる場合もあります。パッケージが宣言のみによって構成される場合はオプションで使用します。
型仕様部	オブジェクト型またはコレクション・タイプについて、名前、変数（属性）およびメンバー・サブプログラム（メソッド）を宣言します。
型本体	オブジェクト型の型仕様部で定義されたメンバー・メソッド（ファンクションとプロシージャ）のインプリメンテーション。オブジェクト型で指定された各メソッドについて、対応するメソッド本体が存在する必要があります。
注意: タイプ仕様部およびタイプ本体は、Oracle8に接続しているときにのみ使用できます。


プログラム単位の名前を入力します。


作成するプログラム単位のタイプを指定します。


「オープン・ライブラリ」ダイアログ・ボックス

「オープン・ライブラリ」ダイアログ・ボックスは、ファイル・システムまたはデータベースから既存のライブラリをオープンし、インタプリタのOPENコマンドに対するグラフィカル・ユーザー・インタフェースを提供します。

ライブラリ	オープンするライブラリの名前（および位置）を入力します。
参照	「元」フィールドで「ファイル・システム」または「両方」が選択されていると、オペレーティング・システム・ファイルの選択ダイアログ・ボックスが表示されます。「元」フィールドで「データベース」が選択されていると、「データベース・ライブラリ」ダイアログ・ボックスが表示されます。
元	ライブラリが、ファイル・システムとデータベースのどちらに格納されているかを示します。


オープンするライブラリの名前（および位置）を入力します。


「元」フィールドで「ファイル・システム」または「両方」が選択されていると、オペレーティング・システム・ファイルのダイアログ・ボックスが表示されます。「元」フィールドで「データベース」が選択されていると、「データベース・ライブラリ」ダイアログ・ボックスが表示されます。


ライブラリが、ファイル・システムとデータベースのどちらに格納されているかを示します。


「連結ライブラリ」ダイアログ・ボックス

「連結ライブラリ」ダイアログ・ボックスは、現行セッションにライブラリを連結します。

ライブラリ	連結するライブラリの名前（および位置）を入力します。
参照	「元」フィールドで「ファイル・システム」または「両方」が選択されていると、オペレーティング・システム・ファイルの選択ダイアログ・ボックスが表示されます。「元」フィールドで「データベース」が選択されていると、「データベース・ライブラリ」ダイアログ・ボックスが表示されます。
元	ライブラリが、ファイル・システムとデータベースのどちらに格納されているかを示します。
連結	選択を確認してライブラリを連結し、ダイアログ・ボックスをクローズします。


連結するライブラリの名前（および位置）を入力します。


「元」フィールドで「ファイル・システム」または「両方」が選択されていると、オペレーティング・システム・ファイルのダイアログ・ボックスが表示されます。「元」フィールドで「データベース」が選択されていると、「データベース・ライブラリ」ダイアログ・ボックスが表示されます。


ライブラリが、ファイル・システムとデータベースのどちらに格納されているかを示します。


選択を確認してライブラリを連結し、ダイアログ・ボックスをクローズします。


「ログ・インタプリタ」ダイアログ・ボックス

「ログ・インタプリタ」ダイアログ・ボックスは、ログの実行を管理します。

ファイル	ロギング・セッションを記録するファイルの名前を入力します。
参照	オペレーティング・システムの「ファイル」ダイアログ・ボックスが表示されます。このダイアログ・ボックスで、参照を行い、位置または既存ファイルの名前を選択できます。
追加	これを選択すると、APPENDオプションがアクティブになり、現行のログ・セッションが、「ファイル」テキスト・ボックスで指定した既存のログ・ファイルの終わりに追加されます。選択しないと、指定されたファイル内の現行のログ情報はすべて、新しいロギング・セッションにより上書きされます。
使用不可	これを選択すると、DISABLEDオプションがアクティブになり、指定したファイルへのロギングが、再び使用可能にされるまで中断されます。
ログ表示	これを選択すると、「ログ・インタプリタ」ダイアログ・ボックスがアクセプトされる際に「PL/SQLインタプリタ・ログ」ブラウザが表示されます。「インタプリタ・ログ」ブラウザは、「表示」 [image] 「インタプリタ・ログ」を選択しても表示できます。


ロギング・セッションを記録するファイルの名前を入力します。


オペレーティング・システムの「ファイル」ダイアログ・ボックスが表示されます。このダイアログ・ボックスで、参照を行い、位置または既存ファイルの名前を選択できます。


これを選択すると、APPENDオプションがアクティブになり、現行のログ・セッションが、「ファイル」テキスト・ボックスで指定した既存のログ・ファイルの終わりに追加されます。選択しないと、指定されたファイル内の現行のログ情報はすべて、新しいロギング・セッションにより上書きされます。


これを選択すると、DISABLEDオプションがアクティブになり、指定したファイルへのロギングが、再び使用可能にされるまで中断されます。


これを選択すると、「ログ・インタプリタ」ダイアログ・ボックスがアクセプトされる際に「PL/SQLインタプリタ・ログ」ブラウザが表示されます。「インタプリタ・ログ」ブラウザは、「表示」-->「インタプリタ・ログ」を選択しても表示できます。


「PL/SQLインタプリタ・ログ」ブラウザ

「PL/SQLインタプリタ・ログ」ブラウザは、ロギング・セッションで記録されたメッセージを表示します。

使用不可/使用可能	現行のロギング・セッションのアクティブ状態を切り替えます。
オフ	現行のロギング・セッションを終了し、ブラウザをクローズします。
「メッセージ」リスト・ボックス	インタプリタ・ペイン内で入出力レコードを表示する読込み専用のスクロール可能な領域。リスト・ボックスに表示されるテキストを選択およびコピー、検索することができます。


現行のロギング・セッションのアクティブ状態を切り替えます。


現行のロギング・セッションを終了し、ブラウザをクローズします。


インタプリタ・ペイン内で入出力レコードを表示する読込み専用のスクロール可能な領域。リスト・ボックスに表示されるテキストを選択およびコピー、検索することができます。


「接続」ダイアログ・ボックス

「接続」ダイアログ・ボックスは、データベース・インスタンスへの接続を確立します。

ユーザー名	データベースのユーザーIDを入力します。このテキスト・ボックスには、接続文字列をすべて入力できますが、ユーザーのパスワードがエコー表示されます。
パスワード	データベースのパスワードを入力します。パスワードのセキュリティ保護のため、このフィールドでは、エコー表示されません。
データベース	接続を希望するデータベースのデータベース接続文字列を入力します。通常は、次の形式で入力します。
	network_protocol:network_node[:database_name]
	各フィールドはコロン(:)で区切ります。データベースの正しい接続文字列の詳細は、使用しているデータベース管理者に問い合せてください。 ODBCデータ・ソースに接続している場合、構文は次のようになることに注意してください。
	username/password@ODBC:datasource[:dbname] dbnameを指定しないと、現行のODBC接続用データベースが使用されます。
接続	入力した情報を確認し、接続を試行します。データベースへの接続が完了すると、ダイアログ・ボックスはクローズします。データベースへの接続に失敗すると、エラーが発行されます。


データベースのユーザーIDを入力します。このテキスト・ボックスには、接続文字列をすべて入力できますが、ユーザーのパスワードがエコー表示されます。


データベースのパスワードを入力します。パスワードのセキュリティ保護のため、このフィールドでは、エコー表示されません。


接続を希望するデータベースのデータベース接続文字列を入力します。


入力した情報を確認し、接続を試行します。データベースへの接続が完了すると、ダイアログ・ボックスはクローズします。データベースへの接続に失敗すると、エラーが発行されます。


「アクセス権限リスト」ダイアログ・ボックス

「アクセス権限リスト」ダイアログ・ボックスは、現在選択されているライブラリまたはデータベース・サーバー上のストアド・プログラム単位へのアクセス権限の表示と変更が行えます。他のユーザーに対するアクセス権限の付与または取消しを行うためには、ライブラリに対するGRANTアクセスを必要とします。

ユーザー・リスト・ボックス	選択したライブラリまたはストアド・プログラム単位に対して、現在アクセス権限を持つユーザーをリストします。「ユーザー」テキスト・ボックスに入れるには、対象となるユーザー名をクリックします。
ユーザー	選択したライブラリまたはストアド・プログラム単位へのアクセス権限を付与または取り消す対象ユーザー名を入力します。このユーザー名は、現行のデータベースで有効なユーザー名を入力する必要があります。ユーザー名がすでに「ユーザー」リスト・ボックスに表示されている場合は、ユーザー名をクリックします。
追加	ライブラリまたはストアド・プログラム単位にGRANTアクセス権限を付与されているユーザーのリストに、ユーザー名を追加します。
削除	ライブラリまたはストアド・プログラム単位にGRANTアクセス権限を付与されているユーザーのリストから、ユーザー名を削除します。


選択したライブラリに対して、現在アクセス権限を持つユーザーをリストします。「ユーザー」テキスト・ボックスに入れるには、対象となるユーザー名をクリックします。


選択したライブラリへのアクセス権限を付与または取り消す対象ユーザー名を入力します。このユーザー名は、現行のデータベースで有効なユーザー名を入力する必要があります。ユーザー名がすでに「ユーザー」リスト・ボックスに表示されている場合は、ユーザー名をクリックします。


ライブラリに対しGRANTアクセス権限を付与されているユーザーのリストに、ユーザー名を追加します。


ライブラリに対しGRANTアクセス権限を付与されているユーザーのリストから、ユーザー名を削除します。


「ライブラリ保存」ダイアログ・ボックス

「ライブラリ保存」ダイアログ・ボックスは、ライブラリをファイル・システムまたはデータベースに保存し、インタプリタのSAVEコマンドに対するグラフィカル・ユーザー・インタフェースを提供します。

ライブラリ	保存するライブラリの名前（および位置）を入力します。
参照	「先」フィールドで「ファイル・システム」が選択されていると、オペレーティング・システム・ファイルのダイアログ・ボックスを表示します。「先」フィールドで「データベース」が選択されていると、「データベース・ライブラリ」ダイアログ・ボックスを表示します。
先	ライブラリを、ファイル・システムとデータベースのどちらに保存するかを示します。


保存するライブラリの名前（および位置）を入力します。


「先」フィールドで「ファイル・システム」が選択されていると、オペレーティング・システム・ファイルのダイアログ・ボックスを表示します。「先」フィールドで「データベース」が選択されていると、「データベース・ライブラリ」ダイアログ・ボックスを表示します。


ライブラリを、ファイル・システムとデータベースのどちらに保存するかを示します。


「検索と置換」ダイアログ・ボックス

「検索と置換」ダイアログ・ボックスは、プログラム単位エディタまたはストアド・プログラム単位エディタに現在表示されているプログラム単位ソース内の文字列または正規表現の検索と置換に使用します。

検索文字列	検索文字列を入力します。この文字列を正規表現として扱う場合は、「正規表現」チェックボックスをクリックします。
置換文字列	検索結果文字列と置換する文字列を入力します。
正規表現	これがチェックされると、検索文字列を文字列ではなく正規表現として扱うかどうかを指定します。
大/小文字区別	検索文字列の英文字の大文字と小文字を区別して検索するかどうかを示します。このチェックボックスをチェックしない場合、英文字の大小の区別なく、検索文字列に一致するすべての文字列が検索されます。
次を検索	検索文字列の検索を、現在のカーソル位置から開始します。
置換	最新の検索結果文字列を、「置換文字列」テキスト・ボックスで指定した文字列に変更します。その時点で検索結果文字列が選択されていない場合は、検索文字列の次の文字列を検索して置換します。
すべて置換	すべての検索結果文字列を置換文字列に置換します（カーソル位置から検索可能な領域の最後まで）。


検索文字列を入力します。この文字列を正規表現として扱う場合は、「正規表現」チェックボックスをクリックします。


検索結果文字列と置換する文字列を入力します。


検索文字列の英文字の大文字と小文字を区別して検索するかどうかを示します。このチェックボックスをチェックしない場合、英文字の大小の区別なく、検索文字列に一致するすべての文字列が検索されます。


これがチェックされると、検索文字列を文字列ではなく正規表現として扱うかどうかを指定します。


検索文字列の検索を、現在のカーソル位置から開始します。


最新の検索結果文字列を、「置換文字列」テキスト・ボックスで指定した文字列に変更します。その時点で検索結果文字列が選択されていない場合は、検索文字列の次の文字列を検索して置換します。


すべての検索結果文字列を置換文字列に置換します（カーソル位置から検索可能な領域の最後まで）。


「PL/SQLブレークポイント」ダイアログ・ボックス

「PL/SQLブレークポイント」ダイアログ・ボックスは、BREAKコマンドに対するグラフィカル・ユーザー・インタフェースを提供します。これによって、ブレーク・ポイントの作成または変更や、トリガーのブレークができます。

ブレークポイント	ブレーク・ポイントを識別します。 フォームは、「ブレーク・ポイント: 新規作成」または 「ブレーク・ポイント: 番号」です。ラベルの値は、新規のブレーク・ポイントを指定する場合は「新規作成」、既存のブレーク・ポイントを変更する場合は番号です。
使用可能	ブレーク・ポイントが使用可能か使用不可かを示します。
プログラム単位	ブレーク・ポイントが作成されるプログラム単位、既存のブレーク・ポイントの位置または新規ブレーク・ポイントの作成場所を識別します。
行	プログラム単位内のブレーク・ポイントのソース位置を識別します。
トリガー	必要に応じて、ブレーク・ポイントがヒットされたときに起動するPL/SQL文を入力します。BEGINおよびENDの各キーワードはトリガーでは必要ありません。 たとえば、DEBUG.INTERPRETを使用してインタプリタ・コマンドを実行できます。 DEBUG.INTERPRET('.SHOW LOCALS');


ブレーク・ポイントを識別します。フォームは、「ブレーク・ポイント: 新規作成」または 「ブレーク・ポイント: 番号」です。ラベルの値は、新規のブレーク・ポイントを指定する場合は「新規作成」、既存のブレーク・ポイントを変更する場合は番号です。


ブレーク・ポイントが使用可能か使用不可かを示します。


既存のブレーク・ポイントがあるプログラム単位または新規のブレーク・ポイントが作成されるプログラム単位を識別します。


プログラム単位内のブレーク・ポイントのソース位置を識別します。


ブレーク・ポイントがヒットされたときに起動するPL/SQL文を入力します。BEGINおよびENDの各キーワードは必要ありません。


「PL/SQLトリガー」ダイアログ・ボックス

「PL/SQLトリガー」ダイアログ・ボックスは、デバッグ・トリガーを作成し、TRIGGERコマンドに対するグラフィカル・ユーザー・インタフェースを提供します。

トリガー	デバッグ・トリガーを識別します。 フォームは、「トリガー: 新規作成」または ｢トリガー: 番号」です。新しいデバッグ・トリガーを指定するときのラベル値は「新規作成」であり、既存のデバッグ・トリガーを変更するときは番号です。
使用可能	デバッグ・トリガーが使用可能か使用不可かを示します。
場所	デバッグ・トリガーのソース位置を指定します。
	「プログラム単位」オプション（デフォルト）は、デバッグ・トリガーがプログラム単位内の特定のソース位置に置かれていることを示します。
	「デバッグ・エントリ」オプションは、トリガーがプログラム単位の実行停止と同時に起動することを示します。
	「ステートメント毎」オプションは、デバッグ・トリガーがプログラム単位内のすべての実行可能文の直前で起動することを示します。
プログラム単位	目的のプログラム単位を識別します。
行	プログラム単位内のデバッグ・トリガーのソース位置を識別します。
トリガー本体	デバッグ・トリガー本体に使用されるPL/SQL文を入力します。BEGINおよびENDの各キーワードは必要ありません。 デバッグ・トリガーは条件付きのブレーク・トリガーのように動作します。デバッグ・アクションが必要な場合について条件を指定する場合、その条件が真のときのみトリガーが起動します。   たとえば、変数が特定の値（100など）に等しい場合、DEBUG.BREAKをコールすることができます。 IF DEBUG.GETC('vnumber') = 100 THEN   RAISE DEBUG.BREAK; END IF;


デバッグ・トリガーを識別します。 フォームは、「トリガー: 新規作成」または｢トリガー: 番号」です。新しいデバッグ・トリガーを指定するときのラベル値は「新規作成」であり、既存のデバッグ・トリガーを変更するときは番号です。


デバッグ・トリガーが使用可能か使用不可かを示します。


デバッグ・トリガーのソース位置を指定します。


目的のプログラム単位を識別します。


プログラム単位内のデバッグ・トリガーのソース位置を識別します。


デバッグ・トリガー本体に使用されるPL/SQL文を入力します。


「PL/SQLステップ」ダイアログ・ボックス

「PL/SQLステップ」ダイアログ・ボックスではインタプリタのSTEPコマンドに対するグラフィカル・ユーザー・インタフェースが提供されており、デバッグ中に一時停止されたプログラム単位のコードを1行ずつ実行するオプションを設定できます。

モード	使用するステップ・オプションを指定します。
	「ステップ・イン（INTO）」は、実行を再開して、次の実行可能文まで続けます。
	「ステップ・オーバー（OVER）」は、実行を再開して、サブプログラムのコールをすべてスキップして、現行のプログラム単位内の次の実行可能文まで続けます。
	「ステップ・アウト（OUT）」は、ネストされたサブプログラムの実行を再開し、コール中のプログラム単位内の次の実行可能文の前で処理を停止します。
	「指定先へ（STEP TO）」は、実行を再開して、指定した位置に到達するまで続けます。
プログラム単位	「指定先へ（STEP TO）」コマンド・オプションのターゲット・プログラム単位本体を識別します。
行	「指定先へ（STEP TO）」コマンド・オプションのターゲット・プログラム単位本体内の位置を識別します。
カウント	STEPコマンドを繰り返す回数を指定します。カウントのデフォルト値は、1です。
適用	指定したオプションを受け入れ、それに従ってプログラム単位の実行を再開します。ステップ操作は通常1つずつ繰り返されるため、「ステップ」ダイアログ・ボックスは、ユーザーが明示的にクローズするまで、またはアクティブなデバッグ・レベルがあるかぎり、表示されたままです。


使用するステップ・オプションを指定します。


「指定先へ」コマンド・オプションのターゲット・プログラム単位本体を識別します。


｢指定先へ｣コマンド・オプションのターゲット・プログラム単位本体内の位置を識別します。


STEPコマンドを繰り返す回数を指定します。カウントのデフォルト値は、1です。


指定したオプションを受け入れ、それに従ってプログラム単位の実行を再開します。ステップ操作は通常1つずつ繰り返されるため、「ステップ」ダイアログ・ボックスは、ユーザーが明示的にクローズするまで、またはアクティブなデバッグ・レベルがあるかぎり、表示されたままです。


「プログラム単位のロード」ダイアログ・ボックス

「プログラム単位のロード」ダイアログ・ボックスは、ファイル・システム上に格納されたプログラム単位のインポートとコンパイルが可能であり、インタプリタのLOADコマンドに対するグラフィカル・ユーザー・インタフェースを提供します。

ファイル	プログラム単位ソース・テキストを含むファイルの名前（および位置）を入力します。
参照	オペレーティング・システム・ファイルのダイアログ・ボックスを表示します。
確認の抑止	既存のプログラム単位を上書きする際などに、ロードおよびコンパイル時のすべての確認メッセージを抑止します。デフォルトは使用不可であり、確認メッセージは抑止されません。
ロード	選択を確認してプログラム単位をロードし、ダイアログ・ボックスをクローズします。


プログラム単位ソース・テキストを含むファイルの名前（および位置）を入力します。


オペレーティング・システム・ファイルのダイアログ・ボックスを表示します。


既存のプログラム単位を上書きする際などに、ロードおよびコンパイル時のすべての確認メッセージを抑止します。デフォルトは使用不可であり、確認メッセージは抑止されません。


選択を確認してプログラム単位をロードし、ダイアログ・ボックスをクローズします。


「インタプリタ・デバッグ・スクリプト」ダイアログ・ボックス

「インタプリタ・デバッグ・スクリプト」ダイアログ・ボックスは、インタプリタ・コマンド、PL/SQLソースまたはSQL文の組合せが入ったスクリプトのインポートと実行が可能であり、INTERPRETコマンドに対するグラフィカル・ユーザー・インタフェースを提供します。

ファイル	解釈されるデバッグ・スクリプトを含むファイルの名前（および位置）を入力します。
参照	オペレーティング・システム・ファイルのダイアログ・ボックスを表示します。
エコー	エコー・モードを使用可能または使用不可にします。デフォルトは使用不可です。 したがって、スクリプトがロードされたとき、スクリプトの各行はインタプリタ・コマンド・ラインにエコー表示されません。
サイレント	サイレント・モードを使用可能または使用不可にします。デフォルトは使用不可です。 したがって、スクリプトのロード中、状態メッセージは表示されます。
確認の抑止	既存のプログラム単位を上書きする際などに、操作時のすべての確認メッセージを抑止します。デフォルトは使用不可であり、確認メッセージは抑止されません。
インタプリタ	選択を確認してスクリプトを実行し、ダイアログ・ボックスをクローズします。


解釈されるデバッグ・スクリプトを含むファイルの名前（および位置）を入力します。


オペレーティング・システム・ファイルのダイアログ・ボックスを表示します。


エコー・モードを使用可能または使用不可にします。デフォルトは使用不可です。 したがって、スクリプトがロードされたとき、スクリプトの各行はインタプリタ・コマンド・ラインにエコー表示されません。


サイレント・モードを使用可能または使用不可にします。デフォルトは使用不可です。 したがって、スクリプトのロード中、状態メッセージは表示されます。


既存のプログラム単位を上書きする際などに、操作時のすべての確認を抑止します。デフォルトは使用不可であり、確認メッセージは抑止されません。


選択を確認してスクリプトを実行し、ダイアログ・ボックスをクローズします。


「コンパイル」ダイアログ・ボックス

「コンパイル」ダイアログ・ボックスは、バッチ・コンパイル中にコンパイル・エラー・メッセージを表示します。 このダイアログ・ボックスで、コンパイルの中断と再開、およびエラー・ソースへのナビゲートが行えます。

ステータス行	プログラム単位のコンパイルの際、コンパイル中のプログラム単位の名前とタイプおよびコンパイルの終了したプログラム単位の割合などの情報を表示します。
	現在コンパイルされているプログラム単位の名前とタイプ。
	「割込み」をクリックした場合、[INTERRUPTED]を表示。
	コンパイルされたプログラム単位の割合。
コンパイル・エラー・リスト・ボックス	選択されたプログラム単位のコンパイル時のエラーを表示する、スクロール可能でマウス操作可能な領域。 コンパイル・エラー・リスト・ボックス内のエラーをクリックすると、プログラム単位エディタおよびエラーが特定されたプログラム単位が表示されます。 コンパイルの割込み状態のときに（「割込み」をクリックした結果）、コンパイル・エラー・リスト・ボックス内のエラーをクリックした場合、「今エラー処理に移ると、残りのコンパイル操作が停止します」という警告のメッセージが表示されます。
割込み	エラーが生成されすぎる場合などに、コンパイルを一時的に中止します。
再開	割込み後、コンパイルを再開します。
エラーへジャンプ	最初のエラーが位置しているプログラム単位ソースが含まれたプログラム単位エディタを表示します。 コンパイルの割込み状態のときに（「割込み」をクリックした結果）、コンパイル・エラー・リスト・ボックス内のエラーをクリックした場合、エラーのソースに移動するとバッチ・コンパイルが終了するという警告のメッセージが表示されます。 また、「PL/SQLコンパイル・メッセージ」ダイアログ・ボックスも表示されます。これは、選択されたプログラム単位のコンパイル時のエラーをすべて参照できる、スクロール可能でマウス操作可能なリスト・ボックスです。リスト・ボックス内でエラーをクリックすると、プログラム単位エディタおよびエラーが特定されたプログラム単位が表示されます。

エラーが検出されずにコンパイルが終了した場合、ステータス行に「コンパイルは正常終了しました」というメッセージが表示されます。コンパイル時にエラーが検出されて終了した場合は、「コンパイルは終了しましたが、エラーがあります」というメッセージが表示されます。

「PL/SQLコンパイル・メッセージ」ダイアログ・ボックスは、選択されたプログラム単位のコンパイル時のエラーをすべて参照できる、スクロール可能でマウス操作可能なリスト・ボックスです。リスト・ボックス内でエラーをクリックすると、プログラム単位エディタおよびエラーが特定されたプログラム単位が表示されます。


プログラム単位のコンパイルの際、コンパイル中のプログラム単位の名前とタイプおよびコンパイルの終了したプログラム単位の割合などの情報を表示します。


エラーが生成されすぎる場合などに、コンパイルを一時的に中止します。「割込み」をクリックすると、ステータス行に[INTERRUPTED]が表示されます。


割込み後、コンパイルを再開します。


「PL/SQLコンパイル・メッセージ」ブラウザを提示し、最初のエラーの位置でプログラム単位ソースが含まれたプログラム単位エディタを表示します。


正規表現

正規表現は、次の特殊なワイルドカード文字のいずれかを含むことができる文字列です。

.	任意の1文字を検索します。たとえば、.heでは、theとsheの両方が検索されます。
( )	デフォルトの優先順位が望ましくない場合、演算子（たとえば、+）の優先順位を強制するために使用します。たとえば、連結文字（theなど）は、他の+などの演算子より優先されます。したがって、the+Aは(the)+Aと等価です。また、theeeeeeAを検索する際、カッコを使ってth(e+)Aのようにすると、+が連結文字より優先されます。
[ ]	大カッコ内の任意の1文字を検索します。大カッコは論理OR演算子です。たとえば、t[hr]eでは、otherのtheおよびtrendのtreが検索されます。
|	2つの正規表現の間に使用します。どちらかの正規表現に一致するものが検索されます。
\	円マークの後の特殊文字を検索します。たとえば、\*は*が検索されます。円マークは、エスケープ文字です。円マークの次の特殊文字は、特殊文字として扱われません。 次に、エスケープ文字の特殊な使用方法を示します。
	\nは、改行文字を検索します。
	\tは、タブ文字を検索します。
	\bは、ブランク文字を検索します。
	\wは、\n、\t、\bまたは\0を検索します。
*	正規表現の0個以上のインスタンスを検索します。たとえば、(the)*Aでは、 AおよびtheA、thetheAが検索されます。
+	正規表現の1つ以上のインスタンスを検索します。たとえば、(the)+Aでは、theAおよびthetheAの両方が検索されますが、(the)*Aの場合とは異なりAは検索されません。
これらの文字が大カッコに囲まれている場合、特殊な意味を持ちます。

~	最初の文字に使用すると、大カッコ内の文字または範囲にない文字を検索します。たとえば、t[~hr]eでは、toeは検索されますがtheは検索されません。
-	文字の組の間にある場合、その範囲のすべての文字を検索します。たとえば、[A-E]では、文字AおよびB、C、D、Eが検索されます。文字範囲の組は、次のどちらでもかまいません。
	• アルファベット順にみて、最初の文字が2番目の文字より前にある（または同一の文字である）、同じケースのアルファベット。
	• 最初の数字が2番目の数字以下（たとえば、[4-9]または[0-3]）である数字。
	大カッコ内でエスケープ文字を使用することもできます。
ルール: 正規表現の特殊文字の優先順序は、( )、[ ]、連結文字（たとえば、abc）、*、+、~、 、|、.です。

次に、優先順位がわかるようにいくつかの例を示します。

•	Start|Finishは、(Start)|(Finish)と等価です。

•	Start*は、(Start)*と等価です。

•	Start|Finish*は、(Start)|((Finish)*)と等価です。


「PL/SQL表要素選択」ダイアログ・ボックス

「PL/SQL表要素選択」ダイアログ・ボックスには選択された表内の行に対する索引が入っています。 このダイアログ・ボックスを使用し、オブジェクト・ナビゲータで確認したい行を最大に拡大して選択できます。

レコード索引リストボックス	表内のすべての行の索引のリストが入った、スクロール可能なマウス専用の領域。
すべて選択	表内の要素をすべて選択します。
すべて選択解除	表内の要素をすべて選択解除します。
デフォルトでは、すべての索引が選択されます。[Ctrl]キーを押しながらリスト内の選択した項目をクリックして個々の選択を解除します。


「プログラム単位内の検索と置換」ダイアログ・ボックス

「プログラム単位内の検索と置換」ダイアログ・ボックスでは、複数のプログラム単位に渡って、検索と置換を実行できます。

検索文字列	検索文字列を入力します。   文字列を正規表現として扱う場合は、「正規表現を使う」チェックボックスをチェックします。
正規表現	検索条件に使用できる正規表現のリストを表示します。表現をクリックすると、「検索文字列」ボックスに挿入されます。
置換文字列	検索文字列を置換するための文字列を入力します。
正規表現を使う	検索条件に正規表現を使用する場合は、このボックスをチェックします。 検索条件に正規表現を使用しない場合は、このボックスのチェックを外します。
大/小文字を区別	検索文字列の英文字の大文字と小文字を区別して検索する場合は、このボックスをチェックします。 英文字の大小の区別なく、検索文字列に一致するすべての文字列を検索する場合は、このボックスのチェックを外します。
検索する場所	検索または検索/置換を実行する場所を指定します。 スタンドアロンのProcedure Builderでは、「/」はオブジェクト・ナビゲータの1番上のプログラム単位ノードを表します。現行のセッションでオープンしているすべてのPL/SQLライブラリが、「/」の下にリストされます。   すべてのノードがデフォルトで選択されます。特定のノードのみを検索したい場合は、そのノードをクリックします。
すべて検索	指定した検索文字列に一致するすべての文字列を検索します。置換は行われません。
すべて置換	検索文字列に一致するすべての文字列を、指定の置換文字列に置換します。一括置換を行う場合は、操作の確認を求めるメッセージ・ボックスが表示されます。
クローズ	ダイアログ・ボックスをクローズします。
ヘルプ	ヘルプ・トピックを表示します。
「結果」リスト・ボックス	検索結果文字列が表示されます。検索結果文字列の場所は、ノード、プログラム単位の名前、ソースの行数と列数で示されます。 リスト・ボックスの上にあるステータス・バーには、検索または置換された文字列の数が表示されます。 検索結果文字列を編集または置換するために選択するには、その文字列をクリックします。複数の検索結果文字列を選択できます。
置換	「結果」リスト・ボックスで選択した検索結果文字列のみを対象に、検索文字列を置換文字列に置換します。
編集	選択した検索結果文字列のソースをプログラム単位エディタでオープンします。


プログラム単位エディタのインタフェース

  関連項目

プログラム単位エディタに含まれるボタンおよびドロップダウン・リスト・ボックスは次のとおりです。

コンパイル	現行のプログラム単位をコンパイルします。コンパイルの結果生成されたエラー・メッセージは、スクロール可能なコンパイル・メッセージ・ペインに表示されます。
適用	エディタが最初にオープンされてから、あるいは最後の適用操作または変更の破棄の操作が行われてから、エディタのプログラム単位に加えられた変更を保存します。プログラム単位は再コンパイルされません。エディタはクローズしません。元に戻すスタックまたは再実行スタックは消去されます。
変更の破棄	最後の適用操作または変更の破棄操作を行ったときの状態に、プログラム単位を戻します。適用操作または変更の破棄操作が行われなかった場合、プログラム単位は元の状態に戻ります。
作成	「新規プログラム単位」ダイアログ・ボックスを表示します。このダイアログ・ボックスで、作成するプログラム単位のタイプと名前を指定できます。
削除	現行のプログラム単位を削除します。操作の確認を求めるメッセージ・ボックスが表示されます。
クローズ	プログラム単位エディタをクローズします。
ヘルプ	このヘルプ・トピックが表示されます。
名前	現行のプログラム単位の名前を表示します。現行セッションにあるその他の既存プログラム単位のドロップダウン・リストを表示するには、フィールドの右にある矢印をクリックします。ソース・ペインにプログラム単位を表示するには、このリストで表示するプログラム単位をクリックします。

この他に、エディタは次の要素で構成されています。

ソース・ペイン	PL/SQLプログラム単位ソース・テキストを入力および編集する領域。 分割バーを使用すると、現行のプログラム単位について、異なるビューを4つまで作成できます。各ビューは、個別にスクロールできます。   ソース・ペイン内に水平なビューを作成するには、垂直スクロール・バーの最上部にある分割バーにカーソルを置き、ダブルクリックします。これによってソース・ペインが2つの均等なビューに水平に分割されます。また、分割バーをクリックし、希望のビュー・サイズになるまでドラッグして調整することもできます。  垂直なビューを作成するには、水平スクロール・バーの左端にある分割バーにカーソルを置き、ダブルクリックします。これによってソース・ペインが2つの均等なビューに垂直に分割されます。また、分割バーをクリックし、希望のビュー・サイズになるまでドラッグして調整することもできます。 ビューのサイズを変更するには、ビューを分割している分割バーをクリックし、ドラッグします。 水平または垂直なビューを削除するには、ビューを分割している分割バーをダブルクリックするか、ペインの端までドラッグします。 4つのビューを一度にすべて削除するには、境界バーが交差する部分にカーソルを置いてダブルクリックするか、交差する部分をペインの任意の隅までドラッグします。 コード行を選択するには、左マージンにカーソルを置いて、クリックします。
コンパイル・メッセージ・ペイン	コンパイルの結果生成されたエラー・メッセージがあれば表示します。エラー・メッセージをクリックすると強調表示され、問題のソース文までソース・ペインをスクロールし、エラーの位置にテキスト・カーソルが置かれます。 デフォルトでは、コンパイル時にコンパイル・エラー・メッセージが生成された場合にだけ、コンパイル・メッセージ・ペインが表示されます。 コンパイル・メッセージ・ペインを必要なときに手動で表示するには、カーソルの形状が十字線になるまで、カーソルをエディタ・ウィンドウの右下隅に移動します。次に、マウスを1回クリックし、カーソルを上にドラッグします。これによって分割バーが上に移動し、その下にコンパイル・メッセージ・ペインが表示されます。
分割バー （ペインの分割）	ソース・ペインとコンパイル・メッセージ・ペインを分割します。これによって、ペインの相対サイズを変更できます。ペインのサイズを変更するには、分割バーをクリックして、ドラッグします。 コンパイル・メッセージ・ペインが表示されない場合は、分割バーがエディタ・ウィンドウの底部にあります。
ステータス・バー	エディタの1番下に、プログラム単位の現行の状態に関する情報を表示します。


「ソース」ペインに表示されるプログラム単位をコンパイルします。コンパイルの結果生成されたエラー・メッセージは、スクロール可能なコンパイル・メッセージ・ペインに表示されます。


エディタが最初にオープンされてから、あるいは最後の適用操作または変更の破棄操作が行われてから、エディタでプログラム単位に加えられた変更を保存します。プログラム単位は再コンパイルされません。エディタはクローズしません。


最後の適用操作または変更の破棄操作を行ったときの状態に、プログラム単位を戻します。適用操作または変更の破棄操作が行われなかった場合、プログラム単位は元の状態に戻ります。


「新規プログラム単位」ダイアログ・ボックスを表示します。このダイアログ・ボックスで、作成するプログラム単位のタイプと名前を指定できます。


表示されているプログラム単位を削除します。


エディタをクローズしようとします。変更後、変更内容が適用されていない場合、メッセージ・ボックスが表示され、変更内容を適用または破棄するか、あるいは操作を取り消すように求められます。変更内容がすべて適用または破棄されると、プログラム単位エディタはクローズします。


現在エディタに表示されている、プログラム単位のタイプ（トリガー、プロシージャなど）を指定します。


プログラムがどのオブジェクトに関連付けられているかを指定します。


現行のプログラム単位の名前を表示します。その他の既存プログラム単位のドロップダウン・リストを表示するには、フィールドの右にある矢印をクリックします。エディタにプログラム単位を表示するには、このリストで表示するプログラム単位をクリックします。


PL/SQLプログラム単位のソース・テキストの入力と編集を行います。


コンパイル中に発見された構文エラーを表示します。プログラム単位内のエラー元の位置に進むには、エラーをクリックします。


プログラム単位エディタの2つのペイン（ソース・ペインとコンパイル・メッセージ・ペイン）領域の相対量を変更できます。デフォルトでは、コンパイル・メッセージ・ペインは、コンパイル中にエラー・メッセージが生成された場合にのみ表示されることに注意してください。


ステータス・バーの右側に次のメッセージが表示されます。

変更されていません。	プログラム単位が最初に表示または最後に適用されてから加えられた変更はありません。
変更されました。	プログラム単位が最初に表示または最後に適用されてから1つ以上の変更が加えられています。

ステータス・バーの右側に次のメッセージが表示されます。

コンパイルされていません。	現在表示されているプログラム単位のソース・テキストは、コンパイルされていません。
コンパイルは成功しました。	現在表示されているプログラム単位のソース・テキストは、エラーなくコンパイルされました。
コンパイル･エラーがあります。	現在表示されているプログラム単位のソース・テキストは、コンパイル中にエラーが発生しました。エラーは、コンパイル・メッセージ・ペインに表示されます。


「PL/SQL V1の変換オプション」ダイアログ・ボックス

サポートされているPL/SQL V1またはV2構文の各タイプのエラーが発生した場合、「PL/SQL V1の変換オプション」ダイアログ・ボックスを使用して、ユーティリティが取るべき処置をコントロールします。作業環境は変換ユーティリティの複数回の起動に渡って、Windows95/NTレジストリまたはUNIXプロファイルのどちらにも保存されます。

問題のタイプ	変換ユーティリティでサポートされるPL/SQL V1またはV2構文タイプの状態リスト。 CHARをVARCHAR2に置換 VARCHAR2に必要な文字列の長さを設定 OUTおよびIN OUTのデフォルト式を削除 式に必須なRETURN文 廃止されたビルトインの置換 ファンクションlengthはゼロ長の文字列に対しNULLを返す NULLを渡すオーバーロードしたサブプログラムへの対処 ファンクションにRETURN文を指定しないとランタイム・エラーが発生する
変換	選択された問題のすべてのインスタンスが、確認の指示なしに自動的に変換されます。
すべて変換	変換するすべての問題のタイプを設定するための迅速なパス。ユーティリティは、確認の指示なしにすべてのPL/SQL V1またはV2を自動的に変換します。
スキップ	問題のタイプが選択されると、問題のすべてのインスタンスが無視されます。コンパイラ・エラーを避けるには、手動でV1またはV2コードを修正する必要があります。
すべて無視	無視するすべての問題のタイプを設定するための迅速なパス。ユーティリティは、すべての問題のタイプを無視し、どんな変換も実行しません。コンパイラ・エラーを避けるには、手動でV1またはV2コードを修正する必要があります。
確認	選択された問題のタイプについて、各インスタンスを別々に「変換」ダイアログ・ボックスに表示します。ダイアログ・ボックスから、「変換」または「無視」のどちらでも選択できます。
すべて確認	すべての問題タイプを「確認」に設定するための迅速なパス。ユーティリティは、PL/SQL V1またはV2文字列を変換する前に、（「変換」ダイアログ･ボックスで）確認を行うように指示します。
OK	選択したものを確認し、ダイアログ・ボックスをクローズします。
取消し	モジュールへのすべての変更を取り消し、ダイアログ・ボックスをクローズします。


「変換」ダイアログ・ボックス

「変換」ダイアログ・ボックスで、PL/SQL V1またはV2の変換プロセスを対話式にコントロールできます。以下に示した変換のためのオプションを設定するには、「オプション」をクリックしてください。

ソース・ペイン	変換条件が検出されるプログラム単位ソースを表示します。変換される構文は強調表示されます。このペイン内でスクロール・アップまたはダウンを行い、それまでに完成された変換をレビューできます。
条件:	変換を必要とするPL/SQL V1またはV2文。
処置:	「変換」をクリックしたときに、変換ユーティリティが行うこと。
説明. . .	問題の詳細と、変換を無視した場合に起こることについて表示します。
変換	推奨されるデフォルト動作を受け入れ、次の文に移動します。
すべて変換	モジュール全体にわたり、すべてのPL/SQL V1またはV2構文の問題を変換します。このモジュールは、複数のユニットを持つ場合があります。すべてのデフォルト動作が受け入れられます。
スキップ	「問題」フィールドに記述されるPL/SQL V1またはV2文を変換せずに、次の文へ移動します。
すべて無視	モジュール全体についての変換を回避します。このモジュールは、複数のプログラム単位を持つ場合があります。
オプション. . .	変換プロセスを制御するオプションを指定できる「PL/SQL V1の変換オプション」ダイアログ・ボックスを表示します。


「PL/SQL V1の変換サマリー」ダイアログ・ボックス

「PL/SQL V1の変換サマリー」ダイアログ・ボックスによって、次の情報を入手できます。

•	正常に変換されたソース行

•	無視されたソース行

•	PL/SQLコンパイラ・エラーを生成したソース行

ツールバー・ボタン:

Xアイコン	ダイアログ・ボックスをクローズします。
?アイコン	ダイアログ・ボックスのヘルプを表示します。
サマリー・ペイン:

検索	拡張および縮小ノードのどちらにも標準検索機能を提供します。
ノード	モジュールの各プログラム単位のためのもの。ノードがプラス記号を含む場合は、それをクリックすると、変換または無視されたもの（およびその方法）についてのサマリーを表示します。ノードが空（プラス記号もマイナス記号もない）の場合は、プログラム単位は変換を必要としません。 コンパイラ・エラーをアドレスする、または変換されたソースや無視したアイテムをレビューするには、拡張されたノードにある行をダブル・クリックします。（または行を選択し、「プログラム」 [image] 「プログラム単位エディタ」を選択します。）エディタは、選択された行のカーソル位置でオープンします。 注意: プログラム単位エディタを使用してソースを変更した後では、次回に行をダブル・クリックするか、または「編集」ボタンを使用すると、カーソルがあるべき位置にないことがあります。
メニュー・アイテム:

プログラム・メニューには次の2つのオプションがあります。

プログラム単位エディタ	プログラム単位エディタでソースをオープンします。カーソルは選択した行に置かれます。
変換オプション	「PL/SQL V1の変換オプション」ダイアログ・ボックスを表示するので、指定したオプションをビューまたは修正できます。
ポップアップ・メニュー:

マウス右ボタンをクリックして、ポップアップ・メニューを表示します。

編集	プログラム単位エディタでソースをオープンします。カーソルは選択した行に置かれます。
説明	選択された行に要求される変換のタイプについてのオンライン・ヘルプを表示します。


ストアド・プログラム単位エディタのインタフェース

  関連項目

ストアド・プログラム単位エディタに含まれるボタンおよびドロップダウン・リスト・ボックスは次のとおりです。

作成	「新規プログラム単位」ダイアログ・ボックスを表示します。このダイアログ・ボックスで、作成するストアド・プログラム単位のタイプと名前を指定できます。
保存	現行のストアド・プログラム単位をコンパイルします。コンパイルの結果生成されたエラー・メッセージは、スクロール可能なコンパイル・メッセージ・ペインに表示されます。元に戻すスタックまたは再実行スタックは消去されます。
変更の破棄	最後の保存操作または変更の破棄操作を行ったときの状態に、ストアド・プログラム単位を戻します。保存操作または変更の破棄操作が行われなかった場合、プログラム単位は元の状態に戻ります。
削除	データベースから、現行のストアド・プログラム単位を削除します。操作の確認を求めるメッセージ・ボックスが表示されます。
クローズ	ストアド・プログラム単位エディタをクローズします。
ヘルプ	このヘルプ・トピックが表示されます。
所有者	現行のプログラム単位の所有者の、データベース・ユーザーIDを表示します。このボックスの右向きの矢印キーをクリックし、アクセス権限のある、ユーザー名のドロップダウン・リストを表示します。所有者リストには、自分がアクセス権限を持っているストアド・プログラムの所有ユーザーの名前のみが表示されます。
名前	現行のストアド・プログラム単位の名前を表示します。「所有者」フィールドに示されたユーザーIDによって所有されるストアド・プログラム単位のドロップダウン・リストを表示するには、このボックスの右にある矢印をクリックします。「名前」リストには、アクセス権限を付与されたストアド・プログラム単位の名前のみが表示されます。

この他に、エディタは次の要素で構成されています。

ソース・ペイン	PL/SQLプログラム単位ソース・テキストを入力および編集する領域。   分割バーを使用すると、現行のプログラム単位について、異なるビューを4つまで作成できます。各ビューは、個別にスクロールできます。   ソース・ペイン内に水平なビューを作成するには、垂直スクロール・バーの最上部にある分割バーにカーソルを置き、ダブルクリックします。これによってソース・ペインが2つの均等なビューに水平に分割されます。また、分割バーをクリックし、希望のビュー・サイズになるまでドラッグして調整することもできます。  垂直なビューを作成するには、水平スクロール・バーの左端にある分割バーにカーソルを置き、ダブルクリックします。これによってソース・ペインが2つの均等なビューに垂直に分割されます。また、分割バーをクリックし、希望のビュー・サイズになるまでドラッグして調整することもできます。 ビューのサイズを変更するには、ビューを分割している分割バーをクリックし、ドラッグします。 水平または垂直なビューを削除するには、ビューを分割している分割バーをダブルクリックするか、ペインの端までドラッグします。 4つのビューを一度にすべて削除するには、境界バーが交差する部分にカーソルを置いてダブルクリックするか、交差する部分をペインの任意の隅までドラッグします。 コード行を選択するには、左マージンにカーソルを置いて、クリックします。
コンパイル・メッセージ・ペイン	コンパイルの結果生成されたエラー・メッセージがあれば表示します。エラー・メッセージをクリックすると強調表示され、問題のソース文までソース・ペインをスクロールし、エラーの位置にテキスト・カーソルが置かれます。 デフォルトでは、コンパイル時にコンパイル・エラー・メッセージが生成された場合にのみ、コンパイル・メッセージ・ペインが表示されます。 コンパイル・メッセージ・ペインを必要なときに手動で表示するには、カーソルの形状が十字線になるまで、カーソルをエディタ・ウィンドウの右下隅に移動します。次に、マウスを1回クリックし、カーソルを上にドラッグします。これによって分割バーが上に移動し、その下にコンパイル・メッセージ・ペインが表示されます。
分割バー	ソース・ペインとコンパイル・メッセージ・ペインを分割します。これによって、ペインの相対サイズを変更できます。ペインのサイズを変更するには、分割バーをクリックして、ドラッグします。 コンパイル・メッセージ・ペインが表示されない場合は、分割バーがエディタ・ウィンドウの底部にあります。
ステータス・バー	エディタの一番下に、ストアド・プログラム単位の現行の状態に関する情報を表示します。


「新規プログラム単位」ダイアログ・ボックスを表示します。このダイアログ・ボックスで、作成するプログラム単位のタイプと名前を指定できます。


ソース・ペインに表示されるストアド・プログラム単位をコンパイルします。コンパイルの結果生成されたエラー・メッセージは、スクロール可能なコンパイル・メッセージ・ペインに表示されます。


最後の保存操作または変更の破棄操作を行ったときの状態に、ストアド・プログラム単位を戻します。保存操作または変更の破棄操作が行われなかった場合、プログラム単位は元の状態に戻ります。


現行のストアド・プログラム単位を削除します。削除する場合には、確認を行います。


現行のプログラム単位の所有者の、データベース・ユーザーIDを表示します。このフィールドの右向きの矢印キーをクリックし、アクセス権限のある、ユーザー名のドロップダウン・リストを表示します。


現行のストアド・プログラム単位の名前を表示します。「所有者」フィールドに示されたユーザーIDによって所有されるストアド・プログラム単位のドロップダウン・リストを表示するには、このフィールドの右にある矢印をクリックします。「名前」リストには、アクセス権限を付与されたストアド・プログラム単位の名前のみが表示されます。


PL/SQLストアド・プログラム単位のソース・テキストを、入力および編集するために使用されます。


コンパイル中に発見された構文エラーを表示します。プログラム単位内のエラー元の位置へナビゲートするには、エラーをクリックします。


ストアド・プログラム単位エディタの2つのペイン領域の相対量を変更できます。デフォルトでは、コンパイル・メッセージ・ペインは、コンパイル中にエラー・メッセージが生成された場合にのみ表示されることに注意してください。


バージョン制御について - PVCS

  関連項目

バージョン制御とは、アーカイブ内の同じファイルの複数のバージョンを管理、メンテナンスするプロセスです。

アーカイブはユーザー定義のディレクトリで、ファイルのテキスト版と、そのファイルに加えられたすべての変更と変更日時の記述を含む、各バージョンの情報が収められています。

アーカイブを使用すると、開発チームのメンバーは、安全かつ首尾一貫した方法でファイルの任意のバージョンを検索し、変更した後、戻すことができます。

Form Builderなどのコンポーネントは、汎用的なインタフェースを経由して、任意のソース制御プロバイダにソース制御の機能を提供します。プラグイン・モジュールは、現在INTERSOLV社のPVCS(Polytron Version Control System)やPure-Atria社のClearcase、その他将来リリースされる製品で利用可能です。

PVCSのインストールと使用方法の詳細は、PVCSのマニュアルを参照してください。

PVCSではファイル・ロックとアーカイブ・レポートもサポートしています。


構成ファイルについて

ソース制御インタフェースの最適なパフォーマンスを得るために設定する必要がある4つの環境変数があります。これらの環境変数は、Windows 3.1では、oracle.iniで設定され、Windows NTまたはWindows 95/98では、レジストリのSOFTWARE/ORACLEキーで設定されます。

DEV2000_SOURCECONTROLは、使用するソース制御システムを指定します。これは、"PVCS"に設定する必要があります。Form Builderなどのコンポーネントは、デフォルトでPVCSを使用するため、この変数を省略すると、このリリースでは大きな効果を得ることはできません。ただし、その他のソース制御システムのサポートを追加している場合は、この変数を設定することにより、そのソース制御システムの機能を期待どおり確実に利用することができます。

DEV2000_PROJECTは、Forms Developerリリース1.0および1.1からTVCCFG変数を置き換え、使用する必要があるPVCSプロジェクト構成(.CFG)ファイルを識別します。環境変数を使用してプロジェクト構成ファイルを指定しない場合は、セッションごとに、「ソース制御オプション」ダイアログ・ボックスからプロジェクト構成ファイルを選択する必要があります。

DEV2000_SCVIEWERは、ソース制御のログやレポート操作の違いの結果を表示するために使用するプログラムを制御します。結果の表示を無効にするには、この変数をnull(値なし)に設定します。

DEV2000_SCCONVERTは、ファイルをPVCSに対してチェックインする前にファイルをASCIIに変換するかどうかと、ファイルをチェックアウトする前にファイルをバイナリに戻すかどうかを制御します。以前のバージョンのForms DeveloperでのPVCSの使用からアップグレードしていて、この動作をそのまま残す場合以外は、このエントリをデフォルトのFALSEに設定しておく必要があります。

oracle.iniの例の一部を次に示します。

...

DEV2000_SOURCECONTROL=PVCS

DEV2000_PROJECT=C:\PROJECTS\MYPROJ\MYPROJ.CFG

DEV2000_SCVIEWER=NOTEPAD.EXE

DEV2000_SCCONVERT=FALSE

...


PVCSのインプリメントについて

一定のオブジェクト（フォーム、メニュー、レポート、図表、PL/SQLライブラリ）をチェックインすると、バイナリ・ファイルは等価のテキスト・ファイルに自動的に変換され、そのテキスト・ファイルがソース制御にチェックインされます。たとえば、MYFORM.FMBをチェックインした場合、MYFORM.FMBは自動的にMYFORM.FMBをMYFORM.FMT（テキスト形式のMYFORMファイル）に変換した後、MYFORM.FMTをソース制御にチェックインします。

同様に、アーカイブ・ファイルをチェックアウトする場合、Oracle Developerではテキスト形式のファイルを、デザイナ・インタフェースで読めるバイナリ形式に変換します。MYFORM.FMTをチェックアウトしたら、編集できるようにMYFORM.FMBに変換します。

アーカイブは、あるファイルの異なるバージョン間でより有意義な差分レポートを生成できるように、テキスト形式のファイルに対して行われます。PVCSではバイナリ・ファイルのアーカイブをサポートしていますが、バイナリ・ファイルのバージョン間の差分レポートの生成はできません。

このファイル変換の結果、PVCSの設定によっては、作業ディレクトリに余分なファイルが残ることがあります。プロジェクトが、ワーク・ファイルをチェックイン後に読取り専用ファイルにするよう構成されている場合、作業ディレクトリにはバイナリ・ファイルと読取り専用のテキスト形式のファイルの両方が残ります。ただし、プロジェクトが、ワーク・ファイルをチェックイン後削除するように構成されている場合は、作業ディレクトリにはバイナリ・ファイルのみが残ります。


ファイルのチェックインについて

  関連項目

ファイルを変更しアーカイブにチェックインするたびに、ファイルは新しいバージョンになります。あるファイル（拡張子がpllのPL/SQLライブラリ・ファイルなど）をチェックインすると、PVCSではバイナリからテキストへの変換を自動的に実行し、そのファイルを適切な拡張子（pldなど）を持つテキスト・ファイルとして、指定したディレクトリにアーカイブします。PVCSでは、このテキスト・ファイルを使用してアーカイブ・レポートを生成します。

バージョン・ラベルにより、バージョンはアプリケーションの完全バージョンを構成する代表的なバージョン群の１つとして識別されます。バージョン・ラベルを使用すると、特定のバージョンに関係付けられたすべてのファイルを、1つの名前を参照することで同時に操作できます。現行モジュールのバージョンをすでにアーカイブしている場合、Oracle Developerではアーカイブ・フィールドに適切な情報を自動的に挿入します。


ファイルのチェックアウトについて

  関連項目

アーカイブからファイルをチェックアウトすると、参照、編集または印刷をするためにファイルにアクセスできます。デフォルトでは、ロックされた特定のバージョンをチェックアウトできるのは一度に1人のユーザーのみです。

ファイルをチェックアウトする場合、ファイルはアーカイブされたテキスト版から適切な形式に自動的に変換します（たとえば、PL/SQLライブラリ・ファイルをpldから.pllへ変換）。アーカイブからチェックアウトしたファイルはワーク・ファイルと呼ばれます。ワーク・ファイルをチェックインするたびに、これが最新バージョンになります。


アーカイブ・レポートの作成について

  関連項目

PVCSによって、次のアーカイブ・アクティビティを要約するレポートを生成できます。

•	アーカイブの作成

•	アーカイブされたファイルの属性

•	継続的な改訂

•	ラベル名

•	最後の改訂で変更された行

•	ワーク・ファイルの説明


プロモーション・モデルについて

プロモーション・モデルとは、開発サイクルにおける重要段階の階層構造です。プロモーションを使用して、設計段階から最終的なリリースまでソース・コードの開発を制御します。各重要段階はプロモーション・グループによって表されます。プロモーション・グループの例として、Development（開発）およびQuality Assurance（品質保証）、Production（生産）があります。プロモーション・モデルは先進機能で、正式にソフトウェアの切替えを図っている現場での使用をお薦めします。

プロモーション・モデルには、1つ以上の最下位グループ、すなわち開発グループを設定することができます。プロモーション・モデルが実行されていると、開発グループに関係付けられたバージョンしか変更することはできません。上位グループに関係付けられたバージョンを編集するには、そのバージョンをチェックアウトし、チェックアウト時に1つの開発グループに再び関係付けてから、チェックインしなおして上位グループに再び昇格させる必要があります。

プロモーション・モデルに開発グループが1つしかない場合、一度にロックできるのは、アーカイブ内の1つのバージョンのみです。開発を並行して進めるためのプロモーション・モデルを設計するには、最低2つの開発グループを設定する必要があります。

開発グループの上には、テストや予備リリースの様々な段階のために、中間のプロモーション・グループをいくつでも定義できます。最上位レベルはProductionグループで、 通常、バージョンに最終的なリリースの準備ができたことを示します。

プロモーション・モデルを使用すると、次のことができます。

•	プロジェクトの状態の迅速な判断。1つのプロジェクト内で、プロジェクトに関するアーカイブ・レポートを実行して、どのモジュールが重要段階に達していないかを即座に判断することができます。

•	非開発レベルでのバージョンへのアクセスの制御。開発後のプロモーション・グループに関係付けられたバージョンを変更することはできないので、必ずすべてのバージョンを徹底的にテストするようにします。

•	独自のモデルのカスタム設計。各プロジェクトに最適のプロモーション構造体を、任意の数の重要段階を設定してカスタム設計することができます。


アーカイブ・ディレクトリの作成

  次のステップ	  関連項目

アーカイブ・ディレクトリを作成するには: 注意:

1	「ファイル」 [image] 「管理」 [image] 「ソース制御オプション」を選択して、「ソース制御: オプション」ダイアログを表示します。

2	「プロジェクト」タブがまだ選択されていない場合は選択します。

3	「アーカイブするディレクトリ」フィールドで、自分のアーカイブ・ディレクトリの名前と位置を指定します。

4	「追加」をクリックし、次に「クローズ」をクリックしてダイアログをクローズします。


レジストリでDEV2000_PROJECTパラメータを定義済みでない限り、アーカイブ・ディレクトリを追加することはできません。Microsoft Windowsでは、DEV2000_PROJECTパラメータを次のように定義します。

DEV2000_PROJECT=C:\PVCS\PROJECT1\PROJECT1.CFG

DEV2000_PROJECTパラメータの編集には、Windows 3.1の場合はOracle.iniファイルを使用し、Windows 95/98およびWindows NTの場合はレジストリを使用します。


ファイルのチェックイン

  次のステップ	  関連項目

ファイルをチェックインするには:

1	「ファイル」 [image] 「管理」 [image] 「チェックイン」を選択して、「ソース制御: チェックイン」ダイアログを表示します。

2	「ワーク・ファイル」テキスト・ボックスにアーカイブするファイルの名前を入力します。

3	「アーカイブするファイル」フィールドで、自分のアーカイブ・ディレクトリを指定します。

4	（オプション）  「バージョン・ラベル」、「プロモーション・グループ」、「記述」を指定します。

5	（オプション）  アーカイブ･ファイルのチェックイン後も、ファイルの書込み可能なコピーをローカルに残したい場合、「チェックイン後もロックを継続」チェックボックスをクリックします。ファイルの書込み可能なコピーがあれば、最初にファイルをチェックアウトしなくても、ファイルに後続の変更を加え、チェックインすることができます。

6	「OK」をクリックして、ファイルをチェックインします。

PVCSによってファイルがアーカイブされます。


ファイルのチェックアウト

  次のステップ	  関連項目

ファイルをチェックアウトするには:

1	「ファイル」 [image] 「管理」 [image] 「チェックアウト」を選択し、「ソース制御: チェックアウト」ダイアログを表示します。

2	「ソース・アーカイブ」フィールドでソース・アーカイブ・ディレクトリを指定します。

3	「ファイル名」テキスト・ボックスに、チェックアウトするファイルの名前を入力します。

4	「改訂バージョン」フィールドで、希望するファイルの改訂バージョンを選択します。

5	（オプション）  「配布先」フィールドにパスを入力して、希望する配布先を指定します。

6	（オプション）  チェックアウトするファイルをロックする場合、チェックアウトするバージョンに割り当てられる開発レベルのプロモーション・グループを選択する必要があります。

7	（オプション）  「チェックアウト時にファイルをロック」チェックボックスをクリックします。注意:

8	（オプション）  「チェックアウト時にファイルをオープン」チェックボックスをクリックします。このボックスをチェックすると、チェックアウトしたファイルは、PVCSからチェックアウトした後、デザイナでオープンされます。

9	「OK」をクリックして、ファイルをチェックアウトします。


アーカイブ・ファイルを変更する場合は、変更をチェックインするために、「チェックアウト時にファイルをロック」チェックボックスを使用可能にする必要があります。使用可能にしないと、ファイルの読込み専用版がチェックアウトされます。


アーカイブ・レポートの作成

  関連項目

アーカイブ・レポートを作成するには:

1	「ファイル」 [image] 「管理」 [image] 「ソース制御オプション」を選択します。

2	「レポート」タブをクリックして、「ソース制御: レポート・オプション」ページを表示します。

3	「アーカイブ」フィールドでアーカイブ・ディレクトリを指定します。

4	「ソース・ファイル」フィールドで、希望するアーカイブ・ファイルの名前を指定します。PVCSでは、このファイルとターゲット・ファイルの比較に基づいてレポートが生成されます。

5	「ターゲット・ファイル」フィールドで、ターゲット・ファイルの名前を指定します。注意

6	「改訂バージョン」フィールドで、希望するファイルの改訂バージョンを選択します。

7	「出力ファイル」フィールドでレポートの名前とディレクトリを指定し、「レポート実行」をクリックします。

PVCSによってレポートが作成されます。DEV2000_SCVIEWER環境変数またはレジストリのパラメータで表示プログラムが指定されている場合、出力を表示するためにこのプログラムがコールされます。指定されていない場合は、エディタを使用して、レポート・ファイルをオープンします。


同じアーカイブ内で2つの改訂バージョンを比較する場合、ステップ4で入力したアーカイブ・ファイルの名前を入力します。 異なるアーカイブ・ファイルを比較する場合、「ターゲット・ファイル」フィールドで異なるアーカイブ・ファイルを1つ指定します。


「ソース制御: チェックイン」ダイアログ

  関連項目

希望するファイルを指定したアーカイブにマージします。

「チェックイン」ダイアログには、次のオプションがあります。

ワーク･ファイル	チェックインするファイルの名前を指定します。「参照」を選択して、ファイルを選択することができるファイル・ダイアログを起動します。
アーカイブするファイル	現行のプロジェクトに使用可能なすべてのアーカイブのドロップダウン・リスト。リストからファイルをチェックインするアーカイブを選択します。
バージョン・ラベル	（オプション）ファイルのバージョン・ラベルを指定します。
プロモーション・グループ	PVCSプロジェクトにプロモーション・モデルが定義されている場合、このリストが使用可能になります。チェックインする改訂バージョンに割り当てられる、開発レベルのプロモーション・グループを選択します。
説明	この改訂バージョンに加えられた変更の記述を指定します。オプションですが、チェックアウト時に改訂バージョンを指定しやすくするため、変更の記述を入力することをお薦めします。
チェックイン後もロックを継続	アーカイブ・ファイルの書込み可能なコピーを、チェックイン後もローカルに残すかどうかを指定します。ファイルの書込み可能なコピーがあれば、最初にファイルをチェックアウトしなくても、ファイルに後続の変更を加え、チェックインすることができます。


「ソース制御: チェックアウト」ダイアログ

  関連項目

指定したファイルを、編集できるようにアーカイブから取り出します。

「チェックアウト」ダイアログには、次のオプションがあります。

ソース・アーカイブ	ファイルをチェックアウトするアーカイブのディレクトリ名を指定します。
ファイル名	ソース制御から取り出すファイルの名前を指定します。「参照」を選択して、ファイルを選択することができるファイル・ダイアログを起動します。
改訂バージョン	「ファイル名」フィールドで選択したファイルの、使用可能な改訂バージョンとバージョン・ラベルを表示します。
説明	「改訂バージョン」リストにある使用可能な改訂バージョンの記述をリストします。
配布先	（オプション） チェックアウトするファイルの配布先ディレクトリを指定します。
プロモーション・グループ	PVCSプロジェクトにプロモーション・モデルが定義されている場合、このリストが使用可能になります。チェックアウトするファイルにロックをかける場合、チェックアウトする改訂バージョンに割り当てられる開発レベルのプロモーション・グループを選択する必要があります。
チェックアウト時にファイルをロック	チェックアウトするファイルにロックのマークを付けるかどうかを指定します。ロックされたファイルは、他のユーザーによる更新から保護されます。
チェックアウト時にファイルをオープン	このボックスをチェックすると、チェックアウトしたファイルは、PVCSからチェックアウトした後、デザイナでオープンされます。


「ソース制御: オプション」ダイアログ

  関連項目

「オプション」ダイアログには、次の3つのタブがあります。

「ソース制御: プロジェクト・オプション」ページ

「ソース制御: ファイル・オプション」ページ

「ソース制御: レポート・オプション」ページ


「ソース制御: プロジェクト・オプション」ページ

  関連項目

プロジェクト構成ファイルで、アーカイブ・ディレクトリの追加および削除ができるようにします。

「プロジェクト・オプション」ページには、次の設定項目があります。

現行プロジェクト	現行のPVCSプロジェクト構成ファイルの名前。初期値はレジストリのDEV2000_PROJECTの値です。直接ファイル名を入力するか、または「参照」を選択して、使用しているオペレーティング・システムのファイル・ダイアログを表示することができます。
アーカイブするディレクトリ	現行のプロジェクトで使用可能なアーカイブ・ディレクトリのリストに追加する、新しいアーカイブ・ディレクトリを指定します。直接ディレクトリ名を入力するか、または「参照」を選択して、使用しているオペレーティング・システムのファイル・ダイアログを表示することができます。
アーカイブ・ディレクトリ・リスト	現行のプロジェクトで使用可能なアーカイブ・ディレクトリを表示します。
追加	「アーカイブするディレクトリ」テキスト・ボックスにアーカイブ・ディレクトリを入力してから、「追加」をクリックし、ディレクトリを現行のプロジェクトに追加します。追加されたディレクトリはリストに表示されます。
削除	リストからアーカイブ・ディレクトリを選択し、次に「削除」をクリックして、プロジェクトからディレクトリを削除します。


「ソース制御: ファイル・オプション」ページ

  関連項目

アーカイブのロックやアンロック、またはそのアーカイブでのアクティビティのログの生成ができるようにします。

「ファイル・オプション」ページには、次の設定項目があります。

アーカイブ	現行のプロジェクト構成ファイル内のすべてのアーカイブ・ディレクトリのドロップダウン・リスト。
ファイル名	アクセスするアーカイブ・ファイルを指定します。直接ファイル名を入力するか、または「参照」を使用してファイルを選択することができます。PVCSプロジェクトがワーク・ファイルのパスを無視するように構成されている場合、ワーク・ファイルまたはアーカイブ・ファイルのいずれかを指定できます。そのように構成されていない場合は、必ずアーカイブ・ファイルのみを指定してください。
改訂バージョン	このドロップダウン・リストでは、選択したファイルの使用可能な改訂バージョンとバージョン・ラベルがすべて表示され、ファイルが選択されていない場合には空項目が表示されます。特定の改訂バージョンを選択した場合、その改訂バージョンはロックまたはアンロックされます。改訂バージョンを選択しない場合、プロモーション・モデルが定義されているかどうかでロックの動作が決まります。プロモーション・モデルが定義されていない場合は、チップ・バージョンがロックされます。定義されている場合は、指定したプロモーション・グループに現在割り当てられている改訂バージョンがロックされます。改訂バージョンを選択せずにアンロックする動作では、必ずそのファイルにかけたすべてのロックが解除されます。
プロモーション・グループ	PVCSプロジェクトにプロモーション・モデルが定義されている場合に使用可能なリストで、プロモーション・モデル内のすべての開発レベルのプロモーション・グループを表示します。改訂バージョンをロックする場合、リストに表示されるプロモーション・グループはその改訂バージョンに割り当てられます。
ログ・ファイル名	ログ・ファイルの名前を指定します。
ログ・タイプ	チェックインまたはチェックアウトが発生した際、指定したログ・ファイルに入力される更新のタイプを指定します。
ロック	ソース制御から取り出さずに、「ファイル名」フィールドで指定したファイルをロックします。ロックされたファイルは、他のユーザーによる更新から保護されます。「改訂バージョン」リストから特定の改訂バージョンを選択すると、その改訂バージョンがロックされます。改訂バージョンを選択しなかった場合、チップ・バージョン（すなわち、指定したプロモーション・グループに現在割り当てられている改訂バージョン）がロックされます。PVCSプロジェクトにプロモーション・モデルが定義されている場合、指定したプロモーション・グループはロックされている改訂バージョンに割り当てられます。
アンロック	「ファイル名」フィールドで指定したファイルをアンロックし、他のユーザーがそのアーカイブ・ファイルに対してチェックアウトや変更を行えるようにします。「改訂バージョン」リストから特定の改訂バージョンを選択した場合、その改訂バージョンはアンロックされます。改訂バージョンを選択しなかった場合、そのファイルの改訂バージョンにかけたロックはすべて解除されます。
ログ生成	名前を指定してログ・ファイルを生成します。ログ・ファイルの項目のタイプは、「ログ・タイプ」オプションの設定によって決まります。DEV2000_SCVIEWER環境変数またはレジストリのパラメータで表示プログラムが指定されている場合、出力を表示するためにこのプログラムがコールされます。


「ソース制御: レポート・オプション」ページ

  関連項目

アーカイブ・レポートの定義と作成ができます。

「レポート・オプション」ページには、次の設定項目があります。

アーカイブ	現行のプロジェクト構成ファイル内のすべてのアーカイブ・ディレクトリのドロップダウン・リスト。
ソース・ファイル	差分レポートで最初に使用するファイルを指定します。直接ファイル名を入力するか、または隣りの「参照」ボタンを使用してファイルを選択することができます。PVCSプロジェクトがワーク・ファイルのパスを無視するように構成されている場合、ワーク・ファイルまたはアーカイブ・ファイルのいずれかを指定できます。そのように構成されていない場合は、必ずアーカイブ・ファイルのみを指定してください。
改訂バージョン	ソース・ファイルのすべての使用可能な改訂バージョンとバージョン・ラベルのドロップダウン・リスト。
ターゲット・ファイル	ターゲット・ファイルの名前を指定します。PVCSでは、ソース・ファイルとターゲット・ファイルの比較に基づいてレポートを生成します。
改訂バージョン	ターゲット・ファイルの使用可能なすべての改訂バージョンとバージョン・ラベルのドロップダウン・リスト。
出力ファイル	ファイルを他のファイルと比較する際、差分レポートが書き込まれる配布先ディレクトリおよびファイル名を指定します。
レポート実行	指定したオプションに従って、レポートを作成します。DEV2000_SCVIEWER環境変数またはレジストリのパラメータで表示プログラムが指定されている場合、出力を表示するためにこのプログラムがコールされます。


エラー・メッセージ

ソース制御インタフェース・ダイアログの使用中に、次のエラー・メッセージが表示されることがあります。

D2SCP-001:	ファイル・システムにファイルのアクセスを拒否されました。

原因:	アーカイブ・ファイルの読込み、またはワーク・ファイルの書込み、ログ出力またはレポート出力の書込みを行うファイル・システム・アクセス権限がありません。

処置:	これらのファイルに対するファイル・システム・アクセス権限が必要であると思われる場合は、システム管理者に連絡してください。

D2SCP-002:	バージョン・マネージャに対するアクセス権限が不十分です。

原因:	指定したアーカイブにアクセスするPVCS権限がありません。マスター･プロジェクトでアーカイブ・ディレクトリの変更ができないのに、「オプション」ダイアログの「プロジェクト・オプション」タブで変更しようとした場合にも、このエラーが表示されます。

処置:	そのアーカイブに対するアクセス権限が必要であると思われる場合は、PVCS管理者に連絡してください。

D2SCP-003:	すでにアーカイブが存在します。

原因:	これは内部エラーの発生を示し、表示されてはならないメッセージです。

処置:	操作を繰り返し試行した後もエラーが発生する場合は、サポート担当に連絡してください。

D2SCP-004:	指定したアーカイブが見つかりません

原因:	アーカイブ・ファイルが必要なときに、アーカイブではないファイル名を入力または選択しました。このエラーは通常、アーカイブ・ファイルではなくワーク・ファイル（たとえば、MYFORM.FMVではなくMYFORM.FMB）を選択したことが原因です。

処置:	「参照」ボタンを使用してアーカイブ・ファイルを選択します。

D2SCP-005:	無効なファイル名：ドライブまたはパスが存在しないか、ファイル名に無効な文字が使われています。

原因:	入力したファイル名が、オペレーティング・システムの有効なファイル名ではありません。

処置:	ファイル名の構文にエラーがないかチェックしてください。

D2SCP-006:	ファイルは別プロセスで使用中です。

原因:	アクセスしようとしたファイルは、他のPVCSユーザーが使用中です。

処置:	通常、少し時間を置いてから再び操作すれば、アクセスできます。

D2SCP-007:	変換に失敗しました。ワーク・ファイルが読込み専用であるか、サポートされていないタイプである可能性があります。

原因:	このエラーの原因として、次のことが考えられます。

A.	ワーク・ファイルが読込み専用である可能性があります。このエラーは、ファイルをロックせずにチェックアウトし、その後「オプション」ダイアログからロックした場合に起こります。

B.	認識されないタイプのファイルをチェックインまたはチェックアウトしようとしました。

処置:	このエラーの訂正には、次の処置を行ってください。

A.の場合	Windowsのファイル・マネージャまたはエクスプローラを使用して、操作を進める前にファイルを書込み可能にしてください。

B.の場合	スタンドアロンのPVCSインタフェースを使用して、ファイルのチェックインまたはチェックアウトを行ってください。

任意のファイルをチェックアウトできますが、チェックインできるのはForms Developerが認識するファイルのみであることに注意してください。これは、Forms Developerでは、ワーク・ファイルからしかサポートするファイル・タイプかどうかを判別できないためです。チェックインする時点でワーク・ファイルがあります。したがって、Forms Developerはチェックインする前にそのファイルをテストします。チェックアウトするときは、そのファイルはワーク・ファイルを取得するためにチェックアウトされます。そうしなければ、Forms Developerではファイルをテストできません。したがって、チェックアウトしているファイルがForms Developerによって認識されないタイプのファイルであるとわかっていれば、チェックアウトのときにこのエラーを無視してもかまいません。

D2SCP-008:	値が無効であるか、不十分です。

原因:	これは内部エラーの発生を示し、表示されてはならないメッセージです。

処置:	操作を繰り返し試行した後もエラーが発生する場合は、サポート担当に連絡してください。

D2SCP-010:	指定したバージョン・ラベルがすでに存在します。

原因:	「チェックイン」ダイアログで、チェックインするファイルに、すでに存在している改訂バージョン・ラベルを指定しました。PVCSでは、指定する改訂バージョン・ラベルは他と重複しないでください。

処置:	ラベルを変更してください。使用中のラベルを参照するには、「オプション」ダイアログの「ファイル・オプション」タブで「ログ」機能を使用します。

D2SCP-011:	指定された改訂バージョンは存在しません。

原因:	これは内部エラーの発生を示し、表示されてはならないメッセージです。

処置:	操作を繰り返し試行した後もエラーが発生する場合は、カスタマ・サポートに連絡してください。

D2SCP-012:	無効な構成ファイルが指定されました。

原因:	このエラーの原因として、次のことが考えられます。

A.	「オプション」ダイアログの「プロジェクト・オプション」タブで選択したファイルが、有効なPVCS構成ファイルではありません。

B.	「チェックイン」ダイアログまたは「チェックアウト」ダイアログにアクセスしようとして、このエラーが発生した場合、DEV2000_PROJECT環境変数で指定された構成ファイルが無効であることを意味します。

処置:	このエラーの訂正には、次の処置を行ってください。

A.の場合	別の有効なファイルを選択します。

B.の場合	変数を変更するか、「オプション」ダイアログの「プロジェクト・オプション」タブを使用して、有効な構成ファイルを設定してください。

D2SCP-013:	最初に、「ソース制御オプション」からプロジェクトを選択する必要があります。

原因:	「チェックイン」ダイアログまたは「チェックアウト」ダイアログにアクセスしようとしましたが、レジストリでDEV2000_PROJECT変数を使用して、または「オプション」ダイアログの「プロジェクト・オプション」タブ上で、プロジェクトを指定していません。

処置:	操作を続行する前に「プロジェクト・オプション」タブを表示し、プロジェクトを選択する必要があります。

D2SCP-014:	プロジェクト構成ファイルを更新できません。

原因:	プロジェクト構成ファイルからアーカイブ・ディレクトリを追加または削除しようとしましたが、ファイルまたはファイルがあるディレクトリに対する書込み許可がありません。

処置:	このアクセス許可が必要であると思われる場合は、PVCS管理者またはシステム管理者に連絡してください。

D2SCP-015:	改訂バージョンがロックされていません。

原因:	ロックしていない改訂バージョンをチェックインしようとしたか、またはロックしていない改訂バージョンを（「ファイル・オプション」タブから）アンロックしようとしました。

処置:	変更を加えた場合、改訂バージョンをチェックインする前に「ファイル・オプション」タブでロックしてください。

D2SCP-016:	指定した改訂バージョンをロックできません。

原因:	「チェックアウト」ダイアログから改訂バージョンをロックしてチェックアウトしようとしたか、または「ファイル・オプション」タブから改訂バージョンをロックしようとしましたが、PVCSではロックの権限を付与できませんでした。このエラーの原因として、次のことが考えられます。

A.	その改訂バージョンがすでに、自分または他のユーザーによってロックされています。

B.	プロジェクトに複数のロックをかけることができず、その改訂バージョンはすでにロックされています。

C.	プロジェクトにプロモーション・モデルがある場合、指定したプロモーション・グループが、ロックした改訂バージョンにすでに割り当てられている可能性があります。

処置:	このエラーの訂正には、次の処置を行ってください。

A.の場合	「ログ」機能を使用して誰がロックしているかを参照します。 自分で改訂バージョンをロックしている場合、ロックを要求せずにファイルをチェックアウトします。他のユーザーがロックしている場合、そのユーザーがロックを解除するのを待ってから、変更のためにファイルをチェックアウトします。

B.の場合	改訂バージョンかファイルが使用可能になるのを待つか、またはそのプロジェクトで1つのファイルに複数のロックがかけられるようにすることを考えてください。

C.の場合	プロモーション・グループが使用可能（ロックされた改訂バージョンに割り当てられていない状態）になるのを待つか、または別の開発レベルのプロモーション・グループを使用してください。

D2SCP-017:	指定したディレクトリが存在しません。

原因:	存在しないディレクトリを指定しました。このエラーは通常、ファイルをチェックインした場所がワークステーション上に存在しないのに、そこからファイルをチェックアウトしようとしたことが原因です。

処置:	この場合は、「宛先」フィールドを編集して、既存のディレクトリを指定してください。

D2SCP-018:	出力をファイルにリダイレクトできません。

原因:	ログ出力または差分レポート出力に指定したファイル名が無効か、またはファイルを書込みのためにオープンできませんでした。

処置:	有効で書込み可能なファイルを指定します。

D2SCP-100:	PVCSエラー 数値 - キーワード

原因:	「ソース制御インタフェースでは処理できませんでした」というエラーが、PVCSから戻されました。

処置:	PVCSのマニュアルでエラーの数値またはエラーのキーワードを使用してエラーを調べ、適切な処置を行ってください。


PVCS構成マネージャ・インタフェースで、新規ファイルまたは改訂バージョンが表示されないのはなぜですか？

ファイルをチェックインし、改訂バージョン・ラベルを割り当てたのに、PVCS構成マネージャ・インタフェースで、新規ファイルまたは改訂バージョンが表示されません。どうすればよいのでしょうか？

プロジェクト・フォルダを、アーカイブ（新規ファイルおよび改訂バージョン）にある新しい情報で更新する必要があります。更新するには、PVCSの最上位の「Project」メニューから「プロジェクト・フォルダ更新...」を選択します。すると、新規ファイルおよび改訂バージョンが、PVCSの「フォルダ」ウィンドウに表示されます。


ソース制御メニュー・オプションが、1つの製品でしか使用できないのはなぜですか？

複数の製品を同時に実行すると、ソース制御メニュー・オプションがそのうちの1つでしか使用できません。なぜですか？

Windows上のPVCSはリエントラントではありません。つまり、PVCSサービスに一度にアクセスできるのは1つのプログラム（Report BuilderのようなPVCSが使用可能なプログラム、またはPVCSインタフェース自体のいずれか）のみです。使用可能なメニューがあるプログラムと、そこからPVCSサービスにアクセスしたいプログラムを両方とも終了する必要があります。次に、PVCSへのアクセスを必要とするプログラムを再起動します。


「PVCSがアーカイブを検索できません」というエラーが出るのはなぜですか？

レポートをチェックアウトしようとして、.RDV（アーカイブ・ファイル）を選択しましたが、PVCSがアーカイブを検索できないというエラーが出ます。どうなっているのでしょうか？

.RDVファイルを選択したとしても、そのファイルはアーカイブ・ファイルではなかった可能性があります。Report Builderでは、チェックイン前に、中間（ASCII）ファイルを拡張子.RDVのファイルとして作成します。（詳細は、PVCSのインプリメントについてを参照してください。）作業ディレクトリではなく、アーカイブ・ディレクトリから.RDVファイルを選択していることを確認してください。この混乱を避けるには、次の3つの方法が役立ちます。

•	チェックイン後にワーク・ファイルを削除するようにPVCSプロジェクト・オプションを設定します。これによって、Reports中間.RDVファイルがディスク上に残らないようにします。

•	.RDVファイルがチェックインされると、VRDなどの異なる接尾語が付けられるように、接尾語のルールを変えます。これで、チェックアウト時に、.RDVではなくVRDのファイルを探すことができます。

•	アーカイブを検索するときに、ワーク・ファイルのパスを無視するようにプロジェクトを構成します。これで、チェックアウト時に、アーカイブ・ファイルではなくワーク・ファイル（この場合はRDFファイル）を指定できるようになります。

これらの方法は、PVCS構成マネージャのユーザー・インタフェース、「プロジェクト構成...」メニュー項目から実行可能です。


どうすれば、ファイルをロックするとき、必ず正しいユーザー名が使用されるようにすることができますか？

ファイルをロック（またはロックしてチェックアウト）すると、必ずユーザーIDが「UNKNOWN」に設定されてしまいます。このように設定されると、他のユーザーがファイルをチェックインまたはアンロックできるようになります。どうすれば必ず正しいユーザー名が使用されるようにすることができますか？

（PVCS改訂バージョン・マネージャ・インタフェースの）PVCSプロジェクト構成オプションの「ネットワーク」セクションに、「ログイン・ソース」というオプションがあります。 これを使用して、この問題を回避することができます。このオプションによって、PVCSが現在のユーザIDを判別する方法を定義することができます。たとえば、NETWAREネットワークを使用する場合、PVCSに現行のNETWAREログインIDを使用するように指示することができます。Windows NTでは、"HOST"ログイン・ソースを使用して、NTログインIDを使用することができます。詳細は、PVCSのマニュアルを参照してください。


チェックアウトのためにワーク・ファイルを選択できるようにする方法はありますか？

チェックアウトのために、アーカイブ・ファイルではなく、ワーク・ファイルを選択できるようにする方法はありますか？

（PVCS改訂バージョン・マネージャ・インタフェースの）PVCSプロジェクト構成オプションの「アーカイブ検索」セクションにある「ワーク・ファイル・パスを無視」というオプションを使用することができます。このオプションを使用すると、「チェックアウト」ダイアログおよび「ソース制御オプション」ダイアログで、ワーク・ファイルまたはアーカイブ・ファイルのいずれかを選択できるようになります。


「VCSDIRがプロジェクト構成ファイルで実現できません」というエラーが出るのはなぜですか？

マスター・プロジェクトをアーカイブ・ディレクトリの変更ができないように構成しました。PVCS改訂バージョン・マネージャ・インタフェースでは、意図したとおり、サブプロジェクトでアーカイブ・ディレクトリを変更することはできません。しかし、Forms Developerでは変更できました。その後、PVCS改訂バージョン・マネージャ・インタフェースから「VCSDIRがプロジェクト構成ファイルで実現できません」というエラーが戻されました。どうなっているのでしょうか？

PVCS改訂バージョン・マネージャ・インタフェースでは、ルート・ディレクトリでデフォルトの MASTER.CFG を検索します。 アーカイブ・ディレクトリを変更した後に、このファイルを元のディレクトリで検索したために、このエラーが通知されたものと思われます。マスター構成ファイルを認識できるようにするには、 VCONFIG  コマンドを使用してPVCSを構成する必要があります。これにより、PVCSライブラリにあるマスター構成ファイルの名前が暗号化され、誰もアーカイブ・ディレクトリのリストを不用意に変更できないようになります。詳細は、INTERSOLV社PVCS付属の『PVCSコマンド行リファレンス・ガイド』の「Master Configuration Files」および「VCONFIG Command」の項を参照してください。


• 9


非Oracleデータソースへのアクセス

  関連項目

Oracle Developerアプリケーションは、Oracle Open Client Adapter(OCA)を使用して任意のODBCデータソースに接続できます。次にリストするデータソースについて、特別な情報を提供します。

アクセスしたいデータソースをクリックします。

Personal Oracle Lite

Microsoft SQL Server(バージョン4.2、6.0および6.5)

Microsoft Access(バージョン2.0以降)

Oracle Rdb(バージョン5.1、6.1および7.0)

Sybase(SQL Serverバージョン4.9、システム10およびシステム11)

Tandem NonStop SQL

Informix(SEおよびオンライン・バージョン5.x、6.xおよび7.x)


Open Client Adapter(OCA)の使用準備

  関連項目

使用するシステムでOCAの使用を設定するには:

1	ネットワーク・ライブラリを含む、必要なサーバーおよびクライアント・ソフトウェアをインストールします。データベースを構築し、データベース・アカウントを作成し、ユーザーに適切なアクセス権限を付与します。Microsoft Accessのようなシングル・ユーザー、シングル・マシンのデータソースには、データベース・サーバーやデータベース・クライアントなどの概念はなく、特別なセットアップは必要ありません（ただし、データベース表を格納するためのデータベース・ファイルを作成する必要はあります）。

2	必要なODBCドライバをクライアント・マシンにインストールし、Microsoft ODBC Administrator(ドライバとともに自動的にインストールされます)を使用してデータソースを構築します。Intersolv社製のODBCドライバ(SQL ServerおよびRdb、Sybase、Informix、Ingres、その他の多数のデータベース用)は、インストレーションCDからインストールされます。MicrosoftやIBM、その他のODBCドライバ・ベンダー製のドライバも使用できます。


Personal Oracle Liteへのアクセス

  関連項目 	  oca_info.pdfをオープンする

Personal Oracle Liteにアクセスするには:

1	Open Client Adapter(OCA)を使用するためにシステムをセットアップします。

2	「リリース・ノート」およびPDFドキュメント(oca_info.pdf)を読みます。

3	SQLスクリプトを実行し、サーバー側にデータ・ディクショナリ・ビューを作成します。このデータ・ディクショナリ・ビューにより、開発時に必要なデータベース・オブジェクト名を表示することができます。注意

UBT32.EXE user/password@ODBC:datasource[:dbname] @sqlscript  例

dbnameが指定されないと、データ・ディクショナリ・ビューはODBC接続の「現行」データベース内に作成されます。

4	Builderを起動します。

5	(オプション)SQLスクリプトを実行し、デモ表の作成とデータの挿入を行います。例

6	(Form Builderのみ)各データ項目の主キー・プロパティを「はい」に設定します。データ項目は、データソースの各列に対応しています。

7	Personal Oracle Liteデータソースへ接続する準備ができたら、次の接続文字列を「接続」ダイアログ・ボックスに入力します。

[user[/password]]@ODBC:datasource[:dbname] 例

Personal Oracle Liteへのアクセスの詳細は、oca_info.pdfを参照してください。


Init_Formは、form-levelを自動的に変更するOPENDBルーチンで、これによってフォームはODBCデータソースと対話できます。


OCA.PLLは、ディレクトリORACLE_HOME\ocaにあります。Form BuilderがOCA.PLLを見つけることができるように、レジストリ内の環境変数FORMS50_PATHに、ディレクトリORACLE_HOME\oca20を追加する必要があります。


Microsoft SQL Serverへのアクセス

  関連項目	  Open oca_info.pdfをオープンする

Microsoft SQL Serverにアクセスするには:

1	Open Client Adapter(OCA)を使用するためにシステムをセットアップします。

2	「リリース・ノート」およびPDFドキュメント(oca_info.pdf)を読みます。

3	SQLスクリプトを実行し、サーバー側にデータ・ディクショナリ・ビューを作成します。 このデータ・ディクショナリ・ビューにより、設計時に選択できるように、データベース・オブジェクト名を表示することができます。注意

UBT32.EXE user/password@ODBC:datasource[:dbname] @sqlscript  例

dbnameが指定されないと、データ・ディクショナリ・ビューはODBC接続の「現行」データベース内に作成されます。

4	Builderを起動します。

5	(オプション)SQLスクリプトを実行し、デモ表の作成とデータの挿入を行います。例

6	(Form Builderのみ)各データ項目の主キー・プロパティを「はい」に設定します。データ項目は、データソースの各列に対応しています。

7	Microsoft SQLサーバー・データソースへ接続する準備ができたら、次の接続文字列を「接続」ダイアログ・ボックスに入力します。

[user[/password]]@ODBC:datasource[:dbname] 例

Microsoft SQL Serverへのアクセスの詳細は、oca_info.pdfを参照してください。


Oracle Rdbへのアクセス

  関連項目 	  Open oca_info.pdf をオープンする

Oracle Rdbにアクセスするには:

1	Open Client Adapter(OCA)を使用するためにシステムをセットアップします。

2	「リリース・ノート」およびPDFドキュメント(oca_info.pdf)を読みます。

3	SQLスクリプトを実行し、サーバー側にデータ・ディクショナリ・ビューを作成します。 このデータ・ディクショナリ・ビューにより、設計時に選択できるように、データベース・オブジェクト名を表示することができます。注意

UBT32.EXE user/password@ODBC:datasource[:dbname] @sqlscript  例

dbnameが指定されないと、データ・ディクショナリ・ビューはODBC接続の「現行」データベース内に作成されます。

4	Builderを起動します。

5	(オプション)SQLスクリプトを実行し、デモ表の作成とデータの挿入を行います。例

6	(Form Builderのみ)OCA.PLLライブラリをアプリケーションに接続します。次に、OPENDB.Init_Formルーチンを含むPre-FormまたはWhen-New-Form-Instanceトリガーを作成します。

7	Oracle Rdbデータソースへ接続する準備ができたら、次の接続文字列を「接続」ダイアログ・ボックスに入力します。

[user[/password]]@ODBC:datasource[:dbname] 例

Oracle Rdbへのアクセスの詳細は、oca_info.pdfを参照してください。


Microsoft Accessへのアクセス

  関連項目 	  oca_info.pdfをオープンする

Microsoft Accessにアクセスするには:

1	Open Client Adapter(OCA)を使用するためにシステムをセットアップします。

2	「リリース・ノート」およびPDFドキュメント(oca_info.pdf)を読みます。

3	(オプション)SQLスクリプトを実行し、次に示すようにUBTユーティリティによりデモ表の作成とデータの挿入を行います。

UBT32.EXE user/password@ODBC:datasource[:dbname] @sqlscript  例

dbnameが指定されないと、データ・ディクショナリ・ビューはODBC接続の「現行」データベース内に作成されます。

4	Builderを起動します。

5	(Form Builderのみ)各データ項目の主キー・プロパティを「はい」に設定します。データ項目は、データソースの各列に対応しています。

6	Microsoft Accessデータソースに接続する準備ができたら、次の接続文字列を「接続」ダイアログ・ボックスに入力します。

[user[/password]]@ODBC:datasource[:dbname] 例

Microsoft Accessへのアクセスの詳細は、oca_info.pdfを参照してください。


Sybaseへのアクセス

  関連項目 	  oca_info.pdfをオープンする

Sybaseにアクセスするには:

1	Open Client Adapter(OCA)を使用するためにシステムをセットアップします。

2	「リリース・ノート」およびPDFドキュメント(oca_info.pdf)を読みます。

3	SQLスクリプトを実行し、サーバー側にデータ・ディクショナリ・ビューを作成します。 このデータ・ディクショナリ・ビューにより、設計時に選択できるように、データベース・オブジェクト名を表示することができます。注意

UBT32.EXE user/password@ODBC:datasource[:dbname] @sqlscript  例

dbnameが指定されないと、データ・ディクショナリ・ビューはODBC接続の「現行」データベース内に作成されます。

4	Builderを起動します。

5	(オプション)SQLスクリプトを実行し、デモ表の作成とデータの挿入を行います。例

6	(Form Builderのみ)各データ項目の主キー・プロパティを「はい」に設定します。データ項目は、データソースの各列に対応しています。

7	Sybaseデータソースへ接続する準備ができたら、次の接続文字列を「接続」ダイアログ・ボックスに入力します。

[user[/password]]@ODBC:datasource[:dbname] 例

Sybaseへのアクセスの詳細は、oca_info.pdfを参照してください。


Tandem NonStop SQLへのアクセス

  関連項目 	  oca_info.pdfをオープンする

Tandem NonStop SQLにアクセスするには:

1	Open Client Adapter(OCA)を使用するためにシステムをセットアップします。

2	「リリース・ノート」およびPDFドキュメント(oca_info.pdf)を読みます。

3	SQLスクリプトを実行し、サーバー側にデータ・ディクショナリ・ビューを作成します。 このデータ・ディクショナリ・ビューにより、設計時に選択できるように、データベース・オブジェクト名を表示することができます。注意

UBT32.EXE user/password@ODBC:datasource[:dbname] @sqlscript  例

dbnameが指定されないと、データ・ディクショナリ・ビューはODBC接続の「現行」データベース内に作成されます。

4	Builderを起動します。

5	(オプション)SQLスクリプトを実行し、デモ表の作成とデータの挿入を行います。例

6	(Form Builderのみ)各データ項目の主キー・プロパティを「はい」に設定します。データ項目は、データソースの各列に対応しています。

7	Tandem NonStop SQLデータソースへ接続する準備ができたら、次の接続文字列を「接続」ダイアログ・ボックスに入力します。

[user[/password]]@ODBC:datasource[:dbname] 例

Tandem NonStop SQLへのアクセスの詳細は、oca_info.pdfを参照してください。


Informixへのアクセス

  関連項目 	  oca_info.pdfをオープンする

Informixにアクセスするには:

1	Open Client Adapter(OCA)を使用するためにシステムをセットアップします。

2	「リリース・ノート」およびPDFドキュメント(oca_info.pdf)を読みます。

3	SQLスクリプトを実行し、サーバー側にデータ・ディクショナリ・ビューを作成します。 このデータ・ディクショナリ・ビューにより、設計時に選択できるように、データベース・オブジェクト名を表示することができます。注意

UBT32.EXE user/password@ODBC:datasource[:dbname] @sqlscript  例

dbnameが指定されないと、データ・ディクショナリ・ビューはODBC接続の「現行」データベース内に作成されます。

4	Builderを起動します。

5	(オプション)SQLスクリプトを実行し、デモ表の作成とデータの挿入を行います。例

6	(Form Builderのみ)各データ項目の主キー・プロパティを「はい」に設定します。データ項目は、データソースの各列に対応しています。

7	Informixデータソースへ接続する準備ができたら、次の接続文字列を「接続」ダイアログ・ボックスに入力します。

[user[/password]]@ODBC:datasource[:dbname] 例

Informixへのアクセスの詳細は、oca_info.pdfを参照してください。


Open Client Adapter(OCA)について

  oca_info.pdfをオープンする

ODBC用のOracle Open Client Adapter(OCA)により、Microsoft Windows3.1、Windows95、Windows98、およびWindows NT上のアプリケーションで、ODBCドライバを使用してODBC準拠のデータソースにアクセスすることが可能になります。OCAでは、ODBCドライバがODBCのレベル1に準拠する必要があります。ODBCドライバにレベル2のODBC機能がある場合、OCAではその機能も使用してさらに高いパフォーマンスを実現します。

OCAを使用することにより一貫した方法で、アプリケーションで様々なデータソースにアクセスできます。これにより、アプリケーションの開発者は、複数のデータソースに対して修正を行わずに同じアプリケーションを実行することができます。逆に、そのアプリケーションの対象を特定のデータソースに固定し、そのシステム固有の特徴を利用することもできます。

OCAは、Oracle Installerによってインストールされ、すべての必要なファイルがORACLE_HOMEディレクトリにコピーされます。これらのファイルの1つが、oca.pllです。 oca.pllはPL/SQLのファンクション・ライブラリで、アプリケーションからこれを使用して次の操作ができます。

•	アプリケーションのメイン接続の他に、他のデータソースに対する補助接続をオープンします。

•	任意の接続に対し、任意のSQL文およびストアド・プロシージャ・コールを実行します。

•	Oracle以外のストアド・プロシージャから検索結果を取り出します。

•	DBMSおよびODBCドライバの名前とバージョンを取得します。

•	データソースに適合するように、実行時に「フォーム」および「データ・ブロック」プロパティを自動的に調整します。

これらの機能の詳細は、この項目の最上部の [image] ボタンをクリックしてください。

インストールされている他のファイルの詳細は、「リリース・ノート」を参照してください。


デフォルトでは、oca_info.pdfはORACLE_HOME\TOOLS\DOC60\USにインストールされます。デフォルト・ディレクトリにAdobe Acrobat Readerをインストールしてある場合は、この項目の最上部の [image] ボタンをクリックし、ドキュメントを表示してください。このプログラムをインストールしていない場合は、PDFビューアを起動しoca_info.pdfをオープンしてください。


UBTユーティリティについて

ODBC用のOracle Open Client Adapter(OCA)には、Universal Backend Tester(UBT)というSQL*Plusに似たユーティリティが含まれています。UBTにより、インタプリタ内またはコマンド・ファイルを使用してSQLコマンドを操作できます。

UBT実行プログラム(Windows NT、Windows95、およびWindows98ではUBT32.EXE、Windows3.1ではUBT.EXE)は、ORACLE_HOME\BINにインストールされます。

Oracle Client Adapaterの詳細は、oca_info.pdf(UBTユーティリティの情報を含む)を参照してください。


OCAリリース・ノートは、インストレーションCDのRELNOTES.TXT内に含まれています。


Personal Oracle Liteへのアクセスについて必要な情報は、デフォルトではORACLE_HOME\TOOLS\DOC60\US\oca_info.pdfにインストールされます。デフォルト・ディレクトリにAdobe Acrobat Readerをインストールしてある場合は、この項目の最上部の [image] ボタンをクリックし、ドキュメントを表示してください。このプログラムをインストールしていない場合は、PDFビューアを起動しoca_info.pdfをオープンしてください。


これはアプリケーション開発用のオプションであり、実行時には必要としません。一部のデータベース(たとえば、Microsoft Access)では、データベース・カタログの情報の公開が不十分で、ビュー作成のサポートが不足しているために、データ・ディクショナリ・ビューを作成できません。この場合は、データベース・オブジェクトの名前を、リストから選択するのではなく、設計時に入力します。


次に示すPersonal Oracle Liteにデータ・ディクショナリ・ビューを作成するSQLスクリプトは、デフォルトではORACLE_HOME\OCA20\SQL\POLITEにインストールされます。

polvudrp.sql	旧バージョンのビューを削除します。

polvubld.sql	必要なビューを作成します。


UBT32.EXE scott/tiger@ODBC:polite_ds @polvubld.sql


次に示すPersonal Oracle Liteにデモ表を作成するSQLスクリプトは、デフォルトではORACLE_HOME\OCA20\SQL\POLITEにインストールされます。

poldmbld.sql	デモ表を作成します。

デモ表にデータを挿入するSQLスクリプトは、ORACLE_HOME\OCA20\DEMOにインストールされています。

demodata.sql	デモ表に日付を挿入します。


UBT32.EXE scott/tiger@ODBC:polite_ds @poldmbld.sql


scott/tiger@ODBC:polite_ds


Microsoft SQL Serverへのアクセスについて必要な情報は、デフォルトではORACLE_HOME\TOOLS\DOC60\US\oca_info.pdfにインストールされます。デフォルト・ディレクトリにAdobe Acrobat Readerをインストールしてある場合は、この項目の最上部の [image] ボタンをクリックし、ドキュメントを表示してください。このプログラムをインストールしていない場合は、PDFビューアを起動しoca_info.pdfをオープンしてください。


次に示すMicrosoft SQL Serverにデータ・ディクショナリ・ビューを作成するSQLスクリプトは、デフォルトではORACLE_HOME\OCA20\SQL\SQLSRVにインストールされます。

sqsvudrp.sql	旧バージョンのビューを削除します。

sqsvubld.sql	SQL Serverバージョン4.2用で、必要なビューを作成します。

sqs60bld.sql	SQL Serverバージョン6.0用で、必要なビューを作成します。


UBT32.EXE scott/tiger@ODBC:sqlserver_ds @sqsvubld.sql


次に示すMicrosoft SQL Serverにデモ表を作成するSQLスクリプトは、デフォルトではORACLE_HOME\OCA20\SQL\SQLSRVにインストールされます。

sqsdmbld.sql	デモ表を作成します。

デモ表にデータを挿入するSQLスクリプトは、ORACLE_HOME\OCA20\DEMOにインストールされています。

demodata.sql	デモ表に日付を挿入します。


UBT32.EXEscott/tiger@ODBC:sqlserver_ds @sqsdmbld.sql


scott/tiger@ODBC:sqlserver_ds


Microsoft Accessへのアクセスについて必要な情報は、デフォルトではORACLE_HOME\TOOLS\DOC60\US\oca_info.pdfにインストールされます。デフォルト・ディレクトリにAdobe Acrobat Readerをインストールしてある場合は、この項目の最上部の [image] ボタンをクリックし、ドキュメントを表示してください。このプログラムをインストールしていない場合は、PDFビューアを起動しoca_info.pdfをオープンしてください。


次に示すMicrosoft Accessにデモ表を作成するSQLスクリプトは、デフォルトではORACLE_HOME\OCA20\SQL\ACCESSにインストールされています。

accdmbld.sql	デモ表を作成します。

デモ表にデータを挿入するSQLスクリプトは、ORACLE_HOME\OCA20\DEMOにインストールされています。

demodata.sql	デモ表に日付を挿入します。


UBT32.EXE scott/tiger@ODBC:access_ds @accdmbld.sql


scott/tiger@ODBC:access_ds


Oracle Rdbへのアクセスについて必要な情報は、デフォルトではORACLE_HOME\TOOLS\DOC60\US\oca_info.pdfにインストールされます。デフォルト・ディレクトリにAdobe Acrobat Readerをインストールしてある場合は、この項目の最上部の [image] ボタンをクリックし、ドキュメントを表示してください。このプログラムをインストールしていない場合は、PDFビューアを起動しoca_info.pdfをオープンしてください。


次に示すOracle Rdbにデータ・ディクショナリ・ビューを作成するSQLスクリプトは、デフォルトではORACLE_HOME\OCA20\SQL\RDBにインストールされます。

rdbvudrp.sql	旧バージョンのビューを削除します。

rdbvubld.sql	必要なビューを作成します。

rdbdual.sql	ビューを複式にします(SYSDATEをサポートするため)。


UBT32.EXE scott/tiger@ODBC:rdb_ds @rdbvubld.sql


次に示すOracle Rdbにデモ表を作成するSQLスクリプトは、デフォルトではORACLE_HOME\OCA20\SQL\RDBにインストールされます。

rdbdmbld.sql	デモ表を作成します。

デモ表にデータを挿入するSQLスクリプトは、ORACLE_HOME\OCA20\DEMOにインストールされています。

demodata.sql	デモ表に日付を挿入します。


UBT32.EXE scott/tiger@ODBC:rdb_ds @rdbdmbld.sql


scott/tiger@ODBC:rdb_ds


Sybaseへのアクセスについて必要な情報は、デフォルトではORACLE_HOME\TOOLS\DOC60\US\oca_info.pdfにインストールされます。デフォルト・ディレクトリにAdobe Acrobat Readerをインストールしてある場合は、この項目の最上部の [image] ボタンをクリックし、ドキュメントを表示してください。このプログラムをインストールしていない場合は、PDFビューアを起動しoca_info.pdfをオープンしてください。


Sybaseにデータ・ディクショナリ・ビューを作成するSQLスクリプトは、デフォルトではORACLE_HOME\OCA20\SQL\SYBASEにインストールされます。

sybvudrp.sql	旧バージョンのビューを削除します。

sybvubld.sql	必要なビューを作成します。


UBT32.EXE scott/tiger@ODBC:sybase_ds @sybvubld.sql


Sybaseにデモ表を作成するSQLスクリプトは、デフォルトではORACLE_HOME\OCA20\SQL\SYBASEにインストールされます。

sybdmbld.sql	デモ表を作成します。

デモ表にデータを挿入するSQLスクリプトは、ORACLE_HOME\OCA20\DEMOにインストールされています。

demodata.sql	デモ表に日付を挿入します。


UBT32.EXE scott/tiger@ODBC:sybase_ds @sybdmbld.sql


scott/tiger@ODBC:sybase_ds


Tandem NonStop SQLへのアクセスについて必要な情報は、デフォルトではORACLE_HOME\TOOLS\DOC60\US\oca_info.pdfにインストールされます。デフォルト・ディレクトリにAdobe Acrobat Readerをインストールしてある場合は、この項目の最上部の [image] ボタンをクリックし、ドキュメントを表示してください。このプログラムをインストールしていない場合は、PDFビューアを起動しoca_info.pdfをオープンしてください。


Tandem NonStop SQLにデータ・ディクショナリ・ビューを作成するSQLスクリプトは、デフォルトではORACLE_HOME\OCA20\SQL\NONSTOPにインストールされます。

nssvudrp.sql	旧バージョンのビューを削除します。

nssvubld.sql	必要なビューを作成します。


UBT32.EXE scott/tiger@ODBC:nonstop_ds @nssvubld.sql


Tandem NonStop SQLにデモ表を作成するSQLスクリプトは、デフォルトではORACLE_HOME\OCA20\SQL\NONSTOPにインストールされます。

nssdmbld.sql	デモ表を作成します。

デモ表にデータを挿入するSQLスクリプトは、ORACLE_HOME\OCA20\DEMOにインストールされています。

demodata.sql	デモ表に日付を挿入します。


UBT32.EXE scott/tiger@ODBC:nonstop_ds @nssdmbld.sql


scott/tiger@ODBC:nonstop_ds


Informixへのアクセスについて必要な情報は、デフォルトではORACLE_HOME\TOOLS\DOC60\US\oca_info.pdfにインストールされます。デフォルト・ディレクトリにAdobe Acrobat Readerをインストールしてある場合は、この項目の最上部の [image] ボタンをクリックし、ドキュメントを表示してください。このプログラムをインストールしていない場合は、PDFビューアを起動しoca_info.pdfをオープンしてください。


Informixにデータ・ディクショナリ・ビューとデモ表を作成するSQLスクリプトは、デフォルトではORACLE_HOME\OCA20\SQL\INFORMIXにインストールされます。

infvudrp.sql	旧バージョンのビューを削除します。

infvubld.sql	必要なビューを作成します。


UBT32.EXE scott/tiger@ODBC:informix_ds @infvubld.sql


Informixにデモ表を作成するSQLスクリプトは、デフォルトではORACLE_HOME\OCA20\SQL\INFORMIXにインストールされます。

infdmbld.sql	デモ表を作成します。

デモ表にデータを挿入するSQLスクリプトは、ORACLE_HOME\OCA20\DEMOにインストールされています。

demodata.sql	デモ表に日付を挿入します。


UBT32.EXE scott/tiger@ODBC:informix_ds @infdmbld.sql


scott/tiger@ODBC:informix_ds


トラブルシューティング

以前、Oracleに使用していたアプリケーションが、ODBCデータソースには使用できない場合、おそらく、ODBCかデータソースのいずれかの制限または限界を超えたことが原因と考えられます。

次に、OCAが発行するSQL文とODBCのドライバまたはデータベースが生成するメッセージを表示する手順を示します。

1	次のエントリが、Windows3.1のORACLE.INIファイル、またはWindows NT、Windows95およびWindows98のレジストリに設定されていることを確認します。

•	UB=ORACLE_HOME\OCA20

2	次のエントリを、Windows3.1のORACLE.INIファイル、またはWindows NT、Windows95およびWindows98のSOFTWARE\ORACLEの下にあるレジストリに追加します。

•	OCA_DEBUG_SQL=TRUE

•	OCA_DEBUG_ERROR=TRUE

3	ODBCデータソースに対してアプリケーションを実行し、デバッグ・ウィンドウにSQL文またはエラー・メッセージを表示します。「OK」をクリックして、デバッグ・ウィンドウをクローズし、処理を続けます。

4	エラーを解決できない場合は、サポート担当に問い合せてください。


OCAメッセージ

コード	メッセージの記述。

30000	一般的なOCAエラー。

30001	hostdefがNULLです。

30002	ファンクションがサポートされていません。

30003	接続文字列のユーザー名がNULLです。

30004	接続文字列のホスト名がNULLです。

30005	カーソルがすべて使用中です。

30006	解析ツリーの作成中にエラーが発生しました。

30007	SQL文がNULLです。

30008	メモリーの割当てに失敗しました。

30009	バインド変数の処理中にエラーが発生しました。

30010	OracleからODBCへのデータ型変換エラーです。

30011	ODBCからOracleへのデータ型変換エラーです。

30012	参照値をバインド中にエラーが発生しました。

30013	バインドするパラメータがありません。

30014	ホスト名が長すぎます。

30015	このデータソースではストアド・プロシージャはサポートされていません。

30016	このデータベースでは順序はサポートされていません。

30017	非Oracleデータベースへのログイン中にエラーが発生しました。

30018	ユーザー名またはパスワードが長すぎます。

30019	非Oracleのストアド・プロシージャの処理中にエラーが発生しました。

30020	ストアド・プロシージャの名前が抜けています。

30021	SQL文の準備または実行中にエラーが発生しました。

30022	列の取出し中にエラーが発生しました。

30023	結果セットのフェッチ中にエラーが発生しました。

30024	列記述子の取出し中にエラーが発生しました。

30025	結果セットの列数を取得中にエラーが発生しました。

30026	プロシージャ記述子の取出し中にエラーが発生しました。

30027	ODBC接続/文オプションの設定中にエラーが発生しました。

30028	コミットまたはロールバックでエラーが発生しました。

30029	列のバインド中にエラーが発生しました。

30030	パラメータのバインド中にエラーが発生しました。

30031	ドライバまたはデータベースについての情報の取出し中にエラーが発生しました。

30032	メモリーの解放中にエラーが発生しました。

30033	行ステータス・エラー。

30034	表が見つかりません。

30035	列が見つかりません。

30036	認可仕様が無効です。

30037	データソースを使用できません。

30038	列番号が無効です。

30039	バンドルされた演算子の組合せが不正です。

30040	カーソル・コンテキストが無効です。

30041	バインド変数がありません。

30042	データが見つかりません。

30043	フェッチされた列値がNULLです。

30044	フェッチされた列値が切り捨てられました。

30045	結果データを取出し中にエラーが発生しました。

30046	データソースの名前が指定されていません。

30047	トランザクション分離レベルがサポートされていません。

30048	配列のバインドはサポートされていません。

30049	ログオンされていません。

30050 	SQL文の解放中にエラーが発生しました。

30051	データのフェッチ中にエラーが発生しました。このデータソースをコミットした後に再度実行してください。

30052	実行時にパラメータ値が切捨てられました。

31000	一般的なODBCエラーが使用中のODBCドライバから戻されました。

エラーが発生して、アプリケーションでメッセージ・ファイルからのメッセージが読めない場合、次のエントリがWindows3.1のORACLE.INIファイル、またはWindows NT、Windows95およびWindows98のレジストリに設定されていることを確認してください。

•	UB=ORACLE_HOME\OCA20


PDFドキュメント

PDFドキュメントを表示するには、PDFビューアをインストールされたディレクトリから開始し、oca_info.pdfをオープンしてください。


用語集

英

    ActiveX
    Ada
    ASCII
    Bilder
    CGI
    CGM
    CHARデータ型（CHAR datatype）
    CMDFILE
    DATE
    Designer
    Designer(Oracle)
    DIANA
    EBCDIC
    Familyツール（Family tool）
    GUI
    HTML
    HTTP
    ICD
    IP（インターネット・プロトコル）アドレス（Internet Protocol）
    JAR
    Java
    NA値（NA value）
    NOCACHE
    NULL値（NULL value）
    ODBC
    OLE
    OLEコンテナ（OLE container）
    OLEサーバ（OLE Server）
    Oracle Designer
    ORACLE_HOME
    Oracleデータ型（Oracle datatype）
    Pcode
    PDF
    PL/SQL
    pldファイル（pld file）
    pllファイル（pll file）
    plsファイル（pls file）
    plxファイル（plx file）
    Project Wizard
    prtファイル（prt file）
    RC4
    RDBMS
    rdfファイル（rdf file）
    REF列（REF column）
    Reports Queue Manager（RWRQM60）
    Reports Server（RWMTS60）
    Reports Web Cartridge
    Reports Web CGI（RWCGI60）
    Reportsバックグラウンド・エンジン（Reports Background Engine）（RWRBE60）
    repファイル（rep file）
    rexファイル（rex file）
    RGB
    RTF
    SELECT文（SELECT statement）
    SQL
    SQLスクリプト（SQL script）
    sqlファイル（sql file）
    SQL文（SQL statement）
    SYLK
    TCP
    Top/Bottomツール（Top/Bottom tool）
    URL
    VBX
    VBXコントロール（VBX control）
    Web
    Web cartridge
    Webサーバー（Web server）
    Webブラウザ（Web browser）
    Webリンク（Web link）
    WKS
    WRB
    WWW
    XML
    zoom

数

あ

    アイコン（icon）
    アクション（action）
    アクティブ・ウィンドウ/ビュー（active window/view）
    値構成体（value construct）
    値軸（continuous axis）
    値軸（value axis）
    値のリスト（list of values）
    アプリケーション（application）
    アプレット（applet）
    アンカー（anchor）
    アンカー・ポイント（anchor point）
    暗号化（encyption）
    暗示項目（implied item）
    依存項目（decendant）
    依存性ツリー（dependency tree）
    依存性表示（dependency view）
    依存データ（dependent data）
    イメージ（image）
    インクローズ・オブジェクト（enclosing object）
    インターネット（internet）
    インタプリタ・スクリプト（interpreter script）
    イントラネット（intranet）
    インポート（import）
    ウィンドウ（window）
    内側枠ボックス（inner bounding box）
    エクスポート（export）
    エクスポート・ファイル（export file）
    エディタ（editor）
    オーバーフロー（overflow）
    オブジェクト（object）
    オブジェクト・グループ（object group）
    オブジェクト・タイプ（object type）
    オブジェクト・ナビゲータ（Object Navigator）
    オブジェクト・ハンドル（object handle）
    オブジェクト表（object table）
    オブジェクト列（object column）
    親（parent）

か

    カーソル（cursor）
    カートリッジ（cartridge）
    階層（hierarchy）
    外部PL/SQLライブラリ（external PL/SQL library）
    外部キー（foreign key）
    外部問合せ（external query）
    可視属性（visual attribute）
    カスケード・スタイル・シート（cascading style sheet）
    カスタム基準（custom measure）
    仮想ディレクトリ（virtual directory）
    仮想ファイル・システム（virtual file system）
    カット（cut）
    カテゴリ（category）
    カテゴリ軸（category axis）
    可変配列（varying array）type
    カラー・パレット（color palette）
    環境（environment）
    関係演算子（relational operator）
    キーワード（keyword）
    基準（measure）
    基本形（primitive）
    基本線の値（baseline value）
    キャッシュ（メモリー）（cache （memory））
    キャンバス（canvas）
    キャンバス・ビュー（canvas view）
    行（row）
    行オブジェクト（row object）
    境界線/塗り/テキスト表示（Edge/Fill/Text Display）
    境界線（border）
    切離しメニュー（tear-off menu）
    句（clause）
    クライアント（client）
    クライアント/サーバー・アーキテクチャ（client/server architecture）
    繰返し枠（repeating frame）
    クリップボード（Clipboard）
    グループ（group）
    グループ・ツリー（group tree）
    グループ・フィルタ（group filter）
    グローバル変数（global variable）
    グローバル・レジストリ（Global Registry）
    クロス積（cross product）
    クロス・タブ（crosstab）
    警告（alert）
    計算式列（formula column）
    継承（inherit）
    結合（join）
    限定モード（confie mode）
    原点（origin）
    子（child）
    格子表示（gridlines）
    更新（update）
    構成体（construct）
    構文（syntax）
    項目（item）
    項目軸（discrete axis）
    項目ノード（item node）
    コール・インタフェース（call interface）
    コール・スタック（call stack）
    子問合せ（child query）
    コピー（copy）
    コマンド行（command line）
    コミット（commit）
    コメント（comment）
    コレクション・タイプ（collection type）
    コンテキスト領域（context area）
    コンパイル（compile）
    コンポーネント（component）

さ

    作業環境（preference）
    索引（index）
    座標（x, y）（coordinates）
    座標系（coordinate system）
    座標平面（coordinate plane）
    サブプログラム（subprogram）
    サブプロジェクト（subproject）
    サブプロジェクト・ノード（subproject node）
    サマリー列（summary column）
    参照線（reference line）
    式（expression）
    式（formula）
    字句参照（lexical reference）
    軸チャート（aixs chart）
    システム変数（system variable）
    下に伸びる（downward-growing）
    実行（execute）
    実行（run）
    実行時（Runtime）
    実行ファイル（runfile）
    実行プログラム引数（executable argument）
    修飾ディメンション（qualifying dimension）
    十分に構成されたXML（well-formed XML）
    集約（aggregation）
    終了（quit）
    主キー（primary key）
    仕様（specification）
    上位項目（antecedent）
    使用可能（enabled）
    使用禁止（disabled）
    条件（condition）
    省略記号ボタン（Ellipsis button）
    書式マスク（format mask）
    数値演算子（numeric operators）
    スキーマ（schema）
    スクリプト（script）
    スコープ（scope）
    スタイル・シート（style sheet）
    スタック（stack）
    ストアド・サブプログラム（stored subprogram）
    ストアド・プログラム単位（stored program unit）
    すべてのツール（All tool）
    制御ポイント（control point）
    生成（Generate）
    生成（generate）
    静的な選択済み保存項目（static saved selection）
    制約（constraint）
    セクション（section）
    セッション（session）
    接続（connect）
    接続文字列（connect string）
    セル（cell）
    セレクタ（selector）
    セレクタ・ツール（Selector tool）
    選択項目（selection）
    選択項目のスクリプト（selection script）
    相関副問合せ（correlated subquery）
    挿入モード（insert mode）
    ソース（source）
    ソート・ツール（Sort tool）
    属性（attriute）
    属性値（attribute value）
    属性ツール（Attribute tool）
    属性マスク（attribute mask）
    属性列（attribute columns）
    ソケット（socket）
    祖先（ancestor）
    祖先グループ（ancestor group）
    外側枠ボックス（outer bounding box）

た

    ターゲット（target）
    ターゲット・ノード（target node）
    ダイアログ・ボックス（dialog box）
    タイトルバー（title bar）
    タイトル・ページ（title page）
    タイプ（type）
    チェックサム（checksum）
    チェックボックス（check box）
    置換モード（replace mode）
    チャート項目（chart item）
    チャート・テンプレート（chart template）
    チャート要素（chart element）
    ツール（tool）
    ツールバー（toolbar）
    ツール・パレット（tool palette）
    定義済みアクション（pre-defined action）
    定義済みタイプ（pre-defined type）
    ディテール問合せ（detail query）
    ディメンション（dimension）
    ディメンション階層（dimension hierarchy）
    ディメンション値（dimension value）
    データ型（datatype）
    データ構造ノード（data structure node）
    データソース（datasource）
    データ・ディクショナリ（data dictionary）
    データベース（database）
    データベース・トリガー（database trigger）
    データ・モデル（data model）
    データ・リンク（data link）
    テキスト項目（text item）
    デバッガ（debugger）
    デバッグ（debug）
    デバッグ・アクション（debug action）
    デバッグ・トリガー（debug trigger）
    デフォルト（default）
    問合せ（query）
    問合せフィルタ・ファンクション（query filter function）
    同位項目（sibling）
    動的な保存済み選択項目（dynamic saved selection）
    登録（register）
    独立ﾃﾞｰﾀ（independent data）
    トグル（toggle）
    ドラッグ（drag）
    トランザクション（transaction）
    トリガー（trigger）
    ドリル（drill）
    トレーラ（trailer）

な

    入力項目（input item）
    塗り領域（fill area）
    ネストされたマトリックス（nested matrix）
    ノード（node）

は

    配置（alignment）
    ハイパー・テキスト（hypertext）
    ハイパーリンク（hyperlink）
    配布（deliver）
    バインド参照（bind reference）
    バインド変数（bind variable）
    破損（damage）
    パターン（pattern）
    バックグラウンド処理（background process）
    バックグラウンド要素（background element）
    パッケージ（package）
    パッケージ仕様部（package specification）
    パッケージ・ファンクション（package function）
    パッケージ本体（package body）
    バッチ（Batch）
    バッチ・コンパイル（batch compile）
    バッファ（buffer）
    パネル（panel）
    パラメータ（parameter）
    パラメータ・リスト（parameter list）
    パレット（palette）
    範囲ツール（Range tool）
    ハンドル（handle）
    比較演算子（comparison operators）
    引数（argument）
    非キャッシュ列（non-caching column）
    日付軸（date axis）
    非表示（hidden）
    ビュー（view）
    表（table）
    表形式（tabular）
    表示（display）
    表示形式（plot type）
    表示項目（display item）
    表タイプ（table type）
    ビルトイン（built-ins）
    ビルトイン・データ型（built-in datatype）
    ビルトイン・マクロ（built-in macro）
    ファイアウォール（firewall）
    ファイル・ノード（file node）
    ファミリ（family）
    ファンクション（function）
    フィールド（field）
    フィールド・テンプレート（field template）
    フィルタ（filter）
    フォアグラウンド要素（foregrond element）
    フォーカス（focus）
    フォーマット・トリガー（format trigger）
    フォーム・レイアウト（form layout）
    フォーム・レター・レイアウト（form letter layout）
    複数行フィールド（multi-line field）
    複製（duplicate）
    物理ページ（physical page）
    付与（grant）
    フラット化オブジェクト（flattened object）
    プリンタ制御コード（printer control code）
    ブレーク・グループ（break group）
    ブレーク・チャート（break chart）
    ブレーク・トリガー（break trigger）
    ブレーク・ポイント（breakpoint）
    ブレーク列（break column）
    ブレーク・レポート（break report）
    プレースホルダー・ユーザー名（placeholder username）
    フレックス・モード（flex mode）
    プレビュー（preview）
    プレビューア（Previewer）
    プログラム単位（program unit）
    プロシージャ（procedure）
    プロジェクト（project）
    プロジェクト項目（project item）
    プロジェクト・ナビゲータ（Project Navigator）
    プロジェクト・ノード（project node）
    プロジェクト表示（project view）
    プロジェクト・ファイル（project file）
    プロジェクト・レジストリ（project registry）
    ブロック（block）
    プロトコル（protocol）
    プロパティ（property）
    プロパティ・クラス（property class）
    文（statement）
    分解オブジェクト（deconstructed object）
    分割バー（split bar）
    分類（classification）
    並行性（concurrency）
    ペイン（pane）
    ページ（page）
    ページ・ブレーク（page break）
    ペースト（paste）
    ヘッダー（header）
    ヘッダー・ノード（heading node）
    別名(alias)
    変数（variable）
    編成ノード（organization node）
    ボイラープレート（boilerplate）
    ポート（port）
    保存済み選択項目（saved selection）
    保存済み選択項目ツール（Saved Selection tool）
    ボタン（button）
    ボタン・プロシージャ（button procedure）
    ポップアップ・リスト（pop-up list）
    ボディ（body）

ま

    マージン（margin）
    マクロ（macro）
    マスター/ディテール・レイアウト（master/detail layout）
    マッチング・ツール（Match tool）
    マトリックス・セル（matrix cell）
    マトリックス・レイアウト（matrix layout）
    マトリックス・レポート（matrix report）
    無名ブロック（anoymous block）
    メール・ラベル・レイアウト（mailing label layout）
    メガバイト（MB）（megabyte）
    メソッド（method）
    メッセージ・ボックス（message box）
    モーダル・ウィンドウ（modal window）
    モードなしウィンドウ（modeless window）
    文字位置（justification）
    モジュール（module）

や

    有効なXML（valid XML）
    ユーザー・イグジット（user exit）
    ユーザー定義アクション（user-defined action）
    ユーザー定義型（user-defined type）
    ユーザー定義マクロ（user-defined macro）
    ユーザー・レジストリ（user registry）
    要素（element）
    要素タイプ（element type）
    読込み一貫性（read consistency）

ら

    ライブラリ（library）
    ラジオ・グループ（radio group）
    ラジオ・ボタン（radio button）
    ラベル（label）
    ランタイム・パラメータ･フォーム（Runtime Parameter Form）
    ランチャ（Launcher）
    リスト項目（list item）
    リスト・ツール（list tool）
    リスト・ボックス（list box）
    リフレッシュ（refresh）
    リモート・データベース（remote database）
    リンク（link）
    リンク・ファイル（link file）
    ルート（root）
    ルート・ノード（root node）
    ループ（loop）
    レイアウト（layout）
    レイアウト単位（layout unit）
    例外（exception）
    例外ツール（Exception tool）
    レコード（record）
    レコード・グループ（record group）
    レジストリ（registry）
    列（column）
    列オブジェクト（column object）
    レベル（level）
    レベル・ツール（level tool）
    レポート・レベルのオブジェクト（report-level objects）
    連結したライブラリ（attached library）
    ローカル・データベース（local database）
    ローカル変数（local variable）
    ローカル・レジストリ（local registry）
    論理演算子（logical operators）
    論理ページ（logical page）

わ

    ワイルド・カード（wildcard）
    枠（edge）
    枠（frame）
    枠ボックス（bounding box）


Project Builderにおいて、Project Builderまたはユーザーにより提供され、一定の形式のファイルに用いられるコマンド文字列。アクションは単一のファイル・タイプに制限されていない。たとえば、「ビルド」アクションがFormモジュールおよびCソース・ファイルの双方に定義されている場合、「すべてをビルド」を選択すると適切なツールによりすべての.fmbおよび.cファイルがコンパイルされる。｢定義済みアクション（pre-defined action）｣と｢ユーザー定義アクション（user-defined action）｣も参照。


埋込み型のコンピュータ・システム用に米国国防総省により開発された、高レベルのプログラミング言語。


ユーザー入力を受けることができるウィンドウまたはビュー。


（Oracle Express） 複数のディメンション値のデータを1つの値（全都市の合計販売数など）またはさらに小さな値セット（各地域の都市について算出された平均販売数など）に統合すること。データは詳細の最低レベルで収集されることが多く、分析用にさらに高いレベルでの合計に集約される。


最後のアクションのために発生した状況を通知するモーダル・ウィンドウ。警告には応答する必要がある。


フィールド内でデータが位置付けられる方法。データを定義されたフィールド幅の左、右、中央、左揃え、右揃えまたは中央揃えで配置できる。


表、ビューまたは列を参照するためにSQL文内で使用される2次的な名前。


（Oracle Express） ディメンション内のすべての値または特定階層についてのディメンション内のすべての値を選択できる「セレクタ」ダイアログ・ボックスのツール。


（Oracle Express） 階層内の特定の値を超えるレベルのディメンション値。祖先の値は、その子孫の値の集約合計である。次の例は、GEOGRAPHYディメンション内における、"France"、"Lyon"および"Paris"の祖先としてのディメンション値である"Europe"を示している。


別のグループを直接または間接に所有するグループ。


最初のオブジェクトの位置と2番目のオブジェクトとの関係を保ちながら、1つのオブジェクト上のスポットを別のオブジェクト上のスポットに固定するレイアウト・オブジェクト。


（Oracle Express） ファミリ・リレーションを基準にしてディメンション値を選択するとき、または階層内をナビゲートするときに使用する特定のディメンション値。


名前がなく、実行可能文を囲むBEGINおよびENDキーワードを明示的に指定する必要のないPL/SQLプログラム単位。無名ブロックには名前がないため、他のプログラム単位は参照できない。


別のオブジェクトのグループツリー内で、そのオブジェクトよりも上の位置で現れるオブジェクト。どのオブジェクトも、その依存項目の上位項目になる。


必要に応じWebページやアプリケーションに動的にインポートできる小さなプログラムを表すJava用語。


特定の結果を達成するために使用される、1つ以上のプログラム・モジュール。アプリケーションは、他のアプリケーションにネストできる。たとえば、業務システムを制御するアプリケーションには、データ入力用のさまざまなForm Builderアプリケーションやそのデータを視覚的に表示するさまざまなGraphics Builderアプリケーションを含めることができる。


1. プログラム単位が継続して作動するようにプログラム単位に渡される任意の式。
2. キーワードおよびキーワードの指定値を含む句。


情報交換用の米国標準コード。American National Standard Code for Information Interchangeの略称。


読込み専用のPL/SQLサブプログラムの集合であり、通常アプリケーションと共に提供され、必要なPL/SQLソースを提供する。連結ライブラリ内のプログラム単位は、コンパイル時または実行時に他のプログラム単位によって初めてコールされたときに、暗黙的にロードされる。それらのプログラム単位は、再度必要になったときにすばやく利用できるように、ロードされた状態になっている。このため、実行時のメモリの使用量を節約し、アプリケーションのパフォーマンスを改善することができる。「ライブラリ（library）」も参照。


1. 「プロパティ（prorety）」を参照。
2.  Oracle8オブジェクト・タイプ定義の一部またはコンポーネント。各属性には、名前とOracle8データ型がある。オブジェクト表がオブジェクト・タイプに基づいて作成される場合、表内の列は、オブジェクト・タイプ定義内の属性に対応する。リレーショナル表内の列オブジェクトがオブジェクト・タイプに基づいて作成される場合、その列オブジェクトにはサブ列と同等のものが含まれ、それぞれがオブジェクト・タイプ定義内の属性に対応する。表内の各Oracle8オブジェクト属性が、別の列であるかのように異なるデータ項目として扱われる。このことは、リレーショナル表内のオブジェクト表と列オブジェクトについてもあてはまる。
3. （Oracle Express） ディメンション値によって共有される記述子の特徴。属性は論理グループ分けを表し、これによってユーザーは、同類の特徴を基にデータを選択できる。たとえば、履き物を表すデータベースでは、履き物の色という属性を使用することにより、同じ色を共有するすべてのブーツ、スニーカーおよびスリッパを選択できる。


列オブジェクトを構成する列（Oracle8）。


Graphics Builderでは、属性記述子内の最初の要素。その後のファンクション・コールで設定または取り出される属性のツールキットに知らせる32ビットのマスク。属性マスク内に対応するビットが設定されている要素のみが設定または取り出される。


（Oracle Express） 属性および属性値を基準にしてディメンション値を選択できる「セレクタ」ダイアログ・ボックスのツール。たとえば、ソフト・ドリンクを表すデータベースでは、サイズが1リットルの全製品を選択する場合もある。その場合、「サイズ」が属性で、「1リットル」が属性値である。


（Oracle Express） 属性を構成する、データベース内の値。たとえば、アイスクリーム製品を表すデータベースでは、バニラ、チョコレートおよびストロベリーといった属性値は、製品ディメンションの味属性に属する場合がある。ブランド、形態およびサイズなど、製品ディメンションのさまざまなレベルにおけるディメンション値は、味について同じ値を共有する場合がある。


チャートの1種であり、軸と呼ばれるチャートの境界線のどこにデータが位置するかに基づきデータが表示される。軸チャートには軸が2つまたは3つあり、それぞれが項目軸、値軸または日付軸のいずれかになる。


パターンの白い部分。バックグラウンド要素に色を付けるには、「塗りカラー」パレットを使用する。


オペレーティング・システム環境で実行され、サービスやアクションを行う非対話形式のプロセス。一部のOracle製品では、データベースを同時に使用するユーザーのための作業の実行と調整、電子メッセージの処理と配布、印刷サービスの管理など、さまざまな作業にバックグラウンド処理を使用する。


チャートの値軸上の表示フィールドの始点として使用される値。


ウィンドウ・システムを使用せずにバッチ・モードでアプリケーションを実行する実行可能プログラム。


いくつかのPL/SQLプログラム単位をマシンが実行できる形式に一度に変換する。


PL/SQL構成体またはSQL SELECT文内のあらゆる位置に出現する単一のリテラル値（文字列、数値、日付など）の置換に使用されるパラメータへの参照。バインド参照の際には、パラメータ名の前にコロン（:）を付ける必要がある。


PL/SQLパッケージ以外で作成し使用できるグローバル変数。


1. キーワードDECLARE、BEGIN、EXCEPTIONおよびENDで定義される、PL/SQL内の基本的なプログラム単位。
2. Form Builderでは、データベース表またはビューに関連する論理コンテナ。


1. プログラム単位の仕様部と同じ情報が入っており、サブプログラムの実際のインプリメンテーション（そのアクション順序）も含む。ほとんどの場合、1つのサブプログラムには、本体を1つのみ定義する必要がある。
2. Report Builderでは、レポート・レイアウトの大部分（テキスト、図形、データおよび計算）を含む領域。レポートのボディは、レポートのヘッダー・ページとトレーラ・ページの間に表示される。


レポートが実行されるたびにレポート内に表示されるテキストまたは図形（あるいはその両方）。一部の製品では、「一定の」テキストまたは図形と呼ばれる。


レイアウト・オブジェクトの周辺のユーザー定義のアウトラインであり、通常その内容を強調表示するために使用する。境界線は、幅の半分がオブジェクトの枠の外側、もう半分が内側になるように描かれる。


「内側枠ボックス（inner bounding box）」および「外側枠ボックス（outer bounding box）」を参照。


1つの軸に沿って2種類のデータを表示する軸チャート。


ブレーク・グループに割り当てられた問合せ列。


レポート・データのブレークまたは分類に使用されるグループ。ブレーク・グループに割り当てられた問合せ列のデータは、すべて別のグループに属する列のデータの上に表示される。ブレーク・グループにフェッチされた各レコードは一度しか表示されないが、別のグループの複数の関連レコードは表示できる。


レポート・データの集合を分類する項目を含むレポート。


ブレーク・ポイントに達するたびに実行されるPL/SQLブロック。「ブレーク・ポイント（breakpoint）｣も参照。


PL/SQLサブプログラム内のあらゆる実行可能ソース行にセットできるデバッグ・アクション。ブレーク・ポイントはプログラム単位の実行を中断し、制御をPL/SQLインタプリタに渡す。ブレーク・ポイントを使用すると、サブプログラムをステップごとに実行し、ランタイム・エラーを探すことができる。「ブレーク・トリガー（break trigger）」も参照。


特定の形式のドキュメントを作成するために使用されるコンポーネントを指す。たとえば、フォームの作成にはForm Builderが、レポートの作成にはReport Builderが使用される。


Oracle Serverによって定義およびサポートされるデータ型。


PL/SQL言語に対する拡張機能の集合であり、ソフトウェアで使用されるように設計されている。ビルトインには、データ型、プロシージャ、ファンクション、例外および定数が含まれる。


Project Builderでは、マクロはProject Builderに付属している。「マクロ（macro）｣も参照。


コンピュータと周辺機器、またはコンピュータの部分間でデータを転送する間、データを一時的に格納する領域。バッファにより、転送の速度またはタイミングの違いによる情報の損失を防ぎ、一部の機能が高速化される。


1. アクション項目の選択、ダイアログボックスの表示、または現行の条件の確認に使用されるインタフェース要素。
2. 関連するPL/SQLプロシージャをもつ、アプリケーション内のオブジェクト。通常、ユーザ・マウス・イベントに基づいて実行される。


アプリケーション・オブジェクトに関連するPL/SQLプロシージャであり、実行時にその項目で特定のマウス・イベント（ボタンのクリックなど）が発生すると実行される。これは、ブレーク・グループを含む、フェッチされたデータの階層を確立することによって行われる。


現在、ユーザーからアクセスまたは変更されているデータベース上のデータ、またはOracle Serverがユーザーのサポートに必要とするデータのための、一時的な格納領域。これらの用語は同義で使用されることが多い。


Forms DeveloperおよびReports Developerコンポーネントの実行可能プログラムを他のOracle製品や3GLプログラムから起動させるためのインタフェース。


最初のエントリ・ポイントから現在実行しているサブプログラムに対する、一連のサブプログラム・コール。各サブプログラム・コールは、下に伸びるコール・スタック上の枠によって表され、新規に入力されたサブプログラムはスタックの一番下に追加される。


   「エディタ（editor）」を参照。


Form Builderでは、ユーザーがランタイム・アプリケーションで対話を行うインタフェース・オブジェクトを配置するバックグラウンド・オブジェクト。キャンバス・ビューは、通常、ウィンドウに対応付けられる。


オープンAPIを通じてクライアント、アプリケーション・サーバーまたはデータベースにプラグインできる、管理可能なオブジェクト。


「スタイル・シート（style sheet）」を参照。


非階層型の図表やその断片などの情報の種別を、感性レベルではなく、可能とするラベル・コンポーネント。分類された種々の情報へのアクセスを個別に制限する手段として使用される。


「項目軸（discrete axis）」を参照。


スプレッドシート内のデータのインスタンス（Microsoft Excelなど）。


Common Gateway Interfaceの略称。アプリケーションをWebサーバー上で実行するための、業界標準の技法。Webサーバーで検索される標準のHTMLドキュメントは静的であるが（まったく同じテキストが毎回検索される）、CGIにより、プログラムがWebサーバー上で稼働して別のコンピュータと通信を行い、ユーザーが入力する情報に応えて「動的な」HTMLドキュメントを生成することが可能になる。


コンピュータ・グラフィックス・メタファイル。国際的に認められたファイル形式で、オブジェクト指向の図形の保存や、システムまたはプログラム間の転送に使用される。


ANSI/ISO互換のために提供されているOracleデータ型の1種。CHAR列は固定長の列で、A、3、&、ブランクなどの印字可能文字を含むことができ、1～255個の半角文字やNULLを入力できる。


フィールドに対する単一の値を示す、横棒、線、記号、その他の図形オブジェクト。


Graphics Builderチャートをフォームまたはレポートに埋め込むのに使用されるあらゆるサイズの境界のある四角形。


チャートの書式を定義する属性とプロパティの集合。


小さな四角形として表示されるインタフェース要素であり、ユーザーはこれをオンまたはオフに切り替えることができる。


エラーチェックのアルゴリズム。


1. グループの1メンバーであり、グループ・ツリー内でそのグループ・オブジェクトのすぐ下に位置するオブジェクト。グループ・オブジェクトを構成するオブジェクトは、そのグループの子である。どのオブジェクトも、その親オブジェクトの子になる。
2. （Oracle Express） 階層内にある特定値のすぐ下のレベルのディメンション値。子の値は、親の集約合計を生成する計算に組み込まれる。ディメンションに複数の階層が含まれる場合、ディメンション値は複数の親の子である場合がある。次の例は、GEOGRAPHYディメンション内で、"France"の子としてのディメンション値"Lyon"と"Paris"を示している。


「ディテール問合せ（detail query）」を参照。


ラベルの付いた、情報の感度を示す階層レベル。分類は、情報へのアクセスを制限する手段として使用される。


文全体を構成しない、SQL文の一部。たとえば、「WHERE句」。


別のアプリケーションまたはコンピュータ（「サーバー」）のサービス、データ、処理などを要求するユーザー、ソフトウェア・アプリケーションまたはコンピュータ。2タスク環境では、クライアントはユーザー・プロセスである。ネットワーク環境では、クライアントはローカル・ユーザー・プロセスであり、サーバーはローカルまたはリモートの場合がある。


2つのCPU間の処理の分離。1つはトランザクション内でサービスを提供するサーバーとして、もう1つはトランザクション内でサービスを要求して受けるクライアントとして稼働する。共有データ管理の仕事は、すべてデータベース管理システムを実行しているコンピュータによって処理されるので、データベース・アプリケーションを実行しているワークステーションは、データの解釈と表示専用になる。


メモリー・バッファ。オブジェクトは、別のオブジェクトをカットまたはコピーするか、またはアプリケーションを終了するまで、クリップボードに残る。


すべてが同じデータ型で、数に制限のない要素によって構成されるデータ単位を記述する、ユーザー定義データ型。可変配列型および表タイプは、コレクション・タイプである（Oracle8）。


Forms Developerの実行可能プログラムのコマンド・ライン引数のセットが入ったファイルを指定できる引数。


ウィンドウ・システム、描画面、またはウィンドウおよびそのビューに利用できるすべての色を含む。


1. データの特定のドメインを表す、データベース表内の垂直方向の領域。列には列名（ENAMEなど）があり、特定のデータ型（CHARなど）を持っている。たとえば、従業員情報の表で従業員名のすべてが1つの列を構成するなど。レコード・グループ列は、データベースの列を意味する。
2. Report Builderでは、問合せのSELECTリスト内の列のそれぞれの式に対し自動的に作成されるか、集計や式を実行したりプレースホルダーとして稼働するために手動で作成されるデータ・モデル・オブジェクト。


Oracle8のリレーショナル表またはオブジェクト表で、定義がオブジェクト・タイプに基づいている列。列は複合列で、その構成部分は、オブジェクト・タイプの属性に対応する。


オペレーティング・システムのコマンド・ライン。ほとんどのOracle製品は、いくつかの実行プログラム引数を使用して、コマンド・ラインから起動できる。


プログラム内に説明文を含めるための言語要素。これを実行しても影響は出ない。


データベース内のデータの変更を永続的にすること。変更が確定されるまでは、変更情報を格納したり、データを前の状態に復元できるように、新旧のデータが存在する。


（Oracle Express）

>	より大きい

<	より小さい

=	等しい

<=	以下

>=	以上

<>	等しくない

数値の場合、オペランドは最小共通型に拡大される（IntegerはLongに優先し、LongはSingleに優先し、SingleはDoubleに優先する）。文字列の場合、比較は大/小文字が区別され、Windowsのコントロール・パネルで指定する言語によって使用される照合順番に基づいて行われる。結果はFALSEが0でTRUEが-1になる。


ソース・プログラムを、バイナリの実行可能な形式に変換すること。PL/SQLプログラム単位は、実行する前にコンパイルする必要がある。


大規模アプリケーションの一部である特定のターゲット・オブジェクト。｢ターゲット（target）｣も参照。


異なるデータベース・アプリケーションや同じアプリケーションを実行する複数のユーザーによる、同じデータの同時アクセス。データベース・ソフトウェアで並行性を保つには、すべてのユーザーが首尾一貫したデータを参照できることと、すべての変更が適切な順序で行われることを保証するロジックを追加する必要がある。


X> 100のように、値が真か偽である式。たとえば、式で真を評価させた行のみを表示するための問合せを行う場合、問合せに条件を設定します。


子オブジェクトが親オブジェクトの内外で移動またはサイズ変更されることを防ぐレイアウト・エディタ・モード。


データベースへログインすること。問合せを作成または変更したり、データベースに格納されているアプリケーションにアクセスする場合は、接続する必要がある。


SQL*Netがネットワーク上の特定のOracleインスタンスへの接続に使用する、プロトコルを含むパラメータの集合。


オブジェクト・レベルやアプリケーション・レベルではなくデータベース・レベルで実施される、一定のデータに関する規則または制限（列でのNOT NULL制限など）。


PL/SQLコードの構成体。構成体には2つのタイプがある。値無し構成体は値を戻さず、値付き構成体は値を戻す。


Oracle Serverが現行のSQL文を格納する作業領域。文が問合せの場合には、結果の列ヘッダーと結果が入る１行。カーソルとも呼ばれる。


1つの値で始まり、別の値に達するまで継続する値を表示する軸。したがって、これらの値は、数学的に関連付けられている依存データは、通常、値軸とも呼ばれるこの軸に沿って表示される。


オブジェクトの理想的な形を構成する、垂直の四角形の4隅の点。レイアウト上のオブジェクトを選択すると、その制御ポイントが表示される。選択するオブジェクトによっては、制御ポイントをドラッグして、オブジェクトを変更できる場合がある。


描画が行われる2次元の格子。


レイアウト・エディタ・ビューでのオブジェクトの配置とサイズ設定に使用される、x，y単位のタイプ。利用できる座標システムは、1) プラットフォーム固有の文字セル・サイズを使用する文字、2) 単位がピクセル、センチメートル、インチまたはポイントである実際単位。


オブジェクトがレイアウト内で表示されるための位置を示す点。x座標とy座標により、オブジェクトの水平方向（x）と垂直方向（y）の位置が決まる。


必要に応じエディタ内の別の位置にペーストできるように、選択されたオブジェクトの複製をクリップボード上に保管すること。


親問合せと同じ表に基づく副問合せ（たとえば、その親問合せに含まれる表の中にある列の参照など）。


2つ以上の他のグループを所有し、数学的なクロス積を実行する（それらの間の値を相関させる）グループ。


｢マトリックス･セル｣を参照。


1. マウスの位置を示す小さなアイコン。カーソルの形は、選択するツールによって異なる。
2. 問合せにより取り出されるデータに対する内部ポインタ。カーソルは、一度に1行のデータしか指さない。ただし、ビルトイン・サブプログラムを使用すると、カーソルをデータ・セットの任意の行に移動できる。


（Oracle Express） ユーザーが作成する式で、これによってデータ解析を細かくチューニングできる。データベース内のベース基準を使用して、カスタム基準を作成できる。たとえば、データベース内にVolume Shareという既存の基準がある場合、この基準を使用して、Volume Share Year Agoという名前のカスタム基準を作成できる。このカスタム基準では、製品の前年度からの全体シェアを見ることができる。


1つ以上のオブジェクトを削除し、必要に応じエディタ内の別の位置にペーストできるようにそれらをクリップボードに保管すること。


ビューは、その全体または一部が他のビューにより遮られると破損する。


データベースの管理者により所有される一組の表およびビュー。Oracle Serverやその他のリレーショナル・データベースの中核となる情報ソース。


グループと問合せ間でマスター/ディテール（親子）関係を定義するのに使用されるデータ・モデル・オブジェクト。


データベースからどの値をフェッチすべきか、どの値を計算すべきか、データをレポート内でどのように順序付けるべきかを定義するリレーショナル・モデル。データ・モデルを定義するReport Builderオブジェクトは、問合せ、グループ、列、パラメータおよびリンクである。


ビューは、その全体または一部が他のビューにより遮られると破損する。


Project Builderにおいて、オープン・オブジェクトの構造を制御するプロジェクト項目を示す、プロジェクト・ナビゲータ内のノード。たとえば、「グローバル・レジストリ」ノードはグローバル・レジストリを示し、ローカル・レジストリのリストとグローバル・タイプ定義のリストが含まれている。


ユニットとして扱われる、一組のディクショナリ表とユーザー表。


トリガーを実行するINSERT、UPDATEまたはDELETE文がデータベースのリレーショナル表に対して発行されたときに、暗黙的に実行される保存済みのPL/SQLブロック。｢デバッグ・トリガー（debug trigger）｣も参照。


データの標準の書式。共通のOracleデータ型には、CHAR、VARCHAR2、DATE、NUMBER、LONG、RAWおよびLONG RAWなどがある。


Oracle Serverのデータ型の1つ。日付列には、紀元前9999年1月1日から西暦9999年12月31日までの日付と時刻が入る。


1つの日付から始まり、別の日付に達するまで続く日付の値を表示する軸。


プログラム内のランタイム・エラーを検出して診断し、削除すること。


PL/SQLサブプログラム内に配置されるユーザー指定のイベントであり、通常ランタイム・エラーのトラブルシュートを目的とする。


PL/SQLサブプログラムのどの実行可能ソース行にも配置できる、条件付きのデバッグ・アクション。指定条件が満たされると、サブプログラムの実行が再開される前に、指定したアクションが実行される。｢データベース・トリガー（database trigger）｣も参照。


テストとデバッグに使用される、ソフトウェアでのProcedure Builderの機能。


Oracle8では、オブジェクト・タイプとオブジェクトは複合要素であり、構成要素と属性によって構成される。Forms DeveloperおよびReports Developerでは、個々の構成要素または属性を、独立した、個別に選択できるデータ項目として扱う。このような扱い方によって、分解オブジェクトが生成される（フラット化オブジェクトとも呼ばれることもある）。オブジェクトはDeveloper環境内において、同類のエンティティではない。


値が他のデータに依存するデータ。たとえば、ある従業員の就業年数は値10であるが、それはその従業員の名前の値と依存します。値データとも呼ばれる。


ユーザーが必要なコマンド・パラメータや属性を指定しない場合にシステムにより提供される値。


配布と実行のために完成されたアプリケーションを用意し提供すること。


Project Builderにおいて、Project Builderがプロジェクト内で参照されるファイルをどのようにコンパイルするかを決定するために使用する機構。ツリーの左上の項目は、右下の項目に依存している。たとえば、ヘッダー・ファイルが古いか、またはそれを使用して構築する実行可能ファイルより新しいと、Project Builderでは、Buildコマンドを受けて、実行可能ファイルが再構築される。依存性はサブプロジェクトにも当てはまる。たとえば、関数ライブラリを含むサブプロジェクトが再構築されていると、Project Builderは更新されたライブラリ関数を使用するため依存プロジェクトを再構築する必要があることを「理解する」。｢依存性表示（dependency view）｣も参照。


Project Builderでは、プロジェクト・ナビゲータ内のファイルをそれらが互いに依存する順に表示（プロジェクト・ノードを階層の最上位に、その後にターゲット・ノードを、続いてそれらのターゲットの構築可能コンポーネントを配置）する。たとえば、実行可能フォームは.fmbファイルに依存してこれに先行し、.fmbファイルはUSEREXITプロシージャが使用するライブラリに依存してこれに先行するなど。｢プロジェクト表示（project view）｣、｢ターゲット（target）｣も参照。


1. 別のオブジェクトのグループ・ツリー内で、そのオブジェクトより下位に現れるオブジェクト。どのオブジェクトも、その上位項目の依存項目になる。
2.（Oracle Express）階層内の特定の値より小さいレベルのディメンション値。子孫の値は、その祖先の集約合計を生成する計算に組み込まれる。次の例は、GEOGRAPHYディメンション内における、"Europe"の子孫としてのディメンション値である"France"、"Lyon"および"Paris"を示している。


Forms DeveloperおよびReports Developerアプリケーションのさまざまなコンポーネントを設計するためのインタフェース。


「Oracle Designer」を参照。


アプリケーション・モデリング、設計および生成のツールセット。Oracle Designerを使用すると、Oracleリポジトリに記録されているモジュール定義からフォームとメニューを生成できる。


マスター/ディテール・レポートを定義する際、ディテール問合せはマスター（親）問合せにより取り出された各レコードに対するすべての関連レコードを取り出す。


操作を完了するために必要な情報の入力を求める、部分的な画面またはウィンドウ。


コンパイラにより生成される、プログラム単位の中間的な表現。DIANAには、コンパイルされるプログラム単位の構文上と意味上の情報がすべて含まれている。参照をプログラム単位にコンパイルするため、コンパイラは参照先のプログラム単位のDIANAへのアクセスを必要とする。たとえば、プログラム単位Aがプログラム単位Bをコールする場合、BのDIANAが使用可能でなければ、Aをコンパイルできない。


（Oracle Express） データのカテゴリを提供する値のリストである、データベース・オブジェクトのタイプ。ディメンションは、変数の値を識別する索引として機能する。たとえば、月ごとに個別の販売金額が記録された販売データがある場合、そのデータにはMONTHディメンションがある。つまり、データが月別に分類される。ディメンションはリレーショナル・データベースにおけるキーに似ている。

マルチディメンションの変数内にある任意のデータ項目は、変数の各ディメンションから1つのメンバーを指定することにより、一意におよび完全に選択できる。たとえば、販売変数がMONTH、PRODUCTおよびMARKETによってディメンション化されている場合、MONTHディメンションで"January"、PRODUCTディメンションで"Stereos"、MARKETディメンションで"Eastern Resion"を指定すると、変数内の1つのセルが一意に指定される。このように、ディメンションによって、データの取出し、更新および計算について、データを編成および選択するための、正確で、直感的な方法が提供される。

ディメンションは、1つのテキストまたは整数値などの単純な値から、他のディメンションの値を組み合わせた値など、連結した値の場合もある。複合は、ディメンションではないが、散在する値を処理する目的でExpressによってディメンションのように扱われる、連結に似た内部オブジェクトである。


（Oracle Express） ディメンションを構成するリスト内の1つの要素。たとえば、コンピュータ会社のPRODUCTディメンションでは、"LAPPC"および"DESKPC"と呼ばれるディメンション値を持つ場合がある。GEOGRAPHYディメンション内の値には、"Boston"および"Paris"などが含まれる場合がある。また、TIMEディメンション内の値には、"MAY96"および"JAN97"などが含まれる場合がある。


メニュー項目、ボタンなどを表す、インタフェース要素の状態。現行のコンテキストでは使用不可。つまり、キーボードやマウス入力には応答しない。


固有の値を固定した間隔で表示する軸。これらの値は、数学的に関連付けられていない。通常、独立データは、項目軸とも呼ばれるこの軸に沿って表示される。


チャート、イメージ、テキスト・オブジェクトおよび形のあらゆる組合せを含むGraphics Builderドキュメント。


Form Builderでは、PL/SQLでプログラムに基づいてフェッチまたは割り当てる必要のある情報を格納または表示する項目。


これはコール・スタックに属するため、この中では新規に入るサブプログラムはスタックの最下部に追加される。最初のプログラム・エントリ・ポイントに対応する最も古い枠は、スタックの一番上に、最も深くネストされたサブプログラム・コールと関連付けられた最新の枠は、スタックの一番下にある。


マウス・ボタンを押したまま、マウス・ポインタをウィンドウ内の特定の位置にスライドさせること。


（Oracle Express） 階層を持つディメンション内の集約のレベルを上下にナビゲートすること。ディメンション値を選択したり、データを表示したりするとき、ディメンション階層内でドリル・ダウンまたはドリル・アップすることにより、階層を拡張または縮小できる。ドリル・ダウンによってビューが拡張され、ディメンション階層内にある親の値に関連付けられている子の値も表示される。ドリル・アップによって、ディメンション階層内にある親の値に関連付けられている子の値のリストが収縮される。

階層をドリル・ダウン（拡張）するにはプラス・アイコン( [image])をクリックし、ドリル・アップ（縮小）するにはマイナス・アイコン( [image])をクリックする。

セレクタ内では、ドリル・アイコン( [image])をクリックして「ドリル」ダイアログ・ボックスを表示し、ディメンション全体の詳細レベル選択できる。


クリップボードの内容を変更することなくレイアウト上のオブジェクトを直接コピーできるオプション。


（Oracle Express） 評価されるたびに異なるディメンション値を持つことのできる保存済み選択項目。選択されたディメンション値は、使用ごとに異なる場合がある。対照的に、静的な保存済み選択項目は、ディメンション値の変化しないリストである。動的な保存済み選択項目のスクリプトには"Select the last three Months"などのように文が記述されるが、静的な保存済み選択項目のスクリプトには、"Select February 1996, March 1996, and April 1996"といったように文が記述される。


拡張2進化10進符号（Extended Binary-Coded Decimal Interchange Code）の略称。


オブジェクトの境界。


境界線、塗りおよびテキスト・パターンと色の現行の設定を表示する、レイアウト・エディタのツール・パレット上の表示ボックス。


プログラム単位の作成やアプリケーションの設計など、一連の特定のタスクを実行する作業領域。


情報を記録する必要があるかもしれない重要な事柄。要素は、属性および他の要素との関係で記述される。


ディクショナリ内に保持される要素はすべて、特定のタイプに分類される。要素タイプには、エンティティ、属性、プログラム・モジュール、表、ダイアグラム、テキスト、ソフトボックスなどがある。これらのオカレンスまたはインスタンスは、要素と呼ばれる。


（Oracle Express） 実行しようとしているタスクに関連のあるダイアログ・ボックスを表示する。通常はそこで1つ以上の必要な値を選択する。


メニュー項目、ボタンなどが現行のコンテキストで使用できる（つまり、キーボードやカーソルおよびマウスの入力に応答する）ことを表すインタフェース要素の状態。


別のオブジェクトを含むオブジェクト。オブジェクトは、次の条件をすべて満たす場合に限り、別のオブジェクトに囲まれると見なされる。両方のオブジェクトが同じ領域に属している（ボディまたはマージン、ヘッダー、トレーラ）。2つのオブジェクトの外側のものが、枠または繰返し枠である。2つのオブジェクトの外側のものが、もう一方の後ろにある。2つのオブジェクトの内側のものが、完全にもう一方の境界線内にある。両方のオブジェクトが同じ領域に属している（ボディまたはマージン、ヘッダー、トレーラ）。2つのオブジェクトの外側のものが、枠または繰返し枠である。2つのオブジェクトの外側のものが、もう一方の後ろにある。2つのオブジェクトの内側のものが、完全にもう一方の境界線内にある。


意図された受取人のみがデータを暗号解除し、読めるようにデータを暗号化すること。


一般的に使用されるツールおよびそれらの構成情報を含む、ユーザーのコンピュータ･ベースの作業場所。Project Builderにおいて、Forms Developerアプリケーションの開発関連のさまざまな作業を完成するのに使用される、ツールのサブセットを指す。


PL/SQLサブプログラムから生成される警告またはエラーの状況。


（Oracle Express） 指定期間を満たすデータに関連付けられたディメンション値を選択できる「セレクタ」ダイアログ・ボックスのツール。たとえば、ボストン市場で1995年の12月23日で終わる週に、ドル売上高が10,000ドルを超えるすべての製品を選択するといった操作もできる。


'OPENFILE=my_disp'や'PRINT=YES'など、製品の実行可能プログラムに渡すことができる引数。これらの引数は、通常実行可能プログラムがコマンド・ラインから起動される際に指定される。


「実行（run）」を参照。


オブジェクト、モジュール、選択されたテキストやイメージのコピーをファイルやデータベースに格納すること。Project Builderにおいて、プロジェクト、タイプ、アクションまたはマクロ（あるいはそれらすべて）の定義が含まれるファイルを、異種プラットフォームで作業する他のクライアントに配布できる移植性のある形式で書くプロセス。「エクスポート・ファイル（export file）」、「インポート（import）」も参照。


Project Builderにおいて、プロジェクトのエクスポートにより作成された共有可能な移植性のあるファイル。


1. 変数、定数、リテラルおよびそれらの値による操作を結合したPL/SQL構成体。
2.（Oracle Express） Express言語プログラム内で指定される1つ以上のデータ値。たとえば、式をプログラムまたは関数の引数として指定できる。式は次のいずれかである。

•	単一のリテラル値（10など）

•	1つ以上の値を含む変数または式

•	1つ以上の値を返す関数

•	変数、式または関数などの値を、算術演算子またはブール演算子と組み合せる計算


「ライブラリ（library）」を参照。


他のOracle製品により参照可能なANSI規格のSQL SELECT文。


（Oracle Express） ディメンション階層のレベルに対応する、関連のあるディメンション値のグループ。ファミリ内のディメンション値は、祖先、親、子および子孫としてお互いに関連付けることができる。次の例では、GEOGRAPHYディメンション内のディメンション値"France"についてのファミリ・リレーションを示す。


（Oracle Express） 特定階層のディメンション値のファミリを選択できる、「セレクタ」ダイアログ・ボックスのツール。ファミリには、1つの親とその子孫にあたるディメンション値すべてが含まれる。たとえば、GeographyディメンションにあるChicago市場レベル以下のファミリ・メンバーをすべて選択できる。


1. その中でデータの入力、編集および削除が可能なインタフェース要素。2. Graphics BuilderおよびReport Builderでは、特定の問合せ列のデータがどのように表示されるかを定義するレイアウト・オブジェクト。


Graphics Builderでは、独立データ（値）が横棒や線のようなチャート・フィールドとしてどのように表示されるかを決定する、属性およびプロパティの集合。


Project Builderにおいて、ファイル・システム内に格納されたファイルを示す、プロジェクト・ナビゲータ内のノード。たとえば、グローバルおよびローカル・レジストリ・ノードは、それぞれグローバルおよびローカル・レジストリ・ファイルに対応する。


塗り（色またはパターン）が適用される、オブジェクト内の領域。


グループによりデータが表示されることを制限する、PL/SQL関数または無名関数。


ローカル・エリア・ネットワーク上のコンピュータに対する外部からのアクセスと、ローカル・エリア・ネットワーク内から外部のコンピュータへのアクセスを規定するコンピュータ。


「分解オブジェクト（deconstructed object）」を参照。


子オブジェクトが移動またはサイズ変更される際に親オブジェクトのサイズ変更または縮小を自動的に行い、オブジェクトの位置変更やサイズ変更により影響される可能性のある他のレイアウト・オブジェクトの位置を調整するレイアウト・エディタ・モード。


ユーザーまたはクライアントからの入力に応答できるエンティティ状態。エンティティは、キーボード・フォーカスを持っていれば、ユーザーがキーを押したときにイベントを受け取れる。描画ビューは、描画フォーカスを持っていれば、描画に影響を与えるクライアント・ルーチンに応答できる。


パターンの黒い部分。フォアグラウンド要素に色を付けるには、「線カラー」パレットを使用する。


別の表の主キーを参照している、1つの表内の値または列。


Report Builderにおいて、ラベルがフィールドの左に、各レコードが別々の論理ページに表示される、デフォルトのレイアウト・スタイル。


Report Builderにおいて、ボイラープレートとフィールドを混在させ「ワード」ブレークで行を折り返すデフォルトのレイアウト・スタイル。


（フィールド・プロパティ） フィールドの値の表示状態を定義する設定。たとえば、書式マスクは、金額や日付の表示を指定するのに使用される。


オブジェクトのフォーマット属性の動的な変更を可能にするPL/SQL関数。


（Oracle Express） 値を生成するストアド計算、ストアド式またはストアド・プロシージャを表すデータベース・オブジェクトのタイプ。データ内の複雑なまたは頻繁に使用されるリレーションを、データ自体を再保存せずに定義および保存する方法は、式によって提供される。式を使用するたびに、値の生成に必要な計算またはプロシージャはExpressによって実行される。


PL/SQLのファンクションまたは式、ユーザー・イグジット、SQL文またはこれらのあらゆる組合せからそのデータを獲得するユーザー作成の列。


1.Graphics Builderにおいて、チャートの基本構造を定義するがデータの表示方法は決定しない、チャート・テンプレートの一部。
2.Report Builderにおいて、他のレイアウト・オブジェクトを囲み複数のオブジェクトのフォーマット、周期および位置を同時に制御するのに使用されるレイアウト・オブジェクト。


アクションの指定されたシーケンスを実行して値を返すPL/SQLサブプログラム。クライアントおよびデータベース・サーバーに存在し、実行することができる。


アプリケーションを、ランタイム実行可能プログラムおよびバッチ実行可能プログラムで実行できるバイナリ形式でファイルまたはデータベースに保存すること。


実行可能なForm Builder。アプリケーションをバイナリ形式でファイルやデータベースに保存するときに使用される。


Forms DeveloperおよびReports Developerインストールの全体に共通した情報を格納するProject Builderレジストリ。この情報は、タイプ定義と、それに関連付けられたアクションおよび、事前定義済みまたはユーザー定義のプロパティに限られる。グローバル・レジストリの使用はオプションである。グローバル・レジストリのファンクションは、個々のユーザー・レジストリにより実行することができる。「レジストリ（registry）」、「ユーザー・レジストリ（user registry）」も参照。


アプリケーション内に存在する論理コンテナ。アプリケーションがグローバル変数を使用する場合、その変数は、アプリケーションを終了するまで、または別のオブジェクトがその変数を明示的に削除するまで、保持される。


ユーザーに、モジュールに対するアクセス権限を与える。アクセス権限を他のユーザーに付与できるのは、モジュールの作成者のみである。


Graphics Builderでは、レイアウト・エディタ内の行と列を分離する線。


1. いくつかの他のオブジェクトから構成されているオブジェクト。
2. Report Builderにおいて、問合せにより選択されているすべての列を含むため自動的に作成されるか、レポート内に現れるデータの階層を変更するためにユーザーにより作成されるデータ・モデル・オブジェクト。主に、レポート内でのブレークの作成と計算のリセットに使用される。
3.Project Builderにおいて、ランチャ外のサブメニューを介して利用できる関連項目の集合。グループによりユーザーは、他の項目またはグループ（あるいはその両方）を表示するためにポップアップする任意の「グループ」をエントリとして、ランチャをWindows95の「スタート」メニューに似せてセットアップできる。たとえば、ユーザーはプロジェクト計画、作業リスト、コンポーネント仕様などを含む「Project Docs」というグループを定義し、.TXTファイルや.DOCファイルなどを含めることができる。


グループによりフェッチされるデータを制限するPL/SQL関数。


「ファミリ・ツリー」に類似した階層モデルで、グループ・オブジェクトとそれらを構成するオブジェクトの関係を表す。


グラフィカル・ユーザー・インタフェース。プログラムの入出力を表す以外に、ピクチャを使用することを意味する。GUIのあるプログラムは、ウィンドウ・システム（X Windows、Microsoft Windows、Apple Macintoshなど）上で稼働する。GUIプログラムは、アイコンやボタンなどを画面上のウィンドウに表示する。ユーザーは、GUIプログラムを主に画面上のポインタ（通常マウスで制御される）を移動して制御する。ビットマップ・インタフェースとも呼ばれる。


アプリケーション・オブジェクトに対する内部ポインタ。PL/SQLプログラム単位内のオブジェクトを参照するには、適切なサブプログラムに、引数としてそのハンドルを渡す必要がある。


テキスト、図形、データ、計算など、レポートの紹介内容を入れることができるオプションのレポート領域。レポートには、ヘッダーが最初に表示され、ボディとトレーラがそれに続く。


レポート内に含めたりレポートに関連付けることができるオブジェクトのタイプを示す、オブジェクト・ナビゲータ内のノード。ヘッダー・ノードを選択しても、レポート内のオブジェクトは選択されない。


（フィールド・プロパティ）  Report Builderが、示されたフィールドをレイアウト内のその位置で禁止するかどうかを指定するプロパティ。「非表示」が指定されると、フィールドの値は（&fieldnameにより）テキスト・オブジェクト内で参照される位置のみ表示される。


（Oracle Express） データを編成および構造化するための方法。ディメンション内の値が複数のレベルに配置され、各レベルがその下位レベルからのデータの集約合計を表している場合、階層が存在する。一部のディメンションは、それらに基づく複数の階層を持つ。

次の例は、GEOGRAPHYディメンションに基づく階層を示す。ここでディメンション値は、5つのレベルで配置されている。CustomersレベルのデータはCitiesレベルに集約され、Citiesレベルのデータは、Countries/Areas、Continents/RegionsおよびGlobalの各レベルに集約される。


Hypertext Markup Languageの略称。インターネット上のWebサーバーの他のドキュメントに対するコンテンツとリンクを指定するのに使用される、タグ・ベースのASCII言語。エンド・ユーザーは、WebブラウザによりHTMLドキュメントを表示させ、リンクに従って他のドキュメントを表示させる。


Hypertext Transfer Protocolの略称。WWWブラウザを有するコンピュータとアクセスされるWWWサーバー間のWWW通信データを搬送するのに使用されるプロトコル。


1つの文書のある位置から、別のドキュメント（のある位置）や同じ文書内の別の場所への参照（リンク）。Webブラウザでは、通常区別ができる方法（異なる色、フォント、スタイルなど）によりハイパーリンクが表示される。ユーザーが（マウスをクリックして）ハイパーリンクを実行すると、ブラウザがリンク対象を表示する。


クロス・リファレンスを含むドキュメントの集まりであり、これを使用するとWebブラウザによりドキュメント間の移動を簡単に行うことができる。


Webブラウザを使用することにより、ドキュメント間を簡単に移動できるクロス・リファレンス。


インタフェースC定義。Cにインプリメントされた機能に対するPL/SQLアプリケーションのプログラミング・インタフェース。


ウィンドウやツールの図形表示。


アプリケーションに保管およびロードできるビットマップ・オブジェクト。クライアントは、インポートされたイメージを変更できない。


Project Builderでは、Project Builderが認識し自動的にプロジェクト・ナビゲータ内にそのエントリを作成するプロジェクト項目であり、通常自動生成の結果である。たとえば、Project BuilderはCソース・ファイルのコンパイルの間に中間ステップとして生成される、 OBJファイルを認識し、それらのエントリをプロジェクト・ナビゲータ内に作成できる。暗示項目のプロパティのリセットは使用が制限されているが（次のコンパイルが変更を破棄する）、編集、ビュー、印刷のようなアクションを介して確認できるため、このような項目は便利である。「項目（item）」、「アクション（action）」も参照。


1. モジュールをファイル・システムまたはデータベースから読み込み、それをアプリケーションに取り込むこと。
2.プロジェクト情報が入ったファイルを読み込むこと。


その値について他のデータに依存しないデータ。たとえば、ある従業員の名前が値Jonesで、これは他の従業員名や関連データの値とは無関係であるなど。項目データとも呼ばれる。


表に関連するオプション構造であり、Oracle Serverにより表の行の位置を素早く確かめ、（オプションとして）それぞれの行が他と重複しないことを保証するために使用される。


Project Builderにおいて、依存性ツリー内の祖先ノードからアクション、タイプ、マクロまたはプロパティ定義の情報を取得すること。上位ノードに関連属性がある場合、それらの属性は継承できる。したがって、フォームや文書のようなファイル・システム項目がサブプロジェクト、プロジェクト、ユーザー・レジストリ、グローバル・レジストリからアクション定義を継承したり、プロジェクトがローカルまたはグローバル・レジストリからタイプ定義を継承する、などの場合がある。


枠の厚みや他の属性設定にかかわらず、オブジェクトの理想的な形を構成し、その4つの制御ポイントを接続する仮想の四角形。


ターゲットの構築に使用されるファイル。たとえば、.FMBは.FMXの入力となる。ソースともいう。


入力する各文字が、カーソル位置以降の文字を右に移動させてその位置に挿入されるモード。置換モードの反対。


世界的な、コンピュータのTCP/IPベースのネットワーク。


PL/SQLソース、Procedure BuilderコマンドおよびSQL文のあらゆる組合せが入ったファイル。


内部的なTCP/IPネットワークであり、これに対するアクセスは（ファイアウォールにより）企業や組織内の人物に制限されている。イントラネットは、インターネットが提供するサービスと類似したものを組織内に提供するが、インターネットに接続される必要は必ずしもない。企業内で情報やアプリケーションの配布のため、内部ネットワーク上に1つ以上のWebサーバーをセットアップするのはイントラネットの一般的な例である。


インターネット上のコンピュータを個別に識別する4つの部分をもつ数値で、それぞれの部分は3桁以下である。


Project Builderでは、フォームやドキュメントなど、そのオブジェクトに関連するファイル・システム内のオブジェクト。プロジェクト・ナビゲータ内のノードにより指定または参照される。


Project Builderでは、「プロジェクト・ナビゲータ」ウィンドウ内のエントリで、アイコンおよび内容を示すタイトルから構成される。ノードは、「Form Builder」ファイルおよび文書などのファイル・システム内の実際の項目を持つ。「ノード（node）」、「項目（item）」も参照。


Java ARchiveの略称。多くのファイル（Javaのクラス・ファイル、イメージなど）を1つのファイルに集めるのに使用されるファイル。


インターネット用のプログラミングをプラットフォーム独自の「アプレット」の形でサポートするコンピュータ言語。


2つ（以上）の表のデータを1つのSELECT文内で結合すること。


「配置（alignment）」を参照。


1. 対応する引数と共に指定する必要があるコマンド・ライン構文の一部。

2. PL/SQL構成体に必要な部分の1つ。


アプリケーションの仮想オブジェクトの値または意味を示すテキスト。


（Oracle Express） ディメンション階層内の位置。ベース・レベルより上の各レベルは、それより下のレベルからのデータの集約合計を表す。たとえば、TIMEディメンションには、MonthやQuarterなどの昇順レベルを持つ場合がある。ディメンション階層内では、1つのレベルのディメンション値は、そのレベルより上または下のレベルのディメンション値とファミリ・リレーションを持つ。


（Oracle Express） 特定階層内のレベルに基づいてディメンション値を選択できる「セレクタ」ダイアログ・ボックスのツール。たとえば、GeographyディメンションにあるKey Accountレベルのすべてのディメンション値を選択するといった操作もできる。


オブジェクトの作成、変更、位置付けまたは削除ができるエディタ領域。


異なる表示デバイス間で一貫した測定システムを使用するための寸法の単位。レイアウト上の位置またはオブジェクトの寸法を指定するのに使用される。


SQL SELECT文のテキスト文字列を示すのに使用されるパラメータへの参照。字句参照の際には、パラメータ名の前にアンパサンド（&）を付ける必要がある。


クライアントのファイル・システムまたはデータベースのファイルにともに保管された1つ以上のPL/SQLプログラム単位の集合。ライブラリに保管されたプログラム単位は、複数のアプリケーションから一度に参照できる。ストアド・プログラム単位（データベースに保存され、実行される）とは異なり、ライブラリ内のプログラム単位は、常にクライアント側のPL/SQLエンジン内にロードされ、実行される。ライブラリに保管されたプログラム単位を参照するには、まずライブラリを連結する必要があります。｢連結したライブラリ（attached library）」も参照。


グループと問合せ間でマスター/ディテール（親子）関係を定義するのに使用されるデータ・モデル・オブジェクト。


ボイラープレート・オブジェクトが関連付けられているファイルの名前。実行時に、Report Builderはファイルの内容をレポート・レイアウト内にインポートする。


ダイアログ・ボックス内の項目リスト。通常、リスト・ボックスは選択肢を提供し、スクロールできる。


Form Builderにおいて、選択肢の一覧を表示する項目。


LOVともいう。1列または複数列の選択リストを提供する、スクロール可能なポップアップ・ウィンドウ。


（Oracle Express） ディメンション内で現在選択されている値のリストからディメンション値を選択できる「セレクタ」ダイアログ・ボックスのツール。


1. アプリケーションを実行するコンピュータ上のデータベース。2. アプリケーションが接続されているデータベース。このデータベースは、アプリケーションによって生成されるすべてのSQL文を解析し、実行する。


「ユーザー・レジストリ（user registry）」を参照。


現行のプログラム単位のスコープ内でのみ宣言されるPL/SQL変数。


（Oracle Express）

Not	Unary Not -- オペランドはＩNTEGER型またはLONG型。演算はビット単位で実行される（1の補数）。

And	And -- オペランドはＩNTEGER型またはLONG型。演算はビット単位で実行される。

Or	Inclusive Or -- オペランドはＩNTEGER型またはLONG型。演算はビット単位で実行される。

Xor	Exclusive Or -- オペランドはＩNTEGER型またはLONG型。演算はビット単位で実行される。

Eqv	Equivalence -- オペランドはＩNTEGER型またはLONG型。演算はビット単位で実行される。（A Eqv B）は（Not (A Xor B)）と同じ。

Imp	Implication -- オペランドはＩNTEGER型またはLONG型。演算はビット単位で実行される。（A Imp B）は（(Not A）OR B）と同じ。


実際のレポートの1ページ（1つ以上の物理ページに表示される可能性がある）。


PL/SQLサブプログラムでは、 条件が一致しなくなるまで繰り返される条件文。


Project Builderにおいて、アクションのカスタマイズや拡張に使用できる型独自の変数。マクロは、定数または単純な式（これはまた、別の定数または式、あるいはその両方を含む場合がある）の形をとる。マクロを使用すると、コマンド・オプションの発行、およびユーザーがプロパティ定義を1つ変更して行うコマンド・セットの変更の自由度が、大きく高まる。


ページ上の1つ以上の列にレコードを表示する、デフォルトのレイアウト。フィールドは、1つの繰返し枠内で、互いのすぐ下に表示される。


ボディ領域の各論理ページの最上部と最下部にあるオプションのレポート領域。マージンは、任意のレイアウト・オブジェクトを含むことができるが、一般には、ボイラープレートと（ページ番号、総ページ数、総計、現在の日付と時刻のための）フィールドを含む。


ディテール・レコードがマスター・レコードの下に表示される、デフォルト・レイアウト。マスター・レコードは、フォーム・レイアウト・スタイルで表示され、ディテール・レコードは、表形式のレイアウト・スタイルで表示される。


（Oracle Express） ディメンション値の名前に含まれる文字をユーザーが指定する文字に一致させることにより、ディメンション値を選択できる「セレクタ」ダイアログ・ボックスのツール。たとえば、BrandレベルのProductディメンションで、"new"という文字を含むすべてのディメンション値を選択できる。


繰返し枠の各レコードをマトリックスのセルとして表示する繰返し方向。


マトリックス・レポートに必要な4つのデータ・セットをフォーマットする、格子に類似したデフォルト・レイアウト。この4つのデータ・セットは、ラベルの行として表示されるセット、ラベルの列としてのセット、格子を作成するセットおよび格子のセルに入るセットがそれぞれ1つずつである。


4つのデータ・セットのクロス・タブ。1つのデータ・セットはページの横方向に表示され、1つはページの縦方向に表示される。1つは、横方向と縦方向のデータが交わることが可能なすべての位置を決定し、それらの位置にセルを配置するクロス積である。もう1つは、セルの「フィルタ」として表示される。1つのデータ・セットはページの横方向に表示され、1つはページの縦方向に表示される。1つは、横方向と縦方向のデータが交わることが可能なすべての位置を決定し、それらの位置にセルを配置するクロス積である。もう1つは、セルの「フィルタ」として表示される。


（Oracle Express） 販売データやコスト・データなど、調査および分析できるデータ。ある基準内のデータを選択および表示できる。基準は、変数やリレーションとして格納したり、式を使用して計算したりできる。


1,048,576（1024x1024）バイトに等しいメモリーの単位。多くの場合、100万バイトに切り捨てられる。


最後のアクションのために発生した状況を通知するモーダル・ウィンドウ。メッセージ・ボックスには応答する必要がある。


オブジェクト・タイプ定義によってOracle8に連結された実行可能コード。


アプリケーションが継続する前にオペレータからの応答を引き出すウィンドウ。


ランタイム・ウィンドウ・マネージャがサポートできる量と同じ量の機能をもてる制限のないウィンドウ。


1. 複数のアプリケーションにより共有できるオブジェクト。外部問合せやPL/SQLライブラリは、モジュールの例。2. Form Builderでは、アプリケーションの主要なコンポーネント（メニュー・モジュール）。


いくつかの行に渡るウィンドウ内のフィールド、またはダイアログ。情報を垂直にスクロールさせることが可能である。


（Oracle Express） データが"使用できない（"not available"）（NA）ことを示す特別なデータ値。NAは、特別なデータ値が割り当てられていないまたはデータを計算できない任意のセルの値である。


横方向または縦方向（あるいはその両方）のディメンションに1つ以上のマスター/ディテール関係が含まれるマトリックス・レポート。ネストできる量に制限はない。


データ上のページが（フェッチしてからフォーマットされるまでキャッシュするのではなく）、フォーマットされてからフェッチされるデータ型。


1.  オブジェクト・ナビゲータのオブジェクト階層内の特定の位置。ノードは、他のオブジェクトへのクロス・リファレンスなどのオブジェクトの情報を表示するために拡張できる。2.  Project Builderにおけるプロジェクト・ナビゲータ内のエントリ。「項目（item）」、「項目ノード（item node）」および「編成ノード（organization node）」も参照。


データ型NOCACHEのデータベース列を参照するレポート列。


値がないこと。


（Oracle Express）

^	指数

-,+	単項のプラスおよびマイナス

*, /	数値乗算または除算。除算の場合、結果はDOUBLE型。

\	整数の除算。オペランドはＩNTEGER型またはLONG型。

Mod	係数または剰余。オペランドはＩNTEGER型またはLONG型。

-, +	数値の加算と減算。+演算子は文字列の連結にも使用できる。


1.  レイアウト上に配置できる項目。オブジェクトの例は次のとおり。四角形および、線、楕円、円弧、多角形、折れ線、丸い四角形、手書き、チャート、テキスト、記号、テキスト・フィールドなどのオブジェクト。

2. Oracle8では、オブジェクト・タイプのインスタンス。オブジェクトは、オブジェクト表内の行であったり、リレーショナル表内の列オブジェクトに含まれる行の一部であったりする。


「列オブジェクト（column object）」を参照。


関連するオブジェクトのコピーや参照を行う機能の提供に使用する、オブジェクト・グループのコンテナ。


「ハンドル（handle）」を参照。


現行セッションのオブジェクトの階層リストが入ったウィンドウ。リストはアウトライン形式で表示され、ユーザーはオブジェクトの作成、編集、改名および削除などの複数の作業を実行できる。


Oracle8において、定義がオブジェクト・タイプに基づいている表のこと。オブジェクト・タイプ内の各属性は、オブジェクト表内の列になる。表内の各行は、個々のOracle8オブジェクトである。


Oracle8において、オブジェクト作成の基盤となる、ユーザーが提供する定義またはテンプレート。オブジェクト・タイプは複合であり、その構成要素が属性である。各属性は名前とデータ型を持ち、オブジェクト・タイプ全体として名前を持つ。オブジェクト・タイプには1つ以上のメソッドが含まれる場合もある。


Open Database Connectivityの略称。異なるデータベース・システムをアクセスするための基準。アプリケーションは、SQLのODBC仕様によりODBCに対し文を送ることができる。ODBCはその文をデータベースが理解できる仕様に変換する。Oracle Open Client Adapter（OCA）により、アプリケーションは異なるデータベース管理システムを一貫した方法でアクセスできる。このためアプリケーション開発者は、特定のDBMSを対象とすることなくアプリケーションの開発、コンパイルおよび実行を行うことができる。


Object Linking and Embeddingの略称。


OLEオブジェクトの保管と表示が可能なアプリケーション。


OLEオブジェクトを作成するアプリケーション。


「ビルトイン・データ型（built-in datatype）」を参照。


Oracle製品のルート・ディレクトリを示す環境変数。


ナビゲータの設定や子項目のファイル・タイプの指示に役立つ、「タイプ」、「プロジェクト」、「フォーム・ファイル」などのプロジェクト・ナビゲータ内のエントリ。これはまた、特定のタイプのファイル・システム・オブジェクト内のデータ構成体に対応する。


x座標とy座標により示される。ビューの原点は、その親のキャンバス上のビューの位置を示す。キャンバスの原点は、描画ビュー上の描画の位置を示す。


オブジェクトを完全に囲む最少の仮想の四角形。


オブジェクトの内容が現行の論理ページに入りきらない状態。オーバーフローが発生すると、内容の一部が次の論理ページに移される。


プログラム単位内のあらゆる位置で参照可能な、ソフトウェアで提供されるPL/SQL関数。


関連するプロシージャ、ファンクション、変数およびその他のパッケージ要素をデータベースまたはクライアント内に1つの単位としてカプセル化し保管する方法。パッケージにより、データベース管理者やアプリケーション開発者の、編集作業が容易になると同時に、機能性とデータベースのパフォーマンスも向上する。ソフトウェアでは、クライアント側のプログラム単位によって参照されるPL/SQL構成体を含むビルトイン・パッケージがいくつか提供されている（TEXT_IOパッケージなど）。いくつかのパッケージには、ストアド・プログラム単位の参照用にOracleデータベース・サーバーも提供されている（DBMS_OUTPUTパッケージなど）。


パッケージの実際のインプリメンテーションを含む。これは、個別のサブプログラムおよびデータ型を含む場合がある。パッケージが宣言のみで構成される場合、本体はオプション。


パッケージに対する公開インタフェース（他のプログラム単位により参照可能なデータ型およびサブプログラム）を宣言する。


（Oracle Express） 1. レポート内に含まれる1つのデータ。追加ページによって追加データが表示される。

次の図は3ページ分のデータを示す。

2. Expressにおいて、ページはExpressデータベース内の格納単位も意味する。


（Oracle Express） 問合せについて選択したデータがスプレッドシート内でどのように表示されるかを表したもの。ページ・レイアウトによって、「横」、「縦」および「ページ」の3つの枠が表示される。問合せによって定義されるマルチディメンションのデータキューブが、2次元のスプレッドシート内でどのように表示されるかが、これらの枠によって示される。ディメンション・タイルには、ディメンションの名前と位置が表示される。「横」枠上のディメンションは、このディメンションが列として表示されることを意味する。「縦」枠上のディメンション・タイルは、このディメンションが行として表示されることを意味する。「ページ」枠上のディメンションは、このディメンションが結果の最上部にあるページ・ボックス内に表示されることを意味する。


現行のオブジェクトとその子を次の論理ページに移動するかどうかを制御する設定。レポート出力に現行オブジェクトが表示される前または後に、ページ・ブレークが発生するように設定できる。


エディタ内で利用できるツール、色またはパターンを表示するインタフェース要素。


作業が行われる、エディタの固有の位置で、通常サイズの変更が可能。


1つの論理ページを印刷するのに必要な物理ページの数。


1. 情報をサブプログラムに渡すのに使用されるPL/SQL構成体。たとえば、サブプログラム・コールMYPROC（x）では、xがパラメータ。2. Forms Developerでは、パラメータは情報をForm BuilderやGraphics Builderなどのコンポーネント間で渡すのに使用される。3. 実行時に変更可能な変数。


Forms Developerコンポーネント間で情報を渡すのに使用される、パラメータ名と関連する値のグループ。


1. そのグループ・ツリー内のあるオブジェクトのすぐ上位のオブジェクト。グループ・オブジェクトは、それを構成する各オブジェクトの親である。どのオブジェクトも、その子の親になる。
2.（Oracle Express）階層内において特定値のすぐ上のレベルにあるディメンション値。親値は、その子の値の集約合計である。次の例は、GEOGRAPHYディメンションにおいて、"Lyon"と"Paris"の親としてのディメンション値"France"を示す。


クリップボードの内容（カットまたはコピーされたオブジェクト）を現行のカーソル位置に入れること。


ほとんどのオブジェクトの枠または塗りに適用できる、図形プロパティ。


コンパイルされたプログラム単位に対するマシン・コードまたは指示リスト。


Portable Document Formatの略称。ドキュメントの作成に使用された元のアプリケーション・ソフトウェア、ハードウェアおよびオペレーティング・システムとは無関係にドキュメントを表現する（Adobe Acrobatに固有の）ファイル形式。PDFファイルは、テキスト、図形およびイメージのあらゆる組合せが入ったドキュメントを、デバイスや解像度から独立した形式で表現できる。


プリンタに出力されるページのサイズ。


横棒、線、記号のような、チャート上のフィールドの表示に使用される要素のタイプ。


SQL言語に対するOracle専用の拡張。SQLに対しアプリケーションの記述に適するようにプロシージャ型構成体やその他の構成体を追加している。


Procedure Builderインタプリタのスクリプト・ファイル。


ソース・コードとコンパイル済みコードを含むPL/SQLライブラリ・ファイル。ファイルはProcedure Builderでオープンして編集できる。


1つのプログラム単位のPL/SQLソースを含むテキスト・ファイル。


実行可能コードのみを含むランタイムPL/SQLライブラリ・ファイル。ファイルをProcedure Builderでオープンして編集することはできない。


ユーザーが特定のアクションを実行する際にポップアップするリスト。


転送されたデータと特定のプログラム間の経路を定めるためにTCPが使用する番号。


Project Builderに付属しておりメニュー項目またはツールバー・ボタン（あるいはその両方）で自動的に利用できるアクション。事前定義済みアクションには、「ビルド」および「配布」、複数のソース制御オプションが含まれる。事前定義済みアクションは、サポートされているファイル・タイプに定義されると、Project Builderからコールすることにより、そのタイプの任意の選択項目に対して起動される。「アクション（action）」、「ユーザー定義アクション（user-defined action）」も参照。


「ビルトイン・データ型（built-in datatype）」を参照。


アプリケーションのインタフェースの動作に影響する設定。


（Oracle Express） 現行の基準を受け入れる場合に生成されるスクリプトを表示する。任意の「セレクタ」ツールのダイアログ・ボックスでは、「プレビュー」ボタンを選択することにより、選択項目のプレビューを表示できる。


レポート出力のアウトラインを表示しスクロールできるインタフェース。


表内の行の識別に使用できる一意の値で内容が構成された、データベース表内の列。


「ビルトイン・データ型（built-in datatype）」を参照。


プリンタ定義ファイルでは、レポート内で参照できるプリンタ・コードを割り当てるエスケープ・シーケンス。


プリンタ定義がテキスト形式（ASCIIやEBCDICなど）で入ったファイル。


指定されたアクション・シーケンスを実行するPL/SQLサブプログラム。クライアントおよびデータベース・サーバーに存在し、実行することができる。


PL/SQLコンパイラが独自に認識して処理できるPL/SQLコード構造。無名ブロック、サブプログラムの仕様部と本体（プロシージャおよびファンクション）、パッケージの仕様部と本体などがある。プログラム単位は、クライアントおよびデータベース・サーバーに存在し、実行できる。｢ストアド・プログラム単位（stored program unit）｣も参照。


Project Builderにより作成される基本的なデータ構造。プロジェクトは、アプリケーションの一部と見なしている、または概念的にグループ分けするすべてのファイルに対するポインタの集合である。エディタ、コンパイラまたは他のツールを定義して、プロジェクト内に含まれる項目を操作できる。すべてのプロジェクト情報はプロジェクト・レジストリ内に格納される。「プロジェクト項目（project item）」、「プロジェクト・ファイル（project file）」および「エクスポート（export）」も参照。


Project Builderにおいて、プロジェクト・ファイルは、アプリケーションに関連付けられたすべてのファイルを指す。プロジェクト・ファイルには、フォーム、レポート、ディスプレイ、3GLモジュール、ドキュメントおよびテスト・スクリプトを含む、あらゆるタイプがある。「プロジェクト（project）」、「プロジェクト項目（project item）」も参照。


Project Builderにおいて、プロパティを定義できるすべての項目を指す。これには、「プロジェクト」ノード下に格納されたすべてのエンティティ、タイプ、アクションおよびマクロも含まれる。「プロジェクト（project）」、「プロジェクト・ファイル（project file）」も参照。


現行セッションのプロジェクト項目の階層リストを含むウィンドウ。リストはアウトライン形式で表示され、ユーザーはオブジェクトの作成、編集、改名および削除などの複数の作業を実行できる。いつでも表示できるのは1つのみだが、オブジェクトの編成に使用される2つの異なるスキーマから選択できる。


プロジェクトのトップ・レベルのノード。プロジェクト・ファイルを表示または指示する。「プロジェクト（project）」、「プロジェクト・ファイル（project file）」も参照。


Project Builderにおいて、プロジェクトに関連付けられたすべての情報を格納するファイル。プロジェクトに属するファイル、タイプ、アクションおよびプロジェクトについて定義されたマクロなどが含まれる。プロジェクトに属するファイル、タイプ、アクションおよびプロジェクトについて定義されたマクロなどが含まれる。


プロジェクト表示は、タイプ、およびプロジェクトとサブプロジェクトの関係により編成されるオブジェクトを表示する。プロジェクトは、プロジェクト・ファイルごとにアルファベット順に編成されてから、カテゴリごとにアルファベット順に編成される。「依存性表示（dependency view）」、「プロジェクト（project）」、「プロジェクト・ファイル（project file）」、「ビュー（view）」も参照。


ユーザーが新規プロジェクトまたはサブ・プロジェクトの作成に必要なステップを完了するのを支援するダイアログ。


オブジェクトの動作または外観を決定する、オブジェクトの特性。


クラスに基づいたオブジェクトの外観と機能性をグローバルに制御するために使用するプロパティとその設定のリストを含む、ユーザー命名オブジェクト。


データベースまたはサーバーに接続する際に入力できる文字列で、リモート・データベースまたはサーバーへの接続を可能にする。


（Oracle Express） 基準内のいずれかのディメンションの値を選択するとき、その基準を構成する他のディメンションは修飾ディメンションと呼ばれる。

「販売」基準が「製品」、「月」および「地域」別にディメンション化されていると仮定する。「販売」に基づく上位10都市を選択する場合、「販売」値を比較するには、比較の対象となる製品と月も指定する必要がある。この場合、「製品」と「月」は、修飾ディメンションである。


データベースの1つ以上の表またはビューから検索するデータを指定する、SQL SELECT文。


実行時に、問合せにより取り出されたデータのフィルタリングを行うPL/SQL関数。ファンクションの条件を満たすデータのみをチャートにする。


現行セッションを終了しユーザーをオペレーティング・システムに戻すオプション。一部のシステムでは、「終了（Quit）」は「終了（Exit）」になる。


2つ以上のセットで表示される（チェックボックスに類似した）制御であり、一定の時間において「オン」または「オフ」となるのはそのうちの1つのみである。


2つ以上のラジオ・ボタンのセットであり、一定の時間において「オン」または「オフ」となるのはそのうちの1つのみである。


（Oracle Express） 連続する時間間隔をディメンション値として選択できる「セレクタ」ダイアログ・ボックスのツール。これらの時間間隔は、次のいずれかを基準にすることができる。

•	最も最近の時間間隔の具体的な数

•	開始時間間隔と最も最近の時間間隔

•	開始および終了の時間間隔

たとえば、1996年11月25日で終わる週から、1996年12月30日で終わる週までの範囲で、ディメンション値を選択するといった操作もできる。


RSA Data Security, Inc.により考案された暗号法であり、任意の長さのキーを認める。これは基本的に、暗号データを作成するためにデータ・ストリームにより排他的論理和が行われているジェネレータの出力を使用する、偽のランダム番号のジェネレータである。このため、2種類のデータ・ストリームを暗号化するのに同じRC4キーを使用しないように十分注意する必要がある。


Relational Databasse Management System（リレーショナル・データ・モデルに基づいたデータベース管理システム）の略称。データ構造、格納と検索操作、および整合性制約の定義が行うことができるデータベース。このようなデータベースでは、データとそれらの間の関係は表で編成される。


単一のバイナリ形式のレポート定義を含むファイル。.RDFファイルは、レポートの実行と編集の双方に使用される。


単一のバイナリ形式のレポート定義を含むファイル。.repファイルは、レポートの実行にのみ使用される。.repファイルを編集できない。


ある時点において、データベース全体でデータを問い合わせる能力。


SQL SELECT文によりフェッチされる1行。


列と行構造による内部的なデータ構造オブジェクトで、それらが定義されるフォーム・モジュールに属する。


他の列オブジェクト内またはオブジェクト表内のデータを参照する列のタイプ（Oracle8）。


チャート上の指定された値の位置に表示される線。


（Oracle Express） 問合せ結果をレポートに表示した後、Expressデータベースから最新のデータをフェッチする。保存されたExpress問合せをオープンすると、結果は自動的にリフレッシュされる。


タイプまたは新規プロジェクトの定義をグローバル・レジストリまたはローカル・レジストリに追加すること。登録されると、新規のタイプにはアクションを定義でき、新規のプロジェクトでは参照ファイルを特定のタイプとして識別させ、そのタイプに対してアクションを起動できる。「レジストリ（registry）」も参照。


プロジェクト定義および環境情報を格納した、グローバルな構造ファイルまたはユーザー固有の構造ファイル（あるいはその両方）。「グローバル・レジストリ（Global Registry）」、「ユーザー・レジストリ（user registry）」も参照。


"WHERE DEPTNO = 10"内の等号など、2つの値間の比較を示す検索条件に使用される記号。比較結果が"TRUE"となる行は結果が返され（フェッチされ）、比較結果が"FALSE"となる行は結果は返されない。


コンピュータ上の、ローカル・データベース以外のデータベース。通常、同じネットワーク上にあるが、ノードが異なるコンピュータ（つまり、データベース・リンクを介して使用するデータベース）。


グループのためにフェッチされるデータ行の表示に使用されるレイアウト・オブジェクト。


入力する各文字がカーソル位置の現行の文字を置換するモード。挿入モードの反対。


レポートのデータ・モデルとレイアウトの定義に使用されるオブジェクト。レポート・レベルのオブジェクトは、1つのレポートに割り当てられ、他のレポートまたは他のOracle製品とは共有できない。オブジェクトには、レポート、問合せ、外部問合せ、外部PL/SQLライブラリ、グループ、列、パラメータ、リンク、枠、繰返し枠、フィールド、ボイラープレートおよびアンカーが含まれる。


Windows NTおよびWindows95でのみ利用可能。コマンド・ラインがレポートを実行するのを待機し、ローカル・サーバー上のバックグラウンドで実行するためそのレポートをそのキューに入れる。通常コマンド・ラインは、RUN_PRODUCTを介してForm BuilderまたはGraphics Builderから、あるいはSRW.RUN_REPORTを介して別のレポートから受け取られる。RWISV60を使用し、レポートをReportsバックグラウンド・エンジンに送ることもできる。


タイムスタンプおよびReports Serverにより管理されるレポートに関するステータス情報をメンテナンスする。


Windows NT、Windows95およびUNIXで利用可能。リモート・サーバー上でのレポートの実行を可能にする。ジョブ要求をキューに登録し、レポートをいつ実行するか計画できる。レポートをReports Serverに送るには、RWCLI60を使用する。


WebサーバーとReports Runtime間のインタフェースを提供し、レポートをWebブラウザから動的に実行することを可能にする。


WebサーバーとReports Serverの間の接続を提供する。


テキスト形式（ASCIIやEBCDICAなど）で格納された、レポート定義を含むファイル。.REXファイルは、レポートを1つのプラットフォームから別のプラットフォームに移植するのに使用する。.REXファイルは、現時点では必要ではないことに注意する。このファイルは、下位互換性のために利用できる。


色のコンポーネント、赤、緑および青の濃度を示す。


アプリケーション内の他のすべてのオブジェクトが属するグループ・オブジェクト。


ユーザー環境を表す、プロジェクトの最上位のノード。デフォルトの設定にどのレジストリが選択されているかによって、ユーザー・レジストリまたはグローバル・レジストリに対応する可能性がある。


1. 表内のフィールド値の1組。たとえば、サンプル表EMPにおける1人の従業員を表すフィールド。

2. アプリケーションのランタイム・バージョンを生成する。


Oracle8オブジェクト表内のオブジェクト。表内の各行がオブジェクトになる。ただし、Forms Developerにおいて、オブジェクト表は個々の列に分解されるため、行オブジェクトは1つのエンティティとして存在しない（個別の属性としてのみ存在する）。


アプリケーションまたはプログラム単位のランタイム・バージョンを実行する。


リッチ・テキスト形式の略称。プラットフォームに特定されないファイル形式で、書式化されていないテキストやイメージをさまざまなアプリケーションおよびオペレーティング・システムで表現するのに使用される制御文字に基づいている。RTFは、ANSI、PC-8、MacintoshまたはIBM PCのキャラクタ・セットを使用して、スクリーン表示や印刷において文書の表現と書式化を行う。


「REPファイル（rep file）」を参照。


ユーザーがその中でランタイム・アプリケーションの表示とランタイム・アプリケーションとの対話を行うインタフェース。


実行時にオプションで表示される画面またはウィンドウであり、この中でユーザーはレポートの実行に先立ち印刷オプションやパラメータの変更を行うことができる。


（Oracle Express） 値のリストまたはスクリプトとして保存された一連のディメンション値。ユーザーは自分で作成した選択項目を保存したり、データベース管理者は保存済みの選択項目を作成して、ユーザーが利用できるように提供できる。

保存済みの選択項目は時間短縮の機能を果たす。つまり、選択項目を再利用する必要があるたびに、保存された選択項目を再作成することなく、取り出すことができる。つまり、選択項目を再利用する必要があるたびに、保存された選択項目を再作成することなく、取り出すことができる。


（Oracle Express） 保存されたディメンション値の選択項目を取り出すことのできるセレクタ・ツール。


通常データベースのユーザーIDによりグループ化されている、関連するデータベース・オブジェクトの集まり。スキーマ・オブジェクトには、表、ビュー、順序、ストアド・プログラム単位、シノニム、索引、クラスタおよびデータベース・リンクが含まれる。


オブジェクトが作動するレベルまたは範囲。Project Builderでは1. コンパイル可能なプロジェクト項目に対して起動された「ビルド」および「すべてをビルド」コマンドによって、影響されるファイルの範囲を記述する。

2. 継承可能な定義によって影響されるファイルの範囲を記述する。


「SQLスクリプト（SQL script）」、「インタプリタ・スクリプト（Interpreter script）」を参照。


Report Builderにおける同一レポート内の複数のレイアウトのいずれかで、それぞれ異なる対象読者、出力形式、ページ・レイアウト、ページ・サイズまたは印刷の向きを持つ。たとえば、1つのレポートで、あるセクションには上級管理職向けの業務要約を記載し、別のセクションには個々の管理者用の詳細な業務分析を記載できる。


1つ以上の表またはビューからどの行と列をフェッチするかを指定するSQL文。


（Oracle Express） ディメンションについて現在選択されている一連のディメンション値またはそれらの値を指定するための条件や基準を含むスクリプト。


（Oracle Express） セレクタ内のさまざまなダイアログ・ボックスで表示される、ディメンション値の選択において、ユーザーが選択した項目の説明。Express言語スクリプトを通常の言語で翻訳したもの。


（Oracle Express） レポート、表、グラフまたはディメンションの各リスト・ボックスに含めるディメンション値を選択するための一連のツール。たとえば、セレクタを使用すると、「販売」に基づく上位10都市を選択したり、「販売」が「割当額」を15パーセント超えた上位10都市を選択できる。セレクタを使用することにより、ディメンション値のソート、および保存済み選択項目の作成と取出しも行うことができる。


（Oracle Express） ディメンション値を選択またはソートするための特定の方法を提供するダイアログ・ボックスまたはそのグループ。各セレクタ・ツールは、セレクタの構成要素である。セレクタ・ツールを使用することにより、階層内のレベル、属性または値名内の文字などを基準にしてディメンション値を選択できる。セレクタ・ツールを使用して、ディメンション値をソートすることもできる。


実行可能プログラムの起動と終了の間の期間。


グループ・ツリー内で同じ親オブジェクトをもつ2つ以上のオブジェクトの1つ。1つのグループ・オブジェクトに属するオブジェクトは、すべて同位項目である。


IPアドレスとポート番号の組合せ。


（Oracle Express） 表示された選択項目内で、ディメンション値の順序を並べ替えることのできる「セレクタ」ダイアログ・ボックスのツール。次の項目を基準にして、選択項目を昇順または降順にソートできる。

•	アルファベット

•	データベース内における順序

•	データ値

•	階層内の順序またはレベル

•	時間間隔

ディメンション値をドラッグ・アンド・ドロップすることにより、選択項目を手動でソートすることもできる。


PL/SQLでは、サブプログラムまたはパッケージ内で提供される文。プログラム単位のソース・コードを持っていなければ、それを実行可能な形にコンパイルすることはできません。Project Builderでは、ターゲットの種類の構築に必要な入力タイプ。サブプログラムの名前、パラメータおよび戻り型（ファンクションへの適用のみ）のみを定義する。


サブプログラムの名前、パラメータおよび戻り値の型（ファンクションへの適用のみ）のみを定義する。


エディタ内の、垂直スクロール・バーの下と、水平スクロール・バーの左にある小さな四角形。マウス・ボタンをドラッグして離すと、新規のペインが作成され、スクロール・バーはそれぞれのペイン用に分割される。


リレーショナル・データベースにおける情報の格納と検索のための標準インタフェース。SQLは、Structured Query Language（構造化問合せ言語）の略称。


テキスト形式（ASCIIやEBCDICなど）に格納された問合せを含む。


データベース管理を素早く簡単に行うSQL文を含むファイル。SQLスクリプトの一部は、Oracle製品に付属している。


Oracleに対するSQLの指示。SELECT文は、SQL文の一種。


「コール･スタック（call stack）」を参照。


条件制御、繰返し制御、逐次制御およびエラー処理に使用されるPL/SQL構成体。各PL/SQL文の最後には、必ずセミコロン（;）を付ける必要がある。


（Oracle Express） 評価されるたびに同じディメンション値を含む保存済みの選択項目。静的な保存済み選択項目では、選択基準ではなく、選択されるディメンション値がリストされる。たとえば、静的な保存済み選択項目のスクリプトには、"Select February 1996, March 1996, and April 1996"などのように文が記述され、動的な保存済み選択項目のスクリプトでは、"Select the last three Months"といったように文が記述される。


Oracleデータベース・サーバーに存在し、Oracleデータベース・サーバーで実行されるプロシージャ、ファンクションまたはパッケージ。


Oracleデータベース・サーバーに存在し、Oracleデータベース・サーバーで実行されるプロシージャまたはファンクション。


HTMLドキュメント内でフォーマットの強力な柔軟性を提供するHTMLの拡張機能。スタイル・シートを利用するHTMLドキュメントを探し、それをスタイル・シートをサポートするブラウザに表示する。


PL/SQLプロシージャまたはPL/SQL関数。


Project Builderにおいて、それ自身のファイル内に格納されているのではなく、他のプロジェクトファイル内に含まれるプロジェクト。「プロジェクト（project）」も参照。


Project Builderにおいて、サブプロジェクトを示すノード。「プロジェクト（project）」、「プロジェクト・ノード（project node）」および「サブプロジェクト・ノード（subproject node）」も参照。


集計タイプの列。Report Builderにより提供されているパッケージ化された集計ファンクションの1つを使用し、レポート内のデータのサブ合計、グランド合計、実行合計およびその他のデータ集計を計算する。


Microsoft Excelプログラムで使用されているファイル形式。


コマンド、修飾子およびパラメータが結びつけられて有効なコマンド文字列を形成する規則的なシステム。


Reports Developerで提供されている変数の1つ（&Logical Page、DESTYPEなど）。


リレーショナル・データベースまたはサーバーで行と列から構成される2次元の格子に格納される、関連する情報の名前付き集合。


コレクション・タイプの一種で、すべてが同じデータ型を持つ、順序付けのされていない一連の要素で構成されるデータ単位を定義する。対応するデータ単位は、1つの列がネストされた表で、その列タイプはビルトイン・タイプまたはオブジェクト・タイプである。（Oracle8）


ページの最上部にラベルを、ラベルの下にデータ行を表示するデフォルト・レイアウト。


Project Builderにおける依存ツリー内のあらゆる項目。たとえば、実行可能プログラムはライブラリの（コンパイル）ターゲット、ライブラリはオブジェクトのグループのターゲット、そしてオブジェクトはソース・ファイルのターゲットである。


ターゲットを示すノード。「ターゲット（target）」も参照。


Transmission Control Protocol（伝送制御プロトコル）の略語。クライアントとWebサーバー間のHTTP要求を交換するための基礎的な通信プロトコル。


マウスやその他のポインティング・デバイスを使用しユーザーがそのソースから削除して表示画面の別の位置へドラッグできるサブメニュー。


Form Builderにおいて、文字列の値を表示する項目。


アプリケーション名やそのウィンドウ内のインタフェース要素を表示する、ウィンドウの最上部の水平領域。


「ヘッダー（header）」を参照。


設定を交互にオンまたはオフに切り替えること。たとえば、オブジェクト・ナビゲータを隠したり表示できる。


アプリケーション内でオブジェクトの作成と操作に使用するアイコン・ボタン。


製品コマンドを実行するアイコン・ボタンの集合。通常、ウィンドウの一番上に沿って水平に並んでいるか、横に垂直に並んでいる。


ツールの集合。


（Oracle Express） 上限xと下限yまたは上限xと下限yのデータ値を基準にしてディメンション値を選択できる「セレクタ」ダイアログ・ボックスのツール。たとえば、1995年12月30日で終わる4週間の時間間隔において、「米国内」で生産された製品のうち、販売量が上位10パーセントに入る製品を含むディメンション選択項目を生成できる。


テキスト、図形、データ、計算など、レポートについての最終内容を入れることができるオプションのレポート領域。レポート・トレーラは、ヘッダーとボディに続いて最後に表示される。


1つの単位として扱われる一連のSQL文。


特定のイベントに従って実行または「起動」されるPL/SQLプロシージャ。


タイプ名や説明などの情報が入った、フォームやドキュメントなどのファイル・タイプの説明。各説明は1つのファイル・タイプに当てはまる。また、4つのメタ・タイプもある。"updtext"は、すべてのテキスト・ファイルに適用される。"updproj"は、すべてのプロジェクト・ファイルに適用される。"updlink"は、すべてのプロジェクト・リンクに適用される。"all"は、すべてのファイル・タイプに適用される。"updtext"は、すべてのテキスト・ファイルに適用される。"updproj"は、すべてのプロジェクト・ファイルに適用される。"updlink"は、すべてのプロジェクト・リンクに適用される。"all"は、すべてのファイル・タイプに適用される。タイプは、アクションやマクロを定義する基礎となる。


表データの値を変更すること。特に、SQLコマンドUPDATEによるデータ値の変更、SQLコマンドDELETEによる値の削除、またはコマンドINSERTによる値の挿入。


Uniform Resource Locatorの略称。WWWサーバーおよびホーム・ページの指定に使用される「アドレス」。たとえば、http://www.acme.com/。
この例は、ホストのアドレスがwww.acme.comであることを示す。一般に、URLはファイル名である（長いパスをもち、拡張子.HTMLまたは.HTM（PC-DOSファイル名の場合）が通常付く）。


Forms Developerからの制御（および引数）を別のOracle製品または3GLに渡し、続いて制御（および引数）をForms Developerに戻す方法。


Project Builderユーザーにより定義されるカスタム・アクション。このようなアクションは、任意の1つのファイル・タイプまたはすべてのファイル・タイプに適用できる。「アクション（action）」、「定義済みアクション（pre-defined action）」も参照。


「オブジェクト・タイプ（object type）」を参照。


Project Builderユーザーにより定義されるカスタム・マクロ。このようなマクロは、ビルトイン・アクションとユーザー定義アクションの両方を変更するのに使用することができる。「マクロ（macro）」、「ビルトイン・マクロ（built-in macro）」、「アクション（action）」および「定義済みアクション（pre-defined action）」も参照。


構成情報をユーザーごとに格納するプロジェクト・ファイル。これによってユーザーは、個々の開発環境をカスタマイズできる。ユーザー・レジストリは、グローバル・レジストリからタイプ情報を継承するほか、新規タイプを定義したり、グローバル・レジストリに格納されているタイプ定義の一部を上書きすることもできる。また、ユーザー設定による接続文字列、「ツールバー表示」のようなUI設定、および「作成者」のような一般的なプロジェクト情報など、環境情報および作業環境情報も格納する。「レジストリ（registry）」、「グローバル・レジストリ（Global Registry）」も参照。


「値軸（continuous axis）」を参照。


値を返すPL/SQLコード構造。値構成体には、ファンクションと式が含まれる。


値を割り当てることができ、割り当てられた値が時間がたつにつれ変化する可能性があるユーザー命名オブジェクト。


コレクション･タイプの一種で、すべてが同じデータ型を持つ、順序付けされた一連の要素で構成されるデータ単位を定義する。対応するデータ単位は、可変配列つまりVARRAYである。VARRAY（サイズ）内の要素数は可変である。ただし、可変配列型を宣言するときは、最大サイズを指定する必要がある。


Visual Basic extensionの略称。事前定義済みのVBXコントロールを含むファイル上に分配された特定のダイナミック・リンク・ライブラリのファイル拡張子として使用される。


Microsoft Visual Basic言語で構築されたウィジェット。ユーザー・インタフェースの拡張、ユーザー入力の取得、および出力（スライダ、格子、制御ノブなど）の表示に使用される。


その行がデータベース内に実際に存在しないが、データベースに物理的に格納されている表に基づいている仮想的な表。


仮想ファイル・システムがホスト・マシン上のファイル・システムに格納されたファイルをマッピングするのに使用する、ディレクトリ・ニーモニック（本来、ショートカットまたは略称）。


URL内で使用されているパス名を、ホスト・マシンのオペレーティング・システムによりメンテナンスされているファイル・システムに関連付けるマッピング。


アプリケーション・インタフェース内に現れるオブジェクトに対し設定する、フォント、色およびパターンのプロパティ。


「WWW」を参照。


エンド・ユーザーが（Webサーバーによりサービスされる）コンピュータ上に保管されているHTMLドキュメントおよびプログラムを読むために利用するプログラム。


Web Request Brokerを介してWebサーバー上で実行されるプログラム。


リモートWebブラウザのHTTP要求に応答してWebページを送信する、Webサイトで稼働しているサーバー・プロセス（HTTPデーモン）。


ワードまたはフェーズ内で「任意の1文字」または「隣り合うキャラクタ・セット」を意味するために使用される文字。


1. アプリケーションが入った、デスクトップの四角形の領域。各ウィンドウには、アプリケーションと対話できる領域がある。ウィンドウは、オープン、サイズ変更、移動、アイコンへの縮小、デスクトップ全体への拡張ができる。2. Form Builderにおいて、キャンバス・ビューと関連付けることができるオブジェクト・タイプ。


SQL*CalcやLotus 1-2-3プログラムなどのスプレッドシート・プログラムで使用されているファイル形式。


Oracle Web Request Brokerの略語。Web用のアプリケーションの開発と実行に、強力な分散した実行時環境を提供する。WRBランタイム・プラットフォームにより、アプリケーション開発者は、Webサーバーから独立したアプリケーションや多くのWebサーバーと共に稼働するアプリケーションを記述することができる。


World Wide Webの略語。インターネット上のサーバーのネットワークであり、サーバーのそれぞれが1つ以上のホームページをもつ。ホームページは、そのサーバーまたは他のサーバー（通常こちら）上の他のドキュメントに対し情報やリンクを提供する。


フィールドの内容を編集するため、オブジェクトを拡大し表示領域を広げること。


（デフォルトで）descriptionプロジェクト・ナビゲータの左に表示された2番目のツールバー。簡単な編成およびアプリケーション起動機能がある。


 OLEコントロール（OCX）の最新バージョン。


適切なタギング、ネスティングおよびXML宣言（<?xml version="1.0" encoding="UTF-8"?>など）の組込みなどの一般的なXML原理に従うXML出力。


プレースホルダ・ユーザー名を使用すると、Webブラウザからレポートを実行するときに、Oracelデータベースのユーザー名（$user_name@databaseなど）ではなく、個人ユーザー名を使用してデータベースにログオンできる。


ＸML（Extensible Markup Language）。SGMLを使用して、データを定義および構築するメタ言語。Report Builderは、XML出力をサポートして、Webパブリッシングおよびサードパーティーのアプリケーションとの電子的データ交換を可能にする。また、XMLを使用して、実行時に他のレポート定義とマージすることができるレポート定義を作成することも、文書型定義（DTD）に従う構造および要素の内容を持つXML出力を別々に実行することもできる。


文書型定義（DTD）に準拠する構造および要素内容を持つ、XMLによる出力。有効なXMLは、適切に構成されている。


オンライン・ヘルプの使用

オンライン・ヘルプ・システムを効果的に利用するためのガイドラインを次に示します。

•	「目次」タブを読んで、オンライン・ヘルプで取り上げられているトピックの内容を把握します。

•	トピック・タイトルのすぐ下にある「関連項目」ボタンをクリックして、現行のトピックに関連するトピックのリストを表示します。

•	トピックの一番上にある「オプション」ボタンをクリックして、「手前に表示」を設定します。これにより、アプリケーションの開発を進めながらでも、ヘルプ・トピックは常に画面の手前に表示されます。

•	用語の定義を調べるには、トピックの最上部にある「用語集」ボタンをクリックします。


ドキュメント・ロードマップ

アプリケーションの構築方法を習得するには:

1	各コンポーネントの概要を述べたクイック・ツアーを確認します。

•	「ヘルプ」 [image] 「クイック・ツアー」を選択します。

2	最も一般的な作業の実行方法を学習するには、キュー・カードを参照します。

•	「ヘルプ」 [image] 「キュー・カード」を選択します。

3	オンライン・マニュアルを表示します（ハード・コピーのマニュアルも利用できます）。

•	「ヘルプ」 [image] 「マニュアル」を選択します。

4	オンライン・ヘルプ・システムにアクセスします。

•	「ヘルプ」 [image] 「ヘルプ・トピック」を選択します。

•	状況依存ヘルプを参照するには、[Help]キー（ほとんどのプラットフォームでは通常[F1]キー）を押します。


インフォメーション・デスク


Forms Developerの各国語サポート

  関連項目

世界各国で使用できるアプリケーションを設計する場合、データの表示方法について各国語固有の表記法規約を使用することにより、世界中のユーザーがそれぞれの言語でアプリケーションと対話できるようにしたいものです。Oracleの各国語サポート（NLS）は、次の3つの主要な階層で構成されます。

•	各国語文字コード体系のサポート

•	言語および地域の表記法規約のサポート

•	アプリケーションの翻訳

このように、文字レベル、データ表示レベルおよびインタフェース・レベルでのサポートを組み合せることにより、作成したアプリケーションは、マルチバイト・キャラクタのコード体系および双方向性を含め、ヨーロッパ、中東およびアジアのほとんどの言語で使用できるようになります。


NLSアーキテクチャ

  関連項目

NLSアーキテクチャには、次の2つの主要な部分で構成されます。

•	言語に依存しない機能

•	言語依存のデータ

言語に依存しない機能では、実行時にオペレータが使用する言語および地域に応じて適切な方法でデータを処理し、その国での日付および時刻の表記法規約に従って、データを自動的に書式設定します。

言語依存のデータを特定することにより、作成したアプリケーションに固有な文字列の翻訳のみをアプリケーションで処理できるようになります。


各国語サポートの環境変数

  関連項目

次に示すパラメータを環境変数として使用することにより、Forms Developerの言語設定を指定できます。

パラメータ	指定する言語設定
NLS_CALENDAR	使用するカレンダー・システム
NLS_CREDIT	正の通貨値を示す文字列
NLS_CURRENCY	各国通貨記号
NLS_DATE_FORMAT	日付用のデフォルト書式
NLS_DATE_LANGUAGE	日付用のデフォルト言語
NLS_DEBIT	負の通貨値を示す文字列
NLS_ISO_CURRENCY	ISO通貨記号
NLS_LANG	Forms Developerの言語設定
DEVELOPER_NLS_LANG	Forms Developer Builderの言語
USER_NLS_LANG	Forms Developer Runtimeコンポーネントの言語
NLS_LIST_SEPARATOR	リスト内の項目を区切るための文字
NLS_MONETARY_CHARACTERS	通貨値用の小数点記号と3桁区切り
NLS_NUMERIC_CHARACTERS	数値用の小数点記号と桁グループ・セパレータ
NLS_SORT	文字データ用のソートのタイプ

これらのパラメータの詳細は、『Oracle8 Serverリファレンス・マニュアル』を参照してください。


NLS_LANG環境変数

  例	  関連項目

NLS_LANG環境変数によって、Forms Developerで使用される言語設定が決まります。

NLS_LANGによって指定される設定は次のとおりです。

•	'しばらくお待ちください...'メッセージなど、ユーザーに対して表示されるメッセージの言語

•	日付と数値用のデフォルトの書式マスク

•	ソート基準

•	キャラクタ・セットを構成する文字

NLS_LANGの構文を次に示します。

NLS_LANG=language_territory.charset

パラメータの内容は次のとおりです。

language	メッセージおよび日と月の名前を表示するための言語とその規約を指定します。 言語を指定しないと、その値はデフォルトで米語に設定されます。
territory	地域を指定し、デフォルトの日付書式や、数値、通貨記号および週番号と曜日番号の計算に使用される表記法規則も指定します。 地域を指定しないと、値はデフォルトでアメリカに設定されます。
charset	データを表すキャラクタ・セットを指定します。これは、使用している言語とプラットフォームに一致するキャラクタ・セットである必要があります。この引数は、メッセージの表示に使用するキャラクタ・セットも制御します。

NLS_LANGの詳細は、『Oracle8 Serverリファレンス・マニュアル』を参照してください。


DEVELOPER_NLS_LANG環境変数とUSER_NLS_LANG環境変数

  例	  関連項目

ほとんどの場合、NLS_LANGには1つの値を設定するのみで十分です。ただし、同一コンピュータ上で2か国語のリソース・ファイルとメッセージ・ファイルを同時に使用する必要がある場合、次の2つの環境変数が使用できます。

•	DEVELOPER_NLS_LANGは、製品のBuilder用の言語を指定します。

•	USER_NLS_LANGは、製品のRuntimeコンポーネント用の言語を指定します。

DEVELOPER_NLS_LANGとUSER_NLS_LANGの構文は、NLS_LANGと同じです。

次のような状況の場合は、NLS_LANGを1つ使用するかわりに、上記の2つの変数を使用します。

•	Builderは英語で使用する必要があるが、アプリケーションを他言語用に開発している場合。

•	双方向キャラクタ・セットを使用する言語で実行するアプリケーションを作成している場合。

•	Builderの各国語バージョンが使用できない言語で実行するアプリケーションを作成している場合。

注意  これらの環境変数を個別に指定しないと、それぞれがNLS_LANGのデフォルト値を取ります。

NLS_LANGの詳細は、『Oracle8 Serverリファレンス・マニュアル』を参照してください。


NLS_LANG環境変数の設定

  例	  関連項目

NLS_LANG環境変数を設定するには:

  NLS_LANG環境変数の値を定義する方法は、使用しているオペレーティング・システムについて他の環境変数を定義する場合と同じです。パスの長さなど、プラットフォームに固有の規則に注意してください。

たとえば、Microsoft Windows NTについてNLS_LANGを設定するには、次の手順を実行します。

1	「スタート」メニューの「ファイル名を指定して実行」を選択します。

2	'regedit'と入力し、「OK」をクリックして、レジストリ・エディタをオープンします。

注意  Windowsのレジストリを変更すると、システムの動作に大きく影響します。環境変数の変更は、必要な場合にのみ行います。操作を誤った場合は、「キャンセル」をクリックし、再度実行します。

1	「HKEY_LOCAL_MACHINE」ノードを拡張し、次に「SOFTWARE」ノードを拡張します。

2	「ORACLE」をクリックし、レジストリ・エディタの右側のパネルにOracle環境変数を表示します。

3	NLS_LANG環境変数をダブルクリックします。

4	「値のデータ」テキスト・ボックスにNLS_LANGの新しい値を入力し、「OK」をクリックします。

注意  NLSの機能を使用する場合は、製品がNLSコンポーネントを特定できるように、少なくともNLS_LANGを設定する必要があります。


Windowsプラットフォームでのフォントのエイリアシング

  関連項目

特定のフォントを使用してアプリケーションを作成しても、実行すると別のフォントが使用されている場合があります。この問題は、多くの場合、西ヨーロッパ圏以外の言語環境で英語フォント（MS Sans SerifやArialなど）を使用すると発生します。この問題が起こる理由は、フォントに関連付けられているキャラクタ・セットと、言語環境変数によって指定されたキャラクタ・セットが一致しているかどうかが、Forms Developerによってチェックされるためです。2つのキャラクタ・セットが一致しない場合、Forms Developerでは、言語環境変数によって指定されているキャラクタ・セットと一致するキャラクタ・セットに関連付けしているフォントに自動的に置換します。この自動置換によって、データベースから返されるデータがアプリケーション内で正しく表示されます。

注意  英語フォントを使用して各国語の文字を入力した場合、Windowsでは他のフォントに暗黙的な関連付けを行います。

ただし、このような自動置換を行いたくない場合もあります。自動置換が行われないようにするには、希望するすべてのフォントを、フォント・エイリアス・ファイル内のWE8ISO8859P1キャラクタ・セットにマッピングします。たとえば、アプリケーション内でArialフォントを使用できないときは、フォント・エイリアス・ファイルに次の行を追加します。

Arial.....=Arial...WE8ISO8859P1


サポートされているMicrosoft Windowsのキャラクタ・セット

キャラクタ・セット名	説明
AR8MSWIN1256	MS Windowsコード・ページ1256、8ビット、ラテン語/アラビア語
BG8MSWIN	MS Windows 8ビット、キリル語（ブルガリア）
CL8MSWIN1251	MS Windowsコード・ページ1251、8ビット、ラテン語/キリル語
EE8MSWIN1250	MS Windowsコード・ページ1250、8ビット、東ヨーロッパ言語
EL8MSWIN1253	MS Windowsコード・ページ1253、8ビット、ラテン語/ギリシア語
ET8MSWIN923	MS Windowsコード・ページ923、8ビット、エストニア語
IW8MSWIN1255	MS Windowsコード・ページ1255、8ビット、ラテン語/ヘブライ語
JA16SJIS	Shift-JIS、16ビット、日本語
KO16KSC5601	KSC5601、16ビット、韓国語
LT8MSWIN921	MS Windowsコード・ページ921、8ビット、リトアニア語
TH8TISASCII	タイ工業規格620-2533 - ASCII、8ビット
WE8ISO8859P1	ISO 8859-1、西ヨーロッパ言語
ZHS16CGB231280	CGB2312-80、16ビット、簡体字中国語
ZHT16BIG5	BIG5、16ビット、繁体字中国語


サポートされているアラビア語の表示キャラクタ・セット

Id	キャラクタ・セット名	説明
61	AR8ASMO708PLUS	ASMO 708 Plus Client、8ビット、ラテン語/アラビア語
72	AR8XBASIC	EBCDIC XBASIC Client、8ビット、ラテン語/アラビア語
504	AR8NAFITHA711T	Nafitha Enhanced 711 Client、8ビット、ラテン語/アラビア語
505	AR8SAKHR707T	SAKHR 707 Client、8ビット、ラテン語/アラビア語
506	AR8MUSSAD768T	Mussa'd Alarabi/2 768 Client 8-bit ラテン語/アラビア語
507	AR8ADOS710T	Arabic MS-DOS 710 Client、8ビット、ラテン語/アラビア語
508	AR8ADOS720T	Arabic MS-DOS 720 Client、8ビット、ラテン語/アラビア語
509	AR8APTEC715T	APTEC 715 Client、8ビット、ラテン語/アラビア語
511	AR8NAFITHA721T	Nafitha International 721 Client、8ビット、ラテン語/アラビア語
514	AR8HPARABIC8T	HP ARABIC8 Client、8ビット、ラテン語/アラビア語
567	AR8ARABICMACT	Mac Client、8ビット、ラテン語/アラビア語


言語および地域の表記法規約

  関連項目

文字コード体系によって各言語に必要な個々の文字が使用できる一方で、各国語の表記法規約のサポートにより、ローカライズされたデータ項目が正しく表示されます。

指定の言語によって、次の要素についてデフォルトの表記法規約が決まります。

•	サーバー・メッセージの言語

•	曜日名、月名およびそれらの省略形（SQL関数TO_CHARとTO_DATEによって指定）の言語

•	AM、PM、ADおよびBCを表す記号

•	ORDER BYを指定したときのデフォルトのソート基準（ORDER BYが指定されない限り、GROUP BYではバイナリ・ソートが使用されます）。

•	文字表記の方向

•	肯定応答または否定応答の文字列

たとえば、言語にフランス語を設定すると、次のメッセージ

ORA-00942：表またはビューが存在しません
FRM-10043:ファイルをオープンできません。

は、次のように表示されます。

ORA-00942：table ou vue inexistante
FRM-10043:Ouverture de fichier impossible.

指定された地域によって、次のような日付および数値に関するデフォルトの書式設定が決まります。

•	日付書式

•	小数点記号と桁グループ・セパレータ

•	各国通貨記号

•	ISO通貨記号

•	週の開始日

•	貸し方および借り方の記号

•	ISO週フラグ

•	リスト・セパレータ

たとえば、地域にフランスを設定すると、カンマを小数点記号として使用して数値が書式設定されます。


サポートされている言語

省略形	言語
us	米語
ar	アラビア語
bn	ベンガル語
ptb	ポルトガル語（ブラジル）
bg	ブルガリア語
frc	フランス語（カナダ）
ca	カタロニア語
hr	クロアチア語
cs	チェコ語
dk	デンマーク語
nl	オランダ語
eg	エジプト語
gb	英語
et	エストニア語
sf	フィンランド語
f	フランス語
d	ドイツ語
din	ドイツ工業規格
el	ギリシア語
iw	ヘブライ語
hu	ハンガリー語
is	アイスランド語
in	インドネシア語
i	イタリア語
ja	日本語
ko	韓国語
esa	スペイン語（ラテン・アメリカ）
lv	ラトビア語
lt	リトアニア語
ms	マレー語
esm	スペイン語（メキシコ）
n	ノルウェー語
pl	ポーランド語
pt	ポルトガル語
ro	ルーマニア語
ru	ロシア語
zhs	簡体字中国語
sk	スロバキア語
sl	スロベニア語
e	スペイン語
s	スウェーデン語
th	タイ語
zht	繁体字中国語
tr	トルコ語
uk	ウクライナ語
vn	ベトナム語

注意  特定の言語がサポートされていても、その言語の翻訳が使用できるとは限りません。


サポートされている地域

アルジェリア	ギリシア	ポルトガル
アメリカ	香港	カタール
オーストリア	ハンガリー	ルーマニア
バーレーン	アイスランド	サウジ・アラビア
バングラデシュ	イラク	スロバキア
ブラジル	イスラエル	スロベニア
ブルガリア	イタリア	ソマリア
カナダ	日本	スペイン
カタロニア	ヨルダン	スーダン
中国	韓国	スウェーデン
CIS	クウェート	スイス
クロアチア	ラトビア	シリア
キプロス	レバノン	台湾
チェコ共和国	リビア	タイ
チェコスロバキア	リトアニア	オランダ
デンマーク	マレーシア	チュニジア
ジブティ	モーリタニア	トルコ
エジプト	メキシコ	ウクライナ
エストニア	モロッコ	アラブ首長国連邦
フィンランド	ノルウェー	イギリス
フランス	オマーン	ベトナム
ドイツ	ポーランド	イエメン


Forms Developerの双方向サポート

  関連項目

中東圏の言語および北アフリカ圏の言語についてのNLSサポートには、通常の文字表記方向が右から左である言語の双方向サポートが含まれます。

双方向サポートによって、開発者は次の事項を制御できるようになります。

•	レイアウト方向。右側にラベルがあり、チェックボックスおよびラジオ・ボタンが正しい位置に配置されている項目の表示を含みます。

•	読み方向。右から左または左から右のテキスト方向を含みます。

•	整列。原点の左上から右上への切替えを含みます。

•	初期キーボード状態。エンド・ユーザーがフォームへの入力を開始したときに、各国語文字またはローマ字が自動的に生成されるかどうかを制御します（エンド・ユーザーはこの設定を上書きできます）。

NLS_LANG環境変数に加え、双方向アプリケーションでは次の2つの環境変数を使用する場合があります。

•	DEVELOPER_NLS_LANG

•	USER_NLS_LANG

たとえば、Windows環境でアラビア語のアプリケーションを開発しているときに、米語のインタフェースを使用する場合は、これらの環境変数を次のように設定します。

DEVELOPER_NLS_LANG=AMERICAN_AMERICA.AR8MSWIN1256
USER_NLS_LANG=ARABIC_territory.charset


Form Builderの双方向サポート

  関連項目

双方向アプリケーションでのオブジェクトの外観を指定するには、「方向」、「文字位置」、「読込み順序」、「キーボード状態」および「初期キーボード状態」の5つのプロパティが使用されます。

「方向」は包括的なプロパティで、各オブジェクトについてできる限り多くの機能を提供します。テキスト項目と表示項目を除くすべてのオブジェクトについて、「方向」プロパティが唯一の双方向プロパティで、その設定によって双方向機能の他の局面が制御されます。（ただし、リスト項目には、「初期キーボード状態」と「キーボード状態」の各プロパティが含まれます。）

テキスト項目と表示項目には「方向」プロパティはありませんが、「文字位置」、「読込み順序」、「初期キーボード状態」および「キーボード状態」の各プロパティに限り、これらの項目について設定できます。

キーボード状態は1つの言語に制限できます。たとえば、「キーボード状態」に「ローカル」を設定すると、エンド・ユーザーはキーボードを他の言語に切り替えることができなくなります。

双方向プロパティに「デフォルト」を設定すると、これらのプロパティは、言語環境変数で指定された通常の文字表記方向の値を継承します。ほとんどの場合、これによって希望する機能は提供されます。継承されたデフォルト値を上書きしたいときは、双方向プロパティを指定するのみです。

双方向プロパティの継承は次のとおりです。

	デフォルト設定の値が導出されるオブジェクト
フォーム	言語環境変数
警告、ブロック、値リスト、ウィンドウおよびキャンバスビューなど、すべてのオブジェクト	フォーム
テキスト項目、表示項目、チェックボックス、ボタン、ラジオ・グループおよびリスト項目などのすべての項目	キャンバスビュー

双方向機能に関連する大部分のプロパティは、プログラムによって取り出し、設定できます。詳細は、適切なビルトイン・サブプログラムの説明を参照してください。たとえば、ボタンの「方向」プロパティの値を取得する方法の詳細は、GET_ITEM_PROPERTYの説明を参照してください。


Report Builderの双方向サポート

  関連項目

双方向アプリケーションでのオブジェクトの外観を指定するには、「位置揃え」、「方向」（オブジェクト用）および「方向」（レポート用）の3つのプロパティが使用されます。双方向プロパティは、次に示す階層でオブジェクトに追加されます。

モジュール

ボイラープレート

フィールド

外部ボイラープレート

ボタン

パラメータ・フォーム・ボイラープレート

このリストにないオブジェクトは、双方向サポートを必要としないか（イメージなど）、上記のいずれかのオブジェクト・プロパティからデフォルト値を継承します。


Forms DeveloperのUnicodeサポート

  関連項目

Unicodeは、1つのアプリケーションで多言語テキストを表示できるようにするグローバルなキャラクタ・セットです。これによって多国籍企業では、次に説明するように、1つの多言語アプリケーションを開発し、それを世界各国で実行できます。

グローバルな市場では、次のようなキャラクタ・セットが必要です。

•	すべての言語について製品の1つのインプリメンテーションで済み、さらに世界各国で簡単にインプリメントできること。

•	主要スクリプトをすべて含むこと。

•	多言語ユーザーおよび多言語組織をサポートします。

•	インターネットを使用して世界各国間でのデータ交換が可能であること。

Forms DeveloperではUnicodeをサポートしています。Unicodeを使用すると、西ヨーロッパ、東ヨーロッパおよび中東（双方向）などのシングルバイト言語や、中国語、日本語および韓国語（CJK）などマルチバイトのアジア言語といった複数の言語を、同一アプリケーションで表示できるようになります。

すべての言語を網羅する1つのキャラクタ・セットを使用することにより、さまざまな言語についてさまざまなキャラクタ・セットを用意する必要がなくなります。

たとえば、日本語などのマルチバイト言語を表示するには、NLS_LANG環境変数を次のように設定する必要があります（Windowsプラットフォームの場合）。

Japan_Japanese.JA16SJIS

ドイツ語などのシングルバイト言語を表示するには、NLS_LANGを次のように設定する必要があります（Windowsプラットフォームの場合）。

German_Germany.WE8ISO8859P1

この方式の明らかな短所は、アプリケーションで一度に表示できる文字が1つのキャラクタ・セットに限られることです。複数のキャラクタ・セットを組み合せた言語データは生成できません。

Unicodeキャラクタ・セットでは、NLS_LANGのキャラクタ・セット部分に、特定言語のキャラクタ・セットのかわりにUTF8を設定できます。これによって、異なる言語およびキャラクタ・セットの文字を同時に表示できます。

たとえば、画面上に日本語とドイツ語を同時に表示するには、NLS_LANGの変数を次のように設定する必要があります。

Japanese_Japan.UTF8

または

German_Germany.UTF8

Forms DeveloperのUnicode機能によって、アプリケーション開発者とエンド・ユーザーは、多言語テキストをフォーム内で表示できるようになります。これには、Unicodeを含むデータベースのテキスト、多言語テキスト、GUIオブジェクト内のテキスト（ボタン・ラベルなど）、キーボード入力されたテキストおよびクリップボードのテキストなども含まれます。Forms Developerでは現在、Windows NT 4.0とWindows 95/98（限定サポート）上でUnicodeをサポートしています。

注意  Web用にアプリケーションを開発する場合は、Unicodeを使用できます。これは、JavaによってUnicodeがサポートされているためです。


構成に関する考慮点

  関連項目

UNIXサーバーでは複数のORACLE_HOME(ORACLE_HOMEはOracleソフトウェアについてそれ自体によって作成されるディレクトリ）をサポートできるため、複数のNLS設定をサポートできます。つまり、1台のUNIXサーバーで複数の言語をサポートできます。

ただし、Windows NTでは、サポートできるORACLE_HOMEは1つに限られるため、サポートできるNLS設定も1つのみです。つまり、Windows NTでサポートできる言語は1つのみです。


Unicodeフォントのサポート

  関連項目

Unicodeの多言語テキストを表示するには、絵文字または表示される言語の文字を含むフォントを使用する必要があります。Windows NT、Windows 95およびWindows 98の場合、Microsoft社によって提供されるTrueTypeの'Big Fonts'か、サード・パーティーのUnicodeフォントを使用する必要があります。多言語テキストを入力、表示または印刷して、予期しない文字が表示された場合は、Big Fontを使用していない可能性があります。Microsoft社がNT 4.0で提供しているBig Fontは次のとおりです。

•	Arial

•	Courier New

•	Lucida Console

•	Lucida Sans Unicode

•	Times New Roman

WindowsのBig Fontで表示要件が満たされない場合は、サード・パーティーのフォントを使用します。


Unicodeサポートの有効化

  関連項目

Forms DeveloperでUnicodeサポートを有効にするには、NLS_LANGを次のように設定します。

NLS_LANG=language_territory.UTF8


キャラクタ・セット間の変換

  関連項目

複数の言語で使用するアプリケーションの設計を始めるとき、アプリケーションのエンド・ユーザーによって使用されるキャラクタ・セットと、アプリケーション開発者によって使用されるキャラクタ・セットの両方を考慮する必要があります。実行時におけるキャラクタ・セット・レベルでの変換は自動ですが、この変換によってパフォーマンスは影響を受けます。

たとえば、1つのキャラクタ・セットでアプリケーションを構築し、別のキャラクタ・セットで実行すると、パフォーマンスの低下が見られる場合があります。また、特定の文字と同等の文字がキャラクタ・セットに含まれていない場合、クエスチョン・マーク（?）などの代替文字が表示されます。ただし、目に見える違いがわからない場合でも、パフォーマンスの問題があるため、言語の生成に使用するキャラクタ・セットには開発者として十分な注意を払う必要があります。

注意  Forms Developerでは、AR8MSWINとAR8ISOまたはIW8MSWINとIW8ISOなど、同一言語のキャラクタ・セット間の変換のみを行います。

複数の言語または同一言語でも異なるキャラクタ・セットで実行するアプリケーションを設計する場合、最適なパフォーマンスを実現するため、生成する環境を実行時環境に合せる必要があります。たとえば、次の作業を行います。

•	実行時に最も幅広く使用されるキャラクタ・セットを判断します。

•	言語環境変数をそのキャラクタ・セットに設定して環境を生成します。

注意  Form Builderの場合、生成時に使用されるキャラクタ・セットは、実行時環境でキャラクタ・セットを指定した場合でも、実行時に使用されます。


Forms Developerユーザー・インタフェース

  関連項目

Oracleではソフトウェアの多言語化で1つの実行可能なアプローチを使用します。つまり、シングルバイトのヨーロッパ言語やマルチバイトのアジア言語を処理するために、別の実行可能ファイル（f60des.exeなど）が不要になることを意味します。同一のツール・セットを使用して、英語および英語以外のアプリケーションを作成できます。

注意  Forms Developerでは、異なる言語のフォントおよび入力方式について、Microsoft社のWindowsオペレーティング・システムに依存しています。任意の言語でテキストを入力および表示するには、その言語をサポートするWindowsのバージョンを実行している必要があります（タイ語を表示するには、Thai語のWindowsを実行している必要があります）。

Forms Developerのインストール時に、インストールするメッセージ・ファイルの言語を選択します。Forms Developerのコンポーネント（Form Builderなど）を使用すると、言語環境変数に基づく適切なメッセージ・ファイルを使用してインタフェースが表示されます。たとえば、次のインタフェース要素が含まれます。

•	メッセージ

•	メニューとメニュー項目

•	ダイアログ・ボックス

•	プロンプトとヒント

•	警告

現行の言語設定に対応するメッセージ・ファイルがForms Developerによって検索されない場合、デフォルトで米語のメッセージ・ファイルが設定されます。

注意  メッセージ・ファイルのインストール時に指定できる言語は、米語の他に1つのみです。Forms Developerを別の言語で使用する必要が生じた場合は、適切なメッセージ・ファイルを使用してForms Developerを再インストールする必要があります。

メッセージ・ファイル名によって、Forms Developerコンポーネントと言語が指定されます。その場合、次のようなファイル命名規則が使用されます。

<product_id><language_id>.MSB

たとえば、Form Builderの場合を次に示します。

FMDUS.MSBには、デフォルト（米語）のBuilderメッセージが含まれます。

FMGUS.MSBには、デフォルト（米語）のGenerateメッセージが含まれます。

FMFUS.MSBには、デフォルト（米語）のRunformメッセージが含まれます。

FMFI.MSBには、イタリア語のRunformメッセージが含まれます。

FMFD.MSBには、ドイツ語のRunformメッセージが含まれます。

言語に依存するメッセージ・ファイルのインストールの詳細は、使用しているプラットフォーム用インストレーション・ガイドおよびユーザーズ・ガイドを参照してください。

注意  言語用の補足製品には上位互換性がありません。それらの製品は、共にリリースされたバージョンのForms Developerとのみ動作するように提供されています。以前のリリースの言語用の補足製品がすでにインストールされている場合は、システムから削除する必要があります。


CONVERTを使用したデータ変換

SQL関数CONVERTを使用すると、キャラクタ・セット間でデータを変換できます。この関数は、1つのキャラクタ・セットでの文字列のバイナリ表現を、別のキャラクタ・セットのバイナリ表現に変換します。変換の詳細は、「キャラクタ・セット間の変換」を参照してください。

CONVERTの詳細は、『Oracle8 Serverリファレンス・マニュアル』を参照してください。


デフォルトの書式マスク

  例	  関連項目

言語環境変数によって、Forms Developerインタフェース（BuilderとRuntime）で使用される言語のみでなく、データの表示に使用される一連のデフォルト書式マスクも定義されます。ただし、明示的な書式マスクによってデフォルトが上書きされない場合に限ります。アプリケーション開発者としてデフォルトの表示マスクを上書きする場合は、NLS関連の追加の書式マスクも使用できます。

Forms Developerまたはアプリケーションに入力されるすべてのデータでは、特定の地域に関連付けられたデフォルトの書式マスクが使用されます。そのため、アプリケーションの構築時および実行時に言語を変更でき、日付および数値の書式を変える必要はありません。

Forms Developerでは、次の場合に限りデフォルトの書式マスクを使用します。

•	Builderの使用時: Builderによって、項目、範囲またはパラメータのデフォルト値が表示される場合

•	実行時： ユーザーが、DATEやNUMBERなど、地域固有の型を持つテキスト項目に対してデータを入力する場合

多言語アプリケーションの日付フィールドおよび通貨フィールドについて作業するときは、次の点を考慮する必要があります。

•	表示されるすべての項目（ボイラープレート、テキスト項目、ボタンなどのインタフェース・オブジェクトおよび値リスト）の長さを増やして、テキストの翻訳、および各国語固有の表記法規約に基づく形式で数値を表示できるようにするかどうか。

•	特別な書式マスクを作成するために、NLS関連の書式マスク文字を使用する必要があるかどうか、またはNLS_LANGによって起動されるデフォルトの書式マスクで十分かどうか。


ヒント
暗黙的な型変換の場合、PL/SQLでは常にデフォルトの米語書式（DD-MON-YYなど）が使用されるため、地域固有の型を持つ項目をPL/SQLで使用する場合は、正しい書式マスクを指定する必要があります。PL/SQLで地域固有の項目を翻訳する場合、オラクル社では次に示すとおり、TO_DATEを使用することをお薦めします。

IF :emp.hiredate < TO_DATE('30-12-1996','DD-MM-YYYY') THEN
   ...


書式マスク文字

  例	  関連項目

次の書式マスク文字を使用すると、デフォルトの書式マスクを上書きできます。

日付の書式マスク文字

文字	戻り値
D	日の桁（1～7）
DY	曜日の名前（省略形）
DAY	曜日の名前（空白埋めによって9文字分の長さにされます）
WW	週の桁。アルゴリズムint((day-jan1)/7)によって計算されます。
IW	ISO週の桁
MON	月の名前（省略形）
MONTH	月の名前（空白埋めによって9文字分の長さにされます）
RM	ローマ数字による月の文字
I,IY,IYY,IYYYY	先頭から順に、ISO年の最後の1桁、2桁、3桁およびISO年
BC,AD,B.C.,A.D.	BCまたはADの記号（ピリオド付きとピリオドなし）
AM,PM,A.M.,P.M.	AMまたはPMの記号（ピリオド付きとピリオドなし）
ISOとその日付書式マスクの詳細は、『Oracle Server SQLリファレンス』を参照してください。

数値の書式マスク文字

文字	戻り値
C	国際通貨記号
L	各国通貨記号
D	小数点セパレータ
G	桁グループ（3桁）セパレータ


文字データのソート

  制約	  例	  関連項目

従来から文字データをソートするときは、文字コード体系によって定義される文字の数値に基づいてソート基準が決定されます。このようなソートはバイナリ・ソートと呼ばれ、英語アルファベットについて順序どおりの結果を生みます。これは、ASCII標準およびEBCDIC標準では、AからZまでの文字が昇順の数値で定義されるためです。注意

ただし、他の言語で使用される文字が含まれている場合、バイナリ・ソートでは順序どおりの結果は生まれません。たとえば、昇順のORDER BY問合せによって、文字列ABC、ABZ、BCDおよびﾄBCがこの順序で返されます。文字コード体系では、ﾄはBよりも高い数値を持ちます。

特定の言語について文字のアルファベット順に一致するソート基準を生成するには、文字コード体系の数値を考慮せずに文字をソートする、別のソート手法を使用する必要があります。このような手法は言語ソートと呼ばれます。言語ソートは、バイナリ・ソートで希望の結果が返されるように、文字本来の言語順序を反映する他のバイナリ値と文字を置き換えることによって動作します。

言語上の特殊ケース  言語上の特殊ケースとは、ソート時に1つの文字として扱う必要のある文字順序です。そのような特殊ケースは、言語ソートを使用すると自動的に処理されます。たとえば、スペイン語の言語ソート基準では、2文字のchとllは、cとdの間およびlとmの間にそれぞれ来るとき1つの文字としてソートされることが指定されます。

もう1つの例としてドイツ語のシャープs（ﾟ）があります。ドイツ語の言語ソート基準では、この順序が2文字のSSとしてソートされ、米語の言語ソート基準ではSZとしてソートされます。

このような特殊ケースは、大文字を小文字にまたは小文字を大文字に変換するときにも処理されます。たとえば、ドイツ語でシャープsの大文字は2文字のSSです。このような大/小文字変換の問題は、言語ソート基準によって定義された規則に従って、NLS_UPPER、NLS_LOWERおよびNLS_INITCAPの各関数によって処理されます。（標準関数のUPPER、LOWERおよびINITCAPではこれらの特殊ケースは処理されません。

NLSSORT関数  SQL関数NLSSORTを使用して、文字データをソートできます。この関数は、ソート機構で使用される同等のソート文字列によって文字列を置き換えます。バイナリ・ソートの場合、ソート文字列は入力文字列と同じです。言語ソートが使用されている場合、NLSSORTは元の文字列を置き換えるために使用されたバイナリ値を返します。


注意
ASCII標準では、すべての大文字は小文字の前に表示されます。EBCDIC標準ではそれとは反対に、すべての小文字は大文字の前に表示されます。


言語ソートの制約

  関連項目

言語ソートは、マルチバイト・キャラクタ・セットでサポートされていません。


WHERE句に含まれる文字列の比較

  例	  関連項目

WHERE句に含まれる文字列は、文字のバイナリ値を使用して比較されます。データベース・キャラクタ・セットにおいてより高いバイナリ値を持つ文字は、より低いバイナリ値を持つ文字より'大きい'と言えます。データベース・キャラクタ・セットにおいてより高いバイナリ値を持つ文字は、より低いバイナリ値を持つ文字より'大きい'と言えます。バイナリ値に基づく文字順序は、その言語のアルファベット順と一致しない場合があるため、アルファベット規則に従った比較はあまり行われません。バイナリ・ソートのかわりに言語ソートを実行するには、NLSSORT関数を使用します。


ORDER BY句の制御

  関連項目

言語ソートの順序が使用されている場合、NLSSORTはORDER BY句の各文字項目について暗黙的に使用されます。その結果、ORDER BYについて使用されるソート機構（言語またはバイナリ）は、アプリケーションにとって透明です。

ただし、ORDER BY項目の文字項目についてNLSSORT関数が明示的に指定された場合、暗黙的なNLSSORTは実行されません。つまり、NLSSORTの言語置換は1度のみ適用され、2度目からは適用されません。

デフォルトのソート機構が言語ソートの場合、NLSSORT関数は通常、ORDER BY句では必要ありません。ただし、デフォルトのソート機構がバイナリの場合、次のような問合せでバイナリ・ソートが使用されます。

SELECT ENAME FROM EMP

ORDER BY ENAME

は、バイナリ・ソートを使用します。言語ソートは（次の例に示すドイツ語の場合）、次の構文を使用して取得できます。

SELECT ENAME FROM EMP

ORDER BY NLSSORT(ENAME, 'NLS_SORT = GERMAN')


ALTER SESSIONの使用

  例	  関連項目

NLSデフォルトを上書きするには、ALTER SESSION SQLコマンドを使用できます。たとえば、一部のパラメータ（languageやterritoryなど）を作成し、ユーザーがその値を指定すると仮定します。すると、ユーザーが指定したとおりにセッションを変更できます。

注意  実行時に、サーバーは、NLS_LANGで指定された値に基づいてクライアントのためにALTER SESSIONコマンドを実行します。NLS_LANGが定義されていないと、ALTER SESSION文は実行されません。

Form Builderでは、ALTER SESSIONコマンドについて次のNLSパラメータを指定できます。ただし、Report BuilderとGraphics Builderの場合は、NLS_SORTパラメータしか指定できません。

パラメータ	説明
NLS_LANGUAGE	メッセージおよびエラーを返すためにサーバーによって使用される言語
NLS_TERRITORY	デフォルトの日付マスクおよび通貨マスク用の地域
NLS_DATE_FORMAT	日付用のデフォルト書式
NLS_DATE_LANGUAGE	日付用のデフォルト言語
NLS_NUMERIC_CHARACTERS	小数点記号および桁グループ・セパレータ
NLS_ISO_CURRENCY	ISO国際通貨記号
NLS_CURRENCY	各国通貨記号
NLS_SORT	文字ソート基準
NLS_CALENDAR	現行のカレンダー・システム

これらのパラメータの詳細は、『Oracle8 SQL リファレンス』マニュアルを参照してください。


SQL関数でのNLSパラメータの使用

  関連項目

SQLを使用する場合は常に、次のNLSパラメータを使用してデフォルトのNLS動作を上書きできます。

SQL関数	NLSパラメータ
TO_DATE	NLS_DATE_LANGUAGE NLS_CALENDAR
TO_NUMBER	NLS_NUMERIC_CHARACTERS NLS_CURRENCY NLS_ISO_CURRENCY
TO_CHAR	NLS_DATE_LANGUAGE NLS_NUMERIC_CHARACTERS NLS_CURRENCY NLS_ISO_CURRENCY NLS_CALENDAR
NLS_UPPER	NLS_SORT
NLS_LOWER	NLS_SORT
NLS_INITCAP	NLS_SORT
NLSSORT	NLS_SORT

これらのパラメータの詳細は、『Oracle8 SQLリファレンス』マニュアルを参照してください。


Form BuilderのNLSパラメータ

  関連項目

PL/SQLコードで使用されるNLS環境変数の現行値を取得するには、Form Builderのビルトイン関数を使用できます。

	DEVELOPER_NLS_LANG	USER_NLS_LANG
ビルトイン	GET_FORM_PROPERTY	GET_APPLICATION_PROPERTY
パラメータ	MODULE_NLS_LANG	USER_NLS_LANG

USER_NLS_LANGとDEVELOPER_NLS_LANGはどちらもNLS_LANGの値にデフォルトで設定されるため、どちらかの変数が設定されない場合、Form BuilderのNLSパラメータはNLS_LANGの値を持ちます。

Form BuilderのNLSパラメータはどちらも4つのバリエーションがあり、環境変数のすべてまたは特定部分のみを取り出せます。次の表に、USER_NLS_LANG環境変数を返すGET_APPLICATION_PROPERTYビルトインの4つのパラメータを示します。

パラメータ	戻り値
USER_NLS_LANG	すべてのUSER_NLS_LANG変数
USER_NLS_LANGUAGE	言語部分のみ
USER_NLS_TERRITORY	地域部分のみ
USER_NLS_CHARACTER_SET	キャラクタ・セット部分のみ

DEVELOPER_NLS_LANG環境変数を取り出すには、MODULE_NLS_LANGパラメータを使用してGET_FORM_PROPERTYをコールします。


プリンタ定義ファイルと各国語サポート

  関連項目

レポートを文字モードで使用する場合、レポートの物理ページ幅を、プリンタ定義ファイル（.PRTファイル)で定義されたページ幅より1文字分少なくして定義する必要があります。そのように定義しなかった場合、マルチバイト文字は行の最後の文字スペースから印刷され、すべてを印刷するために次の行に渡る場合があります。たとえば、物理ページ幅が80文字で、プリンタ定義の幅も80文字の場合、マルチバイト文字は80番目の文字から印刷される場合があります。マルチバイト文字は分割できないため、マルチバイト文字をすべて印刷するために81番目の文字を次の行に渡す必要があります。これを回避するため、物理ページ幅はレポートについて79に設定する必要があります。

次に示すアラビア語およびヘブライ語に固有のNLSパラメータは、プリンタ定義ファイルで設定できます。

使用するパラメータ	目的	パラメータの値
nls locale	印刷エンジンの地域を設定する。	hebrewまたはarabic
nls datastorageorder	論理データ格納または可視データ格納を設定する。	logicalまたはvisual
nls contextuallayout	アラビア語プリンタについて、事前の文脈依存レイアウトを実行する。	noまたはyes
nls contextualshaping	アラビア語プリンタについて、事前の文脈依存形状を実行する。	noまたはyes
nls pcharset	プリンタのキャラクタ・セットを指定する。	任意のキャラクタ・セット

プリンタ定義ファイルの詳細は、Report Builderのヘルプ・システムを参照してください。


アプリケーションの翻訳

  関連項目

すべてのエラー・メッセージとボイラープレート・テキストは、同じ言語で表記される必要があります。アプリケーションの実行時、エンド・ユーザーに対して表示されるメッセージまたはボイラープレート・テキストのソースには、次の3つがあります。

•	サーバーからのエラー・メッセージ

•	Forms Developerによって生成される実行時エラー・メッセージ

•	アプリケーションの一部として定義されるメッセージまたはボイラープレート・テキスト

OracleのNLSでは、最初の2つのソースの翻訳を処理します。アプリケーション開発者は、3つ目のソースであるメッセージおよびボイラープレート・テキストを翻訳する必要があります。

通常、翻訳する必要のあるアプリケーション固有のテキストには、次の2つのタイプがあります。

•	メニュー、ボイラープレート・テキスト、項目ラベル、メッセージおよびヒントなど、翻訳可能なテキスト

•	トリガー内で定義された警告およびメッセージを含む、トリガーおよびプロシージャ内の文字列

Translation Builderを使用することによって、ユーザー・インタフェース内の'翻訳可能テキスト'を、複数の言語に翻訳できます。Translation Builderを使用すると、各言語について個別のバイナリ・ファイルを生成することにより、ほとんどすべてのForms Developer多言語アプリケーションを翻訳できるようになります。

Translation Builderではユーザー・インタフェース内の文字列を検索および翻訳できますが、PL/SQLトリガーおよびプロシージャ内の文字列定数を取り出すことはできません。PL/SQLブロック内の定数テキストについては、手動で翻訳する必要があります。これは、テキストが明確に区切られておらず、多くの場合、変数や文字列から構築されているためです。

Translation Builderの詳細は、Translation Builderのヘルプ・システムを参照してください。


設計に関する考慮点

  関連項目

後で翻訳されるアプリケーションを設計する場合、ウィジェットおよびボイラープレート・ラベル用に、追加スペースを残しておくことに注意します。複数のキャラクタ・セットに対応し、翻訳によるスペースの拡張に対処するには、フィールド、境界線およびボイラープレート・テキストの周辺に、30パーセントの空白を残しておくことをお薦めします。

次に例を示します。

フィールド左側のプロンプト	拡張に備えてプロンプトの左側に30パーセントの余白を残す。
フィールドの上のプロンプト	拡張に備えてプロンプトの右側に30パーセントの余白を残す。
ボタン、チェックボックス、ラジオ・グループおよびポップリスト	30パーセントの拡張を考慮する。
タイトル	タイトルを右に30パーセント拡張できるように、バウンディング・ボックスをサイズ設定する。
表示のみのフィールド	基本言語で必要となるサイズより30パーセント広くサイズ設定する。
すべてのウィジェット	すべての翻訳が表示されるように、ウィジェットのサイズを十分に大きくする。たとえば、ボタンは翻訳されたラベルを表示できるだけの大きさが必要です。 使用する必要のある文字で最も高さのある文字が表示できるように、ボタンの長さだけでなく高さもチェックします。たとえば、漢字の表示に必要なピクセル数を計算します。


Translation Builderアプローチの使用

  関連項目

Translation Builderを使用すると、ほとんどすべてのForms Developer多言語アプリケーションを翻訳できます。アプリケーション側でエンド・ユーザーが実行時に言語を切り替える必要がない限り、Translation Builderを使用して、各言語について個別のバイナリ・ファイルを生成できます。

実行時に1つの言語から別の言語に変更する場合、ユーザーはアプリケーションを終了し、言語環境変数を変更します。次に、アプリケーションを再起動します。

Translation Builderアプローチでは、次の段階に従ってアプリケーションを開発します。

•	ソース言語で1つの基本的なアプリケーション定義を作成します（.FMBや.RDFなど）。

•	Translation Builderを使用して、翻訳する文字列を抽出します。次に、文字列を再度アプリケーション定義内に格納します。

•	PL/SQLライブラリの標準メッセージを手動で翻訳します。

•	Generatorを使用して、各ターゲット言語についてアプリケーションのバイナリ・バージョンを生成します。

メリット  上記の方法は、複数言語のアプリケーションを短時間でインプリメントする最も簡単な方法です。このアプローチを使用すると、最も効率よくTranslation Builderを使用できます。動作が安定しているアプリケーションであれば、このアプローチが最適です。

たとえば、4つの言語でアプリケーションを作成し、後でフィールド・ラベルのテキストを変更する必要が生じた場合は、Builder内で変更を行い、定義ファイルに変更を保存します。次に、Translation Builderを使用して新しいフィールド・ラベルを翻訳し、新しいメッセージを定義ファイルに挿入し、再生成して、新しいラベルを含んだバイナリ・ファイルを作成します。

デメリット  アプリケーションで複数の言語を同時にサポートする必要がある場合、かわりに実行時言語切替えアプローチを使用する必要があります。


実行時言語切替えアプローチの使用

  関連項目

アプリケーションの中には、複数の言語を同時にサポートする必要のあるものが少数ながらあります。たとえば、ウィンドウに英語を表示して起動するアプリケーションは終了するまでその状態である必要がありますが、エンド・ユーザーがそのウィンドウ内のボタンを押すことによってプロンプトをフランス語に切り替えたり、また英語に戻したりする場合があります。

アプリケーションで実行時の言語切替えが必要な場合、言語が同じキャラクタ・セットを共有する限り、複数の言語を組み込むことができますが、実行時にテキストを動的に生成している場合は、Translation Builderを使用して翻訳可能なテキストを特定することはできません。そのかわり、case構造（IF...THEN...ELSIF）を構築し、GET_FORM_PROPERTYを使用してNLS環境変数の値をチェックすることによって、アプリケーションの言語を別の言語に変更できます。

実行時言語切替えアプローチでは、次の段階に従ってアプリケーションを開発します。

•	ライブラリも含めて、アプリケーション全体を1つの言語について開発します。

•	各ライブラリを手動で翻訳します。

•	ボイラープレート・ラベルを、実行時に動的に生成される、適切にサイズ設定された表示項目として設計します。

Form Builderでは複数のライブラリを連結できるため、翻訳されるメッセージについて1つのライブラリを使用し、他のライブラリを他の用途に利用できます。

メリット  このアプローチの主なメリットは、フォームが高度に動的になる洗練されたアプリケーションをサポートできることです。フォームが高度に動的になるケースでは、フォームが変わるたびに各言語について個別のファイルを生成する必要がないため、このアプローチによってメンテナンスに関する一部の問題が回避されます。

デメリット  このアプローチは、他のアプローチより複雑です。言語に固有なメッセージの格納、生成およびそのためのメンテナンスを行ったり、手動で翻訳を実行したりするために非常に多くの作業が発生するためです。たとえば、各ボタンにラベルを設定するために、WHEN-NEW-FORM-INSTANCEトリガーを設定し、NLS環境変数の値に基づいて、連結ライブラリから正しいラベルを読み込みます。


コード内文字列についてのPL/SQLライブラリの使用

  例	  関連項目

Translation Builderでは標準のBuilderインタフェースの一部であるメッセージを翻訳できますが、プログラムによって表示されるメッセージでは特別な処理が必要です。PL/SQLライブラリを使用すると、メッセージについて柔軟なメッセージ構造をトリガーまたはプロシージャ内でインプリメントできます。

ビルトイン・ルーチンMESSAGEまたはCHANGE_ALERT_MESSAGEFを使用して画面にプログラムによって表示されるメッセージや、トリガーまたはプロシージャの表示項目にメッセージを割り当てることによって表示されるメッセージなど、アプリケーション固有のメッセージの場合、連結可能なPL/SQLライブラリを使用して、柔軟なメッセージ機能をインプリメントできます。ライブラリはホスト上に格納し、実行時に動的に連結できます。実行時には検索パスに基づいて、フォームに連結されたライブラリを読み込むことができます。（たとえば、ライブラリはイタリア語のメッセージのみを保有している場合があります。）


各国語サポートの例

  関連項目 	  すべての例

文字列比較の例

書式マスクの例

NLS_LANGの例

PL/SQLライブラリの例


ALTER SESSIONの例

  関連項目

次の文は、小数点記号をカンマに、桁グループ・セパレータをピリオドに変更します。

ALTER SESSION
   SET NLS_NUMERIC_CHARACTERS = ',.'

これらの新しい文字は、それらの数値書式要素DとGを使用すると返されます。

SELECT TO_CHAR(SUM(sal), 'L999G999D99') Total FROM emp

TOTAL
--------------
   FF29.025,00

次の文は、ISO通貨記号を、地域がアメリカの場合のISO通貨記号に変更します。

ALTER SESSION
   SET NLS_ISO_CURRENCY = America

アメリカについて定義されたISO通貨記号が使用されます。

SELECT TO_CHAR(SUM(sal), 'C999G999D99') Total FROM emp

TOTAL
---------------
   USD29.025,00

次の文は、各国通貨記号をDMに変更します。

ALTER SESSION
   NLS_CURRENCY = 'DM'

新しい各国通貨記号は、数値書式要素Lを使用すると返されます。

SELECT TO_CHAR(SUM(sal), 'L999G999D99') Total FROM emp

TOTAL
--------------
   DM29.025,00


文字列比較の例

  関連項目 	  すべての例

ISO 8859/1 8ビット・キャラクタ・セットでABC、ABZ、BCDおよびﾄBCの値を含む列（COL1）があると仮定します。また、次の問合せを作成したと仮定します。

SELECT COL1 FROM TAB1 WHERE COL1 > 'B'

ﾄはBよりも高い数値を持つため、この問合せではBCDとﾄBCが返されます。

次に示すとおり、WHERE句でNLSSORTを使用して、言語比較を実行できます。

WHERE NLSSORT(column) operator NLSSORT(string)

NLSSORTを比較演算子の両側で使用する必要があることに注意してください。

SELECT COL1 FROM TAB1 WHERE NLSSORT(COL1) > NLSSORT('B')

ドイツ語の言語ソートが使用されている場合、ドイツ語アルファベットでﾄはBの後に来るため、この問合せではﾄで始める文字列は返されません。スウェーデン語の言語ソートが使用されている場合、スウェーデン語アルファベットでﾄはZの後に来るため、ﾄで始める文字列が返されます。


書式マスクの例

  関連項目 	  すべての例

NLS準拠のアプリケーションの場合、月名を含む文字列はハードコードしないようにします。ただし、ハードコードされた月名が必要な場合は、COPYビルトインを使用しないようにします。COPYを使用すると、指定する言語によっては、月名が正しく設定されなくなる場合があります。（ライブラリで日付を指定するには、日付の変数を使用すると、COPYは正常に動作します。

言語に依存する例（お薦めできません）

:emp.hiredate := '30-DEC-96';

copy ('30-DEC-96','emp.hiredate');

上記の代わりに、次の例に示すTO_DATEを使用します。

言語に依存しない例（お薦めします）

:emp.hiredate := to_date('30-12-1996','DD-MM-YYYY');


NLS_LANGの例

  関連項目 	  すべての例

アプリケーションをフランス語で実行すると仮定します。アプリケーションはフランスで使用されますが、データはWE8ISO8895P1キャラクタ・セットを使用して表示されます。NLS_LANGを次のように設定する必要があります。

NLS_LANG=French_France.WE8ISO8895P1

ここで、アプリケーションはまだフランス語で実行するものの、今度はスイスで使用すると仮定します。NLS_LANGを次のように設定する必要があります。

NLS_LANG=French_Switzerland.WE8ISO8895P1

その他の例

NLS_LANG=Norwegian_Norway.NDK7DEC
NLS_LANG=Norwegian_Norway.WE8ISO8895P1
NLS_LANG=Japanese_Japan.JA16SJIS
NLS_LANG=Arabic_Egypt.AR8MSWIN1256
NLS_LANG=American_America.AR8MSWIN1256
NLS_LANG=American_America.WE8ISO8859P1


PL/SQLライブラリの例

  関連項目 	  すべての例

FUNCTION nls_appl_mesg(index_no NUMBER)

RETURN CHAR

IS

msg CHAR(80);

BEGIN

IF index_no = 1001 THEN

msg := 'L''impiegato che Voi cercate non esiste...';

ELSIF index_no = 1002 THEN

msg := 'Lo stipendio non puo essere minore di zero.';

ELSIF ...

   :

ELSE

msg := 'ERRORE:Indice messaggio inesistente.';

END IF;

RETURN msg;

END;

このようなルーチンは、一般的に文字式が有効な場所ではどこでも使用できます。たとえば、適切に翻訳されたアプリケーション・メッセージを使用して警告を表示するために、フォームに次のコードを組み込む場合があります。

Change_Alert_Message('My_Error_Alert', nls_appl_mesg(1001));

n := Show_Alert('My_Error_Alert');

アプリケーションを別の言語に変更するには、nls_appl_mesg関数を含むPL/SQLライブラリを、テキストの翻訳された、nls_appl_mesg関数を含む同名のライブラリに置き換えるのみです。

アプリケーションで複数の言語を同時にサポートする必要がある場合は、上記の関数で希望の言語を示す追加パラメータを受け入れることができ、コードにはさまざまな言語を処理するための追加レベルのIF...THEN...ELSIF...ELSE...ENDが組み込まれます。


Oracle8オブジェクトの例

  関連項目 	   すべての例

オブジェクト・タイプ

表タイプ

可変配列タイプ

列オブジェクト

オブジェクト表

オブジェクト・ビュー


Oracle8 Serverのサポート

  関連項目

Oracle8 Serverではさまざまな新機能を使用できます。一般に、機能は、次のようなカテゴリに分けられます。

•	拡張性の向上。たとえば、Oracle8データベースには数十TBのデータを格納できます。また、最大10000ユーザーの同時アクセスがサポートされています。表には、最大1000列を含めることができます。CHARデータ型とVARCHAR2データ型は、それぞれ最大2000バイトと4000バイトまで可能です。

•	パフォーマンスと効率の向上。これらのOracle8の機能を使用することによって必要となるユーザ操作はありません。Oracle8 Serverにデータを格納する速度と信頼性の利点が自動的に得られます。

•	ラージ・オブジェクト（LOB）

•	ユーザー定義オブジェクト

Oracle7の継続サポート

Oracle7 Serverの機能もサポートされています（リリース7.3.4以降）。


サポートされているOracle8データ型

  関連項目

このリリースでは、以下のOracle8データ型を引き続きサポートしています。

ラージ・オブジェクト（LOB）

Oracle8では、プログラマは、ラージ・オブジェクト（LOB）を定義できます。ラージ・オブジェクトには、テキスト、イメージ、サウンド、ビデオなどを格納できます。

このリリースでは、次のOracle8ラージ・オブジェクトのデータ型がサポートされています。

•	BLOB（バイナリ・ラージ・オブジェクト）

•	CLOB（シングルバイト・キャラクタ・ラージ・オブジェクト）

•	BFILE（バイナリ・ファイルまたは外部ファイル）

ユーザー定義のオブジェクト

Oracle8では、プログラマはオブジェクト・タイプ（ユーザー定義タイプとも呼ぶ）を定義できます。 オブジェクト・タイプは、Oracle8によってサポートされる既存の単一要素のデータ型に基づく複合要素です。これらのオブジェクト定義を使用して、プログラマは、さまざまな種類の表を作成できます。

現在サポートされているOracle8オブジェクトは、次のとおりです。

•	オブジェクト表。この場合、表全体が1つのオブジェクト・タイプに基づいています。

•	リレーショナル表内の列オブジェクト。この場合、列がオブジェクト・タイプに基づいています。

•	オブジェクト表またはリレーショナル表内のREF列。この場合、列の値が他のオブジェクト表内の行へのポインタとなっています。

新しいスカラー・データ型

このリリースでは、新しいOracle8 FLOATデータ型もサポートされています。このデータ型をそれ自身のNUMBERデータ型にマップします。


Oracle8ラージ・オブジェクト（LOB）について

バイナリ・ラージ・オブジェクト（BLOB）、キャラクタ・ラージ・オブジェクト（CLOBとNCLOB）およびバイナリ・ファイル（BFILE）などのOracle8ラージ・オブジェクト・データ型にアクセスできます。

Oracle8サーバーでは、これらのデータ型は、サイズが4GBまでのオブジェクトを格納できます。Oracle7のLONGデータ型およびLONG RAWデータ型の用途と似ていますが、さらにさまざまな利点が提供されます。

LOBとLONGの比較

LOB	LONG
4GBまで	2GBまで
1つの表につき複数のLOB列	1つの表につき1つのLONG列
レプリケーション可能	レプリケーションなし
ランダム・データ・アクセスが可能	シーケンシャル・アクセスのみ可能
優れた表領域管理（LOBロケータのみを格納）	LOBと比べて効率性に欠ける（表に直接データが格納される）
ユーザー定義のオブジェクト・タイプが使用可能	ユーザー定義のオブジェクト・タイプが使用不可能
プロシージャおよび外部コールに簡単に渡せる	プロシージャおよび外部コールに簡単に渡せない
LOBの詳細

BLOBは、ラージ・オブジェクトをバイナリ形式で格納するときに使用します。CLOBは、文字データを格納するときに使用します。これら2つのタイプは、データがサーバー内に格納されるため、内部LOBとも呼ばれます。データは、コミットとロールバックを含め、トランザクションおよび整合性制御で使用されます。

BFILEは対照的に、サーバーの外に格納されます。サーバーでは、ファイルのオペレーティング・システム・アドレスのみが格納されます。そのため、BFILEはデータベース・トランザクションでは使用できません。

互換性

LOBによってさまざまな利点が提供されるため（前述の表を参照）、任意の新しいアプリケーションでは、LONGではなくLOBを使用することをお薦めします。

ただし、下位互換性を保持するため、LONGも完全にサポートされています。

Forms型

Formでは、LOBは通常、その性質と使用法に基づいて、テキスト、イメージまたはサウンドのいずれかの制御タイプが指定されます。

制限

•	BFILEは読込み専用です。

•	FormsはBLOBの読取り時にBLOB全体をロードしようとしますが、実行時の使用可能仮想メモリ容量の制限を受けます。

•	CLOBの場合、Formsには65,534バイトの制限があります。


Oracle8のユーザー定義オブジェクトについて

  関連項目  [image]  例

Oracle8 Serverに対するサポートとして、このリリースではOracle8のユーザー定義オブジェクトにアクセスできます。ユーザー定義オブジェクトには、オブジェクト表、リレーショナル表の列オブジェクトおよびREF列と呼ばれる特殊な列オブジェクトが含まれます。

オブジェクト表

Oracle8では、オブジェクト表はユーザーのオブジェクト・タイプ定義に基づいています。この定義はそれ自体が複合要素であり、その属性またはコンポーネントがそれぞれ、一般的なOracle8ビルトイン・データ型に基づいています。（オブジェクト・タイプ定義は、他のオブジェクト・タイプ定義に基づかせることができますが、定義は最終的に一般的なOracle8ビルトイン・データ型に依存しています。）

このため、オブジェクト表内の各列は、リレーショナル表の列を扱う場合と同様に個々のデータ項目として扱われます。

リレーショナル表の列オブジェクト

データベース・プログラマは、リレーショナル表の列をオブジェクト・タイプ定義に基づかせることもできます。これには、複合オブジェクトをリレーショナル表に埋め込む効果があります。

埋め込まれた列オブジェクトは複合部分に拡張され、それぞれの部分自体は列として扱われます。

たとえば、Oracle8 Serverに3列のリレーショナル表があり、そのいずれかの列が列オブジェクトで、その列オブジェクトが、4つの部分または属性を持つオブジェクト定義に基づいている場合、その表が6列の表として扱われます（リレーショナル表の列が2つとオブジェクトを構成する列が4つ）。

列オブジェクト定義の個々の属性のいずれかが別のオブジェクト・タイプに基づいている場合は、その部分がさらに拡張され、一連の個別の列として扱われます。

REF列

オブジェクト表またはリレーショナル表のいずれかの列をREF型を持つように定義することができます。REF列はデータを直接保持するのではなく、実際のデータを保持する別のオブジェクト表へのポインタ（参照）を持ちます。

参照は実行時に解決されるため、ユーザーは参照される実際のデータを見ることができます。


Oracle8のユーザー定義オブジェクト: 例

  関連項目

Oracle8 Server内でオブジェクトを作成するには、データベース・プログラマはまずオブジェクト・タイプを定義し、次にそのタイプ定義に基づいて特定のオブジェクトを作成します。作成されるオブジェクトは、オブジェクト表またはリレーショナル表内の列オブジェクトになります。

例

次の定義について考えてみます。最初の定義ではオブジェクト・タイプが作成されます。2番目の定義ではそのタイプの表が作成されます。

CREATE TYPE  emp_type  AS OBJECT

(name     CHAR(30),

title    CHAR(20),

idnum    NUMBER);

CREATE TABLE  emp  OF emp_type;

前述の例では、empという名前のオブジェクト表を作成します。この表には3つの列があり、これらの列は、emp_typeオブジェクト・タイプ定義で確立された名前とデータ型を持ちます。

次は、リレーショナル表内の列オブジェクトの例です。

CREATE TYPE  address_type  AS OBJECT

(street    VARCHAR2(40),

city      VARCHAR2(25),

state     VARCHAR2(2)

zip       NUMBER);

CREATE TABLE  customers

(cust_id  NUMBER,

name     VARCHAR(40),

address  address_type);

この例では、customersという名前のリレーショナル表を作成します。表には3つの列があります。最初の2つの列（cust_idとname）は、通常の関係列です。3つ目の列（address）は、列オブジェクトです。これは、address_typeという名前のオブジェクト・タイプ定義に基づいて作成されます。このaddress列は、オブジェクト定義によって確立された構造とデータ型を持ちます。address列は、4つの部分またはコンポーネント（street、city、stateおよびzip）を持っていると考えることができます。これらの各コンポーネントは、address_typeオブジェクト・タイプ定義で確立されたデータ型を持ちます。（この場合、NUMBER型のzipを除くすべてのコンポーネントはVARCHAR2型です）。

次の例では、3つの列で構成されるリレーショナル表の3番目の列は、それ自体が3つの部分またはコンポーネントを持つオブジェクト・タイプに基づいています。

Oracle8オブジェクトは、部分またはコンポーネントによって作成される複合であることに注意してください。それぞれの部分は、名前および一般的なOracle8データ型を持ちます。オブジェクトが表の場合（実際はオブジェクト表の行）、オブジェクト・タイプ定義内の属性と同じ数の列または部分を持ちます。リレーショナル表の列がオブジェクトに基づいている場合、各オブジェクトの部分は、その表の追加列であると考えることができます。それぞれの部分がオブジェクト・タイプ定義内の属性に基づいているため、これらの部分は属性列と呼ばれることもあります。

Developerにおけるオブジェクトの扱い

オブジェクト表は、リレーショナル表と非常に似た方法で扱われます。それぞれの列は個別に選択できます。すべての列を選択できますが、それぞれの列はアプリケーション内で別々の項目として扱われます。表自体は、環境内のオブジェクトなどの特定の個別性は持ちません。

同様にリレーショナル表の列オブジェクトは、単一の、同類性を持つエンティティとして扱われません。その代わりに、列オブジェクトの各コンポーネントを、個別の、独立したデータ項目として扱います。列オブジェクトの各コンポーネントは選択できます。選択されると、それぞれが独立したデータ項目として扱われます。列オブジェクトのすべてのコンポーネントを選択した場合でも、列オブジェクト自体は、開発環境内のオブジェクトとしての特定の個別性は持ちません。

オブジェクトから選択されたデータ項目には、ColumnObjectName_ItemNameというデフォルト名が付けられます。したがって、前述の例で、addressという名前の列オブジェクトからzipという名前のコンポーネントを選択すると、そのデータ項目はアプリケーション内でaddress_zipという名前が付けられます。


Oracle8のREFについて

  関連項目

REFは、Oracle8の新しいデータ型です。REFによって、他のオブジェクト表にあるデータへのポインタとしての列オブジェクトが確立されます。REF列自体はデータを保有しません。

次に例を示します。

CREATE TYPE  dept_type  AS OBJECT

(deptname     VARCHAR2(24),

deptnumber   NUMBER);

CREATE TABLE  dept_table OF dept_type;

CREATE TABLE  emp

(empname    VARCHAR2(50),

empnumber  NUMBER,

empdept    REF  dept_type);

empという名前のリレーショナル表では、列empdeptはREF列です。これは、タイプdept_typeのオブジェクトを参照します。

タイプと表

REF列を定義すると、特定のオブジェクト表ではなく、オブジェクト・タイプが識別されます。データベースには、単一のオブジェクト・タイプ定義に基づくオブジェクト表が複数含まれる場合があります。このため、REF列の定義自体によって、ターゲット表は識別されません。

ポインタ変換

REF列を含む表を初期化すると、REF列に配置されている値は、希望のデータを持つ特定の表に含まれる行へのポインタになります。実行時には、REF列に参照先のデータ（ポインタではない）が表示されます。

Developerにおける設計時のREFの表示方法

設計時にREF列を含む表の表示を求めると、REF列が拡張された形態で表示されます。つまり、元のREF定義によって参照されるオブジェクト・タイプ内の属性が表示されます。

この例の場合、empdeptが2つのコンポーネントまたは属性列、deptnameとdeptnumberを保有するREF列として表示されます。これらは、REF定義内で識別されたオブジェクト・タイプ（dept_type）内の2つの属性でした。

通常の列オブジェクトと同じように、参照先となるコンポーネントまたは属性の一部またはすべてを選択して、アプリケーション内のデータ項目にすることができます。ただし、通常の列オブジェクトとは対照的に、REF名自体を選択して、アプリケーション内で操作可能な項目にすることもできます。つまり、PL/SQLコード作成でREFを使用することができます。デフォルトで、REFはNULLキャンバスの一部になります。

ユーザーに対するREFの表示方法

アプリケーション設計者は、実行時ユーザーに対する参照先データ（変換されたREF）の表示方法を選択できます。

•	REFがあるデータ・ブロック内のデータを表示（参照方式と呼ばれることもある）

•	REFによって参照されるデータ・ブロック内のデータを表示（マスター/ディテール方式）

最初の方法（REFがあるデータ・ブロックの一部としてデータを表示）は最も単純です。データ・ブロック内に含める項目として目的のREFコンポーネントを選択し、実行時にDeveloperおよびOracle8によって参照が変換され、参照先の実際のデータが表示項目内に配置されます。ユーザーは1つのブロックを見るだけで済みます。

もう1つの方法（参照先データ・ブロックのデータを表示）では、マスター/ディテール・リンクを設定する必要があります。これは、主キー/外部キー・リレーションを持つ2つのブロックについてマスター/ディテール・リンクを設定することと似ています。この場合は、REFによって2つのブロック間にリンクが作成されます。ユーザーには両方のブロックが表示されますが、REFデータは参照先ブロック内にしか表示されません。

Form Builderのデータ・ブロック・ウィザードを使用して、このマスター/ディテール・リレーションを設定できます。


Oracle8オブジェクトのアイコン

オブジェクト・ナビゲータとウィザードでは、アクセスしているOracle8データの型がアイコンによって表示されます。アイコンとその意味は次のとおりです。

             通常の表

             オブジェクト・タイプ

             オブジェクト・ビュー

             オブジェクト表

             ネストしたオブジェクト

             ネストした表

             参照オブジェクト

             可変配列

             メソッド

             不明の型

             サーバー側のスタック・モード

             サーバー側のプログラム単位

             ファイル

             DATEデータ型

             NUMBERデータ型

             CHARACTERデータ型

             RAWデータ型

            BLOBデータ型

             BFILEデータ型

             CLOBデータ型

             rowid

             MLSラベル


Oracle8の拡張性とパフォーマンス

Oracle8 Serverによって、さまざまな点で拡張性およびパフォーマンスの向上が実現します。これらの利点の多くは、自動的に提供されます。

たとえば、Oracle8の次の特性を利用できます。

•	より大きなサイズへの対応。データベース自体のサイズ、同時ユーザーの数および表列の制限数（現行では1000列まで）がすべて増加しました。

•	表と索引のパーティション化

•	クライアント側のオブジェクト・キャッシング

また、パフォーマンスを向上させるOracle8のその他のさまざまな機能を直接利用できます。

•	プリフェッチ。Formsでは、Oracle8のこの機能を使用して（既存の配列サイズ機能と併用）、データベースのラウンドトリップ回数およびメモリ使用量を削減します。プリフェッチ機能は、ユーザーが操作しなくても自動的に実行されます。

•	戻り値句。Formsでは、挿入および更新を行うときに、この新しいDML機能を使用します。戻り値句によって2回目のデータベース問合せ（データに対するサーバー側トリガーの変更を取得する）が不要になるため、処理時間が短縮されます。ユーザーは「DMLの戻り値」プロパティを使用して、この機能を制御できます。

•	ビュー更新用のINSTEAD-OFトリガー。このサーバー側トリガーによって、リレーション・ビューとオブジェクト・ビューを更新する機能が提供されます。 これらのビューは、これ以外の方法では更新できません。


PL/SQL 8のサポート

  関連項目

このリリースでは、クライアントとサーバーでPL/SQL 8を使用します。クライアント側のプログラム単位は、現在Oracle8のオブジェクト関連機能をサポートしていません。ただし、ストアド・プログラム単位は、新しいPL/SQL 8機能をすべて使用できます。

『PL/SQLユーザーズ・ガイドおよびリファレンス、リリース8』マニュアルの付録Aでは、PL/SQL 8の新機能について説明しています。このマニュアルはオンラインで利用できます。「ヘルプ」 -> 「マニュアル」を選択して、オンライン・マニュアルの下のリファレンス・マニュアルに移動します。


PL/SQLの以前のリリースとの互換性

PL/SQL 1またはPL/SQL 2を使用して書かれたクライアント側のプログラム単位は、コードを新しいレベルに変換する必要があります。アップグレードを自動化できるように、PL/SQL 1変換ユーティリティが提供されています。

以前のリリースを使用して作成されたストアド・プログラム単位は、データベース・サーバー上のPL/SQL 8エンジンに対して実行できますが、コンパイル・エラーが発生する場合があります。これらのエラーは、PL/SQL 8とPL/SQL 2との間で構文の互換性がない場合に発生します。 PL/SQL 8の互換性フラグを使用することによってPL/SQL 2との互換性モードを選択できるため、PL/SQL 8エンジンでは、サーバーでPL/SQL 2コードをコンパイルするときに、このようなエラーは発生しません。『Oracle8 Server移行ガイド』の第6章では、この互換性フラグによってサポートされる状況について説明しています。


サポートされていないOracle8機能

  関連項目

このリリース全体では、一部のOracle8機能がサポートされていません。サポートされていない主な機能は次のとおりです。

•	コレクション・タイプ（ネストした表と可変配列）

•	オブジェクト値を返すストアド・プロシージャ

•	スカラー・データ型のNCHARとNVARCHAR2

このリリースではPL/SQL 8をサポートしていますが、クライアント側のPL/SQL 8は一部のOracle8 Serverの機能をまだサポートしていないことに注意してください。（サーバー側のPL/SQL 8ではOracle8 Serverのすべての機能をサポートしています。）


オブジェクト・ナビゲータのOracle8オブジェクト・サポート

オブジェクト・ナビゲータのOracle8機能を利用すると、オブジェクトのデータ型にアクセスし、Oracle8データに対するプログラムをより簡単に行うことができます。追加されたOracle8オブジェクト・サポートを使用すると、ユーザー定義データ型を階層形式で表示したり、ユーザー定義データ型に関連付けられた表、ビュー、列、トリガー、属性、メソッドの検索や表示を行うことができます。

「データベース・オブジェクト」ノードには、現在接続中のデータベース内でアクセス可能なスキーマとそのオブジェクトが含まれます。Oracle8データベースに接続している場合は、使用可能なユーザー定義データ型が（その属性およびメソッドと一緒に）各スキーマ内の「タイプ」ノードに表示されます。ユーザー定義データ型に関連付けられた表、ビュー、列およびトリガーは、「表」ノードと「ビュー」ノードに表示されます。

特に、オブジェクト・ナビゲータのOracle8機能を使用すると、次の項目を表示および検索できます。

•	「表」ノードのオブジェクト表と列オブジェクト

•	「ビュー」ノードのオブジェクト・ビュー

•	「ビュー」ノードのビュー用のInstead Ofトリガー

•	「タイプ」ノードのオブジェクト・タイプ、表タイプおよび可変配列タイプ

•	「タイプ」ノードのオブジェクト・タイプの属性とメソッド

オブジェクト・ナビゲータでは、リレーション・オブジェクトとOracle8オブジェクトを区別するために、アイコンが使用されます。たとえば、通常のリレーショナル表とオブジェクト表、および通常のビューとオブジェクト・ビューは、別々のアイコンで表されます。

Oracle8ユーザー定義データ型の詳細は、Oracle8のマニュアルを参照してください。

関連項目

オブジェクト・タイプ・ノード

表タイプ・ノード

可変配列タイプ・ノード

列オブジェクト・ノード

オブジェクト表ノード

オブジェクト・ビュー・ノード

すべて拡張

Oracle8オブジェクトのアイコン


オブジェクト・タイプ・ノード

  例	  関連項目

オブジェクト・タイプは、オブジェクト・ナビゲータの「タイプ」ノード内に表示されます。オブジェクト・タイプ・ノードは、SQL文のCREATE TYPE AS OBJECTで作成されたタイプを表します。オブジェクト・タイプはオブジェクト・ナビゲータに次のように表示されます。

object-type-name ( Object Type [ * ] & Body [ * ] )

CREATE TYPE AS OBJECT文がデータベースに発行されると、「オブジェクト・タイプ」ラベルが表示されます。タイプ仕様が無効か、またはタイプが不完全な場合は、アスタリスク（ * ）が表示されます。不完全なタイプは、タイプを再帰的に定義するためのプレースホルダになります。

CREATE TYPE BODY文を使用してタイプ本体が作成されると、「オブジェクト本体」ラベルが表示されます。タイプ本体が無効な場合は、アスタリスク（ * ）が表示されます。

オブジェクト･タイプとオブジェクト本体の両方が正常に作成されると、ラベルは「オブジェクト・タイプおよび本体」と表示されます。

オブジェクト・タイプ・ノードは複合ノードで、「属性」と「メソッド」の2つのサブノードを持ちます。オブジェクト・タイプ・ノードを拡張できるのは、有効なタイプ仕様が存在する場合のみです。

オブジェクト・タイプの属性は、「属性」サブノードの下のノードとして表されます。

オブジェクト・タイプのメソッドは、「メソッド」サブノードの下のノードとして表されます。メソッドは、プロシージャとファンクションとして表示されます。メソッドのラベルはオブジェクト・ナビゲータに次のように表示されます。

method-name (Procedure)

および

method-name (Function)

オブジェクト・タイプにマップ・メソッドまたはオーダー・メソッドが指定されている場合、メソッドのラベルは次のように表示されます。

method-name (Map Function)

または

method-name (Order Function)

注意: メソッドの引数リストは表示されません。


オブジェクト・タイプ・ノードの例

  関連項目 	   すべての例

次のSQL文は、オブジェクト・タイプemp_typを作成します。

CREATE TYPE emp_typ AS OBJECT
  (ename VARCHAR2(30), esalary NUMBER(5,2),
  MEMBER PROCEDURE raise(amount NUMBER),
  MEMBER FUNCTION get_salary RETURN NUMBER,
  MAP MEMBER FUNCTION compare RETURN NUMBER);

emp_typのサブツリーは次のとおりです。


表タイプ・ノード

  例	  関連項目

表タイプは、オブジェクト・ナビゲータの「タイプ」ノード内に表示されます。表タイプ・ノードは、SQL文のCREATE TYPE AS TABLEで作成されたタイプを表します。表タイプはオブジェクト・ナビゲータに次のように表示されます。

table-type-name (TABLE OF table-subtype-name)

サブタイプがビルトイン・タイプの場合、表タイプ・ノードは拡張できません。サブタイプがオブジェクト・タイプまたは参照オブジェクトの場合は、オブジェクトの属性がサブノードとして表示されます。


表タイプ・ノードの例

  関連項目 	   すべての例

次のSQL文は、オブジェクト・タイプemp_typおよび表タイプemp_tblを作成します。

CREATE TYPE emp_typ AS OBJECT
  (ename VARCHAR2(30), esalary NUMBER(5,2),
  MEMBER PROCEDURE raise(amount NUMBER),
  MEMBER FUNCTION get_salary RETURN NUMBER,
  MAP MEMBER FUNCTION compare RETURN NUMBER);

CREATE TYPE emp_tbl AS TABLE OF emp_typ;

emp_tblのサブツリーは次のとおりです。


可変配列タイプ・ノード

  例	  関連項目

可変配列タイプは、オブジェクト・ナビゲータの「タイプ」ノード内に表示されます。可変配列タイプ・ノードは、SQL文のCREATE TYPE AS VARYING ARRAYで作成されたタイプを表します。可変配列タイプはオブジェクト・ナビゲータに次のように表示されます。

varying-array-type-name (VARRAY (size) varying-array-subtype-name)

サブタイプがビルトイン・タイプの場合、可変配列タイプ・ノードは拡張できません。サブタイプがオブジェクト・タイプまたは参照オブジェクトの場合は、オブジェクトの属性がサブノードとして表示されます。


可変配列タイプ・ノードの例

  関連項目 	   すべての例

次のSQL文は、オブジェクト・タイプemp_typおよび可変配列タイプemp_aryを作成します。

CREATE TYPE emp_typ AS OBJECT
  (ename VARCHAR2(30), esalary NUMBER(5,2),
  MEMBER PROCEDURE raise(amount NUMBER),
  MEMBER FUNCTION get_salary RETURN NUMBER,
  MAP MEMBER FUNCTION compare RETURN NUMBER);

CREATE TYPE emp_ary AS VARRAY(7) OF emp_typ;

emp_aryのサブツリーは次のとおりです。


列オブジェクト・ノード

  例	  関連項目

列オブジェクトは、「列」ノード内のノードとして表示されます。各オブジェクトには、名前およびカッコで囲まれたタイプのラベルが付きます。列オブジェクト・ノードは複合ノードで、タイプの属性がサブノードとして表示されます。

列オブジェクトのサブタイプには、ネスト・オブジェクト・タイプ、表タイプ、可変配列タイプおよび参照オブジェクト・タイプの4種類があります。オブジェクト・ナビゲータでは、列オブジェクトに次のようなラベルが付きます。

column-name (nested-object-type)

column-name (table-type-name:TABLE OF table-subtype-name)

column-name (varying-array-type-name:VARRAY(size) OF varying-array-subtype-name)

column-name (REF reference-type-name)


列オブジェクト・ノードの例

  関連項目 	   すべての例

次の例では、表emp_tabのemp_col列が、タイプemp_typのネスト・オブジェクトになります。

CREATE TYPE emp_typ AS OBJECT (ename VARCHAR2(30), esalary NUMBER(5,2));
CREATE TABLE emp_tab (emp_col emp_typ, dept VARCHAR2(2));

emp_tabのサブツリーは次のとおりです。

次の例では、表dept_tabのemps列が、サブタイプemp_tblのネスト表になります。ネスト表には、タイプemp_typの行が含まれます。

CREATE TYPE emp_typ AS OBJECT (ename VARCHAR2(30), esalary NUMBER(5,2));
CREATE TYPE emp_tbl AS TABLE OF emp_typ;
CREATE TABLE dept_tab (dname VARCHAR2(20), emps emp_tbl)
  NESTED TABLE emps STORE AS emps_tab;

dept_tabのサブツリーは次のとおりです。

次の例では、表dept_tab_aryのemps列が、サブタイプemp_aryの可変配列になります。可変配列には、タイプemp_typの行が含まれます。

CREATE TYPE emp_typ AS OBJECT (ename VARCHAR2(30), esalary NUMBER(5,2));
CREATE TYPE emp_ary AS VARRAY(7) OF emp_typ;
CREATE TABLE dept_tab_ary (dname VARCHAR2(20), emps emp_ary);

dept_tab_aryのサブツリーは次のとおりです。

次の例では、表dept_refのmanager列が、タイプemp_typの参照オブジェクトになります。

CREATE TYPE emp_typ AS OBJECT (ename VARCHAR2(30), esalary NUMBER(5,2));
CREATE TABLE dept_ref (dname VARCHAR2(20), manager REF emp_typ);

dept_refのサブツリーは次のとおりです。


オブジェクト表ノード

  例	  関連項目

オブジェクト表は、オブジェクト・ナビゲータの「表」ノード内に表示されます。オブジェクト表ノードは、SQL文のCREATE TABLE OFで作成された表を表します。オブジェクト・ナビゲータでは、オブジェクト表ノードに次のようなラベルが付きます。

object-table-name (object-type-name)

各オブジェクト表ノードには、「トリガー」と「列」の2つのサブノードがあります。「トリガー」サブノードには、オブジェクト表に関連付けられたすべてのトリガーが含まれます。これらのトリガーは、通常のリレーショナル表に関連付けられたトリガーと同じように表示されます。「列」ノードには、オブジェクト表に関連付けられたすべての関係列と列オブジェクトが含まれます。各列には、名前およびカッコで囲まれたタイプのラベルが付きます。


オブジェクト表ノードの例

  関連項目 	   すべての例

次のSQL文は、オブジェクト・タイプperson_typおよびオブジェクト表person_tabを作成します。

CREATE TYPE person_typ AS OBJECT
  (name VARCHAR2(30), address VARCHAR2(60));

CREATE TABLE person_tab OF person_typ;

person_tabのサブツリーは次のとおりです。


オブジェクト・ビュー・ノード

  例	  関連項目

オブジェクト・ビューは、オブジェクト・ナビゲータの「ビュー」ノード内に表示されます。オブジェクト・ビュー・ノードは、OF object_type句を使用して作成されたビューを表します。オブジェクト・ビュー・ノードには、名前およびカッコで囲まれたタイプのラベルが付きます。オブジェクトの属性は表示されません。

各オブジェクト・ビュー・ノードには、「トリガー」と「列」の2つのサブノードがあります。「トリガー」サブノードには、Instead Ofトリガーを含む、オブジェクト・ビューに関連付けられたすべてのトリガーが含まれます。Instead Ofトリガーがビューに関連付けられている場合、ラベルは次のように表示されます。

trigger-name (INSTEAD OF trigger-statements)


オブジェクト・ビュー・ノードの例

  関連項目 	   すべての例

次のSQL文は、オブジェクト・ビューを作成します。

CREATE TYPE emps_typ AS OBJECT (ename VARCHAR2(30), esalary number(5,2), deptno NUMBER(2));
CREATE TABLE emps (ename VARCHAR2(30), esalary number(5,2), deptno NUMBER(2));
CREATE VIEW dev_emps OF emps_typ
  WITH OBJECT OID (ename)
  AS SELECT ename, esalary, deptno FROM emps WHERE deptno = 10;

オブジェクト・ビューdev_empsのサブツリーは次のとおりです。


すべてのOracle8オブジェクト・ノードの拡張

  関連項目

オブジェクト・ナビゲータで「すべて拡張」を実行しても、Oracle8データ型と属性の各ノードは再帰的に拡張されません。

たとえば、タイプemp_typのmanagerという属性が、別のタイプemp_typの派生項目として表示されている場合、「すべて拡張」を実行してもmanager属性は拡張されません。


環境変数

  関連項目

CA_GPREFS

CA_UPREFS

CUE_PREFS

DEV2000_PROJECT

DEV2000_SOURCECONTROL

DOC60

FORMS60_DEFAULTFONT

FORMS60_EDITOR

FORMSnn_ERROR_DATE/DATETIME_FORMAT

FORMS60_JAVADIR

FORMS60_MAPPING

FORMS60_OUTPUT

FORMSnn_OUTPUT_DATE/DATETIME_FORMAT

FORMS60_PATH

FORMS60_REPFORMAT

FORMSnn_PLSQLV1_NAME_RESOLUTION

FORMS60_TIMEOUT

FORMSnn_USER_DATE/DATETIME_FORMAT

FORMS60_USEREXITS

GRAPHICS60_PATH

INTERRUPT（DOS SQL*Netユーザーのみ）

LOCAL

NLS_LANG

OleCreateObjPoolInMemory

OleDoNotUpdateLinks

OleUpdateLinksPrompt

ORACLE_HOME

ORACLE_PATH

ORAINFONAV_DOCPATH

REPORTS60_CGIDIAGBODYTAGS

REPORTS60_CGIDIAGHEADTAGS

REPORTS60_CGIHLP

REPORTS60_CGIMAP

REPORTS60_CGINODIAG

REPORTS60_CGIPATHONLYURL

REPORTS60_COOKIE_EXPIRE

REPORTS60_DB_AUTH

REPORTS60_ENCRYPTION_KEY

REPORTS60_OWSDIAGBODYTAGS

REPORTS60_OWSDIAGHEADTAGS

REPORTS60_OWSHELP

REPORTS60_OWSMAP

REPORTS60_OWSNODIAG

REPORTS60_OWSPATHONLYURL

REPORTS60_PATH

REPORTS60_REPORTS_SERVER

REPORTS60_SYS_AUTH

REPORTS60_TERMINAL

REPORTS60_TMP

REPORTS60_USEREXIT

REMOTE

UI_ICON

USERNAME

WIN_REMOTE_SESSIONS

XMITTR（DOSユーザーのみ）


レジストリ（Windows95およびWindows NT）

  環境変数

Oracleインストーラは、レジストリ内に新しいORACLEセクションを作成します。Oracleレジストリには、Oracleホーム・ディレクトリの名前、製品の作業環境ファイルのディレクトリ、ヘルプ・ファイルのディレクトリなどを制御する構成パラメータが入っています。

レジストリの表示と変更

Microsoft Windowsレジストリは、レジストリ・エディタを使用して表示およびオプションの編集ができます。このエディタは、Windowsソフトウェアがインストールされているディレクトリに入っています。エディタを起動するには、「スタート」 [image] 「ファイル名を指定して実行」を選択し、続いてREGEDITと入力し、「OK」をクリックします。

レジストリ・エディタ内で、HKEY_LOCAL_MACHINEノードを拡張し、続いてSOFTWAREノードを拡張します。[ORACLE]キーをクリックし、Oracle構成パラメータを表示させます。

パラメータ名をダブルクリックし「文字列の編集」ダイアログを表示させると、どのパラメータ値でも変更できます。「値」データ・テキスト・ボックス内の値を変更し、「OK」をクリックして新しい値を認めます。


構成パラメータ

  環境変数

Oracleインストーラは、多くのパラメータを自動的に設定します。これらのパラメータはOracle製品が必要とするものもあれば、開発者が製品動作のカスタマイズに使用するものもあります。

必要なパラメータ

この項に挙げているパラメータは、Oracleインストーラにより自動的に設定または削除されます。これらのパラメータは、さまざまなOracle製品が正しく動作するために必要なものです。

注意: この項に挙げられているパラメータの設定は変更しないでください。設定を変更すると、1つ以上のOracle製品が正しく動作しなくなります。

次に挙げているパラメータ内のnnは、製品またはコンポーネントのリリース番号を示します。この番号は、Oracle製品の新しいリリースにアップグレードする際に変わる場合があります。

パラメータ	デフォルト値
BROWSERnn	ORACLE_HOME\BROWSE25
DEnn	ORACLE_HOME\TOOLS\COMMON60
FORMSnn	ORACLE_HOME\FORMS60
GRAPHICSnn	ORACLE_HOME\GRAPH60
MMnn	ORACLE_HOME\TOOLS\COMMON60
OCLnn	ORACLE_HOME\GRAPH60
PROnn	ORACLE_HOME\PRO18
RDBMSnn	ORACLE_HOME\RDBMS73
RWnn	ORACLE_HOME\REPORT60
TKnn	ORACLE_HOME\TOOLS\COMMON60
VGSnn	ORACLE_HOME\TOOLS\COMMON60
カスタマイズできるパラメータ

この項に挙げているパラメータは、Oracle製品のさまざまな面を制御します。これらのパラメータの設定を変更し、製品動作をカスタマイズできます。

この後の項では、Oracleインストーラにより自動的に設定される、各パラメータのデフォルト設定（存在する場合）を挙げています。自動的に設定されないパラメータについても述べられています。設定の有効な値および例の説明も合わせて挙げられています。


CA_GPREFS

デフォルト: ORACLE_HOME

有効な値: 任意のドライブの任意のディレクトリ

例:

CA_GPREFS=C:\orawin95

このパラメータは、グローバル作業環境ファイルCAGPREFS.ORAのディレクトリを指定します。グローバル作業環境は、ネットワーク化されたユーザー間で共有されます。この製品は、CAGPREFS.ORAファイルを探すのに、CA_GPREFSパラメータで指定されるディレクトリの他、現行ディレクトリも検索します。

CAGPREFS.ORAファイルは、Oracleインストーラにより自動的に作成されます。グローバル作業環境を変更するには、「メモ帳」などのテキスト・エディタを使用し、このファイルを直接編集してください。CAGPREFS.ORA内のグローバル作業環境は、ローカル作業環境ファイルCAUPREFS.ORA（パラメータCA_UPREFSにより定義される）で上書きできます。


CA_UPREFS

デフォルト: ORACLE_HOME

有効な値: 任意のドライブの任意のディレクトリ

例:

CA_UPREFS=C:\orawin95

このパラメータは、ユーザー作業環境ファイルCAUPREFS.ORAのディレクトリを指定します。CAUPREFS.ORAファイルは、開発者が「ツール」 [image] 「ツール・オプション」から設定する作業環境をメンテナンスします。製品は、CAUPREFS.ORAファイルを探すために、CA_UPREFSパラメータで指定されているディレクトリの他、現行ディレクトリも検索します。

Oracle製品の中には、作業環境情報をCAUPREFS.ORAファイルに書き込むものもあります。ユーザー作業環境を手動で変更するには、「メモ帳」などのテキスト・エディタを使用しこのファイルを編集します。CAUPREFS.ORAに設定されているユーザー作業環境は、CAGPREFS.ORAファイル（パラメータCA_GPREFSで定義する）内のグローバル作業環境を上書きします。


CUE_PREFS

デフォルト: ORACLE_HOME

有効な値: 任意のドライブの任意のディレクトリ

例:

CUE_PREFS=C:\orawin95

このパラメータは、キュー・カードの作業環境ファイルCUEPREF.RESのディレクトリを指定します。CUEPREF.RESファイルは、「キュー・カード・オプション」ダイアログで設定可能なキューカードの作業環境をメンテナンスします。

作業環境は、アプリケーションを終了するたびにCUEPREF.RESファイルに保存されます。このファイルは、手動では変更できません。


DEV2000_SOURCECONTROL

デフォルト: なし

有効な値: Forms DeveloperまたはReports Developerにどのソース制御システムを使用すべきかを指定するキーワード

例:

DEV2000_SOURCECONTROL=PVCS

このパラメータは、Forms DeveloperまたはReports Developerにどのソース制御システムを使用するかを指定します。現在のところ、ソース制御システムを指定しない、またはこのパラメータを値'PVCS'に設定する、のどちらかを指定できます。ソース制御システムのサポートが追加されると、追加されたソース制御システムのキーワードも指定できるようになります。


DEV2000_PROJECT

デフォルト: なし

有効な値: Forms DeveloperまたはReports Developerで使用するソース制御システムのプロジェクト・ファイルを指定するキーワード

例:

DEV2000_PROJECT=c:\pvcs\project1\project1.cfg

このパラメータは、開発者がDEV2000_SOURCECONTROLパラメータ上で選択したソース制御システムのプロジェクト・ファイルの名前を指定します。


DOC60

デフォルト: Oracle_Home\tools\doc60

有効な値: 任意のドライブの任意のディレクトリ

例:

DOC60=c:\orawin95\tools\doc60

このパラメータは、オンライン・ヘルプ、キュー・カード、クイック・ツアーなど、オンライン・ドキュメント・ファイルのディレクトリを指定します。


FORMS60_DEFAULTFONT

デフォルト: なし

有効な値: 任意の有効フォントを指定するテキスト文字列

例:

FORMS60_DEFAULTFONT="MS Sans Serif.8"

このパラメータは、Form Builderのレイアウト・エディタ内のボイラープレートに使用するデフォルト・フォントを指定します。


FORMS60_EDITOR

デフォルト: なし

有効な値: システム・エディタの名前とパス

例:

FORMS60_EDITOR=C:\windows\notepad.exe

このパラメータは、デザイナまたはランフォーム・コンポーネント内でForm Builderの複数行の項目が起動できるエディタを定義します。このパラメータが定義されない限り、ユーザー定義のエディタは起動できません。

注意: エディタを終了する際、ファイルは「ASCIIのみ」のファイルとして保存する必要があります。固有のワープロ形式はサポートされていません。


FORMSnn_ERROR_DATE/DATETIME_FORMAT

目的： 次の環境変数は、エンドユーザーが日付または日時項目に無効な値を入力したときに表示されるランタイム・エラー･メッセージを生成するために、Formsが使用する書式マスクを設定します。

デフォルト: ヘルプ・トピック「日付の書式マスク」を参照してください。

有効な値: 任意の有効な日付/日時書式マスク。

例:

FORMS65_ERROR_DATE_FORMAT YYYY/MM/DD


FORMS60_JAVADIR

デフォルト: Oracle_Home\forms60\java

有効な値: Oracle Java実行時環境の名前およびパス

例:

FORMS60_JAVADIR=C:\orant\forms60\java

このパラメータは、Java Beanエリアを使用し、WebベースのフォームをForm Builderからプレビューするのに必要なOracle Java実行時環境ファイルのロケーションを定義します。


FORMS60_MAPPING

デフォルト: なし

有効な値: 一時作業ディレクトリの仮想位置

例:

FORMS60_MAPPING=http://myhost.com/webtemp

Web上でイメージを処理するために、Forms Serverは一時的な圧縮JPEGファイルを送信します。Web Formsアプリケーションでイメージまたはアイコンを使用する場合は、Forms Serverがイメージやその他の作業ファイルに使用する一時ディレクトリと仮想ディレクトリ（例 C:\ORANT\WEBTEMP）を作成する必要があります。また、Forms Serverが動作しているコンピュータ上にFORMS60_OUTPUT環境変数およびFORMS60_MAPPING環境変数を作成する必要もあります。


FORMS60_OUTPUT

デフォルト: なし

有効な値: Formsサーバーが動作しているコンピュータ上の任意のドライブの任意のディレクトリ

例:

FORMS60_OUTPUT=C:\ORANT\WEBTEMP\

Web上でイメージを処理するために、Forms Serverは一時的な圧縮JPEGファイルを送信します。Web Formsアプリケーションでイメージまたはアイコンを使用する場合は、Forms Serverがイメージやその他の作業ファイルに使用する一時ディレクトリ（例 C:\ORANT\WEBTEMP）を作成する必要があります。また、Forms Serverが動作しているコンピュータ上にFORMS60_OUTPUT環境変数およびFORMS60_MAPPING環境変数を作成する必要もあります。


FORMSnn_OUTPUT_DATE/DATETIME_FORMAT

目的： 次の2つの環境変数は、独自のマスクを持たない任意の日付および日時項目で実行時出力操作を行うためにFormsが使用する書式マスクを設定します。

デフォルト: ヘルプ・トピック「日付の書式マスク」を参照してください。

有効な値: 任意の有効な日付/日時書式マスク。

例:

FORMS65_OUTPUT_DATETIME_FORMAT YYYY/MM/DD HH24:MI:SS


FORMS60_PATH

デフォルト: ORACLE_HOME\FORMS60\PLSQLLIB

有効な値: 任意のドライブの任意のディレクトリ

例:

FORMS60_PATH=C:\oracle\apps\forms;C:\myfiles

このパラメータは、Form Builderのランタイム・アプリケーション内で使用するファイルの検索パスを指定します。これには、フォーム・ファイル（.fmx）、メニュー・ファイル（.mmx）、PL/SQLライブラリ（.pll）、アプリケーションが実行時にロードを試みるその他のオブジェクトが含まれます。たとえば、イメージ・ファイルscooter.tifをインポートすると、Form BuilderはそのファイルをFORMS60_PATHで指定されているディレクトリ内で検索します。

FORMS60_PATHは、複数のディレクトリを指定できます。セミコロン（;）を使用して、パス・リスト内のディレクトリ名を区切ってください。


FORMSnn_PLSQLV1_NAME_RESOLUTION

デフォルト:  オフ

有効な値:  オン、オフ

例:

FORMS6i_PLSQLV1_NAME_RESOLUTION=ON

この環境変数を使用すると、ランタイム・プログラム・ユニット名の解決の動作をR4.5とR5以降のバージョン間で選択できます。オンを指定すると、R4.5の動作が選択されます。オフを指定すると（またはこの環境変数を指定しないと）、R5以降の動作が選択されます。

R4.5の動作:

Formsがプログラム・ユニットのコールに出会うと、まず現行Formsまたはメニューのプログラム・ユニットを探し、次に連結されたライブラリを検索します。この動作により、呼び出されるプログラム・ユニットが、コンパイル時に解決されたのと同じプログラム・ユニットではないので、動的名前の解決の簡易なスタイルが得られます。さらに、同じライブラリが複数のFormsに連結される場合には、各Formsは、インスタンシエーション、パッケージ状態、依存関係を含む一意のセットのライブラリ情報を保持します。これは依存関係情報がForms全体にわたって共有されないことを意味します。

R4.5には次の短所があります。

•	Forms全体にわたって情報が共有されません。SHARE_LIBRARY_STATEは効果がありません。

•	実行時間とメモリー使用量が増えます（R5+と比較した場合）。

R5+の動作:

Formsがプログラム・ユニットのコールに出会うと、まず現行Formsまたはメニューのプログラム・ユニットを探し、次に連結されたライブラリを検索します。しかし、同じライブラリが複数のFormsに連結される場合には、各Formsは一意のセットのライブラリ情報を保持しません。その代わりに、プログラム・ユニット・インスタンシエーションはForms全体にわたって共有されます。これは依存関係情報がForms全体にわたって共有できることを意味します。

推奨事項:

前述の短所とこの環境変数が将来のバージョンで必ずサポートされるとは限らないため、R4.5の動作を選択しないようお薦めします。

その代わりに、動的な名前の解決を取得するために、Execute-Triggerビルトインを使用してください。引数が必要な場合はグローバル変数を使用します。


FORMS60_REPFORMAT

デフォルト: なし

有効な値: HTML、PDF

例:

FORMS60_REPFORMAT=HTML

ブラウザを起動して、フォームからRUN_PRODUCTを使用してレポートを実行する場合は、FORMS60_REPFORMAT環境変数を設定する必要があります。このパラメータは、レポートの書式を指定します。


FORMS60_TIMEOUT

デフォルト:   15

有効な値: 1～1440（1日）

例:

FORMS60_OUTPUT=1440

このパラメータは、クライアントとFormsのサーバーとの通信がない場合に、Formsのサーバーのプロセスが終了するまでの経過時間を分単位で指定します。


FORMSnn_USER_DATE/DATETIME_FORMAT

目的: 次の2つの環境変数は、独自のマスクを持たないDATE型およびDATETIME型の項目から値を取り出すためにFormsが実行時に使用する書式マスクを設定します。

デフォルト: ヘルプ・トピック「日付の書式マスク」を参照してください。

有効な値: 任意の有効な日付/日時書式マスク。複数の書式マスクを垂直バーで区切って指定できます。ランタイム項目の変換時には、その変換が正常に終了するまで（または、書式マスクがなくなるまで）書式マスクが指定された順に使用されます。

例:

FORMS65_USER_DATE_FORMAT  FXFMDD-MM-RRRR


FORMS60_USEREXITS

デフォルト: なし

有効な値: （絶対パスおよび）任意のユーザー・イグジット・ダイナミック・リンク・ライブラリ。

このパラメータにより、複数のDLLを定義し、ユーザー・イグジット・インタフェースから起動できる外部ファンクションを含めることができます。FORMS60_USEREXITSパラメータには、セミコロンで区切られた一連のユーザー・インタフェースDLLが入っています。

FORMS60_USEREXITSには、複数のDLLを指定できます。円記号（\）を使用してパス内のディレクトリを指定し、セミコロン（;）を使用してパスごとに区切ってください。

この値を明示的に設定しないと、Form Builderは値をORACLE_HOME\BIN\F45XTB.DLLと断定します。

例:

FORMS60_USEREXITS = C:\mathlib\add.dll;C:\mathlib\mult.dll


GRAPHICS60_PATH

デフォルト: なし

有効な値: 任意のドライブの任意のディレクトリ

例:

GRAPHICS60_PATH=C:\oracle\apps\graphics;C:\myfiles

このパラメータは、Graphics Runtimeアプリケーション内で使用されるファイルの検索パスを指定します。これは、表示ファイル（.ogr）、イメージ、外部問合せおよびアプリケーションが実行時にファイルからロードを試みるその他のオブジェクトを含みます。たとえば、イメージ・ファイルscooter.tifをインポートすると、Graphics Builderはこのファイルを探すためにGRAPHICS60_PATHで指定されているディレクトリを検索します。

GRAPHICS60_PATHには、複数のディレクトリを指定できます。円記号（\）を使用してパス内のディレクトリを指定し、セミコロン（;）を使用してパスごとに区切ってください。


INTERRUPT（DOS SQL*Netユーザーのみ）

デフォルト: なし

有効な値: DOSのCONFIG.ORAファイルで指定されているものと同じ値

このパラメータは、DOSのOracle製品が使用する割込みベクトル・アドレスを指定します。Windows版のDOS SQL*Netドライバを使用する場合は、CONFIG.ORAファイルがDOSのOracleホーム・ディレクトリに入っていることを確認してください。INTERRUPTパラメータがCONFIG.ORA内に設定されている場合は、レジストリ内でこのパラメータを同じ値に設定する必要があります。DOSのCONFIG.ORAファイル内でこの変数が設定されていない場合は、レジストリ内で設定する必要はありません。

注意: QEMM、386MAX、CEMM、EMM386などのサードパーティのメモリー管理製品を使用する場合は、INTERRUPTを103に設定しないでください。この設定が行われると、SQLPMEおよびSQL*Netを起動後、予期しない動作が起きます。


LOCAL

デフォルト: なし

有効な値: データベースの文字列パラメータを含む、任意の有効なSQL*Netドライバ接頭辞。詳細は、『Oracleネットワーク管理者ガイド』を参照してください。

このパラメータは、製品内でのデータベースの接続に通信ドライバを設定しない場合にこの製品が使用する、SQL*Netドライバと完全な接続文字列を指定します。

LOCALパラメータを追加する場合、そのパラメータをファイルの最後に追加しないでください。Oracle製品は、LOCALパラメータが最後のパラメータとして現れる場合、それを認識しません。

注意: Windows版のDOS SQL*Netドライバを使用する場合は、LOCALパラメータがDOSのOracleホーム・ディレクトリのCONFIG.ORAファイルに設定されているかを確認してください。CONFIG.ORA内でLOCALが設定されている場合、同じ値をレジストリ内で設定する必要があります。


NLS_LANG

デフォルト: AMERICAN_AMERICA.WE8ISO8859P1

有効な値: 利用できる値の現行の一覧を、『NLSリファレンス・マニュアル』またはCDの\bonus\nls\nlsd2r1.wriファイルで参照してください。

例:

NLS_LANG=AMERICAN_AMERICA.WE8ISO8859P1

このパラメータは、メッセージ・ファイルが表示される言語を設定します。NLS_LANGの構文を次に示します。

NLS_LANG=<language>_<territory>.<char_set>

パラメータの内容は次のとおりです。

language	メッセージおよび日と月の名前を表示するための言語とその規約を指定します。
territory	週と日の数を計算するための地域およびその規約を指定します。
char_set	UPPER、LOWERおよびINITCAPファンクションに使用されるキャラクタ・セットと、ORDER BY問合せが使用するソートの型を指定します。この引数は、メッセージの表示に使用するキャラクタ・セットも制御します。


OleCreateObjPoolInMemory

デフォルト:   0

有効な値: 0または1

例:

OleCreateObjPoolInMemory=0

Report Builderでは、このパラメータはOLE2オブジェクト・プールを一時ファイル（0）に作成するか、メモリー（1）に作成するかを指定します。メモリーにプールを作成すると、ディスク・アクセスを減らしパフォーマンスが向上します。OLE2オブジェクトが多いか大きなOLE2オブジェクト（イメージなど）がある場合は、必要なメモリー量が多くなる可能性があります。どれだけのOLE2オブジェクトがあるかを調べるには、繰返し枠内の1つのOLE2ボイラープレート・オブジェクトにOLE2オブジェクトが1つ入っていることを参考にしてください。1つのOLE2フィールドには、フィールドのそれぞれのインスタンスに対しOLE2オブジェクトが1つ入っています。


OleDoNotUpdateLinks

デフォルト:   0

有効な値: 0または1

例:

OleDoNotUpdateLinks=0

Report Builderでは、このパラメータは、レイアウト・エディタがオープンされる場合やレポートが実行される場合、リンクのアップデートを有効（0）または無効（1）にします。リンクされたOLE2オブジェクトには、それらのソース・オブジェクトのキャッシュされたプレゼンテーションが入っています。これらのキャッシュされたプレゼンテーションは、持続したオブジェクト・データに基づく対応するOLE2サーバーにより更新されます。

これらの更新は、リンクの種類に基づき、自動的に、または手動で行われます。キャッシュされたプレゼンテーションの更新はOLE2サーバーの起動を要するため、ソース・オブジェクトが変更されていないことが明らかな場合や、最新の変更を必要としない場合は、更新を無効にしパフォーマンスを向上させることができます。このオプションを指定しない場合も、OLE2オブジェクトが更新される際に表示される標準のダイアログ・ボックスで更新を取り消すことができます。


OleUpdateLinksPrompt

デフォルト:   0

有効な値: 0または1

例:

OleUpdateLinksPrompt=0

Report Builderでは、このパラメータは、リンクしたオブジェクトが見つからない場合にそれを知らせる（0）か知らせない（1）かを指定します。更新時にオブジェクトのソースが見つからない場合ダイアログ・ボックスが表示され、リンク・ソースを再指定するかエラーを無視できます。ダイアログ・ボックスに対応できない場合（レポートを一晩中実行している場合など）、レポートの実行が確実に終了するようにこの確認を無効にできます。


ORACLE_HOME

デフォルト: C:\ORAWIN95

有効な値: 任意のドライブの任意のディレクトリ

例:

ORACLE_HOME=C:\orawin95

このパラメータは、Windows版のOracle製品がインストールされているホーム・ディレクトリを指定します。このディレクトリは、Oracleディレクトリ階層の「トップ」ディレクトリです。

使用上の注意

•	Reports Runtimeを使用している場合は、ORACLE_HOMEとORACLE_PATHで使用できる検索パスの最大長は合計で255文字です。


ORACLE_PATH

デフォルト: なし

有効な値: 任意のドライブの任意のディレクトリ

例:

ORACLE_PATH=C:\oracle\apps\forms;C:\oracle\apps\graphics;
C:\oracle\apps\reports

このパラメータは、Forms Runtime、Graphics RuntimeまたはReports Runtimeにより参照されるファイルの検索パスを指定します。ORACLE_PATHで指定されるディレクトリは、製品固有のパラメータであるFORMS60_PATH、GRAPHICS60_PATHまたはREPORTS60_PATHで指定されるディレクトリの後に検索される点に注意してください。

ORACLE_PATHには、複数のディレクトリを指定できます。セミコロン（;）を使用して、パス・リスト内のディレクトリ名を区切ってください。

使用上の注意

•	Reports Runtimeを使用している場合は、ORACLE_HOMEとORACLE_PATHで使用できる検索パスの最大長は合計で255文字です。


ORAINFONAV_DOCPATH

デフォルト: なし

有効な値: 任意のドライブの任意のディレクトリ

例:

ORAINFONAV_DOCPATH=C:\orawin95\oin

このパラメータは、オンライン・ドキュメントの目次と索引のテーブルのディレクトリを指定します。


REMOTE

デフォルト: なし

有効な値: 任意の有効なSQL*Netドライバ接頭辞およびパラメータ

例:

REMOTE=P:PIPER

このパラメータは、ローカル・データベースを介して接続する場合に使用する、デフォルトのリモートSQL*Netドライバを指定します。このパラメータには、デフォルトのSQL*Netパラメータ（すべてのデータベース文字列）を含めることができます。

この例中のP：は名前付きパイプに対するネットワーク接頭辞、Piperはデータベース名です。

ユーザーがログインを行いREMOTEで指定されたものと一致する明示的なドライバ接頭辞との接続を指定し、SQL*Netパラメータを指定しないと、REMOTEで指定されたパラメータが使用されます。このパラメータによりDBAは、SQL*Netユーザーが接続パラメータを指定する必要がない「通常の」ネットワーク接続を定義できます。このパラメータは、コマンド・ラインでいつでもリセットできます。

注意:Windows版のDOS SQL*Netドライバを使用する場合は、DOSのOracleホーム・ディレクトリに入っているCONFIG.ORAファイルにREMOTEパラメータが設定されているか確認してください。CONFIG.ORAでREMOTEが設定されている場合は、レジストリ内でこのパラメータを同じ値に設定する必要があります。


REPORTS60_CGIDIAGBODYTAGS

Reports Web CGIでは、このパラメータはRWCGI60診断/デバッグ出力で<BODY_>タグとして挿入されるHTMLタグを指定します。たとえば、この環境変数を文字色/背景色とイメージを設定するのに使用することができます。


REPORTS60_CGIDIAGHEADTAGS

Reports Web CGIでは、このパラメータは診断/デバッグ出力のRWCGI60で <HEAD> � </HEAD>タグの間に挿入されるHTMLタグを指定します。たとえば、この環境変数を<TITLE>や<META_>タグを設定するのに使用することができます。


REPORTS60_CGIHLP

Reports Web CGIでは、このパラメータでRWCGI60ヘルプ・ファイルを空の要求で起動したときにナビゲートされるURL/URIを指定します。

http://your_webserver/your_virtual_cgi_dir/rwcgi60.exe?

たとえば、REPORTS60_CGIHLPをhttp://www.yahoo.comに設定すると、指定したWebページが表示され、myhelpfile.htmに設定すると指定したファイルが表示されます。

http://your_webserver/myhelpfile.htm

この変数を定義しない場合は、デフォルトのヘルプ画面が表示されます。


REPORTS60_CGIMAP

Reports Web CGIでは、このパラメータでマップ・ファイル構成が使用される場合に、RWCGI60マップ・ファイルの適切なファイル名および位置を定義します。

c:\orant\report60\mymap.dat


REPORTS60_CGINODIAG

Reports Web CGIでは、このパラメータを定義するとRWCGI60からのすべてのデバッグ/診断出力が使用不可になります。

http://your_webserver/cgi-bin/rwcgi60.exe/help?

使用上の注意

このパラメータは、REPORTS60_CGINODIAGが定義されている場合は使用できません。


REPORTS60_CGIPATHONLYURL

Reports Web CGIでは、このパラメータが定義されている場合（値にかかわらず）、指定されたURLのパス部分にしか戻りません。 たとえば、次のURLに戻るかわりに、

Location: http://your_webserver:port/path

こちらに戻ります。

Location: /Path

この変数は、デフォルトのポートを含む複数のポートを使用するWebサーバーのセットアップに関する問題を解決するのに使用することができます。


REPORTS60_COOKIE_EXPIRE

デフォルト:   30

有効な値: 任意の数（分単位）

例:

REPORTS60_COOKIE_EXPIRE=30

Reports Serverのセキュリティでは、このパラメータはクッキーのアイドル時間（例 REPORTS60_COOKIE_EXPIRE=30）を決定します。クッキーは暗号化されたユーザー名とパスワードをクライアント側で保存します。CGIがクライアントからクッキーを受け取ると、CGIがクッキーに保存された時間と、現在のシステム時間を比較します。

REPORTS60_COOKIE_EXPIREパラメータで指定された時間（例 30分）よりも長い時間が経過している場合は、CGIはクッキーを拒否し、データベース認証フォームとエラー・メッセージをクライアントに返します。レポートを実行するには、ユーザーは再度認証を受けなければなりません。


REPORTS60_DB_AUTH

デフォルト: dbauth.htm

有効な値: 特別な認証アクションを含む、任意のhtmlファイル。デフォルトの状態が望ましい。

例:

REPORTS60_DB_AUTH=dbauth.htm

データベースにログインするのに使用するデータベース認証テンプレートを指定します。


REPORTS60_SYS_AUTH

デフォルト: sysauth.htm

有効な値: 特別な認証アクションを含む、任意のhtmlファイル。デフォルトの状態が望ましい。

例:

REPORTS60_SYS_AUTH=sysauth.htm

アクセスが制限されているReports Serverに対してユーザがレポート要求を実行するときに、ユーザー名とパスワードを認証するのに使用する認証テンプレートを指定します。


REPORTS60_ENCRYPTION_KEY

デフォルト: Reports6.0

有効な値: 任意の暗号キー

例:

REPORTS60_ENCRYPTION_KEY=reports6.0

このパラメータで、ユーザー名とパスワードの暗号化に必要な暗号キーを指定します。


REPORTS60_REPORTS_SERVER

有効な値: 任意のReports Serverサービス・エントリ名

例:

REPORTS60_REPORTS_SERVER=repserver

デフォルトのReports ServerをWeb CartridgeまたはWeb CGI要求に指定します。このパラメータを設定すると、レポート要求でSERVERコマンド･ライン引数を省略し、デフォルト・サーバーを使用してそれらを処理することも、SERVERコマンド･ライン引数を組み込んで、デフォルトより優先させることもできます。


REPORTS60_OWSDIAGBODYTAGS

Reports Webカートリッジでは、このパラメータはRWOWS60診断/デバッグ出力ファイルで<BODY_>タグとして挿入されるHTMLタグを指定します。たとえば、この環境変数を文字や背景の色やイメージなどを指定するのに使用することができます。


REPORTS60_OWSDIAGHEADTAGS

Reports Webカートリッジでは、このパラメータはRWOWS60診断/デバッグ出力ファイルで<HEAD> _</HEAD>タグの間に挿入されるHTMLタグを指定します。たとえば、この環境変数を<TITLE>や<META_>タグなどを指定するのに使用することができます。


REPORTS60_OWSHELP

有効な値:任意のパスとファイル名、またはURL

Reports Web カートリッジでは、このパラメータはRWOWS60ヘルプ・ファイルが空の要求で起動されたときにナビゲートされるURL/URIを指定します。

http://your_webserver/rwows60?

例 このパラメータをhttp://www.yahoo.comに設定すると、Webページが表示され、myhelpfile.htmに設定すると、指定したファイルが表示されます。

http://your_webserver/myhelpfile.htm

このパラメータを定義しない場合は、デフォルトのヘルプ画面が表示されます。


REPORTS60_OWSMAP

Reports Webカートリッジでは、このパラメータはRWOWS60マップ・ファイルの適切なファイル名および位置を指定します（マップ・ファイル構成が使用されている場合）。

C:\ORANT\REPORTS60\MYMAP.DAT


REPORTS60_OWSNODIAG

Reports Webカートリッジでは、このパラメータを定義すると、RWOWS60からのすべてのデバッグ/診断出力が使用不可になります。

http://your_webserver/rwows60/help?

REPORTS60_OWSNODIAGが定義されている場合は、このパラメータを使用することはできません。


REPORTS60_OWSPATHONLYURL

Reports Webカートリッジでは、このパラメータを指定すると（値にかかわらず）、RWOWS60は、レポート出力するHTTPリダイレクションと、RWOWS60が生成する診断出力にURLのパス部分のみを使用します（例 "http://mywebsrv.com:1550/rscache/..."の代わりに"/rscache/..."）。クライアントのブラウザで、レポート出力を検索した後に、"Location"フィールドのオリジナルのURL要求を維持するのに役に立ちます。通常、RWOWS60はURLをレポート出力の場所に置き換えて（例 REPORTS60_WEBLOCで指定されたディレクトリ）、出力されたレポート出力ファイルの名前を、12345679.htmのような意味のない文字列のような形式の名前で表示します。このパラメータを設定することによって、このような"URL の切り替え"を避けることができます。すべてのURLがデフォルトのポート（通常は80）を使用している場合のみ、このパラメータを使用することができます。

しかし、このパラメータを設定する場合の欠点は、メインのレポート出力ファイルに依存している任意の補助ファイル（たとえば画像ファイルなど）をブラウザで検索することができないことです（REPORTS60_WEBLOCで指定した場所に作成はされています）。この問題は、メインのレポート出力ファイルにインクルードしたり、REPORTS60_WEBLOCでRWOWS60実行可能ファイルの場所を、レポート定義の<BASE HREF="...">や<META HREF="...">タグ（メイン・ファイルの場所をフル・パスまたは部分パスで）で指定すると対処できます。

コンピュータ名やIPアドレスのHTTPリダイレクションの依存性を解決するため、REPORTS60_OWSPATHONLYURLを設定すると、1台のコンピュータが複数の異なるIPアドレスを同時に（複数のネットワーク・カードを使用して）持つイントラネットまたはインターネット構成に対処することもできます。


REPORTS60_PATH

デフォルト:ORACLE_HOME\REPORT60\DEMO;ORACLE_HOME\REPORT60\DEMO\BITMAP;ORACLE_HOME\REPORT60\DEMO\REQFILES

有効な値: 任意のドライブの任意のディレクトリ

例:

REPORTS60_PATH=C:\oracle\apps\reports;C:\myfiles

この環境変数は、レポートと、PL/SQLライブラリ、外部問合せ、外部ボイラープレートなどのレポート内で使用する外部オブジェクトの位置を示すのに使用します。この環境変数により、ディレクトリ・パスをハードコード化する必要がなくなり、オペレーティング・システム間で簡単に移植できるレポートを作成することが可能となります。

注意: REPORTSPATHは256文字以内に制限されています。

パスの長さなどのプラットフォーム固有の規則に注意しながら、オペレーティング・システム上の他の環境変数の定義と同じ方法で、REPORTS60_PATHを定義してください。

REPORTS60_PATHを定義する際、ディレクトリ・パスの他、キーワードとなるデータベースを指定できます。この指定は、Report Builderに現在接続しているデータベースを検索するように指示します。

Unixプラットフォームで次のように指定したと仮定します。

setenv REPORTS60_PATH
/home/tkostin/pay:/home/tkostin/receive:DB

Report Builderは、初めにディレクトリ/home/tkostin/payを検索します。探しているファイルが見つからない場合、/home/tkostin/receiveを検索します。それでもファイルが見つからないと、Report Builderセッションを開始したときに接続していたデータベースを検索します。


REPORTS60_TERMINAL

デフォルト: なし

有効な値: 任意のドライブの任意のディレクトリ

例:

REPORTS60_TERMINAL=C:\mytermdefs

この環境変数は、文字モード・レポート内で使用する端末定義の位置を示すのに使用します。この変数に指定するパスは、ORACLE_TERMINAL環境変数よりも優先します。

パスの長さなどのプラットフォーム固有の規則に注意しながら、オペレーティング・システム上の他の環境変数の定義と同じ方法でREPORTS60_TERMINALを定義してください。


REPORTS60_TMP

デフォルト: なし

有効な値: 任意のドライブの任意のディレクトリ

例:

REPORTS60_TMP=C:\tmp

この環境変数は、Report Builderの一時ファイルを格納するディレクトリを設定します。Report Builderは、この目的では1つのディレクトリしか使用しません。 複数のディレクトリを定義しないでください。

パスの長さなどのプラットフォーム固有の規則に注意しながら、ベース・オペレーティング・システム上の他の環境変数の定義と同じ方法でREPORTS60_TMPを定義してください。REPORTS60_TMPを定義しないと、現在使用しているディレクトリがデフォルトで指定されます。


REPORTS60_USEREXIT

デフォルト: なし

有効な値: （絶対パスおよび）任意のユーザー・イグジット・ダイナミック・リンク・ライブラリ

例:

REPORTS60_USEREXIT=C:\mydll.dll;d:\mynew.dll;e:\bin\speed.dll

このパラメータにより、Report Builderおよびその関連する実行可能プログラム（Reports Runtimeなど）が使用する複数のDLLを定義できます。これらのDLLは、Report Builderの実行可能プログラムがコールするように開発者が作成したプログラム・モジュールです。

REPORTS60_USEREXITSには、複数のDLLを指定できます。円記号（\）を使用してパス内のディレクトリを指定し、セミコロン（;）を使用してパスごとに区切ってください。

この値を明示的に指定しないと、Report Builderはシステムのパス変数に従って60xtb32.dllを探します。


UI_ICON

デフォルト: なし

有効な値: 任意のドライブのアクセス可能なディレクトリ

例:

UI_ICON=C:\icon

この環境変数は、レイアウト内のボタンに使用するアイコンを格納するディレクトリを設定します。Report Builderは、この目的では1つのディレクトリしか使用しません。 複数のディレクトリを定義しないでください。

パスの長さのようなプラットフォーム固有の規則に注意しながら、ベース・オペレーティング・システム上の他の環境変数の定義と同じ方法で、UI_ICONを定義してください。


USERNAME

デフォルト: なし

有効な値: （OPS$接頭辞を除く）任意の有効なOracleユーザー名

例:

USERNAME=dsanvita

このパラメータは、デフォルトのログイン・アカウントの変数部分を指定します。USERNAMEパラメータの設定の詳細は、データベースのドキュメントを参照してください。


WIN_REMOTE_SESSIONS

デフォルト: なし

有効な値:   0～33

ログイン時にORA-3100～ORA-3100の範囲のエラーを受け取った場合は、Oracle Serverとの通信バッファを設定するのに十分なリアルモード・メモリーがない可能性があります。NETINIT7.EXEを使用すると、サーバー接続のメモリーを確保しこの問題を解決できます。

このパラメータは、NETINIT7がメモリーを確保する、リモート・サーバーへの接続数を設定します。WIN_REMOTE_SESSIONSパラメータを設定する際、次の規則に注意してください。

•	WIN_REMOTE_SESSIONSを0に設定すると、NETINIT7はリモート・サーバー接続に対しメモリーを確保しません。

•	WIN_REMOTE_SESSIONSを1～33の値に設定すると、指定した接続数に必要なメモリーを確保します。NETINIT7は、各リモート・サーバー接続に対し12KBのリアルモード・メモリーを確保します。

•	WIN_REMOTE_SESSIONSの推奨されるデフォルト値は5。 WIN_REMOTE_SESSIONSを5に設定すると、複数の製品を実行するのに十分なセッションを作成できます。

•	WIN_REMOTE_SESSIONSパラメータを追加しないと、NETINIT7は1つのリモート・サーバー接続に必要なメモリーを確保します。

NETINIT7を使用する場合、次に示すステップを行ってください。

1	WIN_REMOTE_SESSIONSパラメータを追加し、セッション数を設定します。

2	Oracleプログラム・グループ内でNETINIT7アイコンを作成します（アイコンの作成の詳細は、Microsoft Windowsの文書を参照）。Windowsの「アイコンのプロパティ」ダイアログ・ボックスの「コマンド・ライン」フィールドで次のパスを入力します。

ORACLE_HOME\bin\netinit7.exe

3	Oracleプログラム・グループ内のアイコンをダブルクリックし、NETINIT7を起動します。NETINIT7は、必ず製品を起動する前に起動してください。Windowsの起動時にNETINIT7を自動的に実行したい場合は、「Windows起動」プログラム・グループにNETINIT7アイコンを含めてください。

NETINIT7は、設定された数のサーバー接続に必要な実メモリーの確保を試みます。必要なメモリーを割り当てられないと、NETINIT7は警告メッセージを表示し、メモリーを割り当てた実際のセッション数を示します。

メモリーを割り当てた後、NETINIT7のサイズは最小化されます。NETINIT7を復元すると、設定されているセッションの合計数と使用されているメモリーの合計容量が表示されます。NETINIT7をクローズすると、使用されていないすべてのセッション・メモリーが解放されます。アプリケーションでセッション・メモリーがまだ使用されている場合は、NETINIT7はセッション・メモリーが解放される前にアプリケーションのログオフが必要なことを知らせます。

注意: NETINIT7の前にこの製品を起動すると、製品はNETINIT7が認識しないそれ自身のセッション・メモリーを割り当てます。NETINIT7は、起動した製品によりすでに割り当てられているメモリーに加えて設定されているセッション・メモリーを割り当てようとします。


XMITTR（DOSユーザーのみ）

デフォルト: なし

有効な値: DOSのCONFIG.ORAファイルで指定されているものと同じ値

このパラメータは、Oracle DOSのプロテクト・モードの実行可能プログラムのユーザーにのみ適用されます。DOSのOracleホーム・ディレクトリに入っているCONFIG.ORAファイルを確認してください。CONFIG.ORAにXMMITRパラメータが設定されている場合、レジストリ内でこのパラメータを同じ値に設定する必要があります。DOSのCONFIG.ORAファイル内でこの変数が設定されていない場合は、レジストリ内で設定する必要はありません。

拡張メモリー・マネージャの割込みベクトル（Extended Memory Manager Interrupt Vector:XMMITR）は、拡張メモリー・マネージャ、モード遷移ドライバXMMおよびMTD割込みサービスのエントリ・ポイントに使用される割込みベクトルを示す変数です。異なるベクトルを設定するには、新しいベクトルを10進数として表現します。XMMITRは、システム内の別のプログラムが割込みの100（10進）または64（16進）を使用する必要がある場合のみ使用してください。

注意: QEMM、386MAX、CEMM、EMM386などのサードパーティのメモリー管理製品を使用する場合は、XMMITRを103に設定しないでください。この設定が行われると、SQLPMEおよびSQL*Netのロード後、予期しない動作が起きます。


構文パレットのインタフェース

構文パレットを使用すると、PL/SQL言語要素やビルトイン・パッケージの構成体を表示したりコピーできます。選択した構文は、プログラム単位エディタまたはストアド・プログラム単位エディタにのみコピーできます。

構文パレットには、次のページがあります。

PL/SQLページ	コピーするPL/SQL言語要素を表示および選択できます。PL/SQL言語要素は、制御フロー、カーソル、例外などのカテゴリの一覧にグループ化されています。
ビルトイン・ページ	ビルトイン・パッケージからPL/SQL構成体（ファンクションまたはプロシージャ）を表示および選択できます。ビルトインの一覧は、EXEC_SQL、DEBUG、DDEのようなパッケージ名でグループ化されています。

各ページには次のコンポーネントがあります。

ドロップダウン・リスト	PL/SQLカテゴリ名またはビルトイン・パッケージ名が表示されます。   右側の矢印をクリックすると、PL/SQLカテゴリまたはビルトイン・パッケージを選択できます。
リスト領域	選択されたPL/SQLカテゴリ内の個々の言語要素、または選択されたビルトイン・パッケージ内の構成体が表示されます。デフォルトで、リスト内の最初の項目がハイライト表示（選択）されます。 言語要素または構成体をクリックすると、それらが選択され、表示領域に完全な構文が表示されます。
表示領域	選択されたPL/SQL言語要素または構成体の完全な構文が表示されます。予約語は大文字で表示されます。 エディタに構文を挿入した後、コメント内にない小文字の項目を適切な値に置き換えます。コメント内の小文字の項目は任意です。
挿入	クリックすると、リスト領域で選択された項目が、アクティブ・エディタ・ウィンドウの現行のカーソル位置にコピーされます。
クローズ	クリックすると、構文パレットがクローズします。
ヘルプ	このヘルプ・トピックが表示されます。


構文パレットの表示

構文パレットを表示するには:

  「プログラム」 [image] 「構文パレット」を選択します。


構文パレットのクローズ

構文パレットをクローズするには:

  「クローズ」ボタンをクリックします。


エディタへの構文の挿入

  関連項目

構文をエディタに挿入するには:

1	プログラム単位エディタまたはストアド・プログラム単位エディタが現行の（最後に選択された）ウィンドウであることを確認します。

2	エディタ内で、構文を挿入する位置にカーソルを置きます。

3	構文パレットで、「PL/SQL」タブまたは「ビルトイン」タブをクリックします。

4	ドロップダウン・リストで、PL/SQLカテゴリまたはビルトイン・パッケージを選択します。

カテゴリまたはパッケージをクリックすると、選択できるPL/SQL言語要素またはPL/SQL構成体が下のリスト領域に表示されます。

5	リスト領域でPL/SQL言語要素または構成体を選択します。

PL/SQL言語要素または構成体をクリックすると、リスト領域の下の表示領域に構文が表示されます。

6	「挿入」をクリックして、選択された構文をコピーします。

選択したプレースホルダのあるPL/SQL構文は、アクティブ・エディタの現行のカーソル位置に挿入されます。予約語は大文字で表示されます。

コメント内にない小文字のプレースホルダを、すべて適切な値と置換します。コメント内の項目は任意です。


PL/SQLカテゴリの一覧

ブロック

コメント

制御フロー

カーソル

データ型

例外

ファンクション

ループ

オブジェクト・タイプ

パッケージ

PL/SQL表

プロシージャ

問合せ

レコード

SQLカーソル

表/ビュー

トランザクション

ユーザー・タイプ

変数


ビルトインの一覧

EXEC_SQL

TOOL_SQL

ORA_FFI

ORA_DE

ORA_PROF

ORA_NLS

TOOL_RES

TOOL_ENV

TEXT_IO

TOOL_ERR

STPROC

LIST

OLE2

DDE

DEBUG

PLITBLM

STANDARD


編集機能

  関連項目

次の編集機能は、プログラム単位エディタおよびストアド・プログラム単位エディタでのみサポートされます。

自動インデントおよびインデント解除	エディタでコードを入力すると、PL/SQL構文の規則に従って行が自動的にインデントまたはインデント解除されます。
カラーによる構文のハイライト	キーワード、コメント、文字列および:=や||などの記号は、別のカラーで表示されます。
列と行の選択	テキスト列やソース・コードの行を選択できます。 列を選択するには、[ALT]キーを押してから列ををクリックし、水平にドラッグします。 行を選択するには、ソース・ペインで行の左端マージンをクリックします。
ドラッグ・アンド・ドロップによるテキストの操作	選択されたテキストは、ドラッグ・アンド・ドロップによってコピーまたは移動できます。 テキストをコピーするには、[Ctrl]キーを押しながら、選択したテキストをドラッグします。 テキストを移動するには、選択したテキストをドラッグします。
行のインデントおよびインデント解除	「編集」メニューの「インデント」コマンドおよび「インデント解除」コマンドを使用すると、選択したソース行をインデントまたはインデント解除できます。 [Tab]および[Shift]+[Tab]キーを押しても、選択した行をインデントまたはインデント解除できます。
複数の分割ビュー	現行のプログラム単位の別個のビューを最大4つ作成できます。 水平ビューを作成するには、垂直スクロール・バーの一番上にある分割バーにカーソルを置きます。次に、分割バーをクリックし、下にドラッグします。 垂直ビューを作成するには、水平スクロール・バーの左端にある分割バーにカーソルを置きます。次に、分割バーをクリックし、右方向にドラッグします。 水平ビューまたは垂直ビューを削除するには、ビューを分割する分割バーをダブルクリックします。
印刷	現行のプログラム単位を印刷するには、「ファイル」 [image] 「印刷」を選択します。
無制限の元に戻す/再実行	「編集」メニューの「元に戻す」コマンドおよび「再実行」コマンドを使用すると、最後に保存したときの状態まで、変更を元に戻したり、再実行できます。

注意: これらの機能は、Microsoft Windowsのみで使用できます。UNIXでは、次の操作のみを実行できます。

•	現行のプログラム単位の印刷

•	[TAB]および[Shift]+[TAB]キーを使用した、選択行のインデントとインデント解除

•	ドラッグ・アンド・ドロップによる選択テキストの移動


エディタでのマウスの使用

  関連項目

Microsoft Windowsでプログラム単位エディタ（およびストアド・プログラム単位エディタ）を使用するときは、次のマウス操作がサポートされています。

操作	マウス操作
文字の範囲を選択する	選択する範囲内の最初の文字をクリックし、最後の文字までカーソルをドラッグします。(UNIXでもサポートされています) または 選択する範囲内の最初の文字をクリックし、[Shift]キーを押しながら最後の文字をクリックします。
カーソルの下の単語を選択する	単語をダブルクリックします。(UNIXでもサポートされています) または [Ctrl]キーを押しながら、選択する単語をクリックします。
単語の範囲を選択する	[Ctrl]キーを押しながら、選択する範囲の最初の単語をクリックし、最後の単語までカーソルをドラッグします。
行を選択する	選択する行の左マージンにカーソルを置きます。カーソルが矢印に変わったときにクリックします。
複数の行を選択する	選択する最初の行の左マージンにカーソルを置きます。カーソルが矢印に変わったときにクリックし、選択する最後の行までカーソルをドラッグします。
テキスト列を選択する	[Alt]キーを押し、選択する範囲の最初の列をクリックし、最後の列までカーソルをドラッグします。
選択されたテキストを移動する	まずテキストを選択します。次に、選択したテキストをクリックし、新しい位置にドラッグします。(UNIXでもサポートされています)
選択されたテキストをコピーする	まずテキストを選択します。次に、[Ctrl]キーを押しながら、コピーを配置する位置まで、選択したテキストをドラッグし、マウスを離します。
ウィンドウを2つの水平ビューに分割する	垂直スクロール・バーの一番上にある分割バーをダブルクリックします。 または 垂直スクロール・バーの一番上にある分割バーをクリックし、ドラッグします。
ウィンドウを2つの垂直ビューに分割する	水平スクロール・バーの左端にある分割バーをダブルクリックします。 または 水平スクロール・バーの左端にある分割バーをクリックし、ドラッグします。
分割ビューの相対サイズを調整する	ビューを分割している分割バーをクリックし、ドラッグします。
分割ビューを削除する	ビューを分割している分割バーをダブルクリックします。 または 分割バーをクリックし、ウィンドウの端までドラッグします。 4つのビューを一度に削除するには、分割バーが交わる点をダブルクリックするか、またはその点をウィンドウの任意の角までドラッグします。


エディタでのキーボードの使用

  関連項目

Microsoft WindowsまたはUNIXでプログラム単位エディタ（およびストアド・プログラム単位エディタ）を使用するときは、次のキーボード操作がサポートされています。

操作	キー入力
カーソルを左に1文字移動する	[←]
カーソルを左に移動しながら文字を選択する	[Shift]+[←]
カーソルを右に1文字移動する	[→]
カーソルを右に移動しながら文字を選択する	[Shift]+[→]
選択された文字または単語をコピーする	[Ctrl]+[C]
選択された文字または単語をカットする	[Ctrl]+[X]
クリップボードからペーストする	[Ctrl]+[V]
現行のカーソル位置の右側にある文字を削除する、または選択された文字または単語を削除する	[Del]
現行のカーソル位置の左側にある文字を削除する	[Back Space]
カーソルをプログラム単位の末尾に移動する	[Ctrl]+[End]	(Windowsのみ)
カーソルをプログラム単位の先頭に移動する	[Ctrl]+[Home]	(Windowsのみ)
現行のカーソル位置から、プログラム単位の末尾までのソース行を選択する	[Ctrl]+[Shift]+[End]	(Windowsのみ)
現行のカーソル位置から、プログラム単位の先頭までのソース行を選択する	[Ctrl]+[Shift]+[Home]	(Windowsのみ)
カーソルを現行の行の末尾に移動する	[End]	(Windowsのみ)
カーソルを現行の行の先頭に移動する	[Home]	(Windowsのみ)
現行のカーソル位置から、現行の行の末尾までの文字を選択する	[Shift]+[End]	(Windowsのみ)
現行のカーソル位置から、現行の行の先頭までの文字を選択する	[Shift]+[Home]	(Windowsのみ)
選択された行をインデントするか、または現行のカーソル位置の右側にある文字をインデントする	[Tab]
選択された行をインデント解除する	[Shift]+[Tab]
カーソルを下に1行移動する	[↓]
カーソルを下に移動しながら行を選択する	[Shift]+[↓]
カーソルを上に1行移動する	[↑]
カーソルを上に移動しながら行を選択する	[Shift]+[↑]
ソース・ペインに表示されている行数単位でプログラム単位を下にスクロールする	[Page Down]
ソース・ペインに表示されている行数単位でプログラム単位を下にスクロールしながら行を選択する	[Shift]+[Page Down]
ソース・ペインに表示されている行数単位でプログラム単位を上にスクロールする	[Page Up]
ソース・ペインに表示されている行数単位でプログラム単位を上にスクロールしながら行を選択する	[Shift]+[Page Up]
最後の操作を元に戻す	[Ctrl]+[Z]	(Windowsのみ)
最後に元に戻した操作を再実行する	[Ctrl]+[Y]	(Windowsのみ)


PL/SQL V1変換の例

  関連項目 	   すべての例

デフォルト式を削除する

NULLをRETURN文に追加する

廃止されたビルトインを置換する

ファンクションlength

オーバーロードしたサブプログラムにNULLを渡す

RETURN文が指定されていない

パッケージのプロシージャ名を一意名に変更する

パッケージの接頭辞を削除する

予約語

長さの制限を削除する

変数の宣言


データ・ウィザード: 前置きページ

データ・ウィザードについて

データ・ウィザードを使用すると、問合せ、ブレーク・グループ、複数問合せレポートの合計が簡単に定義できます。ウィザードでデータ・モデルを作成したら、以下のことができます。

•	データ・モデル表示でデータ・モデルを修正します。

•	データ・ウィザードを使用して、追加問合せを作成します。

•	レポート・ウィザードを使用して、レイアウトをデフォルト設定します。

•	レイアウト・モデル表示でレイアウトを修正します。順序の再指定または新規レイアウト・セクションの追加を含みます。

注意: このリリースでは、データ・ウィザードは問合せ間のリンクの作成をサポートしていません。親/子問合せのリレーションを定義する場合、手動でデータ・リンクを作成します。

データ・ウィザードは再実行可能

データ・ウィザードの優れた点は繰り返し実行できることです。データ・ウィザードを使用して、既存のデータ・モデルの問合せを修正できます。

再実行モードでデータ・ウィザードを起動するには、オブジェクト・ナビゲータで既存の「問合せ」をクリックし、「ツール」 [image] 「データ・ウィザード」を選択します。

データ・ウィザード内のナビゲート

データ・ウィザードにはページ間をナビゲートするときに使用する6個のボタンがあります。

•	取消—加えた変更（ある場合）をすべて取り消し、ウィザードを終了します。

•	ヘルプ—ウィザードの現行ページのオンライン・ヘルプ・テキストを表示します。

•	戻る—ウィザードの前のページに移動します。

•	次へ—ウィザードの次のページに移動します。

•	適用—加えた変更を適用します（再実行可能ウィザードのみ）。

•	完了—ウィザードで加えた変更（ある場合）を保存し、ウィザードを完了します。

注意: 特定のウィザード・ページに必要な情報をすべて入力し終える前に「次へ」をクリックすると、ウィザードでは次のページに移動できなくなります。同様に、必要な情報をすべてウィザードに入力しないで「適用」または「完了」をクリックすると、ウィザードでは自動的にそのページに切り替わり、必要なデータを入力し終えることができます。


データ・ウィザード: 問合せ名ページ

  データ・ウィザードについて

1	（オプション）「問合せ名」フィールドで、デフォルト問合せ名を置換します。

2	マトリックス（クロスタブ）レポートのデータ・モデル内でこの問合せが使用されている場合、「マトリックス問合せ」チェックボックスをチェックします。


データ・ウィザード: タイプ・ページ

作成する問合せのタイプを選択します。

•	SQL文は、リレーショナル・データベース（Oracle8など）からデータを選択する問合せを作成することを意味します。

•	Expressへの問合せは、OLAP Serverからデータを選択する問合せを作成することを意味します。


データ・ウィザード: データ・ページ

  関連項目      [image]  データ・ウィザードについて

1	データベースに接続していなければ「接続」をクリックし、「接続」ダイアログ・ボックスに必要事項を入力します。

2	次のいずれかの方法でSELECT文を指定します。

•	「SQL問合せ文」領域にSELECT文を入力します。

•	「Query Builder」をクリックし、「Query Builder」のダイアログを使用して問合せを定義します。Query Builderによる問合せの作成を終了すると、SELECT文が「SQL問合せ文」領域に表示されます。

•	「SQL問合せインポート」をクリックして、ファイルに格納されているSELECT文を取得します。「インポート」ダイアログ・ボックスをクローズすると、選択したファイルの内容が「SQL問合せ文」領域に置かれます。


データ・ウィザード: グループ・ページ

  データ・ウィザードについて

1	「使用可能フィールド」リストで、グループ・フィールドにするフィールドをクリックします。

2	 をクリックして、そのフィールドを「マトリックス・グループ・フィールド」リストに移動します。フィールドのブレーク・レベルを定義する行が、その上に表示されます。

3	レポートに入れるすべてのフィールド・グループについて、ステップ1と2を繰り返します。

4	（オプション）「グループ・フィールド」リストのフィールドをクリックし、希望するブレーク・レベルまでドラッグします。

5	（オプション）「グループ・フィールド」リストからフィールドを削除するには、それをクリックしてから [image] をクリックします。

使用上の注意

•	2つの列を同じブレーク・レベルに配置する場合は、「グループ・フィールド」リストの列を先にクリックしてから、「使用可能フィールド」リストから列を移動します。「使用可能フィールド」リストから移動した列は、選択された列と同じブレーク・レベルに自動的に配置されます。新しいブレーク・レベルを作成する場合は、「使用可能フィールド」リストの列をクリックし、「グループ・フィールド」リストのブレーク・レベルをクリックします。次に、「使用可能フィールド」リストから列を移動します。列は選択したブレーク・レベルの下にある新しいブレーク・レベルに自動的に配置されます。

•	現時点では、一部のOracle8データ型がサポートされていません。サポートされていないOracle8データ型が問合せによって選択されると、ウィザード内でそのデータ型は特殊なアイコンによって識別されます。

•	列オブジェクトと参照列は、ブレーク列にはなりません。したがって、「使用可能フィールド」リストでこれらの列は選択できません。

•	「グループ・フィールド」リストの属性列は、アンダースコア記号を使用してその親子リレーション（ADDRESS_ZIPなど）を示します。


データ・ウィザード: 合計ページ

  データ・ウィザードについて      [image]  関連項目

1	「使用可能フィールド」リストのフィールドをクリックします。

2	そのフィールドに適用するファンクションに該当するボタンをクリックします。フィールドとファンクション名のエントリが、「合計」リストに表示されます。

3	そのフィールドに適用する他のファンクションについても、ステップ2を繰り返します。

4	希望するすべての合計が作成されるまで、ステップ1から3を繰り返します。

5	（オプション）「合計」リストからフィールドを削除するには、それをクリックしてから左矢印 [image] ボタンをクリックします。

使用上の注意

•	現時点では、一部のOracle8データ型がサポートされていません。サポートされていないOracle8データ型が問合せによって選択されると、ウィザード内でそのデータ型は特殊なアイコンによって識別されます。

•	列オブジェクトまたは参照列に対して実行できるファンクションは限られています。したがって、「使用可能フィールド」リストでこれらの列を選択すると、一部のファンクションは使用不可の状態になります。

•	グループ・レポートの場合、データ・ウィザードは、定義する各サマリー列について、データ・モデル内にn個のサマリー・フィールドを作成します。集計中の列の上にあるグループ・レベルごとに1つ、およびレポート・レベルに1つ作成します。たとえば、レポートが部署別にグループ分けされ、さらに課別にグループ分けされる場合、給与合計について定義されたサマリー列によって、各部署および各課グループの給与小計（グループ・レベル・サマリー）および全給与の小計（レポート・レベル・サマリー）のフィールドが作成されます。


データ・ウィザード: グループ・ページ

  データ・ウィザードについて

「マトリックス・グループ・フィールド」リストのフィールドが希望どおりの場合は、

  「次へ」をクリックします。

「マトリックス・グループ・フィールド」リストのフィールドを変更するには:

1	「変更可能フィールド」リストで、マトリックス・グループ・フィールドにするフィールドをクリックします。

2	 をクリックして、そのフィールドを「マトリックス・グループ・フィールド」リストに移動します。フィールドのブレーク・レベルを定義する行が、その上に表示されます。

3	レポートに入れるすべてのマトリックス・グループ・フィールドについて、ステップ1と2を繰り返します。

4	（オプション）「マトリックス・グループ・フィールド」リストのフィールドを選択し、希望するブレーク・レベルまでドラッグします。

5	（オプション）「マトリックス・グループ・フィールド」リストからフィールドを移動するには、それをクリックしてから [image] をクリックします。

使用上の注意

•	2つの列を同じブレーク・レベルに配置する場合は、「マトリックス・グループ・フィールド」リストの列を先にクリックしてから、「使用可能フィールド」リストから列を移動します。「使用可能フィールド」リストから移動した列は、選択された列と同じブレーク・レベルに自動的に配置されます。新しいブレーク・レベルを作成する場合は、「使用可能フィールド」リストの列をクリックし、「マトリックス・グループ・フィールド」リストのブレーク・レベルをクリックします。次に、「使用可能フィールド」リストから列を移動します。列は選択したブレーク・レベルの下にある新しいブレーク・レベルに自動的に配置されます。

•	現時点では、一部のOracle8データ型がサポートされていません。サポートされていないOracle8データ型が問合せによって選択されると、ウィザード内でそのデータ型は特殊なアイコンによって識別されます。

•	列オブジェクトと参照列は、ブレーク列にはなりません。したがって、「使用可能フィールド」リストでこれらの列は選択できません。

•	「マトリックス・グループ・フィールド」リストの属性列は、アンダースコア記号を使用してその親子リレーション（ADDRESS_ZIPなど）を示します。


データ・ウィザード: 行ページ

  データ・ウィザードについて

1	「使用可能フィールド」リストのフィールドをクリックします。

2	 をクリックして、そのフィールドを「マトリックス行フィールド」リストに移動します。フィールドのブレーク・レベルを定義する行が、その上に表示されます。ヒント

3	希望するすべてのマトリックス行フィールドについて、ステップ1と2を繰り返します。

4	（オプション）「マトリックス行フィールド」リストからフィールドを削除するには、それをクリックしてから [image] をクリックします。

使用上の注意

•	現時点では、一部のOracle8データ型がサポートされていません。サポートされていないOracle8データ型が問合せによって選択されると、ウィザード内でそのデータ型は特殊なアイコンによって識別されます。

•	列オブジェクトと参照列は、マトリックス行フィールドとして使用できません。したがって、「使用可能フィールド」リストでこれらの列は選択できません。

•	「マトリックス行フィールド」リストの属性列は、アンダースコア記号を使用してその親子リレーション（ADDRESS_ZIPなど）を示します。


データ・ウィザード: 列ページ

  データ・ウィザードについて

1	「使用可能フィールド」リストのフィールドをクリックします。

2	 をクリックして、そのフィールドを「マトリックス列フィールド」リストに移動します。フィールドのブレーク・レベルを定義する行が、その上に表示されます。ヒント

3	希望するすべてのマトリックス列フィールドについて、ステップ1と2を繰り返します。

4	（オプション）「マトリックス列フィールド」リストからフィールドを移動するには、それをクリックしてから [image] をクリックします。

使用上の注意

•	現時点では、一部のOracle8データ型がサポートされていません。サポートされていないOracle8データ型が問合せによって選択されると、ウィザード内でそのデータ型は特殊なアイコンによって識別されます。

•	列オブジェクトと参照列は、マトリックス行フィールドとして使用できません。したがって、「使用可能フィールド」リストでこれらの列は選択できません。

•	「マトリックス行フィールド」リストの属性列は、アンダースコア記号を使用してその親子リレーション（ADDRESS_ZIPなど）を示します。


データ・ウィザード: セル・ページ

  データ・ウィザードについて

1	「使用可能フィールド」リストのフィールドをクリックします。

2	そのフィールドに適用するファンクションに該当するボタンをクリックします。フィールドとファンクション名のエントリが、「マトリックス（セル）・フィールド」リストに表示されます。ヒント

3	希望するすべてのマトリックス（セル）・フィールドについて、ステップ1と2を繰り返します。

4	（オプション）「マトリックス（セル）・フィールド」リストからフィールドを削除するには、それをクリックしてから [image] をクリックします。

使用上の注意

•	現時点では、一部のOracle8データ型がサポートされていません。サポートされていないOracle8データ型が問合せによって選択されると、ウィザード内でそのデータ型は特殊なアイコンによって識別されます。

•	列オブジェクトと参照列は、マトリックス・セル・フィールドとして使用できません。したがって、「使用可能フィールド」リストでこれらの列は選択できません。

•	「マトリックス・セル・フィールド」リストの属性列は、アンダースコア記号を使用してその親子リレーション（ADDRESS_ZIPなど）を示します。


データ・ウィザード: 合計ページ

  データ・ウィザードについて

1	「使用可能フィールド」リストのフィールドをクリックします。

2	そのフィールドに適用するファンクションに該当するボタンをクリックします。フィールドとファンクション名のエントリが、「マトリックス合計」リストに表示されます。

3	そのフィールドに適用する他のファンクションについても、ステップ2を繰り返します。

4	希望するすべての合計が作成されるまで、ステップ1から3を繰り返します。

5	（オプション）「マトリックス合計」リストからフィールドを削除するには、それをクリックしてから [image] をクリックします。

使用上の注意

•	現時点では、一部のOracle8データ型がサポートされていません。サポートされていないOracle8データ型が問合せによって選択されると、ウィザード内でそのデータ型は特殊なアイコンによって識別されます。

•	列オブジェクトまたは参照列に対して実行できるファンクションは限られています。したがって、「使用可能フィールド」リストでこれらの列を選択すると、一部のファンクションは使用不可の状態になります。


データ・ウィザード: 完了ページ

  データ・ウィザードについて

次に行うこと

データ・ウィザードを終了し、レポートの作業を続行する準備ができました。「完了」 をクリックすると、Report Builderではデータ・ウィザードがクローズされ、データ・モデル表示にデータ・モデルが自動的に表示されます。これで以下のことができます。

•	データ・モデル表示でデータ・モデルを修正します。

•	データ・ウィザードを使用して、追加問合せを作成します。

•	レポート・ウィザードを使用して、レイアウトをデフォルト設定します。

•	レイアウト・モデル表示でレイアウトを修正します。順序の再指定または新規レイアウト・セクションの追加を含みます。

レポート作成の詳細は、オンライン・ヘルプを参照してください。

1	Report Builderの簡単な概要は、クイック・ツアーを参照します。

•	「ヘルプ」 [image] 「クイック・ツアー」を選択します。

2	最も一般的な作業の実行方法を学習するには、キュー・カードを参照します。

•	「ヘルプ」 [image] 「キュー・カード」を選択します。

3	オンライン・マニュアルにアクセスします。

•	「ヘルプ」 [image] 「マニュアル」を選択します。

4	「ヘルプ・トピック」を検索します。

•	目次および索引の表の場合、「ヘルプ」 [image] 「ヘルプ・トピック」を選択します。

•	状況判断ヘルプの場合、[Help]（ほとんどのプラットフォームでは通常、[F1]キー）を押します。


「オブジェクト整列」ダイアログ・ボックス

説明  「オブジェクト整列」ダイアログ・ボックスでは、一連のオブジェクトの配置方法を指定することができます。

ダイアログ・ボックスの内容:

整列基準: 相互/格子

水平

垂直


整列基準

説明  「整列基準」は、選択したオブジェクトをどのように並べるかを指定するラジオ・ボタンです。「格子」または「相互」のいずれかを選択します。

値

格子	最も近い格子指定点に合せて並べます。
相互	選択した他のオブジェクトに合せて並べます。


水平

説明 「水平」は、オブジェクトを水平方向にどのように並べるかを指定するラジオ・ボタンです。

値

中央	各選択オブジェクトの水平中心点が、選択したすべてのオブジェクトの中央で並ぶように移動します。
左	各選択オブジェクトの左側が、一番左にある選択オブジェクトの左側にそろうように移動します。
右	各選択オブジェクトの右側が、一番右にある選択オブジェクトの右側にそろうように移動します。
分配	一番左と一番右のオブジェクトを元の水平位置に残したまま、選択オブジェクトを等間隔に移動します。
寄せ	各選択オブジェクトの左側が、すぐ左のオブジェクトの右側に並ぶように移動します。一番左のオブジェクトは、元の位置のままです。
なし	水平整列は使用されていません。


垂直

説明  「垂直」は、オブジェクトを垂直方向にどのように並べるかを指定するラジオ・ボタンです。

値

下	各選択オブジェクトの最下部が、一番下にある選択オブジェクトの最下部にそろうように移動します。
中央	各選択オブジェクトの垂直中心点が、選択したすべてのオブジェクトの中央で並ぶように移動します。
上	各選択オブジェクトの最上部が、一番上にある選択オブジェクトの最上部にそろうように移動します。
分配	一番上と一番下のオブジェクトを元の垂直位置に残したまま、選択オブジェクトを等間隔に配置します。
寄せ	各選択オブジェクトの最上部が、すぐ上のオブジェクトの最下部に並ぶように移動します。一番上のオブジェクトは、元の位置のままです。
なし	垂直整列は使用されていません。


「オブジェクト・サイズ設定」ダイアログ・ボックス

説明  「オブジェクト・サイズ設定」ダイアログ・ボックスでは、一連のオブジェクトのサイズを相対的に変更することができます。

ダイアログ・ボックスの内容:

カスタム高さ

カスタム幅

高さ

単位

幅


カスタムの高さ

説明  カスタムの高さとは、「カスタム」ラジオ・ボタンで「高さ」を選択した場合、各選択オブジェクトのサイズがそこまで変更される高さです。

値

任意の正数を入力します。


カスタムの幅

説明  カスタムの幅とは、「カスタム」ラジオ・ボタンで「幅」を選択した場合、各選択オブジェクトのサイズがそこまで変更される幅です。この値のサイズの単位は、ダイアログ・ボックス内のラジオ・ボタンによって指定します。

値

任意の正数を入力します。


高さ

説明  「高さ」は、選択オブジェクトの高さをどのように変更するかを指定する一連のラジオ・ボタンです。

値

平均	高さが選択したすべてのオブジェクトの平均の高さと等しくなるように、各オブジェクトのサイズを変更します。
カスタム	高さが「Custom Hight」テキスト・フィールドに入力したカスタムの高さと等しくなるように、各オブジェクトのサイズを変更します。
最大サイズ	高さが一番背の高い選択オブジェクトの高さと等しくなるように、各オブジェクトのサイズを変更します。
なし	オブジェクトの高さは変わりません。
最小サイズ	高さが一番背の低い選択オブジェクトの高さと等しくなるように、各オブジェクトのサイズを変更します。


単位

説明  「単位」は、「カスタム」フィールドで使用するサイズの単位を指定します。

値

センチメートル

文字セル

インチ

ポイント


幅

説明  「幅」は、選択したオブジェクトの幅をどのように変更するかを指定する一連のラジオ・ボタンです。

値

平均	幅が選択したすべてのオブジェクトの平均の幅と等しくなるように、各オブジェクトのサイズを変更します。
カスタム	幅が「カスタム」フィールドに入力したカスタムの幅と等しくなるように、各オブジェクトのサイズを変更します。
最大サイズ	幅が一番幅の広い選択オブジェクトの幅と等しくなるように、各オブジェクトのサイズを変更します。
なし	オブジェクトの幅は変わりません。
最小サイズ	幅が一番幅の狭い選択オブジェクトの幅と等しくなるように、各オブジェクトのサイズを変更します。


「チャート」ダイアログ・ボックス

  関連項目

説明  「チャート」ダイアログ・ボックスでは、レポート列とパラメータをチャート列とパラメータにマップすることができます。

ダイアログ・ボックスの内容:

  「パラメータ」タブ

  「列」タブ


「値リスト・パラメータ」ダイアログ・ボックス

説明  「値リスト・パラメータ」ダイアログ・ボックスでは、パラメータの値リストを定義することができます。スタティック値リストを作成するか、またはデータベースからの値を使用することができます。作成するリストのタイプ（スタティック値またはSELECT文）を選択すると、ダイアログの設定が適宜変わります。

ダイアログ・ボックスの内容:

追加

第1列を隠す

値リスト

Query Builder

削除

事前定義済み値に対するリストを制限

SELECT文/スタティック値

値


Query Builder

説明  Query Builderにより、SELECT文の作成に使用できる一連のダイアログ・ボックスが起動します。


「カラー/パターン」ダイアログ・ボックス

説明  「カラー/パターン」ダイアログ・ボックスでは、プロパティ・パレットの現行プロパティのカラーまたはパターンを選択することができます。カラーまたはパターンを選択し、ダイアログ・ボックスを適用します。


「SQL問合せ文」ダイアログ・ボックス

説明  「SQL問合せ文」ダイアログ・ボックスでは、SQL SELECT文を入力することができます。SELECT文の入力、Query Builderを使ったSELECT文の作成、または既存問合せのインポートができます。

ダイアログ・ボックスの内容:

SQL問合せ文	作成したSELECT文です。
Query Builder	Query Builder（SELECT文を作成できるようにする一連のダイアログ・ボックス）を表示します。
接続	「接続」ダイアログ・ボックスを表示し、ここから希望するデータベースに接続できます。
SQL問合せ　インポート	インポートする.sqlファイルを選択できるファイル・ダイアログ・ボックスを表示します。
使用上の注意

•	入力するSELECT文は、SELECT文の基準となるSQL言語の構文ルールに従ってください。『Oracle8 Server SQLリファレンス』を参照してください。

•	8ビット文字（たとえば、Danish_Denmark.we8ISO8859P1）を使用している場合は、列、表およびパラメータを二重引用符で囲む必要があります。


条件付き書式ダイアログ・ボックス

  関連項目

説明  「条件付き書式」ダイアログ・ボックスを使用すると、レポート出力内のデータをハイライト表示する書式属性（フォントおよびカラー）を条件付きで設定する書式の例外を追加、編集または削除できます。「書式の例外」ダイアログ・ボックス（「新規作成」または「編集」をクリックすると表示される）を使用すると、定義済みの条件に基づいて選択したレイアウト・オブジェクトの出力書式属性を、すばやく、簡単に指定できます。

ダイアログ・ボックスの内容:

書式の例外	「書式の例外」ダイアログ・ボックスで定義された書式の例外をリストする。書式は書式の例外がリストされる順序で適用されます。 両方の書式の例外がTRUEに評価される場合、書式の例外は前の書式の例外を上書きします。
作成	「書式の例外」ダイアログ・ボックスが表示され、新しい書式の例外を定義できる。
編集	「書式の例外」ダイアログ・ボックスが表示され、既存の書式の例外を編集できる。
削除	選択された書式の例外を削除する。
サンプル	選択された書式の例外がTRUEに評価される場合、サンプル出力を表示する。オブジェクトを隠す場合、"オブジェクトを隠す"がここに表示されます。
上へ 下へ	「書式の例外」リストで選択された書式の例外を上下に移動する。注意: リスト内の項目をドラッグ・アンド・ドロップすることもできます。


「書式の例外」ダイアログ・ボックス

  関連項目

説明  「書式の例外」ダイアログ・ボックスを使用すると、定義済みの条件に基づいて選択したレイアウト・オブジェクトの出力書式属性を、すばやく、簡単に指定できます。条件は3つまで定義でき、指定された順序で評価されます（つまり、上から下へ）。条件設定の結果がオブジェクトを隠すことでない限り（この場合、書式を適用する意味がない）TRUEに評価される各条件が適用されます。

ダイアログ・ボックスの内容:

条件チェックボックス

パラメータ/列のドロップダウン･リスト

条件ドロップダウン･リスト

値フィールド

AND/ORドロップダウン･リスト

書式セクション:

境界色

塗りカラー

フォント

オブジェクトを表示しない

書式設定のリセット

文字色


条件チェックボックス

説明  条件チェックボックスを使用すると、最高で3つの条件を指定できます。

値

指定する条件のチェックボックスをチェックします。


パラメータ/列のドロップダウン･リスト

説明  パラメータ/列のドロップダウン･リストには、条件を設定できるシステムおよびユーザー・パラメータ、およびレイアウト・オブジェクトの値を提供する数値、日付、文字、LONG型列が含まれます。

値

リストからパラメータまたは列を選択します。


条件ドロップダウン･リスト

説明  条件ドロップダウン･リストには、選択したパラメータまたは列の有効な条件が含まれます。

値

リストから条件を選択します。


値フィールド

説明  値フィールドを使用すると、選択したパラメータまたは列の値を指定できます。

値

リストから値を選択するか、選択したパラメータまたは列の値を入力します。リテラル値またはバインド変数を指定できます;以下に例を示します。

SAL between :LOWSAL and 50000

ここで、LOWSALはデータ・モデルの列またはパラメータです。


AND/ORドロップダウン･リスト

説明  AND/ORドロップダウン･リストを使用すると、複数条件の結果を評価するためのブール論理を指定できます。条件を3つ指定した場合、3つめの条件に対して最初の2つの条件の結果が評価されます。（つまり、（条件1 AND/OR 条件2） AND/OR 条件3）。

このドロップダウン･リストは、後に続く条件のチェックボックスをチェックしているときに限りアクティブになります。

値

AND	書式を適用するには、現行の条件および後続の条件が共にTRUEにする必要があることを意味する。
OR	書式を適用するには、現行の条件または後続の条件のいずれかがTRUEであることを意味する。


境界色

説明  境界色は、指定した条件の評価がTRUEである場合のレイアウト・オブジェクトの境界線のカラーです。

値

をクリックし、カラー・パレットからカラーを選択します。


塗りカラー

説明  塗りカラーは、指定した条件の評価が TRUE である場合のレイアウト・オブジェクトの塗り（バックグラウンド）カラーです。

値

をクリックし、カラー・パレットからカラーを選択します。


フォント

説明  フォントは、指定した条件の評価が TRUE である場合にフォントのスタイル、太さ、およびレイアウト・オブジェクトのサイズを変更するために、「フォント」ダイアログ・ボックスを表示します。「フォント」ダイアログ・ボックスの「OK」をクリックすると、指定した条件の評価が TRUE である場合に、Report Builderではこのダイアログ・ボックス内のすべての設定がレイアウト・オブジェクトに適用されます（「フォント」ダイアログ・ボックスのデフォルト設定の修正とは無関係）。


オブジェクト非表示

説明  「オブジェクト非表示」チェックボックスを使用すると、指定した条件の評価が TRUE である場合に、レイアウト・オブジェクトを書式付きレポートに表示しないかどうかを指定できます。

値

チェック	オブジェクトを書式付きレポートに表示しない。
チェックなし	オブジェクトを書式付きレポートに表示する。


書式設定のリセット

説明  「書式設定のリセット」ボタンを使用すると、実質的な変更をしないで、レイアウト・オブジェクトの書式を既存の設定にリセットできます。カラーおよびフォントの値は<default>に設定されます。


文字色

説明  文字色は、指定した条件の評価が TRUE である場合のレイアウト・オブジェクトのテキストのカラーです。

値

をクリックし、カラー・パレットからカラーを選択します。


「変換」ダイアログ・ボックス・オプション

説明  「変換」ダイアログ・ボックスでは、レポートまたはPL/SQLライブラリのコピーを異なる形式で作成することができます。たとえば、データベースに格納されているレポート定義を、RWRUN60によって実行できる実行ファイルに変換することができます。レポート定義を、他のレポートにも適用されるテンプレートに変換することもできます。

ダイアログ・ボックスの内容:

  「変換」タブ

  「オプション」タブ

使用上の注意

•	変換を行うと、変換処理の一部として、レポートのPL/SQLが自動的にコンパイルされる場合もあります。変換先がrexファイルでないと、PL/SQLは次の場合に、自動的にコンパイルされます。その他の状況では、自分でレポートのPL/SQLをコンパイルする必要があります（「プログラム」 [image] 「コンパイル」 [image] 「すべて」など）。

•	「変換」を使用してrepファイルを作成する。コンパイルでエラーが発生すると、エラー・メッセージが表示され、repファイルは作成されません。

•	ソース・レポートとしてrexファイルを使用する。コンパイルでエラーが発生すると、警告が表示されますが、変換は続行します。

•	ソース・レポートとして別のプラットフォーム上に作成されたレポートを使用する。コンパイルでエラーが発生すると、警告が表示されますが、変換は続行します。

•	Report BuilderまたはReport Runtimeでレポートをオープンすると、フォントがマップされます。変換中は、フォントはマップされません。

•	レポートをテンプレートに変換する場合、レポートのヘッダー・ページとトレーラ・ページおよびマージン領域にあるオブジェクトのみがテンプレートに使用されます。ボディにあるオブジェクトは無視されます。

•	連結ライブラリ付きのレポートを変換する場合、レポートに連結されたpllファイルを変換してから、rdfファイルを変換する必要があります。


「変換」タブ

説明  「変換」タブでは、実行する変換のソースと宛先の情報を指定します。このタブのほとんどの項目は、RWCON60キーワードに対応します。

文書タイプ

宛先	DEST

宛先タイプ	DTYPE

ソース	SOURCE

ソース・タイプ	STYPE


「オプション」タブ

説明  「オプション」タブでは、特定の変換特性を指定します。このタブのすべての項目は、RWCON60キーワードに対応します。

宛先単位	DUNIT

フォーム・ディメンション	FORMSIZE

ログ・ファイル	LOGFILE

上書き	OVERWRITE

ページ・ディメンション	PAGESIZE


文書タイプ

説明  「文書タイプ」は、変換している文書のタイプです。

値

PL/SQLライブラリ

Report

デフォルト

Report


変換状態

説明  「変換状態」ダイアログ・ボックスでは、変換処理についての情報（正常に処理されたかどうか、正常に処理されなかった場合の原因など）を提供します。


「コメント」ダイアログ・ボックス

説明  「コメント」ダイアログ・ボックスでは、オブジェクトを記録することができます。たとえば、オブジェクトが行うことを他の人がすぐに理解できるように、その用途を記述できます。64KB以下のテキストを入力します。


「デリミタ付き出力」ダイアログ・ボックス

  関連項目

説明  「デリミタ付き出力」ダイアログ・ボックスでは、デリミタ付きレポート出力の作業環境を定義します。

ダイアログ・ボックスの内容:

デリミタ

日付書式マスク

数値書式マスク

セルの囲み


デリミタ

  関連項目

説明  「デリミタ」は、デリミタ付きレポート出力の各セルを区切る文字を指定する値です。

値

[Tab]	各セルをタブで区切ります。
,	各セルをカンマで区切ります。
:	コロンで各セルを区切ります。
;	セミコロンで各セルを区切ります。
|	垂直バーで各セルを区切ります。
?	疑問符で各セルを区切ります。
$	ドル記号で各セルを区切ります。
.	各セルをピリオドで区切ります。
スペース	各セルをスペースで区切ります。
Return（リターン）	各セルを改行で区切ります。
任意の英数字または英数字の文字列	テキスト・ボックスに入力する文字で各セルを区切ります。
デフォルト

[Tab]

使用上の注意

ASCIIキャラクタ・セットに基づくエスケープ・シーケンスを使用することもできます。


日付書式マスク

説明  「日付書式マスク」は、デリミタ付きレポート出力で日付値を表示する方法を指定します。

値

任意の有効な日付書式マスク

デフォルト

なし

使用上の注意

•	このオプションは、デリミタを選択した場合のみ使用できます。

•	書式マスクは日付データのみに適用されます。


数値書式マスク

説明  「数値書式マスク」は、区切りレポート出力で数字値を表示する方法を指定します。

値

任意の有効な数値書式マスク

デフォルト

なし

使用上の注意

•	このオプションは、デリミタを選択した場合のみ使用できます。

•	書式マスクはレポート出力のすべての数値データのみに適用されます。


セルの囲み

説明  「セルの囲み」は、デリミタ付きレポート出力の各セルの周囲に表示する文字を指定する値です。

値

なし	セルの囲みを表示しません。
"	セルの両側に二重引用符を表示します。
'	セルの両側に一重引用符を表示します。
スペース	セルの両側にスペースを表示します。
任意の英数字  または英数字の文字列	テキスト・ボックスに入力する文字をセルの両側に表示します。
デフォルト

なし

使用上の注意

•	このオプションは、デリミタを選択した場合のみ使用できます。

•	ASCIIキャラクタ・セットに基づくエスケープ・シーケンスを使用することもできます。


「オープン」ダイアログ・ボックス

説明  「オープン」ダイアログ・ボックスは、モジュールがデータベースもしくはファイルのどちらにあるかをReport Builderに知らせるのに使用されます。ファイルまたはデータベースのダイアログ・ボックス値リストに表示させるモジュールのタイプを制御することもできます。「オープン」ダイアログ・ボックスは、オブジェクト・アクセスの作業環境がファイル/データベースの場合にのみ表示されます。

ダイアログ・ボックスの内容:

  表示

  オープン元


「オープン」ダイアログ・ボックス

説明  「オープン」ダイアログ・ボックスは、ファイルまたはデータベースのダイアログ・ボックス値リストに表示させるモジュールのタイプを、Report Builderに知らせるのに使用されます。

ダイアログ・ボックスの内容:

  表示


表示

説明  「表示」は、データベースまたはファイルの選択ダイアログ・ボックスに表示されるリストに含めるオブジェクトのタイプを示す5つのチェックボックスです。

値

すべて	すべてが含まれます。
PL/SQL	外部PL/SQLライブラリが含まれます。
問合せ	外部問合せが含まれます。
レポート	レポートが含まれます。
テンプレート	テンプレートが含まれます。
デフォルト

すべて


オープン元

説明  「オープン元」には、モジュールがデータベースにあるのかファイルにあるのかが示されます。

値

データベース

ファイル

ファイル/データベース

デフォルト

データベース


「データベース」ダイアログ・ボックス

説明  「データベース」ダイアログ・ボックスでは、その操作用のデータベースからオブジェクトを選択することができます。

ダイアログ・ボックスの内容:

オープン	選択するモジュールの名前。モジュールの名前を入力するか、または値リストから選択することができます。データベースに格納されているモジュールの名前には、前にユーザーIDが付き、後ろにコロン（:）と拡張子（REPORTまたはQUERY、LIB）が付きます。モジュールの名前を入力すると、Report Builderでは自動的に名前の前にユーザーIDを付け、適切な拡張子を追加します。モジュールは、タイプ（REPORT、QUERY、LIB）、ユーザーID（現行ユーザーの後にアルファベット順でユーザーが続く）、アルファベット順のモジュール名の順序でリストされます。値リストは、「オープン」ダイアログ・ボックスの「表示」オプションによって制限されます。たとえば、「表示」オプションで「問合せ」のみを指定した場合は、値リストにはデータベースに格納された外部問合せの名前しか含まれません。
リスト取出し	「作業環境」ダイアログ・ボックスの「ダイアログ・ボックス・エントリでのリスト取出しを隠す」を選択すると、「データベース」ダイアログ・ボックスには、データベースに現在存在しているオブジェクトのリストが表示されません。オブジェクトのリストを表示するには、「リスト取出し」ボタンを選択しなければなりません。「ダイアログ・ボックス・エントリでのリスト取出しを隠す」を選択しないと、「リスト取出し」ボタンは使用できません（リストがすでに表示されているため）。
使用上の注意

•	データベースに格納されたモジュールの名前は、大/小文字の区別がありません。


「配布」ダイアログ・ボックス

  制限	  関連項目

説明  「配布」ダイアログ・ボックスでは、レポートまたはセクション（あるいはその両方）の出力に複数の宛先を指定することや、配布リストから宛先を削除することができます。

ダイアログ・ボックスの内容:

配布リスト	現行のレポートまたはセクションの配布リストの宛先が一覧表示されます。
配布ID	宛先の識別子です。
DESNAME	レポート出力の送り先となるパスとファイルの名前、プリンタまたは電子メールID（あるいは配布リスト）です。注意: ファイルを指定する場合は、パスの中のディレクトリがすでに存在していることが必要です。
	デフォルト repname repnamem repnameh repnamet	レポート メイン・セクション ヘッダー・セクション トレーラ・セクション
DESFORMAT	DESTYPEがFILEのときに使用される宛先の形式またはプリンタ・ドライバです。
	値
	BITMAP	Builderに表示されるのと同じビットマップ形式を指定します。 プリンタに送ることができます。
	HTML	HTML3.0準拠のブラウザで読み込めるHTML形式を指定します。
	HTMLCSS	カスケード・スタイル・シートをサポートするHTML3.0準拠のブラウザで読み込めるHTML形式を指定します。
	PDF	PDFビューアで読み込めるPDF形式を指定します。PDF出力は、ご使用のシステム用に現在構成されているプリンタをベースにしています。現在選択されているプリンタのドライバが、出力の作成に使用されます。 レポートを実行しているマシン用に、プリンタを構成してください。
	ASCII	文字（ASCII）形式を指定します。 MAPI準拠の電子メール・アプリケーションに送ることができます。
	RTF	標準のワード・プロセッサ（Microsoft Wordなど）で読み込めるRTF形式を指定します。
	デフォルト BITMAP
DESTYPE	レポート出力を受け取る宛先デバイスの種類です。
	値
	FILE	ファイル（DESNAMEで指定された）を指定します。
	MAIL	電子メール（DESNAMEで指定されたメールID）を指定します。MAPI準拠またはサービス・プロバイダ・ドライバがインストールされているメール・システムであれば、メールを送ることができます。レポートは、添付ファイルとして送られます。
	PRINTER	ファイル（DESNAMEで指定された）を指定します。
	デフォルト FILE
COPIES	配布する部数です。
作成	「設定」セクションの配布定義を配布リストに追加し、新しい配布定義の新規行をオープンします。
削除	選択した配布定義を配布リストから削除します。
すべて削除	配布リストを消去します。


配布の制限

•	複数の宛先にレポートを配布できるのはビットマップ・モードまたはキャラクタ・モードのみで、この両方を組み合わせて使用することはできません。

•	ASCII形式でレポートを配布するには、MODEシステム・パラメータをキャラクタ・モードに設定する必要があります。


「レポート前値」ダイアログ・ボックス

説明  「レポート前値」ダイアログ・ボックスでは、「レポート前値」プロパティのHTMLコードを入力することができます。希望するHTMLを入力し、ダイアログ・ボックスを確定します。


「レポート後値」ダイアログ・ボックス

説明  「レポート後値」ダイアログ・ボックスでは、「レポート後値」プロパティのHTMLコードを入力することができます。希望するHTMLを入力し、ダイアログ・ボックスを確定します。


「ページ前値」ダイアログ・ボックス

説明  「ページ前値」ダイアログ・ボックスでは、「ページ前値」プロパティのHTMLコードを入力することができます。希望するHTMLを入力し、ダイアログ・ボックスを確定します。


「ページ後値」ダイアログ・ボックス

説明  「ページ後値」ダイアログ・ボックスでは、「ページ後値」プロパティのHTMLコードを入力することができます。希望するHTMLを入力し、ダイアログ・ボックスを確定します。


「フォーム前値」ダイアログ・ボックス

説明  「フォーム前値」ダイアログ・ボックスでは、「フォーム前値」プロパティのHTMLコードを入力することができます。希望するHTMLを入力し、ダイアログ・ボックスを確定します。


「フォーム後値」ダイアログ・ボックス

説明  「フォーム後値」ダイアログ・ボックスでは、「フォーム後値」プロパティのHTMLコードを入力することができます。希望するHTMLを入力し、ダイアログ・ボックスを確定します。


「ページ・ナビゲーション・コントロール値」ダイアログ・ボックス

説明  「ページ・ナビゲーション・コントロール値」ダイアログ・ボックスでは、「ページ・ナビゲーション・コントロール値」プロパティのHTMLコードを入力することができます。希望するHTMLを入力し、ダイアログ・ボックスを確定します。


「外部問合せ定義」ダイアログ・ボックス

  例	  制限

説明  「外部問合せ定義」ダイアログ・ボックスでは、外部問合せとして使用するSQL SELECT文を指定します。64Kを超えない有効SELECT文を入力するか、または「ツール」 [image] 「Query Builder」を選択して問合せを組み立てます。


WHERE句付きSELECT文の例

  関連項目 	  すべての例

SELECT O.CUSTID, P.DESCRIP, I.ITEMTOT, O.ORDERDATE,
      I.ORDID
FROM ORD O, PRODUCT P, ITEM I
      I.PRODID = P.PRODID
WHERE O.ORDID = I.ORDID AND
ORDER BY O.CUSTID, P.PRODID, O.ORDERDATE
/* For each customer, show the products they bought */
/* (DESCRIP), the amount spent on each product */
/* (ITEMTOT), the date they ordered each product */
/* (ORDERDATE), the order id (ITEM.ORDID) of the */
/* order in which they bought each product. */


パラメータ参照元付きSELECT文の例

  関連項目 	  すべての例

SELECT CUSTID, SUM(TOTAL) TOTAL
FROM &FROMGROUP
HAVING SUM(TOTAL) > :MINTOTAL
/* &FROMGROUP is a parameter with an Initial Value of ORD GROUP */
/* BY CUSTID.Note that, in this case, you must define a */
/* parameter named FROMGROUP with an Initial Value specified.*/
/* If the value of &FROMGROUP is null when the SELECT statement is */
/* parsed, you will get an error because the statement will not */
/*have a table name after FROM.
/* :MINTOTAL is a column from another query that is used to */
/* select customers with a minimum total of orders. */


SELECT文の制限

注意: SELECT文を更新する場合、その更新によって、外部問合せを参照するレポート定義が無効にならないことを確認する必要があります。たとえば、レポートにDEPTNOの列があって、外部問合せの「SELECT」リストからDEPTNOを削除すると、そのレポートは実行できません。

•	入力するSELECT文は、SELECT文の基準となるSQL言語の構文ルールに従ってください。『ORACLE8 Server SQL言語リファレンス・マニュアル』を参照してください。

•	セミコロン、スラッシュまたはその他の文字をSELECT文の終わりに使用することはできません。

•	SELECT文を参照するレポート問合せが確定すると、SELECT文は有効になります。SELECT文を参照するレポートを実行しても、SELECT文が有効になり再読込みされます。

•	レポートで外部問合せを参照するときには、外部問合せで参照される表またはビューに対して適切な権限が必要となり、権限がないとエラーが発生します。

•	外部問合せでパラメータに字句参照を使用すると、Report Builderの解析時にNULL値が代入されます。

•	表名、列名またはパラメータ名で8ビット文字（たとえば、Danish_Denmark.we8ISO8859P1）を使用している場合は、列、表およびパラメータを二重引用符で囲む必要があります。


「カスタム間隔」ダイアログ・ボックス

説明  「カスタム間隔」ダイアログ・ボックスでは、フィールドのテキストまたはボイラープレート・テキストの縦の行間のカスタム設定値を指定します。使用する場合はポイント数を選択または入力します。

ダイアログ・ボックスの内容:

6 ポイント

12 ポイント

18 ポイント

他	フィールドには正のポイント数を入力します。

使用上の注意

•	間隔は、ユーザーが作成したボタン・ラベル・テキストには影響を及ぼしません。

•	間隔は、ボイラープレート・テキストの選択部分に対して定義することはできません。ボイラープレート・オブジェクト全体に対して適用する必要があります。


「カスタム線幅」ダイアログ・ボックス

説明  「カスタム線幅」ダイアログ・ボックスでは、オブジェクトのカスタム境界線幅を指定することができます。使用する場合はサイズの単位を選択し、幅の数値を入力します。

ダイアログ・ボックスの内容:

インチ	幅をインチで指定します。
センチメートル	幅をセンチメートルで指定します。
ポイント	幅をポイントで指定します。
幅	現在選択されているオブジェクトの線の太さです。任意の正数を入力します。


「一般描画オプション」ダイアログ・ボックス

説明  「一般描画オプション」ダイアログ・ボックスでは、オブジェクトをレポート・エディタでどのように描くかを定義するオプションを指定することができます。「端形式」および「結合形式」、「オブジェクト作成」にオプションを1つずつ選択します。

ダイアログ・ボックスの内容:

端形式	オブジェクトの端の形式です。「切り」または「伸ばし」、「丸め」を選択します。
結合形式	オブジェクトがレポート・エディタで結合するときに使用される形式です。「凹凸」または「角」、「丸め」を選択します。
オブジェクト作成	オブジェクトを作成するとき、描き始める点です。「中心から描画する」または「角から描画する」を選択します。
使用上の注意

•	これらの設定は、レイアウトまたはパラメータ・フォームで描かれるオブジェクトにのみ適用されます。

•	「中心から描画する」の「オブジェクト作成」を選択しダイアログ・ボックスを確定すると、この設定に影響されるツール・パレットのこれらのツール上に、プラス記号が表示されます。


「円弧描画オプション」ダイアログ・ボックス

説明  「円弧描画オプション」ダイアログ・ボックスでは、円弧をレポート・エディタでどのように描くかを指定することができます。「円弧の閉じ」と「円弧の形」にオプションを1つずつ選択します。

ダイアログ・ボックスの内容:

円弧の閉じ	円弧を閉じるかどうかを指定します。「閉じる」または「閉じない」を選択します。
円弧の形	円弧内の領域をパターンで満たすかどうかを指定します。「弦型」または「円グラフ」を選択します。


「丸い四角形オプション」ダイアログ・ボックス

説明  「丸い四角形オプション」ダイアログ・ボックスでは、角の丸い四角形をレポート・エディタでどのように描くかを指定することができます。「単位」でサイズの単位を選択し、「水平」および「垂直」の数値を入力します。

ダイアログ・ボックスの内容:

水平	角の丸い四角形の丸い角の水平半径です。任意の正数を入力します。
垂直	角の丸い四角形の丸い角の垂直半径です。任意の正数を入力します。
単位	「水平」および「垂直」の値に使用するサイズの単位です。「センチメートル」または「インチ」、「ポイント」を選択します。


「イメージ描画オプション」ダイアログ・ボックス

説明  「イメージ描画オプション」ダイアログ・ボックスでは、イメージをどのように描画するかを指定します。

ダイアログ・ボックスの内容:

イメージの粗さ	イメージをディザリングするかどうかを指定します。ディザリングとは、イメージにはあるが、Rreport Builderのカラー・パレットにはないカラーをReport Builderでまねるプロセスです。イメージをディザリングしない場合、Report Builderではイメージに一番近い使用可能なカラーをかわりに使用します。ディザリングで処理したイメージは、見た目はよくなりますが、スクリーンでの再描画が遅くなります。「粗め」または「通常」を選択します。
イメージの品質	Report Builderでイメージを表示する品質を指定します。品質が高いイメージほど見た目はよくなりますが、スクリーンでの再描画が遅くなります。「高」または「低」、「標準」を選択します。


「カラー・パレット」ダイアログ・ボックス

説明  「カラー・パレット」ダイアログ・ボックスでは、カラー・パレットで使用可能なカラーを変更することができます。

ダイアログ・ボックスの内容:

現在のカラー	現在選択されているカラー名です。
編集	現在のカラーの設定を変更できるカラー・ホイールを表示します。
パレット名	現在のカラー・パレットの名前です。
改名	現在のカラーを「現在のカラー」に入力した名前に改名します。
編集するカラーを選択	レポート・エディタで使用されている現在のカラー・パレットが含まれています。パレットからカラーを選択すると、現在選択されているカラーを変更することができます。カラー・ホイールを適用すると、制御は「カラー・パレット」ダイアログ・ボックスに戻されます。


「定規設定」ダイアログ・ボックス

設定  「定規設定」ダイアログ・ボックスでは、レポート・エディタでの定規の外観の作業環境を定義します。

ダイアログ・ボックスの内容:

格子間隔

水平

格子当りのスナップポイント数

単位

垂直


格子間隔

説明  「格子間隔」ラジオ・ボタンにより、1定規単位に表示される格子線の間隔を指定します。

値

0.25	定規単位の4分の1ごとに格子線を1本、つまり1定規単位につき格子線を4本指定します。
0.5	定規単位の2分の1ごとに格子線を1本、つまり1定規単位につき格子線を2本指定します。
1	サイズの1単位ごとに格子線を1本、つまり1定規単位につき格子線を1本指定します。
2	サイズの2単位ごとに格子線を1本、つまり2定規単位につき格子線を1本指定します。
5	サイズの5単位ごとに格子線を1本、つまり5定規単位につき格子線を1本指定します。
他	サイズのx単位ごとに格子線を1本指定します。 xは「他」のフィールドに入力する数値です。


水平

説明  「水平」フィールドでは、文字セル単位のサイズをポイントで指定します。

値

任意の正の値を入力します。


格子当りのスナップポイント数

説明  「格子当りのスナップポイント数」ラジオ・ボタンにより、各格子線にスナップポイントをいくつ設定するかを指定します。「表示」メニューの「格子指定」をチェックすると、エディタでオブジェクトを配置するのにスナップポイントが使用されます。格子線にスナップポイントを多く設定するほど、オブジェクトの配置をより細かく制御できます。

値

1	各格子線にスナップポイントを1つ指定します。
2	各格子線にスナップポイントを2つ指定します。
4	各格子線にスナップポイントを4つ指定します。
5	各格子線にスナップポイントを5つ指定します。
8	各格子線にスナップポイントを8つ指定します。
他	各格子線にスナップポイントをx指定します。 xは「他」のフィールドに入力する数値です。
使用上の注意

•	「単位」が「インチ」の場合、「格子間隔」は1、「格子当りのスナップポイント数」は1です。 任意のオブジェクトを移動または作成する場合は、最も近いインチのスナップポイントに配置されます。「格子当りのスナップポイント数」を2に変更すると、オブジェクトは最も近い2分の1インチのスナップポイントに配置されます。


単位

説明  「単位」ラジオ・ボタンにより、現行の表示の定規にはどのサイズの単位を使用するかを指定します。

値

センチメートル

文字セル

インチ

ポイント


垂直

説明  「垂直」フィールドでは、文字セル単位のサイズをポイントで指定します。

値

任意の正の値を入力します。


ポイント

「ポイント」は1パイカを構成するプリンタの印字サイズです。1パイカは12ポイントで、1インチの6分の1に相当します（1ポイントは、1インチの72分の1です）。


文字セル

「文字セル」は1文字のサイズに相当する単位です（文字のサイズは「水平」および「垂直」で設定されます）。


?


「描画インポート/エクスポート」ダイアログ・ボックス

説明  「描画インポート/エクスポート」ダイアログ・ボックスでは、描画をどのようにインポートまたはエクスポートするかを指定することができます。「データベース」または「ファイル」を選択し、描画の名前を入力します。「形式」を指定します。希望するオプションを指定します。

ダイアログ・ボックスの内容:

データベース	データベースからインポートするかどうか、またはデータベースにエクスポートするかどうかを指定します。このラジオ・ボタンの隣には、オブジェクト名のフィールドと、データベースに格納したもののリストから選択できる「参照」ボタンがあります。
ファイル	ファイルからインポートするかどうか、またはファイルにエクスポートするかどうかを指定します。このラジオ・ボタンの隣には、ファイル名のフィールドと、ファイルに格納したもののリストから選択できる「参照」ボタンがあります。
形式	インポート、またはエクスポートされる描画に指定できる形式のリストです。形式を1つ選択します。
オプション（エクスポート）	次のとおりです。
CGMコード化	CGM形式でエクスポートされるオブジェクトの格納方法です。CGMでは、4バイトおよび2バイトの座標データ領域がサポートされています。（ほとんどの製品では、CGMに2バイトの座標データ領域が使用されています。）2バイトの座標データ領域には16ビットを、4バイトには32ビットを選択します。
圧縮	描画のエクスポート時に使用できる圧縮アルゴリズムのリストです。使用可能な圧縮アルゴリズムは、形式やモニター・タイプによって異なります。希望するアルゴリズムを選択します。
オプション（インポート）	次のとおりです。
	インポートしたカラー・パレットを使用	インポートしたカラー・パレットをデフォルトのカラー・パレットにするかどうかを指定します。


「イメージ・インポート/エクスポート」ダイアログ・ボックス

説明  「イメージ・インポート/エクスポート」ダイアログ・ボックスでは、イメージをどのようにインポートまたはエクスポートするかを指定することができます。「データベース」または「ファイル」を選択し、イメージの名前を入力します。「形式」を指定します。希望する他のオプションを指定します。

ダイアログ・ボックスの内容:

圧縮	描画のエクスポート時に使用できる圧縮アルゴリズムのリストです。使用可能な圧縮アルゴリズムは、形式やモニター・タイプによって異なります。希望するアルゴリズムを選択します。
データベース	データベースからインポートするかどうか、またはデータベースにエクスポートするかどうかを指定します。このラジオ・ボタンの隣には、オブジェクト名のフィールドと、データベースに格納したもののリストから選択できる「参照」ボタンがあります。
データ型	イメージをエクスポートするのに指定できるデータ型のリストです（Grayscale、24ビットTrue Colorなど）。
ファイル	ファイルからインポートするかどうか、またはファイルにエクスポートするかどうかを指定します。このラジオ・ボタンの隣には、ファイル名のフィールドと、ファイルに格納したもののリストから選択できる「参照」ボタンがあります。
形式	インポートまたはエクスポートされるイメージに指定できる形式のリストです。形式を1つ選択します。
質	イメージを表示する相対的な解像度です。質が高くなるほど、ファイルが大きくなり、必要な記憶容量が増えます。「Excellent」または「Very Good」、「Good」、「Fair」、「Poor」を選択します。


「カラー・パレット・インポート/エクスポート」ダイアログ・ボックス

説明  「カラー・パレット・インポート/エクスポート」ダイアログ・ボックスでは、カラー・パレットをどのようにインポートまたはエクスポートするかを指定することができます。「データベース」または「ファイル」を選択し、カラー・パレットの名前を入力します。

ダイアログ・ボックスの内容:

データベース	データベースからインポートするかどうか、またはデータベースにエクスポートするかどうかを指定します。このラジオ・ボタンの隣には、オブジェクト名のフィールドと、データベースに格納したもののリストから選択できる「参照」ボタンがあります。
ファイル	ファイルからインポートするかどうか、またはファイルにエクスポートするかどうかを指定します。このラジオ・ボタンの隣には、ファイル名のフィールドと、ファイルに格納したもののリストから選択できる「参照」ボタンがあります。


「日付と時刻を挿入」ダイアログ・ボックス

説明  「日付と時刻を挿入」ダイアログ・ボックスでは、日付または時刻、あるいはその両方のフィールドを、レポート・レイアウトに迅速に追加できます。ダイアログ・ボックスを確定すると、適切な書式マスクを設定したフィールドが、レイアウトの指定した位置に挿入されます。必要であれば、レイアウトの他のフィールドと同様に、そのフィールドを変更できます。

ダイアログ・ボックスの内容:

使用可能な書式	日付と時刻の事前定義済み書式をリストします。このリストから1つ選択するか、または「カスタム」ボタンを使用して独自の書式を作成できます。
カスタム	日付と時刻の独自の書式を定義できる「カスタム日付と時刻」ダイアログ・ボックスを表示します。
日付/時刻を付ける	ぺージ上でフィールドを配置する位置を指定します。フィールドを作成すると、レイアウトの他のオブジェクトと同様に、移動できることに注意してください。


「カスタム日付と時刻」ダイアログ・ボックス

説明  「カスタム日付と時刻」ダイアログ・ボックスでは、レイアウトに挿入する日付および時刻の書式マスクを指定できます。このダイアログ・ボックスを確定すると、「日付と時刻を挿入」ダイアログ・ボックスに戻り、カスタム書式マスクがそのダイアログ・ボックスの「使用可能な書式」リストに追加されます。

ダイアログ・ボックスの内容:

カスタム書式	日付および時刻の書式マスクです。有効な書式マスクが「オプション」の下に表示されます。
例	現行の日付および時刻に適用したとき、「カスタム書式」の書式マスクがどのように見えるかを表示します。「例」に何も表示されない場合は、「カスタム書式」で指定した書式マスクが有効ではないことを意味します。
オプション	「カスタム書式」でマスクを構成するときに使える書式マスクを表示します。このリストは読込み専用です。


「ページ番号を挿入」ダイアログ・ボックス

説明  「ページ番号を挿入」ダイアログ・ボックスでは、レポート・レイアウトにページ番号を迅速に挿入できます。ダイアログ・ボックスを確定すると、適切な設定をしたボイラープレート・テキスト・オブジェクトがレイアウトの指定した位置に挿入されます。必要であれば、レイアウトの他のボイラープレート・オブジェクトと同様に、そのボイラープレート・オブジェクトを変更できます。

ダイアログ・ボックスの内容:

「位置」ドロップダウン・ボックス	ページ上でボイラープレート・オブジェクトを配置する位置を指定します。ボイラープレートを作成すると、ライブ・プレビューアやレイアウト・モデル表示の他のオブジェクトと同様に、移動できることに注意してください。
使用可能な書式	レイアウトに挿入する番号を定義する2つのラジオ・ボタン（「ページ番号のみ」と「ページ番号と合計ページ」）です。「ページ番号のみ」では、ページnを挿入します。nは現行のページ番号です。「ページ番号と合計ページ」では、n/mページを挿入します。nは現行のページ番号、mはレポートの合計ページ数です。


「レイアウト・オプション」ダイアログ・ボックス

説明  「レイアウト・オプション」ダイアログ・ボックスでは、「レイアウト・モデル」の作業環境を定義します。

ダイアログ・ボックスの内容:

  「レイアウト」タブ

  「オプション」タブ


制限

  制限 	  関連項目

説明  「制限」チェックボックスにより、オブジェクトの移動をそれらを囲むオブジェクト（繰返し枠または枠）内に限定するかどうかを指定します。制限モードは、レポートで頻度のエラーを避けるのに非常に便利です。たとえば、「制限」がチェックされると、Report Builderではフィールドを繰返し枠の外に移動することができなくなります。

制限モードに設定すると、Report Builderでは、オブジェクトがコンテナ・オブジェクトの境界線の外に出ないように、次の操作が制限されます。

•	オブジェクトまたはコンテナ・オブジェクトの移動。

•	オブジェクトまたはコンテナ・オブジェクトを他のレイヤーに移動（「配置」 [image] 「最背面へ移動」、「配置」 [image] 「背面へ」、「配置」 [image] 「最前面へ移動」または「配置」 [image] 「前面へ」の使用など）。

•	オブジェクトまたはコンテナ・オブジェクトのサイズ変更。

•	オブジェクトまたはコンテナ・オブジェクトの回転。

•	オブジェクトまたはコンテナ・オブジェクトの境界線のサイズ拡大。

デフォルト

チェック（制限モード）


制限モードの制限;
制限モードの制限

•	次のような場合、オブジェクトは他のオブジェクトの中にあります。

•	オブジェクトがコンテナ・オブジェクトの上のレイヤーにあります。

•	オブジェクトがコンテナ・オブジェクトで完全に囲まれています。

•	オブジェクトが、コンテナ・オブジェクトの外のオブジェクトに明示的にアンカーされていません。

•	制限モードの指定時にオブジェクトが他のオブジェクト内にある場合、そのオブジェクトは、コンテナが変更されない限り、そのコンテナ・オブジェクト内に残ります。制限モードでオブジェクトのコンテナを変更するには、次の方法しかありません。

•	オブジェクトをコンテナの外のオブジェクトに明示的にアンカーします。

•	元のコンテナ内にオブジェクトの新規のコンテナを作成します。

•	制限モードで他のすべてのオブジェクトの外でオブジェクトを作成すると、オブジェクトを中に入れた最初のコンテナ・オブジェクトがそのコンテナになります。たとえば、既存のレイアウトの外にフィールドを作成して、それを繰返し枠内に移動すると、繰返し枠の外に戻せなくなります。フィールドを繰返し枠内に移動すると同時に、その繰返し枠がコンテナ・オブジェクトとなり、フィールドをコンテナの境界線の外に移動することができなくなります。


フィールド表示方法

説明  「フィールド表示方法」ラジオ・ボタンにより、レポート・エディタの「レイアウト・モデル」と「パラメータ・フォーム」でのフィールドの表示方法を指定します。

値

名前	名前が付いたフィールドを表示します。
マスク	書式マスクを設定したフィールドを表示します。
アウトラインのみ	名前またはマスクのないフィールドを表示します。
デフォルト

名前


レイアウト表示方法

説明  「レイアウト表示方法」ラジオ・ボタンにより、レポートのどの範囲をレポート・エディタの「レイアウト・モデル」に表示するかを指定します。

値

ボディ表示	現行のレポート・セクションのボディを表示します。
マージン表示	レポート・セクションの1論理ページにあるすべてのパネルのマージンに囲まれた現行のレポート・セクションのボディを表示します。
デフォルト

ボディ表示


フレックス

  関連項目

説明  「フレックス」チェックボックスにより、オブジェクトの移動またはサイズ変更時に、周りのオブジェクトの移動またはサイズ変更するかどうかを指定します。たとえば、フレックス・モードで親繰返し枠の外にフィールドを移動しようとすると、その繰返し枠はそれが入るように必要に応じて大きくなり、繰返し枠の周りのオブジェクトも必要に応じて大きくなったり、押しやられたりします。

注意: フレックス・モードでは、サイズ変更できるオブジェクトは一度に1つのみです。フレックス・モードで一度に複数のオブジェクトのサイズを変更しようとすると、制御ポイントをクリックしているオブジェクトのサイズのみが変更されます。その他の選択したオブジェクトは、選択が解除されます。また、オブジェクトのサイズ変更は、一度に一方向のみです（垂直または水平のみで、斜めは不可）。

デフォルト

チェックなし


アンカー

説明  「アンカー」により、明示的アンカーを「レイアウト・モデル」に表示するか、非表示にするかを指定します。アンカーが多数あると、他のオブジェクトに集中できるように、非表示にすると便利な場合があります。

デフォルト

チェック


ボイラープレート・アウトライン

説明  「ボイラープレート・アウトライン」により、ボイラープレートおよびチャート・オブジェクトのアウトライン（囲みの枠）を、「レイアウト・モデル」に表示するか、非表示にするかを指定します。

デフォルト

チェック


コメント

説明  「コメント」により、オブジェクトのコメント記号を、レポート・エディタで表示するか、非表示にするかを指定します。

デフォルト

チェック


フィールド・アウトライン

説明  「フィールド・アウトライン」により、フィールドのアウトライン（囲みの枠）を、「レイアウト・モデル」に表示するか、非表示にするかを指定します。

デフォルト

チェック


枠アウトライン

説明  「枠アウトライン」により、枠のアウトライン（囲みの枠）を、「レイアウト・モデル」に表示するか、非表示にするかを指定します。

デフォルト

チェック


非表示フィールド

説明  「非表示フィールド」により、非表示の設定になっているフィールドを表示するか、非表示にするかを指定します。

デフォルト

チェック


アンカー・オブジェクト・アイコンの維持

説明  「アンカー・オブジェクト・アイコンの維持」により、オブジェクトの「アンカー・オブジェクト・アイコンの維持」記号を、「レイアウト・モデル」に表示するか、非表示にするかを指定します。

デフォルト

チェック


名前

説明  「名前」により、オブジェクトの名前を、「レイアウト・モデル」に表示するか、非表示にするかを指定します。

デフォルト

チェックなし


ページ・ブレーク・アイコン

説明  「ページ・ブレーク・アイコン」により、前で改ページまたは後で改ページの設定をしたオブジェクトの改ページ記号を、「レイアウト・モデル」に表示するか、非表示にするかを指定します。

デフォルト

チェック


ページ・プロテクト・アイコン

説明  「ページ・プロテクト・アイコン」により、オブジェクトのページ・プロテクト記号を、「レイアウト・モデル」に表示するか、非表示にするかを指定します。

デフォルト

チェック


 「オブジェクト・ナビゲータ・オプション」ダイアログ・ボックスのオプション

説明  「オブジェクト・ナビゲータ・オプション」ダイアログ・ボックスでは、オブジェクト・ナビゲータの動作を制御します。

ダイアログ・ボックスの内容:

  「一般」タブ

  「レイアウト」タブ


オブジェクト・アイコン表示

説明  「オブジェクト・アイコン表示」により、ノードで表されるオブジェクトのタイプを示すオブジェクト型アイコンの表示を使用可能または不可にします。表示すると、オブジェクト型アイコンはノード名の左側に現れます。

デフォルト

チェック

使用上の注意

•	「オブジェクト・アイコン表示」の選択を解除すると、「ツール」 [image] 「プロパティ・パレット」を使用して、オブジェクト・ナビゲータからプロパティへのアクセスが必要になります。


PL/SQLアイコン表示

説明  「PL/SQLアイコン表示」により、オブジェクトに関係付けられたPL/SQLがあることを示すPL/SQLアイコンの表示を使用可能または不可にします。表示すると、アイコンはノード名の左側に現れます。

デフォルト

チェック

使用上の注意

•	「PL/SQLアイコン表示」は、PL/SQLをサポートするオブジェクトを表すノードにのみ適用されます。ヘッダー・ノードでは、PL/SQLアイコンは表示されません。


アンカー情報

説明  「アンカー情報」により、明示的に他のレイアウト・オブジェクトにアンカーされているレイアウト・オブジェクトのアンカー情報ノードを表示します。アンカー情報ノードには、そのオブジェクトが暗黙的および明示的にアンカーされているオブジェクトのリストが含まれています。

デフォルト

チェックなし


ボタン

説明  「ボタン」により、オブジェクト・ナビゲータでレポート・レイアウトのボタン・オブジェクトを表示します。

デフォルト

チェック


外部ボイラープレート

説明  「外部ボイラープレート」により、オブジェクト・ナビゲータでレポート・レイアウトの外部ボイラープレート・オブジェクトを表示します。

デフォルト

チェック


フィールド

説明  「フィールド」により、オブジェクト・ナビゲータでレポート・レイアウトのフィールドを表示します。

デフォルト

チェック


図形ボイラープレート

説明  「図形ボイラープレート」により、オブジェクト・ナビゲータでレポート・レイアウトの図形ボイラープレート・オブジェクトを表示します。

デフォルト

チェック


イメージ・ボイラープレート

説明  「イメージ・ボイラープレート」により、オブジェクト・ナビゲータでレポート・レイアウトのボイラープレート・イメージを表示します。

デフォルト

チェック


OLE2オブジェクト

説明  「OLE2オブジェクト」により、オブジェクト・ナビゲータでレポート・レイアウトのOLE2オブジェクトを表示します。

デフォルト

チェック


チャート

説明  「チャート」により、オブジェクト・ナビゲータでレポート・レイアウトのチャートを表示します。

デフォルト

チェック


テキスト・ボイラープレート

説明  「テキスト・ボイラープレート」により、オブジェクト・ナビゲータでレポート・レイアウトのボイラープレート・テキスト・オブジェクトを表示します。

デフォルト

チェック


?


「Parameter Form Builder」ダイアログ・ボックス

説明  「Parameter Form Builder」ダイアログ・ボックスでは、ランタイム・パラメータ・フォームに含めるものと、その表示方法を指定できます。「Parameter Form Builder」を使用して、ユーザーが実行時に変更できるパラメータを指定できます。このダイアログ・ボックスを確定すると、ランタイム・パラメータ・フォーム・レイアウトがレポート・エディタの「パラメータ・フォーム」に表示されます。

ダイアログ・ボックスの内容:

ヒント行	ランタイム・パラメータ・フォームのタイトルの下に表示されるヒント行の内容。デフォルトのヒントを確定するか、または80バイトを超えない文字列を入力します。
ラベル	パラメータのラベル（ヘッダー）のリスト。デフォルトのラベルを確定するか、または256バイトを超えない文字列を入力します。
パラメータ	現行レポートのすべてのパラメータのリスト。クリックして選択したパラメータのみが、ランタイム・パラメータ・フォームに挿入されます。最初は、DESNAMEおよびDESTYPE、ユーザー作成のパラメータのみが、ランタイム・パラメータ・フォームに挿入するために選択されています。
ステータス行	ランタイム・パラメータ・フォームのヒント行の下に表示されるステータス行の内容。デフォルトのステータスを確定するか、または80バイトを超えない文字列を入力します。
タイトル	ランタイム・パラメータ・フォームの一番上に表示されるタイトルの内容。デフォルトのタイトルを確定するか、または128バイトを超えない文字列を入力します。
使用上の注意

•	「ヒント」と「タイトル」は、レポート・プロパティで定義されたランタイム・パラメータ・フォームの幅に収めてください。


ランタイム・パラメータ・フォーム

  関連項目

説明  「ランタイム・パラメータ・フォーム」は、レポートを実行するためのパラメータ値を設定できるダイアログ・ボックスです。希望に応じてパラメータを変更し、ツールバーの [image] をクリックして、レポートを実行します。または、ツールバーの [image] をクリックして、実行を取り消します。


?


「書式マスク」ダイアログ・ボックス

  関連項目

説明  「書式マスク」ダイアログ・ボックスでは、フィールドの書式マスク・プロパティとパラメータの入力マスク・プロパティの値リストに、どの書式マスクを表示するかを定義します。それらをクリックしてマスクを選択します。すでに選択されているマスクをクリックすると、選択解除されます。リストのオープン・エリア内でクリックすると、選択されているすべてのマスクが選択解除されます。

ダイアログ・ボックスの内容:

追加	書式マスク・リストに、「マスク」で指定した書式マスクを追加します。「マスク」が指定されていない場合は、このボタンを選択しても何も起こりません。
表示	書式マスク・リストに表示される書式マスクのタイプ（日付または数値）です。
書式マスク	現行の書式マスクのリストです。
マスク	「追加」ボタンを選択したとき、書式マスク・リストに追加されるマスクです。
削除	書式マスク・リストから選択した書式マスクを削除します。マスクがリストで選択されていない場合、このボタンを選択しても何も起こりません。


「接続」ダイアログ・ボックス

説明  「接続」ダイアログ･ボックスでは、Oracleまたは非Oracleデータ・ソースに接続できます。各フィールドに1つずつ入力しても、「ユーザー名」に次の接続文字列をいくつかまとめて入力してもかまいません。

username[/password]

username[/password][@database]

[user[/password]]@ODBC:datasource[:database] or [user[/password]]@ODBC:*

ダイアログ・ボックスの内容:

データベース	接続するデータベースの名前です。256バイトを超えない有効なデータベース文字列を入力します。この値には、ローカル・データベースの名前、リモート・データベースにアクセスするための通信プロトコル、または（非Oracleデータソースにアクセスする場合の）ODBCデータ・ソース名を指定できます。入力する通信プロトコルは、ご使用のオペレーティング・システムによって異なります。詳細は、ご使用のシステムのOracle Net8マニュアルを参照するか、DBAに問い合せてください。
パスワード	本人であることを証明するのに使用される文字列です。30バイトを超えない有効パスワードを入力します。
ユーザー名	データベースに接続するのに使用される名前です。512バイトを超えない有効ユーザー名を入力します。コンピュータへのログインに使用されるユーザー名とは異なる場合があります。


「ページ番号付け」ダイアログ・ボックス

説明  「ページ番号付け」ダイアログ・ボックスでは、「ページ番号」または「パネル番号」、「物理ページ番号」、「総ページ数」、「総パネル数」、「総物理ページ数」の各フィールドでの、ページ番号の計算方法を定義します。

ダイアログ・ボックスの内容:

インクルード	レポートのどのセクションが、レポートのページ番号を計算するのに使用されるかを示します。「ヘッダー」セクション、「メイン」セクションまたは「トレーラ」セクション、あるいはこれらを組合せてチェックできます。デフォルトではすべてのセクションがチェックされており、レポートのすべてのセクションがページ番号の計算に含まれることを意味します。
起動位置	フィールドがフォーマットされる最初のページに使用される1から32,000までの数値です。デフォルトは1で、番号付けは1から始まります。
増分	ページごとに増分される分を指定する1から32,000までの数値です。デフォルトは1で、新規のページごとに1ずつ増加します。
リセット位置	ページ番号を、「起動位置」で指定した初期値にいつリセットするかを指定します。「リセット位置」には、「レポート」とすべての繰返し枠を含む値リストがあります。デフォルトは「レポート」で、ページ番号がレポートの開始時に一度だけ「起動位置」値にリセットされます。繰返し枠が指定されると、ページ番号は、繰返し枠のインスタンスごとに「起動位置」値にリセットされます。


?


「作業環境」ダイアログ・ボックス

説明  「作業環境」ダイアログ・ボックスでは、セッションの作業環境と、現行レポートの実行時設定を設定することができます。

ダイアログ・ボックスの内容:

  「一般」タブ

  「アクセス」タブ

  「ウィザード」タブ

  「ランタイム値」タブ

  「ランタイム設定」タブ


カラー・モード

説明  「カラー・モード」により、レポートのカラー・パレットをシステム上でどのようにインプリメントするかを決定します。異なるレポートをアクティブにするたびに、Report Builderでは、そのレポートのカラー・パレットと一致、またはできる限り近くなるように、使用しているシステムのカラー・パレットを変更します。システムが同時に扱えるカラーの数が限られているため、複数のレポートが異なるカラー・パレットを使用していると、Report Builderではそれらを同時に正確に表示できない場合があります。

値

編集可	Report Builderが、システムのカラー・パレットをアクティブ・レポートのパレットに一時的に置換します。新規レポートをアクティブにするたびに、そのカラー・パレットがシステム・パレットに代わります。これでアクティブ・レポートは正確に表示されますが、アクティブでないレポートの外観は悪くなります。
読込み専用、  個別	レポートをアクティブにするたびに、Report Builderでは、パレットにカラーを入れる余地がなくなるまで、そのレポートのカラー・パレットがシステムの元のパレットに追加されます。そのパレットは、レポートがアクティブなときはいつでも使用できるようになります。これでアクティブ・レポートは正確に表示されますが、アクティブでないレポートの外観は悪くなります。
読込み専用、  共有	Report Builderでは、パレットにカラーを入れる余地がなくなるまで、各アクティブ・レポートのカラー・パレットがシステムの元のパレットに追加されていきます。そのパレットは、すべてのオープン・レポートが共有する共通のパレットになります。まったく異なるカラーを使用するレポートを作成すると、正確に表示されない場合があります。
使用上の注意

•	「書式」 [image] 「レイアウト・オプション」 [image] 「カラー・パレット」を使用するには、「カラー・モード」を「編集可」に設定する必要があります。

•	この作業環境設定は、作成またはオープンする次のレポートから有効になります。


オープン時のレポート・エディタを抑止

説明  「オープン時のレポート・エディタを抑止」チェックボックスにより、レポートのオープン時にレポート・エディタをオープンするかどうかを示します。レポート・エディタを表示しないと、レポートをオープンするスピードが速くなります。

デフォルト

チェックなし

使用上の注意

•	レポート・エディタがオープンしていないときは、「ツール」 [image] 「レポート・エディタ」を選択してレポート・エディタをオープンし、「表示」メニューを選択して表示を変更します。


作成時のプロパティ・パレットを止める

説明  「作成時のプロパティ・パレットを止める」により、レポート・オブジェクトのプロパティを作成時に表示するかどうかを示します。レイアウト・オブジェクトの一部のプロパティは、そのオブジェクトのプロパティ・パレットでしか定義できません（フィールドのソースなど）。別のオブジェクトを作成する前に1つのオブジェクトを完全に定義する場合は、この作業環境をチェックしないほうがよいでしょう。オブジェクトを作成するとただちに完全に定義することができます。最初にプロパティを全部定義しないで、多数のレイアウト・オブジェクトを作成する場合は、この作業環境をチェックしてください。エディタでオブジェクトを作成するたびに、プロパティ・シートが表示されることはありません。

デフォルト

チェック

使用上の注意

•	この設定を使用する場合、一部のオブジェクトでは、一定の設定を行わないと、レポートの生成や実行ができないことを覚えておいてください。たとえば、フィールドと繰返し枠ではソースの指定が必要です。


ダイアログ・ボックス・エントリでのリスト取出しを隠す

説明  「ダイアログ・ボックス・エントリでのリスト取出しを隠す」により、アクションの結果データべース・ダイアログ・ボックスが現れるときに、リストを表示しないようにします。たとえば、「データベースからオープン」ダイアログ・ボックスでは、この作業環境がチェックされていると、モジュール・リストが表示されません。この作業環境を設定すると、データベース・ダイアログ・ボックスを表示する際のパフォーマンスを改善できます。

デフォルト

チェックなし

使用上の注意

•	この作業環境が選択されていても、「取出しリスト」ボタンをクリックすれば、ダイアログからリストを取り出すことができます。


サイズの単位

説明  「長さの単位」により、新規レポートの定義に使用される単位を指定します。（既存のビットマップ・レポートでは、レポート・プロパティ・シートで定義されたサイズの単位を使用します。レポート・プロパティ・シートには、オブジェクト・ナビゲータでレポート・ノードのアイコンをダブルクリックすればアクセスできます。

値

センチメートル

インチ

ポイント	1パイカを構成するプリンタの印字サイズです。1パイカは12ポイントで、1インチの6分の1に相当します。

デフォルト

インチ


アクセス

説明  「アクセス」は、使用しているモジュールのデフォルトの位置を示す一連のラジオ・ボタンです。この作業環境で入力したものは、「オープン」または「別名保存」などを実行するときに、デフォルト情報として使用されます。

値

データベース

ファイル

ファイル/データベース

デフォルト

ファイル/データベース

使用上の注意

•	データベースを指定してからファイルのモジュールにアクセスする必要がある場合は、ファイル・ダイアログ・ボックスにアクセスするために、「アクセス」の設定を「ファイル」に変更することが必要になります。同様に、「ファイル」を指定してからデータベースのモジュールにアクセスする必要がある場合は、データベース・ダイアログ・ボックスにアクセスするために、この作業環境を「データベース」に変更する必要があります。


すべて

説明  「すべて」により、操作にオブジェクト名またはファイル名が必要な場合、Report Builderですべてをオブジェクトまたはファイルのリストに挿入するかどうかを示します。この作業環境に指定した値は、「オープン」ダイアログ・ボックスで表示されます。

デフォルト

チェック


PL/SQLライブラリ

説明  「PL/SQLライブラリ」により、操作にオブジェクト名またはファイル名が必要な場合、Report Builderで外部PL/SQLライブラリをオブジェクトまたはファイルのリストに挿入するかどうかを示します。この作業環境に指定した値は、「オープン」ダイアログ・ボックスで表示されます。

デフォルト

チェックなし


問合わせ
問合せ

説明  「問合せ」により、操作にオブジェクト名またはファイル名が必要な場合、Report Builderで外部問合せをオブジェクトまたはファイルのリストに挿入するかどうかを示します。この作業環境に指定した値は、「オープン」ダイアログ・ボックスで表示されます。

デフォルト

チェックなし


レポート

説明  「レポート」により、操作にオブジェクト名またはファイル名が必要な場合、Report Builderでレポートをオブジェクトまたはファイルのリストに挿入するかどうかを示します。この作業環境に指定した値は、「オープン」ダイアログ・ボックスで表示されます。

デフォルト

チェックなし


テンプレート

説明  「テンプレート」により、操作にオブジェクト名またはファイル名が必要な場合、Report Builderでテンプレートをオブジェクトまたはファイルのリストに挿入するかどうかを示します。この作業環境に指定した値は、「オープン」ダイアログ・ボックスで表示されます。

デフォルト

チェックなし


チャート・ウィザード前置きページ

説明  「チャート・ウィザード前置きページ」では、チャート・ウィザードの起動時に前置きページを表示するかどうかを示します。

デフォルト

チェック


水平差

説明  「水平差」は、Report Builderで、オブジェクトと、デフォルト・レイアウト作成時にそれらが囲むオブジェクトとの間に残される水平スペースの量です。この差を増やすと、「レイアウト・モデル」でレイアウトが読み込みやすくなり、出力で空白が増えます。

値

0以上の任意の数値（小数第四位まで）。スペースの量は、デフォルト・レイアウトの作成に使用される文字サイズの倍数として表されます。たとえば、0.1の「水平差」を指定すると、現行フォントの1文字の10分の1の差を指定することになります。

デフォルト

0.1000

使用上の注意

•	キャラクタ・モードのエミュレーション（レポート・プロパティにある「キャラクタ単位で設計」をチェック）の場合、Report Builderでは「水平差」と「垂直差」で指定した値が使用されます。ただし、キャラクタ・モードのReport Builderでは、「水平差」と「垂直差」は使用されません。その結果、レポートがキャラクタ・モードのReport Builderでどのように表示されるか正確に見たい場合は、「垂直差」と「水平差」を両方とも0に設定する必要があります。


水平中間フィールド

説明  「水平中間フィールド」は、Report Builderで、デフォルト・レイアウトの作成時にフィールド間に残される水平スペースの量です。この差を増やすと、「レイアウト・モデル」でレイアウトが読込みやすくなり、出力でフィールド間の空白が増えます。

値

0以上の任意の数値（小数第四位まで）。スペースの量は、デフォルト・レイアウトの作成に使用される文字サイズの倍数として表されます。たとえば、0.1の「水平中間フィールド」を指定すると、現行フォントの1文字の10分の1の差を指定することになります。

デフォルト

2.0000


レポート・ウィザード前置きページ

説明  「レポート・ウィザード前置きページ」では、レポート・ウィザードの起動時に前置きページを表示するかどうかを指定します。

デフォルト

チェック


垂直差

説明  「垂直差」は、Report Builderで、オブジェクトと、デフォルト・レイアウト作成時にそれらが囲むオブジェクトとの間に残される垂直スペースの量です。この差を増やすと、「レイアウト・モデル」でレイアウトが読込みやすくなり、出力で空白が増えます。

値

0以上の任意の数値（小数第四位まで）。スペースの量は、デフォルト・レイアウトの作成に使用される文字サイズの倍数として表されます。たとえば、0.1の「垂直差」を指定すると、現行フォントの1文字の10分の1の差を指定することになります。

デフォルト

0.1000

使用上の注意

•	キャラクタ・モードのエミュレーション（レポート・プロパティにある「キャラクタ単位で設計」をチェック）の場合、Report Builderでは「水平差」と「垂直差」で指定した値が使用されます。ただし、キャラクタ・モードのReport Builderでは、「水平差」と「垂直差」は使用されません。その結果、レポートがキャラクタ・モードのReport Builderでどのように表示されるか正確に見たい場合は、「垂直差」と「水平差」を両方とも0に設定する必要があります。


垂直中間フィールド

説明  「垂直中間フィールド」は、Report Builderで、デフォルト・レイアウトの作成時にフィールド間に残される垂直スペースの量です。この差を増やすと、「レイアウト・モデル」でレイアウトが読込みやすくなり、出力でフィールド間の空白が増えます。

値

0以上の任意の数値（小数第四位まで）。スペースの量は、デフォルト・レイアウトの作成に使用される文字サイズの倍数として表されます。たとえば、0.1の「垂直中間フィールド」を指定すると、現行フォントの1文字の10分の1の差を指定することになります。

デフォルト

0.0000


Webウィザード前置きページ

説明  「Webウィザード前置きページ」では、Webウィザードの起動時に前置きページを表示するかどうかを示します。

デフォルト

チェックなし


前置きダイアログ

説明  「前置きダイアログ」では、Report Builderの起動時に、前置きダイアログ・ボックスを表示するかどうかを示します。

デフォルト

チェック


ランタイム値

説明  「ランタイム値」により、現行セッション中のレポート実行時に使用される値を指定します。（特定のレポートについてこれらの設定のデフォルト値を永続的に変更するには、そのレポートの定義で適切なパラメータの初期値を更新する必要があります。）

バックグラウンド	BACKGROUND

部数	COPIES

通貨記号	CURRENCY

小数点の記号	DECIMAL

宛先書式	DESFORMAT

宛先名	DESNAME

宛先タイプ	DESTYPE

モード	MODE

印刷方向	ORIENTATION

印刷ジョブ	PRINTJOB

3桁区切り文字	THOUSANDS


ランタイム設定

  制限	  関連項目

説明  「ランタイム設定」により、現行セッション中のレポート実行時に使用される設定を指定します。（特定のレポートについてこれらの設定のデフォルト値を永続的に変更するには、そのレポートの定義で適切なパラメータの初期値を更新する必要があります。)

配列サイズ	ARRAYSIZE

自動コミット	AUTOCOMMIT

空白ページ	BLANKPAGES

バッファ	BUFFERS

エラー・ファイル 	ERRFILE

チャンク長	LONGCHUNK

非ブロック化SQL	NONBLOCKSQL

失敗時	ONFAILURE

成功時	ONSUCCESS

ページ幅x高さ	PAGESIZE

パラメータ･フォーム	PARAMFORM

プロフィール	PROFILE

読込み専用	READONLY

ロール	ROLE

デバッグ実行	RUNDEBUG


ランタイム設定の制限

•	「ランタイム設定」タブで指定した任意の値は、コマンド・ラインで指定した値やレポート定義で保存された初期値よりも優先されます。しかし、ランタイム・パラメータ・フォームから設定を変更することはできます（宛先タイプ、宛先書式、通貨など）。


?


プロパティ・パレット

プロパティ・パレットにより、オブジェクト・ナビゲータおよびレポート・エディタ、テンプレート・エディタで現在選択されているオブジェクトのプロパティにアクセスすることができます。

特定のプロパティのヘルプを見るには、プロパティ・パレットでそのプロパティを選択して[F1]キーを押します。

プロパティ・パレットについて

プロパティ・パレットでの複数選択について

プロパティ・パレットのツールバー・コマンドについて

プロパティ・パレットの表示

プロパティ・パレットのクローズ

プロパティ・パレットを使ったプロパティ設定

例: 複数選択のプロパティ設定

オブジェクトどうしのプロパティの比較


「改名」ダイアログ・ボックス

説明  「改名」ダイアログ・ボックスでは、データベースに格納されたモジュールを改名することができます。

ダイアログ・ボックスの内容:

新規名	現行モジュールに付ける新しい名前です。このフィールドに名前を直接入力します。
旧名	モジュールの現行の名前です。名前を直接入力するか、または値リストから選択することができます（値リストは、自分で所有するモジュールに限られます）。
改名	モジュールを「新規名」で指定した名前に改名するボタンです。
使用上の注意

•	指定する名前がすでに存在する場合、「警告」ダイアログ・ボックスが表示され、希望すれば、別の名前をそのモジュールに指定できます。


「文書アクセス」ダイアログ・ボックス

説明  「文書アクセス」ダイアログ・ボックスでは、現行のモジュールに対する読込み、書込み、実行のアクセス権限を持つすべてのユーザーをリストします。アクセス権限を付与または拒否するには、ユーザーをリストで追加または削除します。

ダイアログ・ボックスの内容:

アクセス・リスト	現行の文書に対する読込み、書込み、実行のアクセス権限を付与されたすべてのユーザーのリストです。
追加	「ユーザー」で指定した名前を「アクセス・リスト」に追加するボタンです。
削除	選択した名前を「アクセス・リスト」から削除するボタンです。
User	「アクセス・リスト」に追加するユーザーの名前です。任意の有効ユーザー名またはPUBLIC（すべてのユーザーにアクセス権限を付与）を入力します。
使用上の注意

•	「アクセス・リスト」のエントリは大文字で表示され、ユーザー名を追加および削除すると、アルファベット順に自動的に配列されます。


「Reports上のレポート」ダイアログ・ボックス

説明  「Reports上のレポート」ダイアログ・ボックスでは、レポートがデータベースに格納されていれば、そのレポートの設定で実行することができます。「Reports上のレポート」は、自分のすべてのレポートを記録し、デバッグするのに便利です。レポートの印刷方向指定のために「縦」または「横」を選択します。ダイアログ・ボックスを確定すると、「Reports上のレポート」のランタイム・パラメータ・フォームが表示されます。必要事項を入力して確定すると、レポートが実行されます。 必要事項を入力して確定すると、レポートが実行されます。

ランタイム・パラメータ・フォームに通常表示されるデフォルト・パラメータに加えて、次のものを指定します。

•	レポート名（ワイルドカードを使用すると、複数のレポートを出力できます）。

•	コメントを挿入するかどうか。

•	PL/SQLを挿入するかどうか。

•	レポート・レベルの情報（ページ幅など）を挿入するかどうか。

•	データ・モデルの情報（問合せ設定など）を挿入するかどうか。

•	パラメータ設定を挿入するかどうか。

•	レイアウト情報（繰返し枠の設定など）を挿入するかどうか。

使用上の注意

•	「Reports上のレポート」をバッチ処理で実行する場合は、RWRUN60を使用してレポートに関するレポートの1つを実行することができます。縦の出力にはsrwdocpb.rdfを、横にはsrwdoclb.rdfを実行します。


「ロール作成」ダイアログ・ボックス

  関連項目

説明 「ロール作成」ダイアログ・ボックスにより、レポート実行時に使用するデータベース・ロールを指定できます。

ダイアログ・ボックスの内容:

ロール名	レポートの実行時に使用するデータベース・ロールの名前。
ロール・パスワード	データベース・ロールを使用する権限の確認に使用される文字列。
確認パスワード	「ロール・パスワード」に入力したものと同じ文字列。確認パスワードは、「ロール・パスワード」に入力したものが正しいことを確認するために使用されます。


「ロール・パスワード」ダイアログ・ボックス

  関連項目

説明 「ロール・パスワード」ダイアログ・ボックスにより、レポートのオープンまたは実行（あるいはその両方）に必要なデータベース・ロールにパスワードを指定できます。

ダイアログ・ボックスの内容:

パスワード	データベース・ロールを使用する権限の確認に使用される文字列。


「ランタイム・トレース設定」ダイアログ・ボックス

説明  「ランタイム・トレース設定」ダイアログ・ボックスでは、レポートの実行中に（もしあれば）どのトレース情報をログ・ファイルに記録するかを指定できます。これらの設定は、RWBLD60で使用可能な実行引数に対応しており、同じ値を使用して指定します。

追加  「配布」チェックボックス

レポートを実行すると、どの配布リストが使用されたかというトレース情報が、「トレース・ファイル」フィールドで指定するファイルに書き込まれます。この情報を使用して、どのセクションがどの宛先に送られたかを調べることができます。

ダイアログ・ボックスの内容:

トレース・ファイル	TRACEFILE
トレース・モード	TRACEMODE
エラー/警告	TRACEOPTS=TRACE_ERR
プロフィール・メッセージ	TRACEOPTS=TRACE_PRF
ブレークポイント	TRACEOPTS=TRACE_BRK
レポート・オブジェクトの処理	TRACEOPTS=TRACE_APP
PL/SQLの実行	TRACEOPTS=TRACE_PLS
SQLの実行	TRACEOPTS=TRACE_SQL
タイムスタンプ	TRACEOPTS=TRACE_TMS
配布	TRACEOPTS=TRACE_DST
すべて	TRACEOPTS=TRACE_ALL
使用上の注意

•	トレース情報は、rdfファイルの実行時にのみ生成されます。repファイルの実行時には、トレースを指定することはできません。


「連結ライブラリ」ダイアログ・ボックス

説明  「連結ライブラリ」ダイアログ・ボックスでは、外部PL/SQLライブラリを自分のレポートに連結することができます。外部ライブラリが連結されると、そのパッケージおよびファンクション、プロシージャを自分のレポート内から参照することができます。

ダイアログ・ボックスの内容:

連結	「ライブラリ」で指定した外部PL/SQLライブラリを連結する。有効なライブラリ名を「ライブラリ」に入力してから、このボタンをクリックします。
元	連結するライブラリのある位置を示す一連のラジオ・ボタン（データベース、ファイル、両方）。連結しているライブラリに適したものを選択します。
ライブラリ	レポートに連結する外部PL/SQLライブラリの名前。有効なライブラリ名を入力するか、または「参照」ボタンをクリックして検索します。


?


「検索と置換」ダイアログ・ボックス

説明  「検索および置換」ダイアログ・ボックスでは、指定した英数字文字列を検索し、任意で別の英数字文字列に置換します。テキストを多く含むフィールド（長いSQL文が入っているフィールドなど）で役立ちます。

ダイアログ・ボックスの内容:

大/小文字区別	検索文字列の文字を、大文字および小文字の区別をして検索するかどうかを示すチェックボックスです。このチェックボックスをチェックしない場合、英文字の大小の区別なく、検索文字列に一致するすべての文字列が検索されます。
置換	一番最後に検索した文字列を「置換文字列」で指定した文字列に変更するボタンです。カーソルが検索結果文字列にない場合は、検索文字列の次のオカレンスを検索して置換します。
すべて置換	すべての検索結果文字列を、置換文字列に（カーソルの位置から検索可能領域の終点まで）置換するボタンです。
正規表現	検索文字列を正規表現として扱うべきかどうかを指定します。このチェックボックスがチェックされていないと、Report Builderでは「検索」フィールドで指定したとおりに検索します。
置換文字列	検索文字列の検索結果と置換する文字列です。
検索	カーソル位置から次の検索結果文字列を検索するボタンです。
検索文字列	検索する文字列です。この文字列を正規表現として扱う場合は、「正規表現」チェックボックスを選択します。


正規表現

正規表現は、次の特殊なワイルドカード文字のいずれかを含むことができる文字列です。

.	任意の1文字を検索する。たとえば、.heではtheとsheが検索されます。
( )	カッコで囲まれたものを検索します。たとえば、(the)ではotherとthenの両方が検索されます。
[ ]	大カッコ内の任意の1文字を検索する。大カッコは論理OR演算子です。たとえば、(t[hr]e)では、otherとtrendを検索します。
	次の2つの文字が大カッコに囲まれている場合、特殊な意味を持ちます。
~	最初の文字に使用すると、大カッコ内の文字または範囲にない文字を検索する。たとえば、(t[~hr]e)では、toeは検索されますが、otherとtheは検索されません。
--	文字の組の間にある場合、その範囲のすべての文字を検索します。たとえば、[A-E]では、文字AおよびB、C、D、Eが検索されます。文字範囲の組は、次のいずれかです。アルファベット順で、最初の文字が2番目の文字より前にある（または同じ）大文字または小文字どうしのアルファベット。最初の数字が2番目の数字よりも小さい（または同じ）数字。
Note:

|	2つの正規表現の間に使用すると、いずれかの正規表現に一致するものがあれば検索します。
\	円マークの次の特殊文字を検索します。たとえば、\*は*が検索されます。円マークは、エスケープ文字です。円マークの次の特殊文字は、特殊文字として扱われません。
	次に、エスケープ文字の特殊な使用方法を示します。
\n	改行文字を検索します。
\t	タブ文字を検索します。
\b	ブランク文字を検索します。
\w	\nまたは\t、\b、\0を検索します。
*	正規表現の0つ以上のインスタンスを検索します。たとえば、(the)*Aでは、AまたはtheA、thetheAが検索されます。
+	正規表現の1つ以上のインスタンスを検索します。たとえば、 (the)+Aでは、theAまたはthetheAが検索されますが、(the)*Aの場合とは異なりAは検索されません。
使用上の注意

•	正規表現の特殊文字の優先順位は、( )、[ ]、連結文字（abcなど）、*、+、~、 、|、.の順です。次に、優先順位がわかるようにいくつかの例を示します。

Start|Finishは、(Start)|(Finish)と等価です。

Start*は、(Start)*と等価です。

Start|Finish*は、(Start)|((Finish)*)と等価です。

•	大カッコ内ではエスケープ文字を使用できます。たとえば、[\*\+]を入力すると、*または+が検索されます。


?


Webウィザード: 前置きページ

  関連項目

Webウィザードについて

Webウィザードを使用すると、既存のレポートからHTMLまたはPDF出力フォームを迅速かつ簡単に生成できます。Report Builderでは、ウィザードの各ページで指定するものを使用して、HTMLまたはPDF出力の生成方法を決めます。

Webウィザードでのナビゲート

Webウィザードには、ページを移動するために有効な5つのボタンが付いています。

•	取消—加えた変更（ある場合）をすべて取り消し、ウィザードを終了します。

•	ヘルプ—ウィザードの現行ページのオンライン・ヘルプ・テキストを表示します。

•	戻る—ウィザードの前のページに移動します。

•	次へ—ウィザードの次のページに移動します。

•	終了—ウィザードで加えた変更（ある場合）を保存し、ウィザードを終了します。


Webウィザード: チャート・ハイパーリンク・ページ

  関連項目

1	「使用可能なチャート」リストの列をクリックします。

2	をクリックして、チャートを「チャート」リストに移動します。

3	ステップ1と2を繰り返し、チャート・ハイパーリンクを追加します。

4	（オプション）  「チャート」リストからチャートを削除するには、チャートをクリックし、 [image] をクリックします。


Webウィザード: アウトライン・ページ

  関連項目

1	「使用可能な列」リストから列を選択します。

2	をクリックして列を「ブックマーク」リストに移動します。これで、この列の各インスタンスがHTML出力またはPDF出力のブックマークになります。

3	ブックマークとして使用するすべての列について、ステップ1と2を繰り返します。

4	（オプション）「ブックマーク」リストから列を削除するには、列をクリックし、 [image] をクリックします。


Webウィザード: HTMLヘッダー/フッター・ページ

  関連項目

HTML出力のヘッダーまたはフッターとしてHTMLファイルの名前を入力するか、または「参照」をクリックしてファイルを選択します。


Webウィザード: 終了ページ

  関連項目

次のいずれかのラジオ・ボタンを選択します。

•	「すぐにHTMLに出力」または「すぐにPDFに出力」を選択すると、Report BuilderではHTMLまたはPDFファイルが生成されます。これによって、WebブラウザまたはPDFビューアに出力ファイルを表示できます。

•	「Report Builderに戻る」を選択すると、ウィザードで行った変更（ブックマークまたはヘッダー/フッター・ファイルなど）は、ウィザードを再実行しなくても、後でHTMLまたはPDF出力を生成できるように、レポート定義に保存されます。

レポート出力をデフォルトのWebブラウザで自動的に生成するには、「Webブラウザに出力」チェックボックスをチェックします。「Report Builderに戻る」ラジオ・ボタンを選択した場合、このオプションは使用できません。


「Report Builderへようこそ」ダイアログ・ボックス

説明  「Report Builderへようこそ」ダイアログ・ボックスを使えば、Report Builderの起動時に行う初期作業を簡単に選択できます。リストから作業を1つ選択し、ダイアログ・ボックスを適用します。

ダイアログ・ボックスの内容:

レポート・ウィザードを使う	Report Builderでユーザーは、レポート・ウィザードを使って、新規レポートを作成します。レポート・ウィザードの指示に従って、新規レポートを作成します。
新規レポートを手動で作成	Report Builderでは、オブジェクト・ナビゲータに新規レポート・ノードを作成し、レポート・エディタのデータ・モデル表示をオープンします。
既存レポートをオープン	Report Builderでは、ダイアログを介してレポートをオープンします。表示されるダイアログは、アクセス作業環境に指定したものによって異なります。レポートを選択すると、Report Builderによってそのレポートがオープンされます。
起動時に表示	「Report Builderへようこそ」ダイアログ・ボックスが、Report Builderの起動時に表示されるかどうかを指定します。今後このダイアログを表示しないようにするには、このチェックボックスをチェックしないでください。この作業環境は、作業環境ファイルに保存されます。
キュー・カードを参照（タスク）	Report Builderでキュー・カードをオープンします。キュー・カードは、Report Builderの最も基本的な作業を実行するためのステップを説明します。
クイック・ツアーを実行 （コンセプト）	Report Builderでクイック・ツアーをオープンします。クイック・ツアーは、Report Builderについて説明する、オンラインのマルチメディア・プレゼンテーションです。
使用上の注意

•	「起動時に表示」をチェックしなかった場合、「Report Builderへようこそ」ダイアログ・ボックスを再表示するには、「ツール」 [image] 「作業環境」を選択します。「ウィザード」タブをクリックします。次に、「前置きダイアログ」の作業環境をチェックします。

•	レポートをコマンド・ライン上で指定すると、「Report Builderへようこそ」ダイアログ・ボックスは表示されず、かわりにレポートがオープンされ、オブジェクト・ナビゲータが表示されます。


「新規レポート」ダイアログ・ボックス

説明  「新規レポート」ダイアログ・ボックスでは、レポートの作成に使用する方法（レポート・ウィザードを使用する方法または手動の方法）を選択できます。

ダイアログ・ボックスの内容:

レポート・ウィザードを使用する	Report Builderでユーザーは、レポート・ウィザードを使って、新規レポートを作成します。レポート・ウィザードの指示に従って、新規レポートを作成します。
新規レポートを手動で作成	Report Builderでは、オブジェクト・ナビゲータに新規レポート・ノードを作成し、レポート・エディタのデータ・モデル表示をオープンします。


「Report Builderについて」ダイアログ・ボックス

説明  「Report Builderについて」ダイアログ・ボックスには、使用しているReport Builderのバージョン情報と著作権の注意が含まれています。


「PL/SQLブレーク情報」ダイアログ・ボックス

説明  「PL/SQLブレーク情報」ダイアログ・ボックスでは、PL/SQLでSRW.BREAKを使って、ブレークポイントをいつ設定したかを表示します。レポートでそのブレークポイントに達すると、その時点の変数の値がこのダイアログ・ボックスに表示されます。「続行」ボタンをクリックし、レポートの実行を再開します。


レポート・ウィザード: 前置きページ

レポート・ウィザードについて

レポート・ウィザードを使用すれば、単一の問合せレポートを迅速かつ容易に定義することができます。Report Builderでは、ウィザードの各ページで指定するものを使用して、レポートのデータ・モデルとレイアウトが作成されます。ウィザードで作成したレポートは、他のレポートと同様に変更できます。

レポート・ウィザードは再実行可能

レポート・ウィザードの強力な点は、再実行可能モードで操作できます。つまり、レポート・ウィザードを使用して、既存の単一または複数の問合せレポートを変更できます。レポート・ウィザードは、既存のレポート上で使用しているときはタブごとに分けられて、どのページもすぐに表示できるようになっています。

再実行可能モードでレポート・ウィザードを起動するには、既存のレポートをオープンして、「ツール」 [image] 「レポート・ウィザード」を選択します。

レポート・ウィザードでのナビゲート

レポート・ウィザードには、ページを移動するために有効な6つのボタンがあります。

•	取消—加えた変更（ある場合）をすべて取り消し、ウィザードを終了します。

•	ヘルプ—ウィザードの現行ページのオンライン・ヘルプ・テキストを表示します。

•	戻る—ウィザードの前のページに移動します。

•	次へ—ウィザードの次のページに移動します。

•	適用—加えた変更を適用します（再実行可能ウィザードのみ）。

•	終了—ウィザードで加えた変更（ある場合）を保存し、ウィザードを終了します。

注意: 特定のウィザード・ページに必要な情報をすべて入力し終える前に「次へ」をクリックすると、ウィザードでは次のページに移動できなくなります。同様に、必要な情報をすべてウィザードに入力しないで「適用」または「終了」をクリックすると、ウィザードでは自動的にそのページに切り替わり、必要なデータを入力し終えることができます。


レポート・ウィザード: スタイル・ページ

  レポート・ウィザードについて

1	（オプション）レポートのタイトルをタイトル･フィールドにタイプします。このタイトルは、レポートのマージン領域に表示されます。

2	次のレポート・スタイルの1つを選択します。

表レポートについて

フォーム形式レポートについて

メール・ラベル・レポートについて

フォーム・レター・レポートについて

グループ左レポートについて

グループ上レポートについて

マトリックス・レポートについて

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

使用上の注意

•	Expressへの問合せを使用してレポートを生成する場合は、通常、マトリックスまたはグループ別マトリックス・レポート・スタイルを選択する必要があります。

•	既存レポートのレポート・スタイルを変更すると、Report Builderでは集計計算が新規のレポート・スタイルで保存されます。異なるデータ・モジュールを必要なレポート・スタイル間で切り替える場合（表からマトリックスへなど）、Report Builderでは既存の集計計算を新規のレポート・スタイルに正確にマップできないことがあります。


レポート・ウィザード: タイプ・ページ

作成する問合せのタイプを選択します。

•	SQL文は、リレーショナル・データベース（Oracle8など）からデータを選択する問合せを作成することを意味します。

•	Expressへの問合せは、OLAP Serverからデータを選択する問合せを作成することを意味します。


レポート・ウィザード: データ・ページ

  関連項目      [image]  レポート・ウィザードについて

1	データベースに接続していなければ「接続」をクリックし、「接続」ダイアログ・ボックスに必要事項を入力します。

2	次のいずれかの方法でSELECT文を指定します。

•	「SQL問合せ文」領域にSELECT文を入力します。

•	「Query Builder」をクリックし、「Query Builder」のダイアログを使用して問合せを定義します。Query Builderによる問合せの作成を終了すると、SELECT文が「SQL問合せ文」領域に表示されます。

•	「SQL問合せインポート」をクリックして、ファイルに格納されているSELECT文を取得します。「インポート」ダイアログ・ボックスをクローズすると、選択したファイルの内容が「SQL問合せ文」領域に置かれます。


レポート・ウィザード: グループ・ページ

  レポート・ウィザードについて	  関連項目

「表示グループ」リストのグループが希望どおりで、希望する「印刷方向」（「下」または「下/右」、「右/下」、「右」、「マトリックス」）に設定されている場合は、

  「次へ」をクリックします。

「表示グループ」リストのグループの「印刷方向」を変更する場合:

1	「表示グループ」リストのグループを1つ選択します。

2	をクリックします。

3	そのグループに適用する「印刷方向」に該当するボタンをクリックします。

4	「表示グループ」リストにあるグループがすべて修正されるまで、ステップ1から3を繰り返します。ヒント

使用上の注意

•	2つの列を同じブレーク・レベルに置く場合は、「グループ・フィールド」リストの列を最初にクリックし、次に「使用可能フィールド」リストから列を移動します。「使用可能フィールド」リストから移動した列は、選択された列と同じブレーク・レベルに自動的に配置されます。新しいブレーク・レベルを作成する場合は、「使用可能フィールド」リストの列をクリックし、「グループ・フィールド」リストのブレーク・レベルをクリックします。次に、「使用可能フィールド」リストから列を移動します。列は選択したブレーク・レベルの下にある新しいブレーク・レベルに自動的に配置されます。

•	現時点では、一部のOracle8データ型がサポートされていません。サポートされていないOracle8データ型が問合せによって選択されると、ウィザード内でそのデータ型が不明であることが [image] によって識別されます。

•	列オブジェクトと参照列は、ブレーク列にはなりません。したがって、「使用可能フィールド」リストでこれらの列は選択できません。

•	「グループ・フィールド」リストの属性列は、アンダースコア記号を使用してその親子関係を示します（ADDRESS_ZIPなど）。


レポート・ウィザード: グループ・ページ

  レポート・ウィザードについて	  関連項目

1	「使用可能フィールド」リストで、グループ・フィールドにするフィールドをクリックします。

2	 をクリックして、そのフィールドを「マトリックス・グループ・フィールド」リストに移動します。フィールドのブレーク・レベルを定義する行が、その上に表示されます。

3	レポートに入れるすべてのフィールド・グループについて、ステップ1と2を繰り返します。

4	（オプション）「グループ・フィールド」リストのフィールドをクリックし、希望するブレーク・レベルまでドラッグします。

5	（オプション）「グループ・フィールド」リストからフィールドを削除するには、それをクリックしてから [image] をクリックします。

使用上の注意

•	2つの列を同じブレーク・レベルに置く場合は、「グループ・フィールド」リストの列を最初にクリックし、次に「使用可能フィールド」リストから列を移動します。「使用可能フィールド」リストから移動した列は、選択された列と同じブレーク・レベルに自動的に配置されます。新しいブレーク・レベルを作成する場合は、「使用可能フィールド」リストの列をクリックし、「グループ・フィールド」リストのブレーク・レベルをクリックします。次に、「使用可能フィールド」リストから列を移動します。列は選択したブレーク・レベルの下にある新しいブレーク・レベルに自動的に配置されます。

•	現時点では、一部のOracle8データ型がサポートされていません。サポートされていないOracle8データ型が問合せによって選択されると、ウィザード内でそのデータ型が不明であることが [image] によって識別されます。

•	列オブジェクトと参照列は、ブレーク列にはなりません。したがって、「使用可能フィールド」リストでこれらの列は選択できません。

•	「グループ・フィールド」リストの属性列は、アンダースコア記号を使ってその親子関係を示します（ADDRESS_ZIPなど）。


レポート・ウィザード: フィールド・ぺージ

  レポート・ウィザードについて	  関連項目

1	「使用可能フィールド」リストのフィールドをクリックします。ヒント

2	 をクリックして、そのフィールドを「表示フィールド」リストに移動します。ヒント

3	レポートに表示するすべてのフィールドについて、ステップ1と2を繰り返します。

4	（オプション）「表示フィールド」リストからフィールドを削除するには、それをクリックしてから [image] をクリックします。

使用上の注意

•	現時点では、一部のOracle8データ型がサポートされていません。サポートされていないOracle8データ型が問合せによって選択されると、ウィザード内でそのデータ型が不明であることが [image] によって識別されます。

•	列オブジェクトまたは参照列を「使用可能フィールド」リストから「表示フィールド」リストに移動すると、そのすべての属性列は「表示フィールド」リストに移動され、列オブジェクトまたは参照列は非表示になります。列オブジェクトはレイアウト・オブジェクトのソースにはならないため、「表示フィールド」リストからは除外されます。「表示フィールド」リストの属性列は、アンダースコア記号を使用してその親子関係を示します（ADDRESS_ZIPなど）。


レポート・ウィザード: 合計ページ

  レポート・ウィザードについて      [image]  関連項目

1	「使用可能フィールド」リストのフィールドをクリックします。

2	そのフィールドに適用するファンクションに該当するボタンをクリックします。フィールドとファンクション名のエントリが、「合計」リストに表示されます。

3	そのフィールドに適用する他のファンクションについても、ステップ2を繰り返します。

4	希望するすべての合計が作成されるまで、ステップ1から3を繰り返します。

5	（オプション）「合計」リストからフィールドを削除するには、それをクリックしてから左矢印 [image] ボタンをクリックします。

使用上の注意

•	現時点では、一部のOracle8データ型がサポートされていません。サポートされていないOracle8データ型が問合せによって選択されると、ウィザード内でそのデータ型が不明であることが [image] によって識別されます。

•	列オブジェクトまたは参照列に対して実行できるファンクションは限られています。したがって、「使用可能フィールド」リストでこれらの列を選択すると、一部のファンクションは使用不可の状態になります。

•	レポート・ウィザードとデータ・ウィザードは、グループ・レポートに対し、ユーザーが定義する各サマリー列のデータ・モデル内にn個のサマリー・フィールドを作成します。集計中の列の上にあるグループ・レベルごとに1つ、およびレポート・レベルに1つ作成します。たとえば、レポートが部署別にグループ分けされ、さらに課別にグループ分けされる場合、給与合計について定義されたサマリー列によって、各部署および各課グループの給与小計（グループ・レベル・サマリー）および全給与の小計（レポート・レベル・サマリー）のフィールドが作成されます。


レポート・ウィザード: テキスト・ページ

  レポート・ウィザードについて

1	「使用可能フィールド」リストのフィールドをクリックします。

2	 をクリックして、そのフィールドを「メール・ラベル・テキスト」領域に置きます。

3	適切なボタン（「新規行」または「スペース」、「線種」、「コンマ」、「ピリオド」）をクリックして、希望する間隔または句読点を追加します。

4	希望するすべてのフィールドが「メール・ラベル・テキスト」領域に入るまで、ステップ1から3を繰り返します。

5	（オプション）「メール・ラベル・テキスト」領域でクリックし、希望どおりにテキストを編集します。


レポート・ウィザード: テキスト・ページ

  レポート・ウィザードについて

1	「使用可能フィールド」リストのフィールドをクリックします。

2	 をクリックして、そのフィールドを「フォーム・レター・テキスト」領域に置きます。

3	適切なボタン（「新規行」または「スペース」、「線種」、「コンマ」、「ピリオド」）をクリックして、希望する間隔または句読点を追加します。

4	希望するすべてのフィールドが「フォーム・レター・テキスト」領域に入るまで、ステップ1から3を繰り返します。

5	（オプション）「フォーム・レター・テキスト」領域でクリックし、希望どおりにテキストを編集します。


レポート・ウィザード: グループ・ページ

  レポート・ウィザードについて

「マトリックス・グループ・フィールド」リストのフィールドが希望どおりの場合は、

  「次へ」をクリックします。

「マトリックス・グループ・フィールド」リストのフィールドを変更するには:

1	「使用可能フィールド」リストで、マトリックス・グループ・フィールドにするフィールドをクリックします。

2	 をクリックして、そのフィールドを「マトリックス・グループ・フィールド」リストに移動します。フィールドのブレーク・レベルを定義する行が、その上に表示されます。

3	レポートに入れるすべてのマトリックス・グループ・フィールドについて、ステップ1と2を繰り返します。

4	（オプション）「マトリックス・グループ・フィールド」リストのフィールドを選択し、希望するブレーク・レベルまでドラッグします。

5	（オプション）「マトリックス・グループ・フィールド」リストからフィールドを移動するには、それをクリックしてから [image] をクリックします。

使用上の注意

•	2つの列を同じブレーク・レベルに置く場合は、「マトリックス・グループ・フィールド」リストの列を最初にクリックし、次に「使用可能フィールド」リストから列を移動します。「使用可能フィールド」リストから移動した列は、選択された列と同じブレーク・レベルに自動的に配置されます。新しいブレーク・レベルを作成する場合は、「使用可能フィールド」リストの列をクリックし、「マトリックス・グループ・フィールド」リストのブレーク・レベルをクリックします。次に、「使用可能フィールド」リストから列を移動します。列は選択したブレーク・レベルの下にある新しいブレーク・レベルに自動的に配置されます。

•	現時点では、一部のOracle8データ型がサポートされていません。サポートされていないOracle8データ型が問合せによって選択されると、ウィザード内でそのデータ型が不明であることが [image] によって識別されます。

•	列オブジェクトと参照列は、ブレーク列にはなりません。したがって、「使用可能フィールド」リストでこれらの列は選択できません。

•	「マトリックス・グループ・フィールド」リストの属性列は、アンダースコア記号を使用してその親子関係を示します（ADDRESS_ZIPなど）。


レポート・ウィザード: 行ページ

  レポート・ウィザードについて	  関連項目

1	「使用可能フィールド」リストのフィールドをクリックします。

2	 をクリックして、そのフィールドを「マトリックス行フィールド」リストに移動します。フィールドのブレーク・レベルを定義する行が、その上に表示されます。ヒント

3	希望するすべてのマトリックス行フィールドについて、ステップ1と2を繰り返します。

4	（オプション）「マトリックス行フィールド」リストからフィールドを削除するには、それをクリックしてから [image] をクリックします。

使用上の注意

•	現時点では、一部のOracle8データ型がサポートされていません。サポートされていないOracle8データ型が問合せによって選択されると、ウィザード内でそのデータ型が不明であることが [image] によって識別されます。

•	列オブジェクトと参照列は、マトリックス行フィールドとして使用できません。したがって、「使用可能フィールド」リストでこれらの列は選択できません。

•	「マトリックス行フィールド」リストの属性列は、アンダースコア記号を使用してその親子関係を示します（ADDRESS_ZIPなど）。


レポート・ウィザード: 列ページ

  レポート・ウィザードについて	  関連項目

1	「使用可能フィールド」リストのフィールドをクリックします。

2	 をクリックして、そのフィールドを「マトリックス列フィールド」リストに移動します。フィールドのブレーク・レベルを定義する行が、その上に表示されます。ヒント

3	希望するすべてのマトリックス列フィールドについて、ステップ1と2を繰り返します。

4	（オプション）「マトリックス列フィールド」リストからフィールドを移動するには、それをクリックしてから [image] をクリックします。

使用上の注意

•	現時点では、一部のOracle8データ型がサポートされていません。サポートされていないOracle8データ型が問合せによって選択されると、ウィザード内でそのデータ型が不明であることが [image] によって識別されます。

•	列オブジェクトと参照列は、マトリックス行フィールドとして使用できません。したがって、「使用可能フィールド」リストでこれらの列は選択できません。

•	「マトリックス行フィールド」リストの属性列は、アンダースコア記号を使用してその親子関係を示します（ADDRESS_ZIPなど）。


レポート・ウィザード: セル・ページ

  レポート・ウィザードについて	  関連項目

1	「使用可能フィールド」リストのフィールドをクリックします。

2	そのフィールドに適用するファンクションに該当するボタンをクリックします。フィールドとファンクション名のエントリが、「マトリックス（セル）・フィールド」リストに表示されます。ヒント

3	希望するすべてのマトリックス（セル）・フィールドについて、ステップ1と2を繰り返します。

4	（オプション）「マトリックス（セル）・フィールド」リストからフィールドを削除するには、それをクリックしてから [image] をクリックします。

使用上の注意

•	現時点では、一部のOracle8データ型がサポートされていません。サポートされていないOracle8データ型が問合せによって選択されると、ウィザード内でそのデータ型が不明であることが [image] によって識別されます。

•	列オブジェクトと参照列は、マトリックス・セル・フィールドとして使用できません。したがって、「使用可能フィールド」リストでこれらの列は選択できません。

•	「マトリックス・セル・フィールド」リストの属性列は、アンダースコア記号を使用してその親子関係を示します（ADDRESS_ZIPなど）。


レポート・ウィザード: 合計ページ

  レポート・ウィザードについて	  関連項目

1	「使用可能フィールド」リストのフィールドをクリックします。

2	そのフィールドに適用するファンクションに該当するボタンをクリックします。フィールドとファンクション名のエントリが、「マトリックス合計」リストに表示されます。

3	そのフィールドに適用する他のファンクションについても、ステップ2を繰り返します。

4	希望するすべての合計が作成されるまで、ステップ1から3を繰り返します。

5	（オプション）「マトリックス合計」リストからフィールドを削除するには、それをクリックしてから [image] をクリックします。

使用上の注意

•	現時点では、一部のOracle8データ型がサポートされていません。サポートされていないOracle8データ型が問合せによって選択されると、ウィザード内でそのデータ型が不明であることが [image] によって識別されます。

•	列オブジェクトまたは参照列に対して実行できるファンクションは限られています。したがって、「使用可能フィールド」リストでこれらの列を選択すると、一部のファンクションは使用不可の状態になります。

•	レポート・ウィザードとデータ・ウィザードは、グループ・レポートに対し、ユーザーが定義する各サマリー列のデータ・モデル内にn個のサマリー・フィールドを作成します。集計中の列の上にあるグループ・レベルごとに1つ、およびレポート・レベルに1つ作成します。たとえば、レポートが部署別にグループ分けされ、さらに課別にグループ分けされる場合、給与合計について定義されたサマリー列によって、各部署および各課グループの給与小計（グループ・レベル・サマリー）および全給与の小計（レポート・レベル・サマリー）のフィールドが作成されます。


レポート・ウィザード: ラベル・ぺージ

  レポート・ウィザードについて

1	「ラベル」ヘッダーの下にある任意のラベル・テキストをクリックします。

2	レポート出力で表示する形に、テキストを編集します。

3	すべてのラベルが希望どおりになるまで、ステップ1と2を繰り返します。

4	「幅」ヘッダーの下にある任意の数値をクリックします。

5	その数値を、関係付けられたフィールドに対して希望する幅に変更します。ヒント

6	すべての幅が希望どおりになるまで、ステップ4と5を繰り返します。


レポート・ウィザード: テンプレート・ぺージ

  レポート・ウィザードについて	  次のステップ

1	「事前定義テンプレート」、「テンプレート・ファイル」、「テンプレートなし」の3つのラジオ・ボタンから1つを選択します。

2	ステップ1で選択したものに応じて、次の作業を行います。

•	「事前定義テンプレート」の場合、リストからテンプレートを選択します。

•	「テンプレート・ファイル」の場合、tdf ファイルの名前を入力するか、または「参照」をクリックして選択します。

•	「テンプレートなし」の場合、必要なアクションはありません。


レポート・ウィザード: 終了ページ

  レポート・ウィザードについて

次に行うこと

これで、レポート・ウィザードを終了して、レポート上で作業を続ける準備ができました。「終了」をクリックすると、Report Builderではレポート・ウィザードがクローズされ、Report Builderの設計ツールの1つであるライブ・プレビューアにレポートが自動的に表示されます。現プレビューアでレポートを変更することも、あるいは「ツール」 [image] 「レポート・ウィザード」を選択してウィザードに戻り、さらに変更を加えることもできます。レポート作成の詳細は、オンライン・ヘルプを参照してください。

1	Report Builderの簡単な概要は、クイック・ツアーを参照します。

•	「ヘルプ」 [image] 「クイック・ツアー」を選択します。

2	最も一般的な作業の実行方法を学習するには、キュー・カードを参照します。

•	「ヘルプ」 [image] 「キュー・カード」を選択します。

3	オンライン・マニュアルにアクセスします。

•	「ヘルプ」 [image] 「マニュアル」を選択します。

4	「ヘルプ・トピック」を検索します。

•	目次および索引の表の場合、「ヘルプ」 [image] 「ヘルプ・トピック」を選択します。

•	状況判断ヘルプを参照するには、[Help]キー（ほとんどのプラットフォームでは通常[F1]キー）を押します。


グループ・フィールド

グループ・フィールドは、レポートのデータをマスターとディテール（親と子ともいいます）に分割するのに使用されます。グループ・フィールドはマスター・グループに表示され、マスター・グループの各レコードには、対応するディテール・レコードが取り出されます。


マトリックス・グループ・フィールド

マトリックス・グループ・フィールドは、レポートのデータをマスターとディテール（親と子ともいいます）に分割するのに使用されます。マトリックス・グループ・フィールドはマスター・グループに表示され、マスター・グループの各レコードには、対応するディテール・レコードが取り出され、マトリックスとしてフォーマットされます。


マトリックス行フィールド

マトリックス行フィールドの値は、マトリックスの左に表示されます。


マトリックス列フィールド

マトリックス列フィールドの値は、マトリックスの一番上に表示されます。


ヒント

をクリックして、「使用可能フィールド」リストにあるすべての列を「表示フィールド」リストに移動します。 をクリックして、「表示フィールド」リストにあるすべての列を「使用可能フィールド」リストに移動します。


ヒント

「グループ・フィールド」リストが空の場合は、レポートのブレークを定義するために現在選択されているグループ・リストがないということです。ウィザードの別のページに進む前に、「グループ・フィールド」リストに少なくとも1つのフィールドが必要です。「グループ・フィールド」にフィールドがない場合、「戻る」または「次へ」をクリックしたり、タブを選択したりすると、エラーが発生します。


ヒント

「表示フィールド」リストが空の場合は、レポート出力に表示するために現在選択されているフィールドがないということです。ウィザードの別のページに進む前に、「表示フィールド」リストに少なくとも1つのフィールドが必要です。「表示フィールド」にフィールドがない場合、「戻る」または「次へ」をクリックしたり、タブを選択したりすると、エラーが発生します。


ヒント

「表示グループ」リストにあるグループのみが、レポート出力に表示されます。


ヒント

Report Builderでは、データベースからレポートの問合せで指定したすべての列を取り出しますが、レポートの出力で実際に表示されるのは、「表示フィールド」リストに表示されるもののみです。


ヒント

レベル1のマトリックス行フィールドは、マトリックスの左に最も外側の行として表示されます。レベル2のフィールドはレベル1のフィールドの右側に、レベル3のフィールドはレベル2のフィールドの右側に、というように表示されます。


ヒント

レベル1のマトリックス列フィールドは、マトリックスの一番上に最も外側の列として表示されます。レベル2のフィールドはレベル1のフィールドの下に、レベル3のフィールドがレベル2のフィールドの下に、というように表示されます。


ヒント

ファンクションをフィールドに適用しない場合は、 [image] を使用して、ファンクションを適用せずに、そのフィールドを「マトリックス（セル）・フィールド」リストに置きます。これは、問合せがフィールドのソース列上でファンクション（SUM(SAL)など）をすでに実行している場合に便利で、別のファンクションをそのフィールドに適用する必要はありません。


ヒント

幅は、文字単位（10は10字の幅など）で指定されます。


?


データ・モデル

  関連項目

データ・モデルは、レポートで使用するデータを定義する作業領域です。データ・モデル・オブジェクト（問合せ、グループ、列、パラメータおよびリンク）を作成、定義および変更します。

Report Builderでは、データ・モデルを使用して、レポートに取り出すデータを判断します。これにより、データベースから取り出されるデータが、レポートに表示されるかどうかが決まります。

アクセス

ペイント領域

オブジェクト表現

定規

格子表示

ツールバー

ツール・パレット

ステータス・バー


説明

データ・モデルは、レポートで使用するデータを定義する作業領域です。データ・モデル・オブジェクト（問合せ、グループ、列、パラメータおよびリンク）を作成、定義および変更します。

Report Builderでは、データ・モデルを使用して、レポートに取り出すデータを判断します。これにより、データベースから取り出されるデータが、レポートに表示されるかどうかが決まります。


アクセス

データ・モデルにアクセスするには、次のような方法があります。

•	「データ・モデル」ツールをクリックします。

•	「表示」 [image] 「データ・モデル」を選択します。

•	「ウィンドウ」メニューから、データ・モデルが入っているウィンドウを選択します。

•	オブジェクト・ナビゲータで、「データ・モデル」ノード・アイコンをダブルクリックします。


ペイント領域

ペイント領域は、画面上のグラフィカル表示を見ながら、オブジェクトを作成または変更、配置、削除できる領域です。オブジェクトは、エディタでグラフィカルに表示されたデータ・モデル内でのみ、相対的に位置づけられます。オブジェクトの設定を参照するには、オブジェクトをダブルクリックして、プロパティ・シートをオープンする必要があります。


オブジェクト表現

ペイント領域で作成できるデータ・モデル・オブジェクトには、問合せ、グループ、列（サマリーおよび式）、パラメータおよびリンクが含まれます。データ・モデル・オブジェクトを切り取り、コピーまたは貼り付けすることはできません（つまり、「編集」メニューで、「カット」、「コピー」、「ペースト」および「複製」は使用不可になっています）。

データ・モデルのグループ階層は、親子リレーションまたはエディタ内の位置によって決まります。2つのグループ間で親子リレーションがない場合（たとえば、同位項目であるか、または関係付けられていないグループである場合）、階層はデータ・モデルで、まず左から右、次に上から下の順に読み込まれます。列の階層は、各グループ内で上から下へ読み込まれます。

「デフォルト・レイアウト」ダイアログ・ボックスのグループおよび列は、データ・モデルのグループおよび列の階層に従って順序付けられます。同様に、「デフォルト・レイアウト」ダイアログ・ボックスのグループおよび列の順序によって、デフォルト・レイアウトでオブジェクトを表示する順序が決定します。


定規

定規は、ペイント領域の左の枠と上の枠に配置されています。初めは、データ・モデルには定規は表示されません。定規を表示するには、「表示」 [image] メニューの「定規」を選択します。

マーカー  マーカーは、ペイント領域内のカーソル位置に従って左端および上端の2つの定規の上を移動します。定規は、ペイント領域に沿ってスクロールします。また、ペイント領域の一部を拡大すると、定規もそれに伴って拡大します。

定規ガイド  定規ガイドによって、オブジェクトの作成および変更の際の参照点が示されます。定規ガイドを作成するには、定規の1つをクリックし、ペイント領域にドラッグします。定規ガイドを表示するには、「表示」 [image] 「定規ガイド」を選択します。


格子表示

ペイント領域の内側は、ペイント領域内のオブジェクトの位置がわかるように格子表示になっています。格子の線は、定規と関連して引かれます。格子を表示するには、「表示」 [image] 「格子」を選択します。


ツールバー

ツールバーのツールを使用するには、希望するツールをクリックしてアクションを実行します。ツールがオブジェクト上のアクションを実行するよう設定されている場合は、1つ以上のオブジェクトを選択するまではグレー表示になっています。したがって、オブジェクトを選択してから、選択したオブジェクト上でアクションを実行するツールを選択します。


ツール・パレット

ツール・パレットは、オブジェクトを作成および操作するために使用できる一連のツールです。1回の操作を行う場合は、該当するツールをクリックしてアクティブにします。また、複数回の操作を行う場合は、使用するツールをダブルクリックして「ロック」します。

ツール・パレット内のツールは、レポート・エディタによって変わります。データ・モデルのツール・パレット上のツールをクリックすると、その機能の詳細がわかります。


ステータス・バー

データ・モデルのステータス・バーには、次の情報が表示されます。

•	マウスの絶対位置（ピクセルまたはインチ、センチメートル）

•	マウスのドラッグ距離（ピクセルまたはインチ、センチメートル）

•	拡大率


問合せツール

問合せツールを使用して、データ・モデル内に新規問合せを作成できます。問合せを作成するには、ツールを選択し、ペイント領域でクリックします。問合せオブジェクトをダブルクリックして、希望するプロパティを指定します。


PL/SQLツール

PL/SQLツールを使用して、データ・モデル内に新規参照カーソル問合せを作成できます。参照カーソル問合せを作成するには、ツールを選択し、ペイント領域でクリックします。PL/SQLエディタが表示されます。カーソルをオープンしパッケージ内で定義した参照カーソル型を持つカーソル変数を戻す、PL/SQLを入力します。


データ・リンク・ツール

データ・リンク・ツールを使用すると、2つの問合せのデータ間にリレーションを作成できます。データ・リンク・ツールには、次の3つの使用方法があります。

•	問合せ間のリンク  親問合せから子問合せへクリック・アンド・ドラッグし、2つの問合せに使用される表間に定義された各データベース制約に基づいてデータ・リンクを作成します。

•	グループ間のリンク  親グループ（グループ内の列は避ける）から子問合せに属するグループへクリック・アンド・ドラッグします。

•	列間のリンク  親グループの列から子グループの列へクリック・アンド・ドラッグします。


サマリー列ツール

サマリー列ツールを使用して、データ・モデル内にサマリー列を作成できます。サマリー列を作成するには、ツールを選択して、グループ内またはペイント領域のオープン域内をクリックします。その後、サマリー列オブジェクトをダブルクリックし、希望するプロパティを指定します。


式列ツール

式列ツールを使用して、データ・モデル内に新しい式列を作成できます。式列を作成するには、ツールを選択して、グループ内またはペイント領域のオープン域内をクリックします。その後、式列オブジェクトをダブルクリックし、希望するプロパティを指定します。


プレースホルダ列ツール

プレースホルダ列ツールを使用して、データ・モデル内に新しいプレースホルダ列を作成できます。プレースホルダ列を作成するには、ツールを選択して、グループ内またはペイント領域のオープン域内をクリックします。その後、プレースホルダ列オブジェクトをダブルクリックし、希望するプロパティを指定します。


クロス積ツール

クロス積ツールを使用して、他の複数のグループの周りにクロス積グループを作成できます。クロス積は、マトリックスを作成するためにデータ・モデル内で使用されます。クロス積ツールを選択し、クロス積グループに組み込むグループの周囲をクリック・アンド・ドラッグします。セル・グループがクロス積グループから独立した問合せである場合は、クロス積グループとセル・グループの列間に適切なリンクを作成してください。その後、レポートを生成し、レポート・ウィザードでマトリックス・レポートのオプションを指定します。


?


レイアウト・モデル

    関連項目

レイアウト・モデルは、レポート出力の書式を定義できる作業領域です。この作業は、枠および繰返し枠、フィールド、ボイラープレート、アンカー、チャート・オブジェクトのようなレイアウト・オブジェクトを使用して行います。

レポートを実行する際、Report Builderでは、レイアウト・モデルがレポート出力のデフォルト・テンプレートとして使用されます。このテンプレートは、フェッチされるデータおよびレイアウト・オブジェクトに割り当てられるPL/SQL論理に基いて拡大または縮小します。

アクセス

ペイント領域

オブジェクト表現

定規

格子表示

ツールバー

スタイルバー

ツール・パレット

ステータス・バー


説明

レイアウト・モデルは、レポート出力の書式を定義できる作業領域です。この作業は、枠および繰返し枠、フィールド、ボイラープレート、アンカー、チャート・オブジェクトのようなレイアウト・オブジェクトを使用して行います。

レポートを実行する際、Report Builderでは、レイアウト・モデルがレポート出力のデフォルト・テンプレートとして使用されます。このテンプレートは、フェッチされるデータおよびレイアウト・オブジェクトに割り当てられるPL/SQL論理に基いて拡大または縮小します。


アクセス

レイアウト・モデルにアクセスするには、次のような方法があります。

•	「レイアウト・モデル」ツールをクリックします。

•	「表示」 [image] 「レイアウト・モデル」を選択します。

•	「ウィンドウ」メニューから、レイアウト・モデルが入っているウィンドウを選択します。

•	オブジェクト・ナビゲータで、「レイアウト・モデル」ノード・アイコンをダブルクリックします。


ペイント領域

ペイント領域は、画面上のグラフィカル表示を見ながら、オブジェクトを作成または変更、配置、削除できる領域です。レイアウト・モデルには、次の3つのレポート領域があります。

•	ヘッダー

•	ボディ/マージン

•	トレーラ

 ここをクリックしてください。

レポート領域間をナビゲートするには、次のどちらかを行います。

•	ツールバーの対応するアイコンをクリックします。

•	「表示」メニューから「レイアウト・セクション」を選択します。

ヘッダー  一連の独立したページの各レポートの最初には、レポート・ヘッダー・ページが表示されます。このページには、テキストおよび図形、データ、計算を含むことができます。

ボディ/マージン  ヘッダー・ページとトレーラ・ページの間に、レポートの大部分を占めるボディ/マージン・ページが表示されます。このセクションの各物理ページは、1つのボディと1つのマージンから構成されています。新規レポートのレイアウト・モデルに初めて入ったときには、ボディ/マージン領域に入ることになります。ボディ、マージンのどちらのオブジェクトも作成および変更、削除できます。

ボディには、レポートのテキストおよび図形、データ、計算のほとんどが含まれます。ボディ内のすべてのデータがフォーマットされるまで、上下のマージンが各ページに表示されます。マージンには、テキストおよび図形、ページ番号、ページ合計、総計を組み込むことができます。デフォルトのマージン・サイズは、上下のマージンがそれぞれ0.5インチで、左右のマージンは0（ゼロ）となっています。

トレーラ  一連の独立したページの各レポートの終わりには、レポート・トレーラ・ページが表示されます。このページには、テキストおよび図形、データ、計算を含むことができます。


オブジェクト表現

ペイント領域で作成できるレイアウト・オブジェクトには、枠および繰返し枠、フィールド、ボイラープレート、アンカー、ボタン、OLE2オブジェクト、チャート・オブジェクトが含まれます。オブジェクトは、サイズおよび相対位置、パターン、カラー、グラフィカルにエディタ内に表示されるフォントを備えています。

図形表現（アイコン）は表示されるオブジェクトのタイプを示しますが、オブジェクトの設定を示すこともあります。図では、レイアウト・モデル内のこれらのアイコンの意味が示されています。

 ここをクリックしてください。

オブジェクトの設定を参照するには、オブジェクトをダブルクリックして、プロパティ・シートをオープンする必要があります。


定規

定規は、ペイント領域の左の枠と上の枠に配置されています。定規は、最初、レイアウト・モデルに表示されます。定規を隠すには、「表示」メニューの「定規」メニュー・オプションを選択解除します。

単位  定規のサイズの単位には、次のいずれかを設定できます。その場合、「書式」 [image] 「レイアウト・オプション」 [image] 「定規」を選択します。

•	インチ

•	センチメートル

•	ポイント

•	文字セル

レポートの「サイズの単位」プロパティを変更すると、定規の単位はサイズの単位に合わせて更新されます。「キャラクタ単位で設計」を「はい」に設定すると、定規単位は文字セルに変更されます。

マーカー  マーカーは、ペイント領域内のカーソル位置に従って左端および上端の2つの定規の上を移動します。定規は、ペイント領域に沿ってスクロールします。また、ペイント領域の一部を拡大すると、定規もそれに伴って拡大します。

定規ガイド  定規ガイドによって、オブジェクトの作成および変更の際の参照点が示されます。定規ガイドを作成するには、定規の1つをクリックし、ペイント領域にドラッグします。

注意: 定規および定規ガイドを隠すには、「表示」メニューの「定規」および「定規ガイド」メニューを選択解除します。定規および定規ガイドを表示するには、これらのメニュー・オプションを選択します。


格子表示

ペイント領域の内側は、ペイント領域内のオブジェクトの位置がわかるように格子表示になっています。格子の線は、定規と関連して引かれます。定規単位当たりの格子表示の線の間隔を指定するには、「書式」 [image] 「レイアウト・オプション」 [image] 「定規」を選択します。たとえば、「単位」をインチ、「格子間隔」を0.5に指定した場合、定規の0.5インチきざみに格子の線が引かれます。


ツールバー

ツールバーのツールを使用するには、希望するツールをクリックしてアクションを実行します。ツールがオブジェクト上のアクションを実行するよう設定されている場合は、1つ以上のオブジェクトを選択するまではグレー表示になっています。したがって、オブジェクトを選択してから、選択したオブジェクト上でアクションを実行するツールを選択します。


スタイルバー

スタイルバーのツールを使用するには、1つ以上のオブジェクトを選択した後、希望するツールをクリックします。ツールによって表現されるアクションは、選択したオブジェクトに合わせて実行されます。ツールは通常、スタイルバーで使用することができ、選択されたオブジェクトのフォント、フォント・スタイル、サイズおよび文字揃えを変更できます。


ツール・パレット

ツール・パレットは、オブジェクトを作成および操作するために使用できる一連のツールです。1回の操作を行う場合は、該当するツールをクリックしてアクティブにします。また、複数回の操作を行う場合は、使用するツールをダブルクリックして「ロック」します。

ツール・パレット内のツールは、レポート・エディタによって変わります。レイアウト・モデルのツール・パレット上のツールをクリックすると、この機能の詳細がわかります。


ステータス・バー

レイアウト・モデルのステータス・バーには、次の情報が表示されます。

•	マウスの絶対位置（ピクセルまたはインチ、センチメートル）

•	マウスのドラッグ距離（ピクセルまたはインチ、センチメートル）

•	回転角度

•	拡大率

•	アンカー・パーセンテージ


選択ツール

選択ツールを使用すると、1つ以上のオブジェクトを選択して、1つの操作を行うことができます。1つのオブジェクトを選択すると、その制御点を参照できるようになります。[Shift]キーを押しながらクリックすると、複数のオブジェクトまたはグループを選択できます。レポート・エディタで選択したオブジェクトは、オブジェクト・ナビゲータでも選択されます。


枠選択ツール

枠選択ツールを使用すると、枠または繰返し枠およびその中に含まれるすべてのオブジェクトを選択できます。枠または繰返し枠内のオブジェクトに間接的または直接的にアンカーされているオブジェクトも選択されます。枠または繰返し枠にアンカーされているオブジェクト、あるいは枠または繰返し枠の外側のオブジェクトは、選択されません。


回転ツール

回転ツールを使用すると、選択したボイラープレート・テキストおよび図形オブジェクトを回転できます。オブジェクトを回転するには、オブジェクトの制御点の1つをクリック・アンド・ドラッグします。選択したオブジェクトは、ドラッグした方向に回転します。

次の追加ルールは、回転ツールを使用する場合に適用されます。

•	回転したテキストは、すべてのオペレーティング・システムでサポートされるわけではありません。たとえば、回転したテキストは、キャラクタ・モードでは回転して表示されません。

•	フィールドを直接回転することはできません。ただし、回転することができるボイラープレート・テキスト・オブジェクト内のフィールド（たとえば、&ename）を参照することはできます。

•	回転できるのは、エディタに入力またはインポートしたボイラープレート・テキストのみです。リンク・ファイル・ツールで作成したボイラープレート・テキストを回転することはできません。

•	回転したテキストの「水平拡張度」プロパティは、テキストの読込み方向を示します。たとえば、テキストを90度回転させて、「水平拡張度」を「固定」にすると、実際はテキストは固定した垂直スペースを占有することになります。「水平拡張度」および「垂直拡張度」を「可変」または「拡張」に設定し、テキストを90度の倍数以外の角度に回転させた場合、オブジェクトの幅は、実際には「可変」の場合は縮小され、「拡張」の場合には固定されます。


変形ツール

変形ツールを使用すると、選択したオブジェクトの形を変更できます。オブジェクトを変形するには、オブジェクトの制御点上でクリック・アンド・ドラッグします。変形する際に参照する制御点は、オブジェクトを選択する際に参照したものとは違うことに注意してください。変形ツールを使った結果は、オブジェクトにより異なります。

•	円弧に変形ツールを使用すると、円周角を90度（円弧を作成する場合のデフォルト）以外の角度に変更します。

•	多角形に変形ツールを使用すると、任意の頂点を新しい位置に移動できます。

•	四角形のオブジェクト（たとえば、枠およびフィールド、チャート・オブジェクト）に変形ツールを使用すると、任意の頂点を新しい位置に移動できます。これは、四角形が回転して選択制御点が変形制御点と一致しなくなっている場合にのみ有効となることに注意してください。

•	アンカーに変形ツールを使用すると、任意の頂点を新しい位置に移動できます。また、同一または異なるオブジェクト上の新しい位置に終点を移動することもできます。


拡大ツール

拡大ツールは、クリックする点の周りの領域を2倍に拡大します（つまり、オブジェクトの大きさが2倍になります）。拡大ツールを使用する際、制約キー（通常は、[Shift]キー）を押すと、0.5倍に拡大します（つまり、オブジェクトの大きさが半分になります）。このツールは、大きなレイアウトの一部をフォーカスする場合に便利です。


線ツール

線ツールを使用すると、線のボイラープレート・オブジェクトを描くことができます。線を引くには、一方の終点とする点をクリックし、もう1つの終点までドラッグしてからマウス・ボタンを離します。水平または垂直、45度の線を引くには、制約キー（通常は、[Shift]キー）を使用します。線の他のオプションを設定するには、「書式」メニューから「線幅」または「凹凸」、「線種」、「矢印」を選択します。


丸い四角形ツール

丸い四角形ツールを使用すると、角の丸い四角形のボイラープレート・オブジェクトを描くことができます。角の丸い四角形を描くには、対角線を描くようにクリック・アンド・ドラッグでオブジェクトを定義した後、マウス・ボタンを離します。角の丸い正方形を作成するには、制約キー（通常は、[Shift]キー）を使用します。角の丸い四角形のオブジェクトには、「書式」メニューを使用して、特別の「描画オプション」を設定できます。


四角形ツール

四角形ツールを使用すると、四角形のボイラープレート・オブジェクトを描くことができます。四角形を描くには、対角線を描くようにクリック・アンド・ドラッグでオブジェクトを定義した後、マウス・ボタンを離します。正方形を描くには、制約キー（通常は、[Shift]キー）を使用します。


楕円ツール

楕円ツールを使用すると、楕円形のボイラープレート・オブジェクトを描くことができます。楕円を描くには、対角線を描くようにクリック・アンド・ドラッグでオブジェクトを定義した後、マウス・ボタンを離します。円を描くには、制約キー（通常は、[Shift]キー）を使用します。


円弧ツール

円弧ツールを使用すると、弧形のボイラープレート・オブジェクトを描くことができます。弧を描くには、対角線を描くようにクリック・アンド・ドラッグでオブジェクトを定義した後、マウス・ボタンを離します。円の弧を描くには、制約キー（通常は、[Shift]キー）を使用します。弧形のオブジェクトには、「書式」メニューを使用して、特別の「描画オプション」を設定できます。


多角形ツール

多角形ツールを使用すると、多角形のボイラープレート・オブジェクトを描くことができます。多角形を描くには、最初の頂点を配置する位置をクリックした後、次々に頂点を作成する位置をクリックしていきます。多角形の描画を完結するには、最後の頂点をダブルクリックすると、最初と最後の頂点をつなぐ線が描かれます。水平または垂直、45度のセグメントを描くには、制約キー（通常は、[Shift]キー）を使用します。1つの頂点を制約しても、後続の頂点には影響しません。


折れ線ツール

折れ線ツールを使用すると、折れ線のボイラープレート・オブジェクトを作成できます。折れ線を描くには、最初の頂点を配置する位置をクリックした後、次々に頂点を作成する位置をクリックしていきます。折れ線の描画を完結するには、最後の頂点をダブルクリックします。最初の頂点と最後の頂点は、手動でつながない限り、（多角形オブジェクトの場合のように）接続されることはありません。水平または垂直、45度のセグメントを描くには、制約キー（通常は、[Shift]キー）を使用します。1つの頂点を制約しても、後続の頂点には影響しません。


手書きツール

手書きツールを使用すると、自由な形状のボイラープレート・オブジェクトを描くことができます。手書きのオブジェクトを描くには、クリック・アンド・ドラッグでオブジェクトを定義した後、マウス・ボタンを放します。


テキスト・ツール

テキスト・ツールを使用すると、ボイラープレート・テキスト・オブジェクトを作成および編集することができます。テキスト・ツールを使用してボイラープレート・テキスト・オブジェクトを作成するには、次の2つの方法のどちらかを行います。

•	テキストを開始する場所をクリックして、テキストの入力を開始します。テキストは、新規行を開始するために[Return]を入力した場合のみ、ワードラップします。

•	クリック・アンド・ドラッグで、テキスト・バウンティング・ボックスを作成します。ボックスに入力したテキストは、ボックスの水平の境界線の範囲内に収まるようにワードラップします。ボックスは、必要に応じて、入力するテキストが収まるように垂直方向に拡大されます。

既存のボイラープレート・テキストを編集するには、ボイラープレート・テキスト・オブジェクトをクリックして入力/編集を開始します。テキストを入力または編集する際には、テキスト・モードになります。テキスト・モードを切り替えたい場合は、ボイラープレート・テキスト・オブジェクトの外側をクリックします。テキスト・モードでは、カットおよびコピー、ペーストなどのテキスト上のアクションを実行したり、スタイルバーを使用してフォントや配列を変更できます。

注意: ボイラープレート・テキストのフォントまたはサイズを変更すると、バウンディング・ボックスがテキストに合わせて自動的に拡大または縮小します。


枠ツール

枠ツールを使用すると、枠を作成できます。枠を描くには、対角線を描くようにクリック・アンド・ドラッグでオブジェクトを定義した後、マウス・ボタンを離します。正方形を描くには、制約キー（通常は、[Shift]キー）を使用します。


繰返し枠ツール

繰返し枠ツールを使用すると、繰返し枠を作成できます。繰返し枠を描くには、対角線を描くようにクリック・アンド・ドラッグでオブジェクトを定義した後、マウス・ボタンを離します。正方形を描くには、制約キー（通常は、[Shift]キー）を使用します。


フィールド・ツール

フィールド・ツールを使用すると、フィールドを作成できます。フィールドを描くには、対角線を描くようにクリック・アンド・ドラッグでオブジェクトを定義した後、マウス・ボタンを離します。正方形を描くには、制約キー（通常は、[Shift]キー）を使用します。


リンク・ファイル・ツール

リンク・ファイル・ツールを使用すると、ファイルから読み込まれるボイラープレート・オブジェクトを作成できます。ボイラープレートには、テキストまたは描画、イメージがあり、エディタ内では四角形で表示されます。リンク・ファイル・オブジェクトを描くには、、対角線を描くようにクリック・アンド・ドラッグでオブジェクトを定義した後、マウス・ボタンを離します。正方形を描くには、制約キー（通常は、[Shift]キー）を使用します。


チャート・ツール

チャート・ツールを使用すると、Oracle Graphicsの図表を参照するチャート・オブジェクトを作成できます。チャート・オブジェクトを描くには、対角線を描くようにクリック・アンド・ドラッグでオブジェクトを定義した後、マウス・ボタンを離します。正方形を描くには、制約キー（通常は、[Shift]キー）を使用します。


ボタン・ツール

ボタン・ツールを使用すると、ボタン・オブジェクトを描くことができます。ボタン・オブジェクトを描くには、対角線を描くようにクリック・アンド・ドラッグでオブジェクトを定義した後、マウス・ボタンを離します。正方形を描くには、制約キー（通常は、[Shift]キー）を使用します。

注意: ユーザー定義のボタンは、使用しているプラットフォーム上のネイティブ・ボタンと同じ特性を備え、実行時に表示されます。


アンカー・ツール

アンカー・ツールを使用すると、2つのオブジェクトをアンカーすることができます。アンカーを描くには、子オブジェクトの枠をクリックし、エディタ内の他の位置でクリック（オプション）してから、親オブジェクトの枠をダブルクリックします。子オブジェクトにアンカーを配置するときに制約キー（通常は、[Shift]キー）を使用すると、アンカーは最も近い25％の倍数の位置に置かれます。


OLE2オブジェクト・ツール

OLE2オブジェクト・ツールを使用すると、レイアウトにOLE2オブジェクトを配置できます。OLE2オブジェクトを描くには、対角線を描くようにクリック・アンド・ドラッグでオブジェクトを定義した後、マウス・ボタンを放します。正方形を描くには、制約キー（通常は、[Shift]キー）を使用します。

OLE2オブジェクトを描いた後、オブジェクト・タイプおよびオブジェクト・ソースを定義し、オブジェクトをリンクするか埋め込むかを定義するダイアログ・ボックスが表示されます。作成するオブジェクトに対して、オプションを指定する必要があることに注意してください。


追加デフォルト・レイアウト・ツール

追加デフォルト・レイアウト・ツールを使用すると、全体のレイアウト・モデルを上書きしなくても、レポートの一部にデフォルト・レイアウトを定義できます。追加のデフォルト・レイアウトを描くには、対角線を描くようにクリック・アンド・ドラッグでオブジェクトを定義した後、マウス・ボタンを放します。正方形を描くには、制約キー（通常は、[Shift]キー）を使用します。デフォルト・レイアウトが表示される領域を定義すると、レポート・ウィザードを使用してオプションを指定するよう求められます。


塗り/線/テキスト表示

塗り/線/テキスト表示には、塗りおよび線、文字色の現行の選択内容が表示されます。現行の選択内容を変更するには、塗りカラーおよび線カラー、文字色・ツールを使用します。


塗りカラー・ツール

塗りカラー・ツールには、使用可能なすべての色および「塗りなし」、「パターン」が表示されます。任意の色または「塗りなし」を選択すると、その塗りカラーが、選択したオブジェクトおよびそのオブジェクトの後に作成されたすべてのオブジェクトに対して設定されます。「パターン」を選択すると、パターン・パレットが表示されます。任意のパターンを選択すると、その塗りパターンが、選択したオブジェクトおよびそのオブジェクトの後に作成されたすべてのオブジェクトに対して設定されます。パターン・パレットの下部は、フォアグラウンドおよびバックグラウンド色パレットになっています。フォアグラウンドおよびバックグラウンド色を選択すると、それがパターンに対して設定されます。


線カラー・ツール

線カラー・ツールには、使用可能なすべての色および「枠なし」が表示されます。任意の色または「枠なし」を選択すると、その線カラーが、選択したオブジェクトおよびそのオブジェクトの後に作成されたすべてのオブジェクトに対して設定されます。「パターン」を選択すると、パターン・パレットが表示されます。任意のパターンを選択すると、その線パターンが、選択したオブジェクトおよびそのオブジェクトの後に作成されたすべてのオブジェクトに対して設定されます。パターン・パレットの下部は、フォアグラウンドおよびバックグラウンド色パレットになっています。これらをクリックして、使用できるカラーを表示します。フォアグラウンドおよびバックグラウンド色を選択すると、それがパターンに対して設定されます。


文字色ツール

文字色ツールには、使用可能なすべての色が表示されます。任意の色を選択すると、変更しない限り、選択したオブジェクトおよびそのオブジェクトの後に作成されたすべてのオブジェクトの文字色として設定されます。


?


ライブ・プレビューア

  関連項目

ライブ・プレビューアは、レポートをプレビューしながら、実際のデータまたはライブ・データを操作できる作業領域です。ライブ・プレビューアでは、レポートを対話的にカスタマイズできます。つまり、変更を加えながらその結果を参照できます。

ライブ・プレビューアのボタンをアクティブにするには、レポート出力をランタイム・プレビューアに表示する必要があります。列サイズの変更など、レポートを編集するには、ライブ・プレビューアをフレックス・モードにする必要があります。

アクセス

タイトル

表示領域

定規

格子表示

ツールバー

スタイルバー

ツール・パレット

ステータス・バー


説明

ライブ・プレビューアは、レポートをプレビューしながら、実際のデータまたはライブ・データを操作できる作業領域です。ライブ・プレビューアでは、レポートを対話的にカスタマイズできます。つまり、変更を加えながらその結果を参照できます。

ライブ・プレビューアのボタンをアクティブにするには、レポート出力をランタイム・プレビューアに表示する必要があります。


アクセス

レポートの実行時には、常にライブ・プレビューアが表示されます。オブジェクト・ナビゲータまたは任意のエディタからレポートを実行するには、 [image] をクリックするか、または「プログラム」 [image] 「レポート実行」を選択します。レポート・ウィザードからレポートを実行するには、「完了」をクリックします。

ライブ・プレビューアには、次の方法でアクセスすることもできます。

•	をクリックします。

•	「表示」 [image] 「ライブ・プレビューア」を選択します。

•	「ウィンドウ」メニューから、ライブ・プレビューアが入っているウィンドウを選択します。

•	オブジェクト・ナビゲータで、「ライブ・プレビューア」ノード・アイコン [image] をダブルクリックします。


タイトル

デフォルトでは、ライブ・プレビューア表示のタイトルは、<report name>: ライブ・プレビューアです。レポートのプロパティ・シートで、ライブ・プレビューア表示のタイトルを変更できます。


表示領域

表示領域は、レポート出力を表示し、操作できる領域です。下に位置する黒いバーをスクロール・バーの右側にドラッグすれば、表示領域を垂直または水平に分割して複数の領域にすることができます。また、拡大ツールを使用して、表示領域を拡大することもできます。

その他の表示オプション（複数のプレビューアのオープン、マルチメディア・オブジェクトの表示）の設定は、レポートをランタイム・プレビューアに表示して行ってください。


定規

定規は、ペイント領域の左の枠と上の枠に配置されています。最初は、ライブ・プレビューアでは、定規は非表示になっています。定規を表示するには、「表示」メニューの「定規」を選択します。

単位  定規のサイズの単位には、次のいずれかを設定できます。その場合、「書式」 [image] 「レイアウト・オプション」 [image] 「定規」を選択します。

•	インチ

•	センチメートル

•	ポイント

•	文字セル

レポートの「サイズの単位」プロパティを変更すると、定規の単位はサイズの単位に合わせて更新されます。「キャラクタ単位で設計」を「はい」に設定すると、定規単位は文字セルに変更されます。

マーカー  マーカーは、ペイント領域内のカーソル位置に従って左端および上端の2つの定規の上を移動します。定規は、ペイント領域に沿ってスクロールします。また、ペイント領域の一部を拡大すると、定規もそれに伴って拡大します。

定規ガイド  定規ガイドによって、オブジェクトの作成および変更の際の参照点が示されます。定規ガイドを作成するには、定規の1つをクリックし、ペイント領域にドラッグします。

注意: 定規および定規ガイドを表示するには、「表示」メニューの「定規」および「定規ガイド」を選択します。定規および定規ガイドを隠すには、これらのメニューを選択解除してください。


格子表示

ペイント領域の内側は、表示領域内のオブジェクトの位置がわかるように格子表示になっています。格子の線は、定規と関連して引かれます。定規単位当たりの格子表示の線の間隔を指定するには、「書式」 [image] 「レイアウト・オプション」 [image] 「定規」を選択します。たとえば、「単位」をインチ、「格子間隔」を0.5に指定した場合、定規の0.5インチきざみに格子の線が引かれます。


ツールバー

ツールバーのツールを使用するには、希望するツールをクリックしてアクションを実行します。ツールがオブジェクト上のアクションを実行するよう設定されている場合は、1つ以上のオブジェクトを選択するまではグレー表示になっています。したがって、オブジェクトを選択してから、選択したオブジェクト上でアクションを実行するツールを選択します。


スタイルバー

スタイルバーのツールを使用するには、1つ以上のオブジェクトを選択した後、希望するツールをクリックします。ツールによって表現されるアクションは、選択したオブジェクトに合わせて実行されます。ツールは通常、スタイルバーで使用することができ、選択されたオブジェクトのフォント、フォント・スタイル、サイズ、文字位置を変更することができます。


ツール・パレット

ツール・パレットは、オブジェクトを作成および操作するために使用できる一連のツールです。1回の操作を行う場合は、該当するツールをクリックしてアクティブにします。また、複数回の操作を行う場合は、使用するツールをダブルクリックして「ロック」します。

ツール・パレット内のツールは、レポート・エディタによって変わります。ライブ・プレビューアのツール・パレット上のツールをクリックすると、この機能の詳細がわかります。


ステータス・バー

ライブ・プレビューアのステータス・バーには、次の情報が表示されます。

•	マウスの絶対位置（ピクセルまたはインチ、センチメートル）

•	マウスのドラッグ距離（ピクセルまたはインチ、センチメートル）

•	拡大率


?


オブジェクト・ナビゲータ

  関連項目

オブジェクト・ナビゲータには、連結ライブラリおよび外部問合せを含む、レポートまたはテンプレート内のすべての主要なオブジェクトが階層構造で表示されます。この表示を使用して、オブジェクトの選択、オブジェクトについてのプロパティ・パレットの起動、オブジェクトのPL/SQLの編集、PL/SQLプログラム単位のドラッグ・アンド・ドロップ、名前によるオブジェクトの検索などのアクションを実行できます。

アクセス

コンポーネント

ノード

表示


説明

オブジェクト・ナビゲータには、連結ライブラリおよび外部問合せを含む、レポートまたはテンプレート内のすべての主要なオブジェクトが階層構造で表示されます。この表示を使用して、オブジェクトの選択、オブジェクトについてのプロパティ・パレットの起動、オブジェクトのPL/SQLの編集、PL/SQLプログラム単位のドラッグ・アンド・ドロップ、名前によるオブジェクトの検索などのアクションを実行できます。


アクセス

オブジェクト・ナビゲータにアクセスするには、次の2つの方法があります。

•	Report Builderを起動します。

•	「ウィンドウ」メニューから「オブジェクト・ナビゲータ」を選択します。


コンポーネント

オブジェクト・ナビゲータには、次のコンポーネントが備えられています。

モジュール・リスト

検索

ツールバー

オブジェクト・ツリー


モジュール・リスト

ナビゲータの最上部には、ナビゲータ内で現在オープンしているすべてのモジュールのリストおよび最も最近に選択されたノードとその上位項目が表示されます。リストから名前を選択すると同時に、ナビゲータ内の該当するノードが選択されます。


検索

ナビゲータの最上部には、ノード検索のターゲット文字列を入力できる「検索」というフィールドがあります。検索フィールドの隣には、逆方向検索か順方向検索かを指示するための2つのツールがあります。

 順方向検索では、「検索」内の検索文字列に一致する名前を持つ次のノードが検索されます。順方向検索では、縮小されたノードが検索および拡張されます。

 逆方向検索では、「検索」内の検索文字列に一致する名前を持つ前のノードが検索されます。逆方向検索では、縮小されたノードが検索されます。


ツールバー

ツールバーのツールを使用するには、アウトライン表示で1つ以上のオブジェクトをクリックして選択した後、希望するツール・アイコンをクリックします。そのツールで表現されたアクションは、選択したオブジェクト上で実行されます。


オブジェクト・ツリー

オブジェクト・ツリーは、現行のセッション内のオブジェクトのリストが表示される領域です。このリストはノードで構成され、各ノードのオブジェクトまたはオブジェクトのタイプが表示されています。


ノード

現行のセッション内の各オブジェクトまたはオブジェクト・タイプ（オープンしたレポートまたはテンプレートから、各レポートのオブジェクトまで）は、オブジェクト・ナビゲータではノードで表示されます。（ノードは、オブジェクト・ナビゲータで選択可能な行です）。

オブジェクト・ナビゲータの各ノードは、次のいくつかまたはすべてから構成されています。

•	プラス（+）またはマイナス（-） ノードの拡張状態を示します。

•	PL/SQLアイコン（ [image] または [image] ） オブジェクトのPL/SQLを示します。

•	オブジェクト・ノードまたはエディタ表示アイコン オブジェクトのプロパティ（たとえば、 [image] ）またはレポート・エディタ内の表示（たとえば、 [image] ）を示します。

•	名前またはヘッダー（たとえば、Q_Empまたはデータ・モデル）を示します。


プラス（+）/マイナス（-）

ノードの拡張状態を示します。

•	プラス（+）は、そのノードの下に、現在表示されていない別のノードがあることを示しています。プラス（+）アイコンをクリックすると、子ノードを表示できます。プラス（+）がグレー表示されているときは、そのノードに他のノードを含めることができますが、現在は他のノードが含まれていないことを示しています。

•	マイナス（-）は、そのノードの下にあるノードが現在表示されていることを示しています。マイナス（-）アイコンをクリックすると、現在表示されている子ノードがすべて縮小されます。


PL/SQLアイコン

オブジェクトにPL/SQLを関係付けできることを示します。  また、そのオブジェクトに現在定義されたプログラム単位があるかどうかを示します。プログラム単位エディタに、オブジェクトのプログラム単位を表示するには、PL/SQLアイコンをダブルクリックします。


オブジェクト・タイプまたはエディタ表示

ノードで表示されたオブジェクトのタイプまたはエディタを示します。たとえば、パラメータを示すノードは [image] と表示され、「レイアウト・モデル」ヘッダー・ノードは [image] と表示されます。オブジェクトのプロパティ・パレットを表示するには、表示するオブジェクトのアイコンをダブルクリックします。エディタを表示するには、エディタ表示アイコンをダブルクリックします。これらのアイコンを表示または非表示にするには、「ナビゲータ」 [image] 「ナビゲータ・オプション」を使用します。


オブジェクト名またはヘッダー

ノードまたはヘッダー・ノードで示されたオブジェクト名です。オブジェクト・ノードは、たとえば、F_1, M_GRPFR_DeptまたはB_Rectangleのように、オープンしたレポートまたはテンプレート内で検索された特定のオブジェクトを示します。オブジェクト・ナビゲータでオブジェクト・ノードを選択すると、エディタがすでにオープンしていれば、レポート・エディタまたはテンプレート・エディタの該当する表示でもそのオブジェクトが選択されます。ヘッダー・ノードは、レポートおよび枠、図形ボイラープレートなどのオブジェクトまたはプロパティのタイプを示します。これらのヘッダーは、オブジェクトを示すノードよりも前にあり、ナビゲーションで使用されます。

オブジェクト名またはヘッダーをクリックすると、ノードが選択されます。そのノードがすでに選択されている場合は、名前の上をシングルクリックすれば編集モードに切り替わるので、オブジェクト名を編集できます（ヘッダーは編集できません）。オブジェクトの外側をクリックすると、編集モードが解除され、該当するすべての場所で、名前が編集した名前に更新されます（たとえば、レイアウトおよびオブジェクトのプロパティ）。同様に、オブジェクトの名前を別の場所で変更した場合は、オブジェクト・ナビゲータ内の名前も自動的に更新されます。

注意: オブジェクト・ナビゲータ内の名前が編集モードになっていても、別の場所で編集された場合は、その名前はオブジェクト・ナビゲータ内では更新されません。かわりにオブジェクト・ナビゲータ内の名前が優先され、オブジェクトの最終的な名前は、編集モードが解除されたときにオブジェクト・ナビゲータ内で表示される名前になります。


表示

  関連項目

オブジェクト・ナビゲータでは、所有者階層別またはオブジェクト・タイプ別にオブジェクトを参照できます。

「表示」 [image] 「所有者」を選択すると、親子階層にオブジェクトが表示されます。たとえば、問合せの列は問合せの下に表示され、フィールドはそれを囲んでいる繰返し枠の下に表示されます。この表示は、オブジェクト間のリレーションを簡単に参照できるので、デバッグ・ツールとして使用できます。

「表示」 [image] 「タイプ」を選択すると、タイプ別にオブジェクトが表示されます。たとえば、すべての問合せは問合せヘッダーの下に表示され、すべてのデータベース列はデータベース列ヘッダーの下に表示されます。この表示は、オブジェクト・ナビゲータ内のオブジェクトを素早く検索するときに便利です。


パラメータ・フォーム

  関連項目

パラメータ・フォームは、レポートのランタイム・パラメータ・フォームの書式を定義する作業領域です。この作業を行うには、パラメータ・フォーム・オブジェクト（フィールドおよびボイラープレート）を定義および変更します。

レポートを実行する際、Report Builderでは、パラメータ・フォームがランタイム・パラメータ・フォームのテンプレートとして使用されます。フィールドおよびボイラープレートは、パラメータ・フォームで表示したとおりに、ランタイム・パラメータ・フォームに表示されます。パラメータ・フォームでランタイム・パラメータ・フォームを定義しない場合、Report Builderでは、実行時にデフォルトのパラメータ・フォームが表示されます。

アクセス

ペイント領域

オブジェクト表現

定規

格子表示

ツールバー

スタイルバー

ツール・パレット

ステータス・バー


説明

パラメータ・フォームは、レポートのランタイム・パラメータ・フォームの書式を定義する作業領域です。この作業を行うには、パラメータ・フォーム・オブジェクト（フィールドおよびボイラープレート）を定義および変更します。

レポートを実行する際、Report Builderでは、パラメータ・フォームがランタイム・パラメータ・フォームのテンプレートとして使用されます。フィールドおよびボイラープレートは、パラメータ・フォームで表示したとおりに、ランタイム・パラメータ・フォームに表示されます。パラメータ・フォームでランタイム・パラメータ・フォームを定義しない場合、Report Builderでは、実行時にデフォルトのパラメータ・フォームが表示されます。


アクセス

パラメータ・フォームにアクセスするには、次のような方法があります。

•	「パラメータ・フォーム」ツールをクリックします。

•	「表示」 [image] 「パラメータ・フォーム」を選択します。

•	「ウィンドウ」メニューから、パラメータ・フォームが入っているウィンドウを選択します。

•	オブジェクト・ナビゲータで、「パラメータ・フォーム」ノード・アイコンをダブルクリックします。


ペイント領域

ペイント領域は、画面上のグラフィカル表示を見ながら、オブジェクトを作成または変更、配置、削除できる領域です。パラメータ・フォームのペイント領域は、物理ページで構成されています。パラメータ・フォームの物理ページは、ボイラープレート・テキストおよび図形、フィールドを入れることができる情報のウィンドウです。

パラメータ・フォームに初めて入ったときには、最初の物理ページに入ることになります。下へスクロールすれば、パラメータ・フォームの他のページにナビゲートすることができます。エディタでは、ページは黒い線で区切られます。

レポート・プロパティ・シート（オブジェクト・ナビゲータでレポートのノードをダブルクリックすると表示されます）を使用して、各パラメータ・フォームのページ・サイズおよびページ番号を指定します。パラメータ・フォームには、指定した数のページが、それぞれ水平の線で区切られ垂直方向に表示されます。ページにまたがるオブジェクトは、ランタイム・パラメータ・フォームの第1ページにのみ表示され、後は切り捨てられます。


オブジェクト表現

ペイント領域で作成できるパラメータ・フォーム・オブジェクトは、フィールドおよびボイラープレートです。

パラメータ・フォームでは、オブジェクトを切り取りおよびコピー、貼り付けすることができますが、コピーされるのはオブジェクトの図形表現のみです。オブジェクトをコピーしても、プロパティ・シートの設定はコピーされません。

オブジェクトの設定を参照するには、オブジェクトをダブルクリックして、プロパティ・シートをオープンする必要があります。


定規

定規は、ペイント領域の左の枠と上の枠に配置されています。定規は、最初、パラメータ・フォームに表示されています。定規を隠すには、「表示」メニューの「定規」メニュー・オプションを選択解除します。

単位  定規のサイズの単位には、次のいずれかを設定できます。その場合、「書式」 [image] 「レイアウト・オプション」 [image] 「定規」を選択します。

•	インチ

•	センチメートル

•	ポイント

•	文字セル

レポートの「サイズの単位」プロパティを変更すると、定規の単位はサイズの単位に合わせて更新されます。「キャラクタ単位で設計」を「はい」に設定すると、定規単位は文字セルに変更されます。

マーカー  マーカーは、ペイント領域内のカーソル位置に従って左端および上端の2つの定規の上を移動します。定規は、ペイント領域に沿ってスクロールします。また、ペイント領域の一部を拡大すると、定規もそれに伴って拡大します。

定規ガイド  定規ガイドによって、オブジェクトの作成および変更の際の参照点が示されます。定規ガイドを作成するには、定規の1つをクリックし、ペイント領域にドラッグします。

注意: 定規および定規ガイドを隠すには、「表示」メニューの「定規」および「定規ガイド」メニューを選択解除します。定規および定規ガイドを表示するには、これらのメニュー・オプションを選択します。


格子表示

ペイント領域の内側は、ペイント領域内のオブジェクトの位置がわかるように格子表示になっています。格子の線は、定規と関連して引かれます。定規単位当たりの格子表示の間隔を指定するには、「書式」 [image] 「レイアウト・オプション」 [image] 「定規」を選択します。たとえば、「単位」をインチ、「格子間隔」を0.5に指定した場合、定規の0.5インチきざみに格子の線が引かれます。


ツールバー

ツールバーのツールを使用するには、希望するツールをクリックしてアクションを実行します。ツールがオブジェクト上のアクションを実行するよう設定されている場合は、1つ以上のオブジェクトを選択するまではグレー表示になっています。したがって、オブジェクトを選択してから、選択したオブジェクト上でアクションを実行するツールを選択します。


スタイルバー

スタイルバーのツールを使用するには、1つ以上のオブジェクトを選択した後、希望するツールをクリックします。ツールによって表現されるアクションは、選択したオブジェクトに合わせて実行されます。ツールは通常、スタイルバーで使用することができ、選択されたオブジェクトのフォント、フォント・スタイル、サイズ、文字位置を変更することができます。


ツール・パレット

ツール・パレットは、オブジェクトを作成および操作するために使用できる一連のツールです。1回の操作を行う場合は、該当するツールをクリックしてアクティブにします。また、複数回の操作を行う場合は、使用するツールをダブルクリックして「ロック」します。

ツール・パレット内のツールは、レポート・エディタによって変わります。パラメータ・フォームのツール・パレット上のツールをクリックすると、この機能の詳細がわかります。


ステータス・バー

パラメータ・フォームのステータス・バーには、次の情報が表示されます。

•	マウスの絶対位置（ピクセルまたはインチ、センチメートル）

•	マウスのドラッグ距離（ピクセルまたはインチ、センチメートル）

•	回転角度

•	拡大率


?


テンプレート・エディタ

  関連項目

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

使用上の注意

アクセス

ペイント領域

レポート・スタイル

オブジェクト表現

定規

格子表示

ステータス・バー


説明

  関連項目

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


使用上の注意

  関連項目

•	テンプレート・エディタで作業すると、すべてのレポート・スタイルについてデフォルトの属性を定義したり、選択したレポート・スタイルの属性を上書きしたりできます。

•	テンプレートを作成するときには、ほとんどの場合に見栄えが適切になるように、デフォルト属性を変更します。次に、上書き属性を変更し、特定のレポート・スタイルに合うように変更を調整します。

•	テンプレートのレポート・プロパティおよびシステム・パラメータ、ユーザー・パラメータ、プログラム単位、連結ライブラリ、レポート・トリガーの変更には、オブジェクト・ナビゲータを使用します。

•	マージン領域にオブジェクトを作成する場合、そのオブジェクトには、テンプレートが適用されるどのレポートでも必ず他と重複しない名前を割り当てる必要があります。たとえば、テンプレートでB_1というボイラープレート・オブジェクトを作成するとしても、この名前では、テンプレートをレポートに適用すると、レポート内の既存のボイラープレート・オブジェクトの名前とおそらく競合してしまうでしょう。この問題を避けるには、オブジェクト名に何かを追加して、他と重複しないもの（$MY_TEMPLATE_BPLATE1など）にしてください。


アクセス

テンプレート・エディタにアクセスするには、次のような方法があります。

•	「ウィンドウ」メニューから、テンプレート・エディタ・レイアウト・モデルが入っているウィンドウを選択します。

•	オブジェクト・ナビゲータで、テンプレートの「レイアウト・モデル」ノードのアイコンをダブルクリックします。


ペイント領域

  関連項目

ペイント領域は、画面上のグラフィカル表示を見ながら、オブジェクトを変更できる領域です。テンプレート・エディタには、次の2つの領域があります。

•	ボディ

•	マージン

レポート領域間を移動するには、ツールバーで対応するアイコンをクリックします。


ボディ

テンプレートのボディ領域内のオブジェクトの書式設定特性（フォント、カラーなど）は、そのテンプレートを適用するレポートのボディ領域にあるオブジェクトに継承されます。テンプレートのボディ領域内のオブジェクトは、そのスタイルのレポート･レイアウトで表示されるオブジェクトのタイプのプレースホルダです。


マージン

テンプレートのマージン領域内のオブジェクトは、そのテンプレートを適用するレポートのマージン領域に定義されます。マージンでは、テキストおよび図形、システム･パラメータ（現在の時刻またはページ番号など）をソースとするフィールドを定義できます。


レポート・スタイル

異なるレイアウト・スタイル間でボディ領域を切り替えるには、テンプレート・エディタ上部の「レポート・スタイル」リストを使用します。


オブジェクト表現

ボディ内のオブジェクトは、可視属性がレポート内のオブジェクトにどのように適用されるかを示す例として表示されるのみです。マージン領域内のオブジェクトは、テンプレート内と同じようにレポートに表示されます。オブジェクトの設定を表示または変更するには、プロパティ・パレットを表示します。


定規

定規は、ペイント領域の左の枠と上の枠に配置されています。定規は、最初、レイアウト・モデルに表示されます。定規を隠すには、「表示」メニューの「定規」メニュー・オプションを選択解除します。テンプレートの「サイズの単位」プロパティを変更（オブジェクト・ナビゲータでテンプレート・アイコンをダブルクリック）すると、そのサイズの単位に合わせて定規単位も更新されます。「キャラクタ単位で設計」を「はい」に設定すると、定規単位は文字セルに変更されます。

マーカー  マーカーは、ペイント領域内のカーソル位置に従って左端および上端の2つの定規の上を移動します。定規は、ペイント領域に沿ってスクロールします。また、ペイント領域の一部を拡大すると、定規もそれに伴って拡大します。

定規ガイド  定規ガイドによって、オブジェクトの作成および変更の際の参照点が示されます。定規ガイドを作成するには、定規の1つをクリックし、ペイント領域にドラッグします。定規ガイドを削除するには、ドラッグして定規に戻します。すべての定規ガイドを隠すには、「表示」メニューで「定規ガイド」メニュー・オプションを選択解除します。定規および定規ガイドを表示するには、これらのメニュー・オプションを選択します。


格子表示

ペイント領域の内側は、ペイント領域内のオブジェクトの位置がわかるように格子表示になっています。格子の線は、定規と関連して引かれます。「定規設定」ダイアログ・ボックスから、定規の単位ごとに表示される格子の線の間隔を指定します。たとえば、「単位」をインチ、「格子間隔」を0.5に指定した場合、定規の0.5インチきざみに格子の線が引かれます。


ステータス・バー

レイアウト・モデルのステータス・バーには、次の情報が表示されます。

•	マウスの絶対位置（ピクセルまたはインチ、センチメートル）

•	マウスのドラッグ距離（ピクセルまたはインチ、センチメートル）

•	回転角度

•	ズーム・レベル

•	アンカー・パーセンテージ


?


ビルトイン・パッケージの例

  関連項目 	  すべての例

Report Builderのビルトイン・パッケージの例

その他のビルトイン・パッケージの例


Report Builderのビルトイン・パッケージの例

  関連項目 	  すべての例

Report Builderには、ビルトイン・パッケージが1つのみあります。

SRW


SRWのビルトイン・パッケージの例

  関連項目 	  すべての例

動的SRW.SET_HYPERLINKの例

動的SRW.SET_LINKTAGの例

SRW.CONTEXT_FAILUREの例

SRW.DO_SQLの例

SRW.DO_SQL_FAILUREの例

SRW.GET_PAGE_NUMの例

SRW.GETERR_RUNの例

SRW.INTEGER_ERRORの例

SRW.MAXROW_INERRの例

SRW.MESSAGEの例

SRW.NULL_ARGUMENTSの例

SRW.PROGRAM_ABORTの例

SRW.REFERENCEの例

SRW.RUN_REPORTの例

SRW.RUN_REPORT_BATCHNOの例

SRW.RUN_REPORT_FAILUREの例

SRW.SET_ATTR

SRW.SET_AFTER_PAGE_HTMLの例

SRW.SET_AFTER_REPORT_HTMLの例

SRW.SET_DISPLAY_NAMEの例

SRW.SET_FIELD_CHAR example

SRW.SET_FIELD_DATEの例

SRW.SET_FIELD_NUMの例

SRW.SET_HYPERLINKの例

SRW.SET_HYPERLINK_ATTRSの例

SRW.SET_LINKTAGの例

SRW.SET_MAXROWの例

SRW.SET_PDF_ACTIONの例

SRW.SET_PRINTER_TRAYの例

SRW.UNKNOWN_QUERYの例

SRW.UNKNOWN_USER_EXITの例

SRW.USER_EXITの例

SRW.USER_EXIT_FAILUREの例


SRW.SET_ATTR

  関連項目	  すべての例

SRW.SET_ATTRキャラクタ・モードの例

SRW.SET_ATTR書式マスクの例

SRW.SET_ATTRフィールド・カラー設定の例

SRW.SET_ATTRフィールド・テキスト属性設定の例

SRW.SET_ATTR垂直間隔設定の例

Webリンクの例


コール・インタフェースの例

  関連項目 	  関連項目

Adaの例

Cの例

COBOLの例

FORTRANの例

Pascalの例

PL/Iの例


配布の例

  関連項目      [image]  すべての例

.DSTファイルの例


データ・モデルの例

  関連項目 	  すべての例

ブレーク順序の例

列の例

データ・リンクの例

グループの例

マトリックスの例

問合せの例


ブレーク順序の例

  関連項目 	  すべての例

ブレーク順序の例（降順）

ブレーク順序の例(ORDER BY)


列の例

  関連項目 	  すべての例

式列

値を追加する式の例

条件付きの式の例

PL/SQLの例（式からPL/SQL関数を参照）

積順序の例（式）

ファイルからの読込み例（式列）

サマリー列

計算位置の例（グループ・レポート）

計算位置の例（マトリックス・レポート）

積順序の例（複数のグループ）

積順序の例（1つのグループ）


グループの例

  関連項目 	  すべての例

子クロス積の例（「いいえ」に設定）

子クロス積の例（「はい」に設定）

フィルタ・タイプの例

外部XMLタグの例

外部XML属性の例

リセット位置の例（グループ）

XMLタグの例

XMLタグ属性の例（グループ・レベル）


データ・リンクの例

  関連項目 	  すべての例

START WITHリンクの例

WHERE句リンクの例


問合せの例

  関連項目 	  すべての例

SQL問合せの例

バインド参照の例

字句参照の例

ファイルからの読込みの例（イメージ）

SELECT INTO文の例

SELECT文の例（複数の問合せからなるグループ上レポートの最初の問合せ）

SELECT文の例（ネストされたマトリックス）

SELECT文の例（複数の問合せからなるグループ上レポートの2番目の問合せ）

パラメータ参照元付きSELECT文の例

WHERE句付きSELECT文の例

SQL問合せ文の例

バインド参照および字句参照を含むSQL問合せ文の例

字句参照を含むSQL問合せ文の例

参照カーソル問合せの例

参照カーソルおよび関数付きパッケージの例

参照カーソル付きパッケージの例

関数をコールする参照カーソル問合せの例

参照カーソル問合せの例


電子メールの例

  関連項目 	  すべての例

バッチ・モードによるMAPI（Windows）電子メールの例（受信者の名前にアポストロフィが含まれる場合）

バッチ・モードによるMAPI（Windows）電子メールの例（氏名によって受信者を指定する場合）

MAPI（Windows）電子メールの例（受信者の名前にアポストロフィが含まれる場合）

MAPI（Windows）電子メールの例（氏名によって受信者を指定する場合）

Oracle*Mail（UNIX）電子メールの例（受信者を複数指定する場合）


Expressの例

  関連項目 	  すべての例

RWBLD60 の例

ユーザーID、パスワードおよびドメインを指定したOLAP_SERVERの例

ユーザーID、パスワードおよびドメインを指定していないOLAP_SERVERの例

RWRUN60 の例

ユーザーID、パスワードおよびドメインを指定したOLAP_SERVERの例

ユーザーID、パスワードおよびドメインを指定していないOLAP_SERVERの例


レイアウト・モデルの例

  関連項目 	  すべての例

アンカーの例

ボイラープレートの例

チャートの例

共通レイアウト・オブジェクトの例

フィールドの例

フレームおよび繰返しフレームの例

リンク・ファイルの例


共通レイアウト・オブジェクトの例

  関連項目 	  すべての例

ページ保護

ページ保護の例（グループ・レポート）

ページ保護の例（大きなオブジェクト）

ページ保護の例（小さなオブジェクト）

垂直拡張度

垂直拡張度の例（拡張）

垂直拡張度の例（可変）

Webリンク

Webリンクの例


アンカーの例

  関連項目 	  すべての例

フィールドを水平に中央揃えする例

フィールドを垂直に中央揃えする例

垂直方向および水平方向に縮小する例（フィールド）

垂直方向に縮小する例（フィールド）

「アンカー・オブジェクトと連動」の例


ボイラープレートの例

  関連項目 	  すべての例

「枠付きの行伸長」の例（格子表示）

最小孤立行の設定例（設定値1の場合と設定値2の場合）

ObjectWidthとObjectHeightのHTMLへの出力例

「印刷オブジェクト・オン」の例（オーバーフロー）

Webリンクの例


フィールドの例

  関連項目 	  すべての例

書式マスクの例

非表示フィールドの参照例

水平拡張度の例（フィールド）

ページ番号付けの例（「Nページ/全ページ」形式の場合）

ページ番号付けの例（ボディ・ページの場合）

ページ番号付けの例（繰返し枠のインスタンスの場合）

ソースの例

Webリンクの例


リンク・ファイルの例

  関連項目 	  すべての例

「印刷オブジェクト・オン」の例（すべて）

URLの例（イメージへのリンク）


フレームおよび繰返し枠の例

  関連項目 	  すべての例

列モードの例

水平拡張度の例（枠）

ページ当りの最大レコード数の例

最小孤立レコード数の例

ページ保護の例（グループ・レポート）

「印刷方向」の例（右/下）

プリンタ・コードの特別なフォントの例


印刷の例

  関連項目 	  すべての例

プロパティ・パレットの設定の例

「ページ当りの水平/垂直パネル」の例

「印刷方向」の例（右/下）

「印刷オブジェクト・オン」の例（すべて）

「印刷オブジェクト・オン」の例（オーバーフロー）

プリンタ定義の例

dec180.prtの例

declno3.prtの例

dflt.prtの例

hplwide.prtの例

psport85.prtの例

プリンタの例

プリンタ・コードの特別なフォントの例

PRINTER_INTRAYの例

SRW.SET_ATTRの例（プリンタ・トレイの切替え）

SRW.SET_PRINTER_TRAYの例


例

  アルファベット順のリスト

ビルトイン・パッケージの例

コール・インタフェースの例

データ・モデルの例

配布の例

電子メールの例

Expressの例

フォント・マッピングの例

インタプリタ・コマンドの例

レイアウト・モデルの例

Oracle8の例

パラメータ・フォームの例

PL/SQL V1変換の例

印刷の例

Query Builderの例

トリガーの例

ユーザー・イグジットの例

Webレポートの例

XMLの例


トリガーの例

  関連項目 	  すべての例

レポート・トリガーの例

データ・トリガーの例

レイアウト・トリガーの例


レポート・トリガーの例

  関連項目 	  すべての例

Between Pagesトリガー

SRW.SET_PRINTER_TRAYの例

設定属性プロシージャ

SRW.SET_BEFORE_REPORT_HTMLの例

SRW.SET_AFTER_REPORT_HTMLの例

SRW.SET_BEFORE_PAGE_HTMLの例

SRW.SET_AFTER_PAGE_HTMLの例

SRW.SET_BEFORE_FORM_HTMLの例

SRW.SET_AFTER_FORM_HTMLの例

SRW.SET_ATTR（下位互換のプレリリース2.1）

BEFPAGE_ESCAPEとAFTPAGE_ESCAPEの例

BEFREPORT_ESCAPEとAFTREPORT_ESCAPEの例

グラフィック・ページ・セパレータの例

ホーム・ページへのリンクの例


データ・トリガーの例

  関連項目 	  すべての例

グループ・フィルタ

グループ・フィルタの例

参照カーソル問合せ

参照カーソル付きパッケージの例

参照カーソルおよび関数付きパッケージの例

参照カーソルの例

参照カーソル問合せの例

関数をコールする参照カーソル問合せの例

式

値を追加する式の例

条件付きの式の例

妥当性チェック・トリガー

妥当性チェック・トリガーの例


レイアウト・トリガーの例

  関連項目 	  すべての例

アクション・トリガー

アクション・トリガーの例

フォーマット・トリガー

フォーマット・トリガーの例（値をハイライト表示する）

フォーマット・トリガーの例（フィールド間にカンマを配置する）

フォーマット・トリガーの例（ラベルを非表示にする）

フォーマット・トリガーの例（値を非表示にする）

フォーマット・トリガーの例（行のグループ間に空白行を挿入する）

SRW.SET_ATTRキャラクタ・モードの例

SRW.SET_ATTR書式マスクの例

SRW.SET_ATTRフィールド・カラー設定の例

SRW.SET_ATTRフィールド・テキスト属性設定の例

SRW.SET_ATTR垂直間隔の例

SRW.SET_ATTR Webリンクの例

設定属性プロシージャ

動的SRW.SET_BOOKMARKの例

動的SRW.SET_HYPERLINKの例

動的SRW.SET_LINKTAGの例

SRW.SET_BOOKMARKの例

SRW.SET_HYPERLINKの例

SRW.SET_LINKTAGの例

SRW.SET_PDF_ACTIONの例


ユーザー・イグジットの例

  関連項目 	  すべての例

完全なユーザー・イグジットの例

SRW.USER_EXITの例

SRW.USER_EXIT_FAILUREの例

SRW.USER.UNKNOWN_USER_EXITの例

ユーザー・イグジットの例

ユーザー・イグジット・コールの例


Webレポートの例

  関連項目 	  すべての例

プロパティ・パレットの設定の例

属性設定プロシージャの例

SRW.SET_ATTRの例（下位互換のプレリリース2.1）


プロパティ・パレットの設定の例

  関連項目 	  すべての例

Webリンク

Webリンクの例

HTMLドキュメントおよびページのヘッダーとフッター

ページ後値の例（GIFの挿入）

レポート後値の例（テキストの追加）

レポート後値の例（ホーム・ページへのリンク）

ページ前値の例

レポート前値の例

HTMLパラメータ・フォーム

フォーム後値の例（テキストの追加）

フォーム前値の例

ボイラープレート・テキスト・オブジェクトの例

大文字へのデフォルト入力の例

データ入力妥当性検査の例

選択の妥当性検査の例


Webリンクの例（プロパティ・パレット）

  関連項目 	  すべての例

アプリケーション・コマンド・ライン

アプリケーション・コマンド・ラインの例

ブックマーク

ブックマークの例（動的ブックマーク文字列）

ブックマークの例（インデント/順序指定付き）

ブックマークの例（順序指定のブックマーク・リスト）

ブックマークの例（順序指定のブックマーク・リスト、インデント）

ブックマークの例（静的ブックマーク文字列）

ハイパーリンク

チャート・ハイパーリンクの例

追加のハイパーリンク属性の例

ハイパーリンクの例（動的）

ハイパーリンクの例（リモート・サーバー上のHTMLドキュメントへのハイパーリンク）

ハイパーリンクの例（リモート・サーバー上のスクリプトへのハイパーリンク）

ハイパーリンクの例（静的）

ハイパーリンクの宛先

ハイパーリンクの宛先の例（動的）

ハイパーリンクの宛先の例（静的）


属性設定プロシージャの例

  関連項目 	  すべての例

Webリンクの例

Webリンクの例

HTMLドキュメントおよびページのヘッダーとフッターの例

SRW.SET_AFTER_PAGE_HTMLの例

SRW.SET_AFTER_REPORT_HTMLの例

SRW.SET_BEFORE_PAGE_HTMLの例

SRW.SET_BEFORE_REPORT_HTMLの例

HTMLパラメータ・フォームのヘッダーとフッターの例

SRW.SET_AFTER_FORM_HTMLの例

SRW.SET_BEFORE_FORM_HTMLの例


Webリンクの例（属性設定）

  関連項目 	  すべての例

SRW.SET_PDF_ACTION

SRW.SET_PDF_ACTIONの例

SRW.SET_BOOKMARK

動的SRW.SET_BOOKMARKの例

SRW.SET_BOOKMARKの例

SRW.SET_HYPERLINK

動的SRW.SET_HYPERLINKの例

SRW.SET_HYPERLINKの例

SRW.SET_LINKTAG

動的SRW.SET_LINKTAGの例

SRW.SET_LINKTAGの例


SRW.SET_ATTRの例（下位互換のプレリリース2.1）

  関連項目 	  すべての例

Webリンクの例

Webリンクの例

HTMLドキュメントおよびページのヘッダーとフッターの例

BEFPAGE_ESCAPEとAFTPAGE_ESCAPEの例

BEFREPORT_ESCAPEとAFTREPORT_ESCAPEの例

ホーム・ページへのリンクの例


Webリンクの例（SRW.SET_ATTR）

  関連項目 	  すべての例

ACTION

ACTIONの例

BOOKMARK

BOOKMARKの例

動的BOOKMARKの例

HYPERLINK

動的HYPERLINKの例

HYPERLINKの例

LINKTAG

動的LINKTAGの例

LINKTAGの例


XMLの例

  関連項目 	  すべての例

XMLプロパティの例

XML出力から除外の例（データ出力の制限）

XML出力から除外の例（冗長性の制限）

XMLタグを含む例

外部XML属性の例

外部XMLタグの例

XML Prolog値の例（Prolog型: ファイル）

XML Prolog値の例（Prolog型: テキスト）

XMLタグ属性の例（グループ・レベル）

XMLタグ属性の例（レポート・レベル）

XMLタグの例


実行プログラム名

  関連項目

実行プログラムのGUIモードが、システム固有のGUI以外のものかどうかを示すために、前記の実行プログラム名に文字を追加します。たとえば、「a」はApple MacintoshのGUIモード、「m」はMotifのGUIモードを示します（文字が追加されていない場合は、実行プログラムのGUIモードがそのシステム固有のGUIであることを示します）。さらに、「x」は、ユーザー・イグジットがその実行プログラムにリンクされているかどうかを示すのに使用されます。


実行プログラムの起動

  関連項目

実行プログラムは、次の2つの方法のいずれかで起動できます。

•	コマンド・ラインを使用します。

•	実行プログラムのアイコンをダブルクリックします。

実行引数  実行プログラムを起動するとき、実行プログラムの動作を制御する実行引数を入力できます。コマンド・ラインを介して実行プログラムを起動する場合、コマンド・ラインで、実行プログラム名の後に実行引数を入力します。


コマンド・ライン・オプションのヘルプ

  関連項目

コマンド・ラインを使用している場合、実行プログラム名の後に空白1つと疑問符1つを入力して[Return]リターン・キーを押すと、実行プログラムのコマンド・ライン・オプションを表示できます。たとえば、rwrun60 "?"のように入力します。

注意: 疑問符を引用符で囲む必要があるオペレーティング・システムもあります。たとえば、UNIXのCシェルでRWRUN60実行プログラムのコマンド・ライン・オプションを表示するには、rwrun60 "?"と入力する必要があります。


実行プログラム構文の制限

  関連項目

•	コマンド・ラインに実行プログラムを入力する場合、一般には次のような形式になります。

executable_name  keyword1=value1  keyword2=value2 ...

•	オペレーティング・システムに使用可能なコマンド・ラインがなく（Apple MacintoshまたはWindowsなど）、アイコンを使用して実行プログラムを起動する場合、実行引数の値を入力できるダイアログ・ボックスが表示されるか、実行引数の指定に「作業環境」ダイアログ・ボックス（「ツール」 [image] 「作業環境」）の「ランタイム値」および「ランタイム設定」タブが使用されることが必要な場合があります。

•	各keyword=valueは、実行引数と呼ばれます。キーワードを毎回入力するのは面倒なので、省略できます。

•	引数の等号の前後には、空白を入れません。

•	引数は、1つ以上の空白で区切ります。引数を区切るのにカンマを使用しないでください。

•	引数の値を一重または二重引用符で囲むことができます。一重または二重引用符の機能は、オペレーティング・システムによって異なります。

•	すべての引数のkeyword=の部分は、大/小文字の区別をしません。SOURCEおよびDEST、CMDFILE、TERM、DESNAME、DESFORMAT、DNAME、SNAME引数の値の部分は、使用しているオペレーティング・システムによって、大/小文字の区別が必要な場合があります。その他すべての引数の値の部分は、大/小文字の区別をしません。

•	キーワードは省略される場合があります。

•	コマンド・ラインから一重引用符を渡すには、2つの引用符（1つはエスケープとして、もう1つは実際の引用符として）を入力する必要があります。次に例を示します。

rwrun60 module=myrep destype=file desname=run.out batch=yes
p_value="Roy''s Batch Report"

FormsのRUN_PRODUCTパッケージ・プロシージャを使用して一重引用符の付いたパラメータ値を渡すには、4つの一重引用符を入力する必要があります（PL/SQLやReport Builderでは、2つの引用符を1つと見なします）。たとえば、次のリテラル値をReportsのパラメータに渡す場合、次のように入力します。

where '='

RUN_PRODUCTでは、次の文字列を入力します。

'where ''''='''''

•	引数に値として空の文字列を指定するには、keyword=またはkeyword =""を入力します。このように空の文字列を入力すると、ランタイム・パラメータ・フォームでは、初期値のかわりに引数の空の文字列を表示します。

•	すべてのファイルを参照するために、フル・パス名がサポートされています（desname=/revenues/q1/nwsalesなど）。フル・パスを指定しないと、ファイルの検索にはファイル・パス検索順序が使用されます。注意: レポートの移植性を確実にするために、Reports固有の環境変数REPORTS60_PATHを使用して、レポート、外部問合せ、外部PL/SQLライブラリ、テキスト・ファイル、図形などを参照できます。REPORTS60_PATHを使用すると、自分のレポートにディレクトリ・パスをハードコードしなくても、Report BuilderまたはReports Runtimeの外部に格納されているファイルにアクセスできます。

•	ランタイム・パラメータ・フォームから入力された値は、コマンド・ラインに入力された値を上書きします。たとえば、コマンド・ラインで、RWRUN60をCOPIES=1にして指定しても、ランタイム・パラメータ・フォームでCOPIES=2と指定すると、レポートのコピーは2つ生成されます。

同様に、コマンド・ラインに入力された値は、コマンド・ファイルで指定された値を上書きします。たとえば、コマンド・ラインからRWRUN60をCOPIES=1およびCMDFILE=RUNONE（コマンド・ファイル）として指定するとします。RUNONEでは、COPIESはRWRUN60コマンドによって2に設定されています。この場合、生成されるレポートのコピーは1つのみです。

DESTYPE、DESNAME、DESFORMAT、ORIENTATIONおよびCOPIESの値は、いろいろな場所で指定できます。次のリストは、これらの値を指定する場所の優先順位を示しています。リストの最初の項目は他すべての項目よりも優先順位が高く、2番目の項目は最初の項目を除くすべての項目よりも優先順位が高い、というようになります。

•	「印刷ジョブ」ダイアログ・ボックス

•	ランタイム・パラメータ・フォーム

•	「環境設定」ダイアログ・ボックスの「ランタイム値」タブおよび「ランタイム設定」タブ

•	コマンド・ライン上のキーワード

•	レポート定義で指定された値

•	「印刷」ダイアログ


キーワードの使用方法

各引数のkeyword=の部分は、引数が構文で指定される順で入力される限り、オプションです。引数の1つをスキップする場合は、スキップした引数の後にキーワードを使用する必要があります。

実行プログラムに4つの引数があり、1、2、4番目の引数のみを指定する場合、最初の2つはキーワードなしで指定できます。4番目の引数は、構文で指定された順で入力しないので、キーワードが必要です。

例（有効）:

次は、有効なコマンド・ライン・シーケンスの例です。

rwrun60 userid=scott/tiger paramform=no destype=mail
  desname=rmiller

rwrun60 scott/tiger no destype=mail desname=rmiller

この例では、キーワードDESTYPEを使用した後に、後続のすべての引数でもキーワードを使用していることに注意してください。一度キーワードを入力すると、コマンド・ラインの残りの引数もキーワードを使用する必要があります。

例（無効）:

次は、無効なコマンド・ライン・シーケンスの例です。

rwrun60 paramform=no scott/tiger destype=mail
  desname=rmiller

前述のシーケンスは、scott/tigerの入力が順序どおりではなく、USERIDキーワードが使用されていないので無効です。

rwrun60 scott/tiger mail rmiller no

前述のシーケンスは、値NOの入力が順序どおりではなく、PARAMFORMキーワードが使用されていないので無効です。


データベースへのログイン

  関連項目

次の方法でデータベースに接続できます。

•	明示的ログイン

•	自動ログイン

•	リモート・ログイン


明示的ログイン

USERIDキーワードを使用するか、または「ファイル」 [image] 「接続」を選択して、明示的にデータベースにログインできます。


ユーザーID

説明  ユーザーIDは、オプションのデータベース名またはリモート・データベースにアクセスするためのNet8サービス名、ODBCデータ・ソース名（非Oracleデータ・ソースにアクセスする場合）を持つOracleのユーザー名およびパスワードです。

オプションのNet8サービス名の詳細は、「リモート・ログイン」を参照してください。自動ログインの詳細は、「自動ログイン」を参照してください。

値

データベース接続の文字列は次の形式のいずれかで、長さは512バイトを超えないようにしてください。

username[/password]

username[/password][@database]

[user[/password]]@ODBC:datasource[:database] or [user[/password]]@ODBC:*


自動ログイン

Oracleの自動ログイン機能により、明示的にユーザー名とパスワードを指定しなくてもデータベースに接続できます。

この方法で接続する場合、Oracleではデフォルトのログイン（OPS$など）を使用して、Oracleユーザー名を、ご使用のオペレーティング・システムのユーザー名と関連付けます。自動ログイン・プロシージャを起動するには、次のいずれか1つを実行します。

•	コマンド・ラインでrwconv60 /を入力します。

•	「ログイン」画面に、ユーザー名としてスラッシュ（/）を入力します。

•	コマンド・ラインでユーザー名およびパスワードを省略し、[Return]キーを2回押して「ログイン」フォームを表示します。

注意: この方法でログインする場合、スラッシュの後に@databaseを入力すると、リモート・ログインにアクセスできます。

デフォルトのログインの詳細は、『Oracle8 Server SQLリファレンス』を参照してください。


リモート・ログイン

Net8を介して、リモート・データベース（使用しているコンピュータ上にないもの）を指定できます。リモート・ログイン機能を使用すると、リモート・データベースは透過的になります。詳細は、Oracle Net8のマニュアルを参照してください。

使用上の注意

•	リモート・アクセスを実行するには、ターゲット・データベースが常駐するリモート・コンピュータ・ノードのアカウントがあることが必要です。


RWBLD60

  コマンド・ライン引数 	  関連項目

説明  RWBLD60は、Report Builderを起動し、レポートの作成およびメンテナンスを行います。

構文

RWBLD60 [ [keyword=]value ] ...

ここで、keyword=valueは、有効なコマンド・ライン引数です。


RWBLD60コマンド・ライン引数

[MODULE|REPORT=]modulename

[USERID=]userid

[PARAMFORM=]{YES|NO}

[CMDFILE=]filename

[ARRAYSIZE=]n

[DESTYPE=]{SCREEN|FILE|PRINTER|PREVIEW|MAIL}

[DESNAME=]desname

[DESFORMAT=]desformat

[COPIES=]n

[CURRENCY=] currency_symbol

[THOUSANDS=] thousands_symbol

[DECIMAL=] decimal_symbol

[READONLY=]{YES|NO}

[BUFFERS=]n

[PAGESIZE=]width x height

[PROFILE=]profiler_file

[RUNDEBUG=]{YES|NO}

[ONSUCCESS=]{COMMIT|ROLLBACK|NOACTION}

[ONFAILURE=]{COMMIT|ROLLBACK|NOACTION}

[ERRFILE=]error_file

[LONGCHUNK=]n

[ACCESS=]{file|database}

[ORIENTATION=]{DEFAULT|LANDSCAPE|PORTRAIT}

[BACKGROUND=]{YES|NO}

[MODE=]{BITMAP|CHARACTER|DEFAULT}

[PRINTJOB]{YES|NO}

[TRACEFILE=]tracefile

[TRACEMODE=]{TRACE_APPEND|TRACE_REPLACE}

[TRACEOPTS=]{TRACE_ERR|TRACE_PRF|TRACE_BRK|TRACE_APP|
TRACE_PLS|TRACE_SQL|TRACE_TMS|TRACE_DST|TRACE_ALL|(opt1, opt2,...)}

[AUTOCOMMIT=]{YES|NO}

[NONBLOCKSQL=]{YES|NO}

[ROLE=]rolename/[rolepassword]

[BLANKPAGES=]{YES|NO}

[MAXIMIZE=]{YES|NO}

[DISABLEPRINT=]{YES|NO}

[DISABLEMAIL=]{YES|NO}

[DISABLEFILE=]{YES|NO}

[DISABLENEW=]{YES|NO}

[DISTRIBUTE=]{YES|NO}

[DESTINATION=]filename.DST

[CACHELOB=]{YES|NO}

[DELIMITER=]value

[CELLWRAPPER=]value

[NUMBERFORMATMASK=]mask

[DATEFORMATMASK=]mask

[PAGESTREAM=]{YES|NO}

[EXPRESS_SERVER=]"server=[server]/domain=[domain]/user=[userid]/password=[passwd]"

[CUSTOMIZE]=filename.xml | (filename1.xml, filename2.xml, . . .)

[SAVE_RDF]=filename.rdf

<param>=value


MODULE|REPORT

  RWBLD60の概要

説明  MODULE|REPORTは、Report Builderでオープンするモジュール（レポートまたは外部問合せ、外部PL/SQLライブラリ）です。(REPORTは、下位互換性のためのものです。)MODULE|REPORTを使用してレポートを指定しないと、Report Builderは、新規レポートの定義をオープンして起動します。

構文

[MODULE|REPORT=]runfile

値

任意の有効なレポートまたはXMLレポート定義(.XMLファイル)、外部問合せ、外部PL/SQLライブラリ名です。Report Builderは、モジュールのACCESSキーワードで指定した場所を検索します。ACCESSを指定しないと、Report Builderではファイル・パス検索順序を使用します。モジュールが見つからないと、Report Builderは指定したモジュールをオープンしないで起動します。

使用上の注意

•	ビットマップのRWBLD60を介してキャラクタ・モードのレポートをオープンする場合、Report Builderでは警告を表示してから、レポートを8.5 x 11インチのページ・サイズと7 x 6インチのフォーム・サイズを使用してオープンします。

•	レポートを実行（たとえば、ライブ・プレビューアで表示）するには、レポート定義は完全に行う必要があります（それ自身のデータ定義およびレイアウト定義が含まれていることなど）。レポート定義の一部のみを実行することはできません。

•	MODULE|REPORTキーワードを指定した場合、XMLレポート定義はXMLファイルの拡張子が指定されている必要があります。


PARAMFORM

  RWBLD60の概要

説明   PARAMFORMは、レポートの実行時にランタイム・パラメータ・フォームを表示するかどうかを指定します。

構文

[PARAMFORM=]{YES|NO}

値

YESの場合、フォームを表示します。

NOの場合、フォームを非表示にします。

デフォルト

YES


CMDFILE

  RWBLD60の概要

説明  CMDFILEは、RWBLD60コマンドの引数を含むファイルです。このオプションを使用すると、RWBLD60を起動するたびに多くの引数を指定しなくても、レポートを実行できます。

構文

[CMDFILE=]cmdfile

値

任意の有効なコマンド・ファイルです。

使用上の注意

•	コマンド・ファイルは、別のコマンド・ファイルを参照できます。

•	RWBLD60引数のコマンド・ファイル構文は、コマンド・ラインで使用される構文と同じです。

•	コマンド・ラインに入力した値は、コマンド・ファイルで指定した値を上書きします。たとえば、コマンド・ラインからCOPIES = 1およびCMDFILE = RUNONE（コマンド・ファイル）としてRWBLD60を指定するとします。RUNONEでは、COPIESは2に設定されています。この場合、生成されるレポートのコピーは1つのみです。詳細は、実行可能プログラム構文の制限を参照してください。

•	このキーワードの引数は、オペレーティング・システム固有の場合があります。


ARRAYSIZE

  RWBLD60の概要

説明  ARRAYSIZEは、Oracle配列処理用の配列サイズで、キロバイトで指定します。

構文

[ARRAYSIZE=]n

値

1から9,999までの数値です。つまり、Report Builderでは、レポートの問合せ1つに対してこのキロバイト数のメモリーを使用できます。

デフォルト

デフォルトの配列サイズは10です。Oracleの配列処理の詳細は、『Oracle8 Server管理者ガイド』を参照してください。


DESTYPE

  RWBLD60の概要

説明  DESTYPEは、レポート出力を受け取る宛先のデバイスのタイプです。

構文

[DESTYPE=]{SCREEN|FILE|PRINTER|PREVIEW|MAIL}

値

SCREEN	出力をプレビューアに送ります。
FILE	出力をDESNAMEで指定したファイルに保存します。
PRINTER	出力をDESNAMEで指定したプリンタに送ります。
PREVIEW	出力は対話形式で表示するためにプレビューアに送られます。ただし、Previewを指定すると、出力はPostScript出力としてフォーマットされます。プレビューアではDESNAMEを使用して、出力の表示にどのプリンタのフォントを使用するかを判断します。
MAIL	出力をDESNAMEで指定したメールIDに送ります。MAPI準拠またはサービス・プロバイダ・ドライバがインストールされているメール・システムであれば、メールを送ることができます。レポートは、添付ファイルとして送られます。
デフォルト

DESTYPEパラメータの初期値プロパティの設定値です。

使用上の注意

•	SYSOUTは、RWBLD60の使用中は、DESTYPEの有効なオプションではありません。SYSOUTが使用するのは、BATCH=YESのときのRWRUN60のみです。

•	DESTYPEをPRINTERまたはFILE、MAILに設定すると、非表示に指定していなければ、ランタイム・パラメータ・フォームを確定した後に、「印刷ジョブ」ダイアログ・ボックスが表示されます。「印刷ジョブ」ダイアログ・ボックスを適用すると、レポートが実行され、出力がプリンタ（「ファイル」 [image] 「プリンタ選択」で指定されている）またはファイル、メールIDに送られます。）オペレーティング・システムによって、ダイアログ・ボックスの外観は異なります。

•	このパラメータは、使用しているオペレーティング・システムによって上書きされる場合があります。

•	オペレーティング・システムによっては、一部のDESTYPE値がサポートされないことがあります。


DESNAME

  RWBLD60の概要

説明  DESNAMEは、レポート出力の送り先のファイル、プリンタ、あるいは電子メールID （または配布リスト）の名前です。電子メールでレポート出力を送るには、電子メール・アプリケーション（Windows上のMAPI準拠のアプリケーションや、UNIX上の固有のメール・アプリケーションなど）の場合と同様に電子メールIDを指定します。名前をカンマで区切ってカッコで囲むことによって、複数のユーザーを指定できます（(name, name, . . .name)など）。

構文

[DESNAME=]desname

値

長さが1Kを超えない任意の有効なファイル名またはプリンタ名、電子メールIDです。プリンタ名には、任意にポートを指定できます。次に例を示します。

DESNAME=printer,LPT1:

DESNAME=printer,FILE:

デフォルト

DESNAMEパラメータの初期値プロパティの設定値です。DESTYPE=FILEとDESNAMEが指定されていない場合、実行時にデフォルトで<reportname>.lisになります。

Usage Notes

•	DESTYPEがScreenの場合、このキーワードは無視されます。

•	DESTYPEがPreviewの場合、Report BuilderではDESNAMEを使用して、出力の表示にどのプリンタのフォントを使用するかを判断します。

•	このキーワードの引数は、使用しているオペレーティング・システムによっては、大/小文字の区別が必要な場合があります。

•	このパラメータは、使用しているオペレーティング・システムによって上書きされる場合があります。


DESFORMAT

  関連項目      [image]  RWBLD60の概要

説明  DESFORMATは、ビットマップ環境では、DESTYPEがFileの場合に使用するプリンタ・ドライバを指定します。キャラクタ・モード環境では、DESNAMEで指定したプリンタの特性を指定します。

構文

[DESFORMAT=]desformat

値

長さが1Kを超えない任意の有効な宛先フォーマットです。このキーワードの有効値の例として、hpl、hplwide、dec、decwide、decland、dec180、dflt、wideなどがあります。有効な宛先フォーマットのリストについては、システム管理者に問い合せてください。

PDF	レポート出力は、 PDF viewerで読み込むことのできるファイルに送られます。PDF出力は、ご使用のシステム用に現在構成されているプリンタをベースにしています。現在選択されているプリンタのドライバが、出力の作成に使用されます。レポートを実行しているマシン用に、プリンタを構成する必要があります。
HTML	レポート出力は、HTML3.0準拠のブラウザ（Netscape 2.2など）で読み込むことのできるファイルに送られます。
HTMLCSS	ファイルに送られるレポート出力には、カスケード・スタイル・シートをサポートするHTML3.0準拠のブラウザで読み込むことのできるスタイル・シート拡張が含まれます。
HTMLCSSIE	ファイルに送られるレポート出力には、Microsoft Internet Explorer 3.xで読み込むことのできるスタイル・シート拡張が含まれます。
RTF	レポート出力は、標準のワード・プロセッサ（Microsoft Wordなど）で読み込むことのできるファイルに送られます。MS-WORDでファイルをオープンする場合、レポート内のすべての図形およびオブジェクトを表示するには、「表示」 [image] 「ページ・レイアウト」を選択する必要があります。
DELIMITED	レポート出力は、標準のスプレッドシート・ユーティリティ（Microsoft Excelなど）で読み込むことのできるファイルに送られます。デリミタを選択しないと、デフォルトのデリミタはタブになることに注意してください。
XML	レポート出力は、第5世代以上のWebブラウザを含む任意のXMLをサポートするアプリケーションで読み込むことのできるファイルに送られます。
デフォルト

DESFORMATパラメータの初期値プロパティの設定値です。ビットマップReport Builderでは、DESFORMATがブランクまたはデフォルトの場合、現行のプリンタ・ドライバ（「ファイル」 [image] 「プリンタの選択」で指定）が使用されます。「プリンタの選択」で何も選択していない場合、デフォルトでPostScriptが使用されます。

使用上の注意

•	DESTYPEがScreenの場合、このキーワードは無視されます。

•	このキーワードの値は、使用しているオペレーティング・システムによっては、大/小文字の区別が必要な場合があります。


COPIES

  RWBLD60の概要

説明  COPIESは、印刷するレポート出力の部数です。

構文

[COPIES=]n

値

1～9,999までの任意の有効な整数です。

デフォルト

COPIESパラメータの初期値プロパティの設定値です。

使用上の注意

•	DESTYPEがPrinterでない場合、このキーワードは無視されます。

•	COPIESがランタイム・パラメータ・フォームで指定されていない場合、デフォルトで1に設定されます。


CACHELOB

  関連項目 	  RWBLD60 の概要

説明  CACHELOBは、抽出されたOracle8ラージ・オブジェクトを一時ファイル・ディレクトリ（REPORTS60_TMPによって指定）内にキャッシュとして格納するかどうかを指定します。

値

YESの場合、LOBを一時ファイル・ディレクトリにキャッシュします。

NOの場合、LOBを一時ファイル・ディレクトリにキャッシュしません。

デフォルト

YES

使用上の注意

•	このオプションは、コマンド・ラインからのみ設定できます。

•	一時ファイル・ディレクトリの場所に十分な空きディスク領域がない場合は、この値をNOに設定してください。ただし、値をNOに設定すると、サーバーから何度もLOBをフェッチすることになるため、パフォーマンスが低下する場合があります。


CURRENCY

  RWBLD60の概要

説明  CURRENCYは、数値書式に使用される通貨記号です。

構文

[CURRENCY=]currency_symbol

値

長さが1Kを超えない任意の有効な英数字文字列です。

デフォルト

Oracleのデフォルトは、Oracle各国語サポート機能によって決まります。CURRENCYパラメータの初期値プロパティに、4文字までのデフォルトを設定することもできます。

使用上の注意

•	プロパティ・パレットに入力されたCURRENCY値は、コマンド・ラインに入力されたCURRENCY値を上書きします。


THOUSANDS

  RWBLD60の概要

説明  THOUSANDSは、数値書式に使用される3桁区切り記号です。

構文

[THOUSANDS=]thousands_symbol

値

任意の有効な英数字です。

デフォルト

Oracleのデフォルトは、Oracle各国語サポート機能によって決まります。THOUSANDSパラメータの初期値プロパティに、4文字までのデフォルトを設定することもできます。

使用上の注意

•	パラメータ・プロパティ・シートに入力されたTHOUSANDS値は、コマンド・ラインに入力されたTHOUSANDS値を上書きします。

•	THOUSANDS値として定義した英数字が、実際に返される値になります。たとえば、THOUSANDS値として "," を定義した場合は、"," が返されます。


DECIMAL

  RWBLD60の概要

説明  DECIMALは、数値書式に使用される10進記号（インジケータ）です。

構文

[DECIMAL=]decimal_symbol

値

任意の有効な英数字です。

デフォルト

Oracleのデフォルトは、Oracle各国語サポート機能によって決まります。THOUSANDSパラメータの初期値プロパティに、デフォルトを設定することもできます。

使用上の注意

•	パラメータ・プロパティ・シートに入力されたDECIMAL値は、コマンド・ラインに入力されたDECIMAL値を上書きします。

•	DECIMAL値として定義した英数字が、実際に返される値になります。たとえば、DECIMAL値として "." を定義した場合は、"." が返されます。


READONLY

  制限      [image]  RWBLD60の概要

説明  READONLYは、レポートの複数の問合せにおける読込み一貫性を要求します。Oracleからデータにアクセスする場合、読込み一貫性はSET TRANSACTION READ ONLY文によって達成されます（SET TRANSACTION READ ONLYの詳細は、『Oracle8 Server SQLリファレンス』を参照）。

構文

[READONLY=]{YES|NO}

値

YESの場合、読込みの一貫性を要求します。

NOの場合、読込みの一貫性は要求されません。

デフォルト

NO

使用上の注意

•	Oracleでは、問合せが1つのレポートには、ロックせずに、読込み一貫性を自動的に提供するので、このキーワードが役に立つのは、複数の問合せを使用するレポートのみです。


READONLYの制限

•	レポート・トリガーの実行順序で、SET TRANSACTION READONLYがどこで発生するかに注意してください。


BUFFERS

  RWBLD60の概要

説明  BUFFERSは、仮想メモリー・キャッシュのサイズで、キロバイトで指定します。レポートの実行に十分な領域を確保する一方で、システムのリソースを使用し過ぎないように調整する必要があります。

構文

[BUFFERS=]n

値

1から9,999までの数値です。オペレーティング・システムによっては、上限がこれよりも低い場合があります。

デフォルト

640K

使用上の注意

•	この設定がセッションの途中で変更されても、変更は次のレポートが実行されるまで有効になりません。


PAGESIZE

  RWBLD60の概要

説明  PAGESIZEは、物理ページのサイズ（つまり、プリンタが出力するページのサイズ）です。ページには、レポートの内容が収まるだけの大きさが必要であることに注意してください。たとえば、レポートの枠サイズがページのサイズよりも大きくなると、レポートは実行されません。

構文

[PAGESIZE=]width x height

値

「ページ幅×ページの高さ」の形式で表される任意の有効なページ・サイズで、ページ幅およびページの高さは0（ゼロ）以上です。最大幅および高さは、サイズの単位によって異なります。インチでは、最大幅および高さは512インチです。センチメートルでは、1,312センチメートルです。パイカの場合、36,864パイカです。

デフォルト

ビットマップでは、8.5 x 11インチです。キャラクタ・モードでは、80 x 66文字です。レポートがキャラクタ・モードに設計されており、ビットマップ上で実行または変換中の場合、何も指定されていないと、ページ・サイズを判断するのに次の計算式が使用されます。（デフォルトのページ・サイズ * キャラクタ・ページ・サイズ）/デフォルトのキャラクタ・ページ・サイズ。たとえば、キャラクタ・ページ・サイズが80 x 20の場合、ビットマップ・ページ・サイズは、(8.5 * 80)/80 x (11 * 20)/66 = 8.5 x 3.33となります。

使用上の注意

•	物理ページの印刷可能領域が制限されているプリンタもあります。たとえば、プリンタ用紙は8.5 x 11インチでも、プリンタで印刷できる範囲が8 x 10.5インチしかない場合があります。Report Builderで、プリンタの印刷可能領域よりも大きいページ幅xページの高さを定義すると、レポート出力でクリッピングが発生する可能性があります。クリッピングを防ぐには、プリンタの印刷可能領域を拡大するか（オペレーティング・システムで可能な場合）、ページ幅×ページの高さをページの印刷可能な領域のサイズに設定します。

•	このキーワードを使用すると、その値はレポート定義のページのサイズを上書きします。

•	ランタイム・パラメータ・フォームに入力されたPAGESIZE値は、コマンド・ラインに入力されたPAGESIZE値を上書きします。


PROFILE

  RWBLD60の概要

説明  PROFILEは、レポートの実行に関するパフォーマンスの統計を格納するファイルの名前です。ファイル名を指定すると、Report Builderでは、レポートの実行にかかった経過時間およびCPU時間の統計を計算します。PROFILEは、次の統計を計算します。

•	合計経過時間は、RWBLD60を発行してからデザイナを終了するまでに経過した時間です。合計経過時間は、Report Builder時間とOracle時間の合計です。

•	時間は、Report Builderでかかった時間です。

•	Oracle時間は、データベースでかかった時間で、次のものから成り立っています。

•	UPIは、データベースへの接続およびSQLの解析、データのフェッチなどにかかった時間。

•	SQLは、SRW.DO_SQLの実行にかかった時間。

•	プロセスで使用された合計CPU時間は、デザイナの実行にかかったCPU時間。

注意: オペレーティング・システムには、データベースがReport Builderのプロセスに含まれているために、Report Builder時間にデータベース時間が含まれるものもあります。

構文

[PROFILE=]profiler_file

値

現行のディレクトリにある任意の有効なファイル名です。


RUNDEBUG

  RWBLD60の概要

説明  RUNDEBUGは、レポートの論理エラーのチェックを行うかどうかを指定します。RUNDEBUGは、エラーではないが、望ましくない出力結果になる可能性があるものをチェックします。RUNDEBUGは、次のものをチェックします。

•	別のオブジェクトとオーバーラップしているが、囲んではいない枠または繰返し枠。これにより、オブジェクトが出力で他のオブジェクトを上書きする可能性があります。

•	固定のサイズ設定ではない、ページ依存の参照元を持つレイアウト・オブジェクト。Report Builderでは、そのようなオブジェクトを、「垂直拡張度」および「水平拡張度」プロパティにかかわらず、固定サイズにします。

•	誤った頻度で参照されるPL/SQLのバインド変数。

構文

[RUNDEBUG=]{YES|NO}

値

YESの場合、追加のランタイム・エラーのチェックを実行します。

NOの場合、追加のランタイム・エラーのチェックを実行しません。

デフォルト

YES


ONSUCCESS

  RWBLD60の概要

説明  ONSUCCESSは、レポートの実行終了時に、COMMITまたはROLLBACKのどちらを実行するかを指定します。

構文

[ONSUCCESS=]{COMMIT|ROLLBACK|NOACTION}

値

COMMITの場合、レポートが終了するとCOMMITを実行します。

ROLLBACKの場合、レポートが終了するとROLLBACKを実行します。

NOACTIONの場合、レポートが終了しても何も行われません。

デフォルト

ユーザーIDが指定されている場合はCOMMITです。

ユーザーIDの指定がなく、外部ソース（Oracle Formsなど）からコールされる場合はNOACTIONです。

使用上の注意

•	ONSUCCESSのCOMMITまたはROLLBACKは、「After Reportトリガー」の起動後に実行されます。その他のCOMMITおよびROLLBACKは、これより前に発生する場合があります。詳細は、「READONLY」を参照してください。


ONFAILURE

  RWBLD60の概要

説明  ONFAILUREは、エラーが発生してレポートが終了できない場合に、COMMITまたはROLLBACKのどちらを実行するかを指定します。

構文

[ONFAILURE=]{COMMIT|ROLLBACK|NOACTION}

値

COMMITの場合、レポートが失敗するとCOMMITを実行します。

ROLLBACKの場合、レポートが失敗するとROLLBACKを実行します。

NOACTIONでは、レポートが失敗しても何も行いません。

デフォルト

ユーザーIDが指定されている場合は、ROLLBACKです。

ユーザーIDの指定がなく、外部ソース（Oracle Formsなど）からコールされる場合はNOACTIONです。

使用上の注意

•	ONFAILUREのCOMMITまたはROLLBACKは、レポートが失敗した後に実行されます。その他のCOMMITおよびROLLBACKは、これより前に発生する場合があります。詳細は、「READONLY」を参照してください。


ERRFILE

  RWBLD60の概要

説明  ERRFILEは、Report Builderでエラー・メッセージを格納するファイルの名前です。

構文

[ERRFILE=]error_file

値

任意の有効なファイル名です。


LONGCHUNK

  RWBLD60の概要

説明  LONGCHUNKは、Report BuilderでLONG列値を取り出す変更分のサイズ（キロバイト）です。LONG値を取り出す場合、メモリーのサイズに制限があるので、すべてを一度に取り出さずに、変更分に取り出せます。LONGCHUNKは、Oracle7およびOracle8にのみ適用されます。

構文

[LONGCHUNK=]n

値

1から9,999までの数値です。オペレーティング・システムによっては、上限がこれよりも低い場合があります。

デフォルト

10K


ACCESS

  RWBLD60の概要

説明 ACCESSは、モジュールをオープンする位置です。Report Builderでは、MODULEで指定したモジュールがこの位置で検索されます。ACCESSを指定しないと、Report Builderではファイル・パス検索順序を使用して、ファイルを検索します。

構文

[ACCESS=]{FILE|DATABASE}

値

FILE

database

デフォルト

FILE


ORIENTATION

  RWBLD60の概要

説明  ORIENTATIONは、レポートのページを印刷する方向を制御します。

構文

[ORIENTATION=]{DEFAULT|LANDSCAPE|PORTRAIT}

値

DEFAULTの場合、現行のプリンタの方向設定を使用します。

LANDSCAPEは横方向です。

PORTRAITは縦方向です。

デフォルト

DEFAULT

使用上の注意

•	キャラクタ・モードのレポートに、ORIENTATION=LANDSCAPEを設定する場合、プリンタ定義ファイルにLANDSCAPE句が含まれていることを確認する必要があります。

•	レポートをMotif版のPCLプリンタに出力する場合、印刷方向の設定は無視されます。レポートは、デフォルトの設定を使用して処理されます。


BACKGROUND

  RWBLD60の概要

説明  BACKGROUNDは、レポートをバックグラウンドで実行するかどうかを指定します。

構文

[BACKGROUND=]{YES|NO}

値

YESは、RWBLD60の有効なオプションではありません。

NO

デフォルト

NO


MODE

  RWBLD60の概要

説明   MODEは、レポートをキャラクタ・モードまたはビットマップのどちらで実行するかを指定します。これによって、キャラクタ・モードのレポートをビットマップのReport Builderから、またはビットマップのレポートをキャラクタ・モードのReport Builderから実行できます。たとえば、端末（vt220など）からPostScriptプリンタにレポートを送る場合、キャラクタ・モードのRWRUN60を起動し、MODE=BITMAPを指定してレポートを実行できます。Windowsでは、MODE=CHARACTERを指定すると、Report Builder ASCIIドライバが編集可能なASCII出力の作成に使用されます。

構文

[MODE=]{BITMAP|CHARACTER|DEFAULT}

値

BITMAP

DEFAULTの場合、使用されている現行の実行プログラムのモードでレポートを実行します。

CHARACTER

デフォルト

DEFAULT


PRINTJOB

  RWBLD60の概要

説明  PRINTJOBは、「印刷」ダイアログ・ボックスをレポートの実行前に表示するかどうかを指定します。

構文

[PRINTJOB=]{YES|NO}

値

YESまたはNO

デフォルト

YES

使用上の注意

•	レポートが、発生したプロセスとして実行される（つまり、RWRUN60などの実行プログラムが、RWBLD60などの別の実行プログラムからコールされる）場合、PRINTJOBの指定にかかわらず、「印刷」ダイアログ・ボックスは表示されません。

•	DESTYPE=MAILの場合、PRINTJOBの指定にかかわらず、「印刷」ダイアログ・ボックスは表示されません。


TRACEFILE

  RWBLD60の概要

説明  TRACEFILEは、Report Builderがトレース情報のログをとるファイルの名前です。

構文

[TRACEFILE=]tracefile

値

任意の有効なファイル名です。

使用上の注意

•	トレース情報は、.rdfファイルの実行時にのみ生成されます。.repファイルの実行時に、ロギングの指定はできません。

•	TRACEFILEのみでなくLOGFILEまたはERRFILEも指定する場合、すべてのトレース情報は、最後に指定したファイルに保存されます。たとえば、次の場合、err.logがRWRUN60コマンドで指定した最後のファイルなので、指定したトレース情報はすべてこのファイルに保存されます。

RWRUN60 MODULE=order_entry
USERID=scott/tiger
TRACEFILE=trace.log LOGFILE=mylog.log
ERRFILE=err.log


TRACEMODE

  RWBLD60の概要

説明  TRACEMODEは、Report Builderでトレース情報をファイルに追加するかまたはファイル全体を上書きするかを示します。

構文

[TRACEMODE=]{TRACE_APPEND|TRACE_REPLACE}

値

TRACE_APPENDは、新しい情報をファイルの終わりに追加します。

TRACE_REPLACEは、ファイルを上書きします。

デフォルト

TRACE_APPEND

使用上の注意

•	トレース情報は、.rdfファイルの実行時にのみ生成されます。.repファイルの実行時に、ロギングの指定はできません。


TRACEOPTS

  RWBLD60の概要

説明  TRACEOPTSは、レポートの実行時にトレース・ファイルにログをとるトレース情報を示します。

構文

[TRACEOPTS=]{TRACE_ERR|TRACE_PRF|TRACE_APP|TRACE_PLS|
TRACE_SQL|TRACE_TMS|TRACE_DST|TRACE_ALL|(opt1, opt2, ...)}

値

カッコ内のオプションのリストは、カッコ内のオプションをすべて使用するということです。たとえば、TRACE_OPTS=(TRACE_APP, TRACE_PRF)は、TRACE_APPおよびTRACE_PRFを適用するということです。

TRACE_ALLの場合、トレース・ファイルに、考えられるすべてのトレース情報のログをとります。

TRACE_APPの場合、トレース・ファイルに、すべてのレポート・オブジェクトのトレース情報のログをとります。

TRACE_BRKの場合、トレース・ファイルに、ブレーク・ポイントをリストします。

TRACE_DSTの場合、トレース・ファイルに、配布リストをリストします。この情報を使用して、どのセクションがどの宛先に送られたかを調べることができます。トレース・ファイル・フォーマットは、.DSTファイル・フォーマットと非常に似ているため、カット・アンド・ペーストによってトレース・ファイルから.DSTファイルを生成できます。

TRACE_ERRの場合、トレース・ファイルに、エラー・メッセージと警告をリストします。

TRACE_PLSの場合、トレース・ファイルに、すべてのPL/SQLオブジェクトのトレース情報のログをとります。

TRACE_PRFの場合、トレース・ファイルに、パフォーマンス統計のログをとります。

TRACE_SQLの場合、トレース・ファイルに、トレース情報のログをとります。

TRACE_TMSの場合、トレース・ファイルに、各エントリのタイムスタンプを入力します。

デフォルト

TRACE_ALL

使用上の注意

•	トレース情報は、.rdfファイルの実行時にのみ生成されます。.repファイルの実行時に、ロギングの指定はできません。


AUTOCOMMIT

  RWBLD60の概要

説明  データベースの変更（CREATEなど）をデータベースに自動的にコミットするかどうかを指定します。一部の非Oracleデータベース（SQL Serverなど）では、AUTOCOMMIT=YESを指定する必要があることに注意してください。

構文

[AUTOCOMMIT=]{YES|NO}

値

YESまたはNO

デフォルト

NO


NONBLOCKSQL

  RWBLD60の概要

説明  Report Builderでデータベースからデータをフェッチしている間に、他のプログラムを実行できるかどうかを指定します。

構文

[NONBLOCKSQL=]{YES|NO}

値

YESの場合、データがフェッチされている間、他のプログラムを実行できます。

NOの場合、データがフェッチされている間、他のプログラムを実行できません。

デフォルト

YES


ROLE

  関連項目      [image]  RWBLD60の概要

説明  ROLEは、実行時にそのレポートについて確認されるデータベースのロールを指定します。RWBLD60では、ROLEは無視されます。

構文

[ROLE=]{rolename/[rolepassword]}

値

有効なロールおよびロールのパスワード（オプション）です。


BLANKPAGES

  RWBLD60の概要

説明  BLANKPAGESは、レポートを印刷する際にブランク・ページを抑止するかどうかを指定します。このキーワードは、レポート出力時に、ブランク・ページを印刷しない場合に使用してください。

構文

[BLANKPAGES=]{YES|NO}

値

YESは、すべてのブランク・ページを印刷します。

NOはブランク・ページを印刷しません。

Default

YES

使用上の注意  BLANKPAGESは、論理ページが複数の物理ページ（またはパネル）にまたがっていて、すべての物理的なブランク・ページを印刷しない場合に特に便利です。


MAXIMIZE

  RWBLD60の概要

説明  MAXIMIZEは、Reports Runtimeのウィンドウを最大化するかどうかを指定します。このキーワードによるReport Builderへの影響はなく、Reports Runtimeでのみ使用されます。


DISABLEPRINT

  RWBLD60の概要

説明  DISABLEPRINTは、「ファイル」 [image] 「印刷」、「ファイル」 [image] 「ページ設定」、（Motif上での）「ファイル」 [image] 「プリンタ選択」およびランタイム・プレビューア内の同等のツールバー・ボタンを無効にするかどうかを指定します。

構文

[DISABLEPRINT=]{YES|NO}

値

YESまたはNO

Default

NO


DISABLEMAIL

  RWBLD60の概要

説明  DISABLEMAILは、ランタイム・プレビューア内の「メール」メニューおよび同等のツールバー・ボタンを無効にするかどうかを指定します。

構文

[DISABLEMAIL=]{YES|NO}

値

YESまたはNO

Default

NO


DISABLEFILE

  RWBLD60の概要

説明  DISABLEFILEは、ランタイム・プレビューア内の「ファイル」 [image] 「ファイル形式に出力」メニューを無効にするかどうかを指定します。

構文

[DISABLEFILE=]{YES|NO}

値

YESまたはNO

Default

NO


DISABLENEW

  RWBLD60の概要

説明  DISABLENEWは、ランタイム・プレビューアの新規インスタンスを表示する機能を抑止するために「表示」 [image] 「新規プレビューア」メニューを無効にするかどうかを指定します。

構文

[DISABLENEW=]{YES|NO}

値

YESまたはNO

Default

NO


DELIMITER

  RWBLD60の概要      [image]  関連項目

説明  DELIMITERは、レポート出力のセルを区切るために使用する文字（列）を指定します。

構文

[DELIMITER=]value

値

次のような任意の英数字または英数字の文字列を使用します。

,	各セルをカンマで区切ります。
.	各セルをピリオドで区切ります。
次の4つの予約済みの値を使用することもできます。

タブ	各セルをタブで区切ります。
スペース	各セルをスペースで区切ります。
リターン	各セルを改行で区切ります。
なし	デリミタを使用しません。
ASCIIキャラクタ・セットに基づくエスケープ・シーケンスを使用することもできます。

\t	各セルをタブで区切ります。
\n	各セルを改行で区切ります。
デフォルト

[Tab]

使用上の注意

•	この引数はDESFORMAT=DELIMITED. を指定した場合にのみ使用できます。


CELLWRAPPER

  RWBLD60の概要      [image]  関連項目

説明  CELLWRAPPERは、レポート出力の区切りセルの周囲に表示される文字（列）を指定します。

構文

[CELLWRAPPER=]value

Value

任意の英数字または英数字の文字列を使用します。

"	セルの両側に二重引用符が表示されます。
'	セルの両側に一重引用符が表示されます。
次の4つの予約済みの値を使用することもできます。

タブ	セルの両側にタブが表示されます。
スペース	セルの両側にシングル・スペースが表示されます。
リターン	セルの両側に改行が表示されます。
なし	セルの囲みを使用しません。
ASCIIキャラクタ・セットに基づくエスケープ・シーケンスを使用することもできます。

\t	セルの両側にタブが表示されます。
\n	セルの両側に改行が表示されます。
デフォルト

なし

使用上の注意

•	この引数はDESFORMAT=DELIMITED. を指定した場合にのみ使用できます。

•	セルの囲みは、実際のデリミタとは異なります。


DATEFORMATMASK

  RWBLD60の概要      [image]  関連項目

説明  DATEFORMATMASKは、デリミタ付きレポート出力の日付値の表示方法を指定します。

構文

[DATEFORMATMASK=]mask

値

任意の有効な日付書式マスクです。

使用上の注意

•	この引数は、DESFORMAT=DELIMITEDを指定した場合にのみ使用できます。


NUMBERFORMATMASK

  RWBLD60の概要      [image]  関連項目

説明  NUMBERFORMATMASKは、デリミタ付きレポート出力の数値の表示方法を指定します。

構文

[NUMBERFORMATMASK=]mask

値

任意の有効な数値書式マスクです。

使用上の注意

•	この引数は、DESFORMAT=DELIMITEDを指定した場合にのみ使用できます。


DESTINATION

  RWBLD60の概要      [image]  関連項目

説明  DESTINATIONキーワードを使用すると、現行の実行レポートの配布を定義する.DSTファイルの名前を指定できます。

構文

[DESTINATION=]filename.DST

値

.DSTファイルの名前です。

使用上の注意

•	DESTINATIONキーワードを使用可能にするには、コマンド・ラインからDISTRIBUTE=YESを指定する必要があります。


DISTRIBUTE

  RWBLD60の概要      [image]  関連項目

説明  DISTRIBUTEは、「配布」ダイアログ・ボックスまたは.DSTファイルで定義された配布リストに従って、レポート出力を複数の宛先に配布することを許可または禁止します。

構文

[DISTRIBUTE=]{YES|NO}

値

YESの場合、配布リストにレポートを配布します。

NOの場合、配布リストを無視して、DESNAMEおよびDESFORMATパラメータの指定に従ってレポートを出力します。これは基本的に、配布用のレポート・セットアップを実行するデバッグ・モードで、配布を実際には実行しません。

Default

NO

使用上の注意

•	DESTINATIONキーワードを使用可能にするには、DISTRIBUTE=YESを指定する必要があります。


PAGESTREAM

 RWBLD60の概要	 関連項目

説明  PAGESTREAMは、レポートをHTML出力またはHTMLCSS出力として書式設定するときに、レポートのページ・ストリームを許可または禁止します。レポートをHTML出力またはHTMLCSS出力として書式設定する場合、次のいずれかによって設定されるナビゲーション・コントロールを使用します。

•	レポート・プロパティ・パレットの「ページ・ナビゲーション・コントロール・タイプ」プロパティおよび「ページ・ナビゲーション・コントロール値」プロパティ

•	Before Reportトリガー(SRW.SET_PAGE_NAVIGATION_HTML)内のPL/SQL

構文

[PAGESTREAM=]{YES|NO}

値

YESの場合、ページはストリーム処理されます。

NOの場合、ページ・ストリームなしでレポートが出力されます。

デフォルト

NO


EXPRESS_SERVER
EXPESS_SERVER

 例

説明  EXPESS_SERVERは、接続するOLAP Serverを指定します。

構文

EXPRESS_SERVER="server=[server]/domain=[domain]/
user=[userid]/password=[passwd]"

RAMでの構文

EXPRESS_SERVER="server=[server]/domain=[domain]/
user=[userid]/password=[passwd]/ramuser=[ramuserid]/
rampassword=[rampasswd]/ramexpressid=[ramexpid]/
ramserverscript=[ramsscript]/rammasterdb=[ramdb]/
ramconnecttype=[ramconn]"

値

次の有効な接続文字列を二重引用符（"）で囲みます。

server	OLAP Server文字列（ncacn_ip_tcp:olap2-pc/sl=x/st=x/ct=x/sv=x/ など）。サーバー文字列の詳細は次を参照してください。
domain	OLAP Serverのドメイン。
user	OLAP ServerにログインするためのユーザーID。
password	ユーザーIDに対応するパスワード。
ramuser	RDBMSにログインするためのユーザーID。
rampassword	RDBMSに対応するパスワード。
ramexpressid	Oracle Sales AnalyzerデータベースのユーザーID。これはOracle Sales Analyzerデータベースに対してのみ必要となります。
ramserverscript	サーバー上のリモート・データベース構成ファイル（RDC）の完全なファイル名（フル・パスを含む）。このファイルではコードおよびデータベースの位置などの情報を指定します。UNC (Universal Naming Convention)構文を使用することにより、複数のユーザーが同一の接続を使用してデータにアクセスすることができ、データの位置に対して同じドライブ文字をマップする必要がありません。UNC構文のパスは、\\ServerName\ShareName\の後に任意のサブフォルダまたはファイル、あるいはその両方が続きます。
rammasterdb	最初に接続するRelational Access Managerデータベースの名前。データベースファイル名のみを指定する必要があります。このデータベースは、OLAP Serverに対するServerDBPathのパス・リストにインクルードされるディレクトリに常駐している必要があります。ServerDBPathは、「Express Configuration Manager」ダイアログ・ボックスのファイルI/Oタブでチェックできます。
ramconnecttype	Expressの接続のタイプです。ダイレクト接続に対しては常に0を指定します
パラメータ

server値には、Oracle Express Connection Editorで作成され、接続ファイル（.xcf）に格納されている設定に対応する4つのパラメータが含まれます。これら4つのパラメータはすべて必須で、どのような順序でも指定できます。次の表は、パラメータとその設定を示しています。

パラメータ	説明	設定
sl	サーバー・ ログイン	-2: ホスト（ドメイン・ログイン） -1: ホスト（サーバー・ログイン） 0: 認証不要 1: ホスト（ドメイン・ログイン）および接続セキュリティ 2: ホスト（ドメイン・ログイン）およびコール・セキュリティ 3: ホスト（ドメイン・ログイン）およびパケット・セキュリティ 4: ホスト（ドメイン・ログイン）および整合性セキュリティ 5: ホスト（ドメイン・ログイン）およびプライバシ・セキュリティ 注意:  Windows NTでは、すべての設定を使用します。UNIXシステムでは、0、-1、-2の設定のみを使用します。 これらの設定の詳細は、Express Connection Editorのヘルプ・システムを参照してください。
st	サーバー・ タイプ	1: OLAP Server
ct	接続タイプ	0: Express接続
sv	サーバー・ バージョン	1: Express 6.2以降
使用上の注意

•	文字列全体が引用符で囲まれているので、必要に応じて文字列にスペースを入れることができます（ユーザーIDがJohn Smithの場合など）。

•	文字列の中でスラッシュ（/）が必要な場合は、追加のスラッシュをエスケープ文字として使用してください。たとえば、ドメインがtools/reportsの場合、コマンド・ラインは次のようになります。

EXPRESS_SERVER="server=ncacn_ip_tcp:sburns2-pc/sl=0/
st=1/ct=0/sv=1/ domain=tools//reports"

•	文字列の中で一重引用符を使用することができます。二重引用符で囲まれているので、特別に扱われることはありません。


ユーザーID、パスワードおよびドメイン（RWBLD60）を指定したEXPRESS_SERVERの例
ユーザーID、パスワードおよびドメイン（RWBLD60）を指定したEXPESS_SERVERの例

  関連項目 	  すべての例

rwbld60 userid=scott/tiger@nt805
express_server="server=ncacn_ip_tcp:sburns2-pc/sl=0/st=1/ct=0/sv=1/
user=orbuild/domain=tools/password=buildme/"
report=exp.rdf destype=file desname=exp1.html
desformat=html batch=yes


ユーザーID、パスワードおよびドメイン(RWBLD60)を指定していないEXPRESS_SERVERの例
ユーザーID、パスワードおよびドメイン（RWBLD60）を指定していないEXPRESS_SERVERの例

  関連項目 	  すべての例

rwbld60 userid=scott/tiger@nt805
express_server="server=ncacn_ip_tcp:sburns2-pc/sl=0/st=1/ct=0/sv=1/"
report=exp.rdf destype=file desname=exp1.html
desformat=html batch=yes


RAM (RWBLD60)を指定したEXPRESS_SERVERの例
RAM（RWBLD60）を指定したEXPRESS_SERVERの例

  関連項目 	  すべての例

rwrun60 userid=scott/tiger@nt805
express_server="server=ncacn_ip_tcp:olap2-pc/sl=0/st=1/
ct=0/sv=1/ramuser=appqa/rampassword=appqa1/ramexpressid=appqa/
ramserverscript=\\olap3-pc\orant\olap\ram6202\ram\sqstnt.rdc/
rammasterdb=sqstnt.db/ramconnecttype=0"
report=exp.rdf destype=file desname=exp1.html
desformat=html batch=yes


CUSTOMIZE

説明  CUSTOMIZEは、MODULEまたはREPORTキーワードで選択したレポートに適用するXMLファイルまたはファイルのリストを指定します。XMLファイルには、レポート定義をなんらかの方法で変更するカスタマイズ（たとえば、フォントの変更またはカラーの変更）が含まれます。

詳細は、『Publishing Reports』マニュアルを参照してください。

構文

[CUSTOMIZE=]filename.xml|(filename1.xml, filename2.xml, _)

値

有効なXMLレポート定義（必要な場合にはファイル名の前に付けられているパス情報が指定されたXMLレポート定義）を含むファイルの名前。

使用上の注意

•	通常、XMLレポート定義のファイル拡張子はXMLですが、CUSTOMIZEキーワードが指定されている場合には必ずしもそうである必要はありません。


SAVE_RDF

説明  SAVE_RDFは、CUSTOMIZEキーワードで選択したXMLカスタマイズ・ファイルとともにMODULEまたはREPORTキーワードで選択したレポートに保存するファイルを指定します。この引数は、CUSTOMIZEキーワードを介してXMLファイルに適用する.RDFファイルを所有しており、この2つの組合わせを新規の.RDFファイルに保存する場合に最も有効です。

詳細は、『Publishing Reports』マニュアルを参照してください。

構文

[SAVE_RDF=]filename.rdf

値

任意の有効なファイル名です。


<param>

  RWBLD60の概要

説明  <param> は、レポートの定義の一部になるパラメータです。パラメータに指定する値は、そのパラメータの値として使用されます。

構文

<param>=value

値

そのパラメータの任意の有効な値です。

デフォルト

パラメータの「初期値」プロパティから取得されます。

使用上の注意

•	ランタイム・パラメータ・フォームのデフォルト値を上書きできます。

•	引数の値を一重または二重引用符で囲むことができます。一重または二重引用符の働きは、オペレーティング・システムによって異なります。

•	パラメータは未定義の値を参照する場合もあるため、PARAM値の解析または妥当性チェックは行われません。


?


RWCGI60

説明  RWCGI60は、WebサーバーとReports Server（RWMTS60）間のインタフェースを提供するReports Web CGI実行可能プログラムです。 使用しているのWebブラウザからレポートを動的に実行することができます。RWCGI60の詳細は、『Publishing Reports』を参照してください。


RWCLI60

  コマンド・ライン引数 	  関連項目

説明  RWCLI60はコマンド・ラインを解析し、指定されたReports Server (RWMTS60)に渡します。RWCLI60は、RWRUN60とよく似たコマンド・ラインを使用します。

構文

RWCLI60 MODULE|REPORT=runfile USERID=userid
[ [keyword=]value|(value1, value2, ...)] SERVER=tnsname

ここで、keyword=valueは、有効なコマンド・ライン引数です。

使用上の注意

•	クライアント・コマンド・ラインで指定されたすべてのファイル名とパスは、コマンド・ファイルを除いて、サーバー・マシン上のファイルとディレクトリを指します。

•	コマンド・ラインにCMDFILE=が含まれている場合、コマンド・ファイルは元のコマンド・ラインに読み込まれ、追加されてから、Reports Serverに送られます。ランタイム・エンジンによってコマンド・ファイルが再び読み込まれることはありません。


RWCLI60コマンド・ライン引数

[MODULE|REPORT=]runfile

[USERID=]userid

[PARAMFORM=]NO

[CMDFILE=]cmdfile

[TERM=]termtype

[ARRAYSIZE=]n

[DESTYPE=]{CACHE|LOCALFILE|FILE|PRINTER|SYSOUT|MAIL|XML}

[DESNAME=]desname

[DESFORMAT=]desformat

[CACHELOB=]{YES|NO}

[COPIES=]n

[CURRENCY=]currency_symbol

[THOUSANDS=]thousands_symbol

[DECIMAL=]decimal_symbol

[READONLY=]{YES|NO}

[LOGFILE=]logfile

[BUFFERS=]n

[BATCH=]YES

[PAGESIZE=]width x height

[PROFILE=]profiler_file

[RUNDEBUG=]{YES|NO}

[ONSUCCESS=]{COMMIT|ROLLBACK|NOACTION}

[ONFAILURE=]{COMMIT|ROLLBACK|NOACTION}

[KEYIN=]keyin_file

[KEYOUT=]keyout_file

[ERRFILE=]error_file

[LONGCHUNK=]n

[ORIENTATION=]{DEFAULT|LANDSCAPE|PORTRATI

[BACKGROUND=]{YES|NO}

[MODE=]{BITMAP|CHARACTER|DEFAULT}

[PRINTJOB]{YES|NO}

[TRACEFILE=]tracefile

[TRACEMODE=]{TRACE_APPEND|TRACE_REPLACE}

[TRACEOPTS=]{TRACE_ERR|TRACE_PRF|TRACE_APP|TRACE_PLS|
TRACE_SQL|TRACE_TMS|TRACE_DST|TRACE_ALL|(opt1, opt2, ...)}

[AUTOCOMMIT]{YES|NO}

[NONBLOCKSQL=]{YES|NO}

[ROLE=]rolename/[rolepassword]|(rolename/[rolepassword],. . .)

[BLANKPAGES=]{YES|NO}

[DISABLEPRINT=]{YES|NO}

[DISABLEMAIL=]{YES|NO}

[DISABLEFILE=]{YES|NO}

[DISABLENEW=]{YES|NO}

[DESTINATION=]filename.DST

[DISTRIBUTE=]{YES|NO}

[DELIMITER=]value

[CELLWRAPPER=]value

[DATEFORMATMASK=]mask

[NUMBERFORMATMASK=]mask

[PAGESTREAM=]{YES|NO}

[SERVER=]tnsname

[JOBNAME=]string

[SCHEDULE=]string

[TOLERANCE=]number

[DELIMITER=]value

[CELLWRAPPER=]value

EXPRESS_SERVER="server=[server]/domain=[domain]/user=[userid]/password=[passwd]"

[AUTHID]=username/password

[CUSTOMIZE]=filename.xml | (filename1.xml, filename2.xml, . . .)

[SAVE_RDF]=filename.rdf

<param>=value


PARAMFORM

  関連項目

説明  PARAMFORMを指定する場合は、NOとする必要があります。

構文

[PARAMFORM=]NO


DESTYPE

  関連項目

説明  DESTYPEは、レポート出力を受け取るデバイスのタイプです。

構文

[DESTYPE=]{CACHE|LOCALFILE|FILE|PRINTER|SYSOUT|MAIL}

値

CACHE	出力はReports Serverのキャッシュへ直接送られます。DESTYPE=CACHEには、DISTRIBUTEキーワードとの互換性がないことに注意してください。サーバーは、コマンド・ラインにDISTRIBUTEを見つけると、DESTYPE=CACHEコマンド・ライン引数を無視します。
LOCALFILE	出力はクライアント・マシン上のファイルへ送られ、BACKGROUNDの値にかかわらず、強制的に同期コールになります。
FILE	出力はDESNAMEで指定したサーバー・マシン上のファイルに送られます。
PRINTER	出力はDESNAMEで指定したサーバー・マシンのプリンタに送られます。
MAIL	出力はDESNAMEで指定されたメール・ユーザーに送られます。MAPI準拠またはサービス・プロバイダ・ドライバがインストールされているメール・システムであれば、メールを送ることができます。レポートは、添付ファイルとして送られます。
SYSOUT	出力はクライアント・マシンのデフォルトの出力デバイスに送られ、強制的に同期コールになります。
デフォルト

DESTYPEパラメータの初期値プロパティの設定値です。

使用上の注意

•	R30CLIでは、DESTYPEに画面およびプレビュー画面を指定できません。


BATCH

  関連項目

説明  BATCHを指定する場合は、YESとする必要があります。

構文

[BATCH=]YES


BACKGROUND

  関連項目

説明  BACKGROUNDは、コールが同期（BACKGROUND=NO）または非同期（BACKGROUND=YES）のいずれであるかを指定します。同期コールの場合、クライアントはレポートがキューに入り、ランタイム・エンジンに割り当てられ、実行、終了するのを待ちます。非同期コールの場合、クライアントはただコールを送るのみで、コールの完了を待ちません。同期コール中にクライアント・プロセスが強制終了されると、ジョブは取り消されます。

構文

[BACKGROUND=]{YES|NO}

値

YESまたはNO

デフォルト

NO


SERVER

  関連項目

説明  SERVERは、Reports ServerのTNSアドレスです。

構文

[SERVER=]tnsname

値

任意の有効なTNSNAMEです。

使用上の注意

•	Webサーバー・コンピュータで環境変数REPORTS60_REPORTS_SERVERを設定すると、デフォルト・サーバーに対して処理を要求する場合にSERVERコマンド・ライン引数を省略できます。あるいは、SERVERコマンド・ライン引数を組み込んでデフォルトを上書きすることもできます。


JOBNAME

  関連項目

説明  JOBNAMEは、Reports Queue Managerに表示されるジョブの名前です。コメントとして扱われ、ジョブの実行とは関係ありません。指定しない場合、レポート名がジョブ名として表示されます。

構文

[JOBNAME=]string


SCHEDULE

  関連項目

説明  SCHEDULEはスケジュール・コマンドです。デフォルトはnowです。スケジュール・コマンドを引用しなくてすむように、スペースのかわりにアンダースコア（_）を使用します。次に例を示します。

schedule=every_first_fri_of_month_from_15:53_Oct_23,_1999_retry_3_after_1_hour

schedule=last_weekday_before_15_from_15:53_Oct_23,_1999_retry_after_1_hour

注意: SCHEDULE構文の以前のフォームもサポートされますが、ここでは現行のSCHEDULE構文についてのみ説明します。

構文

[SCHEDULE=]string

ここで、stringは次のように指定します。

[FREQ from] TIME [retry {n} + after LEN]

FREQ	hourly | daily | weekly | monthly | {every LEN | DAYREPEAT}} | {last  {WEEKDAYS | weekday | weekend} before {n}+}
LEN	{n}+ {minute[s] | hour[s] | day[s] | week[s] | month[s]}
DAYREPEAT	{first | second | third | fourth | fifth} WEEKDAYS of month
WEEKDAYS	mon | tue | wed | thu | fri | sat | sun
TIME	now | CLOCK [DATE]
CLOCK	h:m | h:mm | hh:m | hh:mm
DATE	today | tomorrow | {MONTHS {d | dd} [,year]}
MONTHS	jan | feb | mar | apr | may | jun | jul | aug | sep | oct | nov | dec


TOLERANCE

  関連項目

説明  TOLERANCEは、重複ジョブ検出時間の許容範囲を分単位で示したものです。

構文

[TOLERANCE=]number


AUTHID

  関連項目

説明  AUTHIDは、保護されたReports Serverに対するユーザを認証するのに使用されるユーザ名およびパスワードです。セキュリティ検査の実行にはOracle WebDBが使用されます。WebDBにより、レポートを実行しているユーザは要求されたレポートを実行するのに必要なアクセス権限を持つことができるようになります。セキュリティの詳細は、Oracle WebDBのオンライン・ヘルプを参照してください。

ユーザが正常にログインすると、ブラウザは暗号化されたクッキーに送られ、これにより保護されたReports Serverに対するユーザの認証が行われます。デフォルトにより、クッキーは30分後には有効期限が切れます。クッキーが終了した場合、後続の要求（すでに保護されたサーバーへ送られているものなど）は、再び認証を受ける必要があります。

REPORTS60_COOKIE_EXPIRE環境変数を使用して認証クッキーの満了時間を変更できます。

ユーザーに対して認証を行い、そしてクッキーが終了するまでその認証を保持させる場合は、リポート要求からAUTHIDコマンドを省略します。ユーザーがWeb要求を出すたびに認証を行う場合は、Web CGIまたはWeb CartridgeコマンドのSHOWAUTHおよびAUTHYPE=SをレポートURLに組み込むか、%S引数をowscmd.dat (Web Cartridge)またはcgicmd.dat (Web CGI)ファイルのキー・マップ・エントリに組み込みます。

構文

[AUTHID=]username/password

値

Oracle WebDBで作成された任意の有効なユーザー名およびパスワード。WebDBに新規のユーザー・プロファイルを作成する場合はDBAに問い合わせてください。


ユーザーID

  関連項目

説明  ユーザーIDは、オプションのデータベース名またはリモート・データベースにアクセスするためのNet8サービス名、ODBCデータ・ソース名（非Oracleデータ・ソースにアクセスする場合）を持つOracleのユーザー名またはプレースホルダ・ユーザー名（たとえば、$username）およびパスワードです。

オプションのNet8サービス名の詳細は、「リモート・ログイン」を参照してください。自動ログインの詳細は、「自動ログイン」を参照してください。

ユーザーがデータベースへログインできるようにする場合は、レポート要求からUSERIDコマンドを省略します。ユーザーがWeb要求を出すたびにログオンできるようにする場合は、Web CGIまたはWeb CartridgeコマンドのSHOWAUTHおよび AUTHYPE=DをレポートURLに組み込むか、%D引数をowscmd.dat （Web Cartridge)またはcgicmd.dat (Web CGI)ファイルのキー・マップ・エントリに組み込みます。

値

データベース接続の文字列は次の形式のいずれかで、長さは512バイトを超えてはいけません。

username[/password]

username[/password][@database]

[user[/password]]@ODBC:datasource[:database] or [user[/password]]@ODBC:*

<$username>[/password]

<$username>[/password][@database]


?


RWCON60

  コマンド・ライン引数 	  関連項目

説明  RWCON60によって、1つ以上のレポート定義またはPL/SQLライブラリをある保存形式から別の保存形式に変換できます。

RWCON60を使用して、次のレポート変換を実行できます。

•	データベースに格納されたレポートを.rep、.rex、.rdfファイルまたはテンプレート（.tdfファイル）に変換

•	rdfファイルに格納されたレポートをrepファイル、rexファイル、またはデータベース・レポート、テンプレート（tdfファイル）に変換

•	rexファイルに格納されたレポートをデータベース・レポート、rdfファイル、repファイルまたはテンプレート（tdfファイル）に変換

RWCON60を使用して、次のPL/SQLライブラリ変換を実行できます。

•	データベースに格納されたライブラリをpldまたはpllファイルに変換

•	pldファイルに格納されたライブラリをデータベース・ライブラリまたはpllファイルに変換

•	pllファイルに格納されたライブラリをデータベース・ライブラリまたはpldファイルに変換

構文

rwcon60 [ [keyword=]value ] ...

keyword=valueは、有効なコマンド・ライン引数です。

使用上の注意

•	変換を行うと、変換処理の一部として、レポートのPL/SQLが自動的にコンパイルされる場合もあります。変換先がrexファイルでないと、PL/SQLは次の場合に、自動的にコンパイルされます。その他の状況では、自分でレポートのPL/SQLをコンパイルする必要があります（「プログラム」 [image] 「コンパイル」 [image] 「すべて」など）。

•	「変換」を使用してrepファイルを作成します。コンパイルでエラーが発生すると、エラー・メッセージが表示され、repファイルは作成されません。

•	ソース・レポートとしてrexファイルを使用します。コンパイルでエラーが発生すると、警告が表示されますが、変換は続行します。

•	ソース・レポートとして別のプラットフォーム上に作成されたレポートを使用します。コンパイルでエラーが発生すると、警告が表示されますが、変換は続行します。

•	フォントは、Report BuilderやReports Runtimeによってレポートをオープンしたときにマップされます。フォントは変換中にはマップされません。

•	レポートをテンプレートに変換する場合、レポートのヘッダー・ページとトレーラ・ページおよびマージン領域にあるオブジェクトのみがテンプレートに使用されます。ボディにあるオブジェクトは無視されます。

•	連結ライブラリ付きのレポートを変換する場合、レポートに連結されたpllファイルを変換してから、rdfファイルを変換する必要があります。


RWCON60コマンド・ライン引数

[USERID=]userid

[STYPE=]{DATABASE|PLLDB|PLDFILE|PLLFILE|
RDFFILE|REXFILE|XML}

[SOURCE=]{sname|(sname1,sname2,...)}

[DTYPE=]{DATABASE|PLLDB|PLDFILE|PLLFILE|
RDFFILE|REPFILE|REXFILE|TDFFILE|XML}

[DEST=]{dname|(dname1,dname2,...)|pathname}

[CMDFILE=]cmdfile

[LOGFILE=]logfile

[OVERWRITE=]{YES|NO|PROMPT}

[BATCH=]{YES|NO}

[DUNIT=]{CENTIMETER|CHARACTER|INCH|POINT}

[PAGESIZE=]width x height

[FORMSIZE=]width x height

[CUSTOMIZE=]filename.xml | (filename1.xml, filename2.xml, . . .)


STYPE

説明  STYPEは、変換するレポートまたはライブラリの形式です。

構文

[STYPE=]{DATABASE|PLLDB|PLDFILE|PLLFILE|RDFFILE|REXFILE|XML}

値

DATABASEの場合、ソース・レポートはOracleデータベースに格納されています。

PLLDBの場合、ソースPL/SQLライブラリはデータベースに格納されています。

PLDFILEの場合、ソースPL/SQLライブラリはASCII形式のファイルに格納されています。

PLLFILEの場合、ソースPL/SQLライブラリはソース・コードおよびPコードを含むファイルに格納されています。

RDFFILEの場合、ソース・レポートは1つ以上のレポート定義ファイル（拡張子rdfを持つファイル）に格納されています。

REXFILEの場合、ソース・レポートは1つ以上のテキスト・ファイル（拡張子rexを持つファイル）に格納されています。

XMLの場合、ソース・レポートは1つ以上のXMLファイル（拡張子xmlを持つファイル）に格納されています。

デフォルト

database


SOURCE

説明  SOURCEは、変換する1つのレポートまたはライブラリ、あるいはレポートまたはライブラリのリストです。RWCON60を実行するには、ソース・レポートまたはソース・ライブラリを指定する必要があります。

構文

[SOURCE=]{sname|(sname1,sname2,...)}

値

任意の有効なレポートまたはライブラリ名、あるいはファイル名（qandaなど）。

名前をカンマで区切り、カッコで囲んだ有効なレポートまたはライブラリ名、あるいはファイル名のリスト（(qanda,test,dmast)など）。

使用上の注意

•	データベースに格納されているレポートまたはライブラリには、SQLのワイルドカード文字（%および_）を使用できます。たとえばR%を指定すると、データベースに格納されているレポートのうちRで始まるものがすべてフェッチされます。該当するすべてのレポートが変換されます。

•	レポートまたはライブラリ名、あるいはファイル名のリストは、名前をカンマで区切り、カッコで囲む必要があります。次に例を示します。

(qanda,test,dmast)

(qanda, test, dmast)

•	ワイルドカード文字は、ファイルに格納されているレポートまたはライブラリ（拡張子rdf、rep、rex、pld、pllを持つもの）には無効です。

•	このキーワードの引数は、オペレーティング・システム固有の場合があります。

•	Oracleデータベースに格納されているレポートまたはライブラリを変換し、システム所有のReport Builder表を使用する場合、次の例のように、別のユーザーのレポートまたはライブラリをリストすることができます。

SOURCE=(sday.qanda,dsmith.test,dmast.sal)

•	ユーザー所有のReport Builder表を使用する場合、複数のユーザーからのレポートまたはライブラリは、各ユーザー用に個別に変換する必要があります。

•	レポートまたはライブラリを変換するには、これらを自分で作成済みであるかまたは自分が作成したものでない場合は、アクセス権限が付与されている必要があります。レポートまたはライブラリ名の前にユーザーIDが付いていない場合、ユーザーIDは現行のユーザーになります。

•	データベースからファイルへの変換で、データベースのレポートまたはライブラリ名がファイル名として長すぎると、Report Builderでは、使用しているオペレーティング・システムに適した長さのファイル名を指定するように要求します。


DTYPE

説明  DTYPEは、レポートまたはライブラリの変換後の形式です。

構文

[DTYPE=]{DATABASE|PLLDB|PLDFILE|PLLFILE|RDFFILE|REPFILE|REXFILE|TDFFILE|XML}

値

DATABASEの場合、変換されたレポートは、Oracleデータベースに格納されます。

PLLDBの場合、変換されたPL/SQLライブラリは、データベースに格納されます。

PLDFILEの場合、変換されたPL/SQLライブラリは、ASCII形式のファイルに格納されます。

PLLFILEの場合、変換されたPL/SQLライブラリは、ソース・コードおよびPコードを含むファイルに格納されます。

RDFFILEの場合、変換されたレポートは、1つ以上のレポート定義ファイル（拡張子rdfを持つファイル）に格納されます。

REPFILEの場合、変換されたレポートは、1つ以上のバイナリ実行ファイル（拡張子repを持つファイル）に格納されます。

REXFILEの場合、変換されたレポートは、1つ以上のテキスト・ファイル（拡張子rexを持つファイル）に格納されます。

TDFFILEの場合、レポートはテンプレート（tdfファイル）に変換されます。

XMLの場合、宛先レポートは1つ以上のXMLファイル（拡張子xmlを持つファイル）に格納されています。

デフォルト

REXFILE

使用上の注意

•	RWCON60を使用してrepファイルを作成する場合、ソース・レポートのPL/SQLは、自動的にコンパイルされます。コンパイルでエラーが発生すると、エラー・メッセージが表示され、repファイルは作成されません。こうならないように、repファイルを作成する前に、必ず「プログラム」 [image] 「コンパイル」を使用して、ソース・レポートのPL/SQLをコンパイルしてください。

•	レポートをテンプレートに変換する場合、レポートのヘッダー・ページとトレーラ・ページおよびマージン領域にあるオブジェクトのみがテンプレートに使用されます。ボディにあるオブジェクトは無視されます。


DEST

説明  DESTは、データベースに格納される場合の変換済みのレポートまたはライブラリの名前またはファイル名です。

構文

[DEST=]{dname|(dname1,dname2,...)|pathname}

値

任意の有効なレポートまたはライブラリ名、あるいはファイル名（qandaなど）。

名前をカンマで区切り、カッコで囲んだ有効なレポートまたはライブラリ名、あるいはファイル名のリスト（(qanda,test,dmast)など）。

デフォルト

DESTキーワードを指定しない場合、RWCON60は次のデフォルト名を使用します。

•	DTYPEがデータベースまたはPLLDBならば、DESTはSOURCEです。

•	DTYPEがPLDFILEならば、DESTはpld拡張子を持つSOURCEです。

•	DTYPEがPLLFILEならば、DESTはpllファイル拡張子を持つSOURCEです。

•	DTYPEがRDFFILEならば、DESTはrdf拡張子を持つSOURCEです。

•	DTYPEがREPFILEならば、DESTはrep拡張子を持つSOURCEです。

•	DTYPEがREXFILEならば、DESTはexpdat.rexです。

使用上の注意

•	レポートまたはライブラリ名、あるいはファイル名のリストは、名前をカンマで区切り、カッコで囲む必要があります。次に例を示します。

(qanda,test,dmast)

(qanda, test, dmast)

•	存在するソース名よりも指定した宛先名が多い場合、余分な宛先名は無視されます。存在するソース名よりも指定した宛先名が少ない場合、宛先名がなくなるとデフォルト名が使用されます。

•	このキーワードの引数は、オペレーティング・システム固有の場合があります。


CMDFILE

説明  CMDFILEは、RWCON60コマンドの引数を含むファイルです。このオプションを使用すると、レポートまたはライブラリを変換するのに、RWCON60を起動するたびに多くの引数を指定する必要がありません。

構文

[CMDFILE=]cmdfile

値

任意の有効なコマンド・ファイルです。

使用上の注意

•	コマンド・ファイルは、別のコマンド・ファイルを参照できます。

•	RWCON60引数のコマンド・ファイル構文は、コマンド・ライン上で使用される構文と同じです。

•	コマンド・ラインに入力した値は、コマンド・ファイルで指定した値を上書きします。たとえば、コマンド・ラインからRWRUN60をCOPIES=1およびCMDFILE=RUNONE（コマンド・ファイル）として指定するとします。RUNONEでは、COPIESは2に設定されています。この場合、生成されるレポートのコピーは1つのみです。詳細は、「コマンド・ライン構文ルール」を参照してください。

•	このキーワードの引数は、オペレーティング・システム固有の場合があります。


LOGFILE

説明  LOGFILEは状態およびエラー出力が送られるファイル名。

[LOGFILE=]logfile

値

任意の有効なファイル名です。

デフォルト

現行のディレクトリのdfltrep.logです。


OVERWRITE

説明  OVERWRITEは、既存のファイルまたはデータベース・オブジェクトを、変換済みのファイルまたはオブジェクトで上書きするかどうかを指定します。

構文

[OVERWRITE=]{YES|NO|PROMPT}

値

YESの場合、同名の既存のファイルまたはデータベース・オブジェクトを、自動的にすべて上書きします。

NOの場合、同名の既存のファイルまたはデータベース・オブジェクトがあっても、レポートを変換せず、警告メッセージを表示します。

PROMPTの場合、既存のファイルまたはデータベース・オブジェクトを上書きする前に、するかどうかの指示を要求します。

デフォルト

NO


BATCH

説明  BATCHは、レポートまたはライブラリの変換にユーザーが介入しないように、すべての端末入力および出力を非表示にします。

構文

[BATCH=]{YES|NO}

値

YESの場合、すべての端末入力および出力を抑止します。

NOの場合、特定の端末入力および出力を可能にします。「変換」ダイアログ・ボックスが表示され、ダイアログ・ボックスを確定すると、変換が実行されます。

デフォルト

NO


DUNIT

説明  DUNITは、レポートを変換する宛先のサイズの単位です。これを指定すると、DUNITは、ソース・レポートのサイズの単位と異なっている必要があります。これをブランクのままにしておくと、ソース・レポートのサイズの単位がDESTレポートのサイズの単位として使用されます。

構文

[DUNIT=]{CENTIMETER|CHARACTER|INCH|POINT}

値

CENTIMETERの場合、変換されたレポートは、サイズの単位として最初にセンチメートルを使用します。

CHARACTERの場合、変換されたレポートは、サイズの単位として最初に文字を使用します。

INCHの場合、変換されたレポートは、サイズの単位として最初にインチを使用します。

POINTの場合、変換されたレポートは、サイズの単位として最初にポイントを使用します。

デフォルト

ブランク


PAGESIZE

説明  PAGESIZEは、変換するレポートの論理ページのサイズを、宛先のサイズの単位（DUNITキーワードを使用して指定）で指定します。

構文

[PAGESIZE=]width x height

値

指定のサイズの単位でフォーム幅x高さの形をとる任意の有効値。

デフォルト

ビットマップでは、8.5 x 11インチです。キャラクタ・モードでは、80 x 66文字です。レポートがキャラクタ・モードに設計されており、ビットマップ上で実行または変換中の場合、何も指定されていないと、ページ・サイズを判断するのに次の計算式が使用されます。（デフォルトのページ・サイズ * キャラクタ・ページ・サイズ）/デフォルトのキャラクタ・ページ・サイズ。たとえば、キャラクタ・ページ・サイズが80 x 20の場合、ビットマップ・ページ・サイズは、(8.5 * 80)/80 x (11 * 20)/66 = 8.5 x 3.33となります。

使用上の注意

•	キャラクタ以外のDUNITでは、端数を指定するのに小数を使用できます（8.5 x 11など）。


FORMSIZE

説明  FORMSIZEは、変換するレポートのランタイム・パラメータ・フォームを、宛先のサイズの単位（DUNITキーワードを使用して指定）で指定します。

構文

[FORMSIZE=]width x height

値

指定のサイズの単位でフォーム幅x高さの形をとる任意の有効値。

使用上の注意

•	キャラクタ以外のDUNITでは、端数を指定するのに小数を使用できます（8.5 x 11など）。


CUSTOMIZE

説明  CUSTOMIZEは、SOURCEキーワードにリストされているレポートに適用するXMLファイルまたはファイルのリストを指定します。XMLファイルには、レポート定義を何らかの方法で変更するカスタマイズ（たとえば、フォントの変更またはカラーの変更）が含まれます。

詳細は、『Publishing Reports』マニュアルを参照してください。

構文

[CUSTOMIZE=]filename.xml | (filename1.xml, filename2.xml, . . .)

値

有効なXMLレポート定義（必要な場合にはファイル名の前にパス情報を指定）を含むファイル名またはファイル名のリスト。


?


RWMTS60

  関連項目

説明  RWMTS60はReports Serverの実行可能プログラムです。レポートを実行する複数階層アーキテクチャを実現するために、Reports Serverを使用することで、リモート・アプリケーション・サーバー上でレポートを実行できるようになります。RWMTS60をコマンド・ラインから起動するには、RWCLI60を使用します。

Reports Web Cartridge、Reports Web CGIまたはReports Servletと一緒に使用する場合、Reports Serverでは標準URL構文を使用して、Webブラウザからレポートを実行することも可能です。サーバーは、Windows NT、Windows 95またはUNIX上にインストールできます。サーバーは、すべてのリクエストをジョブ・キューに入れることによって、レポートの実行というクライアントの要求を処理します。サーバーのランタイム・エンジンの1つが有効になると、キュー内の次のジョブが実行されます。キューのジョブ数が増えるにつれて、サーバーは、サーバー・プロセス開始時に指定した最大制限数に達するまで、ランタイム・エンジンを追加して起動することができます。同様に、アイドル状態が指定時間を超えると、アイドル・エンジンは停止します。

レポートを自動実行させるのに、サーバーを利用することができます。スケジュール・コマンドを使用することで、レポートに対して時間と頻度を指定することが可能になります。サーバーは、事前に定義された過去のジョブの最大数を記録しています。ジョブがいつキューに並んだか、起動したか、そして終了したかの情報は、レポートの最終状態と一緒に保存されます。この情報は、Reports Queue Manager(RWRQM60)から取り出されるか、あるいはAPIを介してWindows上で見直すことができます。Reports Queue Managerは、Reports Serverと同じマシン上またはクライアント・マシン上に存在します。Unix上では、 Reports Queue Viewer(RWRQV60)を使用してReports Serverのキューを表示できます。


RWRQM60

説明  RWRQM60は、（Windowsプラットフォームでの）Reports Queue Managerの実行可能プログラムです。リモート・サーバー上でのレポートの実行をスケジュールするのに、Reports Server実行可能プログラム(RWMTS60)を使用する場合、Reports Queue Managerを使用すると、レポートの最終状態とともに、いつジョブがキューに並んだか、起動したか、そして終了したかを表示することができます。また、ジョブとサーバーを操作することもできます。Reports Queue Managerは、Reports Serverと同じマシン上またはクライアント・マシン上に存在します。

UNIX上では、 Reports Queue Viewer(RWRQV60)を使用してReports Serverのキューを表示できます。


RWRQV60

説明  RWRQV60は、（Unixプラットフォームでの） Reports Queue Viewer実行可能プログラムです。リモート・サーバ上でのレポートの実行をスケジュールするのにReports Server実行可能プログラム(RWMTS60)を使用する場合、Reports Queue Viewerを使用してReports Serverのキューを表示することができます。キーワード・ヘルプを表示するにはコマンド・ラインで、RWRQV60 "?"と入力します。

Windows上では、 Reports Queue Manager(RWRQM60)を使用してReports Serverのキューを表示および操作できます。


RWOWS60

説明 RWOWS60は、Oracle Web ServerとReports Server（RWMTS60）間の接続を容易にするReports Webカートリッジです。この接続で、WebクライアントがReports Server上でレポートを実行したり、クライアントWebブラウザ上でレポート出力を見ることが可能になります。他のWebカートリッジと同様、RWOWS60はWeb Request Broker対応の動的リンクライブラリ、または共有ライブラリです。このライブラリは特にOracle Web Application Serverのリスナーと対応しています。RWOWS60はReports Web CGI（R30CGI）の変わりであり、同じ機能を持っています。しかしOracle Web Application Server固有の統合にも対応しています。


RWRBE60

  関連項目

説明  RWRBE60はReportsバックグラウンド・エンジンです。RWRBE60はReportsバックグラウンド・エンジンは、コマンド・ラインがレポートを実行するのを待機します。コマンド・ラインを受け取ると、そのレポートをそのキューに入れます。一般に、Reportsバックグラウンド・エンジンでは、RUN_PRODUCTパッケージ・プロシージャからまたはSRW.RUN_REPORTを使用してレポートからコマンド・ラインを受け取ります。

構文:

rwrbe60

使用上の注意

•	RWRBE60は、以前のバージョンではR25SRVでコールされました。

•	RWRBE60実行可能プログラムは、ダブル・クリックして起動することもできます。

•	Windowsでは、RWISV60を使用してレポートをReportsバックグラウンド・エンジンに送り、実行することができます。これは、パフォーマンスのオーバーヘッドがReports Runtimeよりも少ないので、より効果的な方法です。RWISV60のコマンド・ライン引数は、RWRUN60のコマンド・ライン引数と同じです。

•	RWRBE60は、レポートをローカルに実行するときにのみ使用されます。Reports Server (RWMTS60)にレポートを送るには、RWCLI60を使用します。

•	RWRBE60はセッションを閉じる際、別のデータベースに対するレポートを実行するまでデータベースとのセッションを閉じることはしません。これはデータベースとの接続時間を減らすためです。


RWRUN60

  コマンド・ライン引数      [image]  関連項目

説明  RWRUN60は、レポート（つまり、rdfファイルまたはrepファイル）を対話形式またはバッチで実行します。

構文:

RWRUN60 [ [keyword=]value|(value1, value2, ...) ]

ここで、keyword=valueは、有効なコマンド・ライン引数です。

使用上の注意

•	repファイルを実行する場合、PL/SQLはすでにコンパイルされているので、再コンパイルはされません。rdfファイルを実行する場合は、必要に応じて、PL/SQLは自動的に再コンパイルされます（つまり、Report Builderのレポートをコンパイルまたは保存しなかったか、あるいは、レポートを実行しているプラットフォームまたはバージョンと、レポートを最後にコンパイルまたは保存したプラットフォームとの互換性がないとき）。

•	RWRUN60には2つのバージョンがあります。いずれのバージョンでもキャラクタ・モードまたはビットマップ・レポートを実行できることに注意してください。唯一の制約は出力デバイスです（ビットマップ・レポートをvt220の画面で実行できないなど）。

•	キャラクタ・モードの実行プログラムは、キャラクタ・モード・マシン（vt220など）からレポートを実行するユーザー用です。

•	GUI実行プログラムは、ビットマップ・マシン（Windows 95/NT稼動PCなど）からレポートを実行するユーザー用です。


RWRUN60コマンド・ライン引数

[MODULE|REPORT=]runfile

[USERID=]userid

[PARAMFORM=]{yes|no}

[CMDFILE=]cmdfile

[TERM=]termtype

[ARRAYSIZE=]n

[DESTYPE=]{SCREEN|FILE|PRINTER|PREVIEW|SYSOUT|MAIL}

[DESNAME=]desname

[DESFORMAT=]desformat

[CACHELOB=]{YES|NO}

[COPIES=]n

[CURRENCY=]currency_symbol

[THOUSANDS=]thousands_symbol

[DECIMAL=]decimal_symbol

[READONLY=]{yes|no}

[LOGFILE=]logfile

[BUFFERS=]n

[BATCH=]{yes|no}

[PAGESIZE=]width x height

[PROFILE=]profiler_file

[RUNDEBUG=]{yes|no}

[ONSUCCESS=]{COMMIT|ROLLBACK|NOACTION}

[ONFAILURE=]{COMMIT|ROLLBACK|NOACTION}

[KEYIN=]keyin_file

[KEYOUT=]keyout_file

[ERRFILE=]error_file

[LONGCHUNK=]n

[ORIENTATION=]{DEFAULT|LANDSCAPE|PORTRAIT}

[BACKGROUND=]{yes|no}

[MODE=]{BITMAP|CHARACTER|DEFAULT}

[PRINTJOB]{YES|NO}

[TRACEFILE=]tracefile

[TRACEMODE=]{TRACE_APPEND|TRACE_REPLACE}

[TRACEOPTS=]{TRACE_ERR|TRACE_PRF|TRACE_APP|TRACE_PLS|
TRACE_SQL|TRACE_TMS|TRACE_DST|TRACE_ALL|(opt1, opt2, ...)}

[AUTOCOMMIT=]{YES|NO}

[NONBLOCKSQL=]{yes|no}

[ROLE=]rolename/[rolepassword]

[BLANKPAGES=]{YES|NO}

[DISABLEPRINT=]{YES|NO}

[DISABLEMAIL=]{YES|NO}

[DISABLEFILE=]{YES|NO}

[DISABLENEW=]{YES|NO}

[DELIMITER=]value

[CELLWRAPPER=]value

[DATEFORMATMASK=]mask

[NUMBERFORMATMASK=]mask

[DESTINATION=]filename.DST

[DISTRIBUTE=]{YES|NO}

[PAGESTREAM=]{YES|NO}

EXPRESS_SERVER="server=[server]/domain=[domain]/user=[userid]/password=[passwd]"

[CUSTOMIZE]=filename.xml | (filename1.xml, filename2.xml, . . .)

[SAVE_RDF]=filename.rdf

<param>=value


MODULE|REPORT

  制限	  関連項目

説明  MODULE|REPORTは、実行するレポートの名前です。（REPORTは、下位互換性のためのものです。）

構文

[MODULE|REPORT=]runfile

値

任意の有効な実行ファイル（つまり、.rdfまたは.repの拡張子が付いたファイル）またはXMLレポート定義（.xmlファイル)です。ファイル拡張子を入力しないと、Reports Runtimeでは、最初に拡張子.repの付いたファイル、次に拡張子.rdfの付いたファイル、そして拡張子のないファイルの順に検索されます。Reports Runtimeでは、ファイルの検索にファイル・パス検索順序が使用されます。

使用上の注意

•	レポートを実行するには、レポート定義は完全に行う必要があります（それ自身のデータ定義およびレイアウト定義が含まれていることなど）。レポート定義の一部のみを実行することはできません。

•	MODULE|REPORTキーワードを指定した場合、XMLレポート定義ではXMLファイルの拡張子が指定されている必要があります。


MODULE|REPORTの制限

  関連項目

•	MODULE|REPORTを使用して実行ファイルを指定すると、「RWRUN60」ウィンドウは呼び出されません（この動作により、別のアプリケーションからRWRUN60へ連続的に入ることができます）。MODULE|REPORTを使って実行ファイルを指定せず、BATCH=NOを指定すると、「RWRUN60」ウィンドウがオープンし、対話形式でレポートを実行できます。

•	ビットマップのRWRUN60を介してキャラクタ・モードのレポートを実行する場合、Reports Runtimeでは警告を表示してから、8.5 x 11インチのページ・サイズと7 x 6インチのフォーム・サイズを使ってレポートを実行します。


PARAMFORM

  関連項目

説明  PARAMFORMは、レポートの実行時にランタイム・パラメータ・フォームを表示するかどうかを指定します。

構文

[PARAMFORM=]{YES|NO}

値

YESの場合、フォームを表示します。

NOの場合、フォームを非表示にします。

デフォルト

YES

使用上の注意

バッチ・モードでランタイム・パラメータ・フォームを表示しても無意味なので、PARAMFORM=YESでBATCH=YESは指定できません。


CMDFILE

  制限 	  関連項目

説明  CMDFILEは、RWRUN60コマンドの引数を含むファイルです。このオプションを使用すると、レポートを実行するたびに多くの引数を指定しなくても、レポートを実行できます。

構文

[CMDFILE=]cmdfile

値

任意の有効なコマンド・ファイルです。


CMDFILEの制限

•	コマンド・ファイルは、別のコマンド・ファイルを参照できます。

•	RWRUN60引数のコマンド・ファイル構文は、コマンド・ラインで使用される構文と同じです。

•	コマンド・ラインに入力した値は、コマンド・ファイルで指定した値を上書きします。たとえば、コマンド・ラインからRWRUN60をCOPIES=1およびCMDFILE=RUNONE（コマンド・ファイル）として指定するとします。RUNONEでは、COPIESは2に設定されています。 この場合、生成されるレポートのコピーは1つのみです。

•	このキーワードの引数は、オペレーティング・システム固有の場合があります。


TERM

  関連項目

説明  TERMは、RWRUN60を使っている端末のタイプです。TERMは、ランタイム・パラメータ・フォームおよびランタイム・プレビューアにのみ有効です。このキーワードが使用されるのは、キャラクタ・モードの場合のみです。

構文

[TERM=]termtype

値

任意の有効な端末のタイプです。

デフォルト

インストール状態によって異なります（システム管理者に問い合せてください）。

使用上の注意

•	このキーワードの引数は、使用しているオペレーティング・システムによっては、大／小文字の区別が必要な場合があります。


ARRAYSIZE

  関連項目

説明  ARRAYSIZEは、Oracle配列処理用の配列サイズ（キロバイト）です。一般に、配列サイズが大きいほど、レポートの実行速度は速まります。

構文

[ARRAYSIZE=]n

値

1～9,999までの数値です。つまり、Reports Runtimeは、レポートの問合せ1つに対してこのキロバイト数のメモリーを使用します。

デフォルト

デフォルトの配列サイズは10Kです。Oracleの配列処理の詳細は、『Oracle8 Server管理者ガイド』を参照してください。


DESTYPE

  関連項目

説明  DESTYPEは、レポート出力を受け取るデバイスのタイプです。

構文

[DESTYPE=]{SCREEN|FILE|PRINTER|PREVIEW|SYSOUT|MAIL}

値

SCREEN	出力は対話形式で表示するためにプレビューアに送られます。この値は、BATCH=NOの場合にのみ有効です。Screenでは、フォント・エイリアシングは実行されません。
FILE	出力はDESNAME（次に説明するキーワード）で指定したファイルに保存されます。
PRINTER	出力はDESNAME（次に説明するキーワード）で指定したプリンタに送られます。
PREVIEW	出力は対話形式で表示するためにプレビューアに送られます。ただし、Previewを指定すると、出力はPostScript出力としてフォーマットされます。プレビューアではDESNAMEを使って、出力の表示にどのプリンタのフォントを使用するかを判断します。Previewでは、フォント・エイリアシングが実行されます。
SYSOUT	出力はオペレーティング・システムのデフォルトの出力デバイスに送られます。この値は、BATCH=YESの場合にのみ有効です。
MAIL	出力はDESNAMEで指定されたメール・ユーザーに送られます。MAPI準拠またはサービス・プロバイダ・ドライバがインストールされているメール・システムであれば、メールを送ることができます。レポートは、添付ファイルとして送られます。
デフォルト

DESTYPEパラメータの初期値プロパティの設定値です。

使用上の注意

•	DESTYPEをPRINTER、FILEまたはMAILに設定すると、非表示に指定していなければ、ランタイム・パラメータ・フォームを確定した後に、「印刷ジョブ」ダイアログ・ボックスが表示されます。「印刷ジョブ」ダイアログ・ボックスを確定すると、レポートが実行され、出力がプリンタ（「ファイル」 [image] 「プリンタ選択」で指定されている）またはファイル、メールIDに送られます。オペレーティング・システムによって、ダイアログ・ボックスの外観は異なります。

•	このパラメータは、使用しているオペレーティング・システムによって上書きされる場合があります。

•	オペレーティング・システムによっては、一部のDESTYPE値がサポートされないことがあります。


DESNAME

  関連項目

説明  DESNAMEは、レポート出力の送り先のファイル、プリンタ、あるいは電子メールID （または配布リスト)の名前です。電子メールでレポート出力を送るには、電子メール・アプリケーション（Windows上のMAPI準拠のアプリケーションや、UNIX上の固有のメール・アプリケーションなど）の場合と同様に電子メールIDを指定します。名前をカンマで区切ってカッコで囲むことによって、複数のユーザーを指定できます（(name, name, . . .name)）。

構文

[DESNAME=]desname

値

長さが1Kを超えない任意の有効なファイル名またはプリンタ名、電子メールIDです。プリンタ名には、任意にポートを指定できます。次に例を示します。

DESNAME=printer,LPT1:

DESNAME=printer,FILE:

デフォルト

DESNAMEパラメータの初期値プロパティの設定値です。DESTYPE=FILEとDESNAMEが指定されていない場合、実行時にデフォルトで<reportname>.lisになります。

使用上の注意

•	DESTYPEがScreenまたはSysoutの場合、このキーワードは無視されます。

•	DESTYPEがPreviewの場合、Reports RuntimeではDESNAMEを使って、出力の表示にどのプリンタのフォントを使用するかを判断します。

•	このキーワードの引数は、使用しているオペレーティング・システムによっては、大／小文字の区別が必要な場合があります。

•	このパラメータは、使用しているオペレーティング・システムによって上書きされる場合があります。


DESFORMAT

  関連項目

説明  DESFORMATは、ビットマップ環境では、DESTYPEがFileの場合に使用するプリンタ・ドライバを指定します。キャラクタ・モード環境では、DESNAMEで指定したプリンタの特性を指定します。

構文

[DESFORMAT=]desformat

値

長さが1Kを超えない任意の有効な宛先フォーマットです。このキーワードの有効値の例として、hpl、hplwide、dec、decwide、decland、dec180、dflt、wideなどがあります。有効な宛先フォーマットのリストについては、システム管理者に問い合せてください。 さらに、Report Builderでは次の宛先フォーマットがサポートされます。

PDF	レポート出力は、PDFビューアで読み込むことのできるファイルに送られる。PDF出力は、ご使用のシステム用に現在構成されているプリンタをベースにしています。現在選択されているプリンタのドライバが、出力の作成に使用されます。レポートを実行しているマシン用に、プリンタを構成する必要があります。
HTML	レポート出力は、HTML3.0準拠のブラウザ（Netscape 2.2など）で読み込むことのできるファイルに送られる。
HTMLCSS	ファイルに送られるレポート出力には、カスケード・スタイル・シートをサポートするHTML3.0準拠のブラウザで読み込むことのできるスタイル・シート拡張が含まれる。
HTMLCSSIE	ファイルに送られるレポート出力には、Microsoft Internet Explorer 3.xで読み込むことのできるスタイル・シート拡張が含まれる。
RTF	レポート出力は、標準のワード・プロセッサ（Microsoft Wordなど）で読み込むことのできるファイルに送られる。MS-WORDでファイルをオープンする場合、レポート内のすべての図形およびオブジェクトを表示するには、「表示」 [image] 「ページ・レイアウト」を選択する必要があります。
XML	レポート出力はXMLドキュメントとなり、.XML拡張子のついた別個のファイルとして保存されます。このレポートは、XMLをサポートするブラウザで開いたり、読み込んだりできます。または選択したXML表示のアプリケーションに依存します。
DELIMITED	レポート出力は、標準のスプレッドシート・ユーティリティ（Microsoft Excelなど）で読み込むことのできるファイルに送られる。DELIMITERも指定する必要があります。
デフォルト

DESFORMATパラメータの初期値プロパティの設定値です。ビットマップのReports Runtimeでは、DESFORMATがブランクまたはdfltの場合、現行のプリンタ・ドライバ（「ファイル」 [image] 「プリンタの選択」で選択）が使用されます。「プリンタの選択」で何も選択していない場合、デフォルトでPostScriptが使用されます。

使用上の注意

•	DESTYPEがScreenまたはSysoutの場合、このキーワードは無視されます。

•	このキーワードの値は、ご使用のオペレーティング・システムによっては、大文字と小文字の区別が必要な場合があります。


COPIES

  関連項目

説明  COPIESは、印刷するレポート出力の部数を指定します。

構文

[COPIES=]n

値

1～9,999までの任意の有効な整数です。

デフォルト

COPIESパラメータの初期値プロパティの設定値です。

使用上の注意

•	DESTYPEがPrinterでない場合、このキーワードは無視されます。

•	COPIESがランタイム・パラメータ・フォームで指定されていない場合、デフォルトで1に設定されます。


CACHELOB

  関連項目

説明  CACHELOBは、取り出されたOracle8ラージ・オブジェクトを（REPORTS60_TMPで指定された）一時ファイル・ディレクトリにキャッシュするかどうかを指定します。

値

YESの場合、LOBを一時ファイル・ディレクトリにキャッシュします。

NOの場合、LOBを一時ファイル・ディレクトリにキャッシュしません。

デフォルト

YES

使用上の注意

•	このオプションは、コマンド・ラインからのみ設定できます。

•	一時ファイル・ディレクトリの場所に十分な空きディスク領域がない場合は、この値をNOに設定してください。ただし、値をNOに設定すると、サーバーから何度もLOBをフェッチすることになるため、パフォーマンスが低下する場合があります。


CURRENCY

  関連項目

説明  CURRENCYは、数値書式に使用される通貨記号です。

構文

[CURRENCY=]currency_symbol

値

長さが1Kを超えない任意の有効な英数字文字列です。

デフォルト

Oracleのデフォルトは、Oracle各国語サポート機能によって決まります。CURRENCYパラメータの初期値プロパティに、4文字までのデフォルトを設定することもできます。

使用上の注意

•	ランタイム・パラメータ・フォームに入力されたCURRENCY値は、コマンド・ラインに入力されたCURRENCY値を上書きします。


THOUSANDS

  関連項目

説明  THOUSANDSは、数値書式に使用される3桁区切り記号です。

構文

[THOUSANDS=]thousands_symbol

値

任意の有効な英数字です。

デフォルト

Oracleのデフォルトは、Oracle各国語サポート機能によって決まります。THOUSANDSパラメータの初期値プロパティに、デフォルトを設定することもできます。

使用上の注意

•	ランタイム・パラメータ・フォームに入力されたTHOUSANDS値は、コマンド・ラインに入力されたTHOUSANDS値を上書きします。

• 	THOUSANDS値として定義した英数字が、実際に返される値になります。たとえば、THOUSANDS値として "," を定義した場合は、"," が返されます。


DECIMAL

  関連項目

説明  DECIMALは、数値書式に使用される10進記号（インジケータ）です。

構文

[DECIMAL=]decimal_symbol

値

任意の有効な英数字です。

デフォルト

Oracleのデフォルトは、Oracle各国語サポート機能によって決まります。DECIMALパラメータの初期値プロパティに、デフォルトを設定することもできます。

使用上の注意

•	ランタイム・パラメータ・フォームに入力されたDECIMAL値は、コマンド・ラインに入力されたDECIMAL値を上書きします。

• 	DECIMAL値として定義した英数字が、実際に返される値になります。たとえば、DECIMAL値として "." を定義した場合は、"." が返されます。


READONLY

  関連項目

説明  READONLYは、レポートの複数の問合せにおける読込み一貫性を要求します。Oracleからデータにアクセスする場合、読込み一貫性はSET TRANSACTION READ ONLY文によって達成されます（SET TRANSACTION READ ONLYの詳細は、『Oracle8 Server SQLリファレンス』を参照）。

構文

[READONLY=]{YES|NO}

値

YESの場合、読込みの一貫性を要求します。

NOの場合、読込みの一貫性は要求されません。

デフォルト

NO

使用上の注意

•	Oracleは、1つの問合せを持つレポートでは、ロックせずに、読込み一貫性を自動的に提供するので、READONLYが役に立つのは、複数の問合せを使用するレポートのみです。


LOGFILE

  関連項目

説明  LOGFILEは、「ファイル」 [image] 「印刷」の出力の送り先のファイルの名前です。指定ファイルがすでにある場合、出力はそれに追加されます。このキーワードが使用されるのは、キャラクタ・モードの場合のみです。

構文

[LOGFILE=]logfile

値

任意の有効なファイル名です。

デフォルト

現行のディレクトリのdfltrep.logです。


BUFFERS

  関連項目

説明  BUFFERSは、仮想メモリー・キャッシュのサイズで、キロバイトで指定します。レポートの実行に十分な領域を確保する一方で、システムのリソースを使い過ぎないように調整する必要があります。

構文

[BUFFERS=]n

値

1から9,999までの数値です。オペレーティング・システムによっては、上限がこれよりも低い場合があります。

デフォルト

640K

使用上の注意

•	この設定がセッションの途中で変更されても、変更は次のレポートが実行されるまで有効になりません。


BATCH

  関連項目

説明  BATCHは、レポートの実行時にユーザーが介入しないように、すべての端末入力および出力を抑止します。BATCH=YESにすると、RWRUN60インタフェースを使用しなくても、レポートを実行できます。バックグラウンドでレポートを実行する方法は、「BACKGROUND」を参照してください。

構文

[BATCH=]{YES|NO}

値

YESの場合、すべての端末入力および出力を抑止します。

NOの場合、特定の端末入力および出力を可能にします。

デフォルト

NO

使用上の注意

•	BATCH=YESの場合、エラー・メッセージはSYSOUTに送られます。Sysoutの詳細は、「DESNAME」を参照してください。

•	BATCH=YESの場合、バッチ・モードでランタイム・パラメータ・フォームを表示しても無意味なので、PARAMFORM=YESは無効です。

•	BATCH=NOで、キャラクタ・モードのRWRUN60を使っている場合、ビットマップのレポートは実行できません（ビットマップのレポートはキャラクタ・モード・デバイスの画面で実行できません）。

•	BATCH=YES、MODE=BITMAPで、キャラクタ・モードのRWRUN60を使っている場合、キャラクタ・モードのレポートは実行できません。


PAGESIZE

  関連項目

説明  PAGESIZEは、物理ページのサイズ（つまり、プリンタが出力するページのサイズ）です。ページには、レポートの内容が収まるだけの大きさが必要であることに注意してください。たとえば、レポートの枠サイズがページのサイズよりも大きくなると、レポートは実行されません。

構文

[PAGESIZE=]width x height

値

「ページ幅×ページの高さ」の形式で表される任意の有効なページ・サイズで、ページ幅およびページの高さは0（ゼロ）以上です。最大幅および高さは、サイズの単位によって異なります。インチでは、最大幅および高さは512インチです。センチメートルでは、1,312センチメートルです。パイカの場合、36,864パイカです。

デフォルト

ビットマップでは、8.5 x 11インチです。キャラクタ・モードでは、80 x 66文字です。レポートがキャラクタ・モードに設計されており、ビットマップ上で実行または変換中の場合、何も指定されていないと、ページ・サイズを判断するのに次の計算式が使用されます。（デフォルトのページ・サイズ * キャラクタ・ページ・サイズ）/デフォルトのキャラクタ・ページ・サイズ。たとえば、キャラクタ・ページ・サイズが80 x 20の場合、ビットマップ・ページ・サイズは、(8.5 * 80)/80 x (11 * 20)/66 = 8.5 x 3.33となります。

使用上の注意

•	物理ページの印刷可能領域が制限されているプリンタもあります。たとえば、プリンタ用紙は8.5 x 11インチでも、プリンタで印刷できる範囲が8 x 10.5インチしかない場合があります。Reports Runtimeでプリンタの印刷可能領域よりも大きいページ幅×ページの高さを定義すると、レポート出力でクリッピングが発生する可能性があります。クリッピングを防ぐには、プリンタの印刷可能領域を拡大するか（オペレーティング・システムで可能な場合）、ページ幅×ページの高さをページの印刷可能な領域のサイズに設定します。

•	このキーワードを使用すると、その値はレポート定義のページのサイズを上書きします。

•	ランタイム・パラメータ・フォームに入力されたPAGESIZE値は、コマンド・ラインに入力されたPAGESIZE値を上書きします。


PROFILE

  関連項目

説明  PROFILEは、レポートの実行に関するパフォーマンスの統計を格納するファイルの名前です。ファイル名を指定すると、Reports Runtimeは、レポートの実行にかかった経過時間およびCPU時間の統計を計算します。PROFILEは、次の統計を計算します。

•	合計経過時間は、RWRUN60を発行してからレポートの実行を終えるまでに経過した時間です。合計経過時間は、Reports Runtime時間とOracle時間の合計です。

•	時間は、Reports Runtimeでかかった時間です。

•	Oracle時間は、データベースでかかった時間で、次のものから成り立っています。

•	UPIは、データベースへの接続およびSQLの解析、データのフェッチなどにかかった時間。

•	SQLは、SRW.DO_SQLの実行にかかった時間。

•	プロセスで使用された合計CPU時間は、レポートの実行にかかったCPU時間。

注意: オペレーティング・システムによっては、データベースがReports Runtimeのプロセスに含まれているために、Reports Runtime時間にデータベース時間が含まれるものもあります。

構文

[PROFILE=]profiler_file

値

現行のディレクトリにある任意の有効なファイル名です。


RUNDEBUG

  関連項目

説明  RUNDEBUGは、レポートの論理エラーのチェックを行うかどうかを指定します。RUNDEBUGは、エラーではないが、望ましくない出力結果になる可能性があるものをチェックします。RUNDEBUGは、次のものをチェックします。

•	別のオブジェクトとオーバーラップしているが、囲んではいない枠または繰返し枠。これにより、オブジェクトが出力で他のオブジェクトを上書きする可能性があります。

•	固定のサイズ設定ではない、ページ依存の参照元を持つレイアウト・オブジェクト。Reports Runtimeでは、そのようなオブジェクトを「垂直拡張度」および「水平拡張度」プロパティの設定にかかわらず、固定サイズにします。

•	誤った頻度で参照されるPL/SQLのバインド変数。

•	レポートはキャラクタ・モードまたはビットマップで、環境はその反対。

構文

[RUNDEBUG=]{YES|NO}

値

YESの場合、追加のランタイム・エラーのチェックを実行します。

NOの場合、追加のランタイム・エラーのチェックを実行しません。

デフォルト

NO


ONSUCCESS

  関連項目

説明  ONSUCCESSは、レポートの実行終了時に、COMMITまたはROLLBACKのどちらを実行するかを指定します。

構文

[ONSUCCESS=]{COMMIT|ROLLBACK|NOACTION}

値

COMMITの場合、レポートが終了するとCOMMITを実行します。

ROLLBACKの場合、レポートが終了するとROLLBACKを実行します。

NOACTIONの場合、レポートが終了しても何も行われません。

デフォルト

ユーザーIDが指定されている場合はCOMMITです。

ユーザーIDの指定がなく、外部ソース（Oracle Formsなど）からコールされる場合はNOACTIONです。

使用上の注意

•	ONSUCCESSのCOMMITまたはROLLBACKは、「After Reportトリガー」の起動後に実行されます。その他のCOMMITおよびROLLBACKは、これより前に発生する場合があります。詳細は、「READONLY」を参照してください。


ONFAILURE

  関連項目

説明  ONFAILUREは、エラーが発生してレポートが終了できない場合に、COMMITまたはROLLBACKのどちらを実行するかを指定します。

構文

[ONFAILURE=]{COMMIT|ROLLBACK|NOACTION}

値

COMMITの場合、レポートが失敗するとCOMMITを実行します。

ROLLBACKの場合、レポートが失敗するとROLLBACKを実行します。

NOACTIONでは、レポートが失敗しても何も行いません。

デフォルト

ユーザーIDが指定されている場合は、ROLLBACKです。

ユーザーIDの指定がなく、外部ソース（Form Builderなど）からコールされる場合はNOACTIONです。

使用上の注意

•	ONFAILUREのCOMMITまたはROLLBACKは、レポートが失敗した後に実行されます。その他のCOMMITおよびROLLBACKは、これより前に発生する場合があります。詳細は、「READONLY」を参照してください。


KEYIN

  関連項目

説明  KEYINは、実行時に実行するキーストローク・ファイルの名前です。KEYINは、KEYOUTで作成されたキーストローク・ファイルの実行に使用されます。KEYINは、キーストローク・ファイルの実行に使用されるので、キャラクタ・モード環境で実行している場合にのみ有効です。

構文

[KEYIN=]keyin_file

値

現行のディレクトリにある任意の有効なキー・ファイル名です。


KEYOUT

  関連項目

説明  KEYOUTは、Reports Runtimeによって、すべてのキーストロークを記録するキーストローク・ファイルの名前です。これを指定すると、キーストローク・ファイルを実行するのにKEYINを使用することができます。KEYOUTおよびKEYINは、レポートを実行するたびに実行する特定のキーストロークがある場合に便利です。これらはデバッグを行うのにも便利です。KEYOUTは、キーストローク・ファイルを作成するのに使用されるので、キャラクタ・モード環境でレポートを実行している場合にのみ有効です。

構文

[KEYOUT=]keyout_file

値

任意の有効なファイル名です。


ERRFILE

  関連項目

説明  ERRFILEは、Reports Runtimeによって、レポートの実行中に発行されたすべてのエラー・メッセージを格納するファイルの名前です。

構文

[ERRFILE=]error_file

値

任意の有効なファイル名です。


LONGCHUNK

  関連項目

説明  LONGCHUNKは、Reports RuntimeでLONG列値を取り出す変更分のサイズ（キロバイト）です。LONG値を取り出す場合、メモリーのサイズに制限があるので、すべてを一度に取り出さずに、変更分に取り出せます。LONGCHUNKは、Oracle7およびOracle8にのみ適用されます。

構文

[LONGCHUNK=]n

値

1から9,999までの数値です。オペレーティング・システムによっては、上限がこれよりも低い場合があります。

デフォルト

10K


ORIENTATION

  関連項目

説明  ORIENTATIONは、レポートのページを印刷する方向を制御します。

構文

[ORIENTATION=]{DEFAULT|LANDSCAPE|PORTRAIT}

値

DEFAULTの場合、現行のプリンタの方向設定を使用します。

LANDSCAPEの場合、用紙を横に使用します。

PORTRAITの場合、用紙を縦に使用します。

デフォルト

DEFAULT

使用上の注意

•	キャラクタ・モードのレポートに、ORIENTATION=LANDSCAPEを設定する場合、プリンタ定義ファイルにLANDSCAPE句が含まれていることを確認する必要があります。

•	レポートをMotif版のPCLプリンタに出力する場合、印刷方向の設定は無視されます。レポートは、デフォルトの設定を使用して処理されます。


BACKGROUND

  関連項目

説明  BACKGROUNDは、レポートをバックグラウンドで実行するかどうかを指定します。BACKGROUNDがYESの場合、別のプロセスが発生します。このオプションは、レポートの実行中に、フォアグラウンドで別の作業を行いたい場合に便利です。Windows 95/NTでは、BACKGROUND=YESを指定すると、レポートはReportsバックグラウンド・エンジンのキューに入れられます。

構文

[BACKGROUND=]{YES|NO}

値

YESまたはNO

デフォルト

NO

使用上の注意

•	Windowsでは、RWRBE60を使ってレポートをReportsバックグラウンド・エンジンに送り、実行できます。これは、パフォーマンスのオーバーヘッドがReports Runtimeよりも少ないので、より効果的な方法です。RWRBE60のコマンド・ライン引数は、RWRUN60のコマンド・ライン引数と同じです。

•	コマンド・ラインでは、BATCH=YES、DESTYPE=SCREENまたはPREVIEWあるいはRWBLD60の場合には、BACKGROUND=YESは使用できません。ただし、SRW.RUN_REPORTを使用している場合は、BATCH=YESでもBACKGROUND=YESが使用できます。

•	コマンド・ラインやSRW.RUN_REPORTからではなく、Reports Runtimeからレポートを実行する場合、レポートを実行する前に、Before FormトリガーおよびAfter Formトリガー、妥当性チェック・トリガーで行ったデータベースの変更をコミットする必要があります。この方法で実行している場合、これらのトリガーは、親プロセスのデータベース接続を共有します。ただし、レポートが実際に実行されると、個々のデータベース接続が確立されます。


MODE

  関連項目

説明   MODEは、レポートをキャラクタ・モードまたはビットマップのどちらで実行するかを指定します。これによって、キャラクタ・モードのレポートをビットマップのReports Runtimeからまたはビットマップのレポートをキャラクタ・モードのReports Runtimeから実行できます。たとえば、端末（vt220など）からPostScriptプリンタにレポートを送る場合、キャラクタ・モードのRWRUN60を起動し、MODE=BITMAPを指定してレポートを実行できます。Windows 95/NTでは、MODE=CHARACTERを指定すると、Reports RuntimeASCIIドライバが編集可能なASCII出力の作成に使用されます。

構文

[MODE=]{BITMAP|CHARACTER|DEFAULT}

値

BITMAP

DEFAULTの場合、使用されている現行の実行プログラムのモードでレポートを実行します。

CHARACTER

デフォルト

DEFAULT


PRINTJOB

  関連項目

説明  PRINTJOBは、「印刷」ダイアログ・ボックスをレポートの実行前に表示するかどうかを指定します。

構文

[PRINTJOB=]{YES|NO}

値

YESまたはNO

デフォルト

YES

使用上の注意

•	レポートが、発生したプロセスとして実行される（つまり、RWRUN60などの実行プログラムが、RWBLD60などの別の実行プログラムからコールされる）場合、PRINTJOBの指定にかかわらず、「印刷」ダイアログ・ボックスは表示されません。

•	DESTYPE=MAILの場合、PRINTJOBの指定にかかわらず、「印刷」ダイアログ・ボックスは表示されません。


TRACEFILE

  関連項目

説明  TRACEFILEは、Reports Runtimeがトレース情報のログをとるファイルの名前です。

構文

[TRACEFILE=]tracefile

値

任意の有効なファイル名です。

デフォルト

trace.dat

使用上の注意

•	トレース情報は、rdfファイルの実行時にのみ生成されます。repファイルの実行時に、ロギングの指定はできません。

•	TRACEFILEのみでなくLOGFILEまたはERRFILEも指定する場合、すべてのトレース情報は、最後に指定したファイルに保存されます。たとえば、次の場合、err.logがRWRUN60コマンドで指定した最後のファイルなので、指定したトレース情報はすべてこのファイルに保存されます。

rwrun60 MODULE=order_entry USERID=scott/tiger
TRACEFILE=trace.log LOGFILE=mylog.log
ERRFILE=err.log


TRACEMODE

  関連項目

説明  TRACEMODEは、Reports Runtimeでトレース情報をファイルに追加するかまたはファイル全体を上書きするかを示します。

構文

[TRACEMODE=]{TRACE_APPEND|TRACE_REPLACE}

値

TRACE_APPENDは、新しい情報をファイルの終わりに追加します。

TRACE_REPLACEは、ファイルを上書きします。

デフォルト

TRACE_APPEND

使用上の注意

•	トレース情報は、rdfファイルの実行時にのみ生成されます。repファイルの実行時に、ロギングの指定はできません。


TRACEOPTS

  関連項目

説明  TRACEOPTSは、 トレース・ファイルにログをとるトレース情報を示します。

構文

[TRACEOPTS=]{TRACE_ERR|TRACE_PRF|TRACE_APP|TRACE_PLS|
TRACE_SQL|TRACE_TMS|TRACE_DST|TRACE_ALL|(opt1, opt2, ...)}

値

カッコ内のオプションのリストは、カッコ内のオプションをすべて使用するということです。たとえば、TRACE_OPTS=(TRACE_APP, TRACE_PRF)は、TRACE_APPおよびTRACE_PRFを適用するということです。

TRACE_ALLの場合、トレース・ファイルに、考えられるすべてのトレース情報のログをとります。

TRACE_APPの場合、トレース・ファイルに、すべてのレポート・オブジェクトのトレース情報のログをとります。

TRACE_DSTの場合、トレース・ファイルに、配布リストをリストします。この情報を使って、どのセクションがどの宛先に送られたかを調べることができます。

TRACE_ERRの場合、トレース・ファイルに、エラー・メッセージと警告をリストします。

TRACE_PLSの場合、トレース・ファイルに、すべてのPL/SQLオブジェクトのトレース情報のログをとります。

TRACE_PRFの場合、トレース・ファイルに、パフォーマンス統計のログをとります。

TRACE_SQLの場合、トレース・ファイルに、トレース情報のログをとります。

TRACE_TMSの場合、トレース・ファイルに、各エントリのタイムスタンプを入力します。

デフォルト

TRACE_ALL

使用上の注意

•	トレース情報は、rdfファイルの実行時にのみ生成されます。repファイルの実行時に、ロギングの指定はできません。


AUTOCOMMIT

  関連項目

説明  AUTOCOMMITは、データベースの変更（CREATEなど）をデータベースに自動的にコミットするかどうかを指定します。一部の非Oracleデータベース（SQL Serverなど）では、AUTOCOMMIT=YESを指定する必要があることに注意してください。

構文

[AUTOCOMMIT=]{YES|NO}

値

YESまたはNO

デフォルト

NO


NONBLOCKSQL

  関連項目

説明  NONBLOCKSQLは、Reports Runtimeでデータベースからデータをフェッチしている間に、他のプログラムを実行できるかどうかを指定します。

構文

[NONBLOCKSQL=]{YES|NO}

値

YESの場合、データがフェッチされている間、他のプログラムを実行できます。

NOの場合、データがフェッチされている間、他のプログラムを実行できません。

デフォルト

YES


ROLE

  関連項目

説明  ROLEは、実行時にそのレポートについて確認されるデータベースのロールを指定します。ROLEを使用すると、通常はアクセス権限がないデータベースの表に問合せを行うレポートを実行できるので便利です。

構文

[ROLE=]rolename/[rolepassword]

値

有効なロールおよびロールのパスワード（オプション）です。


BLANKPAGES

  関連項目

説明  BLANKPAGESは、レポートを印刷する際にブランク・ページを抑止するかどうかを指定します。このキーワードは、レポート出力時に、ブランク・ページを印刷しない場合に使用してください。

構文

[BLANKPAGES=]{YES|NO}

値

YESは、すべてのブランク・ページを印刷します。

NOはブランク・ページを印刷しません。

デフォルト

YES

使用上の注意  BLANKPAGESは、論理ページが複数の物理ページ（またはパネル）にまたがっていて、すべての物理的なブランク・ページを印刷しないする場合に特に便利です。


DISABLEPRINT

  関連項目

説明  DISABLEPRINTは、「ファイル」 [image] 「印刷」、「ファイル」 [image] 「ページ設定」、（Motif上での）「ファイル」 [image] 「プリンタ選択」およびランタイム・プレビューア内の同等のツールバー・ボタンを無効にするかどうかを指定します。

構文

[DISABLEPRINT=]{YES|NO}

値

YESまたはNO

デフォルト

NO


DISABLEMAIL

  関連項目

説明  DISABLEMAILは、ランタイム・プレビューア内の「メール」メニューおよび同等のツールバー・ボタンを無効にするかどうかを指定します。

構文

[DISABLEMAIL=]{YES|NO}

値

YESまたはNO

デフォルト

NO


DISABLEFILE

  関連項目

説明  DISABLEFILEは、ランタイム・プレビューア内の「ファイル」 [image] 「ファイル形式に出力」メニューを無効にするかどうかを指定します。

構文

[DISABLEFILE=]{YES|NO}

値

YESまたはNO

デフォルト

NO


DISABLENEW

  関連項目

説明  DISABLENEWは、ランタイム・プレビューアの新規インスタンスを表示する機能を抑止するために「表示」 [image] 「新規プレビューア」メニューを無効にするかどうかを指定します。

構文

[DISABLENEW=]{YES|NO}

値

YESまたはNO

デフォルト

NO


DESTINATION

  関連項目

説明  DESTINATIONキーワードを使用すると、現在実行中のレポートの配布を定義する.DSTファイルの名前を指定できます。

構文

[DESTINATION=]filename.DST

値

レポートまたはレポート・セクションの配布を定義する.DSTファイルの名前です。

使用上の注意

•	DESTINATIONキーワードを使用可能にするには、コマンド・ラインからDISTRIBUTE=YESを指定する必要があります。


DISTRIBUTE

  関連項目

説明  DISTRIBUTEは、複数の宛先へのレポート出力の配布を使用可能または使用不可にします。 宛先は、レポート配布定義または.DSTファイルに定義された配布リストで指定します。

構文

[DISTRIBUTE=]{YES|NO}

値

YESの場合、配布リストにレポートを配布します。

NOの場合、配布リストを無視して、DESNAMEおよびDESFORMATパラメータの指定に従ってレポートを出力します。これは基本的に、配布用のレポート・セットアップを実行するデバッグ・モードで、配布を実際には実行しません。

デフォルト

NO

使用上の注意

•	DESTINATIONキーワードを使用可能にするには、DISTRIBUTE=YESを指定する必要があります。


 DELIMITER

  関連項目

説明  DELIMITERは、レポート出力のセルを区切るために使用する文字（列）を指定します。

構文

[DELIMITER=]value

値

次のような任意の英数字または英数字の文字列を使用します。

,	各セルをカンマで区切ります。
.	各セルをピリオドで区切ります。
次の4つの予約済みの値を使用することもできます。

タブ	各セルをタブで区切ります。
スペース	各セルをスペースで区切ります。
リターン	各セルを改行で区切ります。
なし	デリミタを使用しません。
ASCIIキャラクタ・セットに基づくエスケープ・シーケンスを使用することもできます。

\t	各セルをタブで区切ります。
\n	各セルを改行で区切ります。
デフォルト

Tab

使用上の注意

この引数は、DESFORMAT=DELIMITEDを指定した場合にのみ使用できます。


 CELLWRAPPER

  関連項目

説明  CELLWRAPPERは、レポート出力の区切りセルの周囲に表示される文字（列）を指定します。

構文

[CELLWRAPPER=]value

値

任意の英数字または英数字の文字列を使用します。

"	セルの両側に二重引用符が表示されます。
'	セルの両側に一重引用符が表示されます。
次の4つの予約済みの値を使用することもできます。

タブ	セルの両側にタブが表示されます。
スペース	セルの両側にシングル・スペースが表示されます。
リターン	セルの両側に改行が表示されます。
なし	セルの囲みを使用しません。
ASCIIキャラクタ・セットに基づくエスケープ・シーケンスを使用することもできます。

\t	セルの両側にタブが表示されます。
\n	セルの両側に改行が表示されます。
デフォルト

なし

使用上の注意

•	この引数は、DESFORMAT=DELIMITEDを指定した場合にのみ使用できます。

•	セルの囲みは、実際のデリミタとは異なります。


 DATEFORMATMASK

  関連項目

説明  DATEFORMATMASKは、デリミタ付きレポート出力の日付値の表示方法を指定します。

構文

[DATEFORMATMASK=]mask

値

任意の有効な日付書式マスクです。

使用上の注意

•	この引数は、DESFORMAT=DELIMITEDを指定した場合にのみ使用できます。


 NUMBERFORMATMASK

  関連項目

説明  NUMBERFORMATMASKは、デリミタ付きレポート出力の数値の表示方法を指定します。

構文

[NUMBERFORMATMASK=]mask

値

任意の有効な数値書式マスクです。

使用上の注意

•	この引数は、DESFORMAT=DELIMITEDを指定した場合にのみ使用できます。


PAGESTREAM

  関連項目

説明  PAGESTREAMは、レポートの開発者が次のいずれかを使って設定したナビゲーション・コントロールを使用して、レポートをHTMLまたはHTMLCSS出力としてフォーマットするときにページ・ストリームを使用可能または使用不可にします。

•	レポート・プロパティ・パレットの「ページ・ナビゲーション・コントロール・タイプ」および「ページ・ナビゲーション・コントロール値」プロパティ。

•	Before ReportトリガーのPL/SQL(SRW.SET_PAGE_NAVIGATION_HTML)。

構文

[PAGESTREAM=]{YES|NO}

値

YESの場合、ページはストリーム処理されます。

NOの場合、ページ・ストリームなしでレポートが出力されます。

デフォルト

NO


EXPRESS_SERVER

  関連項目

説明  EXPRESS_SERVERは、接続するOLAP Serverを指定します。

構文

EXPRESS_SERVER="server=[server]/domain=[domain]/
user=[userid]/password=[passwd]"

RAMでの構文

EXPRESS_SERVER="server=[server]/domain=[domain]/
user=[userid]/password=[passwd]/ramuser=[ramuserid]/
rampassword=[rampasswd]/ramexpressid=[ramexpid]/
ramserverscript=[ramsscript]/rammasterdb=[ramdb]/
ramconnecttype=[ramconn]"

値

次の有効な接続文字列を二重引用符（"）で囲みます。

server	OLAP Server文字列（ncacn_ip_tcp:olap2-pc/sl=x/st=x/ct=x/sv=x/ など）。
Domain	OLAP Serverのドメイン。
User	OLAP ServerにログインするためのユーザーID。
Password	ユーザーIDに対応するパスワード。
ramuser	RDBMSにログインするためのユーザーID。
rampassword	RDBMSに対応するパスワード。
ramexpressid	Oracle Sales AnalyzerデータベースのユーザーID。これはOracle Sales Analyzerデータベースに対してのみ必要となります。
ramserverscript	サーバー上のリモート・データベース構成ファイル（RDC）の完全なファイル名（フル・パスを含む）。このファイルではコードおよびデータベースの位置などの情報を指定します。UNC (Universal Naming Convention)構文を使用することにより、複数のユーザーが同一の接続を使用してデータにアクセスすることができ、データの位置に対して同じドライブ文字をマップする必要がありません。UNC構文のパスは、\\ServerName\ShareName\ となり、その後に任意のサブフォルダまたはファイル、あるいはその両方が続きます。
rammasterdb	最初に接続するRelational Access Managerデータベースの名前データベース・ファイル名のみを指定する必要があります。このデータベースは、OLAP Serverに対するServerDBPathのパス・リストに含まれるディレクトリに常駐している必要があります。ダイレクト接続に対しては常に0を指定します。
ramconnecttype	Express接続のタイプ。ダイレクト接続に対しては常に0を指定します。
server値には、Oracle Express Connection Editorで作成され、接続ファイル（.xcf）に格納されている設定に対応する4つのパラメータが含まれます。これら4つのパラメータはすべて必須で、どのような順序でも指定できます。次の表は、パラメータとその設定を示しています。

パラメータ	説明	設定
sl	サーバー・ログイン	-2: ホスト（ドメイン・ログイン） -1: ホスト（サーバー・ログイン） 0: 認証不要 1: ホスト（ドメイン・ログイン）および接続セキュリティ 2: ホスト（ドメイン・ログイン）およびコール・セキュリティ 3: ホスト（ドメイン・ログイン）およびパケット・セキュリティ 4: ホスト（ドメイン・ログイン）および整合性セキュリティ 5: ホスト（ドメイン・ログイン）およびプライバシ・セキュリティ 注意: Windows NTでは、すべての設定を使用します。UNIXシステムでは、0、-1、-2の設定のみを使用します。 これらの設定の詳細は、Express Connection Editorのヘルプ・システムを参照してください。
st	サーバー・タイプ	1: OLAP Server
ct	接続タイプ	0: Express接続
sv	サーバー・バージョン	1: Express 6.2以降
使用上の注意

•	文字列全体が引用符で囲まれているので、必要に応じて文字列にスペースを入れることができます（ユーザーIDがJohn Smithの場合など）。

•	文字列の中でスラッシュ（/）が必要な場合は、追加のスラッシュをエスケープ文字として使用する必要があります。たとえば、ドメインがtools/reportsの場合、コマンド・ラインは次のようになります。

EXPRESS_SERVER="server=ncacn_ip_tcp:olap2-pc/sl=0/st=1/
ct=0/sv=1/ domain=tools//reports"

•	文字列の中で一重引用符を使用することができます。二重引用符で囲まれているので、特別に扱われることはありません。


RAM（RWRUN60）を指定したEXPRESS_SERVERの例

  関連項目 	  すべての例

rwrun60 userid=scott/tiger@nt805
express_server="server=ncacn_ip_tcp:olap2-pc/sl=0/st=1/
ct=0/sv=1/ramuser=appqa/rampassword=appqa1/ramexpressid=appqa/
ramserverscript=\\olap3-pc\orant\olap\ram6202\ram\sqstnt.rdc/
rammasterdb=sqstnt.db/ramconnecttype=0"
report=exp.rdf destype=file desname=exp1.html
desformat=html batch=yes


ユーザーID、パスワード、およびドメインを指定したEXPRESS_SERVER（RWRUN60）の例
ユーザーID、パスワードおよびドメインを指定したEXPRESS_SERVER（RWRUN60）の例

  関連項目      [image]  すべての例

rwrun60 userid=scott/tiger@nt805
express_server="server=ncacn_ip_tcp:olap2-pc/sl=1/st=1/ct=0/
sv=1/ user=orbuild/domain=tools/password=buildme/"
report=exp.rdf destype=file desname=exp1.html
desformat=html batch=yes


ユーザーID、パスワード、およびドメインを指定していないEXPRESS_SERVER（RWRUN60）の例
ユーザーID、パスワードおよびドメインを指定していないEXPRESS_SERVER（RWRUN60）の例

  関連項目      [image]  すべての例

rwrun60 userid=scott/tiger@nt805
express_server="server=ncacn_ip_tcp:olap2-pc/sl=0/st=1/ct=0/
sv=1/" report=exp.rdf destype=file desname=exp1.html
desformat=html batch=yes


CUSTOMIZE

  関連項目

説明  CUSTOMIZEは、MODULEまたはREPORTキーワードで選択したレポートに適用するXMLファイルまたはファイルのリストを指定します。XMLファイルには、レポート定義を何らかの方法で変更するカスタマイズ（たとえば、フォントの変更またはカラーの変更）が含まれます。

詳細は、『Publishing Reports』マニュアルを参照してください。

構文

[CUSTOMIZE=]filename.xml|(filename1.xml, filename2.xml, ...)

値

有効なXMLレポート定義（必要な場合にはファイル名の前に付けられているパス情報が指定されたXMLレポート定義）を含むファイルの名前。

使用上の注意

•	通常、XMLレポート定義のファイル拡張子はXMLですが、CUSTOMIZEキーワードが指定されている場合には必ずしもそうではありません。


SAVE_RDF

  関連項目

説明  SAVE_RDFは、CUSTOMIZEキーワードで選択したXMLカスタマイズ・ファイルとともにMODULEまたはREPORTキーワードで選択したレポートに保存するファイルを指定します。 この引数は、CUSTOMIZEキーワードを介してXMLファイルに適用するRDFファイルを所有しており、この2つの組合わせを新規のRDFファイルに保存する場合にもっとも有効です。

詳細は、『Publishing Reports』マニュアルを参照してください。

構文

[SAVE_RDF=]filename.rdf

値

任意の有効なファイル名です。


<param>

  関連項目

説明  <param> は、レポートの定義の一部になるパラメータです。指定した値は、そのパラメータの値として使用されます。

構文

<param>=value

値

そのパラメータの任意の有効な値です。

デフォルト

パラメータの「初期値」プロパティから取得されます。

使用上の注意

•	ランタイム・パラメータ・フォームのデフォルト値を上書きできます。

•	引数の値を一重または二重引用符で囲むことができます。一重または二重引用符の働きは、オペレーティング・システムによって異なります。

•	REPORTキーワードを使って実行ファイルを指定した場合、レポートの各パラメータ（入力マスク、妥当性チェック・トリガーなど）に指定された設定を使って、PARAM値の妥当性チェックが行われます。

•	REPORTキーワードを使って実行ファイルを指定しない場合、パラメータが未定義のパラメータを参照している場合があるので、PARAM値の解析や妥当性チェックは行われません。


?


「Attach Database」ダイアログ・ボックス

「Attach Database」ダイアログ・ボックスは、セッションに連結するデータベースの完全なパス名を指定するときに使用します。

このダイアログ・ボックスは、すべての言語で翻訳されているわけではありません。

ダイアログ・ボックスのコンポーネント

「Look in」ボックス -- 使用可能なフォルダとファイルが一覧表示されます。小さいほうのボックスで選択した場所にあるフォルダとファイルが、大きいほうのボックスに表示されます。

表示されるフォルダとファイルは、接続先のOLAP Server上にあることに注意してください。

「File name」ボックス -- オープンするデータベースの名前を指定します。ボックスにファイル名を入力することも、大きいほうの「Look in」ボックスから名前を選択することもできます。該当するファイルが見つからない場合は、「Look in」ボックスで別の場所を指定できます。

「Files of Type」ボックス -- 「File Name」ボックスに表示されるファイルの種類を指定します。.dbという拡張子はデータベースを表します。

「Up」ボタン -- ディレクトリ構造の1つ上のレベルに移動するには、このボタンを選択します。

「Read Only」ボックス -- データベースが変更されないように、読込み専用でデータベースを連結するときに指定します。


「Connect」ダイアログ・ボックス

「Connect」ダイアログ・ボックスは、Expressへの接続に関する情報を指定するときに使用します。

このダイアログ・ボックスは、すべての言語で翻訳されているわけではありません。

ダイアログ・ボックスのコンポーネント

「OLAP Server」ボックス -- 確立するOLAP Server接続を指定します。

「Authentication」ボックス -- OLAP Serverのドメイン、ユーザーIDおよびパスワードを入力します。選択したOLAP Server接続によっては、一部または全部のボックスがグレー表示になっていることがあります。

「Domain」ボックス -- リモート・システム上のドメイン名を入力します。このコンポーネントは、ドメイン・ログインが必要な場合にのみ表示されます。

「User ID」ボックス -- リモート・システム上のユーザーIDを入力します。

「Password」ボックス -- リモート・システム上のパスワードを入力します。

「RDBMS Connection」ボックス -- ユーザーID、パスワードおよびRDBMSのExpress IDを入力します。選択したOLAP Server接続によっては、「Express ID」ボックスがグレー表示になっている場合があります。

「User ID」ボックス -- RDBMSのユーザーIDを入力します。

「Password」ボックス -- RDBMSのパスワードを入力します。

「Express ID」ボックス -- RDBMSのExpress IDを入力します。


「Custom Measures」ダイアログ・ボックス

関連項目

「Custom Measures」ダイアログ・ボックスは、カスタム・メジャーを表示、作成、選択または編集するときに使用します。

このダイアログ・ボックスは、すべての言語で翻訳されているわけではありません。

ダイアログ・ボックスのコンポーネント

「Database」ボックス -- 現在使用しているデータベースを指定します。データベースを変更するには、矢印をクリックし、リストから別のデータベースを選択します。

「Custom Measures」ボックス -- 使用可能なカスタム・メジャーが一覧表示されます。カスタム・メジャーをコピーまたは編集するには、ボタンの1つを押す前に、このリストからメジャーを選択します。

「Expression」ボックス -- 選択したカスタム・メジャーに対して定義されている式が表示されます。

「Dimensions」ボックス -- 選択したカスタム・メジャーのディメンションが表示されます。

「New」ボタン -- 新しいカスタム・メジャーを作成するための「Custom Measures - Action」ダイアログ・ボックスを表示します。タイトル・バーのアクション名は、「New」です。

「Copy」ボタン -- 選択したカスタム・メジャーをコピーするための「Custom Measures - Action」ダイアログ・ボックスを表示します。タイトル・バーのアクション名は、「Copy」です。

「Delete」ボタン -- 選択したカスタム・メジャーを削除します。

「Edit」ボタン -- 選択したカスタム・メジャーを編集するための「Custom Measures - Action」ダイアログ・ボックスを表示します。タイトル・バーのアクション名は、「Edit」です。


「Custom Measures - Action」ダイアログ・ボックス

「Custom Measures - Action」ダイアログ・ボックスは、カスタム・メジャーを作成、編集またはコピーするときに使用します。タイトル・バーに表示されるアクション名は、関数によって決まります。

このダイアログ・ボックスは、すべての言語で翻訳されているわけではありません。

ダイアログ・ボックスのコンポーネント

「Name」ボックス -- カスタム・メジャーの名前を指定します。名前の長さは16文字までです。

「Description」ボックス -- カスタム・メジャーの説明を指定します。

「Expression」ボックス -- カスタム・メジャーの式を定義します。

「Category」ボックス -- カスタム・メジャーの式を作成するときに使用できる、関数と式のカテゴリが一覧表示されます。

「Choices」ボックス -- 選択したカテゴリ内の項目が一覧表示されます。

「Insert」ボタン -- 選択した項目を編集するために「Expression」ボックスに挿入します。

「Information」ボックス -- 選択した項目に関する情報が表示されます。


「Database Password」ダイアログ・ボックス

「Database Password」ダイアログ・ボックスは、連結するデータベースのパスワードを入力するときに使用します。このダイアログ・ボックスは、データベースがパスワードを要求する場合にのみ表示されます。

このダイアログ・ボックスは、すべての言語で翻訳されているわけではありません。

ダイアログ・ボックスのコンポーネント

「Enter the password for database」ボックス -- 連結するデータベースのパスワードを入力します。セキュリティ上の理由から、入力したパスワードはアスタリスク（*）で表示されます。


「Express Query」ダイアログ・ボックス

「Express Query」ダイアログ・ボックスは、Expressデータの問合せを作成するときに使用します。

このダイアログ・ボックスは、すべての言語で翻訳されているわけではありません。

このステップのコンポーネント

「Choose Database」ボックス -- 現在連結されているExpressデータベースの一覧が表示されます。リストにデータベースを追加したり、リストからデータベースを削除するには、「Attach Database」ボタンと「Remove Database」ボタンを使用します。データベースは複数連結できます。

「Attach Database」ボタン -- 「Attach Database」ダイアログ・ボックスにアクセスし、連結するデータベースを選択できます。

「Remove Database」ボタン -- 「Choose Database」ボックスで選択したデータベースの連結を解除します。オープン問合せで使用中のデータベースの連結を解除することはできません。問合せが処理中の場合、または結果がオープン・レポートに表示されている場合は、データベースの連結を解除する前に問合せを取り消すか、結果を削除する必要があります。

「Available Measures」ボックス -- データベースのすべての単位の一覧が表示されます。

「Selected Measures」ボックス -- 現在選択されている単位の一覧が表示されます。

「Report columns」ボックス -- 選択されている単位に対応するディメンションの情報が表示されます。

「Add One」ボタン ( [image]) -- 「Available Measures」ボックスで選択した単位を「Selected Measures」ボックスに追加します。

「Add All」ボタン ( [image]) -- 「Available Measures」ボックスのすべての単位を「Selected Measures」ボックスに追加します。

「Remove One」ボタン ( [image]) -- 「Selected Measures」ボックスから、選択した単位を削除します。

「Remove All」ボタン ( [image]) -- 「Selected Measures」ボックスから、すべての単位を削除します。

「Custom Measures」ボタン -- 「Custom Measures」ダイアログ・ボックスにアクセスします。

「Selector」ボタン -- 「Selector」ダイアログ・ボックスにアクセスし、次の操作を実行できます。

以前の保存済み選択項目を含む、ディメンションの特定の値を選択します。たとえば、時間ディメンションの場合は、特定の年、月または四半期を選択できます。

ビューのセレクタのカスタマイズこの問合せの「Selector」ダイアログ・ボックスの外観と動作をカスタマイズするオプションを設定できます。


「Dimension」ダイアログ・ボックス

「Dimension」ダイアログ・ボックスは、1つの値を選択するときに使用します。「Dimension」ダイアログ・ボックスのタイトル・バーには、値を選択するディメンションの名前が表示されます。

このダイアログ・ボックスは、すべての言語で翻訳されているわけではありません。

ダイアログ・ボックスのコンポーネント

「Select One」ボックス -- ディメンションの値が一覧表示されます。リストから値を1つ選択します。ディメンションに階層が定義されている場合は、「Select one」ボックスに次の2つの列が表示されます。

「Drilling」列 -- ディメンションに階層が定義されている場合、ドリル・アイコンを含む列が左側に表示されます。これらのアイコンをクリックすると、階層を拡張したり縮小したりできます。この列の一番下には、「Drill」ダイアログ・ボックスを表示するためのドリル・ボタンがあります。

「Values」列 -- すべてのディメンション値が一覧表示されます。


「Drill」ダイアログ・ボックス

「Drill」ダイアログ・ボックスは、ディメンション値のリストをディメンション階層の特定のレベルに拡張または縮小するときに使用します。

このダイアログ・ボックスは、すべての言語で翻訳されているわけではありません。

ダイアログ・ボックスのコンポーネント

「Starting With」ラベル -- ドリルの開始位置になるディメンション値を識別します。

「Drill」ボックス -- 現行のディメンション階層の開始位置から下のレベルが一覧表示されます。選択項目に入れる最下位のレベルを選択します。


「List」ダイアログ・ボックス

関連項目

「List」ダイアログ・ボックスは、使用可能な値のリストからディメンション値を選択するときに使用します。リストに値を追加し、リスト上に値を保持し、リストから値を削除することができます。階層が定義されているディメンションの場合は、「Drill」ダイアログ・ボックスにアクセスし、階層を拡張または縮小することもできます。

このダイアログ・ボックスは、すべての言語で翻訳されているわけではありません。

ダイアログ・ボックスのコンポーネント

「Available Dimension Values」ボックス -- 現行の階層のすべての値が一覧表示されます。選択されている階層がない場合は、ディメンションのすべての値が一覧表示されます。現行の選択項目に値を追加したり、現行の選択項目を置き換える場合は、追加または置換で使用する値をハイライトします。複数の値をハイライトするには、[Shift]または[Ctrl]を押しながらマウスをクリックするか、マウスの左ボタンを押しながら、ハイライトする値の上をドラッグします。

「Drilling」列 -- 現行のディメンションに階層が定義されている場合、ドリル・アイコンを含む列が左側に表示されます。これらのアイコンをクリックすると、階層を拡張したり縮小したりできます。この列の一番下には、「Drill」ダイアログ・ボックスを表示するためのドリル・ボタンがあります。

「Selected Dimension Values」ボックス -- 現在選択されているディメンション値が一覧表示されます。現行の選択項目に値を保持したり、選択項目から値を削除する場合は、保持または削除する値をハイライトします。複数の値をハイライトするには、[Shift]または[Ctrl]を押しながらマウスをクリックするか、マウスの左ボタンを押しながら、ハイライトする値の上をドラッグします。

「Select」ボタン -- 現行の選択項目（「Selected Dimension Values」ボックスに一覧表示されている）を、「Available Dimension Values」ボックスでハイライトされているディメンション値に置き換えます。

「Add」ボタン -- 「Selected Dimension Values」ボックスの現行の選択項目に、「Available Dimension Values」ボックスでハイライトされているディメンション値を追加します。

「Keep」ボタン -- 「Selected Dimension Values」ボックスでハイライトされているディメンション値を現行の選択項目に保持し、それ以外の値を削除します。

「Remove」ボタン -- 「Selected Dimension Values」ボックスでハイライトされているディメンション値を現行の選択項目から削除し、それ以外の値を保持します。

「Hierarchy」ボックス -- ディメンションに定義されている階層が一覧表示されます。選択する場合はディメンション値を含む階層を選択します。選択した階層の中の値が「Available Dimension Values」ボックスに表示されます。


「Preview」ダイアログ・ボックス

「Preview」ダイアログ・ボックスは、Selectorツールで実行する選択の結果を調べるときに使用します。

選択項目を変更すると、選択スクリプトが変更されます。「Preview」ダイアログ・ボックスを使用すると、スクリプトの変更の結果と、変更を適用した場合に選択されるディメンション値を確認できます。

このダイアログ・ボックスは、すべての言語で翻訳されているわけではありません。

ダイアログ・ボックスのコンポーネント

「Script」ボックス -- 完全な選択スクリプトが表示されます。この中には、「Preview」ダイアログ・ボックスを起動したダイアログ・ボックスで「OK」を選択した場合に追加される部分も含まれます。

「Selected Values」ボックス -- 表示された選択スクリプトによって作成される値が一覧表示されます。


「Qualifying Dimension Values」ダイアログ・ボックス

メジャー値を基にディメンション値を選択またはソートする場合は、修飾ディメンションごとに1つの値を指定してください。「Qualifying Dimension Values」ダイアログ・ボックスは、修飾ディメンションごとの値を選択するときに使用します。

このダイアログ・ボックスは、すべての言語で翻訳されているわけではありません。

ダイアログ・ボックスのコンポーネント

「Choose a Value for Each Dimension」ボックス -- メジャーの各修飾ディメンションが、ディメンションごとに1つの値付きで一覧表示されます。値を選択するディメンションをクリックします。

「Dimension Values」ボックス -- 「Choose a Value for Each Dimension」ボックスで選択したディメンションに使用できる値が一覧表示されます。ディメンションの値を1つ選択します。


「Rename Selection」ダイアログ・ボックス

「Rename Selection」ダイアログ・ボックスは、保存済み選択項目を改名するときに使用します。

このダイアログ・ボックスは、すべての言語で翻訳されているわけではありません。

ダイアログ・ボックスのコンポーネント

「Name」ボックス -- 保存済み選択項目の新しい名前が識別されます。長さは16文字までです。保存済み選択項目を別のユーザーと共有するときに、名前の競合を回避するには、名前が一意になることを保証する規則を使用します。たとえば、日付やイニシャルを名前に組込むことができます。

「Description」ボックス -- 保存済み選択項目の新しい説明が識別されます。


「Replace Saved Selection」ダイアログ・ボックス

「Save Selection」ダイアログ・ボックスで、選択項目を別の保存済み選択項目の置換として保存するときに、「Replace Saved Selection」ダイアログ・ボックスによって、以前の保存済み選択項目を新しい選択項目で置換するかどうかが確認されます。

「Yes」を選択すると、以前の保存済み選択項目が新しい選択項目で置換されます。

このダイアログ・ボックスは、すべての言語で翻訳されているわけではありません。

ダイアログ・ボックスのコンポーネント

「Current Script」ボックス -- 以前の保存済み選択項目のスクリプトが表示されます。

「New script」ボックス -- 「Yes」を選択した場合に、保存済み選択項目スクリプトになる新規スクリプトが表示されます。


「Save Selection」ダイアログ・ボックス

「Save Selection」ダイアログ・ボックスは、選択項目を保存するとき、または以前の保存済み選択項目を置換するときに使用します。

このダイアログ・ボックスは、すべての言語で翻訳されているわけではありません。

ダイアログ・ボックスのコンポーネント

「Dimension」ラベル -- 選択項目が属するディメンションを識別します。

「Hierarchy」ラベル -- 保存済み選択項目で使用されている最後に選択した階層を識別します。選択項目が再度使用されるときは、この階層がディメンションの現行の階層になります。

「Database」ラベル -- ディメンションが置かれているデータベースを識別します。

「Save Selection as」ボックス -- 次のいずれかのボタンを選択します。

「New」ボタン -- 現行の選択項目を新しい保存済み選択項目として保存します。「New」を選択すると、次のボックスが表示されます。

「Name」ボックス -- 保存済み選択項目の名前を入力します。長さは16文字までです。

「Description」ボックス -- 保存済み選択項目の説明を入力します。

「Replacement」ボタン -- 選択項目を現行の選択項目で置き換えます。「Replacement」を選択すると、そのディメンションの保存済み選択項目のリストが表示されます。置換する保存済み選択項目をクリックします。

注意: Express Administratorで作成した保存済み選択項目は置換できません。

「Type」ボックス -- 選択項目について、次のいずれかのタイプを選択します。

「Dynamic」 -- 現行ステータスに基づいて、選択条件を評価します。選択項目に含まれている実際の値は、変更されることがあります。たとえば、選択スクリプトで「Select last three months」が指定されている場合は、動的選択項目に、ユーザーが保存済み選択項目を選択する月より前の3か月間が含まれます。

「Static」 -- 選択項目が保存されたときに選択項目に含まれていた正確なディメンション値を選択します。たとえば、選択スクリプトで「Select last three months」が指定されている場合は、問合せをいつ実行したかにかかわらず、静的選択項目に、保存済み選択項目が作成された月より前の3か月間が含まれます。

「Script」ボックス -- 「Selector Options」ダイアログ・ボックス で「Show selection script」ボックスがチェックされている場合に、保存済み選択項目の選択スクリプトが表示されます。


「Saved Selection」ダイアログ・ボックス

関連項目

「Saved Selection」ダイアログ・ボックスは、Express Administratorでディメンションに定義された保存済み選択項目を取り出すときに使用します。

このダイアログ・ボックスは、すべての言語で翻訳されているわけではありません。

ダイアログ・ボックスのコンポーネント

「Selection Type」ボックス -- 新しく選択した値が、現行の選択項目にどのように作用するかを指定する次のオプションが表示されます。

「Select」 -- 現行の選択項目を保存済み選択項目に置き換えます。

「Add」 -- 現行の選択項目に保存済み選択項目の値を追加します。

「Keep」 -- 現行の選択項目の値で、保存済み選択項目にも含まれている値は保持し、それ以外のディメンション値は破棄します。

「Remove」 -- 現行の選択項目から保存済み選択項目の値を削除し、それ以外は保持します。

「Dimension Values in Selection」ボックス -- ディメンションに保存されている選択項目が一覧表示されます。

「Selection Name」ボックス -- ハイライトされた保存済み選択項目に関する次の情報が表示されます。

「Dimension」ラベル -- 保存済み選択項目が属するディメンションを識別します。

「Hierarchy」ラベル -- 保存済み選択項目に指定されている階層を識別します。保存済み選択項目を選択すると、この階層が現行の階層になります。

「Database」ラベル -- ディメンションが置かれているデータベースを識別します。

「Type」ラベル -- 保存済み選択項目が動的か静的かを識別します。

「Access」ラベル -- 保存済み選択項目を変更できるかどうかを識別します。

「Script」ボックス -- 「Selector Options」ダイアログ・ボックス で「Show selection script」ボックスがチェックされている場合に、保存済み選択項目の選択スクリプトが表示されます。

「Script」ボックス -- 「OK」を選択した場合に編集中の選択項目の選択スクリプトに追加される条件が表示されます。

「Preview」ボタン -- 「Preview」ダイアログ・ボックスが表示されます。このダイアログ・ボックスで、適用を検討している変更を事前に調べることができます。また、変更を実施した場合に選択されるディメンション値が一覧表示されます。


「Select All」ダイアログ・ボックス

関連項目

「Select All」ダイアログ・ボックスは、ディメンションのすべての値、または現行の階層のすべてのディメンション値を選択するときに使用します。

このダイアログ・ボックスは、すべての言語で翻訳されているわけではありません。

ダイアログ・ボックスのコンポーネント

「Selection Type」ボックス -- 新しく選択した値が、現行の選択項目にどのように作用するかを指定する次のオプションが表示されます。

「Select」 -- 現行の選択項目を新しい値に置き換えます。

「Add」 -- 現行の選択項目に新しい値を追加します。

「Keep」 -- 新しく選択した値を現行の選択項目に保持し、それ以外は破棄します。

「Remove」 -- 新しく選択した値を現行の選択項目から削除し、それ以外は保持します。

「Dimension Values in hierarchy」ボックス -- 選択したディメンションに定義されている階層が一覧表示されます。選択項目にすべてのディメンション値を入れるには、「(NONE)」を選択します。特定の階層に属するディメンション値のみを入れるには、その階層を選択します。

「Script」ボックス -- 「OK」を選択した場合に選択スクリプトに追加される条件が表示されます。

「Preview」ボタン -- 「Preview」ダイアログ・ボックスが表示されます。このダイアログ・ボックスで、適用を検討している変更を事前に調べることができます。また、変更を実施した場合に選択されるディメンション値が一覧表示されます。


「Select by Attribute」ダイアログ・ボックス

関連項目

「Select by Attribute」ダイアログ・ボックスは、属性を基に値を選択するときに使用します。たとえば、カラーによってProduct（製品）値を選択することができます。Attributeツールを使用できるのは、ディメンションが属性を持っている場合のみです。

このダイアログ・ボックスは、すべての言語で翻訳されているわけではありません。

ダイアログ・ボックスのコンポーネント

「Selection Type」ボックス -- 新しく選択した値が、現行の選択項目にどのように作用するかを指定する次のオプションが表示されます。

「Select」 -- 現行の選択項目を新しい値に置き換えます。

「Add」 -- 現行の選択項目に新しい値を追加します。

「Keep」 -- 新しく選択した値を現行の選択項目に保持し、それ以外は破棄します。

「Remove」 -- 新しく選択した値を現行の選択項目から削除し、それ以外は保持します。

「Dimension Values Where」ボックス -- 属性を定義する関連ディメンションを指定します。

「Is」ボックス -- 現行の属性の値が一覧表示されます。1つ以上の値を選択し、選択条件として使用することができます。

「In Hierarchy」ボックス -- 選択したディメンションに定義されている階層が一覧表示されます。使用する階層を選択します。

「At Level(s)」ボックス -- 選択した階層にレベルがある場合は、そのレベルが一覧表示されます。新しい選択項目に入れるレベルを選択します。複数のレベルを選択するには、[Shift]または[Ctrl]を押しながらマウスをクリックします。

「Script」ボックス -- 「OK」を選択した場合に選択スクリプトに追加される条件が表示されます。

「Preview」ボタン -- 「Preview」ダイアログ・ボックスが表示されます。このダイアログ・ボックスで、適用を検討している変更を事前に調べることができます。また、変更を実施した場合に選択されるディメンション値が一覧表示されます。


「Select by Exception」ダイアログ・ボックス

関連項目

「Select by Exception」ダイアログ・ボックスは、特定のメジャーのデータ値を基に、あるいはこれらのデータ値を別のメジャーのデータ値と比較する過程を基に、ディメンション値を選択するときに使用します。たとえば、特定の製品の前年度の総売上げが$5,000,000を超えるすべての都市を選択することや、売上げが予想を10%上回るすべての都市を選択することができます。

このダイアログ・ボックスは、すべての言語で翻訳されているわけではありません。

ダイアログ・ボックスのコンポーネント

「Selection Type」ボックス -- 新しく選択した値が、現行の選択項目にどのように作用するかを指定する次のオプションが表示されます。

「Select」 -- 現行の選択項目を新しい値に置き換えます。

「Add」 -- 現行の選択項目に新しい値を追加します。

「Keep」 -- 新しく選択した値を現行の選択項目に保持し、それ以外は破棄します。

「Remove」 -- 新しく選択した値を現行の選択項目から削除し、それ以外は保持します。

「Exception Type」ボックス -- 例外条件のタイプに対応する次のオプションが表示されます。

「Numeric」 -- メジャーを1つの値と比較します。このオプションを選択すると、次のボックスが表示されます。

「Dimension Values Where」ボックス -- Exceptionツールによって、「Value」ボックスで指定した値と比較される値を持つメジャーを識別します。別のメジャーを選択するには、「...Ellipsis」ボタンをクリックし、現行のディメンションを使用するすべてのメジャーのリストを表示します。

「Is」ボックス -- 選択したメジャーのデータ値と、指定したデータ値を比較する方法を識別する演算子です。演算子には、「equal to」、「less than or equal to」、「greater than or equal to」、「not equal to」、「between」、「greater than」、「outside」、および「less than」があります。

「Value」ボックス -- Exceptionツールによって、選択したメジャーの値と比較される数値を入力します。現行の演算子に値の範囲が必要な場合（「between」または「outside」）は、ダイアログ・ボックスに範囲の上限値と下限値を入力するための2つのボックスが表示されます。

「Measure」 -- 1つのメジャーを別のメジャーと比較します。このオプションを選択すると、次のボックスが表示されます。

「Dimension Values Where」ボックス -- Exceptionツールによって、「Value」ボックスで指定した値と比較される値を持つメジャーを識別します。別のメジャーを選択するには、「...Ellipsis」ボタンをクリックし、現行のディメンションを使用するすべてのメジャーのリストを表示します。

「Is」ボックス -- 選択したメジャーのデータ値と、別のメジャーのデータ値を比較する方法を識別する演算子です。演算子には「Less than」と「Greater than」があります。

「Value」ボックス -- Exceptionツールによって、選択したメジャーの値と比較される数値を入力します。入力した数値がパーセントなのか定数値なのかを指定するために、横のボックスで「Percent」または「Value」を選択します。

「Comparison」ボックス -- Exceptionツールが2つのメジャーの間で実行する比較の種類を識別します。比較の種類には、「Above」、「Below」、「Above or below」があります。

「Measure」ボックス -- Exceptionツールが比較で使用する2番目のメジャーを識別します。別のメジャーを選択するには、「...Ellipsis」ボタンをクリックし、現行のディメンションを使用するすべてのメジャーのリストを表示します。

「Exclude」ボックス -- データ値を処理するための次のオプションが表示されます。

「Zeros」チェックボックス -- データの0（ゼロ）値を検索から除外する場合は、このボックスをチェックします。

「In Hierarchy」ボックス -- 選択したディメンションに定義されている階層が一覧表示されます。使用する階層を選択します。使用する階層を選択するか、「NONE」を選択してすべてのディメンション値を入れます。

「At Level(s)」ボックス -- 現行のディメンション階層のレベルが一覧表示されます。新しい選択項目に入れるレベルを選択するか、「All」を選択してすべてのレベルを入れます。複数のレベルをハイライトするには、[Shift]または[Ctrl]を押しながらマウスをクリックします。

「For Dimension」ボックス -- 2つのメジャーの他の各ディメンションの1つの値を識別します。選択項目を変更するには、隣接する「...Ellipsis」ボタンをクリックし、ディメンションのすべての値のリストを表示します。

「Script」ボックス -- 「OK」を選択した場合に選択スクリプトに追加される条件が表示されます。

「Preview」ボタン -- 「Preview」ダイアログ・ボックスが表示されます。このダイアログ・ボックスで、適用を検討している変更を事前に調べることができます。また、変更を実施した場合に選択されるディメンション値が一覧表示されます。


「Select by Family」ダイアログ・ボックス

関連項目

「Select by Family」ダイアログ・ボックスは、ファミリを基に値を選択するときに使用します。たとえば、カナダとその子の各都市の「Geography（地理）」値を選択することができます。Familyツールを使用できるのは、選択したディメンションに階層が定義されている場合のみです。

このダイアログ・ボックスは、すべての言語で翻訳されているわけではありません。

ダイアログ・ボックスのコンポーネント

「Selection Type」ボックス -- 新しく選択した値が、現行の選択項目にどのように作用するかを指定する次のオプションが表示されます。

「Select」 -- 現行の選択項目を新しい値に置き換えます。

「Add」 -- 現行の選択項目に新しい値を追加します。

「Keep」 -- 新しく選択した値を現行の選択項目に保持し、それ以外は破棄します。

「Remove」 -- 新しく選択した値を現行の選択項目から削除し、それ以外は保持します。

「In Hierarchy」ボックス -- 選択したディメンションに定義されている階層が一覧表示されます。使用する階層を選択します。

「Family Member(s) of Dimension」ボックス -- ファミリを選択するディメンション値を識別します。別の値を選択するには、「...Ellipsis」ボタンをクリックし、現行のディメンションと階層のすべての値のリストを表示します。

「Levels」ボックス -- 階層に応じて、通常は2つの列で構成されます。左側の列には、現行の階層のすべてのレベルが一覧表示されます。右側の列には、各レベルの値とアンカー・ポイントのリレーションが表示されます。1つのレベルがアンカー・ポイントを含むレベルとして識別されます。他のレベルの値は、「Family Member(s) of Dimension」ボックスで選択した値の祖先、親、子の1つ、または依存項目の1つになります。

選択項目に入れる1つまたは複数のレベルを選択します。複数のレベルを選択するには、[Shift]または[Ctrl]を押しながらマウスをクリックします。

「Script」ボックス -- 「OK」を選択した場合に選択スクリプトに追加される条件が表示されます。

「Preview」ボタン -- 「Preview」ダイアログ・ボックスが表示されます。このダイアログ・ボックスで、適用を検討している変更を事前に調べることができます。また、変更を実施した場合に選択されるディメンション値が一覧表示されます。


「Select by Level」ダイアログ・ボックス

関連項目

「Select by Level」ダイアログ・ボックスは、現行のディメンション階層のレベルを基に値を選択するときに使用します。たとえば、City（都市）レベルにあるすべてのGeography（地理）値を選択することができます。Levelツールを使用できるのは、選択したディメンションに階層が定義されている場合のみです。

このダイアログ・ボックスは、すべての言語で翻訳されているわけではありません。

ダイアログ・ボックスのコンポーネント

「Selection Type」ボックス -- 新しく選択した値が、現行の選択項目にどのように作用するかを指定する次のオプションが表示されます。

「Select」 -- 現行の選択項目を新しい値に置き換えます。

「Add」 -- 現行の選択項目に新しい値を追加します。

「Keep」 -- 新しく選択した値を現行の選択項目に保持し、それ以外は破棄します。

「Remove」 -- 新しく選択した値を現行の選択項目から削除し、それ以外は保持します。

「Dimension Values in Hierarchy」ボックス -- 選択したディメンションに定義されている階層が一覧表示されます。使用する階層を選択します。

「At Level(s)」ボックス -- 選択したディメンションと階層に定義されているレベルが一覧表示されます。新しい選択項目に入れるレベルを選択します。複数のレベルを選択するには、[Shift]または[Ctrl]を押しながらマウスをクリックします。

「Script」ボックス -- 「OK」を選択した場合に選択スクリプトに追加される条件が表示されます。

「Preview」ボタン -- 「Preview」ダイアログ・ボックスが表示されます。このダイアログ・ボックスで、適用を検討している変更を事前に調べることができます。また、変更を実施した場合に選択されるディメンション値が一覧表示されます。


「Select by Matching Characters」ダイアログ・ボックス

関連項目

「Select by Matching Characters」ダイアログ・ボックスは、指定した文字列に一致するディメンション値を選択するときに使用します。

このダイアログ・ボックスは、すべての言語で翻訳されているわけではありません。

ダイアログ・ボックスのコンポーネント

「Selection Type」ボックス -- 新しく選択した値が、現行の選択項目にどのように作用するかを指定する次のオプションが表示されます。

「Select」 -- 現行の選択項目を新しい値に置き換えます。

「Add」 -- 現行の選択項目に新しい値を追加します。

「Keep」 -- 新しく選択した値を現行の選択項目に保持し、それ以外は破棄します。

「Remove」 -- 新しく選択した値を現行の選択項目から削除し、それ以外は保持します。

「Dimension Values that」ボックス -- ディメンション値が指定した文字列を含む（「contain」）のか、その文字列で始まる（「start with」）のか、終わる（「end with」）のか、あるいは文字列に完全に一致する（「match exactly」）のかを指定します。

「Character(s)」ボックス -- ディメンション値を選択するときに一致させるテキストを入力します。

「In Hierarchy」ボックス -- 選択したディメンションに定義されている階層が一覧表示されます。使用する階層を選択するか、「NONE」を選択してディメンションのすべての値を検索します。ディメンションに階層が定義されていない場合は、このボックスは表示されません。

「At Level(s)」ボックス -- 現行のディメンションのレベルが一覧表示されます。新しい選択項目に入れるレベルを選択するか、「All」を選択してディメンションのすべての値を検索します。ディメンションに階層が定義されていない場合は、このボックスは表示されません。

「Ignore Capitalization」ボックス -- このボックスが選択されていると（デフォルトの状態）、入力したテキストは大/小文字の区別なく照合されます。大/小文字を区別して照合する場合は、このボックスの選択を解除します。

「Script」ボックス -- 「OK」を選択した場合に選択スクリプトに追加される条件が表示されます。

「Preview」ボタン -- 「Preview」ダイアログ・ボックスが表示されます。このダイアログ・ボックスで、適用を検討している変更を事前に調べることができます。また、変更を実施した場合に選択されるディメンション値が一覧表示されます。


「Select by Range」ダイアログ・ボックス

関連項目

「Select by Range」ダイアログ・ボックスは、連続した期間の範囲を選択するときに使用します。

このダイアログ・ボックスは、すべての言語で翻訳されているわけではありません。

ダイアログ・ボックスのコンポーネント

「Selection Type」ボックス -- 新しく選択した値が、現行の選択項目にどのように作用するかを指定する次のオプションが表示されます。

「Select」 -- 現行の選択項目を新しい値に置き換えます。

「Add」 -- 現行の選択項目に新しい値を追加します。

「Keep」 -- 新しく選択した値を現行の選択項目に保持し、それ以外は破棄します。

「Remove」 -- 新しく選択した値を現行の選択項目から削除し、それ以外は保持します。

「Interval」ボックス -- 各種の間隔に対応する次のオプションが表示されます。

「The last」 -- 特定数の最近の期間を選択します。この間隔を選択すると、レベルを選択するための「At Level」ボックス、期間の数を選択するための「Including」ボックス、および選択したレベルで現在定義されている最後の日付を示すテキスト・ラベルが「Time Periods」ボックスに表示されます。

「To date」 -- 特定の時期から現在までのすべての期間を選択します。この間隔を選択すると、レベルを選択するための「At Level」ボックス、範囲の開始時期を選択するための「From」ボックス、および選択したレベルで現在定義されている最後の日付を示すテキスト・ラベルが「Time Periods」ボックスに表示されます。

「A range of」 -- 開始時期から終了時期までの（両方を含む）すべての期間を選択します。この間隔を選択すると、レベルを選択するための「At Level」ボックス、範囲の開始時期を選択するための「From」ボックス、および範囲の終了時期を選択するための「To」ボックスが「Time Periods」ボックスに表示されます。

「Time Periods」ボックス -- 範囲を定義するための次のボックスが2つ以上表示されます。

「In Hierarchy」ボックス -- 選択したディメンションに定義されている階層が一覧表示されます。使用する階層を選択します。

「At Level」ボックス -- 「Time」階層のレベルが表示されます。使用するレベルを選択します。

「From」ボックス -- 「Interval」が「To date」または「A range of」の場合に、範囲の開始時期を指定します。

「To」ボックス -- 「Interval」が「A range of」の場合に、範囲の終了時期を指定します。

「Including」 -- 「Interval」が「Last」の場合に、範囲に入れる期間の数を指定します。

「Script」ボックス -- 「OK」を選択した場合に選択スクリプトに追加される条件が表示されます。

「Preview」ボタン -- 「Preview」ダイアログ・ボックスが表示されます。このダイアログ・ボックスで、適用を検討している変更を事前に調べることができます。また、変更を実施した場合に選択されるディメンション値が一覧表示されます。


「Select Top/Bottom」ダイアログ・ボックス

関連項目

「Select Top/Bottom」ダイアログ・ボックスは、特定のメジャーの最上位と最下位のデータ値を基にディメンション値を選択するときに使用します。たとえば、会社の製品の売上げ上位5都市を選択することができます。Sales（売上げ）メジャーのデータを基に、Geography（地理）値を選択します。

このダイアログ・ボックスは、すべての言語で翻訳されているわけではありません。

ダイアログ・ボックスのコンポーネント

「Selection Type」ボックス -- 新しく選択した値が、現行の選択項目にどのように作用するかを指定する次のオプションが表示されます。

「Select」 -- 現行の選択項目を新しい値に置き換えます。

「Add」 -- 現行の選択項目に新しい値を追加します。

「Keep」 -- 新しく選択した値を現行の選択項目に保持し、それ以外は破棄します。

「Remove」 -- 新しく選択した値を現行の選択項目から削除し、それ以外は保持します。

「The Top」ボックス -- 最初のボックスに数字を入力し、検索する値で最も大きいデータ値の正確な数値またはパーセントを指定します。2番目のボックスで、正確な数値の場合は「Dimension」、パーセントの場合は「%Dimension」を選択します。

「And/Or The Bottom」ボックス -- 最初のボックスに、検索する値で最も小さいデータ値の正確な数値またはパーセントの数字を入力します。2番目のボックスで、正確な数値の場合は「Dimension」、パーセントの場合は「%Dimension」を選択します。

「Based On」ボックス -- 値を選択条件に使用するメジャーを識別します。別のメジャーを選択するには、「...Ellipsis」ボタンをクリックし、現行のディメンションを使用するすべてのメジャーのリストを表示します。

「Exclude」ボックス -- データ値を処理するための次のオプションが表示されます。

「NAs」ボックス -- 検索からNAデータ値を除外する場合は、このボックスをチェックします。

「Zeros」ボックス -- 検索から0（ゼロ）データ値を除外する場合は、このボックスをチェックします。

「Sort automatically」ボックス -- Sortツールで指定したソート条件を使用して、選択項目が変更されるたびにディメンションを自動的にソートするかどうかを指定します。このボックスにチェックがない場合は、選択項目は最上位から最下位の順にソートされます。

「In Hierarchy」ボックス -- 選択したディメンションに定義されている階層が一覧表示されます。使用する階層を選択するか、「NONE」を選択してすべてのディメンション値を入れます。

「At Level(s)」ボックス -- 現行のディメンション階層のレベルが一覧表示されます。新しい選択項目に入れるレベルを選択するか、「All」を選択してすべてのレベルを入れます。複数のレベルをハイライトするには、[Shift]または[Ctrl]を押しながらマウスをクリックします。

「For Dimension」ボックス -- メジャーの他の各ディメンションの1つの値を識別します。選択項目を変更するには、隣接する「...Ellipsis」ボタンをクリックし、ディメンションのすべての値のリストを表示します。

「Script」ボックス -- 「OK」を選択した場合に選択スクリプトに追加される条件が表示されます。

「Preview」ボタン -- 「Preview」ダイアログ・ボックスが表示されます。このダイアログ・ボックスで、適用を検討している変更を事前に調べることができます。また、変更を実施した場合に選択されるディメンション値が一覧表示されます。


「Selection Library」ダイアログ・ボックス
「Selector Library」ダイアログ・ボックス

関連項目

「Selection Library」ダイアログ・ボックスは、選択項目の保存、および保存済み選択項目の改名または削除を行うときに使用します。

このダイアログ・ボックスは、すべての言語で翻訳されているわけではありません。

ダイアログ・ボックスのコンポーネント

「Selections」ボックス -- ディメンションの保存済み選択項目が一覧表示されます。現行の選択項目を新しい保存済み選択項目として保存するときには、<Current Selection>を選択します。保存済み選択項目を改名または削除するには、保存済み選択項目をリストから選択します。

「Dimension」ラベル -- 保存済み選択項目が属するディメンションを識別します。

「Hierarchy」ラベル -- ハイライト表示された保存済み選択項目で使用されている最後に選択した階層を識別します。選択項目が再度使用されるときは、この階層がディメンションの現行の階層になります。

「Database」ラベル -- ディメンションが置かれているデータベースを識別します。

「Type」ラベル -- 保存済み選択項目が動的か静的かを識別します。

「Access」ラベル -- 保存済み選択項目を上書き、改名または削除できるかどうかを識別します。

「Script」ボックス -- 「Selector Options」ダイアログ・ボックス で「Show selection script」ボックスがチェックされている場合に、保存済み選択項目の選択スクリプトが表示されます。

「Save」ボタン -- 新しい選択項目に名前を付けて保存する「Save Selection」ダイアログ・ボックスを表示します。

「Rename」ボタン -- 保存済み選択項目の新しい名前を入力する「Rename Selection」ダイアログ・ボックスを表示します。

「Delete」ボタン -- ハイライト表示された保存済み選択項目を削除できます。


「Selector」ダイアログ・ボックス

関連項目

「Selector」ダイアログ・ボックスは、問合せに表示されるディメンション値を選択するときに使用します。ディメンションに対する特定の値の選択、ディメンション値のカスタム選択項目の保存およびカスタム・メジャーの操作を行うことができます。問合せのセレクタをカスタマイズすることもできます。

「Selector」ダイアログ・ボックスは、セレクタを構成するいくつかの相互に関連するダイアログ・ボックスの中の最初のダイアログ・ボックスです。

このダイアログ・ボックスは、すべての言語で翻訳されているわけではありません。

ダイアログ・ボックスのコンポーネント

ツールバー -- 選択したディメンションで使用可能なSelectorツールを表すボタンが表示されます。各ツールからは、ディメンション値を選択するためのダイアログ・ボックスが表示されます。Selectorツールを表示するには、そのツールのボタンをクリックします。

いずれかのSelectorツールが表示されていない場合は、「Options」を選択し、次に「Available tools」のリストからツールを選択します。これにより、ツールが使用できるようになります。

「Dimensions」オプション・ボタンまたはチェックボックス -- 問合せ用に選択されたメジャーのディメンションが一覧表示されます。ディメンションの数とセレクタ・オプションの設定によって、各ディメンションがオプション・ボタンとして表示される場合と、ディメンションのリストがリスト・ボックスに表示される場合があります。選択項目を変更するディメンションを選択します。

「Dimension Selection Values」ボックス -- 現在ディメンションに選択されているディメンション値が一覧表示されます。このボックスは、「Selector Options」ダイアログ・ボックスの「Show Selection Values」チェックボックスが選択されている場合にのみ表示されます。

「Dimension Selection Script」ボックス -- ディメンションの選択項目を示す完全なスクリプトが表示されます。このボックスは、「Selector Options」ダイアログ・ボックスの「Show Selection Script」ボックスが選択されている場合にのみ表示されます。

「カスタム」ボタン -- カスタム・メジャーの作成、コピー、編集および削除を行う「Custom Measures」ダイアログ・ボックスを表示します。このボタンは、「Selector Options」ダイアログ・ボックスの「Allow custom measure functionality」チェックボックスが選択されている場合にのみ表示されます。

「Library」ボタン -- 保存済み選択項目の作成、改名および削除を行う「Selection Library」ダイアログ・ボックスを表示します。このボタンは、「Selector Options」ダイアログ・ボックスの「Allow access to saved selection library」チェックボックスが選択されている場合にのみ表示されます。

「Options」ボタン -- 「Selector Options」ダイアログ・ボックスが表示されます。このダイアログ・ボックスで、現行の問合せの「Selector」ダイアログ・ボックスの外観を設定できます。


「Selector Options」ダイアログ・ボックス

関連項目

「Selector Options」ダイアログ・ボックスは、「Selector」ダイアログ・ボックスの外観を設定するときに使用します。このボックスで設定したオプションは、問合せからセレクタが表示されるたびに有効になります。

このダイアログ・ボックスは、すべての言語で翻訳されているわけではありません。

ダイアログ・ボックスのコンポーネント

「Allow Custom Measure Functionality」ボックス -- このボックスが選択されているときは、「Selector」ダイアログ・ボックスに「Custom」ボタンが表示され、「Custom Measures」ダイアログ・ボックスにアクセスできます。

「Allow Access To Saved Selection Library」ボックス -- このボックスが選択されているときは、「Selector」ダイアログ・ボックスに「Library」ボタンが表示され、ユーザーは「Selection Library」ダイアログ・ボックスにアクセスできます。

「Show Selection Values」ボックス -- このボックスを選択すると、「Selector」ダイアログ・ボックスのリスト・ボックスに現行の選択項目のディメンション値が表示されます。

「Show Selection Script」ボックス -- このボックスを選択すると、「Selector」ダイアログ・ボックスと関連するダイアログ・ボックスに選択スクリプトが表示されます。

「Use Listbox To Represent Dimension」ボックス -- このボックスを選択すると、たとえオプション・ボタンのラベルとして表示されるほどの数がなくても、使用可能なディメンションがリスト・ボックスに表示されます。このボックスの選択を解除すると、オプション・ボタンで表示しきれないほどの数がある場合にのみ、ディメンションがリスト・ボックスに表示されます。

「Show Dimension Values As」ボックス -- ディメンション値がセレクタに一覧表示されるときのラベルまたは値を指定するオプションが表示されます。データベース管理者は、データベースの構成処理中に、これらのラベルを指定します。次のいずれかのオプションを選択します。

「Long」ラベル -- 長いラベルを使用します（New York CityやNew Yorkなど）。

「Short」ラベル -- 短いラベルを使用します（New Yorkなど）。

「Values」 -- データベースに表示されるとおりのディメンション値を使用します（NEWYORKなど）。

「Available Tools」ボックス -- 各Selectorツールに対応するチェックボックスが表示されます。ボックスを選択すると、そのツールが「Selector」ダイアログ・ボックスに表示されます。ボックスの選択を解除すると、ツールはダイアログ・ボックスに表示されなくなります。

「Maximum Dimension Values In A Selection」ボックス -- 選択項目で使用できるディメンション値の最大数を指定します。この最大数を超えて値を選択することはできません。


「Sort Selection」ダイアログ・ボックス

関連項目

「Sort Selection」ダイアログ・ボックスは、選択項目のディメンション値をソートするときに使用します。どのソート方法を使用できるかは、ディメンションのプロパティによって異なります。

このダイアログ・ボックスは、すべての言語で翻訳されているわけではありません。

ダイアログ・ボックスのコンポーネント

使用できるコンポーネントは、現行のディメンションおよび選択するオプションによって異なります。

「Based On」ボックス -- ソートの方法が一覧表示されます。表示されるオプションは次のとおりです。

「Alphabet」 -- アルファベット順にAからZ（「A to Z」）またはZからA（「Z to A」）の順序で値をソートします。

「Database」 -- データベースに格納されているディメンション値の順序に従って、標準（「standard」）または逆順（「reverse」）で値をソートします。

「Data Value」 -- メジャーの対応するデータ値を基に、昇順（「low to high」）または降順（「high to low」）で値をソートします。この方法を選択すると、次の追加のボックスが表示されます。

「Using」ボックス -- 使用するデータ値のメジャーを指定します。現行のディメンションを使用する別のメジャーを選択するには、「...Ellipsis」ボタンをクリックします。

「For」ボックス -- 「Using」ボックスで選択したメジャーの他のディメンションが一覧表示され、それぞれに1つのディメンション値が識別されます。ディメンション値を変更するには、「...Ellipsis」ボタンを選択します。

「Dragdrop」 -- 値を手動でソートできます。現行の選択項目の値がディメンション・リスト・ボックスに表示されます。値をクリックし、リストの別の位置にドラッグします。

「Hierarchy」 -- 階層内の順序を基に、上から下（「top to bottom」）または下から上（「bottom to top」）の順序で値をソートします。選択したディメンションに階層が定義されている場合のみ使用できます。この方法を選択すると、「In Hierarchy」ボックスが表示され、階層を選択することができます。

「Level」 -- レベルを基に、上から下（「top to bottom」）または下から上（「bottom to top」）の順序で値をソートします。選択したディメンションに階層が定義されている場合のみ使用できます。ソートによってレベルの順序は変わりますが、レベル内の値の順序は変わらないことに注意してください。この方法を選択すると、「In Hierarchy」ボックスが表示され、階層を選択することができます。

「Time」 -- 時期の早いものから遅いもの（「earliest to latest」）または遅いものから早いもの（「latest to earliest」）の順序で値をソートします。時間ディメンションを扱っている場合のみ使用できます。この方法を選択すると、「In Hierarchy」ボックスが表示され、階層を選択することができます。

「In Hierarchy」ボックス -- 「Based On」ボックスで「Data Value」、「Hierarchy」、「Level」、または「Time」を選択すると、選択したディメンションに定義されている階層が「In Hierarchy」ボックスに一覧表示されます。使用する階層を選択します。

「In Order」ボックス -- 「Alphabet」、「Database」、「Data Value」、「Hierarchy」、「Level」、および「Time」の各方法のソート順序のオプションが一覧表示されます。

「Script」ボックス -- 「OK」を選択した場合に選択スクリプトに追加される条件が表示されます。

「Preview」ボタン -- 「Preview」ダイアログ・ボックスが表示され、それまでのソート順序を置き換える前に、選択した値の新しいソート順序を確認できます。

「Sort Automatically」チェックボックス -- 選択項目が変更されるたびに、ディメンションを自動的にソートするかどうかを指定します。


関連項目 -- 「List」ダイアログ・ボックス

選択項目の置換または再構成

Listツールの使用方法


関連項目 -- 「Custom Measures」ダイアログ・ボックス

カスタム・メジャーの作成

カスタム・メジャーの式の定義

カスタム・メジャーへのアクセスの制限


関連項目 -- カスタム・メジャーの作成

カスタム・メジャーのコピー

カスタム・メジャーの式の定義

カスタム・メジャーへのアクセスの制限


関連項目 -- 保存済み選択項目の置換

保存済み選択項目ライブラリへのアクセスの制御

保存済み選択項目の作成

保存済み選択項目の削除

保存済み選択項目の改名


関連項目 -- 「Saved Selection」ダイアログ・ボックス

Saved Selectionsの使用方法


関連項目 -- 「Select All」ダイアログ・ボックス

選択項目の置換または再構成

Allツールの使用方法


関連項目 -- 「Select by Attribute」ダイアログ・ボックス

選択項目の置換または再構成

Attributeツールの使用方法


関連項目 -- 「Select by Exception」ダイアログ・ボックス

選択項目の置換または再構成

Exceptionツールの使用方法


関連項目 -- 「Select by Family」ダイアログ・ボックス

選択項目の置換または再構成

Familyツールの使用方法


関連項目 -- 「Select by Level」ダイアログ・ボックス

選択項目の置換または再構成

Levelツールの使用方法


関連項目 -- 「Select by Matching Characters」ダイアログ・ボックス

選択項目の置換または再構成

Matchツールの使用方法


関連項目 -- 「Select by Range」ダイアログ・ボックス

選択項目の置換または再構成

Rangeツールの使用方法


関連項目 -- 「Select Top/Bottom」ダイアログ・ボックス

選択項目の置換または再構成

Top/Bottomツールの使用方法


関連項目 -- 「Selection Library」ダイアログ・ボックス

保存済み選択項目の作成


関連項目 -- 「Selector」ダイアログ・ボックス

カスタム・メジャーの作成

保存済み選択項目の作成

問合せのセレクタのカスタマイズ

保存済み選択項目の改名

選択項目の置換または再構成

データの選択

Selectorツールバー

Saved Selectionsの使用方法


関連項目 -- 「Selector Options」ダイアログ・ボックス

保存済み選択項目ライブラリへのアクセスの制御

問合せのセレクタのカスタマイズ

セレクタ内のディメンション名の表示

セレクタ内のディメンション値の表示

Selectorツールの表示と非表示の切替え

カスタム・メジャーへのアクセスの制限


関連項目 -- Selectorツールバー

Selectorツールの表示と非表示の切替え

Saved Selectionsの使用方法

Allツールの使用方法

Attributeツールの使用方法

Exceptionツールの使用方法

Familyツールの使用方法

Levelツールの使用方法

Listツールの使用方法

Matchツールの使用方法

Rangeツールの使用方法

Sortツールの使用方法

Top/Bottomツールの使用方法


関連項目 -- 「Sort Selection」ダイアログ・ボックス

Sortツールの使用方法


問合せのセレクタのカスタマイズ

セレクタ・オプションを設定すると、問合せの「Selector」ダイアログ・ボックスの外観と動作をカスタマイズすることができます。問合せからセレクタが表示されるたびに、カスタマイズした「Selector」ダイアログ・ボックスが表示されます。

「Selector」ダイアログ・ボックスは、次のような方法でカスタマイズできます。

ダイアログ・ボックスのSelectorツールの表示と非表示を切り替えます。

たとえオプション・ボタンのラベルとして表示されるほどの数がなくても、リスト・ボックスにディメンション名を表示させます。

ディメンション値が表示される方法と場所を指定します。

保存済み選択項目ライブラリへのアクセスを制御します。

「Custom Measures」ダイアログ・ボックスへのアクセスを制御します。


保存済み選択項目ライブラリへのアクセスの制御

デフォルトでは、「Selector」ダイアログ・ボックスには「Library」ボタンがあります。このボタンを使用すると、保存済み選択項目の作成、変更、改名または削除を行う「Selection Library」ダイアログ・ボックスにアクセスできます。現行の問合せの「Library」ボタンを表示しないことによって、保存済み選択項目ライブラリへのアクセスを拒否できます。

注意: 保存済み選択項目ライブラリへのアクセスを拒否しても、Saved Selectionツールが使用可能であれば、ユーザーは保存済み選択項目を使用できます。

選択項目ライブラリへのアクセスを制御するには：

1.	「Selector」ダイアログ・ボックスで、「Options」を選択します。

2.	「Selector Options」ダイアログ・ボックスで、「Allow access to saved selection library」チェックボックスの値を変更します。

ライブラリへのアクセスを許可するには、チェックボックスを選択します。

または

ライブラリへのアクセスを防止するには、チェックボックスの選択を解除します。

3.	「OK」を選択します。


保存済み選択項目の作成

セレクタを使用するときに、特定のディメンション値の集合を何度も選択する場合があります。時間を節約するために、これらの選択項目を保存し、別の問合せで再使用できます。

データベースが読込み/書込みで連結されているときに選択項目を保存すると、そのデータベースを連結するすべてのユーザーが、その保存済み選択項目を使用できるようになります。データベースが読込み専用で連結されているときに選択項目を保存すると、自分のみがその保存済み選択項目を使用できるようになります。

選択項目を保存するには:

1.	「Selector」ダイアログ・ボックスで、「Library」を選択します。「Selector Library」ダイアログ・ボックスが表示されます。

注意: 「Selector」ダイアログ・ボックスに「Library」ボタンが表示されていない場合は、「Selector」オプションを「allow access to the library」に変更します。

2.	「Selections」ボックスで、<Current Selection>をクリックします。

3.	「Selection Library」ダイアログ・ボックスで、「Save」を選択します。

4.	「Save Selection」ダイアログ・ボックスのオプションを設定します。表示されている情報を調べ、保存する選択項目が説明されていることを確認します。

5.	「OK」を選択します。

6.	「Selection Library」ダイアログ・ボックスで、「Close」を選択して「Selector」ダイアログ・ボックスに戻ります。


保存済み選択項目の削除

使用する予定のなくなった保存済み選択項目は、削除できます。

保存済み選択項目を削除するには:

1.	「Selector」ダイアログ・ボックスで、「Library」を選択します。「Selector Library」ダイアログ・ボックスが表示されます。

注意: 「Selector」ダイアログ・ボックスに「Library」ボタンが表示されていない場合は、「Selector」オプションを「allow access to the library」.に変更します。

2.	削除する保存済み選択項目を選択し、「Delete」を選択します。メッセージ・ボックスによって、選択項目を削除するかどうかを確認されます。

3.	「OK」を選択します。

4.	「Selection Library」ダイアログ・ボックスで、「Close」を選択して「Selector」ダイアログ・ボックスに戻ります。


セレクタ内のディメンション名の表示

デフォルトでは、ダイアログ・ボックスに収まりきらないほどの数のディメンションがない限り、ディメンション名はオプション・ボタンのラベルとして「Selector」ダイアログ・ボックスに表示されます。ディメンションが多すぎる場合は、ディメンション名がリスト・ボックスに表示されます。オプションを設定すると、ディメンションの数にかかわらず、ディメンション名が常にリスト・ボックスに表示されるようになります。

このオプションの設定は、問合せから「Selector」ダイアログ・ボックスが表示されるたびに有効になります。

セレクタのリスト・ボックスにディメンション名を表示するには:

1.	「Selector」ダイアログ・ボックスで、「Options」を選択します。「Selector Options」ダイアログ・ボックスが表示されます。

2.	「Selector Options」ダイアログ・ボックスで、「Use listbox to represent dimension」を選択します。

3.	「OK」を選択します。


セレクタ内のディメンション値の表示

セレクタ・オプションを使用すると、セレクタ内のディメンション値の表示方法を次のように柔軟に設定できます。

ディメンション値を「Selector」ダイアログ・ボックスに表示します。

ディメンション値の表示方法と使用方法をセレクタ全体を通じて変更します。

このオプションの設定は、現行の問合せから「Selector」ダイアログ・ボックスが表示されるたびに有効になります。

「Selector」ダイアログ・ボックスの値の表示

デフォルトでは、「Selector」ダイアログ・ボックスにディメンションの選択項目の選択スクリプトは表示されますが、選択した値は表示されません。Listツールを使用すると、選択した値を表示できます。また、セレクタ・オプションを設定し、「Selector」ダイアログ・ボックスに値を表示することもできます。

「Selector」ダイアログ・ボックスにディメンション値を表示するには:

1.	「Selector」ダイアログ・ボックスで、「Options」を選択します。

2.	「Selector Options」ダイアログ・ボックスで、「Show selection values」を選択します。

3.	「OK」を選択します。

セレクタ内のディメンション値の表示方法の変更

デフォルトでは、ディメンション値は長いラベルの形式（New Yorkなど）でセレクタに表示されます。値には、短いラベルの形式（NYなど）と、スペースなしの大文字のみで表されるExpressデータベースの識別子の形式（NEWYORKなど）もあります。セレクタ・オプションを使用すると、セレクタのリスト・ボックスの表示形式を、長いラベル、短いラベルまたは実際の識別子のいずれかに指定できます。

注意: SortツールおよびMatchツールでも、ここで選択した種類のラベルが使用されます。たとえば、オプションを「Values」に設定すると、Matchツールは指定した文字列に一致する実際のディメンション値を検索します。Sortツールがディメンションをアルファベット順にソートする場合は、実際のディメンション値のスペルを使ってアルファベット順を判断します。

セレクタ・リストのディメンション値の表示を変更するには:

1.	「Selector」ダイアログ・ボックスで、「Options」を選択します。

2.	「Selector Options」ダイアログ・ボックスの「Show dimension values as」ボックスで、次のいずれかのオプションを選択します。

ディメンション値を長いラベルの形式（New Yorkなど）で表示するには、「Long labels」を選択します。

ディメンション値を短いラベルの形式（NYなど）で表示するには、「Short labels」を選択します。

ディメンション値をExpressデータベースに表示されるとおりの形式で表示するには、「Values」を選択します。

3.	「OK」を選択します。


Selectorツールの表示と非表示の切替え

デフォルトでは、すべてのSelectorツールが「Selector」ダイアログ・ボックスに表示されます。選択したディメンションに適用できないツールは、ダイアログ・ボックスでグレー表示になります。セレクタ・オプションを使用すると、使用可能なツールをダイアログ・ボックスで非表示にすることができます。

このオプションの設定は、現行の問合せから「Selector」ダイアログ・ボックスが表示されるたびに有効になります。

「Selector」ダイアログ・ボックスでSelectorツールを非表示にするには:

1.	「Selector」ダイアログ・ボックスで、「Options」を選択します。「Selector Options」ダイアログ・ボックスが表示されます。

2.	「Available Tools」ボックスで、「Selector」ダイアログ・ボックスに表示するツールのチェックボックスを選択します。ダイアログ・ボックスに表示したくないツールのチェックボックスは、選択を解除します。たとえば、Allツールを表示し、Rangeツールを表示したくない場合は、Allツールを選択し、Rangeツールの選択を解除します。

3.	「OK」を選択します。


保存済み選択項目の改名

選択項目を保存した後で、保存済み選択項目を改名できます。

保存済み選択項目を改名するには:

1.	「Selector」ダイアログ・ボックスで、「Library」を選択します。

注意: 「Selector」ダイアログ・ボックスに「Library」ボタンが表示されていない場合は、「Selector」オプションを「allow access to the library」.に変更します。

2.	「Selection Library」ダイアログ・ボックスで、改名する保存済み選択項目を選択します。

3.	「Rename」を選択します。

4.	「Rename Selection」ダイアログ・ボックスのオプションを設定します。

5.	「OK」を選択します。

6.	「Selection Library」ダイアログ・ボックスで、「Close」を選択して「Selector」ダイアログ・ボックスに戻ります。


選択項目の置換または再構成

Selectorツールは、ディメンションの選択項目に入れるディメンション値を指定するときに使用します。これらのツールを使用すると、現在有効になっている選択項目を置き換えて選択処理を最初からやり直すことや、現行の選択項目を再構成することができます。

現行の選択項目を新しい項目に置換するには:

Selectorツールで、選択タイプに「Select」を選択します。

現行の選択項目を再構成するには:

Selectorツールで、次のいずれかの選択タイプを選択します。

新しく選択したディメンション値を現行の選択項目に追加するには、「Add」を選択します。

新しく選択したディメンション値のみを選択項目に保持するには、「Keep」を選択します。

新しく選択した値を現行の選択項目から削除するには、「Remove」を選択します。


保存済み選択項目の置換

関連項目

以前に保存した選択項目を置換できます。

保存済み選択項目を変更するには:

1.	Saved Selectionツールを使用して、変更する保存済み選択項目を選択します。

または

新しい選択から開始します。

2.	他のSelectorツールを使用して、選択項目を変更します。

3.	「Selector」ダイアログ・ボックスで、「Library」を選択します。「Selector Library」ダイアログ・ボックスが表示されます。

注意: 「Selector」ダイアログ・ボックスに「Library」ボタンが表示されていない場合は、「Selector」オプションを「allow access to the library」.に変更します。

4.	「Selections」ボックスで、<Current Selection>をクリックします。

5.	「Save」を選択します。

6.	「Save Selection」ダイアログ・ボックスのオプションを設定します。表示されている情報を調べ、保存する選択項目が説明されていることを確認し、「Save Selection As」ボックスで「Replacement」を選択します。

7.	「OK」を選択します。

8.	「Replace Saved Selection」ダイアログ・ボックスのオプションを設定します。

9.	「Selection Library」ダイアログ・ボックスで、「Close」を選択して「Selector」ダイアログ・ボックスに戻ります。


データの選択

セレクタは、各ディメンションのディメンション値を選択するための、相互に関連するダイアログ・ボックスの集まりです。セレクタの機能を使用すると、ディメンションに特定の値を選択し、値をソートし、ディメンション値のカスタム選択を保存し、カスタム・メジャーと保存済み選択項目を処理することができます。また、セレクタの表示オプションも設定できます。

セレクタを使用するには:

1.	「Express Query」ダイアログ・ボックスで問合せのメジャーを選択し、「Selector」を選択します。

「Selector」ダイアログ・ボックスが表示されます。ディメンションと、現在ディメンションに選択されている値の数が表示されます。

ヒント: 「Options」を選択すると、セレクタ内のディメンション値の表示方法を変更できます。たとえば、値が番号ではなくリストで表示されるように指定できます。

2.	Selectorツールを使って、保存済み選択項目を含む、このディメンションの値の選択とソートを行います。現行の選択条件がスクリプトに表示されます。ツールを使って選択項目を修正するか、置換します。

注意: ディメンションの種類によっては、使用できないツールがあります。グレー表示になっているツールは使用できません。

ヒント: 現行の選択項目のディメンション値を表示するには、Listツールを選択します。

3.	選択項目に必要な値が入ったら、「Selector」ダイアログ・ボックスで「OK」を選択します。

ヒント: 再度使用する選択条件を作成する場合は、セレクタを終了する前に保存できます。選択項目を保存するには、「Library」を選択します。

4.	変更するディメンションごとにステップ1～3を繰り返します。

5.	カスタム・メジャーを作成または保存済みカスタム・メジャーを選択するには、Measureディメンションを選択して「Custom」を選択します。

6.	作業が完了したら、「OK」を選択します。


Selectorツールバー

関連項目

Selectorツールバーには、条件に適合するディメンション値を選択または配置するためのツールが用意されています。Selectorツールバーは、「Selector」ダイアログ・ボックスの上部に表示されます。

アイコン	ツール	説明
	Allツール	ディメンションまたはディメンション階層のすべての値を選択または選択解除します。
	Listツール	ディメンションの値のリストから値を選択または選択解除します。
	Matchツール	指定した文字列を含むディメンション値を選択します。
	Levelツール	階層の1つ以上のレベルにあるディメンション値を選択または選択解除します。
	Familyツール	特定のディメンション値とのファミリ・リレーションを基に、ディメンション値を選択または選択解除します。
	Attributeツール	カラーやサイズなど、共通の属性を持つディメンション値のグループを選択または選択解除します。
	Exceptionツール	メジャー値と別の値との比較を基に、ディメンション値を選択または選択解除します。
	Top/Bottomツール	特定のメジャーの最大または最小のデータ値を選択または選択解除します。
	Rangeツール	期間の範囲を選択または選択解除します。
	Saved Selectionツール	保存済み選択項目のディメンション値を選択または選択解除します。
	Sortツール	指定した条件を使用してディメンション値をソートします。


Saved Selectionツールの使用方法

Express Administratorで保存された選択項目を使用できます。

保存済み選択項目を使用するには:

1.	「Selector」ダイアログ・ボックスで、SelectorツールバーからSaved Selectionツールを選択します。

2.	「Saved Selection」ダイアログ・ボックスのオプションを設定します。

3.	「OK」を選択します。


Allツールの使用方法

Allツールは、ディメンションのすべての値を選択するときや、階層のすべてのディメンション値を選択するときに使用します。

ディメンションのすべての値または階層のすべてのディメンション値を選択するには:

1.	「Selector」ダイアログ・ボックスで、SelectorツールバーからAllツールを選択します。

2.	「Select All」ダイアログ・ボックスのオプションを設定します。

3.	「OK」を選択します。


Attributeツールの使用方法

Attributeツールは、カラーやサイズなど、特定の属性を共有するディメンション値を選択するときに使用します。

属性によってディメンション値を選択するためには、そのディメンションが1つ以上の属性を持っている必要があります。

属性を共有するディメンション値を選択するには:

1.	「Selector」ダイアログ・ボックスで、SelectorツールバーからAttributeツールを選択します。

2.	「Select by Attribute」ダイアログ・ボックスのオプションを設定します。

3.	「OK」を選択します。


Exceptionツールの使用方法

Exceptionツールは、ディメンションを使用するメジャーの値を基にディメンション値を選択するときに使用します。たとえば、Sales（売上げ）値が$1,000,000を超える都市を選択することができます。

また、Exceptioinツールを使用して、2つの異なるメジャーの比較を基に選択を行うこともできます。たとえば、Sales（売上げ）値がForcast（予想）を5%以上上回る製品を選択することができます。

注意: 例外値の検索は、指定したメジャーの他のディメンションごとに1つのディメンション値に制限されています。

Exceptionツールを使用して値を選択するには:

1.	「Selector」ダイアログ・ボックスで、SelectorツールバーからExceptionツールを選択します。

2.	「Select by Exception」ダイアログ・ボックスのオプションを設定します。

3.	「OK」を選択します。


Familyツールの使用方法

ディメンションに階層が定義されている場合、Familyツールを使用すると、特定のディメンション値とのファミリ・リレーションを持つ値を選択できます。たとえば、地域のセールス・マネージャが、担当地域内の都市を選択するとします。Familyツールを使用すると、担当地域（たとえば米国東部）とその子の地域（たとえばボストン、ニューヨーク、フィラデルフィアなど）を選択できます。

あるいは、1か月の間に売上げが倍増した1つの店舗を取り上げたとします。Familyツールを使って、その店舗の親や祖先を選択し、店舗の売上げがその店舗の都市や地域の売上げの数字にどのように影響したかを調べることができます。

Familyツールを使用して値を選択するには:

1.	「Selector」ダイアログ・ボックスで、SelectorツールバーからFamilyツールを選択します。

2.	「Select by Family」ダイアログ・ボックスのオプションを設定します。

3.	「OK」を選択します。


Levelツールの使用方法

ディメンションに階層が定義されている場合、Levelツールを使用すると、階層の1つ以上のレベルにあるすべての値を選択できます。たとえば、都市ごとのSales（売上げ）データを分析するには、City（都市）レベルにあるすべてのGeography（地理）ディメンション値を選択します。月次および四半期ごとのSales（売上げ）データを分析するには、Month（月）およびQuarter（四半期）レベルにあるすべてのTime（期間）値を選択します。

Levelツールを使用して値を選択するには:

1.	「Selector」ダイアログ・ボックスで、SelectorツールバーからLevelツールを選択します。

2.	「Select by Level」ダイアログ・ボックスのオプションを設定します。

3.	「OK」を選択します。


Listツールの使用方法

Listツールは、使用可能なすべての値のリストからディメンション値を個別に選択するときに使用します。

Listツールを使用してディメンション値を選択するには:

1.	「Selector」ダイアログ・ボックスで、SelectorツールバーからListツールを選択します。

2.	「List」ダイアログ・ボックスのオプションを設定します。次のようにディメンション値を選択します。

目的 . .	操作 . .
現行の選択項目に値を追加するか、現行の選択項目を置換する。	「Available Dimension Values」ボックスで値をハイライトし、「Add」または「Select」を選択する。
現行の選択項目に値を保持するか、現行の選択項目から値を削除する。	「Selected Dimension Values」ボックスで値をハイライトし、「Keep」または「Remove」を選択する。
3.	「OK」を選択します。


Matchツールの使用方法

Matchツールは、特定の文字列を検索することによって、ディメンション値を選択するときに使用します。たとえば、Matchツールを使用すると、「Size 12」という文字列を含むすべての値を選択することができます。

Matchツールは、セレクタに表示されるとおりのディメンション値を検索します。たとえば、ディメンション値が短いラベルの形式で表示されるようにセレクタ・オプションを設定すると、Matchツールは指定した文字列の短いラベルを検索します。

ヒント: 「Options」ボタンを使用すると、セレクタ内のディメンション値の名前の表示方法を変更できます。たとえば、長い名前（New Yorkなど）ではなく、短い名前（NYなど）で値が表示されるように指定できます。

Matchツールを使用して値を選択するには:

1.	「Selector」ダイアログ・ボックスで、SelectorツールバーからMatchツールを選択します。

2.	「Select by Matching Characters」ダイアログ・ボックスのオプションを設定します。

3.	「OK」を選択します。


Rangeツールの使用方法

Rangeツールは、Time（期間）値の範囲を選択するときに使用します。たとえば、前年の1月から6月までの範囲の月を選択することができます。また、今年の1月から現在の日付までのすべての月を選択することや、最後の3か月を選択することもできます。

期間値の範囲を選択するには:

1.	「Selector」ダイアログ・ボックスで、SelectorツールバーからRangeツールを選択します。

2.	「Select by Range」ダイアログ・ボックスのオプションを設定します。

3.	「OK」を選択します。


Sortツールの使用方法

デフォルトでは、階層型の各ディメンションは、問合せ結果に表示される前と、選択項目が変更されるたびにソートされます。階層型ディメンションでは、Sortツールを使用して自動ソート処理をオフにしたり、ディメンション値のソートに使用される規則を変更したりできます。

非階層型ディメンションでは、Sortツールを使ってディメンション値をソートしたり、ディメンションの自動ソート処理をオンにしたりできます。

ディメンション値をソートするには:

1.	「Selector」ダイアログ・ボックスで、SelectorツールバーからSortツールを選択します。

2.	「Sort Selection」ダイアログ・ボックスを設定します。選択項目を変更するたびにディメンション値がソートされるようにするには、「Sort Automatically」ボックスを必ず選択してください。

3.	「OK」を選択します。


Top/Bottomツールの使用方法

Top/Bottomツールは、特定のメジャーで最大または最小のデータ値を持つディメンション値を選択するときに使用します。たとえば、Audio Division（オーディオ部門）製品ラインの第一四半期のSales（売上げ）を基に、上位10都市を選択することができます。あるいは、その年のすべての製品のSales（売上げ）を基に、下位30%の都市を選択することもできます。

注意: 最上位および最下位のデータ値の検索は、指定したメジャーの他のディメンションごとに1つのディメンション値に制限されています。

最上位または最下位のディメンション値を選択するには:

1.	「Selector」ダイアログ・ボックスで、SelectorツールバーからTop/Bottomツールを選択します。

2.	「Select Top/Bottom」ダイアログ・ボックスのオプションを設定します。

3.	「OK」を選択します。


Expressの操作

Reportsのマニュアルには、Expressについて言及されている箇所があります。Expressは、予測、特定の状況を仮定したシナリオ、財務モデリングなどの機能を備えたオンライン分析処理（OLAP）を提供します。マルチディメンションのデータ・モデルをベースに、Expressは販売、マーケティング、財務、製造、人事のデータなど、企業データの問合せと分析のために最適化されています。

Expressデータベースからのデータを含むレポートを作成するには、次の操作を行います。

Expressへの問合せの作成

 データの選択

 データベースの連結

 データベースの削除

Report Builderのインストール時にExpressコンポーネントをインストールしなかった場合は、Expressデータを含むレポートを作成できません。Expressコンポーネントをインストールする方法は、『Reportsスタート・ガイド』を参照してください。

多くのExpressアプリケーションでは、データは階層内に提示されます。階層では、データのレベルがインデントされます。多くの場合には、レベルのドリル・アップやドリル・ダウンを行うことができます。Report Builderでは、データはインデントされた階層として提示されますが、ドリル・アップやドリル・ダウンはサポートされていません。


データベースの連結

Expressデータベースを問合せのデータ・ソースとして利用するには、データベースを連結する必要があります。複数のソースからデータをフェッチする場合は、複数のデータベースを同時に連結できます。

重要: 同じオブジェクト名を使用する複数のデータベースを連結しないでください。予期しない結果が生じる可能性があります。

 データベースを連結するには:

1.	「Express Query」ダイアログ・ボックスで、「Attach Database」を選択します。

2.	オープンするデータベース・ファイルを見つけます。

3.	「Open」を選択し、データベース・ファイルを連結します。

4.	さらに他のデータベースを連結するには、ステップ1～3を繰り返します。


データベースの削除

Expressデータベースの作業が終了したら、データベースを削除（連結解除）します。

注意: アクティブな問合せが使用しているデータベースの連結を解除することはできません。問合せが処理中の場合、または問合せの結果がオープン・レポートに表示されている場合は、データベースの連結を解除する前に問合せを取消すか、結果を削除する必要があります。

 データベースの連結を解除するには:

1.	「Express Query」ダイアログ・ボックスを表示します。

2.	「Choose Database」ボックスで、連結解除するデータベースを選択します。

3.	「Remove Database」を選択します。

4.	連結解除するデータベースごとに、ステップ2と3を繰り返します。


Expressへの問合せの作成

Expressデータへの問合せを作成するには、次のいずれかの方法を用います。

レポート・ウィザード

Express Queryツール


Expressへの問合せの作成: レポート・ウィザード

レポート・ウィザードを使用すると、Expressデータベースからのデータの問合せを簡単に作成し、その結果をReport Builderに表示できます。

 Expressへの問合せを作成するには:

1.	「ツール」メニューから「レポート・ウィザード」を選択します。

2.	「スタイル」ページで、目的のレポート・スタイルを選択します。

3.	「次へ」を選択します。

4.	「Expressへの問合せ」を選択し、「次へ」を選択します。

5.	「接続」を選択して「接続」ダイアログ・ボックスを表示し、OLAP Serverへの接続を確立します。

6.	「Expressへの問合せ」を選択し、「Express Query」ダイアログ・ボックスを表示します。

7.	「Choose Database」ボックスで、データベースを選択します。

目的のデータベースが表示されない場合は、「Attach Database」を選択してデータベースを連結します（連結したデータベースは「Choose Database」ボックスに表示されます）。

8.	問合せのメジャーを選択します。そのためには、「Available Measures」ボックスでメジャーをダブルクリックするか、次のいずれかのボタンを使用します。

注意: 「Selected Measures」ボックスからメジャーを削除するには、そのメジャーをダブルクリックするか、次のいずれかのボタンを使用します。

9.	「Selector」を選択し、「Selector」ダイアログ・ボックスを表示します。このダイアログ・ボックスで、現行の選択スクリプトを表示することや、Selectorツールを使用してこのディメンションの選択項目を再構成または置換することができます。

ヒント: 現行値を表示するには、Listツールを選択します。

10.	各ディメンションの値を選択します。

11.	セレクタの作業が終了したら、「OK」を選択します。

12.	「Express Query」ダイアログ・ボックスの作業が終了したら、「OK」を選択します。


Expressへの問合せの作成: Express Queryツール

Express Queryツールを使用すると、Expressデータベースからのデータの問合せを簡単に作成し、その結果をReport Builderに表示できます。

 Expressへの問合せを作成するには:

1.	Oracle8に接続します。

2.	データ・モデル表示で、ツール・パレットの [image] [image] をシングル・クリックします。

3.	ウィンドウのメイン領域（キャンバス領域）をクリックします。

4.	新しく作成された問合せをダブルクリックし、「接続」ダイアログ・ボックスの各フィールドを設定して、OLAP Serverへの接続を確立します。

5.	「Expressへの問合せ」を選択し、「Express Query」ダイアログ・ボックスを表示します。

6.	「Choose Database」ボックスで、データベースを選択します。

目的のデータベースが表示されない場合は、「Attach Database」を選択してデータベースを連結します。（連結したデータベースは「Choose Database」ボックスに表示されます。

7.	問合せのメジャーを選択します。そのためには、「Available Measures」ボックスでメジャーをダブルクリックするか、次のいずれかのボタンを使用します。

注意: 「Selected Measures」ボックスからメジャーを削除するには、そのメジャーをダブルクリックするか、次のいずれかのボタンを使用します。

8.	「Selector」を選択し、「Selector」ダイアログ・ボックスを表示します。このダイアログ・ボックスで、現行の選択スクリプトを表示することや、Selectorツールを使用してこのディメンションの選択項目を再構成または置換することができます。

ヒント: 現行値を表示するには、Listツールを選択します。

9.	各ディメンションの値を選択します。

10.	セレクタの作業が終了したら、「OK」を選択します。

11.	「Express Query」ダイアログ・ボックスの作業が終了したら、「OK」を選択します。


カスタム・メジャーのコピー

「Custom Measures」ダイアログ・ボックスの「Custom Measure」ボックスに表示されるカスタム・メジャーは、コピーできます。

カスタム・メジャーをコピーするには:

1.	「Express Query」ダイアログ・ボックスで、「Custom Measures」を選択します。

2.	「Custom Measures」ダイアログ・ボックスで、コピーするカスタム・メジャーが含まれているデータベースを選択します。

3.	「Custom Measures」ボックスで、コピーするメジャーを選択します。

4.	「Copy」を選択します。

5.	「Custom Measures - Action」ダイアログ・ボックスで設定を完了します。

6.	「OK」を選択します。

7.	「Close」を選択します。


カスタム・メジャーの作成

関連項目

問合せを作成するときに、データベース内に存在しない式を使用する場合があります。既存のメジャーを使用して、これらの必要条件を満たす式を定義できます。作成する式をカスタム・メジャーと呼びます。

データベースが読込み/書込みで連結されているときにカスタム・メジャーを作成すると、そのデータベースを連結するすべてのユーザーが、そのカスタム・メジャーを使用できるようになります。データベースが読込み専用で連結されているときにカスタム・メジャーを作成すると、自分のみがそのカスタム・メジャーを使用できるようになります。

 新規カスタム・メジャーを作成するには:

1.	「Express Query」ダイアログ・ボックスで、「Custom Measures」を選択します。

2.	「Custom Measures」ダイアログ・ボックスで、使用するデータベースを選択します。

3.	「New」ボタンを選択します。タイトル・バーに表示されるアクションの名前は「New」です。

4.	「Custom Measures - Action」ダイアログ・ボックスで設定を完了します。

5.	「OK」を選択して「Custom Measures」ダイアログ・ボックスに戻ります。

6.	「Close」を選択します。


カスタム・メジャーの式の定義

カスタム・メジャーを作成、コピーまたは編集するときに、カスタム・メジャーで値の計算に使用される式を定義します。「Custom Measures - Action」ダイアログ・ボックスの「Expression」ボックスで、式を定義します。

注意: 現在は、TOTALやAVERAGEなどの集計関数をカスタム・メジャーで使用することはできません。これらの関数を使用すると、予期しない結果が発生します。

式を定義する最も簡単な方法は、「Choices」ボックスに表示されているオブジェクト、関数および演算子から選択することです。集計関数は提示されないので、「Choices」ボックスに表示されている関数はすべて安全に使用できます。

入力する値が有効なExpress式である限り、「Expression」ボックスに式を直接入力することもできます。

「Choices」ボックスで選択して式を定義するには:

1.	「Category」ボックスで、関数または演算子のカテゴリを選択します。特定の関数がどのカテゴリに含まれているかが不明な場合は、「Function」を選択してから「All」を選択します。

2.	「Choices」ボックスで、関数または演算子を選択します。

選択したエントリに関する情報は、「Category」ボックスと「Choices」ボックスの下の「Information」ボックスに表示されます。

各関数の詳細は、『Expressリファレンス・マニュアル』を参照してください。

3.	次のいずれかの方法で、「Choices」ボックス項目を「Expression」ボックスに挿入します。

選択項目をダブルクリックする。

または

選択項目をクリックし、「Insert」を選択する。

4.	「Expression」ボックスで、挿入した式の一部を選択し、必要に応じて置換します。ダブルクリックして、引数を選択することができます。

たとえば、関数のプロトタイプを挿入した後で、プロトタイプ内の最初の引数が選択されるので、その引数を実際の引数で置換できます。関数を挿入したのと同じ方法で、Expressディメンション名を挿入できます。


カスタム・メジャーへのアクセスの制限

「Custom Measures」ダイアログ・ボックスを使用すると、ユーザーは、カスタム・メジャーと呼ばれる独自の式を作成してデータを分析できます。ユーザーは、「Custom Measures」ダイアログ・ボックスを使用して、他のカスタム・メジャーを編集、コピーまたは削除することもできます。

「Selector」オプションを設定して、「Selector」ダイアログ・ボックスの「Custom」ボタンが表示されないようにすることができます。この操作によって、ユーザーはセレクタからカスタム・メジャーを作成、編集、コピーまたは削除できなくなりますが、自分で作成したカスタム・メジャーを使用することはできます。ユーザーは「Express Query」ダイアログ・ボックスで、「Custom Measures」オプションを選択することもできます。

このオプションの設定は、現行の問合せから「Selector」ダイアログ・ボックスが表示されるたびに有効になります。

問合せでの「Custom Measure」ダイアログ・ボックスへのアクセスを制限するには:

1.	「Selector」ダイアログ・ボックスで、「Options」を選択します。

2.	「Selector Options」ダイアログ・ボックスで、「Allow custom measure functionality」チェックボックスの値を変更します。

「Custom」ボタンを表示しないようにするには、チェックボックスの選択を解除します。

または

「Custom」ボタンを表示するには、チェックボックスを選択します。

3.	「OK」を選択します。


Express Reports Queryのヘルプ

  Express Reports Queryの使用方法

データベースの連結

Expressへの問合せの作成

データベースの削除

セレクタの使用方法

Expressの操作

  参照

Express Reports Queryのヘルプ情報


Express Reports Queryのヘルプ情報

表記規則

このヘルプ・システムでは、書体の表記規則を使用して特定の情報を分類し、書式の表記規則を使用して一貫した外観を作成しています。これらの表記規則を知っておくと、ヘルプ・システムをより効果的に利用できます。

書体の表記規則

このヘルプ・システムでは、次に示す書体の表記規則が使用されています。

表記規則	説明
太字のテキスト	メニュー項目、コマンド・ボタン、フィールド名またはオプションを表します。
固定幅のテキスト	フォルダ名、ファイル名およびオペレーティング・システムのコマンドを表します。また、表示されるとおりに入力する必要のある例やその他のテキストを表す場合もあります。 たとえば、show eversionと入力するように求められている場合は、クーリエフォントで表示されているとおりにすべての文字を入力します。
イタリックの テキスト および 太字イタリックのテキスト	可変テキストを含めた変数を表します。可変テキストは、ダイアログ・ボックスやその他のインタフェース・コンポーネントにラベルが付いていないか、現行のコンテキストに応じて動的に変化するラベルが付いている場合に使用されます。可変テキストの文字列は、画面に表示される文字列とは完全に一致しません。 注意: イタリックや太字イタリックのテキストを含むヘルプ・トピックを印刷すると、印刷設定によってはイタリック体の項目が標準テキストで印刷されることがあります。
大文字のテキスト	Expressコマンドとオブジェクト、および頭字語を表します。
書式の表記規則

このヘルプ・システムのメインのヘルプ・ウィンドウに表示されるトピックは、ウィンドウを画面いっぱいの高さと画面半分の幅にしたときに最良の状態で表示されるように書式設定されています。ただし、メインのヘルプ・ウィンドウは任意のサイズに調整できます。


セレクタの使用方法

ディメンション値の選択

選択項目の置換または再構成

データの選択

Selectorツールバー

Allツールの使用方法

Attributeツールの使用方法

Exceptionツールの使用方法

Familyツールの使用方法

Levelツールの使用方法

Listツールの使用方法

Matchツールの使用方法

Rangeツールの使用方法

Sortツールの使用方法

Top/Bottomツールの使用方法

セレクタ・オプションの設定

問合せのセレクタのカスタマイズ

セレクタ内のディメンション値の表示

セレクタ内のディメンション名の表示

Selectorツールの表示と非表示の切替え

カスタム・メジャーの操作

カスタム・メジャーのコピー

カスタム・メジャーの作成

カスタム・メジャーの式の定義

カスタム・メジャーへのアクセスの制限

保存済み選択項目の操作

保存済み選択項目の作成

保存済み選択項目の削除

保存済み選択項目の改名

保存済み選択項目の置換

Saved Selectionsの使用方法


HTMLページ・ストリーム

 関連項目

HTMLページ・ストリームを使用すると、レポート全体をダウンロードすることなく、HTML/HTMLCSSレポート出力の個々のページをWebブラウザに表示できます。レポートの最初のページから、他のどのページにでも移動することができます。宛先が設定されたブックマークまたはハイパーリンクをクリックすると、次の処理が行われます。

•	レポート内では、現行のページを含む枠が宛先のページに更新されます。

•	レポート外では、基本枠全体（ブックマーク枠、ページおよびナビゲーション枠を含む）が再ロードされます。

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

ページ間のナビゲーション・コントロールを提供するには、次のどちらかの方法を用います。

•	Report Builderに備わっているビルトインのJavaScriptを使用します。

•	独自のJavaScript（または他のスクリプト）を提供します。

独自のスクリプトを提供する場合は、次の2つの変数をスクリプトに組み込んでください。

•	&TotalPages（合計ページ数）

•	&file_name（出力宛先ファイルの名前。例myreport）

Report Builderによって、書式設定時にこれらの変数が割り当てられます。

ページ・ナビゲーション・コントロール枠の高さは、スクロール・バーなしで70ポイントにハードコードされます。枠の幅は可変です。この枠の中でアイコンやイメージを使用する場合は、これらの寸法を覚えておいてください。

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

•	PL/SQL（Before ReportトリガーのSRW.SET_PAGE_NAVIGATION_HTML）を使用します。

•	レポート・プロパティ・パレットで「ページ・ナビゲーション・コントロール・タイプ」および「ページ・ナビゲーション・コントロール値」プロパティを使用します。

出力ファイル名

HTMLページ・ストリームでは、各ページが個別のHTMLドキュメントとしてフォーマットされます。HTMLファイルの名前がmyreport.htmで、ブックマークが含まれていない場合、新しいファイルの名前は次のようになります。

•	myreport.htm（基本枠）

•	myreport_1.htmからmyreport_n.htm（ページ）

•	myreportj.htm（ナビゲーションJavaScript）

HTMLファイルにブックマークが含まれている場合は、新しいファイルの名前は次のようになります。

•	myreport.htm（基本枠）

•	myreportb.htm（ブックマーク・ファイル）

•	myreport_1.htmからmyreport_n.htm（ページ）

•	myreportj.htm（ナビゲーションJavaScript）

HTML出力の範囲

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

ページ・ストリーム出力を使用可能にする

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


他の意思決定支援ツールとの統合

Oracle DiscovererおよびOracle Expressとの組合せにより、Reportsは生産報告や非定型の問合せから高度な分析に至る、企業のあらゆる範囲の意思決定支援のニーズに対応する高品質な技術を提供します。この統合ソリューションは、開発および配置のコストを軽減すると同時に、卓越した使いやすさと比類のないパフォーマンスを実現します。

作成したDiscovererのワークシートは、動的Webレポートに即座に変換し、組織全体に公開することができます。ワークシートをレポートに変換する詳しい方法は、Discovererのマニュアルを参照してください。

Report Builderでは、Expressの単位とディメンションを基にレポートを作成できます。レポート・ウィザードでは、Expressへの問合せを作成するか、SQL問合せを作成するかを選択できます。「Express Query」ダイアログ・ボックスで、レポートで使用するデータベース、単位およびディメンションを選択します。Express Selectorなどの使い慣れたExpressツールを使用して、問合せをさらに細かく設定できます。Expressへの問合せの作成が終了した後は、他のレポートと同じようにレポート・レイアウトをすばやく生成したり、修正したりできます。


デリミタ付き出力

  制限 [image]  関連項目

デリミタ付き出力を使用すると、デリミタ（文字または文字列）を指定して、レポート出力のデータを区切ることができます。この機能を使用して、Microsoft Excelなどのスプレッドシート・ユーティリティに簡単にインポートできるレポート出力を作成できます。

デリミタは、次のどちらかの方法で指定します。

•	コマンド・ラインからDELIMITERパラメータを使用して指定します。

•	「デリミタ付き出力」ダイアログ・ボックスの「デリミタ」オプションを使用して指定します。

デリミタ付き出力を生成するときに、セルの囲みを使用してセルをさらに区別することができます。セルの囲みは、カンマやカッコなどの一連の文字列から成ります。

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

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

使用上の注意

デリミタ付き出力を生成すると、データはレイアウト・モデル表示のオブジェクトの位置に従って表示されます。

•	AをBの上または左に配置すると（AとBをボイラープレート・オブジェクトまたはフィールド・オブジェクトとした場合）、出力のすべての行でAの各インスタンスがBの各インスタンスより前に表示されます。

 ここをクリックしてください。

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

 ここをクリックしてください。

•	この前のレイアウトで、ボイラープレート・オブジェクト（C）を含み、フィールド・オブジェクト（D）を含む別の繰返し枠を囲む枠をもう1つ追加すると、Bのすべてのインスタンスに対してAが表示され、Dのすべてのインスタンスに対してCが表示されます。

 ここをクリックしてください。

•	レポートにマトリックスを作成する場合は、レイアウト・モデル表示の格子に沿って慎重にオブジェクトを整列させてください。オブジェクトが整列していないと、Report Builderが余分なスペースを追加の行または列と解釈し、レポート出力が乱れる可能性があります。

•	ボイラープレート・オブジェクトをマトリックスの外側に作成すると、ボイラープレートの各インスタンスがマトリックスのすべての行（列ではなく）で繰り返されます。マトリックスに含まれるボイラープレートは、フィールド・オブジェクトがマトリックスの外側にあっても繰り返されないことに注意してください。

 ここをクリックしてください。


チャート・ハイパーリンク

HTML出力やPDF出力のチャートの値を、レポート出力内の繰返し枠のインスタンスや別のチャート、あるいは別のレポートに関連付けることができます。レポート出力で、ユーザーがチャートの値をクリックすると、その値に関する詳細にアクセスしたり、値に関連のある別のレポートをドリルダウンできるようになります。

チャート・ハイパーリンクを作成するには、Webウィザードの「チャート・ハイパーリンク」ページを使用するか、プロパティ・パレットで「チャート・ハイパーリンク」プロパティを設定します。


Reports Runtime Java Bean

  関連項目

Reports Runtime Java Beanを使用すると、ユーザーはJava対応のWebブラウザやその他のJavaアプレット・ビューアからレポートの実行と表示を行えるようになります。Reports Runtime Java Bean（Reports RJB）は、他のJava Beansと同じように、設計するユーザー・インタフェース（Javaアプレットや他のJavaアプリケーションなど）に埋め込むことや、再使用することができます。

Reports RJBを使用するには、ランタイム・ユーザーに次のパラメータを要求するユーザー・インタフェースを作成する必要があります。

1	レポート名（HTML、PDFなどの拡張子を含む）。

2	レポートが存在するReports Serverの名前。

3	Reports ServerのユーザーIDとパスワード。

4	レポートの宛先タイプ、宛先フォーマットおよび宛先名。

5	（HTTP接続の場合）レポートが置かれているReports ServerのURL。

ユーザーにこれらのパラメータを要求しない場合は、Javaアプレットやアプリケーションにデフォルトの値を指定します。

Reports RJBを使用してレポート出力を取り出すときは、レポート出力を表示するためのビューア（PDFファイル用のAcrobat Readerなど）を指定する必要があります。

注意

•	Reports RJBは、簡単なレポートの取出しに使用することができます。一度に取り出せるのは、1つのファイルのみであることに注意してください（たとえば、WebレポートのHTMファイルを取り出すときに、関連するGIFファイルは取り出されません）。

•	Reports RJBの属性の詳細は、ORACLE_HOME/REPORTS60/JAVAにあるBeanのJavadocを参照してください。

•	Java Beansの詳細は、市販のJavaプログラミング・マニュアルを参照するか、URL: http://java.sun.comにアクセスしてください。


レポートのセクション化

  関連項目

レポートのセクション化を使用すると、同じレポート内にそれぞれ異なる対象読者、出力書式、ページ・レイアウト、ページ･サイズまたは方向が設定された複数のレイアウトを定義できます。レポートにはセクションを3つまで定義でき、それぞれにボディとマージンの領域を設定できます。以前のリリースとの互換性を保つために、各セクションの名前はヘッダー、メイン、トレーラになっています。デフォルトでは、レポートはメイン・セクションに定義されます。他のセクションには、複数の個別のレポートを作成するよりも、むしろ異なるレイアウトを定義します。たとえば1つのレポートで、あるセクションには上級管理職向けのエグゼクティブ・サマリーを入れ、別のセクションには個々のマネージャ向けの詳細な内訳を入れることができます。

ヘッダー・セクションとトレーラ・セクションのマージンとボディを使用すると、以前のリリースと同じようにヘッダー・ページとトレーラ・ページを作成できます。今後のリリースでは、セクションの追加と削除が行えるようになります。

オブジェクト・ナビゲータでは、レポートの各セクションは「レイアウト・モデル」ノードの下に、「ヘッダー・セクション」、「メイン・セクション」、「トレーラ・セクション」として公開されます。


レポートの配布

  関連項目

レポートの配布を使用すると、レポートを1回実行するのみで、複数の出力書式を生成し、複数の宛先に配布できるレポートを設計できます。配布は、レポート全体に対して作成することも、レポートの個々のセクションに対して作成することもできます。

たとえば、レポートを1回実行するのみで、HTML出力を生成し、PostScript版をプリンタに送り、レポートの一部または全部のセクションを電子メールで配布リストに送信することができます。これまでのリリースでは、出力書式または宛先ごとにレポートを再実行する必要がありました。

レポートの配布は、次のどちらかの方法で指定します。

•	「配布」ダイアログ・ボックスを使用します。

•	コマンド・ラインから、.DSTファイルを指定するDESTINATIONキーワードを使用します。

注意: これらの方法で指定した配布を使用可能にするには、次の操作を行います。

•	「ファイル」 [image] 「配布」を選択します。

•	コマンド・ラインでDISTRIBUTE=YESを指定します。

実際にはレポートを配布せずにレポートの配布をチェックするには、どの配布リストが使用されたかを示すレポートの配布をトレースします。この情報を使用して、どのセクションがどの宛先に送られたかを調べることができます。


ディメンションのソート

  関連項目

Expressレポートのデータ・モデルでは、 [image] アイコンがソート列を表します。Express問合せで選択した各ディメンションに対して、Report Builderでは対応するソート列がレポートのデータ・モデルに自動的に挿入されます。ソート列には、対応するディメンション値へのExpress索引が含まれています。

たとえば、各製品部門について月ごとにグループ化された全世界の売上データを検索するExpress問合せを作成すると、Expressレポートは次のようになります。

時間ディメンションは、アルファベット順ではなく月によってソートされていることに注意してください。

Expressレポートのディメンション値は、SelectorのSortツールを使用してソートできます。ソート列は、データ・モデル表示とオブジェクト・ナビゲータから表示できます。ソート列は、データ・ウィザードとレポート・ウィザード、またはレイアウト・モデル表示とライブ・プレビューアからは表示できません。


パラメータ・フォームのHTML拡張

パラメータ・フォームのHTML拡張を使用すると、Webを介して実行されるレポートで、HTMLタグ付きのランタイム・パラメータ・フォームとJavaScriptを拡張できます。Webレポートのパラメータ・フォームを拡張するには、次の処理を行います。

•	HTMLタグ付きのボイラープレート・テキストを作成して、パラメータ・フォームにハイパーリンクやその他のHTMLタグ付きテキストを追加します。

•	JavaScriptでパラメータ・フィールドを挿入して、エンド･ユーザーが「パラメータ・フォーム」フィールドに無効なデータを入力したときに発生するエラーなどの、入力の定義やイベントの選択を行います。

パラメータ・フォーム・エディタには、オブジェクト・ナビゲータからアクセスするか、「ツール」 [image] 「パラメータ・フォーム作成」を選択してアクセスすることができます。


XML出力

Report Builderでは、レポートからXMLドキュメントを生成できます。XML出力は、サードパーティ・アプリケーションとのデータ交換（EDI -- Electronic Data Exchange）やWebパブリッシングの手段として使用できます。

レポートの構造化データを含むXMLファイルは、.RDFファイルから単純なプロセスで生成できます。コマンド・ラインでXMLの宛先フォーマットを指定するか、「ファイル」 [image] 「ファイル出力」 [image] 「XML」を選択します。

使用上の注意

•	データ・モデルは、レポートのXML出力の構造を決定します。XML出力は、ビジュアルなレイアウトには依存しません。

•	レポートのXML出力の構造は、データ・モデル・オブジェクトのプロパティ・パレットで使用可能なXMLプロパティを編集することによって変更できます。

•	Report Builderは、現在、XML出力の表示情報（カラー、フォント、物理レイアウトなど）をサポートしていません。prologで指定できるXSLを使用して、独自の表示情報を指定できます。詳細は、XML Prolog型とXML Prolog 値を参照してください。

•	コマンド・ラインから、引数DESFORMAT=XMLを使用してXML出力を生成できます。詳細は、DESFORMATを参照してください。

詳細なXMLマニュアルは、XML出力の生成とXMLプロパティを参照してください。


XMLを使用したランタイム・カスタマイズ

XMLタグで作成したレポート定義を実行し、それらの定義を他のレポート定義とマージできます。以前は、レポートを実行するには、Report Builderで作成して、.RDFファイル（または.REPファイル）として保存する必要がありました。現在は、XMLタグを使用してレポート定義を作成できます。XMLレポート定義は、単独で実行するか、実行時に.RDFファイルに適用して特定の読者用にレポートの出力をカスタマイズできます。この機能を使用して、RWCON60でレポートの変更をバッチで実行することもできます。この処理によって、Report Builderでそれぞれの変更を手動で行う必要がなくなります。

詳細は、『Publishing Reports』マニュアルを参照してください。


Oracle WebDBとの統合

Oracle WebDBを使用すると、Webを使用したレポートの発行をより便利で安全にします。システム管理者は、WebDBのウィザードを使用して、レポートへのユーザーのアクセスを制御します。アクセス制御によって、次のことが決定されます。

•	どのレポート、Reports Serverおよびプリンタにアクセスできるか

•	それらのレポート、サーバーおよびプリンタを使用して、要求をいつ処理できるか

•	それらのレポート、サーバーおよびプリンタに誰がアクセスできるか

レポートへのアクセス制御を確立するときは、レポートに関する情報（レポートの実行方法など）をパッケージ・プロシージャとして格納します。これによって、レポート要求を自分で構成する必要がなくなります。単純に、レポートのパッケージ・プロシージャをポイントするリンクを、WebDBサイト上にWebDBコンポーネントとして作成します。ユーザーがリンクをクリックすると、レポートが実行されます。Reports Serverでは、WebDBを使用して、要求元ユーザーが必要なすべてのリソースへのアクセス権を持っているかどうかが判断されます。アクセス権がある場合は、レポートが要求に応じて配布されます。

WebDBを使用すると、レポートを必要に応じて実行することや、レポートの自動実行をスケジュールして結果のレポートを送信先WebDBサイトにプッシュすることができます。

詳細は、『Publishing Reports』マニュアルを参照してください。


Reports Serverのクラスタ化

情報配布の需要が高まるにつれて、サーバーのクラスタ化は、パフォーマンスとロード・バランスを改善する簡単でコスト効率のよいソリューションになります。必要に応じてアプリケーション・サーバーをプラグ・インするのみで、組織の成長に応じてReports Serverの処理能力も成長します。

必要な作業は、あるReports Serverをマスターとして指定し、追加のReports Serverをスレーブとして構成することのみです。Master Serverは、要求を受信してSlave Serverにリダイレクトします。スレーブ・エンジンは要求を処理してマスターに送信し、マスターは要求に応じて出力を配布します。

詳細は、『Publishing Reports』マニュアルを参照してください。


Reports Serverのデータベース・キュー

ジョブが実行されるたびにReports Serverキューのアクティビティのスナップショットをとるように、データベースを設定できます。データベースに接続するには、Reports Server構成ファイルでREPOSITORYCONNパラメータを設定します。データベース内にキュー・アクティビティ表を作成するには、SQLスクリプトを実行します。

Reports Serverを起動すると、データベースへの接続が確立されます。デフォルトでは、Reports Serverは、サーバーが再起動したときにキュー情報を削除して、データベース表内のキュー情報を更新するために、APIをコールします。

詳細は、『Publishing Reports』マニュアルを参照してください。


フォント・マップについて

フォント（たとえば、フォント・タイプ、スタイル、サイズなど）は、あるマシン上で使用されていても、別のマシンでは使用不可能な場合があります。マシンによっては、ある特定のフォントがインストールされていなかったり、異なるオペレーティング・システムを使っている可能性があります。そこで、同一フォントの有無にかかわらず、別のマシン上で実行するレポートを作成している場合は、次の2つの方法のうちいずれかでこれを処理できます。

•	ターゲットGUI上に存在することがわかっているフォント、またはターゲットGUIのデフォルトのフォントに完全にマップするフォントを使用します。

•	レポートが実行されるマシンで使用可能なフォントにこのフォントをマップします（別名にします）。フォントは、uifont.aliファイルの内部でマップされます。


uifont.ali

  例

uifont.aliファイル内の各エントリの構文は、次のとおりです。

source_font = destination_font

各フォントには、次の属性を指定できます。

<face>.<size>.<style>.<weight>.<width>.<character_set>

値

<face>	フォントの名前（文字列または識別子）です。

<size>	ポイント単位でサイズを数値で指定します。

<style>	数値または事前定義済みの識別子（または事前定義済みの文字列）です。たとえば、plainおよび0は有効な値で、同じスタイルを表しています。

<weight>	数値または事前定義済みの識別子（または事前定義済みの文字列）です。たとえば、ultralightおよび1は有効な値で、同じフォントの太さを表しています。

<width>	数値または事前定義済みの識別子（または事前定義済みの文字列）です。たとえば、ultradenseおよび1は有効な値で、同じ幅を表しています。

<character_set>	数値または事前定義済みの識別子（または事前定義済みの文字列）です。たとえば、US7ASCIIおよび1は有効な値で、同じキャラクタ・セットを表しています。

使用上の注意

•	スタイルは、プラス記号（+）を使って結合できます。たとえば、次のように指定します。

Arial..Italic+Overstrike = Helvetica.12.Italic.Bold

•	マップでは、どの文字列にも大/小文字の区別がありません。プラットフォームおよびサーフィスによっては、参照時にフォントの大/小文字の区別がある場合があります。そのため、右辺で使用されている名前では大/小文字の区別に注意してください。しかし、マップされるときには、大/小文字の区別はありません。

•	円記号（\）は、継続文字として使用します。コメントは、次の方法で挿入できます。

/* コメント */

# コメント

; コメント

•	あるキャラクタ・セット（たとえばWE8ISO8859P1）を使ってレポートを開発し、実行時には別のキャラクタ・セット（EEC8EUROPA3）を使用する場合は、適切なエントリをフォント・エイリアシング・ファイル（uifont.ali）に作成し、キャラクタ・セット間でフォントをマップできるようになっていることを確認してください。たとえば、次のように指定します。

"Courier New".....EEC8EUROPA3 = "CourierNew".....WE8ISO8859P1

それ以外の場合、Report Builderはデフォルトのマップを使用します。このマップでは、レポートの要件が満たされないことがあります。

•	uifont.aliファイルが正しいかどうかをチェックするには、fontchkを使用します。このプログラムは、ファイルをチェックし、エラーがないことを確認します。フォント・マップ・ファイルを解析するには、次のように入力します。

fontchk filename

•	Report Builderは、環境変数TK2_FONTALIASによって指定された位置にあるフォント・マップ・ファイルを探します。TK2_FONTALIASが指定されていない場合、Report Builderはオペレーティング・システムのデフォルト位置を探します。


有効なスタイル

スタイル	数値

plain	0

italic	1

oblique	2

underline	4

outline	8

shadow	16

inverted	32

overstrike	64

blink	128


有効なフォントの太さ

フォントの太さ	数値

ultralight	1

extralight	2

light	3

demilight	4

medium	5

demibold	6

bold	7

extrabold	8

ultrabold	9

ultradense	1

extradense	2

dense	3

semidense	4

normal	5

semiexpand	6

expand	7

extraexpand	8

ultraexpand	9


有効な幅

幅	数値

Ultradense	1

Extradense	2

Dense	3

Semidense	4

Normal	5

Semiexpand	6

Expand	7

Extraexpand	8

Ultraexpand	9


フォント・マップ・ファイル例

  関連項目 	  すべての例

[ Global ]  # Put mappings for all surfaces here.

# Mapping from MS Windows
Arial             = helvetica
"Courier New"     = courier
"Times New Roman" = times
Modern            = helvetica
"MS Sans Serif"   = helvetica
"MS Serif"        = times
"Small Fonts"     = helvetica

# Mapping from Macintosh
"New Century Schlbk" = "new century schoolbook"
"New York"           = "times"

[ Printer ]  # Put mappings for all printers here.

[ Printer:PostScript1 ]  /* Put mappings for PostScript
                            level 1 printers here.*/

# Mapping from MS Windows
Roman             = palatino
Script            = "itc zapf chancery"
FixedSys          = courier
System            = helvetica

# Mapping from Macintosh
"Avant Garde"     = "itc avant garde gothic"

# Mapping from Motif display
fixed             = courier
clean             = times
lucidatypewriter  = courier
lucidabright      = times

# Sample Kanji font mappings
courier...Medium..JEUC   = \
   "Ryumin-Light-83pv-RKSJ-H"...Light..JEUC
courier...Bold..JEUC     = \
   "GothicBBB-Medium-83pv-RKSJ-H"...Medium..JEUC
courier...Medium..SJIS   = \
   "Ryumin-Light-83pv-RKSJ-H"...Light..JEUC
courier...Bold..SJIS     = \
   "GothicBBB-Medium-83pv-RKSJ-H"...Medium..JEUC
times...Medium..JEUC     = \
   "Ryumin-Light-83pv-RKSJ-H"...Light..JEUC
times...Bold..JEUC       = \
   "GothicBBB-Medium-83pv-RKSJ-H"...Medium..JEUC
times...Medium..SJIS     = \
   "Ryumin-Light-83pv-RKSJ-H"...Light..JEUC
times...Bold..SJIS       = \
   "GothicBBB-Medium-83pv-RKSJ-H"...Medium..JEUC
helvetica...Medium..JEUC = \
   "Ryumin-Light-83pv-RKSJ-H"...Light..JEUC
helvetica...Bold..JEUC   = \
   "GothicBBB-Medium-83pv-RKSJ-H"...Medium..JEUC
helvetica...Medium..SJIS = \
   "Ryumin-Light-83pv-RKSJ-H"...Light..JEUC
helvetica...Bold..SJIS   = \
   "GothicBBB-Medium-83pv-RKSJ-H"...Medium..JEUC

[ Printer:PostScript2 ]  /* Put mappings for PostScript
                            level 2 printers here.*/
# Mapping from MS Windows
Roman             = palatino
Script            = "itc zapf chancery"
FixedSys          = courier
System            = helvetica

# Mapping from Macintosh
"Avant Garde"     = "itc avant garde gothic"

# Mapping from Motif display
fixed             = courier
clean             = times
lucidatypewriter  = courier
lucidabright      = times

# Sample Kanji font mappings
courier...Medium..JEUC   = \
   "Ryumin-Light-83pv-RKSJ-H"...Light..JEUC
courier...Bold..JEUC     = \
   "GothicBBB-Medium-83pv-RKSJ-H"...Medium..JEUC
courier...Medium..SJIS   = \
   "Ryumin-Light-83pv-RKSJ-H"...Light..JEUC
courier...Bold..SJIS     = \
   "GothicBBB-Medium-83pv-RKSJ-H"...Medium..JEUC
times...Medium..JEUC     = \
   "Ryumin-Light-83pv-RKSJ-H"...Light..JEUC
times...Bold..JEUC       = \
   "GothicBBB-Medium-83pv-RKSJ-H"...Medium..JEUC
times...Medium..SJIS     = \
   "Ryumin-Light-83pv-RKSJ-H"...Light..JEUC
times...Bold..SJIS       = \
   "GothicBBB-Medium-83pv-RKSJ-H"...Medium..JEUC
helvetica...Medium..JEUC = \
   "Ryumin-Light-83pv-RKSJ-H"...Light..JEUC
helvetica...Bold..JEUC   = \
   "GothicBBB-Medium-83pv-RKSJ-H"...Medium..JEUC
helvetica...Medium..SJIS = \
   "Ryumin-Light-83pv-RKSJ-H"...Light..JEUC
helvetica...Bold..SJIS   = \
   "GothicBBB-Medium-83pv-RKSJ-H"...Medium..JEUC

[ Display ]  # Put mappings for all display surfaces here.

[ Display:Motif ]  # Put mappings for Motif displays here

# Mapping from MS Windows
Courier           = courier
Roman             = lucida
Script            = lucidabright
FixedSys          = fixed
System            = lucida

# Mapping from Macintosh
"Avant Garde"     = helvetica
"Bookman"         = times

[ Display:CM ]     # Put mappings for all CM displays here.
# These are DEC-specific, and may need localization
*..Blink          = Blinking
*..Inverted+Underline.Bold = ReverseBoldUnderline
*..Inverted+Underline.     = UnderlineReverse
*..Underline.Bold = UnderlineBold
*..Inverted.Bold  = ReverseBold
*...Bold          = Bold
*..Underline      = Underline
*..Inverted       = Reverse
*                 = Plain    # The font of last resort


REP-0001:  Report Builderのメッセージ・ファイルが見つかりません。インストール内容を確認してください。

原因:	エラー・メッセージ・ファイルをオープンできない、あるいはオープン中に内部エラーが発生しました。
処置:	Report Builderを再インストールするか、サポート担当に連絡して支援を受けてください。


REP-0002:  メッセージ・ファイルで文字列を検索できません。

原因:	必要なエラー・メッセージまたは文字列が、Report Builderで検索できませんでした。
処置:	サポート担当に連絡して支援を受けてください。


REP-0003:  警告: グローバル作業環境ファイルをオープンできません。

原因:	グローバル作業環境ファイルをオープンできませんでした。これは単なる警告なので、これが発生した場合でも製品は稼動します。このエラーの原因として、次のことが考えられます。
	ケース1:	指定された位置に、指定された名前のファイルを検索できません。
	ケース2:	ファイルをオープンするために必要な権限がありません。
	ケース3:	システム・エラーのために、ファイルをオープンできません。
処置:	このエラーの訂正には、次の処置を行ってください。
	ケース1の場合:	prefs.oraというファイルが、適切なディレクトリに格納されていることを確認してください。詳細は、インストレーション・マニュアルを参照してください。またはDBAに連絡してください。
	ケース2の場合:	ファイルにアクセスするために必要な権限があることを確認してください。必要な権限がない場合、適宜権限を変更してください。
	ケース3の場合:	使用しているオペレーティング・システムのマニュアルを参照するか、またはシステム管理者に連絡してください。


REP-0004:  警告: ユーザー作業環境ファイルをオープンできません。

原因:	ローカルな（カスタマイズされた）作業環境ファイルをオープンできませんでした。これは単なる警告なので、これが発生した場合でも製品は稼動します。このエラーの原因として、次のことが考えられます。
	ケース1:	指定された位置に、指定された名前のファイルを検索できません。
	ケース2:	ファイルをオープンするために必要な権限がありません。
	ケース3:	システム・エラーのために、ファイルをオープンできません。
処置:	このエラーの訂正には、次の処置を行ってください。
	ケース1の場合:	ファイルprefs.oraがホーム・ディレクトリ（使用しているシステムにホーム・ディレクトリのような概念がある場合）に存在することを確認してください。保存されていない場合、適宜ディレクトリまたはファイル名（あるいはその両方）を変更してください。
	ケース2の場合:	ファイルにアクセスするために必要な権限があることを確認してください。必要な権限がない場合、適宜権限を変更してください。
	ケース3の場合:	使用しているオペレーティング・システムのマニュアルを参照するか、またはシステム管理者に連絡してください。


REP-0005:  警告: グローバル作業環境ファイルの中に構文エラーが発生しました（行: <line number>）。

原因:	メッセージで示した行番号で、グローバル作業環境ファイルの1つ以上の作業環境が正しく指定されていませんでした。このエラーの原因はおそらく、ファイルが編集され、1つ以上の作業環境が正しく指定されていなかったことです。その結果、Report Builderは正しく指定されていなかった作業環境を無視します。
処置:	ユーザーまたはDBAが、グローバル作業環境ファイルを編集し、すべての作業環境が正しく指定されたことを確認してください。正しく指定されていなかった場合は、必要な更新を行ってください。


REP-0006: 警告: ユーザー作業環境ファイルの中に構文エラーが発生しました（行: <line number>）。

原因:	メッセージで示した行番号で、ユーザー作業環境ファイルの1つ以上の作業環境が正しく指定されていませんでした。このエラーの原因はおそらく、ファイルが編集され、1つ以上の作業環境が正しく指定されていなかったことです。その結果、Report Builderは正しく指定されていなかった作業環境を無視します。
処置:	ユーザー作業環境ファイルを編集し、すべての作業環境が正しく指定されていたかを確認してください。正しく指定されていなかった場合は、必要な更新を行ってください。


REP-0007: ユーザー作業環境ファイルに書き込めません。

原因:	作業環境を保存しようとしましたが、ユーザー作業環境ファイルに書き込めませんでした。このエラーの原因として、次のことが考えられます。
	ケース1:	ファイルに書き込むために必要な権限がありません。
	ケース2:	システム・エラーのために、ファイルに書き込めません。
処置:	このエラーの訂正には、次の処置を行ってください。
	ケース1の場合:	ファイルに書き込むために必要な権限があることを確認してください。必要な権限がない場合、適宜権限を変更してください。
	ケース2の場合:	使用しているオペレーティング・システムのマニュアルを参照するか、またはシステム管理者に連絡してください。


REP-0008: 作業環境の初期化中に予期しないメモリー・エラーが発生しました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-0058:  リモートのReports Serverへのデータ受渡しはサポートされていません。

原因:	リモートで実行されているレポートに、レコード・グループを渡すことを指定しました。
処置:	レコード・グループを渡そうとする場合、Reports Serverは指定できません。


REP-0059: サブコンポーネント: <component name>のリソースを見つけることができません。リソース・ファイルの場所を確認してください。
REP-0059:  サブコンポーネント: <component name>のリソースを見つけることができません。リソース・ファイルの場所を確認してください。リソース・ファイルの場所を確認してください。

原因:	Report Builderのサブコンポーネントの1つが、そのリソース・ファイルを見つけることができませんでした。このエラーの原因として、次のことが考えられます。
	ケース1:	リソース・ファイルが存在しません。
	ケース2:	リソース・ファイルが誤った場所にあります。
	ケース3:	環境が正しく構成されていません。
処置:	このエラーの訂正には、次の処置を行ってください。
	ケース1の場合:	リソース・ファイルが存在することを確認してください。
	ケース2の場合:	リソース・ファイルが適切なディレクトリに存在することを確認してください。
	ケース3の場合:	環境が正しく設定されていることを確認してください。UNIXの場合は、適切な環境変数が設定されていることを確認してください。MS Windowsの場合は、ファイル・システムのレジストリをチェックしてください。


REP-0060:  レポートを実行中に別のジョブは実行できません。

原因:	Forms Runtime実行プログラムを使ってレポートを開始しようとして、そのツールからデータを渡されることを要求していますが、1つ以上の他のレポートが実行されているか実行のためのキューに入っています。データを渡されることを要求するレポートは、ただちに実行する必要があります。
処置:	Reports Serverのキューに現在リストされている他のすべてのレポートが実行されるのを待ってから、レポートをもう1度実行します。


REP-0061: 内部エラー - rxmobfree: 参照カウントがゼロです。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-0062:  内部エラー - rxmobnew: サイズが一致しません。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-0063:  内部エラー - rxmobnew: メモリー・マネージャが一致しません。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-0064:  内部エラー - rxmobnew: タイプが一致しません。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-0065: 仮想メモリー・システム・エラーが発生しました。

原因:	Report Builderでメモリー・エラーが発生しました。
処置:	エラー発生コードを控え、サポート担当に連絡して下さい。詳細は、サポート担当への連絡を参照してください。


REP-0066:  CAユーティリティの実行中にエラーが発生しました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-0067:  STYPEキーワードの値は無効です。有効な値: DATABASE, REXFILE, RDFFILE, PLLDB, PLLFILE, PLDFILE

原因:	RWCON60で、STYPEキーワードの引数に有効でない値が指定されました。
処置:	キーワードの構文をチェックしてください。詳細は、「実行プログラム」を参照してください。）キーワードに有効な値を使って、コマンドを再入力してください。


REP-0068: DTYPEキーワードの値は無効です。有効なオプションは、DATABASEまたはREXFILEです。
REP-0068:  DTYPEキーワードの値は無効です。

原因:	RWCON60で、DTYPEキーワードの引数に有効でない値が指定されました。
処置:	キーワードの構文をチェックしてください。詳細は、「実行プログラム」を参照してください。（オンライン・ヘルプ・システムも確認できます。）キーワードに有効な値を使って、コマンドを再入力してください。


REP-0069:  内部エラー

原因:	Report Builderの内部コードエラーです。
処置:	サポート担当に連絡して支援を受けてください。


REP-0071:  SSLコンテキストを割当てできません。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-0072:  NNITインタフェースを初期化できません。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-0073:  不明な製品を実行しようとしました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-0074:  SSLの使用による別製品の実行に失敗しました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-0075:  コールされたコンポーネントを実行中にエラーが発生しました。

原因:	Forms RuntimeまたはGraphics Runtimeをコールした後、Report Builderにエラーが発生しました。この後に続くエラー・メッセージに、コールされたアプリケーションで発生したエラーが表示されます。
処置:	コールされたアプリケーションで発生したエラーを解決し、操作をやり直してください。


REP-0076:  製品統合中に内部エラーが発生しました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-0077:  問合せ: <query name>の列は、データの受渡しには長すぎます。

原因:	データを渡そうとした列はサイズが長すぎます（おそらくLONG列）。これはサポートされていません。
処置:	レポート定義およびコール元文書の定義から、列を削除してください。


REP-0078:  batch=noでシングル・プロセス統合が起動されました。

原因:	Report Builderが他の製品とリンクされている実行プログラムを使用し、batch=noを指定してReport Builderを起動しようとしました。これはサポートされていません。
処置:	複数のプロセスを使って統合する実行プログラムを使ってください。Report Builderをコールできるのは、batch=yesを指定しているときのみです。


REP-0079:  OVERWRITEキーワードの値は無効です。有効なオプションは、YES、NOまたはPROMPTです。

原因:	RWCON60で、OVERWRITEキーワードの引数に有効でない値が指定されました。
処置:	OVERWRITEキーワードにYES、NOまたはPROMPTの値を指定して、コマンドを再入力してください。


REP-0080:  YES、NOまたはCANCELを入力してください。

原因:	RWCON60で、コマンド・ラインにOVERWRITE=PROMPTと入力し、プロンプトに対してYESまたはNO以外の値を入力しました。
処置:	プロンプトに対してYESまたはNOの値を指定するか、CANCELで操作を取り消してください。


REP-0081: ファイルI/O操作の間にエラーが発生しました。
• REP-0081:  ファイルI/O操作の間にエラーが発生しました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-0082:  SCAユーティリティの実行中にエラーが発生しました。

原因:	このエラーの原因として、次のことが考えられます。
	ケース1:	初期化ファイルが現行のファイルではありません。
	ケース2:	異常な状態です。
処置:	このエラーの訂正には、次の処置を行ってください。
	ケース1の場合:	初期化ファイルが現行のファイルであるかどうかを確認してください。
	ケース2の場合:	詳細は、「異常な状態」を参照してください。


REP-0083:  DUNITキーワードの値は無効です。有効なオプションは、CENTIMETER、CHARACTER、INCHまたはPOINTです。

原因:	RWCON60で、キーワードDUNITに無効な値が入力されました。
処置:	キーワードの構文をチェックしてください。詳細は、「実行プログラム」を参照してください。キーワード（1つあるいは複数）に有効な値を使用して、コマンドを再入力してください。


REP-0084:  PAGESIZEキーワードの値は無効です。構文は[幅]×[高さ]です。

原因:	RWCON60で、キーワードPAGESIZEに無効な値が入力されました。
処置:	キーワードの構文をチェックしてください。詳細は、「実行プログラム」を参照してください。キーワードに有効な値と正しい構文を使用して、コマンドを再入力してください。


REP-0085:  FORMSIZEキーワードの値は無効です。構文は[幅]×[高さ]です。

原因:	RWCON60で、キーワードFORMSIZEに無効な値が入力されました。
処置:	キーワードの構文をチェックしてください。詳細は、「実行プログラム」を参照してください。キーワードに有効な値と正しい構文を使用して、コマンドを再入力してください。


REP-0086:  DUNITは、ソース・レポートのサイズの単位と異なっていなければなりません。

原因:	RWCON60で、変換しようとしているレポートと同じサイズ単位で、キーワードDUNITの値を入力しました。
処置:	キーワードの構文をチェックしてください。詳細は、「実行プログラム」を参照してください。キーワードに有効な値と正しい構文を使用して、コマンドを再入力してください。


REP-0087:  DESTYPEの値が無効です。SCREEN、FILE、PRINTER、MAIL、INTEROFFICE、SYSOUTまたはPREVIEWから選択してください。

原因:	RWRUN60で、キーワードDESTYPEに無効な値が入力されました。
処置:	キーワードの構文をチェックしてください。詳細は、「実行プログラム」を参照してください。キーワード（1つあるいは複数）に有効な値を使用して、コマンドを再入力してください。


REP-0088:  ONSUCCESSキーワードの値は無効です。有効なオプションは、COMMIT、ROLLBACKまたはNOACTIONです。

原因:	ONSUCCESSに無効な値が入力されました。
処置:	「作業環境」ダイアログの「ランタイム設定」タブまたはコマンド・ラインに、COMMITまたはROLLBACK、NOACTIONを指定してください（コマンド・ラインの構文をチェックするには、「実行プログラム」を参照してください）。


REP-0089:  ONFAILUREキーワードの値は無効です。有効なオプションは、COMMIT、ROLLBACKまたはNOACTIONです。

原因:	ONFAILUREに無効な値が入力されました。
処置:	「作業環境」ダイアログの「ランタイム設定」タブまたはコマンド・ラインに、COMMITまたはROLLBACK、NOACTIONを指定してください（コマンド・ラインの構文をチェックするには、「実行プログラム」を参照してください）。


REP-0090:  ACCESSキーワードの値は無効です。有効なオプションは、FILEおよびDATABASEです。

原因:	RWBLD60で入力したACCESSキーワードの値は無効です。
処置:	FILEまたはDATABASEを指定してください（コマンド・ラインの構文をチェックするには、「実行プログラム」を参照してください）。


REP-0091:  パラメータ: <parameter name>の値は無効です。

原因:	指定したパラメータに無効な値が入力されました。たとえば、RWRUN60コマンド文字列で、データ型がNUMBERのパラメータに文字値が入力されました。
処置:	パラメータに有効な値を指定して、操作をやり直してください。


REP-0092:  警告: バージョン1.1のLANGUAGE引数をサポートしていません。代わりにNLS_LANG環境変数を使用してください。

原因:	RWBLD60またはRWRUN60で、コマンド・ライン文字列にLANGUAGEキーワードを使用しました。
処置:	コマンド文字列からLANGUAGE引数文字列を削除し、ORACLE各国語環境変数値NLS_LANGを適切な値に設定してください。詳細は、「各国語サポート」を参照してください。


REP-0094:  DUNITがCharacterの場合、FORMSIZEは80×24でなければいけません。

原因:	DUNIT=Characterを指定してR30CONVを使用している場合、80×24と等しくないパラメータ･フォーム･サイズを指定しました。
処置:	キャラクタ・モードのパラメータ･フォーム･サイズは、80×24でなければいけません。DUNIT=Characterを指定した場合は、FORMSIZEに80×24を指定するか、あるいはFORMSIZEを指定しないでください。


REP-0095:  ORIENTATIONキーワードの値は無効です。有効なオプションは、DEFAULT、LANDSCAPEまたはPORTRAITです。

原因:	ORIENTATIONに無効な値が入力されました。
処置:	「作業環境」ダイアログの「ランタイム値」タブまたはコマンド・ラインに、DEFAULTまたはLANDSCAPE、PORTRAITを指定してください（コマンド・ラインの構文をチェックするには、「実行プログラム」を参照してください）。


REP-0096:  MODEキーワードの値は無効です。有効なオプションは、DEFAULT、BITMAPまたはCHARACTERです。

原因:	MODEに無効な値が入力されました。
処置:	「作業環境」ダイアログの「ランタイム値」タブまたはコマンド・ラインに、DEFAULTまたはBITMAP、CHARACTERを指定してください（コマンド・ラインの構文をチェックするには、「実行プログラム」を参照してください）。


REP-0097:  TRACEMODEキーワードの値は無効です。有効なオプションは、TRACE_APPENDまたはTRACE_REPLACEです。

原因:	TRACEMODEに無効な値を指定したか、または値を指定しませんでした。あるいはコマンド・ラインに標準とは異なる順序でキーワードを指定しましたが、命名しませんでした。
処置:	「ランタイム・トレース設定」ダイアログのトレース・モードに「追加」または「置換」を指定するか、コマンド・ラインにTRACE_APPENDまたはTRACE_REPLACEを指定してください。あるいはコマンドの構文をチェックしてください（コマンド・ラインの構文をチェックするには、「実行プログラム」を参照してください）。


REP-0098:  レポートは動作していません - パラメータ・フォームで取り消しました。

原因:	ランタイム・パラメータ･フォームで「レポート実行」のかわりに、「実行取消し」を選択したため、レポートは実行されませんでした。
処置:	処置は不要です。


REP-0099:  レポートは、ユーザーの要求により終了しました。

原因:	実行中のレポートを終了しました。
処置:	処置は不要です。


REP-0100:  ファイル: <filename>にファイル・ポインタを位置指定できません。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-0101:  ファイル: <filename>を読み込めません。

原因:	Report Builderがメッセージに表示されたファイルを読み込もうとしました。ファイルのオープンはできましたが、読み込めませんでした。
処置:	使用しているオペレーティング・システムのマニュアルを参照するか、またはシステム管理者に連絡してください。


REP-0102:  ファイル: <filename>に書き込めません。

原因:	Report Builderがメッセージに表示されたファイルに書き込もうとしましたが、できませんでした。このエラーの原因として、次のことが考えられます。
	ケース1:	ファイルに書き込むために必要な権限がありません。
	ケース2:	ファイルに書き込むために必要な空き領域が、ファイル・システムにありません。
	ケース3:	システム・エラーのために、ファイルをオープンできません。
処置:	このエラーの訂正には、次の処置を行ってください。
	ケース1の場合:	ファイルに書き込むために必要な権限があることを確認してください。必要な権限がない場合、適宜権限を変更してください。
	ケース2の場合:	不要なファイルを削除するか記憶領域を拡張して、空き領域を作ってください。
	ケース3の場合:	使用しているオペレーティング・システムのマニュアルを参照するか、またはシステム管理者に連絡してください。


REP-0103:  ファイル: <filename>をクローズできません。

原因:	Report Builderが表示されたファイルをクローズしようとしましたが、失敗しました。おそらく、システム・エラーのためにファイルをクローズできないことが原因です。
処置:	使用しているオペレーティング・システムのマニュアルを参照するか、またはシステム管理者に連絡してください。


REP-0104:  ファイル: <filename>を削除できません。

原因:	Report Builderが表示されたファイルを削除しようとしましたが、失敗しました。おそらく、システム・エラーのためにファイルを削除できないことが原因です。
処置:	使用しているオペレーティング・システムのマニュアルを参照するか、またはシステム管理者に連絡してください。


REP-0105:  ファイル: <filename>を専用モードでロックできません。

原因:	Report Builderが表示されたファイルをロックしようとしましたが、失敗しました。おそらく、システム・エラーのためにファイルをロックできないことが原因です。
処置:	使用しているオペレーティング・システムのマニュアルを参照するか、またはシステム管理者に連絡してください。


REP-0106:  ファイル: <filename>を共有モードでロックできません。

原因:	Report Builderが表示されたファイルをロックしようとしましたが、失敗しました。おそらく、システム・エラーのためにファイルをロックできないことが原因です。
処置:	使用しているオペレーティング・システムのマニュアルを参照するか、またはシステム管理者に連絡してください。


REP-0107:  無効な名前: <filename>を持つファイルをオープンしようとしました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-0108:  ファイル: <filename>が見つかりませんでした。

原因:	Report Builderが表示されたファイルにアクセスしようとしましたが、見つかりませんでした。
処置:	正しいファイル名を指定していることをチェックしてください。ファイル名の前にディレクトリを指定するか、あるいはファイルのあるディレクトリを含むように、REPORTS30_PATH環境変数を変更してください。


REP-0109:  オープンしているファイルが多すぎます。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-0110:  ファイル: <filename>がオープンできません。

原因:	Report Builderが表示されたファイルをオープンしようとしましたが、できませんでした。このエラーの原因として、次のことが考えられます。
	ケース1:	指定された位置に、指定された名前のファイルを検索できません。
	ケース2:	ファイルをオープンするために必要な権限がありません。
	ケース3:	システム・エラーのために、ファイルをオープンできません。
処置:	このエラーの訂正には、次の処置を行ってください。
	ケース1の場合:	ファイルが、指定した名前で指定したディレクトリに保存されていることを確認してください。保存されていない場合、適宜ディレクトリまたはファイル名（あるいはその両方）を変更してください。
	ケース2の場合:	ファイルをオープンするために必要な権限があることを確認してください。必要な権限がない場合、適宜権限を変更してください。
	ケース3の場合:	使用しているオペレーティング・システムのマニュアルを参照するか、またはシステム管理者に連絡してください。


REP-0111:  ディレクトリ: <directory path>は保護されています。

原因:	Report Builderに対して読込みまたは書込み権限のないディレクトリへの読込みまたは書込みを行うように指定しました。
処置:	読込みまたは書込みができるように、ディレクトリの権限を変更してください。


REP-0112: ファイル: <filename>は、書込み保護されています。
• REP-0112:  ファイル: <filename>は、書込み保護されています。

原因:	Report Builderに対して、書込み保護されているファイル、つまり書込み権限がないファイルに書込みを行うように指定しました。
処置:	書込みができるように、ファイルの権限を変更してください。


REP-0113:  ファイル: <filename>は、読込み保護されています。

原因:	Report Builderに対して、読込み保護されているファイル、つまり読込み権限がないファイルに読込みを行うように指定しました。
処置:	読込みができるように、ファイルの権限を変更してください。


REP-0114:  ファイル: <filename>は存在しません。

原因:	Report Builderに対して、すでに存在しないファイルにアクセスするように指定しました。
処置:	ファイルのコールを削除するか、ファイルを作成し直してください。あるいは異なるファイルを指定してください。


REP-0115:  ディレクトリ: <directory path>を読み込めません。

原因:	おそらく、Report Builderに対して、存在しないディレクトリへの読込みまたは書込みを行うように指定したことが原因です。
処置:	指定したディレクトリが存在することを確認してください。


REP-0116:  ディレクトリ: <directory path>に接続できません。

原因:	なんらかの理由で、Report Builderが指定されたディレクトリにアクセスできませんでした。
処置:	システム管理者に連絡してください。


REP-0117:  ホスト・オペレーティング・システムへのイグジットでエラーが発生しました。

原因:	プログラムを終了して、ホスト・オペレーティング・システムに制御を戻そうとしました。
処置:	処置は不要です。


REP-0118:  一時ファイルを作成できません。

原因:	Report Builderが一時ファイルを作成しようとしましたが、できませんでした。このエラーの原因として、次のことが考えられます。
	ケース1:	一時ファイルをどのディレクトリに作成するかを判断するための環境変数が、無効なディレクトリに設定されています。
	ケース2:	一時ファイルを作成するために必要なディスクの空き領域が不足しています。
	ケース3:	変更できない一時ファイルがすでに存在しています。
処置:	このエラーの訂正には、次の処置を行ってください。
	ケース1の場合:	一時ファイルの環境変数を、有効なディレクトリに設定してください。
	ケース2の場合:	ディスク上の領域を少し解放してください。
	ケース3の場合:	可能ならば、既存の一時ファイルを削除してください。


REP-0119:  リンク・ファイル・ボイラープレート: <boilerplate name>のソース・ファイル名: <filename>が見つかりません。

原因:	Report Builderが外部ボイラープレートに指定されたソース・ファイルを検索しようとしましたが、できませんでした。このエラーの原因として、次のことが考えられます。
	ケース1:	指定された位置に、指定された名前のファイルを検索できません。
	ケース2:	ファイルをオープンするために必要な権限がありません。
	ケース3:	システム・エラーのために、ファイルをオープンできません。
処置:	このエラーの訂正には、次の処置を行ってください。
	ケース1の場合:	ファイルが、指定した名前で指定したディレクトリに保存されていることを確認してください。保存されていない場合、適宜ディレクトリまたはファイル名（あるいはその両方）を変更してください。
	ケース2の場合:	ファイルをオープンするために必要な権限があることを確認してください。必要な権限がない場合、適宜権限を変更してください。
	ケース3の場合:	使用しているオペレーティング・システムのマニュアルを参照するか、またはシステム管理者に連絡してください。


REP-0120:  チャート: <chart name>の関連文書<filename>が見つかりません。

原因:	Report Builderがチャート・モジュールを検索できませんでした。このエラーの原因として、次のことが考えられます。
	ケース1:	指定された位置に、指定された名前のチャート・モジュールを検索できません。
	ケース2:	チャート・モジュールをオープンするために必要な権限がありません。
	ケース3:	システム・エラーのために、チャート・モジュールをオープンできません。
処置:	このエラーの訂正には、次の処置を行ってください。
	ケース1の場合:	チャート・モジュールが、指定した名前で指定したディレクトリに保存されていることを確認してください。保存されていない場合、適宜ディレクトリまたはファイル名（あるいはその両方）を変更してください。
	ケース2の場合:	チャート・モジュールをオープンするために必要な権限があることを確認してください。必要な権限がない場合、適宜権限を変更してください。
	ケース3の場合:	使用しているオペレーティング・システムのマニュアルを参照するか、またはシステム管理者に連絡してください。


REP-0124:  一時ファイルに書き込めません。

原因:	Report Builderが一時ファイルに書き込もうとしましたが、できませんでした。おそらく、一時ファイルへの書込みに必要な、ディスク上の空き領域の不足が原因です。
処置:	ディスク上の領域を少し解放してください。


REP-0125:  内部エラー: NLSキャラクタ・セットをロードできません。

原因:	ORA_NLSが設定されていないか、ORA_NLSが指定しているディレクトリが存在しません。
処置:	キャラクタ・セット・ファイルを含むNLSディレクトリを指定するように、ORA_NLSを設定してください。


REP-0150:  引数が多すぎます。

原因:	コマンドに入力した引数の数は、指定可能な数を超えています。
処置:	コマンドの構文をチェックしてください。詳細は、「実行プログラム」を参照してください。コマンドを正しく再入力してください。


REP-0151:  キーワード: <keyword>に対する引数が重複して指定されています。

原因:	表示したキーワードに対して、引数を複数回入力しました。このエラーの原因として、次のことが考えられます。
	ケース1:	キーワードに1つの位置引数を入力した後、このキーワードに別の引数を指定して入力しました。
	ケース2:	同じキーワードを2回入力しました（たとえば、KEYWORD1=YESとKEYWORD1=NO）。
処置:	コマンドの構文をチェックしてください。詳細は、「実行プログラム」を参照してください。このエラーの訂正には、次の処置を行ってください。
	ケース1の場合:	位置引数またはキーワード引数のどちらか1つのみを指定して、コマンドを再入力してください。
	ケース2の場合:	キーワードを1回のみ指定して、コマンドを再入力してください。


REP-0152:  キーワードの後に位置引数（Positional argument）が指定されました。

原因:	コマンド・ラインでキーワードと1つの引数を入力した後、キーワードを指定せずに別の引数を入力しました。コマンド・ラインでいったんキーワードを使用すると、後続の引数はすべて、同じようにキーワードを使用する必要があります。
処置:	キーワード付きの引数の後に位置引数（暗黙のキーワードを持つ引数）が指定されていないことを確認して、コマンドを再入力してください。


REP-0153:  キーワード: <keyword>は複数の値は使用できません。

原因:	コマンドで、表示したキーワード引数に指定可能な数以上の引数を入力しました。たとえば、KEYWORD=(A, B)と入力しても、KEYWORDは1つの値だけしか受け入れません。
処置:	コマンドの構文をチェックしてください。詳細は、「実行プログラム」を参照してください。余分な値（1つあるいは複数）を指定せずに、コマンドを再入力してください。


REP-0154:  コマンド・ファイルをオープンできません。

原因:	表示したコマンド・ファイルを参照するコマンドを入力しましたが、ファイルをオープンできませんでした。このエラーの原因として、次のことが考えられます。
	ケース1:	指定された位置に、指定された名前のファイルを検索できません。
	ケース2:	ファイルをオープンするために必要な権限がありません。
	ケース3:	システム・エラーのために、ファイルをオープンできません。
処置:	このエラーの訂正には、次の処置を行ってください。
	ケース1の場合:	ファイルが、指定した名前で指定したディレクトリに保存されていることを確認してください。保存されていない場合、適宜ディレクトリまたはファイル名（あるいはその両方）を変更するか、ファイルを指定のディレクトリに移動してください。
	ケース2の場合:	ファイルにアクセスするために必要な権限があることを確認してください。必要な権限がない場合、適宜権限を変更してください。
	ケース3の場合:	使用しているオペレーティング・システムのマニュアルを参照するか、またはシステム管理者に連絡してください。


REP-0155:  キーワード: <keyword>の値は無効です。

原因:	表示したキーワードに入力した値が、有効な値ではありませんでした。
処置:	キーワードの構文をチェックしてください。詳細は、「実行プログラム」を参照してください。キーワード（1つあるいは複数）に適切な値を指定してコマンドを再入力してください。


REP-0156:  DESTYPEの値が無効です。SCREEN、FILE、PRINTER、MAIL、INTEROFFICE、SYSOUTから選択してください。

原因:	RWRUN60で、DESTYPEパラメータの引数に有効でない値が指定されました。
処置:	キーワードの構文をチェックしてください。詳細は、「実行プログラム」を参照してください。キーワード（1つあるいは複数）に適切な値を指定してコマンドを再入力してください。


REP-0157:  <keyword>に対する値は、YESまたはNOでなければなりません。

原因:	表示したキーワードにYESまたはNO以外の値を入力しましたが、キーワードはYESまたはNOしか受け入れません。
処置:	表示したキーワードにYESまたはNOの値を使用して、コマンドを再入力してください。


REP-0158:  コマンド・ライン・キーワード: <keyword>が不明です。

原因:	キーワードとして参照される文字列を入力しましたが、そのようなキーワードはありません。
処置:	コマンドの構文をチェックしてください。詳細は、「実行プログラム」を参照してください。実行するタスクに適したキーワードを使用して、コマンドを再入力してください。


REP-0159:  コマンド・ラインで構文エラーがあります。

原因:	コマンド・ラインに入力した文字列を解析できませんでした。ほとんどの場合、引用符またはカッコを入力したときに、対応する側の引用符またはカッコを入力していないことが原因です。
処置:	コマンドの構文をチェックしてください。詳細は、「実行プログラム」を参照してください。適切な構文を使用して、コマンドを再入力してください。


REP-0160:  コマンド・ファイルで構文エラーがあります。

原因:	コマンド・ファイルに入力したものを解析できませんでした。ほとんどの場合、引用符またはカッコを入力したときに、対応する側の引用符またはカッコを入力していないことが原因です。
処置:	コマンドの構文をチェックしてください。詳細は、「実行プログラム」を参照してください。コマンド（1つあるいは複数）を修正するために、必要に応じて、ファイルを編集しコマンドを変更してください。


REP-0161:  コマンド・ラインで引数が指定されていません。

原因:	コマンド・ライン引数を指定せずに、RWCON60を起動しました。
処置:	RWCON60に対して、適切なコマンド・ライン引数（たとえば、SOURCE、DESTなど）を指定してください。詳細は、「実行プログラム」を参照してください。


REP-0162:  キーワードSHOWWINDOWに対する値が無効です。有効なオプションは、DEFAULT、WIZARDおよびPREVIEWERです。

原因:	キーワードSHOWWINDOWを使用しましたが、SHOWWINDOWに対して無効な値を指定しました。
処置:	コマンドの構文をチェックしてください。詳細は、「実行プログラム」を参照してください。適切な構文を使用して、コマンドを再入力してください。


REP-0163:  DESTYPEの値が無効です。FILE、PRINTER、MAIL、INTEROFFICE、CACHEから選択してください。

原因:	Reports Serverに対して、DESTYPEパラメータの引数に有効でない値が指定されました。
処置:	コマンドの構文をチェックしてください。詳細は、「実行プログラム」を参照してください。適切な構文を使用して、コマンドを再入力してください。


REP-0164:  PARAMFORMキーワードの値は無効です。有効なオプションは、YES、NOまたはHTML[action]です。

原因:	PARAMFORMパラメータに無効な値を指定して、Reports Runtimeを（スタンドアロンで、またはReports Serverとして）起動しました。
処置:	コマンドの構文をチェックしてください。詳細は、「実行プログラム」を参照してください。適切な構文を使用して、コマンドを再入力してください。


REP-0165:  必須キーワードSITENAMEの値が指定されていません。WEBDBサイト名を指定してください。

原因:	SITENAMEキーワードの値が指定されていません。レポートをスケジュールするには、SITENAMEに値が必要です。
処置:	キーワードSITENAMEに、WEBDBサイト名を指定してください。


REP-0171: リモート・サーバーから結果を抽出できません。
• REP-0171:  リモート・サーバーから結果を抽出できません。

原因:	リモート・サーバーから出力を取り出すときにエラーが発生しました。
処置:	アクセスできないローカル・ファイルを設定した可能性があります。または、リモート・サーバーが出力禁止に設定されています。


REP-0172:  キーワードSERVERの値が無効です。

原因:	必須のキーワードSERVERに有効な引数を指定しませんでした。
処置:	キーワードSERVERに有効な引数を指定し、コマンドを再実行してください。


REP-0173:  キーワードSHOWJOBSに対する値が無効です。有効なオプションは、PAST、CURRENTまたはFUTUREです。

原因:	Report Queue Managerで、コマンド・ラインに指定されたSHOWJOBSキーワードの引数が無効です。
処置:	SHOWJOBSキーワードに、PAST、CURRENTまたはFUTUREの値を指定して、コマンドを再入力してください。


REP-0174:  Reports Serverのキュー情報を取得中に内部エラーが発生しました。

原因:	Reports Serverが、そのキューについて有効な情報をキュー・マネージャに戻しませんでした。このエラーの原因として、次のことが考えられます。
	ケース1:	Reports Serverへの接続が、突然切断しました。
	ケース2:	Reports Serverが不安定な状態にあるか、シャットダウンされました。
処置:	接続しているReports Serverが稼動していることを確認してください。Reports Server管理者に連絡して、稼動を確認した後コマンドを実行してください。引き続き問題が発生する場合は、異常な状態です。詳細は、「異常な状態」を参照してください。


REP-0175:  Reports Serverのプロパティ情報を取得中に内部エラーが発生しました。

原因:	Reports Serverが、そのプロパティについて有効な情報をキュー・マネージャに戻しませんでした。このエラーの原因として、次のことが考えられます。
	ケース1:	Reports Serverへの接続が、突然切断しました。
	ケース2:	Reports Serverが不安定な状態にあるか、シャットダウンされました。
処置:	接続しているReports Serverが稼動していることを確認してください。Reports Server管理者に連絡して、稼動を確認した後コマンドを実行してください。この問題が継続して発生する場合、異常な状態です。詳細は、「異常な状態」を参照してください。


REP-0176:  サーバー: <server>はシャットダウンされています。

原因:	指定されたReports Serverがシャットダウンされているために、レポートを送ることができません。
処置:	他のReports Serverに送るか、Serverが稼動し始めるまで待ってください。


REP-0177:  リモート・サーバーで実行中にエラーが発生しました。

原因:	リモート・サーバーで指定されたコマンド・ラインを実行できません。
処置:	コマンド・ラインをチェックしてください。


REP-0178:  Reports Server: <server>に接続できません。

原因:	指定されたReports Serverに適切な接続を確立できません。
処置:	ネットワークと、問題となっているReports Serverのステータスをチェックしてください。


REP-0179: 実行中にレポートの実行が突然終了しました。

原因:	実行中に、Reports Serverエンジンが破壊されました。
処置:	システム管理者に連絡してください。


REP-0180:  レポートは、Reports Serverから取消されました。

原因:	レポートを、実行中に停止したか、開始する前にキューから削除しました。
処置:	処置は不要です。


REP-0181:  Reports Serverの設定ファイルを読込み/書込み中にエラーが発生しました。

原因:	構成ファイルをオープンできないか、その内容が理解できません。
処置:	構成ファイルとそのアクセス権をチェックして、Reports Serverを再起動してください。


REP-0182:  Reports Serverのコマンド・ラインで構文エラーが発生しました。

原因:	コマンド・ラインに入力した文字列を解析できませんでした。ほとんどの場合、引用符またはカッコを入力したときに、対応する側の引用符またはカッコを入力していないことが原因です。
処置:	コマンドの構文をチェックしてください。適切な構文を使用して、コマンドを再入力してください。


REP-0183:  Reports Serverを起動するには、TNSNAMEを指定しなければなりません。

原因:	サーバーがリスニングする必要があるTNSNAMEを指定せずに、Reports Serverを起動しようとしました。
処置:	コマンド・ライン引数としてTNSNAMEを指定してください。


REP-0184: 指定されたMAXCONNECTSは、範囲外です。

原因:	指定されたMAXCONNECTS値が、このプラットフォームの範囲を超えています。MAXCONNECTSは、少なくとも2以上で、4096を超えることはできません。プラットフォームによってはこの制限がもっと低いこともあります。
処置:	適切な値を指定してください。


REP-0185:  Reports Serverの起動時に間違ったロード引数が指定されました。

原因:	MAXCONNECTS、MINLOAD、MAXLOADおよびINITLOADに矛盾する値を指定しました。
処置:	0 <= MINLOAD <= INITLOAD <= MAXLOAD < MAXCONNECTSであることを確認してください。


REP-0186:  デーモンはポートのリスニングに失敗しました。

原因:	すでにポートをリスニングしている別のデーモンを、実行している可能性があります。
処置:	処置は不要です。すでにデーモンを実行しているので、実行されるレポートを送ることができます。


REP-0187:  デーモンはエンジンの起動に失敗しました。

原因:	デーモンがエンジン実行プログラムを起動できず、通信できません。おそらく、インストールの問題です。
処置:	インストールが適切に行われたことを確認してください。


REP-0188:  Reports Serverはバッチ・ジョブしか受け付けられません。

原因:	batch=no、destype=screen、destype=previewまたはdestype=sysoutのいずれかが指定されているReports Serverに対してジョブを送りました。
処置:	これらの設定は使用できません。適宜コマンド・ラインを変更してください。


REP-0189:  Reports Serverのキャッシュに書き込めません。

原因:	Reports Serverがキャッシュ・ディレクトリへの書込みに失敗しました。
処置:	構成ファイルにキャッシュ・ディレクトリが指定されていることと、それが書込み可能であることを確認してください。


REP-0190:  バックグラウンドでは画面上で実行できません。

原因:	レポートをバックグラウンドで実行するように指定しましたが、DESTYPEの値がScreenとして指定されています。出力を画面に送っている間は、レポートをバックグラウンドで実行できません。
処置:	出力先を画面にする場合は、レポートをフォアグラウンドで実行する必要があります。レポートをバックグラウンドで実行する場合は、DESTYPEに他の値を指定してください。


REP-0194:  この実行モジュールでは、ビットマップ・モードでキャラクタ・レポートを実行できません。

原因:	キャラクタ・モードの実行プログラムを使用してMODEをBITMAPに設定してキャラクタ・モードのレポートを実行しようとしました。この処理は、許可されていません。
処置:	実行プログラムのモードに一致するように、MODEキーワードの値を変更してください。またはビットマップ対応の実行プログラムを使用してレポートを実行してください。


REP-0195:  この実行モジュールでは、ビットマップ・モードで、画面へのレポートの実行ができません。

原因:	キャラクタ・モードの実行プログラムを使用してビットマップ・レポートをっ画面上に実行しようとしました。この処理は、許可されていません。
処置:	BATCH=YESを使用してレポートを実行するか、またはビットマップ対応の実行プログラムを使用してください。


REP-0196:  バックグラウンドではレポートを実行できません。

原因:	BACKGROUNDにYESを指定しましたが、次の条件では実行することはできません。
	ケース1:	デザイナからレポートを実行しています。
	ケース2:	BATCHをYESに設定しています。
	ケース3:	パッケージ・プロシージャsrw.run_reportを使用してレポートを実行しています。
	ケース4:	レポートを実行しているプラットフォームは、他のプロセスの生成物をサポートしていません。
処置:	前述の条件の1つでもあてはまる場合、BACKGROUNDがNOに設定されていることを確認してください。


REP-0197:  ビットマップ・レポートを実行する場合は、コマンド・ラインでBATCH=YESまたはBACKGROUND=YESを指定してください。

原因:	フォアグラウンドでキャラクタ・モードの実行プログラムを使用して、ビットマップ・レポートを実行しようとしました。これはサポートされていません。
処置:	キャラクタ・モードの実行プログラムを使用してビットマップ・レポートを実行する場合、BATCH=YESまたはBACKGROUND=YES （BATCH=YESと異なり、この設定はランタイム・パラメータ・フォームへアクセスします）のどちらかを選択する必要があります。


REP-0200:  必要なメモリーを割り当られません。

原因:	Report Builderが現行の作業を完了するために十分なメモリーを、システムから取得できません。
処置:	可能であれば、使用可能なメモリーを増やしてください。または、システム管理者に連絡してください。


REP-0201:  ブロック・サイズにゼロまたは負の値が要求されました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-0202: NULLポインタの解放を試みました。
• REP-0202:  NULLポインタの解放を試みました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-0203:  NULLポインタがハンドルとして渡されました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-0204:  ハンドルは、mpブロックの中を示していません。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-0205:  1つのオブジェクトでの同時ロックが多すぎます。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-0206:  NULLキャッシュ・ポインタが仮想メモリー・ルーチンに渡されました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-0207:  要求されたブロックの大きさは仮想メモリー領域を超えています。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-0208:  rmalocにファンクション識別子が与えられていませんでした。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-0209:  rmalocには、構造体識別子が与えられていませんでした。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-0210:  ロックしたハンドル上で要求された操作が正しくありません。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-0211:  解放後にハンドルを使用しようとしました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-0212:  リテラルが指定されていません。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-0213:  ハンドル・ロックしようとしましたが失敗しました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-0214:  仮想メモリー・バッファ（サイズ: <number > KB）を割り当てられませんでした。サイズを小さくして再試行してください。

原因:	Report BuilderがキーワードBUFFERSに指定された値（ユーザーまたはデフォルトによる）で仮想メモリー・バッファのサイズを割り当てられませんでした。
処置:	BUFFERSのサイズを小さくするか（「環境設定」ダイアログの「ランタイム設定」タブまたはコマンド・ラインで）、さらにメモリーを解放してください。（コマンド・ラインの構文をチェックするには、「実行プログラム」を参照してください。）


REP-0215:  メモリー・ハンドルをロック、逆参照、または解放中にエラーが発生しました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-0230:  スレッドを起動中にエラーが発生しました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-0231:  スレッド・メッセージを転記中にエラーが発生しました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-0232:  スレッド・メッセージを取得中にエラーが発生しました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-0235:  Security ServerのTNSNAMEが構成ファイルに指定されていません。

原因:	セキュリティ・モードでは、Reports Server構成ファイルでSecurity Server TNSNAMEを指定する必要があります。
処置:	Reports Server構成ファイルのSECURITYTNSNAMEパラメータで、Security Server TNSNAMEを指定してください。


REP-0236:  Security Server に接続できません。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-0237:  Security Serverの認証に成功しました。

原因:	認証に成功しました。
処置:	なし。


REP-0238:  Security Serverの認証に失敗しました。

原因:	システム・ユーザーID/パスワードが無効であるか、またはレポートの実行に必要な権限がありません。
処置:	システム・ユーザーID/パスワードをチェックし、それらが正しいことを確認するか、または必要な権限の付与をシステム管理者に要求してください。


REP-0239:  Security Serverの認証に失敗しました: ユーザー名が無効です。
REP-0239:  Security Serverの認証に失敗しました: ユーザ名が無効です。

原因:	システム・ユーザーIDが正しくありません。
処置:	システム・ユーザーIDをチェックし、それが正しいことを確認するか、またはシステム・ユーザーIDについてシステム管理者に問い合せてください。


REP-0240:  Security Serverの認証に失敗しました: パスワードが無効です。

原因:	システム・ユーザーIDのパスワードが正しくありません。
処置:	システム・ユーザーIDのパスワードをチェックし、それが正しいことを確認するか、またはシステム・ユーザーIDのパスワードについてシステム管理者に問い合せてください。


REP-0241:  Security Serverの認証に失敗しました: Reports Serverに対する権限がありません。

原因:	システム・ユーザーIDに、Reports Serverへのアクセスに必要な権限がありません。
処置:	Reports Serverに対するシステム・ユーザーIDの権限について、システム管理者に問い合せてください。


REP-0242:  Security Serverの認証に失敗しました: プリンタに対する権限がありません。

原因:	システム・ユーザーIDに、プリンタへのアクセス権限がありません。
処置:	プリンタに対するシステム・ユーザーIDの権限について、システム管理者に問い合せてください。


REP-0243:  Security Serverの認証に失敗しました: モジュールに対する権限がありません。

原因:	システム・ユーザーIDに、モジュールへのアクセス権限がありません。
処置:	モジュールに対するシステム・ユーザーIDの権限について、システム管理者に問い合せてください。


REP-0244:  Security Serverの認証に失敗しました: このアクセス・タイプの権限がありません。

原因:	システム・ユーザーIDに、このアクセス・タイプの権限がありません。
処置:	このアクセス・タイプのシステム・ユーザーIDの権限について、システム管理者に問い合せてください。


REP-0245:  Security Serverの認証に失敗しました: この出力タイプの権限がありません。

原因:	システム・ユーザーIDに、この出力タイプの権限がありません。
処置:	この出力タイプのシステム・ユーザーIDの権限について、システム管理者に問い合せてください。


REP-0246:  Security Serverの認証に失敗しました: 指定された時間における権限がありません。

原因:	システム・ユーザーIDに、指定された時間における権限がありません。
処置:	指定された時間に対するシステム・ユーザーIDの権限について、システム管理者に問い合せてください。


REP-0247:  Security Serverの認証に失敗しました: 指定された日付における権限がありません。

原因:	システム・ユーザーIDに、指定された日付における権限がありません。
処置:	指定された日付に対するシステム・ユーザーIDの権限について、システム管理者に問い合せてください。


REP-0250:  記号表がオーバーフローしました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-0251:  識別子が、定義された記号と一致しません。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-0252:  警告: 環境変数: <environment variable name>で指定されているパスは長すぎるので、無視されます。

原因:	環境変数で指示されたパスが長すぎます。
処置:	指示したパスの長さを短くしてください。


REP-0253:  警告: 検索パスの合計長は長すぎるので、切り捨てられます。

原因:	パス環境の検索パスを結合した長さが長すぎます。結合した長さは255文字を超えることはできません。
処置:	パス環境の1つ以上のパスの長さを短くしてください。


REP-0300:  Oracleエラーが発生しました。

原因:	Report BuilderでOracleエラーが発生しました。
処置:	エラー・メッセージをスクロールしてエラーが起きた箇所を表示し、可能ならば修正してください。あるいは、DBAに連絡してください。


REP-0301:  SELECT文にINTO句がない可能性があります。

原因:	SELECT文にINTO句を入力しましたが、Report Builderでは使用できません。
処置:	INTO句を削除してください。


REP-0302: パラメータ: <parameter name>がレポートの中に見つかりません。
• REP-0302:  パラメータ: <parameter name>がレポートの中に見つかりません。

原因:	レポートの中で定義されていないパラメータを参照しました。ほとんどの場合、パラメータを削除したときに、そのパラメータへの参照をすべて削除しなかったことが原因です。
処置:	削除したパラメータへの参照をすべて削除してください。


REP-0303:  入力された文は、SELECT文ではありません。

原因:	SELECT文以外のものが「SELECT文」フィールドに入力されました。このエラーの原因として、次のことが考えられます。
	ケース1:	「SELECT文」フィールドにSELECT文と異なるものを入力しました。
	ケース2:	SELECT文を含んでいない外部問合せを参照しました。
処置:	このエラーの訂正には、次の処置を行ってください。
	ケース1の場合:	有効なSELECT文を入力してください。
	ケース2の場合:	外部問合せを変更するか、他の外部問合せを参照してください。


REP-0304:  SELECT文中の'&'の後に、有効な文字パラメータがありません。

原因:	SELECT文にアンパサンド（&）が単独で入力されました。このエラーの原因として、次のことが考えられます。
	ケース1:	字句参照を行おうとしましたが、列またはパラメータの名前を省きました。あるいは不注意で、アンパサンドと列またはパラメータの名前との間に空白を入力しました。
	ケース2:	SELECT文を入力するときに、誤ってアンパサンドを入力しました。
処置:	このエラーの訂正には、次の処置を行ってください。
	ケース1の場合:	アンパサンドのすぐ後に、空白を含まず、列またはパラメータの名前が続くことを確認してください。
	ケース2の場合:	アンパサンドを削除してください。


REP-0305:  <lexical reference>は、 CHAR型のデータでないため、文字パラメータは使用できません。

原因:	SELECT文に無効な参照字句が入力されました。字句参照ができるのは、文字データを含むパラメータまたは列のみです。このエラーの原因として、次のことが考えられます。
	ケース1:	誤った列またはパラメータを参照しました。
	ケース2:	字句参照ではなく、バインド参照になっています。
	ケース3:	文字以外のデータ型で参照されるパラメータまたは列を作成しました。
処置:	このエラーの訂正には、次の処置を行ってください。
	ケース1の場合:	データ型がキャラクタのパラメータまたは列を参照するように、アンパサンド（&）に続く名前を変更してください。
	ケース2の場合:	パラメータまたは列を参照するときは、アンパサンド（&）をコロン（:）に置き換えてください。
	ケース3の場合:	必要ならば、パラメータまたは列のデータ型をキャラクタに変更してください。


REP-0306:  <name>は、有効なパラメータ名ではありません。

原因:	参照パラメータを作成するときに、無効な名前でパラメータを作成しようとしました。バインド参照を使用するときは、バインド・パラメータに指定された名前を使用して自動的にパラメータ定義が作成されます。この場合、指定された名前が有効でなかったために、Report Builderはパラメータを作成できませんでした。
処置:	データ・モデル・オブジェクトの命名規則とパラメータ名の規則をチェックしてください。命名規則の詳細は、「命名規則」を参照してください。パラメータを改名し、バインド参照中の名前を変更してください。


REP-0307:  SELECT文にFOR UPDATE句がない可能性があります。

原因:	SELECT文にFOR UPDATE句が入力されましたが、Report Builderでは使用できません。
処置:	FOR UPDATE句を削除してください。


REP-0308:  内部エラー - 列タイプは不明です。

原因:	このエラーの原因として、次のことが考えられます。
	ケース1:	SRW.MESSAGEを使用して列の値を表示しようとしましたが、この列のデータ型（たとえば、LONG、LONG RAW、ROWID）はサポートされていません。
	ケース2:	フォームまたはチャート・ランタイム実行プログラムに、パラメータとして列の値を渡そうとしましたが、この列のデータ型（たとえば、LONG、LONG RAW、ROWID）はサポートされていません。
処置:	この列の値は表示または受け渡しできません。


REP-0309:  3回試みましたが指定されたデータベースに接続できませんでした。アクセスは拒否されました。

原因:	入力されたログイン文字列の一部が正しくありませんでした。3回失敗後、Report Builderによって、ダイアログ・ボックスとともにこのメッセージが表示されます。このダイアログ・ボックスの唯一のオプションは、それを適用することです。適用すると、Report Builderは終了し、オペレーティング・システムに戻ります。
処置:	ダイアログ・ボックスを適用してください。必要ならば、DBAにログイン情報を確認してください。Report Builderに戻り、Oracleへ再度接続してみてください。引き続き問題が発生する場合、DBAから新しいOracleログインを取得してください。


REP-0310:  問合せのバインド変数の処理中にエラーが発生しました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-0311:  内部エラー - セグメント化されたメモリーが文字パラメータに使用されました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-0312:  内部エラー - セグメント化されたメモリーの処理中にエラーが発生しました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-0313:  内部エラー - データ・レコードを取り出すと、メモリーのオーバーフローを引き起こす可能性があります。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-0314:  列名が256文字を超えているので記述できません。<column name>...には別名を使用してください。

原因:	SQL SELECT文の1つに256文字を超える式が含まれていますが、別名がありません。
処置:	SELECT文を編集して式に別名を割り当ててください。


REP-0315:  複合問合せでは、各SELECT文の列数が同じでなければなりません。

原因:	UNION、INTERSECTまたはMINUS集合演算子付きの問合せが入力されましたが、問合せのSELECT文に選択された列数が同じではありません。
処置:	列数が同じになるようにSELECT文を変更してください。


REP-0316:  複合問合せでは、対応する列のデータ型は一致していなければなりません。

原因:	UNION、INTERSECTまたはMINUS集合演算子付きの問合せが入力されましたが、対応する列の型が異なっています。たとえば、列1のデータ型を見ると、1番目のSELECT文ではCHARであるのに、2番目のSELECT文ではNUMBERとなっています。
処置:	対応する列がすべて同じデータ型になるようにSELECT文を変更してください。


REP-0320:  データベースに接続できませんでした。

原因:	データベースに接続しようとしましたが、失敗しました。
処置:	ユーザーIDとパスワードを再チェックし、もう一度操作をやり直してください。


REP-0321:  内部エラー - 問合せの記述に失敗しました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-0322:  内部エラー - フェッチした行を返すことができませんでした。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-0330:  内部エラー - GET_REFパラメータを配置できませんでした。

原因:	問合せのCDE_MM.GET_REFコールに対してパラメータ・リストを指定しませんでした。
処置:	問合せのSELECT文のコールにパラメータ・リストを追加してください。


REP-0331:  PL/SQLファンクション: GET_REFには、パラメータが3つ必要です。

原因:	問合せのCDE_MM.GET_REFコールのパラメータ・リストが未完成でした。
処置:	問合せのSELECT文のコールに必要なパラメータを追加してください。


REP-0332:  PL/SQLファンクション: GET_REFの3つめのパラメータはROWID型でなければなりません。

原因:	GET_REFファンクションの最後のパラメータとしてROWID型のパラメータを指定しませんでした。
処置:	パラメータ・リストをチェックして、最後のパラメータがROWID型であることを確認してください。


REP-0340:  ロールのパスワードを確認できません。レポートはオープンされません。

原因:	正しいロール・パスワードを入力しませんでした。
処置:	ロール・パスワードが正しいことを確認してください。レポートのオープンを再試行し、正しいロール・パスワードを入力してください。


REP-0341:  レポートで指定されているロールを設定できません。レポートはオープンされません。

原因:	レポートをオープンする際、レポートで指定されたロールを作成できません。
処置:	ロールが付与されていること、およびロール・パスワードが正しいことを確認してください。レポートのオープンを再試行し、正しいロール・パスワードを入力してください。


REP-00342:  警告:  コマンド・ラインで指定したロールを設定できません。
REP-0342:  警告: コマンド・ラインで指定したロールを設定できません。

原因:	コマンド・ラインで指定したロールを作成できません。
処置:	ロールが付与されていること、およびロール・パスワードが正しいことを確認してください。


REP-0343:  警告: 現行ユーザーのデフォルト・ロールを設定できません。

原因:	Report Builderでは、パスワードを持つ現行ユーザーのデフォルト・ロールを設定できません。
処置:	パスワードのあるデフォルト・ロールを使用しないでください。


REP-344: ロールのパスワードが確認できませんでした。確認パスワードがロールのパスワードと合致しているかを確認してください。
REP-0344:  ロールのパスワードが確認できませんでした。確認パスワードがロールのパスワードと合致しているかを確認してください。

原因:	「パスワードの確認」フィールドに入力されたパスワードが、ロール・パスワードと異なります。
処置:	「パスワードの確認」に再入力を行い、パスワードがロール・パスワードと完全に一致していることを確認してください。


REP-345:  ロールの指定なしでパスワードは指定できません。
REP-0345:  ロールの指定なしでパスワードは指定できません。

原因:	ロール・パスワードが指定されましたが、ロールが指定されていません。
処置:	ロールを指定してからパスワードを指定するか、このレポートにロールを関連付けない場合はすべてのフィールドを空のままにしてください。


REP-0346:  ロール名は、<number>文字以下でなければ切り捨てられます。

原因:	使用できる以上の長さのロール名が指定されました。切り捨てられます。
処置:	より短いロール名を指定してください。


REP-0347:  ロールのパスワードは、<number>文字以下でなければ切り捨てられます。

原因:	使用できる以上の長さのロール・パスワードが指定されました。切り捨てられます。
処置:	より短いロール・パスワードを指定してください。


REP-0348:  ロールのパスワードが正しくありません

原因:	正しくないロール・パスワードが入力されました。
処置:	ロール・パスワードを正しく再入力してください。


REP-0450:  <PL/SQL error>。

計算式列、プレース・ホルダ列またはパラメータなどの関連付けられたPL/SQLコードを持つオブジェクトを編集すると、このエラーが発生する場合があります。Report Builderのオブジェクトに対する変更は、関連付けられたPL/SQLコードに対しても行う必要があります。

原因:	レポートを実行中に、Report Builderでこのエラーが発生しました。
処置:	このエラーが発生しないようにするためには、レポートのPL/SQLを編集し、再コンパイルしてください。
原因:	サイズがデータ型で宣言されませんでした。
処置:	各データ型のサイズを宣言します。たとえば、Varchar2(10)。
原因:	変数に返された値がデータ型の指定サイズには大きすぎます。
処置:	変数のサイズを、選択されているフィールドと同じサイズに変更します。
原因:	レポートの作成にPL/SQLの古いバージョンが使用されました。
処置:	現行バージョンのReport Builderでレポートをオープンして、保存し、終了します。再度オープンして実行します。


REP-0451:  <PL/SQL error>。<additional messages>。

原因:	レポートを実行中に、Report Builderでこのエラーが発生しました。
処置:	このエラーが発生しないようにするためには、レポートのPL/SQLを編集し、再コンパイルしてください。


REP-0452:  <PL/SQL error>。<additional message>。<additional message>。

原因:	レポートを実行中に、Report Builderでこのエラーが発生しました。
処置:	このエラーが発生しないようにするためには、レポートのPL/SQLを編集し、再コンパイルしてください。


REP-0453:  <PL/SQL error>。<additional message>。<additional message>。<additional message>。

原因:	レポートを実行中に、Report Builderでこのエラーが発生しました。
処置:	このエラーが発生しないようにするためには、レポートのPL/SQLを編集し、再コンパイルしてください。


REP-0490:  内部エラー - Toolkitコンテキストは使用不可です。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-0491:  警告: 列: <column name>で、データが切り捨てられたかもしれません。

原因:	レポートのデータベース列の幅が、データベースにおける幅より小さく定義されています。これはレポートが定義された後にデータベース列が更新された場合によく発生します。RUNDEBUGがYESに設定されているときにのみ、この警告は表示されます。
処置:	問合せを、強制的に解析し直してください。再解析には、「SELECT文」フィールドの行末にスペースを入力した後、「SQL問合せ文」ダイアログを適用する方法があります。


REP-0492:  トークン: <token name>は不明です。

原因:	入力されたSELECT文にSQL構文にはない項目が含まれています。
処置:	SELECT文を調べ、SQL構文に従っていることを確認してください。


REP-0493:  内部エラー - 文字参照を拡張できません。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-0494:  内部エラー - 文字参照を処理できません。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-0495:  内部エラー - 問合せをトークン化できません。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-0496:  内部エラー - 問合せを解析できません。

原因:	入力されたSQL文にエラーがあるために解析できません。
処置:	入力されたSQL文を調べ、正しい構文を使用していることを確認してください。詳細は、『Oracle8 Server SQLリファレンス』を参照してください。


REP-0497:  内部エラー - rodsltで問合せが失敗しました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-0498:  問合せで選択した列の数がレポート定義と適合しません。

原因:	レポート定義で想定されている数よりも多い列が、問合せで選択されています。レポートで外部問合せを使用しており、レポートを定義した後に外部問合せが変更されたときに、このエラーが発生することがあります。
処置:	変更された問合せを適用するようにレポート定義を更新してください。たとえば、変更された外部問合せを参照する問合せの「SQL問合せ文」ダイアログに移動し、それを変更してください。列を変更するとその影響を受ける式、集計およびフィールドも更新する必要があります。


REP-0499:  問合せで選択された列: '$0'はレポート定義と互換性がありません。

原因:	データベースからの列がレポート定義の列に一致しません。このエラーの原因として、次のことが考えられます。
	ケース1:	レポートを定義した後にデータベース中の列の定義が変更されました。
	ケース2:	レポートで外部問合せを使用しており、レポートを定義した後に外部問合せが変更されました。
処置:	このエラーの訂正には、次の処置を行ってください。
	ケース1の場合:	変更された列を確定するようにレポート定義を更新してください。たとえば、列のデータ型が変更されている場合は、「SQL問合せ文」ダイアログで外部問合せを再適用し、レポート定義内の列のデータ型を更新します。列を変更するとその影響を受ける式、集計およびフィールドも更新する必要があります。
	ケース2の場合:	変更された問合せを適用するようにレポート定義を更新してください。たとえば、変更された外部問合せを参照する「SQL問合せ文」ダイアログを再適用してください。列を変更するとその影響を受ける式、集計およびフィールドも更新する必要があります。


REP-0500:  入力された数値は、有効範囲を超えています。

原因:	設定に入力された値が大きすぎます。
処置:	フィールドの制限をチェックしてください。フィールドについて記述している章を参照し、制限内の数値を入力してください。


REP-0501:  指定したデータベースに接続できません。

原因:	Report BuilderがOracleに接続しようとしましたが、できませんでした。このエラーの原因として、次のことが考えられます。
	ケース1:	Oracleが一時的に使用できません。
	ケース2:	接続情報が有効ではありませんでした。
処置:	このエラーの訂正には、次の処置を行ってください。
	ケース1の場合:	操作をやり直してください。引き続き問題が発生する場合、DBAに連絡してください。3回失敗すると、Report Builderが強制的に中止されることに注意してください。
	ケース2の場合:	接続情報をチェックして、それが正しいことを確認してください。正しくない場合、再度入力し、接続を再試行してください。3回失敗すると、Report Builderが強制的に中止されることに注意してください。


REP-0502:  端末ファイル: <filename>をオープンしようとしてエラーが発生しました。

原因:	Report Builderが指定された端末定義ファイルをオープンしようとしましたが、できませんでした。TERMキーワードの後に正しくないファイル名が指定されたか、ファイルが見つかりませんでした。
処置:	端末定義の名前を正しく指定し、正しいパスに常駐することを確認してください。引き続き問題が発生する場合、DBAに連絡してください。


REP-0503:  レポートの名前が指定されていません。

原因:	レポートの名前を指定すべき場所に、無効な名前を指定したか、または何も指定しませんでした。
処置:	レポートの名前を正しく指定してください。


REP-0504:  指定したデータベースに接続されていません。

原因:	データベースに接続されていることが条件である操作を実行しようとしましたが、接続されていませんでした。
処置:	「ファイル」 [image] 「接続」を使用してデータベースに接続してください。


REP-0450<PL/SQL error>の例
REP-0450:  <PL/SQL error>の例


REP-0505: この値は列の幅として有効ではありません。
• REP-0505:  この値は列の幅として有効ではありません。

原因:	「幅」に入力された値が無効です。このエラーの原因として、次のことが考えられます。
	ケース1:	0（ゼロ）または負数が入力されました。「幅」は0（ゼロ）より大きい値にする必要があります。
	ケース2:	数値以外の値が入力されました。
	ケース3:	NUMBER型ではない列に、フォームの幅（x, y）が入力されました。ここでxは精度、yは桁数を表します。この「幅」の指定は「データ型」が「Number」のときにのみ有効です。
処置:	このエラーの訂正には、次の処置を行ってください。
	ケース1の場合:	0（ゼロ）より大きい値を入力してください。
	ケース2の場合:	0（ゼロ）より大きい値を入力してください。
	ケース3の場合:	0（ゼロ）より大きい値を入力するか、可能な場合、列の「データ型」を「Number」に変更してください。


REP-0506:  データベース列を別の問合せに移動することはできません。

原因:	別の問合せに属する別のグループに列を移動しようとしましたが、この列はデータベースの列です。データベースの列は、そのグループを所有する問合せによって選択する必要があります。
処置:	可能な場合、移動する列のグループを所有する問合せで列を選択してください。


REP-0507:  この操作を実行する前にファイル名を入力してください。

原因:	「ファイル選択」ダイアログ・ボックスで、ファイル名を指定せずにダイアログ・ボックスを適用しようとしました。
処置:	名前を入力した後にダイアログ・ボックスを適用するか、取り消してください。


REP-0508:  この操作を実行する前にオブジェクト名を入力してください。

原因:	「データベース・オブジェクト選択」ダイアログ・ボックスで、オブジェクト名を指定せずにダイアログ・ボックスを適用しようとしました。
処置:	名前を入力した後にダイアログ・ボックスを適用するか、取り消してください。


REP-0509:  数値は無効です。

原因:	数値フィールドに、数字または小数点以外のものが入力されました。
処置:	数字と小数点のみを含む数値を入力してください。


REP-0510:  有効なオプションは「インチ」、「センチメートル」、「ポイント」です。

原因:	「サイズの単位」フィールドに無効なサイズの単位が入力されました。
処置:	値リストから使用するオプションを選択してください。


REP-0511:  有効なオプションは「右/下」または「下/右」です。

原因:	2つの有効なオプション以外の「パネル印刷順序」が入力されました。
処置:	値リストから使用するオプションを選択してください。


REP-0512:  16進値は、ここでは不適です。

原因:	10進数値が入力されましたが、Report Builderでは10進数以外の値が必要です。
処置:	10進数以外の値を入力してください。


REP-0513:  サイズの単位を入力してください。

原因:	「サイズの単位」をブランクにして、他の設定に移動しようとしました。
処置:	「サイズの単位」のオプションを選択してください。


REP-0514:  ページ・サイズを指定してください。

原因:	「ページ幅」または「ページ高さ」（あるいはその両方）をブランクに設定したままですが、値の設定が必要です。
処置:	「ページ幅」または「ページ高さ」（あるいはその両方）の数値を入力してください。


REP-0515:  パラメータ・フォーム・サイズを指定してください。

原因:	「パラメータ・フォーム幅」または「パラメータ・フォーム高さ」（あるいはその両方）をブランクに設定したままですが、値の設定が必要です。
処置:	「パラメータ・フォーム幅」または「パラメータ・フォーム高さ」（あるいはその両方）の数値を入力してください。


REP-0516:  ページ・サイズを文字数で指定してください。

原因:	「ページ・サイズ」に入力された値が文字単位ではありませんでした。「ページ・サイズ」は文字単位で指定する必要があります。
処置:	「ページ・サイズ」に文字単位の値を入力してください。


REP-0517:  フォーム・サイズを文字数で指定してください。

原因:	「フォーム・サイズ」に入力された値が文字単位ではありませんでした。「フォーム・サイズ」は文字単位で指定する必要があります。
処置:	「フォーム・サイズ」に文字単位の値を入力してください。


REP-0518:  有効なオプションは、「データベース」、「ファイル」または「ファイル/データベース」です。

原因:	入力された「オブジェクト・アクセス」設定が3つの有効な選択肢の1つではありません。
処置:	値リストからオプションを1つ選択してください。


REP-0519:  有効なオプションは、「挿入」または「上書き」です。

原因:	デフォルトのテキスト編集モードに、2つの有効なオプション以外の値が入力されました。
処置:	値リストからオプションを1つ選択してください。


REP-0520:  グループまたは枠の字下げの値は、0～4でなければなりません。

原因:	グループまたは枠の字下げに対して入力した値が有効な値の範囲外でした。
処置:	0～4の数字を入力してください。


REP-0521:  <Name>は、無効な名前です。

原因:	命名規則に違反し、オブジェクトに無効な名前を指定しました。
処置:	作成しているオブジェクト・タイプの命名規則を調べ、名前がそれらの規則に従っていることを確認してください。詳細は、「命名規則」を参照してください。


REP-0522:  このレポートにはグループがないため、デフォルト・レイアウトを作成できません。

原因:	レポートにグループを作成する前にレイアウト・モデル・エディタで「ツール」メニューのデフォルト・レイアウトを使用して領域を描きました。デフォルト・レイアウトを作成するにはグループが必要です。
処置:	Report Builderが自動的にグループを生成できるように1つ以上の問合せを作成した後、操作をやり直してください。


REP-0523:  デフォルト・レイアウト・スタイルは無効です。値リストを参照してください。

原因:	「レポート・スタイル」に有効なオプション以外の値が入力されました。
処置:	値リストからレイアウト・スタイルを選択してください。


REP-0524: 印刷方向は無効です。値リストを参照してください。
REP-0524:  印刷方向が無効です。値リストを参照してください。

原因:	「印刷方向」の値に有効なオプション以外の値が入力されました。
処置:	値リストから「印刷方向」の値を選択してください。


REP-0525:  有効なオプションは、「Screen」または「File」、「Printer」、「Mail」または「Sysout」です。

原因:	システム・パラメータDESTYPEの宛先タイプに有効なオプション以外の値が入力されました。このエラーの原因として、次のことが考えられます。
	ケース1:	「ランタイム・パラメータ・フォーム」の「宛先タイプ」に無効な値が入力されました。
	ケース2:	DESTYPEの「パラメータ」プロパティ・パレットに無効な「初期値」が入力されました。
処置:	このエラーの訂正には、次の処置を行ってください。
	ケース1の場合:	有効な値の「Screen」、「File」、「Printer」、「Mail」または「Sysout」から1つを入力してください。
	ケース2の場合:	値リストから「初期値」の値を選択してください。


REP-0526:  入力した初期値がパラメータの幅を超えています。

原因:	入力された値が、「パラメータ」プロパティ・パレットのパラメータには長すぎます。このエラーの原因として、次のことが考えられます。
	ケース1:	パラメータの「幅」で指定した値よりも大きすぎる値が、「初期値」に入力されました。
	ケース2:	「幅」に入力した値が小さすぎるために、パラメータに入力可能な値を含むことができません。
処置:	このエラーの訂正には、次の処置を行ってください。
	ケース1の場合:	「幅」に指定した値よりも小さいことを確認して、「初期値」を再入力してください。
	ケース2の場合:	入力した「初期値」を削除してください。パラメータの「幅」設定に移動し、指定した「初期値」を含めるように値を大きくしてください。「初期値」を再入力してください。


REP-0527:  システム・パラメータは削除できません。

原因:	「パラメータ」プロパティ・パレットからパッケージ・パラメータを削除しようとしました。
処置:	Report Builderではシステム・パラメータを削除できません。ただし、「デフォルト・パラメータ・フォーム」ダイアログ・ボックスまたはパラメータ・フォーム・エディタを使用して、「ランタイム・パラメータ・フォーム」のパラメータ表示を抑止できます。詳細は、「パラメータ・フォーム・エディタ」を参照してください。


REP-0528:  有効なオプションは、「Character」、「Number」または「Date」です。

原因:	パラメータの「データ型」に入力されたデータ型が有効なデータ型ではありませんでした。
処置:	値リストから「データ型」のデータ型を選択してください。


REP-0529:  有効なオプションは、「Box」または「Graphic」、「Line」、「Text」です。

原因:	ボイラープレートの「型」に入力された値が有効なタイプではありませんでした。
処置:	値リストから「型」の値を選択してください。


REP-0530:  ファイル名が長すぎるため、切り捨てられます。

原因:	ファイルのサイズより小さい最大幅を持つフィールドに、ファイルをインポートしようとしました。Report Builderは、フィールドに収まるファイルの内容のみをインポートしました。
処置:	ファイル全体をインポートする場合、フィールドのサイズを大きくしてください。


REP-0531:  オブジェクト・タイプは無効です。値リストを参照してください。

原因:	「オブジェクトへの操作」ダイアログ・ボックスに無効なオブジェクト・タイプの値を入力しました。
処置:	値リストから値を選択してください。


REP-0532:  指定されたデータ型でこの名前のオブジェクトはありません。

原因:	「オブジェクトへの操作」ダイアログ・ボックスの「オブジェクト名」フィールドに入力した値は、レポートの指定した型のオブジェクトに対応していません。
処置:	名前を正確に指定したことと、オブジェクトが現行のレポートに含まれることを確認してください。


REP-0533:  テキスト入力フィールドにインポートしか行えません。

原因:	テキスト以外のエントリ・フィールド（たとえば数値のみを受け入れるフィールド）で「ファイル」 [image] 「インポート」を選択しました。
処置:	何かをインポートする場合、テキスト・エントリ・フィールドに移動してインポートしてください。


REP-0534:  テキスト入力フィールドからエクスポートしか行えません。

原因:	テキスト以外のエントリ・フィールド（たとえば数値のみを受け入れるフィールド）で「ファイル」 [image] 「エクスポート」を選択しました。
処置:	何かをエクスポートする場合、テキスト・エントリ・フィールドに移動してエクスポートしてください。


REP-0535: データベースには、<object name>という名前のオブジェクトはありません。
• REP-0535:  データベースには、<object name>という名前のオブジェクトはありません。

原因:	データベースに格納されているモジュールに対する操作を実行しようとしましたが、Report Builderがそのオブジェクトを見つけられませんでした。
処置:	名前を正しく指定したことと、モジュールが常駐するデータベースに接続されていることを確認してください。


REP-0536:  所有していないデータベースのオブジェクトは削除できません。

原因:	所有していないオブジェクトを削除しようとしました。オブジェクトを削除するには、そのオブジェクトの所有者であることが必要です。
処置:	可能ならば、所有者にオブジェクトを削除してもらってください。


REP-0537:  所有していないデータベースのオブジェクトは改名できません。

原因:	所有していないオブジェクトを改名しようとしました。オブジェクトを改名するには、そのオブジェクトの所有者であることが必要です。
処置:	可能ならば、所有者にオブジェクトを改名してもらってください。


REP-0538:   <object name>という名前のオブジェクトは、既にデータベースに存在しています。

原因:	オブジェクトに対して入力した名前は、既存のオブジェクトに対してすでに使用されています。
処置:	矛盾を避けるためにオブジェクトに異なる名前を指定するか、既存のオブジェクトを削除してください。


REP-0539:  デフォルト・パラメータ・フォームを<number>ページに合わせることはできません。

原因:	デフォルトのパラメータ・フォームが大きすぎて、指定されたページ数に収まりません。
処置:	「ツール」 [image] 「Parameter Form Builder」を選択し、パラメータ・フォームを収められるページ数に増やしてください。


REP-0540:  デフォルト・パラメータ・フォームのページ・サイズが小さすぎます。

原因:	現行のパラメータ・フォーム・ウィンドウの「幅」と「高さ」の設定値がデフォルト・パラメータ・フォームに対して小さすぎます。
処置:	レポート・プロパティ・パレットのパラメータ・フォーム・ウィンドウの「幅」と「高さ」を変更することによって、サイズを大きくしてください。またはパラメータ・フォーム・エディタでの編集によってオブジェクトのサイズを小さくすることもできます。


REP-0541:  ソースはレポートでなければなりません。

原因:	RWRUN60またはRWCON60、「ファイル」 [image] 「管理」 [image] 「変換」で、ソースとしてレポート以外のものを指定しました。これらの操作ではすべて、ソースとしてレポートが必要です。
処置:	操作のソースとしてレポートを指定してください。


REP-0542:  日付マスクが環境設定で指定されていません。

原因:	「データ型」が「DATE」に設定されているパラメータ/フィールドの「パラメータ」または「フィールド」プロパティ・パレットで「入力マスク」または「書式マスク」の「リスト」ボタンが選択されましたが、「作業環境」ダイアログ・ボックスの「マスク編集」ボタンで開ける日付マスク・リストにマスクの指定がありません。
処置:	手動で日付書式マスクを入力するか、または「作業環境」ダイアログ・ボックスから「書式マスク」ダイアログ・ボックスに移動して、日付マスク・リストに日付書式マスクを入力してください。


REP-0543:  数値マスクが環境設定で指定されていません。

原因:	「データ型」が「NUMBER」に設定されているパラメータ/フィールドの「パラメータ」または「フィールド」プロパティ・パレットで「入力マスク」または「書式マスク」の「リスト」ボタンが選択されましたが、「作業環境」ダイアログ・ボックスの「マスク編集」ボタンで開ける数値マスク・リストにマスクの指定がありません。
処置:	手動で数値書式マスクを入力するか、または「作業環境」ダイアログ・ボックスから「書式マスク」ダイアログ・ボックスに移動して、数値マスク・リストに数値書式マスクを入力してください。


REP-0544:  オンライン・ヘルプ・システムが使用不能です。

原因:	「ヘルプ」 [image] 「Report Builderヘルプ・トピック」が選択されましたが、ヘルプを見つけられませんでした。これは、ヘルプ・ファイルを見つけられなかったことや、またはヘルプ・システム・エラーが原因で起きる場合があります。
処置:	ヘルプ・ファイルとヘルプ・システムが正しくインストールされていることを確認してください。正しくインストールされている場合にもエラーが発生する場合は、サポート担当に連絡してください。詳細は、サポート担当への連絡を参照してください。


REP-0545:  数値は、0より大きくなければなりません。

原因:	「レポート」プロパティ・パレットの「幅」または「高さ」、「論理水平パネル」、「論理垂直パネル」に0（ゼロ）を入力しました。0（ゼロ）より大きい数値を入力する必要があります。
処置:	「幅」、「高さ」、「論理水平パネル」または「論理垂直パネル」に0（ゼロ）より大きい数値を入力してください。


REP-0546:  入力されたパラメータは無効です。

原因:	ランタイム・パラメータ・フォームで、パラメータに無効な値を入力しました。たとえば、データ型がNUMBERのパラメータの値として1つ以上の文字を入力しました。
処置:	パラメータに有効な値を入力して、操作をやり直してください。


REP-0548:  Oracle Toolkitの初期化の際に問題が発生しました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-0549:  バッチ・モードでは、宛先タイプが「File」、「Printer」、「Mail」または「Sysout」でなければなりません。

原因:	バックグラウンド（つまりBATCH=YES）でレポートを実行しようとしましたが、バックグラウンドでの実行には無効のDESTYPEを指定しました。
処置:	DESTYPEをFile、Printer、MailまたはSysoutに変更するか、BATCH=YESでレポートを実行しないでください。


REP-0550:  親グループが無効です。

原因:	入力した名前が、現在定義中のレポートで有効な親グループを示していません。
処置:	値リストからグループを選択してください。


REP-0551:  親列が無効です。

原因:	入力した名前が、現在定義中のレポートで有効な親列を示していません。指定した列が親グループに存在しません。
処置:	値リストから列を選択してください。目的の列が表示されない場合は、「親グループ」に指定したグループの親問合せのSELECT文にその列を加えてください。


REP-0552:  子列が無効です。

原因:	入力した名前が、現在定義中のレポートで有効な子列を示していません。指定した列が問合せに存在しません。
処置:	値リストから列を選択してください。目的の列が表示されない場合は、問合せのSELECT文にその列を加えてください。


REP-0553:  条件が無効です。

原因:	「条件」に入力した値が有効な選択肢ではありません。
処置:	「条件」の値リストから値を選択してください。


REP-0554:  有効なオプションは、「WHERE」、「HAVING」または「START WITH」です。

原因:	「SQL句」に入力した値が有効な選択肢ではありません。
処置:	「SQL句」の値リストから値を選択してください。


REP-0555:  警告: 「START WITH」はOracle固有のSQL構文です。レポートはOracle以外のデータベースでは実行できません。

原因:	START WITH句はOracleデータベースでのみ使用可能です。データベースに接続されていないか、または非Oracleデータベースに接続されている場合、この警告が表示されます。
処置:	Oracleデータベースに対してレポートを実行していること、または非Oracleのデータベースに対してレポートを実行する前にSTART WITH句を削除していることを確認してください。


REP-0556:  データ・リンクは作成されませんでした。子問合せ: <query name>には、親問合せ: <query name>の主キーを参照している外部キーがありません。

原因:	問合せ間にリンクを作成しようとしましたが、子問合せに外部キーが存在しません。
処置:	参照される表がローカル・データベースにあり、アクセス可能であるかどうかを確認してください。確認できたら、必要に応じて適切な列制約を追加してください。


REP-0558:  注意: 問合せ: <query name>は、文字パラメータ: <parameter name>を作成しました。

原因:	指定された問合せが存在しない字句パラメータを参照しています。
処置:	なし。Report Builderがすでに必要な字句パラメータを作成しています。


REP-0559:  注意: 問合せ: <query name>は、バインド・パラメータ: <parameter name>を作成しました。

原因:	指定された問合せが存在しないバインド・パラメータを参照しています。
処置:	なし。Report Builderがすでに必要なバインド・パラメータを作成しています。


REP-0560:  グループは無効です。

原因:	「グループ」に入力したグループ名が列に有効なグループではありません。指定したグループが存在しないか、列を所有できません。
処置:	列を所有できるようにグループを作成または変更してください。データベースの列は、それを選択する問合せに関係付けられたグループによって所有される必要があります。サマリーまたは式列は、そのグループ階層（すなわち、データ・モデル・エディタに現れるグループの表示順）で要約される列を所有するグループより下のグループによって所有されている必要があります。


REP-0561:  有効なオプションは、「式」、「サマリー」または「プレースホルダー」です。

原因:	列の「タイプ」に入力した値が有効な選択肢ではありませんでした。
処置:	列の「タイプ」の値リストから値を選択してください。


REP-0562:  列データ型が無効です。値リストを参照してください。

原因:	「ブレーク順序」に入力した値が有効な選択肢ではありません。
処置:	「ブレーク順序」の値リストから値を選択してください。


REP-0563:  有効なオプションは、「降順」、「昇順」または空白です。

原因:	「ブレーク順序」に入力した値が有効な選択肢ではありません。
処置:	「ブレーク順序」の値リストから値を選択してください。


REP-0564:  ファイル・タイプが無効です。

原因:	「ファイル形式」に入力したファイル・タイプ値が有効なタイプではありませんでした。値のつづりが間違っているか、入力した値が存在しません。
処置:	「ファイル形式」の値リストからファイル・タイプを選択してください。


REP-0565:  ファンクションが無効です。値リストを参照してください。

原因:	「ファンクション」に入力したファンクションが有効な選択肢ではありません。
処置:	値リストからファンクションの1つを選択してください。


REP-0566:  データベース列は削除できません。

原因:	DATABASE型の列を削除しようとしました。
処置:	列を選択する問合せの選択リストから列を削除すると、自動的に列が削除されます。


REP-0567:  サマリー・ソースが無効です。値リストを参照してください。

原因:	サマリーの「ソース」に入力した列が有効な選択肢ではありませんでした。このエラーの原因として、次のことが考えられます。
	ケース1:	列が存在しません。
	ケース2:	「ソース」の「データ型」は、CHARACTERまたはDATEです。「データ型」がNUMBERでない場合、数値ファンクション（たとえば割合（%）、合計または平均）を使用できません。
処置:	このエラーの訂正には、次の処置を行ってください。
	ケース1の場合:	ファンクションの値リストから列を選択してください。
	ケース2の場合:	「データ型」がNUMBERの「ソース」に別の列名を入力してください。


REP-0568: 「NULL時の値」が無効です。
• REP-0568:  「NULL時の値」が無効です。

原因:	「列」プロパティ・パレットの「NULL時の値」の値がその列に無効です。たとえば、列のデータ型がNUMBERの場合に、「NULL時の値」に文字列を指定すると、このエラーが発生します。
処置:	「NULL時の値」に有効な値を指定してください。


REP-0580:  フィルタ・タイプが無効です。値リストを参照してください。

原因:	「フィルタ・タイプ」に入力した値が有効な選択肢ではありません。
処置:	値リストからフィルタ・タイプの1つを選択してください。


REP-0581:  このグループは問合せ: <query name>の唯一のグループで、削除できません。

原因:	削除しようとしたグループは、唯一の問合せグループです。各問合せには少なくとも1つのグループが必要です。
処置:	グループを削除する場合、グループの問合せを削除してください。


REP-0582:  グループをその問合せの外に移動できません。

原因:	グループを問合せ間で移動できません。同じ問合せに属するグループ群内でのみグループを移動できます。
処置:	可能ならば、移動先にしようとした他の問合せの下のグループと同じグループを作成します。


REP-0583:  SQL SELECT文が無効です。

原因:	入力されたSQL SELECT文が有効ではありません。
処置:	エラーが発生したSELECT文をチェックし、修正してください。詳細は、『Oracle8 Server SQLリファレンス』を参照してください。


REP-0584:  文字パラメータは、外部問合せでは使用できません。

原因:	外部問合せで字句を参照しました。外部問合せから字句を参照できません。
処置:	可能ならば、参照を削除するか、バインド参照に変更してください。


REP-0585:  子問合せ: <query name>の親グループ: <group name>がありません。

原因:	データ・リンク内のそのグループへの参照を削除せずに、問合せを削除しました。通常、この状況は、削除を関連オブジェクトにカスケードしないで問合せを削除したときに発生します。
処置:	子問合せのデータ・リンクを更新してください。


REP-0586:  このデータ・リンクを追加すると無限ループになります。

原因:	データ・リンクの親グループとして指定したグループは、直接間接を問わず、リンク先の問合せの子であるため、親として適当ではありません。
処置:	問合せの子にならず、親グループとして適格になるようにグループを移動します。この処理が不可能な場合は、実行できるアクションはありません。


REP-0587:  PL/SQLのグループ・フィルタ条件が無効です。

原因:	「フィルタ・タイプ」に「PL/SQL」を選択しましたが、PL/SQL条件を入力しませんでした。
処置:	PL/SQLを入力するか、「フィルタ・タイプ」を変更してください。Report Builder内でのPL/SQLの使用の詳細は、「PL/SQLインタフェース」を参照してください。PL/SQLの詳細は、『PL/SQLユーザーズ・ガイドおよびリファレンス』を参照してください。


REP-0588:  PL/SQLの列式が無効です。

原因:	列の「タイプ」として「式」を選択しましたが、式にPL/SQLを入力しませんでした。
処置:	式を作成するか、列の「タイプ」を変更してください。Report Builder内でのPL/SQLの使用の詳細は、「PL/SQLインタフェース」を参照してください。PL/SQLの詳細は、『PL/SQLユーザーズ・ガイドおよびリファレンス』を参照してください。


REP-0590:  <number>ページがフォーマット済です。すでに最終ページが表示されています。

原因:	プレビューアで、フォーマット済みの合計ページ番号より大きい番号のページに移動しようとしました。つまり存在しないページに移動しようとしました。
処置:	なし。レポートの最終ページから下へスクロールできません。


REP-0591:  すでに最初のページです。

原因:	プレビューアで、すでにレポートの第1ページにいましたが「第1ページ」を選択しました。
処置:	なし。レポートの第1ページから上へスクロールできません。


REP-0592:  すでに最後のページです。

原因:	プレビューアで、すでにレポートの最終ページにいましたが「最終ページ」を選択しました。
処置:	なし。レポートの最終ページから下へスクロールできません。


REP-0593:  <page number>: ページが現在のページです。

原因:	プレビューアで、現行のページ番号を入力した後、「ジャンプ」を選択しました。
処置:	他のページへジャンプしようとする場合、異なるページ番号を入力し、「ジャンプ」を選択してください。


REP-0594:  レポート出力は生成されません。

原因:	実行したレポートは出力されませんでした。
処置:	この次に表示されるメッセージをチェックしてデータ・モデルとレイアウトにエラーがあるかどうかを確認してください。引き続き問題が発生する場合、サポート担当に連絡して支援を受けてください。詳細は、サポート担当への連絡を参照してください。


REP-0595:  レポート定義が変更されました。レポートを再実行しています。

原因:	レポートを実行し、その出力がプレビューアにある間にレポート定義が変更されました。レポートを再実行せずにプレビューアに復帰した場合、レポート出力は最新の変更内容を反映するように更新されないので、結果としてレポートを再実行する必要があります。
処置:	プレビューアをクローズし、レポートを再実行してください。


REP-0596:  数値は、<number>より大きくても、1より小さくてもいけません。

原因:	パラメータ・フォーム・フィールドの「フィールド」プロパティ・パレットの「ページ数」設定に無効な値を入力しました。ほとんどの場合、0（ゼロ）または負数、使用可能な最大値より大きい数値を入力したことが原因です。
処置:	メッセージに示した範囲内の数値を入力してください。


REP-0597:  オブジェクトを境界外に移動させることはできません。

原因:	オブジェクトをスクリーンからはみ出るほど移動しようとしました。
処置:	オブジェクトがスクリーンからはみ出さないように操作をやり直してください。


REP-0598:  アンカー終了ポイントがオブジェクトの境界を超えました。

原因:	アンカーの移動中に、終点がアンカー対象のオブジェクトの境界線からはみ出してしまいました。
処置:	終点がオブジェクトの境界上にあるようにアンカーを移動してください。


REP-0599:  このテキスト・ボイラープレートは、編集できません。

原因:	リンク・ファイル・ボイラープレート・オブジェクトのテキストを編集しようとしました。
処置:	リンク・ファイル・ボイラープレート・オブジェクトのテキストを編集する場合、レポートを終了し、テキスト・エディタを使用してリンク・ファイル・ボイラープレート・テキストを含むファイルを編集してください。


REP-0600:  このフィールドに使用できる値リストはありません。

原因:	使用可能な値がない、現行フィールドの値リストにアクセスしようとしました。
処置:	処置は不要です。


REP-0601:  このフィールドの値リストは空です。

原因:	値リストから選択しようとしましたが、値リストに値がありません。値リストに値を入れるために、レポートの他の部分をまず作成しなければならない場合があります。たとえば、値リストが列名のみから作成されていて、データ・モデルを完成していなかった場合、このエラーが発生することがあります。
処置:	レポートを完全に作成すると、このエラーは発生しないはずです。エラーがなくならない場合は、サポート担当に連絡してください。詳細は、サポート担当への連絡を参照してください。


REP-0602:  アクセス可能な表を問合せできません。

原因:	アクセス可能な表のディクショナリ・ビューが存在しないか、使用できません。
処置:	DBAに連絡してください。


REP-0603:  表: <table name>を記述できません。

原因:	アクセス可能な表のディクショナリ・ビューが存在しないか、使用できません。
処置:	DBAに連絡してください。


REP-0604:  SELECT文を作成できません - 値が選択されていません。

原因:	SELECT文の作成に必要な値を選択せずに、「表/列」ダイアログ・ボックスを適用しました。「列」または「表」ラジオ・ボタンを選択した場合に、列または表を1つも選択しないと、ダイアログ・ボックスを適用したときにこのエラー・メッセージが表示されます。
処置:	表、または必要に応じて列を選択するか、「列選択」ラジオ・ボタンを選択し、ダイアログ・ボックスを適用します。SELECT文を作成しないでダイアログ・ボックスを終了するには、「クローズ」ボタンを選択します。


REP-0606:  リンク・ファイル: <filename>を読み込みできません。リンク・ファイルのフォーマットを調べてください。

原因:	「ボイラープレート」プロパティ・パレットの「ソース・ファイル名」フィールドで指定したファイルを見つけられないか、ファイルの形式が「ソース・ファイルのフォーマット」フィールドに指定したものと一致しません。
処置:	ファイルの名前を正しく指定したことと、「ソース・ファイルのフォーマット」フィールドに入力した値がファイルの形式に一致することを確認してください。


REP-0607:  実行専用ファイル: <filename>はオープンできません。

原因:	実行ファイル（拡張子.rep）をオープンしようとしました。実行ファイルはオープンできません。実行できるのみです。
処置:	.repファイルに関係付けられたレポート定義をオープンしてください。拡張子.rdfが付いている必要があります。


REP-0608:  ソース・タイプは無効です。値リストを参照してください。

原因:	「ファイル」-->「変換...」を選択しましたが、指定されたソース・タイプが無効です。
処置:	値リストからソース・タイプを選択してください。


REP-0609:  宛先タイプが無効です。値リストを参照してください。

原因:	「ファイル」-->「管理」-->「変換...」を選択しましたが、宛先タイプが無効です。
処置:	値リストから宛先タイプを選択してください。


REP-0610:  画面印刷の試行中にエラーが発生しました。ログ・ファイル: <filename>がアクセス可能であることを確認してください。

原因:	Report Builderがスクリーンの内容をファイルprintdef.datに書き込もうとしましたが、ファイルを見つけられませんでした。
処置:	printdef.datの適切な位置を決定するためには、インストレーション･ガイドを参照してください。


REP-0611: 有効なオプションは、「Screen」、「File」、「Printer」または「Mail」です。
• REP-0611:  有効なオプションは、「Screen」、「File」、「Printer」または「Mail」です。

原因:	ランタイム・パラメータ・フォームで、「宛先タイプ」に有効でない値を入力しました。
処置:	「宛先タイプ」に「Screen」、「File」、「Printer」または「Mail」から1つの値を指定してください。


REP-0612:  日付マスクは無効です。

原因:	入力した日付マスクが、有効な日付マスクのどれにも一致していません。
処置:	マスクを正しく入力したことを確認してください。詳細は、「書式マスク」を参照してください。


REP-0613:  値がマスク: <mask string>と一致しません。

原因:	「書式マスク」に入力したマスクが有効なマスクではありません。このエラーの原因として、次のことが考えられます。
	ケース1:	マスクとして入力した文字列に無効な文字が含まれています。
	ケース2:	「データ型」がCHARACTERであるフィールドに数値書式のマスクを入力しました。
処置:	このエラーの訂正には、次の処置を行ってください。
	ケース1の場合:	値リストから値を選択してください。詳細は、「書式マスク」を参照してください。
	ケース2の場合:	可能ならば、フィールドの「データ型」をNUMBERに変更してください。フィールドをCHARACTERの「データ型」とすることが必要で変更できない場合、そのフィールドには書式マスクを使用できません。


REP-0614:  検索および置換操作に対してアクティブなウィンドウはありません。

原因:	「検索/置換」ダイアログ・ボックスを使って「検索/置換」操作を行おうとしましたが、アクティブなウィンドウにカーソルがありませんでした。
処置:	「検索/置換」操作を実行する前に、テキスト入力フィールドにカーソルを置いてください。


REP-0615:  テキスト入力フィールドは検索および置換しか行えません。

原因:	「検索/置換」ダイアログ・ボックスを使って「検索/置換」操作を行おうとしましたが、テキスト入力フィールドにカーソルがありませんでした。「検索/置換」操作はテキスト入力フィールドでのみ有効です。
処置:	「検索/置換」操作を実行する前に、テキスト入力フィールドにカーソルを置いてください。


REP-0616:  編集不可能領域ではテキストの置換は行えません。

原因:	「検索/置換」ダイアログ・ボックスを使って、アクセス不可能なフィールドでテキストを置換しようとしました。
処置:	テキストを置換するのは、編集可能領域のみにしてください。


REP-0617:  警告: ランタイム・パラメータ・フォームは既にオープンされています。新規フォームを実行するには、オープン中フォームをクローズし、再度実行してください。

原因:	すでにオープンしているランタイム・パラメータ・フォームでレポートを実行しようとしました。
処置:	現在オープンしているランタイム・パラメータ・フォームをクローズし、再度実行してください。


REP-0619: レイアウトがないので実行できません。
REP-0619:  レイアウトなしで実行できません。

原因:	レイアウトなしでレポートを実行しようとしました。レポートが空になる可能性があります。
処置:	レイアウトを作成してから、レポートを実行してください。


REP-0621:  領域は無効です。値リストを参照してください。

原因:	オブジェクトの「垂直拡張度」に入力した値が有効な値の1つではありません。
処置:	値リストから値を選択してください。


REP-0622:  水平拡張度が無効です。値リストを参照してください。

原因:	オブジェクトの「水平拡張度」に入力した値が有効な値の1つではありません。
処置:	値リストから値を選択してください。


REP-0623: 「印刷オブジェクト・オン」の値が無効です。値リストを参照してください。

原因:	「印刷オブジェクト・オン」の値が有効な値ではありません。
処置:	値リストから値を選択してください。


REP-0624:  「基本印刷オン」の値が無効です。値リストを参照してください。

原因:	「基本印刷オン」の値が有効な値ではありません。
処置:	値リストから値を選択してください。


REP-0625:  テキスト整列は無効です。値リストを参照してください。

原因:	Alignmentに入力した値が有効な値の1つではありませんでした。オブジェクトのデータ型によっては、値が無効になります。Flush/LeftおよびFlush/Center、Flush/Rightが有効なのは、データ型がCHARACTERのフィールドのみです。
処置:	値リストから値を選択してください。


REP-0626:  オブジェクトの位置を指定してください。

原因:	有効な座標範囲内にないxまたはy座標を入力しました。座標には負数を指定できません。
処置:	有効な範囲内の座標を入力してください。


REP-0627:  オブジェクトの高さまたは幅は、正の整数である必要があります。

原因:	入力した幅または高さの値が正の整数ではありませんでした。
処置:	正の整数を入力してください。


REP-0630:  値は<number1>から<number2>である必要があります。

原因:	入力した数値が大きすぎるか、または小さすぎます。
処置:	メッセージに示された範囲内の数値を指定してください。


REP-0631:  文字列は、<number>文字より短くする必要があります。

原因:	入力した文字列が長すぎます。
処置:	メッセージに示された文字数より短い文字列を入力してください。


REP-0632:  値が既にリストにあります。

原因:	項目をリストに追加しようとしましたが、その項目は、以前にリストに追加されていました。たとえば、lib1をレポートの「連結ライブラリ」リストに追加しようとしましたが、lib1がすでに「連結ライブラリ」リストにあった場合、このエラーが発生します。
処置:	一度リストに項目を追加すると、再度追加する必要はありません。


REP-0633:  値が指定されていません。

原因:	項目のリスト操作を実行しようとしましたが、項目を指定しませんでした。たとえば、PL/SQLライブラリをレポートの「連結ライブラリ」リストに追加しようとしましたが、「連結ライブラリ」ダイアログ・ボックスの「ライブラリ」フィールドをブランクにしたまま「連結」ボタンを選択した場合、このエラーが発生します。
処置:	ボタンを選択する前に、追加する項目を適切なフィールドに指定してください。


REP-0634:  行先名は<number>バイトより短くしてください。

原因:	指定した宛先（おそらくファイル名）が長すぎます。宛先名の長さを短くする必要があります。
処置:	再度ファイル名を指定し、それが有効な長さであることを確認してください。


REP-0635:  リストには値が存在しません。

原因:	有効な選択肢のリストにない値を指定しました。値リストを使わずに値を入力した可能性があります。
処置:	リストにある有効な選択肢の1つを指定してください。可能ならば、有効な選択肢を選ぶために値リストを使ってください。


REP-0636: <property name>は、<number>文字より長くできないため、切り捨てられます。
REP-0636:  <property name>は、<number>文字より長くできません。切り捨てられます。

原因:	使用できる以上の長さの文字列を指定しました。切り捨てられます。
処置:	より短い文字列を指定してください。


REP-0637:  <property name>は、<number>文字より長くできません。入力し直してください。

原因:	使用できる以上の長さのファイル名が指定されました。
処置:	より短いファイル名を指定してください。


REP-0640:  フィールド・ソースが無効です。値リストを参照してください。

原因:	フィールドのソース設定に無効な値を入力しました。
処置:	値リストから値を選択してください。


REP-0650:  ソース・グループが無効です。値リストを参照してください。

原因:	繰返し枠のソースに入力したグループ名が有効ではありません。
処置:	値リストから値を選択してください。


REP-0651:  印刷方向が無効です。値リストを参照してください。

原因:	「印刷方向」に入力した値が有効な値（「横」「右/下」、「縦」、「下/右」「マトリックス（セル）」）の1つではありませんでした。
処置:	値リストから値を選択してください。


REP-0652:  垂直間隔は無効です。

原因:	「枠間の垂直間隔」フィールドに数値を入力せずに、フィールドから出ようとしたか、「繰返し枠」プロパティ・パレットを確定しようとしました。
処置:	「枠間の垂直間隔」に0（ゼロ）または正の整数を入力してください。


REP-0653:  水平間隔は無効です。

原因:	「枠間の水平間隔」フィールドに数値を入力せずに、フィールドから出ようとしたか、「繰返し枠」プロパティ・パレットを確定しようとしました。
処置:	「枠間の水平間隔」に0（ゼロ）または正の整数を入力してください。


REP-0654:  ページ当り最大レコードの値は無効です。

原因:	「ページ当りの最大レコード数」に数値またはブランクを入力せずに、フィールドから出ようとしたか、「繰返し枠」プロパティ・パレットを確定しようとしました。
処置:	「ページ当りの最大レコード数」にブランクまたは正の整数を入力してください。


REP-0655:  最小孤立レコードの値は無効です。

原因:	「最小ウィンドウ・レコード数」に数値またはブランクを入力せずに、フィールドから出ようとしたか、「繰返し枠」プロパティ・パレットを確定しようとしました。
処置:	「最小ウィンドウ・レコード数」にブランクまたは正の整数を入力してください。


REP-0660: ボタン・ソースは無効です。列を選択してください。
• REP-0660:  ボタン・ソースは無効です。列を選択してください。

原因:	ボタン動作のソースとしてマルチメディア列を選択した後、ソース列を指定しなかったか、無効なソース列を指定しました。
処置:	ボタン動作にソース列を指定したことを確認してください。列を指定している場合は、ソース列にサウンドまたはビデオ、イメージのいずれかが入っていることを確認してください。


REP-0661:  ボタン・ソースは無効です。ソース・ファイルを指定してください。

原因:	ボタン動作のソースとして「マルチメディア・ファイル」を選択した後、ソース・ファイルを指定しなかったか、無効なソース・ファイルを指定しました。
処置:	ボタン動作にソース・ファイルを指定したことを確認してください。ファイルを指定している場合は、ソース・ファイルがサウンドまたはビデオ、イメージのいずれかであることを確認してください。


REP-0662:  ボタン・アイコンは無効です。

原因:	ボタン・ラベルとして「アイコン」を選択しましたが、有効なアイコン名ではありませんでした。
処置:	表示されたテキスト・フィールドに有効なアイコン・ファイルの名前を入力してください。すべての必要なパス情報を含めてください。


REP-0670:  有効なオプションは、「Box」または「Graphic」、「Line」、「Text」です。

原因:	ボイラープレートの「型」に入力した値が有効な値（「Box」、「Line」、「Graphic」または「Text」）ではありませんでした。
処置:	値リストから「型」を選択してください。


REP-0671:  リンク・ファイル名は無効です。

原因:	ボイラープレートをリンクしようとした先のファイルが有効なファイルではありません。
処置:	名前を再入力し、その名前が現行のディレクトリの既存のファイルを参照していることを確認してください。


REP-0672:  最小孤立行の値は無効です。

原因:	プロパティ・パレットの「最小ウィンドウ・レコード数」に数値またはブランクを入力せずに、フィールドから出ようとしたか、プロパティ・パレットを確定しようとしました。
処置:	「最小ウィンドウ・レコード数」にブランクまたは正の整数を入力してください。


REP-0680:  アンカー・オブジェクト名は無効です。値リストを参照してください。

原因:	「オブジェクト名」フィールドに入力したオブジェクト名が、このオブジェクトをアンカーできる先のオブジェクトの名前ではありません。有効なアンカー・オブジェクト名を入力せずにダイアログ・ボックスを確定しようとしました。
処置:	値リストから「オブジェクト名」のオブジェクト名を選択してください。


REP-0681:  枠は無効です。値リストを参照してください。

原因:	「親/子の枠の種類」に入力された値が有効な値（上、左、右または下）ではありませんでした。アンカーに有効な枠を入力せずに「親の枠の種類」または「子の枠の種類」フィールドから出ようとしました。
処置:	値リストから「親の枠の種類」または「子の枠の種類」の値を選択してください。


REP-0682:  アンカー・ポインタは、0～100％でなければなりません。

原因:	％に入力された値が有効な範囲内（0（ゼロ）～100）にありませんでした。％に有効な値を入力せずに、ダイアログ・ボックスを確定しようとしたか、他のフィールドに移動しようとしました。
処置:	％に有効な範囲の値を入力してください。


REP-0690:  開始ページ番号は無効です。

原因:	「起動位置」がブランクのままでした。「起動位置」に値を入力せずに、「起動位置」フィールドを出ようとしたか、「ページ番号付け」ダイアログ・ボックスを確定しようとしました。
処置:	「起動位置」に正の整数を入力してください。


REP-0691:  ページ増分は無効です。

原因:	「増分」がブランクのままでした。「増分」の値を入力せずに、「増分」フィールドを出ようとしたか、「ページ番号付け」ダイアログ・ボックスを確定しようとしました。
処置:	「増分」に正の整数を入力してください。


REP-0692:  ページ番号リセットは無効です。

原因:	「リセット位置」がブランクのままでした。「リセット位置」の値を入力せずに、「リセット位置」フィールドを出ようとしたか、「ページ番号付け」ダイアログ・ボックスを確定しようとしました。
処置:	値リストから繰返し枠名または「&レポート」を選択し、ページ番号をその「リセット位置」の値にリセットする位置を指定してください。


REP-0700:  カラーは無効です。値リストを参照してください。

原因:	フィールドに入力したカラーが有効な選択肢ではありません。
処置:	値リストからフィールドのカラーを選択してください。


REP-0701:  パターンは無効です。値リストを参照してください。

原因:	フィールドに入力したパターンが有効な選択肢ではありません。
処置:	値リストからフィールドのパターンを選択してください。


REP-0702:  ペン幅は無効です。

原因:	線幅に入力した値が有効な選択肢ではありません。
処置:	値リストから線幅を選択してください。


REP-0703:  フォントは無効です。値リストを参照してください。

原因:	入力したフォントが有効な選択肢ではありません。
処置:	値リストからフォントを選択してください。


REP-0704:  テキスト・スタイルは無効です。値リストを参照してください。

原因:	入力したテキスト・スタイルが有効なスタイルではありません。
処置:	値リストからスタイルを1つ選択してください。


REP-0705:  テキスト強調は無効です。値リストを参照してください。

原因:	入力したテキスト・フォントの太さが有効なフォントの太さではありません。
処置:	値リストからフォントの太さを選択してください。


REP-0706:  テキスト・サイズは無効です。

原因:	入力したポイント・サイズが有効な選択肢ではありません。
処置:	値リストから有効なポイント・サイズを選択してください。


REP-0707:  テキスト間隔は無効です。

原因:	有効な範囲内にない間隔値を入力しました。
処置:	有効な範囲の値を入力してください。


REP-0708:  キャラクタ・モード属性は無効です。値リストを参照してください。

原因:	このフィールドに入力した値が無効です。「キャラクタ・モード属性」に入力する値は、Oracle Terminalまたはプリンタ定義で定義する必要があります。（これらの属性を値リストに表示するには、作業環境ファイルのVISUAL_PREFSにもそれらをリストする必要があります。
処置:	値リストから希望する値を選択してください。希望する値が値リストにない場合、Oracle Terminalまたはプリンタ定義をチェックして、値が有効なものであるかどうかを確認してください。


REP-0709:  'Sysout'は、バッチ・モードでのみ有効です。

原因:	バッチ・モードでレポートを実行していないときに、宛先タイプとしてSysoutを入力しました。このエラーの原因として、次のことが考えられます。
	ケース1:	ランタイム・パラメータ・フォームのDESTYPEにSysoutを入力しました。
	ケース2:	DESTYPEの初期値としてSysoutを保持しており、バッチ・モードでレポートを実行していないときにこの値を確定しました。「パラメータ・フォーム」作業環境がチェックされていない場合、知らずにこの値を確定した可能性があります。
処置:	このエラーの訂正には、次の処置を行ってください。
	ケース1の場合:	バッチ・モードでレポートを実行していない場合には、DESTYPEにSysout以外の何かを入力して、レポートを再実行してください。
	ケース2の場合:	DESTYPEの初期値を他の何かに変更するか、DESTYPEをランタイム・パラメータ・フォームでSysout以外の何かに変更してください。初期値をSysoutのままにした場合には、「パラメータ・フォーム」をチェックしない状態で、非バッチ・モードでレポートを実行できません。


REP-0710:  プリンタ記述ファイルが見つかりません。

原因:	Oracle Reportsが、DESFORMATに指定したプリンタ記述ファイルを見つけることができませんでした。
処置:	DESFORMATに有効なプリンタ記述ファイル（たとえばdflt）を指定してください。


REP-0711:  プレビューアから印刷する場合の宛先タイプは「File」、「Printer」または「Mail」です。

原因:	「プレビューア」で「印刷」ボタンを押しましたが、DESTYPEが「File」、「Printer」または「Mail」以外の値に制限されています。
処置:	「プレビューア」から印刷しようとする前に、DESTYPEが前述の値の1つに設定できることを確認してください。


REP-0712:  プリンタが特定されていません。

原因:	レポートを印刷しようとしましたが、DESNAMEまたは「印刷」ダイアログ・ボックスにプリンタ名を指定しませんでした。
処置:	DESNAMEを使って有効なプリンタ名を指定してください。同じプリンタに頻繁に印刷する場合には、「印刷」ダイアログ・ボックスにプリンタ名を入力してください。DESFORMATを使ってプリンタ名を入力すると、「印刷」ダイアログ・ボックスに設定されたプリンタ名が上書きされることに注意してください。


REP-0713:  プリンタ名: <name>（パラメータ: <parameter name>で指定）は無効です。

原因:	レポートを出力しようとしましたが、DESFORMAT（DESTYPEが「File」または「Mail」の場合）あるいはDESNAME（DESTYPEが「Printer」の場合）に有効なプリンタ名を指定しませんでした。
処置:	DESTYPEが「File」または「Mail」の場合DESFORMATに、またはDESTYPEが「Printer」の場合DESNAMEに、有効なプリンタ名を指定してください。


REP-0714:  メール宛先は無効です。

原因:	他のユーザーにメール・レポートを出力しようとしましたが、DESNAMEに有効なユーザー名を指定しませんでした。
処置:	DESNAMEに有効なユーザー名を指定してください。


REP-0715:  トレース時にはトレース・ファイルを指定してください。

原因:	トレース・モードまたはトレース・オプション（あるいはその両方）を指定しましたが、トレース・ファイルを指定しませんでした。
処置:	トレース・ファイルを指定してください。


REP-0716:  トレース用の指定オプションは無効です。

原因:	無効なトレース・オプションを指定しました。
処置:	トレース・オプションを再指定してください。詳細は、「TRACEOPTS」を参照してください。


REP-0717:  トレースでなければ、オプションの設定/解除ができません。

原因:	トレース中でないときにトレース・オプションを設定または解除しようとしました。
処置:	オプションを設定または解除しようとする前に、トレースを開始してください。


REP-0718: Reports Runtimeを使って、ブレーク情報を究明できません。
• REP-0718:  Reports Runtimeを使って、ブレーク情報を究明できません。

原因:	Runtime実行プログラムを使用してレポートを実行中に、ブレークをトレースしようとしました。
処置:	Runtime実行プログラムを使用しているときに、「Break」オプションを指定しないでください。


REP-0719: トレース・ファイル: <filename>への書込みができません。

原因:	指定したトレース・ファイルには書き込めません。
処置:	指定したトレース・ファイル名をチェックして、それが有効であることを確認してください。


REP-0720:  繰返し枠は無効です。値リストを参照してください。

原因:	「マトリックス」プロパティ・パレットの「垂直繰返し枠」または「水平繰返し枠」に指定した繰返し枠が無効です。有効な繰返し枠を入力せずに、「垂直繰返し枠」または「水平繰返し枠」フィールドから出ようとしました。
処置:	値リストから繰返し枠名を選択してください。


REP-0721:  クロス積グループは無効です。値リストを参照してください。

原因:	「マトリックス」プロパティ・パレットの「クロス積グループ」に入力したグループが無効です。
処置:	値リストからグループ名を選択してください。


REP-0724:  ここでは、列: <column name>の値を取得できません。

原因:	PL/SQLインタプリタのコマンド・ラインからコマンドを発行するか、またはスタンドアロンPL/SQLプログラム単位を実行して、指定した列の値を取得しようとしました。列値を取得できるのは、レポートの実行中のみです。
処置:	レポートが実行を中断中に（たとえばブレークポイントで）、PL/SQLインタプリタまたはPL/SQLプログラム単位を使用して列の値を取得しようとしないでください。列値を取得するには、レポート・レベルのトリガーなど、他の方法を使用してください。


REP-0725:  ここでは、列: <column name>の値を設定できません。

原因:	PL/SQLインタプリタのコマンド・ラインからコマンドを発行するか、またはスタンドアロンPL/SQLプログラム単位を実行して、指定した列の値を設定しようとしました。列値を設定できるのは、レポートの実行中のみです。
処置:	レポートが実行を中断中に（たとえばブレークポイントで）、PL/SQLインタプリタまたはPL/SQLプログラム単位を使用して列の値を設定しようとしないでください。列値を設定するには、レポート・レベルのトリガーなど、他の方法を使用してください。


REP-0726:  ここでは、パラメータ: <parameter name>の値を取得できません。

原因:	PL/SQLインタプリタのコマンド・ラインからコマンドを発行するか、またはスタンドアロンPL/SQLプログラム単位を実行して、指定したパラメータの値を取得しようとしました。パラメータ値を取得できるのは、パラメータ・フォームの実行中のみです。
処置:	レポートが実行を中断中に（たとえばブレークポイントで）、PL/SQLインタプリタまたはPL/SQLプログラム単位を使用してパラメータの値を取得しようとしないでください。パラメータ値を取得するには、レポート・レベルのトリガーなど、他の方法を使用してください。


REP-0727:  ここでは、パラメータ: <parameter name>の値を設定できません。

原因:	PL/SQLインタプリタのコマンド・ラインからコマンドを発行するか、またはスタンドアロンPL/SQLプログラム単位を実行して、指定したパラメータの値を設定しようとしました。パラメータ値を設定できるのは、パラメータ・フォームの実行中のみです。
処置:	レポートが実行を中断中に（たとえばブレークポイントで）、PL/SQLインタプリタまたはPL/SQLプログラム単位を使用してパラメータの値を設定しようとしないでください。パラメータ値を設定するには、レポート・レベルのトリガーなど、他の方法を使用してください。


REP-0728:  列: <column name>をパラメータ・トリガーから参照できません。

原因:	パラメータ関連のトリガー（フォーム前、フォーム後、 有効化）で列を参照しようとしましたが、これはできません。
処置:	パラメータ関連のトリガーから参照を削除し、それらの参照をBefore Reportトリガーに追加してください。


REP-0729: プログラム単位: <program unit name>（サイズ: <number>バイト）は、現行のプラットフォームの制限:
REP-0729:  プログラム単位: <program unit name>（サイズ: <number>バイト）は、現行のプラットフォームの制限: <limit>に対して大きすぎてロードできません。

原因:	プログラム単位が他のオペレーティング・プラットフォームで作成されたもので、大きすぎて現行のオペレーティング・プラットフォームにロードできません。
処置:	ロードしようとしているPL/SQLプログラム単位のサイズを小さくしてください。


REP-0730:  以下のバインド変数が定義されていません。

原因:	定義されていないパラメータまたは列にバインド参照を行おうとしました。バインド参照を行う前に、パラメータまたは列を定義する必要があります。
処置:	参照するオブジェクトに対して列またはパラメータ定義を作成してください。可能ならば、バインド参照ではなく字句参照を使用してください。


REP-0732:  プログラム単位の破棄中にエラーが発生しました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-0733:  その名前は既に存在しています。別の名前を選択してください。

原因:	レポートに格納された既存のサブプログラム名と同じ名前でPL/SQLサブプログラムを作成しようとしました。
処置:	既存のサブプログラム名と同じ名前にならないように、新しく作成するサブプログラムの名前を変更してください。


REP-0734:  引数は指定できません。引数を削除してください。

原因:	引数付きのPL/SQLを使用できないPL/SQLフィールドに（たとえば、「フォーマット・トリガー」フィールドまたは「式列」フィールドに、あるいはグループ・フィルタとして）、引数を必要とするPL/SQLファンクションまたはプロシージャを入力しました。
処置:	PL/SQLソースから引数を削除してください。


REP-0735:  PL/SQLソース・テキストをロードできませんでした。データベースに接続していることを確認してください。

原因:	Report Builderはプログラム単位全体をロードできませんでした。プログラム単位がデータベースに格納された1つ以上のオブジェクトを参照しようとしましたが、これらのオブジェクトを見つけられなかったと考えられます。
処置:	正しいデータベースに接続していることを確認してください。プログラム単位が正しい参照を行っていることも確認してください。


REP-0736:  コンパイルされていないプログラム単位があります。

原因:	レポートを変換しようとしたか、または再コンパイルが必要なPL/SQLを含む古いレポートをロードしました。
処置:	RWBLD60を使用してレポートをロードし、プログラム単位を変更してください。


REP-0737:  データ型: <returntype>の戻り値を持つファンクションでなければなりません。

原因:	適切な戻り値の型を持たないPL/SQLを入力しました。
処置:	ファンクションの戻り値の型を、メッセージに表示した型に変更してください。


REP-0738:  ファンクション以外は使用できません。

原因:	ファンクションが必要なところでファンクション以外の何かを入力しました。
処置:	ファンクションを入力してください。


REP-0739:  他のプラットフォームでコンパイルされたPL/SQLは実行できません。

原因:	レポートのPL/SQLがコンパイルされたプラットフォームとは異なるプラットフォームで、レポートを実行しようとしました。レポートにはPL/SQLソースが含まれていないため、 Report Builderは現行のプラットフォームでPL/SQLを再コンパイルできませんでした。
処置:	PL/SQLをコンパイルした元のプラットフォームでレポートを実行してください。または、ソースPL/SQLを含むソース・レポートのコピーを取得し、現行のプラットフォームからそれを再コンパイルしてください。


REP-0740: アンカーを別のオブジェクトにアンカーできません。

原因:	アンカーを他のレイアウト・オブジェクトにアンカーしようとしたか、またはレイアウト・オブジェクトをアンカーにアンカーしようとしました。
処置:	アンカーは他のレイアウト・オブジェクトではアンカーできません。


REP-0741:  マトリックスを別のオブジェクトにアンカーできません。

原因:	マトリックス・オブジェクトを他のレイアウト・オブジェクトにアンカーしようとしたか、またはオブジェクトをマトリックス・オブジェクトにアンカーしようとしました。
処置:	マトリックス・オブジェクトは他のレイアウト・オブジェクトではアンカーできません。


REP-0742:  マージンを別のオブジェクトにアンカーできません。

原因:	マージンをレイアウト・オブジェクトにアンカーしようとしたか、またはレイアウト・オブジェクトをマージンにアンカーしようとしました。
処置:	マージンはレイアウト・オブジェクトでアンカーできません。


REP-0743:  マトリックス繰返し枠は別のオブジェクトにアンカーできません。

原因:	「印刷方向」が「縦」または「横」に設定されているマトリックス繰返し枠を、他のレイアウト・オブジェクトにアンカーしようとしました。
処置:	「印刷方向」が「縦」または「横」に設定されているマトリックス繰返し枠は、他のレイアウト・オブジェクトでアンカーできません。


REP-0744:  アンカーの親オブジェクトと子オブジェクトは別でなければなりません。

原因:	親オブジェクトと子オブジェクトが同じアンカーを作成しようとしました。つまり、オブジェクトをそれ自身にアンカーしようとしました。
処置:	オブジェクトはそれ自身にアンカーできません。アンカーは異なる親オブジェクトと子オブジェクトを持つ必要があります。


REP-0745:  オブジェクトは、一度しか固定できません。

原因:	同じ2つのレイアウト・オブジェクト間で2つのアンカーを作成しようとしました。
処置:	同じ2つのレイアウト・オブジェクト間ではアンカーは1つしか作成できません。


REP-0746:  PL/SQLが存在しないオブジェクトを参照しています。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-0747:  BEFOR FORMトリガーはレポート列を参照できません。

原因:	レポートのフォーム前トリガーがレポートの列を参照しています。フォーム前トリガーからは列を参照できません。
処置:	フォーム前トリガーから列の参照をすべて削除してください。（列の値を設定する必要がある場合は、Before Reportトリガーから設定してください。)


REP-0748:  パラメータ・トリガーは、レポート列を参照できません。

原因:	パラメータの有効化トリガーがレポートの1つ以上の列を参照しています。有効化トリガーからは列を参照できません。
処置:	「パラメータ」プロパティ・パレットの有効化トリガーから列の参照をすべて削除してください。


REP-0749:  AFTER FORMトリガーはレポート列を参照できません。

原因:	レポートのフォーム後トリガーがレポートの列を参照しています。フォーム後トリガーからは列を参照できません。
処置:	フォーム後トリガーから列の参照をすべて削除してください。（列の値を設定する必要がある場合は、Before Reportトリガーから設定してください。


REP-0750:  PL/SQLライブラリのクローズ中にエラーが発生しました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-0751: PL/SQLライブラリからプログラム単位のアクセス中にエラーが発生しました。
• REP-0751:  PL/SQLライブラリからプログラム単位のアクセス中にエラーが発生しました。

原因:	これは異常な状態です。PL/SQLライブラリに何か変更を加えた場合は、「ファイル」 [image] 「別名保存...」を選択して、異なる名前でそれを保存してください。
処置:	詳細は、「異常な状態」を参照してください。


REP-0752:  PL/SQLライブラリを保存できません。

原因:	これは異常な状態です。PL/SQLライブラリに何か変更を加えた場合は、「ファイル」 [image] 「別名保存...」を選択して、異なる名前でそれを保存してください。
処置:	詳細は、「異常な状態」を参照してください。


REP-0753:  PL/SQLライブラリ: <library name>の接続中にエラーが発生しました。

原因:	無効なPL/SQLライブラリを連結しようとしました。PL/SQLライブラリが破壊されているか、指定したファイルまたはオブジェクトにPL/SQLライブラリが入っていないことが原因と考えられます。
処置:	指定したファイルまたはオブジェクトが有効なPL/SQLライブラリを含むことを確認してください。


REP-0754:  PL/SQLライブラリへのプログラム単位の挿入の際にエラーが発生しました。

原因:	プログラム単位を、破壊されているPL/SQLライブラリ、またはPL/SQLライブラリでないファイルやオブジェクトに保存しようとしました。
処置:	指定したファイルまたはオブジェクトが有効なPL/SQLライブラリを含むことを確認し、「ファイル」 [image] 「別名保存」を使って現行のプログラム単位を保存してください。


REP-0755:  PL/SQLライブラリ: <library name>をオープン中にエラーが発生しました。

原因:	破壊されているPL/SQLライブラリ、またはPL/SQLライブラリでないファイルかオブジェクトをオープンしようとしました。
処置:	オープンしようとしたファイルまたはオブジェクトが有効なPL/SQLライブラリを含むことを確認してください。


REP-0756:  警告: PL/SQLライブラリ: <library name>が見つかりません。

原因:	存在しないPL/SQLライブラリを連結しようとしたか、またはレポートをオープンしようとしましたが、連結されたPL/SQLライブラリが見つかりませんでした。
処置:	連結するファイルまたはオブジェクトが存在することを確認してください。レポートをオープンした場合、PL/SQLライブラリを再連結してください。


REP-0757:  外部ロケーション指定を作成できません。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-0758:  PL/SQLライブラリ: <library name>は使用中です。

原因:	すでに連結されている他のPL/SQLライブラリと同じ名前のPL/SQLライブラリを連結しようとしました。これは、PL/SQLライブラリを含むファイルを改名した後、Report Builderが認識する内部名を変更していなかったことが原因です。
処置:	「ファイル」 [image] 「別名保存」を使って、異なる名前でPL/SQLライブラリを保存してください。


REP-0759:  レポートが保存されてから1つ以上のPL/SQLライブラリが変更されています。PL/SQLは再コンパイルされます。

原因:	PL/SQLライブラリを参照するレポートのオープン、もしくは実行を試みました。レポートを最後に保存してからPL/SQLの一部または全体を変更しましたが、コンパイルをしていません。
処置:	処置は不要です。Report BuilderがPL/SQLを再コンパイルします。


REP-0760:  ドキュメントを印刷中です。

原因:	1つ以上のレポートを作成するために、すでに「ファイル」 [image] 「管理」 [image] 「Reportsに関するレポート」を選択しています。
処置:	レポート上で現行のレポートを作成する操作を終了した後、他のレポートを実行するには「ファイル」 [image] 「管理」 [image] 「Reportsに関するレポート」を再度選択してください。


REP-0761:  レポートの印刷のための資源をオープンできません。

原因:	Report Builderが、レポートをドキュメント化するレポート（Report Builderに付属）を見つけられません。
処置:	レポートをドキュメント化するレポート（Report Builderに付属）が適切なディレクトリにあることを確認してください。


REP 0762. Interofficeログイン・ユーザーIDが無効です。
REP-0762:  Interofficeログイン・ユーザーIDが無効です。

原因:	Interofficeリポジトリにレポート出力を保存しようとしましたが、Interofficeドキュメント・サーバーに対する有効な接続文字列を指定しませんでした。
処置:	Interofficeドキュメント・サーバーに対する有効な接続文字列を指定してください。


REP 0763. Interofficeクライアント:$0の起動に失敗しました。
REP-0763:  Interofficeクライアント:$0の起動に失敗しました。

原因:	Interofficeクライアントを起動しようとしましたが、何らかの原因で実行に失敗しました。
処置:	Interofficeクライアントが適切にインストールされていることを確認してください。


REP 0764. Interofficeクライアントの実行中にエラーが起こりました。エラー・コードは$0です。
REP-0764:  Interofficeクライアントの実行中にエラーが起こりました。エラー・コードは$0です。

原因:	Interofficeクライアントを実行してドキュメントをリポジトリにチェックインしようとしましたが前述のエラー・コードに示される原因により失敗しました。
処置:	失敗の理由は、Interofficeエラー・コード（メッセージ）をチェックしてください。


REP-769:  ライブ・プレビューアがオープンされている場合はパラメータ・フォームからメールを実行できません。
REP-0769:  ライブ・プレビューアがオープンされている場合はパラメータ・フォームからメールを実行できません。

原因:	ライブ・プレビューアがオープン中で、宛先タイプ（DESTYPE）がMailに設定されています。
処置:	ランタイム・パラメータ・フォームではなく、ライブ・プレビューアから直接メールを送信してください。


REP-0770:  BEFORE FORMトリガーに失敗しました。

原因:	レポートのBefore FormトリガーがFALSEを戻しました。
処置:	トリガーがTRUEを戻すように、適切な変更を（Before FormトリガーのPL/SQLソースまたはレポートに）行ってください。


REP-0771:  AFTER FORMトリガーに失敗しました。

原因:	レポートのAfter FormトリガーがFALSEを戻しました。
処置:	トリガーがTRUEを戻すように、適切な変更を（After FormトリガーのPL/SQLソースまたはレポートに）行ってください。


REP-0772:  パラメータ・フォーム・フィールド:<fieldname1>および<filedname2>のソースは同じであってはなりません。

原因:	2つのパラメータ・フォーム・フィールドに同じソースを指定しました。ランタイム・パラメータ・フォームのフィールドは他と重複しないようにしてください。
処置:	フィールドのうち1つのソースを変更してください。


REP-0773:  パラメータ・フォーム・フィールド: <fieldname>にソースが指定されていません。

原因:	パラメータ・フォーム・フィールドにソースを指定しなかったか、ソース・パラメータがデータ・モデルから削除されていました。ランタイム・パラメータ・フォームのフィールドにはソースが必要です。
処置:	パラメータ・フォーム・フィールドに有効なソースを指定してください。


REP-0774:  警告:  値リスト・パラメータ: <parameter name>として選択できる値がありません。

原因:	値リスト・パラメータの選択リストに値を指定しなかったか、選択できない値を指定しました。
処置:	SELECT文またはパラメータの選択可能な値リストをチェックして、指定した値が選択可能であることを確認してください。値リスト・パラメータの詳細は、「パラメータ・プロパティ」を参照してください。


REP-0775:  警告: SELECT文の最初の列のデータ型は、値リスト・パラメータ: <parameter name>のデータ型と合っていません。

原因:	SELECT文で指定した第1列のデータ型が、値リスト・パラメータに指定したデータ型と一致していません。
処置:	値リスト・パラメータ、SELECT文およびSELECT文によってアクセスされるデータベースの表の列のデータ型をチェックして、それらが一致することを確認してください。


REP-0776:  警告: 値リスト・パラメータ: <parameter name>をセットする時、値がセグメント化されたメモリーに格納された列が見つかりました。これらの列は無視されます。

原因:	値リスト・パラメータの選択リストのために、セグメント・メモリー内に値のある列を選択しました。この処理は、許可されていません。
処置:	他の列を選択するか、列値を移動してください。


REP-0777:  警告: 値リスト・パラメータ: <parameter name>をセットする時、処理できないデータ型の列が見つかりました。これらの列は無視されます。

原因:	取り扱えないデータ型の列を選択しました（たとえばバイナリ・データ）。
処置:	別の列を選択してください。


REP-0778:  警告: 値リストのパラメータ: <parameter name>をセットする時、指定の書式にできない列がありました。この列は無視されます。

原因:	パラメータの値リストの値を選択するSELECT文が、データ型に従ってフォーマットできない値を持つ列を取り出しました。
処置:	値を有効な値に変換するか、データベースをチェックして列の値が有効かどうかを確認してください。


REP-0779:  警告: 値リストのパラメータ: <parameter name>の項目で値が長すぎるものがあります。これらの項目は切り捨てられます。

原因:	指定した項目または選択した列に含まれる値に、値リスト・パラメータの選択リストに含めるには長すぎるものがあります。
処置:	項目の値をチェックして、必要ならばその長さを短くしてください。


REP-0780:  入力した初期値は、入力マスク: <input mask>に対して無効です。

原因:	「初期値」に入力した値が「入力マスク」フィールドに指定したマスクと一致しません。
処置:	「初期値」に異なる値を入力するか、「入力マスク」のマスクを変更する必要があります。


REP-0781:  バインド変数は、SELECT文で使用できません。

原因:	SELECT文にバインド変数を含めました。
処置:	SELECT文からバインド変数を削除してください。


REP-0782:  パラメータのデータ型が、ソース列のデータ型に一致しません。

原因:	値リスト・パラメータの選択リストに値を入れるためのデータ型が無効です。
処置:	列のデータ型を変更するか、異なる列を指定してください。


REP-0783:  取り得る値のリストに不正な構文があります。

原因:	値リスト・パラメータで使用可能な値リストを作成するとき、誤った構文を使用しました。
処置:	使用可能な値リストを編集して、正しくコンマで区切ってください。


REP-0784:  取り得る値の中で無効な幅を持つものがあります。

原因:	値リスト・パラメータのリストに指定した値の幅が無効です。
処置:	使用可能な値がすべて有効な幅を持つように使用可能な値リストを編集するか、幅を変更してください。


REP-0785:  取り得る値の中で入力マスクに対して無効なものがあります。

原因:	値リスト・パラメータのリストに指定した値が、指定した入力マスクに従ってフォーマットされていません。
処置:	使用可能な値がすべて入力マスクに対して有効になるように、使用可能な値リストを編集してください。


REP-0786:  初期値が取り得る値の中に含まれていません。

原因:	値リスト・パラメータに指定した初期値が、定義済みの使用可能な値リストにありません。
処置:	指定した初期値を使用可能な値リストに追加してください。


REP-0787:  警告: 値リストのパラメータ: $0のSELECT文の最初の列名が、設計時と実行時で異なっています。

原因:	元のSELECT文で指定した列と、現在対象になっている表に入っている値が一致していません。
処置:	データベースをチェックして、パラメータ・リストの作成後に問題の表が更新されているかどうかを判別してください。または値リスト・パラメータのSELECT文を再適用してください。


REP-0788:  警告: 制限付き値リストのパラメータ: <parameter name>の値が選択可能な値の中に含まれていません。

原因:	パラメータの選択リストにない値リスト・パラメータの値を指定しました。
処置:	パラメータの選択リストから値を選択してください。


REP-0790: ページの幅および高さは、両方指定するか両方ブランクでなければなりません。
• REP-0790:  ページの幅および高さは、両方指定するか両方ブランクでなければなりません。

原因:	「環境設定」ダイアログ・ボックスの「ランタイム設定」タブの「ページ幅」または「ページ高さ」にブランク値を指定しました。両方の設定が有効値を含むか、ブランクにする必要があります。
処置:	ブランク設定に有効な値を指定するか、両方の設定をブランクにしてください。


REP-0800:  すべてを選択できるのは、テキスト入力フィールドのみです。

原因:	テキスト・フィールド以外のプロパティ・パレットの要素にカーソルを置いたまま、「編集」 [image] 「すべて選択」を選択しました。
処置:	プロパティ・パレットでは、「編集」 [image] 「すべて選択」はテキスト・フィールドのみで有効です。


REP-0801:  レイアウト・キャンバスには、レイアウト・オブジェクトに合うサイズが必要です。

原因:	「レポート」プロパティ・パレットの1つ以上の設定を変更するか、またはマージンのサイズを変更して、レイアウト・モデル・エディタのペイント領域のサイズを小さくしました。この結果、サイズ変更後のペイント領域にすべてのレイアウト・オブジェクトを収めることができません。
処置:	レポートのボディ、マージン、ヘッダーおよびトレーラの各セクションにあるすべてのレイアウト・オブジェクトが、サイズを変更したペイント領域に収まるようにしてください。


REP-0802:  パラメータ・フォーム・キャンバスには、パラメータ・フォーム・キャンバスに合うサイズが必要です。

原因:	「レポート」プロパティ・パレットの1つ以上の設定を変更して、パラメータ・フォーム・エディタのペイント領域のサイズを小さくしました。この結果、サイズ変更後のペイント領域にすべてのパラメータ・フォーム・オブジェクトを収めることができません。
処置:	すべてのパラメータ・フォーム・オブジェクトが、サイズを変更したペイント領域に収まるようにしてください。


REP-0803:  指定したキャンバスのサイズは大きすぎます。

原因:	レポートの内容が、ページ/フォーム・サイズに加えて、論理ページまたは最大ボディ・ページ、最大ヘッダー・ページ、最大フッター・ページ、パラメータ・フォーム・ページ数のいずれかを組み合せた設定値になっており、結果的に全体の値はReport Builderがサポートする値を超えています（dpi値が2GBを超えています）。
処置:	ページ/フォーム・サイズを小さくするか、論理ページ・サイズまたは最大ボディ・ページ、最大ヘッダー・ページ、最大フッター・ページ、パラメータ・フォーム・ページ数を減らしてください。


REP-0804: レポート定義が、実行中に変更されました。パラメータ・フォームまたはレポートの実行を続行できません。
REP-0804:  実行中に、レポート定義が変更されました。パラメータ・フォームまたはレポートの実行を続行できません。

原因:	ランタイム・パラメータ・フォームで、エディタまたはプロパティ・パレットを使ってレポートを変更しました。
処置:	ランタイム・パラメータ・フォームを取り消し、レポートを再実行してください。


REP-0805:  メニューを初期化できませんでした。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-0806:  ウィンドウ・リソースの読込みでエラーが発生しました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-0807:  配列サイズを入力してください。

原因:	「環境設定」ダイアログ・ボックスの「ランタイム設定」タグで、「配列サイズ」フィールドをブランクにしたままでした。「配列サイズ」には値を入力する必要があります。
処置:	「配列サイズ」に1～9999の値を入力してください。


REP-0808:  バッファ・サイズを入力してください。

原因:	「環境設定」ダイアログ・ボックスの「ランタイム設定」タブで、「バッファ」フィールドをブランクにしたままでした。「バッファ」には値を入力する必要があります。
処置:	「バッファ」に1～9999の値を入力してください。


REP-0809:  チャンク長サイズを入力してください。

原因:	「環境設定」ダイアログ・ボックスの「ランタイム設定」タブで、「チャンク長」フィールドをブランクにしたままでした。「チャンク長」には値を入力する必要があります。
処置:	「チャンク長」に1～9999の値を入力してください。


REP-0810:  有効なオプションは「操作なし」、「ロールバック」または「コミット」です。

原因:	「環境設定」ダイアログ・ボックスの「ランタイム設定」タグで、「成功時/失敗時」に選択した値が無効です。有効な値は、操作なし、ロールバック、コミットです。
処置:	「成功時/失敗時」に有効な値を選択してください。


REP-0811:  有効なオプションは「<In Report Definition>」、「Screen」、「File」、「Printer」または「Mail」です。

原因:	「環境設定」ダイアログ・ボックスの「ランタイム値」タグで、「宛先タイプ」に選択した値が無効です。有効な値は、'<In Report Definition>'、'Screen'、'File'、'Printer'または'Mail'です。
処置:	「宛先タイプ」に有効な値を選択してください。


REP-0812:  有効なオプションは「<In Report Definition>」、「Landscape」または「Portrait」です。

原因:	「環境設定」ダイアログ・ボックスの「ランタイム値」タグで、「印刷方向」に選択した値が無効です。有効な値は、<In Report Definition>、LandscapeまたはPortraitです。
処置:	「印刷方向」に有効な値を選択してください。


REP-0813:   有効なオプションは「<In Report Definition>」、「Default」、「Bitmap」または「Character」です。

原因:	「環境設定」ダイアログ・ボックスの「ランタイム設定」タグで、「モード」に選択した値が無効です。有効な値は、<In Report Definition>、Default、BitmapまたはCharacterです。
処置:	「MODE」に有効な値を選択してください。


REP-0814:  有効なオプションは「<In Report Definition>」、「Yes」または「No」です。

原因:	「環境設定」ダイアログ・ボックスの「ランタイム値」タグで、「BACKGROUND」に選択した値が無効です。有効な値は、<In Report Definition>、YesまたはNoです。
処置:	「BACKGROUND」に有効な値を選択してください。


REP-0815:  有効なオプションは「Landscape」または「Portrait」です。

原因:	キャラクタ・モードのランタイム・パラメータ・フォームで、「印刷方向」に選択した値が無効です。有効な値は、LandscapeまたはPortraitです。
処置:	「印刷方向」に有効な値を選択してください。


REP-0816:  有効なオプションは「Bitmap」または「Character」です。

原因:	キャラクタ・モードのランタイム・パラメータ・フォームで、「MODE」に選択した値が無効です。有効な値は、BitmapまたはCharacterです。
処置:	「MODE」に有効な値を選択してください。


REP-0817:  有効なオプションは「Yes」または「No」です。

原因:	キャラクタ・モードのランタイム・パラメータ・フォームで、「BACKGROUND」に選択した値が無効です。有効な値は、YesまたはNoです。
処置:	「BACKGROUND」に有効な値を選択してください。


REP-0818:  警告: ページの高さはパラメータ・フォーム用に変更されました。パラメータはページ境界を超えているかもしれません。

原因:	「レポート」プロパティ・パレットのランタイム・パラメータ・フォームの高さを変更しました。Report Builderは、この変更によって境界が移動し、パラメータ・フォームでページ境界がオブジェクトの中央に表示される可能性があることを通知します。
処置:	パラメータ・フォーム・エディタからパラメータ・フォームのレイアウトを表示して、ページ境界（エディタ内の色の濃い線）にかかっているオブジェクトがないことを確認してください。あるいは、パラメータ・フォームをデフォルトに設定することもできます。


REP-0819:  SQLサーバー接続でAUTOCOMMITをONに設定できませんでした。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。SRW.DO_SQLのインスタンスをすべて削除してください。レポート内の必要な機能をすべて維持したままこの操作を実行できる場合は、レポートが実行されます。


REP-0820:  指定イメージをインポートできません。

原因:	インポートしようとしているイメージをインポートできません。
処置:	イメージ・ファイルをチェックして、それが有効なイメージであり、壊れていないことを確認してください。


REP-0821:  指定イメージをエクスポートできません。

原因:	イメージとしてエクスポートしようとしているオブジェクトを、イメージとしてエクスポートできません。
処置:	エクスポートするイメージを作成または選択してください。


REP-0822:  線画はインポートされていません。

原因:	インポートしようとしている線画をインポートできません。
処置:	ファイルをチェックして、それが有効な線画であり、壊れていないことを確認してください。


REP-0823:  線画はエクスポートされていません。

原因:	線画としてエクスポートしようとしているオブジェクトを、線画としてエクスポートできません。
処置:	エクスポートする線画を作成または選択してください。


REP-0824:  接続しているデータベースのデータ・ディクショナリは使用できません。表/列情報を取り出せません。

原因:	接続しているデータベースではデータ・ディクショナリが使用できません。
処置:	サポートされているデータベースに接続してください。


REP-0825:  接続されているデータベースはORACLEまたはDB2ではありません。Reportsに関するレポートを格納するためには使用できません

原因:	OracleでもDB2でもないデータベースに文書を格納しようとしています。この処理は、許可されていません。
処置:	OracleまたはDB2データベースのどちらかに接続するか、ファイルとして文書を格納してください。


REP-0828:  データベースにReport Builder表がインストールされていません。Reportsに関するレポートを取り消しています。

原因:	Report Builder表がデータベースにないため、「レポート文書」を実行できません。
処置:	データベース管理者に、Report Builder表がデータベースに正しくインストールされていないことを連絡してください。


REP-0829:  Report Builderデータベース表は、古いバージョンのReport Builder （<Version>）から用いられています。Reportsに関するレポートを取り消しています。

原因:	データベースのReport Builder表が旧バージョンの製品からインストールされたようです。「レポート文書」は旧バージョンのデータベース表に対して実行できません。
処置:	データベース管理者に、このバージョンのReport Builder表がデータベースに正常にインストールされていないことを知らせてください。


REP-0830:  Report Builderデータベース表が壊れているか、正しくインストールされていないようです。Reportsに関するレポートを取り消しています。

原因:	Report Builder表が不安定な状態にあるため、「レポート文書」を実行できません。
処置:	データベース管理者に、Report Builder表が壊れているかデータベースに正常にインストールされていないことを知らせてください。


REP-0831:  問合せを作成できませんでした。

原因:	Report Builderに対して、起動時に問合せを作成するように要求しましたが、失敗しました。作成された問合せに対するデータベース・アカウントが正しくないことが原因の1つです。それ以外の場合は、異常な状態です。
処置:	Report Builderが他の製品から起動された場合、その製品のデータベース接続文字列が正しいことをチェックしてください。異常な状態の詳細は、「異常な状態」を参照してください。


REP-0900: PL/SQLの実行中は、このレポートはクローズできません。
• REP-0900:  PL/SQLの実行中は、このレポートはクローズできません。

原因:	関係付けられたPL/SQLの実行中に、レポートをクローズしようとしました。
処置:	PL/SQLの実行を終了するか中止してから、レポートをクローズしてください。


REP-0901:  表/列機能は、このデータベース・サーバーではサポートされていません。

原因:	表と列をリストするためのアクセス可能なデータ・ディクショナリを持たないデータベース・サーバーに接続されています。
処置:	なし。表と列の機能は、これらのデータベースでは使用できません。


REP-0910:  キュー・カードは見つかりません。キュー・カードを再インストールし、再試行してください。

原因:	キュー・カードを実行しようとしましたが、正しくインストールされていませんでした。
処置:	キュー・カードを再インストールしてください。


REP-0911:  クイック・ツアーは見つかりません。クイック・ツアーを再インストールし、再試行してください。

原因:	クイック・ツアーを実行しようとしましたが、正しくインストールされていませんでした。
処置:	クイック・ツアーを再インストールしてください。


REP-0999:  非実行エラー:

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1010:  この名前は、SQL命名規則に従っていません。

原因:	入力した名前が、1つ以上のSQL命名規則に違反しています。
処置:	命名しようとしているオブジェクトの命名規則をチェックしてください。詳細は、「命名規則」を参照してください。規則に従った名前を入力してください。


REP-1011:  <object type>に名前を指定してください。

原因:	オブジェクトの「名前」フィールドがブランクのままなので、名前を入力する必要があります。
処置:	適切な命名規則に従って、オブジェクトに名前を付けてください。詳細は、「命名規則」を参照してください。


REP-1012:  この名前を持つ別の<object type>があります。

原因:	入力した名前が、同一タイプの他のオブジェクトの名前と重複しています。
処置:	少なくともどちらか一方のオブジェクトの名前を変更してください。


REP-1013:  この名前は予約語と同じにしないでください。

原因:	パラメータに、予約語と重複する名前を入力しました。
処置:	パラメータの名前を、パラメータ命名規則に従ったものに変更してください。詳細は、「命名規則」を参照してください。


REP-1014:  名前の長さは30バイトを超えてはいけません。

原因:	入力された名前が、30バイトを超えました。有効なSQL名は、30バイトを超えることはできません。
処置:	名前のサイズを30バイト以下に減らしてください。


REP-1048:  警告: 所有者およびアクセス・リストは上書きできません。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1049:  新しいバージョンのReport Builderで保存したレポートがオープンできません。

原因:	レポートが保存されたバージョンより古いバージョンのReport Builderで、レポートをオープンしようとしました。
処置:	レポートの保存に使ったものと同じバージョン、またはそれよりも新しいバージョンのReport Builderを使って、レポートをオープンしてください。


REP-1050:  データベース上のモジュール名にアクセスできません。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1051:  モジュールをファイル: <filename>に保存できません。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1052:  モジュールをデータベースに保存できません。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1053:  データベースから新しいモジュールIDを取得できません。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1054:  表: <table name>から削除できません。

原因:	表から削除しようとして、失敗しました。必要な権限を持っていない可能性があります。
処置:	必要な権限を持っていることを確認してください。必要な権限を持っていない場合は、DBAに連絡するか、実行に必要な権限を持っている人に操作を依頼してください。


REP-1055:  表: <table name>をロックできません。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1056:  データベースに保存されているオブジェクトの名前を変更できません。

原因:	データベース・オブジェクトを改名しようとしましたが、失敗しました。必要な権限を持っていない可能性があります。改名するには、改名するオブジェクトを所有している必要があります。
処置:	そのオブジェクトを所有していない場合は、そのオブジェクトのコピーを作るか、所有者に名前の変更を依頼してください。


REP-1057:  <filename>は有効なReport Builderファイルではありません。

原因:	Report Builderの正しい形式ではないファイルにアクセスしようとしました。
処置:	正しいファイルにアクセスしていることを確認してください。


REP-1058:  データベースからモジュールを読み込めません。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1059:  ファイル: <filename>からモジュールを読み込めません。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1060:  Report Builderデータベース表がインストールされていません。

原因:	Report Builderが、現行のデータベースのSRW2_MODELEビューへのアクセスに失敗しました。
処置:	Report Builderが、データベースに正しくインストールされているかどうかをチェックします。不明な点は、システム管理者に問い合せてください。


REP-1061:  外部ファイル: <filename>を読み込めません。

原因:	「ファイルからの読込み」をアクティブにして、列の値にファイル名を指定しましたが、Report Builderは指定ファイルのオープンまたは読込みができませんでした。
処置:	「列」プロパティ・パレットで指定ファイル名のスペルをチェックして、指定ファイルが存在するかどうかをチェックしてください。ファイルが存在する場合は、ファイルに対する権限をチェックして、少なくとも読込みアクセス権限を持っていることを確認してください。


REP-1062:  外部問合せ: <filename>が見つかりません。

原因:	このエラーの原因として、次のことが考えられます。
	ケース1:	REPORTS60_PATHが設定されていません。
	ケース2:	データベースに接続されていません。
	ケース3:	指定された外部問合せが存在しません。
処置:	このエラーの訂正には、次の処置を行ってください。
	ケース1の場合:	REPORTS60_PATHを有効な値に設定してください。
	ケース2の場合:	データベースに接続します。
	ケース3の場合:	正しい名前の外部問合せを指定していることを確認してください。


REP-1063:  PL/SQL: <program unit name>がプラットフォーム固有のサイズを超えています。

原因:	PL/SQLが、使用しているオペレーティング・システムには大きすぎるために、ロードできませんでした。このプログラム単位は、制限値が大きい別のプラットフォームで作成された可能性があります。
処置:	PL/SQLのサイズを小さくして、ユーザーのプラットフォームでロードできるようにしてください。


REP-1064:  モジュール<document name>を読み込めません。

原因:	モジュールをオープンしようとしましたが、データベースまたはファイル・システムに格納されている定義が失われているか、破壊されています。
処置:	このモジュールは使用できません。


REP-1065:  外部問合せ: <file name>は読み込めませんでした。

原因:	外部問合せを読み込もうとしましたが、データベースまたはファイル・システムに格納されている定義が失われているか、破壊されています。
処置:	この外部問合せは使用できません。


REP-1066:  警告: コメントは壊れています。コメントは失われます。

原因:	格納エラーが発生したため、コメントが壊れました。このコメントは、廃棄されます。
処置:	処置は不要です。必要があれば、コメントを作成し直してください。


REP-1067:  レポートの情報が不足しています。

原因:	レポート定義が不完全なために、レポートをオープンできません。このレポートは、壊れている可能性があります。
処置:	レポートがデータベースに格納されている場合は、SQL*Plusを使って、Report Builder表が壊れているかどうかを判断してください。レポートが.rdfファイルの場合は、ファイル・システム・ユーティリティを使って、そのファイルが壊れているかどうかをチェックしてください。適切な処置でデータを回復してください。


REP-1070: モジュールのオープンまたは保存中にエラーが発生しました。
• REP-1070:  モジュールのオープンまたは保存中にエラーが発生しました。

原因:	モジュールのオープンまたは保存中に、エラーが発生しました。
処置:	モジュールに対する適切なアクセス権限を持っていることをチェックしてください。


REP-1071:  オブジェクト/レコードの終わりに達しました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1072:  オブジェクトが見つかりません。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1073:  予期しないオブジェクトが見つかりました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1074:  オブジェクトは大きすぎます。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1075:  オブジェクトは無効です。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1076:  指定されたオブジェクトの格納場所が無効です。

原因:	無効なファイルまたはデータベース・オブジェクトを使おうとしました。
処置:	指定したオブジェクトが、ファイルまたはデータベースに格納されている有効なモジュールであることを確認してください。


REP-1077:  オブジェクトに指定されているデータ型は無効です。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1078:  特定できないファイル・エラーが発生しました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1079:  ファンクションがサポートされていません。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1080:  一意キーの制約違反があります。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1081:  ページが分割されました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1082:  クローズ・エラーです。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1083:  ファイル・バージョン・エラーです。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1084:  ファイル・ヘッダーは無効です。

原因:	Report Builderによるファイルのオープンを必要とする操作を実行しました。オープンするファイルにヘッダーがないか、あるいは期待したヘッダーがありません。ヘッダーがエディタで変更されてしまっているか、ファイルにこのリリースのReport Builderとの互換性がない可能性があります。
処置:	ヘッダーはエディタで修正できますが、一般にReport Builderファイルをこの方法で編集することはお薦めできません。ファイルにこのリリースのReport Builderとの互換性がない場合は、ファイルを移行する必要があります。


REP-1085:  ファイル作成エラーです。

原因:	Report Builderによるファイルの作成を必要とする操作を実行しようとして、エラーが発生しました。ファイル作成に必要なファイル権限を持っていない可能性があります。
処置:	必要な権限を取得してください。


REP-1086:  読込み専用ファイルのオープン・エラーです。

原因:	Report Builderによるファイルのオープンを必要とする操作を実行しようとしましたが、そのファイルにアクセスできませんでした。ファイルのオープンに必要なファイル権限を持っていない可能性があります。
処置:	ファイルに対する必要な権限を取得するか、必要な権限を持っているファイルにアクセスしてください。


REP-1087:  ファイルのオープン・エラーです。

原因:	Report Builderによるファイルのオープンを必要とする操作を実行しようとしましたが、そのファイルにアクセスできませんでした。ファイルのオープンに必要なファイル権限を持っていない可能性があります。
処置:	ファイルに対する必要な権限を取得するか、必要な権限を持っているファイルにアクセスしてください。


REP-1088:  ファイル書込みエラーです。

原因:	Report Builderによるファイルの書込みを必要とする操作を実行しようとしましたが、そのファイルにアクセスできませんでした。ファイルの書込み必要なファイル権限を持っていない可能性があります。
処置:	ファイルに対する必要な権限を取得するか、書込み権限を持っているファイルにアクセスしてください。


REP-1089:  ファイル読込みエラーです。

原因:	Report Builderによるファイルの読込みを必要とする操作を実行しようとしましたが、そのファイルにアクセス権限できませんでした。ファイルの読込みに必要なファイル権限を持っていない可能性があります。
処置:	ファイルに対する必要な権限を取得するか、読込み権限を持っているファイルにアクセスしてください。


REP-1090:  ファイル・クローズ・エラーです。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1091:  ディスクまたはファイル・システムがいっぱいです。

原因:	オブジェクトを保存しようとしましたが、保存するのに十分な領域がありませんでした。
処置:	不要なファイルを削除するか、記憶領域を拡張してください。


REP-1092:  ファイル一意キー制約に違反します。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1093:  割当てに失敗しました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1094:  再割当てに失敗しました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1095:  解放に失敗しました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1096:  <document type>は、現在ロックされています。

原因:	他のユーザーによってすでにオープンされている（ロックされている）モジュールをオープンしようとしました。
処置:	他のユーザーがそのモジュールをクローズするのを待ってアクセスしてください。


REP-1097:  PRODUCT_USER_PROFILEまたはSYSTEM.PRODUCT_PROFILEがありません。

原因:	このエラーの原因として、次のことが考えられます。
	ケース1:	この表が存在しません。
	ケース2:	この表のアクセスに必要な権限がありません。
処置:	このエラーの訂正には、次の処置を行ってください。
	ケース1の場合:	この表が作成されていない場合は、作成してください。
	ケース2の場合:	PRODUCT_USER_PROFILE表にこの表のパブリック・シノニムを作成するか、PRODUCT_USER_PROFILE表を通じてこの表を公開することによって、表にアクセスできるようにしてください。


REP-1098:  PRODUCT_USER_PROFILEまたはSYSTEM.PRODUCT_PROFILEデータの読込み中にエラーが発生しました。

原因:	この表が正しく作成されていません。
処置:	この表が適切な列で作成されていることを確認してください。適切な列で作成されていない場合は、必要に応じて変更してください。


REP-1099:  Report Builderで作成されていないファイルはオープンできません。

原因:	Report Builderレポートではないファイルをオープンしようとしました。
処置:	オープンしようとしているファイルが、Report Builderレポートであることを確認してください。


REP-1100:  ユーザーのデータ・モデルは、このレポートのタイプには無効です。
• REP-1100:  ユーザーのデータ・モデルは、このレポートのタイプには無効です。

原因:	データ・モデルに合わないレイアウト・スタイルでデフォルト・レイアウトを作成しようとしました。
処置:	選択したレイアウト・スタイルに合うようにデータ・モデルを変更するか、データ・モデルに合った別のレイアウト・スタイルを選択してください。


REP-1101:  グループ: <group name>の繰返し方向は無効です。

原因:	デフォルト・レイアウトを作成しようとしましたが、選択したレイアウト・スタイルがグループの1つに対して別の繰返し方向を要求しています。レイアウト・スタイルの中には、グループについて選択できる繰返し方向に制限のあるものがあります。
処置:	レイアウト・スタイル要件に合うように繰返し方向を変更するか、別のレイアウト・スタイルを選択してください。


REP-1102:  デフォルト・レイアウトをページ（サイズ: <number>）に合わせられません。

原因:	Report Builderが、選択されたデフォルト・レイアウトを作成しようとしましたが、ページ幅が十分ではないためレイアウト全体を収めることができませんでした。
処置:	できれば、「レポート」プロパティ・パレットの「幅」を増やすか、レイアウトがページに収まるようにオブジェクトを再配置してください。あるいは、レポートをマルチ・ページ幅に変更してください。


REP-1103:  グループ: <group name>には列が選択されていません。

原因:	デフォルト・レイアウト作成時に、選択したグループに列を選択しませんでした。その結果、レイアウトに値がないために、Report Builderはデフォルト・レイアウトを作成できません。
処置:	レポート・ウィザードで、選択したグループそれぞれから、少なくとも1つの列を選択してください。


REP-1104:  ページ・レベル・サマリーは、デフォルトではサポートされていません。

原因:	デフォルト・レイアウトを作成しましたが、所定の領域内に収まりませんでした。このエラーの原因として、次のことが考えられます。
	ケース1:	作成したレイアウトが大きすぎて、「レポート」プロパティ・パレットで指定されたサイズに収まりません。
	ケース2:	レイアウト・モデル・エディタでマークされている領域のサイズに対して、レイアウトが大きすぎます。
処置:	このエラーの訂正には、次の処置を行ってください。
	ケース1の場合:	レイアウトが収まるようにレポート・サイズを大きくするか、現行のサイズに収まるようにレイアウトを変更してください。
	ケース2の場合:	マークされた領域のサイズを増やしてください。


REP-1106:  警告: 列: <column name>にはフィールドが生成されていません。

原因:	レイアウトをデフォルトに設定したときに、このメッセージで指定されている列にフィールドが作成されませんでした。おそらく、集計がデータ・モデルに正しく置かれていないことが原因です。たとえば、集計列のソースに、その集計グループの上のグループの列を指定したことが原因に考えられます。この処理は、許可されていません。
処置:	データ・モデルをデバッグしてから、レイアウトをデフォルトに設定し直してください。


REP-1107:  クロス積グループ: <group name>でacrossまたはdownグループが見つかりません。

原因:	レポート・ウィザードで「マトリックス」スタイルを選択してデフォルト・レイアウトを作成しようとしましたが、クロス積グループのすべてのグループに「縦」または「横」の繰返し方向が割り当てられました。クロス積のグループには、両方の繰返し方向が割り当てられている必要があります。
処置:	レポート・ウィザードを再表示して、グループに両方の繰返し方向が割り当てられるように注意しながら、グループの繰返し方向を割り当て直してください。


REP-1108:  ページ境界まで拡張しても、デフォルト・レイアウトに合いません。

原因:	レイアウトをデフォルトに設定しようとしましたが、現行の設定を使って作成すると、レポート・ページの定義された高さと幅には収まらなくなります。
処置:	レポート・ウィザードに戻ってデフォルト設定値を小さくしてください（たとえば、いくつかのフィールドの幅を短くしてください）。あるいは、「レポート」・プロパティ・パレットを使ってレポート・ページのサイズを大きくしてから、レイアウトをデフォルトに設定し直してください。必要に応じて調整を続けてください。


REP-1109:  単一グループ・レイアウト・スタイルは、複数のグループを選択できません。

原因:	単一グループ用のデフォルト設定スタイルを選択しているのに、デフォルト設定するグループを複数選択しました。
処置:	単一グループのみが選択されるように、グループ選択を変更してください。または、レイアウト・スタイル選択を複数グループをサポートするスタイルに変更してください。


REP-1110:  クロス積グループ: <group name>中にマトリックスの横軸グループがありません。

原因:	レポート・ウィザードで「マトリックス」スタイルまたは「グループのマトリックス」スタイルを選択してデフォルト・レイアウトを作成しようとしましたが、クロス積グループのすべてのグループに「縦」の繰返し方向が割り当てられました。
処置:	少なくとも1つずつの「横」グループと「縦」グループができるように、クロス積グループの1つの繰返し方向を変更してください。


REP-1111:  クロス積グループ: <group name>中にマトリックスの縦軸グループがありません。

原因:	レポート・ウィザードで「マトリックス」スタイルまたは「グループのマトリックス」スタイルを選択してデフォルト・レイアウトを作成しようとしましたが、クロス積グループのすべてのグループに「横」の繰返し方向が割り当てられました。
処置:	少なくとも1つずつの「縦」グループと「横」グループができるように、クロス積グループの1つの繰返し方向を変更してください。


REP-1112:  マトリックス・レポートにマトリックス・クロス積グループがありません。

原因:	レポート・ウィザードで「マトリックス」スタイルまたは「グループのマトリックス」スタイルを選択してデフォルト・レイアウトを作成しようとしましたが、クロス積グループはマトリックス・グループとして使用するように選択されていませんでした。
処置:	クロス積グループの1つの繰返し方向を「マトリックス」に変更してください。


REP-1113:  グループまたはレポート・レベル列が選択されていません。

原因:	デフォルト・レイアウト作成時に、グループあるいはレポート・レベル列を選択しませんでした。その結果、レイアウトに値がないために、Report Builderはデフォルト・レイアウトを作成できません。
処置:	レポート・ウィザードで、デフォルトに設定するレポート・レベル列あるいはグループを少なくとも1つ選択してください。


REP-1114:  複数グループ・レイアウト・スタイルは、複数のグループを選択する必要があります。

原因:	マルチ・グループ用のデフォルト設定スタイルを選択しているのに、デフォルト設定するグループを1つしか選択していません。
処置:	複数のグループが選択されるように、グループ選択を変更してください。または、レイアウト・スタイル選択を、シングル・グループをサポートするスタイルに変更してください。


REP-1115:  テンプレート・レイアウトがページに収まらないので、レイアウト全体を表示できません。

原因:	テンプレート・レイアウトが、レポート・ページの定義された高さと幅に収まりきらないために、正しく表示できませんでした。レイアウトを表示できないということは、テンプレートが誤っているということではありません。
処置:	テンプレート・レイアウトを表示するために、レポート・ページの幅と高さを一時的に拡張できます。これには、オブジェクト・ナビゲータでテンプレートを選択し、プロパティ・パレットをオープンしてください。「レポート」ノードで「幅」と「高さ」のプロパティを大きくしてください。テンプレートを保存する前に、忘れずに幅と高さのプロパティを戻してください。


REP-1200:  コンパイルが失敗しました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1201:  問合せ: <query name>に問合せテキストがありません。

原因:	問合せに名前を付けて確定しようとしましたが、その問合せにSELECT文を1つも入力しなかったか、あるいはキーワードSELECTで始まらない文を入力しました。「SQL問合せ文」ダイアログは、SQL SELECT文しか確定しません。
処置:	SELECT（大/小文字のどちらでも使用できます）で始まるSQL SELECT文を入力してください。「SQL問合せ文」ダイアログでは、他のSQL文は確定されません。


REP-1202:  Oracleログオンが指定されていません。

原因:	ORACLEログオンを指定しないで、レポートを実行しようとしました。
処置:	「接続」ダイアログ・ボックスにログイン文字列を入力して、レポートを再実行する前にそのダイアログ・ボックスを確定してください。


REP-1203:  フィールド: <field name>は無効な列を参照しています。

原因:	フィールドのソースとして指定されている列が無効であるか、あるいは存在しません。
処置:	値リストから列を選択してください。


REP-1204:  繰返し枠: <frame name>は無効なグループを参照しています。

原因:	「繰返し枠」プロパティ・パレットの「ソース」フィールドに入力したグループ名が、無効であるか、あるいは存在しません。
処置:	値リストからグループを選択してください。


REP-1205:  位置従属関係がループしています。

原因:	オブジェクトが間接的に自身にアンカーされるような明示的なアンカーを作成しました。たとえば、オブジェクトAをオブジェクトBに、オブジェクトBをオブジェクトCに、オブジェクトCをオブジェクトAにアンカーさせると、このエラーが発生します。
処置:	ループの原因になっているアンカーを少なくとも1つ削除してください。


REP-1206:  1つのオブジェクトが複数のオブジェクトにアンカーされています。

原因:	レイアウトで、1つのオブジェクトを他の複数のオブジェクトにアンカーしました。1つのオブジェクトは他の1つのオブジェクトにしかアンカーできません。
処置:	1つのオブジェクトのみにアンカーされるように、他のオブジェクトへのアンカーを削除してください。


REP-1207:  <group name>のグループ・フィルタに関するPL/SQLプロシージャがありません。

原因:	「グループ」プロパティ・パレットの「フィルタ・タイプ」に「PL/SQL」を選択しましたが、有効なフィルタを入力しませんでした。
処置:	有効なPL/SQL関数を入力するか、フィルタ・タイプを変更してください。


REP-1208:  マトリックス: <matrix name>の繰返し枠にアンカーを付けられません。

原因:	マトリックス・オブジェクトの交差繰返しフレームから他のオブジェクトにアンカーしたままでレポートを実行しようとしました。これはできません。
処置:	アンカーを削除してください。このオブジェクトを他のオブジェクトにアンカーすることはできません。


REP-1209:  マトリックス・オブジェクト: <matrix name>はアンカーできません。

原因:	マトリックス・オブジェクトから他のオブジェクトにアンカーしたままでレポートを実行しようとしました。これはできません。
処置:	アンカーを削除してください。このオブジェクトを他のオブジェクトにアンカーすることはできません。


REP-1211:  オブジェクト: <object name1>は、その囲みオブジェクト: <object name2>の大きさを超えています。

原因:	オブジェクトが、囲みオブジェクトより大きくなっています。おそらく、大きなオブジェクトを小さい固定フレームで囲もうとしたことが原因です。
処置:	オブジェクトとその囲みオブジェクトを識別して、それらの相対的なサイズおよび位置を調整して適切な囲み方になるようにしてください。


REP-1212:  オブジェクト: <object name1>は、その囲みオブジェクト: <object name2>に完全に囲まれていません。

原因:	このエラーの原因として、次のことが考えられます。
	ケース1:	オブジェクトがぺージで完全に囲まれていません。つまり、そのオブジェクトはページ境界線を超えています。
	ケース2:	マトリックスを形成している繰返し枠は、それが囲む繰返し枠より1つ以上レイヤーが上位です。マトリックス・レイアウトでは、繰返し枠は、それが囲む方の繰返し枠より下位にある必要があります。
処置:	このエラーの訂正には、次の処置を行ってください。
	ケース1の場合:	ページ境界線を超えないように、オブジェクトを移動あるいはサイズ変更してください。あるいは、「レポート」プロパティ・パレットでページ・サイズを大きくしてください。
	ケース2の場合:	「配置」 [image] 「最背面へ移動」、「配置」 [image] 「最前面へ移動」、「配置」 [image] 「背面へ」、および「配置」 [image] 「前面へ」を使って、レイヤー関係が次のようになるように繰返し枠を配置してください。繰返し枠は、それが囲む繰返し枠の下位、縦方向繰返し枠は横方向繰返し枠の下位とします。


REP-1213:  フィールド: <field name>は、そのグループ以下の頻度で列: <column name>を参照しています。

原因:	このフィールドのソース列が入っているグループは、それを囲む繰返し枠のグループより下位にあります。
処置:	ソース・グループがフィールドのソース列が入っているグループかその上位にある繰返し枠内に、フィールドを移動してください。あるいは、可能であれば、囲む側の繰返し枠のグループ内に、フィールドのソース列を移動してください。


REP-1214:  繰返し枠: <frame name>は、子繰返し枠に囲まれています。

原因:	囲まれる側の繰返し枠のソース・グループが、囲む側の繰返し枠のソース・グループの上位にあります。
処置:	エディタで、囲まれる側の繰返し枠を、囲む側の繰返し枠にすることができます。あるいは、可能であれば、囲まれる側のオブジェクトのグループが囲む側のオブジェクトのグループより下位になるようにグループ階層を変更してください。


REP-1216:  <object name>の「印刷オブジェクト・オン」の設定が無効です。

原因:	指定したオブジェクトに、無効な「印刷オブジェクト・オン」を設定しました。たとえば、マージン・オブジェクトに「印刷オブジェクト・オン」を指定しようとしました。
処置:	オブジェクトの「印刷オブジェクト・オン」を、別の有効な設定に変更してください。


REP-1218:  <object name>「前で改ページ」と「アンカー・オブジェクトと連動」を同時に「はい」にすることはできません。

原因:	あるオブジェクトに対して、「前で改ページ」と「アンカー・オブジェクトと連動」を設定しました。しかし、アンカー・オブジェクトがそのオブジェクトの前にあるため、この2つの設定は矛盾します。
処置:	「前で改ページ」または「アンカー・オブジェクトと連動」のチェックを解除してください。


REP-1219:  <object name>にはサイズがありません-- 長さまたは幅がゼロです。

原因:	レイアウト作成の際に、幅または高さがゼロのレイアウト・オブジェクトを作成しました。
処置:	オブジェクトを拡大して、高さと幅をゼロ以外にします。


REP-1220:  <object name>の最小孤立行は、ページ当り最大行を超えています。

原因:	「ページ当りの最大レコード数」を、「最小ウィンドウ・レコード数」より小さい値に設定しました。このため、2つの設定の間に矛盾が起き、事実上どのインスタンスも印刷しないということを示しています。
処置:	「最小ウィンドウ・レコード数」を減らすか、「ページ当りの最大レコード数」を増やしてください。


REP-1222:  ボディ・サイズは無効です。

原因:	指定したボディのページ幅あるいは高さが、負数あるいは範囲外です。このエラーの原因はおそらく、PAGESIZE実行引数を使ってページ・サイズを無効な値に設定したことです。
処置:	PAGESIZE実行引数を使って有効な値を入力するか、レイアウト・モデル・エディタでマージンのサイズを変更してボディのパネル・サイズを調整してください。


REP-1223:  ページ・サイズは無効です。

原因:	指定した物理ページの幅あるいは高さが、負数あるいは範囲外です。このエラーの原因はおそらく、PAGESIZE実行引数を使ってページ・サイズを無効な値に設定したことです。
処置:	PAGESIZE実行引数を使って有効な値を入力するか、「レポート」プロパティ・パレットで物理ページ・サイズ設定を変更してください。


REP-1225:  論理ページ・サイズは無効です。

原因:	指定した論理ページの高さが負数です。
処置:	負数にならないように注意して、論理垂直パネルを再定義してください。


REP-1226:  ボディ位置は印刷域を超えています。

原因:	ボディ・パネルが、物理ページ内に入っていません。
処置:	レイアウト・モデル・エディタでマージン・サイズを再設定して、ボディのパネル・サイズを調整してください。


REP-1229: 繰返し枠: <repeating frame name>のレコード間隔値が負の値です。
• REP-1229:  繰返し枠: <repeating frame name>のレコード間隔値が負の値です。

原因:	繰返し枠で指定された「枠間の垂直間隔」および（または）「枠間の水平間隔」の値が負の値です。
処置:	エラー・メッセージで示す繰返し枠の「間隔」設定を正しい値に再設定してください。


REP-1230:  フィールド: <field name>に無効なページ・リセット・グループがあります。

原因:	「リセット位置」フィールドで指定した繰返し枠では、ページ番号を表示するレイアウト・フィールドが収まりません。無効な繰返し枠を指定したか、指定後に繰返し枠を削除した可能性があります。
処置:	「リセット位置」として、「Report」または有効な繰返し枠の名前を指定してください。


REP-1231:  <object name>に無効なテキスト折返しスタイルがあります。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1232:  マトリックス: <matrix name>に無効なソース枠があります。

原因:	マトリックス・オブジェクトの枠として無効なオブジェクトを指定したか、あるいは指定した繰返し枠に無効な「印刷方向」があります。
処置:	水平繰返し枠の「印刷方向」を「縦」に、垂直繰返し枠の「印刷方向」を「横」に変更してください。


REP-1233:  マトリックス: <matrix name>の枠は、完全に交差していません。

原因:	マトリックスを形成する繰返し枠が、完全に交差していません。たとえば、2つの縦方向繰返し枠と2つの横方向繰返し枠がある場合で、横方向繰返し枠の1つのみが縦方向繰返し枠の1つと完全に交差している場合に、このエラーが発生します。
処置:	可能であれば、マトリックスのデフォルト・レイアウトを変更してください。あるいは、マトリックスを構成する繰返し枠を移動して、互いに完全に交差するようにしてください。


REP-1234:  マトリックス: <matrix name>の位置は、その枠の交点上ではありません。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1235:  クロス積の索引の生成中にエラーが発生しました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1236:  問合せ: <query name>は無効です。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1237:  データ・リンクは無効です。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1238:  グループ: <group name>は無効です。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1239:  列: <column name>は無効です。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1240:  アンカーは無効です。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1241:  列: <column name>から参照がループしています。

原因:	直接間接を問わず、自身を参照する列を作成しました。たとえば、列Aが列Bを参照し、列Bが列Aを参照するというエラーです。
処置:	対象の列を更新、あるいは削除して、依存性の循環を排除してください。


REP-1242:  マトリックスの縦枠は横枠の下位になければなりません。

原因:	マトリックス・レイアウトでは、縦方向繰返し枠は、横方向繰返し枠の下位にあることが必要です。
処置:	「配置」-->「最背面へ移動」、「配置」-->「最前面へ移動」、「配置」-->「背面へ」および「配置」-->「前面へ」を使用して、レイヤー関係が次のようになるように繰返し枠を配置してください。繰返し枠は、それが囲む繰返し枠の下位、縦方向繰返し枠は横方向繰返し枠の下位とします。


REP-1243:  列: <column name>に実行不能な集計方法が指定されています。

原因:	使用できないサマリー・ファンクションを指定しました。
処置:	有効なサマリー・ファンクションを指定してください。


REP-1245:  列: <column name>の集計ファンクションに指定されたソース列の数が無効です。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1246:  チャート・モジュールが見つかりません。

原因:	Report Builderが、対象チャートに関係付けられたチャート・モジュールを見つけられません。
処置:	チャート・モジュールのファイル名とパスを訂正してください。


REP-1247:  レポートに、コンパイルされていないPL/SQLがあります。

原因:	すべての参照PL/SQL構造体のコンパイルが完了する前に、レポートを実行しようとしました。
処置:	PL/SQLをコンパイルして、その後、レポートを実行してください。


REP-1248:  プレースホルダ: '<column name>'の列は、すべて同じグループになければなりません。

原因:	異なるグループに属している列から、プレースホルダ列の値を設定しようとしました。
処置:	プレースホルダ列のグループを、プレースホルダ列の値を変更する列グループと一致するように変更してください。


REP-1249:  列: <column name>には、PL/SQL式がありません。

原因:	「PL/SQL式」フィールドに何も指定しないで、「型」が「式列」である列を作成しました。
処置:	列のPL/SQL式を作成するか、あるいは列の「型」を変更してください。


REP-1250:  問合せの従属関係がループしています。

原因:	レポート内に、互いに他方が最初に実行されることを要求する問合せが、少なくとも2つあります。
処置:	1つ以上の問合せを編集して、従属関係の循環を除去してください。


REP-1251:  問合せ: <queryname>から従属関係がループしています。

原因:	レポート内に、互いに他方が最初に実行されることを要求する問合せが、少なくとも2つあります。メッセージにリストされている問合せが、矛盾を引き起こしている問合せの1つです。
処置:	リストされている問合せか他方の矛盾している問合せのどちらかを編集して、従属関係の循環を除去してください。


REP-1252:  マトリックスは、グループ: <group name>の繰返し枠によって囲まれていなければなりません。

原因:	レポートのデータ・モデル内では親グループを持つマトリックスがありますが、レイアウトでは親グループに対する繰返し枠が存在しないか、あるいはマトリックスを囲んでいません。
処置:	親グループ内にマトリックスを囲む繰返し枠ができるように、レポートのレイアウトを変更してください。


REP-1253:  マトリックス・オブジェクトが、レイアウトの異なる領域にあります。

原因:	マトリックスの繰返し枠が、レイアウトの異なる領域（ボディまたはマージン、ヘッダー、トレーラ）にあります。
処置:	マトリックスのすべての繰返し枠を、同じレポート領域内に移動してください。


REP-1254:  アンカー・オブジェクトが、レイアウトの異なる領域にあります。

原因:	アンカー・オブジェクトとアンカーされたオブジェクトが、レイアウトの異なる領域（ボディまたはマージン、ヘッダー、トレーラ）にあります。
処置:	前述のオブジェクトを、同じレポート領域に移動してください。


REP-1255:  非表示オブジェクトをアンカーできません。

原因:	アンカーされたオブジェクトが、非表示オブジェクトです。
処置:	アンカーされたオブジェクトが表示されるようにするか、アンカーを削除してください。


REP-1256:  リンク・ファイル・ボイラープレート・テキストにソース・ファイルがありません。

原因:	リンク・ファイル・ボイラープレート・オブジェクトのプロパティ・パレットにある「ソース・ファイル名」フィールドにファイル名が指定されていません。
処置:	「リンク・ファイル・ボイラープレート」プロパティ・パレットにある「ソース・ファイル名」フィールドにディレクトリ・パスとファイル名を指定してください。


REP-1257:  呼出し側から子問合せにデータを渡せません。

原因:	他の製品からReport Builderを起動し、Report Builderは子問合せに対するデータを呼出し側からフェッチするように指示されています。Report Builderに渡されるデータは、マスター問合せに対するもののみです。
処置:	Report Builderが子問合せに対するデータを要求しないように、呼出し側の指示を変更してください。


REP-1258:  グループ: <group name>には列がありません。

原因:	列のないグループを作成しました。
処置:	グループを削除するか、あるいはグループに1つ以上の列を割り当ててください。


REP-1259:  グループ: <group name>にはブレーク列がありません。

原因:	ブレーク列のない親グループを作成しました。
処置:	グループのブレーク列の「ブレーク順序の設定」チェック・ボックスを「はい」にしてください。


REP-1260: グループ: <group name1>および<group name2>は、同じ問合せからのものであるため、リンクできません。
• REP-1260:  グループ: <group name1>および<group name2>は、同じ問合せからのものであるため、リンクできません。

原因:	同じ問合せに属している2つのグループ間にデータ・リンクがあります。この処理は、許可されていません。
処置:	データ・リンクを削除するか、あるいは他のグループと再リンクしてください。


REP-1261:  グループ: <group name>の親が判別できません。

原因:	1つのグループに、2つの問合せが親として存在しています（1グループに親は1つのみです）。
処置:	同じグループから異なる問合せへのデータ・リンクを削除してください。


REP-1262:  グループ: <group name>からデータ・リンクの従属関係がループしています。

原因:	リンクに循環サイクルを作成しました（つまり、間接直接を問わず、親をそれ自体の子に指定しました）。
処置:	サイクル内のリンクの少なくとも1つを削除してください。


REP-1263:  クロス積グループ: <group name>には、グループがないか、または1つしかありません。

原因:	内部にグループがないか、あるいは1つしかないクロス積グループがあります。クロス積グループには、少なくとも2つのグループが必要です。マルチ問合せクロス積グループでは、クロス積グループ内に少なくとも2つの問合せが必要です。
処置:	クロス積グループを削除するか、あるいはグループまたは問合せ（マルチ問合せの場合）を追加してください。


REP-1264:  グループ: <group name>のデータ・リンクは、クロス積境界を横切っています。

原因:	マルチ問合せマトリックス・レポート内に、クロス積の内側と外側の両方にグループがある問合せがあります。
処置:	問合せのすべてのグループを、クロス積グループの内側と外側のどちらか一方に移動してください。


REP-1265:  クロス積グループ: <group name>には、子グループがありません。

原因:	子グループのないクロス積グループがありますが、子グループは必須です。子グループは、マトリックスのセルとして機能します。
処置:	クロス積グループに子グループを作成してください。


REP-1266:  列: <column name>: ページ・レベル列はクロス積では使用できません。

原因:	クロス積グループに列を作成しましたが、そのクロス積グループはページレベル・サマリー（つまり、「リセット位置」が「Page」であるサマリー）の列であるか、あるいはそれに依存しています。
処置:	ページレベル・サマリーであるか、それに依存しているクロス積グループに、列を作成することはできません。クロス積グループから列を削除するか、あるいは列の「リセット位置」または依存しているページレベル・サマリーを変更してください。


REP-1267:  チャート: <display name>は、バインド・パラメータとして無効な列を参照しています。

原因:	チャートが、存在しない列を参照しています。これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1268:  チャート: <display name>は、バインド列: <column name >を無効な頻度で参照しています。

原因:	チャートに指定された列が入っているグループが、そのチャートを囲む繰返し枠のグループより下位にあります。
処置:	ソース・グループが、指定された列の入っているグループかその上位にある繰返し枠内に、チャートを移動してください。あるいは可能ならば、指定された列を囲んでいる繰返し枠のグループに移動してください。


REP-1269:  チャート: <display name>は、無効なレポート・グループを参照しています。

原因:	チャートに指定されたレポート・グループが存在しません。これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1270:  チャート: <display name>は、レポート・グループを無効な頻度で参照しています。

原因:	チャートに指定されたレポート・グループが、囲んでいる繰返し枠のソース・グループの上位にあります。
処置:	ソース・グループが、レポート・グループと同位かその上位にある繰返し枠内に、チャートを移動してください。


REP-1271:  チャート列名: <column name>が、チャート・モジュール: <display name>で重複して指定されています。

原因:	指定されたチャート列あるいはパラメータが、チャート・モジュールで重複して参照されました。
処置:	そのチャートに指定した列とパラメータをチェックして、重複があれば削除してください。


REP-1272:  列: <column name>はブレーク列として使用できません。

原因:	サマリーまたはファンクション、プレースホルダに「ブレーク順序」が指定されています。これらのタイプの列は、ブレーク列としては使用できません。
処置:	ブレーク列として使用できる列についてのルールを見直してください。詳細は、「ブレーク順序」を参照してください。


REP-1273:  マトリックス: <matrix name>のソース・グループは、同じクロス積からのものではありません。

原因:	マトリックスを形成する繰返し枠のソース・グループが、同じクロス積グループに含まれていません。マトリックスは、同じクロス積グループ内に含まれている必要があります。
処置:	繰返し枠のソース・グループを変更するか、あるいは異なる繰返し枠を選択してマトリックスの寸法を形成してください。


REP-1274:  マトリックス: <matrixname>での繰返し方向の組合せは無効です。

原因:	クロス積グループ内でソース・グループが同じ"ファミリ"の階層に属する（つまり、相互に上位項目または下位項目である）マトリックスの繰返し枠は、「印刷方向」が同じであることが必要です。マトリックス内でネストを作成する場合、クロス積グループ内の親子リレーションが使用されます。その結果、そのようなグループと関係付けられた繰返し枠は、ページ上で同じ方向に印刷される必要があります。
処置:	必要に応じて、繰返し枠の「印刷方向」を変更するか、あるいは繰返し枠に異なるソース・グループを選択するか、異なる繰返し枠を選択してマトリックス寸法を形成してください。


REP-1275:  ページ・レベル列: <column name>は、フォーマット・トリガー: <program unit name>から参照できません。

原因:	「フォーマット・トリガー」で入力されたPL/SQLは、「リセット位置」または「計算位置」が「Page」である列を参照することはできません。
処置:	ページ・レベル列への参照を削除するか、あるいは列の「リセット位置」または「計算位置」を「Page」以外に変更してください。


REP-1276:  プレースホルダ: <column name>は、1つまたは複数の式列以外の列を参照しています。

原因:	プレースホルダ列にはSRW.REFERENCEが含まれていますが、参照されている列は式列ではありません。プレースホルダ列では、SRW.REFERENCEは式列を参照する必要があります。
処置:	SRW.REFERENCEによって参照される列を変更してください。


REP-1277:  選択要素は無効です。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1278:  <program unit name>でのPL/SQLプロシージャは無効です。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1279:  枠または繰返し枠: <frame name>は無効です。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1280:  フィールド: <field name>は無効です。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1281:  ボイラープレート: <boilerplate name>は無効です。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1282:  マトリックス: <matrix name>は無効です。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1283:  チャート・モジュール: <display name>が無効です。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1284:  問合せ: <query name>にはグループがありません。

原因:	データ・モデルに、グループを持たない問合せがあります。データ・モデル内の各問合せには、関係付けられたグループが少なくとも1つは必要です。
処置:	問合せに対して新規グループを作成してください。


REP-1285:  問合せ: <query name>には選択要素がありません。

原因:	データ・モデルに、何も選択していない問合せがあります。データ・モデル内の各問合せは、少なくとも1つの要素を選択する必要があります。
処置:	問合せにSELECT文を入力して、少なくとも1つの要素を選択してください。


REP-1286:  クロス積グループ: <group name>が、他のクロス積グループになっています。

原因:	グループが、他のクロス積グループに対して、クロス積グループとグループの両方として機能するように指定されています。この処理は、許可されていません。
処置:	グループを、クロス積グループとグループの両方ではなく一方にしてください。


REP-1287:  クロス積グループ: <group name>にグループ・フィルタがあってはなりません。

原因:	クロス積グループに、グループ・フィルタが指定されています。この処理は、許可されていません。
処置:	クロス積グループからグループ・フィルタを削除してください。必要に応じて、別のグループのグループ・フィルタを作成してください。


REP-1288:  <group name>のグループ・フィルタに関する数値引数がありません。

原因:	グループのフィルタに「最初」または「最後」が指定されていますが、グループがフィルタ処理するレコード数を指示する数値が指定されていません。
処置:	グループ・フィルタに数値を指定してください。


REP-1289:  グループ: <group name>で実行不能なグループ・フィルタが指定されました。

原因:	使用できないか、無効であるグループ・フィルタが指定されています。
処置:	グループに有効なグループ・フィルタを指定してください。


REP-1290:  ソースのデータ型が、列: <column name>で指定された集計ファンクションと互換性がありません。
• REP-1290:  ソースのデータ型が、列: <column name>で指定された集計ファンクションと互換性がありません。

原因:	サマリー列に、指定された「ファンクション」では無効なデータ型を持つ「ソース」が割り当てられました。たとえば、文字列の合計値を出そうとしている場合がそれにあたります。
処置:	ソース列のデータ型が、「サマリー列」プロパティ・パレットで指定されている「ファンクション」に合っていることを確認してください。


REP-1291:  列: <column name>に、無効なリセット位置が指定されています。

原因:	サマリー列に、無効な「リセット位置」を指定しました。「リセット位置」は、サマリー列と同じグループあるいはサマリー列のグループより上のグループ、「Page」または「Report」に設定できます。
処置:	プロパティ・パレットのサマリー列に、有効な「リセット位置」を指定してください。


REP-1292:  列: <column name>に、無効な計算場所が指定されています。

原因:	サマリー列に、無効な「計算位置」を指定しました。「計算位置」は、サマリー列と同じグループあるいはサマリー列のグループより上のグループ、「Page」または「Report」に設定できます。
処置:	プロパティ・パレットのサマリー列に、有効な「計算位置」値を指定してください。


REP-1293:  列: <column name>に、無効な積順序が指定されています。

原因:	クロス積グループ内の列に、「積順序」に無効な値が割り当てられたか、あるいは値が割り当てられませんでした。
処置:	列のプロパティ・パレットの「積順序」に、有効な値を指定してください。


REP-1294:  列: <column name>の幅が大きすぎます。

原因:	列の幅が、使用しているオペレーティング・システムで認められている最大値を超えています。
処置:	「列」のプロパティ・パレットで、列の幅を小さくしてください。


REP-1295:  列: <column name>のデータ・フォーマットはサポートされていません。

原因:	列に対して「ファイルからの読込み」をアクティブにしましたが、「列」プロパティ・パレットの「フォーマット」フィールドに無効または使用不可のデータ・フォーマットを指定しました。
処置:	「フォーマット」フィールドに有効なデータ・フォーマットを指定してください。値リストには、有効なデータ・フォーマットがすべて表示されます。LONG、RAW、LONG RAWのデータベース列で有効なフォーマットの値は、「テキスト」と「Oracle Format（イメージ）」のみです。


REP-1296:  子データ・リンクは、クロス積グループ: <group name>にはありません。

原因:	クロス積グループにある列か、あるいはクロス積グループ自体に列をリンクしようとしました。この操作は許されていません。
処置:	クロス積グループおよびそのグループに関係付けられた列以外の列とグループの間に、データ・リンクを作成してください。


REP-1297:  データ・リンクの子列: <column name>は、データベース列でなければなりません。

原因:	列をデータベース列ではない列（たとえば、サマリー列あるいは式列、プレースホルダ列）とリンクしようとしましたが、これは許されていません。
処置:	データベース列およびグループと、データ・リンクを作成してください。


REP-1298:  列: <column name>および<column name>のデータ型に互換性がないため、リンクできません。

原因:	データ・リンク内の親と子の列のデータ型に互換性がないため、リンクできませんでした。たとえば、「Number」列を「Character」列にリンクしようとした可能性があります。
処置:	データ・リンクで指定する親と子の列が、互換性のあるデータ型であることを確認してください。


REP-1299:  異なるクロス積にあるグループ: <group name>と<group name>はリンクできません。

原因:	2つの異なるクロス積グループの寸法グループ間、あるいはそれらの寸法グループの列間にデータ・リンクを作成しようとしました。この操作は許されていません。
処置:	2つの異なるクロス積間あるいはそれらの列間に、データ・リンクを作成することはできません。


REP-1300:  テキスト・ボイラープレート<boilerplate name>にはコメントがありません。

原因:	テキストの入っていないテキスト・ボイラープレート・オブジェクトを作成しました。
処置:	ボイラープレート・オブジェクトにテキストを入力するか、あるいはボイラープレート・オブジェクトを削除してください。


REP-1301:  クロス積内でグループ: <group name>のリンクを作成することはできません。

原因:	クロス積グループ内で、グループのデータ・リンクを作成しました。クロス積では、同レベルのディメンション・グループは許可されません
処置:	ディメンション・グループは、グループのチェーン以外で構成することはできません。同レベルのディメンション・グループは許可されません。


REP-1302:  クロス積は、複数の子グループを持つことはできません。

原因:	クロス積グループは、2つ以上の子グループを持っています。1つのクロス積グループは、1つの子グループしか持つことができません。
処置:	クロス積グループにある子グループを1つ残してすべて削除してください。


REP-1303:  問合せは、クロス積グループ: <group name>の完全に中、または完全に外になければなりません。

原因:	問合せを作成しましたが、その問合せのグループの一部がクロス積の内側あるいは上側、下側にあります。
処置:	各問合せのグループ枠が完全に、クロス積の内側あるいは上側、下側にあることを確認してください。


REP-1304:  クロス積グループ: <group name>には、別のクロス積が子として存在しています

原因:	別のクロス積グループを子とするクロス積グループを作成しました。この処理は、許可されていません。
処置:	クロス積グループの子グループが、クロス積グループにならないようにしてください。


REP-1305:  警告: 枠: <frame name>とオブジェクト: <object name>が交差しています。

原因:	レポート・レイアウトに、メッセージに示したオブジェクトを完全に囲んでいない枠が含まれています。従って、このオブジェクトは枠内に入っていると見なされません。
処置:	枠がオブジェクトを囲むようにする場合は、枠をサイズ変更するか、あるいは移動してください。


REP-1306:  サマリー列: <column name>に、無効なソースが指定されています。

原因:	サマリー列に、無効なソースを指定しました。サマリー列のソースは、そのサマリー列と同じグループあるいは下位のグループに属している必要があります。
処置:	サマリー列のソースを、そのサマリー列と同じグループあるいは下位のグループに属するように変更してください。


REP-1307:  サマリー列: <column name>に、無効な積順序が指定されています。

原因:	このエラーの原因として、次のことが考えられます。
	ケース1:	サマリー列の「積順序」がソース列の積順序のサブセットになっていません。つまり、集計の「積順序」は、ソース列の「積順序」の一部が含まれたサブセットであることが必要です。
	ケース2:	サマリー列の「積順序」がソース列の「積順序」と一致していません。たとえば、ソース列の「積順序」がA、B、Cであるとすると、集計列の「積順序」はA（それ自体である場合）またはA、Bとなります。この集計の「積順序」を、B、Aとすることはできません。
処置:	このエラーの訂正には、次の処置を行ってください。
	ケース1の場合:	サマリーの「積順序」を、ソース列の「積順序」のサブセットになるように変更してください。
	ケース2の場合:	サマリーの「積順序」を、ソース列の「積順序」と一致するように変更してください。


REP-1308:  プレースホルダ列: <column name>はクロス積ではサポートされていません。

原因:	プレースホルダ列を、クロス積グループ内に作成しようとしました。クロス積グループに、プレースホルダ列を含めることはできません。
処置:	プレースホルダを削除するか、あるいはクロス積グループの外側に移動してください。


REP-1309:  レポート・レベル・サマリー: <column name>で「割合」を求めることはできません。

原因:	「割合（%）」の「ファンクション」を付けて、レポート・レベルのサマリー（つまり、データ・モデルにあるすべてのグループの外側にあるサマリー）を作成しました。この「ファンクション」は常に100%になるので、レポート・レベル・サマリーでは意味がありません。
処置:	サマリーを削除するか、あるいは意味を持つグループに移動してください。


REP-1310:  ボイラープレート: <boilerplate name>が、存在しないフィールド: &<reference name>を参照しています。

原因:	ボイラープレート・オブジェクトが、存在しないフィールドを参照しています。参照対象のフィールドが削除されたか、あるいは改名された可能性があります。そのために、ボイラープレート・オブジェクトでのこの参照が、現在無効になっています。
処置:	状況に応じて、参照を削除するか、あるいは別のフィールドへの参照に置換するか、参照するフィールドを作成してください。


REP-1311:  ページ依存の参照を持つオブジェクト: <object name>は、固定サイズに変更されました。

原因:	フィールドあるいはボイラープレート・オブジェクトが、複数ページにわたって値を参照しています。（これは、前方参照と呼ばれています。）このようなレイアウト・オブジェクトは、大きさが水平方向と垂直方向の両方で固定されている必要があります。
処置:	レイアウト・オブジェクトの「水平拡張度」および「垂直拡張度」が、Report Builderで「固定」に変更されました。出力をチェックして、値が切り捨てられていないことを確認してください。切り捨てられている場合は、値が収まる大きさにレイアウト・オブジェクトを拡張してください。


REP-1312:  「ページ・レベル」列: <column name>は、チャート: <display name>から参照できません。

原因:	チャートに渡そうとしたReport Builder列の1つが、ページ・レベル・サマリー（つまり、「リセット位置」または「計算位置」が「Page」であるサマリー）であるか、あるいはページ・レベル・サマリーに依存しています。チャートに渡される列は、ページ・レベル・サマリーであっても、それに依存していてもいけません。
処置:	列をチャートに渡さないでください。


REP-1313:  「ページ・レベル」列: <column name>は、グループ・フィルタ: <group name>から参照できません。

原因:	グループ・フィルタで参照しようとしたReport Builder列の1つが、ページ・レベル・サマリー（つまり、「リセット位置」または「計算位置」が「Page」であるサマリー）であるか、あるいはページ・レベル・サマリーに依存しています。グループ・フィルタが参照する列は、ページ・レベル・サマリーであっても、それに依存していてもいけません。
処置:	グループ・フィルタで列を参照しないでください。


REP-1314:  フォーマット・トリガー: <program unit name>は、列: <column name>を無効な頻度で参照しています。

原因:	フォーマット・トリガーの1つが、誤った頻度に設定されている列を参照しています。
処置:	フォーマット・トリガーから列への参照を削除してください。


REP-1315:  グループ・フィルタ: <program unit name>は、アクセスできない列: <column name>を参照しています。

原因:	グループ・フィルタの1つが、アクセス不可の列を参照しようとしました。
処置:	グループ・フィルタから列への参照を削除してください。


REP-1316:  <object name>は、アクセスできない列: <column name>を参照しています。

原因:	プロシージャあるいはファンクションが、アクセス不可の列を参照しようとしました。
処置:	PL/SQLサブプログラムから列への参照を削除してください。


REP-1317:  ボイラープレート: <boilerplate name>は、ソース: <column name>のフィールドを無効な頻度で参照しています。

原因:	ボイラープレート・オブジェクトが、&fieldnameを使用してフィールドを参照していますが、2つのオブジェクトが異なる頻度に設定されています。たとえば、ボイラープレート・オブジェクトと参照しているフィールドが、別の繰返し枠内に設定されています。
処置:	ボイラープレート・オブジェクトとフィールドを同じ頻度に設定するか、あるいは参照を削除してください。


REP-1318:  トランザクションを読込み専用に設定中にエラーが発生しました。

原因:	READ ONLY=YESが指定されているとき、（COMMITによって）現行トランザクションが終了中で読込み専用トランザクションが起動中の間に、レポート実行が起動されてエラーが発生しました。あるいは、（COMMITによって）読込み専用トランザクションが終了中の間に、レポート実行が終了されてエラーが発生しました。
処置:	データベースに接続していることを確認して、前のトランザクションによってカーソルあるいはロックが保留状態のままになっていないことを確認してください。


REP-1319:  警告: システムのアンカー・アルゴリズムがアンカー・オブジェクト<object1 name>を一意に識別できません。代わりに<object2 name>を選択します。

原因:	指定されたオブジェクト（オブジェクト名1）が2つのオブジェクトから等距離にあります。結果として、Report Builderは、暗黙のアンカーを判断するのに標準の基準（最短距離）を使用できません。標準の基準が使用できないので、Report Builderは指定されたオブジェクト（オブジェクト名2）に、暗黙のアンカーを作成します。暗黙のアンカーが、実行のたびに異なる場合があることに注意してください。詳細は、「暗黙的なアンカーのアルゴリズム」を参照してください。
処置:	暗黙的なアンカーをランダムに作成するのを避けるには、指定されたオブジェクト（オブジェクト名1）を別のオブジェクトに明示的にアンカーしてください。


REP-1320: プログラム単位: <program unit name>は無効なID: <column ID>を持つ列を参照しています。
• REP-1320:  プログラム単位: <program unit name>は無効なID: <column ID>を持つ列を参照しています。

原因:	無効なPL/SQL（たとえば、コンパイルしなかったPL/SQL）を持つレポートを実行しました。PL/SQLソースは、決定できない列の参照を含んでいました。
処置:	列が、PL/SQLソースの列の参照をチェックし、レポート内のすべてのPL/SQLソースを再コンパイルして、レポートを再実行してください。


REP-1322:  <object name>の後の改ページは無視されます。

原因:	別のオブジェクトによってアンカー（明示的にも暗黙的にも）されていないオブジェクトの「後で改ページ」を、アクティブにしました。この場合、「後で改ページ」は有効ではなく、無効です。これは警告で、エラー・メッセージではないことに注意してください。
処置:	オブジェクトに対する「後で改ページ」を「いいえ」にしてください。


REP-1323:  フォーマット・トリガー: <program unit name>では出力列を使用できません。

原因:	指定されたオブジェクトに対するフォーマット・トリガーで、Report Builder列またはパラメータの値を設定しようとしました。たとえば、ある条件（たとえば、IF :COUNT1 = 10）でCOUNT1という列の値は使用できますが、その値を割当て文（たとえば、COUNT1 = 10）に直接設定することはできません。
処置:	フォーマット・トリガーから、割当て文を削除してください。


REP-1324:  グループ・フィルタ: <group name>では出力列を使用できません。

原因:	指定されたグループに対するフィルタで、Report Builder列またはパラメータの値を設定しようとしました。たとえば、ある条件（たとえば、IF :COUNT1 = 10）でCOUNT1という列の値は使用できますが、その値を割当て文（たとえば、COUNT1 = 10）に直接設定することはできません。
処置:	グループ・フィルタから、割当て文を削除してください。


REP-1325: BETWEEN PAGEトリガーでは出力列を使用できません。

原因:	ページ間トリガーで、Report Builder列あるいはパラメータの値を設定しようとしました。たとえば、ある条件（たとえば、IF :COUNT1 = 10）でCOUNT1という列の値は使用できますが、その値を割当て文（たとえば、COUNT1 = 10）に直接設定することはできません。
処置:	グループ・フィルタから、割当て文を削除してください。


REP-1326:  <trigger name>は無効な頻度で列: <column name>に書き込みます。

原因:	レポート・トリガーで、Report Builder列の値をレポートの誤った頻度に設定しようとしました。参照および設定できるのは、レポート・レベル列あるいはパラメータのみです。ページ依存列（つまり、「リセット位置」が「Page」である列）あるいはページ依存列に依存する列の参照あるいは設定はできません。
処置:	値を参照あるいは設定する列およびパラメータが、レポート・レベル列およびパラメータであることを確認してください。


REP-1327:  列: <column name>は無効な頻度で列: <column name>に書き込みます。

原因:	式列で、Report Builder列の値を、レポートの誤った頻度に設定しようとしました。参照および設定できるのは、グループの階層における同じグループあるいは上位グループにある列のみです。たとえば、レポート・レベルの列の式は、その他のレポート・レベルの列のみを参照できます。
処置:	値を参照あるいは設定する列が、グループの階層における同じグループあるいは上位グループにあることを確認してください。


REP-1328: 信頼性の低いOSではROWLABEL列があるレポートを実行できません。

原因:	安全性の高くないデータベースに接続中に、安全性の高いデータベースを必要とするレポートを実行しようとしています。
処置:	安全性の高いデータベースに接続中に、レポートを実行してください。


REP-1329: 列: <column name>が列: <column name>にリンクできません。

原因:	子列がサマリーあるいは、式、プレースホルダ列であるデータ・リンクを作成しました。データベース列のみがリンク可能です。
処置:	データベース列を使用して、データ・リンクを作成してください。


REP-1330: 文字パラメータ: < parameter name > （問合せ:< query name >）は列の依存関係を変更できません。

原因:	レポートの実行時に、列の番号あるいはタイプ、名前を変更するか、あるいは計算された列に対する新しい依存性または新しいバインド参照を導入する字句パラメータを作成しました。
処置:	列を変更したり、あるいは新しい依存性またはバインド参照を導入しないように、字句パラメータを変更してください。


REP-1331: 列: <column name>が列: <column name >にリンクできません。
REP-1331: 列: <column name>が列: <column name >にリンクできません。子列が文字パラメータで定義されています。

原因:	子列の値が字句パラメータを参照するデータ・リンクを作成しました。この処理は、許可されていません。
処置:	データ・リンクの子列を別の列と置換してください。


REP-1332:  <group name>のグループ・フィルタは、列: <column name>を参照できません。参照列が有効なデータベース列ではないか、関連している問合せに依存しています。

原因:	グループの問合せか、あるいはそれより上位の問合せにないデータベース列を参照するグループ・フィルタか、あるいは非関連列に依存する計算された列を参照するグループ・フィルタを作成しました。
処置:	グループ・フィルタから、違反している参照を削除してください。


REP-1333: サポートできないレイアウトです。マトリックスが別のマトリックスの内側にあってはなりません。

原因:	別のマトリックス・レイアウト内にネストされたマトリックス・レイアウトを作成しました。
処置:	マトリックス・レイアウトは、別のマトリックス・レイアウト内にネストすることはできません。これを避けるために、レイアウトを再設計してください。


REP-1335:  警告: 可変に変更されたテキスト: <boilerplate name>は固定/定義済み幅として扱われます。

原因:	「水平拡張度」および「垂直拡張度」の値が「可変」または「拡張」に設定されていましたが、レポートには、90度の倍数ではない角度に回転されたボイラープレート・テキスト・オブジェクトが含まれています。この場合、「水平拡張度」は「固定」（「拡張」を指定した場合）として、あるいは「縮小」（「可変」を指定した場合）として扱われ、この警告が表示されます。
処置:	このボイラープレート・オブジェクトに対する「水平拡張度」および「垂直拡張度」の値を変更してください。


REP-1336:  フィールド: <field name>のソースが、ページ・レベル: <column name>.<group name>です。

原因:	指定されたフィールドが、指定されたグループが所有するページ・サマリーを参照していますが、そのフィールドを囲むグループに対する繰返し枠がありません。
処置:	ソースがフィールドを囲む指定されたグループである、繰返し枠を作成してください。そのような繰返し枠がすでに存在する場合は、それを拡張してフィールドを囲むようにしてください。


REP-1337:  ボイラープレート: <boilerplate name>が、フィールド: <field name>を参照していますが、そのソースがページ・レベル<column name>.<group name>です。

原因:	指定されたボイラープレート・オブジェクトが、ページ･レベルの「ソース」を参照するフィールドを参照していますが、そのフィールドを囲む繰返し枠（「ソース」が指定されたグループである枠）がありません。
処置:	ソースがフィールドを囲む指定されたグループである、繰返し枠を作成してください。そのような繰返し枠がすでに存在する場合は、それを拡張してフィールドを囲むようにしてください。


REP-1338: 列モードは、繰返し枠: <frame name >で使用できません。

原因:	設定が次のいずれかの条件を満たしていない繰返し枠に対して、「列モード」をアクティブにしました。
	「印刷方向」は「縦」で、「垂直拡張度」は「固定」。
	「印刷方向」は「横」で「水平拡張度」は「固定」。
処置:	繰返し枠の「印刷方向」あるいは「垂直拡張度」または「水平拡張度」を変更するか、あるいは「列モード」を「いいえ」にしてください。


REP-1339:  チャート: <display name>にデータ列の指定がありません。

原因:	「チャート問合せ」に対して値を指定しましたが、レポートからチャート・モジュールに渡す列がありません。
処置:	レポートからチャート・モジュールにデータを渡さない場合は、「チャート問合せ」および「ソース」に対して何も指定しないでください。データを渡す場合は、「チャート問合せ」および「ソース」の他に、渡す列を指定してください。


REP-1340: レポート定義<report name>で列と合致しません。

原因:	別のコンポーネント（たとえば、Form Builder) がReport Builderに問合せを渡して、渡された列とReport Builderが期待した列の間に不一致があるときに、このエラーが発生します。このエラーの原因として、次のことが考えられます。
	ケース1:	Report Builderが、コールしているアプリケーションから実際に渡された列数より少ない数の列、あるいは多い数の列を持っています。
	ケース2:	コールしているアプリケーションのパラメータ・リストでの列の記述が、Report Builderが持っているものとは異なっています。たとえば、レポートの問合せが文字列を選択しており、コールしているアプリケーションがその列に日付データ型を割り当てている場合に、このエラーが発生します。
処置:	このエラーの訂正には、次の処置を行ってください。
	ケース1の場合:	コールしているアプリケーションが、Report Builderが持っている列数と同じ数の列を渡していることを確認してください。
	ケース2の場合:	コールしているアプリケーションが渡している列のデータ型および名前が、レポートのデータ型および名前と一致していることを確認してください。


REP-1341:  警告: 列: <column name>で、データが切り捨てられたかもしれません。

原因:	レポートのデータベース列の幅が、データベースにおける幅より小さく定義されています。レポート定義の作成後に、データベースの列が更新されるときに、このエラーが発生する場合があります。
処置:	問合せを、強制的に解析し直してください。1つの方法として、「SELECT文」フィールドにある1行の終わりに空白を入力してから、「SQL問合せ文」ダイアログを適用するという方法があります。


REP-1342:  問合せ: <query name>へのデータ・リンクのタイプは、Oracle Server以外では無効です

原因:	START WITH句付きでデータ・リンクを作成し、非Oracleデータベースに接続中に実行する場合に、このエラーが発生します。START WITHは、Oracleのみでサポートされています。
処置:	START WITHを使用しているデータ・リンクを削除するか、あるいはOracleに接続してください。


REP-1343:  ボタン: <button name>は無効です。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1344:  ボタン: <button name>にはアクション・ソース・ファイルがありません。

原因:	指定されたボタンに対して、「マルチメディア・ファイル」のアクションを指定しましたが、ソース・ファイルを指定していないか、あるいは存在しないソース・ファイルを指定しました。
処置:	指定されたボタンのプロパティ・パレットをオープンして、ボタン・アクションのソースとして有効なファイルを選択していることを確認してください。詳細は、「ボタン・プロパティ」を参照してください。


REP-1345:  ボタン: <button name>のソース列は無効です。

原因:	指定したボタンに対して、「マルチメディア列」のアクションを指定しましたが、ソース列を指定していないか、あるいは無効なソース列を指定しました。
処置:	指定されたボタンのプロパティ・パレットをオープンして、ボタン・アクションのソースとして有効な列を選択していることを確認してください。ユーザーが作成したボタンの詳細は、「ボタン・プロパティ」を参照してください。


REP-1346:  ボタン: <button name>は、間違った頻度で、ソース列: <column name>を参照しています。

原因:	指定されたボタンのプロパティ・パレットで指定された列が、そのボタンを囲む繰返し枠のグループの下位のグループにあります。
処置:	ボタンを、ソース・グループが指定された列を含むグループあるいはその上位のグループにある繰返し枠に移動してください。あるいは可能ならば、指定された列を囲んでいる繰返し枠のグループに移動してください。


REP-1347:  ボタン: <button name>のアイコン・ファイルは無効です。

原因:	ボタン表面のアイコン・ファイルとして、無効なファイルあるいは存在しないファイルを指定しました。
処置:	アイコン・ファイルが存在していて、正しい形式であり、壊れていないことを確認してください。


REP-1348: ソース列のフィールド: <field name>は、サウンド形式、またはビデオ形式です。

原因:	フィールドのソースとして、サウンドあるいはビデオを含む列を指定しましたが、フィールドは、サウンドおよびビデオを表示できません。
処置:	フィールドのソースとして、別の列（サウンドあるいはビデオではない列）を指定してください。


REP-1349:  ボタン: <button name>からPL/SQLアクションが抜けています。

原因:	指定されたボタンのアクションとして機能しているPL/SQLトリガーが、存在しないPL/SQLを参照しています。
処置:	トリガーをデバッグして、有効なプログラム単位を参照していることを確認してください。


REP-1350:  アクション・トリガー: <program unit name>では出力列が使用できません。

原因:	ボタン・アクションとして機能しているPL/SQLトリガーに、値を戻すバインド変数が含まれています。PL/SQLアクション・トリガーは、値を戻せません。
処置:	PL/SQLから、バインド変数を削除してください。


REP-1351:  警告: ボタン: <button name>のアイコン: <icon name>が見つかりません。

原因:	指定されたボタンのアイコンが、見つかりません。レポートが実行されますが、ボタンはブランクで表示されます。
処置:	指定されたボタンのプロパティ・パレットをオープンして、指定したアイコンが存在していて、正しい形式であり、正しいパス情報を組み込んであることを確認してください。


REP-1352: このレポートで指定されているフォントがNLS_LANGで指定されたキャラクタ・セット中にありません。
• REP-1352:  このレポートで指定されているフォントがNLS_LANGで指定されたキャラクタ・セット中にありません。

原因:	NLS_LANG環境変数が、フォントが使用できないキャラクタ・セットを指定しています。
処置:	NLS_LANGで指定されたキャラクタ・セットに存在するフォントを選択してください。あるいは、レポートで指定されたフォントの代わりに使用可能なフォントが使用されるように強制するために、フォント・エイリアス・ファイルを使用してください。


REP-1353: レイアウト・オブジェクト: <layout object name>のWebプロパティは、フィールドまたは列: <field or column
REP-1353:  レイアウト・オブジェクト: <layout object name>のWebプロパティは、フィールドまたは列: <field or column name>を無効な頻度で参照しています。

原因:	レイアウト・オブジェクト・プロパティの1つ（「Bookmark」、「Action」、「Hyperlink」または「Linktag」）が、フィールドまたは列を参照していますが、2つのオブジェクトが同じ頻度に配置されていません。たとえば、レイアウト・オブジェクトは、列があるグループとは別のグループにソースがある繰返し枠内に配置されています。
処置:	レイアウト・オブジェクトを列オブジェクトと同じ頻度にある繰返し枠内に配置するか、あるいは参照を削除してください。


REP-1354:  レイアウト・オブジェクト: <layout object name>のWebプロパティは、ページ依存のフィールドまたは列: <field or column name>を参照しています。

原因:	レイアウト・オブジェクト・プロパティの1つ（「ブックマーク」、「アクション」、「ハイパーリンク」または「Linktag」）が、ページ計算または可変のページ合計数を参照しているフィールド・ボイラープレート・オブジェクトを参照しています。Webプロパティが参照できるのは、ページ計算をベースにしていない列およびフィールドのみです。
処置:	ページに従属するフィールドまたは列へのWebプロパティからの参照を削除してください。


REP -1355:  PL/SQLベースの問合せ<query name>にPL/SQLがありません。

原因:	PL/SQLベースの問合せを作成しましたが、この問合せにPL/SQLを入力しませんでした。
処置:	問合せにPL/SQLを入力してください。


REP 1356: PL/SQLベースの問合せ<query name>に列をリンクすることはできません。
REP -1356:  PL/SQLベースの問合せ<query name>に列をリンクすることはできません。

原因:	意図的な列リンク条件を設定するため、ある列をPL/SQLベースの問合せに存在する別の列にバインド変数としてリンクしようとしました。
処置:	意図的な列リンク条件を設定するには、グループ・リンクを作成してPL/SQLベースの問合せ内の列をバインド変数として使用できます。


REP 1357:  外部キー・リンクの自動作成はSQL問合せでのみ可能です。
REP -1357:  外部キー・リンクの自動作成はSQL問合せでのみ可能です。

原因:	自動的に外部キー・リレーションシップに基づいた列リンクを作成するように、2つの問合せ間のリンクをドラッグしました。この操作は2つのSQLデータ問合せ間でしか行えません。
処置:	この操作を2つのSQLデータ問合せ上で行うか、PL/SQLベースの問合せをSQLに変更してください。


REP-1365:  Expressベースの問合せ<query name>に列をリンクすることはできません。
REP1365:  Expressベースの問合せ<query name>に列をリンクすることはできません。

原因:	Expressベースの問合せである別の列に列をリンクしようとしましたが、この処理は許可されていません。
処置:	意図的な列リンク条件を設定するには、グループ・リンクを作成してExpressベースの問合せ内の列をバインド変数として使用できます。


REP-1366:  オブジェクト: <object name>のXML設定は、ページ従属列: <column name>を参照しています。
REP1366: オブジェクト: <object name>のXML設定は、ページ従属列: <column name>を参照しています。

原因:	オブジェクトのXMLプロパティの1つが、ページ計算またはページ変数の総数を含む列を参照しています。XML設定は、ページ計算に基づく列を参照できません。
処置:	ページに従属する列へのXML設定からの参照を削除してください。


REP-1367:  オブジェクト: <object name>のXML設定は、フィールドまたは列: <field or column name>を無効な頻度で参照しています。
REP-1367: オブジェクト: <object name>のXML設定は、列: <column name>を無効な頻度で参照しています。

原因:	オブジェクトのXMLプロパティの1つは、列を参照していますが、列&columnnameはオブジェクトよりも高い頻度を持っています（たとえば、列は、その列を参照するオブジェクトとは別のグループにある場合があります）。
処置:	参照先のフィールドまたは列と同じ頻度になるようにオブジェクトを移動する（たとえば、同等以下のグループに配置する）か、参照を削除してください。


REP-1400:  coxrを初期化できませんでした。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1401:  <program unit name>: 致命的なPL/SQLエラーが発生しました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1402:  <program unit name> : PL/SQL例外を処理できません。
REP-1402:  '<program unit name>': PL/SQL例外を処理できません。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1403:  <program unit name>: PL/SQLプロシージャの一時停止が無効です。

原因:	PL/SQL構成体が、実行中または生成中に一時停止されました。
処置:	PL/SQL構成体をデバッグおよび再コンパイルしてください。


REP-1404何らかの理由でコンパイルに失敗しました。
REP-1404:  何らかの理由でコンパイルに失敗しました。

原因:	レポートの生成中に、PL/SQLコンパイルが失敗しました。
処置:	PL/SQL構成体をデバッグしてください。


REP-1405:  実行可能なコードではありません。

原因:	PL/SQL構成体が正しくコンパイルされなかったか、または他のなんらかの理由で実行できませんでした。
処置:	PL/SQL構成体をデバッグしてください。


REP-1406:  パラメータ化されたコードは直接実行できません。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1408:  PL/SQLを初期化できません。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1412PL/SQLファンクション: <program unit name>は無効な値を返したか、値を返しませんでした。
REP-1412:  PL/SQLファンクション: <program unit name>は無効な値を返したか、値を返しませんでした。

原因:	戻り値を指定していないPL/SQLファンクションがレポートに含まれています（たとえば、TRUEやFALSEを戻さないフォーマット・トリガー）。
処置:	ファンクションに、それぞれのコード・パスに対する戻り文が組み込まれていることを確認してください。


REP-1414:  <program unit name>: 実行するためのライブラリが見つかりませんでした。

原因:	これはほとんどの場合、異常な状態です。
処置:	PL/SQLコードをチェックして、再コンパイルしてください。それでも復旧しない場合は、「異常な状態」.を参照してください。


REP-1415: <program unit name>: ユーザー・イグジット<user exit name>は不明です。
REP-1415:  <program unit name>: ユーザー・イグジット: <user exit name>は不明です。

原因:	ユーザー・イグジットがコールされましたが、見つかりませんでした。
処置:	ユーザー・イグジットに対して正しい名前を使用していること、またユーザー・イグジットがコンパイルされていて、リンクされていることを確認してください。


REP-1416: <program unit name>: ユーザー・イグジット<user exit name>.<submessage>
REP-1416:  <program unit name>: ユーザー・イグジット: <user exit name>.<submessage>

原因:	ユーザー・イグジットにエラーが発生しました。考えられるエラーは、次のとおりです。参照されている列が不明である、または列値が切り捨てられている、ユーザー・イグジットが見つかりません。
処置:	サブメッセージに基づいて、ユーザー・イグジットをデバッグしてください。有効な列を参照していて、ユーザー・イグジットがアクセス可能であることを確認してください。適切なライブラリ/ユーザー・イグジットにリンクすることにより、レポートがスタンドアロンで実行できるようになります。


REP-1417:  <program unit name>: 無効な数値引数が<procedure name>に渡されました。

原因:	参照したパッケージ・プロシージャでは引数を整数にするのが望ましいのですが、指定されませんでした。
処置:	パッケージ・プロシージャを参照しているPL/SQLが、そのプロシージャに正しく整数を渡していることを確認してください。PL/SQLパッケージ・プロシージャの詳細は、「Report Builder PL/SQLパッケージ: SRW」を参照してください。


REP-1418:  <program unit name>: <procedure name>にNULL引数が渡されました。

原因:	ユーザー定義のPL/SQLサブプログラムによって、またはパッケージ・サブプログラムに1つ以上のNULL引数が渡されたことによって、例外SRW.NULL_ARGUMENTSが呼び出されました。
処置:	この例外を呼び出す可能性があるPL/SQLコードをチェックしてください。さらに、指定されたパッケージ・サブプログラムに渡されている引数リストをチェックしてください。


REP-1419:  <program unit name>: PL/SQLプログラムを強制終了しました。

原因:	PL/SQL構成体に致命的なエラーがあって、中止しました。
処置:	PL/SQL構成体にエラーがないかどうかチェックしてください。
原因:	壊れた.RDFファイルが、REP-1419 'beforerep'エラーの原因になっている場合があります。
処置:	.RDFファイルを再作成します。
原因:	レポートの複数のフィールドが、そのレポートで使用できないデータ（たとえば、無効なPL/SQL参照）にアクセスしています。
処置:	レポートで問い合されたすべての表および列が、a）使用可能か、さらに、b）レポートで設定されたパラメータに一致するデータで配置されているかを確認してください。


REP-1420:  <program unit name>: PL/SQLプログラムがプログラム・エラーを引き起こしました。

原因:	ユーザー定義のPL/SQLサブプログラムによって、または異常な状態のために、例外SRW.PROGRAM_ERRORが呼び出されました。
処置:	この例外を呼び出す可能性があるPL/SQLコードをチェックしてください。例外を呼び出しているPL/SQLコードがない場合は、「異常な状態」を参照してください。


REP-1421:  <program unit name>: <procedure name>にある、誤ったタイプの列を渡そうとしています。

原因:	パッケージ・プロシージャに名前を渡した列のデータ型が、そのパッケージ・プロシージャの正しいデータ型ではありません（たとえば、パッケージ・プロシージャは「CHARACTER」データ型の列を期待していましたが、渡されたのは別のデータ型の列でした）。
処置:	パッケージ・プロシージャを参照するPL/SQLをデバッグして、パッケージ・プロシージャに正しいデータ型の列名を渡していることを確認してください。さらに、パッケージ・プロシージャの構文をチェックして、正しい参照を行っていることを確認してください。PL/SQLパッケージ・プロシージャの詳細は、「Report Builder PL/SQLパッケージ: SRW」を参照してください。


REP-1422:  この名前のプロシージャはすでに存在しています。

原因:	既存のPL/SQLプロシージャと同じ名前で、新規のPL/SQLプロシージャを作成しようとしました。
処置:	新規プロシージャの名前を変更するか、または既存のプロシージャの名前を変更してください。


REP-1423:  <program unit name>: 問合せの実行を開始した後では最大行数を変更できません。

原因:	問合せがフェッチする行数を減らすために、SRW.SET_MAX_ROWパッケージ・プロシージャを使用しました。しかし、SRW.SET_MAX_ROWをコールしたのは、問合せのフェッチ後でした。
処置:	SRW.SET_MAX_ROWをBeforeReportトリガーに移動してください。


REP-1424:  <program unit name>: srw.set_maxrowの実行中に内部エラーが発生しました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1425:  <program unit name>: DO_SQLパッケージの実行中にエラーが発生しました - <embedded message>。

原因:	Report BuilderがSRW.DO_SQLコールを実行中に、エラーが発生しました。このメッセージ内に、Report Builderメッセージが埋め込まれています。また、発生したエラーについて説明しているOracleエラー・メッセージも埋め込まれている場合があります。
処置:	SRW.DO_SQL内のエラーは、SQLエラーの結果であることがほとんどです。『Oracle8 Server SQLリファレンス』を参照して、SRW.DO_SQLコールにあるSQL文が正しいことを確認してください。


REP-1426:  <program unit name>: <procedure name>は無効なコンテキストから実行されています。

原因:	無効な領域から、指定されたパッケージ・プロシージャをコールしようとしました。たとえば、SRW.SET_ATTRを式からコールすることはできません。
処置:	PL/SQLコードを変更して、そのコンテキストからパッケージ・プロシージャをコールしないようにしてください。


REP-1427:  <program unit name>: <procedure name>で参照されている問合せ名は存在しません。

原因:	Before ReportトリガーにSRW.SET_MAXROWプロシージャのコールを組み込みましたが、そのプロシージャコールで参照されている問合せが存在しません。
処置:	レポートの既存問合せを参照するように、SRW.SET_MAXROWプロシージャのコールを変更してください。


REP-1428:  <program unit name>:<procedure name>の実行中にエラーが発生しました。

原因:	ユーザー定義のPL/SQLサブプログラムによって、またはSRW.RUN_REPORT呼出し後に異常な状態になったため、例外SRW.RUN_REPORT_FAILUREがコールされました。
処置:	この例外を呼び出す可能性があるPL/SQLコードをチェックしてください。例外を呼び出しているPL/SQLコードがない場合は、SRW.RUN_REPORTに渡されたコマンド・ライン文字列をチェックしてください。指定されたレポートが存在し、すべてのパラメータ値が正しいことを確認してください。さらに、PL/SQLコードを持つレポートがBATCH=YESを含むコマンド・ライン文字列にコールされている場合は、BATCH=NOは許されていませんので注意してください。詳細は、「SRW.RUN_REPORT」を参照してください。


REP-1429:  <program unit name>: batch=noでは、<procedure name> を起動できません。

原因:	BATCH=NOを含むコマンド・ライン文字列を使用してSRW.RUN_REPORTプロシージャのコールを組み込みましたが、これは許されていません。
処置:	SRW.RUN_REPORTコマンド文字列から、BATCH=NOを削除してください。


REP-1430:  レポート: <filename>のREPファイルは作成できません。コンパイル・エラーが発生しています。

原因:	変換しようとしているレポート内のPL/SQLに、エラーがあります。
処置:	レポートをオープンして、PL/SQLをデバッグしてください。


REP-1433:  <program unit name>: ユーザー・イグジット: <user exit name>の実行中にエラーが発生しました。

原因:	メッセージで命名されているユーザー・イグジットの実行中に、エラーが発生しました。
処置:	ユーザー・イグジットをデバッグして、リンクされていることを確認してください。


REP-1434:  <program unit name>: <procedure name>がユーザーIDで起動できません。

原因:	ユーザID/パスワードを含むコマンド・ライン文字列を使用してSRW.RUN_REPORTプロシージャのコールを組み込みましたが、これは許されていません。
処置:	SRW.RUN_REPORTコマンド文字列から、ユーザID/パスワードを削除してください。


REP-1435:  <program unit name>: 列<column name>の値が切り捨てられました。

原因:	列（たとえば、プレースホルダ）に、その列幅に収まりきらない大きな値が割り当てられたので、 SRW.TRUNCATED_VALUE例外が呼び出されました。例外は処理されず、このエラーが呼び出されました。
処置:	列の幅を、割り当て値を収めるのに十分な幅にするか、またはPL/SQLソースで例外をハンドルしてください。


REP-1436: <program unit name>: PL/SQLがスコープにないオブジェクトを参照しています。
• REP-1436:  <program unit name>: PL/SQLがスコープにないオブジェクトを参照しています。

原因:	パラメータの「有効化トリガー」フィールドで、レポート列を参照するPL/SQLソースを入力しました。この処理は、許可されていません。
処置:	パラメータの「有効化トリガー」からレポート列への参照を削除してください。


REP-1437:  PL/SQL開発環境（DE）でランタイム・エラーが発生しました。

原因:	これはほとんどの場合、異常な状態です。
処置:	問題の詳細は、一緒に示される開発環境エラー・メッセージを参照してください。問題を自分では解決できない場合は、「異常な状態」.を参照してください。


REP-1438:  GETREFファンクション・パラメータ: <parameter name>は、LONG、LONG RAW、RAWいずれかの型である必要があります。

原因:	CDE_MM.GET_REFコールの2番目のパラメータが、タイプがLONGまたはLONG RAW、RAWではない列を指定しています。
処置:	正しいタイプの列を指定するように、2番目のパラメータを変更してください。


REP-1439:  プログラム単位がランタイム専用レポートであるために、コンパイルできません。

原因:	プログラム単位が、外部プラットフォームまたはPL/SQLの旧バージョンに属しています。
処置:	.repファイルのかわりに、.rdfファイルを使用するか、または.repファイルを生成してください。


REP-1508:  クロス積: 計算値が見つかりません。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1510: 列: <column name>を計算できません。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1517:  列: <column1 name>が、互換性のない頻度を持つ列: <column2 name>を参照しています。

原因:	データ・モデルにある列が、データ・モデル中の別の列（たとえば、「式」フィールド内の列）を参照していますが、2つの列は両立しないグループに割り当てられています。たとえば、「グループ」が「レポート」である式列が、「グループ」が「G_Emp」である列を参照した場合に、このエラーが発生します。
処置:	列の参照を削除するか、または参照している列を参照されている列のグループと両立するグループに割り当ててください。


REP-1518: 内部エラー: <Oracle message>です（グループ:＜group name＞の処理中）。
REP-1518:  内部エラー: <Oracle message>です（グループ:<group name>の処理中）。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1607:  レコード・マネージャ: レポート・レベル列:rdcagt()で使用できません。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1610:  レコード・マネージャ: 内部結合を持つ問合せに「最大行数」の設定があります。

原因:	ほとんどの場合、複数問合せクロス積のセル問合せで、SRW.SET_MAXROWを使用して「最大フェッチ行」を設定したことが原因です。
処置:	セル問合せに対するSRW.SET_MAXROWへのコールを削除してください。


REP-1760: ユーティリティ・エラー: 内部エラー#1です。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1761: 内部エラー<context info>です（<object type>'<object name>'処理中）。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1762:  内部エラー<context info>です。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1780:  スタック・ユーティリティ: 割当ての間にエラーが発生しました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1781:  スタック・ユーティリティ: 'push'の間にエラーが発生しました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1782:  スタック・ユーティリティ: 'pop'の間にエラーが発生しました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1783:  スタック・ユーティリティ: 空のスタックをポップしようとしました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1800:  フォーマット・エラーが発生しました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1801:  「ファイルの読込み」フィールドのファイル形式が不明です。

原因:	ファイル列を作成しようとしましたが、入力したファイル形式が無効です。
処置:	値リストを表示して、有効なファイル形式を選択してください。


REP-1802:  テキスト・ファイルからフィールドの内容を読み込めません。

原因:	列の「ファイルからの読込み」をチェックしましたが、Report Builderは列が指し示したファイルを見つけられませんでした。このエラーの原因として、次のことが考えられます。
	ケース1:	ファイルが存在しません。
	ケース2:	ファイルのアクセスに必要な権限がありません。
	ケース3:	システム・エラーによって、そのファイルの検索ができなくなりました。
処置:	このエラーの訂正には、次の処置を行ってください。
	ケース1の場合:	「ファイルからの読込み」のチェックを解除するか、または必要なファイルを作成してください。
	ケース2の場合:	可能であれば、権限を更新してください。
	ケース3の場合:	使用しているオペレーティング・システムのマニュアルを参照するか、またはシステム管理者に連絡してください。


REP-1803:  宛先ファイル: <filename>がオープンできません。

原因:	レポートに指定した宛先ファイルを、オープンできませんでした。
処置:	使用しているオペレーティング・システムのマニュアルを参照するか、またはシステム管理者に連絡してください。


REP-1804:  プリンタ定義ファイル: <filename>がオープンできません。

原因:	指定したプリンタのプリンタ定義ファイルを、オープンできませんでした。
処置:	使用しているオペレーティング・システムのマニュアルを参照するか、またはシステム管理者に連絡してください。


REP-1805:  メール・テキスト・ファイル: <filename>がオープンできません。

原因:	メール・メッセージにレポート出力を送信しようとしましたが、メッセージ・ファイルをオープンできませんでした。
処置:	Oracle*Mailのマニュアルを参照するか、サポート担当に連絡してください。詳細は、サポート担当への連絡を参照してください。


REP-1806:  メール・コマンド・ファイル: <filename>がオープンできません。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1807:  メール・レポート・コマンドが失敗しました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1808:  印刷コマンド・ファイルがオープンできません。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1809:  印刷レポート・コマンドが失敗しました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1810:  キャラクタのレポートを実行するためにReport Builder ASCIIドライバの使用に切り替えています。

原因:	プリンタまたはファイルに、PostscriptドライバとMicrosoft Windows Generic Textドライバのどちらかを使用して、キャラクタ・モード・レポートを印刷しようとしています。
処置:	処置は不要です。


REP-1811:  チャートの生成中にエラーが発生しました。

原因:	Report Builderが、チャート生成のためにチャート・ランタイム実行プログラムをコールしましたが、チャートは作成されませんでした。
処置:	指定されたチャート・モジュールが存在して、実行できることを確認してください。


REP-1812:  フォーマットされたページが多すぎます。データが多すぎるか、レポートの定義にエラーがあります。

原因:	このエラーの原因として、次のことが考えられます。
	ケース1:	捕捉しようしたデータが多すぎたので、設定されたユーザー定義制限に到達しました。
	ケース2:	レポート定義内でエラーに到達しました。
処置:	このエラーの訂正には、次の処置を行ってください。
	ケース1の場合:	プログラムの実行を終了してください。PRODUCT_PROFILE表内のPAGE_LIMITの値をチェックしてください。その値が「0（ゼロ）」、またはレポートをフォーマットするのに十分な大きさの値であることを確認してください。 値が「0（ゼロ）」ということは、ユーザーがページ数の制限なしにフォーマットができるということです。
	ケース2の場合:	デザイナにあるレポートをデバッグしてください。


REP-1813: オブジェクト: <object name>は大きすぎるため、マトリックス・セルに入りません。
• REP-1813:  オブジェクト: <object name>は大きすぎるため、マトリックス・セルに入りません。

原因:	マトリックス・セル内にフェッチされたデータが、セルの容量を超えています。 たとえば、セルに変数フィールドが含まれていて、データが期待されたより長い可能性があります。
処置:	フェッチされたデータが収まるまでマトリックス・セルを拡大するか、またはデータを再定義してください。


REP-1814:  レポートをフォーマットできません。オブジェクト: <object name>は、<location>に収まりません。

原因:	参照されたオブジェクトが原因で、一番最後にフォーマットされたページが、その前のページとまったく同じ状態で始まるようになっています。そのため、異常終了させるまでフォーマットが循環します。このエラーの原因として、次のことが考えられます。
	ケース1:	「印刷オブジェクト・オン」が「全ページ」になっているオブジェクトが、次ページにオーバーフローしています。
	ケース2:	サイズ設定が「可変」または「拡張」になっているオブジェクトは、レイアウト・モデル・エディタではページ境界線外に拡張して表示されませんが、レポートがフォーマットされるとページ境界線外に拡張して表示されます。
	ケース3:	繰返しフレームは、レイアウト・モデル・エディタではページ境界線外に拡張して表示されませんが、レポートがフォーマットされるとページ境界線外に拡張して表示されます。
処置:	参照されているオブジェクトをガイドとして使用して、レポート・レイアウト内にページ境界線外に拡張しているオブジェクトがないどうかを調べてください。注意: メッセージで参照されているオブジェクトは、境界線外に拡張しているオブジェクトです。このオブジェクトは、別のオブジェクトに押されて境界線外に出ている場合があり、この2番目のオブジェクトの変更が必要な場合があります。


REP-1815:  無効なOracle番号が検出されました。

原因:	列の値を与える式が、値の指定に失敗しました。
処置:	レポート列にある式をデバッグして、それぞれの式が、必要な場合に値を指定していることを確認してください。


REP-1816: 「部数」に値が指定されていません。印刷はされません。

原因:	「ランタイム・パラメータ・フォーム」または「印刷」ダイアログ・ボックスで、部数を0（ゼロ）に指定しました。
処置:	部数の値を1以上に指定してください。


REP-1817:  終了ページの後に開始ページがあります。ページ印刷はされません。

原因:	「印刷」ダイアログ・ボックスで、終了ページ番号より大きい開始ページ番号を指定しました。
処置:	開始ページ番号が終了ページ番号より小さくなるように、開始ページ番号か終了ページ番号を変更してください。


REP-1818:  イメージ・フォーマットのデータを読み込めません。

原因:	このエラーの原因として、次のことが考えられます。
	ケース1:	ファイルまたはデータベース列を、イメージを含んでいるものとして読み込もうとしましたが、そのファイルまたは列の内容は、誤った形式になっています。
	ケース2:	指定したReport Builder列の幅が小さすぎるために、イメージを切り捨てている可能性があります。
処置:	このエラーの訂正には、次の処置を行ってください。
	ケース1の場合:	有効な形式のイメージを含むファイルまたは列を指定していることを確認してください。
	ケース2の場合:	イメージを表示できるだけの大きさになるように、Report Builder列の幅を変更してください。


REP-1819:  ファイル名: <filename>は、プラットフォーム最大<number>文字よりも長いです。

原因:	ファイル名に、プラットフォームで許されている最大値より長い名前を指定しました。ほとんどの場合、「ファイルからの読込み」を使用してファイルにアクセスしていて、データベースにあるファイル名が長すぎることが原因です。
処置:	データベースが壊れていないことを確認するか、または指定された長さのファイル名を受け入れるプラットフォーム上でレポートを実行してください。 あるいは、この両方の操作を行ってください。


REP-1820:  ビットマップ・レポートの実行にReport Builder ASCIIドライバを使用することができません。

原因:	Report Builder ASCIIドライバがデフォルトのプリンタであるときに、ビットマップ・レポートを印刷しようとしています。この処理は、許可されていません。
処置:	別のプリンタを選択してから、レポートを印刷してください。


REP-1825: BEFORE REPORTトリガーがFALSEを戻しました。

原因:	レポートに、TRUEではなくてFALSEの値を戻した「BEFORE REPORT」トリガーが組み込まれています。トリガーがFALSEの値を戻すと、レポートのフォーマットが停止します。
処置:	使用している「BEFORE REPORT」トリガーが、TRUEの値を戻すように設定してください。


REP-1826:  BETWEEN PAGESトリガーがFALSEを戻しました。

原因:	レポートに、TRUEではなくてFALSEの値を戻した「BETWEEN PAGES」トリガーが組み込まれています。トリガーがFALSEの値を戻すと、レポートのフォーマットが停止します。
処置:	使用している「BETWEEN PAGES」トリガーが、TRUEの値を戻すように設定してください。


REP-1827:  書式マスクのカッコが対応していません。

原因:	書式マスクに、一致していないカッコがあります。
処置:	書式マスクを編集して、必要なカッコを挿入してください。


REP-1828:  書式マスクには、カッコは最大で1組しか入れられません。

原因:	書式マスクで2組以上のカッコを使用しました。
処置:	書式マスクでは、使用するカッコは1組のみにしてください。


REP-1829:  書式マスクの中で左カッコは右カッコに先行していなければなりません。

原因:	書式マスクで、カッコの順序を逆にしました。 つまり、右カッコ（閉じるカッコ）を左カッコ（開くカッコ）の前に使用しました。
処置:	書式マスクを編集して、カッコの順序を逆にしてください。


REP-1830:  書式マスクの指数フィールドには、Eをきっかり4つ入力してください。

原因:	フィールドに対して科学表記法の使用を指定しているとき、入力したEの数が多すぎるか、または少なすぎました。 4つのEを入力してください。
処置:	4つのEを持つ書式マスクを入力してください。 出力に余分なEを表示する場合は、それらのEを引用符（"）内に入れてください。


REP-1831:  書式マスクの閉じ引用符がありません。

原因:	書式マスクで、開く引用符（"）を文字列の前に入力しましたが、閉じる引用符を入力しませんでした。このエラーの原因として、次のことが考えられます。
	ケース1:	文字列の後に、閉じる引用符を入力し損いました。
	ケース2:	文字列の開始と終了の引用符内に、1つの引用符を入力しました。
処置:	このエラーの訂正には、次の処置を行ってください。
	ケース1の場合:	文字列の後に、終了の引用符を追加してください。
	ケース2の場合:	文字列の内側にある引用符の次に、もう1つの引用符を入力してください。


REP-1832:  書式マスクの中の文字: <character>は無効です。

原因:	書式マスクでは無効な文字を、書式マスクに入力しました。
処置:	不正な文字を削除してください。詳細は、「書式マスク」を参照してください。


REP-1833:  書式マスクには、少なくとも1桁なければなりません。

原因:	入力した書式マスクに、数字が含まれていません。マスクには、数字を表すトークンが少なくとも1つは入っている必要があります。
処置:	書式マスクに、数字を表すトークンを入力してください。数字を表すトークンは、0、9、*およびSです。 詳細は、「書式マスク」を参照してください。


REP-1834:  書式マスクには、'<'文字は2つ以上使用できません。

原因:	書式マスクに、2つの<を入力しました。<を間違って1つ余分に入力したか、または余分な<を文字列の一部にしようとしました。注意: 連続して入力しなくても、複数の>はエラーの原因になります。
処置:	余分な<を削除するか、その<を出力に表示する場合には、文字列の一部として引用符（"）の内側に入れてください。


REP-1835:  書式マスクには、'>'文字は2つ以上使用できません。

原因:	書式マスクに、2つの>を入力しました。>を間違って1つ余分に入力したか、または余分な>を文字列の一部としようとしました。注意: 連続して入力しなくても、複数の>はエラーの原因になります。
処置:	余分な>を削除するか、その>を出力に表示する場合には、文字列の一部として引用符（"）の内側に入れてください。


REP-1836:  書式マスクの中で、'<'は、'>'の前になければなりません。

原因:	書式マスクで、<は、>の前に来る必要があります。
処置:	出力に表示されるすべての<と>が、引用符（"）の内側に置かれていることを確認してください。数列の開始と終了を表す<と>については、書式マスク内で<が>の前にあることを確認してください。


REP-1837:  書式マスクには、小数点は2つ以上使用できません。

原因:	複数の小数点を持つ書式マスクを入力しました。
処置:	出力に表示する余分な小数点は、引用符（"）内に置いてください。引用符の外側にある余分な小数点を削除してください。


REP-1838:  書式マスクには、スケール・ポイントは2つ以上使用できません。

原因:	書式マスク内に、トークンVを2回以上入力しました。
処置:	出力に余分なVを表示する場合は、それらのVを引用符（"）内に入れてください。あるいは、書式マスク内で1つのみとなるまでVを削除してください。


REP-1839:  書式マスクで最初の桁の前に','を入れられません。

原因:	書式マスクで、最初の数字の前にカンマを入力しましたが、これは無効です。
処置:	出力において数字の前にカンマを表示する場合は、文字列として引用符（"）内に置いてください。あるいは、カンマを削除してください。


REP-1840:  書式マスクで最初の桁の後に','を入れられません。

原因:	書式マスクで、最後の数字の後にカンマを入力しましたが、これは無効です。
処置:	出力において数字の後にカンマを表示する場合は、文字列として引用符（"）内に置いてください。あるいは、カンマを削除してください。


REP-1841:  書式マスクで小数点の後に','を入れられません。

原因:	書式マスクで、小数点の後にカンマを入力しました。
処置:	出力において小数点の後にカンマを表示する場合は、文字列として引用符（"）内に置いてください。あるいは、カンマを削除してください。


REP-1842:  書式マスクには、指数フィールドは2つ以上使用できません。

原因:	書式マスク内に、トークンEEEEを2回以上入力しました。このトークンは、書式マスク1つに1個しか入力を許されていません。
処置:	出力に余分なEを表示する場合は、それらのEを引用符（"）内に入れてください。あるいは、書式マスク内で1つになるまで余分なEを削除してください。


REP-1843:  指数フィールドを持つ書式マスクでは、小数点の前に1桁なければなりません。

原因:	科学表記法書式マスクを入力しましたが、小数点の左側に数字がないか、または2つ以上の数字がありました。
処置:	小数点の左側に2つ以上の数字を入力した場合は、小数点の左側にある数字が1つのみになるまで、数字を削除してください。小数点の左側に数字が1つもない場合は、数字を1つ追加してください。


REP-1844:  内部エラー: フレキシブル配列に無効なインデックスがあります。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1845:  書式マスクの中で、小数点は、'<'と'>'の間になければなりません。

原因:	書式マスクで、<と>の外側に小数点を置きました。
処置:	小数点を削除するか、または<と>の間に置くように書式マスクを編集してください。


REP-1846:  ローマ数字の書式マスクは「RN」または「rn」です。

原因:	ローマ数字書式マスク・トークン（RNまたはrn）を指定するときは、その他の書式マスク・トークンは指定できません。
処置:	値をローマ数字としてフォーマットする場合は、「書式マスク」からRNまたはrn以外のすべての書式マスク・トークンを排除してください。あるいは、RNまたはrnトークンを使用しないでください。


REP-1847:  印刷のセットアップの間に障害が生じました。

原因:	レポートを印刷しようとしました。このエラーの原因として、次のことが考えられます。
	ケース1:	ランタイム・パラメータ・フォームまたはコマンド・ラインにおいて、DESTYPEに「Printer」を指定したときに、DESNAMEに無効なプリンタ名を指定しました。
	ケース2:	SRW.RUN_REPORT使用してレポートを実行していますが、呼び出す側と呼び出される側のレポートのDESTYPEは、どちらも「File」または「Printer」に設定されていますが、呼び出す側のレポートの実行結果は画面に出力する必要があります。
処置:	このエラーの訂正には、次の処置を行ってください。
	ケース1の場合:	DESNAMEに有効なプリンタ名を指定して、この操作を再実行してください。
	ケース2の場合:	最初のレポートのDESTYPEの指定を「Screen」または「Previewer」実行してください。


REP-1848:  印刷開始中に障害が生じました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1849:  印刷中に障害が生じました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1850:  プリンタ定義ファイル: <filename>の行: <number>、列: <number>でエラーが発生しました。（列: <number>，行: <number>，プリンタ定義ファイル: <filename>）ファイルの終わりが引用符の中の文字列に達しました。
REP-1850:  プリンタ定義ファイル: <filename>の行: <number>、列: <number>でエラーが発生しました。（列: <number>,行: <number>,プリンタ定義ファイル: <filename>）ファイルの終わりが引用符の中の文字列に達しました。

原因:	プリンタ定義ファイル内に、引用符で終了していない文字列が含まれています。
処置:	エラー・メッセージ内に示されている位置を使用してエラーの位置をつきとめ、プリンタ定義ファイル内の引用符付き文字列に終了引用符を追加してください。


REP-1851:  プリンタ定義ファイル: <filename>の行: <number>、列: <number>でエラーが発生しました。（列: <number>，行: <number>，プリンタ定義ファイル: <filename>）文字列が<number>文字の制限を超えています。
REP-1851:  プリンタ定義ファイル: <filename>の行: <number>、列: <number>でエラーが発生しました。（列: <number>,行: <number>,プリンタ定義ファイル: <filename>）文字列が<number>文字の制限を超えています。

原因:	プリンタ定義ファイル内の文字列が、許容最大文字数より長くなっています。
処置:	文字列を短くしてください。


REP-1852: プリンタ定義ファイル: <filename>、行: <number>、列: <number>でエラーが発生しました。キーワード「<keyword >...」が不明です。
REP-1852:  プリンタ定義ファイル: <filename>の行: <number>、列: <number>でエラーが発生しました。キーワード「<keyword >...」が不明です。

原因:	プリンタ定義ファイル内に、誤ったキーワードがあります。
処置:	有効なキーワードの詳細は、「プリンタ定義ファイル構文」を参照してください。


REP-1853: プリンタ定義ファイル: <filename>、行: <number>、列: <number>でエラーが発生しました。キーワード: 「<keyword>」が不明です。
REP-1853:  プリンタ定義ファイル: <filename>の行: <number>、列: <number>でエラーが発生しました。キーワード: 「<keyword>」が不明です。

原因:	プリンタ定義ファイル内に、誤ったキーワードがあります。
処置:	有効なキーワードの詳細は、「プリンタ定義ファイル構文」を参照してください。


REP-1854: プリンタ定義ファイル: <filename>、行: <number>、列: <number>でエラーが発生しました。制御文字: 「<character>」が無効です。
REP-1854:  プリンタ定義ファイル: <filename>の行: <number>、列: <number>でエラーが発生しました。制御文字: 「<character>」が無効です。

原因:	プリンタ定義ファイル内に、無効な制御文字があります。
処置:	プリンタ定義ファイル内の無効な制御文字を、置換または削除してください。


REP-1855: プリンタ定義ファイル: <filename>、行: <number>、列: <number>でエラーが発生しました。文字: 「<character>」は無効です。
REP-1855:  プリンタ定義ファイル: <filename>の行: <number>、列: <number>でエラーが発生しました。文字: 「<character>」は無効です。

原因:	プリンタ定義ファイル内に、不明な文字があります。
処置:	プリンタ定義ファイル内の不明な文字を置換または削除してください。


REP-1856:  プリンタ定義ファイル: <filename>の行: <number>、列: <number>でエラーが発生しました。<character>は、有効なASCII文字ではありません。

原因:	プリンタ定義ファイル内に、無効なASCII文字があります。
処置:	プリンタ定義ファイル内の無効なASCII文字を、置換または削除してください。


REP-1857: プリンタ定義ファイル: <filename>、行: <number>、列: <number>でエラーが発生しました。<character>の次には「)」が必要です。
REP-1857:  プリンタ定義ファイル: <filename>の行: <number>、列: <number>でエラーが発生しました。<character>の次には「)」が必要です。

原因:	プリンタ定義ファイル内に、一致しないカッコがあります。
処置:	プリンタ定義ファイルを編集して、必要なカッコを挿入してください。


REP-1858:  プリンタ定義ファイル: <filename>の行: <number>、列: <number>でエラーが発生しました。8進数（<octal number>）は、有効なASCII文字ではありません。

原因:	プリンタ定義ファイル内にあるASCII文字の8進コードが、正しくありません。
処置:	プリンタ定義ファイルを編集して、ASCII文字のコードを訂正してください。


REP-1859:  プリンタ定義ファイル: <filename>の行: <number>、列: <number>でエラーが発生しました。16進数（<character>）は、有効なASCII文字ではありません。

原因:	プリンタ定義ファイル内にあるASCII文字の16進コードが、正しくありません。
処置:	プリンタ定義ファイルを編集して、ASCII文字のコードを訂正してください。


REP-1860:  プリンタ定義ファイル: <filename>、 <number>行、<number>列「<character>」の後に「left」、「center」または「right」が必要です。

原因:	プリンタ定義ファイルに、不完全なコード文字列が含まれています。
処置:	プリンタ定義ファイルを編集して、適切なワードを持つコード文字列を完成させてください。


REP-1861:  ファイル: <filename>、<number>行、<number>列「box」の後に「horizontal」、「vertical」、「top」、「center」または「bottom」が必要です。

原因:	プリンタ定義ファイルに、不完全な"box"コード文字列が含まれています。
処置:	プリンタ定義ファイルを編集して、適切な文字を持つ"box"コード文字列を完成させてください。


REP-1862:  プリンタ定義ファイル: <filename>の行: <number>、列: <number>でエラーが発生しました。キーワード「printer」が必要です。

原因:	プリンタ定義ファイルに、必須コード"printer"が組み込まれていません。
処置:	プリンタ定義ファイルを編集して、必須コード"printer"を追加し、その後に続けて、引用符付きプリンタ名を入力してください。 できればこれは、プリンタ定義ファイルの第1行に置いてください。


REP-1863:  プリンタ定義ファイル: <filename>の行: <number>、列: <number>でエラーが発生しました。引用符の中にはプリンタ名が必要です。

原因:	プリンタ定義ファイル内の"printer"コードの後にプリンタの名前が含まれていますが、その名前が引用符付きの文字列になっていません。
処置:	プリンタ定義ファイルを編集して、"printer"コードの後のプリンタ名を引用符で囲んでください。


REP-1864:  ファイル: <filename>、<number>行、<number>列「width, height, return, linefeed,\nbefore report, after page, after reportまたはcode」が必要です。

原因:	プリンタ定義ファイルに、プリンタ定義ファイルに期待されているコード・ワードが含まれていません。
処置:	プリンタ定義ファイルを編集して、欠けているコード・ワードを追加してください。


REP-1865: プリンタ定義ファイル: <filename>、<number>行、<number>列でエラーが発生しました。「width」の後は数字でなければなりません。
REP-1865:  プリンタ定義ファイル: <filename>の行: <number>、列: <number>でエラーが発生しました。「width」の後は数字でなければなりません。

原因:	プリンタ定義ファイルに"width"コードが含まれていますが、その後にレポート幅を指定する数値がありません。
処置:	プリンタ定義ファイルを編集して、"width"コードの後にレポート幅を指定する数値を挿入してください。


REP-1866: プリンタ定義ファイル: <filename>、<number>行、<number>列でエラーが発生しました。「height」の後は数字でなければなりません。
REP-1866:  プリンタ定義ファイル: <filename>の行: <number>、列: <number>でエラーが発生しました。「height」の後は数字でなければなりません。

原因:	プリンタ定義ファイルに"height"コードが含まれていますが、その後にレポートの高さを指定する数値がありません。
処置:	プリンタ定義ファイルを編集して、"height"コードの後にレポートの高さを指定する数値を挿入してください。


REP-1867:  プリンタ定義ファイル: <filename>の行: <number>、列: <number>でエラーが発生しました。「before」の後は「report」でなければなりません。

原因:	プリンタ定義ファイルにワード"before"が含まれていますが、ワード"report"が抜けています。
処置:	プリンタ定義ファイルを編集して、"before report"を組み込んでください。


REP-1868:  プリンタ定義ファイル: <filename>の行: <number>、列: <number>でエラーが発生しました。（列: <number>，行: <number>，）「between」の次には、「pages」が必要です。
REP-1868:  プリンタ定義ファイル: <filename>の行: <number>、列: <number>でエラーが発生しました。（列: <number>,行: <number>,）「between」の次には、「pages」が必要です。

原因:	プリンタ定義ファイルにワード"between"が含まれていますが、ワード"pages"が抜けています。
処置:	プリンタ定義ファイルを編集して、"between pages"を組み込んでください。


REP-1869:  プリンタ定義ファイル: <filename>の行: <number>、列: <number>でエラーが発生しました。「after」の後は「report」または「page」でなければなりません。

原因:	プリンタ定義ファイル（複数ページ・レポート用）に、ワード"after"が含まれていますが、ワード"report"が抜けています。
処置:	プリンタ定義ファイルを編集して、"after report"を組み込んでください。


REP-1870:  プリンタ定義ファイル: <filename>の行: <number>、列: <number>でエラーが発生しました。引用符の中にはコードの名前が必要です。

原因:	プリンタ定義ファイルに、ユーザー定義の文字列を持つ"code"コードが含まれていますが、その文字列が引用符で囲まれていません。
処置:	プリンタ定義ファイルを編集して、"code"ユーザー定義文字列を引用符で囲んでください。


REP-1871:  プリンタ定義ファイル: <filename>の行: <number>、列: <number>でエラーが発生しました。「dec」の後は「(」でなければなりません。

原因:	プリンタ定義ファイルに、"dec"を使った一般化された文字列が含まれていますが、"dec"の後に左カッコがありません。
処置:	プリンタ定義ファイルを編集して、"dec"の後に続く値をカッコで囲んでください。


REP-1872:  プリンタ定義ファイル: <filename>の行: <number>、列: <number>でエラーが発生しました。「(」の後は数字でなければなりません。

原因:	プリンタ定義ファイルに、一般化された文字列（たとえば、dec、octal）が含まれていますが、左カッコの後に値がありません。
処置:	プリンタ定義ファイルを編集して、一般化された文字列のカッコ内に値を追加してください。


REP-1873:  プリンタ定義ファイル: <filename>の行: <number>、列: <number>でエラーが発生しました。「(」の後は数字でなければなりません。
REP-1873:  プリンタ定義ファイル: <filename>の行: <number>、列: <number>でエラーが発生しました。「octal」の後は「(」でなければなりません。

原因:	プリンタ定義ファイルに、"octal"を使った一般化された文字列が含まれていますが、"octal"の後に左カッコがありません。
処置:	プリンタ定義ファイルを編集して、"octal"の後に続く値をカッコで囲んでください。


REP-1874:  プリンタ定義ファイル: <filename>の行: <number>、列: <number>でエラーが発生しました。「(」の後は数字でなければなりません。

原因:	プリンタ定義ファイルに、一般化された文字列（たとえば、dec、octal）が含まれていますが、左カッコの後に値がありません。
処置:	プリンタ定義ファイルを編集して、一般化された文字列のカッコ内に値を追加してください。


REP-1875:  プリンタ定義ファイル: <filename>の行: <number>、列: <number>でエラーが発生しました。「hex」の後は「(」でなければなりません。

原因:	プリンタ定義ファイルに、"hex"を使った一般化された文字列が含まれていますが、"hex"の後に左カッコがありません。
処置:	プリンタ定義ファイルを編集して、"hex"の後に続く値をカッコで囲んでください。


REP-1876:  プリンタ定義ファイル: <filename>の行: <number>、列: <number>でエラーが発生しました。「(」の後は数字でなければなりません。

原因:	プリンタ定義ファイルに、一般化された文字列（たとえば、dec、octal）が含まれていますが、左カッコの後に値がありません。
処置:	プリンタ定義ファイルを編集して、一般化された文字列のカッコ内に値を追加してください。


REP-1877:  プリンタ定義ファイル: <filename>の行: <number>、列: <number>でエラーが発生しました。「＾」の後は制御文字でなければなりません。
REP-1877:  プリンタ定義ファイル: <filename>の行: <number>、列: <number>でエラーが発生しました。「^」の後は制御文字でなければなりません。

原因:	プリンタ定義ファイルには"^"を使った一般化された文字列が含まれていますが、"^"の後に制御文字がありません。
処置:	プリンタ定義ファイルを編集して、"^"の後に制御文字を追加してください。


REP-1878:  プリンタ定義ファイル: <filename>の行: <number>、列: <number>でエラーが発生しました。「control」の後は「(」でなければなりません。

原因:	プリンタ定義ファイルに、キーワードと一般化された文字列（たとえば、"after report"、"before report"）が含まれていますが、ワード"control"の後に左カッコがありません。
処置:	プリンタ定義ファイルを編集して、ワード"control"の後に左カッコを追加してください。


REP-1879:  プリンタ定義ファイル: <filename>の行: <number>、列: <number>でエラーが発生しました。「(」の後は制御文字でなければなりません。

原因:	プリンタ定義ファイルに、キーワードと一般化文字列（たとえば、after report、before report）が含まれていますが、左カッコの後に制御文字がありません。
処置:	プリンタ定義ファイルを編集して、ワード"control"の後のカッコ内に制御文字を追加してください。


REP-1880:  プリンタ定義ファイル: <filename>の行: <number>、列: <number>でエラーが発生しました。ボックス描画文字列は1文字でなければなりません。

原因:	プリンタ定義ファイルに、"box"コード文字列が含まれていますが、引用符内に指定された描画文字列が2文字分以上の長さになっています。
処置:	プリンタ定義ファイルを編集して、描画文字列として1文字しか指定されていないことを確認してください。


REP-1881:  プリンタ定義ファイル: <filename>の行: <number>、列: <number>でエラーが発生しました。ボックス描画文字を含んだ文字列が必要です。

原因:	プリンタ定義ファイルに、「box」コード文字列が含まれていますが、描画文字列が指定されていません。
処置:	プリンタ定義ファイルを編集して、描画文字列を指定してください。


REP-1882:  ファイル: <filename>、<number>行、<number>列「box」の後に「horizontal」、「vertical」、「top」、「center」または「bottom」が必要です。

原因:	プリンタ定義ファイルに、「box」コード文字列が含まれていますが、後続の必須ワード（horizontalまたはvertical、top、centerまたはbottom）が指定されていません。
処置:	プリンタ定義ファイルを編集して、適切な必須ワードを追加してください。


REP-1883:  プリンタ定義ファイルが予期せず終了しました。

原因:	Report Builderが、プリンタ定義ファイルをオープンできましたが、その読込み中にエラーが発生しました。
処置:	正しいプリンタ定義ファイルを指定したことを確認してください。さらに、プリンタ定義ファイルの内容をチェックしてください。必要であれば、ファイルを編集してください。


REP-1884:  出力を送信中にハングしました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1885:  出力をプリンタへ送信できません。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-1886:  「M」の後は必ず「I」です。

原因:	書式マスクに入力したMの後にIがありませんでした。 Mで始まる唯一のトークンは、MIトークンです。
処置:	MIトークンを使用する場合は、Mの後にIを入力してください。 出力に文字Mを表示する場合は、そのMを二重引用符（"）で囲んでください。あるいは、「書式マスク」から、Mを削除してください。


REP-1887: 「P」の後は必ず「R」です。
• REP-1887:  「P」の後は必ず「R」です。

原因:	書式マスクに入力したPの後にRがありませんでした。 Pで始まるトークンは、PRトークンのみです。
処置:	PRトークンを使用した場合は、Pの後にRを入力してください。 出力に文字Pを表示する場合は、Pを二重引用符（"）で囲んでください。あるいは、「書式マスク」からPを削除してください。


REP-1888:  記号トークンは1つだけ使用できます。

原因:	書式マスクに、複数の記号トークンを入力しています。
処置:	符号トークンは1つにして、あとはすべて書式マスクから削除してください。


REP-1889:  符号トークンは、終わりになければなりません。

原因:	符号トークンが、書式マスクの終わりに置かれていませんでした。
処置:	符号トークン（たとえば、MI、PR、DBおよびCR)を書式マスクの終わりに置いてください。


REP-1890: トークン： 「S」が最初か最後に来なければなりません。

原因:	Sトークンが、書式マスクの最初または最後に置かれていませんでした。
処置:	Sトークンを、書式マスクの始めまたは終わりに置くか、あるいは削除してください。


REP-1891:  カッコ・トークンは、他のトークンを囲んでいなければなりません。

原因:	カッコ・トークンは、書式マスク内の他のすべてのトークンを囲んでいる必要があります。他のすべてのトークンをカッコで囲んでいません。
処置:	書式マスク内の他のすべてのトークンを囲むように、カッコ・トークンを置いてください。


REP-1892:  指定されたdestypeは、pdfまたはhtmlに対してサポートされていません。

原因:	PDFまたはHTML出力では無効なDESTYPEを入力しました。
処置:	有効なDESTYPEの1つを入力して、操作を再試行してください。


REP-1893:  指定されたdestypeは、このプラットフォームではサポートされていません。

原因:	使用しているオペレーティング・システムでは無効なDESTYPEを入力しました（たとえば、Microsoft Windowsで実行中でのSysout）。
処置:	有効なDESTYPEの1つを入力して、操作を再試行してください。


REP-1894:  実行中に、レポート定義が変更されました。新規ページは生成されません。

原因:	レポートの（RWBLD60を使った）プレビュー中に、レポートの定義を変更しました（たとえば、問合せを変更したり、オブジェクトを追加または削除するなど）。 その後、プレビューアに戻って追加ページを表示しようとしました。
処置:	この処理は、許可されていません。Report Builderは、実行時に使用されたすべての情報が残っていることを保証できないので、フォーマット処理が一時停止されます。


REP-1895:  <field name>の日付書式エラーです。

原因:	Report Builderが、指定された日付フィールドをフォーマットできませんでした。
処置:	指定された日付フィールドの書式マスクをチェックしてください。


REP-1896: プリンタ定義ファイル: <filename>の行: <number>、列: <number>でエラーが発生しました。‘hilight’の後には‘backspace’または‘overstrike’が必要です。
REP-1896:  プリンタ定義ファイル: <filename>の行: <number>、列: <number>でエラーが発生しました。‘hilight'の後には‘backspace'または‘overstrike'が必要です。

原因:	指定されたプリンタ定義ファイルに含まれている'hilight'設定が、完成していませんでした。
処置:	'hilight'の後に、'overstrike'または'backspace<sequence>'を追加してください。


REP-1897:  プリンタ定義ファイル: <filename>の行: <number>、列: <number>でエラーが発生しました。数値以外のユーザー定義のプリンタ・コードはサポートしていません。

原因:	指定されたプリンタ定義ファイルに、数値ではないユーザー定義プリンタ・コードが含まれています。
処置:	ユーザー定義プリンタ・コードを数値に変更してください。


REP-1898:  プリンタ定義ファイル: <filename>の行: <number>、列: <number>でエラーが発生しました。ハイライト設定は一度だけ定義できます。

原因:	指定されたプリンタ定義ファイルに、複数のハイライト設定が含まれています。
処置:	プリンタ定義ファイルにあるハイライト設定を、1つを残してすべて削除してください。


REP-1899:  グラフィック・ディスプレイまたはアイコンを.gif形式に変換できません。イメージはスキップされました。

原因:	Report Builderが、埋込みチャートまたはアイコンを、HTMLドキュメント内で表示するためのGIF形式に変換できませんでした。これは、Report Builderがイメージを描画するためのウィンドウ・システムへアクセスできない場合にだけ発生します。
処置:	Report Builderが図表にアクセスできるように、ウィンドウ・システムで実行可能なビットマップを使用してレポートを実行してください。


REP-1920:  キャラクタ・モード・ランタイムは、PDF、HTML、HTMLCSS、RTFのDESFORMATと互換性がありません。

原因:	宛先フォーマットPDF、HTML、HTMLCSSまたはRTFでレポートを実行しようとしています。これらのフォーマットが使用できるのは、ビットマップ環境での実行中およびビットマップ出力の作成中だけです。
処置:	実行可能なビットマップを使用してレポートを再実行するか、または実行可能なビットマップを使用してすでに実行中の場合はMODE=BITMAPを設定してください。


REP-1940:  列: <number>、行: <number> ファイル: <filename>:、:visualorder,logicalorder,contextualshaping,contextuallayout,multibyte,pcharsetから指定してください。

原因:	プリンタ定義ファイルに、nlsコード文字列が含まれていますが、必須ワードが指定されていません。
処置:	プリンタ定義ファイルを編集して、必須ワード（visualorder、logicalorder、contextualshaping、contextuallayout、multibyteまたはpcharset）を追加してください。


REP-1941:  列: <number>、行: <number> ファイル: <filename>:、:「はい」または「いいえ」でなければなりません。

原因:	プリンタ定義ファイルに、次のうちの1つが含まれています。Visualorder、logicalorder、contextualshaping、contextuallayout、multibyteまたはpcharset。しかしyesまたはnoの指定がありません。
処置:	プリンタ定義ファイルを編集して、yesまたはnoを指定してください。


REP-1942:  列: <number>、行: <number> ファイル: <filename>:、:「pcharset」の後はキャラクタ・セット名でなければなりません。

原因:	プリンタ定義ファイルに含まれているpcharsetに、キャラクタ・セット名が指定されていません。
処置:	プリンタ定義ファイルを編集して、キャラクタ・セット名を指定してください。


REP-1943:  列: <number>、行: <number> ファイル: <filename>:、:定義済みキャラクタ・セットはサポートされていません。

原因:	プリンタ定義ファイルが、サポートされていないキャラクタ・セットを参照しています。
処置:	プリンタ定義ファイルを編集して、キャラクタ・セット名が正しいことを確認してください。


REP-1950:  指定されたソースは無効です。

原因:	RWCON60に対して指定したソースは、有効なソースではありません。
処置:	正しいオブジェクトまたはファイルを指定していて、更にそのファイルまたはオブジェクトに対してソース・タイプが正しいことを確認してください。


REP-1951:  指定された宛先は無効です。

原因:	RWCON60に対して指定した宛先は、有効な接続先ではありません。
処置:	正しいオブジェクトまたはファイルを指定していて、更にそのファイルまたはオブジェクトに対して宛先タイプが正しいことを確認してください。


REP-1952:  行先項目数が0であるか、またはソース項目数と一致しなければなりません。

原因:	「変換」ダイアログ・ボックス内、またはRWCON60使用中に指定した宛先項目のリストは、指定された項目数が0（ゼロ）より大きいにもかかわらず、指定されているソース項目数と一致しません。
処置:	Report Builderが、指定されたソース名から宛先名を導出できるようにするため、宛先をブランクのままにしておいてください。あるいは、指定された宛先名の数が指定されたソース名の数と一致していることを確認してください。注意: ソース指定でワイルドカードを使用する場合は、宛先名の数が展開されたワイルドカード・リストのソース項目の数と一致することを確認してください。


REP-2000:  ユーザー・イグジット・エラーです。

原因:	ユーザー・イグジットでエラーが発生しました。
処置:	ユーザー・イグジットを作成した場合は、コードをデバッグしてください。あるいは、DBAに連絡してください。


REP-2001:  IAF GET: 列: <column name>は不明です。

原因:	ユーザー・イグジットのIAF GET文に、不明な列名を指定しました。
処置:	IAF GET文に、有効な列の名前を指定していることを確認してください。


REP-2002:  IAF PUT: 列: <column name>は不明です。

原因:	ユーザー・イグジットのIAF PUT文に、不明な列名を指定しました。
処置:	IAF PUT文に、有効な列の名前を指定していることを確認してください。


REP-2003:  ユーザー・イグジットが見つかりません。

原因:	Report Builderが、ユーザー・イグジットを見つけられませんでした。ほとんどの場合、ユーザー・イグジット・コードの名前または位置（あるいはその両方）が正しく指定されていないことが原因です。
処置:	ユーザー・イグジットを作成した場合は、インストール時に、コードの名前と位置を正しく指定したことをチェックしてください。あるいは、DBAに連絡してください。


REP-2004: 警告 - <object name>のPL/SQLソース・コードを取り出せません。
• REP-2004:  警告 - <object name>のPL/SQLソース・コードを取り出せません。

原因:	1つ以上のレポートを文書化するために、「ファイル」 [image] 「管理」 [image] 「レポート文書」を選択しましたが、RWEPLSユーザー・イグジットは、オブジェクトのPL/SQLソース・コードの取出しに失敗しました。これはほとんどの場合、異常な状態です。
処置:	指定されたオブジェクト内のPL/SQLソース・コードをチェックしてください。詳細は、「異常な状態」を参照してください。


REP-2005:  IAF PUT: 列: <column name>の値が切り捨てられました。

原因:	IAF PUT文が指定された列に値を割り当てましたが、列には値全体を入れる幅がなかったので切捨てが行われました。
処置:	列の幅を拡げて、値全体が入るようにしてください。


REP-2100:  計算マネージャ・エラーです。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-2101:  計算マネージャ: ソース列は、セグメント化メモリーを使用できません。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-2102:  計算マネージャ: 計算された列は、セグメント化メモリーを使用できません。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-2103:  列: <column name> : PL/SQL式は無効な値を戻したか、値を戻しませんでした。

原因:	入力したSRW.DO_SQL文が原因で、Oracleメッセージが表示されました。
処置:	SRW.DO_SQL文を編集してください。Oracleメッセージの詳細は、『Oracle8 Serverメッセージおよびコード・マニュアル』を参照してください。


REP-2300:  <Oracle message>

原因:	入力したSRW.DO_SQL文が原因で、Oracleメッセージが表示されました。
処置:	SRW.DO_SQL文を編集してください。Oracleメッセージの詳細は、『Oracle8 Serverメッセージおよびコード・マニュアル』を参照してください。


REP-2301:  SQLDA記述子の割当て中にエラーが発生しました。<Oracle message>

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-2302:  SQL文の解析中にエラーが発生しました。<Oracle message>

原因:	Report Builderで、SRW.DO_SQL文の解析中にエラーを検出しました。
処置:	Oracleメッセージを参照して、SQL文が解析できなかった理由を調べてください。


REP-2303:  バインド変数の記述中にエラーが発生しました。<Oracle message>

原因:	Report Builderで、SRW.DO_SQL文の中のバインド変数を記述中にエラーを検出しました。
処置:	Oracleメッセージを参照して、選択リストが記述できなかった理由を調べてください。


REP-2304:  SQLカーソルのオープン中にエラーが発生しました。<Oracle message>

原因:	Report Builderで、SRW.DO_SQL文の中のカーソルをオープンしようとしているときにエラーを検出しました。
処置:	Oracleメッセージを参照して、カーソルがオープンできなかった理由を調べてください。


REP-2305:  選択リストの記述中にエラーが発生しました。<Oracle message>

原因:	Report Builderで、SRW.DO_SQL文の中の選択リストを記述中にエラーを検出しました。
処置:	Oracleメッセージを参照して、選択リストが記述できなかった理由を調べてください。


REP-2306:  バインド変数のフェッチ中にエラーが発生しました。<Oracle message>

原因:	Report Builderで、SRW.DO_SQL文の中のバインド変数フェッチ中にエラーを検出しました。
処置:	Oracleメッセージを参照して、バインド変数がフェッチできなかった理由を調べてください。


REP-2307:  データのフェッチ中にエラーが発生しました。<Oracle message>

原因:	Report Builderで、SRW.DO_SQL文の中のデータをフェッチ中にエラーを検出しました。
処置:	Oracleメッセージを参照して、データがフェッチできなかった理由を調べてください。


REP-2308:  選択リストの処理中にエラーが発生しました。<Oracle message>

原因:	Report Builderで、SRW.DO_SQL文の中の選択リストを処理中にエラーを検出しました。
処置:	Oracleメッセージを参照して、選択リストが無効である理由を調べてください。


REP-2309:  Dateフィールドのフォーマット中にエラーが発生しました。<Oracle message>

原因:	Report Builderで、SRW.DO_SQL文の中のDateフィールドをフォーマット中にエラーを検出しました。
処置:	Oracleメッセージを参照して、Dateフィールドがフォーマットできなかった理由を調べてください。


REP-2310: 列への値の入力中にエラーが発生しました。<Oracle message>

原因:	Report Builderで、SRW.DO_SQL文の中の列に値を挿入しようとしているときにエラーを検出しました。
処置:	Oracleメッセージを参照して、値が割り当てられなかった理由を調べてください。


REP-2311:  コミット中にエラーが発生しました。<Oracle message>

原因:	Report Builderで、SRW.DO_SQL文の中のコミットを実行しようとしているときにエラーを検出しました。
処置:	Oracleメッセージを参照して、コミットが失敗した理由を調べてください。


REP-2312:  データの割当て中にエラーが発生しました。<Oracle message>

原因:	Report Builderで、SRW.DO_SQL文の中のデータを割当て中にエラーを検出しました。
処置:	Oracleメッセージを参照して、データが割り当てられなかった理由を調べてください。


REP-2313:  選択リストの解析中にエラーが発生しました。<Oracle message>

原因:	Report Builderで、SRW.DO_SQL文の中の選択リストを解析中にエラーを検出しました。
処置:	Oracleメッセージを参照して、選択リストが解析できなかった理由を調べてください。


REP-2314:  SQLカーソルのクローズ中にエラーが発生しました。<Oracle message>

原因:	Report Builderで、SRW.DO_SQL文の中のSQLカーソルをクローズしようとしているときにエラーを検出しました。
処置:	Oracleメッセージを参照して、カーソルのクローズ操作が失敗した理由を調べてください。


REP-2315:  データの解放中にエラーが発生しました。<Oracle message>

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-2316:  列: <column name>が不明です。

原因:	SRW.DO_SQL文の中で参照されている列が見つかりません。
処置:	PL/SQLをデバッグして、SRW.DO_SQL文に正しい列名が含まれていることを確認してください。


REP-2317:  列: <column name>の値が切り捨てられました。

原因:	SRW.DO_SQL文によって取得された列値が、切り捨てられました。
処置:	列のプロパティ・パレットで、列の幅を拡げてください。または、SRW.DO_SQL文によって列に入力される値のサイズを制限してください。


REP-2400:  デバッグ: 内部エラー0（ゼロ）です。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-2500  エラー<error number>が発生しました。このエラーに関する情報は、リリース・ノート・ファイル(relnotes)を参照してください。

原因:	Report Wizardでレイアウトの初期化を試みたときに、エラーが発生しました。
処置:	リリース・ノート・ファイルを参照してください。


REP-3000:  Oracle Toolkitの起動中に内部エラーが発生しました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3001:  ファイル・ダイアログの初期化中に内部エラーが発生しました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3002:  プリンタの初期化中にエラーが発生しました。プリンタがインストールされているか確認してください。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3020:  Oracleリソース・マネージャの起動中にエラーが発生しました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3021:  メニュー・リソースの処理中に内部エラーが発生しました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3022: ウィンドウ・リソースの処理中に内部エラーが発生しました。
• REP-3022:  ウィンドウ・リソースの処理中に内部エラーが発生しました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3023:  リソース・ファイルが見つかりません。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3040:  Oracleオブザーバ・モデルの開始中に内部エラーが発生しました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3060:  カラー表の初期化中に内部エラーが発生しました。VGSリソースをチェックしてください。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3080:  Oracle Imageの初期化中に、内部エラーが発生しました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3081:  イメージ・ビューアを実行中にエラーが発生しました。

原因:	定義されたイメージ表示のアクションでプレビューアのボタンを選択しましたが、イメージ・ビューアが使用できません。このエラーの原因として、次のことが考えられます。
	ケース1:	ソースとして指定されたイメージの形式に誤りがあります。
	ケース2:	メモリーが不足しています。
	ケース3:	これは異常な状態です。
処置:	このエラーの訂正には、次の処置を行ってください。
	ケース1の場合:	ボタン・アクションのソースとして指定されたイメージ・ファイルが、表示可能形式であることを確認してください。
	ケース2の場合:	可能であれば、使用可能なメモリーを増やしてください。 または、システム管理者に連絡してください。
	ケース3の場合:	詳細は、「異常な状態」を参照してください。


REP-3082:  サウンド・ダイアログを実行中にエラーが発生しました。

原因:	定義されたサウンド再生のアクションでプレビューアのボタンを選択しましたが、サウンド・ダイアログが使用できません。このエラーの原因として、次のことが考えられます。
	ケース1:	ソースとして指定されたサウンド・ファイルの形式に誤りがあります。
	ケース2:	メモリーが不足しています。
	ケース3:	これは異常な状態です。
処置:	このエラーの訂正には、次の処置を行ってください。
	ケース1の場合:	ボタン・アクションのソースとして指定されたサウンド・ファイルが、再生可能形式であることを確認してください。
	ケース2の場合:	可能であれば、使用可能なメモリーを増やしてください。 または、システム管理者に連絡してください。
	ケース3の場合:	詳細は、「異常な状態」を参照してください。


REP-3083:  ビデオ・プレーヤを実行中にエラーが発生しました。

原因:	定義されたビデオ再生のアクションでプレビューアのボタンを選択しましたが、ビデオ・プレーヤが使用できません。このエラーの原因として、次のことが考えられます。
	ケース1:	ソースとして指定されたビデオ・ファイルの形式に誤りがあります。
	ケース2:	メモリーが不足しています。
	ケース3:	これは異常な状態です。
処置:	このエラーの訂正には、次の処置を行ってください。
	ケース1の場合:	ボタン・アクションのソースとして指定されたビデオ・ファイルが、再生可能形式であることを確認してください。
	ケース2の場合:	可能であれば、使用可能なメモリーを増やしてください。 または、システム管理者に連絡してください。
	ケース3の場合:	詳細は、「異常な状態」を参照してください。


REP-3085:  マルチメディア・ソース・ファイル: <filename>が見つかりませんでした。

原因:	プレビューアのボタンをアクティブにしましたが、そのボタンで想定されていたアクション（サウンドまたはイメージ、ビデオ）のソースが見つからないか、または壊れています。
処置:	問題のボタンのプロパティ・パレットをオープンして、指定されたソース・ファイルの存在、形式およびパス情報を検証してください。


REP-3086:  マルチメディア・ソース・ファイルが間違っています。

原因:	プレビューアのボタンをアクティブにしましたが、そのボタンで想定されていたアクション（サウンドまたはイメージ、ビデオ）のソースが壊れています。
処置:	問題のボタンのプロパティ・パレットをオープンして、指定されたソース・ファイルの存在、形式およびパス情報を検証してください。これらが正しい場合は、ファイル自体をチェックしてください。


REP-3087:  この構成では、イメージ・ビューアはサポートされていません。

原因:	ご使用のプラットフォームまたは構成（あるいはその両方）では、イメージ・ビューアによるイメージ表示はサポートされていません。
処置:	処置は不要です。


REP-3088:  この構成では、サウンドはサポートされていません。

原因:	使用しているプラットフォームまたは構成（あるいはその両方）では、サウンド・ファイルの再生はサポートされていません。
処置:	処置は不要です。


REP-3089:  この構成では、ビデオはサポートされていません。

原因:	使用しているプラットフォームまたは構成（あるいはその両方）では、ビデオ・ファイルの再生はサポートされていません。
処置:	処置は不要です。


REP-3100:  マトリックスには、少なくとも縦および横繰返し枠が1つずつ必要です。

原因:	レイアウト・モデル・エディタで正しいオブジェクトを選択せずに、マトリックスを作成しようとしました。マトリックス・レイアウトでは、少なくとも繰返し方向が縦のグループが1つと、繰返し方向が横のグループが1つあることが必要です。
処置:	レポート・ウィザードを起動してマトリックスを作成しなおしてください。


REP-3101:選択された縦および横の繰返し枠はすべてネストされなければなりません。

原因:	マトリックスを作成しようとしましたが、縦および横繰返し枠が正しくオーバーラップおよびネストされていません。
処置:	マトリックスの作成を行う前に、選択された縦および横繰返し枠が正しくオーバーラップして、ネストされていることを確認してください。


REP-3102:  アンカー、マトリックスおよびマージンはグループ化できません。

原因:	「配置」 [image] 「グループ化」を選択しましたが、選択されたオブジェクトのうちの少なくとも1つがアンカー、マトリックスまたはマージンでした。
処置:	オブジェクトのグループ化を行う前に、すべてのアンカーおよびマトリックス、マージンを選択解除してください。


REP-3103:  テキストと図形ボイラープレートのみ回転させられます。

原因:	枠またはフィールド、マージン、アンカー、マトリックス・オブジェクト、リンク・ファイル・ボイラープレート、チャート、OLE2オブジェクト、ボタンのいずれかを回転しようとしました。これらを回転することはできません。
処置:	イメージおよびリンク・ファイル・ボイラープレート以外のボイラープレート・オブジェクトは回転できます。回転されたボイラープレート・テキストのテキストを表示できるかどうかは、使用しているオペレーティング・システムによります。


REP-3104:  アンカーおよびマトリックスは、関連オブジェクトから別にスケールを変更できません。

原因:	前述でリストされたレイアウト・オブジェクトのうちの1つのスケール変更を、関係付けられたオブジェクトのスケール変更を行わずに試みました。この処理は、許可されていません。
処置:	少なくとも1つの関係付けられたオブジェクト（アンカーに対してはアンカー・オブジェクト、マトリックスに対しては繰返し枠）を選択してから、スケール変更操作を再試行してください。


REP-3105:  チャート問合せには、チャート列を選択してください。

原因:	チャート問合せに対して名前を入力しましたが、チャート列を選びませんでした。チャート問合せを指定する場合は、チャート列も指定する必要があります。
処置:	チャート列を指定するか、またはチャート問合せの値を削除してください。


REP-3106:  警告: 選択されたチャート列にチャート問合せ名がありません。選択されたチャート列は無視されます。

原因:	レポート列またはチャート列を選択しましたが、チャート問合せの名前を入力しませんでした。
処置:	データを渡すチャート問合せの名前を入力してください。


REP-3107:  オブジェクト: <object name>は、子: <object name>の前では移動できません。操作は許可されませんでした。

原因:	レイアウト・オブジェクトを、それ自身の1つ以上の子オブジェクトの前に移動しようとしました。
処置:	レイアウト・オブジェクトを移動する場合は、制限モードをオフにしてから移動してください。移動しない場合は、処置は不要です。


REP-3108: オブジェクト: <object name>は、コンテナ: <object name>の後には移動できません。操作は許可されませんでした。

原因:	レイアウト・オブジェクトを、それ自身の1つ以上の親オブジェクトの後に移動しようとしました。
処置:	レイアウト・オブジェクトを移動する場合は、制限モードをオフにしてから移動してください。移動しない場合は、処置は不要です。


REP-3109: 警告: 整列操作は、コンテナ制約のために失敗しました。変更内容を元に戻して、元の状態に回復してください。

原因:	複数のレイアウト・オブジェクトを整列させようとしましたが、このような操作を行うと、コンテナ制約に違反する（つまり、囲んでいる枠の外にフィールドを移動する）ことになります。
処置:	「編集」 [image] 「元に戻す」を選択して、レイアウトをこの操作を試みる前の状態にしてください。その後、この操作を行う場合は、問題のコンテナをサイズ変更または位置変更してください。 または、何もしなくてもかまいません。


REP-3110:  警告: 同一サイズ操作は、コンテナ制約のために失敗しました。変更内容を元に戻して、元の状態に回復してください。

原因:	1つ以上のレイアウト・オブジェクトを同じサイズに変更しようとしましたが、このような操作を行うと、コンテナ制約に違反する（つまり、囲んでいる枠外までフィールドを拡大する）ことになります。
処置:	「編集」 [image] 「元に戻す」を選択して、レイアウトをこの操作を試みる前の状態にしてください。その後、この操作を行う場合は、問題のコンテナをサイズ変更または位置変更してください。 または、何もしなくてもかまいません。


REP-3111:  <object name>の境界幅を変更すると、制限モードの制約に違反します。操作は許可されませんでした。

原因:	オブジェクト境界線幅の変更を行おうとしましたが、このような操作を行うと、コンテナ制約に違反する（つまりボイラープレート・オブジェクトの境界線の幅を拡げることによって、囲んでいる枠外までボイラープレート・オブジェクトが拡張される）ことになります。
処置:	処置は不要です。


REP 3112. テンプレートのレイアウト・ボディ層ではオブジェクトを作成することはできません。

原因:	テンプレートのレイアウト・ボディ層でオブジェクトを作成しようとしました。オブジェクトは、テンプレートのマージン、ヘッダー、トレーラ・ページでのみ作成できます。
処置:	処置は不要です。


REP-3130:  パラメータ・フォーム・フィールドおよびイメージを回転できません。

原因:	前述でリストされたパラメータ・フォーム・オブジェクトのうちの1つを回転しようとしました。この処理は、許可されていません。
処置:	パラメータ・フォーム・エディタでは、イメージ以外のボイラープレート・オブジェクトは回転させることができます。回転されたボイラープレート・テキストのテキストを表示できるかどうかは、使用しているオペレーティング・システムによります。


REP-3131:  パラメータ・フォーム・ボイラープレートはページに内に入りません。

原因:	Parameter Form Builderの「タイトル」、「ヒント行」、「ステータス行」または「ラベル」のフィールドに入力したテキストが、長すぎてページに収まりません。
処置:	当てはまるテキスト・フィールドを短くしてください。


REP-3140:  プログラム単位エディタ内部エラー。モジュール・ハンドルを取得できませんでした。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3150:  各レポートに1つのエディタがオープンされていなければなりません。

原因:	レポートに対して、3つのエディタ（データ・モデルおよびレイアウト・モデル、パラメータ・フォーム）すべてをクローズしようとしました。少なくとも1つのエディタは、オープンしておく必要があります。
処置:	レポートごとに、1つのエディタをオープンしておいてください。


REP-3151: 列: <column name>の無効な幅は、グループ: <group name>が選択されていないため、強調されません。

原因:	レポート・ウィザードにある列に対して、幅に無効な値が入力されました。その列を所有するグループが選択されていないので、列はリストされていません。
処置:	その列を所有するグループを選択してください。列を下へスクロールして、幅に有効な値を入力してください。


REP-3152: リンク、アンカーまたは多角形の作成は、このアクションの前にペインタで完了してください。
• REP-3152:  リンク、アンカーまたは多角形の作成は、このアクションの前にペインタで完了してください。

原因:	データ・モデル・エディタでのデータ・リンクの作成またはレイアウト・モデル・エディタでのアンカー作成、レイアウト・モデル・エディタまたはパラメータ・フォーム・エディタでの多角形作成の終了前に、なんらかのアクション（たとえば、レポートのクローズ）を実行しようとしました。
処置:	続行前に、終了していないオブジェクトを完了してください。


REP-3153:  ウィンドウを作成するリソースがありません。

原因:	要求されたウィンドウを作成するのに変更可能なリソースが十分ではありませんでした。
処置:	ウィンドウまたは他のアプリケーションをクローズして、変更可能なリソースを増やしてください。


REP-3154:  モジュールを作成するリソースがありません。

原因:	要求されたモジュール（レポート、外部問合せ、PL/SQLライブラリ）を作成するのに変更可能なリソースが十分ではありませんでした。おそらく、「ファイル」 [image] 「新規作成」、「ファイル」 [image] 「オープン」または「ファイル」 [image] 「変更の破棄」を選択しました。
処置:	ウィンドウまたは他のアプリケーションをクローズして、変更可能なリソースを増やしてください。


REP-3200:  同時プレビューア・アクションは許可されていません。

原因:	同じプレビューアまたは複数のプレビューアで、一度に2つ以上のボタンをアクティブにしようとしています。たとえば、サウンドの再生とビデオの表示を同時に行おうとしている可能性があります。この処理は、許可されていません。
処置:	アクティブにするボタンは一度に1つのみにしてください。


REP-3300:  回復不能エラー: <additional messages>。

これは異常な状態です。詳細は、「異常な状態」を参照してください。

ヒント1: ORACLE_HOME\REPORTS60\ TMPディレクトリに、ファイルを作成するのに十分なスペースがあること、そのディレクトリに書き込み権限があることを確認してください。

ヒント2: システムでどのプリンタ・ドライバを使用しているかを確認します。違うドライバを使用することで、この問題が解消されないかを調べます。

原因:	サーバーの移行を行って、新しいサーバーで古いレポートを実行しようとしました。
処置:	Installerを使用して、同じoracle_homeディレクトリのReports、Oracle ServerおよびOracleデータベースがあるoracle_home/binディレクトリに、古いOracle Server .DLLをすべてインストールします。
原因:	インストールされていないフォントが必要なレポートを実行しようとしました。
処置:	必要なフォントをダウンロードしてインストールします。


REP-3301:  エラーが発生しました: <additional messages>。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3302:  終了中に致命的なエラーが発生しました。Report Builderを終了しています。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3335:  処理不能内部CAエラー。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3350:  処理不能内部UIエラー。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3351:  UIに未定義障害があります。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3352:  UIに予期しないエラーが発生しました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3353:  作成できない属性を使用して作成しようとしました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3354:  設定できない属性を使用して設定しようとしました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3355:  取得できない属性を使用して設定しようとしました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3356:  不明な属性を設定/取得しようとしました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3357:  矛盾する属性値を設定しようとしました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3358:  有効範囲外の値に属性定義しようとしました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3359:  このファンクション呼出しはコンテキストに合いません。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3360:  ビュー・クラスではスクロールの対象としての指定はできません。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3361:  このファンクション呼出しは間違った再帰呼出しを引き起こします。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3362:  内部APIメモリー・アロケータにエラーが発生しました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3363:  クライアントが指定したメモリー割当て機能でエラーが発生しました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3364:  サポートされていないファンクションを使用しようとしました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3365:  コンテキストに合わない属性を設定しようとしました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3366:  ルート・ビューで無効な操作を行おうとしました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3367:  ファンクションに対するパラメータのいずれかが許容範囲外です。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3368:  ウィンドウ表示システムへの接続に失敗しました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3369:  ウィンドウ表示システムへの接続が切れています。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3370:  ウィンドウ表示システムにエラーが発生しました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3371:  uiER_CL_FORMAT_UNAVAILABLE

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3372:  uiER_CL_FORMAT_UNREGISTERED

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3373: 操作が時間切れになりました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3374:  uiER_NOT_FOUND

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3375:  uiER_ILLEGAL_TOPITEM

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3376:  uiER_SE_BAD_FORMAT

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3377:  ビュー・クラスはスクローラ・インタフェースをサポートしていません。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3378:  パレットから読込み共有カラーを除去しようとしました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3379:  ウィンドウを作成できません。

原因:	Report Builderがウィンドウを作成できませんでした。オープンしているレポートまたはウィンドウの数が多すぎて、メモリー・リソースが不足していると考えられます。
処置:	いくつかのレポートおよびウィンドウをクローズしてください。


REP-3380:  ビューを作成できません。

原因:	Report Builderがビューを作成できませんでした。オープンしているレポートまたはウィンドウの数が多すぎて、メモリー・リソースが不足していると考えられます。
処置:	いくつかのレポートおよびウィンドウをクローズしてください。


REP-3381: カラー・パレットを作成できません。

原因:	Report Builderが、カラー・パレットを作成できませんでした。オープンしているレポートまたはウィンドウの数が多すぎて、メモリー・リソースが不足していると考えられます。
処置:	いくつかのレポートおよびウィンドウをクローズしてください。


REP-3400:  DEの初期化エラーです。DEリソースをチェックしてください。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3420:  Report Builderで内部エラーが発生しました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3430:  未処理の内部HHエラーです。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3431:  属性値は無効です。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3432:  コンテキストは無効です。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3433:  指定されたワードは見つかりません。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3434:  外部モジュールにリンクしています。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3435:  ヘルプ・セッションには何もありません。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3436:  そのマニュアルはヘルプ・マニュアルではありません。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3437:  マニュアルのバージョンがヘルプのバージョンよりも新しいです。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3438:  指定された属性を設定できません。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3439:  指定された属性を取得できません。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3440:  リンクは無効です。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3441:  論理属性が抜けているか無効です。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3442:  NLS言語文字列が抜けているか無効です。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3443:  検索文字列が指定されていません。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3444:  文字列がパーセント記号で始まっています。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3445:  不明なToolkitエラーです。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3446:  不明なオブジェクト・ストア・エラーです。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3447:  メモリーが足りません。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3448: 不明なリソース・マネージャ・エラーです。
• REP-3448:  不明なリソース・マネージャ・エラーです。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3480:  未処理の内部REMエラーです。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3485:  未処理の内部VGSエラーです。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3500:  未処理の内部UTエラーです。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3510:  未処理の内部ZOMエラーです。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3600:  文書ノードと非文書ノードの両方が選択されています。これらのノードのうちどちらか一方のみを選択してください。

原因:	「ナビゲータ」 [image] 「削除」を選択しましたが、オブジェクト・ノードとドキュメント・ノードの両方が選択されています。ドキュメントのクローズとオブジェクトの削除を同時に行うことはできません。
処置:	オブジェクトを削除する場合は、すべてのドキュメント・ノードを選択解除してください。ドキュメントをクローズする場合は、すべてのオブジェクト・ノードを選択解除してください。その後、「ナビゲータ」 [image] 「削除」をもう一度選択してください。


REP-3601:  このレポート・スタイルでは、1つのセクションしか持てません。

原因:	「表」、「フォーム・レター」および「メール・ラベル」レポート・スタイルが持てるのは、それぞれ1セクションのみです。
処置:	既存のセクションにあるすべての上書きを指定する必要があります。


REP 3602. 最低数を下回るような削除はできません。

原因:	表、フォーム・レター、メール・ラベルのレポート・スタイルは、それぞれ1つのセクションを持ちます。グループ上とグループ左のレポート・スタイルは、それぞれ2つのセクションを持ちます。マトリックスとマトリックス・グループは、ノーマル、横、下、セルの下にそれぞれ1つのセクションを持ちます。
処置:	詳細は、「異常な状態」を参照してください。


REP-3700:  選択オブザーバの初期化は失敗しました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-3701:  遮断中に選択オブザーバが失敗しました。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-4001:  OLEサブシステムでエラーが発生しました。

原因:	初期化中に、未指定のOLE2エラーが発生しました。詳細は、一緒に表示されるOLEエラー・メッセージを参照してください。このエラーのその他の原因として、次のことが考えられます。
	ケース1:	OLE2サーバーが正しく機能していません。
	ケース2:	Report Builderのインストール中にエラーが発生して、OLE2機能が正しくインストールされませんでした。
	ケース3:	これは異常な状態です。
処置:	このエラーの訂正には、次の処置を行ってください。
	ケース1の場合:	詳細は、OLE2サーバーのマニュアルを参照してください。
	ケース2の場合:	Report Builderを再インストールしてください。
	ケース3の場合:	詳細は、「異常な状態」を参照してください。


REP-4002:  OLEサブシステムの初期化中に、エラーが発生しました。

原因:	OLE2ライブラリの初期化中に、エラーが発生しました。詳細は、一緒に表示されるOLEエラー・メッセージを参照してください。このエラーのその他の原因として、次のことが考えられます。
	ケース1:	OLE2サーバーが正しく機能していません。
	ケース2:	Report Builderのインストール中にエラーが発生して、OLE2機能が正しくインストールされませんでした。
	ケース3:	これは異常な状態です。
処置:	このエラーの訂正には、次の処置を行ってください。
	ケース1の場合:	詳細は、OLE2サーバーのマニュアルを参照してください。
	ケース2の場合:	Report Builderを再インストールしてください。
	ケース3の場合:	詳細は、「異常な状態」を参照してください。


REP-4003:  OLEオブジェクトを作成中にエラーが発生しました。

原因:	OLEエラーが発生したときに、OLE2オブジェクトを作成しようとしていました。
処置:	詳細は、一緒に表示されるOLE2エラー・メッセージを参照してください。


REP-4004:  OLEオブジェクトを回復中にエラーが発生しました。

原因:	OLEエラーが発生したときに、OLE2オブジェクトを復元しようとしていました。
処置:	詳細は、一緒に表示されるOLE2エラー・メッセージを参照してください。


REP-4005:  OLEオブジェクトを保存中にエラーが発生しました。

原因:	OLEエラーが発生したときに、OLE2オブジェクトを保存しようとしていました。
処置:	詳細は、一緒に表示されるOLE2エラー・メッセージを参照してください。


REP-4006:  カット/コピー操作を実行中にエラーが発生しました。OLEオブジェクトはクリップボード上にはありません。

原因:	OLEエラーが発生したときに、OLE2オブジェクトをカットまたはコピーしようとしていました。
処置:	詳細は、一緒に表示されるOLE2エラー・メッセージを参照してください。


REP-4007:  OLEオブジェクトをクリップボードからペースト中にエラーが発生しました。

原因:	OLEエラーが発生したときに、OLE2オブジェクトをクリップボードからペーストしようとしていました。
処置:	詳細は、一緒に表示されるOLE2エラー・メッセージを参照してください。


REP-4008:  OLEオブジェクトによって定義された操作を実行しようとしている間にエラーが発生しました。

原因:	OLEエラーが発生したときに、OLE2サーバーが通常サポートしているアクションを実行しようとしていました。
処置:	詳細は、一緒に表示されるOLEエラー・メッセージを参照してください。


REP-4009:  OLEオブジェクトをアクティブにしようとしている間にエラーが発生しました。

原因:	OLEエラーが発生したときに、OLE2オブジェクトをアクティブにしようとしていました（たとえば、プレビューア内でOLE2オブジェクトをダブルクリックしました）。
処置:	詳細は、一緒に表示されるOLE2エラー・メッセージを参照してください。


REP-4020:  OLEオブジェクトの異なるタイプへの変換は失敗しました。

原因:	OLEエラーが発生したとき、ボイラープレートの一部に含まれているOLE2オブジェクトを別のタイプのOLE2オブジェクトに変換しようとしていました。これは、OLE2サーバーに問題があることを示しています。
処置:	オブジェクトが正しくインストールされていることをチェックして、必要があれば再インストールしてください。


REP-4021:  Microsoftオブジェクトのリンクと埋込みは、このプラットフォーム上ではサポートされていません。

原因:	OLE2をサポートしているプラットフォーム上で、OLE2オブジェクトを使用して作成されたレポートを実行していますが、現在実行中のプラットフォームはOLE2をサポートしていません。OLE2オブジェクトだった視覚的な表現にアクセスしようとしています。
処置:	処置は不要です。希望する場合は、そのオブジェクトを削除してください。


REP-4022:  OLEライブラリのバージョンが間違っています。OLE機能を使用できなくなります。

原因:	マシンにインストールされているOLE2ライブラリは、使用しているReport Builderのバージョンでサポートされているライブラリと互換性がありません。Report BuilderはOLE2サポートが機能することを保証できないために、OLE2機能を使用不可にします。
処置:	正しいライブラリをインストールしてください。


REP-4023:  操作を完了するためのメモリーが不足しています。

原因:	希望するアクションを実行するのに十分なメモリーがシステムにありません。
処置:	実行中の不要なアプリケーションを終了してください。この処置で効果がない場合は、メモリーの使用効率を向上させるための手順についてMicrosoftのマニュアルを参照してください。


REP-4024:  DOS SHAREサービスでは、操作を成功する必要がありました。SHAREは実行されていません。

原因:	DOS SHAREユーティリティが必要ですが、SHAREが実行中ではありません。
処置:	SHAREが実行中であることを確認してください。


REP-4025:  読込みに失敗しました。

原因:	指定されたデバイスからデータを読み込めません。
処置:	デバイスをチェックして、誤動作でないかどうかを確認してください。 誤動作である場合は、デバイスのマニュアルを参照して、適正なエラー回復手順を判断してください。


REP-4026:  書込みに失敗しました。

原因:	指定されたデバイスにデータを書き込めません。
処置:	デバイスが読込み専用でないかどうかをチェックしてください。読込み専用ではない場合は、デバイスのマニュアルを参照して、適正なエラー回復手順を判断してください。


REP-4027: オープンされているファイルが多すぎます。別のファイルをオープンするだけの十分なリソースがありません。

原因:	Windowsでサポートされている数よりも多くのファイルをオープンしようとしています。
処置:	いくつかのアプリケーションをクローズしてください。さらに、config.sysファイルをチェックして、FILESが20より小さい設定になっていないことを確認してください。注意: OLE2ボイラープレート・オブジェクトがオブジェクトごとに2つまたは3つのファイル・ハンドルを予約することを忘れないでください。 そのため、ユーザーが意識している以上のファイルがオープンされていることがあります。


REP-4028: デバイス上に空き領域が残っていません。

原因:	指定されたデバイスがいっぱいです。
処置:	不要なデータを削除するかまたは別のデバイスに書き込んでください。


REP-4029: OLEオブジェクトを表示できません。
REP-4029:  OLEオブジェクトの表示に失敗しました。OLEオブジェクトを表示できません。

原因:	レポートにOLE2オブジェクトを表示しようとしましたが、OLE2サーバーによって定義されている表示様式が使用できませんでした。
処置:	OLE2オブジェクトが壊れていないことおよびサーバーが正しくインストールされていることを確認してください。必要であれば、再インストールしてください。


REP-4030:  OLEオブジェクトのオリジナル表示面の回復に失敗しました。オブジェクトの内容が使用されます。

原因:	レポートにOLE2オブジェクトを表示しようとしましたが、OLE2サーバによって定義されている表示様式が壊れているかまたはデータベースに格納されていて、復元できませんでした。Report Builderではデフォルト様式を使用してオブジェクトを表示します。
処置:	OLE2サーバーが正しくインストールされていることを確認してください。必要であれば、再インストールしてください。


REP-4031:  サーバー・アプリケーションが見つかりません。アプリケーションが適切にインストールされ、正しく登録されていることを確認してください。

原因:	OLE2オブジェクトによってOLE2サーバーにアクセスしようとしていますが、サーバーが現在アクセス不可です。サーバーが、削除または改名されているか、別の場所に手動で再インストールされている可能性があります。
処置:	サーバーのインストールをチェックして、必要であれば再インストールしてください。


REP-4032:  リンクOLEオブジェクト・ソースに接続できません。リンク・ソースが移動/改名/削除されていないことを確認してください。

原因:	Report Builderが、OLE2オブジェクト・ボイラープレートの指定されたソースにアクセスしようとしていますが、アクセスできません。
処置:	OLE2オブジェクト・ソースが移動または削除されていないことおよびファイル名が変更されていないことを確認してください。


REP-4033: リンク･オブジェクト･ソースに接続できません。このリンク・オブジェクト・ソースはこのマシンに接続されていないネットワークを横切っています。

原因:	ネットワーク接続が現在確立されていないデバイスに格納されているOLE2オブジェクトに、リンクしようとしています。
処置:	適切なデバイスとの接続を確立してください。


REP-4034:  ファイルが見つからないか、OLEオブジェクトが使用しているファイルは無効です。

原因:	OLE2オブジェクトがアクセスしようとしているファイルが見つかりません。
処置:	ファイルが壊れていない、移動または改名されていないことを確認してください。


REP-4035: OLEオブジェクト上での操作を実行中に共有違反が発生しました。
• REP-4035:  OLEオブジェクト上での操作を実行中に共有違反が発生しました。

原因:	考えられる原因:  複数のOLE2オブジェクトで同じファイルにリンクしようとしているか、異なるアプリケーションから同じファイルにアクセスしようとしています。
処置:	複数のOLE2オブジェクトで同時に同じファイルにアクセスしようとしていないことを確認してください。さらに、OLE2サーバーのインストールをチェックしてください。


REP-4036:  OLEオブジェクト上での操作を実行中にアクセスが拒否されました。

原因:	書込み権限を持っていないOLE2オブジェクトを更新しようとしています。
処置:	ファイルを更新しようとする前に、そのファイルに対する適切な権限を取得してください。


REP-4037: ディスクに書込み保護がかかっているので、OLEオブジェクト上でのファイル操作に失敗しました。

原因:	OLE2オブジェクトをファイルに保存しようとしましたが、ディスクが書込み禁止であるために保存できませんでした。
処置:	可能であれば、書込み権限を持っているディスクにそのオブジェクトを保存してください。それができない場合は、処置は不要です。


REP-4038:  OLEオブジェクトでの操作を実行中に、ファイル・システム上で予期せぬエラーが発生しました。

原因:	ハード・ディスクの破損など、特定できないファイル・エラーが発生しました。
処置:	詳細は、使用しているオペレーティング・システムのマニュアルを参照してください。


REP-4039:  OLEによって予期せぬエラーが戻されました。

原因:	特定できないOLEエラーが発生しました。
処置:	詳細は、Microsoftのマニュアルを参照してください。


REP-4040:  OLEオブジェクトのデータが誤っているか、壊れています。このデータからOLEオブジェクトを復元できません。

原因:	レポート内のOLE2オブジェクトを復元するためにOLEサーバーで使用されている情報が、誤っているかまたは壊れています。このエラーの原因として、次のことが考えられます。
	ケース1:	ボイラープレートの場合、ファイルが壊れています。
	ケース2:	フィールドの場合、データベースが壊れているかまたは参照されているLONG RAW列にOLE2オブジェクトが含まれていません。
処置:	このエラーの訂正には、次の処置を行ってください。
	ケース1の場合:	別のアプリケーションを使用してコンテナに埋め込むと、そのオブジェクトが実行可能になることを確認してください。
	ケース2の場合:	SQL Plusを使用してデータベースにある表をチェックし、その列の内容を確認してください。


REP-4041:  このオブジェクトで定義されている操作がないか、またはオブジェクトはスタティックです。

原因:	OLE2オブジェクトでなんらかのアクションを行おうとしましたが、そのオブジェクトに適用されるアクションが定義されていませんでした。あるいは、そのオブジェクトが静的ビットマップに変換されています。
処置:	処置は不要です。


REP-4042:  OLEオブジェクト上での要求操作は有効ですが、このタイミングでは実行できません。オブジェクト・サーバーがビジーである可能性があります。

原因:	OLE2オブジェクトで有効なアクションを行おうとしましたが、サーバー・リソースの不足のためにできませんでした。原因として、シングル・インスタンスのアプリケーションに2番目のインスタンスをオープンしようとしていることが考えられます。
処置:	システム・リソース（メモリー他）をチェックして、可能な場合はリソースを増やすかまたはこの操作を後で試してください。


REP-4043:  オブジェクトでの要求操作は無効で、実行できません。アプリケーションが適切にインストールされていることを確認してください。

原因:	OLE2オブジェクトで実行しようとしたアクションが、有効と認められていません。
処置:	適切なバージョンのOLEサーバーが正しくインストールされていることを確認してください。必要であれば、再インストールしてください。


REP-4044:  システム登録にアクセスできません。十分な解放システム・リソースがあり、登録が壊れていないことを確認してください。

原因:	システム・レジストリでの読込みまたは書込み操作に失敗しました。
処置:	Microsoftのマニュアルを参照してください。


REP-4045:  システム登録で問題が発生しました。オブジェクト・サーバーが適切にインストールされていることを確認してください。

原因:	サーバーに関する情報の一部が、レジストリにありません。
処置:	OLEサーバーが正しくインストールされていることを確認してください。必要であれば、再インストールしてください。


REP-4200:  メール・サブシステムでエラーが発生しました。

原因:	メール操作の1つを実行中に未指定のエラーが発生しました。詳細は、一緒に表示されるエラー・メッセージを参照してください。このエラーのその他の原因として、次のことが考えられます。
	ケース1:	MAPIが適切にインストールされていません。
	ケース2:	Windowsメール・サービス・プロバイダが適切にインストールされていません。
処置:	このエラーの訂正には、次の処置を行ってください。
	ケース1の場合:	MAPIを使用している別のアプリケーションがある場合は、それが正しく機能しているかどうかをチェックしてください。正しく機能していない場合は、MAPIを再インストールしてください。
	ケース2の場合:	Windowsメール・サービス・プロバイダがインストールされていて、そのシステムにアカウントがあることを確認してください。必要な場合は、メール管理者に連絡してください。


REP-4201:  メール・サブシステムを初期化中にエラーが発生しました。

原因:	Oracle ReportsがMAPIを初期化しようとしましたが、できませんでした。詳細は、一緒に表示されるエラー・メッセージを参照してください。このエラーのその他の原因として、次のことが考えられます。
	ケース1:	MAPIがインストールされていないかまたはMAPI DLLが古いか、WIN.INIファイルまたはシステム・レジストリのエントリが誤った位置を指し示しています。
	ケース2:	操作の実行に使用できるメモリーが十分にありません。
	ケース3:	ログイン中に、無効なサービス・プロファイル名またはユーザー名、パスワードを入力しました。
処置:	このエラーの訂正には、次の処置を行ってください。
	ケース1の場合:	MAPIを再インストールするか、WIN.INIファイルまたはシステム・レジストリのエントリを訂正してください。
	ケース2の場合:	実行中の不要なアプリケーションを終了してください。この処置で効果がない場合は、メモリーの使用効率を向上させるための手順についてMicrosoftのマニュアルを参照してください。
	ケース3の場合:	ログオン情報が正しいことを確認して、再試行してください。この処置で効果がない場合は、メール管理者にアカウント情報を確認してください。


REP-4202:  メール・サブシステムへのログオン中にエラーが発生しました。

原因:	メール・サブシステムにログオンしようとして、エラーが発生しました。詳細は、一緒に表示されるエラー・メッセージを参照してください。このエラーのその他の原因として、次のことが考えられます。
	ケース1:	無効なサービス・プロファイル名またはユーザー名、パスワードを入力しました。
	ケース2:	使用できるメモリーが十分にありません。
処置:	このエラーの訂正には、次の処置を行ってください。
	ケース1の場合:	ログオン情報が正しいことを確認して、再試行してください。この処置で効果がない場合は、メール管理者にアカウント情報を確認してください。
	ケース2の場合:	実行中の不要なアプリケーションを終了してください。この処置で効果がない場合は、メモリーの使用効率を向上させるための手順についてMicrosoftのマニュアルを参照してください。


REP-4203:  メール・メッセージを送信中にエラーが発生しました。

原因:	メール・メッセージの作成または送信中に、エラーが発生しました。詳細は、一緒に表示されるエラー・メッセージを参照してください。このエラーのその他の原因として、次のことが考えられます。
	ケース1:	ディスクに十分な空き領域がありません。
	ケース2:	使用できるメモリーが十分にありません。
処置:	このエラーの訂正には、次の処置を行ってください。
	ケース1の場合:	ディスク上の領域を少し解放してください。
	ケース2の場合:	実行中の不要なアプリケーションを終了してください。この処置で効果がない場合は、メモリーの使用効率を向上させるための手順についてMicrosoftのマニュアルを参照してください。


REP-4204: 受信者の名前／アドレスを有効にしている間にエラーが発生しました。
REP-4204:  受信者の名前/アドレスを有効にしている間にエラーが発生しました。

原因:	Report Builderが宛先のメール・アドレスを確認しようとして、エラーが発生しました。
処置:	受信者が有効なメール・アカウントを持っていることを確認するかまたはメール管理者に連絡してください。詳細は、一緒に表示されるエラー・メッセージを参照してください。


REP-4220:  メール・サブシステムに問題があります。

原因:	メール操作の1つを実行中に未指定のエラーが発生しました。
処置:	ディスク領域を少し解放するかまたは実行中の不要なアプリケーションを終了してください。MAPIを使用している別のアプリケーションがある場合は、それが正しく機能しているかどうかをチェックしてください。正しく機能していない場合は、MAPIを再インストールしてください。


REP-4221:  添付ファイルにアクセスできません。

原因:	添付ファイルにアクセスしようとしているときに、エラーが発生しました。このエラーの原因として、次のことが考えられます。
	ケース1:	添付ファイルが見つかりませんでした。
	ケース2:	添付ファイルがオープンできなかったか、添付ファイルの読込みまたは書込みエラーが発生しました。
処置:	このエラーの訂正には、次の処置を行ってください。
	ケース1の場合:	実行中の不要なアプリケーションを終了してください。この処置で効果がない場合は、メモリーの使用効率を向上させるための手順についてMicrosoftのマニュアルを参照してください。
	ケース2の場合:	ディスク上の領域を少し解放してください。


REP-4222:  操作を完了するためのメモリーが十分ではありません。

原因:	使用できるメモリーが十分にないために、メール操作を完了できません。
処置:	実行中の不要なアプリケーションを終了してください。この処置で効果がない場合は、メモリーの使用効率を向上させるための手順についてMicrosoftのマニュアルを参照してください。


REP-4223:  デバイス上に空き領域が残っていません。

原因:	ディスクに使用できる空き領域が十分にないために、メール操作を完了できません。
処置:	ディスク上の領域を少し解放してください。


REP-4224:  ユーザー名、パスワード、サービス・プロファイル名のいずれかが正しくありません。

原因:	入力したログオン情報が無効です。
処置:	ログオン情報が正しいことを確認して、再試行してください。この処置で効果がない場合は、メール管理者にアカウント情報を確認してください。


REP-4225: ユーザーがログオンしていないので、操作を完了できません。

原因:	メール操作を完了できませんでした。
処置:	メール・サブシステムにログオンして、再試行してください。


REP-4226:  パスワードが必要です。

原因:	パスワードを指定せずにメール・サブシステムにログオンしようとしました。
処置:	有効なパスワードを指定して、再試行してください。この処置で効果がない場合は、メール管理者に連絡してください。


REP-4227:  サービス構成は無効です。

原因:	メール・サブシステムが誤った構成になっています。
処置:	メール管理者に連絡してください。


REP-4228:  MAPIは、Report Builderで要求された機能をサポートしていません。

原因:	使用中のMAPIのインプリメントでは、機能に制限があります。
処置:	Windowsメール・サービス・プロバイダを更新する必要がある可能性があります。メール管理者に連絡してください。


REP-4229:  要求されたキャラクタ・セットをサポートしていません。

原因:	デフォルトのキャラクタ・セットはMAPIではサポートされていません。
処置:	メール管理者に連絡してください。


REP-4230:  渡されたテキスト文字列のサイズは大きすぎます。

原因:	使用中のMAPIインプリメントには大きすぎるテキスト文字列を渡しました。
処置:	文字列を短くして、再試行してください。


REP-4232: オープンしているファイルが多すぎます。

原因:	使用中のMAPIインプリメントでは、現在オープンしているファイル数がサポートされていません。
処置:	不要なドキュメントをすべてクローズしてください。


REP-05000:  成功したジョブに対する通知テンプレート・ファイルが設定されていません。
�REP-05000:  成功したジョブに対する通知テンプレート・ファイルが設定されていません。

原因:	ジョブの成功を通知するための通知テンプレート・ファイルを示すSUCCNOTEFILEパラメータが、Reports Server構成ファイルに存在しません。
処置:	Reports Server構成ファイルにSUCCNOTEFILEパラメータを追加し、成功したジョブ用の通知テンプレート・ファイルをポイントします。詳細はシステム管理者に問い合せてください。


REP-05001:  失敗したジョブに対する通知テンプレート・ファイルが設定されていません。

原因:	ジョブの失敗を通知するための通知テンプレート・ファイルを示すFAILNOTEFILEパラメータが、Reports Server構成ファイルに存在しません。
処置:	Reports Server構成ファイルにFAILNOTEFILEパラメータを追加し、失敗したジョブ用の通知テンプレート・ファイルをポイントします。詳細はシステム管理者に問い合せてください。


REP-05002:  通知テンプレート・ファイルが見つかりません。

原因:	Reports Server構成ファイルのSUCCNOTEFILEまたはFAILNOTEFILEで指定されているファイルが存在しません。
処置:	SUCCNOTEFILEまたはFAILNOTEFILEが有効な通知テンプレート・ファイル名をポイントしていることを確認します。詳細はシステム管理者に問い合せてください。


REP-05003: 通知テンプレート・ファイルをオープンできません。

原因:	Reports Server構成ファイルのSUCCNOTEFILEまたはFAILNOTEFILEで指定されている通知テンプレート・ファイルをオープンできません。
処置:	SUCCNOTEFILEまたはFAILNOTEFILEが有効な通知テンプレート・ファイル名をポイントしていることを確認します。また、通知テンプレート・ファイルが読込み可能であることを確認します。詳細はシステム管理者に問い合せてください。


REP-05004:  通知テンプレート・ファイルを読み込めません。

原因:	Reports Server構成ファイルのSUCCNOTEFILEまたはFAILNOTEFILEで指定されている通知テンプレート・ファイルを読み込めません。
処置:	SUCCNOTEFILEまたはFAILNOTEFILEが有効な通知テンプレート・ファイル名をポイントしていることを確認します。また、通知テンプレート・ファイルが読込み可能であることを確認します。詳細はシステム管理者に問い合せてください。


REP-06000:  Expressの問合せダイアログで問合せを作成できませんでした。

原因:	問合せが非常に大きいために、過大なメモリーを要求しています。
処置:	問合せを簡略化します。


REP-06001:  Expressの問合せダイアログの起動に失敗しました。

原因:	問合せが非常に大きいために、過大なメモリーを要求しています。
処置:	問合せを簡略化します。


REP-06002:  メモリーが不足しているため、操作を完了できません。

原因:	マシンのメモリーが不足しています。
処置:	アプリケーションをクローズしてメモリーの量を増やします。長期的な解決策としては、スワップ・ファイルのサイズを増やすか、マシンに追加のメモリーをインストールします。


REP-06003:  OLAP Serverのセッションを開始できませんでした。

原因:	OLAP Serverが動作していないかまたはSNAPIがインストールされていません。
処置:	OLAP Serverが動作していない場合は起動し、SNAPIがインストールされていることを確認します。OLAP Serverデータベース管理者に問い合せてください。


REP-06004:  OLAP Serverに接続できませんでした。

原因:	OLAP Serverが動作していないか、システムのメモリーが不足しています。 または、SNAPIがインストールされていないか、正常に機能していません。
処置:	OLAP Serverが動作していない場合は起動します。アプリケーションをクローズしてメモリーの量を増やします。長期的な解決策としては、スワップ・ファイルのサイズを増やすか、マシンに追加のメモリーをインストールします。SNAPIがインストールされていることを確認します。OLAP Serverデータベース管理者に問い合せてください。


REP-06005:  指定されたSNAPIハンドルに基づくExpressの問合せダイアログの初期化に失敗しました。

原因:	内部エラーが発生しました。
処置:	製品を再起動し、問合せを再発行します。


REP-06006:  Expressの初期化ファイルXPDATA.INIが存在しません。

原因:	XPDATA.INIが見つかりませんでした。
処置:	XPDATA.INIが存在することと、パスが正しいことを確認します。


REP-06007:  Expressの初期化ファイルXPDATA.INIの[Install]セクションに、\nOLAP接続ファイル(XCF)のエントリが見つかりません。
REP-06007:  Expressの初期化ファイルXPDATA.INIの[Install]セクションに、\nExpress接続ファイル（XCF）のエントリが見つかりません。

原因:	XPDATA.INIにエントリがありません。
処置:	XPDATA.INIファイルにXCFエントリを追加するか、.INIファイルを有効なXPDATA.INIに置き換えます。


REP-06008:  ORACLE_HOMEが見つかりません。

原因:	ORACLE_HOMEディレクトリが見つかりませんでした。
処置:	ORACLE_HOMEの設定が正しいことを確認します。詳細は、OLAP Serverのインストレーション・マニュアルを参照してください。


REP-06009:  Expressの初期化ファイルXPDATA.INIの[Install]セクションに、\nOracle SNAPI(OSN)のエントリが見つかりません。
REP-06009:  Expressの初期化ファイルXPDATA.INIの[Install]セクションに、\nOracle SNAPI（OSN）のエントリが見つかりません。

原因:	XPDATA.INIにエントリがありません。
処置:	XPDATA.INIにOSNエントリを追加するか、.INIファイルを有効なXPDATA.INIに置き換えます。


REP-06010:  どのExpress接続ファイル(XCF)にも、\nOLAP Serverの記述が見つかりません。
REP-06010:  どのExpress接続ファイル（XCF）にも、\nOLAP Serverの記述が見つかりません。

原因:	XCFファイルの一部の情報が不足しています。
処置:	XCFファイルをチェックするか、作成し直します。


REP-06011:  生成されたSQL SELECT文のサイズが64KBを超えています。

原因:	SQL文が大きすぎます。
処置:	問合せを修正し、SQL文のサイズを縮小します。


REP-06012:  Expressへのテンポラリ問合せの削除に失敗しました。

原因:	一時問合せを削除できません。
処置:	OLAPへの接続を解除してから再び接続し、問合せを再発行するか、作成し直します。


REP-06013:  問合せを実行できません。Express問合せダイアログは\n以前の問合せのメジャーまたはディメンション設定で起動されました。

原因:	単位またはディメンションが無効か、問合せが壊れています。
処置:	データベースが変更可能であることを確認し、問合せの中の単位とディメンションを調べます。


REP-06014:  バックエンドのXPFetch[N]()が未定義のレポートIDでコールされました。

原因:	内部エラーが発生しました。
処置:	製品を再起動し、問合せを再発行します。


REP-06015:  バックエンドのXPPrepare()が重複するレポートIDで呼び出されました。

原因:	内部エラーが発生しました。
処置:	製品を再起動し、問合せを再発行します。


REP-06016:  SNAPIから次のデータ・セルを取得しようとしてエラーが発生しました。

原因:	内部エラーが発生しました。
処置:	製品を再起動し、問合せを再発行します。


REP-06017:  保存された問合せに含まれる情報が正しくないか、欠落しています。

原因:	問合せが無効です。
処置:	問合せを指定し直します。


REP-O6018:  内部Expressシステム・データベースの連結に失敗しました。

原因:	Expressシステム・データベースを連結できません。
処置:	OLAP Serverが動作していること、システム・データベースが適切な場所にあることおよび'ExpressServerDBPath'の設定が正しいことを確認します。


REP-06019:  保存された問合せで指定されているExpressデータベースの連結に失敗しました。

原因:	Expressシステム・データベースを連結できません。
処置:	OLAP Serverが動作していること、データベースが適切な場所にあることおよび'ExpressServerDBPath'の設定が正しいことを確認します。


REP-06020:  Expressへの問合せの解析に失敗しました。

原因:	Select文が壊れています。
処置:	問合せを指定し直します。


REP-06021:  Oracle Expressサポートがインストールされていません。

原因:	Expressで実行するためのサポート・ファイルがインストールされていません。
処置:	Expressサポート・ファイルをインストールします。詳細は、インストレーション関係のマニュアルを参照してください。


REP-06022:  OLAP Serverの起動に失敗しました。

原因:	OLAP Serverが動作していません。
処置:	OLAP Serverが動作していない場合は起動します。OLAP Serverデータベース管理者に問い合せてください。


REP-06023:  Expressへの問合せの解析中に予期しない行末が検出されました。

原因:	Expressエラーが発生しました。
処置:	Express問合せを調べて、行末の円記号（\）が欠けていないかどうかを確認します。


REP-06024:  Express EXECUTEに失敗しました。

原因:	Expressエラーが発生しました。
処置:	OLAP Serverが動作していない場合は起動します。OLAP Serverデータベース管理者に問い合せてください。


REP-06025:  Express FETCHに失敗しました。

原因:	Expressエラーが発生しました。
処置:	OLAP Serverが動作していない場合は起動します。OLAP Serverデータベース管理者に問い合せてください。


REP-06026:  重複するレポートIDが検出されました。

原因:	内部エラーが発生しました。
処置:	製品を再起動し、問合せを再発行します。


REP-06027:  未定義のレポートIDが検出されました。

原因:	内部エラーが発生しました。
処置:	製品を再起動し、問合せを再発行します。


REP-06028:  未知のExpressサポート・バックエンド・エラーが発生しました。

原因:	Expressエラーが発生しました。
処置:	OLAP Serverが動作していない場合は起動します。OLAP Serverデータベース管理者に問い合せてください。


REP-6029:  Expressエラー

原因:	Expressエラーが発生しました。
処置:	詳細はExpressのマニュアルを参照してください。


REP-6030: xconnect.iniが抜けているか無効です。

原因:	xconnect.iniが抜けているためと考えられます。xconnect.iniに無効な「一般」セクションがある場合にも、このエラーが起こります。
処置:	Oracle_Home/olap/ecf620でxconnect.iniをチェックしてください。xconnect.iniに「一般」セクションがあることを確認してください。


REP-6101: Java Virtual Machineの起動に失敗しました。Java Runtime環境の設定を確認してください。

原因:	REPORTS60_CLASSPATH環境変数の値が正しくないか、Java Runtime環境の設定が無効です。
処置:	Java Runtime環境のインストールを確認してください。REPORTS60_CLASSPATH環境変数にプラットフォームに合せてclasses.zipまたはrt.jarの有効な指定が含まれていることを確認してください。必要な場合は、Reports RuntimeまたはReport Builderを再インストールしてJava Runtime環境およびREPORTS60_CLASSPATH環境変数の設定をリフレッシュしてください。


REP-6102: XML解析の起動に失敗しました。

原因:	設定が正しくないためにOracle XML解析を起動できませんでした。通常、REPORTS60_CLASSPATHの値が正しくないことが原因です。
処置:	REPORTS60_CLASSPATHにOracle XML解析および製品のjarファイルが有効に指定されていることを確認してください。必要な場合は、Reports RuntimeまたはReport Builderを再インストールしてREPORTS60_CLASSPATH環境変数の設定をリフレッシュしてください。


REP-6103: Java Runtime環境の設定エラーです
REP-6103: Java Runtime環境の設定エラーです。

原因:	Java Runtime環境の設定が正しくないか抜けています。
処置:	Reports RuntimeまたはReport Builderを再インストールしてください。


REP-6104: XMLレポートの定義が無効です。

原因:	XMLレポートの定義が無効または抜けています。
処置:	有効なXMLレポートの定義を指定するか、レポートの定義内に示された問題点を修正してください。


REP-6106: <url>の<line number>行でのXMLレポートの定義エラーです。

原因:	指定されたXMLレポートの定義のうち、その行番号に問題があります。
処置:	XMLレポートの定義について、指定された行番号のエラーを修正してください。


REP-16500:  このプログラムはCGI実行形式でのみ呼出されます。
�REP-16500:  このプログラムはCGI実行形式でのみ呼び出されます。

原因:	WebのCGI実行形式が、Webサーバーのコンテキスト外で呼び出されました。
処置:	CGI実行形式が正しく機能するには、Webサーバーから呼び出される必要があります。


REP-16501:  Reports Web Agentキー・マップ・ファイルが正しく設定されていません。

原因:	指定された場所でキー・マップ・ファイルが見つかりません。
処置:	ファイルの位置を確認してください。


REP16504:  メッセージ・サブシステムが初期化できません。メッセージ・ファイルが正しくインストールされているか確認してください。
REP-16504:  メッセージ・サブシステムが初期化できません。メッセージ・ファイルが正しくインストールされているか確認してください。

原因:	メッセージ・ファイルが見つからないか、オープンできません。
処置:	正しくインストールされているか確認してください。


REP-16505:  初期化中に一般エラーが起こりました。正しくインストールされているか確認してください。

原因:	一般エラー。
処置:	正しくインストールされているかどうかおよびシステム・リソースが使用可能かどうか確認してください。


REP-16506:  指定されたURL中のエスケープの記述が正しくありません。

原因:	指定されたURLの記述が正しくありません。
処置:	Web AgentのマニュアルでURLの規則を参照してください。


REP-16507:  キーが認識されません。

原因:	キー・マップの構成はアクティブですが、URLで指定されたキーは認識されません。コマンド・ラインをビルドできません。
処置:	キー値およびキー・マップ・ファイルの設定と内容を確認してください。


REP-16508:  キー:\%s\が認識されません。URL指定が正しくないか、URL内のキーがキー・マップ・ファイルにない可能性があります。

原因:	キー・マップの構成はアクティブですが、URLで指定されたキーは認識されません。コマンド・ラインをビルドできません。
処置:	キー値およびキー・マップ・ファイルの設定と内容を確認してください。


REP-16509:  キー・マップ・ファイルに構文エラーがあります。指定したキーの定義を確認してください。

原因:	キー・マップ・ファイルに構文エラーがあります。
処置:	キー・マップ・ファイルの内容を確認してください（規則については、Web Agentのマニュアルを参照してください）。


REP-16510:  用法が正しくありません。

原因:	非冗長実行の一般エラー。
処置:	冗長を有効にし、実際のメッセージを確認してください。


REP-16511:  URL内のパラメータが多すぎます。

原因:	URL内のパラメータが多すぎます（長すぎます）。
処置:	URLまたはキー・マップ・ファイル、あるいはその両方を短くして、URLを短縮します。


REP-16512:  メモリーが不足しています。

原因:	メモリーが不足しています。
処置:	十分なシステム・リソースが使用可能であることを確認してください。


REP-16513:  Reports Serverに接続できません。

原因:	Reports Serverから応答がありません。
処置:	Reports Serverが動作し、TNSNAMES.ORAネットワーク設定に正しいエントリがあることを確認してください。


REP-16514:  レポートを実行できません。

原因:	レポート実行失敗の一般エラーです。
処置:	このメッセージに加えて、Reports Serverからの詳細なエラー・メッセージを確認してください。


REP-16515:  レポートの出力先にアクセスできません。

原因:	Web Agentから、Report Server実行出力にアクセスできません。
処置:	Web Agentの設定を確認してください（特にWEBLOC変数）。


REP-16516:  Reports Serverがシャットダウンされています。

原因:	警告 - Reports Serverは停止します。
処置:	後で再試行してください。


REP-16517:  ユーザーからの要求によりレポートのジョブが取り消されました。

原因:	ジョブは、ユーザーまたはReports Serverの管理者によって取り消されました。
処置:	必要な場合は再試行してください。


REP-16518:  Reports Serverのエンジンが異常終了しました。

原因:	Reports Serverのエンジンで、レポートに問題がありました。
処置:	Reports Serverの管理者に連絡してください。


REP-16519:  レポートのジョブがエラーで終了しました。

原因:	レポート実行エラーの一般エラー・メッセージ。
処置:	関連する詳細メッセージを参照してください。


REP-16520:  Reports Serverのキューにジョブを追加していてエラーが起こりました。

原因:	Reports Serverのキューにジョブが追加されていたときにエラーが発生しました。
処置:	後で再試行してください。


REP-16521:  Reports Serverのコマンド・ライン解析中にエラーが起こりました。

原因:	レポートが実行され、コマンド・ラインが処理されようとしていたときにエラーが発生しました。
処置:	Reports Serverの管理者に連絡してください。


REP-16522:  Reports Server名が指定されていません。

原因:	レポートが実行され、コマンド・ラインが処理されようとしていたときにエラーが発生しました。
処置:	Reports Serverの管理者に連絡してください。


REP-16523:  レポート名が指定されていません。

原因:	レポートが実行され、コマンド・ラインが処理されようとしていたときにエラーが発生しました。
処置:	Reports Serverの管理者に連絡してください。コマンド・ラインにレポート名があるかどうかを確認してください。


REP-16524:  データベースへのログイン名が指定されていません。

原因:	レポートが実行され、コマンド・ラインが処理されようとしていたときにエラーが発生しました。
処置:	Reports Serverの管理者に連絡してください。コマンド・ラインにデータベースへのログイン名があるかどうかを確認してください。


REP-16525:  スケジュール・コマンドを解析できませんでした。

原因:	レポートが実行され、コマンド・ラインが処理されようとしていたときにエラーが発生しました。
処置:	Reports Serverの管理者に連絡してください。SCHEDULEパラメータを確認してください。


REP-16526:  タイム・トレランスを解析できませんでした。

原因:	レポートが実行され、コマンド・ラインが処理されようとしていたときにエラーが発生しました。
処置:	Reports Serverの管理者に連絡してください。TOLERANCEパラメータを確認してください。


REP-16527:  パラメータ・フォームの型が無効です。

原因:	レポートが実行され、コマンド・ラインが処理されようとしていたときにエラーが発生しました。
処置:	Reports Serverの管理者に連絡してください。PARAMFORMパラメータを確認してください。


REP-16528:  Reports Serverへの接続中にエラーが起こりました。

原因:	通信の問題です。
処置:	後で再試行してください。


REP-16529:  ジョブを削除できません。

原因:	ジョブの削除についての一般メッセージ。
処置:	理由を確認してください。


REP-16530:  ジョブIDが無効です。

原因:	アクションを実行するReports ServerのジョブのIDが無効です。
処置:	IDが有効であることを確認してください。


REP-16531:  ジョブは完了しています。

原因:	アクションを実行するReports ServerのジョブのIDが無効です。
処置:	IDが有効であることを確認してください。


REP16532:  ジョブはまだ行われていません。後で再試行してください。

原因:	アクションを実行するReports ServerのジョブのIDが無効です。
処置:	IDが有効であることを確認してください。


REP-16533:  指定のアクションを実行するために必要な権限がありません。

原因:	アクションを実行するReports ServerのジョブのIDが無効です。
処置:	IDが正しく、また適切な権限があることを確認してください。


REP16534:  レポートの出力先にアクセスできません。  設定を確認してください（REPORTS 60_WEBLOC）。
REP-16534:  レポートの出力先にアクセスできません。設定を確認してください（REPORTS 60_WEBLOC）。

原因:	出力先ディレクトリにアクセスできません。
処置:	ディレクトリ指定を確認してください。


REP-16535:  またはReports60_WEBLOC_TRANSLATEDの環境設定が正しくない可能性があります。

原因:	出力先ディレクトリにアクセスできません。
処置:	ディレクトリ指定を確認してください。


REP-16537:  （REPORTS60_WEBLOC_TRANSLATEDの環境でReports Serverのキャッシュと同じ場所を指定している可能性があります）。
REP-16537:  （REPORTS60_WEBLOC_TRANSLATEDの環境でReports Serverのキャッシュと同じ場所を指定している可能性があります。）

原因:	戻された名前の出力先は、Webディレクトリに既に存在します。
処置:	Web Agentの設定を確認してください。


REP-16538:  レポートが印刷されました。

原因:	レポートからプリンタに正常に実行されました。
処置:	なし。


REP-16539:  レポートがメールされました。

原因:	レポートからメールに正常に実行されました。
処置:	なし。


REP-16540:  レポートが指定された送付先に書き込まれました。

原因:	レポートから指定された宛先タイプに正常に実行されました。
処置:	なし。


REP-16541:  ログオンしてからレポートを実行してください。

原因:	レポートを実行する前にログインしていません。
処置:	レポートを実行する前にログインしてください。


REP-16542:  レポート出力がInterOfficeリポジトリに正常に書き込まれました。
EP-16542:  レポート出力がInterOfficeリポジトリに正常に書き込まれました。

原因:	レポートがInterOfficeレポジトリに対して正常に実行されました。
処置:	なし。


REP-16543:  REPORTS60_PHYSICAL_MAPおよびREPORTS60_SHARED_CACHEの環境が無効になっている可能性があります。

原因:	出力ディレクトリにアクセスできません。
処置:	ディレクトリ指定を確認してください。


REP-20091:  データベースから切断する前に、現在のモジュールを保存しますか?

原因:	データベースに格納されているモジュールがオープンされています。データベースから切断した場合は、変更内容をデータベースに保存できません。
処置:	データベースから切断する前にモジュールを保存するには、「はい」を選択します。モジュールは、オープンされたままなので、必要な場合は再接続して、再度、データベースに保存できます。モジュールを保存せずにデータベースから切断するには、「いいえ」を選択します。モジュールはオープンされたままです。保存せずにデータベースから切断しない場合は、「取消」を選択します。この場合もモジュールはオープンされたままです。


REP-20099:  プレビュー中にプリンタが変更されました。プリンタ・フォントの再マッピングにより切捨てが行われた可能性があります。印刷を続けますか？

原因:	レポートが実行されてから、プレビューアで「印刷」が選択されるまでの間に、デフォルトのプリンタが変更されました。
処置:	印刷を行う場合は「はい」を選択してください。印刷を中止するには「いいえ」を選択します。レポートをクローズし、プリンタをリセットしてレポートを再度実行するか、単にレポートを再度実行して現行のプリンタに対して書式を設定します。


REP-20128:  警告: レポートはDESTYPE=PREVIEWで実行されていません。画面フォントの再マッピングで切捨てが起こりました。印刷を続けますか？
�REP-20128:  警告: レポートはDESTYPE=PREVIEWで実行されていません。画面フォントの再マッピングで切捨てが起こりました。印刷を続けますか？

原因:	プレビューアから「印刷」を選択しましたが、宛先として「プレビュー画面」のかわりに「画面」を選択しました。 「プレビュー画面」では、レポートはプリンタ・フォントを使用した場合と同様にフォーマットされ、より正確なレポートの印刷結果が得られます。
処置:	印刷を行う場合は「はい」を選択してください。印刷を一時停止する場合は、「いいえ」を選択してください。その後、レポートをクローズして、レポートをプリンタ用にフォーマットするために「プレビュー画面」を指定して、再実行してください。


REP-20129:  警告: 新しいバージョンのReport Builderで保存されたレポートをオープンします。機能が失われているかもしれません。続行しますか?

原因:	レポートの作成に使用されたバージョンより古いバージョンのReport Builderでレポートをオープンしようとしました。レポートが古いバージョンでは使用できない機能を使用している場合は、その機能はレポートから排除されます。
処置:	機能が失われることが心配な場合は、Report Builderの最新バージョンにアップグレードするまではそのレポートをオープンしないでください。


REP-20135:  レイアウトなしで実行できません。デフォルト・レイアウトを作成しますか？

原因:	データ・モデルの作成後にレポートを実行しようとしましたが、まだレイアウトが作成されていませんでした。
処置:	レイアウトを作成してから、レポートを実行してください。


REP-20136:  デフォルト・レイアウトとして選択した領域が小さすぎます。領域をページ境界まで拡張しますか？

原因:	ツール・パレットから追加デフォルト・レイアウト・ツールを使用して、レポート・ウィザードの設定に対して大きさが不十分なレイアウトの領域を描画しています。
処置:	Report Builderを使用してレイアウトをレポート・ページの境界線まで最大限拡張する場合は、「はい」を選択してください。 また、レイアウトのサイズを縮小するには、「いいえ」を選択してレポート・ウィザードの設定を変更してください。


REP-20138:  Report Builder表がデータベースにインストールされていない可能性があります。

原因:	Report Builderが、データベースの表にアクセスできませんでした。
処置:	データベース管理者に、Report Builder表がデータベースに正しくインストールされていないことを連絡してください。


REP-20139:  新規パラメータ・フォーム・レイアウトは、その現在サイズに合いません。合うまでページ数を増やしますか？

原因:	新しいパラメータ・フォームが、「レポート」プロパティ・パレットでパラメータ・フォーム用に指定されているページ数に合わせるには大きすぎます。
処置:	Report Builderを使用してパラメータ・フォームにあるページ数を増加する場合は、「はい」を選択してください。 また、パラメータ・フォームを拡大する場合は、「いいえ」を選択して「レポート」プロパティ・パレットの設定を変更してください。


REP-20140: 警告: 枠およびそれに含まれるオブジェクトすべてが削除されます。続行しますか？
REP-20140:  警告: 枠およびそれに含まれるオブジェクトすべてが削除されます。続行しますか?


REP-20141:  警告: すべてのマトリックスが破棄されます。続行しますか?


REP-20142:  警告: レポートのモードはキャラクタに変更されました。レポートは別のウィンドウで実行されます。


REP-20143:  警告: 一部のオブジェクトがページ外に移動されているかもしれません。その場合、レポートはフォーマットできなくなる可能性があります。


REP-20144:  新しいバージョンのReport Builderで保存されたレポートをオープンしています。機能が失われているかもしれません。

原因:	レポートの作成に使用されたバージョンより古いバージョンのReport Builderでレポートをオープンしようとしました。レポートが古いバージョンでは使用できない機能を使用している場合は、その機能はレポートから排除されます。
処置:	機能が失われることが心配な場合は、Report Builderの最新バージョンにアップグレードするまではそのレポートをオープンしないでください。


REP-20146:  このアクションによって参照オブジェクト内の列への参照が無効になる可能性があります。

原因:	データベースの参照、データベースのネストした表、データベースの可変配列の各列を縮小すると、外部からの参照列（たとえば、PL/SQLプログラム単位またはサマリー列の参照列）の使用がすべて無効になります。
処置:	参照列を使用するには、それらの列を参照しているデータベースの参照、データベースのネストした表、データベースの可変配列の各列を縮小しないでください。


REP-20147:  この詳細SQL問合せに列リンクをインプリメントできません。グループ・リンクに変換します。

原因:	オブジェクトの詳細問合せとの問合せ間のデータ・リンクは、サポートされていません。
処置:	「はい」をクリックすると、問合せの親グループ間にリンクを作成します。「取消」をクリックすると、リンクを作成しません。この場合、詳細問合せのSQLを使用すると、手動でリンクを作成することができます。


REP-20148:  警告: レポートは複数の配布先に対して実行されます。続行しますか?

原因:	実行中のレポートの「配布」プロパティで、複数の宛先に対する出力の送信が定義されています。
処置:	「続行」をクリックするとレポートが実行され、出力がすべての宛先に送信されます。「取消」をクリックすると、レポートは実行されません。


REP-20150:  警告: レポート: <report name>のページ幅が、フォントマッピングの一部として、文字セル・フォント用に変更されました。フォント・エイリアス・ファイル内でのフォントマッピングの可能性があります。

原因:	文字フォントがオープンされているレポートのビットマップ済みフォントに置換されたため、ページ幅はそれに従って調整されています。この原因として、ビットマップ済みレポートが、キャラクタ・モードのランタイム・エンジンでオープンしようとしていることが考えられます。
処置:	フォントを特定のフォントにマップする場合は、フォント・エイリアス・ファイル（プラットフォームによって、uifont.aliまたはOracle Font Aliasesのいずれか）を編集して、希望するフォントにマップしてください。マップを希望しない場合は、処置は不要です。


REP-20151:  警告: フォント・エイリアス・ファイルに従ったマッピングによって、フォントがいくつか変更されました。

原因:	レポートで保存された1つ以上のフォントが、プラットフォームまたは図表、レポート宛先、モードでの変更によって別のフォントにマップされました。
処置:	フォントを特定のフォントにマップする場合は、フォント・エイリアス・ファイル（プラットフォームによって、uifont.aliまたはOracle Font Aliasesのいずれか）を編集して、希望するフォントにマップしてください。マップを希望しない場合は、処置は不要です。


REP-20190:  終了すると、その他の保留ページと同じく、現行レポートは放棄されます。

原因:	1つ以上のレポートが実行中または実行待機中に、Reports ServerまたはReportsバックグラウンド・エンジンの終了を指定しました。
処置:	レポートの実行を終了する場合は、操作を取り消してください。終了しない場合は、警告ダイアログを受け入れてください。


REP-20191:  このプログラムを実行している時にはWindowsを終了できません。 Reportsサーバーをクローズし、Windowsを終了してください。
REP-20191:  このプログラムを実行している時にはWindowsを終了できません。Reportsバックグラウンド・エンジンをクローズし、Windowsを終了してください。

原因:	Reportsバックグラウンド・エンジンではWindowsが必要ですが、Reportsバックグラウンド・エンジンの実行中にWindowsを終了するように指定しました。
処置:	Windowsを終了する前にReportsバックグラウンド・エンジンを終了してください。


REP-25204:  変換は正常に実行されました。

原因:	要求された変換は正常に実行されました。
処置:	ありません。


REP-25206:  <source name>から<destination name>への変換は失敗しました。

原因:	ほとんどの場合、指定したソース・タイプに誤りがあったことが原因です。
処置:	ソース・ファイルが指定したソース・タイプであることを確認してください。


REP-25207:  無効な変換: stypeとdtypeは同じ文書タイプではありません。

原因:	あるタイプのドキュメントを別のタイプに変換しようとしました。 つまり、レポート・ファイルからPL/SQLファイルへの変換またはその逆の変換をしようとしました。
処置:	変換のソースと宛先が同じタイプの文書であることを確認してください。


REP-25401:  <user exit .DLL file>を配置できません。

原因:	レポートでユーザー・イグジットを実行しようとしましたが、ユーザー・イグジット.DLLファイルを見つけられませんでした。このファイルは通常次のディレクトリにあります。
	•	現行ディレクトリ
	•	Windowsディレクトリ（通常は\WINDOWS）
	•	Windowsシステム・ディレクトリ（通常は\WINDOWS\SYSTEM）
	•	現行の作業に必要な実行可能ファイルを含むディレクトリ
	•	PATH環境変数にリストされているディレクトリ
	•	ネットワーク内でマップされているディレクトリのリスト
処置:	指定された.DLLファイルを見つけて、前述のディレクトリのうちの1つに配置してください。


REP-25402: 内部エラー - <filename>内に<user exit . DLL file>を配置できません。

原因:	レポートでユーザー・イグジットを実行しようとしましたが、ユーザー・イグジット.DLLファイル内に、ユーザー・イグジットを見つけて実行するために使用されるファンクションがありません。常にユーザー・イグジット.DLLにリンクされるこれらのファンクションはReport Builderに付属の.OBJファイル内にあります。 つまり、ユーザー・イグジット.DLLが誤って構築されています。
処置:	指定されたユーザー・イグジット.DLLを正しく再構築してください。


REP31681:  警告: 異なるデータベースへ接続すると既存のデータ・モデルが無効になる可能性があります。
REP-31681:  警告: 異なるデータベースへ接続すると既存のデータ・モデルが無効になる可能性があります。

原因:	一度に接続できるのは1つのデータベースのみです。異なるデータベースへ接続すると、その後既存のデータ・モデルが無効になる場合があります。
処置:	既存のデータ・モデルの有効性を保つには、問合せが新しいデータベース接続と互換性があることが確実な場合を除き、異なるデータベースに再接続しないでください。


REP-31700: レポート定義が不完全か、または問合せにブレーク・グループがありません。Webウィザードを実行できません。
REP-31700:  レポート定義が不完全かまたは問合せにブレーク・グループがありません。Webウィザードを実行できません。

原因:	Webウィザードを実行する前に、レポート定義を完了する必要があります。Webウィザードを実行するには、レポート定義に複数のグループを持つデータ・モデルおよび有効なレイアウト・モデルが含まれている必要があります。
処置:	レポート・ウィザードを使用して、複数のグループを持つ少なくとも1つの問合せを作成し、レイアウトをデフォルトに設定してください。


REP-31800:  イメージ・ファイル: <filename> が見つかりません。

原因:	Reports Builderで、イメージ・ファイルの1つが見つかりませんでした。このエラーの原因として、次のことが考えられます。
	ケース1:	イメージ・ファイルが存在しません。
	ケース2:	イメージ・ファイルが間違った場所にあります。
	ケース3:	環境が正しく構成されていません。
処置:	このエラーの訂正には、次の処置を行ってください。
	ケース1の場合:	イメージ・ファイルが存在していることを確認してください。
	ケース2の場合:	イメージ・ファイルが適切なディレクトリにあることを確認してください。
	ケース3の場合:	環境が正しく設定されていることを確認してください。UNIXの場合は、適切な環境変数が設定されていることを確認してください。 MS Windowsの場合は、ファイル・システムのレジストリをチェックしてください。


REP-31801:  テンプレートで指定されたイメージ: <filename> が見つかりません。

原因:	Reports Builderで、選択したテンプレートに対応するイメージが見つかりませんでした。このエラーの原因として、次のことが考えられます。
	ケース1:	イメージ・ファイルが存在しません。
	ケース2:	イメージ・ファイルが間違った場所にあります。
	ケース3:	環境が正しく構成されていません。
処置:	このエラーの訂正には、次の処置を行ってください。
	ケース1の場合:	イメージ・ファイルが存在していることを確認してください。
	ケース2の場合:	イメージ・ファイルが適切なディレクトリにあることを確認してください。
	ケース3の場合:	環境が正しく設定されていることを確認してください。UNIXの場合は、適切な環境変数が設定されていることを確認してください。 MS Windowsの場合は、ファイル・システムのレジストリをチェックしてください。


REP-31802:  このページでSQL文を入力してください。

原因:	レポート・ウィザードでレポートを作成するには、有効なSQLテキストが必要です。
処置:	SQL文を入力してください。


REP-31803:  SQL文をチェックするにはデータベースに接続する必要があります。

原因:	レポート・ウィザードでSQLテキストをチェックするには、データベースに接続する必要があります。
処置:	「接続」ダイアログが表示されたら、ログイン文字列を入力してデータベースに接続できます。データベースへの接続要求は、必要に応じて出されます。データベースに接続できない場合は、データベース・アドミニストレータ（DBA）にログイン情報を確認してください。


REP-31804:  SQLは正しく作成されています。

原因:	レポート・ウィザードが、作成したSQLテキストをデータベースに対してチェックし、正しく実行されることを確認しました。
処置:	作成したSQLテキストを変更する必要はありません。


REP-31805:  ブレーク・レベル: <break level number> には、有効なブレーク列がありません。

原因:	各ブレーク・レベルには、少なくとも1つの有効なブレーク列が含まれている必要があります。ブレーク列を、サマリー列またはプレースホルダ列として使用することはできません。また、ブレーク列には、RAW、LONGRAWまたはLONGのデータ型は使用できません。
処置:	ブレーク・レベルに、有効なブレーク列を少なくとも1つ入れてください。 または、現在このブレーク・レベルにあるすべての列を、有効なブレーク列が含まれている別のレベルに移動してください。


REP-31806:  すべてのフィールドをブレーク・フィールドにすることはできません。

原因:	すべてのフィールドをブレーク・フィールドにするよう選択しました。指定した各ブレーク・フィールドによって、ブレーク・フィールドではないフィールドのデータがグループ化されます。非ブレーク・フィールドがないので、この状態は無効です。
処置:	少なくとも1つのフィールドを非ブレーク・フィールドに指定してください。最大の番号のブレーク・レベル（つまり、ブレーク・フィールド・リストの一番下）から、すべてのブレーク・フィールドを削除することをお薦めします。


REP-31807:  テンプレート・ファイル: '<filename>'が見つかりません。

原因:	Reports Builderで、該当する名前のテンプレート・ファイルが見つかりませんでした。このエラーの原因として、次のことが考えられます。
	ケース1:	イメージ・ファイルが存在しません。
	ケース2:	イメージ・ファイルが間違った場所にあります。
	ケース3:	環境が正しく構成されていません。
処置:	このエラーの訂正には、次の処置を行ってください。
	ケース1の場合:	イメージ・ファイルが存在していることを確認してください。
	ケース2の場合:	イメージ・ファイルが適切なディレクトリにあることを確認してください。
	ケース3の場合:	環境が正しく設定されていることを確認してください。UNIXの場合は、適切な環境変数が設定されていることを確認してください。 MS Windowsの場合は、ファイル・システムのレジストリをチェックしてください。


REP-31808:  SQL文を入力してください...

原因:	レポート・ウィザードでレポートを生成するために、SQL文を入力する必要があります。
処置:	レポート・ウィザードを使用して、SQL文を入力してください。


REP-31809:  表示するフィールドを少なくとも1つ選択してください。

原因:	表示するフィールドが選択されていません。
処置:	表示するフィールドを選択してください。


REP-31810:  ブレーク・グループを少なくとも1つ選択してください。

原因:	現行のレポート・スタイルには、ブレーク・グループが必要です。
処置:	ブレーク・グループを作成してください。


REP-31811:  マトリックス行を少なくとも1つ選択してください。

原因:	マトリックス行として何も選択されていません。
処置:	マトリックス行として、フィールドを選択してください。


REP-31812:  マトリックス列を少なくとも1つ選択してください。

原因:	マトリックス列として何も選択されていません。
処置:	マトリックス列として、1つ以上の列を選択してください。


REP-31813:  マトリックス（セル）を少なくとも1つ選択してください。

原因:	マトリックス（セル）として何も選択されていません。
処置:	マトリックス（セル）として、1つ以上の列を選択してください。


REP-31814:  マトリックス・ブレークを少なくとも1つ選択してください。

原因:	マトリックス・ブレークとして何も選択されていません。
処置:	マトリックス・ブレークとして、フィールドを選択してください。


REP-31815:  グループ毎に表示されているフィールドが1つなければいけません。

原因:	マトリックス・ブレークとして何も選択されていません。この問題は、次のことが原因です。
	1） このフィールドがグループ・フィールドとして選択されています。
	2） このフィールドのグループをデフォルトとしており、このフィールドがそのグループで「デフォルト」とマークされたただ1つのフィールドとなっています。
処置:	1） このフィールドをグループ・フィールドとして選択している場合、グループ・ページでこのフィールドを選択解除してください。
	2） この列のグループをデフォルトとしている場合、グループ・ページでそのグループを選択解除してください。


REP-31816:  デフォルトにするグループを選択してください。

原因:	デフォルトとするグループが選択されていません。
処置:	デフォルトとするグループを選択してください。


REP-31817:  グループの一番上です。これより上には移動できません。

原因:	この列は、グループの一番上にあります。
処置:	この列を上に移動しようとしないでください。


REP-31818:  グループの一番下です。これより下には移動できません。

原因:	この列は、グループの一番下にあります。
処置:	この列を上に移動しようとしないでください。


REP-31819:  ここではレポート・レベル列の順序を変えることはできません。

原因:	レポート・レベルの列に順序属性がありません。
処置:	レイアウト・モデル・エディタで、レポート・レベルの列を表示する位置を設定してください。


REP-31820:  選択されたグループには列がありません。

原因:	選択したグループに列がありません。したがって、レポートは生成されません。
処置:	列が入っているグループを選択してください。


REP-31821:  テキスト・エディタでテキストが指定されていません。

原因:	メール・ラベル・レポートまたはフォーム・レター・レポートのテキストが空です。
処置:	テキスト・エディタでテキストを入力してください。


REP-31822:  最初にグループを1つ選択してください。

原因:	グループが選択されていません。
処置:	グループ・ページでグループを1つ選択してください。


REP-31823:  グループは1つしか選択できません。

原因:	複数のグループが選択されています。
処置:	グループを1つのみ選択してください。


REP-31824: 選択されたグループには列がありません。 別のグループを選択してください。
REP-31824:  選択されたグループには列がありません。

原因:	選択したグループに列がありません。
処置:	列が入っているグループを選択してください。


REP-31825:  ウィザードを抜けてから、レポート・エディタの問題を解決してください。

原因:	データ・モデルが無効かまたはデフォルト領域が小さすぎます。
処置:	データ・モデル・エディタまたはレイアウト・モデル･エディタで問題を修正してください。


REP 31827. 出力先が無効か、ページ・レベル・サマリー列がデフォルトで設定されています。
REP-31827. 出力先が無効か、ページ・レベル・サマリー列がデフォルトで設定されています。

原因:	1つ以上のグループの印刷方向が要求されたデフォルト・スタイルに無効であるか、あるいはページ・レベル・サマリー列がデフォルトとして選択されました（ページ・レベル集計はデフォルト設定では使用できません）。
処置:	グループまたはデフォルト・スタイルの印刷方向を変更するか、すべてのページ・レベル集計の選択を解除するようにユーザーに要求してください。


REP-31950:  Report Builderチャート・サポートでエラーが発生しました。

原因:	チャート・ウィザードの初期化中に、エラーが発生しました。
処置:	すべてのコンポーネントが正しくインストールされていることを確認してください。製品を再起動してください。


REP-31951:  チャート・ウィザードを初期化できません。正しくインストールされていることを確認してください。

原因:	Chart Builderライブラリを初期化できませんでした。
処置:	Chart Builderウィザードおよびランタイム実行プログラムが正しくインストールされていることと、変更可能なシステム・リソースが十分にあることを確認してください。


REP-31952:  チャート・ウィザードを初期化できません。ライブラリのバージョンが正しくありません。

原因:	Chart Builderライブラリを初期化できませんでした。
処置:	Chart Builderウィザード・ライブラリが正しくインストールされていることと、変更可能なシステム・リソースが十分にあることを確認してください。


REP-31953:  Report Builderチャート・ウィザードでエラーが発生しました。

原因:	Chart Builderライブラリを初期化できませんでした。
処置:	Chart Builderウィザード・ライブラリが正しくインストールされていることと、変更可能なシステム・リソースが十分にあることを確認してください。


REP-31954:  Report Builderチャート・ウィザードのユーザー・インタフェースでエラーが発生しました。

原因:	チャート・ウィザードが正しくロードできませんでした。
処置:	Chart Builderウィザード・ライブラリが正しくインストールされていることと、変更可能なシステム・リソースが十分にあることを確認してください。


REP-31955:  チャートの作成中に、チャート・ランタイム実行モジュールでエラーが発生しました。

原因:	Chart Builderがチャートを作成できませんでした。
処置:	Chart Builderウィザード・ライブラリが正しくインストールされていることと、変更可能なシステム・リソースが十分にあることを確認してください。


REP-31980:  無効なフィールド・マッピングが指定されました。チャートは生成されません。

原因:	チャート・ウィザードで、「カテゴリ」および「値」軸のフィールドを両方とも指定しませんでした。
処置:	チャート・ウィザードに戻り、「カテゴリ」および「値」軸のフィールドを2つとも指定してください。


REP-31981:  レポート・データ・モデルが空かまたは無効です（チャートではありません）。データ・モデルを作成して再試行してください。

原因:	空のレポートに対して、チャート・ウィザードを起動しようとしました。
処置:	レポート（少なくともデータ・モデル）を作成してから、再試行してみてください。


REP-32600:  予想外のエラーが発生しました。強制終了します。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-32601:  レポートは、既にNXファイル内に存在しています。

原因:	既存の変換ファイルを上書きしようとしました。
処置:	変換ファイルには、別の名前を選択してください。


REP-32602:  Reports Builderを初期化できません。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-32603:  VGSシステムを初期化できません。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-32604:  レポート: '<report name>'をロード中に致命的なエラーが発生しました。バージョンを確認してください。

原因:	指定したレポートがロードできません。
処置:	レポートの正しいバージョンをオープンしていることを確認してください。


REP-32605:  読込み用のレポート・ファイルをオープンできません。

原因:	レポート・ファイルが読み込めません。
処置:	レポート・ファイルの読込み権限をチェックしてください。


REP-32606:  読込み用のファイル: '<translation file>'をオープンできません。

原因:	指定したファイルがオープンできません。
処置:	ファイルが存在していて、読込み可能であることを確認してください。


REP-32607:  Translation Builderツリーが存在しません。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-32608:  その言語の翻訳は存在していません。

原因:	指定されたターゲット言語に翻訳できません。
処置:	ターゲット言語がサポートされていることを確認してください。


REP-32609:  無効なレポート・ツリーです。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-32610:  ソース・データ・ファイル（'<file name>'）が一致しません。

原因:	レポートにマージしようとしている翻訳ファイルは、選択したレポートから作成されたものではありませんでした。
処置:	翻訳ファイルを元のレポートにマージしてください。


REP-32612:  基本言語が残っているので、マージできません。

原因:	翻訳されていない文字列を元のレポートにマージしようとしています。
処置:	翻訳ファイル内の文字列を翻訳してから、再度操作を行ってください。


REP-32613:  NXファイルでVGS文字列に一致する文字列が見つかりません。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-32614:  言語: '<language name>'の文字列マージが成功しました。

原因:	操作は正常に完了しました。
処置:	処置は不要です。


REP-32615:  マージに失敗しました。

原因:	マージ操作中に、エラーが検出されました。
処置:	詳細は、ログ・ファイルをチェックしてください。


REP-32616:  NXファイルで翻訳文字列が見つかりません。

原因:	翻訳ファイルに翻訳済み文字列が含まれていません。
処置:	指定のレポートに対して、正しい翻訳ファイルを使用していることを確認してください。


REP-32617:  NXファイルが壊れています。

原因:	これは異常な状態です。
処置:	詳細は、「異常な状態」を参照してください。


REP-32618:  読込み用のNXファイルをオープンできません。

原因:	翻訳ファイルがオープンできません。
処置:	ファイルが存在していて、読込み可能であることを確認してください。


REP-32750: イメージ: '<image name>'のデータが解凍できません。イメージは削除されました。

原因:	イメージ・データが壊れています。
処置:	イメージをインポートし直してください。


REP-32751:  警告: テキスト・セグメントの一部が不足しています。

原因:	一部のボイラープレート・テキストのセグメントが見つかりません。レポートが壊れている可能性があります。
処置:	レポートのボイラープレート・テキスト・オブジェクトをチェックしてください。疑わしいと思われるテキスト・オブジェクトを削除し、新しく作成したテキストに置き換えてください。


REP-34300:  配布リストが使用できません。

原因:	配布宛先がありません。
処置:	配布宛先を割り当ててください。


REP-34301:  フィールドの値が無効です。

原因:	値が入力されていません。
処置:	値を入力してください。


REP-34302:  宛先フォーマットが実行時モードと互換性がありません。

原因:	そのフォーマットはモードと互換性がありません（たとえば、レポートがビットマップで、配布宛先が文字モードに設定されている場合）。
処置:	宛先側のフォーマットをチェックしてください。


REP-34303:  正常に配布されました。

原因:	配布が正常に行われました。
処置:	ありません。


REP-34304:  配布に失敗しました。配布リストをチェックしてください。

原因:	配布に失敗しました。
処置:	配布リストをチェックしてください。


REP-34305:  destid= '<値>'のキーワード設定に誤りがあります。

原因:	配布ファイル内のキーワード設定（DESNAMEなど）に誤りがあります。
処置:	キーワード設定をチェックし、必要な変更を行ってください。


REP-34306:  宛先に配布IDが指定されていません。

原因:	配布ファイル内で、宛先のIDが指定されていません。
処置:	宛先行に一意の配布IDを追加してください。


REP-34307:  宛先に指定した配布IDが重複しています。

原因:	配布ファイル内で、宛先のIDが重複しています。
処置:	宛先行に一意の配布IDを追加してください。


このトピックは使用できません。

選択したヘルプ・トピックは、このヘルプ・システムでは利用できません。ただし、ご使用のシステムにReport Builderがインストールされている場合は、Report Builderのヘルプ・システムの索引を検索して、目的のトピックを見つけることができます。


メッセージ

  関連項目

メッセージ範囲をクリックし、「参照」ボタンを使ってページを検索することにより、目的のメッセージを探します。

REP-0001~REP-0089

REP-0090~REP-0159

REP-0160~REP-0249

REP-0250~REP-0499

REP-0500~REP-0539

REP-0540~REP-0589

REP-0590~REP-0659

REP-0660~REP-0719

REP-0720~REP-0779

REP-0780~REP-0899

REP-0900~REP-1059

REP-1060~REP-1209

REP-1210~REP-1259

REP-1260~REP-1299

REP-1300~REP-1339

REP-1340~REP-1429

REP-1430~REP-1819

REP-1820~REP-1869

REP-1870~REP-1999

REP-2000~REP-3079

REP-3080~REP-3349

REP-3350~REP-3439

REP-3440~REP-4039

REP-4040~REP-16519

REP-16520~REP-25339

REP-25400~REP-32599

REP-32600~REP-32307


文書の命名規則

文書で作業する際は、一定の命名規則に従う必要があります。文書が保存されているのが、データベースの場合とオペレーティング・システム・ファイルの場合では、従う規則が異なります。

データベース・オブジェクト

データベースに保存されたReport Builder文書の命名規則は、SQLの命名規則とよく似ています。特に、文書名の規則は次のとおりです。

•	長さは30バイトまでです。

•	文字で開始する必要があります。

•	大/小文字の区別はありません。

•	文字および数字、特殊文字$、#、@、_を含みます。

•	タイプが同じオブジェクトに、同じ名前を付けることはできません（2つのレポートに同じ名前を付けることはできません）。

ファイル

オペレーティング・システム・ファイルに保存されたオブジェクトを命名するときは、データベース・オブジェクトの命名規則（前項を参照してください）の他に、使用しているオペレーティング・システムのファイルの命名規則にも従います。オペレーティング・システム・ファイルとしてオブジェクトを保存する場合は、次の拡張子を持つASCII形式で保存します。

•	.rex（レポート用）

•	.sql（外部問合せ用）

•	.pls（外部PL/SQLライブラリ用）


データ・モデル・オブジェクトの命名規則

データ・モデル・オブジェクトの命名規則は、SQL命名規則と同じです。特に、データ・モデル・オブジェクト名の規則は次のとおりです。

•	長さは30バイトまでです。

•	文字で開始する必要があります。

•	大/小文字の区別はありません。

•	文字および数字、特殊文字$、#、@、_を含みます。

•	1つのレポートで、タイプが同じデータ・モデル・オブジェクトに、同じ名前を付けることはできません。

使用上の注意

•	前述のデータ・モデル・オブジェクトの命名規則の他に、パラメータの名前に、Report Builderのオブジェクトの名前またはRWRUN60コマンド・ラインのキーワードと同じ名前を付けることはできません。


レイアウト・オブジェクトの命名規則

レイアウト・オブジェクトの命名規則は、SQL命名規則と同じです。特に、レイアウト・オブジェクト名の規則は次のとおりです。

•	長さは30バイトまでです。

•	文字で開始する必要があります。

•	大/小文字の区別はありません。

•	文字および数字、特殊文字$、#、@、_を含みます。

•	1つのレポートで、タイプが同じレイアウト・オブジェクトに、同じ名前を付けることはできません。


パラメータ・フォーム・オブジェクトの命名規則

パラメータ・フォーム・オブジェクトで作業する際は、一定の命名規則に従う必要があります。命名規則は、SQL命名規則と同じです。特に、パラメータ・フォーム・オブジェクト名の規則は次のとおりです。

•	長さは30バイトまでです。

•	文字で開始する必要があります。

•	大/小文字の区別はありません。

•	文字および数字、特殊文字$、#、@、_を含みます。

•	1つのレポートで、タイプが同じパラメータ・フォーム・オブジェクトに、同じ名前を付けることはできません。


チャート・ウィザード:  前置きページ

チャート・ウィザードについて

チャート・ウィザードを使用すると、チャート作成プロセスによってレポートの内部から段階的にチャートを設定できます。チャート・ウィザードを使用すると、次のことが可能になります。

•	チャート・タイプとサブタイプを指定します。

•	問合せまたはチャートの列に割り当てるデータを含むデータ・グループを指定します。

•	チャートの項目（X）軸用のデータを指定します。

•	チャートの値（Y）軸用のデータを指定します。

•	レポート内のチャートの位置と頻度を指定します。

チャート・ウィザードの各ページで表示されるプロンプトに従って、作成するチャートの設定を指定します。

再入力可能なチャート・ウィザード

チャート・ウィザードには、再入力可能モードで動作できるという特徴があります。つまり、チャート・ウィザードを使用して作成されたチャートは、このウィザードで修正できるということです。

再入力可能モードでチャート・ウィザードを起動するには、オブジェクト・ナビゲータでチャート・オブジェクトを選択し、メニューから「ツール」 [image] 「チャート・ウィザード」 を選択します。

チャート・ウィザードでのナビゲート

チャート・ウィザードには、そのページ内を自由にナビゲートするためのボタンが5つあります。

•	取消—加えた変更（ある場合）をすべて取消し、ウィザードを終了します。

•	ヘルプ—ウィザードの現行ページのオンライン・ヘルプ・テキストを表示します。

•	戻る—ウィザードの前のページに移動します。

•	次へ—ウィザードの次のページに移動します。

•	完了—ウィザードで加えた変更（ある場合）を保存し、ウィザードを終了します。

注意: ウィザードの特定のページで必要な情報をすべて入力する前に「次へ」または「戻る」をクリックした場合、ウィザードは次（または前）のページをナビゲートすることはありません。同様に、必要な情報をすべてウィザードに入力する前に「完了」をクリックした場合、ウィザードは必須データを入力できるページを自動的に表示します。


チャート・ウィザード:  タイプ・ページ

  ウィザードについて

チャート・ウィザードを使用して、次のようにチャート・タイプを指定します。

1	（オプション）「タイトル」フィールドにチャートの上に表示されるタイトルを入力します。

2	「チャート・タイプ」リストからチャート・タイプを選択します。チャート・タイプでは、円グラフまたは棒グラフといった基本的な表示書式を指定します。表示ウィンドウには、選択したチャート・タイプの例が表示されます。

3	「チャート・サブタイプ」リストからチャート・サブタイプを選択します。チャート・サブタイプは、Shadowsといった表示の特定のスタイルまたはテンプレートです。「チャート・サブタイプ」リストには、選択したチャート・タイプで使用することができるサブタイプが表示されます。


チャート・ウィザード:  データ・グループ・ページ

  ウィザードについて

チャート・ウィザードを使用して、次のようにチャートのデータ・グループ（問合せ）を選択します。

注意:  このページは、問合せまたは分岐グループがレポートに複数含まれている場合のみ表示されます。このページを使用して、チャートを作成するために使用される問合せまたはデータ・グループを指定できます。

  「データ・グループ」リストから、チャート列にマップするデータを含む問合せまたはデータ・グループを選択します。選択したグループによって、チャートの項目軸および値軸に割当て可能なフィールドが判別されます。


チャート・ウィザード:  項目ページ

  ウィザードについて

チャート・ウィザードを使用して、次のようにチャートの項目（X）軸にデータをマップします。

1	「使用可能フィールド」リストから、チャートの項目（X）軸にデータをマップするフィールドを選択します。次ページにナビゲートする前に少なくともフィールドを1つ選択する必要があります。

2	 をクリックし、「使用可能フィールド」リストから「項目軸」リストに選択済みフィールドを転送します。ヒント

注意:  次のページにナビゲートする前に、「使用可能フィールド」リストから「項目軸」リストに少なくともフィールドを1つ転送する必要があります。


チャート・ウィザード:  値ページ

  ウィザードについて

チャート・ウィザードを使用して、次のようにチャートの値（Y）軸にデータをマップします。

1	「使用可能フィールド」リストから、チャートの値（Y）軸にデータをマップするフィールドを選択します。

2	 をクリックし、「使用可能フィールド」リストから「値軸」リストに選択済みフィールドを転送します。ヒント

注意:  次のページにナビゲートする前に、「使用可能フィールド」リストから「値軸」リストに少なくともフィールドを1つ転送する必要があります。


チャート・ウィザード:  ブレーク・ページ

  ウィザードについて

チャート・ウィザードを使用して、次のようにレポート内のチャート位置を指定します。

  「チャート」リストから、レポート位置と頻度を示すチャート・グループ化指定を選択すると、レポートのフィールドについてのチャートが表示されます。次の位置にチャートを表示できます。

•	レポートの最初

•	レポートの最後

•	繰返し枠ごと。レポートに複数の繰返し枠が含まれている場合は、各繰返し枠が「チャート」リストの選択オプションとして表示されます。

チャートが繰返し枠内にあり、ページ境界内に表示できる大きさの場合は、チャートは枠内のフィールドの左に表示されます。これより大きなチャートの場合は、繰返し枠のフィールドの下に表示されます。

チャート作成後にチャートの位置を変更するには、選択して新しい位置にドラッグします。


チャート・ウィザード:  ファイル名ページ

  ウィザードについて

チャートをデフォルトのファイル名で保存する方法は、次のとおりです。

  「完了」をクリックします。チャートは、「ファイル名」フィールドに表示されている自動生成されたデフォルト名で保存されます。完成したチャートは、チャートが作成されたときの表示に応じて、レイアウトまたはライブ・プレビューアに表示されます。

チャートをデフォルト以外のファイル名で保存する方法は、次のとおりです。

1	「上書き保存」をクリックします。

2	「ファイル名を付けて保存」ダイアログ・ボックスでチャートを保存するディレクトリを探し、新しいファイル名を入力します。「保存」をクリックします。

3	「完了」をクリックします。チャートは、チャートが作成されたときの表示に応じて、レイアウトまたは「ライブ・プレビューア」に表示されます。

次の作業について

「完了」をクリックすると、Report Builderは完成したチャートを表示します。ウィザードに戻るには、終了したチャート・オブジェクトを選択して、メニューから「ツール」 [image] 「チャート・ウィザード」を選択します。

チャートの作成の詳細は、オンライン・ヘルプを参照してください。

1	簡単な概要は、「クイック・ツアー」を参照してください。

•	「ヘルプ」 [image] 「クイック・ツアー」を選択します。

2	最も一般的な作業の実行方法を学習するには、キュー・カードを参照します。

•	「ヘルプ」 [image] 「キュー・カード」を選択します。

3	オンライン・マニュアルにアクセスします。

•	「ヘルプ」 [image] 「マニュアル」を選択します。

4	「ヘルプ・トピック」を検索します。

•	目次および索引の表の場合、「ヘルプ」 [image] 「ヘルプ・トピック」を選択します。

•	状況判断ヘルプを参照するには、[Help]キー（ほとんどのプラットフォームでは通常[F1]キー）を押します。


ヒント

「項目軸」リストから「使用可能フィールド」リストに選択済みフィールドを転送するには、 [image] をクリックします。


ヒント

「値軸」リストから「使用可能フィールド」リストに選択済みフィールドを転送するには、 [image] をクリックします。


Report BuilderについてのOracle8使用上の注意

列オブジェクトと参照列

•	属性列または列オブジェクトのメソッドを参照するには、表の別名または相関変数で名前を修飾する必要があります。たとえば、次のように指定します。

select e.empno, e.address.street, e.address.city from emp e

•	列オブジェクトや参照列を全体として移動することも、個々の属性列を移動することもできます。関連する列オブジェクトの外部に属性列を移動すると、その列オブジェクトから切り離されて、他の列と同じように扱われます。列オブジェクトとの関連付けを示すために名前（ADDRESS_ZIPなど）のみが更新されます。

•	列オブジェクトをレイアウト・オブジェクトのソースにすることはできませんが、その属性列をレイアウト・オブジェクトのソースとして使用することはできます。たとえば、STREET、CITY、STATEおよびZIPで構成されるADDRESSという名前の列オブジェクトがあるとします。ADDRESSはフィールドのソースになりませんが、STREET、CITY、STATEまたはZIPはフィールドのソースになります。

•	列オブジェクトや参照列は、その属性列の1つが存在する最下位のグループに存在する必要があります。これは、列オブジェクトや参照列の頻度が、最高頻度の属性列と同じ必要があるからです。列オブジェクトや参照列が属性列の1つより上のグループにあると、頻度が低くなりすぎてエラーが発生します。たとえば、列オブジェクトADDRESSがG_MASTERという名前のグループにあり、その属性列の1つがZIPであるとします。G_DETAILというG_MASTERの子にZIPをドラッグする場合は、ADDRESSもG_DETAILに移動してください。

•	列オブジェクトをバインド変数（つまり:column_name）として使用することはできませんが、その属性列をバインド変数として使用することはできます。

•	列オブジェクトや参照列でブレークすることはできません。したがって、列オブジェクトや参照列をブレーク・グループの唯一の列にすることはできません。ただし、列オブジェクトの属性列でブレークすることはできます。たとえば、列オブジェクトとそのすべての属性列をブレーク・グループにドラッグし、必要な数の属性列にブレーク順序を割り当てることができます。

•	データ・モデルのリンクで列オブジェクトや参照列を使用することはできません。リンクで使用できるのは、その個々の属性列のみです。たとえば、STREET、CITY、STATEおよびZIPで構成されるADDRESSという名前の列オブジェクトがあるとします。ADDRESSの任意の属性列（CITYなど）を使って、リンクを作成できます。

サマリー、式およびプレースホルダ

•	式列またはプレースホルダ列のデータ型は、Oracle7ビルトイン・データ型（CHAR、VARCHARなど）の1つにしてください。Oracle8で新しく追加されたデータ型は、まだサポートされていません。

•	列オブジェクトや参照列をソースとして持つサマリー列では、First、LastおよびCountファンクションのみを使用できます。

可変配列およびネストした表

•	可変配列およびネストした表のタイプはまだサポートされていません。問合せでこれらのタイプの列オブジェクトを選択すると、データ・モデル表示の列オブジェクトの横に、サポートされていないことを示す特殊なアイコンが表示されます。

ラージ・オブジェクト(LOB)

•	LOBはまだサポートされていません。問合せでLOBを選択すると、データ・モデル表示のLOBの横に、サポートされていないことを示す特殊なアイコンが表示されます。


プロパティ・パレットについて

プロパティ・パレットには、オブジェクト・プロパティの表示および検索、設定ができる一括表示型インタフェースがあります。プロパティ・パレットには、次の機能があります。

•	拡張と縮小が可能なノード

•	その場でのプロパティ編集

•	検索機能

•	複数選択

•	複合プロパティ・ダイアログ

•	プロパティ・パレットの複数インスタンスを起動する能力

エディタまたはナビゲータでオブジェクトを選択すると、プロパティ・パレットが更新され、選択したオブジェクトのプロパティが表示されます。デフォルトでは、異なるオブジェクトを選択するたびに、パレットに表示されるプロパティ・リストが同期化されます。プロパティ・パレットのツールバーで「固定解除」ボタンをクリックして、特定のパレットの同期化をオンまたはオフに切り替えられます。

オブジェクトのプロパティを比較する必要がある場合、「停止」ボタンをクリックして、現行のプロパティ・パレットを固定し、必要に応じてその他のプロパティ・パレットを起動します。

プロパティ・パレットには、次の機能があります。

プロパティ・リスト

プロパティ・リストは、プロパティ名とプロパティ値の2列のリストです。オブジェクトが選択されていない場合、リストにプロパティは表示されません。プロパティは、「一般情報」プロパティや「フィールド」プロパティのような、機能ヘッダーまたはオブジェクト・ヘッダーのもとにグループ化されます。クリックするか、上/下の矢印キーによってナビゲートし、リストのプロパティを選択します。プロパティ・リスト・ペインで、プロパティを選択し、必要に応じて入力またはダブルクリックして、プロパティを設定することができます。

名前

「名前」フィールドには、ナビゲータまたはエディタで現在選択されているオブジェクトの名前が表示されます。「名前」フィールドは、オブジェクトが選択されていない場合は表示されません。同時に複数のオブジェクトが選択されている場合、名前のリストがプロパティ・パレットの一番上に表示されます。

プロパティ制御の設定

プロパティ・リストでプロパティが選択されている場合、プロパティの横に次のようにテキスト・フィールドまたはポップリスト、コンボ・ボックス、「...」ボタンが表示されます。

現行のプロパティをテキスト値の入力によって設定できる場合、テキスト・フィールドが表示されます。さらに長いテキスト値を必要とするプロパティの場合は、テキスト・フィールドの横にあるアイコン・ボタンを押して、モーダル・エディタを起動します。

プロパティに、TRUE/FALSEまたは一連の固定有効値のいずれかがある場合、ポップリストが表示されます。ダブルクリックを繰り返して、値を循環させることができます。

プロパティを、値の入力またはポップリストからの選択によって設定できる場合、コンボ・ボックスが表示されます。

プロパティに、さらに複雑な値が必要な場合、「...」ボタンが表示されます。このボタンを選択すると、必要な情報を入力するためのダイアログが起動されます。

プロパティ・パレットは、文書で作成するオブジェクトのプロパティを設定する場所です。


プロパティ・パレットでの複数選択について

  関連項目

ナビゲータまたはエディタで、[Shift]を押しながらクリックするか、[Ctrl]を押しながらクリックすると、複数のオブジェクトを同時に選択できます。複数のオブジェクトが選択されると、オブジェクト名のリストがプロパティ・パレットの一番上に表示されます。

2つ以上のオブジェクトが選択されている場合、プロパティ・パレットのツールバーの「論理積/論理和」コマンドによって、プロパティ・リストにどのプロパティが表示されるかが決まります。論理積と論理和を切り替えると、プロパティ・パレットに表示されるプロパティのリストは変更されますが、プロパティの設定には影響ありません。

論理積  デフォルト。すべての選択されたオブジェクトに共通のプロパティのみが表示されます。

論理和  選択された各オブジェクトのプロパティがすべて表示されます。

複数選択の2つ以上のオブジェクトに共通するプロパティは1度のみ表示され、プロパティの設定は次のように表示されます。

•	選択されたオブジェクトがすべて共通のプロパティを持ち、その設定が同じである場合、その共通の設定が表示されます。

•	共通のプロパティを持つオブジェクト間でその設定が異なる場合、文字列*****が表示されます。


プロパティ・パレットのツールバー・コマンドについて

  関連項目

ツールバーを使用すると、コマンドに迅速にアクセスできます。実行するコマンドのアイコンをクリックします。

継承	テンプレートの「デフォルト・セクション」および「見出し」、「ボディ」、「集計」のみに適用されます。現行のプロパティをデフォルトに設定します。複数のプロパティを選択して、「継承」をクリックすることができます。
ローカライズ	テンプレートの「デフォルト・セクション」および「見出し」、「ボディ」、「集計」のみに適用されます。現行のプロパティをローカルにします（つまり、継承しません）。複数のプロパティを選択して、「ローカライズ」をクリックすることができます。
「検索」フィールド	プロパティ・パレットで検索する文字列です。
順方向検索	「検索」フィールドの文字列を順方向検索します。
逆方向検索	「検索」フィールドの文字列を逆方向検索します。
論理積/論理和	プロパティ・パレットの結合表示モードと分岐表示モードの切替えを行います。同時に複数のオブジェクトが選択されている場合（複数選択）、このオプションによってどのプロパティが表示されるかが決まります。分岐モード（デフォルト）では、選択されたオブジェクトに共通のプロパティのみが表示されます。結合モードでは、現在選択されているすべてのオブジェクトのプロパティが表示されます。
固定/固定解除	プロパティ・パレットの同期化のオンとオフを切り替えます。「停止」がオフ（デフォルト）の場合、ナビゲータおよびその他のウィンドウで選択するオブジェクトのプロパティを表示するように、プロパティ・リストが更新されます。「停止」がオンの場合、プロパティ・リストは固定されて更新されないため、その他のプロパティ・リストと比較することができます。


プロパティ・パレットの表示

オブジェクトのプロパティ・パレットを表示するには、次のいずれかを行います。

•	オブジェクトをダブルクリックする。2つ目のプロパティ・パレットを起動するには、現行のプロパティ・パレットを固定し、オブジェクト・アイコンをダブルクリックしてください。

•	オブジェクトをクリックし、「ツール」 [image] 「プロパティ・パレット」を選択します。

•	ポップアップ・メニュー（Windowsで右クリック）から「プロパティ・パレット」を選択します。

•	オブジェクト・ナビゲータで、オブジェクトのプロパティ・アイコンをダブルクリックします。


プロパティ・パレットのクローズ

プロパティ・パレットをクローズするには:

  右上の隅にあるクローズ・ボックスをクリックします。


プロパティ・パレットを使用したプロパティの設定

プロパティ・パレットを使用してプロパティを設定するには:

1	「プロパティ・パレットを表示」します。

2	設定するプロパティを選択します。

プロパティを選択するには、クリックするか、上/下の矢印キーによってナビゲートします。プロパティが選択されると、テキスト・フィールドまたはポップリスト、コンボ・ボックス、「...」ボタンが、そのプロパティの横に表示されます。

3	プロパティを希望どおりに設定します。


複数選択でのプロパティの設定

  例	  関連項目

複数選択してプロパティを設定するには:

1	オブジェクト・ナビゲータまたはエディタで設定するプロパティを持つオブジェクトを選択します。オブジェクトは、タイプが異なるものでも、異なるレポートにあるものでもかまいません。

2	「ツール」 [image] 「プロパティ・パレット」を選択します。

3	プロパティ・パレットで、すべてのオブジェクトのすべてのプロパティを参照する場合は、 [image] （「論理和」ボタン）をクリックします。または、オブジェクトに共通なプロパティのみを参照する場合は [image] （「論理積」ボタン）をクリックします。

4	プロパティを希望どおりに設定します。

プロパティの設定に加えた変更は、現在選択されているオブジェクトのうちで、そのプロパティが適用されるすべてのオブジェクトに適用されます。


複数選択でのプロパティの設定の例

  関連項目      [image]  すべての例

レポートには複数のフィールドが組み込まれており、各フィールドには日付が表示されます。各フィールドの「データ型」プロパティはDATEであるため、日付はデフォルトのOracle書式YY-MM-DDで表示されます。

アプリケーションで全体を通してこれとは異なる日付書式を使用するには、日付を表示する各フィールドの「書式マスク」プロパティを設定する必要があります。各フィールドの「書式マスク」プロパティを個々に設定するのではなく、すべての項目を選択してから「書式マスク」プロパティを設定すれば、選択した各項目の書式マスクが一度に変更されます。


オブジェクトどうしのプロパティの比較

オブジェクトどうしのプロパティを比較するには:

1	オブジェクト・ナビゲータまたはエディタで最初のオブジェクトをダブルクリックし、プロパティ・パレットにそのオブジェクトのプロパティを表示します。

2	プロパティ・パレットで [image] をクリックして、同期化をオフにし、プロパティ・パレットを「停止」します。

3	オブジェクト・ナビゲータで、2番目のオブジェクトをクリックしてから、ポップアップ・メニューから「プロパティ・パレット」を選択します。

2つ目のプロパティ・パレットが表示されます。2つ目のウィンドウが最初のウィンドウの上に重なったときは、ドラッグして最初のウィンドウの横に並べます。


アンカー・プロパティ

  制限 [image]  例

子の枠の割合（%）

子の枠の種類

子オブジェクト名

水平方向に縮小

垂直方向に縮小

コメント

名前

親の枠の割合（%）

親の枠の種類

親オブジェクト名


アンカーの制限

•	オブジェクトは、ただ1個に限り他のオブジェクトにアンカーされることがあります。

•	マトリックス・オブジェクトおよびアンカー、マージンは、何に対してもアンカーできません（つまり、これらはアンカーについて親オブジェクトにも子オブジェクトにもなれません）。

•	あるマトリックスの垂直繰返し枠または水平繰返し枠となっている繰返し枠は、別のオブジェクトにはアンカーできませんが、その他のオブジェクトはこれらの繰返し枠にアンカーできます（つまり、これらの繰返し枠はアンカーについて親オブジェクトにはなれますが、子オブジェクトにはなれません）。

•	非表示オブジェクト（「可視」が「いいえ」に設定されているオブジェクト）には、何もアンカーできません。

•	アンカーを移動すると、アンカーされている2つのオブジェクトも一緒に移動します。

•	オブジェクトの依存関係が循環した形になるようにオブジェクト同士をアンカーすることはできません。たとえば、次のように指定します。

•	オブジェクトAとオブジェクトBが互いにアンカーされており、オブジェクトAが親であるとします。オブジェクトBは、オブジェクトAとオブジェクトB間の別のアンカーについて親にはなれません。さらに、オブジェクトCがオブジェクトAへのアンカーについて親である場合、オブジェクトBはオブジェクトCへのアンカーについて親にはなれません。

  ここをクリックしてください。

•	枠Aの中にフィールドBがあり、レイアウト・モデルでフィールドBが枠Aの上にあるとします。また、枠Aが、枠Aの外側にあるフィールドCにアンカーされており、フィールドCが親であるとします。この場合、フィールドCは、フィールドBへのアンカーについて親にはなれません。それは、フィールドBが枠Aの中にあるため、フィールドCが親の場合はフィールドBをフィールドCにアンカーできないからです。

  ここをクリックしてください。

•	アンカーをコピーするには、アンカーとアンカーされている2つのオブジェクトを選択してください。アンカーのみを選択した場合は、何もコピーされません。アンカーと一方のオブジェクトを選択した場合は、選択されたオブジェクトのみがコピーされます。

•	アンカーのサイズは変更できません。

•	アンカーは、必ずアンカーされるオブジェクトより上にしてください（つまり、アンカーは、親オブジェクトと子オブジェクトよりも上のレイヤーに存在する必要があります）。Report Builderでは、親オブジェクトと子オブジェクトより下のレイヤーにアンカーを移動できないようになっています。

•	「配置」メニューの「オブジェクト整列」および「オブジェクト・サイズ設定」をアンカーに対して使用することはできません。


子の枠の割合（%）;
子の枠の割合（%）

説明  「子の枠の割合（%）」プロパティは、アンカーが配置されている子オブジェクトの枠の縦または横（上から下または左から右）のパーセンテージを示します。この設定によって、オブジェクトが挿入されたときの枠上のアンカーの位置が決まります。

値  0～100の整数

適用対象  アンカー


子の枠の種類;
子の枠の種類

説明  「子の枠の種類」プロパティは、アンカーが配置されている子オブジェクトの枠を示します。

値  上、下、左、右

適用対象  アンカー


子オブジェクト名

説明  「子オブジェクト名」プロパティは、子オブジェクトの名前を示します。このフィールドは、読込み専用です。

適用対象  アンカー


水平方向に縮小;
水平方向に縮小

  例

説明  「水平方向に縮小」プロパティは、親オブジェクトがなんらかの理由で印刷されない場合（たとえば、「印刷オブジェクト・オン」または「基本印刷オン」、「フォーマット・トリガー」プロパティによって）、アンカーの幅が0（ゼロ）である必要があるかどうかを示します。親オブジェクトが印刷されない場合、子オブジェクトは、親オブジェクトが印刷されるはずであった領域に水平移動します。

適用対象  アンカー


垂直方向に縮小;
垂直方向に縮小

  例

説明  「垂直方向に縮小」プロパティは、親オブジェクトがなんらかの理由で印刷されない場合（たとえば、「印刷オブジェクト・オン」または「基本印刷オン」、「フォーマット・トリガー」プロパティによって）、アンカーの高さが0（ゼロ）である必要があるかどうかを示します。親オブジェクトが印刷されない場合、子オブジェクトは、親オブジェクトが印刷されるはずであった領域に垂直移動します。

適用対象  アンカー


フィールドを水平に中央揃えする例

  関連項目 	  すべての例

「水平拡張度」が「可変」に設定された繰返し枠内で、フィールドを水平に中央揃えするとします。また、このフィールドを繰返し枠の枠左部から一定の間隔をおいて固定するとします。フォーマットされた繰返し枠の大きさがわからないので、フィールドを中央揃えするにはアンカーを使用してください。

繰返し枠内でフィールドを水平に中央揃えするには、次の手順に従います。

•	繰返し枠上部中央のX座標がフィールド上部中央のX座標と一致するように、繰返し枠の中央にフィールドを配置する。下の図を参照してください。

•	フィールドの上部中央から繰返し枠上部中央までアンカーを描く。ヒント

これで、このフィールドは繰返し枠内で水平に中央揃えされます。

  ここをクリックしてください。


フィールドを垂直に中央揃えする例

  関連項目 	  すべての例

「垂直拡張度」が「可変」に設定された繰返し枠内で、フィールドを垂直に中央揃えするとします。また、このフィールドを繰返し枠の枠左部から一定の間隔をおいて固定するとします。フォーマットされた繰返し枠の大きさがわからないので、フィールドを中央揃えするにはアンカーを使用してください。

繰返し枠内でフィールドを垂直に中央揃えするには、フィールド枠の左側から繰返し枠枠左側までアンカーを描きます。ヒント

これで、このフィールドは繰返し枠内で垂直に中央揃えされます。

  ここをクリックしてください。


垂直方向に縮小する例（フィールド）

  関連項目 	  すべての例

フィールドBをフィールドAにアンカーし、「垂直方向に縮小」を「はい」に設定したとします。

  ここをクリックしてください。

レポートの最初の論理ページにフィールドAが印刷され、ページの領域をフィールドAが大量に使用しているため、フィールドBが同じ論理ページ内に収まらないとします。そこで、フィールドBは、フィールドAが印刷されない論理ページの2ページ目に印刷されます。「垂直方向に縮小」が「はい」に設定されているので、アンカーはY軸方向に縮小します。フィールドBは、フィールドAが論理ページに実際に印刷されなくても、フィールドAに対するX軸方向の相対的位置を維持します。

  ここをクリックしてください。


水平および垂直方向に縮小する例（フィールド）

  関連項目 	  すべての例

フィールドBがフィールドAにアンカーされているときに、フィールドBを水平と垂直の双方向に移動して、フィールドAが印刷されるはずであった領域に配置するとします。そのためには、次の手順に従います。

•	フィールドBの上部からフィールドAの下部にアンカーを描きます。

•	「水平方向に縮小」と「垂直方向に縮小」の両方を「はい」に設定します。

  ここをクリックしてください。

レポートの最初の論理ページにフィールドAが印刷され、ページの領域をフィールドAが大量に使用しているため、フィールドBは同じページ内に収まりません。そこで、フィールドBは、フィールドAが印刷されない論理ページの2ページ目に印刷されます。アンカーは縮小し、フィールドAが描画として印刷されるはずであった位置にフィールドBが移動します。

  ここをクリックしてください。

フィールドAとBが同一の論理ページに印刷される場合、アンカーは縮小されず、これらのフィールドは互いに相対的な位置を維持します。


オブジェクトの枠上にアンカーを配置する場合、[Shift]キーを押しながらクリックすると、25%の増分値で枠に沿って移動できます。


親の枠の割合（%）

説明  「親の枠の割合（%）」プロパティは、アンカーが配置されている親オブジェクトの枠の縦または横（上から下または左から右）のパーセンテージを示します。この設定によって、オブジェクトが挿入されたときの枠上のアンカーの位置が決まります。

値  0～100の整数

適用対象  アンカー


親の枠の種類

説明  「親の枠の種類」プロパティは、アンカーが配置されている親オブジェクトの枠を示します。

値  上、下、左、右

適用対象  アンカー


親オブジェクト名;
親オブジェクト名

説明  「親オブジェクト名」プロパティは、親オブジェクトの名前を示します。このフィールドは、読込み専用です。

適用対象  アンカー


ボイラープレート・プロパティ

  制限

追加のハイパーリンク属性

アプリケーション・コマンド・ライン（PDF）

基本印刷オン

ブックマーク

コメント

HTMLタグを含む

表示名

フォーマット・トリガー

水平拡張度

ハイパーリンク（HTML/PDF）

ハイパーリンクの宛先

アンカー・オブジェクトと連動

枠付きの行伸長

最小孤立行

名前

後で改ページ

前で改ページ

ページ保護

印刷オブジェクト・オン

後のプリンタ・コード

前のプリンタ・コード

ソース・ファイルの書式

ソース・ファイル名

型

垂直拡張度


ボイラープレートの制限

•	ボイラープレート・テキストの各パラグラフのサイズは64Kバイト以下、もしくはパラグラフの数は64,000個以下にしてください。この制限は、オペレーティング・システムによって異なることがあります。

•	ボイラープレートは、ボイラープレートが含まれる繰返し枠の前にしてください。

注意: ボイラープレート・テキストのサイズを変更する場合は、そのテキストがオブジェクト内に必ず収まるようにしてください。フォントのディセンダ（g、qなどの文字で並び線より下の部分のために残されたスペース）が収まらない場合、そのテキスト行はレポート・エディタには表示されますが、「水平拡張度」と「垂直拡張度」の設定によっては、実行されたレポートの出力に表示されないことがあります。


HTMLタグを含む

  制限 	  例 	  関連項目

説明  「HTMLタグを含む」プロパティは、ボイラープレートまたはフィールド・オブジェクトがHTMLタグをインクルードしていることを示しています。Report Builderでは、オブジェクトを垂直にも水平にも固定でき、標準的なテキスト・オブジェクトとしてそのオブジェクトをフォーマットします（つまり、どのフィールド参照も解析されます）。パラメータとしてオブジェクトの幅と高さを渡す必要がある場合は、例で示したObjectWidthとObjectHeight変数が使用されます。

適用対象  ボイラープレートとフィールド

必須/オプション  オプション

デフォルト  いいえ


ObjectWidthとObjectHeightのHTMLへの出力例

  関連項目 	  すべての例

ボイラープレート・テキスト・オブジェクトには、オブジェクトの幅と高さをパラメータとして使用するNervousText.classという次のJava Appletを入力することができます。

<base href=http://cagney.uk.oracle.com/java/NervousText/>
<applet code="NervousText.class" width=&ObjectWidth height=&<ObjectHeight>>
<param name=text value="&deptno">
</applet>

HTMLへ出力する場合は次のように入力します。

<base href=http://cagney.uk.oracle.com/java/NervousText/>
<applet code="NervousText.class" width=84 height=72>
<param name=text value="10">
</applet>


ボイラープレート・テキスト・オブジェクト例(ハイパーリンク)

  関連項目 	  すべての例

この例は、ハイパーリンクとしてタグ付けしたボイラープレート・テキスト・オブジェクトです。

ボイラープレート・テキスト・オブジェクトとして次のものを作成します。

<a href=http://your_webserver/reports/my_report.html><img src=oracle.gif> </a>

ボイラープレート・オブジェクトを選択し、「プロパティ・パレット」をオープンします。「Webの設定」で、「HTMLタグを含む」プロパティを「はい」に設定します。


「HTMLタグを含む」の制限

•	「HTMLタグを含む」の使用は、テキスト・ボイラープレートおよびテキストのソース・ファイル書式を持つリンク・ファイル・ボイラープレート、キャラクタのソース・データ型を持つフィールドに限られます。


最小孤立行

  制限 	  例

説明  「最小孤立行」プロパティは、オブジェクトがプリントを開始する論理ページ上に現れるボイラープレートまたはフィールド・テキストの最小行数です。このプロパティに設定された行数が論理ページに収まらない場合は、テキストのすべての行が次のページに移動されます。

注意: このプロパティは、ボイラープレートまたはフィールド・オブジェクト内のテキストの最初の数行にのみ適用されます。これによって、個々のパラグラフの孤立保護が行われるわけではありません。

値  0～32Kの正の整数

適用対象  ボイラープレートとフィールド

必須/オプション  オプション

デフォルト  0（次のページに続く前に、論理ページに収まるテキストが印刷されます。)


「最小孤立行」の制限

•	「最小孤立行」プロパティの使用は、テキスト・ボイラープレートおよびテキストのソース・ファイル書式を持つリンク・ファイル・ボイラープレート、キャラクタのソース・データ型を持つフィールドに限られます。


最小孤立行の設定例（設定値1の場合と設定値2の場合）

  関連項目 	  すべての例

「最小孤立行」を1に設定すると、図のような状態になります。つまり、ある論理ページの最終行にフィールドの第1行が印刷され、残りは次の論理ページに印刷されます。「最小孤立行」を2（またはそれ以上）に設定すると、図2のように、フィールドの1行分のみ論理ページの最後に印刷されません。

  ここをクリックしてください。


ソース・ファイルの書式;
ソース・ファイルの書式

説明 「ソース・ファイルの書式」プロパティは、ボイラープレートがリンクしている外部ファイルの書式です。

値

テキスト	ASCII形式のテキストです。
イメージ	ビットマップ・イメージです。
CGM	CGM形式での線の描画です。
Oracle Drawing Format	Oracle形式での線の描画です。
イメージURL	イメージのURLリンクです。
注意: 他の全てのイメージ書式は、リリース2.0内にレポートをオープンするときのために提供されます。リリース2.0内にレポートをオープンまたは実行する場合には、ボイラープレートの特別なイメージ書式を選択してください。それ以外の場合は、上記リストの中から選択できます。

適用対象  リンク・ファイル

必須/オプション  必須


ソース・ファイル名;
ソース・ファイル名

  制限

説明  ソース・ファイル名 プロパティは、ボイラープレートがリンクしている外部ファイルまたはイメージURLの名前です。ファイルにリンクしておくと、変更される可能性があるファイルの内容を組み込む場合に便利です。次のいずれかの処理を行うと、ボイラープレートは自動的に更新され、ファイルの最新の内容が反映されます。

•	プロパティ・パレットの確定

•	オブジェクトのペースト

•	オブジェクトのインポート（Oracle Formatの場合）

•	レポートのオープン

•	レポートの実行

ボイラープレート・オブジェクトにリンクされたファイルの内容は、レポート・エディタに表示されますが、レポート・エディタ内では編集できません。

値  1K以下の長さの有効なファイル名またはイメージURLを入力します。ファイル名の前にパスを付けることができます。ファイル名の前にパスが指定されていない場合は、Report Builderのファイル・パス検索順序に従って、ファイルが検索されます。

適用対象  リンク・ファイル

必須/オプション  オプション

デフォルト  ブランク

使用上の注意

•	レポートの移植を確保するには、REPORTS30_PATHというReport Builder固有の環境変数を使用します。この変数を使用して、レポート内で使用される外部ファイル（外部問合せ、ボイラープレート、PL/SQLなど）をReport Builderが検索するためのデフォルト・ディレクトリを指定できます。これによって、レポートにディレクトリ・パスをハードコードする必要がなくなります。

•	「ファイルからの読込み」を使用して、レポートにファイルを組み込むこともできます。


「ソース・ファイル名」の制限

•	指定するファイルの最大サイズは、オペレーティング・システムによって異なります。

•	ソース・ファイル名は、オペレーティング・システムに依存します。レポートを別のオペレーティング・システムに移動すると、ファイル名を更新する必要があることがあります。

•	このフィールドは、リンク・ファイル・ツールによって作成されたオブジェクトにのみ表示されます。

•	レイアウト・オブジェクトとそのプロパティを含むファイル（つまり、エクスポートされたレイアウト・オブジェクトを含むファイル）を指定した場合は、このファイルは名前のないグラフィック・オブジェクトとして扱われます（つまり、オブジェクトのプロパティは無視されます）。オブジェクトのプロパティを使用する場合、ファイルをリンクするかわりにそれをインポートする必要があります。


型

説明  型プロパティは、ボイラープレート・オブジェクトの書式（例、テキスト）です。このフィールドは、読込み専用です。

適用対象  ボイラープレート


枠付きの行伸長;
枠付きの行伸長

  制限	  例

説明  「枠付きの伸長」プロパティは、ボイラープレート線が関係付けられた枠または繰り返し枠の名前です。このプロパティが設定されている場合、その線は両方の終点で関係付けられた枠にアンカーされます。したがって、レポートのフォーマット時に関係付けられた枠が拡張されるにつれて、この線も同じだけ伸ばされます。

縦線の場合、上の終点は枠の上部にアンカーされ、下の終点は枠の下部にアンカーされます。横線の場合、左側の終点は枠の左側にアンカーされ、右側の終点は枠の右側にアンカーされます。

値   レポート内に現在含まれている枠および繰返し枠のリストから、枠または繰返し枠を選択します。値がNULLの場合は、プロパティが設定されていません。また、レポートのフォーマット時にボイラープレート線のサイズは変化しません。

適用対象  ボイラープレート線

必須/オプション  オプション

デフォルト  NULL

使用上の注意

•	「枠付きの行伸縮」は、レイアウト位置にかかわらず、すべてのボイラープレート線に設定できます。

•	 このプロパティを使って線を繰返し枠に関係付ける場合、線は繰返し枠内に完全に収める必要があります。


「枠付きの行伸長」の例（格子表示）

  関連項目 	  すべての例

格子表示を使ってグループ左レポートの行と列を分割するとします。

  ここをクリックしてください。

アンカー、ボイラープレート線、「枠付きの行伸長」を使用して、次のようにしてレイアウトを編集します。

•	1番内側のグループ枠（GF2）とディテール繰返し枠（RF2）を拡張し、すべてのフィールドがディテール繰返し枠で囲まれるように、2つのグループ・フィールドを囲みます。

•	各グループ・フィールドをマスター繰返し枠（RF1）にアンカーします。

•	ディテール繰返し枠（RF2）内のフィールドの下にボイラープレート線L1を作成します。

•	ボイラープレート線L2～L5を作成し、「枠付きの行伸長」を使用して、外側のグループ枠（GF1）と関係付けます。

  ここをクリックしてください。

レポートがフォーマットされると、明示的なアンカーによってグループ・フィールドがマスター繰返し枠と同じ頻度で表示されます。線L1は、ディテール繰返し枠内の各レコードに対して繰り返し、線L2～L5の線は、最も外側にあるグループ枠の全長が入るように伸ばされます。


「枠付きの行伸長」の制限

•	「枠付きの行伸長」では、垂直方向および水平方向の線のみがサポートされます。対角線にこのプロパティを設定すると、レポートのフォーマット時に、縦線または横線になります。

•	このプロパティが設定されていると、「暗黙のアンカーリング」アルゴリズムが適用されません。


ボタン・プロパティ

  制限 	  関連項目

追加のハイパーリンク属性

アプリケーション・コマンド・ライン（PDF）

基本印刷オン

ブックマーク

コメント

フォーマット・トリガー

水平拡張度

ハイパーリンク（HTML/PDF）

ハイパーリンクの宛先

アイコン名

アンカー・オブジェクトと連動

ラベルの型

マルチメディア列

マルチメディア列の型

マルチメディア・ファイル

マルチメディア・ファイル・タイプ

名前

後で改ページ

前で改ページ

ページ保護

PL/SQLトリガー

印刷オブジェクト・オン

後のプリンタ・コード

前のプリンタ・コード

テキスト

型

垂直拡張度


ボタンの制限

•	ボタンは、印刷されません。また、ボタンが含まれるレポートをキャラクタ・モードで実行した場合も、ボタンは表示されません。

•	ボタンは、使用しているプラットフォームの本来のボタンの特性を持ち、「ライブ・プレビューア」に表示されます。そのため、ボタンの外観に影響する変更（たとえば、境界線を破線に変更）を「レイアウト・モデル」で行っても、出力結果に現れないことがあります。「レイアウト・モデル」では、境界線は破線に変更されますが、「ライブ・プレビューア」では変更されません。「レイアウト・モデル」では、境界線は破線に変更されますが、「ライブ・プレビューア」では変更されません。

•	ユーザー定義のボタンに様々なカラーとパターンを割り当てられるかどうかは、プラットフォームによって異なります。

•	ボタンを回転することはできません。

•	ボタンは、常に「ライブ・プレビューア」のオブジェクトの最上位のレイヤーに表示されます。ただし、ボタンが「レイアウト・モデル」の上に表示されないこともあります。たとえばボタンが「レイアウト・モデル」で繰返し枠に入っている場合、ボタンは「ライブ・プレビューア」の繰返し枠内のオブジェクトの上に表示されますが、繰返し枠ごとには表示されません。


ラベルの型;
ラベルの型

  制限

説明  「ラベルの型」プロパティは、ボタン上に表示する識別子のタイプを示します。

値

テキスト	ボタン・ラベルをテキスト文字列として使用する場合に指定します。ラベルにテキスト文字列を入力するには、「テキスト」プロパティを使用してください。
アイコン	ボタン・ラベルをアイコンとして使用する場合に指定します。ラベルにアイコンを指定するには、「アイコン名」 プロパティを使って、ラベルにアイコンが含まれたファイル名を指定します（ファイルは、UI_ICON環境変数で指定されたディレクトリにあります）。
適用対象  ボタン

必須/オプション  必須

デフォルト  テキスト


「ラベルの型」の制限

•	ラベルとして使われるアイコンは、ご使用のプラットフォームの標準のアイコン形式である必要があり、拡張子は、.icoです。アイコンは、移植できません。


テキスト

  制限

説明  「テキスト」プロパティは、「ラベルの型」で「テキスト」を選択した場合にボタンに表示されるテキスト・ラベルを示します。指定されたテキスト文字列は、ボタンの水平方向と垂直方向の両方で中央揃えになります。

値  2Kまでの長さのテキスト文字列。しかし、実際の長さは、ボタンのサイズで決まります。

適用対象  ボタン

必須/オプション  オプション

デフォルト  ブランク

使用上の注意

•	「書式」メニューの選択肢を使用して、ラベル・テキストのフォントおよびサイズ、フォントの太さ、スタイルを変更できます。しかし、このメニューの選択肢の一部（間隔および整列など）は、ボタンのテキストには効果がありません。


「テキスト」の制限

•	テキストがボタン上に収まらない場合、収まらないテキストが2行目に折り返されることはなく、テキストの左端と右端が切れてしまいます。


アイコン名;
アイコン名

説明  「アイコン名」プロパティは、「ラベルの型」で「アイコン」を選択した場合に、 ボタンに表示されるアイコンを含むファイル名を示します。

値  ご使用のプラットフォームの標準のアイコン形式で、.icoという拡張子の有効なアイコン・ファイル。ファイルは、UI_ICON環境変数で指定されたディレクトリにあります。

適用対象  ボタン

必須/オプション  オプション

デフォルト  ブランク


型

  制限

説明  「型」プロパティは、ボタンを押したときに実行されるアクションです。

値

マルチメディア・ファイル	アクションがオペレーティング・システム内のファイルに含まれることを意味します。「マルチメディア・ファイル」プロパティで指定します。
マルチメディア列	アクションがデータベース列に含まれることを意味します。「マルチメディア列」プロパティで指定します。
PL/SQL	アクションが、ボタンと関連付けられたPL/SQLプログラム単位によって制御されることを意味します。「PL/SQLトリガー」プロパティで指定します。
適用対象  ボタン

必須/オプション  必須

デフォルト  マルチメディア・ファイル


「型」の制限

•	「PL/SQL」を指定し、PL/SQLでSRW.RUN_REPORTが使われている場合、ボタンを選択したときのランタイム・パラメータ・フォームはデフォルトでは表示されません。ランタイム・パラメータ・フォームを表示したい場合は、SRW.RUN_REPORTの呼出しでPARAFORM=YESを指定する必要があります。

•	「PL/SQL」を指定し、ボタンのアクション・トリガーでSRW.PROGRAM_ABORTを呼び出す場合、ボタンによって呼び出された「プレビューア」ウィンドウはすべてクローズされます。


マルチメディア・ファイル;
マルチメディア・ファイル

  制限

説明  「マルチメディア・ファイル」プロパティは、マルチメディア（サウンド、ビデオまたはイメージ）・ファイルの名前を示します。

値  有効なサウンド・ファイル、ビデオ・ファイルまたはイメージ・ファイル

適用対象  ボタン

必須/オプション  「型」が「マルチメディア・ファイル」の場合、必須。

デフォルト  ブランク

使用上の注意

•	レポートの移植を確保するには、REPORTS30_PATHというReport Builder固有の環境変数を使用します。この変数を使用して、レポート内で使用される外部ファイル（外部問合せ、ボイラープレート、PL/SQLなど）をReport Builderに検索させるためのデフォルト・ディレクトリを指定できます。これによって、レポートにディレクトリ・パスをハードコードする必要がなくなります。


「マルチメディア・ファイル」の制限

•	「マルチメディア・ファイル」を選択した場合、表示されているテキスト・フィールドにファイル名を入力してください。ファイルのパスを入力しない場合は、Report Builderのファイル・パス検索順序に従ってファイルを検索します。


マルチメディア・ファイル・タイプ;
マルチメディア・ファイル・タイプ

説明  「マルチメディア・ファイル・タイプ」プロパティは、「マルチメディア・ファイル」プロパティによって指定されたファイルの形式を示します。

値  イメージまたはビデオ、サウンド

適用対象  ボタン

必須/オプション  必須

デフォルト  イメージ


マルチメディア列;
マルチメディア列

  制限

説明  「マルチメディア列」プロパティは、マルチメディア（サウンドまたはビデオ、イメージ）・オブジェクトが含まれるレポート内の、データベースの列の名前を示します。

値  マルチメディア・オブジェクトが含まれるレポート内の、有効なデータベースの列

適用対象  ボタン

必須/オプション  「型」が「マルチメディア列」の場合、必須。

デフォルト  ブランク


「マルチメディア列」の制限

•	ボタンのアクションに「マルチメディア列」を指定した後、レポートからその列を削除した（つまり、イメージ列を選択して、ボタンに対してその列を「マルチメディア列」として指定した後、その列を削除またはマルチメディア以外の形式に変更した）場合、そのボタンから表示するデータにはアクセスできなくなり、「マルチメディア列」は未定義になります。

「マルチメディア列」が未定義になるときにこのボタンのプロパティ・シートがオープンされている場合、別の列を選択してからそのプロパティ・シートを確定する必要があります。また、「マルチメディア列」が未定義になるときにこのプロパティ・シートがクローズされている場合、レポートを実行してボタンをアクティブにしようとするまで、警告は出ません。この処理は、エラーになります。


マルチメディア列の型;
マルチメディア列の型

説明  「マルチメディア列の型」プロパティは、「マルチメディア列」プロパティによって指定されたデータベースの列に格納される、マルチメディア・オブジェクトの形式を示します。

値  イメージまたはビデオ、サウンド

適用対象  ボタン

必須/オプション  必須

デフォルト  「マルチメディア列」が指定された場合、適切なマルチメディア列タイプが自動的に選択されます。それ以外の場合、デフォルト値はイメージです。


PL/SQLトリガー

  関連項目

説明  「PL/SQLトリガー」プロパティは、「ライブ・プレビューア」でボタンが選択されたときに実行されるPL/SQLプロシージャを示します。トリガーは、別のレポートを動的にコール（ドリルダウン）したり、他のPL/SQLを実行するのに使用できます。

適用対象  ボタン

必須/オプション  ボタンの「型」が「PL/SQL」の場合、必須。

デフォルト  ブランク


チャート・プロパティ

  制限 	  例

追加のハイパーリンク属性

アプリケーション・コマンド・ライン（PDF）

基本印刷オン

ブックマーク

チャート・ファイル名

チャート･ハイパーリンク

コメント

フォーマット・トリガー

水平拡張度

ハイパーリンク（HTML/PDF）

ハイパーリンクの宛先

アンカー・オブジェクトと連動

名前

後で改ページ

前で改ページ

ページ保護

パラメータおよび列

印刷オブジェクト・オン

後のプリンタ・コード

前のプリンタ・コード

垂直拡張度


グループ・レポート内のチャートの例

  関連項目 	  すべての例

次のデータ・モデルを持つグループ・レポートがあるとします。

ここをクリックしてください。

Graphics Builderで、各従業員の給与を示す棒グラフを表示するGraphics Builder図表（empsal.ogd）を作成しており、レポートに組み込みたいとします。「レイアウト・モデル」内のチャート・ツールを使って、まず、マスター繰返し枠（R_Dept）用の繰返し枠の中にチャート・オブジェクトを描きます。これによって、各部門別の棒グラフが表示されます。

その後、そのチャート・オブジェクトのプロパティ・パレットに移動し、「表示名」プロパティにempsal.ogdを設定します。「表示名」へのパス指定は任意ですが、このケースでは、REPORTS60_PATH環境変数に指定したパスをReport Builderで使用するので、パスは指定しません。

プロパティ・パレットのプロパティを次のように設定します。

ソース	G_Emp
チャート問合せ	Q_OG_Emp
レポート列/チャート列	ENAME/OG_NAME SAL/OG_SALARY
「レポート・グループ」は、図表によって要約されているグループ（G_Emp）です。

「チャート問合せ」は、図表内の問合せの名前です。Q_OG_Empには、次のSELECT文が含まれています。

SELECT ENAME OG_NAME, SAL OG_SALARY FROM EMP

「チャート問合せ」にQ_OG_Empを指定したので、この問合せは、データベースではなくReport BuilderからENAMEとSALの値を取り出します。

「レポート列」と「チャート列」は、レポートの列を図表の列にマップします。「レポート列」の下のリストから、ENAMEとSALを選択します。「チャート列」内のENAMEとSALに対応する図表の列の名前を入力してください。（「レポート列」が指定されている場合、「チャート列」をブランクにすることはできません。）


チャートの制限

•	データを渡すGraphics Builderの図表またはチャートは、そのソース・グループがマトリックスの次元でない場合は「レイアウト・モデル」の任意の場所に配置できます。Graphics Builderの図表またはチャートのソース・グループが、次元グループ（つまり、クロス積グループ内のグループ）の場合、そのソース・グループの上位項目（上位項目がある場合）の繰返し枠の中に表示してください。

•	パラメータを渡すGraphics Builderの図表またはチャートは、ソース・グループが、渡される列またはパラメータを含むグループ（または、グループの下位項目）となる繰返し枠の中に配置してください。渡される列が、クロス積グループによって所有されるサマリーの場合、Graphics Builderの図表またはチャートは、ソースがサマリー列の積順序内のグループである、繰返し枠の集合の中に配置してください。


チャート・ファイル名;
チャート・ファイル名

  制限

説明  「チャート・ファイル名」プロパティは、Graphics Builderの図表またはチャートが含まれるファイルの名前を示します。

値  Graphics Builderの図表またはチャート（拡張子である.ogdはオプション）の有効なファイル名を入力します。ファイル名の長さは、512バイト以下にしてください。

適用対象  チャート･オブジェクト

必須/オプション  必須

デフォルト  ブランク

使用上の注意

•	オプションでファイル名の前にパスを付けることができます。ファイル名の前にパスが指定されていない場合は、Report Builderのファイル・パス検索順序によって、ファイルが検索されます。

•	レポートの移植を確保するには、REPORTS30_PATHというReport Builder固有の環境変数を使用します。この変数を使用して、レポート内で使用される外部ファイル（外部問合せ、ボイラープレート、PL/SQLなど）をReport Builderに検索させるためのデフォルト・ディレクトリを指定できます。これによって、レポートにディレクトリ・パスをハードコードする必要がなくなります。


「チャート・ファイル名」の制限

•	ファイルに格納された図表またはチャートのみを参照できます。データベースに格納された図表またはチャートは、「チャート・ファイル名」では参照できません。


チャート・ハイパーリンク;
チャート・ハイパーリンク

  制限 	  関連項目

説明  「チャート・ハイパーリンク」プロパティは、チャート・セクションごとに異なるように指定できるハイパーリンクです。注意

値

レポート出力内の任意のオブジェクト、他のレポートまたは任意の有効なハイパーリンク宛先

適用対象

チャート・オブジェクト

必須/オプション  オプション

デフォルト  ブランク

使用上の注意

•	他のオブジェクトをその宛先として指定する、チャートの「チャート・ハイパーリンク」プロパティを設定する場合は、「ハイパーリンクの宛先」プロパティを指定する必要があります。

•	「チャート・ハイパーリンク」プロパティによって定義されたリンクに追加のHTML属性を適用する場合、「追加のハイパーリンク属性」プロパティは使用できません。

•	レポート出力から2つ目のレポートを実行することにより、他のレポートを「チャート・ハイパーリンク」プロパティとして設定できます。詳細は、ORACLE_HOMEにあるd2kcfg.htmを参照してください。

•	フォーマット・トリガーはチャートにつき1度しか実行されないため、PL/SQLを使用してこのプロパティを設定できません。その代わりに、「チャート・ハイパーリンク」プロパティとして&<column_name>を指定できます。


Report Builderは取り出されたデータの各行のプロパティを評価するという点において、「チャート・ハイパーリンク」プロパティの動作と「ハイパーリンク」プロパティの動作は異なります。


チャート・パラメータと列プロパティ

チャート列

チャート・パラメータ

チャート問合せ

レポート列（チャート列）

レポート列（チャート・パラメータ）

レポート・グループ


チャート・パラメータ

  関連項目

説明  「チャート・パラメータ」プロパティは、「レポート列」で指定した列またはパラメータに対応する、Graphics Builderの図表またはチャート内で使用されるパラメータを示します。

注意:  1つのレポート列またはパラメータは、複数のチャート・パラメータに対応させることができますが、各チャート・パラメータは、1つのレポート列またはパラメータのみに対応します。

値  Graphics Builderの図表またはチャート内の有効なパラメータの名前。名前の長さは、1Kバイト以下にしてください。Graphics Builderの図表またはチャート内の有効なパラメータ名のリストを入力することもできます。カンマ（,）を入力して、パラメータ名を区切ってください（たとえば、parm1,parm2,parm3）。

適用対象  チャート･オブジェクト

必須/オプション  オプション

デフォルト  Report Builderのパラメータ名


レポート列（チャート・パラメータ対応）

  制限	  関連項目

説明  「レポート列（チャート・パラメータ対応）」プロパティは、Graphics Builderの図表またはチャートのパラメータに値を指定するために使用される、レポート内の列とパラメータのリストを示します。列またはパラメータを選択するということは、図表またはチャート内に対応するパラメータがあるということであり、図表またはチャート・パラメータは選択済みレポート列またはパラメータから値を取得するということです。図表またはチャートのパラメータ名がレポート内の列またはパラメータと異なる場合、対応する「チャート・パラメータ」フィールドにその名前を指定してください。

値   レポートの中から1つ以上の有効な列またはパラメータを選択します。

適用対象  チャート･オブジェクト

必須/オプション  オプション

デフォルト  選択されていません。


「レポート列（チャート・パラメータ対応）」の制限

•	ページレベルのサマリー列（つまり、「リセット位置」または「計算位置」が「Page」に設定されている場合のサマリー）は、 Graphics Builderの図表またはチャートに渡すことはできません。同様に、ページレベルのサマリーに依存するサマリー列または式列も、図表またはチャートに渡すことはできません。


チャート問合せ

  関連項目

説明  「チャート問合せ」プロパティは、Report Builderからデータを取得するGraphicBuilderの図表またはチャートの問合せの名前です。問合せ名を指定すると、その問合せはデータベースからではなくReport Builderからデータを取り出します。これにより、レポートでデータに対して行ったすべてのフィルタあるいは集計を図表またはチャートに反映させることができます。「チャート問合わせ」は、図表またはチャートで使用されたデータがレポートで使用されたデータと同じであることを確認します。

注意:  ここで問合せ名を指定する場合は、どのレポート列あるいはパラメータが図表またはチャートの問合せに使用される値を持つかも指定してください。

値  チャート・ファイル名で指定された、Graphics Builderの図表またはチャートの有効な問合せ名を入力します。問合せ名の長さは、512バイト以下にしてください。

適用対象  チャート･オブジェクト

必須/オプション  オプション


レポート・グループ

  制限	  関連項目

説明  「レポート・グループ」プロパティは、Graphics Builderの図表またはチャートによってサマリー関数値を計算した、レポート内のグループを示します。

値  値リストからグループ名を選択します。

適用対象  チャート･オブジェクト

必須/オプション  「チャート問合せ」に値が入力されている場合、必須。


「レポート・グループ」の制限

•	「レポート・グループ」には、クロス積グループを指定することはできません。

•	「レポート列（チャート列対応）」を介してGraphics Builderの図表またはチャートに渡す列はいずれも、レポート・グループ内に存在するか、その上位項目にしてください。

•	「チャート問合せ」を選択せず「レポート・グループ」を選択した場合、プロパティ・シートを確定したときに「レポート・グループ」は選択解除されます。


チャート列

  関連項目

説明  「チャート列」プロパティは、「レポート列」で指定した列またはパラメータに対応する、Graphics Builderの図表またはチャート内で使用される列または列のリストを示します。

注意:  1つのレポート列またはパラメータは、複数のチャート・パラメータに対応させることができますが、各チャート列は、1つのレポート列またはパラメータのみに対応します。

値  Graphics Builderの図表またはチャート内の有効な列の名前。名前の長さは、1K以下にしてください。Graphics Builderの図表またはチャート内の有効な列名のリストを入力することもできます。カンマ（,）を入力して、列名を区切ってください（たとえば、col1,col2,col3）。

適用対象  チャート･オブジェクト

必須/オプション  オプション

デフォルト  Report Builderの列名


レポート列（チャート列対応）

  制限	  関連項目

説明  「レポート列（チャート列対応）」プロパティは、Graphics Builderの図表またはチャートのパラメータに値を指定するために使用される、レポート内の列とパラメータのリストを示します。列またはパラメータを選択するということは、Graphics Builderの図表またはチャート内に対応するパラメータがあるということであり、図表またはチャート列は選択済みレポート列またはパラメータから値を取得するということです。図表またはチャートの列名がレポート内の列またはパラメータと異なる場合、対応する「チャート列」フィールドにその名前を指定してください。

値   レポートの中から1つ以上の有効な列またはパラメータを選択します。

適用対象  チャート･オブジェクト

必須/オプション  「チャート問合わせ」に値が入力されている場合は必須


「レポート列（チャート列対応）」の制限

•	「レポート列（チャート列対応）」を介してGraphics Builderの図表またはチャートに渡す列はいずれも、「レポート・グループ」内に存在するか、その上位項目にしてください。

•	ページレベルのサマリー列（つまり、「リセット位置」または「計算位置」が「Page」に設定されている場合のサマリー）は、 Graphics Builderの図表またはチャートに渡すことはできません。同様に、ページレベルのサマリーに依存するサマリー列または式列も、Graphics Builderの図表またはチャートに渡すことはできません。


共通の列プロパティ

ブレーク順序

コメント

列のデータ型

データ型

ファイル形式

名前

ファイルからの読込み

ブレーク順序の設定

NULL時の値

幅


ブレーク順序

  制限 	  例

説明  「ブレーク順序」プロパティは、列値の表示順序を示します。このプロパティは、ユーザーが作成したグループ（つまり、ブレーク・グループ）の固有の値を識別する列にのみ適用されます。デフォルトのグループ内の列値の順序は、SQL問合せのORDER BY句およびExpressへの問合せのソート列によって決まります。しかし、ユーザーが作成したグループ内の列値の場合、ブレーク列の値の順序を指定するため、「ブレーク順序」を使用してください。

値

なし

昇順

降順

適用対象  列

必須/オプション  「ブレーク順序の設定」が「はい」の場合、必須。

デフォルト  データベースおよびソート列は「昇順」。ブレーク・グループを使用してOracle Express問合せ内のディメンションを表示するデータベース列は「なし」。


ブレーク順序の例（降順）

  関連項目 	  すべての例

次の問合せによってレポートを作成するとします。

SELECT DEPTNO, JOB, ENAME, SAL FROM EMP
ORDER BY SAL

その後、2つのグループG_DEPTおよびG_JOBを作成します。G_DEPTにはDEPTNO列が含まれ、G_JOBにはJOB列が含まれます。DEPTNO列の「ブレーク順序」に「降順」を指定し、JOB列には「昇順」 を指定した場合、出力は次のようになります（表スタイルを使用することを想定）。

Deptno	Job	Ename	Sal

------     ----------      ----------   ---------

     30	CLERK	JAMES	950.00

MANAGER	BLAKE	2850.00

SALESMAN	WARD	1250.00

MARTIN	1250.00

TURNER	1500.00

ALLEN	1600.00

     20	ANALYST	SCOTT	3000.00

FORD	3000.00

CLERK	SMITH	800.00

ADAMS	1100.00

MANAGER	JONES	2975.00

     10	CLERK	MILLER	1300.00

MANAGER	CLARK	2450.00

PRESIDENT	KING	5000.00


ブレーク順序の例 (ORDER BY)

  関連項目 	  すべての例

DEPTNOおよびENAMEのあるグループ左レポートを作成するとします。問合せでは、ORDER BY DEPTNOを使用します。また、DEPTNO列の「ブレーク順序」には「降順」を指定してあります。この場合、出力は次のようになります。

Deptno	Ename

------   ----------

    30	JAMES

WARD

MARTIN

TURNER

ALLEN

BLAKE

    20	SMITH

ADAMS

JONES

SCOTT

FORD

    10	MILLER

CLARK

KING

「ブレーク順序」プロパティがORDER BY句より優先することに注意してください（つまり、部門番号が降順になっています）。


「ブレーク順序」の制限

•	「ブレーク順序」は、特定の問合せの最下位のグループに属する列には影響を与えません。「ブレーク順序」は、問合せの最下位の子グループより上のグループの列のみに影響を与えます。

•	問合せの最下位の子グループより上のグループは、「ブレーク順序」が設定された列を少なくとも1つ持っている必要があります。

•	「ブレーク順序」は、「データ型」が「LONG」 または「LONG RAW」 の列には指定できません。

•	「ブレーク順序」はブレーク対象の列の順序にのみ影響を与えます。ブレーク・グループの内部の列の順序には影響を与えません。たとえば、DEPTNOでブレークし、各部門についてENAMEをリストするとします。「ブレーク順序」が「昇順」の場合、部門番号は昇順で印刷されますが、各部門の従業員の名前は問合せによって指定されている順序で印刷されます。(SQL問合せでその順序を変更するには、SELECT文でORDER BY句を使用する必要があります。また、Expressへの問合せでその順序を変更するには、SelectorのSortツールを使用する必要があります。）

•	サマリー列は、ブレーク列にすることはできません。また、「ブレーク順序」を設定することはできません。

•	サマリー列に依存する式列は、ブレーク列にすることはできません。また、「ブレーク順序」を設定することはできません。


列タイプ

説明  「列タイプ」プロパティは、列が属するカテゴリです。

値

データベース - オブジェクト

データベース - 参照

データベース - スカラー

データベース - 不明（列がサポートされていないタイプであることを示す）

式

プレースホルダ

ソート(Oracle Express対応のみ)

サマリー


コメント

説明  「コメント」プロパティは、列についてのコメントを書き込むテキスト・フィールドです。

値  64K以下のテキストを入力します。

適用対象  列

必須/オプション  オプション

デフォルト  ブランク


データベース列名

説明  「データベース列名」プロパティは、列を識別するために使用される列の正式名称です。たとえば、CITYという名前の列を含むCOUNTRYという名前の列オブジェクトが含まれるADDRESSという名前の列オブジェクトがあると想定します。この場合、CITYのデータベース列名は、ADDRESS.COUNTRY.CITYとなります。

適用対象  列

必須/オプション  必須


データ型

  制限

説明  「データ型」プロパティは、列の内容の型を示します。

値

Character

Date

LONG

LONG RAW

Nested Table of <データ型>

Number

RAW

Ref of <データ型>

Rowid

VARCHAR

VARCHAR2

Trusted Oracleのデータ型（MLSLABELとROWLABEL）はReport Builderでサポートしています。Trusted Oracleのインストールされているオペレーティング・システム上でReport Builderを実行すると、これらの列はTrusted Oracleのデータ型として扱われます。つまり、これらの列は適切にソートされることを意味しています。Trusted Oracleのインストールされていない（たとえば、Windows95/NTなどがインストールされている）オペレーティング・システム上でReport Builderを実行すると、これらの列は文字データ型として扱われます。

適用対象  列

必須/オプション  必須

デフォルト  データベースの列の場合、デフォルトの「データ型」はデータベースから導出されます。「ファンクション」が「カウント」に設定されたサマリー列の場合、デフォルトの「データ型」は、「NUMBER」です。その他のサマリー列の場合、デフォルトは「ソース」から導出されます。式列、プレースホルダ列およびソート列の場合、デフォルトの「データ型」は、「NUMBER」です。


データ型の制限

•	式列またはプレースホルダ列の「データ型」のみは編集できます。式列およびプレースホルダ列の場合は、「データ型」を 「CHARACTER」および「DATE」、「NUMBER」に設定できます。

•	「データ型」が「LONG」または「LONG RAW」、「RAW」の場合、「ファイル形式」フィールドでその他の値を指定しなければ、列はテキストとして処理されます。

•	列に別名があり、問合せを変更すると列のデータ型が変更される場合、このデータ型の変更は、問合せを確定したときに自動的に反映されます。


ファイル形式

  制限

説明  「ファイル形式」プロパティは、データベースから取り出されたか、列に保存されたファイル名で識別されるオブジェクトの形式です。

値

テキスト	ASCII形式のテキストです。
イメージ	ビットマップ・イメージです。
CGM	CGM形式での線の描画です。
Oracle Drawing Format	Oracle形式での線の描画です。
サウンド	longraw形式のサウンド・オブジェクトです。
ビデオ	longraw形式のビデオ・オブジェクトです。
OLE2	レポートに埋め込まれるリンク・オブジェクトです。
イメージURL	イメージへのURLリンクです。
適用対象  列


「ファイル形式」の制限

•	「サウンド」および「ビデオ」のソースにアクセスできるのは、ユーザーが作成したボタンからのみです。


ファイルからの読込み

  制限 	  例	  関連項目

説明  「ファイルからの読込み」プロパティは、列にファイル名またはイメージのURLが含まれていることを示します。「ファイルからの読込み」を「はい」に設定する場合は、「ファイル形式」プロパティにファイル名を指定してください。

「ファイルからの読込み」は、列によって指し示されるイメージまたは図形、テキスト・ファイルがある場合に役立ちます。「ファイルからの読込み」を「はい」に設定した場合、ファイルの内容がインポートされ、列の値として使用されます。「ファイルからの読込み」を「いいえ」に設定した場合は、データベースから値を取得します。その結果、列にファイル名が含まれ、「ファイルからの読込み」が「いいえ」に設定されている場合、ファイルの内容ではなく、ファイル名が印刷されます。

「ファイルからの読込み」は、データベース列またはサマリー列、式列、プレースホルダ列に対して使用することができます（列値がファイル名の場合）。ファイルを、ボイラープレートとしてレポートに組み込むこともできます。

適用対象  列

必須/オプション  オプション

使用上の注意

•	列内のファイル名の前にパスを付けることができます。ファイル名の前にパスが指定されていない場合は、Report Builderのファイル・パス検索順序によって、ファイルが検索されます。

•	レポートの移植を確保するには、REPORTS30_PATHというReport Builder固有の環境変数を使用します。この変数を使用して、レポート内で使用される外部ファイル（外部問合せ、ボイラープレート、PL/SQLなど）をReport Builderに検索させるためのデフォルト・ディレクトリを指定できます。これによって、レポートにディレクトリ・パスをハードコードする必要がなくなります。


ファイルからの読込み例（イメージ）

  関連項目 	  すべての例

各従業員用に、従業員の写真が含まれる.bmpファイルがあるとします。従業員表には、その.bmpファイルの名前と従業員の写真を含むPICTURE列があります。

従業員の写真を表示するレポートを生成するには、問合せでPICTURE列を選択します。PICTURE列の「列」プロパティ・シートでは、「ファイルからの読込み」を「はい」に設定し、「ファイル形式」を「イメージ」に設定します。すると、Report Builderによって、PICTURE列によって指し示されたファイルは、レイアウト内のPICTURE列を参照した場所に表示されます。

注意:「ファイルからの読込み」を「いいえ」に設定した場合は、写真ではなく、ファイル名が印刷されます。


ファイルからの読込み例（式列）

  関連項目 	  すべての例

ファイルからテキストを各従業員の情報の横に取り込んだ従業員リストを作成するとします。従業員の給与が2000ドルを超える場合、その従業員の横には、salary1.txtというファイルからテキストを表示するとします。従業員の給与が2000ドル未満の場合、salary2.txtというファイルからその従業員の横にテキストを表示するとします。

「データ型」を「CHARACTER」に、「ファイルからの読込み」を「はい」（「ファイル形式」が「テキスト」の場合）に設定した式列を作成します。式列で、次のPL/SQLを入力します。

if :sal > 2000 then
  return('/home/jsmith/txt/salary1.txt');
else
  return('/home/jsmith/txt/salary2.txt');
end if;


「ファイルからの読込み」の制限

•	各ファイルの最大サイズは、4GBです。（一部のオペレーティング・システムでは、最大64Kです。)

•	列の「データ型」が文字互換型（つまり、CHARACTERまたはVARCHAR、VARCHAR2）の場合のみ、「ファイルからの読込み」を「はい」に設定できます。

•	サマリー列または式列について「ファイルからの読込み」を「はい」に設定した場合、サマリーまたは式は、ファイルが読み込まれる前に計算されます。同様に、プレースホルダ列について「ファイルからの読込み」が「はい」に設定されている場合も、列値は最初に計算されます。


NULL時の値

  制限

説明  「NULL時の値」プロパティは、列のNULL値に代入される値です。たとえば、このフィールドにキャラクタ・タイプの列としてXを入力した場合、列にフェッチされたNULL値には、Xが表示されます。ブランクのままにした場合、NULL値には何も代入されません。

値  列のデータ型に合う有効な値を入力します。「NULL時の値」の最大長は1Kです。

適用対象  列

必須/オプション  オプション

デフォルト  ブランク

使用上の注意

•	ブレーク列について「NULL時の値」に文字列を入力すると、Report Builderによって、ブレーク列のグループ内のすべての行が事前フェッチされます。これによって、レポート実行時の性能が落ちることがあります。事前フェッチを避けるには、「NULL時の値」に文字列を入力しないで、問合せでNVLファンクションを使用します。


「NULL時の値」の制限

•	文字データ型（たとえば、VARCHAR）を持つ列の場合、「NULL時の値」に入力した文字列の幅が列の幅を超えると、文字列の一部は切り捨てられます。

•	問合せの中の字句参照を介して列が参照されている場合は、問合せの妥当性検査のためにその列の「NULL時の値」の値が使用されます。

•	「NULL時の値」に入力する値のデータ型は、列のデータ型と同じにしてください。たとえば、列の「データ型」が「NUMBER」の場合、「NULL時の値」に「XX」を指定することはできません。この場合は、数値を指定してください。

•	「NULL時の値」に日付値を入力する場合、Report Builderの日付用の内部マスク（ YY-MM-DD）に対して妥当性検査が行われます。（数字や文字の値については、妥当性検査は行われません。)


幅

  関連項目

説明  「幅」プロパティは、列値の最大文字数です。この「幅」とは、Report Builderによってその列に対して内部的に使用される幅のことです。サマリーおよび式の計算などに影響があります。しかし、列のデータ表示に使用されるサイズは、「レイアウト・モデル」内の関係付けられたフィールドのサイズおよび「垂直拡張度」プロパティ、「水平拡張度」プロパティによって決まります。

値

1～64Kの数を入力します。

2つの数字は「a,b」という形式で入力します。「a」は全体の桁数を示し、「b」は小数点以下の桁数を示しています。（この形式は、数字の桁数を決めるためのみに使用されます。)

適用対象  列

必須/オプション  必須

デフォルト  データベースの列の場合、デフォルトの「幅」はデータベースから導出されます。ソート列の場合、デフォルトの「幅」は、「38」です。サマリー列および式列の場合は、デフォルトの「幅」は、「10.0」です。サマリー列の場合は、Report Builderでは列の「ソース」および「ファンクション」として入力した値に基づいて「幅」を更新します。

使用上の注意

•	「列タイプ」が「データベース - スカラー」で、「データ型」が「CHARACTER」または「DATE」、「NUMBER」、「RAW」の場合、「幅」を編集することはできません。しかし、レポート出力の列値の幅を制御できないということではありません。「デフォルト・レイアウト」ダイアログ・ボックスまたは「フィールド」プロパティ・シートでフィールド幅を変更することによって、出力値の幅を変更できます。

•	「列タイプ」が「データベース - スカラー」または「データベース - プレースホルダ」で、「データ型」が「LONG」または「LONG RAW」の場合、「幅」に値を入力できます。「LONG」または「LONG RAW」の列に値を指定しない場合、Report Builderによって列の最大幅が割り当てられます。式列の場合も「幅」を入力できます。

•	「列タイプ」が「データベース - 参照」の場合、「幅」を編集することはできません。

•	「列タイプ」が「ソート」の場合は、「幅」を編集できます。


幅の制限

注意:	データベース列で「データ型」が 「LONG」または「LONG RAW」の列の値が、列に指定された「幅」より大きい場合、値は切り捨てられます。

•	プレースホルダ列または式列の値が、列に指定された「幅」より大きい場合、例外状況が発生します。

•	列に別名があり、問合せを変更すると列の幅が変更される場合、この幅の変更は、問合せを確定したときに自動的に反映されます。


ブレーク順序の設定

説明  「ブレーク順序の設定」プロパティは、「ブレーク順序」プロパティを使用して、列値の表示順序を設定するかどうかを示します。

適用対象  列

必須/オプション  オプション

デフォルト   はい


共通のレイアウト・オブジェクト・プロパティ

  制限

追加のハイパーリンク属性

アプリケーション・コマンド・ライン（PDF）

基本印刷オン

ブックマーク

コメント

条件付き書式

表示名

フォーマット・トリガー

水平拡張度

ハイパーリンク（HTML/PDF）

ハイパーリンクの宛先

アンカー・オブジェクトと連動

名前

後で改ページ

前で改ページ

ページ保護

印刷オブジェクト・オン

前のプリンタ・コード

後のプリンタ・コード

垂直拡張度


共通のレイアウト・オブジェクトの制限

•	同じオブジェクトでも、異なるオブジェクトでも、プロパティが相互に矛盾しないように設定してください。レイアウト・プロパティの機能上、別のプロパティと矛盾するプロパティの指定は可能です。同一のオブジェクトについて、次のようにレイアウト・プロパティを組み合せるのは避けてください。同一のオブジェクトに次の組合せを指定しようとすると、エラーになります。

•	「基本印刷オン」を「インクローズ・オブジェクト」に、「印刷オブジェクト・オン」を「最終ページ」に設定

•	「基本印刷オン」を「インクローズ・オブジェクト」に、「印刷オブジェクト・オン」を「最後のページ以外の全ページ」に設定

•	「印刷オブジェクト・オン」を「全ページ」に、「前で改ページ」を「はい」に設定

•	「印刷オブジェクト・オン」を「最初のページ以外の全ページ」に、「前で改ページ」を「はい」に設定

•	「印刷オブジェクト・オン」を「最後のページ以外の全ページ」に、「前で改ページ」を「はい」に設定

•	「アンカー・オブジェクトと連動」および「前で改ページ」を「はい」に設定（アンカー・オブジェクトの後に配置されるオブジェクトの場合）。 または、「アンカー・オブジェクトと連動」および「後で改ページ」を「はい」に設定（アンカー・オブジェクトの前に位置するオブジェクトの場合）。

•	同様に、異なるオブジェクト間でプロパティの組合せが矛盾していると、予期しない結果が発生したり、レポ-トが無限に出力されることがあります。たとえば、枠の中で互いにアンカーされた2つのボイラープレート・オブジェクトがあるとします。親オブジェクトの「印刷オブジェクト・オン」が「全ページ」に、「基本印刷オン」が「インクローズ・オブジェクト」に設定されています。子オブジェクトの「印刷オブジェクト・オン」が「第1ページ」に、「基本印刷オン」が「アンカー・オブジェクト」に、「前で改ページ」が「はい」に設定されています。下の図は、このレイアウトを示しています。レポートを実行しても、子オブジェクトは出力されません。「前で改ページ」が「はい」に設定されているので、子オブジェクトの「印刷オブジェクト・オン」（「第1ページ」）および「基本印刷オン」（「アンカー・オブジェクト」）が満たされることはありません。しかし、子オブジェクトの下にあるオブジェクト（B_Plate3）は出力されることに注意してください。

  ここをクリックしてください。


コメント

説明  「コメント」プロパティには、オブジェクトを説明するテキスト・フィールドが含まれています。64KB以下のテキストを入力します。

適用対象  オブジェクト

必須/オプション  オプション

デフォルト  ブランク


水平拡張度

  例

説明  「水平拡張度」プロパティは、実行時にオブジェクトまたはデータをその中に収めるためにオブジェクトの水平サイズを変更する方法を示します。

•	枠および繰返し枠の場合、このプロパティは、枠または繰返し枠のサイズをその中のオブジェクトに合せて変更する必要があるかどうかを定義します。

•	テキストが含まれるオブジェクトの場合、このプロパティは、フィールドまたはボイラープレートがテキストのサイズに合せて変更される必要があるかどうかを定義します。サイズ固定のテキストは、定義されたオブジェクト・サイズの範囲内でラップされますが、十分な空間がなければ切り捨てられる場合があります。数値データまたは日付データを定義されたサイズ内に収められない場合、アスタリスク（*）が表示されます。

•	イメージおよび描画、チャート・オブジェクトの場合、Report Builderによって、比例したスケール変更が行われます。イメージおよび描画、チャート・オブジェクトの拡張度オプションによって、スケールが決まります。

  ここをクリックしてください。

値

縮小	その中のフォーマットされたオブジェクトまたはデータの幅が狭い場合、オブジェクトの水平サイズは小さくなります。データの切捨てが行われる場合があります。 例を参照してください。（このオプションは、「縮小のみ行われ、拡張されない」ことを意味しています。)
Expand	フォーマットされたオブジェクトまたはデータの幅が広い場合、オブジェクトの水平サイズは大きくなります。（このオプションは、「拡張のみ行われ、縮小されない」ことを意味しています。）
固定	オブジェクトの幅は、その中のオブジェクトまたはデータのサイズに関係なく、各論理ページで同じです。データの切捨てが行われる場合があります。 例を参照してください。オブジェクトの幅は、レポート・エディタ内のオブジェクトの幅に定義されます。
可変	オブジェクトは水平方向に拡張または縮小され、その中のオブジェクトまたはデータは適切なサイズに調整されます。 つまり、実行時のオブジェクトの幅は、レポート・エディタ内に示される幅には影響されないということです。
適用対象  レイアウト・オブジェクト

必須/オプション  必須

デフォルト  オブジェクトにより異なる。

使用上の注意

•	「垂直拡張度」および「水平拡張度」を「固定」に設定して、レポート内にチャート・オブジェクトを作成した場合、Report Builderはオブジェクトに定義したサイズに合わせて図表をスケーリングします。


水平拡張度の例（フィールド）

  関連項目 	  すべての例

次の特性を持つフィールドがあるとします。

特性	値
幅	1インチ
水平拡張度	縮小
高さ	1インチ
垂直拡張度	固定
  ここをクリックしてください。

データ幅が1インチより短い場合は、フィールドのサイズはデータを収めるのに最低限必要なサイズに縮小されることに注意してください。また、データが1インチより長い場合、フィールドを垂直または水平方向に拡張できないため、データが切り捨てられることに注意してください。


水平拡張度の例（枠）

  関連項目 	  すべての例

次の特性を持つ、M_1という枠があるとします。

特性	値
水平拡張度	可変
高さ	7インチ
垂直拡張度	固定
また、レポートのプロパティ・シートで「幅」を8インチに定義したとします。M_1の中には、フィールドF_Enameを持つ繰返し枠があります。F_Enameの最初の値の幅が4インチ、次の値の幅は3インチ、その次の値の幅は4インチ、そして、最後の値の幅は4インチです。次の図は、枠がどのようにフォーマットされるかを示しています。

  ここをクリックしてください。

フィールドF_Enameのインスタンスのうち最初2つは論理ページの1ページ目に印刷されますが、1ページ目に十分な空間がないため、残りの2つのインスタンスは2ページ目に印刷されることに注意してください。また、「水平拡張度」が「可変」ではなく、「縮小」または「固定」に設定されている場合、枠は、1論理ページに完全に収まる場合のみ印刷されることに注意してください。


アンカー・オブジェクトと連動

  制限	  例

説明  「アンカー・オブジェクトと連動」プロパティは、1つのオブジェクトと、そのオブジェクトにアンカーされているオブジェクトを同じ論理ページに保持するかどうかを示します。「アンカー・オブジェクトと連動」を「はい」に設定すると、オブジェクトとアンカー・オブジェクトが同じ論理ページに収まらない場合、次のページに移動します。

繰返し枠の「アンカー・オブジェクトと連動」を「はい」に設定した場合、繰返し枠の最初のインスタンスは、アンカー・オブジェクトと同じページに収めてください。そうしておかないと、「アンカー・オブジェクトと連動」の条件は満たされないことになります。繰返し枠以外のレイアウト・オブジェクトの「アンカー・オブジェクトと連動」を「はい」に設定した場合、繰返し枠の最初のインスタンスは、アンカー・オブジェクトと同じページに収めてください。

2つのオブジェクト間のアンカーは、明示的でも暗黙的でもかまいません。そのため、「アンカー・オブジェクトと連動」は、2つのオブジェクト間に明示的にアンカーを作成しなくても有効になることがあります。

適用対象  レイアウト・オブジェクト

必須/オプション  オプション

デフォルト  いいえ


「アンカー・オブジェクトと連動」の例

  関連項目 	  すべての例

3つのボイラープレート・オブジェクトを作成したとします。

  ここをクリックしてください。

B_2およびB_3の「アンカー・オブジェクトと連動」は「はい」に設定されています。Report Builderが最初にこれらのオブジェクトを印刷しようとした論理ページには、B_1およびB_2を収めることはできますが、B_3を収めることはできません。 B_3の「アンカー・オブジェクトと連動」が「はい」に設定されていて、アンカー・オブジェクトがB_2なので、B_2およびB_3は次の論理ページに移動します。B_2の「アンカー・オブジェクトと連動」も「はい」に設定されており、アンカー・オブジェクトがB_1なので、B_1も次の論理ページに移動します。


「アンカー・オブジェクトと連動」の制限

•	「アンカー・オブジェクトと連動」は、オブジェクトがフォーマットされる最初の論理ページにのみ適用されます。「アンカー・オブジェクトと連動」は後続のページでは、無視されます。

•	オブジェクトとそのアンカー・オブジェクトを次の論理ページに移動すると、現行の論理ページがブランクになったり、繰返しオブジェクト（たとえば、ページ・ヘッダー）のみになる場合、「アンカー・オブジェクトと連動」は適用されません。これによって、レポートに不要なブランク・ページができなくなります。

•	アンカー・オブジェクトが繰返し枠であり、現行のオブジェクトがその繰返し枠の外側にある場合、アンカー・オブジェクトとは、繰返し枠全体（繰返し枠のすべてのインスタンス）になります。

•	2つのオブジェクトが、それらを囲む枠にアンカーされており、その枠の「垂直拡張度」または「水平拡張度」（またはその両方）が「縮小」または「可変」の場合、「アンカー・オブジェクトと連動」の条件を満たすには、これら3つのオブジェクトがすべて同じページでフォーマットできる必要があります。2つのオブジェクトが、枠ではなく、繰返し枠に囲まれている場合、このルールは、その繰返し枠の各インスタンスに適用されます。この図では、「アンカー・オブジェクトと連動」の条件を満たすには、B_1およびB_2、M_1が、すべて同じページ上でフォーマットできる必要があります。

  ここをクリックしてください。


名前

  制限

説明  「名前」プロパティは、Report Builderが現行のオブジェクトの識別に使用する名前です。30バイト以内の有効な名前を入力します。名前についての詳細を以下に示します。

適用対象  オブジェクト

必須/オプション  必須

デフォルト

ボイラープレート	B_n。 このnは、レポートのボイラープレート・オブジェクト名の中で一意の数値です。
ボタン・オブジェクト	U_n。 このnは、レポートのフィールド名の中で一意の数値です。
チャート・ オブジェクト	D_n。 このnは、レポートのチャート・オブジェクト名の中で一意の数値です。
データベースの列	SQL問合せ（表示のみ）のSELECT文で参照される列名。
フィールド	F_n。 このnは、レポートのフィールド名の中で一意の数値です。
式列	CF_n。 このnは、レポートの式名の中で一意の数値です。
枠	M_n。 このnは、レポートの枠名の中で一意の数値です。
問合せ	Q_n。 このnは、レポートの問合せ名の中で一意の数値です。
グループ	G_queryname。 このquerynameは、問合せの名前で、グループの中で一意の数値です。問合せがデフォルト名（たとえば、Q_1）の場合、デフォルト・グループ名は、G_nです。このnは、レポートのグループ名の中で一意の数値です。グループが問合せに関係付けられていない（つまり、クロス積グループ）場合のデフォルト・グループ名も、G_nです。
マトリックス・ オブジェクト	X_n。 このnは、レポートのマトリックス名の中で一意の数値です。
OLE2オブジェクト	B_n。 このnは、レポートのOLE2オブジェクト名の中で一意の数値です。
パラメータ	P_n。 このnは、レポートの列名の中で一意の数値です。問合せでバインド参照を作成することによってパラメータを作成する場合、問合せで使用される名前はデフォルトになります。
プレースホルダ列	CP_n。 このnは、レポートのプレースホルダ名の中で一意の数値です。
繰返し枠	R_n。 このnは、レポートの繰返し枠名の中で一意の数値です。
ソート列	(Oracle Expressのみ) S_dimension。 このdimensionはソート列が参照するデータベース列の名前です。
サマリー列	CS_n。 このnは、レポートのサマリー名の中で一意の数値です。


名前の制限

•	データベース列の場合、名前は編集できません。

•	Report Builderでは、データベースの列のデフォルト名として、問合せから列名および別名、式のテキストを使用します。

•	システム・パラメータの名前は、変更できません。


後で改ページ

  制限 	  例

説明  「後で改ページ」プロパティは、オブジェクトのすべての子オブジェクトを次のページに移動する場合に指定します。つまり、このオブジェクトに対するアンカー（暗黙的または明示的）の子オブジェクトである、すべてのオブジェクトは、「前で改ページ」が「はい」に設定されているかのように処理されます。「後で改ページ」が設定されたオブジェクトの下にあるすべてのオブジェクトが、次のページに移動するわけではないことに注意してください。

適用対象  レイアウト・オブジェクト

必須/オプション  オプション

デフォルト  いいえ


「後で改ページ」の制限

•	「後で改ページ」は、オブジェクトの子オブジェクトのフォーマットを遅らせます。同位オブジェクトの場合Report Builderがフォーマット順序の判別に使用できる階層（つまり、親子の関係）がないので、同位オブジェクトのフォーマットは遅れません。したがって、「後で改ページ」が有効になるように、オブジェクトは親として他のオブジェクトに（暗黙的または明示的に）アンカーされている必要があります。

  ここをクリックしてください。

  ここをクリックしてください。

•	繰返し枠の場合、「後で改ページ」によって、論理ページの改ページは、繰返し枠全体を印刷した後で行われます。繰返し枠の各インスタンスの後で改ページするには、繰返し枠のプロパティ・シートで「ページ当りの最大レコード数」を1に設定することも必要です。

•	「後で改ページ」が「はい」に設定されているオブジェクトの下にあるオブジェクトは、次のページに移動しないことがあります。オブジェクトが、「後で改ページ」が「はい」に設定されているオブジェクトの子オブジェクトではない場合、そのページに収まれば、「後で改ページ」が「はい」に設定されているオブジェクトと同じページに印刷されることがあります。

  ここをクリックしてください。

•	オブジェクトが、外部オブジェクトから（明示的または暗黙的に）アンカーされていない場合、「後で改ページ」は効果がありません。


前で改ページ

  制限 	  例

説明  「前で改ページ」プロパティは、初めに印刷しようとするページの次のページで、オブジェクトをフォーマットする場合に設定します。「前で改ページ」が設定されたオブジェクトの下にあるすべてのオブジェクトが、次のページに移動するわけではないことに注意してください。

適用対象  レイアウト・オブジェクト

必須/オプション  オプション

デフォルト  いいえ


「前で改ページ」の制限

•	繰返し枠の場合、「前で改ページ」によって、論理ページの改ページは、繰返し枠を印刷する前に行われます。繰返し枠の各インスタンスの前で改ページするには、繰返し枠のプロパティ・シートで「ページ当りの最大レコード数」を1に設定することも必要です。

•	「前で改ページ」が「はい」に設定されているオブジェクトの下にあるオブジェクトは、次のページに移動しないことがあります。オブジェクトがあるページに印刷されるよう設定されており、「前で改ページ」によって次のページに移動する場合、十分な空白があれば、そのオブジェクトが印刷されるはずであった位置に、その他のオブジェクトが印刷されることがあります。

  ここをクリックしてください。


ページ保護

  制限 	  例

説明  「ページ保護」プロパティは、同じ論理ページにオブジェクト全体とその内容を保持するかどうかを示します。「ページ保護」を「はい」に設定すると、オブジェクトの内容が現行の論理ページに収まらない場合は、オブジェクトおよびその内容のすべては次の論理ページに移動します。

注意: 「ページ保護」を使用すると、ページ保護されたオブジェクトの下にあるオブジェクトは、ページ保護されたオブジェクトの上に出力されます。

適用対象  レイアウト・オブジェクト

必須/オプション  オプション

デフォルト  いいえ


ページ保護の例（小さなオブジェクト）

  関連項目 	 すべての例

さまざまな列や集計を表示するフィールドを数多く持つ枠M_1を作成したとします。読みやすくするために、M_1内のすべてのフィールドを同じ論理ページに印刷し、列および集計結果を一緒に参照できるようにします。

M_1に「ページ保護」を指定します。 Report Builderが印刷しようとする最初の論理ページに、M_1およびすべてのフィールドが収まらない場合、Report Builderは、次の論理ページに印刷しようとします。

  ここをクリックしてください。

  ここをクリックしてください。


ページ保護の例（大きなオブジェクト）

  関連項目 	 すべての例

さまざまな列や集計を表示するフィールドを数多く持つ枠M_1を作成したとします。読みやすくするために、M_1内のすべてのフィールドを同じ論理ページに印刷し、列および集計結果を一緒に参照できるようにします。

M_1に「ページ保護」を指定します。 Report Builderが印刷しようとする最初の論理ページに、M_1およびすべてのフィールドが収まらない場合、Report Builderは、次の論理ページに印刷しようとします。

しかし、Report Builderが印刷しようとする論理ページの2ページ目にM_1およびすべてのフィールドが収まらないとします。Report Builderは、論理ページに収まるのみM_1を印刷し、残りは次の論理ページに印刷します。


ページ保護の例（グループ・レポート）

  関連項目 	 すべての例

グループ・レポートがあるとします。できる限り同じページにすべてのマスターおよびディテールを表示するとします。その場合は、マスター繰返し枠（最も外側の繰返し枠）の「ページ保護」を指定します。印刷しようとする最初のページに、ディテールおよびマスターが収まらない場合、次のページに印刷するように設定されます。


「ページ保護」の制限

•	「ページ保護」は、オブジェクトがフォーマットされる最初の論理ページのみに適用されます。「ページ保護」は後続のページでは、無視されます。

•	繰返し枠の場合、「ページ保護」は、繰返し枠の各インスタンスに適用されます。繰返し枠の各インスタンスおよび囲まれたオブジェクトは、「ページ保護」によってともに保持されます。ただし、繰返し枠の最初のページを除くページに表示される最初のインスタンスには、ページ保護は適用されません。たとえば、下の図では、ページ保護は、インスタンス1および2、4には適用されますが、インスタンス3には適用されません。 インスタンス3は、繰返し枠の2ページ目でフォーマットされる最初のインスタンスです。この場合、ページ保護がインスタンス3に適用されていれば、2ページ目ではなく3ページ目から開始します。 2ページ目にはほとんど何も印刷されません。

  ここをクリックしてください。

•	「ページ保護」は、マトリックスの一部である繰返し枠には対応していません。マトリックス・オブジェクトによって繰返し枠が関係付けられている場合、「ページ保護」を設定しても効果がありません。

•	オブジェクトとその内容を次の論理ページに移動すると、現行の論理ページがブランクになったり、繰返しオブジェクト（たとえば、ページ・ヘッダー）のみになる場合、「ページ保護」は適用されません。これによって、レポートに不要なブランク・ページができなくなります。

•	フォーマット時に「ページ保護」によって、オブジェクトが次の論理ページに移動する場合、ページ保護されたオブジェクトの横にあるオブジェクトは、一緒に移動することもあれば、移動しないこともあります。ページ保護されたオブジェクトの横にあるオブジェクトが、ページ保護されたオブジェクトに（明示的または暗黙的に）アンカーされていない場合、そのオブジェクトが、ページ保護されたオブジェクトが収まりきらない領域に収まれば、その論理ページに印刷されます。それ以外の場合は、そのオブジェクトはページ保護されたオブジェクトとともに次の論理ページに移動します。


基本印刷オン

 関連項目

説明  「基本印刷オン」プロパティは、現行のオブジェクトの「印刷オブジェクト・オン」プロパティに基づいたオブジェクトです。たとえば、「印刷オブジェクト・オン」を 「全ページ」に、「基本印刷オン」を「アンカー・オブジェクト」に設定した場合、現行のオブジェクトは、アンカー・オブジェクト（親オブジェクト）が表示される論理ページごとに印刷されるようにトリガーされます。

値

アンカー・オブジェクト	現行のオブジェクトが明示的または暗黙的にアンカーされる親オブジェクトです。

インクローズ・オブジェクト	現行のオブジェクトを囲むオブジェクトです。

適用対象  レイアウト・オブジェクト

必須/オプション  必須

デフォルト  アンカー・オブジェクト


印刷オブジェクト・オン

  制限	  例	  関連項目

説明  「印刷オブジェクト・オン」プロパティは、オブジェクトがレポートに出力される頻度です。「印刷オブジェクト・オン」オプションは、オブジェクトが「基本印刷オン」のオブジェクトについて印刷される論理ページを示しています。

注意: オブジェクトが論理ページに印刷されるように設定されていても、その論理ページに印刷されるとは限りません。別の設定（たとえば、「前で改ページ」）またはそのページで使用できる空白の量によって、Report Builderは、最初のトリガー時には印刷されないはずであったページにオブジェクトを印刷することがあります。

これらのオプションを適用する場合、Report Builderは、オブジェクトの1ページ目を、オブジェクトの一部が印刷される最初の論理ページと見なします。同様に、最後のページを、オブジェクトの一部が印刷される最後の論理ページと見なします。たとえば、「印刷オブジェクト・オン」を「第1ページ」に、「基本印刷オン」を「インクローズ・オブジェクト」に設定した場合、オブジェクトは、インクローズ・オブジェクトが表示される最初の論理ページに印刷するようにトリガーされます。

値

全ページ	オブジェクトおよびその内容のすべては「基本印刷オン」のオブジェクトのすべての論理ページに印刷されます。オブジェクトは、「基本印刷オン」のオブジェクトのすべてのオーバーフロー・ページ上で繰り返され、必要があれば論理ページの境界線で切り捨てられます。
最初のページ以外の全ページ	オブジェクトおよびその内容のすべては、「基本印刷オン」のオブジェクトの最初の論理ページを除くすべての論理ページに印刷されます。オブジェクトは、「基本印刷オン」のオブジェクトのオーバーフロー・ページ上でフォーマットされ、必要があれば論理ページの境界線で切り捨てられます。
最後のページ以外の全ページ	オブジェクトおよびその内容のすべては、「基本印刷オン」のオブジェクトの最後の論理ページを除くすべての論理ページに印刷されます。オブジェクトは、「基本印刷オン」のオブジェクトの最後のページを除くすべてのオーバーフロー・ページ上に繰り返され、必要があれば論理ページの境界線で切り捨てられます。
*デフォルト	Report Builderでは、「印刷オブジェクト・オン」が*「第1ページ」または*「最終ページ」のいずれかに設定されるようにオブジェクトが配置されます。（アスタリスク（*）は、Report Builderによって設定された値であることを示します。
第1ページ	オブジェクトおよびその内容のすべては、「基本印刷オン」のオブジェクトの最初の論理ページのみに印刷されます。オブジェクトは、フォーマットされ、必要があれば後続のページにオーバーフローします。
最終ページ	オブジェクトおよびその内容のすべては、「基本印刷オン」のオブジェクトの最後の論理ページのみに印刷されます。オブジェクトは、「基本印刷オン」のオブジェクトの後にフォーマットされ、必要があれば後続のページにオーバーフローします。
適用対象  レイアウト・オブジェクト

必須/オプション  必須

デフォルト  オブジェクトにより異なる。


印刷オブジェクト・オンの例（すべて）

  関連項目 	  すべての例

グループGroup_1内の列の値を合計したサマリー列Col_Sumを作成したとします。 Col_Sumは、Group_1からの値を持つ繰返し枠（R_1）内で囲まれたフィールド（F_1）のソースです。 F_1の「基本印刷オン」を「全ページ」に、「基本印刷オン」を「インクローズ・オブジェクト」に指定した場合、各論理ページのR_1のあらゆるインスタンスの中に印刷されます。


印刷オブジェクト・オンの例（オーバーフロー）

  関連項目 	  すべての例

  ここをクリックしてください。

ボイラープレート・オブジェクトDが繰返し枠Cの外側にあるので、ボイラープレート・オブジェクトDの「基本印刷オン」の設定は、繰返し枠全体に適用されます。ボイラープレート・オブジェクトAおよびBの「基本印刷オン」の設定は、繰返し枠の中にあるので、繰返し枠Cの各インスタンスに適用されます。

オブジェクトDは、繰返し枠Cが出力されるすべての論理ページに出力されます。しかし、オブジェクトAは、繰返し枠Cのインスタンスがオーバーフローしたときにのみ印刷されます。この場合「印刷オブジェクト・オン」の「最初のページ以外の全ページ」を指定すると、オブジェクトは、インスタンスが印刷される最初のページを除いて、繰返し枠の各インスタンスの各論理ページに印刷されるように設定されます。

繰返し枠Cの中にあるのは、2つのオブジェクト（ボイラープレート・オブジェクトAおよびB）のみなので、ボイラープレート・オブジェクトBがオーバーフローした場合に2ページ目にオーバーフローするのみです。オブジェクトAおよびBの「印刷オブジェクト・オン」の設定（「最初のページ以外の全ページ」および「第1ページ」）を見ると、これらのオブジェクト2つは同じページに印刷されることはあり得ない、と思うかもしれません。しかし、この場合、この2つのオブジェクトは同じページにしか出力できません。


「印刷オブジェクト・オン」の制限

注意:	オブジェクトの内容が印刷を開始する論理ページ内に収まらない場合、「印刷オブジェクト・オン」を「全ページ」または「最初のページ以外の全ページ」、「最後のページ以外の全ページ」に設定したオブジェクトは、後続のページにはオーバーフローできません。この場合、オブジェクトの内容は切り捨てられ、オブジェクトの内容のうち最初の論理ページに収まった部分のみが、印刷するように設定されているすべての論理ページに印刷されます。

•	オブジェクトの内容が印刷を開始する論理ページ内に収まらない場合、「印刷オブジェクト・オン」を「第1ページ」または「最終ページ」に設定したオブジェクトは、後続のページにオーバーフローできます。その結果、最初または最後のページのみに印刷されるようにトリガーされていても、最初または最後のページの次のページにオーバーフローすることがあります。オーバーフローすると、「基本印刷オン」の「第1ページ」と「最初のページ以外の全ページ」は、必ずしも互いに排他であるとは限りません。たとえば、あるオブジェクトの「印刷オブジェクト・オン」が「第1ページ」であり、もう1つのオブジェクトは「最初のページ以外の全ページ」で、「基本印刷オン」の設定がどちらも同じ場合、2つのオブジェクトが同じページに表示されることはあり得ないと思うかもしれません。しかし、「第1ページ」に設定されたオブジェクトが2ページ目にオーバーフローした場合、この2つのオブジェクトは同じページに出力されることがあります。

•	囲み枠または繰返し枠に明示的または暗黙的にアンカーされたオブジェクトは、「印刷オブジェクト・オン」を「最終ページ」または「最後のページ以外の全ページ」に設定することはできません。囲み枠または繰返し枠内で別のオブジェクトに明示的または暗黙的にアンカーされたオブジェクトは、「基本印刷オン」を「インクローズ・オブジェクト」にして、「印刷オブジェクト・オン」を「最終ページ」または「最後のページ以外の全ページ」に設定することはできません。

  ここをクリックしてください。

•	「基本印刷オン」に設定されたオブジェクトがそのオブジェクトを囲む繰返し枠の場合、この設定はオブジェクトがアンカーされている繰返し枠の各インスタンスに適用されます。

•	「基本印刷オン」に設定されたオブジェクトが繰返し枠であり、そのオブジェクトが繰返し枠の外側にある場合、この設定は繰返し枠全体に適用されます。たとえば、「印刷オブジェクト・オン」の「第1ページ」は、繰返し枠が印刷されるようにトリガーされている最初の論理ページのことです。

•	「基本印刷オン」の設定の適用対象が繰返し枠全体であるかまたは繰返し枠のインスタンスであるかにかかわらず、「印刷オブジェクト・オン」の設定は、論理ページに必ず適用されます。たとえば、「基本印刷オン」のオブジェクトが繰返し枠であり、そのオブジェクトが繰返し枠の外側にあるとします。この場合、「基本印刷オン」は、繰返し枠のインスタンスに適用されます。しかし、「印刷オブジェクト・オン」の「第1ぺージ」は、繰返し枠の最初のインスタンスのことではありません。それは、繰返し枠が印刷されるように設定されている各インスタンスの最初の論理ページのことです。

•	マージン領域にあるオブジェクトは、各物理ページで再表示されます。その結果、一部の「印刷オブジェクト・オン」の設定は、マージン領域のオブジェクトには意味がありません。オブジェクトは、各ページで再表示されるので、常にオブジェクトの最初のページが出力されているような状態になります。「第1ページ」は、「全ページ」と同じです。「最終ページ」および「最後のページ以外の全ページ」は、「最後」になることがないため、無効です。「最初のページ以外の全ページ」の場合、オブジェクトは「最初」の次になることがないため、オブジェクトは出力されません。


前のプリンタ・コード

  制限 	  例

説明  「前のプリンタ・コード」および「後のプリンタ・コード」は、オブジェクトに対する特別な印刷指示（たとえば、特別なフォント・サイズまたは反転表示）を定義するプリンタ・エスケープ・シーケンスの参照元です。「前のプリンタ・コード」プロパティは、オブジェクトの各行の前に実行されるプリンタ・エスケープ・シーケンスを参照します。プリンタ・エスケープ・シーケンスは、オブジェクトの印刷が準備されてから、実際に印刷するまでに挿入されます。

値  256バイトまでの有効なプリンタ・コード参照を入力します。 入力値は、&number形式の文字列です。このnumberは、パッケージReport Builderプリンタ・コードかまたは自分で作成したプリンタ・コードに割り当てられた番号です。

適用対象  レイアウト・オブジェクト

使用上の注意

•	大抵の場合、レイアウト・オブジェクト用にPL/SQLを記述すれば、どのような特別なフォーマットも可能です。

PL/SQL PL/SQLを使用してこの属性を定義するには、SRW.SET BEFORE PRINTING CODEプロシージャを使用します。


後のプリンタ・コード

  制限 	  例

説明  「後のプリンタ・コード」および「前のプリンタ・コード」は、オブジェクトに対する特別な印刷指示（たとえば、特別なフォント・サイズまたは反転表示）を定義するプリンタ・エスケープ・シーケンスの参照元です。「後のプリンタ・コード」プロパティは、オブジェクトの各行の後に実行されるプリンタ・エスケープ・シーケンスを参照す。プリンタ・エスケープ・シーケンスは、オブジェクトの印刷が準備されてから、実際に印刷するまでに挿入されます。

値  256バイトまでの有効なプリンタ・コード参照を入力します。 入力値は、&number形式の文字列です。このnumberは、パッケージReport Builderプリンタ・コードかまたは自分で作成したプリンタ・コードに割り当てられた番号です。

適用対象  レイアウト・オブジェクト

使用上の注意

•	大抵の場合、レイアウト・オブジェクト用にPL/SQLを記述すれば、どのような特別なフォーマットも可能です。

PL/SQL PL/SQLを使用してこの属性を定義するには、SRW.SET AFTER PRINTING CODEプロシージャを使用します。


プリンタ・コードの特別なフォントの例

  関連項目 	  すべての例

プリンタ定義ファイルに、2つのプリンタ・コード&123および&456を作成したとします。 プリンタは、コード&123によって特別なフォントを印刷し、コード&456によって標準のフォントを印刷します。繰返し枠（R_1）内のすべてのフィールドを特別なフォントを使用して印刷するとします。プリンタ・コードは、各フィールドに使用することも、繰返し枠全体に使用することもできます。後者の方が、作成およびメンテナンスが簡単です。

R_1繰返し枠のプロパティ・シートでは、「前のプリンタ・コード」に&123、「後のプリンタ・コード」に&456を入力します。R_1が印刷されると、R_1の各行印刷前および後に、プリンタ・コードが実行されます。

  ここをクリックしてください。


プリンタ・コードの制限

•	プリンタ・コードは、キャラクタ・モードでレポートを実行しているときのみ使用されます。ビットマップ・モードで実行している場合には、使用されません。


垂直拡張度

  制限 	  例

説明  「垂直拡張度」プロパティは、実行時にオブジェクトまたはデータをその中に収めるためにオブジェクトの垂直サイズを変更する方法を示します。

•	枠および繰返し枠の場合、このプロパティは、枠または繰返し枠のサイズをその中のオブジェクトに合せて変更する必要があるかどうかを定義します。

•	テキストが含まれるオブジェクトの場合、このプロパティは、フィールドまたはボイラープレートがテキストのサイズに合せて変更される必要があるかどうかを定義します。サイズ固定のテキストは、定義されたオブジェクト・サイズの範囲内でラップされますが、十分な空間がなければ切り捨てられる場合があります。数値データまたは日付データを定義されたサイズ内に収められない場合、アスタリスク（*）が表示されます。

•	イメージおよび描画、チャート・オブジェクトの場合、Report Builderによって、比例したスケール変更が行われます。イメージおよび描画、チャート・オブジェクトの拡張度オプションによって、スケールが決まります。

  ここをクリックしてください。

値

縮小	フォーマットされたオブジェクトまたはデータの高さが低い場合、オブジェクトの垂直サイズは小さくなります。データの切捨てが行われる場合があります。 例を参照してください。（このオプションは、「縮小のみ行われ、拡張されない」ことを意味しています。)
Expand	フォーマットされたオブジェクトまたはデータの高さが高い場合、オブジェクトの垂直サイズは大きくなります。（このオプションは、「拡張のみ行われ、縮小されない」ことを意味しています。）
固定	オブジェクトの高さは、その中のオブジェクトまたはデータのサイズに関係なく、各論理ページで同じです。データの切捨てが行われる場合があります。 例を参照してください。オブジェクトの高さは、レポート・エディタ内のオブジェクトの高さに定義されます。
可変	オブジェクトは垂直方向に拡張または縮小され、その中のオブジェクトまたはデータは適切なサイズに調整されます。 つまり、実行時のオブジェクトの高さは、レポート・エディタ内に示される高さには影響されないということです。
適用対象  レイアウト・オブジェクト

必須/オプション  必須

デフォルト  オブジェクトにより異なる。

使用上の注意

•	「垂直拡張度」および「水平拡張度」を「固定」に設定して、レポート内にチャート・オブジェクトを作成した場合、Report Builderによってオブジェクトに定義したサイズに合わせて図表をスケーリングします。


垂直拡張度の例（拡張）

  関連項目 	  すべての例

次の特性を持つフィールドがあるとします。

特性	値
幅	1インチ
水平拡張度	固定
高さ	2インチ
垂直拡張度	Expand
  ここをクリックしてください。


垂直拡張度の例（可変）

  関連項目 	  すべての例

次の特性を持つ、M_2という枠があるとします。

特性	値
幅	5インチ
水平拡張度	固定
垂直拡張度	可変
また、レポートの「高さ」が12インチだとします。その中のオブジェクトのサイズにより、M_2をフォーマットするには垂直方向に8インチ必要です。別の枠M_1は、論理ページ上でM_2の前にあり、6インチ必要だとします。

次の図は、枠がどのようにフォーマットされるかを示しています。

  ここをクリックしてください。

M_2全体は、最初の論理ページには収まりません。「垂直拡張度」が「可変」なので、M_2の最初の6インチ分は、最初の論理ページに印刷され、残りの2インチ分は論理ページの2ページ目に印刷されます。「垂直拡張度」を「固定」にしていた場合は、M_2全体が論理ページの2ページ目に印刷されます。


「垂直拡張度」の制限

注意: オブジェクトの内容が定義された高さを超える場合、「垂直拡張度」および「水平拡張度」によって、内容が次ページにオーバーフローするのかまたは切り捨てられるのかが判断されます。イメージおよび描画、チャート・オブジェクトは、オーバーフローできません。イメージおよび描画、Graphics Builder図表の詳細は、次のルールを参照してください。

  ここをクリックしてください。

追加情報:	データを切り捨てる場合、問合せでSQLのSUBSTRファンクションを使用してください。たとえば、列の最初の4文字のみを使用する場合、SELECT文でSUBSTRを使用して、データベースからその文字のみを取り出します。

•	オブジェクトのフォーマット時に、「垂直拡張度」が「固定」に設定されている場合、論理ページにオブジェクト全体を含むことができる十分な空白があれば、Report Builderは論理ページ上にオブジェクトをフォーマットするのみです。

•	「垂直拡張度」が「拡張」に設定されている場合、論理ページに定義されたオブジェクトの高さ（つまり、最小値）が収まるのみの十分な空白があれば、Report Builderは論理ページ上でオブジェクトをフォーマットするのみです。フォーマットが完了しない場合、オブジェクトは次ページにオーバーフローします。

•	「垂直拡張度」が「可変」または「縮小」に設定されている場合、Report Builderは、最初の論理ページにできるのみフォーマットし、必要があれば、次の論理ページ上でオブジェクトのフォーマットを完了します。

•	数値がフィールドに収まらない場合は、値のかわりにアスタリスク（*）がフィールドに表示されます。値を表示するには、オブジェクトのサイズを変更するかまたはサイズ変更を「拡張」または「可変」に変更します。

•	次のサイズ・ルールは、イメージおよび描画、Graphics Builder図表を含むオブジェクト（たとえば、フィールドまたはボイラープレート）に適用されます。

•	レイアウト・オブジェクトのサイズが可変（つまり、「垂直拡張度」および「水平拡張度」の両方が「可変」）の場合、その内容は、ソース（たとえば、ソース・ファイル）と同じサイズで表示されます。

•	レイアウト・オブジェクトのサイズが固定（つまり、「垂直拡張度」および「水平拡張度」の両方が「固定」）の場合、その内容は、比例してスケール変更されます。これによって、内容とオブジェクトの境界線の間の領域が空白になる、つまり、「隙間」ができることがあります。たとえば、オブジェクトの「垂直拡張度」および「水平拡張度」の両方が「固定」であり、イメージがオブジェクトに対して大きすぎる場合、そのイメージの一方向のみはそのままのサイズになります。その他の方向では、そのイメージはオブジェクトより短くなります。このような隙間ができないようにするには、サイズの設定を変更（つまり、水平方向または垂直方向、その両方を「可変」に）できます。 または、手動でオブジェクトのサイズを変更できます。

•	イメージおよび描画、Graphics Builder図表を含むオブジェクトが一方向のみ「固定」に設定されている場合、Report Builderは常に「固定」のサイズまで内容をサイズ変更します。

•	オブジェクトのサイズ変更の一方向が「縮小」で、他方が「固定」の場合、内容はクリップされることがあります。このようにクリップされないようにするには、サイズの設定を変更（たとえば、水平方向および垂直方向の両方を「可変」に）します。 または、手動でオブジェクトのサイズを変更します。

•	オブジェクトのサイズ変更が可変（つまり、「垂直拡張度」および「水平拡張度」が「可変」）で、オブジェクトが囲みオブジェクト（たとえば、枠または論理ページ）に収まらない場合、オブジェクトをフォーマットできないので、レポートは無限ループします。

•	レポート出力に表示される値がレポートのフォーマットに依存する場合、値を表示するフィールドまたはボイラープレート・オブジェクトは「垂直拡張度」および「水平拡張度」が「固定」に設定されている必要があります。(これは、ページ依存参照と呼ばれます。)サイズが固定されていない場合、Report Builderは実行時に固定に変更します。

ページ依存参照の典型的な例は、「ソース」が「総ページ数」に設定されたフィールドです。論理ページの合計値は、レポート全体がフォーマットされるまでわかりません。しかし、Report Builderは、レポート終了前にフィールドをフォーマットする必要があり、レポートが完全にフォーマットされて作成するフィールドの大きさが決まるまで待つことはできません。そのためにはフィールドのサイズが固定されている必要があるので、フィールドのソース値が決まる前に、Report Builderはフィールド用に確保するスペースの大きさを認識しています。

次はページ依存参照のケースです。フィールドまたはボイラープレート・オブジェクトのソース値がレポートのフォーマットによって決まるので、そのサイズは固定にしてください。

•	サマリー列が「リセット位置」または「計算位置」が「ページ」の場合、その値を表示するフィールドまたはボイラープレート・オブジェクトのサイズは固定にしてください。

•	式列またはサマリー列が、「リセット位置」または「計算位置」が「ページ」のサマリー列に依存する場合、その値を表示するフィールドまたはボイラープレート・オブジェクトのサイズは固定にしてください。

•	フィールドの「ソース」が「ページ番号」または「パネル番号」、「物理ページ番号」、「総ページ数」、「総パネル数」、「総物理ページ数」の場合、フィールド（フィールド自体またはボイラープレート・オブジェクトのいずれか）を表示するオブジェクトのサイズは、固定にしてください。

•	フィールドが「ソース」としてページ番号を持っており、「ページ番号付け」ダイアログ・ボックスの「リセット位置」が繰返し枠の場合、値を表示するレイアウト・オブジェクトのサイズは、固定にしてください。

注意:	ページ依存参照を含むフィールドの「可視」が「いいえ」に設定されている場合、このフィールドの「水平拡張度」は「可変」 または「拡張」、「縮小」にしてください。そのフィールドを参照するどのボイラープレート・オブジェクトも、サイズは固定にしてください。


ハイパーリンク（HTML/PDF）
ハイパーリンク

  制限 	  関連項目	  例

説明  「ハイパーリンク（HTML/PDF）」プロパティは、WebブラウザまたはPDFビューア内でオブジェクトをクリックしたときに、文書または文書内の宛先を表示するURLリンク仕様部です。

値  次の宛先に対する有効なリンクを指定します。

•	現行文書内の宛先（#my_dest_nameなど）

•	ローカルの文書内の宛先（file:/private/somedoc.pdf#a_dest_nameなど）

•	ローカル・マシン上の文書（file:/private/mynewdoc.pdfまたは file:///C|/temp/mynewdoc.pdfなど）

•	リモート・マシン上の文書（http://www.newmach.com/newdoc.pdfまたはhttp://www.newmach.com/newdoc.html、ftp://www.reposit.com/filetoget.example、http://www.somemch.com/cgi-bin/webmenu?choice1など）

•	リモートの文書内の宛先（http://www.newmach.com/newdoc.pdf#some_dest_nameなど）

適用対象  レイアウト・オブジェクト

デフォルト  ブランク

使用上の注意

•	「ハイパーリンク（HTML/PDF）」プロパティが枠に対して指定されている場合、このプロパティは「ハイパーリンク（HTML/PDF）」プロパティが指定されていないすべての子（内部）オブジェクトに転送されます。プロパティを子オブジェクトに転送できない場合、枠の「ハイパーリンク（HTML/PDF）」の値は失われます。

•	PDF形式のレポート出力は、ハイパーリンクとアプリケーション･コマンド･ライン･リンクの両方をインクルードできます。「アプリケーション・コマンド・ライン」プロパティがオブジェクトに設定されている場合は、そのプロパティがオブジェクトに適用されます。それ以外の場合は、「ハイパーリンク」プロパティが適用されます。

•	「ハイパーリンク（HTML/PDF）」プロパティが枠内のオブジェクトについて指定されている場合、オブジェクトをクリックすると、デフォルトで、ハイパーリンクの宛先を示すウィンドウ全体に、枠が置き換わります。枠のみを置き換えるには、"target=ファイル名"というHTMLを「追加のハイパーリンク属性」プロパティ設定に追加します。ファイル名は、置き換える枠の名前です。

PL/SQL PL/SQLで出力するデータを制限するには、SRW.SET HYPERLINKプロシージャを使用します。


「ハイパーリンク（HTML/PDF）」の制限

•	PDFビューアからリモート・サーバーまたはHTML文書へのWebリンクをたどるには、Webブラウザと連動するようにPDFビューアを構成する必要があります(たとえば、ヘルパー・アプリケーションとして構成したり、プラグインとしてWebブラウザにインストールする)。


ハイパーリンクの宛先

  例

説明  「ハイパーリンクの宛先」プロパティは、オブジェクト用の一意識別子で、Webリンクの宛先として使用できます。

値  26の大文字または小文字のASCII文字または数字、アンダースコア文字のみを使用する有効な一意の名前。他の特殊文字は、アンダースコア文字に自動的に変換されます。

適用対象  レイアウト・オブジェクト

必須/オプション  宛先に自分を指定するオブジェクトの「ハイパーリンク（HTML/PDF）」プロパティを設定する場合、必須。

デフォルト  ブランク

使用上の注意

•	「ハイパーリンクの宛先」プロパティが枠に対して指定されている場合、プロパティは枠の上部左角に最も近い可視オブジェクトに転送されます。

PL/SQL PL/SQLで出力するデータを制限するには、SRW.SET LINKTAGプロシージャを使用します。


ブックマーク

  制限      [image]  例

説明  「ブックマーク」プロパティは、マスターHTML文書のブックマーク枠またはPDFビューアのブックマーク領域に表示されるWebリンクです。ブックマークをクリックすると、ウィンドウの一番上に対応付けられたオブジェクトが表示されます。

値

インデントおよび順序付けに関する情報がないテキスト文字列。ブックマークは、レポートがオブジェクトを渡す順に、ブックマーク・リストに表示されます。

順序付けおよびインデントを明示したx#book_mark_name形式のテキスト文字列で、xにはアウトライン番号が入ります。シャープ記号（#）とアウトライン番号は、「ブックマーク」ウィンドウには表示されませんが、順序とインデントを決めるのに使用されます。

適用対象  レイアウト・オブジェクト

デフォルト  ブランク

使用上の注意

•	「ブックマーク」が枠に対して指定されている場合、プロパティは枠の上部左角に最も近い可視オブジェクトに転送されます。

PL/SQL PL/SQLを使用してこの属性を定義するには、SRW.SET_BOOKMARKプロシージャを使用します。


ブックマークの例（インデントおよび順序付け済み）

  関連項目 	  すべての例

1#Expense Summary Section
2#Expense Detail Section
2.1#Expenses for the Administration Department
2.2#Expenses for the Engineering Department
2.3#Expenses for the Sales Department
2.3.1#Expenses for the Eastern Sales Region
2.3.2#Expenses for the Northern Sales Region
2.3.3#Expenses for the Southern Sales Region
2.3.4#Expenses for the Western Sales Region


「ブックマーク」の制限

•	同じアウトライン番号が何回も使用される場合、エントリはすべて表示されますが、順序はレポートがオブジェクトを渡した順で定義されます。

•	番号がとんでいる場合、次の2つのうちの1つが発生します。同等レベルの番号がとんでいる場合は、目に見える影響はありません（たとえば、1.3.1と1.3.3で、1.3.2がない場合、同じインデント・レベルで並んで表示されます）。上位の番号と低位の番号の間がとんでいる場合、中間のレベルが必要に応じて生成されます（たとえば、1.0の後が2.1.1ならば、見かけ上の2と2.1のエントリが定義されます。 そのタイトルは、後の実際のエントリと同じになります）。


アプリケーション・コマンド・ライン（PDF）

  制限	  例

説明  「アプリケーション・コマンド・ライン（PDF）」プロパティは、PDF文書内のオブジェクトがPDFビューアでクリックされたときに、ローカル・マシン上で実行されるコマンド・ラインです。

値  ローカル・マシン上の任意の有効なコマンド・ライン（c:\orawin95\bin\rwrun60 userid=scott/tiger report=example.rdfなど）

適用対象  レイアウト・オブジェクト

デフォルト  ブランク

•	PDF形式のレポート出力は、ハイパーリンクとアプリケーション･コマンド･ライン･リンクの両方をインクルードできます。「アプリケーション・コマンド・ライン」プロパティがオブジェクトに設定されている場合は、そのプロパティがオブジェクトに適用されます。それ以外の場合は、「ハイパーリンク」プロパティが適用されます。

PL/SQL PL/SQLを使用してこの属性を定義するには、SRW.SET_PDF ACTIONプロシージャを使用します。


「アプリケーション・コマンド・ライン（PDF）」の制限

•	「アプリケーション・コマンド・ライン」プロパティは、PDF出力専用です。


条件付き書式

  関連項目

説明  「条件付き書式」プロパティは、「条件書式」ダイアログ･ボックスで指定した条件がTRUEの場合、選択したレイアウト･オブジェクトの出力書式をその条件で設定します。

適用対象  レイアウト・オブジェクト

必須/オプション  オプション


表示名

  例

説明  「表示名」プロパティは、HTMLまたはHTMLCSS形式のレポート出力に含まれるイメージ・オブジェクト上にカーソルを移動したときに、ポップアップ形式で表示されるテキストです。

値  256文字以下のテキスト文字列

適用対象  HTMLレポートのイメージ・オブジェクト

デフォルト  ブランク

使用上の注意

•	レポートをHTMLまたはHTMLCSS形式で出力するとき、「表示名」プロパティ値は、HTML ALTタグを使用してIMGタグに挿入されます。

•	イメージ・オブジェクトに対して定義されたハイパーリンクがある場合、「追加のハイパーリンク属性」プロパティを使用して、情報のステータス行を生成することもできます。

PL/SQL PL/SQLを使用してこの属性を定義するには、SRW.SET DISPLAY NAMEプロシージャを使用します。


追加のハイパーリンク属性

  例	  関連項目

説明  「追加のハイパーリンク属性」プロパティは、「ハイパーリンク（HTML/PDF）」プロパティによって定義されたリンクに適用される、追加のHTML属性を指定します。

値  「ハイパーリンク（HTML/PDF）」プロパティによって定義されたリンクについて有効な任意のHTMLタグ

適用対象  「ハイパーリンク（HTML/PDF）」プロパティによって定義されたリンクを持つレイアウト・オブジェクト。リンクが定義されていない場合、このプロパティは効果がありません。

デフォルト  ブランク

使用上の注意

•	「ハイパーリンク（HTML/PDF）」プロパティが枠内のオブジェクトについて指定されている場合、オブジェクトをクリックすると、デフォルトで、ハイパーリンクの宛先を示すウィンドウ全体に、枠が置き換わります。枠のみを置き換えるには、"target=ファイル名"というHTMLを「追加のハイパーリンク属性」プロパティ設定に追加します。ファイル名は、置き換える枠の名前です。

PL/SQL PL/SQLを使用してこの属性を定義するには、SRW.SET HYPERLINK ATTRプロシージャを使用します。


レイアウト･セクションの終了

説明  「レイアウト･セクションの終了」プロパティでは、ライブ･プレビューアが、整列したオブジェクトの検索をどこで終了するか決定します。このプロパティはおもにキャラクタ･モードで使用し、一致するオブジェクトの検索範囲を制限します。

値

はい	ライブ･プレビューアは、一致するオブジェクトの検索をフレームの終わりで終了します。
いいえ	ライブ･プレビューアは、同じ方向に整列しているすべてのオブジェクトを検索します。
適用対象  フレーム

必須/オプション  必須

デフォルト  オブジェクトにより異なる。


この図は、各プリンタ・コードが起動されるポイントを示しています。


この図は、フィールドがフォーマットされたときの外観を示しています。フィールドの高さは必ず最低2インチ、幅は1インチ必要であることに注意してください。データのサイズが幅1インチ、高さ2インチより大きい場合、フィールドはデータに合わせて垂直方向に大きくなります。


次の表は、オーバーフローおよび切捨てが起こるオブジェクトとサイズ選択の組合せを示しています。（表内の「拡張」および「可変」は、「垂直拡張度」または「水平拡張度」が「拡張」または「可変」のいずれかに設定されていることを表しています）。

オブジェクト	固定/縮小	拡張	可変
繰返し枠	オーバーフローなし	オーバーフローなし	オーバーフローなし
インスタンスおよびフレーム
(内容 <= 定義された高さ)
繰返し枠	オーバーフローなし	条件付でオーバーフロー	条件付でオーバーフロー
インスタンスおよびフレーム		収められない	収められない
(内容>定義された高さ)		(そのページ上に)	(そのページ上に)
フィールドおよびボイラープレート	オーバーフローなし	オーバーフローなし	オーバーフローなし
内容 <=定義された高さ)
フィールドおよびボイラープレート	切り捨てられる*	条件付でオーバーフロー	条件付でオーバーフロー
(内容>定義された高さ)		収められない(そのページ上に)	収められない(そのページ上に)
* 切捨てが発生しないようにするには、フィールドまたはボイラープレートの「垂直拡張度」を

「可変」に設定して、「垂直拡張度」が「固定」に設定された枠で囲んでください。

また、テキストが切り捨てられる場合、フィールドまたはボイラープレートのテキストが折り返された後に、切捨てが起こることに注意してください。


この図は、レイアウトおよび出力結果を示しています。


 レイアウト中のR_Salの下に表示されるB_Graphの印刷が実際に終わるのは、2ページ目ではなく、1ページ目であることに注意してください。


この図では、枠M_Deptの「後で改ページ」が「はい」に設定されています。M_DeptとM_Empは両方とも、「垂直拡張度」および「水平拡張度」が「固定」に設定されています。M_DeptおよびM_Empは親枠M_Parent内の同位項目なので、この場合、「後で改ページ」では何も変わりません。


 この図は、前の例と同じですが、M_Deptが親として明示的にM_Empにアンカーされている点が異なります。M_DeptはM_Empの親であるため、この場合、「後で改ページ」はM_Empのフォーマットを遅らせます。


レイアウト中のR_Salの下に表示されるB_Graphの印刷が実際に終わるのは、R_Salが印刷される1ページ目であることに注意してください。これは、B_GraphがR_Salの子ではないために発生します。B_GraphがR_Salに対する子として明示的にアンカーされている場合、B_Graphは1ページ目ではなく、2ページ目に出力されます。


データベース列プロパティ

  制限

ブレーク順序

列のデータ型

コメント

XMLタグを含む

データベース列名

データ型

XML出力から除外

ファイル形式

名前

ファイルからの読込み

NULL時の値

幅

XMLタグ

XMLタグ属性


データベース列の制限

•	データベースの列を作成できるのは、Report Builderのみです（問合せの選択リスト内の各項目について1つずつ作成されます）。データベースの列を作成するには、問合せの選択リストに項目を追加してください。すると、Report Builderがデータベースの列を作成します。

•	データベースの列を削除するには、関係付けられた項目を選択リストから除去するしかありません。


「フィールド」プロパティ

  関連項目	  制限

追加のハイパーリンク属性

アプリケーション・コマンド・ライン（PDF）

基本印刷オン

ブックマーク

コメント

HTMLタグを含む

書式マスク

フォーマット・トリガー

水平拡張度

ハイパーリンク（HTML/PDF）

ハイパーリンクの宛先

アンカー・オブジェクトと連動

最小孤立行

名前

後で改ページ

前で改ページ

ページ番号付け

ページ保護

印刷オブジェクト・オン

後のプリンタ・コード

前のプリンタ・コード

ソース

ソース・データ型

垂直拡張度

可視


フィールドの制限

•	フィールド内のテキストの各パラグラフのサイズは64Kバイト以下、パラグラフの数は64.000個以下にしてください。この制限は、オペレーティング・システムによって異なることがあります。

•	フィールドの内容は、単語の境界（つまり、スペースおよびハイフン、タブ）で折り返されます。その他の句読点は、直前の単語の最後の文字と見なされます。フィールドの内容の中に改行文字があると改行されます。作成可能な行数についての制限はありません。

•	レイアウト・モデルでは、フィールドは、ソース・グループがフィールドのソース列を含むグループ（または、そのグループの下位グループ）である繰返し枠の中に配置してください。フィールドのソースがクロス積グループによって所有される集計の場合、そのフィールドは、ソースがサマリー列の積順序内のグループである繰返し枠の集合の中に配置してください。

•	フィールドは、フィールドを含む繰返し枠の前面にする必要があります。

•	数値がフィールドに収まらない場合は、値のかわりにアスタリスク（*）がフィールドに表示されます。値を表示するには、オブジェクトのサイズを変更するかまたはサイズ変更を「拡張」または「可変」に変更します。


データ型;
データ型

説明  「データ型」プロパティは、フィールドのソースのデータ型を表示する読込み専用フィールドです。

適用対象  フィールド

使用上の注意

•	「データ型」が「LONG」または「LONG RAW」、「RAW」の場合、「列」プロパティ・パレットの「ファイル形式」フィールドでその他の値を指定しなければ、フィールドはテキストとして処理されます。


書式マスク;
書式マスク

  書式マスク構文	  制限 	  例

説明  「書式マスク」プロパティは、フィールドにDATEおよびNUMBERの値を表示する方法を定義します。数値および日付用のカスタム・マスクを入力することも、値リストから選択することもできます。文字値には、書式マスクはありません。

最初にリストに表示される値は、フィールドのデータ型によって決まります（つまり、フィールドの「データ型」が「NUMBER」の場合、リストには数値マスクのみが表示されます）。「書式マスク」のリストにないものを入力し、「フィールド」プロパティ・パレットを確定した場合、新しい書式マスクが値リストに表示されます。

値   長さ1Kバイト以内の有効な数値または日付書式マスク。   ブランクを入力すると、Report Builderによって、そのフィールドのソースのデータ型に基づいて値がフォーマットされます。

適用対象  フィールド

必須/オプション  オプション

デフォルト  ブランク

使用上の注意

•	このフィールドをブランクにしておき、このフィールドのソースの「データ型」が「DATE」の場合、使っている言語のデフォルトの書式マスクになります（たとえば、アメリカでは、デフォルトは「DD-MON-YY」）。フィールドのソースの「データ型」が「NUMBER」の場合、値はソースの幅（下の表を参照）に従ってフォーマットされます。

  ここをクリックしてください。

デフォルトでは、 SQL*ReportWriter Version 1.1と同じ動作をします。

•	カスタム書式マスクは、現行のReport Builderセッション中のみ有効です。Report Builderを終了して再起動すると、「書式マスク」フィールドの値リストには、前回のReport Builderセッションで作成した書式マスクは含まれていません（これらのマスクが使用されたレポートをオープンしない場合）。リスト内に組み込んだマスクが複数セッション間で保存されるようにするには、「環境設定」ダイアログ・ボックス（「ツール」-->「作業環境」）の「書式マスク」を使用します。

PL/SQL PL/SQLを使ってこの属性を定義するには、SRW.SET FORMAT MASKプロシージャを使用します。


DATEおよびTIME書式マスク構文

次の表に、日付用の書式マスク、それに追加可能な接尾辞および時刻の書式マスクを説明します。

書式マスク	説明
SCCまたはCC	世紀。「S」によって、紀元前の場合「-」が付きます。
SYYYYまたはYYYY	年。「S」によって、紀元前の場合「-」が付きます。
I、YまたはIYY	年の下3桁、下2桁または下1桁。
Y、YYまたはYYY	年の下3桁、下2桁または下1桁。
Y,YYY	カンマ付きの年。
SYEARまたはYEAR	綴りで表した年。「S」によって、紀元前の場合「-」が付きます。
RRRRまたはSRRRR	年。「S」によって、紀元前の場合「-」が付きます。
RR	年の下2桁。
BC、ADまたはB.C.、A.D.	世紀を示す記号。
Q	四半期（1月から3月が四半期「1」）。
MM	数字表記の月（1月は「01」）。
MONTHまたはMON	月の名前または月の略称（英語の場合3文字）。
WWまたはIW	年間の何週目かを示します。
W	ユリウス暦で何週目かを示します。
J	ユリウス暦日付。紀元前4712年1月1日からの日数。
DDD、DDまたはD	1年の何日目かまたは月の何日目か、週の何日目かを示します。
DAY	曜日（例:月曜日）。
DY	曜日の略称（例:月）。
AM、PMまたはA.M.、P.M.	正午標識。
HHまたはHH12	1日の時間の表記（1～12時）。
HH24	1日の時間の表記（0～23時）。
MI	分。
SSおよびSSSSS	1分間の秒および1日の秒。
FM	日付、数値またはワードの前か間にある複数のスペースを1つのスペースに置換する充填モードをトグルします。
次の接尾辞は、書式マスクに追加できます。

接尾辞	説明
TH	序数（「4th」の場合は「DDth」）
SP	綴りで表した数値（「FOUR」の場合は「DDSP」）
SPTHまたはTHSP	綴りで表した序数（「FOURTH」の場合は「DDSPTH」）


数値書式マスク構文

次の表に、数値書式マスクの作成に使用できるトークンを説明します。

フォーマット・トークン	説明
0	1桁分の数字を印刷。
N	小数点左側の先行0ゼロまたは小数点右側の後続0以外の数字の場合、1桁分の数字を印刷。
*	小数点左側の先行0以外の数字の場合、1桁分の数字が印刷され、先行0の場合はアスタリスク（*）が印刷されます。小数点右側の後続0は、印刷されます。
9	小数点左側の先行0以外の数字の場合、1桁分の数字が印刷され、先行0の場合はスペースが印刷されます。小数点右側の後続0は、印刷されます。
+	正の値の前にはプラス記号（+）が印刷され、負の値の前にはマイナス記号（-）が印刷されます。このトークンは、マスクの前にあることが必要です。
-	負の値の前にはマイナス記号（-）が印刷されますが、正の数の場合は何も印刷されません。このトークンは、その他のトークンの前にあることが必要です。
MI	負の値の後にはマイナス記号（-）、正の値の後にスペースを印刷する。このトークンは、その他のトークンより後にあることが必要です。
S	負の値にはマイナス記号（-）、正の値にはプラス記号（+）を印刷します（マスク内のSの位置に印刷）。このトークンは、その他のトークンより前または後にあることが必要です。
PR	負の値は山がた（<>）で囲み、正の値はスペースで囲んで印刷します。このトークンは、その他のトークンより後にあることが必要です。
( )	負の値は丸カッコ（ ）で囲み、正の値はスペースで囲んで印刷します。カッコでその他のトークンを囲む必要があります。
DB	正の値の後に、「DB」を印刷します。このトークンは、その他のトークンより後にあることが必要です。
CR	負の値の後に、「CR」を印刷します。このトークンは、その他のトークンより後にあることが必要です。
Y	負の数でも正の数でも、符号記号は印刷しません。
V	数値を10のN乗倍します。Nは、Vの右側にあるトークン（0または9、*、S）の数。
EEEE	科学表記法で数値を印刷します。すべての数字トークンは、仮数の数字を示します。小数点の左側には、その表示、非表示にかかわらず、数字がちょうど1桁必要です。トークンEEEEは、縦座標が正または0の場合、Eの後にプラス記号（+）を印刷します。縦座標が負の場合、Eの後にマイナス記号（-）と縦座標を表す2桁の数字を印刷（たとえば、E-99）します。
"文字列"	文字列を二重引用符で囲んで印刷します。文字列の中に二重引用符を含めたい場合、二重引用符を続けて2つ（""）入力します。
. (ピリオド)	数値の整数部と小数部を分けるピリオド（.）を印刷します。
D	数値の整数部と分数部を分けます、ローカルの小数点文字を印刷します。
, (カンマ)	グループ・セパレータまたは3桁セパレータを示す文字としてカンマ（,）を印刷します。
G	ローカルのグループ･セパレータまたは3桁セパレータを印刷します。
$	ドル記号（$）を印刷します。
L	地域別通貨記号を印刷します。
C	ISO基準の通貨記号を印刷します。
%	パーセント記号（%）を印刷します。
" "	ブランクを印刷します（マスクに引用符を含めてはいけません）。
v	他のトークンに関係なく、すべての0をスペースで印刷します。
K	ブランクを印刷します。
<>	小数点揃えする領域（つまり、書式マスク中の小数点に合わせる数値の部分）の開始および終了を示します。山がたは、その数値が常に同じ大きさの領域を使用することを示します。必要に応じて、小数点左側または右側にスペースが埋め込まれます。
RN, rn	値をローマ数字（RNの場合は大文字、rnの場合小文字）で印刷します。このトークンは、他のトークンとともに使用することはできません。


書式マスクの例

  関連項目 	  すべての例

次の表に、書式マスクの例をいくつか示します。

日付書式の例	表示される日付
MM/DD/RR	03/04/85
DD MON RRRR	04 MAR 1985
Mon.DD, RRRR	Mar. 4, 1985
Day Month DD fmHH:MI AM	Monday March 4 11:35 AM
Dy Mon ddth fmHH24:MI:SS	Mon Mar 4th 23:35:22
Day "the" ddthsp "of" Month	Monday the fourth of March
数値書式の例	数値	表示される数値
-0000	7934	"7934"
	-7934	"-7934"
-00000	7934	"07934"
-NNNN	7639	"7639"
	535	"535"
-NNN	7639	"****"
-****	7902	"7902"
-*****	7902	"*7902"
+NNNN	100	"+100"
	-99	"-99"
(NNNN)	1600	"1600"
	-800	"(800)"
NNNNPR	1600	"1600"
	-800	"<800>"
NNNNMI	1600	"1600 "
	-800	"800-"
NNNVNN	343	"34300"
N.NNEEEE	7369	"7.37E+03"
"SRW"-0000	7782	"SRW7782"
-$NNNN.NN	800	"$800"
	1600	"$1600"
-%NNN	10	"%10"
-NN NNN.NN	3000	"3 000"
+KKNNNNN.00	1950	"+  1950.00"
	900	"+   900.00"
$<NNNNN.00>	1200	"$  1200.00"
	500	"$   500.00"
$<NNNNN.00> DB	1200	"$  1200.00 DB"
	-500	"$   500.00"
$<NNNNN.00> CR	1200	"$  1200.00"
	-500	"$   500.00 CR"
* 引用符は出力されません。この表では、先行または後続する空白の位置を明示するために使用されています。


「書式マスク」の制限

•	数値書式マスクの場合、実際の値が指定された書式マスクより長ければ、フィールドの幅に関係なく、アスタリスク（*）の文字列がレポート出力に表示されます。たとえば、フィールドの固定幅が8で、値が1234567の場合、書式マスクが<NNNNNN>ならば、*******と出力されます。

同様に、数値書式マスクによって、フィールドの幅より値が大きくなる場合は、値のかわりにアスタリスク（*）が出力されます。たとえば、フィールドの固定幅が6で、値が1234、書式マスクが-99999999の場合、******が出力されます。これは、フォーマット・トークン9によって、小数点左側の先行0にスペースが印刷される指定になっているためです。その結果、値が長すぎるため、幅が6のフィールドには表示できません。

•	書式マスクに符号トークンを指定しない場合、正の値の前にはスペース、負の値の前にはマイナス記号（-）が表示されます。この動作は、SQL*ReportWriter Version 1.1のデフォルトの動作とは異なります。書式マスク･トークンYを指定すると、Version 1.1のデフォルトの動作になります。

•	つまり、数値書式マスクはソースが数値の場合に表示され、日付書式マスクはソースが日付のときに表示されます。

•	0をスペースに置き換えて印刷する書式マスク（たとえば、9）を使用すると、1ページ当たりのバイト数が増加し、出力に時間がかかります。


可視;
可視

  制限 	  例

説明  「可視」プロパティは、フィールドのフォーマットの有無を示します。このプロパティを「いいえ」に設定すると、フィールドは非表示になります（フォーマットされません）。これは、ボイラープレート・テキストで参照するのみのフィールドに使用します。非表示フィールドは、フォーム・レター・レポートに最もよく使用されます。フォーム・レター・レポートでは、フィールドは、ボイラープレート・テキストで参照されます。非表示フィールドを参照するには、ボイラープレート・テキスト・オブジェクト内に&フィールド名を入力します。

適用対象  フィールド

必須/オプション  オプション

デフォルト   はい

使用上の注意

•	非表示フィールドを参照する場合、ボイラープレート・テキスト内ならどこでも表示できます。フィールド参照をその他のテキストの横に配置し、それらの間にスペースがない場合は、フィールド名を山がた（<>）で囲みます（たとえば、&<フィールド名>Kg）。それ以外の場合、Report Builderでは、アンパサンド（&）と次のスペースの間にあるテキストはフィールド名の一部であると見なされます。しかし、間にスペースを入れたり、山がたを使用したりしなくても、複数の参照を並べることができる（たとえば、&フィールド1&フィールド2&フィールド3）ことに注意してください。


非表示フィールドの参照例

  関連項目 	 すべての例

フォーム・レター・レポートを作成しており、そのレターに受取人の名前および住所、電話番号を書くとします。受取人名用にNAME1、住所用にADDRESS、電話番号用にPHONEという名前のフィールドを作成します。これらのフィールドは、ボイラープレート・テキスト内に表示されるのみなので、「いいえ」を選択します。これらの値を表示するボイラープレート・テキスト内に、参照を次のように挿入します。

Dear &NAME1,

Our records show that your address and phone are the

following:

&ADDRESS

&PHONE

出力すると、次のようなレターになります。

Dear J. Smith,

Our records show that your address and phone are the

following:

234 Summer Lane

San Francisco, CA 11104

415-363-1234


非表示フィールドの制限

非表示フィールドの次のプロパティおよび属性は、非表示フィールドの参照に適用されます。

•	「フォントの指定」ダイアログの各属性

•	水平拡張度

•	書式マスク

•	ページ番号（「ページ番号付け」ダイアログ・ボックスにあります）

•	フォーマット・トリガー


ページ番号付け;
ページ番号付け

  制限 	  例

説明  「ページ番号付け」プロパティによって、「物理ページ番号」または「総物理ページ数」、「パネル番号」、「総パネル数」の「ソース」を持つフィールドについてページ番号の計算方法が判別されます。

  ここをクリックしてください。

注意:  各ページの設定は、フィールドの「ソース」によって指定された論理ページまたは物理ページに基づいています。


ページ番号付けの例（ボディ・ページの場合）

  関連項目      [image]  すべての例

レポートのメイン・セクションの物理ページに番号を付けるとします。

1	F_PAGEという名前のフィールドを作成し、「ソース」プロパティを「物理ページ番号」に設定します。

2	F_PAGEの「フィールド」プロパティ・パレットで、「ページ番号付け」ダイアログ・ボックスに次のように入力し、「ページ番号付け」プロパティを設定します。

•	メイン・セクションのページのみに番号を付けるので、「メイン」セクションをチェックして、ヘッダー・セクションとトレーラ・セクションはチェックしません。

•	「起動位置」の設定に、1を入力します。

•	「増分」の設定に、1を入力します。

•	メイン・セクションのすべてのページに連続した番号を付けるので、「リセット位置」の設定に「&Report」を入力します。

3	レイアウト・モデル内でF_PAGEを配置します。


ページ番号付けの例（「Nページ/全ページ」形式の場合）

  関連項目      [image]  すべての例

レポートの各ページの最上部にページ番号を付けるとします。「Nページ/Mページ」という形式にするとします。

1	F_PAGEという名前のフィールドを作成し、「ソース」プロパティを「物理ページ番号」に設定します。

2	F_PAGEの「フィールド」プロパティ・パレットで、「ページ番号付け」ダイアログ・ボックスに次のように入力し、「ページ番号付け」プロパティを設定します。

•	メイン・セクションのページのみに番号を付けるので、「メイン」セクションをチェックして、ヘッダー・セクションとトレーラ・セクションはチェックしません。

•	「起動位置」の設定に、1を入力します。

•	「増分」の設定に、1を入力します。

•	レポートが完了するまでページ番号が0にリセットされないように、「リセット位置」に「&Report」を入力します。

3	F_TOTPGEという名前のフィールドを作成し、「ソース」プロパティを「総物理ページ数」に設定します。

4	次のいずれかの操作を行います。

•	これらのフィールドを非表示に（つまり、プロパティ・シートで「可視」を「いいえ」に設定）して、ボイラープレート・テキスト内でそれらを参照します。

ページ &F_PAGE of &F_TOTPGE

•	または、F_PAGEとF_TOTPGEを並べて配置します。テキスト「ページ」を含むボイラープレートをF_PAGEの左に挿入します。テキスト「/」を含むボイラープレートをF_PAGEとF_TOTPGEの間に挿入します。


ページ番号付けの例（繰返し枠のインスタンスの場合）

  関連項目      [image]  すべての例

複数ページにまたがるインスタンスを持つ繰返し枠（R_1）があり、この各インスタンスがまたがる物理ページにページ番号を付けるとします。また、「Nページ/Mページ」という書式にするとします。

1	F_PAGEという名前のフィールドを作成し、「ソース」プロパティを「物理ページ番号」に設定します。

2	F_PAGEの「フィールド」プロパティ・パレットで、「ページ番号付け」ダイアログ・ボックスに次のように入力し、「ページ番号付け」プロパティを設定します。

•	メイン・セクションのページのみに番号を付けるので、「メイン」セクションをチェックして、ヘッダー・セクションとトレーラ・セクションはチェックしません。

•	「起動位置」の設定に、1を入力します。

•	「増分」の設定に、1を入力します。

•	繰り返し枠のインスタンスごとにページ番号をリセットするので、「リセット位置」に「&R_1」を入力します。

3	F_TOTPGEという名前のフィールドを作成し、「ソース」プロパティを「総物理ページ数」に設定します。

4	F_TOTPGEの「フィールド」プロパティ・パレットで、「ページ番号付け」ダイアログ・ボックスに次のように入力し、「ページ番号付け」プロパティを設定します。

•	繰り返し枠のインスタンスごとにページ番号をリセットするので、「リセット位置」に「&R_1」を入力します。

5	R_1のすべての論理ページに印刷されるように、F_PAGEおよびF_TOTPGEの印刷条件を設定します。

•	「印刷オブジェクト・オン」を「全ページ」に設定します。

•	「基本印刷オン」を「インクローズ・オブジェクト」に設定します。

6	次のいずれかの操作を行います。

•	これらのフィールドを非表示にして（つまり、プロパティ・シートで「可視」を「いいえ」に設定）、次のテキストを持つボイラープレート・テキスト・オブジェクトをR_1内に作成します。

Page &F_PAGE of &F_TOTPGE

•	または、レイアウト・モデルを使用して、R_1内にF_PAGEとF_TOTPGEを並べて配置します。テキスト「ページ」を含むボイラープレートをF_PAGEの左に挿入します。テキスト「/」を含むボイラープレートをF_PAGEとF_TOTPGEの間に挿入します。


「ページ番号付け」の制限

「リセット位置」の値が繰返し枠の場合、繰返しフィールドが表示されないページには、フィールドを表示しないようにしてください。フィールドの値は繰返し枠によって決まるため、繰返し枠が表示されないページでは、結果が予測できなくなります。この状況を避けるには、次のいずれかの作業を行うことができます。

•	フィールドの値がリセットされる繰返し枠の内部にフィールドを配置する。これによって、フィールドは、繰返し枠が表示されるときのみ表示されます。

•	フィールドの値が有効なページ（つまり、繰返し枠の1つのインスタンスが表示されるページ）にのみフィールドが表示されるように、フィールドの「フォーマット・トリガー」を作成する。

同様に、フィールドがリセットする繰返し枠の内部になく、複数のインスタンスが同じページに表示される場合、Report Builderではフィールドの値が判別されず、この場合も結果が予測できなくなります。この状況を避けるには、次のいずれかの作業を行うことができます。

•	フィールドの値がリセットされる繰返し枠の内部にフィールドを配置する。

•	フィールドの値がリセットされる繰返し枠の「ページ当りの最大レコード数」を 1に設定する。


ソース

  制限 	  例

説明  「ソース」プロパティは、フィールドの値の格納場所（通常は、列またはパラメータ）です。

注意:   「ソース」がページ番号値（たとえば、「パネル番号」）の場合、どのようにページ番号付けされるかを制御する「ページ番号付け」を選択できます。

値  有効な列またはパラメータの名前

現在の日付	ランタイム・パラメータ・フォーム終了後、レポートが実行されるときのオペレーティング・システムの日付
ページ番号	論理ページでの番号付けによる現行のページ番号
パネル番号	論理ページ内の現行のパネル番号
物理ページ番号	物理ページでの番号付けによる現行のページ番号
総ページ数	論理ページでの番号付けによる合計ページ数
総パネル数	論理ページ内のパネルの合計数
総物理ページ数	物理ページでの番号付けによる合計ページ数
適用対象  フィールド

必須/オプション  必須


ソースの例

  関連項目	  すべての例

次の図のようなデータ・モデルを持つレポートがあるとします。さらに、G_Deptは繰返し枠R_Deptの「ソース」で、G_Empは繰返し枠R_Empの「ソース」であるとします。

  ここをクリックしてください。


ソースの制限

•	フィールドが繰返し枠に囲まれている場合、そのソースとして使用される列は、フィールドを囲む繰返し枠のソース・グループの中またはソース・グループの上位項目の中に存在する必要があります。

図には、グループ・ツリーが示されています。繰返し枠のソース・グループが6の場合、フィールド「ソース」は、1または3、6になります。フィールドを囲む繰返し枠がない場合、列はレポート・レベルの列にしてください。つまり、レポートによって所有されている列である必要があります。

ここをクリックしてください。

•	列に「Page」という「リセット位置」が設定されている場合、それをソースとして使用する任意のフィールドは、その列のグループをソースとして使用する繰返し枠の中にある必要があります。さらに、フィールドを参照するボイラープレート・オブジェクトも、列のグループをソースとして使用する繰返し枠によって囲まれている必要があります。

•	フィールドの「ソース」を指定した後、レポートからそのソースを削除した（つまり、サマリー列を作成して、それをフィールドのソースに指定した後そのサマリー列を削除した）場合、フィールドは表示するデータにアクセスできなくなり、「ソース」フィールドにNULLが表示されます。

•	フィールドの「ソース」が「ページ番号」または「パネル番号」、「物理ページ番号」、「総ページ数」、「総パネル数」、「総物理ページ数」の場合、フィールド（フィールド自体またはボイラープレート・オブジェクトのいずれか）を表示するレイアウト・オブジェクトのサイズは、必ず固定にしてください。

•	フィールドは、「ソース」に「サウンド」または「ビデオ」を指定することはできません。


次の表では、「NUMBER」値がフィールドの「ソース」の幅に従ってどのようにフォーマットされるかを示すいくつかの例が挙げられています。

値	ソースの幅	出力結果
9.99999	4	10.0
9.99999	3	10.
9.99999	2	10
9.99999	1	*
-9.99999	4	-10.
-9.99999	3	-10
-9.99999	2	**
400	2	**
4.563	5	4.563
4.563	4	4.56
4.563	3	4.6
0.001	5	.001
0.001	4	.001
0.001	3	.00
0.001	2	.0
0.001	1	.
-0.01	4	-.01
-0.01	3	-.0
-.01	2	-.


図には、論理ページおよび物理ページ、パネルの番号付けの違いが示されています。各領域には複数の論理ページが含まれる可能性があることに注意してください。さらに、各論理ページ内には、複数のパネルが含まれていることがあります。図では、物理ページは、ヘッダー・セクションのページから開始して連続した番号が付けられます。これは、「ページ番号付け」ダイアログ・ボックスで、ヘッダー、ボディおよびトレーラの各セクションを選択したと想定しています。


 この例では、DEPTNOおよびDNAMEは、R_DeptまたはR_Emp内のフィールドの「ソース」にすることができます。ENAMEおよびSALは、R_Emp内のフィールドの「ソース」にしかできません。


式列プロパティ

  制限

ブレーク順序

列のデータ型

コメント

データ型

XML出力から除外

ファイル形式

名前

PL/SQL式

積順序

ファイルからの読込み

ブレーク順序の設定

NULL時の値

幅

XMLタグ

XMLタグ属性


式列の制限

•	プレースホルダ列または式列に設定できるデータ型は、CharacterおよびNumber、Dateです。


枠プロパティ

追加のハイパーリンク属性

アプリケーション・コマンド・ライン（PDF）

基本印刷オン

ブックマーク

コメント

フォーマット・トリガー

レイアウト･セクションの終了

水平拡張度

ハイパーリンク（HTML/PDF）

ハイパーリンクの宛先

アンカー・オブジェクトと連動

名前

後で改ページ

前で改ページ

ページ保護

印刷オブジェクト・オン

後のプリンタ・コード

前のプリンタ・コード

垂直拡張度


グループ・プロパティ

  制限

子ディメンション

コメント

XML出力から除外

フィルタ・タイプ

名前

レコード数

外部XMLタグ

外部XML属性

PL/SQLフィルタ

XMLタグ

XMLタグ属性


グループの制限

•	問合せによって所有されている最下位のグループ以外は、「ブレーク順序」が指定された列を少なくとも1つ含んでいる必要があります。

•	クロス積グループに関するルールは、「マトリックスの制限」を参照してください。


子ディメンション;
子ディメンション

  制限 	  例

説明  子ディメンションは、グループがネストされたマトリックス・データ・モデル内の子ディメンション・グループであるかどうかを示します。どのグループが子ディメンションであるかを識別することにより、マトリックス内の空の行または列（あるいはその両方）を排除します。

値

あり	グループがネストされたマトリックス・レポート内で子ディメンションであることを示します。
いいえ	グループがネストされたマトリックス・レポート内で子ディメンションでないことを示します。
適用対象  1つの問合せのマトリックス・データ・モデル内のクロス積・グループ

必須/オプション  オプション

デフォルト  いいえ

使用上の注意

•	子ディメンションが「いいえ」に設定されると、クロス積グループ内のグループ間の線は点線になります。子ディメンションが「はい」に設定されると、グループとその親の間の線は実線になります。


「いいえ」に設定された子ディメンションの例

  関連項目      [image]  すべての例

次のマトリックスでは、deptno (G_DEPTNO)を含むグループは子ディメンションが「いいえ」に設定されています。値が存在しない場合にすべての行がどのように出力されているかに注意してください。


「はい」に設定された子ディメンションの例

  関連項目      [image]  すべての例

次のマトリックスでは、deptno (G_DEPTNO)を含むグループは子ディメンションが「はい」に設定されています。値が存在する行のみ出力されていることに注意してください。


子ディメンションの制限

•	子ディメンションは、1つの問合せのマトリックス・データ・モデル内のクロス積・グループにのみ有効です。

•	子ディメンションは、データ・モデル内の一番上のグループには無効です。

•	次のデータ・モデル例で、子ディメンションはG_1、G_CrossおよびG_YEARには無効です。G_DEPTNOおよびG_JOBには有効です。


フィルタ・タイプ;
フィルタ・タイプ

  制限 	  例

説明  「フィルタ・タイプ」によって、Report Builderがグループにフェッチされるレコードに対して使用するフィルタ・タイプが指定されます。

値

なし	グループにフィルタを使用していないことを意味します。
最初	取り出された最初のn個のレコードがグループに含まれることを意味する。 nは、「レコード数」プロパティで指定された数値です。
最後	取り出された最後のn個のレコードがグループに含まれることを意味する。 nは、「レコード数」プロパティで指定された数値です。
PL/SQL	グループに組み込むレコードを判別するPL/SQLファンクションが定義される（参照される）ことを意味します。
適用対象  グループ

必須/オプション  オプション

デフォルト  なし


「フィルタ・タイプ」の例

  関連項目 	  すべての例

2つの列（ENAMEおよびSAL）を含む、EMPという名前のグループがあるとします。EMPの親グループはDEPTで、DEPTNOのみが含まれています。DEPTの「フィルタ・タイプ」に「最初」、「レコード数」に3を指定し、EMPの「フィルタ・タイプ」を「最初」、「レコード数」に5を指定します。この場合、Report Builderによって、最初の3つの部門番号が、それぞれ最初の5つの名前および給与とともに取り出されます。


フィルタ・タイプの制限

•	「フィルタ・タイプ」が「最初」または「最後」の場合、対応付けられたフィールドにNUMBER型の正の整数を指定する必要があります。数値のサイズは、最長64Kまでです。

•	クロス積グループには、フィルタを使用することはできません。

•	フィルタによってグループから除外されたレコードは、計算には使用されません。データを計算には使用するがレポートには出力しない場合、フォーマット・トリガーを使用して出力するデータを制限します。


名前

説明  「名前」プロパティは、Report Builderにより現行のグループの識別に使用される名前です。30バイト以内の有効なグループ名を入力します。

適用対象  グループ

必須/オプション  必須

デフォルト  G_queryname。 このquerynameは、問合せの名前で、グループの中で一意の数値です。問合せがデフォルト名（たとえば、Q_1）の場合、デフォルト・グループ名は、G_nです。このnは、レポートのグループ名の中で一意の数値です。グループが問合せに関係付けられていない（つまり、クロス積グループ）場合のデフォルト・グループ名も、G_nです。


コメント

説明  「コメント」プロパティは、グループを説明するテキストを含みます。たとえば、ブレーク・グループの用途を記述しておけば、他の人が見てそのブレーク・グループで何が処理されるかがすぐにわかります。64KB以下のテキストを入力します。

適用対象  グループ

必須/オプション  オプション

デフォルト  ブランク


レコード数;
レコード数

説明  「レコード数」プロパティは、「フィルタ・タイプ」が「最初」または「最後」に設定されている場合に、グループに組み込むレコードの数です。たとえば、「フィルタ・タイプ」が「最初」、「レコード数」が20に設定されている場合、取り出された最初の20レコードがグループに組み込まれます。

値  長さが64K以下の、正の整数を入力します。

適用対象  グループ

必須/オプション  「フィルタ・タイプ」プロパティが「最初」または「最後」に設定されている場合、必須。

デフォルト  0


PL/SQLフィルタ

  関連項目

説明  「PL/SQLフィルタ」プロパティは、PL/SQLエディタを表示するボタンです。 エディタは、グループに組み込むレコードを判別する際のPL/SQLファンクションを入力できます。

適用対象  グループ

必須/オプション  「フィルタ・タイプ」プロパティが「PL/SQL」に設定されている場合は必須。


データ・リンク・プロパティ

  制限      [image]  例

子列

子問合せ

条件

親列

親グループ

SQL句


WHERE句のリンク例

  関連項目 	  すべての例

次の2つの問合せによって、マスター/ディテール・レポートを作成するとします。

Q_1:   SELECT DISTINCT ENAME, EMPNO
FROM EMP
WHERE JOB = 'SALESMAN'

Q_2:   SELECT REPID, AMOUNT
FROM SALES
ORDER BY REPID

この2つの問合せを結合するには、プロパティ・パレットが次のように設定されたリンクを作成します。

SQL句	親列	条件	子列
WHERE	EMPNO	=	REPID
これによって、次のような1つの問合せを作成した場合と同様のリンクが作成されます。

SELECT DISTINCT ENAME, EMPNO, REPID, AMOUNT
FROM EMP, SALES
WHERE EMPNO = REPID (+) AND JOB = 'SALESMAN'
ORDER BY REPID

ヒント

表スタイルを使用すると、次の図のような出力になります。

Ename        Empno   Repid        Amount

-----------  ------  ------  ------------

ALLEN         7499    7499          3000

                      7499           810

                      7499           847

                      7499            24

                      7499          1500

                      7499           340

                      7499           240

                      7499           400

                      7499           180

                      7499           280

                      7499           250

MARTIN        7654    7654         16569

                      7654          2301

                      7654          3306

                      7654          5600

TURNER        7844    7844           350

                      7844           485

                      7844           293

                      7844            50

                      7844          1703


「START WITH」を使用したリンクの例

  関連項目 	  すべての例

管理階級の役職順に従業員をリストしたレポートを作成するとします。次のような問合せを使用することができます。

Q_1:   SELECT EMPNO FROM EMP
WHERE JOB = 'MANAGER'

Q_2:   SELECT  ENAME, JOB, EMPNO, MGR, LEVEL
FROM EMP
CONNECT BY PRIOR EMPNO = MGR

この2つの問合せを結合するには、プロパティ・パレットが次のように設定されたリンクを作成します。

SQL句	親列	条件	子列
START WITH	EMPNO	=	EMPNO1
デフォルト・レイアウトの表スタイルを使用すると、次の図のような出力になります。

 Empno  Ename       Job        Empno1     Mgr     Level

------  ----------   ---------   ------  ------  --------

  7566  JONES       MANAGER      7566    7839         1

        SCOTT       ANALYST      7788    7566         2

        ADAMS       CLERK        7876    7788         3

        FORD        ANALYST      7902    7566         2

        SMITH       CLERK        7369    7902         3

  7698  BLAKE       MANAGER      7698    7839         1

        ALLEN       SALESMAN     7499    7698         2

        WARD        SALESMAN     7521    7698         2

        MARTIN      SALESMAN     7654    7698         2

        TURNER      SALESMAN     7844    7698         2

        JAMES       CLERK        7900    7698         2

  7782  CLARK       MANAGER      7782    7839         1

        MILLER      CLERK        7934    7782         2


データ・リンクの制限

•	列を指定してリンクを作成する場合、親と子両方の列を持っており、それらの列が互換性のあるデータ型であることが必要です。たとえば、親列が文字データ型（たとえば、VARCHAR）の場合、子列も文字データ型（たとえば、CHAR）であることが必要です。


1つの問合せを使用した場合、ENAMEおよびEMPNOのブレーク・グループを作成してください。


子列;
子列

 制限

説明  「子列」プロパティは、親グループ内の列（つまり、親列）に関連する子問合せで使用される列の名前です。「子列」は、データベースの列であることが必要です。サマリーまたは式にすることはできません。また、字句参照に依存することもできません（「子列の制限」を参照してください）。

適用対象  リンク


「子列」の制限

•	Report Builderのリンクは、字句参照に依存してはいけません。つまり、リンクの子列または表名のどちらも、字句参照によって判別してはいけません。この機能を達成するには、列を指定しないでリンクを作成し、そのリンクに対するSQL句（WHEREなど）を問合せに直接入力する必要があります。たとえば、親および子問合せを次のように書きます。

Parent Query:  SELECT DEPTNO FROM EMP
Child Query:   SELECT &PARM_1 COL_1, &PARM2
               COL_2
               FROM EMP
               WHERE &PARM_1 = :DEPTNO

親問合せで選択されたDEPTNOへのバインド参照が、WHERE句でどのように作成されるかに注意してください。また、この例では、列を指定しない状態で、データ・モデル内で問合せ間のリンクをすでに作成していることが想定されています。


子問合せ;
子問合せ

  制限

説明  「子問合せ」プロパティは、データ・モデルでのリンク作成時に子として定義された問合せの名前です。このフィールドは、読込み専用です。

適用対象  リンク


「子問合せ」の制限

•	「子問合せ」は、「親グループ」を1つのみ保有できます。1つの子に対して複数の親を定義することはできません。


条件

説明  「条件」プロパティは、「親列」と「子列」のリレーションを定義するSQL演算子です。SQL演算子の詳細は、『Oracle8 Server SQLリファレンス』を参照してください。

値

=	（等価）
<	（より小さい）
<=	（以下）
<>	（等しくない）
>	（より大きい）
>=	（以上）
Like	1つの列の値がその他の列のパターンと一致する場合に、条件が真であることです。パターンには、ワイルドカード文字としてパーセント記号（%）およびアンダースコア（_）を含むことができます。
Not Like	1つの列の値がその他の列のパターンと一致しない場合に、条件が真であることです。パターンには、ワイルドカード文字としてパーセント記号（%）およびアンダースコア（_）を含むことができます。
適用対象  リンク

必須/オプション  「親列」が指定されている場合、必須。

デフォルト  = （等価符号）


親列

説明  「親列」プロパティは、子問合せ内の列（つまり、子列）に関連する親問合せで使用される列です。「親列」には、親グループ内のデータベースの列またはサマリー列、式列を指定できます。「親列」がサマリー列または式列の場合、子問合せによって所有される列に直接的にも間接的にも依存できません。このフィールドは、読込み専用です。

適用対象  リンク


親グループ

 制限

説明  「親グループ」プロパティは、データ・モデルでのリンク作成時に親として定義されたグループの名前です。このフィールドは、読込み専用です。

適用対象  リンク

使用上の注意

•	リンク先の列を指定しなくても、親グループから子問合せへのリンクを作成できます。これによって、2つのオブジェクト間のリレーションを作成できます。しかし、すべてのディテール・レコードが親グループの各マスター・レコードについて表示されます。


「親グループ」の制限

•	「親グループ」は、上位項目の1つとして「子問合せ」を持つことはできません。つまり、リンクは循環依存（つまり、子問合せが親グループに依存し、親グループは子問合せに依存する状況）できません。


SQL句

説明  「SQL句」プロパティは、子問合せに対して親グループを関係付ける句のタイプです。詳細は、『Oracle8 Server SQLリファレンス』を参照してください。

値

HAVING

START WITH

WHERE

適用対象  リンク

必須/オプション  「親列」が指定されている場合、必須。

デフォルト  WHERE

使用上の注意

•	「SQL句」が「START WITH」の場合、子問合せのSELECT文には、CONNECT BY句が含まれている必要があります（このプロパティに含まれているため、START WITH句は不要です）。同様に、「SQL句」が「HAVING」の場合、子問合せのSELECT文には、GROUP BY句が含まれている必要があります（このプロパティに含まれているため、HAVING句は不要です）。


?


マトリックス・プロパティ

  制限      [image]  例

追加のハイパーリンク属性

アプリケーション・コマンド・ライン（PDF）

ブックマーク

コメント

クロス積グループ

水平繰返し枠

ハイパーリンク（HTML/PDF）

ハイパーリンクの宛先

名前

垂直繰返し枠


クロス積グループ

説明  「クロス積グループ」プロパティは、「水平繰返し枠」および「垂直繰返し枠」のソース・グループを含むグループです。クロス積グループによって、1つのグループの中または複数のグループ間で互いに値が関係付けられて、マトリックス内のデータが作成されます。

値  有効なクロス積グループの名前を入力します。

適用対象  マトリックス

必須/オプション  必須

デフォルト  ブランク


マトリックスの例

  関連項目 	  すべての例

データベースの列DEPTNOから値を取得するC_DEPTNOという列が含まれる、Group1という名前のグループがあるとします。Group2というグループには、データベースの列JOBから値を取得する列C_JOB、およびGroup1の問合せへのリンクに使用される列C_DEPTNO1が含まれています。Group3というグループには、データベースの列SALの合計であるSUMSALという列が含まれています。

                           Job

             Analyst      Clerk        Manager

      10                  $1300        $2450

Dept  20     $6000        $1900        $2975

      30                  $ 950        $2850

この例では、次のようになっています。

•	「垂直繰返し枠」は、Group1（部門番号）を含む繰返し枠です。

•	「水平繰返し枠」は、Group2（ジョブ・タイトル）を含む繰返し枠です。

•	「クロス積グループ」は、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


マトリックスの制限

•	マトリックス内では、縦方向への繰返し枠は横方向の繰返し枠の下にあることが必要です。

•	マトリックス・オブジェクトは、必ず、マトリックスを形成する繰返し枠の一番上にあることが必要です（つまり、マトリックスは、水平繰返し枠および垂直繰返し枠よりも上のレイヤーに存在する必要があります）。Report Builderでは、マトリックスを水平繰返し枠および垂直繰返し枠より下に移動できません。

•	マトリックスを移動すると、その2つの繰返し枠も移動します。

•	マトリックス・オブジェクトを他のオブジェクトにアンカーしたり、また、他のオブジェクトをマトリックス・オブジェクトにアンカーできません（つまり、マトリックス・オブジェクトは、あるアンカーについて親オブジェクトになることも子オブジェクトになることもできません）。

•	マトリックスをコピーするには、そのマトリックスおよびその2つの繰返し枠を選択してください。マトリックスのみを選択した場合は、ペースト・バッファには何もコピーされません。マトリックスと一方の繰返し枠を選択した場合は、その繰返し枠のみがペースト・バッファにコピーされます。

•	マトリックス・オブジェクトのサイズを変更するには、関係付けられた繰返し枠のサイズを変更するしかありません。

•	「配置」メニューの「オブジェクト整列」、「オブジェクト・サイズ設定」をマトリックス・オブジェクトに対して使用することはできません。

•	マトリックスの列および行を構成する繰返し枠のソース・グループは、同じクロス積グループから取得される必要があります。

•	ソース・グループが同じ「系列」の階層に属する（つまり、相互に上位項目または下位項目である）繰返し枠の「印刷方向」は同じにしてください。マトリックス内でネストを作成する場合、クロス積グループ内の親子リレーションが使用されます。その結果、そのようなグループと関係付けられた繰返し枠は、ページ上で同じ方向に印刷されることが必要です。

•	他のオブジェクトと同様に、マトリックス・オブジェクトに対しても境界線を書くことができます。 しかし、幅は必ず最小幅になります。マトリックス・レイアウト内ではオブジェクトの間が狭いため、境界線を太くすることはできません。


水平繰返し枠

  制限

説明  「水平繰返し枠」プロパティは、列のヘッダーおよびサマリーの作成、およびマトリックスのクロス積の計算に使用される値を持つ繰返し枠です。

値  有効な繰返し枠名を入力します。

適用対象  マトリックス

必須/オプション  必須

デフォルト  ブランク


「水平繰返し枠」および「垂直繰返し枠」の制限

•	「水平繰返し枠」プロパティおよび「垂直繰返し枠」プロパティに指定された繰返し枠のソース・グループは、同じクロス積グループ内にあることが必要です。


垂直繰返し枠

  制限

説明  「垂直繰返し枠」プロパティは、行のヘッダーおよびサマリーの作成、およびマトリックスのクロス積の計算に使用される値を持つ繰返し枠です。

値  有効な繰返し枠名を入力します。

適用対象  マトリックス

必須/オプション  必須

デフォルト  ブランク


?


データベース列オブジェクト・プロパティ

コメント

列のデータ型

データ型

名前


OLE2プロパティ

追加のハイパーリンク属性

アプリケーション・コマンド・ライン（PDF）

基本印刷オン

ブックマーク

コメント

フォーマット・トリガー

水平拡張度

ハイパーリンク（HTML/PDF）

ハイパーリンクの宛先

アンカー・オブジェクトと連動

名前

後で改ページ

前で改ページ

ページ保護

印刷オブジェクト・オン

後のプリンタ・コード

前のプリンタ・コード

垂直拡張度


?


パラメータ・プロパティ

追加

追加の属性（HTML）

コメント

データ型

第1列を隠す

初期値

入力マスク

値リスト

名前

削除

事前定義済み値に対するリストを制限

SELECT文/スタティック値

妥当性チェック・トリガー

値

幅


システム・パラメータ

BACKGROUND	レポートをフォアグラウンドとバックグラウンドのどちらで実行するかを設定します。
COPIES	レポートの印刷時に、レポートを印刷する部数を指定します。
CURRENCY	通貨インジケータの記号（たとえば、ドル記号「$」）。
DECIMAL	小数点の記号（たとえば、ピリオド「.」）。
DESFORMAT	出力デバイスの形式（たとえば、プリンタのLandscapeモード）を定義します。このパラメータは、レポートをキャラクタ・モード環境で実行する場合およびビットマップ・レポートをファイル送信する（たとえば、PDFまたはHTML出力を作成する）場合に使用されます。
DESNAME	出力デバイスの名前（たとえば、ファイル名、プリンタ名、メール・ユーザーID）です。
DESTYPE	レポート出力の送信先となるデバイスのタイプ（screenまたはfile、mail、printer、preview）。
MODE	レポートをキャラクタ・モードとビットマップのどちらで実行するかを設定します。
ORIENTATION	レポートの印刷方向（Landscape、Portrait、デフォルト）。
PRINTJOB	レポート実行前に「印刷ジョブ」ダイアログ・ボックスを表示するかどうかを指定します。
THOUSANDS	3桁区切り文字の記号（たとえば、カンマ「,」）。


追加

説明  「追加」ボタンを押すと、「値」フィールドの値がスタティック値としてリストに追加されます。

適用対象  パラメータ

必須/オプション  スタティック値を追加する場合、必須。


追加の属性（HTML）

  例	  関連項目

説明  「追加の属性（HTML）」プロパティには、JavaScriptイベント・ハンドラが含まれます。これにより、Webを介してレポートが実行されている場合、さまざまな入力のトリガーまたはイベントの選択（たとえば、無効な入力に対するエラー・メッセージの表示または入力値のフォーマット）をランタイム・パラメータ・フォームで行います。

値  有効なJavaScriptイベント・ハンドラ

適用対象  パラメータ・フォーム・フィールド

デフォルト  ブランク


コメント

説明  「コメント」プロパティは、パラメータを説明するテキストを含みます。たとえば、パラメータの用途を記述しておけば、他の人が見てそのパラメータで何が処理されるかがすぐにわかります。64KB以下のテキストを入力します。

適用対象  パラメータ

必須/オプション  オプション

デフォルト  ブランク


データ型

  制限

説明  「データ型」プロパティは、パラメータの値（たとえば、数値）の型を示します。

値

Character

Date

Number

適用対象  パラメータ

必須/オプション  必須

デフォルト  Character


データ型の制限

•	パラメータに入力する値は、実行時でも必ずパラメータの「データ型」に一致する必要があります。

•	「データ型」には、パッケージ・パラメータ（たとえば、DESTYPE）を指定できません。

•	文字データ型のパラメータは、明示的にSQL文に埋め込まない限り、埋め込まれません。


第1列を隠す

  例

説明  「第1列を隠す」プロパティは、パラメータの値リストに選択リストの第1列を表示するかどうかを示すチェックボックスです。この設定は、ユーザーが知らない値または知られたくない値を隠す場合に便利です。

適用対象  パラメータ

デフォルト  チェックあり


第1列を隠す場合の例

  関連項目 	  すべての例

実行時にユーザーが部門を指定して、従業員をリストするレポートを作成するとします。この場合に使用する表には、プライマリ・キーまたは外部キーとしてDEPTNOがあります。このレポートのユーザーは、部門番号を知りません。ユーザーが知っているのは、部門名のみです。レポートの問合せは、次のようになります。

SELECT * FROM EMP
WHERE DEPTNO = :MYDEPT

「パラメータ」プロパティ・シートの「データ/選択」タブでは、「SELECT文」を選択して値リストに次のSQL文を入力します。

SELECT DEPTNO, DNAME FROM DEPT

その後、「第1列を隠す」をチェックします。これによって、DEPTNOは、レポート実行時に値リストに表示されません。DNAMEのみが表示されます。ユーザーがリストからDNAMEの値を選択すると、それに対応するDEPTNOの値がパラメータMYDEPTに使用されます。


初期値

  制限

説明  「初期値」プロパティには、パラメータのデフォルト値を指定します。コマンド・ラインまたはランタイム・パラメータ・フォームで上書きしなければ、この値が使用されます。そのパラメータの「データ型」に合う値を入力します。「初期値」の最大長は、1Kバイトです。「初期値」をブランクのままにした場合、そのパラメータのデフォルト値はありません。

適用対象  パラメータ

必須/オプション  オプション

デフォルト  DESTYPEの場合、「Preview」。DESFORMATの場合、「dflt」。COPIESの場合、「1」。その他のパラメータの場合、ブランク。


初期値の制限

•	「初期値」は、パラメータの「データ型」および「幅」によって妥当性チェックが行われます。また、次のように、「初期値」は書式マスクに対しても妥当性チェックが行われます。

•	あるデータに初期値を指定すると、「書式マスク」に設定されたマスクが使用されます。

•	「書式マスク」がブランクで値が日付である場合、Report Builderの内部マスク（たとえば、DD-MON-YY）が使用されます（数字や文字の値については、「書式マスク」を指定しない限り妥当性チェックは行われません）。

•	値を指定せず、パラメータがSQLまたはPL/SQLで参照される場合、SQLまたはPL/SQLの解析にはNULLが使用されます。NULLによって、SQLまたはPL/SQL構成体が正しく解析されない場合、エラーが発生します。


入力マスク

  制限

説明  「入力マスク」プロパティは、コマンド・ラインまたはランタイム・パラメータ・フォームで入力されたパラメータの値についてReport Builderが妥当性チェックに使用する書式マスクです。パラメータの「初期値」の妥当性チェックにも使用されます。128バイト以下の有効な書式マスクを入力するか、リストから値を選択します。

適用対象  パラメータ

必須/オプション  オプション

デフォルト  ブランク。つまり、「データ型」が「Date」の場合、「入力マスク」は、ご使用の言語のデフォルト値（たとえば、アメリカならばデフォルトは「DD-MON-YY」）になり、「データ型」が「Number」の場合、「入力マスク」は-9999になります。


入力マスクの制限

•	最初に「入力マスク」の値リストに表示される値は、パラメータのデータ型によって決まります（たとえば、パラメータの「データ型」が「Number」の場合、リストには数値マスクのみが表示されます）。新しい書式マスクを入力してプロパティ・シートを確定した場合、新しい値がリストに表示されます。しかし、これらの書式マスクが有効なのは、現行のReport Builderセッション中のみです。Report Builderを終了して再起動すると、値リストには、前回のReport Builderセッションで作成した書式マスクは含まれていません（これらのマスクが使用されたレポートをオープンしない場合）。リストに追加した書式マスクが複数セッション間で保存されるようにするには、「作業環境」ダイアログの「マスク編集」ボタンを使用します。

•	「入力マスク」プロパティは、「データ型」が「Character」に設定されたパラメータには適用されません。


削除

説明  「削除」ボタンは、スタティック値リストから選択された値を削除します。

適用対象  パラメータ

必須/オプション  スタティック値を削除する場合、必須。


事前定義済み値に対するリストを制限

説明  「事前定義済み値に対するリストを制限」は、パラメータの値を値リストに含むかどうかを示すチェックボックスです。たとえば、「事前定義済み値に対するリストを制限」をチェックして、「初期値」が値リストの値に一致しない場合、「パラメータ」プロパティ・シートの確定時にエラーが発生します。同様に、コマンド・ラインまたはコマンド・スクリプトに指定したパラメータが値リストの値に一致しない場合、レポート実行時にエラーが発生します。「事前定義済み値に対するリストを制限」をチェックした場合、値リストがランタイム・パラメータ・フォームに表示されます。このパラメータをチェックしない場合は、コンボ・ボックスが表示されます（つまり、リストから選択することも、値を入力することもできます）。

適用対象  パラメータ

デフォルト  チェックあり


SELECT文/スタティック値

説明  「SELECT文/スタティック値」プロパティは、パラメータの値リストへの挿入に、SELECT（SQL問合せ）文とスタティック・リストのどちらを使用するかを示すラジオ・ボタンです。

値

SELECT文	パラメータの値リストに挿入するためにSELECT文を入力することを示します。このオプションを選択した場合、「SELECT文」ラジオ・ボタンの下の領域にSELECT文を入力する必要があります。
スタティック値	パラメータの値リストに挿入するために自分で値を入力することを示します。このオプションを選択した場合、自分で値を入力して値リストを作成してください。この場合、「値」フィールドに値を入力して、「追加」ボタンを選択します。リストに載せる値すべてについてこの処理を行います。値を削除するには、削除する値をリストから選択して「削除」ボタンを選択します。
適用対象  パラメータ

必須/オプション  必須


有効化トリガー

  関連項目

説明  「有効化トリガー」プロパティは、妥当性チェックをするPL/SQLの入力および（必要があれば）パラメータの修正が可能なPL/SQLエディタを表示するボタンです。

適用対象  パラメータ


値

説明  「値」プロパティは、「追加」ボタンを選択したときに、パラメータ値のスタティック・リストに追加される値です。パラメータに有効な値を入力して「追加」ボタンを選択し、スタティック値リストにその値を追加します。

適用対象  パラメータ

必須/オプション  スタティック・リストに値を追加する場合、必須。


幅

  制限

説明  「幅」プロパティは、コマンド・ラインまたはランタイム・パラメータ・フォームに入力するパラメータ値の最大文字数です。1～64000の数を入力します。

適用対象  パラメータ

必須/オプション  必須

デフォルト  40文字


幅の制限

•	実行時に入力されたパラメータ値が「幅」より長い場合、Report Builderによって値が切り捨てられます。

•	「幅」には、パッケージ・パラメータ（たとえば、DESNAME）を指定できません。


値リスト

追加

第1列を隠す

削除

事前定義済み値に対するリストを制限

SELECT文/スタティック値

値


?


パラメータ・フォーム・ボイラープレート・プロパティ

コメント

名前

型


名前

説明  「名前」プロパティは、Report Builderが現行のボイラープレートの識別に使用する名前です。

値  有効なパラメータ・フォーム・ボイラープレート名を入力してください。

適用対象  パラメータ・フォーム・ボイラープレート

必須/オプション  必須

デフォルト  PB_n。 このnは、レポートのパラメータ・フォーム・ボイラープレート名の中で一意の数値です。


型

説明  「型」プロパティには、ボイラープレート・オブジェクトの書式（たとえば、テキスト）が表示されます。このフィールドは、読込み専用です。


?


パラメータ・フォーム・フィールド・プロパティ

コメント

データ型

名前

ソース


データ型;
データ型

説明  「データ型」プロパティは、パラメータ・フォーム・フィールドの「ソース」のデータ型を表示するフィールドです。


名前;
名前

説明  「名前」プロパティは、Report Builderが現行のフィールドの識別に使用する名前です。

値  有効なパラメータ・フォーム・フィールド名を入力します。

適用対象  パラメータ・フォーム・フィールド

必須/オプション  必須

デフォルト  PF_n。このnは、レポートのパラメータ・フォーム・フィールド名の中で一意の数値です。


ソース;
ソース

  制限

説明  「ソース」プロパティは、パラメータ・フォーム・フィールドの値を持つパラメータです。この値リストには、レポート内のすべてのパラメータが含まれています。

値  有効なパラメータ名を入力します。

適用対象  パラメータ・フォーム・フィールド

必須/オプション  必須

デフォルト  ブランク


ソースの制限

•	パラメータ・フォーム・フィールドの「ソース」は、データ・モデル・パラメータであることが必要です。

•	1つの「ソース」に対して複数のパラメータ・フォーム・フィールドを指定できません。


?


プレースホルダ列プロパティ

 例	  制限

ブレーク順序

列タイプ

コメント

データ型

ファイル形式

名前

PL/SQL式

積順序

ファイルからの読込み

ブレーク順序の設定

NULL時の値

幅


特殊な集計計算のプレースホルダの例

各部門の最も給与の高い従業員をリストしたマスター/ディテール・レポートを作成するとします。たとえば、次のような出力結果が得られます。

Dname ACCOUNTING      Loc NEW YORK      Highest Paid

                                        Employee(s):

  Ename       Job              Sal

  ----------  ---------  ---------

  CLARK       MANAGER      2450.00      KING

  KING        PRESIDENT    5000.00

  MILLER      CLERK        1300.00

Dname RESEARCH        Loc DALLAS        Highest Paid

                                        Employee(s):

  Ename       Job              Sal

  ----------  ---------  ---------

  SMITH       CLERK         800.00      SCOTT and FORD

  JONES       MANAGER      2975.00

  SCOTT       ANALYST      3000.00

  ADAMS       CLERK        1100.00

  FORD        ANALYST      3000.00

給与の最も高い従業員の名前を取得するには、データ型が「Character」に設定されたHIGHEST_PAID_EMPというプレースホルダ列を作成します。HIGHEST_PAID_EMPの値は、データ型が「Character」に設定されたSET_HIGHEST_PAID_EMPという式列によって設定されます。R_COUNTは、「カウント」ファンクションによるサマリー列です。SET_HIGHEST_PAID_EMPは、式に次のPL/SQL関数を含んでいます。

function set_plch_high_emp return character is
begin
   /* Check if we are at first record in child, if so,
      then reset placeholder  */
   if (:r_count <= 1) then
     :highest_paid_emp := ' ';
   end if;
   /* Does this child record compare to the max sal
      for the dept ?  If yes, and placeholder already
      set (i.e.we have more than one max sal) set the
      placeholder to the concatenated string.Else
      set the placeholder to the employee's name  */
   if (:sal = :max_dept_sal) then
     if (:highest_paid_emp <> ' ') then
       :highest_paid_emp := :highest_paid_emp||' and '
       ||:ename;
     else
       :highest_paid_emp := :ename;
     end if;
   end if;
   return (:highest_paid_emp);
  end;


プレースホルダ列の制限

•	プレースホルダ列または式列に設定できるデータ型は、Character、NumberおよびDateです。

•	プレースホルダ列の値を割り当てることができるのは、1つのグループのみです。複数のグループにプレースホルダ列の値を割り当てることはできません。


PL/SQL式

  関連項目

説明  「PL/SQL式」プロパティは、式の入力が可能なPL/SQLエディタを表示するボタンです。

適用対象  式列およびプレースホルダ列


?


プロパティ・リスト

追加

追加の属性（HTML）

追加のハイパーリンク属性

「フォーム後型」

「フォーム後値」

「ページ後型」

「ページ後値」

「レポート後型」

「レポート後値」

サマリーをフィールドの位置に合わす

整列

アプリケーション・コマンド・ライン（PDF）

バックグラウンド・カラー

基本印刷オン

「フォーム前型」

「フォーム前値」

「ページ前型」

「ページ前値」

「レポート前型」

「レポート前値」

フィールドとラベル間（水平）

枠とフィールド間（水平）

枠とフィールド間（垂直）

マスターとディテール間（水平）

マスターとディテール間（垂直）

ページと枠間（水平）

ページと枠間（垂直）

同等枠間（水平）

同等枠間（垂直）

ブックマーク

境界線

ブレーク順序

文字揃え

チャート列

チャート・ファイル名

チャート･ハイパーリンク

チャート・パラメータ

チャート問合せ

子列

子の枠の割合（%）

子の枠の種類

子オブジェクト名

子問合せ

水平方向に縮小

垂直方向に縮小

列モード

列タイプ

コメント

計算位置

条件

条件付き書式

XMLタグを含む

クロス積グループ

破線

データ型（列）

データ型（パラメータ）

データ型（パラメータ・フォーム・フィールド）

日付揃え

キャラクタ単位で設計

方向

配布（セクション）

配布（レポート）

ホスト・メニュー項目を使用不可にする

画面分割キーを使用不可にする

ズーム・キーを使用不可にする

表示名

枠のバックグラウンド・カラー

枠のフォアグラウンド・カラー

枠のパターン

XML出力から除外

外部問合せソース・ファイル

行当りのフィールド数

ファイル形式

塗りパターン

フォント

フォアグラウンド・カラー

フィルタ・タイプ

書式マスク

フォーマット・トリガー

ファンクション

高さ（パラメータ・フォーム・ウィンドウ）

高さ（セクションの物理ページ）

第1列を隠す

枠間の水平間隔

水平拡張度

ページ当りの水平パネル

水平繰返し枠

ハイパーリンク（HTML/PDF）

ハイパーリンクの宛先

アイコン名

イメージ

ビットマップ・オブジェクトを含む

境界線を含む

初期値

入力マスク

フィールド間（水平）

フィールド間（垂直）

枠間（水平）

枠間（垂直）

位置揃え

アンカー・オブジェクトと連動

ラベルの型

枠付きの行伸長

値リスト

最大水平ボディ・ページ

最大垂直ボディ・ページ

ページ当りの最大レコード数

最大取出し行

最小孤立行

最小孤立レコード数

マルチメディア列の型

マルチメディア列

マルチメディア・ファイル・タイプ

マルチメディア・ファイル

名前

ページ数

レコード数

数値揃え

方向

外部XMLタグ

外部XMLタグ属性

後で改ページ

前で改ページ

ページ・ナビゲーション・コントロール・タイプ

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

ページ番号付け

ページ保護

パネル印刷順序

親列

親の枠の割合（%）

親の枠の種類

親グループ

親オブジェクト名

PL/SQLフィルタ

PL/SQL式（式およびプレースホルダ列）

PL/SQL文

PL/SQLトリガー

フィールドの上にラベルを置く

プレビューアのヒント行のテキスト

プレビューアのステータス行のテキスト

印刷方向

印刷オブジェクト・オン

後のプリンタ・コード

前のプリンタ・コード

積順序

ファイルからの読込み

削除

レポート列（チャート列）

レポート列（チャート・パラメータ）

レポート・グループ

レポート高

レポート幅

リセット位置

ロール名

事前定義済み値に対するリストを制限

SELECT文/スタティック値リスト

ブレーク順序の設定

ソース・データ型

ソース・ファイルの形式

ソース・ファイル名

ソース（サマリー列）

ソース（繰返し枠）

ソース（パラメータ・フォーム・フィールド）

ソース（フィールド）

SQL句

SQL問合せ文

ズームで起動

スタイル

プレビューア・タイトルの抑止

テキスト（ボタン）

テキスト（テンプレート）

文字色

タイトル

型（ボイラープレート）

型（ボタン）

型（問合せ）

サイズの単位

プレビューアのヒント行を使用

プレビューアのステータス行を使用

垂直間隔の使用

妥当性チェック・トリガー

NULL時の値

値

枠間の垂直間隔

垂直拡張度

ページ当りの垂直パネル

垂直繰返し枠

可視

幅（列）

幅（パラメータ）

幅（パラメータ・フォーム・ウィンドウ）

幅（セクションの物理ページ）

XML Prologタイプ

XML Prolog値

XMLタグ

XMLタグ属性


この文字で始まるプロパティはありません。


問合せプロパティ

コメント

外部問合せソース・ファイル

最大取出し行

名前

SQL問合せ文

型


コメント

説明  「コメント」プロパティには、問合せを説明するテキストが含まれます。たとえば、問合せの用途を記述しておけば、他の人が見てその問合せで何が処理されるかがすぐにわかります。64KB以下のテキストを入力します。

適用  問合せ

必須/オプション  オプション

デフォルト  ブランク

使用上の注意

•	Oracleの標準SQLコメント・デリミタ（たとえば、/* comment */）を使用して、SQLのSELECT文に直接コメントを挿入することもできます。詳細は、『Oracle8 Server SQLリファレンス』を参照してください。


外部問合せソース・ファイル

説明  「外部問合せソース・ファイル」プロパティは、データベース、または現行の問合せのSELECT文として使用する必要のあるSELECT文を持つファイルに格納された問合せの名前です。1KB以内の有効な外部問合せソース・ファイル名を入力します。参照する外部問合せソース・ファイルの長さは、32KB以内である必要があります。32KBを超えると、ファイルは切り捨てられ、警告が出されます。その問合せがファイルに格納されている場合は、問合せ名の前にパスをつけることができます。ファイル名の前にパスが指定されていない場合は、Report Builderのファイル・パス検索順序に従って、ファイルが検索されます。問合せがデータベースに格納されている場合、格納場所を示すために問合せの前に「DB:」を付けます。たとえば、次のように指定します。

DB:myquery

問合せ名に接頭辞「DB:」を付けると、Report Builderによって直接データベースがアクセスされ、問合せが検索されます。データベースに接続されていない場合、問合せを見つけられず、その結果を知らせるメッセージが発行されます。

注意: レポートの移植性を確保するには、REPORTS60_PATHという環境変数を使用します。この変数を使用して、レポート内で使用される外部ファイル（外部問合せ、ボイラープレート、PL/SQLなど）を検索するためのデフォルト・ディレクトリを指定できます。これによって、レポートにディレクトリ・パスをハードコードする必要がなくなります。

適用  問合せ

必須/オプション  オプション

デフォルト  ブランク

使用上の注意

•	このフィールドから参照される外部問合せソース・ファイルのSELECT文についての妥当性チェックは、この問合せのプロパティ・シートの確定時に行われます。

•	外部問合せソース・ファイルを更新する場合、更新によってレポート定義が無効になることがないようにすることが必要です。たとえば、レポートにDEPTNO用の列があり、外部問合せソース・ファイルの選択リストからDEPTNOを削除する場合、レポートを実行できません。

•	外部問合せソース・ファイル名を指定した場合、外部問合せのSELECT文が「SQL問合せ文」フィールドに読込み専用として表示されます。SELECT文を変更する場合は、外部問合せソース・ファイルをオープンしてください。


最大取出し行

説明  「最大取出し行」プロパティは、問合せで取り出すことができるデータの最大行数です。Report Builderによって、このプロパティで指定した行数のみが問合せで取り出されます。レポートを設計している場合、どのようなレイアウトになるかを見るために何度もReoprt Builderを実行する必要があります。レポートで多数のデータを取り出す場合、この作業にはかなりの時間がかかってしまいます。このプロパティの指定により、取り出されてフォーマットされるデータ量を減らせば、パフォーマンスが改善されます。

値  取り出される行数を、1～32,000の正の数で指定。ブランクのままにすると、すべての行が取り出されます。

すべての問合せグループではなく、一部の問合せグループによって行が読み込まれるように制限する場合は、「グループ」プロパティ・シートの「フィルタ」を使用します。

適用  問合せ

必須/オプション  オプション

デフォルト  ブランク

使用上の注意

•	最大行数を超えたために取り出されなかった行は、Report Builder固有の計算では使用されません。たとえば、子問合せで「最大取出し行」を5に設定した場合、その親グループに含まれる子のサマリーには、その問合せによって取り出される5レコードのみが使用されます。データを計算には使用するがレポートには出力しない場合、「フォーマット・トリガー」を使用して出力するデータを制限します。

PL/SQL PL/SQLで出力するデータを制限するには、SRW.SET MAXROWプロシージャを使用します。


名前

説明  「名前」プロパティは、Report Builderによって現行の問合せの参照に使用される名前です。30バイト以内の有効な名前を入力します。

適用  問合せ

必須/オプション  必須

デフォルト  Q_n。このnは、レポートの問合せ名の中で一意の数値です。


SQL問合せ文

  制限      [image]  例

説明  「SQL問合せ文」プロパティは、データベースからレポートにデータを取り出すSQLのSELECT文です。64K以内の有効なSELECT文を入力します。この上限は、オペレーティング・システムによって異なります。SELECT文の機能は、INTO句およびFOR UPDATE句を除いて、すべてサポートされています。SELECT文の作成には、次の作業を行います。

•	「表/列」ダイアログ・ボックスを使用

•	コメントを挿入

•	バインド参照および字句参照を挿入

•	SQLエラーのチェック

適用  問合せ

必須/オプション  必須


SQL問合せ文の例

  関連項目 	  すべての例

次にSELECT文の例を示します。

SELECT O.CUSTID, P.DESCRIP, I.ITEMTOT, O.ORDERDATE,
   I.ORDID
FROM ORD O, PRODUCT P, ITEM I
WHERE O.ORDID = I.ORDID AND
   I.PRODID = P.PRODID
ORDER BY O.CUSTID, P.PRODID, O.ORDERDATE
/* For each customer, show the products they bought */
/* (DESCRIP), the amount they spent on that product */
/* (ITEMTOT), the date they ordered the product */
/* (ORDERDATE),and the order id (ITEM.ORDID) of the */
/* order in which they bought the product. */


バインド参照および字句参照を含むSQL問合せ文の例

  関連項目 	  すべての例

次に、バインド参照および字句参照を使用するSELECT文の例を示します。

SELECT CUSTID, SUM(TOTAL) TOTAL
FROM &FROMGROUP
HAVING SUM(TOTAL) > :MINTOTAL

この場合:

&FROMGROUP	ORD GROUP BYCUSTID （または、実行時に入力するその他の値）です。この場合、指定された「初期値」を持つFROMGROUPという名前のパラメータを定義することが必要なことに注意してください。SELECT文の解析時に値&FROMGROUPがNULLの場合、この文ではFROMの後に表名が指定されていないため、エラーになります。
:MINTOTAL	注文の合計が最小になるよう顧客を選択するために使用される別の問合せからの列です。


字句参照を含むSQL問合せ文の例

  関連項目 	  すべての例

次に、パラメータに字句参照を使用するSELECT文の例を示します。

SELECT ENAME, EMPNO
FROM EMP
WHERE ENAME LIKE UPPER (&NAME)

この場合:

&NAME	デフォルト値を持つパラメータを参照します。このパラメータの値は実行時にも指定できることに注意してください。たとえば、コマンド・ラインから、次のように入力できます。

RWRUN60 REP SCOTT/TIGER NAME='SM%'


SQL問合せ文の制限

注意: レポート作成後にデータベースの列の幅が増えた場合、その変更を反映するためには、データ・モデルとレイアウト・モデルの両方を更新する必要があります。更新しない場合は、切捨てが行われる場合があります。問合せの再解析（たとえば、「SQL問合せ文」にスペースを入力して「OK」をクリック）時に、データベースの列は自動的に更新されます。ソース列の幅が大きくなった集計、式およびプレースホルダについては、手動でそれぞれの幅を更新する必要があります。同様に、レイアウト内のフィールドのサイズを変更し、広くなったソース列の幅に合わせてサイズ設定を変更する必要があります。

•	SELECT文は、すべてのSQL構文ルールに従っている必要があります。詳細は、『Oracle8 Server SQLリファレンス』を参照してください。「SQL問合せ文」の終了時およびレポートの生成または実行時に、Report Builderによって構文がチェックされます。

•	セミコロン、スラッシュまたはその他の文字をSELECT文の終わりに使用することはできません。

•	SELECT文を有効にするためにSELECT文で参照される表およびビューに関する適切な権限を保持している必要があります。

•	「SQL句」のSTART WITHとのリンクにおいて子になっている問合せの「SQL問合せ文」には、CONNECT BY句が含まれている必要があります（データ・モデル・リンクに含まれているため、START WITH句は不要です）。同様に、「SQL句」のHAVINGとのリンクにおいて、子になっている問合せの「SQL問合せ文」には、GROUP BY句が含まれている必要があります（データ・モデル・リンクに含まれているため、HAVING句は不要です）。

•	SELECT式が問合せに追加されたり、問合せ内で改名されたり、問合せから削除された場合、それに対応する列はReport Builderによって自動的に作成または削除されます。「レイアウト・モデル」内の影響を受けたオブジェクトは手動で更新するか、またはそのレポート用に新規のデフォルト・レイアウトを作成する必要があります。Report Builderによってレイアウト・モデルが自動更新されない理由は、デフォルト・レイアウトに対して手動で行った更新が、誤って失われる可能性があるためです。

•	問合せによって選択された列のデータ型または名前をデータベース内で変更する場合、変更された列を「ソース」として使用するReport Builderの列およびフィールドに必要な変更は、すべて手動で行なってください。

•	SELECT文内の列の順序によって最初の列の順序が決まります。SELECT文内の列の順序を後で変更しても、列の順序は変更されません。SELECT文に新規の列を追加した場合、その列は、問合せに属する最下位の子グループの終わりに付加されます。列の順序は、デフォルト・レイアウト内の関係付けられたフィールドの順序決定に使用されます。


型

説明  「型」プロパティは、問合せの型を記述する読込み専用のフィールドです。

適用  問合せ


データベース参照列プロパティ

ブレーク順序

コメント

列のデータ型

データ型

名前

幅


繰返し枠プロパティ

  制限

追加のハイパーリンク属性

アプリケーション・コマンド・ライン（PDF）

基本印刷オン

ブックマーク

列モード

コメント

フォーマット・トリガー

枠間の水平間隔

水平拡張度

ハイパーリンク（HTML/PDF）

ハイパーリンクの宛先

アンカー・オブジェクトと連動

ページ当りの最大レコード数

最小孤立レコード数

名前

後で改ページ

前で改ページ

ページ保護

印刷オブジェクト・オン

後のプリンタ・コード

前のプリンタ・コード

印刷方向

ソース

枠間の垂直間隔

垂直拡張度


繰返し枠の制限

•	繰返し枠は、そのソース・グループがマトリックスでない場合は「レイアウト・モデル」の任意の場所に配置できます。

•	繰返し枠は、それを含むオブジェクト（たとえば、フィールドまたはボイラープレート）の背面にある必要があります。


列モード

  制限 	  例

説明  「列モード」プロパティは、Report Builderによって、繰返し枠のインスタンス用のデータがどのようにフェッチおよびフォーマットされるかをコントロールします。「列モード」を「はい」に設定すると、前のインスタンスが完了する前に、繰返し枠の次インスタンスのフォーマットが開始できます。

  ここをクリックしてください。

「列モード」を「いいえ」に設定すると、前のインスタンスが完了する前に、繰返し枠の次インスタンスのフォーマットを開始できません。

  ここをクリックしてください。

「列モード」が使用されるのは、主に、マスター繰返し枠か、垂直または水平方向に拡張（つまり、サイズ変更が「可変」または「拡張」）される可能性があるフィールドを含む繰返し枠です。

適用対象  繰返し枠

必須/オプション  オプション

デフォルト  いいえ


列モードの例

  関連項目 	  すべての例

  ここをクリックしてください。

  ここをクリックしてください。

  ここをクリックしてください。


列モードの制限

•	次のいずれかを持つ繰返し枠についてのみ「列モード」を指定できます。

•	「印刷方向」が「横」および「水平拡張度」が「固定」

•	「印刷方向」が「縦」および「垂直拡張度」が「固定」

•	「印刷方向」が「右/下」または「下/右」に設定されている繰返し枠には、列モードを指定できません。


枠間の水平間隔

  制限

説明  「枠間の水平間隔」プロパティは、繰返し枠のインスタンスの水平間隔の空白の量（そのレポートのサイズの単位による）です。0以上の数値を入力します。この最大値は、サイズの単位によって異なります。単位がインチの場合、最大値は512インチです。センチメートルでは、1.312センチメートルです。パイカの場合、36,864パイカです。

  ここをクリックしてください。

適用対象  繰返し枠

必須/オプション  必須

デフォルト  0


枠間の水平間隔の制限

•	「印刷方向」が「縦」の場合、この設定には効果がありません。

•	「印刷方向」が「下/右」の場合、横並びに表示される2つのインスタンス間の空白に対してこの設定は有効です。


ページ当りの最大レコード数

  例

説明  「ページ当りの最大レコード数」プロパティは、1論理ページ上でフォーマットされる繰返し枠のインスタンス数の最大値です。多数のインスタンスを持つ繰返し枠があるとします。レポートを見やすくするために、繰返し枠のインスタンスが1論理ページに最大3つまで含まれるようにするとします。1論理ページに含まれるインスタンスが3つを超えないようにするには、「ページ当りの最大レコード数」を3に設定します。

値

1～32Kまでの整数	1論理ページ上にフォーマットできるインスタンスの最大数です。
ブランク	1論理ページ上にできる限り多数のインスタンスをフォーマットします。
適用対象  繰返し枠

必須/オプション  オプション

デフォルト  ブランク


ページ当りの最大レコード数の例

  関連項目 	  すべての例

1論理ページに1つの繰返し枠のインスタンスを1つのみ含むようにするとします。まず、1つのインスタンスのみが各論理ページに表示されるように、繰返し枠の「ページ当りの最大レコード数」を1に設定します。その後、最初のインスタンスが新しい論理ページから表示されるように「前で改ページ」および「後で改ページ」を指定します。


最小孤立レコード数

  制限 	  例

説明  「最小孤立レコード数」プロパティは、繰返し枠の印刷を開始する論理ページに表示されるインスタンスの最小数です。このプロパティに設定された数のインスタンスが、最初に印刷が設定されていた論理ページに収まらない場合は、繰返し枠のフォーマットは次のページで開始します。このプロパティを1に設定した場合は、最小値はなく、繰返し枠は、1つのインスタンスが収まる論理ページであればどのページでもフォーマットを開始します。

レポートを見やすくするために、繰返し枠の最初のインスタンスが論理ページの一番下に印刷されないようにするとします。その論理ページに少なくとも2つのインスタンスがあるようにするには、「最小孤立レコード数」を2に設定します。

値

1～32Kまでの整数	1論理ページ上にフォーマットできるインスタンス数の最小値です。1を設定した場合、最小値はありません。
ブランク	最小値はありません。
適用対象  繰返し枠

必須/オプション  必須

デフォルト  ブランク


最小孤立レコード数の例

  関連項目 	  すべての例

1論理ページに繰返し枠のすべてのインスタンスが含まれるようにするとします。この場合、「最小孤立レコード数」には、かなり大きな値を指定します。繰返し枠が印刷されるように設定されている最初の論理ページにすべてのインスタンスが収まらない場合、そのページにはどのインスタンスもフォーマットされません。そのかわり、次の論理ページにすべてフォーマットされます。しかし、次のページおよび後続のページでは、「最小孤立レコード数」は無視されます。空白のページで印刷を開始しているので、すべてのインスタンスがその論理ページに収まらない場合はどの論理ページにも収まりません。


最小孤立レコード数の制限

•	「最小孤立レコード数」は、オブジェクトが印刷されるように設定されている最初の論理ページのみに適用されます。「最小孤立レコード数」は後続のページでは、無視されます。

•	「最小孤立レコード数」が繰返し枠のインスタンスの合計より大きい場合、繰返し枠がフォーマットされるように設定されている最初の論理ページにすべてのインスタンスが収っている必要があります。繰返し枠がフォーマットされるように設定されている最初の論理ページにすべてのインスタンスが収まらない場合、繰返し枠のフォーマットはその次のページで開始します。


印刷方向

  制限 	  例

説明  「印刷方向」プロパティは、繰返し枠の後続のインスタンスが表示される方向です。

値

横	繰返し枠の2番目以降の各インスタンスは、その論理ページの前のインスタンスの右に印刷されます。
右/下	繰返し枠の2番目以降の各インスタンスは、その論理ページの前のインスタンスより右のマージンに1つのインスタンス全体が入りきらなくなるまで、前のインスタンスの右に印刷されます。その時点でその論理ページの垂直方向に印刷できる空白が残っていれば、Report Builderによって論理ページの左端のインスタンスの下にインスタンスが印刷されます。
縦	繰返し枠の2番目以降の各インスタンスは、その論理ページの前のインスタンスより下に印刷されます。
下/右	繰返し枠の2番目以降の各インスタンスは、その論理ページの前のインスタンスより下のマージンに1つのインスタンス全体が入りきらなくなるまで、前のインスタンスの下に印刷されます。その時点でその論理ページの水平方向に印刷できる空白が残っていれば、Report Builderによって論理ページの上端のインスタンスの右にインスタンスが印刷されます。
適用対象  繰返し枠

必須/オプション  必須

デフォルト  縦


印刷方向の例（「右/下」の場合）

  関連項目 	  すべての例

「印刷方向」が「右/下」に設定された繰返し枠があるとします。その繰返し枠のインスタンスは、左から右、上から下へ印刷されます。

  ここをクリックしてください。

  ここをクリックしてください。

しかし、オブジェクト（たとえば、図形）があるために、そのページで繰返し枠の2つのインスタンスを右方向へ配置できない場合、繰返し枠のインスタンスは、ページの下方向に印刷されることがあります。複数のインスタンスをページの右方向に印刷する空間がある場合は、繰返し枠のインスタンスがまず右方向に印刷され、次に下方向に印刷されます。

  ここをクリックしてください。

  ここをクリックしてください。


印刷方向の制限

•	ネストされた繰返し枠の「印刷方向」が「横」で、それを囲む繰返し枠の「印刷方向」が「縦」に設定されている場合、横の繰返し枠は、現行のページ幅よりも幅が広ければ、オーバーフローします。外側の次インスタンス、つまり下の繰返し枠は、右の繰返し枠の前のインスタンスが終わるまで印刷されません。注意: 1ページ目のA3を2ページ目にオーバーフローしたA3と揃える場合は、「列モード」を使用します。

  ここをクリックしてください。

•	クロス積グループ内でソース・グループが同じ「系列」の階層に属する（つまり、相互に上位項目または下位項目である）マトリックスの繰返し枠は、「印刷方向」が同じである必要があります。マトリックス内でネストを作成する場合、クロス積グループ内の親子リレーションが使用されます。その結果、そのようなグループと関係付けられた繰返し枠は、ページ上で同じ方向に印刷される必要があります。


ソース

説明  「ソース」プロパティは、繰返し枠のデータを所有するグループです。有効なグループ名を選択します。

適用対象  繰返し枠

必須/オプション  必須

使用上の注意

•	「ソース」には、クロス積グループを指定できません。


枠間の垂直間隔

  関連項目

説明  「枠間の垂直間隔」プロパティは、繰返し枠のインスタンスの垂直間隔の空白の量（そのレポートのサイズの単位による）です。0以上の数値を入力します。この最大値は、サイズの単位によって異なります。単位がインチの場合、最大値は512インチです。センチメートルでは、1.312センチメートルです。パイカの場合、36,864パイカです。

  ここをクリックしてください。

適用対象  繰返し枠

必須/オプション  必須

デフォルト  0


枠間の垂直間隔の制限

•	「印刷方向」が「横」の場合、この設定には効果がありません。

•	「印刷方向」が「右/下」の場合、上下に並んで表示される2つのインスタンス間の空白に対してこの設定は有効です。


A3の中にBのインスタンスが多すぎるため、最初の論理ページに収まらないことに注意してください。そのため、A3は次の論理ページにまでオーバーフローし、A4の印刷を開始できるのは、A3が完了してからです。


この図では、「列モード」が繰返し枠のインスタンスのフォーマットにどのような影響を与えるかが示されています。インスタンス3のフォーマットは、1ページ目で開始し、2ページ目で終了します。 さらに、インスタンスが別のページにもオーバーフローした場合はページ間で整列されます。この図では、インスタンス3は、2ページ目でも1ページに表示された位置と同じ相対位置に表示されます。


この図では、「列モード」が設定されていない場合のインスタンスの位置が示されています。 この場合、インスタンスがオーバーフローすると、ページ間の整列は行われません。インスタンス3は1ページ目右側でフォーマットされ、オーバーフローは2ページ目の左側でフォーマットされます。


この図では、「列モード」を使用した場合のレイアウト例が示されています。（Xの「水平拡張度」は「固定」であると想定されています。）


この図では、繰返し枠Xの「列モード」が「はい」に設定された場合のインスタンス1～3が示されています。インスタンス2が論理ページの2ページ目で完了したとしても、インスタンスの位置は、論理ページの1ページ目と同じです。 論理ページ幅によって、1ページ目でフォーマットを開始できるインスタンスが制限されることに注意してください。 同様に、3ページ目でインスタンス4および5がフォーマットされます。


この図では、繰返し枠Xの「列モード」が「はい」に設定されていない場合のインスタンス1～5の位置が示されています。この例では、インスタンス2は、論理ページの2ページ目では異なる位置で完了します。 また、インスタンス3は、論理ページの1ページ目で完了しなかったため、論理ページの2ページ目では、1ページ目とは異なる位置にあります。


?


この見出しノードの下のプロパティのヘルプを表示するには、プロパティをクリックし、[F1]を押してください。プロパティ・パレット自体のヘルプを表示するには、[Ctrl]を押しながらプロパティをクリックしてプロパティの選択を解除し、次に[F1]を押してください。


この見出しノードの下のプロパティのヘルプを表示するには、プロパティをクリックし、[F1]を押してください。プロパティ・パレット自体のヘルプを表示するには、[Ctrl]を押しながらプロパティをクリックしてプロパティの選択を解除し、次に[F1]を押してください。


この見出しノードの下のプロパティのヘルプを表示するには、プロパティをクリックし、[F1]を押してください。プロパティ・パレット自体のヘルプを表示するには、[Ctrl]を押しながらプロパティをクリックしてプロパティの選択を解除し、次に[F1]を押してください。


この見出しノードの下のプロパティのヘルプを表示するには、プロパティをクリックし、[F1]を押してください。プロパティ・パレット自体のヘルプを表示するには、[Ctrl]を押しながらプロパティをクリックしてプロパティの選択を解除し、次に[F1]を押してください。


この見出しノードの下のプロパティのヘルプを表示するには、プロパティをクリックし、[F1]を押してください。プロパティ・パレット自体のヘルプを表示するには、[Ctrl]を押しながらプロパティをクリックしてプロパティの選択を解除し、次に[F1]を押してください。


この見出しノードの下のプロパティのヘルプを表示するには、プロパティをクリックし、[F1]を押してください。プロパティ・パレット自体のヘルプを表示するには、[Ctrl]を押しながらプロパティをクリックしてプロパティの選択を解除し、次に[F1]を押してください。


この見出しノードの下のプロパティのヘルプを表示するには、プロパティをクリックし、[F1]を押してください。プロパティ・パレット自体のヘルプを表示するには、[Ctrl]を押しながらプロパティをクリックしてプロパティの選択を解除し、次に[F1]を押してください。


この見出しノードの下のプロパティのヘルプを表示するには、プロパティをクリックし、[F1]を押してください。プロパティ・パレット自体のヘルプを表示するには、[Ctrl]を押しながらプロパティをクリックしてプロパティの選択を解除し、次に[F1]を押してください。


この見出しノードの下のプロパティのヘルプを表示するには、プロパティをクリックし、[F1]を押してください。プロパティ・パレット自体のヘルプを表示するには、[Ctrl]を押しながらプロパティをクリックしてプロパティの選択を解除し、次に[F1]を押してください。


この見出しノードの下のプロパティのヘルプを表示するには、プロパティをクリックし、[F1]を押してください。プロパティ・パレット自体のヘルプを表示するには、[Ctrl]を押しながらプロパティをクリックしてプロパティの選択を解除し、次に[F1]を押してください。


この見出しノードの下のプロパティのヘルプを表示するには、プロパティをクリックし、[F1]を押してください。プロパティ・パレット自体のヘルプを表示するには、[Ctrl]を押しながらプロパティをクリックしてプロパティの選択を解除し、次に[F1]を押してください。


この見出しノードの下のプロパティのヘルプを表示するには、プロパティをクリックし、[F1]を押してください。プロパティ・パレット自体のヘルプを表示するには、[Ctrl]を押しながらプロパティをクリックしてプロパティの選択を解除し、次に[F1]を押してください。


この見出しノードの下のプロパティのヘルプを表示するには、プロパティをクリックし、[F1]を押してください。プロパティ・パレット自体のヘルプを表示するには、[Ctrl]を押しながらプロパティをクリックしてプロパティの選択を解除し、次に[F1]を押してください。


この見出しノードの下のプロパティのヘルプを表示するには、プロパティをクリックし、[F1]を押してください。プロパティ・パレット自体のヘルプを表示するには、[Ctrl]を押しながらプロパティをクリックしてプロパティの選択を解除し、次に[F1]を押してください。


この見出しノードの下のプロパティのヘルプを表示するには、プロパティをクリックし、[F1]を押してください。プロパティ・パレット自体のヘルプを表示するには、[Ctrl]を押しながらプロパティをクリックしてプロパティの選択を解除し、次に[F1]を押してください。


この見出しノードの下のプロパティのヘルプを表示するには、プロパティをクリックし、[F1]を押してください。プロパティ・パレット自体のヘルプを表示するには、[Ctrl]を押しながらプロパティをクリックしてプロパティの選択を解除し、次に[F1]を押してください。


この見出しノードの下のプロパティのヘルプを表示するには、プロパティをクリックし、[F1]を押してください。プロパティ・パレット自体のヘルプを表示するには、[Ctrl]を押しながらプロパティをクリックしてプロパティの選択を解除し、次に[F1]を押してください。


この見出しノードの下のプロパティのヘルプを表示するには、プロパティをクリックし、[F1]を押してください。プロパティ・パレット自体のヘルプを表示するには、[Ctrl]を押しながらプロパティをクリックしてプロパティの選択を解除し、次に[F1]を押してください。


この見出しノードの下のプロパティのヘルプを表示するには、プロパティをクリックし、[F1]を押してください。プロパティ・パレット自体のヘルプを表示するには、[Ctrl]を押しながらプロパティをクリックしてプロパティの選択を解除し、次に[F1]を押してください。


この見出しノードの下のプロパティのヘルプを表示するには、プロパティをクリックし、[F1]を押してください。プロパティ・パレット自体のヘルプを表示するには、[Ctrl]を押しながらプロパティをクリックしてプロパティの選択を解除し、次に[F1]を押してください。


この見出しノードの下のプロパティのヘルプを表示するには、プロパティをクリックし、[F1]を押してください。プロパティ・パレット自体のヘルプを表示するには、[Ctrl]を押しながらプロパティをクリックしてプロパティの選択を解除し、次に[F1]を押してください。


この見出しノードの下のプロパティのヘルプを表示するには、プロパティをクリックし、[F1]を押してください。プロパティ・パレット自体のヘルプを表示するには、[Ctrl]を押しながらプロパティをクリックしてプロパティの選択を解除し、次に[F1]を押してください。


この見出しノードの下のプロパティのヘルプを表示するには、プロパティをクリックし、[F1]を押してください。プロパティ・パレット自体のヘルプを表示するには、[Ctrl]を押しながらプロパティをクリックしてプロパティの選択を解除し、次に[F1]を押してください。


レポート・プロパティ

「フォーム後型」

「フォーム後値」

「ページ後型」

「ページ後値」

「レポート後型」

「レポート後値」

「フォーム前型」

「フォーム前値」

「ページ前型」

「ページ前値」

「レポート前型」

「レポート前値」

コメント

キャラクタ単位で設計

方向

ホスト・メニュー項目を使用不可にする

画面分割キーを使用不可にする

ズーム・キーを使用不可にする

配布

高さ（パラメータ・フォーム・ウィンドウ）

境界線を含む

ビットマップ・オブジェクトを含む

最大水平ボディ・ページ

最大垂直ボディ・ページ

名前

ページ数

ページ・ナビゲーション・コントロール・タイプ

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

パネル印刷順序

プレビューアのヒント行のテキスト

プレビューアのステータス行のテキスト

ロール名

プレビューア・タイトルの抑止

ズームで起動

タイトル

サイズの単位

プレビューアのヒント行を使用

プレビューアのステータス行を使用

幅（パラメータ・フォーム・ウィンドウ）

XMLタグ

XML タグ属性

XML Prolog型

XML Prolog値


サイズの単位

説明  「サイズの単位」プロパティは、レポートおよびパラメータ・フォームのサイズ指定に使用されるサイズの標準です。

値

センチメートル

インチ

ポイント 	1パイカを構成するプリンタの印字サイズです。1パイカは12ポイントで、1インチの6分の1に相当します。

適用対象  レポート

必須/オプション  必須

デフォルト  インチ


最大水平ボディ・ページ

説明  「最大水平ボディ・ページ」プロパティは、レポートに表示する幅でのボディ・ページの最大数です。

値  1～999の整数

適用対象  レポート

必須/オプション  必須

デフォルト  10


最大垂直ボディ・ページ

説明  「最大垂直ボディ・ページ」プロパティは、レポートに表示する高さでのボディ・ページの最大数です。

値  1～999の整数

適用対象  レポート

必須/オプション  必須

デフォルト  10


パネルの印刷順序

説明  パネル印刷順序は、論理ページを導出する物理ページが印刷される順序です。また、論理ページ内でのパネル番号の順序を決めます。図は、論理ページおよび物理ページ、パネルを示しています。

  ここをクリックしてください。

値

右/下	レポート・ボディの物理ページが左から右に印刷されてから、上から下に印刷されます。
下/右	レポート・ボディの物理ページが上から下に印刷されてから、左から右に印刷されます。
適用対象  レポート

必須/オプション  必須

デフォルト  右/下


方向

  制限

説明  「方向」プロパティでは、レポート全体の読込み順序を指定できます。「方向」の値は、レポートにあるレイアウト・オブジェクト（たとえば、フィールド、ボイラープレートなど）のデフォルトとなります。また、レポート・エディタの方向を制御します（たとえば、「方向」が「右から左」である場合は、レポート・エディタの方向は右から左になります）。つまり、レポート・エディタが右から左になるように、手動でオブジェクトを移動する必要はありません。

値

左から右

右から左

適用対象  レポート

必須/オプション  必須

デフォルト  使用言語の自然な記述方向。


「方向」の制限

•	レポートまたは任意のオブジェクトの方向の変更は、双方向プラットフォーム上での実行時にのみ有効です。


配布

説明  「配布」プロパティでは、「配布」ダイアログ・ボックスで指定された値を使用して、レポート全体の配布を定義します。

適用対象  レポート

必須/オプション  オプション


タイトル

説明  「タイトル」は、ライブ・プレビューアでレポートの一番上に表示されるテキストです。デフォルトのタイトルを変更するには、フィールドに希望するテキストを入力します。

値  256バイト以内の英数字文字列を入力します。デフォルトのタイトルは、自分で入力したタイトルのテキストを削除すれば、復元できます。

適用対象  レポート


ロール名

  制限	  関連項目

説明  「ロール名」プロパティは、実行時にそのレポート用に設定されるデータベースのロールを指定します。このオプションを使用して、エンド・ユーザーが、通常はアクセス権限を持っていないデータベース表への問合せを行うレポートを実行することができます。Reports Runtimeは、データベースに付与されているロールを設定できるだけです。Reports Runtimeではロールを設定できない場合は、そのレポートは実行されません。

値   30文字以内の有効なデータベース・ロールを入力します。

適用対象  レポート

必須/オプション  オプション

デフォルト  データベースでユーザーに対して指定されたデフォルトのロールです。これは、ユーザーがデータベースに接続すると設定されます。

使用上の注意

•	レポートのプロパティ・パレットで「ロール名」プロパティを設定できます。ロール・パスワードを設定する（オプション）には、「ロール名」値フィールドのボタンをダブルクリックして、「ロール設定」ダイアログを表示します。

•	Reports Runtime（RWRUN60）でコマンド・ラインを使用してロールを指定する場合、レポートのロール設定が上書きされます。

•	1つのレポートには、1つのロールしか設定できません。複数のロールを設定するには、他のロールが付与されたロールを設定する必要があります。


「ロール名」の制限

•	PL/SQLトリガーにロールを設定すると矛盾が起きる可能性があるので、これはお薦めできません。


幅（パラメータ・フォーム・ウィンドウ）

  制限

説明  「幅」プロパティは、「サイズの単位」での1パラメータ・フォーム・ページの幅です。

値  0以上の有効な幅を入力します。最大幅は、「サイズの単位」によって異なります。インチの場合、最大幅は512インチになります。センチメートルでは、1,312センチメートルです。ポイントの場合は36,864ポイントになります。

適用対象  レポート

必須/オプション  必須

デフォルト  4インチまたは10センチメートル、あるいは300ポイント


「幅」の制限（パラメータ・フォーム・ウィンドウ）

•	「幅」を指定後に「サイズの単位」を変更する場合は、「幅」は新しい「サイズの単位」の適切な幅に自動的に変更されます。


高さ（パラメータ・フォーム・ウィンドウ）

  制限

説明  「高さ」プロパティは、「サイズの単位」での1パラメータ・フォーム・ページの高さです。

値   0以上の有効な高さを入力します。最大高は、「サイズの単位」によって異なります。インチの場合、最大高は512インチになります。センチメートルでは、1,312センチメートルです。ポイントの場合は36,864ポイントになります。

適用対象  レポート

必須/オプション  必須

デフォルト  4インチまたは10センチメートル、あるいは300ポイント


「高さ」の制限（パラメータ・フォーム・ウィンドウ）

•	「高さ」を指定後に「サイズの単位」を変更する場合は、「高さ」は新しい「サイズの単位」の適切な高さに自動的に変更されます。


ページ数

説明  「ページ数」プロパティは、ランタイム・パラメータ・フォームで希望する総ページ数です。

値  1～9,999の整数

適用対象  レポート

必須/オプション  必須

デフォルト  1


ページ・ナビゲーション・コントロール・タイプ

  関連項目

説明  「ページ・ナビゲーション・コントロール・タイプ」プロパティは、HTMLページ・ストリームのレポート出力のナビゲーション・ボタンについて、スクリプトの定義方法を指定します。

値

ファイル	ページ・ナビゲーション・コントロールのHTMLスクリプト・コードを含む、任意の有効なテキスト・ファイルです。
テキスト	ページ・ナビゲーション・コントロールのHTMLスクリプト・コードを含む、任意のテキスト文字列です。
適用対象  HTMLまたはHTMLCSSページ・ストリームのレポート出力

必須/オプション  オプション

デフォルト  テキスト

PL/SQL  PL/SQLを使用してこの属性を定義するには、SRW.SET_PAGE_NAVIGATION_HTML プロシージャを使用します。


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

  関連項目

説明  「ページ・ナビゲーション・コントロール値」プロパティは、HTMLページ・ストリームのレポート出力のナビゲーション・ボタンについて、ファイル名またはスクリプト・コードを指定します。

値  任意の有効なファイル名、または有効なHTMLコマンドを含む任意のテキスト文字列。「ページ・ナビゲーション・コントロール・タイプ」に指定したものによって決まります。必要に応じて、値フィールド（?ラベル）をクリックして、デフォルトのビルトインJavaScriptを変更できます。

適用対象  HTMLまたはHTMLCSSページ・ストリームのレポート出力

必須/オプション  オプション

デフォルト  Report BuilderのビルトインJavaScript

使用上の注意

ナビゲーション・コントロールに自分で作成したスクリプトを使用する場合、スクリプトに次の3つの変数を含める必要があります。

•	&TotalPages（合計ページ数）

•	&file_name（出力宛先ファイルの名前。myreportなど）

•	&file_ext（ファイル拡張子。htmなど）

Report Builderによって、書式設定時にこれらの変数が割り当てられます。

ページ・ナビゲーション・コントロール枠の高さは、スクロール・バーなしで70ポイントにハードコードされます。枠の幅は可変です。この枠の中でアイコンやイメージを使用する場合は、これらの寸法を覚えておいてください。

PL/SQL  PL/SQLを使用してこの属性を定義するには、SRW.SET_PAGE_NAVIGATION_HTML プロシージャを使用します。


「レポート前型」

  関連項目

説明  「レポート前型」プロパティでは、レポートがHTMLファイルに出力されてWebブラウザに表示されるときに、文書の始めに表示されるヘッダーの型を指定します。

HTMLページ・ストリームを使用する場合、このプロパティはレポート出力の先頭ページに適用されます。レポート全体（バックグラウンド・カラー、イメージまたはその他の<body> HTML属性など）にHTMLを適用するように指定するには、「ページ前」プロパティを使用する必要があります。

値

テキスト	有効なHTMLコマンドを含む任意のテキスト文字列です。
ファイル	任意の有効なテキスト・ファイルまたはグラフィック・ファイルです。
適用対象  レポート

必須/オプション  必須（「レポート前値」を指定した場合）

デフォルト  テキスト

PL/SQL PL/SQLを使用してこの属性を定義するには、SRW.SET BEFORE REPORT HTMLプロシージャを使用します。


「レポート前値」

  制限      [image]  例	  関連項目

説明  「レポート前値」プロパティでは、レポートがHTMLファイルに出力されてWebブラウザに表示されるときに、文書の始めに表示されるヘッダーを指定します。

HTMLページ・ストリームを使用する場合、このプロパティはレポート出力の先頭ページに適用されます。レポート全体（バックグラウンド・カラー、イメージまたはその他の<body> HTML属性など）にHTMLを適用するように指定するには、「ページ前」プロパティを使用する必要があります。

値  任意の有効なファイル名、または有効なHTMLコマンドを含む任意のテキスト文字列。「レポート前型」に指定したものによって決まります。

適用対象  レポート

必須/オプション  必須（「レポート前型」を「File」に指定した場合）

デフォルト  次のようなデフォルトのHTMLコマンドが、レポートの始めに組み込まれています。

<html>
<body bgcolor="#ffffff">

使用上の注意

•	このプロパティは、HTML文書の始めに、1つのロゴまたは複数の標準リンクを入れるのに便利です。

PL/SQL PL/SQLを使用してこの属性を定義するには、SRW.SET BEFORE REPORT HTMLプロシージャを使用します。


「レポート前値」の制限

•	デフォルトのテキストを置換する場合は、等価のHTMLコマンドが含まれていることを確認する必要があります。


「レポート後型」

  関連項目

説明  「レポート後型」プロパティでは、レポートがHTMLファイルに出力されてWebブラウザに表示されるときに、文書の終わりに表示されるトレーラの型を指定します。

HTMLページ・ストリームを使用する場合、このプロパティはレポート出力の最終ページに適用されます。レポート全体（バックグラウンド・カラー、イメージまたはその他の<body> HTML属性など）にHTMLを適用するように指定するには、「ページ前」プロパティを使用する必要があります。

値

テキスト	有効なHTMLコマンドを含む任意のテキスト文字列です。
ファイル	任意の有効なテキスト・ファイルまたはグラフィック・ファイルです。
適用対象  レポート

必須/オプション  必須（「レポート後値」を指定した場合）

デフォルト  テキスト

PL/SQL PL/SQLを使用してこの属性を定義するには、SRW.SET AFTER REPORT HTMLプロシージャを使用します。


「レポート後値」

  制限 [image]  例	  関連項目

説明  「レポート後値」プロパティでは、レポートがHTMLファイルに出力されてWebブラウザに表示されるときに、文書の終わりに表示されるトレーラを指定します。

HTMLページ・ストリームを使用する場合、このプロパティはレポート出力の最終ページに適用されます。レポート全体（バックグラウンド・カラー、イメージまたはその他の<body> HTML属性など）にHTMLを適用するように指定するには、「ページ前」プロパティを使用する必要があります。

値  任意のファイル名、または有効なHTMLコマンドを含む任意のテキスト文字列。「レポート後型」に指定したものによって決まります。

適用対象  レポート

必須/オプション  必須（「レポート後型」を「File」に指定した場合）

デフォルト  次のようなデフォルトのHTMLコマンドが、レポートの終わりに組み込まれています。

</body></html>

使用上の注意

•	このプロパティは、HTML文書の終わりに、1つのロゴまたは複数の標準リンクを入れるのに便利です。

PL/SQL PL/SQLを使用してこの属性を定義するには、SRW.SET AFTER REPORT HTMLプロシージャを使用します。


「レポート後値」の制限

•	デフォルトのテキストを置換する場合は、等価のHTMLコマンドが含まれていることを確認してください。


「ページ前型」

  関連項目

説明  「ページ前型」プロパティでは、レポートがHTMLファイルに出力されてWebブラウザに表示されるときに、文書の各ページの始めに表示されるへッダーの型を指定します。

HTMLページ・ストリームを使用する場合、このプロパティはレポート出力のすべてのページに適用されます（バックグラウンド・カラー、イメージまたはその他の<body> HTML属性など）。レポート出力の先頭（ヘッダー）ページまたは最終（フッター）ページにのみHTMLを指定するには、「レポート前」プロパティまたは「レポート後」プロパティをそれぞれ使用します。

値

テキスト	有効なHTMLコマンドを含む任意のテキスト文字列です。
ファイル	任意の有効なテキスト・ファイルまたはグラフィック・ファイルです。
適用対象  レポート

必須/オプション  必須（「ページ前値」を指定した場合）

デフォルト  テキスト

PL/SQL PL/SQLを使用してこの属性を定義するには、SRW.SET BEFORE PAGE HTMLプロシージャを使用します。


「ページ前値」

  例	  関連項目

説明  「ページ前値」プロパティでは、レポートがHTMLファイルに出力されてWebブラウザに表示されるときに、文書の各ページの始めに表示されるへッダーを指定します。

HTMLページ・ストリームを使用する場合、このプロパティはレポート出力のすべてのページに適用されます（バックグラウンド・カラー、イメージまたはその他の<body> HTML属性など）。レポート出力の先頭（ヘッダー）ページまたは最終（フッター）ページにのみHTMLを指定するには、「レポート前」プロパティまたは「レポート後」プロパティをそれぞれ使用します。

値  任意のファイル名、または有効なHTMLコマンドを含む任意のテキスト文字列。「ページ前型」に指定したものによって決まります。

適用対象  レポート

必須/オプション  必須（「ページ前型」を「File」に指定した場合）

デフォルト  ブランク

使用上の注意

•	このプロパティは、HTML文書の各ページの始めに、1つのロゴまたは複数の標準リンクを入れるのに便利です。

•	この値を現行のページのみに適用する場合は、そのページのオブジェクトに対する「フォーマット・トリガー」に値を指定します。

PL/SQL PL/SQLを使用してこの属性を定義するには、SRW.SET BEFORE PAGE HTMLプロシージャを使用します。


「ページ後型」

  関連項目

説明  「ページ後型」プロパティでは、レポートがHTMLファイルに出力されてWebブラウザに表示されるときに、文書の各ページの終わりに表示されるフッターの型を指定します。

HTMLページ・ストリームを使用する場合、このプロパティはレポート出力のすべてのページに適用されます（バックグラウンド・カラー、イメージまたはその他の<body> HTML属性など）。レポート出力の先頭（ヘッダー）ページまたは最終（フッター）ページにのみHTMLを指定するには、「レポート前」プロパティまたは「レポート後」プロパティをそれぞれ使用します。

値

テキスト	有効なHTMLコマンドを含む任意のテキスト文字列です。
ファイル	任意の有効なテキスト・ファイルまたはグラフィック・ファイルです。
適用対象  レポート

必須/オプション  必須（「ページ後値」を指定した場合）

デフォルト  テキスト

PL/SQL PL/SQLを使用してこの属性を定義するには、SRW.SET AFTER PAGE HTMLプロシージャを使用します。


「ページ後値」

  制限      [image]  例	  関連項目

説明  「ページ後値」プロパティでは、レポートがHTMLファイルに出力されてWebブラウザに表示されるときに、文書の各ページの終わりに表示されるフッターを指定します。

HTMLページ・ストリームを使用する場合、このプロパティはレポート出力のすべてのページに適用されます（バックグラウンド・カラー、イメージまたはその他の<body> HTML属性など）。レポート出力の先頭（ヘッダー）ページまたは最終（フッター）ページにのみHTMLを指定するには、「レポート前」プロパティまたは「レポート後」プロパティをそれぞれ使用します。

値  任意のファイル名、または有効なHTMLコマンドを含む任意のテキスト文字列。「ページ後型」に指定したものによって決まります。

適用対象  レポート

必須/オプション  必須（「ページ後型」を「File」に指定した場合）

デフォルト  次のようなデフォルトのHTMLコマンドが、ページの終わりに組み込まれています。

<hr size=5 noshade>

使用上の注意

•	このプロパティは、HTML文書の各ページの終わりに、1つのロゴまたは複数の標準リンクを入れるのに便利です。

•	この値を現行のページのみに適用する場合は、そのページのオブジェクトに対する「フォーマット・トリガー」に値を指定します。

PL/SQL PL/SQLを使用してこの属性を定義するには、SRW.SET AFTER PAGE HTMLプロシージャを使用します。


「ページ後値」の制限

•	デフォルトのテキストを置換する場合は、等価のHTMLコマンドが含まれていることを確認する必要があります。


「フォーム前型」

説明  「フォーム前型」プロパティでは、レポートがHTMLファイルに出力されてWebブラウザに表示されるときに、ランタイム・パラメータ・フォームの始めに表示されるヘッダーの型を指定します。

値

テキスト	有効なHTMLコマンドを含む任意のテキスト文字列です。
ファイル	任意の有効なテキスト・ファイルまたはグラフィック・ファイルです。
適用対象  レポート

必須/オプション  必須（「フォーム前値」を指定した場合）

デフォルト  テキスト

PL/SQL PL/SQLを使用してこの属性を定義するには、SRW.SET BEFORE FORM HTMLプロシージャを使用します。


「フォーム前値」

  制限 	  例

説明  「フォーム前値」プロパティでは、レポートがHTMLファイルに出力されてWebブラウザに表示されるときに、ランタイム・パラメータ・フォームの始めに表示されるヘッダーを指定します。

値  任意の有効なファイル名、または有効なHTMLコマンドを含む任意のテキスト文字列。「フォーム前型」に指定したものによって決まります。

適用対象  レポート

必須/オプション  必須（「フォーム前型」を「File」に指定した場合）

デフォルト  次のようなデフォルトのHTMLコマンドが、ランタイム・パラメータ・フォームの始めに組み込まれています。

<html>
<body bgcolor="#ffffff">
<form method=post>
<center>
<p><hr>
<table border=0 cellspacing=0 cellpadding=0>
<tr>
<td><input type=submit>
<td width=15>
<td><input type=reset>>
</table>
<p><hr><p>

使用上の注意

•	このプロパティは、HTML文書のランタイム・パラメータ・フォームの始めに、1つのロゴまたは複数の標準リンクを入れるのに便利です。

PL/SQL PL/SQLを使用してこの属性を定義するには、SRW.SET BEFORE FORM HTMLプロシージャを使用します。


「フォーム前値」の制限

•	デフォルトのテキストを置換する場合は、等価のHTMLコマンドが含まれていることを確認してください。


「フォーム後型」

説明  「フォーム後型」プロパティでは、レポートがHTMLファイルに出力されてWebブラウザに表示されるときに、ランタイム・パラメータ・フォームの終わりに表示されるフッターの型を指定します。

値

テキスト	有効なHTMLコマンドを含む任意のテキスト文字列です。
ファイル	任意の有効なテキスト・ファイルまたはグラフィック・ファイルです。
適用対象  レポート

必須/オプション  必須（「フォーム後値」を指定した場合）

デフォルト  テキスト

PL/SQL PL/SQLを使用してこの属性を定義するには、SRW.SET_AFTER_FORM_HTMLプロシージャを使用します。


「フォーム後値」

  制限

説明  「フォーム後値」プロパティでは、レポートがHTMLファイルに出力されてWebブラウザに表示されるときに、ランタイム・パラメータ・フォームの終わりに表示されるフッターを指定します。

値  任意の有効なファイル名、または有効なHTMLコマンドを含む任意のテキスト文字列。「フォーム後型」に指定したものによって決まります。

適用対象  レポート

必須/オプション  必須（「フォーム後型」を「File」に指定した場合）

デフォルト  次のようなデフォルトのHTMLコマンドが、ランタイム・パラメータ・フォームの終わりに組み込まれています。

</center>
</body>
</form>
</html>

使用上の注意

•	このプロパティは、HTML文書のランタイム・パラメータ・フォームの終わりに、1つのロゴまたは複数の標準リンクを入れるのに便利です。

PL/SQL PL/SQLを使用してこの属性を定義するには、SRW.SET_AFTER_FORM_HTMLプロシージャを使用します。


「フォーム後値」の制限

•	デフォルトのテキストを置換する場合は、等価のHTMLコマンドが含まれていることを確認する必要があります。


キャラクタ単位で設計

説明  「キャラクタ単位で設計」プロパティは、レポート・エディタおよびその格子表示でキャラクタ・セル単位の使用を指定します。このプロパティおよび「境界線を含む」を使用すると、レポート・エディタではオブジェクトのキャラクタ・モード境界線が0（ゼロ）以上の幅の線で表示されます。

デフォルト  いいえ


プレビューアのヒント行を使用

説明  プレビューアのヒント行は、画面の最終行から2行目に表示されるライブ・プレビューアの行です。デフォルトのヒント行を変更するには、「はい」を選択して、「プレビューアのヒント行のテキスト」プロパティに希望するテキストを入力します。

値  「はい」である場合は、「プレビューアのヒント行のテキスト」プロパティにテキストを入力します。

適用対象  レポート

デフォルト  いいえ

使用上の注意

•	「プレビューアのヒント行のテキスト」プロパティに入力したヒント・テキストを削除して、「プレビューアのヒント行を使用」プロパティを「いいえ」に設定すると、デフォルトのヒント行を復元できます。


プレビューアのヒント行のテキスト

説明  プレビューアのヒント行は、画面の最終行から2行目に表示されるライブ・プレビューアの行です。

値  80バイト以内の英数字文字列を入力します。

適用対象  レポート


プレビューアのステータス行を使用

  制限

説明  プレビューアのステータス行は、ライブ・プレビューアの最終行です。デフォルトのステータス行を変更するには、「はい」を選択して、「プレビューアのステータス行のテキスト」プロパティに希望するテキストを入力します。

値  「はい」である場合は、「プレビューアのステータス行のテキスト」プロパティにテキストを入力します。

適用対象  レポート

デフォルト  いいえ

使用上の注意

•	「プレビューアのステータス行のテキスト」プロパティに入力したステータス・テキストを削除して、「プレビューアのステータス行を使用」プロパティを「いいえ」に設定すると、デフォルトのステータス行を復元できます。


「プレビューアのステータス行を使用」の制限

•	プレビューアのステータス行を「いいえ」に設定すると、Report Builderではそのための行が予約されません。このため、画面当たり1行余分にレポートを表示できます。

•	「プレビューアのステータス行のテキスト」を変更するとき、レポート名を入力しないとステータス行には表示されません。たとえば、次のように入力します。

This report is for Human Resources personnel only (Report: deptinfo)


プレビューアのステータス行のテキスト

説明  プレビューアのステータス行は、ライブ・プレビューアの最終行です。

値  80バイト以内の英数字文字列を入力します。

適用対象  レポート


ビットマップ・オブジェクトを含む

説明  「ビットマップ・オブジェクトを含む」プロパティは、レポートがキャラクタ・モードで実行されるときに、すべてのビットマップ処理済みオブジェクト（つまり、テキストおよび線、四角形を除くGraphics Builder図表およびボイラープレート・オブジェクト）をボックスに変換します。「いいえ」に設定すると、レポートがキャラクタ・モードで実行されるときに、すべてのビットマップ処理済みオブジェクトおよびそれらに対する明示的アンカーが削除されます。

適用対象  レポート

デフォルト  いいえ


「ビットマップ・オブジェクトを含む」の制限

  制限

•	水平または垂直でない線は、キャラクタ・モードではこの設定に関わらず、水平または垂直の線に変換されます。同様に、回転された四角形は、キャラクタ・モードではこの設定に関わらず、回転していない四角形に変換されます。


境界線を含む

説明  「境界線を含む」プロパティは、ビットマップで0（ゼロ）以上の線幅のオブジェクトに対して、キャラクタ・モードでの境界線をオンにします。「いいえ」に設定すると、キャラクタ・モードではすべての境界線がオフになります。

適用対象  レポート

デフォルト  いいえ

使用上の注意

•	このプロパティおよび「キャラクタ単位で設計」プロパティを、「はい」に設定すると、レポート・エディタではオブジェクトのキャラクタ・モード境界線が0（ゼロ）以上の幅の線で表示されます。


ホスト・メニュー項目を使用不可にする

説明  「ホスト・メニュー項目を使用不可にする」プロパティは、ランタイム・パラメータ・フォームおよびライブ・プレビューアの両方にある「ファイル」メニューのホスト項目を使用不可にします。ホスト項目はキャラクタ・モードのReport Builderの「ファイル」メニューに表示されます。

適用対象  レポート

デフォルト  いいえ


画面分割キーを使用不可にする

説明  「画面分割キーを使用不可にする」は、「Split Vertical」および「Split Horizontal」ファンクション・キーを使用不可にします。

適用対象  レポート

デフォルト  いいえ


ズーム・キーを使用不可にする

  制限

説明  「ズーム・キーを使用不可にする」プロパティは、ライブ・プレビューア表示での「Zoom/Unzoom」ファンクション・キーを使用不可にします。

適用対象  レポート

デフォルト  いいえ


「ズーム・キーを使用不可にする」の制限

•	この機能は、UNIXでのみ使用できます。

•	「ズーム・キーを使用不可にする」および「ズームで起動」が両方とも「はい」に設定されていると、ライブ・プレビューアではズームがオンで表示され、ズームをオフにすることはできなくなります。


ズームで起動

  制限

説明  「ズームで起動」プロパティは、ズームがオンになった状態でライブ・プレビューアを表示します（つまり、ライブ・プレビューアの周りに通常表示される境界線は見えずに、レポート出力のみが見えます）。

適用対象  レポート

デフォルト  いいえ


「ズームで起動」の制限

•	この機能は、UNIXでのみ使用できます。

•	「ズーム・キーを使用不可にする」および「ズームで起動」が両方とも「はい」に設定されていると、ライブ・プレビューアではズームがオンで表示され、ズームをオフにすることはできなくなります。


プレビューア・タイトルの抑止

説明  「プレビューア・タイトルの抑止」プロパティは、キャラクタ・モードのプレビューアにある「タイトル」の表示を隠します。

適用対象  レポート

デフォルト   はい


この場合、ぺージとはレポート・ページのことです。


言語は、NLS環境変数で定義されています。


?


参照カーソル問合せプロパティ

コメント

最大取出し行

名前

PL/SQL文

型


PL/SQL文

  関連項目

説明  PL/SQL文のプロパティは、データを戻すために参照カーソルを使用するPL/SQL関数を入力できるPL/SQLエディタを表示するボタンです。

適用  問合せ

必須/オプション  必須


この見出しノードの下のプロパティのヘルプを表示するには、プロパティをクリックし、[F1]を押してください。プロパティ・パレット自体のヘルプを表示するには、[Ctrl]を押しながらプロパティをクリックしてプロパティの選択を解除し、次に[F1]を押してください。


セクション・プロパティ

配布

高さ

ページ当りの水平パネル

方向

レポート高

レポート幅

ページ当りの垂直パネル

幅


配布

説明  「配布」プロパティは、「配布」ダイアログ・ボックスで指定された値を使用して、現行のセクションの配布を定義します。

適用対象  セクション

必須/オプション  オプション


高さ

  制限

説明  「高さ」プロパティは、1物理ページ（マージンを含む）の「サイズの単位」の高さです（例11インチ）。

値   0以上の有効な高さを入力します。最大高は、「サイズの単位」によって異なります。インチの場合、最大高は512インチになります。センチメートルでは、1,312センチメートルです。ポイントの場合は36,864ポイントになります。

適用対象  セクション

必須/オプション  必須

デフォルト  11インチ


高さの制限

•	ページは、セクションが入る大きさである必要があります。たとえば、セクション内のフレームを「高さ」以上のサイズに拡張すると、レポートは実行されません。

•	すでに「高さ」を指定した後で「サイズの単位」を変更すると、「高さ」は新しい「サイズの単位」のおおよその高さに自動的に変更されます。

•	物理ページの「幅」または「高さ」を変更すると、論理ページのサイズがそれに応じて変更され、マージンのサイズが可能な限り保たれます。

注意: 物理ページの印刷可能領域が制限されているプリンタもあります。たとえば、プリンタ用紙は8.5 x 11インチでも、プリンタで印刷できる範囲が8 x 10.5インチしかない場合があります。プリンタの印刷可能な領域を超える「幅」や「高さ」を定義した場合、レポート出力でクリッピングが起きる可能性があります。クリッピングを回避するには、プリンタの印刷可能な領域を広げるか（オペレーティング・システムで設定できる場合）、ページの印刷可能な領域のサイズになるように「幅」と「高さ」を設定します。

•	コマンド・ラインでPAGESIZEパラメータに別の値を指定すると、ページの大きさを上書きできます。

•	上下のデフォルトのマージンは、それぞれ0.5インチです。


ページ当りの水平パネル

  例

説明  「ページ当りの水平パネル」プロパティは、物理ページ（プリンタ・ページ）単位の論理ページ（レポート･ページ）の幅です。たとえば、「ページ当りの水平パネル」のサイズが1であれば、各論理ページは1物理ページの幅になります。

値  1～50までの任意の整数

適用対象  セクション

必須/オプション  必須

デフォルト  1


ページ当りの水平/垂直パネルの例

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

ここをクリックしてください。


方向

  制限

説明  「方向」プロパティは、セクションの出力が縦方向か横方向かを指定します。この設定は、ORIENTATIONコマンド・ライン・パラメータ、システム・パラメータ、または「ページ設定」ダイアログ・ボックスで指定された方向を上書きします。

値

デフォルト	ORIENTATIONコマンド・ライン・パラメータ、システム・パラメータ、または「ページ設定」ダイアログ・ボックスで定義された方向を使用します。
縦	縦方向のセクション出力です。
横	横方向のセクション出力です。
適用対象  セクション

必須/オプション  オプション

デフォルト  デフォルト


「方向」の制限

•	レポートをMotif版のPCLプリンタに出力する場合には、印刷方向の設定は無視されます。レポートはデフォルトの設定を使用して処理されます。


レポート高

  制限

説明  「レポート高」プロパティは、レポート・ページの文字単位の高さです。

値  1～9,999までの任意の整数

適用対象  セクション

必須/オプション  必須

デフォルト  80文字


レポート高の制限

•	キャラクタ・モードのレポートをビットマップのライブ・プレビューア表示で表示する場合、Report Builderはこの設定を使用して表示フォントを選択します。フォントは実際の文字セル・サイズよりわずかに大きくなるか、小さくなることがあります。このため、文字の一部が切り捨てられる可能性があります。


レポート幅

  制限

説明  「レポート幅」プロパティは、レポート・ページの文字単位の幅です。

値  1～9,999までの任意の整数

適用対象  セクション

必須/オプション  必須

デフォルト  66文字


レポート幅の制限

•	キャラクタ・モードのレポートをビットマップのライブ・プレビューア表示で表示する場合、Report Builderはこの設定を使用して表示フォントを選択します。フォントは実際の文字セル・サイズよりわずかに大きくなるか、小さくなることがあります。このため、文字の一部が切り捨てられる可能性があります。


ページ当りの垂直パネル

  例

説明  「ページ当りの垂直パネル」プロパティは、物理ページ（プリンタ・ページ）単位の論理ページ（レポート・ページ）の高さです。たとえば、「ページ当りの垂直パネル」のサイズが1であれば、各論理ページは1物理ページの高さになります。

値  1～50までの任意の整数

適用対象  セクション

必須/オプション  必須

デフォルト  1


幅

  制限

説明  「幅」プロパティは、1物理ページ（マージンを含む）の「サイズの単位」の幅です（例8.5インチ）。

値  0以上の有効な幅を入力します。最大幅は、「サイズの単位」によって異なります。インチの場合、最大幅は512インチになります。センチメートルでは、1,312センチメートルです。ポイントの場合は36,864ポイントになります。

適用対象  セクション

必須/オプション  必須

デフォルト  8.5インチ


幅の制限

•	ページは、セクションが入る大きさである必要があります。たとえば、セクション内のフレームを「幅」以上のサイズに拡張すると、レポートは実行されません。

•	すでに「幅」を指定した後で「サイズの単位」を変更すると、「幅」は新しい「サイズの単位」のおおよその幅に自動的に変更されます。

•	物理ページの「幅」または「高さ」を変更すると、論理ページのサイズがそれに応じて変更され、マージンのサイズが可能な限り保たれます。

注意: 物理ページの印刷可能領域が制限されているプリンタもあります。たとえば、プリンタ用紙は8.5 x 11インチでも、プリンタで印刷できる範囲が8 x 10.5インチしかない場合があります。プリンタの印刷可能な領域を超える「幅」や「高さ」を定義した場合、レポート出力でクリッピングが起きる可能性があります。クリッピングを回避するには、プリンタの印刷可能な領域を広げるか（オペレーティング・システムで設定できる場合）、ページの印刷可能な領域のサイズになるように「幅」と「高さ」を設定します。

•	コマンド・ラインでPAGESIZEパラメータに別の値を指定すると、ページの大きさを上書きできます。

•	左右のデフォルトのマージン・サイズは0です。


?


「列ソート」プロパティ

  制限

ブレーク順序

列のデータ型

コメント

データベース列名

データ型

XML出力から除外

ファイル形式

名前

ファイルからの読込み

NULL時の値

幅

XMLタグ

XMLタグ属性


「列ソート」の制限

•	列ソートは、Expressへの問合せにのみ使用できます。

•	Expressのディメンションのみ対応するソート列を持ち、単位は指定できません。

•	「列ソート」プロパティの編集は、データ・モデル表示またはオブジェクト・ナビゲータで行います。

•	ディメンション値をデータ・モデルの別のグループに移動する場合は、対応するソート列もいっしょに移動する必要があります。

•	ソート列は、データ・ウィザードおよびレポート・ウィザード、レイアウト・モデル表示およびライブ・プレビューアには表示されません。

•	Report Builderは、Expressへの問合せ内のディメンションごとにソート列を生成します。

•	セレクタのソート・ツールを使って、ディメンションの順序を変更します。


?


サマリー列プロパティ

ブレーク順序

列のデータ型

コメント

計算位置

データ型

XMLから除外

ファンクション

ファイル形式

名前

積順序

ファイルからの読込み

リセット位置

ブレーク順序の設定

ソース

NULL時の値

幅

XMLタグ

XMLタグ属性


計算位置

  制限 	  例

説明  「計算位置」プロパティは、「割合（%）」サマリー列が計算されるグループのことです。「計算位置」は、「割合（%）」のファンクションが設定された列に対してのみ使用します。パーセンテージを計算する場合、その値を合計で割ります（たとえば、SMITHの給与/部門の給与合計）。「計算位置」で、パーセンテージ計算の合計が定義されます。Report Builderでは、このフィールドを使用して、各ソース列値がそのパーセンテージとなる合計が決められます。マトリックス・レポートの場合、「計算位置」を複数のグループにすることができます。

値

Page	1ページの合計値のパーセンテージとして、ソース列を計算するために使用します。
Report	レポート内の合計値のパーセンテージとして、ソース列を計算するために使用します。
<names>	グループ内の合計値のパーセンテージとして、ソース列を計算するために使用します。
適用対象  サマリー列。

必須/オプション  「割合（%）」のファンクションを持つサマリー列の場合は、必須。

デフォルト  サマリー列のグループの親グループ。


計算位置の例（グループ・レポート）

  関連項目 	  すべての例

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

Deptno  10    Dname  ACCOUNTING

 Ename              Sal   %Dept    %Total

 ----------- ----------   ------   ------

 MILLER         1300.00   14.86%    6.62%

 CLARK          2450.00   28.00%   12.48%

 KING           5000.00   57.14%   25.48%

Deptno  20    Dname  RESEARCH

 Ename              Sal   %Dept    %Total

 ----------- ----------   ------   ------

 SMITH           800.00    7.36%    4.08%

 ADAMS          1100.00   10.11%    5.61%

 JONES          2975.00   27.36%   15.16%

 SCOTT          3000.00   27.59%   15.29%

 FORD           3000.00   27.59%   15.29%

親グループのG_DEPTには、DEPTNOおよびDNAMEの列が含まれています。子グループのG_EMPには、ENAMEおよびSALの列が含まれています。

部門の給与合計（Pct_Dept）に対するパーセンテージとして、各従業員の給与の合計を求めるには、次の設定でG_EMPにサマリー列を作成します。

ファンクション	リセット位置	計算位置
割合（%）	G_EMP	G_DEPT
この場合、「リセット位置」は、各従業員ごとに集計がNULLに再設定されることを示しています。これは、各従業員に対して個別のパーセンテージを求めるためです。「計算位置」は、その部門の給与合計がパーセンテージを計算するための全体（100%）となることを示しています。各従業員別のパーセンテージを表示するため、この集計がG_EMPグループに置かれていることにも注意する必要があります。

レポート全体（Pct_Total）の給与合計のパーセンテージとして、各従業員の給与の合計を求めるには、次の設定でG_EMPにサマリー列を作成します。

ファンクション	リセット位置	計算位置
割合（%）	G_EMP	Report
この場合、「計算位置」は、レポート全体の給与合計がパーセンテージを計算するための全体（100%）となることを示しています。前述のPct_Dept集計の場合のように、「リセット位置」は、各従業員別のパーセンテージを表示するため、各従業員ごとに集計がNULLに再設定され、その集計がG_EMPグループに置かれることを示しています。


計算位置の例（マトリックス・レポート）

  関連項目 	  すべての例

次のようなマトリックス・レポートがあり、それにいくつかのパーセンテージの集計を追加するとします。

Dept Analyst   Clerk   Manager   Total

10              1300      2450    3750

20      6000    1900      2975   10875

30               950      2850    3800

Total   6000    4150      8275   18425

グループG_JOBには列JOB、G_DEPTにはDEPTNO、G_SALにはSUMSALが含まれていて、G_CROSSはクロス積グループです（G_CROSSには、このマトリックスのすべての集計が含まれています）。

1部門あたりの各職種カテゴリの給与合計を、すべての部門におけるその職種の給与合計のパーセンテージとして計算する集計を求めるには、G_CROSSのサマリー列に次の設定を入力してください。

ファンクション	リセット位置	計算位置	積順序
割合（%）	G_DEPT	G_JOB	G_JOB, G_DEPT
この場合、「リセット位置」は、各部門ごとに集計がNULLに再設定されることを示します。これは、各部門に対して個別のパーセンテージを求めるためです。「計算位置」は、各職種カテゴリの給与合計がパーセンテージを計算するための全体（100%）となることを示しています。このマトリックスに使用されるすべての集計はクロス積グループに属していなければならないので、この集計がG_CROSS内に置かれていることにも注意する必要があります。

注意: これはマトリックス・レポートなので、集計には「積順序」を使用する必要があります。「積順序」の詳細は、「積順序」.を参照してください（その中の一例では、この例と同じ出力を使用して、「積順序」の使用方法がより詳しく説明されています）。

  ここをクリックしてください。


計算位置の制限

•	列が集計であり、「ファンクション」が「割合（%）」である場合にのみ、「計算位置」は編集できます。

•	サマリー列のグループが「レポート」でない場合は、サマリー列の「計算位置」グループを、「レポート」および「ページ」を含めてサマリー列のグループもしくはそれより上の任意のグループにすることができます。

•	クロス積グループに属しているサマリー列には、「Page」という「計算位置」を設定できません。

•	サマリーに「Page」という「計算位置」が設定されている場合は、それを表示するフィールドまたはボイラープレート・オブジェクトのサイズが固定されている必要があります。


            Analyst Pct_Job   Clerk Pct_Job   Manager Pct_Job  Total

    Dept   -------- -------  ------ -------  -------- ------- ------

    10                         1300  31.33%      2450  29.61%   3750

    20         6000 100.00%    1900  45.78%      2975  35.95%  10875

    30                          950  22.89%      2850  34.44%   3800

    Total      6000            4150              8275          18425

             (100%)          (100%)            (100%)


ファンクション

  制限

説明  「ファンクション」プロパティは、「ソース」で指定された列の値に対して実行される計算です。累計集計を作成するには、該当するグループに列を入れ、「リセット位置」と「ファンクション」を組み合せて使用します。

値

平均	リセット・グループ内の列の値の平均を計算します。
カウント	リセット・グループ内のレコード数をカウントします。
最初	リセット・グループにフェッチされた列の最初の値を印刷します。
最後	リセット・グループにフェッチされた列の最後の値を印刷します。
最大値	リセット・グループ内の列の最大値を計算します。
最小値	リセット・グループ内の列の最小値を計算します。
割合（%）	リセット・グループ内の列の合計に対するパーセントを計算します。
標準偏差	リセット・グループの平方偏差の正の平方根を計算します。
合計	リセット・グループ内の列の値の合計を計算します。
分散	リセット・グループの列の平均値と各値との差を2乗し、その和を値の数より1小さい数で除算します。
適用対象  サマリー列。

必須/オプション  サマリー列の場合は必須。

デフォルト  ブランク。


ファンクションの制限

•	「ファンクション」は、列のタイプが「サマリー」である場合のみ、編集できます。

•	「合計」、「平均」、「割合（%）」、「標準偏差」および「分散」は、「Number」のデータ型のフィールドに対してのみ、適用できます。

•	Report Builderでは、集計関数値を計算される列のデータ型をベースにして、集計にデータ型が設定されます。

•	集計関数値を計算される列を変更すると、それに合わせて集計のデータ型も変更されます。

•	レポート・レベルの集計には、「割合（%）」の「ファンクション」を設定できません。レポート・レベルの列にこのファンクションを設定した場合、列値は常に100%となるので、設定する意味がありません。

•	「割合（%）」または「合計」、「分散」の「ファンクション」が設定された列を、ブレーク列にすることはできません。また、この列にはブレーク順序を設定できません。

•	列の平均を計算するとき、NULL値は無視されます（つまり、「平均」の「ファンクション」では、NULL値と0（ゼロ）は区別されます）。


積順序

  制限 	  例

説明  「積順序」プロパティは、集計を出すためにクロス積で評価されるグループの順序のことです。「積順序」は、クロス積グループ内の集計、式またはプレースホルダの度数も定義します。つまり、集計、式、またはプレースホルダは、「積順序」におけるグループの各値の組合せに対して、それぞれ1つずつしか値を持ちません。「積順序」は、クロス積グループに属する列に対してのみ使用します。クロス積は複数のグループに関係するため、クロス積内のグループを多数の異なる順序で評価できます。したがって、クロス積の集計を作成する場合、Report Builderで「積順序」を使用して、評価する最初のグループ、2番目のグループというように指定する必要があります。また、「積順序」を使用して、クロス積内の集計、式またはプレースホルダの度数も指定する必要があります。

値  有効なグループの組合せ。

適用対象  集計、式、プレースホルダの列。

必須/オプション  クロス積グループに属するサマリー列または式列の場合は必須。


積順序の例（1つのグループ）

  関連項目 	  すべての例

次のようなマトリックス・レポートがあるとします。

  ここをクリックしてください。

グループG_JOBには列JOB、G_DEPTにはDEPTNO、G_YEARにはYEAR、G_SALにはSUMSALが含まれていて、G_CROSSはクロス積グループです（G_CROSSには、このマトリックスのすべての集計が含まれています）。

職種別の給与合計を求めるには、次の設定でG_CROSS内にサマリー列を作成します。

ファンクション	リセット位置	積順序
割合（%）	G_JOB	G_JOB
この場合、G_JOBの各レコード（つまり、各職種カテゴリ）の合計を計算させようとしているので、「積順序」はG_JOBになります（この集計は、マトリックスの最下部に表示されます）。

年度別の給与合計を求めるには、次の設定でG_CROSS内にサマリー列を作成します。

ファンクション	リセット位置	積順序
合計	G_YEAR	G_YEAR
この場合、G_YEARの各レコード（つまり、各年度）の集計を計算させようとしているので、「積順序」はG_YEARになります。（この集計は、マトリックスの右枠に沿って、ボイラープレート・ラインのすぐ下に表示されます。）

各年度の部門別の給与合計を求めるには、次の設定でG_CROSS内にサマリー列を作成します。

ファンクション	リセット位置	積順序
合計	G_DEPT	G_YEAR, G_DEPT
この場合、集計は各年度の各部門（G_DEPTおよびG_YEAR）の合計を計算します。この集計では、G_YEARの度数が最も低く（つまり、G_DEPTの3つのレコードに対して1度しか変化しない）、G_DEPTの度数が最も高くなります（つまり、G_YEARの各レコードに対して3度変化する）。結果として、「積順序」には、最初にG_YEAR（最も度数の低いグループ）が表示され、2番目にG_DEPT（最も度数の高いグループ）が表示されます。


積順序の例（複数のグループ）

  関連項目 	  すべての例

次のようなマトリックス・レポートがあり、それにいくつかのパーセンテージの集計を追加するとします。

Dept Analyst   Clerk  Manager  Total

10              1300     2450   3750

20      6000    1900     2975  10875

30               950     2850   3800

Total   6000    4150     8275  18425

グループG_JOBには列JOB、G_DEPTにはDEPTNO、G_SALにはSUMSALが含まれていて、G_CROSSはクロス積グループです。

1部門あたりの各職種カテゴリの給与合計を、すべての部門におけるその職種の給与合計のパーセンテージとして計算する集計を求めるには、G_CROSSの集計列に次の設定を入力してください。

ファンクション	リセット位置	計算位置	積順序
割合（%）	G_DEPT	G_JOB	G_JOB, G_DEPT
この場合、集計がマトリックスの縦方向を計算してから横方向を計算するようにしています。集計は初めは縦に向かうので、G_JOBの度数は最も低くなり（3つの部門で1度しか変化しない）、「積順序」で第1番目のグループになります。縦に向かった後、集計はマトリックスの横に向かうので、G_DEPTの度数は最も高くなり（1つの職種で3度変化する）、「積順序」では第2番目のグループになります。

  ここをクリックしてください。

職種カテゴリあたりの各部門の給与合計を、その部門の給与合計のパーセンテージとして計算する集計を求めるには、G_CROSSのサマリー列に次の設定を入力してください。

ファンクション	リセット位置	計算位置	積順序
割合（%）	G_JOB	G_DEPT	G_DEPT, G_JOB
この場合、集計がマトリックスの横方向を計算してから縦方向を計算するようにしています。集計は初めは横に向かうので、G_DEPTの度数は最も低くなり（3つの職種で1度しか変化しない）、「積順序」で第1番目のグループになります。横に向かった後、集計はマトリックスの縦に向かうので、 G_JOBの度数は最も高くなり（1つの部門で3度変化する）、「積順序」では第2番目のグループになります。

  ここをクリックしてください。

職種カテゴリあたりの各部門の給与合計を、レポート内の給与合計のパーセンテージとして計算する集計を求めるには、G_CROSSのサマリー列に次の設定を入力してください。

ファンクション	リセット位置	計算位置	積順序
割合（%）	G_JOB	Report	G_DEPT, G_JOB
この場合、集計はマトリックスの横方向を計算してから縦方向を計算することも、縦方向を計算してから横方向を計算することもあります。これは、レポート全体に対してこの集計を計算（たとえば、「計算位置」は 「Report」）しているためです。「積順序」は、「G_DEPT、G_JOB」（横、縦）または「G_JOB、G_DEPT」（縦、横）のどちらでもかまいません。ただし、「リセット位置」は最も度数の高いグループである必要があることに注意してください。したがって、「G_JOB、G_DEPT」の場合はG_DEPT、「G_DEPT、G_JOB」の場合はG_JOBになります。

  ここをクリックしてください。


積順序の例（式）

  関連項目 	  すべての例

次のようなマトリックス・レポートがあり、それに1つの式を追加するとします。

Dept Analyst   Clerk  Manager  President  Salesman

10              1300     2450      5000

20      6000    1900     2975

30               950     2850                 5600

グループG_JOBには列JOB、G_DEPTにはDEPTNO、G_SALにはSUMSALが含まれていて、G_CROSSはクロス積グループです。

各部門の課税後の給与合計を計算する式を追加するには、まず次の設定でG_CROSS内にサマリー列（DEPTSUM）を作成します。

ファンクション	リセット位置	積順序
割合（%）	G_DEPT	G_DEPT
次に、次の設定でG_CROSS内に式（AFTERTAX）を作成します。

式	積順序
:deptsum * .9	G_DEPT
式はG_CROSS内にあるので、「積順序」を指定する必要があります。この場合、式の度数は、サマリー列（DEPTSUM）と同じです。これによって、式は次のように計算されます。

Dept Analyst   Clerk  Manager  President  Salesman  Comp

10              1300     2450      5000             7875

20      6000    1900     2975                       9788

30               950     2850                 5600  8460


積順序の制限

•	このフィールドは、集計、式、またはプレースホルダ列のグループがクロス積である場合にのみ使用できます。

•	累計集計ではない集計（つまり、「リセット位置」が「Report」でない）には、そのソース列の「積順序」のサブセットである「積順序」が必要です。集計のソース列の度数は、集計の度数と同じか、それ以上にしてください。つまり、集計の「積順序」は、ソース列の「積順序」の一部が含まれたサブセットにしてください。

•	累計集計（つまり、「リセット位置」が「Report」）には、ソース列の「積順序」の接頭辞になっている「積順序」が必要です。たとえば、ソース列の「積順序」がA、B、Cであるとすると、集計列の「積順序」はA（それ自体である場合）またはA、Bとなります。この集計の「積順序」を、B、Aとすることはできません。


Job         ANALYST    CLERK      MANAGER    PRESIDENT    SALESMAN

            -------    -----      -------    ---------    --------

Year  Dept

----  ----

80      10

        20               800                                            800

        30

                                                                     ------

                                                                        800

81      10                           2450         5000                 7450

        20     3000                  2975                              5975

        30               950         2850                     5600     9400

                                                                     ------

                                                                      22825

82      10              1300                                           1300

        20     3000                                                    3000

        30

                                                                     ------

                                                                       4300

83      10

        20              1100                                           1100

        30

                                                                     ------

                                                                       1100

            -------    -----      -------    ---------    --------

               6000     4150         8275         5000        5600


       Analyst  Pct_Job  Clerk  Pct_Job  Manager  Pct_Job Total

Dept   -------- -------  ------ -------  -------- ------- ------

10                         1300  31.33%      2450  29.61%   3750

20         6000 100.00%    1900  45.78%      2975  35.95%  10875

30                          950  22.89%      2850  34.44%   3800

Total      6000            4150              8275          18425

                100%             100%              100%


       Analyst Pct_Job   Clerk Pct_Job   Manager Pct_Job  Total

Dept   -------- -------  ------ -------  -------- ------- ------

10                         1300  34.67%      2450  65.33%   3750

                                                            100%

20         6000  55.17%    1900  17.47%      2975  27.36%  10875

                                                            100%

30                          950  25.00%      2850  75.00%   3800

                                                            100%

Total      6000            4150              8275          18425


        Analyst Pct_Job   Clerk Pct_Job   Manager Pct_Job  Total

Dept   -------- -------  ------ -------  -------- ------- ------

10                         1300   7.06%      2450  13.30%   3750

20         6000  32.56%    1900  10.31%      2975  16.15%  10875

30                          950   5.16%      2850  15.47%   3800

Total      6000            4150              8275          18425

                                                            100%


リセット位置

  制限 	  例

説明  「リセット位置」プロパティは、サマリー列値が0（ゼロ）（「ファンクション」が「カウント」である場合）またはNULL（「ファンクション」が「カウント」ではない場合）、NULL時の値（列がそれを持っている場合）に再設定されるグループです。「リセット位置」には、有効なリセット・グループが含まれている値リストがあります。「リセット位置」では、集計が累計集計であるか、または周期的（たとえば、グループ・レベル）集計であるかについて判断されます。

値

Page	ページ・レベルの集計に使用します。集計はページ間で再設定されます。
Report	総計など、レポート全体に対して適用される集計に使用されます。集計は、レポートが終わるごとに再設定されます（つまり、一度も再設定されません）。
<names>	有効なグループ名です。集計は、グループの各レコードが終わるごとに再設定されます。
適用対象  サマリー列。

必須/オプション  タイプがサマリーの列の場合は必須。

使用上の注意

•	サマリー列のリセット・グループは、「レポート」および「ページ」を含めて、そのグループか、またはグループより上の任意のグループにすることができます。

•	ページの集計を想定したとおりに実行するには、各レコードを確実に1ページに収めるようにします。収まらない場合は、各新規レコードを次のページに印刷するようにします。


リセット位置の例（グループ）

  関連項目 	  すべての例

次のようなグループ・レポートを希望しているとします。

DEPT NAME    SAL  RESETSUM RUNSUM

---- ------- ---- -------- ------

10   SMITH   1000 1000     1000

     JONES   1000 2000     2000

     KING    1000 3000     3000

20   JOHNSON 1500 1500     4500

     WARD    1000 2500     5500

親グループG_DEPTには、DEPTNO列が含まれています。子グループG_EMPには、ENAMEおよびSALが含まれています。各部門の給与合計（RESETSUM）を求めるには、次の設定でG_EMPにサマリー列を作成します。

ファンクション	リセット位置
合計	G_DEPT
この場合、「リセット位置」は、各部門が終わるごとに集計がNULLに設定されることを示しています。

累計の給与合計（RUNSUM）を求めるには、次の設定でG_EMPにサマリー列を作成します。

ファンクション	リセット位置
合計	Report
この場合、「リセット位置」は、集計がNULLに再設定されないで、レポートの終わりまで累計加算されることを示しています。


リセット位置の制限

•	「リセット位置」は、サマリー列の場合にのみ編集できます。

•	クロス積グループに属しているサマリー列では、「リセット位置」として「Page」を設定できません。

•	集計に「Page」という「リセット位置」が設定されている場合、それを表示するフィールドまたはボイラープレート・オブジェクトのサイズを固定してください。

•	列に「Page」という「リセット位置」が設定されている場合、それをソースとして使用する任意のフィールドは、その列のグループをソースとして使用する繰返し枠の中にあることが必要です。

•	「Page」 という「リセット位置」は、集計に必要なグループと関係付けられた複数の繰返し枠が入っているレポートに対しては、稼動しません。この一般的なケースが、マトリックス・レポートです。結果として、マトリックス・レポートにはページ・レベルの集計は使用できません。

•	同じ親グループを持つ子グループ内の複数のサマリー列の場合は、「Page」の「リセット位置」は間違った結果を生む可能性があります。

•	データ・モデルに同じ親を持つ複数の子グループが含まれている場合（たとえば、マスター-ディテール-ディテール）、「Page」の「リセット位置」を持つ集計列により、予想外の結果になることがあります。


ソース

  制限

説明  「ソース」プロパティは、集計関数値を計算する列の名前です。

値  任意の有効な列名。

適用対象  サマリー列。

必須/オプション  サマリー列の場合は必須。

デフォルト  ブランク。


ソースの制限

•	サマリー列のソースは、サマリー列のグループ内またはその下にある（ファンクションに対して有効なデータ型の）列となります。

•	列に「ファイルからの読込み」が指定されていない場合、サマリー列の「ソース」を変更すると、サマリー列のデータ型が新規のソース列のデータ型に合わせて変更されます。

•	どの列も、複数のサマリー列の「ソース」にすることができます。

•	サマリー列のソースを指定した後、レポートからソース列を削除すると、そのサマリー列からは集計関数値を計算するデータにアクセスできなくなります。


?


テンプレート・プロパティ

整列

サマリーをフィールドの位置に合わす

バックグラウンド・カラー

フィールドとラベル間（水平）

枠とフィールド間（水平）

枠とフィールド間（垂直）

マスターとディテール間（水平）

マスターとディテール間（垂直）

ページと枠間（水平）

ページと枠間（垂直）

同等枠間（水平）

同等枠間（垂直）

境界線

文字揃え

破線

日付揃え

枠のバックグラウンド・カラー

枠のフォアグラウンド・カラー

枠のパターン

行当りのフィールド数

塗りパターン

フォント

フォアグラウンド・カラー

イメージ

フィールド間（水平）

フィールド間（垂直）

枠間（水平）

枠間（垂直）

位置揃え

数値揃え

フィールドの上にラベルを置く

位置

スタイル

テキスト

文字色

垂直間隔の使用


整列

説明  「整列」プロパティは、行にあるラベルおよびフィールドをページ内で位置づけする方法を指定します。このプロパティは、「スタイル」が「フォーム」の場合にのみ適用されます。フィールドおよび列の数は「行当りのフィールド数」プロパティで決められます。

値

[←]	1番左のラベルまたはフィールドがページの左側に整列されます。
	ここをクリックしてください。
[→]	1番右のラベルまたはフィールドがページの右側に整列されます。
	ここをクリックしてください。
中央	ラベルおよびフィールドが、ページの中央に揃えられます。
	ここをクリックしてください。
フラッシュ	1番右のラベルまたはフィールドはページの右側に整列され、1番左のラベルまたはフィールドはページの左側に整列されて、ラベルおよびフィールドがページ内で等間隔に位置づけされます。
	ここをクリックしてください。
Column	最大のラベルおよびフィールドの幅を基盤として、ページ内でレベルおよびフィールドが列上に等間隔で整列されます。
	ここをクリックしてください。
適用対象  テンプレート

デフォルト 左


サマリーをフィールドの位置に合わす

説明 「サマリーをフィールドの位置に合わす」プロパティが「はい」に設定されている場合には、ソース・フィールドの下にサマリー･フィールドが位置付けられます。このプロパティは、「スタイル」が「フォーム」の場合にのみ適用されます。

  ここをクリックしてください。

適用対象  テンプレート

デフォルト   はい


バックグラウンド・カラー

説明  「バックグラウンド・カラー」プロパティは、「塗りパターン」プロパティ設定のバックグラウンド・カラーを定義します。

値   カラー・パレットから有効なカラーを選択します。

適用対象  テンプレート

デフォルト   white

使用上の注意

•	「塗りパターン」プロパティが「transparent」に設定されていると、「バックグラウンド・カラー」および「フォアグラウンド・カラー」設定が無視されます。

•	「塗りパターン」プロパティが「ソリッド」に設定されていると、「バックグラウンド・カラー」は無視されて、「フォアグラウンド・カラー」のみが参照できるように設定されます。

PL/SQL PL/SQLを使用してこの属性を定義するには、SRW.SET BACKGROUND FILL COLORプロシージャを使用します。


フィールドとラベル間（水平）

説明  「フィールドとラベル間（水平）」プロパティは、1つのグループにあるフィールドと関係付けられたラベルの間にある水平領域の広さを定義します。このプロパティは、「スタイル」が「フォーム」の場合にのみ適用され、ラベルはフィールドの左側にあります。このように、このプロパティに対する垂直領域はありません。

値   0（ゼロ）以上の値を入力します。値はレポートの「サイズの単位」（インチ、センチメートルまたはポイント）になります。

適用対象  テンプレート

デフォルト  0

使用上の注意

•	「格子指定」がオンの場合は、この設定に関係なく、オブジェクトは一番近い格子指定ポイントに指定されます。より細かい間隔制御をする場合は、レポートの作成時に「格子指定」をオフにできます。しかし、これはオブジェクトが格子指定ポイントに指定されなくなることを意味します。

•	レポートの「サイズの単位」を変更すると、それに従ってこの設定も変更する必要があります。


枠とフィールド間（水平）

説明  「枠とフィールド間（水平）」プロパティは、枠と枠が囲んでいるフィールドの間の水平領域の広さを定義します。

値   0（ゼロ）以上の値を入力します。値はレポートの「サイズの単位」（インチ、センチメートルまたはポイント）になります。

適用対象  テンプレート

デフォルト  0

使用上の注意

•	「格子指定」がオンの場合は、この設定に関係なく、オブジェクトは一番近い格子指定ポイントに指定されます。より細かい間隔制御をする場合は、レポートの作成時に「格子指定」をオフにできます。しかし、これはオブジェクトが格子指定ポイントに指定されなくなることを意味します。

•	レポートの「サイズの単位」を変更すると、それに従ってこの設定も変更する必要があります。


枠とフィールド間（垂直）

説明  「枠とフィールド間（垂直）」プロパティは、枠と枠が囲んでいるフィールドの間の垂直領域の広さを定義します。

値   0（ゼロ）以上の値を入力します。値はレポートの「サイズの単位」（インチ、センチメートルまたはポイント）になります。

適用対象  テンプレート

デフォルト  0

使用上の注意

•	「格子指定」がオンの場合は、この設定に関係なく、オブジェクトは一番近い格子指定ポイントに指定されます。より細かい間隔制御をする場合は、レポートの作成時に「格子指定」をオフにできます。しかし、これはオブジェクトが格子指定ポイントに指定されなくなることを意味します。

•	レポートの「サイズの単位」を変更すると、それに従ってこの設定も変更する必要があります。


マスターとディテール間（水平）

説明  「マスターとディテール間（水平）」プロパティは、マスター・グループ枠とディテール・グループ枠の間の水平領域の広さを定義します。

値   0（ゼロ）以上の値を入力します。値はレポートの「サイズの単位」（インチ、センチメートルまたはポイント）になります。

適用対象  テンプレート

デフォルト  0

使用上の注意

•	「格子指定」がオンの場合は、この設定に関係なく、オブジェクトは一番近い格子指定ポイントに指定されます。より細かい間隔制御をする場合は、レポートの作成時に「格子指定」をオフにできます。しかし、これはオブジェクトが格子指定ポイントに指定されなくなることを意味します。

•	レポートの「サイズの単位」を変更すると、それに従ってこの設定も変更する必要があります。


マスターとディテール間（垂直）

説明  「マスターとディテール間（垂直）」プロパティは、マスター・グループ枠とディテール・グループ枠の間の垂直領域の広さを指定します。

値   0（ゼロ）以上の値を入力します。値はレポートの「サイズの単位」（インチ、センチメートルまたはポイント）になります。

適用対象  テンプレート

デフォルト  0

使用上の注意

•	「格子指定」がオンの場合は、この設定に関係なく、オブジェクトは一番近い格子指定ポイントに指定されます。より細かい間隔制御をする場合は、レポートの作成時に「格子指定」をオフにできます。しかし、これはオブジェクトが格子指定ポイントに指定されなくなることを意味します。

•	レポートの「サイズの単位」を変更すると、それに従ってこの設定も変更する必要があります。


ページと枠間（水平）

説明  「ページと枠間（水平）」プロパティは、ページの枠と最上位グループ枠の間の水平領域の広さを定義します。

値   0（ゼロ）以上の値を入力します。値はレポートの「サイズの単位」（インチ、センチメートルまたはポイント）になります。

適用対象  テンプレート

デフォルト  0

使用上の注意

•	「格子指定」がオンの場合は、この設定に関係なく、オブジェクトは一番近い格子指定ポイントに指定されます。より細かい間隔制御をする場合は、レポートの作成時に「格子指定」をオフにできます。しかし、これはオブジェクトが格子指定ポイントに指定されなくなることを意味します。

•	レポートの「サイズの単位」を変更すると、それに従ってこの設定も変更する必要があります。


ページと枠間（垂直）

説明  「ページと枠間（垂直）」プロパティは、ページの枠と最上位グループ枠の間の垂直領域の広さを定義します。

値   0（ゼロ）以上の値を入力します。値はレポートの「サイズの単位」（インチ、センチメートルまたはポイント）になります。

適用対象  テンプレート

デフォルト

使用上の注意

•	「格子指定」がオンの場合は、この設定に関係なく、オブジェクトは一番近い格子指定ポイントに指定されます。より細かい間隔制御をする場合は、レポートの作成時に「格子指定」をオフにできます。しかし、これはオブジェクトが格子指定ポイントに指定されなくなることを意味します。

•	レポートの「サイズの単位」を変更すると、それに従ってこの設定も変更する必要があります。


同等枠間（水平）

説明 「同等枠間（水平）」プロパティは、同一レベルにあるグループの枠の間の水平領域の広さを定義します。グループは分かれている場合と、同じ親グループを共有している場合があります。

値   0（ゼロ）以上の値を入力します。値はレポートの「サイズの単位」（インチ、センチメートルまたはポイント）になります。

適用対象  テンプレート

デフォルト  0

使用上の注意

•	「格子指定」がオンの場合は、この設定に関係なく、オブジェクトは一番近い格子指定ポイントに指定されます。より細かい間隔制御をする場合は、レポートの作成時に「格子指定」をオフにできます。しかし、これはオブジェクトが格子指定ポイントに指定されなくなることを意味します。

•	レポートの「サイズの単位」を変更すると、それに従ってこの設定も変更する必要があります。


同等枠間（垂直）

説明 「同等枠間（垂直）」プロパティは、同一レベルにあるグループの枠の間の垂直領域の広さを定義します。グループは分かれている場合と、同じ親グループを共有している場合があります。

値   0（ゼロ）以上の値を入力します。値はレポートの「サイズの単位」（インチ、センチメートルまたはポイント）になります。

適用対象  テンプレート

デフォルト  0

使用上の注意

•	「格子指定」がオンの場合は、この設定に関係なく、オブジェクトは一番近い格子指定ポイントに指定されます。より細かい間隔制御をする場合は、レポートの作成時に「格子指定」をオフにできます。しかし、これはオブジェクトが格子指定ポイントに指定されなくなることを意味します。

•	レポートの「サイズの単位」を変更すると、それに従ってこの設定も変更する必要があります。


境界線

説明 「境界線」プロパティは、オブジェクトのどの境界線を表示するかを定義します。

値

すべて	すべての境界線を表示します。
上のみ	1番上の境界線のみを表示します。
下のみ	1番下の境界線のみを表示します。
左のみ	左の境界線のみを表示します。
右のみ	右の境界線のみを表示します。
上と下	1番上と1番下の境界線のみを表示します。
左と右	左と右の境界線のみを表示します。
上と右	1番上と右の境界線のみを表示します。
上と左	1番上と左の境界線のみを表示します。
下と右	1番下と右の境界線のみを表示します。
下と左	1番下と左の境界線のみを表示します。
上以外すべて	1番上の境界線以外のすべてを表示します。
下以外すべて	1番下の境界線以外のすべてを表示します。
左以外のすべて	左の境界線以外のすべてを表示します。
右以外のすべて	右の境界線以外のすべてを表示します。
なし	境界線を表示します。
適用対象  テンプレート

デフォルト  すべて


文字揃え

説明  フィールドの「ソース」のデータ型がCHARACTERである場合に、「文字揃え」プロパティは、フィールドまたはラベルのテキストの整列方法を定義します。

値

[←]	テキストが左側に整列されることを意味します。
中央	テキストが中央に整列されます。
[→]	テキストが右側に整列されます。
始点	使用している言語が通常左右のどちらから書き始められるかによって、テキストが左側または右側に整列されます。たとえば、左から右に流れる言語の場合は、「始点」を指定するとテキストが左側に数値揃えされます。反対に、右から左に流れる言語の場合、「始点」を指定するとテキストが右側に数値揃えされます。
[End]	使用している言語が通常左右のどちらで終わるかによって、テキストが左側または右側に整列されます。たとえば、左から右に流れる言語の場合は、「終点」を指定するとテキストが右側に数値揃えされます。反対に、右から左に流れる言語の場合は、「終点」を指定するとテキストが左側に数値揃えされます。
適用対象  テンプレート

デフォルト  始点

PL/SQL PL/SQLを使用してこの属性を定義するには、SRW.SET JUSTIFICATIONプロシージャを使用します。


破線

説明  「破線」プロパティは、オブジェクトの線/線種スタイルを定義します。

値   リストから有効な線/線種パターンを選択します。

適用対象  テンプレート

デフォルト  実線


日付揃え

説明  フィールドの「ソース」のデータ型がDATEである場合に、「日付揃え」プロパティは、フィールドまたはラベルのテキストの整列方法を定義します。

値

[←]	テキストが左側に整列されます。
中央	テキストが中央に整列されます。
[→]	テキストが右側に整列されます。
始点	使用している言語が通常左右のどちらから書き始められるかによって、テキストが左側または右側に整列されます。たとえば、左から右に流れる言語の場合は、「始点」を指定するとテキストが左側に数値揃えされます。反対に、右から左に流れる言語の場合、「始点」を指定するとテキストが右側に数値揃えされます。
終点	使用している言語が通常左右のどちらで終わるかによって、テキストが左側または右側に整列されます。たとえば、左から右に流れる言語の場合は、「終点」を指定するとテキストが右側に数値揃えされます。反対に、右から左に流れる言語の場合は、「終点」を指定するとテキストが左側に数値揃えされます。
値   入力

適用対象  テンプレート

デフォルト  始点

PL/SQL PL/SQLを使用してこの属性を定義するには、SRW.SET JUSTIFICATIONプロシージャを使用します。


枠のフォアグラウンド・カラー

説明  「枠のフォアグラウンド・カラー」は、「枠のパターン」プロパティ設定のフォアグラウンド・カラーを定義します。

値   カラー・パレットから有効なカラーを選択します。

適用対象  テンプレート

デフォルト  black

使用上の注意

•	「枠のパターン」プロパティが「transparent」に設定されていると、「枠のバックグラウンド・カラー」および「枠のフォアグラウンド・カラー」設定が無視されます。

•	「枠のパターン」プロパティが「ソリッド」に設定されていると、「枠のフォアグラウンド・カラー」設定のみが参照できます（「枠のバックグラウンド・カラー」設定は無視されます）。

PL/SQL PL/SQLを使用してこの属性を定義するには、SRW.SET FOREGROUND BORDER COLORプロシージャを使用します。


枠のバックグラウンド・カラー

説明  「枠のバックグラウンド・カラー」プロパティは、「枠のパターン」プロパティ設定のバックグラウンド・カラーを定義します。

値   カラー・パレットから有効なカラーを選択します。

適用対象  テンプレート

デフォルト   white

使用上の注意

•	「枠のパターン」プロパティが「transparent」に設定されていると、「枠のバックグラウンド・カラー」および「枠のフォアグラウンド・カラー」の両方の設定が無視されます。

•	「枠のパターン」プロパティが「ソリッド」に設定されていると、「枠のバックグラウンド・カラー」設定は無視され、「枠のフォアグラウンド・カラー」設定のみが参照されます。

PL/SQL PL/SQLを使用してこの属性を定義するには、SRW.SET BACKGROUND BORDER COLORプロシージャを使用します。


枠のパターン

説明  「枠のパターン」プロパティは、オブジェクトの境界線に使用するパターンを定義します。「枠のフォアグラウンド・カラー」および「枠のバックグラウンド・カラー」プロパティを使用して、バックグラウンドおよびフォアグラウンドのカラーを定義できます。

値   パターン・パレットから有効なパターンを選択します。

適用対象  テンプレート

デフォルト  transparent

使用上の注意

•	「枠のパターン」プロパティが「transparent」に設定されていると、「枠のフォアグラウンド・カラー」および「枠のバックグラウンド・カラー」プロパティ設定が無視されます。

•	「枠のパターン」プロパティが「ソリッド」に設定されていると、「枠のフォアグラウンド・カラー」設定のみが参照できます。

PL/SQL PL/SQLを使用してこの属性を定義するには、SRW.SET BORDER PATTERNプロシージャを使用します。


行当りのフィールド数

説明  「行当りのフィールド数」プロパティは、行に表示される、空白を許すフィールド/ラベルの組合せの最大数を定義します。たとえば、2つのフィールド/ラベルの組合せに対して空白が1つのみあり、値が3に設定されている場合は、2つのフィールド/ラベルの組合せのみが表示されます。しかし、4つのフィールド/ラベルの組合せに対して空白があり、値が3に設定されている場合は、3が最大許可数であるために、3つの組合せのみが表示されます。このプロパティは、「スタイル」が「フォーム」の場合にのみ適用されます。

値   0（ゼロ）以上の値を入力します。0（ゼロ）は、最大値がなく、行に収まるのみのフィールド/ラベルの組合せが表示されることを示しています。

適用対象  テンプレート

デフォルト  0


塗りパターン

説明  「塗りパターン」プロパティは、オブジェクトで囲む領域に使用するパターンを定義します。「フォアグラウンド・カラー」および「バックグラウンド・カラー」プロパティを使用して、塗りパターンのバックグラウンドおよびフォアグラウンドのカラーを定義できます。

値   パターン・パレットから有効なパターンを選択します。

適用対象  テンプレート

デフォルト  transparent

使用上の注意

•	「塗りパターン」プロパティが「transparent」に設定されていると、「フォアグラウンド・カラー」および「バックグラウンド・カラー」プロパティ設定が無視されます。

•	「塗りパターン」プロパティが「ソリッド」に設定されていると、「フォアグラウンド・カラー」設定のみが参照できます。

PL/SQL PL/SQLを使用してこの属性を定義するには、SRW.SET FILL PATTERNプロシージャを使用します。


フォント

説明  「フォント」プロパティは、オブジェクトで使用するテキスト・フォントを定義します。

値   使用しているシステムのフォントのリストから有効なフォントを選択してください。

適用対象  テンプレート

デフォルト  Courier、10ポイント、Regular

PL/SQL PL/SQLを使用してフォントを定義するには、SRW.SET FONT FACEプロシージャを使用します。PL/SQLを使用してフォント・サイズを定義するには、SRW.SET FONT SIZEプロシージャを使用します。PL/SQLを使用してフォント・スタイルを定義するには、SRW.SET FONT STYLEプロシージャを使用します。


フォアグラウンド・カラー

説明  「フォアグラウンド・カラー」は、「塗りパターン」プロパティ設定のフォアグラウンド・カラーを定義します。

値   カラー・パレットから有効なカラーを選択します。

適用対象  テンプレート

デフォルト  black

使用上の注意

•	「塗りパターン」プロパティが「transparent」に設定されていると、「フォアグラウンド・カラー」および「バックグラウンド・カラー」設定が無視されます。

•	「塗りパターン」プロパティが「ソリッド」に設定されていると、「フォアグラウンド・カラー」設定のみが参照できます（「バックグラウンド・カラー」設定は無視されます）。

PL/SQL PL/SQLを使用してこの属性を定義するには、SRW.SET FOREGROUND FILL COLORプロシージャを使用します。


イメージ

説明  「イメージ」プロパティは、使用しているテンプレート内のリンク・ファイル（外部）・ボイラープレート・オブジェクトで参照されるイメージ用の代用ファイルです。

値   有効なテキスト・ファイルの名前を入力します。

適用対象  テンプレート

デフォルト  なし


フィールド間（水平）

説明  「フィールド間（水平）」プロパティは、1つのグループにあるフィールド間の水平領域の広さを定義します。「スタイル」が「フォーム」の場合、このプロパティは、1つのグループにあるフィールド/ラベルの組合せの終点と別のフィールド/ラベルの組合せの始点間の水平領域の広さを定義します。フィールドとラベル間の距離は、「フィールドとラベル間（水平）」プロパティの設定で決められます。

値   0（ゼロ）以上の値を入力します。値はレポートの「サイズの単位」（インチ、センチメートルまたはポイント）になります。

適用対象  テンプレート

デフォルト  .174インチ

使用上の注意

•	「格子指定」がオンの場合は、この設定に関係なく、オブジェクトは一番近い格子指定ポイントに指定されます。より細かい間隔制御をする場合は、レポートの作成時に「格子指定」をオフにできます。しかし、これはオブジェクトが格子指定ポイントに指定されなくなることを意味します。

•	レポートの「サイズの単位」を変更すると、それに従ってこの設定も変更する必要があります。


フィールド間（垂直）

説明  「フィールド間（垂直）」プロパティは、1つのグループにあるフィールド間の垂直領域の広さを定義します。

値   0（ゼロ）以上の値を入力します。値はレポートの「サイズの単位」（インチ、センチメートルまたはポイント）になります。

適用対象  テンプレート

デフォルト  0

使用上の注意

•	「格子指定」がオンの場合は、この設定に関係なく、オブジェクトは一番近い格子指定ポイントに指定されます。より細かい間隔制御をする場合は、レポートの作成時に「格子指定」をオフにできます。しかし、これはオブジェクトが格子指定ポイントに指定されなくなることを意味します。

•	レポートの「サイズの単位」を変更すると、それに従ってこの設定も変更する必要があります。


枠間（水平）

説明  「枠間（水平）」プロパティは、1つのグループにある枠間の水平領域の広さを定義します。

値   0（ゼロ）以上の値を入力します。値はレポートの「サイズの単位」（インチ、センチメートルまたはポイント）になります。

適用対象  テンプレート

デフォルト  .0087インチ

使用上の注意

•	「格子指定」がオンの場合は、この設定に関係なく、オブジェクトは一番近い格子指定ポイントに指定されます。より細かい間隔制御をする場合は、レポートの作成時に「格子指定」をオフにできます。しかし、これはオブジェクトが格子指定ポイントに指定されなくなることを意味します。

•	レポートの「サイズの単位」を変更すると、それに従ってこの設定も変更する必要があります。


枠間（垂直）

説明  「枠間（垂直）」プロパティは、1つのグループにある枠間の垂直領域の広さを定義します。

値   0（ゼロ）以上の値を入力します。値はレポートの「サイズの単位」（インチ、センチメートルまたはポイント）になります。

適用対象  テンプレート

デフォルト  .0136 インチ

使用上の注意

•	「格子指定」がオンの場合は、この設定に関係なく、オブジェクトは一番近い格子指定ポイントに指定されます。より細かい間隔制御をする場合は、レポートの作成時に「格子指定」をオフにできます。しかし、これはオブジェクトが格子指定ポイントに指定されなくなることを意味します。

•	レポートの「サイズの単位」を変更すると、それに従ってこの設定も変更する必要があります。


位置揃え

説明  「位置揃え」プロパティは、タイトルのテキストの整列方法を定義します。

値

[←]	テキストが左側に整列されます。
中央	テキストが中央に整列されます。
フラッシュ	テキストが左側と右側に整列されます。
[→]	テキストが右側に整列されます。
始点	使用している言語が通常左右のどちらから書き始められるかによって、テキストが左側または右側に整列されます。たとえば、左から右に流れる言語の場合は、「始点」を指定するとテキストが左側に数値揃えされます。反対に、右から左に流れる言語の場合、「始点」を指定するとテキストが右側に数値揃えされます。
終点	使用している言語が通常左右のどちらで終わるかによって、テキストが左側または右側に整列されます。たとえば、左から右に流れる言語の場合は、「終点」を指定するとテキストが右側に数値揃えされます。反対に、右から左に流れる言語の場合は、「終点」を指定するとテキストが左側に数値揃えされます。
適用対象  テンプレート

デフォルト  始点


数値揃え

説明  フィールドの「ソース」のデータ型がNUMBERである場合に、「数値揃え」プロパティは、フィールドまたはラベルのテキストの整列方法を定義します。

値

[←]	テキストが左側に整列されます。
中央	テキストが中央に整列されます。
[→]	テキストが右側に整列されます。
始点	使用している言語が通常左右のどちらから書き始められるかによって、テキストが左側または右側に整列されます。たとえば、左から右に流れる言語の場合は、「始点」を指定するとテキストが左側に数値揃えされます。反対に、右から左に流れる言語の場合、「始点」を指定するとテキストが右側に数値揃えされます。
終点	使用している言語が通常左右のどちらで終わるかによって、テキストが左側または右側に整列されます。たとえば、左から右に流れる言語の場合は、「終点」を指定するとテキストが右側に数値揃えされます。反対に、右から左に流れる言語の場合は、「終点」を指定するとテキストが左側に数値揃えされます。
適用対象  テンプレート

デフォルト  始点

PL/SQL PL/SQLを使用してこの属性を定義するには、SRW.SET JUSTIFICATIONプロシージャを使用します。


フィールドの上にラベルを置く

説明  「フィールドの上にラベルを置く」プロパティは、「はい」に設定されている場合には、ラベルをフィールドの左側ではなくフィールドの上に位置決めします。このプロパティは、「スタイル」が「フォーム」の場合にのみ適用されます。

適用対象  テンプレート

デフォルト  いいえ


位置

説明  「位置」プロパティは、子オブジェクトに関する親オブジェクトの配置を定義します。

適用対象  テンプレート

デフォルト  親オブジェクトは、子オブジェクトの上に表示されます。


スタイル

説明  「スタイル」プロパティは、グループに「表」スタイル・レイアウトまたは「フォーム」スタイル・レイアウトのどちらが指定されるかを定義します。このプロパティを使用して、以下にリストされているデフォルトを上書きすることができます。

値

表	ラベルがフィールドの上にあり、フィールドを含む繰返し枠の外側にあることを意味します。
	ここをクリックしてください。
フォーム	ラベルがフィールドの左側にあり、フィールドを含む繰返し枠の内側にあることを意味します。
	ここをクリックしてください。
適用対象  テンプレート

デフォルト  デフォルトの「スタイル」は、次のように、テンプレートのレイアウト・スタイルで決められます。

表	表
左のグループ	表
上のグループ	子グループのあるグループの場合は「フォーム」。 子グループのないグループの場合は「表」。
フォーム形式	フォーム
フォーム・レター	該当なし（上書き不可）。
メール・ラベル	該当なし（上書き不可）。
マトリックス	表（上書き不可）。
マトリックス・ブレーク	表（上書き不可）。


テキスト

 関連項目

説明  「テキスト」プロパティは、テンプレート内のボイラープレート・テキスト・オブジェクトで使用する代替ファイルです。

値   有効なテキスト・ファイルの名前を入力します。

適用対象  テンプレート

デフォルト  なし


文字色

説明  「文字色」プロパティは、オブジェクトで使用する文字色を定義します。

値   カラー・パレットから有効なカラーを選択します。

適用対象  テンプレート

デフォルト  black

PL/SQL PL/SQLを使用してこの属性を定義するには、SRW.SET COLOR TEXTプロシージャを使用します。


垂直間隔の使用

説明  「垂直間隔の使用」プロパティは、「はい」に設定されている場合は、オブジェクトを前行の未使用の領域に置きます。たとえば、後続の行にあるオブジェクトが前行の未使用領域に収まる場合は、オブジェクトは未使用領域を占めるように移動されます。

  ここをクリックしてください。

このプロパティは、「スタイル」が「フォーム」の場合にのみ適用されます。

適用対象  テンプレート

デフォルト   はい


「いいえ」に設定されているときは、前行の未使用領域は保存されます。

「はい」に設定されているときは、オブジェクトは未使用領域を埋めるように移動されます。


「はい」に設定されているときは、サマリーはソースと一緒に整列されます。

「いいえ」に設定されているときは、サマリーは他の場所か、または表示されているようにマスター・レコードに配置されます。


XMLプロパティ

XMLタグ

XMLタグ属性

XML出力から除外

XML Prolog型

XML Prolog値

外部XMLタグ

外部XML属性

XMLタグを含む


XMLの設定

  関連項目

説明  これらのプロパティを使用して、レポートについてのデフォルトのXML設定を操作することができます。プロパティにより、レポート・レベル、グループ・レベル、列レベルの3つのレベルの項目を制御できるもの、1つのレベルまたは2つのレベルの制御に限られるものがあります。

この見出しノードの下のプロパティのヘルプを表示するには、プロパティをクリックし、[F1]を押してください。  プロパティ・パレット自体のヘルプを表示するには、[Ctrl]を押しながらプロパティをクリックしてプロパティの選択を解除し、[F1]または [image] を押してください。


XMLタグ

  関連項目	 例

説明  「XMLタグ」プロパティには、現在選択されているレポート、グループあるいは列の要素名が含まれ、ユーザー定義が可能です。XMLタグの目的はオブジェクトを特定の型あるいはデータのカテゴリとして一意に識別することなので、任意に要素の名前を選択できます。XML出力を生成する理由の1つは、オブジェクトを外部のDTD仕様に合った構成にするためです。これにより、レポートとサード・パーティーのアプリケーションとの統合が可能になります。

適用対象  レポート、グループ、列

必須/オプション  オプション

デフォルト  オブジェクト名（「名前」プロパティに表示されるのと同じもの）

使用上の注意

•	任意の長さの文字列を含むことができます。

•	XML要素の名前は、プロパティ・パレットのオブジェクト名に依存します。「名前」プロパティを変更すると、それにあわせて「XMLタグ」プロパティも変更されます。

•	このオブジェクトについてはXMLを出力せずに子のタグおよびデータを出力する場合にはこのプロパティをブランクにしてください。詳細は、XMLタグの例を参照してください。


XMLタグ属性

  関連項目	 例

説明  「XMLタグ属性」プロパティを使用して、XMLの属性を入力できます。オブジェクトのタグに属性を追加するのは、そのタグについての詳細を記述したり、データ値を特定したりするためです。タグの属性の使用は、XML出力を編成する方法の1つです。この方法をとる場合は、このプロパティに値を入力する必要があります。もう1つの編成方法は、データの型（グループあるいは列）ごとに別のタグを割り当てる方法です。この場合は、プロパティをブランクにしてください。

適用対象  レポート、グループ、列

必須/オプション  オプション

デフォルト  ブランク

構文  XMLの属性は、名前の値の組をスペースで区切って入力してください。次に例を示します。

XMLタグ属性	[attribute name]="&[report object name]"
大カッコ（[]）内のテキストはユーザーが選択します。レポートのオブジェクト名には、レポート内の任意の列あるいはユーザー・パラメーターを使用できます。このプロパティには、任意の数の属性を追加できます。それぞれの属性の間にスペースを入れてください。

使用上の注意

•	他のXMLタグに属性として追加されたデータ・オブジェクトは、冗長性を少なくするため、XML出力から除外されます。詳細は、XMLタグ属性の例（グループ・レベル） を参照してください。

•	属性で参照する列あるいは変数は、同じあるいは少ない頻度で発生するものである必要があります。


XML出力から除外

  関連項目	 例

説明  「XML出力から除外」プロパティを使用して、選択したグループまたは列についてXMLタグおよび関連データ（子データを含む）の出力を止めることができます。オブジェクトの除外を選択すると、XMLタグ、属性、データ値および子データ、たとえばそのグループ内の列が出力されません。このプロパティは、冗長なあるいは不必要と思われるデータを除外できるので、XMLドキュメントをフォーマットし直すのに便利です。

適用対象  レポート、グループ、列

必須/オプション  オプション

デフォルト  なし

値

あり

なし

使用上の注意

•	オブジェクトを属性として別の要素に追加したあと、そのオブジェクトのデータをもうXML出力内の別の要素として表示しない場合に、このプロパティが特に便利です。

•	レポート・レベルで「XML出力からの除外」プロパティを「あり」に設定した場合、すべてのデータがレポートの子データなので、レポートからのXML生成ができなくなります。


XML Prolog型

  関連項目

説明  「XML Prolog型」プロパティを使用して、外部のprologファイルまたはReport Builderによって生成されたテキストprologを選択できます。XML prologには、XML宣言、コメント、処理命令(PI)および文書型宣言(DTD)が含まれます。prologの詳細はXML Prolog値を参照してください。

適用対象  レポート

必須/オプション  必須

デフォルト  テキスト

値

テキスト	「XML Prolog値」プロパティで、prologをテキストとして入力してください。
ファイル	「XML Prolog値」プロパティを使用して、外部prologファイルへナビゲートします。


XML Prolog値

  関連項目	 例

説明  「XML Prolog値」プロパティを使用して、適格なXML出力すべての最初に表示されるXML Prologの値を編集できます。XML prologにはXML宣言が含まれますが、その他にコメント、処理命令（スタイルシート[XSL]など）およびDTDも含むことができます。

適用対象  レポート

必須/オプション  適格なXML出力にはXML宣言が必須です。ただし、このプロパティ内の任意の英数字を使用して、Report Builder内にRaw XML出力を生成できます。

デフォルト  <?xml version="1.0"?>

構文例

XML宣言:	<?xml version="1.0" encoding="UTF-8"?>
コメント:	<!-- this is how you do comments in XML -->
処理命令(PI):	<?xml:stylesheet type="text/xsl" href="emp.xsl" ?>
文書型宣言(DTD):	<!DOCTYPE EMP_TABULAR    [ <!ELEMENT EMP_TABULAR (EMP_ITEM)*> <!ELEMENT EMP_ITEM (EMPNO)> <!ELEMENT EMPNO (#PCDATA)> ]>


外部XMLタグ

  関連項目	 例

説明  「外部XMLタグ」フィールドは、選択されたグループの名前とLIST_ prefixとを表示します。外部XMLタグの目的は、グループ・オブジェクトのインスタンス内のすべてのタグおよびデータを囲むことです。レポート内では、グループ・オブジェクトのインスタンスは繰り返されます（たとえば10、20、30のように出力するdeptnoなど）。外部XMLタグは、すべての繰返しインスタンスのデータをカプセル化します。

適用対象  グループ

必須/オプション  オプション

デフォルト  <LIST_G_[groupname]>

使用上の注意

•	このフィールドはブランクのままでもかまいません。しかし、ブランクが便利なのは、レポートの問合せ内にグループのインスタンスが1つしかない場合のみです。


外部XML属性

  関連項目	 例

説明  「外部XML属性」プロパティを使用して、外部のXMLタグについてのXMLの属性を入力することができます。外部のタグに属性を追加するのは、そのタグについての詳細を記述したり、データ値を特定したりするためです。

適用対象  グループ

必須/オプション  オプション

デフォルト  ブランク

構文  外部XMLの属性は、名前の値の組をスペースで区切って入力してください（HTML属性の場合と同じ）。次に例を示します。

外部XMLタグ属性:	[attribute name]="&[report object name]"
ここで、大カッコ（[ ]）内のテキストはユーザーが選択します。このプロパティには、任意の数の属性を追加できます。それぞれの属性の間にスペースを入れてください。

使用上の注意

•	他のXMLタグに属性として追加されたデータ・オブジェクトは、冗長性を少なくするため、XML出力から除外されることに注意してください。詳細はXMLから除外を参照してください。

•	属性で参照する列あるいは変数は、より少ない頻度で発生するものである必要があります。


XMLタグを含む

  関連項目	 例

説明  「XMLタグを含む」プロパティは、レポート列にXMLタグが含まれるかどうかを表示します。プロパティを「はい」に設定すると、Report Builderは<、>および&と&lt;, &gt;および&amp;などのXML構文関連の文字を変換しません。

適用対象  キャラクタのソース・データ型を持つ列

必須/オプション  オプション

デフォルト  いいえ


「XMLタグ属性」の例(グループ・レベル)

  関連項目      [image]  すべての例

表レポートに次の問合せを使用しているとします。

SELECT * FROM DEPT

デフォルトのXML出力は次のようになります。

<MODULE2>
  <LIST_G_DEPTNO>
    <G_DEPTNO>
      <DEPTNO>10</DEPTNO>
      <DNAME>ACCOUNTING</DNAME>
      <LOC>NEW YORK</LOC>
    </G_DEPTNO>
    <G_DEPTNO>
      <DEPTNO>20</DEPTNO>
      <DNAME>RESEARCH</DNAME>
      <LOC>DALLAS</LOC>
    </G_DEPTNO>

与えられた部門番号(DEPTNO)に関係付けられたすべてのデータを、その部門番号<DEPTNO>の要素に収めているXML出力として生成するとします。これにより、多数の出力要素を減らすことができます。

データ・モデルから、DETPNO列について次のプロパティを指定します。

XMLタグ	DEPTNO
XMLタグ属性	NAME="&DNAME" LOCATION="&LOC"
ここで&DNAMEは部門名、&LOCはその部門の場所です。この2つのオブジェクトは、DEPTNOと同じ頻度で繰り返されます。

新しいXML出力は次のようになります。

<G_DEPTNO>
  <DEPTNO NAME="ACCOUNTING" LOCATION="NEW YORK">10</DEPTNO>
  <DNAME>ACCOUNTING</DNAME>
  <LOC>NEW YORK</LOC>
</G_DEPTNO>
<G_DEPTNO>
  <DEPTNO NAME="RESEARCH" LOCATION="DALLAS">20</DEPTNO>
  <DNAME>RESEARCH</DNAME>
  <LOC>DALLAS</LOC>
</G_DEPTNO>

DNAMEおよびLOCの値が今度は二度出力されているのがわかります。一度が属性として、もう一度がXML要素としての出力です。XML要素としての出力を削除するには、「XML出力から除外」プロパティも使用する必要があります。

データ・モデルでDNAME列およびLOC列についての「XML出力から除外」プロパティを「はい」に設定します。

この結果、XML出力は次のようになります。

<G_DEPTNO>
  <DEPTNO NAME="ACCOUNTING" LOCATION="NEW YORK">10</DEPTNO>
</G_DEPTNO>
<G_DEPTNO>
  <DEPTNO NAME="RESEARCH" LOCATION="DALLAS">20</DEPTNO>
</G_DEPTNO>
<G_DEPTNO>
  <DEPTNO NAME="SALES" LOCATION="CHICAGO">30</DEPTNO>
</G_DEPTNO>
<G_DEPTNO>
  <DEPTNO NAME="OPERATIONS" LOCATION="BOSTON">40</DEPTNO>
</G_DEPTNO>


「XMLタグ属性」の例（レポート・レベル）

  関連項目      [image]  すべての例

次の例では、レポート・レベルの属性がXMLにおいてどのように役に立つか示しています。

レポートに次の問合せを使用しているとします。

select deptno, job, ename, hiredate from emp

レポートはグループ左として設計され、DEPTNOが1番目のレベルのグループ、JOBが2番目のレベルのグループになっています。この例では、データ・モデルでDEPTNO列およびJOB列を選択し、「ブレーク順序」プロパティを「降順」に指定しておきます。データ・モデルのDEPTNO列およびJOB列の左向きの矢印が、これで下を向きます。

データ・モデルは次のようになっています。

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

<MODULE2>
  <LIST_G_DEPTNO>
    <G_DEPTNO>
      <DEPTNO>30</DEPTNO>
      <LIST_G_JOB>
        <G_JOB>
          <JOB>SALESMAN</JOB>
          <LIST_G_ENAME>
            <G_ENAME>
              <ENAME>ALLEN</ENAME>
              <HIREDATE>20-FEB-81</HIREDATE>
            </G_ENAME>
            <G_ENAME>
              <ENAME>WARD</ENAME>
              <HIREDATE>22-FEB-81</HIREDATE>
            </G_ENAME>
            <G_ENAME>
              <ENAME>MARTIN</ENAME>
              <HIREDATE>28-SEP-81</HIREDATE>
            </G_ENAME>

後で参考にするため、部門番号30内の最初の3人の従業員の雇用日が20-FEB-81から28-SEP-81であることに注意してください。

次に、レポートにユーザー・パラメータを追加して、雇用日によってデータを選択したり排除したりしてみます。データ・モデルの問合せ(Q_1)をダブルクリックします。

「SQL問合せ文」ダイアログ・ボックスで、入力されている問合せの最後に次のテキストを追加します。

where hiredate > :p_date

これで、問合せは次のようになります。

Select deptno, job, ename, hiredate from emp where hiredate > :p_date

このSQL文はReport Builderに、p_dateの名前を持つパラメータを作成するよう指示します。ただし、「データ型」プロパティを、手動でDateに変更する必要があります。

1.	オブジェクト・ナビゲータで、データ・モデル下のユーザー・パラメータを確認します。ユーザー・パラメータの左側のプラス記号をクリックします。

2.	オブジェクトP_DATEをダブルクリックします。

3.	プロパティ・パレットで、「データ型」プロパティ・フィールドをクリックし、ドロップ・ダウン・メニューから「Date」を選択します。

次に、このユーザー・パラメータをレポート要素の属性に割り当てることを考えます。パラメータは、レポートのXML出力全体を通して様々な要素を含めたり除外したりする規則を提供します。

オブジェクト・ナビゲータのレポート・ノードをダブルクリックします。

プロパティ・パレットの「XMLタグ属性」プロパティ・フィールドにHiredateLaterThan="&p_date"と入力します。

ライブ・プレビューアでレポートを実行します。ランタイム・パラメータ・フォームが表示され、日付値(P Date)を要求されます。「1-JUL-81」と入力し、 [image] をクリックします。

これでXMLは次のようになります。

<MODULE2 HiredateLaterThan="01-JUL-81">
  <LIST_G_DEPTNO>
    <G_DEPTNO>
      <DEPTNO>30</DEPTNO>
      <LIST_G_JOB>
        <G_JOB>
          <JOB>SALESMAN</JOB>
          <LIST_G_ENAME>
            <G_ENAME>
              <ENAME>MARTIN</ENAME>
              <HIREDATE>28-SEP-81</HIREDATE>
            </G_ENAME>

1-July-81より前のHIREDATEを持つグループG_ENAMEのインスタンスが、XMLで使用できなくなっていることに注意してください。このパラメータHiredateLaterThan="01-JUL-81"を定義する属性が、レポート要素MODULE2に表示されています。


「XML出力から除外」の例（データ出力の制限）

  関連項目      [image]  すべての例

データをいくつかの指定した要素に制限するXML出力を生成するとします。現在、XML出力には部門番号、部門名および場所が含まれています。XML出力は次のようになっています。

    <G_DEPTNO>
      <DEPTNO>10</DEPTNO>
      <DNAME>ACCOUNTING</DNAME>
      <LOC>NEW YORK</LOC>
    </G_DEPTNO>
    <G_DEPTNO>
      <DEPTNO>20</DEPTNO>
      <DNAME>RESEARCH</DNAME>
      <LOC>DALLAS</LOC>
    </G_DEPTNO>
    <G_DEPTNO>
      <DEPTNO>30</DEPTNO>
      <DNAME>SALES</DNAME>
      <LOC>CHICAGO</LOC>
    </G_DEPTNO>
    <G_DEPTNO>
      <DEPTNO>40</DEPTNO>
      <DNAME>OPERATIONS</DNAME>
      <LOC>BOSTON</LOC>
    </G_DEPTNO>

<LOC>タグおよび関係付けられたデータを削除することにします。

データ・モデル・ビューで、LOC列をダブルクリックし、プロパティ・パレットで次のプロパティを指定します。

XML出力から除外	はい
これでXML出力は次のようになります。

  <LIST_G_DEPTNO>
    <G_DEPTNO>
      <DEPTNO>10</DEPTNO>
      <DNAME>ACCOUNTING</DNAME>
    </G_DEPTNO>
    <G_DEPTNO>
      <DEPTNO>20</DEPTNO>
      <DNAME>RESEARCH</DNAME>
    </G_DEPTNO>
    <G_DEPTNO>
      <DEPTNO>30</DEPTNO>
      <DNAME>SALES</DNAME>
    </G_DEPTNO>
    <G_DEPTNO>
      <DEPTNO>40</DEPTNO>
      <DNAME>OPERATIONS</DNAME>
    </G_DEPTNO>
  </LIST_G_DEPTNO>

<LIST_G_DEPTNO>タグまたは<G_DEPTNO>タグを削除したいが、（DEPTNOまたはDNAMEなどの）子データは除外しない場合には、データ・モデルでグループG_DEPTNOを選択し、そのプロパティ・パレットをオープンします。「XMLタグ」プロパティ・フィールドからG_DEPTNOのXMLタグを削除し、「外部XMLタグ」プロパティ・フィールドからLIST_G_DEPTNOのXMLタグを削除します。詳細は、「外部XMLタグ」プロパティ を参照してください。


「XML出力から除外」の例（冗長性の制限）

  関連項目      [image]  すべての例

現在次のようになっているXML出力の属性を使用するとします。

<G_DEPTNO>   <DEPTNO NAME="ACCOUNTING" LOCATION="NEW YORK">10</DEPTNO>   <DNAME>ACCOUNTING</DNAME>   <LOC>NEW YORK</LOC> </G_DEPTNO> <G_DEPTNO>   <DEPTNO NAME="RESEARCH" LOCATION="DALLAS">20</DEPTNO>   <DNAME>RESEARCH</DNAME>   <LOC>DALLAS</LOC> </G_DEPTNO>
冗長性をなくすには、XML出力からDNAMEおよびLOCの要素を除外する必要があります。

データ・モデル表示でDNAME列およびLOC列のプロパティ・パレットを表示し、次のプロパティを指定します。

XML出力から除外	はい
この結果、XML出力は次のようになります。

<G_DEPTNO>
  <DEPTNO NAME="ACCOUNTING" LOCATION="NEW YORK">10</DEPTNO>
</G_DEPTNO>
<G_DEPTNO>
  <DEPTNO NAME="RESEARCH" LOCATION="DALLAS">20</DEPTNO>
</G_DEPTNO>
<G_DEPTNO>
  <DEPTNO NAME="SALES" LOCATION="CHICAGO">30</DEPTNO>
</G_DEPTNO>
<G_DEPTNO>
  <DEPTNO NAME="OPERATIONS" LOCATION="BOSTON">40</DEPTNO>
</G_DEPTNO>


「XMLタグ」の例

  関連項目      [image]  すべての例

レポート、グループ、問合せの列についてXML出力を作成するとします。問合せ文、

SELECT deptno, dname, loc FROM dept

が表レポート内にあり、これにより次のXML出力が生成されます。

<MODULE1>
  <LIST_G_DEPTNO>
    <G_DEPTNO>
      <DEPTNO>10</DEPTNO>
      <DNAME>ACCOUNTING</DNAME>
      <LOC>NEW YORK</LOC>
    </G_DEPTNO>
    <G_DEPTNO>
      <DEPTNO>20</DEPTNO>
      <DNAME>RESEARCH</DNAME>
      <LOC>DALLAS</LOC>
    </G_DEPTNO>
    <G_DEPTNO>
      <DEPTNO>30</DEPTNO>
      <DNAME>SALES</DNAME>
      <LOC>CHICAGO</LOC>
    </G_DEPTNO>
    <G_DEPTNO>
      <DEPTNO>40</DEPTNO>
      <DNAME>OPERATIONS</DNAME>
      <LOC>BOSTON</LOC>
    </G_DEPTNO>
  </LIST_G_DEPTNO>
</MODULE1>

出力にさまざまなタグが表示されないようにするには、「XMLタグ」プロパティ・フィールドのデフォルト名を削除し、ブランクのままにしておきます。これでタグの出力は削除されますが、子のタグに関係付けられたデータはすべて残ります。

たとえば、G_DEPTNOタグを削除すると、XML出力は次のようになります。

<MODULE1>
  <LIST_>
    <DEPTNO>10</DEPTNO>
    <DNAME>ACCOUNTING</DNAME>
    <LOC>NEW YORK</LOC>
    <DEPTNO>20</DEPTNO>
    <DNAME>RESEARCH</DNAME>
    <LOC>DALLAS</LOC>
    <DEPTNO>30</DEPTNO>
    <DNAME>SALES</DNAME>
    <LOC>CHICAGO</LOC>
    <DEPTNO>40</DEPTNO>
    <DNAME>OPERATIONS</DNAME>
    <LOC>BOSTON</LOC>
  </LIST_>
</MODULE1>

前に<LIST_G_DEPTNO>と呼ばれていたタグがここでは<LIST_>となっていることに注意してください。これは「外部XMLタグ」と呼ばれ、グループ・タグに関係付けられているのみです。外部XMLタグの名前は、グループのXMLタグの名前から選択されます。<LIST_>タグも削除する場合は、「外部XMLタグ」フィールドをブランクのままにします。詳細は、「外部XMLタグ」プロパティ を参照してください。


「外部XMLタグ」の例

  関連項目      [image]  すべての例

次の問合せを含むレポートがあるとします。

SELECT * from EMP

このデータをグループ左レポートとして表示することとし、DEPTNOを1番目のレベルのグループ、JOBを2番目のレベルのグループとします。

この例では、グループDEPTNOおよびJOBの出力順を昇順から降順に入れ替えることを考えます。

1.	データ・モデルから列DEPTNOを選択し、プロパティ・パレットをオープンします。

2.	「ブレーク順序」プロパティを「昇順」から「降順」に変更します。

3.	1、2を列JOBについても繰り返します。

データ・モデルは次のようになっています。

次にレポートのグループについて、XML出力の階層構造を表示するとします。G_JOBをG_DEPTNOの子グループにしたので、外部グループ<LIST_G_DEPTNO>内のすべての要素を縮小してデータの構造を一度に1レベル拡張します。

- <MODULE1>
- <LIST_G_DEPTNO>
+ <G_DEPTNO>
+ <G_DEPTNO>
+ <G_DEPTNO>
  </LIST_G_DEPTNO>
  </MODULE1>

上のXML例では、グループG_DEPTNO（外部タグ<LIST_G_DEPTNO>で表示されている）に一意のDEPTNOデータのインスタンスが3つあることがわかります。次に、G_DEPTNOの子である次のレベルのグループ、G_JOBを見てみます。最初のXMLタグ<G_DEPTNO>を拡張すると、次のように表示されます。

- <MODULE1>
- <LIST_G_DEPTNO>
- <G_DEPTNO>
<DEPTNO>30</DEPTNO>
+ <LIST_G_JOB>
  </G_DEPTNO>
+ <G_DEPTNO>
+ <G_DEPTNO>
  <LIST_G_DEPTNO>
  </MODULE1>

<LIST_G_DEPTNO>に<G_DEPTNO>の繰り返されるインスタンスが含まれるのと同じように、+ <LIST_G_JOB> には<G_JOB>の繰り返されるインスタンスが含まれます。要素+ <LIST_G_JOB>を拡張すると、次のXML出力がその場に表示されます。

- <LIST_G_JOB>
+ <G_JOB>
+ <G_JOB>
+ <G_JOB>
- </LIST_G_JOB>

最初のG_JOB要素（+<G_JOB>）を拡張すると、次のXML出力がその場に表示されます。

- <G_JOB>
    <JOB>SALESMAN</JOB>
 + <LIST_G_EMPNO>
 </G_JOB>

<G_JOB>に、別の繰返しグループ<G_EMPNO>のインスタンスが含まれていることがわかります。+<LIST_G_EMPNO>を拡張すると、<G_EMPNO>のインスタンスが表示されます。ここではもう子グループはありませんが、G_EMPNOで使用できる多くの列値があります。XML出力は次のようになります。

- <LIST_G_EMPNO>
 - <G_EMPNO>
   <EMPNO>7499</EMPNO>
   <ENAME>ALLEN</ENAME>
   <MGR>7698</MGR>
   <HIREDATE>20-FEB-81</HIREDATE>
   <SAL>1600</SAL>
   <COMM>300</COMM>
  </G_EMPNO>
  </LIST_G_EMPNO>

外部の要素<LIST_[groupname]>は、繰返しグループのコンテナとして便利です。


「外部XML属性」の例

  関連項目      [image]  すべての例

レポートに次の問合せを使用しているとします。

SELECT deptno, job, ename, sal FROM EMP

このデータを除外グループ・レポートとして表示することとし、DEPTNOを1番目のレベルのグループ、JOBを2番目のレベルのグループとします。

この例では、グループDEPTNOおよびJOBの出力順を昇順から降順に入れ替えることを考えます。

1.	データ・モデルから列DEPTNOを選択し、プロパティ・パレットをオープンします。

2.	「ブレーク順序」プロパティを「昇順」から「降順」に変更します。

3.	1、2を列JOBについても繰り返します。

データ・モデルは次のようになっています。

ここでのXML出力は次のようになります。

<MODULE1>
  <LIST_G_DEPTNO>
    <G_DEPTNO>
      <DEPTNO>30</DEPTNO>
      <LIST_G_JOB>
        <G_JOB>
          <JOB>SALESMAN</JOB>
          <LIST_G_ENAME>
            <G_ENAME>
              <ENAME>ALLEN</ENAME>
              <SAL>1600</SAL>
            </G_ENAME>
            <G_ENAME>
              <ENAME>WARD</ENAME>
              <SAL>1250</SAL>
            </G_ENAME>

この中で、<JOB>の一意の値が<G_ENAME>に少なくとも2回適用されています。具体的には、少なくとも2人の従業員（ALLENおよびWARD）がSALESMANのジョブを持っています。役職（<JOB>）を別の行の別のXMLタグにネストするかわりに、この一意の値を<LIST_G_ENAME>要素に収めます。<JOB>の値は<LIST_G_ENAME>ごとに1回発生するためです。

データ・モデルから、次のプロパティを指定します。

グループ・オブジェクト	プロパティ	アクション	値
G_ENAME	外部XML属性	入力	JOBTITLE="&JOB"
Job	XML出力から除外	選択	はい
G_JOB	XMLタグ	削除	G_JOB
これでXML出力は次のようになります。

<MODULE1>
  <LIST_G_DEPTNO>
    <G_DEPTNO>
      <DEPTNO>30</DEPTNO>
      <LIST_G_JOB>
        <LIST_G_ENAME JOBTITLE="SALESMAN">
          <G_ENAME>
            <ENAME>ALLEN</ENAME>
            <SAL>1600</SAL>
          </G_ENAME>
          <G_ENAME>
            <ENAME>WARD</ENAME>
            <SAL>1250</SAL>
          </G_ENAME>


「XML Prolog値」の例（Prolog型テキスト）
「XML Prolog値」の例（Prolog型:テキスト）

  関連項目      [image]  すべての例

XML出力の最初にテキストとしてprologを挿入するとします。

Report Builderでレポートをオープンした状態でオブジェクト・ナビゲータ内のレポート・アイコンを選択し、プロパティ・パレットを表示します。次のプロパティを指定します。

XML Prolog型	テキスト
次に、「XML Prolog値」プロパティ・フィールドを1回クリックし、 [image] ボタンを表示します。このボタンをクリックして「XML Prolog値」ダイアログ・ボックスを表示します。prologのテキストを入力し、「OK」をクリックします。

次の例は、順にXML宣言、コメント、処理命令（PI）、文書型宣言（DTD）を含むprologテキストです。

<?xml version="1.0" encoding="UTF-8"?>
<!-- This is how you make comments in XML -->
<?xml:stylesheet type="text/xsl" href="emp.xsl" ?>
<!DOCTYPE EMP_TABULAR   [
<!ELEMENT EMP_TABULAR (EMP_ITEM)*>
<!ELEMENT EMP_ITEM (EMPNO)>
<!ELEMENT EMPNO (#PCDATA)>
]>


「XML Prolog値」の例（Prolog型ファイル）
「XML Prolog値」の例（Prolog型:ファイル）

  関連項目      [image]  すべての例

prologを外部のファイルに記述するとします。

Report Builderでレポートをオープンした状態で、次のプロパティをレポート・レベルで指定します。

XML Prolog型	ファイル
次に、「XML Prolog値」プロパティ・フィールドを1回クリックし、 [image] ボタンを表示します。このボタンをクリックして、prologテキストが含まれている外部のファイルまでナビゲートします。

次の例は、順にXML宣言、コメント、処理命令（PI）、文書型定義（DTD）を含むprologテキストです。

<?xml version="1.0" encoding="UTF-8"?>
<!-- This is how you make comments in XML -->
<?xml:stylesheet type="text/xsl" href="emp.xsl" ?>
<!DOCTYPE EMP_TABULAR   [
<!ELEMENT EMP_TABULAR (EMP_ITEM)*>
<!ELEMENT EMP_ITEM (EMPNO)>
<!ELEMENT EMPNO (#PCDATA)>
]>


「XMLタグを含む」の例

  関連項目      [image]  すべての例

データベースにすでに列の値に含まれたXMLタグがあるとします。下の最初のインスタンスで、XMLタグ「DESTINATION」は、ユーザー指定のパラメータ&p_destを表します。「XMLタグを含む」プロパティが「はい」に設定されていると、Report Builderは<DESTINATION>をXMLタグと認識します。&p_destをユーザー指定に従って変数と解釈し、かわりにXML出力の&p_destにある一意の値を使用します。このことは、"&[report object name]"の構文を持つ列に含まれるどの値にも当てはまります。

XMLタグを持つ変数の列値:

列の元のテキスト文字列:	<DESTINATION>&p_dest<DESTINATION>
「XMLタグを含む」=「はい」:	<DESTINATION>FIJI<DESTINATION>
「XMLタグを含む」=「いいえ」:	&lt;DESTINATION&gt;&amp;p_dest&lt;DESTINATION&gt;

XMLタグを持つ変数でない列値:

列の元のテキスト文字列:	<JOB>Clerk<JOB>
「XMLタグを含む」=「はい」:	<JOB>Clerk<JOB>
「XMLタグを含む」=「いいえ」:	&lt;JOB&gt;Clerk&lt;JOB&gt;


プリンタ定義ファイル

  関連項目

プリンタ定義ファイルは、プリンタの翻訳プログラムのような役割を果たします。太字、下線、線/ボックスで使用されるグラフィック文字等をどのように扱うかを指定するコードが含まれています。プリンタ定義ファイルは、使用される前に圧縮したり、コンパイルしたりする必要がないテキスト・ファイル（ASCII、EBCDICなど）です。

注意: プリンタおよび端末定義が必要なのは、キャラクタ・モード・プラットフォームの場合のみです。ビットマップ・プラットフォームでは必要ありません。


プリンタ定義ファイルの使用

  関連項目

プリンタ定義ファイルを使用するには（キャラクタモード動作環境でレポートを実行するときのみ使用されます）:

1	DESFORMATシステム・パラメータを、プリンタ定義ファイルの名前に設定します。

2	DESTYPEをプリンタに、DESNAMEをプリンタ名に設定します。


プリンタ・パッケージ定義ファイル

  関連項目

dec.prt	LN03およびLPS40、LP05、LA50プリンタの66×80ページ・サイズをサポートする大部分のDECプリンタ用の一般的なプリンタ・ファイルです。
decland.prt	横向き印刷モードで印刷し、66×132ページ・サイズをサポートする一般的なプリンタ・ファイルです。
decwide.prt	decと同じですが、66×132ページ・サイズをサポートしています。
dec180.prt	declandと同じですが、66×180ページ・サイズをサポートしています。
dflt.prt	ハイライト属性を無視し、66×80ページ・サイズをサポートする一般的なプリンタ・ファイルです。
hpl.prt	66×80ページ・サイズをサポートするHP LaserJetプリンタ用の一般的なプリンタ・ファイルです。
hplwide.prt	hplと同じですが、66×132ページ・サイズをサポートしています。
psland.prt	横向き印刷モードで印刷し、110×51ページ・サイズをサポートするPostScriptプリンタ・ファイルです。
psl132.prt	横向き印刷モードで印刷し、132×66ページ・サイズをサポートするPostScriptプリンタ・ファイルです。
Psl180.prt	横向き印刷モードで印刷し、180×66ページ・サイズをサポートするPostScriptプリンタ・ファイルです。
psport.prt	縦向き印刷モードで印刷し、85×66ページ・サイズをサポートするPostScriptプリンタ・ファイルです。
psp132.prt	縦向き印刷モードで印刷し、132×120ページ・サイズをサポートするPostScriptプリンタ・ファイルです。
wide.prt	ハイライト属性を無視し、66×132ページ・サイズをサポートする一般的なプリンタ・ファイルです。
wide180.prt	wideと同じですが、66×180ページ・サイズをサポートしています。
使用上の注意

•	前述のプリンタ定義が全部そろっていない場合や、前述以外のプリンタ定義が付属している場合があります。これは、Report Builder付属のプリンタ定義の集合が、システム固有のものであるためです。

•	プリンタ定義ファイルはテキスト・ファイル（EBCDIC、ASCIIなど）であるため、任意のテキスト・エディタを使用して作成または変更できます。作成または変更の作業が終わったら、テキストとしてファイルを保存することを忘れないでください。新規または変更した定義を使用するには、DESFORMATキーワードを使用して指定します。


プリンタ定義ファイル構文（Printerコード）

  制限 [image]  例	  関連項目

プリンタ定義ファイルには、プリンタ・コードが含まれています。キャラクタ・モードおよびPostScriptプリンタ定義の両方に使用されるプリンタ・コード名もあれば、どちらか一方でしか使用できないものもあります。

共通のキャラクタおよびPostScriptプリンタ・コード

コード名と構文	使用方法
After report  <gen_string>	レポートが印刷を終了した後でプリンタへ送られる<gen_string>です。このコードは通常、次の印刷ジョブが必ず新しい用紙で開始されるための設定に使用されます。
before report<gen_string>	AFTER REPORTと同じ様なものですが、レポートが印刷を開始する前に、<gen_string>が送られます。
after page <gen_string>	最終ページを含めて、各物理ページ（つまり、それぞれの印刷ページ）の後にプリンターに送られる<gen_string>です。
between pages <gen_string>	最終ページを除いて、各物理ページ（つまり、それぞれの印刷ページ）の後にプリンタへ送られる<gen_string>です。
code *string* <gen_string>	ユーザー定義またはReport Builder認識コードです。下記の*string*を参照してください。
High <integer>	文字数で表されるレポートの高さです。
Printer<string>	プリンタの名前です。
Width <integer>	文字数で表されるレポートの幅です。
文字固有のコード

コード名と構文	使用方法
automargin	最後の列の文字がNULLでない場合は、キャリッジ・リターンがファイルの最後に入らないように指定します。
autopage	最後の行がブランクでないページの最後では、用紙送りが実行されないように指定します。
box bottom center <gen_string>	ボックスの下の枠の中心を描くのに使用される文字列です。
box bottom left <gen_string>	ボックスの左下の角を描くのに使用される文字列です。
box bottom right <gen_string>	ボックスの右下の角を描くのに使用される文字列です。
box center center <gen_string>	ボックスの中心を描くのに使用される文字列です。
box center left <gen_string>	ボックスの左枠の中心を描くのに使用される文字列です。
box center right <gen_string>	ボックスの右枠の中心を描くのに使用される文字列です。
box horizontal <gen_string>	ボックスの上と下の枠を描くのに使用される文字列です。
box top center <gen_string>	ボックスの上の枠の中心を描くのに使用される文字列です。
box top left <gen_string>	ボックスの左上の角を描くのに使用される文字列です。
box top right <gen_string>	ボックスの右上の角を描くのに使用される文字列です。
box vertical <gen_string>	ボックスの右枠と左枠を描くのに使用される文字列です。
hilight backspace <gen_string>	文字を印刷し、バックアップしてから文字を再度印刷することにより、太字または下線付きの文字を印刷します。バックアップは、<gen_string> （たとえば、esc "[0m"）に従って行われます。
hilight overstrike	行を印刷してから、適宜、項目を太字に再度印刷したり、下線を引いたりして、太字または下線に似せます。
andscape <gen_string>	プリンターに横向き印刷モードで印刷させるのに使用する<gen_string>です。
linefeed <gen_string>	ページの各行の終わりで使用する<gen_string>です。
return string <gen_string>	プリンタを現在行の開始位置に戻すのに使用する<gen_string>です。
PostScript固有コード

コード名と構文	使用方法
postscript	プリンタ定義ファイルがPostScriptプリンタ用であることを示す標識です。


gen_string

文字プリンタにおいて、<gen_string>は任意の順序での以下の組合せです。

•	string,例, "abc"

•	integer, 例, 10

•	dec(decimal_number), 例, dec(10)

•	octal(octal_number), 例, octal(10)

•	hex(hex_number), 例, hex(1A)

•	^control_character, 例, ^L

•	control(control_character), 例, control(L)

•	esc escape_string, 例, esc "abc"

PostScriptプリンタにおいて、<gen_string>は二重引用符で囲んだ、任意の順序での以下の組合せです。

•	BOLD、太字に切り替えます。

•	BOLDFONT、太字フォントに切り替えます。

•	BOLDOBLIQUE、太字イタリックに切り替えます。

•	BOLDOBLIQUEFONT、太字イタリック・フォントに切り替えます。

•	BOTTOMMARGIN、下のマージンを切り替えます。

•	BOX、ボックス・フォントに切り替えます。

•	FONTSIZE、フォント・サイズを切り替えます。

•	LANDSCAPE、横向き印刷モードに切り替えます。

•	LEFTMARGIN、印字不可能なマージンのサイズを設定します。

•	MONOSPACE、等幅間隔に切り替えます（キャラクタ・マトリックスを施行）。

•	NORMAL、標準に切り替えます。

•	NORMALFONT、標準フォントに切り替えます。

•	OBLIQUE、イタリックに切り替えます。

•	OBLIQUEFONT、イタリック・フォントに切り替えます。

•	PAGEHT、ページの縦に入るように文字数を設定します。

•	PAGEWD、ページの横に入るように文字数を設定します。

•	PAPERHT、用紙の高さをインチで設定します。

•	PAPERWD、用紙の幅をインチで設定します。

•	PORTRAIT、縦向き印刷モードに切り替えます。

•	PROPORTIONAL, 比例間隔に切り替えます（文字マトリクスを強制しない）。

•	RIGHTMARGIN、右マージンの幅を設定します。

•	ROTATE2、ページが変わるごとに2ページずつ印刷します。

•	TOPMARGIN、上のマージンの幅を設定します。

•	UNDERLINE、下線を引くに切り替えます。

•	UNDERLINESTOP、下線を引くをオフにします。


string

<string>は、句読点を含む1つ以上の英数字で、二重引用符で囲む必要があります。


*string*

*string*は、ユーザー作成とReport Builder認識という2種類のコード名のいずれかです。ユーザー作成コード名は、ユーザーが作成する任意のコードです。パッケージ化されたコードとは、レイアウト・オブジェクトの「表示シート」ダイアログ・ボックスから属性（たとえば、BOLD）を選択するときにReport Builderが使用するコード名です。

•	太字オフ

•	太字オン

•	太字イタリック下線オフ

•	太字イタリック下線オン

•	太字下線オフ

•	太字下線オン

•	イタリック・オフ

•	イタリック・オン

•	イタリック下線オフ

•	イタリック下線オン

•	プレーン・オフ

•	プレーン・オン

•	下線オフ

•	下線オン

使用上の注意

•	プリンタ・コードを作成し、Report Builderでパッケージ文字列でなく、ユーザー作成の汎用文字列をオブジェクト上で使用する場合は、次のいずれかの作業を行います。

•	レイアウト・オブジェクトの「前のプリンタ・コード」または「後のプリンタ・コード」プロパティに、作成したプリンタ・コード名を入力します。

•	PL/SQLパッケージ・プロシージャのSRW.DEFAULT_BEFORE_CODEまたはSRW.DEFAULT_AFTER_CODEを使用します。


プリンタ定義の制限

•	プリンタ定義は、各プリンタ定義ファイルに1つしか入っていません。

•	コードは、任意の順序で表示できます。

•	コードはスペースまたはリターンで区切ってください。したがって、複数のコードが同じ行に表示されることがあります。

•	改行とスペースは、まったく同様に扱われます。つまり、行の最後にリターンを置くと、リターンはスペースとして解釈されます。例外: 文字列内にリターンが置かれると、リターンはリターンとして解釈されます。

•	プリンタ・コードを指定すると、余分なスペースおよび大文字使用、順序は無視されます。たとえば、次のものはすべて同じと考えられます。

bold underline off
bold UNDERLINE OfF
Underline Bold Off

•	一部のオペレーティング・システムでは、文字列に二重引用符のかわりに一重引用符が必要となる場合があります。また、プリンタ定義ファイルによっては、大/小文字区別をする場合があります。

•	先行ゼロが付いたプリンタ・コードは同じと見なされます。たとえば、コード001と1は同じです。

•	Afterページ・コードに対してブランク文字列（""）を入力すると、新しいページが開始されるまで、「行送り」が挿入されます。

•	HILIGHT OVERSTRIKEおよびHILIGHT BACKSPACEコードは、一緒に使用することはできません。さらに、正規のプリンタ・シーケンス（BOLD ONまたはBOLD OFFなど）が、HILIGHTコードが入ったファイルで指定されると、その正規のプリンタ・シーケンスが優先されます。

•	DESFORMATに対してプリンタ定義ファイルを指定すると、プリンタと端末定義ファイル検索順序に従って、検索が行われます。


dflt.prtの例

  関連項目 	  すべての例

printer "dflt"

height   66

width    80

after report control(L)

after page control(L)

return ""

linefeed control(J)


declno3.prtの例

  関連項目 	  すべての例

printer "dec LNO3"

height   66

width    80

return ""

linefeed 10

after report control(L)

after page control(L)

box horizontal    "-"

box vertical      "|"

box top left      "+"

box top center    "+"

box top right     "+"

box center left   "+"

box center center "+"

box center right  "+"

box bottom left   "+"

box bottom center "+"

box bottom right  "+"

code "box on"    ""

code "box off"       ""

code "bold on"         esc "[1m"

code "bold off"        esc "[0m"

code "underline on"    esc "[4m"

code "underline off"   esc "[0m"

code "500"   esc "[2N"


dec180.prtの例

  関連項目 	  すべての例

printer "dec180"

height   66

width    180

before report control(L)

after report control(L)

after page control(L)

return ""

linefeed control(J)

code "bold on"         esc "[1m"

code "bold off"        esc "[0m"

code "underline on"    esc "[4m"

code "underline off"   esc "[0m"


hplwide.prtの例

  関連項目 	  すべての例

printer "hplwide"

height   66

width    132

Before report esc "(s0P" esc "&k2S" esc "&17.27c66F"

after report control(L)

after page control(L)

return        ""

linefeed      control(J)

code "bold on"         esc "(s7B"

code "bold off"        esc "(s0B"

code "underline on"    esc "&dD"

code "underline off"   esc "&d@"


psport85.prtの例

  関連項目 	  すべての例

printer "postscript portrait"       % set printer type

postscript            %% declare this a PostScript printer

height   66           %% height of the page in characters

width    85           %% width of the page in characters

return   ""           %% unnecessary for PostScript

linefeed ""           %% unnecessary for PostScript

before report "

PORTRAIT          %% set portrait mode

12 FONTSIZE       %% pick a suitable font size

8.5 PAPERWD       %% 8.5 x 11 paper size

11 PAPERHT        %%

66 PAGEHT         %% each page is 80 x 66

85 PAGEWD         %%

0.2 LEFTMARGIN    %% leave small border

0.2 RIGHTMARGIN   %%

0.2 TOPMARGIN     %%

0.2 BOTTOMMARGIN  %%

NORMAL            %% set up normal Courier font

after report ""   %% unnecessary for PostScript

after page ""  %% unnecessary for PostScript

box horizontal "a"

box vertical      "b"

box top left      "c"

box top center    "d"

box top right     "e"

box center left   "f"

box center center "g"

box center right "h"

box bottom left   "i"

box bottom cente "j"

box bottom right"k"

code "box on"        "BOX"

code "box off"       "NORMAL"

code "bold on"       "BOLD"

code "bold off"      "NORMAL"

code "underline on"  "UNDERLINE"

code "underline off" "UNDERLINESTOP"

code "italic on"   "OBLIQUE"

code "italic off"  "NORMAL"

code "BOLDOBLIQUE"

code "bold italic off"  "NORMAL"

code "bold underline on"   "BOLD UNDERLINE"

code "bold underline off"  "NORMAL UNDERLINESTOP"

code "italic underline on"   "OBLIQUE UNDERLINE"

code "italic underline off"  "NORMAL UNDERLINESTOP"

code "bold italic underline on"   "BOLDOBLIQUE UNDERLINE"

code "bold italic underline off"  "NORMAL UNDERLINESTOP"

code "1" " PROPORTIONAL /Times-Bold 14 SETFONT "

code "2" " MONOSPACE NORMAL "


説明

端末リソースは、端末の機能を指定する関連データの集合です。端末リソースには、Report Builderに対する各種端末の属性（画面幅および高さ、グラフィックス機能など）を説明するための端末定義が含まれています。さらに、端末リソースは、キー・バインディングとして知られる機能を使用して、アプリケーションのファンクションを特定の端末キーに関係付けます。これらのリソースは、端末リソース・ファイルに格納されています。

注意: プリンタおよび端末定義が必要なのは、キャラクタ・モード・プラットフォームの場合のみです。ビットマップ・プラットフォームでは必要ありません。ここで提供される情報は、キャラクタ・モード用のレポートを設計するユーザー向けのものです。


パッケージ端末定義

ファイル名	説明
dflt.res	最小限のキー・バインディングおよびリソースを提供する一般的なリソース・ファイルです。Report Builderの起動時にリソース・ファイルが指定されない場合に使用されます。
sun4.res	Sun4端末用の定義とキー・バインディングを含むリソース・ファイルです。
sun10.res	Sun10端末用の定義とキー・バインディングを含むリソース・ファイルです。
vt100.res	VT100端末用の定義とキー・バインディングを含むリソース・ファイルです。
vt220.res	VT220端末用の定義とキー・バインディングを含むリソース・ファイルです。
vt320.res	VT320端末用の定義とキー・バインディングを含むリソース・ファイルです。
使用上の注意

•	前述の端末リソース・ファイルがすべて揃っていない場合や、これ以外のファイルが付属している場合があります。これは、Report Builder付属の端末リソース・ファイルの集合が、システム固有のものであるためです。


端末リソース

Report Builderのリソース・ファイルは、Oracle Terminalというツールを使用して、作成とメンテナンスを行います。端末リソース・ファイルを変更するには、Oracle Terminalのリソース・エディタotにアクセスする必要があります。

Oracle Terminalを使用してアプリケーションを作成していれば、Oracle Terminalリソース・エディタを使用するだけで、アプリケーションの端末リソースを構成できます。つまり、Report Builderでは、ビットマップ・バージョン用の端末リソースを構成できません。さらに、構成できるキャラクタ・モードのリソースは、次のものに限られます。

  キー・バインディング

  端末定義ファイル

使用上の注意

•	ランタイム・インタフェース（ダイアログ・ボックスなど）の外観は変更できません。

•	キャラクタ・モード端末の端末リソースを変更する場合は、次に示すように、キャラクタ・モードot実行プログラムを使用してください。任意のプラットフォーム上で任意のプラットフォームのリソースを編集できますが、そのリソースが使用されるプラットフォーム上で、キー・バインディングを生成する必要があります。

•	キャラクタ・モードの実行プログラムを使用することになるので、ファンクション・キーを表すためのキャラクタ・モードの表記規則を知っておく必要があります。Oracle ReportとOracle Terminalのファンクション・キーは、どちらも大カッコで囲まれたファンクションの名前（[Next Page]など）で表されます。これらのファンクション・キーをキーボードの実際のキーにマップするには、キーパッド・ダイアグラムまたは「キー一覧」画面（ヘルプでアクセス可能）を参照できます。

•	Oracle Terminalの機能をすべて説明するのは、このヘルプ・システムで扱う範囲を超えています。Oracle Terminalのチュートリアルも提供されていません。この説明は、Oracle TerminalのReport Builderに関連する面のみに限られていることをご承知ください。さらに、その例には、Report Builderで認識されたデバイスのリストにデバイスを追加するといった、本来、管理作業と考えるべき一部の作業は含まれていません。

•	Oracle Terminalと、それを使用して編集できる各種リソースの詳細は、『Oracle Terminalユーザーズ・ガイド』を参照してください。

•	Oracle Terminalでは、SQL*ReportWriter V1.1ユーティリティをTERMDEFに置き換えます。


キー・バインディング

キー・バインディングは、特定のキーを特定のファンクションに"連結"する指定です。キー・バインディングは変更できますが、バインドされるファンクションは、Report Builderによって限定されます。

キー・バインディングを変更するには:

1	オペレーティング・システムのコピー・コマンドを使用して、変更するキー・バインディングを含むリソース・ファイルをコピーし、一意の名前を付けて保存します。（通常、Report Builderで使用されるファイルへの書込みアクセス権限は許可されていません。このアクセス権限があれば、編集するためのファイルが提供されます。

2	オペレーティング・システム・プロンプトでコマンドotを入力し、[Return]キーを押します。

3	ファイル選択ダイアログで、変更するリソース・ファイルを選択します。リソース・エディタのメイン・ウィンドウが現れます。このウィンドウを使用して、リソースを変更する製品（Report Builderなど）、デバイスまたは端末（VT100、Sun4など）、および実行するアクションのタイプを選択します。

4	「製品」フィールド上にカーソルを置き、[List]キーを押します。値リストから「Report Builder」を選択してください。

5	カーソルが「デバイス」の隣のフィールドに位置付けられるまで、[New Field]キーを押します。[List]キーを押します。値リストの使用可能な端末リソース・ファイルがあるすべての端末名から、端末のタイプを選択します。

6	[Menu]キーを押してメイン・メニューにアクセスし、「ファンクション」 [image] 「キーを編集」を選択します。otキー・バインディング・エディタで、使用しているアプリケーション用に任意のキー・バインディングを変更できます。

7	「コンポーネント」リストが見つかるまで[New Field]キーを押し、コンポーネントを選択してから、変更するコンポーネント上にカーソルを置いた状態で[Select]キーを押し、コンポーネントを選択します。

コンポーネントにさらにサブコンポーネントがある場合は、[Select]キーを押しても、そのコンポーネントは選択されません。かわりに、コンポーネントの階層における次の下位レベルが、コンポーネント・リストに表示されます。

この場合のコンポーネントは、キー・バインディングのグループ化が有効なReport Builderの一部（ランタイム・パラメータ・フォームまたはライブ・プレビューアのような場所、あるいはナビゲーションのようなアクションの種類）です。グローバルなキー・バインディングは、ランタイム・エンジンのどこからでも有効です。共通キー・バインディングは、Report Builderのみでなく、他のOracle Toolsでも有効です。

コンポーネントを選択すると、「キー・バインディングを編集...」ボタンがハイライト表示されます。

8	カーソルが「キー・バインディングを編集...」に位置付けられるまで[New Field]キーを押し、次に[Accept]キーを押します。

9	キー・バインディング・エディタで、キー・バインディング定義表を表示します。この表では、選択されたコンポーネントの一部であるアクションと、それらのアクションがバインドされているキーがすべて表示されます。

10	[New Field]キーを1度押して、カーソルをバインディング・リストに位置付けてから、変更するバインディングが見つかるまで[New Item]キーを押します。アクションが現在バインドされているキーの名前を、使用するキーの名前に変更します。

11	希望どおりに変更したら、「OK」をクリックします。

12	メイン・ウィンドウで、変更を適用または取消しできます。変更を取り消す場合は、[Menu]キーを押してから、「ファイル」 [image] 「クローズ」、または「ファイル」 [image] 「終了」を選択し、ファイルは保存しません。変更を保存する場合は、次のステップに進みます。

13	[Menu]キーを押してから、「ファイル」 [image] 「上書き保存」を選択します。

この時点ではまだ、リソース・ファイルの変更バージョンは保存されていません。かわりに、リソース・ファイルに加える変更が保存されます。新規のキー・バインディングをリソース・ファイルに実際に取り込むには、リソース・ファイルを再生成する必要があります。

14	[Menu]キーを押してから、「ファンクション」 [image] 「生成」を選択します。

こうして新規のリソース・ファイルを生成し、キー・バインディングに加えた変更を取り込みます。

警告が現れ、リソース・ファイルが正常に生成されたことを知らせます。警告を受け入れます。

かわりに、エラー・メッセージが戻された場合は、『Oracle Terminalユーザーズ・ガイド』を参照してください。

15	[Menu]キーを押してから、「ファイル」 [image] 「上書き保存」を選択します。

このステップで、リソース・ファイルが保存されます。これでこのファイルを使用して、端末でReport Builderに使用するキー・バインディングを決定できます。

16	otを終了するには、[Menu]キーを押して「ファイル」 [image] 「終了」を選択します。

17	新規のキー・バインディングをテストするには、Report Builderのキャラクタ・モード・ランタイム・エンジンを起動し、「キー一覧」画面を表示します。

18	コマンド・ラインで次のように入力し、すべての必要なパス情報をもう1度入れ直します。rwrun60 term=resfile

上のコマンドで、引数term=resfileは次の2つの目的を果たします。どの端末リソース・ファイルを使用するかを識別することと、このことによって、Report Builderに対し使用している端末を識別させることができるということです。作成した新規のキー・バインディングを使用するためには、引数のresfile部分が生成したリソース・ファイルを指している必要があります。

19	「キー一覧」画面を表示し、リストされたキーを調べます。キー・バインディングに加えた変更が反映されているはずです。


端末定義ファイル

  制限

端末定義ファイルには、様々な端末タイプの機能についての情報が含まれています。これらのファイルは、キャラクタ・モードおよびブロック・モードの端末や、そのようなデバイスをエミュレートする端末にのみ適用されます。Report Builderには、DECファミリのVT100およびVT220、VT320端末といった標準端末用の端末定義ファイルがいくつか付属しています。必要な場合は、これらのうちのどれか1つを変更して、非標準端末用の定義にすることができます。

端末定義では、キー・バインディングとは異なり、端末固有の機能が記述されています。そのため、次のステップでは端末定義のどこをどのように変更するかを示していますが、実際の変更は行いません。非標準端末の新規定義を作成し、端末のマニュアルで必要な仕様がすべて提供されているのでない限り、端末定義は変更しないでください。

端末定義を変更するには:

1	オペレーティング・システム・プロンプトでコマンドotを入力し、[Return]キーを押します。

2	ファイル選択ダイアログが現われます。変更するリソース・ファイルを選択します。リソース・エディタのメイン・ウィンドウが現れます。このウィンドウを使用して、リソースを変更する製品（Report Builderなど）またはデバイス、端末（VT100、Sun4など）、および実行するアクションのタイプを選択します。

3	「製品」フィールド上にカーソルを置き、[List]キーを押します。値リストが現れ、Oracle Terminalを使用してリソースを変更できるすべての製品が表示されます。リストからReport Builderを選択します。

4	[Menu]キーを押して「ファンクション」 [image] 「デバイスを編集」を選択します。デバイス・クラス・エディタが表示されます。デバイス・クラス・エディタには、指定した製品（この場合は、Report Builder）に組み込まれたすべてのデバイスが表示されます。デバイスのすべての上位クラス（VT220端末の場合、上位クラスは"キャラクタ・モード"）も表示されます。このエディタを使用して、端末定義を変更する特定のデバイスを選択します。非標準端末の定義を追加する必要がある場合、通常、同種の端末を選択し、その端末定義を変更してから、それらの変更を新規のファイル名で保存するほうが簡単です。

5	カーソルがデバイス・リスト（"This Class"）に位置付けられるまで、[New Field]キーを押します。端末名が表示されない場合、ご使用の端末はデバイス階層の下位レベルにある可能性があります。

クラス・リストの右側には、デバイス階層が図で表示されています。これを使用して、端末の上位デバイスを調べます。上位デバイスが見つかったら、クラス・リストのそのデバイス上にカーソルを位置付け、[Accept]キーを押します。端末名がクラス・リストに現れるまで、クラス・レベルを下にたどっていきます。カーソルを端末名の上に位置付け、[Select]キーを押します。

6	「デバイスを編集」がハイライト表示されます。カーソルが「デバイスを編集」ボタン上に位置付けられるまで[New Field]キーを押し、[Accept]キーを押します。「デバイス表示定義」画面が表示されます。これは、Report Builderが端末と通信するときに参照するデバイス特性のリストです。カーソルが適切なフィールドに位置付けられるまで[New Field]キーを押し、希望する値を入力して、任意の値を変更します。

端末の他の定義を変更するには、「属性」および「編集」、「標準キー」、「ユーザー・キー」ボタンを押してダイアログ・ボックスを表示させます。これらのダイアログの詳細は、『Oracle Terminalユーザーズ・ガイド』を参照してください。

非標準端末の新規端末定義ファイルを作成するつもりが特にない限り、これらの値は変更しないでください。これらはデバイスに従って設定されており、ユーザーが定義できるものではありません。

非標準端末の新規端末定義ファイルを作成する場合は、ご使用の端末のマニュアルを参照して、使用する適切な値を調べてください。

7	ファイルの変更が終了したら、[Menu]キーを押し、「ウィンドウ」を選択してから、編集中のリソース・ファイルの名前を持つメイン・ウィンドウを選択します。

8	[Menu]キーを押してから、「ファンクション」 [image] 「生成」を選択します。

こうして新規のリソース・ファイルを生成し、キー・バインディングに加えた変更を取り込みます。

警告が現れ、リソース・ファイルが正常に生成されたことを知らせます。警告を受け入れます。

かわりに、エラー・メッセージが戻された場合は、『Oracle Terminalユーザーズ・ガイド』を参照してください。

9	[Menu]キーを押してから、「ファイル」 [image] 「別名保存」を選択します。

10	otを終了するには、[Menu]キーを押して「ファイル」 [image] 「終了」を選択します。


端末定義の制限

•	一部のオペレーティング・システムでは、文字列に二重引用符のかわりに一重引用符が必要となる場合があります。また、端末リソース・ファイルによっては、大/小文字を区別する場合があります。


端末リソース・ファイルの参照

デフォルト以外の端末リソース・ファイルを使用する場合は、TERMシステム・パラメータを使用します。


別名

別名は、他のSELECT文で使用するのと同様に、問合せのSELECT文で使用できます。別名の詳細は、『Oracle8 Server SQLリファレンス』を参照してください。列に別名を使用する場合、その別名はReport Builderの列名になります。

別名をパラメータと一緒に使用する場合、その別名に関係付けられた列の変更は注意して行なう必要があります。たとえば、問合せに次のSELECT文を作成したと仮定します。

SELECT &NAME NAME, &PAY PAY FROM EMP

最初にレポートを作成する際、&NAMEがCHAR列の名前、&PAYがNUMBER列の名前であるとします。実行時に&NAMEパラメータにCHAR列ではない列の名前を入力すると、エラーが発生します。別名の名前は変更されないので、Report Builderでは、その列がレポートを作成したときと同じデータ型の列であると見なされます。


コメント

Oracleの標準SQLコメント・デリミタ（/* comment */など）を使用して、SELECT文に直接コメントを挿入できます。『Oracle8 Server SQLリファレンス』を参照してください。

注意: コメントを入力するのに、「問合せ」プロパティ・シートの「コメント」ボタンを使用することもできます。


列およびパラメータ参照の制限

•	問合せでバインド参照および字句参照を使用しているとき、値がないために問合せによる解析が正しく行われない場合、パラメータまたは列にそれぞれ初期値またはNULLの場合の値を指定する必要があります。たとえば、問合せにはFROM句がある必要があります。FROM句に字句参照を使用する問合せを作成する場合、字句参照に対応するパラメータには、SELECT文が有効になるように初期値（EMPなど）がある必要があります。

•	文字データ型のパラメータは、明示的にSQL文に埋め込まない限り、埋め込まれません。

•	Report Builderの列がページ設定でのリセットを設定したサマリーである場合、その列は問合せで（バインド参照または字句参照を介して）参照できません。たとえば、AVG_SALがレポートの各ページの平均給与を計算するサマリー列である場合、次のバインド参照は無効です。

SELECT SAL FROM EMP
WHERE SAL > :AVG_SAL

•	問合せには、問合せの上のグループ（つまり、問合せの親グループまたは上のグループ）に属すデータベースのタイプを持つ列への参照しか含むことができません。たとえば、グループG_1はSALというデータベース列を含み、問合せQ_1に属しているとします。グループG_1はQ_2という別の問合せを所有しています。SALはQ_2では参照できますが、Q_1ではできません。

•	問合せは、ソース列が問合せの下にあるサマリー列または式列への参照しか含むことができません。たとえば、グループG_1にSUM_SALというサマリー列を作成するとします。G_1は問合せQ_1に属しており、Q_2という別の問合せを所有しています。そのため、問合せQ_1にはSUM_SALへの参照を含むことができますが、問合せQ_2にはそのような参照を含むことができません。

•	日付データ型のパラメータへの参照が式で使用されている場合、TO_DATEファンクションを使用する必要があります。


バインド参照

  制限 	  例	  関連項目

バインド参照（またはバインド変数）は、文字列または数値、日付などの、SQLまたはPL/SQLの1つの値を置換するのに使用されます。バインド参照は、特に問合せのSELECT句、WHERE句、GROUP BY句、ORDER BY句、HAVING句、CONNECT BY句およびSTART WITH句の式を置換するために使用できます。バインド参照はFROM句では参照できません。また、予約されている語や句のかわりにも参照できません。

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


バインド参照の制限

•	バインド参照は、予約されているどのSQLキーワードとも異なっている必要があります。詳細は、『Oracle8 Server SQLリファレンス』を参照してください。


バインド参照の例

  関連項目 	  すべての例

SELECT句

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

DFLTCOMMの値は、選択した行のCOMMPLANのNULL値に置き換わります。

WHERE句

SELECT ORDID, TOTAL  FROM ORD WHERE CUSTID = :CUST

CUSTの値は、1つの顧客を選択するのに使用されます。

GROUP BY句

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

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

HAVING句

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

MINTOTALの値は、受注総額が最小の顧客を選択するのに使用されます。

ORDER BY句

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

SORTの値は、ソートの基準として、SHIPDATEまたはORDERDATEのいずれかを選択するのに使用されます。:SORTは、SELECTリストでの式の位置の特定のためではなく、値として使用されるので、ORDER BY 1と同じではないことに注意してください。この例では、DECODEが必要なことに注意してください。DECODEがなければ、ORDER BY句にバインド変数を使用できません。

CONNECT BY句およびSTART WITH句

CONNECT BY句およびSTART WITH句での参照は、WHERE句およびHAVING句の場合と同様に使用されます。

PL/SQL

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

myparamの値は2倍にして、myparamに割り当てられます。


字句参照

  制限 	  例

字句参照は、SELECT文に埋め込まれたテキストのプレースホルダです。字句参照を使用して、SELECT、FROM、WHERE、GROUP BY、ORDER BY、HAVING、CONNECT BYおよびSTART WITHの後に表示される句を置換できます。

PL/SQL文で字句参照を作成できません。ただし、PL/SQLのバインド参照を使用してパラメータの値を設定し、それをSQLで字句によって参照できます。後に示す例を参照してください。

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

•	問合せを作成する前に、問合せの各字句参照に対して、データ・モデルの列またはパラメータを定義します。列にはNULLの場合の値、パラメータには初期値を入力する必要があります。Report Builderではこれらの値を使用して、字句参照を持つ問合せを有効にします。

•	字句参照を含む問合せを作成します。


字句参照の制限

•	PL/SQL文で字句参照を作成できません。

•	列またはパラメータが問合せで字句参照として使用されている場合、データ型は文字である必要があります。

•	SELECT句で字句参照を使用する場合、置換する列ごとに異なる字句参照を作成する必要があります。さらに、各字句参照に別名を割り当てる必要があります。これにより、ランタイム・パラメータ・フォームの字句参照に入力するどのような値にも、同じレイアウト・フィールドとボイラープレート・ラベルを使用することができます。

•	SELECT句に字句参照を使用する場合、実行時にレポートのデータ・モデルに指定したのと同数の項目を指定する必要があります。さらに、実行時に字句参照に指定する各値は、その初期値と同じデータ型である必要があります。

•	SELECT句に字句参照を使用する場合、列の幅はパラメータの「初期値」で決まります。したがって、パラメータの「初期値」が、使用する列の最大幅に相当することを確認する必要があります。

•	Report Builderのリンクは、字句参照に依存してはいけません。つまり、リンクの子列または表名のどちらも、字句参照によって判別してはいけません。この機能を達成するには、列を指定しないでリンクを作成し、そのリンクに対するSQL句（WHEREなど）を問合せに直接入力する必要があります。たとえば、親および子問合せを次のように書きます。

Parent Query:SELECT DEPTNO FROM EMP
Child Query:   SELECT &PARM_1 COL_1,
               &PARM2 COL_2 FROM EMP
               WHERE &PARM_1 = :DEPTNO

•	親問合せで選択されたDEPTNOへのバインド参照が、WHERE句でどのように作成されるかに注意してください。また、この例では、データ・モデル・エディタの問合せ間のリンクを、列を指定しないで作成したと仮定しています。

•	「After Formトリガー」が起動すると、字句参照を使用して追加のバインド変数を作成できません。たとえば、次のような問合せがあるとします（WHERE句は、字句参照に置き換わることに注意）。

SELECT ENAME, SAL FROM EMP
&where_clause

WHERE_CLAUSEパラメータの値にバインド変数への参照が含まれている場合、「After Formトリガー」内またはそれ以前に値を指定する必要があります。「Before Reportトリガー」のパラメータに次の値を指定すると、エラーが発生します。

WHERE SAL = :new_bind

この値を「After Formトリガー」内で指定すると、レポートは実行されます。


字句参照の例

  関連項目 	  すべての例

SELECT句

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

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

FROM句

SELECT ORDID, TOTAL FROM &ATABLE

ATABLEは、実行時に列を選択する表を変更するのに使用できます。たとえば、実行時にATABLEにORDを入力できます。このように表名を動的に変更する場合、列名が表間で異なるならば、SELECT句にも字句参照を使用することができます（前の例を参照）。

WHERE句

SELECT ORDID, TOTAL FROM ORD WHERE &CUST

CUSTは、ORDから取り出されるレコードを制限するのに使用できます。任意の書式のWHERE句を、実行時に指定できます。

GROUP BY句

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

NEWCOMMの値は、GROUP BY句を定義するのに使用できます。

HAVING句

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

MINTOTALの値は、たとえば、受注総額が最小の顧客を選択するのに使用できます。

ORDER BY句

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

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

CONNECT BY句およびSTART WITH句

CONNECT BY句およびSTART WITH句のパラメータは、WHERE句およびHAVING句の場合と同様に使用されます。

複数の句

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を入力できます。

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というパラメータ（文字データ型）の値を指定できます。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では、必要な場合には、TO_CHARがユーザーが選択するブレーク列の周辺に必ず置かれます。SQLで、BREAK_COLへの字句参照をどのように作成するかに注意してください。PL/SQLでは字句参照ができないので、BREAK_COLへのバインド参照を作成する必要があります。


DMLおよびDDL

PL/SQLでDMLまたはDDLを使用する場合、SRW.DO_SQLパッケージ・ファンクションを使用する必要があります。SRW.DO_SQLは、DMLおよびDDLにのみ使用され、データのフェッチには使用できないことに注意してください。DMLおよびDDLの詳細は、『Oracle8 Server SQLリファレンス』を参照してください。

Report Builderの処理モデルのために、「Before Reportトリガー」および「After Reportトリガー」では、DDLのみを使用してください。

DMLは、PL/SQLを受け入れる場所ならばどこにでも入力できます。

注意:  SRW.DO_SQLを使用すると、レポート実行のオーバーヘッドが多少増えます。


?


サポートされているファイル

ファイル	内容	移植性	使用	作成
.afc	AIFCサウンド（バイナリ・ファイル）	-	ボタンに関係付けられている場合	Report Builderでは作成されない
.aff	AIFFサウンド （バイナリ・ファイル）	-	ボタンに関係付けられている場合	Report Builderでは作成されない
.au	AUサウンド （バイナリ・ファイル）	-	ボタンに関係付けられている場合	Report Builderでは作成されない
.avi	Windowsビデオ （バイナリ・ファイル）	-	プレビューア内、ボタンに関係付けられている場合	Report Builderでは作成されない
.cal	CALSイメージ （バイナリ・ファイル）	-	レポート・エディタ内（ライブ・プレビューアまたはレイアウト、パラメータ・フォーム）	「ファイル」 [image] 「エクスポート」
.bmp	BMPイメージ （バイナリ・ファイル）	-	レポート・エディタ内（ライブ・プレビューアまたはレイアウト、パラメータ・フォーム）	「ファイル」 [image] 「エクスポート」
.cgm	CGM描画 （バイナリ・ファイル）	-	レポート・エディタ内（ライブ・プレビューアまたはレイアウト、パラメータ・フォーム）	「ファイル」 [image] 「エクスポート」
.gif	GIFFイメージ （バイナリ・ファイル）	-	レポート・エディタ内（ライブ・プレビューアまたはレイアウト、パラメータ・フォーム）	「ファイル」 [image] 「エクスポート」
.jfi	JFIFイメージ （バイナリ・ファイル）	-	レポート・エディタ内（ライブ・プレビューアまたはレイアウト、パラメータ・フォーム）	「ファイル」 [image] 「エクスポート」
.moo	QuickTimeビデオ（バイナリ・ファイル）	-	ボタンに関係付けられている場合	Report Builderでは作成されない
.odf	Oracle描画 （バイナリ・ファイル）	-	レポート・エディタ内（ライブ・プレビューアまたはレイアウト、パラメータ・フォーム）	「ファイル」 [image] 「エクスポート」
.oif	Oracleイメージ（バイナリ・ファイル）	-	レポート・エディタ内（ライブ・プレビューアまたはレイアウト、パラメータ・フォーム）	「ファイル」 [image] 「エクスポート」
.pal	カラー・パレット（バイナリ・ファイル）	-	レポート・エディタ内（ライブ・プレビューアまたはレイアウト、パラメータ・フォーム）	「ファイル」 [image] 「エクスポート」
.pcx	PCXイメージ （バイナリ ・ファイル）	-	レポート・エディタ内（ライブ・プレビューアまたはレイアウト、パラメータ・フォーム）	「ファイル」 [image] 「エクスポート」
.pic	PICTイメージ （バイナリ ・ファイル）	-	レポート・エディタ内（ライブ・プレビューアまたはレイアウト、パラメータ・フォーム）	「ファイル」 [image] 「エクスポート」
.pld	PL/SQLライブラリ（テキスト・ファイル）	あり	「ファイル」 [image] 「管理」 「変換」	「ファイル」 [image] 「上書き保存」、 「ファイル」 [image] 「別名保存」
.pll	PL/SQLライブラリ（ソース/Pコード付きバイナリ・ファイル）	あり	オブジェクト・ナビゲータの連結ライブラリの場合	「ファイル」 [image] 「上書き保存」、 「ファイル」 [image] 「別名保存」
.prt	キャラクタ・モードでのプリンタ定義（テキスト・ファイル）	あり	DESFORMAT	Report Builderでは作成されない
.ras	Sunラスター・イメージ（バイナリ・ファイル）	-	レポート・エディタ内（ライブ・プレビューアまたはレイアウト、パラメータ・フォーム）	「ファイル」 [image] 「エクスポート」
.rdf	レポート定義（ソース/Pコード付きバイナリ・ファイル）	あり	「ファイル」 [image] 「オープン」、 「ファイル」 [image] 「実行」、 「ファイル」 [image] 「管理」 「変換」	「ファイル」 [image] 「上書き保存」、 「ファイル」 [image] 「別名保存」、 「ファイル」 「管理」 「変換」
.rep	レポート定義（ソース/Pコード付きバイナリ・ファイル）	あり（コンパイル済みのPL/SQLがない場合）	レポート実行時	「ファイル」 「管理」 「変換」
.rex	レポート定義（テキスト・ファイル）	あり	「ファイル」 [image] 「管理」 「変換」	「ファイル」 「管理」 「変換」
.sql	問合せ定義（テキスト・ファイル）	あり	問合せ作成時	「ファイル」 [image] 「上書き保存」、 「ファイル」 [image] 「別名保存」
.snd	SNDサウンド （バイナリ ・ファイル）	-	ボタンに関係付けられている場合	Report Builderでは作成されない
.tif	TIFFイメージ （バイナリ ・ファイル）	-	レポート・エディタ内（ライブ・プレビューアまたはレイアウト、パラメータ・フォーム）	「ファイル」 [image] 「エクスポート」
.wav	WAVEサウンド （バイナリ ・ファイル）	-	ボタンに関係付けられている場合	Report Builderでは作成されない
使用上の注意

•	Report Builder付属のSQLスクリプトも拡張子.sqlを持つファイルです。

•	オラクル社は、.rexまたは.pldファイルの編集によって変更されたモジュールをサポートしていません。

•	プリンタ定義ファイルは、キャラクタ・モード環境で実行されるレポートまたはReport Builder ASCIIドライバで実行されるレポートにのみ使用されます。ビットマップ・プラットフォームで実行されるレポートでは、プリンタ・コードおよびプリンタ定義は無視されます。これは、その機能が「書式」メニューでの設定値（フォント、フォントの太さなど）に置き換えられるからです。

•	オブジェクトをReport BuilderからCGMにエクスポートすると、オブジェクトがCGMで複数のオブジェクトに分割されることがあります。たとえば、塗りパターン付きの四角形をエクスポートすると、このオブジェクトはCGMでは2つのオブジェクトになります。1つは四角形自体のオブジェクト、もう1つは塗りパターンのオブジェクトです。

•	OLE2オブジェクトは、Report Builderによって表示できます。データベースに格納されたOLE2オブジェクトについては、「ファイル形式」プロパティをOLE2に設定します。ファイルに格納されたOLE2オブジェクトについては、「ファイルからの読込み」を選択し、列のプロパティ・パレットで「ファイル形式」をOLE2に設定します（これで、データベース列にOLE2オブジェクトの名前が含まれていると見なされます）。

•	指定するオプションによって、Report Builderでは次のうちのいずれかのファイルを作成します。

•	プロファイラ・ログ・ファイル

•	エラー・ログ・ファイル

•	トレース・ログ・ファイル

•	作業環境ファイル

•	キーストローク・ファイル（キャラクタ・モードのみ）

•	印刷スクリーン・ログ・ファイル（キャラクタ・モードのみ）


作業環境ファイル

「ツール」 [image] 「作業環境」を選択して設定した作業環境は、作業環境ファイルに保存し、そこから取り出します。（このファイルには、他のすべてのOracle Toolsの作業環境も含まれています。

ユーザ-自身の作業環境ファイルがない場合、 Report Builderでは、インストール中に作成されたグローバル作業環境ファイルから作業環境が取り出されます。作業環境を編集して保存すると、 Report Builderでは、ユーザー専用のローカル作業環境ファイルが作成されます。ユーザー専用の作業環境ファイルが作成されると、Report Builderでは、グローバル作業環境ファイルのかわりにそのファイルが使用されます。

これらのファイルの正確な名前と場所は、オペレーティング・システムによって異なる場合があります。作業環境ファイルの内容は移植可能ですが、別のオペレーティング・システムに移植する場合、必ずそのプラットフォームに適した名前を付けて、正しい場所に置く必要があります。


フォント・マッピング・ファイル

Report Builderでは、フォントの別名をサポートしています。Report Builderで使用されるフォント・マッピングは、ファイルuifont.aliで定義されます。このファイルを編集することによって、これらのマッピングを変更できます。このファイルの位置は、使用しているオペレーティング・システムによって異なります。Report Builderのインストールに使用するファイルの詳細は、インストレーション・マニュアルを参照してください。


一時ファイル

Report Builderでは、レポートの実行中に一時ファイルを作成します。

•	フォーマットするのに複数のパスが必要なレポート（合計論理ページのソースを持つフィールドなどの前方参照を持つレポートなど）を実行するときに、スワップ・ファイルが作成されます。スワップ・ファイルには、Report Builderでレポートの長さを決定したり、前方参照を解決するのに使用されるレポートの各ページの最初のパス・コピーが含まれています。すべてのページがフォーマットされるまでに、このファイルのサイズは最終出力サイズの約2倍になります。レポートの作成時には、テスト時間を短縮するために、前方参照フィールドを除外する必要があります。

スワップ・ファイルには、一意識別子となる名前が付けられます。

•	データ・キャッシュ・ファイルは、データベースから取り出されるすべてのデータ・レコード、およびレポートのすべての集計の値をキャッシュに入れるのに使用されます。このファイルのサイズは、レポート内のデータ量を反映します。レコードは、各列に割り当てられた領域が、各列の最大サイズではなく、現在の値を収められるだけの大きさになるようにパックされます。

データ・キャッシュ・ファイルには、datXXXXという名前が付けられ、XXXXは一意です。

•	索引ファイルは、レポート内のブレークの追跡に使用されます。このファイルには、レポートのデータ・モデルで定義された関係に従ってデータを走査するために構築されたツリー構造体が含まれています。このファイルのサイズは、次のものによって決まります。

•	レポート内のグループ数

•	各グループ内のレコード数

•	各グループのブレーク列のサイズ

•	グループ・ツリーの深さ

索引ファイルはidxXXXXXという名前が付けられ、XXXXは一意です。

一時ファイルのサイズ

一時ファイルは、様々な理由で非常に大きくなる可能性があります。一時ファイルが大きくならないように、次の点を考慮してください。

•	可能ならば、問合せ内で計算を行います。これにより、レポートの取り出すデータ量が、サマリー列または式で計算を行う場合と比べて少なくてすむので、データ・キャッシュ・ファイルのサイズを小さくすることができます。

•	可能ならば、ブレーク・グループごとのブレーク列のサイズと数を減らします。これにより、ファイル内のツリー構造体のサイズが小さくなるので、索引ファイルのサイズを小さくすることができます。

•	可能ならば、前方参照（合計論理ページのソースを持つフィールドなど）を排除します。これにより、 Report Builderでは、フォーマットを行う前にレポート出力をスワップ・ファイルに保存しておく必要がなくなるので、スワップ・ファイルを排除できます。


ファイル検索メソッド

Report Builderのファイルを参照する場合、次の順でファイルが検索されます。

1	ファイル名の前に付けられているパス（/home/jsmithなど）（ある場合）。

2	使用しているオペレーティング・システムで現行のパスと見なされるパス。

3	環境変数REPORTS60_PATHで指定されたパス。

4	環境変数ORACLE_PATHで指定されたパス。

5	Report Builderを起動した際の場所。

使用上の注意

•	拡張子を入力しない場合、Report Builderでは、検索を実行する前に拡張子を追加します。ファイルが見つからないと、Report Builderでは、次にその拡張子を外して検索します。

•	プリンタおよび端末定義とアイコンを検索する場合は、検索順序が異なります。


プリンタおよび端末定義ファイル検索メソッド

プリンタ定義ファイル検索メソッド

1	使用しているオペレーティング・システムで現行のパスと見なされるパス。

2	環境変数REPORTS60_PATHで指定されたパス。

3	環境変数ORACLE_PATHで指定されたパス。

4	ORACLE_HOME/REPORT60/printersサブディレクトリまたはフォルダ。

端末定義ファイル検索メソッド

1	環境変数REPORTS60_TERMINALで指定されたパス。

2	環境変数ORACLE_TERMINALで指定されたパス。

3	ORACLE_HOME/REPORT60/admin/terminalサブディレクトリまたはフォルダ。


アイコン・ファイル検索メソッド

Report Builderでボタンを作成する場合、そのボタンにラベルではなくアイコンを割り当てることができます。アイコンのフル・パスを指定しないと、Report Builderでは、UI_ICON環境変数によって定義されたパスでそのアイコンを検索します。


データベースの表

Report Builderと一緒に使用される表は3セットあります。

デモ表	デモンストレーション・レポートで使用されるサンプル・データが含まれています。
データ表	ユーザーのデータが含まれています。
Report Builder表	レポートおよび外部問合せ、外部PL/SQLライブラリが含まれています。データベースにレポートを格納する場合は、これらの表をインストールする必要があります。詳細は、インストレーション・マニュアルを参照してください。


データベースのセキュリティの確立と制限

  関連項目

Report Builderのユーザーに対しては、次の2つのタイプの制限を加えることができます。

•	Report Builderへのアクセス権限の付与および取消

•	データベースに格納されたレポートへのアクセスの許可および禁止

アクセス権限付与と権限取り消しについての詳細は、インストレーション・マニュアルを参照して下さい。

使用上の注意

•	Report Builderのセキュリティ機構は、OracleのGRANTおよびREVOKEコマンドを利用します。GRANTおよびREVOKEによって加えた制限は、そのまま適用されます。

•	ファイルは、ファイル・システムによって保護されます。Report Builderには、ファイルのセキュリティ機能がありません。

•	レポートの作成者のみが、他のユーザーにそのレポートへのアクセス権限を付与できます。また、他のユーザーにアクセス権限を付与したとしても、レポートを変更できるのは作成者のみです。


?


サマリー列の作成

  関連項目

データ・ウィザードを使用して（合計または小計の）サマリー列を作成するには:

1	データ・モデル表示で、合計を算出する列が入った問合せをクリックします。

2	「ツール」 [image] 「データ・ウィザード」を選択します。

3	「合計」ページで、ウィザードに従い希望する集計をレポートに追加します。注意

ツール・パレットを使用して（合計または小計の）サマリー列を作成するには:

1	データ・モデル表示で、ツール・パレットの [image] をシングルクリックします。次に、

•	グループ内に列を作成する場合は、目的のグループの中で、列を配置する階層位置をクリックします。

•	レポートレベルの列を作成する場合は、キャンバス領域のオープン・エリア内でクリックします。

2	プロパティ・パレットを表示するには、集計列オブジェクトをダブルクリックします。

3	「集計」ノードで次の操作を行います。

•	ドロップダウン・リストから希望するサマリーのタイプを選択して、「ファンクション」プロパティを設定します。

•	「ソース」プロパティに、集計する列を設定します。


式列の作成と編集

  関連項目

式列を作成または編集するには:

1	データ・モデル表示内で、ツール・パレットの [image] をシングルクリックします。次に:

•	グループ内に列を作成する場合は、目的のグループの中で、列を配置する階層位置をクリックします。

•	レポートレベルの列を作成する場合は、キャンバス領域のオープン・エリア内でクリックします。

2	プロパティ・パレットを表示するには、式列オブジェクトをダブルクリックします。

3	「プレースホルダ/式」ノード下で、「PL/SQL式」プロパティの値フィールドをダブルクリックします。

4	PL/SQLエディタ内で、PL/SQL式（たとえば、SAL*0.07）を定義します。


プレースホルダ列の作成

  次へ	  関連項目

プレースホルダ列を作成または編集するには:

1	データ・モデル表示内で、ツール・パレットの [image] をシングルクリックします。

•	グループ内に列を作成する場合は、目的のグループの中で、列を配置する階層位置をクリックします。

•	レポートレベルの列を作成する場合は、キャンバス領域のオープン・エリア内でクリックします。

2	プレースホルダ列オブジェクトをダブルクリックします。

3	プロパティ・パレット内で、プレースホルダ列に対して、必要なプロパティを設定します。

プレースホルダ列の値は、次の場所に設定できます。

•	プレースホルダーがレポートレベルの列の場合、Before Reportトリガー

•	プレースホルダーがレポートレベルの列である場合、レポートレベルの「式列」

•	プレースホルダのグループ、またはその下のグループ（グループの各レコードに一度、値が設定されます）


ページ番号の作成

  次へ	  関連項目	  例

ページ番号のスクリプトを作成するには:

1	ライブ・プレビューア表示で、ツールバーの [image] をクリックします。注意

2	ドロップダウン・リストから、ページ番号の位置を選択します。

3	希望するページ番号の書式は、「ページ番号のみ(N)」または「ページ番号と合計ページ(T)」のどちらかを選択します。

4	（オプション）必要に応じて、ページ番号テキストの属性のデフォルトを変更します。

ページ番号のユーザー設定を行うには:

1	レイアウト・モデル表示内で、ツールバー内の [image] をクリックします。注意

2	マージン領域内に、フィールド・オブジェクトを作成し、必要と思われるページ番号を定義します（たとえば、物理ページ番号、合計物理ページ番号）。

3	フィールドのプロパティ・パレット内の「フィールド」ノードで、ページ番号に対するソースに「ソース」プロパティを設定し、「可視」プロパティを「いいえ」に設定します。「標準レイアウト」ノードの「水平拡張度」プロパティを「可変」に設定します。

4	マージン領域に、ボイラープレート・テキスト・オブジェクトを作成します。&フィールド名を使用してページ番号フィールドを参照します。


ページ番号の再設定

ページ番号の既定値をリセットする（作成日付、 [image] または [image] ページ番号の挿入）には:

1	ページ番号の既定値をクリックします。削除する場合は、次に「編集」 [image] 「消去」を選択します。

2	ユーザーが設定したページ番号を作成します。

3	ページ番号フィールドのプロパティ・パレットにある「フィールド」下で、「ページ番号付け」プロパティの値フィールドをダブル・クリックします。

4	ダイアログ内で、希望する「リセット場所」設定をクリックします。ページ番号は、選択した枠がフォーマットされるたびに開始の値にリセットされます。「OK」をクリックします。


日付/タイム・スタンプの作成

  関連項目

日付/タイム・スタンプを追加するには:

1	ライブ・プレビューア表示で、ツールバーの [image] をクリックします。注意

2	ドロップダウン・リストから、日付、またはタイム・スタンプの位置を選択します。

3	希望する日付/時刻の書式をクリックするか、または「カスタム」ボタンをクリックして専用の書式を定義します。


ハイパーリンクの作成

  制限	  例	  関連項目

レポートにハイパーリンクを追加するには:

1	Webリンクのターゲットとなるハイパーリンクの宛先を作成します。

2	オブジェクト・ナビゲータで「レイアウト・モデル」ノードを拡張した後、Webリンクのソースとなるオブジェクトが含まれたノードを拡張します。注意

3	プロパティ・パレットを表示するために、Webリンクでソースとなるオブジェクトをダブルクリックします。

4	「Webの設定」ノードの「ハイパーリンク」プロパティにリンクの宛先を設定します。注意

5	追加のHTML属性をハイパーリンクに適用するには、「追加のハイパーリンク属性」プロパティを必要に応じて設定します。例

6	チャートのセクションにハイパーリンクを追加するには、チャートのハイパーリンクを作成します。


アプリケーション・コマンド・ライン・リンクの作成

  制限	  例	  関連項目

レポート内で、コマンドにオブジェクトを関係付けるには:

1	オブジェクト・ナビゲータ内で「レイアウト・モデル」ノードを拡張し、次に、関連付けるコマンドが入っているオブジェクトを含むノードを拡張します。注意

2	コマンドを関係付けるオブジェクトをダブルクリックし、プロパティ・パレットを表示します。

3	「Webの設定」ノードの「アプリケーション・コマンド・ライン（PDF）」プロパティに、オブジェクトをクリックしたときに実行するコマンドを設定します。注意


ブックマークの作成

  例	  関連項目

HTMLまたはPDFドキュメントのブックマーク領域内にあるブレイク・グループすべてにブックマークを作成するには:

1	「ツール」 [image] 「Webウィザード」を選択します。

2	ウィザードの「ブックマーク」ページで、「ブックマーク」リストに希望する列を移動します。

3	「完了」ページで、希望するアウトプットを選択して、Webブラウザ、またはPDFビューア内に表示するファイルにそれを保存します。

HTMLまたはPDFドキュメントのブックマーク領域内にある他のレポート・オブジェクトにブックマークを作成するには:

1	オブジェクト・ナビゲータで「レイアウト・モデル」ノードを拡張した後、ブックマークに関係付けるオブジェクトが含まれたノードを拡張します（通常、オブジェクトは、レポートの関連セクションを囲む繰返し枠または枠です）。注意.

2	プロパティ・パレットを表示するブックマークを関係付けるオブジェクトをダブルクリックします。

3	「Webの設定」ノード下で、「ブックマーク」プロパティに、フォーマット済みのレポートのブックマーク領域に表示する文字列を設定します。


ハイパーリンクの出力先を作成

  例	  次へ	  関連項目

レポートにハイパーリンクの出力先を追加するには:

1	オブジェクト・ナビゲータで「レイアウト・モデル」ノードを拡張した後、Webリンクの宛先となるオブジェクトが含まれたノードを拡張します。注意

2	Webリンクの出力先オブジェクトをダブルクリックし、プロパティ・パレットを表示します。

3	「Webの設定」ノード下で、「ハイパーリンクの宛先」プロパティに、オブジェクトの識別子を設定します。


URLへのイメージ・オブジェクトのリンク

  例 	  関連項目

URLにイメージ・オブジェクトをリンクするには:

1	ライブ・プレビューア表示で、ツール・パレットの [image] をクリックします。注意

2	クリック・アンド・ドラッグで四角形を描きます。

3	プロパティ・パレットを表示するには、リンク・ファイル・オブジェクトをダブルクリックします。

4	「リンク・ファイル・ボイラープレート」ノード下での注意点

•	「ソース・ファイル形式」プロパティを、「イメージURL」に設定します。

•	「ソース・ファイル名」プロパティを、必須プロトコルでイメージを配置するURLに設定します。例


データベースからのイメージURLの選択

  関連項目

データベースからURLを選択するには:

1	URLを含む列を選択するSELECT文を使用して、問合せを作成します。

2	データ・モデル表示内で、URLを含む列をダブルクリックします。

3	プロパティ・パレット内で、「列」ノードの下の:

•	「ファイルからの読込み」プロパティを「はい」に設定します。

•	「ファイル形式」プロパティを「イメージURL」に設定します。


HTMLタグのボイラープレート・テキスト・オブジェクトの作成

  例	  関連項目

HTMLタグにボイラープレート・テキスト・オブジェクトを作成するには:

1	ライブ・プレビューア表示、レイアウト・モデル表示、またはパラメータ・フォーム表示でツール・パレット内の [image] をクリックします。

2	クリック・アンド・ドラッグで四角形を描きます。

3	新しいボイラープレート・オブジェクト内で、目的のHTMLをタイプ、またはインポート（「ファイル」 [image] 「インポート」 [image] 「テキスト」）します。注意

4	ボイラープレート・テキスト・オブジェクトの外側をクリックします。

5	ボイラープレート・テキスト・オブジェクトをダブルクリックします（または、オブジェクトのポップアップ・メニューを表示して、プロパティ・パレットをクリックします）。

6	「標準レイアウト」下のプロパティ・パレット内で、「HTMLタグを含む」プロパティを「はい」に設定します。


ファイルへのHTMLオブジェクトのリンク

  関連項目

ファイルにHTMLオブジェクトをリンクするには:

1	ライブ・プレビューア表示またはレイアウト・モデル表示でツール・パレットの [image] をクリックします。

2	クリック・アンド・ドラッグで四角形を描きます。

3	プロパティ・パレットを表示するには、リンク・ファイル・オブジェクトをダブルクリックします。

4	「リンク・ファイル・ボイラープレート」ノード下での注意点

•	「ソース・ファイル形式」プロパティを「テキスト」に設定します。

•	「ソース・ファイル名」プロパティに、HTMLタグが含まれたファイル名を設定します。

5	「Webの設定」ノードで、「HTMLタグを含む」プロパティを「はい」に設定します。


データベースからのHTMLタグの選択

  関連項目

データベースからHTMLタグを選択するには:

1	HTMLタグ、またはHTMLタグを含むファイル名を含んだ列を選択するSELECT文での問合せを作成します。

2	プロパティ・パレットを表示するには、データ・モデル表示内で、HTMLタグ列をダブルクリックします。

3	HTMLタグ自体ではなく、HTMLタグを含むファイル名が列に入っている場合は、

•	「列」ノードの「ファイルからの読込み」プロパティを「はい」に設定します。

•	「ファイル形式」プロパティを「テキスト」に設定します。

4	レイアウト・モデル表示内で、列を参照するフィールド・オブジェクトを作成します。

5	フィールド・オブジェクトをダブルクリックします。

6	「Webの設定」下のプロパティ・パレット内で、「HTMLタグを含む」プロパティを「はい」に設定します。


HTMLドキュメント・ヘッダーの作成

  例	  関連項目

HTMLドキュメントのヘッダー・ページにHTMLファイルを挿入するには:

1	「ツール」 [image] 「Webウィザード」を選択します。

2	ウィザードの2番目のページで、「ヘッダーＨＴＭＬファイル」プロパティに名前を入力するか、または「参照」ボタンをクリックして名前を検索します。

3	最後のページで、「ＨＴＭＬを出力生成」または「ＨＴＭＬスタイル・シート出力を生成」を選択します（ブラウザがHTMLスタイル・シート・イクステンションをサポートしている場合）。そして、Webブラウザ内に表示させるファイルに出力を保存します。

HTMLドキュメントのヘッダー・ページに他の項目を追加するには:

1	オブジェクト・ナビゲータ内で、 [image] （レポートのプロパティ・アイコン）をダブルクリックして、プロパティ・パレットを表示します。

2	「レポート・エスケープ」ノードの「レポート前型」プロパティを、「テキスト」（ヘッダーを入力する場合）か、または「File」（ファイルからヘッダーをインポートする場合）に設定します。

3	「レポート前値」プロパティの「…」ボタンをクリックしてダイアログにHTMLコードを入力するか、インポートするHTMLファイルを指定します。


HTMLドキュメント・フッターの作成

  例	  関連項目

HTMLドキュメントのフッター・ページにHTMLファイルを挿入するには:

1	「ツール」 [image] 「Webウィザード」を選択します。

2	ウィザードの2番目のページで、「フッターＨＴＭＬファイル」プロパティに名前を入力するか、または「参照」ボタンをクリックして名前を検索します。

3	最後のページで、「ＨＴＭＬを出力生成」または「ＨＴＭＬスタイル・シート出力を生成」を選択します（ブラウザがHTMLスタイル・シート・イクステンションをサポートしている場合）。そして、Webブラウザ内に表示させるファイルに出力を保存します。

HTMLドキュメントのフッター・ページに他の項目を追加する:

1	オブジェクト・ナビゲータ内で、 [image] （レポートのプロパティ・アイコン）をダブルクリックして、プロパティ・パレットを表示します。

2	「レポート・エスケープ」ノード下の「レポート後型」プロパティを、「テキスト」（フッターを入力する場合）か、または「File」（ファイルからフッターをインポートする場合）に設定します。

3	「レポート後値」プロパティの「…」ボタンをクリックして、ダイアログにHTMLコードを入力するか、インポートするHTMLファイルを指定します。


HTMLページ・ヘッダーの作成

  例	  関連項目

HTMLドキュメントのすべてのページにページ・ヘッダーを追加するには:

1	オブジェクト・ナビゲータ内で、 [image] （レポートのプロパティ・アイコン）をダブルクリックして、プロパティ・パレットを表示します。

2	「レポート・エスケープ」ノードの「ページ前型」プロパティを、「テキスト」（ヘッダーを入力する場合）か、または「File」（ファイルからヘッダーをインポートする場合）に設定します。

3	「ページ前値」プロパティの「…」ボタンをクリックして、ダイアログにHTMLコードを入力するか、インポートするHTMLファイルを指定します。

HTMLドキュメント内の1つのページにページ・ヘッダーを追加するには:

「関連項目」ボタンをクリックし、PL/SQLを使用してページ・ヘッダーを作成するプロシージャを参照します。


HTMLページ・フッターの作成

  例	  関連項目

HTMLドキュメントのすべてのページにページ・フッターを追加するには:

1	オブジェクト・ナビゲータで、 [image] （レポートのプロパティ・アイコン）をダブルクリックして、プロパティ・パレットを表示します。

2	「レポート・エスケープ」ノードの「ページ後型」プロパティを、「テキスト」（ヘッダーを入力する場合）か、または「File」（ファイルからヘッダーをインポートする場合）に設定します。

3	「ページ後値」プロパティの「…」ボタンをクリックして、ダイアログにHTMLコードを入力するか、インポートするHTMLファイルを指定します。

HTMLドキュメント内の1つのページにページ・フッターを追加するには:

「関連項目」ボタンをクリックし、PL/SQLを使用してページ・フッターを作成するプロシージャを参照します。


プロパティ・パレットによるHTMLパラメータ・フォーム・ヘッダーの作成

  例	  関連項目

HTMLパラメータ・フォーム上に項目を追加するには:

1	オブジェクト・ナビゲータで、 [image] （レポートのプロパティ・アイコン）をダブルクリックして、プロパティ・パレットを表示します。

2	「レポート・エスケープ」ノードの「フォーム前型」プロパティを、「テキスト」（ヘッダーを入力する場合）か、または「File」（ファイルからヘッダーをインポートする場合）を設定します。

3	「フォーム前値」プロパティの「…」ボタンをクリックして、ダイアログでHTMLコードを入力するか、インポートするHTMLファイルを指定します。


プロパティ・パレットによるHTMLパラメータ・フォーム・フッターの作成

  例	  関連項目

HTMLパラメータ・フォーム下に項目を追加するには:

1	オブジェクト・ナビゲータで、 [image] （レポートのプロパティ・アイコン）をダブルクリックして、プロパティ・パレットを表示します。

2	「レポート・エスケープ」ノードの「フォーム後型」プロパティを、「テキスト」（フッターを入力する場合）か、「File」（ファイルからフッターをインポートする場合）を設定します。

3	「フォーム後値」プロパティの「…」ボタンをクリックし、ダイアログでHTMLコードを入力するか、インポートするHTMLファイルを指定します。


HTMLパラメータ・フォームの入力イベントまたは選択イベントの作成

  例	  関連項目

入力イベントまたは選択イベントのあるパラメータ・フォーム・フィールドを作成するには:

1	オブジェクト・ナビゲータで、 [image] をダブルクリックし、パラメータ・フォーム・エディタを表示します。

2	パラメータ・フォーム・フィールドを作成または編集します。

3	「Webの設定」ノード下のプロパティ・パレット内で、「追加の属性（HTML）」プロパティを有効なJavaScriptイベント・ハンドラに設定します。注意

Before FormトリガーにJavaScriptコードを挿入するには:

1	オブジェクト・ナビゲータで、 [image] （レポートのプロパティ・アイコン）をダブルクリックして、プロパティ・パレットを表示します。

2	「レポート・エスケープ」ノードの「フォーム前型」プロパティを、「テキスト」（JavaScriptを入力する場合）か、または「File」（ファイルからJavaScriptをインポートする場合）を設定します。

3	「フォーム前値」プロパティの「…」ボタンをクリックして、ダイアログでJavaScriptを入力するか、インポートするJavaScriptのHTMLファイルを指定します。


プロパティ・パレットによるHTMLページストリーム出力へのナビゲーション・コントロールの追加

 関連項目

HTMLページストリーム出力のナビゲーション・コントロールを追加するには:

1	オブジェクト・ナビゲータで、 [image] （レポートのプロパティ・アイコン）をダブルクリックして、プロパティ・パレットを表示します。

2	「ページ・ナビゲーション・コントロール・タイプ」プロパティと「ページ・ナビゲーション・コントロール値」プロパティを設定します。注意


描画オブジェクトの作成

  関連項目

描画オブジェクトを作成するには:

1	レイアウト・モデル表示内で、ツール・パレットの描画ツール（たとえば、四角形、楕円、折れ線等）をクリックします。注意

2	線または角の丸い四角形、四角形、楕円、円弧、手書きオブジェクトを作成するには、ウィンドウのメイン領域（キャンバス領域)内をクリックしてドラッグしながらオブジェクトを作成します。

3	多角形や折れ線を作成するには、ウインドウのメイン領域（キャンバス領域）内で、オブジェクトの起点および角を形成する点をクリックしていき、最後にダブルクリックし、オブジェクトを作成します。

4	（たとえば、完全な円と四角形など）を描くには、グラフィックを描くときに強制キー（たとえば、[Shift]キー）を押下したままにします。

5	描画オブジェクトをダブルクリックします。

6	プロパティ・パレットで、必要なプロパティを設定します。


Graphics Builderチャートの作成

  関連項目

レポートに新しいGraphics Builderチャートを作成するには:

1	「ツール」 [image] 「チャート・ウィザード」を選択します。

2	ウィザードに従って、希望するチャートを作成し、レポートに配置します。

3	ウィザードを変更するには、ライブ・プレビューア内のレポート出力を変更するか、または「ツール」 [image] 「チャート・ウィザード」を選択してウィザードに戻ります。

4	チャート・ウィザードの範囲を超えて、チャートをさらに改良してカスタマイズする、あるいはより複雑な画面を作成する場合は、Graphics Builderを使用し、レポート内に表示を埋め込みます。


複雑な画面とは、対話形式で、複数の問合せを含む、あるいはチャートと同じくオブジェクトを含む画面です。


現在のGraphics Builder図表の埋込み

  関連項目

レポート内の既存のGraphics Builder図表を埋め込むには:

1	レイアウト・モデル表示内で、ツール・パレットの [image] をクリックします。

2	クリック・アンド・ドラッグで四角形を描きます。

3	プロパティ・パレットを表示するには、新しいGraphics Builder図表オブジェクトをダブルクリックします。

4	「チャート」ノードの「チャート・ファイル名」プロパティに、図表が含まれたファイル名を設定します。

5	レポート内の各グループごとに1つずつ図表を出力する場合は、「パラメータおよび列」プロパティのフィールドをダブルクリックして「チャート」ダイアログ・ボックスを表示します。

6	「パラメータ」ページ:

•	「レポート列」の図表のパラメータと一致するレポート列またはパラメータをクリックして選択します。

•	「チャート・パラメータ」に、選択した各レポート列またはパラメータに対応するパラメータ表示の名前を入力します。

7	「列」ページ:

•	「チャート問合せ」フィールドに、レポートからデータを取得する必要があるGraphics Builder図表の問合せの名前を入力します。レポートから渡す列またはパラメータに対応する列を選択する問合せを、必ず指定してください。

•	「レポート・グループ」フィールドでは、ドロップダウン・リストから、指定した問合せに使用される列およびパラメータが含まれたグループを選択します。

•	「レポート列」で、図表の列と一致するレポート列をクリックして選択します。

•	「チャート列」に、選択した各レポート列に対応する列表示名の名前を入力します。

8	「OK」をクリックします。


データベースからのイメージの選択

  例 	  関連項目

データベースからイメージを選択するには:

1	イメージまたはイメージ・オブジェクトのファイル名を含む列を選択するSELECT文による問合せを作成します。

2	プロパティ・パレットを表示するには、データ・モデル表示内でイメージ列をダブルクリックします。

3	イメージ自体ではなく、イメージ・オブジェクトのファイル名が列に入っている場合は、

•	「列」ノードの「ファイルからの読込み」プロパティを「はい」に設定します。例

4	「列」ノードで、「ファイル形式」プロパティを「イメージ」に設定します。


ファイルへのイメージ・オブジェクトのリンク

  関連項目

ファイルにイメージ・オブジェクトをリンクするには:

1	ライブ・プレビューア表示で、ツール・パレットの [image] をクリックする。注意

2	クリック・アンド・ドラッグで四角形を描きます。

3	プロパティ・パレットを表示するには、リンク・ファイル・オブジェクトをダブルクリックします。

4	「リンク・ファイル・ボイラープレート」ノード下での注意点

•	「ソース・ファイル形式」プロパティを「イメージ」に設定します。

•	「ソース・ファイル名」プロパティに、イメージが含まれたファイル名を設定します。


イメージ、サウンド、ビデオ・オブジェクトのボタンの作成

  関連項目

イメージ、サウンド、ビデオ・オブジェクトのボタンを作成するには:

1	「レイアウト・モデル」で、ツール・パレットの [image] をクリックします。

2	クリック・アンド・ドラッグで四角形を描きます。

3	ボタン・オブジェクトをダブルクリックして、プロパティ・パレットを表示します。

4	「ボタン･ラベル」ノードで、「ラベルの型」プロパティを「テキスト」または「アイコン」に設定します。

•	ボタン・ラベルが「テキスト」の場合、「テキスト」プロパティに、ボタン上に表示するテキストを設定します。

•	「ボタン・ラベル」が「アイコン」であれば、「アイコン名」プロパティに、アイコンが含まれたファイル名を設定します（ファイルは、UI_ICON環境変数で指定されたディレクトリ内にある必要があります）。

5	「ボタン動作」ノードで、次の操作を行います。

•	ファイル内に格納されたイメージ、サウンド、ビデオを表示する場合は、「型」プロパティを「マルチメディア・ファイル」に設定します。「マルチメディア・ファイル」プロパティにはファイル名を設定し、「マルチメディア・ファイル・タイプ」プロパティには「イメージ」、「サウンド」または「ビデオ」のいずれかを設定します。

•	データベース（オブジェクトを含むデータベース列を選択する問合せを定義しており、さらに列のプロパティ・パレット内で書式を定義していた場合に有効）に格納されたイメージまたはサウンドを表示するには、「型」プロパティを「マルチメディア列」に設定します。「マルチメディア列」プロパティには列名を設定し、「マルチメディア列の型」プロパティには「イメージ」または「サウンド」を設定します。

6	ボタンをアクティブにするには、ライブ・プレビューアに対してレポートを実行し、次にランタイム・プレビューア内に表示します。


データベースからのOLE2オブジェクトの選択

  関連項目

データベースからOLE2オブジェクトを選択するには:

1	OLE2またはOLE2オブジェクトのファイル名を含む列を選択するSELECT文による問合せを作成します。

2	プロパティ・パレットを表示するには、データ・モデル表示内でOLE2列をダブルクリックします。

3	OLE2オブジェクト自体ではなく、OLE2オブジェクトのファイル名が列に入っている場合は、

•	「列」ノードの「ファイルからの読込み」プロパティを「はい」に設定します。

4	「ファイル形式」プロパティを「OLE2」に設定します。


ファイルへのOLE2オブジェクトのリンク

  関連項目

ファイルにOLE2オブジェクトをリンクするには:

1	レイアウト・モデル表示内で、ツール・パレットの [image] をクリックします。

2	クリック・アンド・ドラッグで四角形を描き、「オブジェクト挿入」ダイアログ・ボックスを表示します。

3	「Create New」をクリックして、作成するオブジェクトのタイプを選択します。

4	「Create from File」をクリックしてファイル名を指定するか、または「Browse」ボタンをクリックしてファイルを選択します。また、オブジェクトをファイルにリンクする（レポートの中にコピーしない）場合は、「Link」をチェックします。

5	OLE2コントロールを挿入する場合は、「Create Control」をクリックして挿入するコントロールのタイプを選択します。

6	レポート内でOLE2オブジェクトをアイコン表示するには、「Display As Icon」をチェックします。

7	レポート・レイアウト内のOLE2オブジェクトをアクティブにするには、オブジェクトの右マウス・ボタンをクリックします。ポップアップ・メニューから、オブジェクトのサーバーによって実行されるアクションのサブメニューを表示するためのオブジェクト項目を選択します。


データベースからのサウンドまたはビデオ・オブジェクトの選択

  関連項目

データベースからサウンドまたはビデオ・オブジェクトを選択するには:

1	サウンド・オブジェクトまたはビデオ・オブジェクトのファイル名を含む列を選択するSELECT文によって、問合せを作成します。

2	プロパティ・パレットを表示するには、データ・モデル表示内で、マルチメディア列をダブルクリックします。

3	ビデオまたはサウンド・オブジェクトのファイル名が含まれた列の場合には、

•	「列」ノードの「ファイルからの読込み」プロパティを「はい」に設定します。

4	「列」ノードで、「ファイル形式」プロパティを「ビデオ」または「サウンド」に設定します。


描画、カラー・パレット、イメージのインポートおよびエクスポート

  関連項目

描画、カラー・パレット、イメージをインポートするには:

1	ライブ・プレビューア表示内で、「ファイル」 [image] 「インポート」を選択して、インポートするオブジェクトのタイプをクリックします。注意

2	ダイアログ・ボックスで、ファイルの名前と形式を指定します。「OK」をクリックします。

3	必要な位置にオブジェクトを移動します。

描画、カラー・パレット、イメージをエクスポートするには:

1	レイアウト・モデル表示内で、エクスポートするオブジェクトをクリックします。注意

2	「ファイル」 [image] 「エクスポート」を選択して、エクスポートするオブジェクトのタイプをクリックします。

3	ダイアログ・ボックスで、ファイルの名前と形式を指定します。「OK」をクリックします。


マージン・オブジェクトの作成

  関連項目

レポートのマージンにオブジェクトまたはヘッダーを作成するには:

1	レイアウト・モデル表示内で、ツールバー内の [image] をクリックします。注意

2	マージンを調整するには、マージンの境界線をクリックした後、必要な位置までハンドルをドラッグします。レポートの上下左右のマージン調整ができます。

3	「関連項目」を参照して、マージン領域に必要なオブジェクトを作成します。作成したオブジェクトは、レポートのすべてのページに表示されます。

4	ツールバー内の [image] をクリックして、レポートのボディ領域をアクティブにします。


データベース値を組み込んだヘッダーの作成

  関連項目

データベース値を組み込んだヘッダーを作成するには:

1	「ツール」 [image] 「レポート・ウィザード」を選択します。

2	「合計」ページで、ヘッダーに組み込む合計を作成します。

3	「フィールド」ページで、ヘッダーに組み込むフィールドと合計が使用可能であるか、またはレポート内に表示されているかを確認します。

4	レイアウト・モデル表示内で、ツールバー内の [image] をクリックします。注意

5	マージン領域内に、ヘッダーにインクルードするデータベース値を入れるフィールド・オブジェクトを作成します。プロパティ・パレットの「フィールド」ノードで、「ソース」プロパティに値のソース列を設定して、「可視」プロパティを「いいえ」に設定します。そして「書式マスク」プロパティを数値に設定します。「標準レイアウト」ノード下の「水平拡張度」プロパティを「可変」に設定します。

6	マージン領域内にボイラープレート・テキスト・オブジェクトを作成し、ヘッダーにインクルードするフィールドを参照します。


グループのヘッダーまたはフッターの作成

  関連項目

レコードの各グループの上または下に、ヘッダーまたはフッターを作成するには:

1	レイアウト・モデル表示内で、制限モードがオフになっていて、フレックス・モードがオン（ツールバー内のボタンが [image] と [image] ）になっていることを確認します。

2	ヘッダーまたはフッターを追加するグループに対する繰り返し枠をクリックします。そしてそれをドラッグして枠のサイズを変更し、ヘッダーまたはフッターをタイプするのに十分なスペースを作ります。

3	ヘッダーまたはフッターに対してボイラープレート・テキスト・オブジェクトを作成します。


ヘッダー・ページまたはトレーラ・ページへのオブジェクト作成

レポートのセクション化を導入することにより、ヘッダー・ページおよびトレーラ・ページがボディ・ページと同一になりました。つまり、ヘッダー、トレーラおよびボディがレポートのセクションを構成することを意味します。以前のリリースとの互換性を保つため、セクションの名前は、オブジェクト・ナビゲータの「レイアウト・モデル」ノードに、ヘッダー・セクション、メイン・セクションおよびトレーラ・セクションとして表示されます。ヘッダー・セクションおよびトレーラ・セクションのマージンとボディを使用して、以前のリリースで行っていたように、ヘッダーおよびトレーラの各"ページ"を作成できます。今後のリリースでは、セクションの追加と削除が行えるようになります。


バーコードの作成

  関連項目

バーコード・フォントを使用してバーコードを作成するには:

1	使用しているマシンにバーコード・フォントをインストールします（たとえば、Windowsでは、 バーコード・フォントは「Windows コントロール パネル」の「フォント」でインストールします）。バーコード・フォントは、ほとんどのコンピュータ販売店で入手できます。注意

2	レポートにインクルードするバーコードの値に対応するデータベース上のNUMBER列を選択する問合せを作成します。

3	フィールドにバーコード・フォントを適用するには、ライブ・プレビューア表示内で、バーコード・フィールドをクリックして、「書式」 [image] 「フォント」を選択します。注意


テキストのボイラープレート・オブジェクトの作成

  関連項目

テキストのボイラープレート・オブジェクトを作成するには:

1	ライブ・プレビューア表示内で、ツールバーの [image] をクリックします。注意

2	クリック・アンド・ドラッグで四角形を描きます。

3	新しいボイラープレート・オブジェクトに、必要なテキストを入力します。

入力するテキストは、改行で区切られたパラグラフで構成されます。パラグラフ内のテキストは、ボイラープレート・オブジェクトの水平サイズの中でワードラップされます。

4	ボイラープレート・テキスト・オブジェクトの外側をクリックします。


レポートへのテキストの直接入力

  関連項目

レポートに直接、テキストを入力するには:

1	ライブ・プレビューア表示内で、ツールバーの [image] をクリックします。注意

2	テキストを開始する場所をクリックして、テキストの入力を開始します。

入力するテキストは、改行で区切られたパラグラフで構成されます。テキスト・オブジェクトの水平サイズは、入力するにつれて大きくなるため、テキストはワードラップされません。したがって、次行に移るときは、[Return]キーを押してください。

3	テキスト・オブジェクトの外側をクリックします。


ボイラープレート・テキストのフィールドの参照

  関連項目

ボイラープレート・テキストのフィールドを参照するには:

1	ライブ・プレビューア表示内で、表示されるフィールドに対して参照するボイラープレート・テキストの中をクリックします。注意

2	アンパサンド（&）の次にフィールド名を入力します。

フィールド参照を他のテキストと間隔をあけないで配置する場合、フィールド名を角括弧で囲みます（たとえば、&<フィールド名>Oracle）。しかし、間にスペースを入れたり、山カッコを使用しなくても、複数の参照を並べることができる（たとえば、&フィールド1&フィールド2&フィールド3）ことに注意してください。


ファイルへのテキスト・オブジェクトのリンク

  関連項目

ファイルにテキスト・オブジェクトをリンクするには:

1	ライブ・プレビューア表示で、ツール・パレットの [image] をクリックする。

2	クリック・アンド・ドラッグで四角形を描きます。

3	プロパティ・パレットを表示するには、リンク・ファイル・オブジェクトをダブルクリックします。

4	「リンク・ファイル・ボイラープレート」ノード下での注意点

•	「ソース・ファイル形式」プロパティを「テキスト」に設定します。

•	「ソース・ファイル名」プロパティに、テキストが含まれたファイル名を設定します。


ボイラープレート・オブジェクト・テキストのインポートとエクスポート

  関連項目

ボイラープレート・オブジェクトにテキストをインポートするには:

1	ライブ・プレビューア表示内で、ツールバーの [image] をクリックします。注意

2	クリック・アンド・ドラッグで四角形を描きます。

3	「ファイル」 [image] 「インポート」で [image] 「テキスト」を選択します。

4	ダイアログ・ボックスで、インポート元のファイル名を入力または選択します。「開く」を選択します。

5	必要な位置にオブジェクトを移動します。

ボイラープレート・オブジェクトからテキストをエクスポートするには:

1	ボイラープレート・オブジェクト内のすべてのテキストをエクスポートするには、ボイラープレート・オブジェクトをクリックします。

2	テキストの選択された部分をエキスポートするには、ツール・パレットの [image] をクリックし、ボイラープレート・オブジェクトをクリックします。そして次に、テキストをドラッグ、それからハイライトします。

3	「ファイル」 [image] 「エキスポート」で [image] 「テキスト」を選択します。

4	ダイアログ・ボックスで、エクスポート先のファイル名を入力または選択します。「保存」をクリックします。


フィールド・オブジェクトの作成

  関連項目

レポート・レイアウト内にフィールド・オブジェクトを作成するには:

1	ライブ・プレビューア表示、レイアウト・モード表示またはパラメータ･フォーム表示でツール・パレットの [image] をクリックします。

2	クリック・アンド・ドラッグで四角形を描きます。

3	プロパティ・パレットを表示するには、オブジェクトをダブルクリックします。

4	「フィールド」ノード下の「ソース」プロパティを、フィールドの値を提供する列またはパラメータに設定します。

5	その他のプロパティを、目的に応じて設定します。


枠または繰返し枠の作成

  関連項目

枠または繰返し枠を手動で作成するには:

1	レイアウト・モデル表示内で、ツールバー [image] 、または [image] をクリックします。

2	クリック・アンド・ドラッグで四角形を描きます。

3	新しい枠オブジェクトをダブルクリックします。

4	プロパティ・パレットで、必要なプロパティを設定します。


新規レポート・レイアウトの作成

  関連項目

既存のレイアウトを上書きせずに、レポートに新しいレイアウト・セクションを追加するには:

1	レイアウト・モデル表示内で、ツールバーの [image] をクリックします。

2	クリック・アンド・ドラッグでデフォルト・レイアウトの四角形の領域を描き、レポート・ウィザードを表示します。

3	ウィザードに従い、新しいレイアウト・セクションで表示するデータを選択します。

4	レイアウト・セクションの順序を並べ替えるには、それらをクリックしてレイアウト・モデル表示内の新しい位置へドラッグします。

5	変更するには、ライブ・プレビューア表示でレポート出力を変更するか、「ツール」 [image] 「レポート・ウィザード」を選択してウィザードに戻ります。


レポートへのタイトルの追加

  関連項目

レポートにタイトルを追加するには:

1	オブジェクト・ナビゲータ内で、レポートを選択、またはオープンします。

2	「ツール」 [image] 「レポート・ウィザード」を選択します。

3	「スタイル」ページで、「タイトル」フィールドにレポートのタイトルを入力します。

4	選択したテンプレートでタイトルのデフォルト属性（フォントやカラーなど）を設定するには、次の操作を行います。

•	オブジェクト・ナビゲータで、テンプレートをオープンします。

•	「レイアウト・モデル」ノードを拡張し、続いて「ボディ」ノードを拡張します。

•	プロパティ・パレットを表示するために、「デフォルト」ノードの横の [image] （プロパティ・アイコン）をダブルクリックします。

•	「タイトル」ノードで、プロパティを適宜変更します。

5	選択したテンプレートでタイトルの配置を設定し属性（フォントやカラーなど）を上書きするには、次の操作を行います。

•	テンプレートのレイアウト・モデル表示で、マージン内のタイトルに対するボイラープレート・テキスト・オブジェクトを作成します。

•	タイトルの大きさと位置を決め、適宜色の変更とテキスト属性の変更を行います。

•	タイトル・オブジェクトをダブルクリックし、プロパティ・パレットを表示します。

•	「一般情報」ノードで、「名前」プロパティをB_OR$REPORT_TITLEに設定します。


デリミタ付き出力の生成

  関連項目

デリミタ付き出力を生成するには:

1	新規レポートを作成するか、既存のレポートをオープンします。

2	「デリミタ付き出力」ダイアログ・ボックスで、レポート出力のセルを分割するデリミタをドロップダウン・リストから選択するか、入力します。

3	書式オプションを使用する場合は、「日付書式マスク」または「数値書式マスク」をドロップダウン・リストから選択するか、入力します。

4	セル・ラッパーを使用する場合は、レポート出力のセル・データ周辺に配置するセル・ラッパーをドロップダウン・リストから選択するか、入力します。

5	「OK」をクリックします。


チャート・ハイパーリンクの作成

  例      [image]  関連項目

Webウィザードを使用してチャート・ハイパーリンクを作成するには:

1	「ツール」 [image] 「Webウィザード」を選択します。注意

2	ウィザードの「チャート・ハイパーリンク」ページで、「使用可能なチャート」リストから希望のチャートをクリックします。注意

3	をクリックして、チャートを「チャート」リストに移動します。

4	「終了」をクリックします。

プロパティ・パレットを使用してチャート・ハイパーリンクを作成するには:

1	オブジェクト・ナビゲータで、「レイアウト・モデル」ノードを拡張し、次にチャート・オブジェクトを含むノードを拡張します。

2	チャート・オブジェクトをダブルクリックして、プロパティ・パレットを表示します。

3	「チャート」ノードで、「チャート・ハイパーリンク」プロパティに、リンクの宛先を設定します。このプロパティにオブジェクトを設定する場合は、オブジェクトの宛先を「ハイパーリンクの宛先」プロパティに設定する必要もあります。


XML出力の生成

  関連項目

現行のレポートからXML出力ファイルを生成するには:

1	XMLに出力するレポートをオープンします。現在、すべてのレポート･スタイルをXML出力に生成できますが、マトリックス･スタイルのレポートについてはサポート範囲が限られています（詳細はReportBuilderのリリース･ノートを参照してください）。

2	オブジェクト･ナビゲータでレポートを選択し、「ファイル」 [image] 「ファイル形式に出力」 [image] 「XML」を選択します。ヒント

3	XML出力を、選択したディレクトリに保存します。注意

XMLファイルの内容をWebブラウザに表示するには:

1	オブジェクト･ナビゲータにレポートをオープンし、 [image] をダブルクリックします。次に進むには、ライブ･プレビューアがアクティブになっている必要があります。注意

2	「ビュー」 [image] 「Web表示」 [image] 「XMLを使用」を選択します。（これにより、表示の準備をしているときにブラウザがレポートをどのように扱うかが変わります。）

3	（Web表示ボタン）をクリックし、ブラウザを起動してレポートをXML出力として表示します。注意

データ･モデル表示のプロパティ･パレットからレポートの変更を続ける場合、 [image] をクリックするたびにブラウザによって対応するXML出力がWebブラウザに表示されます。

コマンド･ライン起動とともにXMLファイルの内容をWebブラウザに表示するには:

1.	コマンド･ライン上で次の引数でレポートを実行します。DESFORMAT=XML､DESTYPE=FILEおよびDESNAME=[name].XML（コマンド･ライン起動についての詳細は、RWRUN60を参照してください。）

2.	XMLをサポートしているWebブラウザをオープンします。

3.	「ファイル」 [image] 「オープン」を選択し、生成したXMLファイルまでナビゲートします。XMLファイルがブラウザのウィンドウに表示されます。

4.	レポートでXML出力に変更を加え、同じ名前でXMLファイルを生成する場合には、ブラウザの「リフレッシュ」ボタンを使用して更新したXML出力を表示します。


XML出力の設計

  関連項目

レポートのXML出力をコントロールするXMLプロパティは、レポート、グループ、および列の3つのレベルで変更できます。ReportBuilderが生成したすべてのXMLファイルにおいて、その出力はデータ･モデルを擬似実行することに注意してください。データ･モデルはグループおよび列で構成されています。XML出力の変更を表示する方法についての詳細は、XML出力の生成を参照してください。

ヒント

レポート全体のXMLプロパティを変更するには:

1	オブジェクト･ナビゲータで [image] をダブルクリックし、プロパティ･パレットを表示します。

2	このレポートでの必要に応じて、「XMLの設定」ノード下でXMLプロパティを設定します。

グループのXMLプロパティを変更するには:

1	レポートのデータ･モデル表示から編集するグループ･オブジェクトを選択します。

2	グループのタイトル･バーをダブルクリックしてプロパティ･パレットをオープンします。

3	このグループの必要に応じて、「XMLの設定」ノード下でXMLプロパティを設定します。

列のXMLプロパティを変更するには:

1	レポートのデータ･モデル表示から編集する列を選択します。

2	列をダブルクリックしてプロパティ･パレットを表示します。

3	この列の必要に応じて、「XMLの設定」ノード下でXMLプロパティを設定します。


場合によっては（たとえばメッセージを呼び出す場合）、Before FormトリガーでJavaScriptコードを入力する必要があります。


XML対応のブラウザは、XMLとしてのフォーマットを認識し、それにしたがって表示するためにXML拡張が必要です。


Report Builderは、「最適な形式の」XML出力を作成します。これはXMLドキュメントのプロローグにXML宣言があることを意味しますが、DTD（文書型定義）はない場合もあります。有効なXMLを作成する場合は、XML Prolog値プロパティからレポート・レベルでDTDを追加する必要があります。


プロパティ･パレットで変更を行ったときは、プロパティ･パレットをクローズする前に別のプロパティをクリックして変更の保存を確認してください。


これには、XMLをサポートしているWebブラウザが必要です。


レイアウト・オブジェクトを定義している場合には、レポートが表示されます。レイアウト･オブジェクトを定義していない場合には、ライブ･プレビューアはブランクの画面になります。


?9


レポートへのアクセスの許可および禁止

  関連項目

レポート（データベースに格納）へのアクセスを許可または禁止するには:

1	オブジェクト・ナビゲータで、レポートをクリックします。

2	「ファイル」 [image] 「管理」 [image] 「レポート・アクセス」を選択します。

3	ユーザーにレポートへのアクセス（外部SQL問合せおよび外部PL/SQLライブラリを含む）を許可するには、ユーザーIDを入力して「追加」をクリックします。アクセスを禁止するには、ユーザーIDをクリックしてから「削除」をクリックします。


データベース・ロールの設定

 関連項目

レポートのデータベース・ロールを設定するには:

1	データベース管理者が、ロールを作成して権限を付与し、そのロールを承認されたエンド・ユーザーに付与したことを確認します。詳細は、『Oracle7 Serverアプリケーション開発者ガイド』または『Oracle8 Serverアプリケーション開発者ガイド』を参照してください。

2	プロパティ・パレットを表示するには、オブジェクト・ナビゲータでレポートの [image] （プロパティ・アイコン）をダブルクリックする。

3	「レポート」ノードで、データベース管理者がデータベースで定義したとおりに、「ロール名」プロパティを設定します。

4	（オプション）ロール・パスワードを設定するには、「ロール名」値フィールドの該当するボタンをダブルクリックし、「ロール作成」ダイアログを表示します。

注意:

•	Reports Runtime（RWRUN60）でコマンド・ラインを使用してロールを指定する場合は、レポートのロール設定は上書きされます。

•	1つのレポートには、1つのロールしか設定できません。複数のロールを設定するには、他のロールが付与されたロールを設定する必要があります。

警告: PL/SQLトリガーでロールを設定しないでください。PL/SQLではコンパイルされません。


?


標準レポートの作成

  関連項目

1つの問合せからなるレポートを作成するには:

1	オブジェクト・ナビゲータで「レポート」ノードをクリックし、続いてツールバーの [image] をクリックします。

2	「ツール」 [image] 「レポート・ウィザード」を選択します。

3	「スタイル」ページで希望するレポート・スタイルをクリックし、ウィザードに従ってレポートを作成します。

4	ライブ・プレビューア表示でレポート出力を変更するか、またはツールバーの [image] をクリックしてウィザードに戻ります。

複数の問合せからなるレポートを作成するには:

1	データ・ウィザードを使用し、各問合せを作成します。

2	レポートのレイアウトを作成します。


複数の問合せからなるグループ上レポートの作成

  関連項目 	  例

複数の問合せからなるグループ上レポートを作成するには:

1	オブジェクト・ナビゲータで「レポート」ノードをクリックし、続いてツールバーの [image] をクリックします。

2	新しいレポートの下にある [image] （「データ・モデル」ノードのアイコン）をダブルクリックします。

3	SQL問合せツールを使用して、最初の問合せを作成します。例

4	SQL問合せツールを使用して、2番目の問合せを作成します。例

5	親列（たとえば、EMPNO）と子列（たとえば、REPID）の列間のリンクを定義します。

6	ツールバーの [image] をクリックし、デフォルトのレイアウトを作成するかどうかを確認するプロンプトが表示されたら、「はい」をクリックします。

7	レポート・ウィザードの「スタイル」ページで「グループ上」をクリックします。

8	「グループ」ページで、レポート出力を「グループ表示」リストにグループ分けするためのフィールドを移動します。フィールドを移動するには、「使用可能フィールド」リストでフィールドを選択し、適切な印刷方向ボタンを選択します。

9	「フィールド」ページで、レポート出力に表示するフィールドを「表示フィールド」リストに移動します。子列が移動されていないをことを確認してください（レポートの「ディテール」の部分に表示されないようにするため）。

10	「ラベル」ページで、列ラベルを任意にカスタマイズします。

11	「終了」をクリックします。

12	ライブ・プレビューア表示でレポート出力を変更するか、またはツールバーの [image] をクリックしてウィザードに戻ります。

13	（オプション） 1ページにつきマスター・レコードを1つのみ表示するには、

•	「レイアウト・モデル表示」で、マスター繰返し枠をダブルクリックします。ヒント

•	プロパティ・パレットの「繰返し枠」ノードで、「ページ当りの最大レコード数」を1に設定します。


ネストされたマトリックス・レポートの作成

  関連項目	  例

ネストされたマトリックス・レポートを作成するには:

1	オブジェクト・ナビゲータで「レポート」ノードをクリックし、続いてツールバーの [image] をクリックする

2	新しいレポートの下にある [image] （「データ・モデル」ノードのアイコン）をダブルクリックします。

3	SQLの「問合せ」ツールを使用し、問合せを作成します。例

4	ネストされたマトリックス・データ・モデルを作成します。

  デモ

•	新しく作成したグループ・オブジェクトのタイトル・バーをクリックしたまま、下へドラッグします。

•	2つの「行」の列（たとえば、YEARおよびDEPTNO）と1つの「列」の列（たとえば、JOB）を空きスペースにドラッグして、3つの新しいグループを作成します。

•	ツール・パレットの [image] をシングルクリックします。

•	作成した3つのグループの周囲にボックスをドラッグして、4番目のグループを作成します。

5	プロパティ・パレットを表示するために、ネストされたグループ（たとえばDEPTNO）をダブルクリックします。

6	「グループ」ノードの下の「子クロス積」プロパティを「はい」に設定します（この設定をすると、データのない行はレポートに出力されません）。

7	ツールバーの [image] をクリックします。

8	レポート・ウィザードの「スタイル」ページで「マトリックス」をクリックします。

9	「行」ページで、第1および第2ブレーク・レベル用に2つの「行」の列を選択します。

10	「列」ページで、「列」の列を選択します。

11	「セル」ページで、セル値が含まれる列を選択します。

12	「ラベル」ページで、列ラベルを任意にカスタマイズします。

13	「終了」をクリックします。

14	ライブ・プレビューア表示でレポート出力を変更するか、またはツールバーの [image] をクリックしてウィザードに戻ります。


マルチメディア・レポートの作成

 関連項目

マルチメディア・レポートを作成する場合、次のことができます。

•	データベースからのイメージの選択

•	データベースからのサウンドまたはビデオの選択

•	データベースまたはファイルに格納されたイメージ、サウンドまたはビデオのボタンの作成


OLE2レポートの作成

 関連項目

OLE2レポートを作成する場合、次のことができます。

•	データベースからのOLE2オブジェクトの選択

•	ファイルからレポート・レイアウトへのOLE2オブジェクトのインポート


ローカルの問合せの作成

  関連項目

単一問合せレポートに対する問合せを作成するには、次に示す方法の1つを使用します。

•	レポート・ウィザード

•	「SQL問合せ」ツール（SQL問合せ用）

•	「参照カーソル問合せ」ツール（参照カーソルを使用する）

複数問合せレポートに対する問合せを作成するには、次に示す手段の1つを使用します。

•	データ・ウィザード

•	「SQL問合せ」ツール（SQL問合せ用）

•	「参照カーソル問合せ」ツール（参照カーソルを使用する）


ローカルの問合せの作成: レポート･ウィザード

  次のステップ 	  関連項目

レポート・ウィザードを使用して問合せを作成するには:

1	「ツール」 [image] 「レポート・ウィザード」を選択します。

2	「スタイル」ページで、任意のレポート・スタイルをクリックし、ウィザードに従い問合せのSELECT文（表示するフィールド、グループ・フィールドおよび希望する任意の合計）を指定します。


ローカルの問合せの作成: データ・ウィザード: 列ページ

  次のステップ 	  関連項目

データ・ウィザードを使用して問合せを作成するには:

1	データ・モデル表示で、「ツール」 [image] 「データ・ウィザード」を選択します。注意

2	ウィザードに従い、データ・モデルの最初の問合せを作成します。

3	作成する問合せごとに、ステップ1と2を繰り返します。

4	データ・モデル表示でデータ・モデルの結果を変更するか、あるいは「ツール」 [image] 「データ・ウィザード」を選択してウィザードに戻ります。

注意:  このリリースでは、データ・ウィザードは問合せ間のリンクの作成をサポートしていません。親/子問合せのリレーションを定義する場合、手動でデータ・リンクを作成します。


データ・モデル表示でオブジェクトが1つも選択されていないことを確認してください。


ローカルの問合せの作成: 「SQL問合せ」ツール

  次のステップ 	  関連項目

SQL問合せを作成するには:

  デモ

1	データ・モデル表示で、ツール・パレット内の [image] をシングルクリックします。

2	ウィンドウのメイン領域（キャンバス領域）をクリックします。ヒント

3	「SQL問合せ文」ダイアログ・ボックスで、問合せに使用するSELECT文を定義します。

•	「Query Builder」ダイアログを使用する場合は、「Query Builder」をクリックします。

•	ファイルから問合せをインポートする場合は、「SQL問合せインポート」をクリックします。

•	直接、SELECT文を入力する場合は、「SQL問合せ文」領域に入力します。ヒント

4	「OK」をクリックします。

5	次に示す方法のいずれかを使用し、問合せをリファインします。

•	問合せオブジェクトをクリックし、「ツール」 [image] 「プロパティ・パレット」を選択して、プロパティ・パレットを表示します。次に、希望のプロパティを設定します。

•	問合せオブジェクトをクリックし、「ツール」 [image] 「データ・ウィザード」を選択して表示するフィールド、グループ・フィールド、合計する項目を指定します。

6	作成する問合せごとに、ステップ1～5を繰り返します。

注意: レポートのデータ・モデル表示で複数の問合せを定義すると、レイアウトのデフォルト設定のためにレポート・ウィザードを起動するときに「データ」ページは表示されません。


ローカルの問合せの作成: 「参照カーソル問合せ」ツール

  次のステップ	  関連項目

参照カーソル問合せを作成するには:

1	参照カーソルの型を定義するパッケージを、以下のいずれかの方法で作成します。

•	ローカルのプログラム単位を作成します。

•	外部PL/SQLライブラリを作成します。

•	ストアド・プログラム単位を作成します。

2	ステップ1で作成したパッケージが外部PL/SQLライブラリの場合は、それを参照する前にレポートに添付します。

3	データ・モデル表示で、ツール・パレットの [image] をシングルクリックします。

4	ウィンドウのメイン領域（キャンバス領域）をクリックします。ヒント

5	PL/SQLエディタで、カーソルをオープンし、パッケージ内で定義した参照カーソル型を持つカーソル変数を返すPL/SQLを入力します。例

6	問合せを必要に応じて修正します。

•	参照カーソル問合せオブジェクトをクリックし、「ツール」 [image] 「プロパティ・パレット」を選択してプロパティを変更します。

•	問合せオブジェクトをクリックし、「ツール」 [image] 「データ・ウィザード」を選択して表示するフィールド、グループ・フィールド、合計する項目を指定します。

7	作成する参照カーソル問合せごとにステップ1～6を繰り返します。


外部（共有可能な）問合せの作成

  関連項目

外部（共有可能な）問合せを作成するには:

1	オブジェクト・ナビゲータで、「外部SQL問合せ」ノードをクリックします。

2	ツールバーの [image] をクリックします。

3	新規外部問合せノードのアイコンをダブルクリックします。

4	「外部問合せ定義」ダイアログ・ボックスで、問合せに使用するSELECT文を入力します。

5	ツールバーの [image] をクリックし、ファイル・システムに問合せを保存します。


ブレーク・グループの作成

  次のステップ	  関連項目

データ・ウィザードを使用してブレーク・グループを作成するには:

1	データ・モデル表示で、問合せオブジェクトをクリックし、続いて「ツール」 [image] 「データ・ウィザード」を選択します。

2	「グループ」ページで、ブレーク・グループに対する1つ以上の列を選択します。

ブレーク・グループを手動で作成するには:

  デモ

1	データ・モデル表示で、グループ・オブジェクトのタイトル・バーを下へドラッグします。

2	ブレーク列（たとえば、DEPTNO）をグループの上方にドラッグして、新しいグループを作成します。注意

3	（オプション）新しいグループ・オブジェクトをダブルクリックしてプロパティ・パレットを表示し、希望するプロパティを設定します。


（Oracle Expressのみ）ディメンション値をソートするには、対応するソート列も新しいグループにドラッグする必要があります。


マトリックス（クロスタブ）グループの作成

  次のステップ	  関連項目

データ・ウィザードを使用してマトリックス（クロスタブ）グループを作成するには:

1	データ・モデル表示で、問合せオブジェクトをクリックし、続いて「ツール」 [image] 「データ・ウィザード」を選択します。

2	「問合せ名」ページで、「マトリックス」問合せチェック・ボックスを選択します。

3	ウィザードに従い、マトリックス・グループ、行、列、およびセルに対する列を選択します。

マトリックス（クロスタブ）グループを手動で作成するには:

  デモ

1	データ・モデル表示で、グループ・オブジェクトのタイトル・バーを下へドラッグします。

2	「行」の列と「列」の列を空きスペースにドラッグして、2つの新しいグループを作成します。

3	ツール・パレットの [image] をシングルクリックします。

4	ボックスをドラッグして、マトリックス（クロスタブ）グループに組み込むグループを中に収めます。

5	セル・グループがマトリックス（クロスタブ）グループとは別の問合せである場合、マトリックス・グループ内の列とセル・グループの間に適切なリンクを作成します。


データ・リンクの作成

  関連項目

データ・リンクを作成するには:

  デモ

1	データ・モデル表示で、ツール・パレット内の [image] をシングルクリックします。注意

•	問合せリンクに問合せを作成する  2つの問合せに使用される表間に定義された各データベース制約にデータ・リンクを作成するには、親問合せをクリックして子問合せまでドラッグします。注意

•	グループ・リンクにグループを作成する  1つの問合せグループと他の問合せグループとの間にリンクを作成するには、親グループ（グループ内の列は避けます）をクリックして子グループまでリンクをドラッグします。これは、子問合せの側で親問合せのデータに関する情報を参照する場合に便利です。

•	列リンクに列を作成する  列間にリンクを作成するには、親問合せの列をクリックして子問合せの列までリンクをドラッグします。

2	新しいリンク・オブジェクトをダブルクリックします。

3	プロパティ・パレットで、必要なプロパティを設定します。


レポートのデフォルト・レイアウトの作成

  関連項目

レポートのデフォルト・レイアウトを作成するには:

1	現レポート・レイアウト（デフォルトでは、レポートのメイン・セクション）のデフォルト設定を行うには、「ツール」 [image] 「レポート・ウィザード」を選択し、続いてウィザードに従い選択したレポート・スタイルのレイアウトを作成します。

2	現レポート・レイアウトに別のレイアウト・セクションを追加するには、別のレポート・レイアウトを作成します。

3	レイアウト・モデル表示で、デフォルトのレイアウトに対して、手動でさらに変更を加えます。警告:  レイアウトを手動で調整した後に再度レポート・ウィザードで再入力した場合、レポート・ウィザードの「完了」をクリックすると、変更の一部が失われます。「完了」は、レイアウトをデフォルト設定に戻します。


セクション・レイアウトの作成

  関連項目

レポート・セクションのデフォルト・レイアウトを作成するには:

1	レイアウト・モデル表示で、セクションのレイアウト表示を表示します。

2	「ツール」 [image] 「レポート・ウィザード」を選択します。

3	ウィザードの指示に従って、レポートのデフォルト・レイアウトを作成します。

4	セクションのマージン領域でレイアウトまたはオブジェクトを作成するには、ツールバーの [image] をクリックし、マージン領域を表示または編集します。

5	現行のレポート・レイアウトに別のレイアウト・セクションを追加するには、別のレポート・レイアウトを作成します。

6	レイアウト・モデル表示で、デフォルトのレイアウトに対して、手動でさらに変更を加えます。警告:  レイアウトを手動で調整した後に再度レポート・ウィザードで再入力した場合、レポート・ウィザードの「完了」をクリックすると、変更の一部が失われます。「完了」は、レイアウトをデフォルト設定に戻します。

7	必要に応じて、セクションのプロパティを設定します。


World Wide Web用のレポートの準備

  次のステップ	  関連項目

Web用のレポートを準備するには:

1	（オプション） 新規または既存のレポートに希望のWebリンクを追加します。

•	ハイパーリンクを作成（レポート内のオブジェクトにリンクする場合は、関係付けられたハイパーリンクの宛先を作成）します。

•	アプリケーション・コマンド・ライン・リンクを作成（PDF出力専用）します。

•	ブックマークを作成します。

•	HTMLドキュメント・ヘッダーを作成します。

•	HTMLドキュメント・フッターを作成します。

•	HTMLページ・ヘッダーを作成します。

•	HTMLページ・フッターを作成します。

•	HTMLパラメータ・フォーム・ヘッダーを作成します。

•	HTMLパラメータ・フォーム・フッターを作成します。

2	プリンタを選択するか、またはデフォルトのプリンタ設定を使用します（現在選択されているプリンタのドライバは、出力生成のために使用されます。したがって、レポートを実行するマシンに対応した構成のプリンタを備えておく必要があります）。

3	「ツール」 [image] 「Webウィザード」を選択します。

4	ウィザードの最終ページで、希望する出力を選択し、WebブラウザまたはPDFビューアで表示するためにファイルに保存します。


ASCII（キャラクタ・モード）レポートのプロパティの設定

  関連項目

ASCII（キャラクタ・モード）レポートのプロパティを設定するには:

1	新規レポートの場合の操作は:

•	オブジェクト・ナビゲータで「レポート」ノードをクリックし、続いてツールバーの [image] をクリックします。

2	レポート・ノードの横の [image] （プロパティ・アイコン）をダブルクリックして、プロパティ・パレットを表示します。

3	「レポート」ノードの「幅」プロパティおよび「高さ」プロパティを目的に応じて設定します（たとえば、横向きの幅11（または15）×高さ8.5、または縦向きの幅8.5×高さ11（または15））。

4	「キャラクタ・モード」ノードで次の操作を行います。

•	「キャラクタ単位で設計」を「はい」に設定します。

•	「レポート幅」および「レポート高」をそのレポートに適したキャラクタ・モードの寸法に設定します（たとえば、横向きの幅132 （または180)×高さ66、または縦向きの幅102×高さ85 （または116)）。

5	オブジェクト・ナビゲータで、「データ・モデル」ノードを拡張してから「システム・パラメータ」ノードを拡張します。

6	「MODE」プロパティ・アイコンをダブルクリックして、プロパティ・パレットを表示します。

7	「パラメータ」ノードで、「初期値」プロパティを「Character」に設定します。

8	オブジェクト・ナビゲータで、 [image] （「レイアウト・モデル」ノードのアイコン）をダブルクリックします。

9	レイアウト・モデル表示で、「書式」 [image] 「レイアウト・オプション」 [image] 「定規」を選択して、「定規設定」ダイアログ・ボックスを表示します。

10	「単位」を「文字セル」に設定し、「格子当りのスナップ・ポイント数」を1に設定します。そして、「OK」をクリックします。

11	メニュー・バーの「表示」をクリックし、「格子指定」がチェックされていることを確認します。

12	「ツール」 [image] 「作業環境」を選択し、「作業環境」ダイアログ・ボックスを表示します。

13	「作業環境」ページで、「水平中間フィールド」を1、「垂直中間フィールド」を0に設定します。「OK」をクリックします。

14	「書式」 [image] 「フォント」を選択し、キャラクタ・モードのフォントに最も近い値のフォントおよびスタイル、サイズを選択します（たとえば、「Courier」、「Regular」、12ポイント）。

これが新規レポートである場合、これでデータ・モデルおよびレイアウトを定義する準備が完了しました。作成するレポートのタイプ（たとえば、表、グループ左など）の指示を参照してください。


ビットマップ・レポートのASCII （キャラクタ・モード）への変換

  関連項目

ビットマップ・レポートをASCII （キャラクタ・モード）レポートへ変換するには:

1	オブジェクト・ナビゲータの「レポート」ノードで、変換するレポートをクリックします。

2	「ファイル」 [image] 「管理」 [image] 「変換」を選択します。

3	「変換」ダイアログ・ボックスの「変換」ページで次の操作を行います。

•	「文書タイプ」を「レポート」に設定します。

•	「ソース・タイプ」を「レポート・バイナリ・ファイル（RDF）」に設定します。

•	「ソース」を既存のビットマップ・レポートの名前に設定します。

•	「宛先タイプ」を「レポート・バイナリ・ファイル（RDF）」に設定します。

•	「宛先」を新しいキャラクタ・モード・レポートの名前に設定します。

4	「オプション」ページで、「宛先単位」を「文字」に設定します。

5	「OK」をクリックします。

6	新しいキャラクタ・モード・レポートのプロパティを設定します。


ビットマップ・レポートのASCII （キャラクタ・モード）への変換について

  関連項目

ビットマップ・レポートをASCII （キャラクタ・モード）レポートに変換するためにReport Builderを使用すると、ビットマップ・レポートに対応する新しいキャラクタ・モードのレポートが作成されます。元のビットマップ・レポートは変更されずに残ります。

変換後、フィールドおよびテキスト・オブジェクトの多くをサイズ変更する必要がある場合があります。また、イメージや描画のような図形オブジェクトはキャラクタ・モード・レポートには含まれません。次に、それぞれの出力形式でサポートされる内容を示します。

キャラクタ・モード	ビットマップ

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


マルチプラットフォーム用のレポートの準備

  関連項目

マルチプラットフォームで実行するレポートを準備する際には、次のGUIの違いを考慮します。

フォント ターゲットGUIでは、特定のフォント・タイプまたはスタイル、サイズが使用できないことがあります。この場合、次の2つの方法のうちどちらかで対処してください。

•	ターゲットGUI上に存在することがわかっているフォント、またはターゲットGUIのデフォルトのフォントに完全にマップするフォントを使用します。

•	フォントが正しくマップされるように、フォント・マップ・ファイルuifont.aliを変更します。

カラー ターゲットGUIでは、特定の色が使用できないことがあります。なるべく、ターゲットGUIに組み込まれている色を使用してください。またはターゲットGUIのデフォルトの色と整合するようにマップされている色を使用してください。通常、ブルー、マゼンダ、レッド、シアン、グリーン、イエローの色は、多数のプラットフォームで使用できます。

DPI 使用しているモニターの1インチあたりのドット数（DPI）は、レポートを実行するモニターで使用されているDPIとは異なることがあります。DPIによって影響を受けるのは、スクリーン上のどの位置で英数字がワードラップされるかということのみです。「ライブ・プレビューア表示」に表示できるようにレポートを設計する場合は、レポートを実行するモニターと同じDPIを使用するようにしてください。また、レイアウト・オブジェクトを固定したサイズ設定にしないでください。

マルチプラットフォームで考慮すべき点の詳細は、『アプリケーション作成のガイド』を参照してください。


他の言語に翻訳するレポートの準備

各国語サポートの詳細に関しては、ヘルプのトピック・ウィンドウからReport Builder参照、各国語サポートの順で検索してください。


セクションのレイアウト表示の表示

  関連項目

レポート・セクションのレイアウト表示を表示するには:

•	レイアウト・モデル表示で、次のいずれかの操作を行います。

•	「表示」 [image] 「レイアウト・セクション」を選択し、表示するセクションを選択します。次に、マージン領域を表示または編集するかどうかをチェックします。

•	ツールバーの [image] 、 [image] または [image] をクリックして、それぞれ、ヘッダー・セクション、メイン・セクションまたはトレーラ・セクションを表示します。マージン領域を表示または編集するには、 [image] をクリックします。


セクションのプロパティ設定

  関連項目

レポート・セクションのプロパティを設定するには（ページのサイズおよび方向を含む）:

1	オブジェクト・ナビゲータで、「レイアウト・モデル」ノードを拡張し、プロパティを設定するセクション（ヘッダー、メインまたはトレーラ）をクリックします。

2	「ツール」 [image] 「プロパティ・パレット」を選択します。

3	プロパティ・パレットで、希望のプロパティを設定します。


?


オブジェクト・ナビゲータの表示設定の変更

デバッグを容易にするために、オブジェクト・ナビゲータの表示設定を変更するには:

1	オブジェクト・ナビゲータで、「ナビゲータ」 [image] 「ナビゲータ・オプション」を選択します。

2	プロパティ・シートで、目的に応じて設定を変更します。「OK」をクリックします。

3	オブジェクト階層を表示するには、「表示」 [image] 「所有者」を選択します。

4	タイプ別にオブジェクトを表示するには、「表示」 [image] 「タイプ」を選択します


レポートの実行のトレース

トレース・オプションを設定するには、次のいずれかの操作を行います。

•	「ツール」 [image] 「トレース」を選択して、目的に応じてダイアログ・ボックスに入力します。

•	コマンド・ラインに、TRACEFILE、TRACEMODEおよびTRACEOPTSキーワードを使用したRWBLD60またはRWRUN60で、トレース・オプションを指定します。

•	SRW.TRACE_START、SRW.TRACE_END、SRW.TRACE_ADD_OPTIONSまたは SRW.TRACE_REM_OPTIONSを使用したReport Builderビルトイン・パッケージを介して、トレース・オプションを指定します。


レポートの配布のトレース

  関連項目

レポートの配布をトレースするには:

1	「ランタイム・トレース設定」ダイアログ・ボックスの「トレース・ファイル」フィールドで、トレース・ファイルの名前を指定します。

2	「配布」チェックボックスをチェックします。

3	「OK」をクリックします。

4	レポートを実行します。

5	テキスト・エディタ（ワードパッドなど）を使用して、配布リストが使用されたトレースを開いて確認します。この情報を使用して、どのセクションがどの宛先に送られたかを調べることができます。トレース・ファイルのフォーマットは、.DSTファイルのフォーマットに非常に似ているため、カット・アンド・ペーストによって、トレース・ファイルから.DSTファイルを生成できることに注意してください。


ブレークポイントの設定

  次のステップ

レポートの実行プログラムの中にブレークポイントを設定するには:

1	PL/SQLインタプリタが表示されていない場合は、「プログラム」 [image] 「PL/SQLインタプリタ」を選択します。

2	オブジェクト・ナビゲータで、コンパイル済みプログラム単位ノードをシングルクリックして、インタプリタ・ソース・ペイン内にプログラム単位を表示します。注意

3	ブレークポイントを作成する位置にある実行可能文をダブルクリックします。ヒント

これにより、ブレークポイントが挿入され、B00nとして示されます。 nはブレークポイントの番号です。プログラム単位を実行すると、ブレークポイントの直前の行で実行が中断されます。


デバッグ・トリガーの設定

  次のステップ

デバッグ・トリガーを設定するには:

1	PL/SQLインタプリタが表示されていない場合は、「プログラム」 [image] 「PL/SQLインタプリタ」を選択します。

2	オブジェクト・ナビゲータで、コンパイル済みプログラム単位ノードをシングルクリックして、インタプリタ・ソース・ペイン内にプログラム単位を表示します。注意

3	デバッグ・トリガーを作成する位置にある行を選択して、マウスの右ボタンをクリックし、ポップアップ・メニューから「トリガー」コマンドを選択します。ヒント

4	現行のプログラム単位以外の位置でトリガーを起動するには、「場所」ドロップダウン・リストから位置を選択します。

5	「トリガー本体」テキスト・ボックス内にデバッグ・トリガーを入力します。

6	「OK」をクリックします。


PL/SQLインタプリタへのナビゲータ・シートの挿入

  関連項目

PL/SQLインタプリタにオブジェクト･ナビゲータ･ペインを挿入するには：

  デモ

1	PL/SQLインタプリタが表示されていない場合は、「プログラム」 [image] 「PL/SQLインタプリタ」を選択します。

2	「表示」 [image] 「ナビゲータ・ペイン」を選択して、PL/SQLインタプリタの中央にオブジェクト・ナビゲータ・ペインを挿入します。

ボタン・バーが新しいオブジェクト・ナビゲータのボタンに更新されている点に注意してください。

3	（オプション） 分割バーを使用して、3つのペインの比率サイズを変更します。


コードのステップ単位での実行

  次のステップ	  関連項目

コードをステップ単位で実行するには：

処理を続行する前に、ブレークポイントのようなデバッグ・アクションを設定した上でPL/SQLインタプリタのPL/SQL>プロンプトでプログラム単位を実行して、実行を中断する必要があります。

中断されたプログラム単位の次行を実行するには:

  デモ

  現行のプログラム単位で、実行コードの次行を実行するには、インタプリタのツールバーの [image] をクリックします。

次の実行可能な行が、ネストされたサブプログラムのコールである場合、「ステップ･イン」により、ネストされたサブプログラムの最初の行で実行が中断されます。

中断したプログラム単位で、ネストされたサブプログラム・コールの次のステップへ進むには:

  デモ

  PL/SQLインタプリタのツールバーの [image] をクリックします。

「ステップ･オーバー」により、ネストされたサブプログラムのコールが実行され、現行のプログラム単位内の次の実行可能な行で、実行が中断されます。

ネストされたサブプログラムからステップ・アウトし、元のプログラム単位に戻るには:

  デモ

  PL/SQLインタプリタのツールバーの [image] をクリックします。

ネストされたサブプログラムの処理に入るときに「ステップ･イン」を使用した場合、「ステップ・アウト」により、ネストされたサブプログラムの処理を終了して、元のプログラム単位の次行へ戻ります。

プログラム単位の実行を再開するには:

  PL/SQLインタプリタのツールバーの [image] をクリックします。

プログラム単位の実行が再開され、プログラム単位の実行が終了するか、または他のデバッグ・アクションにより再び実行が中断されるまで続けられます。

ただし、デバッグ・アクションがPL/SQL LOOPにある場合は、「実行」を使用するとループ内の処理を繰り返します。

現行のデバッグ・レベルで中断された実行を終了するには:

  PL/SQLインタプリタのツールバーの [image] をクリックします。

インタプリタか、または（他にある場合は）外部のデバッグ・レベルに制御が戻されます。


ローカル変数の検査または変更

  次のステップ

ローカル変数の値を検査または変更するには、PL/SQLインタプリタでプログラム単位を現在中断している必要があります。

ローカル変数の値を検査するには:

1	オブジェクト・ナビゲータで「スタック」ノードを拡張して、コール・スタック・フレームを表示します。

2	「スタック」ノードで、検査または変更する変数を持つプログラム単位のノードをダブルクリックします。

各ローカル変数が現在の設定値で表示されます。

ローカル変数の値を編集するには:

1	オブジェクト・ナビゲータで「スタック」ノードを拡張して、コール・スタック・フレームを表示します。

2	「スタック」ノードで、検査または変更する変数を持つプログラム単位のノードをダブルクリックします。

各ローカル変数が現在の設定値で表示されます。

3	オブジェクト・ナビゲータ内の変数の値をクリックします。

4	もう一度変数値をクリックして、編集モードに入ります。

5	変数の値を変更します。

6	オブジェクト・ナビゲータのブランク領域をクリックして編集モードを終了し、変更した値を受け入れます。

7	PL/SQLインタプリタでプログラム単位の実行を再開して、新規の値の影響をテストします。


デバッグ・アクションを使用不可または変更可能にする

  次のステップ	  関連項目

現在アクティブのデバッグ・アクションを使用不可にするには:

1	オブジェクト・ナビゲータで「デバッグ・アクション」ノードを拡張してから、希望するアクションをクリックします。

2	右マウスをクリックし、ポップアップ・メニューから「使用不可」を選択します。

現在使用不可のデバッグ・アクションを変更可能にするには:

1	オブジェクト・ナビゲータで「デバッグ・アクション」ノードを拡張してから、変更可能にするアクションをクリックします。

2	右マウスをクリックし、ポップアップ・メニューから「変更可能」を選択します。


デバッグ・アクションの編集

デバッグ・アクションを編集するには:

1	オブジェクト・ナビゲータで「デバッグ・アクション」ノードを拡張してから、該当するダイアログに表示するデバッグ・アクションのアイコンをダブルクリックします。

2	ダイアログ内のデバッグ・アクション内容またはプロパティを編集します。

3	「OK」をクリックします。


デバッグ・アクションの削除

デバッグ・アクションを削除するには:

1	オブジェクト・ナビゲータで「デバッグ・アクション」ノードを拡張してから、削除するアクションをクリックします。

2	ツールバーの [image] をクリックします。


?


SELECT文の例（複数の問合せからなるグループ上レポートの最初の問合せ）

  関連項目 	  すべての例

次の例は、複数の問合せからなるグループ上レポートの最初の問合せに使用するSELECT文です。

SELECT ENAME, EMPNO FROM EMP WHERE JOB = 'SALESMAN'


SELECT文の例（複数の問合せからなるグループ上レポートの2番目の問合せ）

  関連項目 	  すべての例

次の例は、複数の問合せからなるグループ上レポートの2番目の問合せに使用するSELECT文です。

SELECT REPID, PRODNAME, AMOUNT, CUSTNAME FROM SALES ORDER BY REPID, CUSTNAME


SELECT文の例（ネストされたマトリックス）

  関連項目 	  すべての例

次の例は、ネストされたマトリックス・レポートに使用するSELECT文です。

SELECT TO_CHAR(HIREDATE,'YY') YEAR, DEPTNO, JOB, SUM(SAL) FROM EMP GROUP BY TO_CHAR(HIREDATE,'YY'), DEPTNO, JOB ORDER BY TO_CHAR(HIREDATE,'YY'), DEPTNO, JOB


ハイパーリンクの宛先の例（静的）

  関連項目 	  すべての例

次の例は、「LINK1」としてオブジェクトを識別する場合の「ハイパーリンクの宛先」プロパティの値です。

LINK1


ハイパーリンクの宛先の例（動的）

  関連項目 	  すべての例

次の例は、動的に識別子を作成する場合の「ハイパーリンクの宛先」プロパティの値です。

'DEPT_DETAILS_' || LTRIM(TO_CHAR(:DEPTNO))

ここで、:DEPTNOは実行時にデータベースから取り出される列値です。


ハイパーリンクの例（静的）

  関連項目 	  すべての例

次の例は、「LINK1」として識別される宛先へのリンクを指定する場合の「ハイパーリンク（HTML/PDF）」プロパティの値です。

#LINK1


ハイパーリンクの例（動的）

  関連項目 	  すべての例

次の例は、動的に識別される宛先へのリンクを指定する場合の「ハイパーリンク（HTML/PDF）」プロパティの値です。

'DEPT_DETAILS_' || LTRIM(TO_CHAR(:DEPTNO))

ここで、:DEPTNOは実行時にデータベースから取り出される列値です。


ハイパーリンクの例（リモート・サーバー上のHTMLドキュメントへのハイパーリンク）

  関連項目 	  すべての例

次の例は、リモートWebサーバー上のHTMLドキュメントへのリンクを指定する場合の「ハイパーリンク（HTML/PDF）」プロパティの値です。

HTTP://WWW.NETMACH.COM/MYDOC.HTM


ハイパーリンクの例（リモート・サーバー上のスクリプトへのハイパーリンク）

  関連項目 	  すべての例

次の例は、リモートWebサーバー上のスクリプトへのリンクを指定する場合の「ハイパーリンク（HTML/PDF）」プロパティの値です（PDFまたはHTMLドキュメントのいずれかを戻します）。

HTTP://WWW.NETMACH.COM/CGI-BIN/DOCSTUFF/PARAM1+PARAM2+PARAM3


アプリケーション・コマンド・ラインの例

  関連項目 	  すべての例

次の例は、フォーマットされたレポート内でリンクがクリックされると指定されたコマンドを実行するオブジェクトに対して、リンクを追加する場合の「アプリケーション・コマンド・ライン（PDF）」プロパティの値です。

C:\ORAWIN95\BIN\RWRUN60.EXE USERID=SCOTT/TIGER REPORT=EXAMPLE.RDF


ブックマークの例（静的ブックマーク文字列）

  関連項目 	  すべての例

次の例は、「Expense Summary」というブックマーク文字列を作成する場合の「ブックマーク」プロパティの値です。

EXPENSE SUMMARY


ブックマークの例（動的ブックマーク文字列）

  関連項目 	  すべての例

次の例は、動的にブックマーク文字列を作成する場合の「ブックマーク」プロパティの値です。

:CATEGORY || ' EXPENSES'

ここで、:CATEGORYは実行時にデータベースから取り出される列値です。


ブックマークの例（順序指定のブックマーク・リスト）

  関連項目 	  すべての例

次の例は、ブックマークのリストを明示的に順序付ける場合の「ブックマーク」プロパティの値です。たとえば、ブックマーク・エントリをブックマーク・リストの最初の項目として順序付けるには、次のように指定します。注意

1#EXPENSE SUMMARY


ブックマークの例（順序指定のブックマーク・リスト、インデント）

  関連項目 	  すべての例

次の例は、ブックマーク・リストを明示的に順序付けてインデントする場合の「ブックマーク」プロパティの値です。たとえば、ブックマーク・リストの最初の項目の下にブックマーク・エントリをインデントするには、次のように指定します。注意

'1.1#':CATEGORY || ' EXPENSES'


レポート前値の例

  関連項目 	  すべての例

次の例は、ヘッダー・ページに会社のロゴが入ったHTMLファイルを組み込む場合の「レポート前値」プロパティの値です。

LOGO.HTM

「レポート前値」を設定する前に「レポート前型」プロパティを「ファイル」に設定する必要があることに注意してください。


レポート後値の例（テキストの追加）

  関連項目 	  すべての例

次の例は、HTMLドキュメントにテキストを追加する場合の「レポート後値」プロパティの値です。

<ADDRESS>

QUESTIONS? - -

<A HREF=MAILTO:WEBMASTER@XYZTECH.COM>WEBMASTER@XYZTECH.COM</A>

</ADDRESS>

</BODY>

</HTML>


レポート後値の例（ホーム・ページへのリンク）

  関連項目 	  すべての例

次の例は、レポート出力の最後にホーム・ページへの2つのリンクを挿入する場合の「レポート後値」プロパティの値です。

<CENTER>

<A HREF="HTTP://WWW.ORACLE.COM/">ORACLE CORPORATION</A> -

<A HREF="HTTP://HOME.NETSCAPE.COM/">NETSCAPE</A>

</CENTER>

</BODY>

</HTML>'


ページ前値の例

  関連項目 	  すべての例

次の例は、ブラウザ内にドキュメントを中央揃えする場合の「ページ前値」および「ページ後値」プロパティの値です。

「ページ前値」：<CENTER>

「ページ後値」：</CENTER>


ページ後値の例（GIFファイルの挿入）

  関連項目 	  すべての例

次の例は、ページ・セパレータとしてGIFファイルを挿入する場合の「ページ後値」プロパティの値です。

<CENTER><IMG ALT="RULER" SRC="LINE.GIF" VSPACE=10><BR></CENTER>


フォーム前値の例

  関連項目 	  すべての例

次の例は、HTMLパラメータ・フォームの先頭に会社のロゴが入ったHTMLファイルを組み込む場合の「フォーム前値」プロパティの値です。

LOGO.HTM


フォーム後値の例（テキストの追加）

  関連項目 	  すべての例

次の例は、HTMLパラメータ・フォームの下部にテキストを追加する場合の「フォーム後値」プロパティの値です。

<B><FONT FACE="Arial, Helvetica"><FONT COLOR="#FF0000">

Click <IMG SRC="RUN.GIF" HEIGHT=18 WIDTH=18> to run the report using the parameters you have specified above.

</FONT></FONT></B>


フォーマット・トリガーの例（行グループ間へのブランクの挿入）

  関連項目 	  すべての例

次の例は、行グループ間にブランクを挿入するフォーマット・トリガーです（行数をSPACEの値で割って余りのないときに四角形のボイラープレートを表示）。

FUNCTION SPACING RETURN BOOLEAN IS
BEGIN
  IF :CountENAMEPerReport MOD :SPACE = 0 THEN
    RETURN (TRUE);
  ELSE RETURN (FALSE);
  END IF;
END;


バッチ・モードによるMAPI (Windows) 電子メールの例（姓と名前で受信者を指定する場合）

  関連項目 	  すべての例

次の例は、バッチ・モードでレポートをメール送信する場合に、氏名によって電子メールの受信者を指定する方法を示しています。注意

RWRUN60 monthly.rdf USERID=scott/tiger DESTYPE=mail DESNAME="John Robertson,Mary Johnson,Anne" BATCH=yes


バッチ・モードによるMAPI (Windows) 電子メールの例（受信者の名前にアポストロフィが含まれる場合）

  関連項目 	  すべての例

次の例は、バッチ・モードでレポートをメール送信する場合に、電子メールの受信者の名前にアポストロフィが含まれる場合（O'Hara）の指定方法を示しています。注意

RWRUN60 monthly.rdf USERID=scott/tiger DESTYPE=mail DESNAME="John,Tim O''Hara,Mary Johnson,Anne" BATCH=yes


MAPI (Windows) 電子メールの例（姓と名前で受信者を指定する場合）

  関連項目 	  すべての例

次の例は、氏名によって電子メールの受信者を指定する方法を示しています。注意

"John Robertson,Steve Johnson,Paul"


MAPI (Windows) 電子メールの例（受信者の名前にアポストロフィが含まれる場合）

  関連項目 	  すべての例

次の例は、電子メールの受信者の氏名にアポストロフィが含まれる場合（O'Hara）の指定方法を示しています。注意

"John,Tim O''Hara,Steve Johnson,Paul"


Oracle*Mail (UNIX) 電子メールの例（受信者を複数指定する場合）

  関連項目 	  すべての例

次の例は、電子メールの受信者を複数指定する方法を示しています。注意

(JROBERTS, SJOHNSON, PHARVEY)


URLの例（イメージへのリンク）

  関連項目 	  すべての例

次の例は、イメージのURLを指定する方法を示しています。

1	HTTP://www.oracle.com/images/logo.gif

2	HTTP://&<P_SERVER_NAME>/images/logo.gif

この場合、P_SERVER_NAMEはCHAR型のユーザー・パラメータです。

エンド・ユーザーは、実行時に、パラメータの値を指定できます （たとえば、HTTP://www.oracle.us.com/images/logo.gifの動的URLリンクに  P_SERVER_NAME = www.oracle.us.comを指定する）。

3	FILE://c:/images/logo.gif

注意:  「参照」をクリックしてファイルを検索すると、Report Builderでは、戻されたパスにFILE://を自動的に付加します。


REFカーソルの例

  関連項目 	  すべての例

empCur rcPackage.empCurType;

BEGIN
  OPEN empCur FOR SELECT * FROM emp;
  RETURN empCur;
END;

/* Note, rcPackage is a local program unit defined as: */ */

PACKAGE rcPackage IS
  TYPE empCurType IS REF CURSOR RETURN emp%ROWTYPE;
END;


追加のハイパーリンク属性の例

  関連項目 	  すべての例

例1

ハイパーリンクの宛先によって置き換えるHTMLフレームを指定するには、「追加のハイパーリンク属性」プロパティ設定に、次のHTMLをインクルードします。

TARGET=<name of the frame to replace>

また、オブジェクトをクリックすると、ハイパーリンクの宛先を表示するウィンドウ全体によってフレームがデフォルトで置き換えられます。

例2

マウス・カーソルが買い物かごオブジェクトの上を通過するとき、Webブラウザの下部に情報のステータス行を生成するには、「追加のハイパーリンク属性」プロパティ設定に、次のHTMLをインクルードします。

onMouseover "window.status='買い物かごの中身を見るには、ここをクリックしてください';return true" onMouseout ="window.status=' ';return true"

結果: マウスのカーソルが買い物かごオブジェクトの上を通過するとき、Webブラウザの底部に、'買い物かごの中身を見るには、ここをクリックしてください'というメッセージが表示されます。

また、「追加のハイパーリンク属性」プロパティを設定してJavaScript関数をコールし、カーソルがオブジェクト上を通過するときにオブジェクトの色を変えるなど、希望のアクションを実行させることもできます。

onMouseover="fSwitch(2, 1)" onMouseout ="fSwitch(2, 0)" onClick="fSelect(2)"

注意: JavaScriptコールを使用するには、レポート前エスケープを変更して、次の行のようなコードをインクルードする必要があります。

<!--  //hide from older browsers

// iCurrentSelect maps to the currently
// selected menu choice,
// which is the index of the choice
//in the base image name array
var iCurrentSelect = -1

// the BaseImgName array holds the base
// image name for each choice in the document
// if new choices are added, the 'name' of
// the image and gif file must match the value
// added to this array

aBaseImgName = new Array(9)
aBaseImgName[0] = "nw"
aBaseImgName[1] = "db"
aBaseImgName[2] = "tl"
aBaseImgName[3] = "ap"
aBaseImgName[4] = "dw"
aBaseImgName[5] = "ol"
aBaseImgName[6] = "it"
aBaseImgName[7] = "ot"
aBaseImgName[8] = "mo"

// create the image arrays for each menu
//choice

aChoice0 = new Array(2)
aChoice1 = new Array(2)
aChoice2 = new Array(2)
aChoice3 = new Array(2)
aChoice4 = new Array(2)
aChoice5 = new Array(2)
aChoice6 = new Array(2)
aChoice7 = new Array(2)
aChoice8 = new Array(2)

// preload the images into the image arrays

for (var i = 0 ; i < aBaseImgName .length; i++) {
  eval("aChoice" + i)[0] = new Image(150,27)
  eval("aChoice" + i)[0].src = "roll_images/" + aBaseImgName[i] + "_off.gif"
  eval("aChoice" + i)[1] = new Image(150,27)
  eval("aChoice" + i)[1].src = "roll_images/" + aBaseImgName[i] + "_on.gif"
}

function fSwitch(choiceNum, state) {
  // choiceNum = the array index of the
  // base img name that is being replaced
  // - nw=0, db=1 ....
  // state = array index of img to use
  // from image array - 0=off, 1=on,
  // (2=sel not implemented)
  if (iCurrentSelect != choiceNum) {
  // do not switch the current select
    eval("document."+ aBaseImgName[choiceNum]).src = eval("aChoice" + choiceNum)[state].src
  }

  return true
}

function fSelect(choiceNum) {
  // if there is a previous select then
  // clear it state 0
  if (iCurrentSelect > -1) {
    eval("document."+ aBaseImgName[iCurrentSelect]).src = eval("aChoice" + iCurrentSelect)[0].src
  }

  // image state of 1 hard wired, could be
  // passed as a variable
  eval("document."+ aBaseImgName[choiceNum]).src = eval("aChoice" + choiceNum)[1].src
  // store the new selection
  iCurrentSelect = choiceNum

  return true;
}

//stop hiding -->


チャート・ハイパーリンクの例

各従業員の給与を表示するレポートを作成すると仮定します。同じデータを表示するには、チャートを作成できます。Webウィザードの「チャート・ハイパーリンク」ページで、「使用可能なチャート」リストから「チャート」リストへ、チャートを移動し、「完了」をクリックします。次に、「レイアウト・モデル」表示内でチャート・オブジェクトをダブルクリックし、プロパティ・パレットを表示します。「チャート・ハイパーリンク」プロパティには、次のようなコードが表示されます。

#chart_name&sumsal

ここで、chart_nameはチャートの名前、sumsalはレポートのサマリー列です。これら2つの値は問合せによって異なることに注意してください。

レポートの出力先では、ランタイム・ユーザーはチャートのセクションをクリックし、対応するデータ行にアクセスできます。このグラフィックでは、Millerの肩書き、名前および給与が表示されているのがわかります。


HTMLパラメータ･フォームの例（デフォルトは大文字で入力）

  関連項目 	  すべての例

次の例では、パラメータ･フォーム･フィールドでの入力について、データ入力値がデフォルトで大文字になるように指定します。パラメータ･フォーム･エディタでソースがDESFORMATのパラメータ･フォームPF_DESFORMATを作成します。「Webの設定」下のプロパティ･パレットで、「追加の属性（HTML）」プロパティを次のように設定します。

onChange="this.value=this.value.toUpperCase()"

エンド･ユーザーが宛先フォーマットにpdfを使用すると、レポートをWebから実行したときにランタイム・パラメータ･フォームでその値が大文字（たとえばPDF）に変換されます。


HTMLパラメータ･フォームの例（データ入力の妥当性）

  関連項目 	  すべての例

次の例は、レポートをWebから実行する場合に入力の妥当性チェックに関してパラメータ･フォーム･フィールドを設定する方法を示します。これにより、エンド･ユーザーが無効なデータをパラメータ･フォーム･フィールドに入力するたびにメッセージを呼び出すことができます。

パラメータ･フォーム･エディタでパラメータ･フォームPF_DEPTNOを作成し、プロパティ･パレットをオープンします。「パラメータ･フォーム･フィールド」で「ソース」プロパティを「DEPTNO」に設定します。「Webの設定」で「追加の属性（HTML）」プロパティを次のJavaScriptイベント･ハンドラに設定します。

onChange="checkIt(this.form)"

オブジェクト・ナビゲータで、 [image] （レポートのプロパティ・アイコン）をクリックして、プロパティ･パレットをオープンします。「レポート･エスケープ」で「フォーム前型」を「テキスト」に設定し、「フォーム前値」プロパティに次のJavaScriptコードを挿入します。

<SCRIPT LANGUAGE = "JavaScript">

function isNumber(inputStr){

   for (var i = 0; i < inputStr.length; i++) {

var oneChar = inputStr.charAt(i)

if (oneChar < "0" || oneChar > "9") {

alert("Please enter a numeric value.")

return false

             }

     }

    return true

}

function checkIt(form) {

inputStr = form.DEPTNO.value

if (isNumber(inputStr)) {

// statements if true

} else {

form.numeric.focus()

form.numeric.select()

}

}

</SCRIPT>

レポートをWebから実行した場合に、エンド･ユーザーがランタイム･パラメータ･フォームに部門番号ではなく部門名を入力すると、次のメッセージが呼び出されます。

Please enter a numeric value.


HTMLパラメータ･フォームの例（選択の妥当性）

  関連項目 	  すべての例

次の例は、レポートをWebから実行する場合に選択の妥当性チェックに関してパラメータ･フォーム･フィールドを設定する方法を示します。これにより、エンド･ユーザーがランタイム･パラメータ･フォームでDESTYPE値リストからプリンタを選択するたびにメッセージを呼び出すことができます。

パラメータ･フォーム･エディタでパラメータ･フォームPF_DESTYPEを作成し、プロパティ･パレットをオープンします。「パラメータ･フォーム･フィールド」で「ソース」プロパティを「DESTYPE」に設定します。「Webの設定」で「追加の属性（HTML）」プロパティを次のJavaScriptイベント･ハンドラに設定します。

onChange="isPrinter(this.form)"

オブジェクト・ナビゲータで、 [image] （レポートのプロパティ・アイコン）をクリックして、プロパティ･パレットをオープンします。「レポート･エスケープ」で「フォーム前型」を「テキスト」に設定し、「フォーム前値」プロパティに次のJavaScriptコードを挿入します。

<SCRIPT LANGUAGE = "JavaScript">

function isPrinter(form) {

  if( form.DESTYPE.options[form.DESTYPE.selectedIndex].value == 'Printer')

    alert("Please be sure that your print is installed and running.")

    return true}

   }

</SCRIPT>

実行時に、エンド･ユーザーがDESTYPEフィールド内の値リストからプリンタを選択すると、次のメッセージが呼び出されます。

Please be sure that your print is installed and running.


ユーザー・イグジットの作成

  関連項目

ユーザー・イグジットを作成するには：

1	ユーザー・イグジットのないレポートを作成します。

2	必要なユーザー・イグジットを決めます。

3	ホストのプログラミング言語の1つを使用してユーザー・イグジットを書きます。

4	サンプルのソース・ファイルを変更してまたはユーザー独自のソース・ファイルを作成してユーザー・イグジットをインプリメントします。

5	Report オブジェクトおよびユーザー・イグジット・コールを作成します。


プロシージャ・コールの作成

  関連項目

プロシージャ・コールを含むプログラムを生成する方法

1	Oracleプログラム・インタフェースのホスト言語の1つを使用して、プログラムを記述します（Ada、C、COBOL、FORTRANまたはPascal、PL/1）。プログラムには、1つ以上のプロシージャ・コールを組み込みます。

2	プログラムをコンパイルします。これにより、オブジェクト・ファイルが作成されます。

3	Report Builderプロシージャ・コールはCで書かれています。 コンパイルで生成されたCプログラムのオブジェクト・ファイルはReport Builderに添付されています。作成したプログラムを参照先となるReport Builderオブジェクト・ファイルにリンクします。


?


問合せの変更

  関連項目	  次へ

レポートに表示されたSQL問合せ文または列を変更するには:

1	データ・モデル表示で、問合せオブジェクトをクリックし、続いて「ツール」 [image] 「データ・ウィザード」を選択します。

•	SELECT文を変更するには、「データ」タブをクリックします。

•	ブレーク・グループを変更するには、「グループ」タブをクリックします。

•	合計のサマリー列を追加または変更するには、「Totals」タブをクリックします。

2	レポートに表示する選択したデータベースの列を変更するには、「ツール」 [image] 「レポート・ウィザード」を選択し、「フィールド」タブをクリックします。

問合せのプロパティを変更するには:

1	データ・モデル表示で、問合せオブジェクトをクリックし、「ツール」 [image] 「プロパティ・パレット」を選択します。

2	プロパティ・パレットで、適宜プロパティを変更します。


テキストの編集

  関連項目

テキストを挿入して置換するには:

1	ライブ・プレビューア表示内で、テキスト・オブジェクトをクリックします。注意

2	テキストをクリックし、編集モードに切り替えます。

3	テキストを希望の通りに変更した後、テキスト・オブジェクトの外側をクリックします。

テキストを削除するには:

1	ライブ・プレビューア表示内で、テキスト・オブジェクトをクリックします。注意

2	テキストを全てカットするには、「編集」 [image] 「消去」を選択します。

3	テキストの一部分をカットするには、カットするテキスト部分をクリック・アンド・ドラッグでマークした後、[Del]キーをクリック・アンド・ドラッグします。

テキストをカット、コピーまたはペーストするには:

1	レイアウト・モデル表示内で、テキスト・オブジェクトをクリックします。注意

2	カットまたはコピーするテキストをクリック・アンド・ドラッグで範囲指定します。

3	「編集」 [image] 「カット」または「編集」 [image] 「コピー」を選択します。

4	テキストをペーストするには、「編集」 [image] 「ペースト」を選択します。


テキストの属性の変更

  関連項目

テキストのフォント、文字揃え、間隔、読込み方向を変更するには:

1	ライブ・プレビューア表示内で、テキスト・オブジェクトをクリックします。ヒント  注意

2	「書式」メニューから、「フォント」、「両端揃え」、「テキスト間隔」または「方向」を選択します。


フィールド内のテキストの折返し

  関連項目

フィールド内のテキストを折り返すには:

1	「ツール」 [image] 「レポート・ウィザード」を選択します。

2	「レポート・ウィザード」で、「ラベル」タブをクリックします。

3	テキストを折り返すフィールドの列幅の値を、希望するとおりに変更します。

4	「適用」をクリックします。

5	レイアウト・モデル表示内で、フィールドをダブルクリックします。注意

6	「標準レイアウト」ノードの下の、プロパティ・パレット内で、「垂直拡張度」プロパティが「拡張」に設定されていることを確認します。


オブジェクト境界線属性の変更

  関連項目

オブジェクトの境界線を変更するには:

1	ライブ・プレビューア表示内で、オブジェクトをクリックします。ヒント  注意

2	線幅を変更するには、「書式」 [image] 「線幅」を選択します。

3	パターンを選択するには、「書式」 [image] 「線種」を選択します。線種パターンはオブジェクトの出力によってはっきりしないことがあります。「書式」 [image] 「レイアウト・オプション」 [image] 「レイアウト・モデル」を選択して、「オプション」タブの 「枠アウトライン」のチェックをオフにします。

4	境界線に"枠を付ける"には、「書式」 [image] 「凹凸」を選択します。


オブジェクトの境界線の表示または非表示

  関連項目

オブジェクトの境界線を表示または非表示にするには:

1	ライブ・プレビューア表示内で、オブジェクトをクリックします。ヒント  注意

2	ツール・パレットの中にある、 [image] 「線カラー・ツール」をクリックします。

3	境界線を追加するには、黒く塗りつぶされた正方形をクリックします。

4	境界線を削除するには、カラー・パレットの下の「枠なし」をクリックします。ヒント

5	境界の一部を表示したりしなかったりするには、「書式」 [image] の「境界線」を選択します。 変更する個所（「上」「下」「左」「右」）をクリックし、チェック状態（表示）と未チェック状態（隠す）を切り替えてください。


カラーの変更

  関連項目

オブジェクトのカラーを変更するには:

1	ライブ・プレビューア表示内で、オブジェクトをクリックします。ヒント  注意

2	オブジェクトのどの部分に色を適用するかに応じて、パレット内の [image] 「塗りカラー」、 [image] 「線カラー」または [image] 「文字色」をクリックします

3	カラー・パレット上で、「色」をクリックします。


パターンの変更

  関連項目

オブジェクトのパターンを変更するには:

1	ライブ・プレビューア表示内で、オブジェクトをクリックします。ヒント  注意

2	オブジェクトのどの部分に色を適用するかに応じて、ツール・パレット内の [image] 「塗りカラー」または [image] 「線カラー」をクリックします。

3	カラー・パレット上で、「パターン」をクリックします。

4	パターン・パレット上で、パターンをクリックします。フォアグラウンド・カラーまたはバックグラウンド・カラーを変更するには、パターン・パレットの一番下のドロップダウン・カラー・パレットから選択します。

5	システム・メニュー・アイコンをダブルクリックして、パターン・パレットをクローズします。


数字オブジェクトへの書式マスクの適用

関連項目

数値オブジェクトに書式マスクを適用するには:

1	ライブ・プレビューア表示内で、オブジェクトをクリックします。ヒント

2	オブジェクトに通貨書式を適用するには、ツールバー内の [image] をクリックします。

3	オブジェクトにパーセンテージ書式を適用するには、ツールバー内の [image] をクリックします

4	オブジェクトの値にコンマを追加するには、ツールバー内の [image] をクリックします。コンマを右左に動かすには、 [image] または [image] をクリックします。

5	「ツール」 [image] 「プロパティ・パレット」を選択します。ヒント

6	「フィールド」ノードで、「書式マスク」プロパティが希望する書式に設定されていることを確認します。

7	その他のプロパティを、目的に応じて設定します。


日付オブジェクトへの書式マスクの適用

  関連項目

日付オブジェクトに書式マスクを適用するには:

1	ライブ・プレビューア表示内で、オブジェクトをクリックします。ヒント

2	「ツール」 [image] 「プロパティ・パレット」を選択します。ヒント

3	「フィールド」ノードで、「書式マスク」プロパティを希望する日付書式に設定します。

4	その他のプロパティを、目的に応じて設定します。


複数のオブジェクトの移動

  関連項目

複数のオブジェクトを移動するには:

1	移動するオブジェクトの周囲に、クリック・アンド・ドラッグでボックスを描きます。ヒント

2	キーボードの矢印キーを使用して、オブジェクトを希望する位置に移動します。


親の外へのオブジェクトの移動

  関連項目

子オブジェクトを親である囲みオブジェクトの外側に移動するには:

  デモ

1	レイアウト・モデル表示内で、制限モードがオフ（ツールバー内のボタンの表示が [image] ）になっていることを確認します。

2	希望どおりに、子オブジェクトをクリック・アンド・ドラッグします。ヒント


親の境界線の自動調整

  関連項目

子オブジェクトの移動時に、親の境界線を調整するには:

  デモ

1	ライブ・プレビューア表示内で、フレックス・モードがオン（ツールバー表示内のボタンが、 [image] ）になっていることを確認します。注意

2	希望どおりに、子オブジェクトをクリック・アンド・ドラッグします。ヒント

3	他のオブジェクトと水平または垂直に整列しているオブジェクト（フィールドやラベルなど）を移動するには、[Ctrl]キーを押しながら最初のオブジェクトをドラッグします。両方のオブジェクトを同時に移動する場合は、[Ctrl]キーを使用しないでください。


レポート出力範囲内の列の移動

  関連項目

レポート出力内で列を移動するには:

1	ライブ・プレビューア表示内で、列をクリックします。注意

2	フレックス・モードがオン（ツールバー内のボタンが、 [image] ）になっていることを確認します。

3	希望する位置に列をドラッグします。


オブジェクトの整列

  関連項目

オブジェクトを整列するには:

1	レイアウト・モデル表示またはパラメータ・フォーム表示内で、整列させるオブジェクトをクリックします。ヒント

2	「配置」 [image] 「オブジェクト整列」を選択します。

3	ダイアログ・ボックスで、希望する整列を指定します。

4	「OK」をクリックします。

その他のオブジェクトに現行の整列を適用するには:

1	レイアウト・モデル表示またはパラメータ・フォーム表示内で、整列させるオブジェクトをクリック。ヒント

2	「配置」 [image] 「整列繰返し」を選択します。


アンカーの移動

  関連項目

アンカーを移動するには:

1	レイアウト・モデル表示内で、アンカーをクリックします。

2	ツール・パレット内の [image] をクリックし、次にアンカー終点の1つをオブジェクト枠の新たな位置までドラッグします。

アンカーをオブジェクトの枠に沿って25%ずつ移動するには:

 制限キー（たとえば、[Shift]キー）を押しながら、アンカーを移動します。


オブジェクト・レイヤーの変更

  関連項目

オブジェクト・レイヤー間の上下の順序を変更するには:

1	レイアウト・モデル表示内で、制限モードがオフ（ツールバー内のボタンの表示が [image] ）になっていることを確認します。

2	移動するオブジェクトをクリックします。注意

3	「配置」メニューから、次の項目のうち1つを選択します。

•	「最前面へ移動」は、その他すべてのオブジェクトの前面へオブジェクトを移動します。

•	「最背面へ移動」は、その他すべてのオブジェクトの背面へオブジェクトを移動します。

•	「前面へ」は、ひとつ上のオブジェクトの前面へオブジェクトを移動します。

•	「背面へ」は、ひとつ下のオブジェクトの背面へオブジェクトを移動します。


ボイラープレート・オブジェクトの回転

  関連項目

ボイラープレート・オブジェクトを回転するには:

1	レイアウト・モデル表示またはパラメータ・フォーム表示内で、回転させるオブジェクトまたはグループをクリックします。ヒント

2	ツール・パレット内の [image] をクリックします。

3	ハンドルをドラッグして、オブジェクトまたはグループを回転します。


オブジェクトのサイズ変更

  関連項目

1個または複数個のオブジェクトのサイズを変更するには: 注意

1	オブジェクトをクリックします。ヒント

2	サイズを設定します。

•	固定サイズに設定する場合は、選択したオブジェクトのうち1つのハンドルをドラッグします。それに従って、選択したすべてのオブジェクトのサイズが変更されます。

•	または、「ツール」 [image] 「プロパティ・パレット」を選択します。プロパティ・パレットにおいて、「標準レイアウト」ノードの垂直拡張度と水平拡張度のプロパティを縮小、拡張、固定または可変に設定します。


複数のオブジェクトを同じサイズに変更

  関連項目

複数のオブジェクトを同じサイズに変更するには:

1	レイアウト・モデル表示またはパラメータ・フォーム表示内で、サイズを変えるオブジェクトをクリックします。ヒント

2	「配置」 [image] 「オブジェクト・サイズ設定」を選択します。

3	ダイアログ・ボックスで、希望する設定を指定します。「OK」をクリックします。

前に行った「配置」 [image] 「オブジェクト・サイズ設定」の処理を繰り返すには:

1	レイアウト・モデル表示またはパラメータ・フォーム表示内で、サイズ変更するオブジェクトをクリックします。ヒント

2	「配置」 [image] 「整列繰り返し」を選択します。


マージンの調整

  関連項目

マージンを調整するには:

1	レイアウト・モデル表示内で、ツールバー内の [image] をクリックします。注意

2	マージンの境界線をクリックした後、希望する位置へハンドルをドラッグします。レポートの上下左右のマージン調整ができます。

3	ツールバー内の [image] をクリックして、レポートのボディ領域をアクティブにします。


列のラベルまたは列幅の変更

  関連項目

列のラベルや列幅を変更するには:

1	「ツール」 [image] 「レポート・ウィザード」を選択します。

2	「レポート・ウィザード」で、「ラベル」タブをクリックします。

3	「ラベル」および「幅」列の値を、希望するとおりに変更します。

4	「適用」をクリックします。


フィールド内の間隔の変更

  関連項目

フィールドの範囲間隔を変更するには:

1	ライブ・プレビューア表示内で、フィールドをクリックします。ヒント  注意

2	「書式」 [image] 「テキスト間隔」を選択して、フィールド値に対して望ましい間隔を設定します。


デフォルト・レイアウトの間隔の変更

  関連項目

デフォルト・レイアウトの間隔を変更するには:

1	プロパティ・シートを表示するには、「ツール」 [image] 「作業環境」を選択します。

2	「ウィザ-ド」タブをクリックします。

3	オブジェクトと囲まれるオブジェクトの間隔を広くするには、「水平差」および「垂直差」に大きい値を入力します。

4	フィールド間の間隔を広くするには、「水平中間フィールド」および「垂直中間フィールド」に大きい値を入力します。

5	「OK」をクリックします。


すべての行間隔の変更

  関連項目

ライブ・プレビューアを使用してすべての行の間隔を変更するには:

1	ライブ・プレビューア表示内で、2番目のレコードをクリックします。

2	レポート出力のすべての行間に希望する間隔を作るには、2番目のレコードを下へドラッグします。

プロパティ・パレットを使用してすべての行の間隔を変更するには:

1	ライブ・プレビューア表示で、レポートのボディ内の任意のフィールドをクリックします。注意

2	ツールバー内 [image] 「親枠を選択」をクリックします。

3	「ツール」 [image] 「プロパティ・パレット」を選択します。ヒント

4	「繰返し枠」ノードで、「枠間の垂直間隔」（単位: インチ）プロパティにレポート出力での行間のスペースの大きさを設定します（たとえば、0.25）。


行のグループ間のブランク行の追加

  関連項目	  例

行のグループ間にブランク行を追加するには:

1	サマリー列を作成します。データ・ウィザード（またはレポート・ウィザード）の「合計」ページで、出力の各行に表示されるフィールドから任意のものを選択し、計算結果として「カウント」を選択します。「フィールド」ページで、表示されているフィールド列から集計を削除します。

2	SPACEと名付けたユーザーパラメータを作成します。「パラメータ」ノードのプロパティ・パレット内で 、データ型プロパティをNUMBERに、そして初期値プロパティを、各グループ内に必要とするレコードの数（例えば5）に設定します。

3	レイアウト・モデル表示内で、フレックス・モードがオン、制限モードがオフ（ツールバー内のボタンの表示が [image] と [image] ）になっていることを確認します。

4	レポート出力の行のグループ間に追加するスペースより少し大きいスペースを作成するには、レコードに対する繰返し枠をクリックし、続いてフレームの一番下でハンドルをドラッグします。

5	繰り返し枠に対するプロパティ・パレットを表示するには、「ツール」 [image] 「プロパティ・パレット」を選択します。

6	「標準レイアウト」ノードの「垂直拡張度」プロパティを「可変」に設定します。

7	ツール・パレット内の [image] をクリックします。

8	レコードの下のスペース内に、四角形を描画します。

9	四角形のオブジェクトをダブルクリックします。

10	「拡張レイアウト」ノードのプロパティ・パレット内で、フォーマット・トリガー・プロパティをダブルクリックします。

11	PL/SQLエディタで、フォーマット・トリガーのPL/SQLを定義します。例

12	四角形オブジェクト上の境界を隠します。


ページ・ブレークの追加

  関連項目

ページ・ブレークを追加するには:

1	ライブ・プレビューア表示で、ページ・ブレークを挿入する枠の一部である任意のフィールドをクリックします。注意

2	ツールバー内 [image] 「親枠を選択」をクリックします。

3	「ツール」 [image] 「プロパティ・パレット」を選択します。ヒント

4	ページ・ブレークを設定するには、

•	選択した枠の前後に設定する場合:  「標準レイアウト」ノードで「前で改ページ」または「後で改ページ」プロパティを「はい」に設定します。

•	各ページの出力行の後に設定する場合:  レポート出力範囲にページ・ブレークを設定するには、「繰返し枠」ノードで、「ページ当りの最大レコード数」プロパティに各ページに表示する行数を設定します。

5	ページ・ブレークが設定されたページを確認するアイコンを表示するには、レイアウト･モデル表示:内で「表示」 [image] 「ページ・ブレーク」を選択します（ページ・ブレークの前で [image] と後で [image] が表示されます）。

注意:  Report Builderはレポート出力の特定の列でのページ・ブレークの設定をサポートしません。


オブジェクトの一括アンカー

  関連項目

オブジェクトを一括してアンカーするには: 注意

1	レイアウト・モデル表示内で、ツール・パレットの [image] をクリックします。

2	子オブジェクトの枠をクリックし、親オブジェクトの枠をダブルクリックします。

子から親へ線が引かれます。親オブジェクトに連結されている線の端に小さなボックスが表示されます。


オブジェクトへの条件付き書式の適用

  関連項目

レイアウト・オブジェクトに条件付き書式を適用するには:

1	オブジェクトをクリックし、続いて「書式」 [image] 「条件付き書式」を選択します。ヒント

2	「条件付き書式」ダイアログ・ボックスで、「書式の例外」ダイアログ・ボックスを表示するには、「新規作成」をクリックします。

3	条件と、条件がTRUEに評価される際に適用される書式を指定します。

4	「OK」をクリックします。


?


ブレーク・グループの作成

  関連項目

ビデオ・プレーヤの一番下の [image] をクリックし、動画デモを起動します。


制限モードについて

  関連項目

ビデオ・プレーヤの一番下の [image] をクリックし、動画デモを起動します。


フレックス・モードについて

  関連項目

ビデオ・プレーヤの一番下の [image] をクリックし、動画デモを起動します。


データ・リンクの作成

  関連項目

ビデオ・プレーヤの一番下の [image] をクリックし、動画デモを起動します。


マトリックス・データ・モデルの作成

  関連項目

ビデオ・プレーヤの一番下の [image] をクリックし、動画デモを起動します。


データ・モデル・オブジェクトの作成

  関連項目

ビデオ・プレーヤの一番下の [image] をクリックし、動画デモを起動します。


ライブラリへのプログラム単位の追加

  関連項目

ビデオ・プレーヤの一番下の [image] をクリックし、動画デモを起動します。


クライアントからサーバーへのプログラム単位の移動

  関連項目

ビデオ・プレーヤの一番下の [image] をクリックし、動画デモを起動します。


1つのプログラム単位のコンパイル

  関連項目

ビデオ・プレーヤの一番下の [image] をクリックし、動画デモを起動します。


PL/SQLインタプリタへのナビゲータ・シートの挿入

  関連項目

ビデオ・プレーヤの一番下の [image] をクリックし、動画デモを起動します。


ネストされたサブプログラム・コールの次のステップへ進む

  関連項目

ビデオ・プレーヤの一番下の [image] をクリックし、動画デモを起動します。


実行可能コードの次行から実行

  関連項目

ビデオ・プレーヤの一番下の [image] をクリックし、動画デモを起動します。


ネストされたサブプログラムからのステップ・アウト

  関連項目

ビデオ・プレーヤの一番下の [image] をクリックし、動画デモを起動します。


?


オブジェクトの削除

オブジェクトを削除するには:

1	オブジェクトをクリックします。ヒント

2	「編集」 [image] 「消去」を選択します。


現在のモードの変更（制限またはフレックス）

  関連項目

制限モードを設定するには:

  デモ

  モードを切り替えるには、レイアウト・モデル表示内で、ツールバーの [image] または [image] をクリックします。

オン: 子オブジェクトを、それを囲んでいる親オブジェクトの外へ移動することはできません。

オフ: 子オブジェクトを、それを囲んでいる親オブジェクトの外へ移動することができます。

フレックス・モードを設定するには:

  デモ

  モードを切り替えるには、レイアウト・モデル表示で、ツールバーの [image] または [image] をクリックします。

•	オン: 子オブジェクトを親オブジェクトの境界内で移動させると、親オブジェクトの境界が拡張します。

•	オフ: 子オブジェクトを親オブジェクトから移動させても、親の境界線は変わりません。


データベースへの接続

データベースに接続するには、次のいずれかの方法を使用します。

•	明示的ログイン

•	自動ログイン

•	リモート・ログイン


レポート・プロパティの設定

レポートのプロパティを設定するには:

1	プロパティ・パレットを表示するには、オブジェクト・ナビゲータでレポートの [image] （プロパティ・アイコン）をダブルクリックします。

2	レポート・プロパティを目的に応じて設定します。


レポートの作業環境の設定

レポートの作業環境を設定するには:

1	「ツール」 [image] 「環境設定」を選択します。

2	値を設定します。


ライブ・プレビューア・タイトルの変更

ライブ・プレビューアのタイトル・バー内のタイトルを変更するには:

1	プロパティ・パレットを表示するには、オブジェクト・ナビゲータでレポートの [image] （プロパティ・アイコン）をダブルクリックします。

2	「レポート」ノードで、「タイトル」プロパティに希望するタイトルを設定します。


?


実行時のパラメータ・フォームの表示

 次のステップ 	 関連項目

レポートの実行時にランタイム・パラメータ・フォームを表示するには:

1	「ツール」 [image] 「環境設定」を選択します。「ランタイム設定」タブで、「パラメータ・フォーム」チェックボックスがチェックされていることを確認します。

2	次のいずれかの操作を行います。

•	パラメータ・フォームで、希望するオブジェクトを作成します。

•	希望するパラメータの [image] （プロパティ・アイコン）をダブルクリックし、プロパティ・パレットを表示します。

3	「パラメータ」ノードで、必要に応じて「初期値」プロパティを設定します。

4	実行時にパラメータ値の妥当性を検査するには、「妥当性チェック・トリガー」プロパティの値フィールドをダブルクリックします。PL/SQLエディタで、実行時にトリガーされるようにPL/SQLを定義します。


事前定義済みのシステム・パラメータの使用

 次のステップ 	  関連項目

システム・パラメータを使用するには:

1	オブジェクト･ナビゲータで「データ･モデル」ノードを拡張した後、「システム･パラメータ」ノードを拡張します。

2	希望するパラメータの [image] （プロパティ・アイコン）をダブルクリックし、プロパティ･パレットを表示します。

3	「パラメータ」ノードで、必要に応じて「初期値」プロパティを設定します。

4	実行時にパラメータ値の妥当性を検査するには、「妥当性チェック・トリガー」プロパティの値フィールドをダブルクリックします。PL/SQLエディタで、実行時にトリガーされるようにPL/SQLを定義します。


ユーザー・パラメータの作成

 次のステップ	  関連項目

ユーザー・パラメータを作成するには:

1	オブジェクト・ナビゲータで「データ・モデル」ノードを拡張した後、「ユーザー・パラメータ」ノードをクリックします。

2	ツールバーの [image] をクリックします。

3	新しいパラメータの [image] （プロパティ・アイコン）をダブルクリックし、プロパティ･パレットを表示します。

4	「一般情報」ノードで、「名前」プロパティを希望するパラメータ名に置換します。

5	「パラメータ」ノードで、必要に応じて「初期値」および「値リスト」プロパティを設定します。

6	実行時にパラメータ値の妥当性を検査するには、「妥当性チェック・トリガー」プロパティの値フィールドをダブルクリックします。PL/SQLエディタで、実行時にトリガーされるようにPL/SQLを定義します。


パラメータの値リスト(LOV)の作成

パラメータの値リストを作成するには:  ヒント

1	オブジェクト・ナビゲータで「データ・モデル」ノードを拡張した後、「ユーザー・パラメータ」ノードを拡張します。

2	値リストを作成するパラメータの [image] （プロパティ・アイコン）をダブルクリックし、プロパティ・パレットを表示します。

3	「パラメータ」ノードで、「値リスト」プロパティの値フィールドをダブルクリックし、ダイアログ・ボックスを表示します。

4	作成するリストのタイプを選択します。

•	スタティック値を選択する場合、「値」テキスト・ボックスに値を入力し、「追加」をクリックします。追加する値それぞれについて、これを繰り返します。（項目をリストから削除する場合は、「削除」をクリックします。）

•	SELECT文を選択する場合は、値リストを挿入する問合せを入力します。値リストには、2つ以上の列を選択し表示することができます。 最初の列には、パラメータに割り当てられる値が入ります。値リストには、問合せに指定された順序で列が表示されます。

5	パラメータ値を値リスト内の値のみに制限する場合、「事前定義済み値に対するリストを制限」チェックボックスを選択します。ランタイム・パラメータ・フォームで値を編集したり別の値を入力できるようにするには、「事前定義済み値に対するリストを制限」チェックボックスをクリアします。

6	問合せの最初の列（パラメータ値が入っている）を値リストに表示しない場合、「第1列を隠す」チェックボックスを選択します。最初の列を隠しておく必要がないならば、「第1列を隠す」をクリックしてオフにします。

警告:

•	レポート出力をReport Builderからまたはレポートを使用しているWebブラウザで実行して、HTMLファイルに送ると、第1列の値は「第1列を隠す」を選択していても、表示されます。

•	レポートをWebブラウザから実行しており、値のリストが制限されていない場合、HTMLパラメータ・フォームにより、テキスト・フィールドのコンボ・ボックスと、テキスト・フィールドにコピーおよびペーストできるスタティック値のリストが表示されます。この場合、第1列は「第1列を隠す」を選択していても必ず、パラメータ・フォームに表示されます。

7	「OK」をクリックします。


実行時のパラメータ値の妥当性検査

  例	   関連項目

実行時にパラメータ値の妥当性検査を行うには: ヒント

1	オブジェクト・ナビゲータで「データ・モデル」ノードを拡張した後、「システム・パラメータ」または「ユーザー・パラメータ」ノードを拡張します。

2	PL/SQL妥当性チェック・トリガーを追加するパラメータの [image] （PL/SQLアイコン）をダブルクリックします。

3	PL/SQLエディタで、実行時にトリガーされるようにPL/SQLを定義します。


デフォルト・パラメータ・フォームの作成

  次のステップ	  関連項目

デフォルト・パラメータ・フォームを作成するには:

1	「ツール」 [image] 「Parameter Form Builder」を選択します。

2	「OK」をクリックし、パラメータ・フォームにデフォルト・パラメータ・フォームを表示します。


ランタイム・パラメータ・フォームに組み込むパラメータの選択

  関連項目

ランタイム・パラメータ・フォームに組み込むパラメータを選択するには: ヒント

1	「ツール」 [image] 「Parameter Form Builder」を選択します。

2	ランタイム・パラメータ・フォームに組み込むパラメータを選択します。

3	希望するとおりにパラメータ・ラベルを変更します。

4	「OK」をクリックし、「パラメータ・フォーム表示」を表示します。


ランタイム・パラメータ・フォームへのページの追加

ランタイム・パラメータ・フォームにページを追加するには:

1	オブジェクト・ナビゲータで、レポートの名前の横にある [image] （レポート・アイコン）をダブルクリックします。

2	プロパティ･パレットの「パラメータ・フォーム・ウィンドウ」ノードで、「ページ数」プロパティを希望するとおりに設定します。


?


PL/SQLの定義

  関連項目

PL/SQLを定義するには：

1	PL/SQLエディタで、プログラム単位に使用するPL/SQLコードを入力または編集します。

2	「コンパイル」をクリックします。

3	必要に応じてエラーをクリックし、ソース・コード内のエラー位置にナビゲートします。ヒント

4	コードが正常にコンパイルされたら、「クローズ」をクリックします。


PL/SQLを使用したハイパーリンクの作成

  制限	  例	  次のステップ	  関連項目

プロパティ・パレットのかわりに、PL/SQLを使用してレポートにハイパーリンクを追加するには:

1	オブジェクト・ナビゲータで「レイアウト・モデル」ノードを拡張した後、Webリンクのソースとなるオブジェクトが含まれたノードを拡張します。注意

2	Webリンクのソースとなるオブジェクトの横にある [image] （PL/SQLアイコン）をダブルクリックします。

3	PL/SQLエディタで、フォーマット・トリガーにSRW.SET_HYPERLINKを含めたPL/SQLを定義します。

4	ハイパーリンクに追加のHTML属性を適用するには、SRW.SET_HYPERLINK_ATTRSを使用します。


PL/SQLを使用したアプリケーション・コマンド・ライン・リンクの作成

  制限	  例	  関連項目

プロパティ・パレットのかわりに、PL/SQLを使用してレポート内のコマンドをオブジェクトに関係付けるには:

1	オブジェクト・ナビゲータで「レイアウト・モデル」ノードを拡張した後、アプリケーション・コマンド・ライン・リンクに関係付けるオブジェクトが含まれたノードを拡張します。注意.

2	アプリケーション・コマンド・ライン・リンクに関係付けるオブジェクトの横にある [image] （PL/SQLアイコン）をダブルクリックします。

3	PL/SQLエディタで、フォーマット・トリガーのPL/SQLを定義します。


PL/SQLを使用したブックマークの作成

  例	  関連項目

プロパティ・パレットのかわりに、PL/SQLを使用してレポートのブックマーク領域にブックマーク文字列を追加するには:

1	オブジェクト・ナビゲータで「レイアウト・モデル」ノードを拡張した後、ブックマークに関係付けるオブジェクトが含まれたノードを拡張します（通常、オブジェクトは、レポートの関連セクションを囲む繰返し枠または枠です）。注意.

2	ブックマークに関係付けるオブジェクトの横にある [image] （PL/SQLアイコン）をダブルクリックします。

3	PL/SQLエディタで、フォーマット・トリガーのPL/SQLを定義します。


PL/SQLを使用したハイパーリンクの宛先の作成

  例	  次のステップ	  関連項目

プロパティ・パレットのかわりに、PL/SQLを使用してレポートにハイパーリンクの宛先を追加するには:

1	オブジェクト・ナビゲータで「レイアウト・モデル」ノードを拡張した後、Webリンクの宛先となるオブジェクトが含まれたノードを拡張します。注意.

2	Webリンクの宛先となるオブジェクトの横にある [image] （PL/SQLアイコン）をダブルクリックします。

3	PL/SQLエディタで、フォーマット・トリガーのPL/SQLを定義します。


PL/SQLを使用したHTMLドキュメント・ヘッダーの作成

  例 	  関連項目

プロパティ・パレットのかわりに、PL/SQLを使用してHTMLドキュメントのヘッダー・ページに項目を追加するには:  注意

1	オブジェクト・ナビゲータで「レポート・トリガー」ノードを拡張します。

2	「Before Report」トリガーの横にある [image] （PL/SQLアイコン）をダブルクリックします。

3	PL/SQLエディタで、フォーマット・トリガーのPL/SQLを定義します。


PL/SQLを使用したHTMLドキュメント・フッターの作成

  例 	  関連項目

プロパティ・パレットのかわりに、PL/SQLを使用してHTMLドキュメントのフッター・ページに項目を追加するには:  注意

1	オブジェクト・ナビゲータで「レポート・トリガー」ノードを拡張します。

2	「Before Report」トリガーの横にある [image] （PL/SQLアイコン）をダブルクリックします。

3	PL/SQLエディタで、フォーマット・トリガーのPL/SQLを定義します。


PL/SQLを使用したHTMLページ・ヘッダーの作成

  例 	  関連項目

プロパティ・パレットのかわりに、PL/SQLを使用してHTMLドキュメントのすべてのページにページ・ヘッダーを追加するには:  注意

1	オブジェクト・ナビゲータで「レポート・トリガー」ノードを拡張します。

2	「Before Report」トリガーの横にある [image] （PL/SQLアイコン）をダブルクリックします。

3	PL/SQLエディタで、フォーマット・トリガーのPL/SQLを定義します。

PL/SQLを使用して、HTMLドキュメントの1つのページにページ・ヘッダーを追加するには:  注意

1	オブジェクト・ナビゲータで「レイアウト・モデル」を拡張した後、フォーマット時にトリガーを起動するオブジェクトが入ったノードを拡張します。

2	フォーマット時にトリガーを起動するオブジェクトの横にある [image] （PL/SQLアイコン）をダブルクリックします。

3	PL/SQLエディタで、フォーマット・トリガーのPL/SQLを定義します。


PL/SQLを使用したHTMLページ・フッターの作成

  例 	  関連項目

プロパティ・パレットのかわりに、PL/SQLを使用してHTMLドキュメントのすべてのページにページ・フッターを追加するには:  注意

1	オブジェクト・ナビゲータで「レポート・トリガー」ノードを拡張します。

2	「Before Report」トリガーの横にある [image] （PL/SQLアイコン）をダブルクリックします。

3	PL/SQLエディタで、フォーマット・トリガーのPL/SQLを定義します。

PL/SQLを使用して、HTMLドキュメントの1つのページにページ・フッターを追加するには:  注意

1	オブジェクト・ナビゲータで「レイアウト・モデル」を拡張した後、フォーマット時にトリガーを起動するオブジェクトが入ったノードを拡張します。

2	フォーマット時にトリガーを起動するオブジェクトの横にある [image] （PL/SQLアイコン）をダブルクリックします。

3	PL/SQLエディタで、フォーマット・トリガーのPL/SQLを定義します。


PL/SQLを使用したHTMLパラメータ・フォーム・ヘッダーの作成

  例 	  関連項目

プロパティ・パレットのかわりに、PL/SQLを使用してHTMLパラメータ・フォームの一番上に項目を追加するには: 注意

1	オブジェクト・ナビゲータで「レポート・トリガー」ノードを拡張します。

2	「パラメータ･フォーム前」トリガーの横にある [image] （PL/SQLアイコン）をダブルクリックします。

3	PL/SQLエディタで、フォーマット・トリガーのPL/SQLを定義します。


PL/SQLを使用したHTMLパラメータ・フォーム・フッターの作成

  例 	  関連項目

プロパティ・パレットのかわりに、PL/SQLを使用してHTMLパラメータ・フォームの一番下に項目を追加するには: 注意

1	オブジェクト・ナビゲータで「レポート・トリガー」ノードを拡張します。

2	「パラメータ･フォーム前」トリガーの横にある [image] （PL/SQLアイコン）をダブルクリックします。

3	PL/SQLエディタで、フォーマット・トリガーのPL/SQLを定義します。


PL/SQLを使用したHTMLページストリーム出力のナビゲーション・コントロールの追加

  関連項目

HTMLページストリーム出力のナビゲーション・コントロールを追加するには:

•	「Before Report」トリガーで、SRW.SET_PAGE_NAVIGATION_HTML PL/SQLプロシージャを使用します。


ビルトイン・パッケージの使用

  関連項目

ビルトイン・パッケージを使用するには：

1	オブジェクト・ナビゲータで「ビルトイン･パッケージ」ノードを拡張します。

2	使用するパッケージを拡張します。

3	プロシージャ、ファンクションまたは例外の横の [image] (PL/SQLアイコン）をダブルクリックしてPL/SQLコードを表示します。

4	PL/SQLプログラム単位に任意のプロシージャまたはファンクションを組込みます。


ローカルなプログラム単位の作成

  次のステップ	  関連項目

ローカルな（クライアント側）プログラム単位を作成するには:

1	オブジェクト・ナビゲータで「プログラム単位」ノードをクリックします。

2	ツールバーの [image] をクリックします。

3	ダイアログ・ボックスで、「名前」テキスト・ボックスにプログラム単位名を入力します。

4	プログラム単位がプロシージャでない場合は、「ファンクション」または「パッケージ仕様部」、「パッケージ本体」ラジオ・ボタンをクリックします。「OK」をクリックします。

5	PL/SQLエディタで、プログラム単位のPL/SQLを定義します。


ストアド・プログラム単位の作成

  次のステップ      [image]  関連項目

ストアド・（サーバー側）プログラム単位を作成するには:

1	「プログラム」 [image] 「ストアドPL/SQLエディタ」を選択します。

2	ストアド・プログラム単位エディタで「所有者」ドロップダウン・リストから所有者名を選択し、プログラム単位を格納するデータベース内の場所を示します。

3	「作成」を選択します。

4	ダイアログ・ボックスで、「名前」テキスト・ボックスにプログラム単位名を入力します。

5	プログラム単位がプロシージャでない場合は、「ファンクション」または「パッケージ仕様部」、「パッケージ本体」ラジオ・ボタンをクリックします。「OK」をクリックします。

6	PL/SQLエディタで、ストアド・プログラム単位のPL/SQLを定義します。


プログラム単位の編集

  次のステップ	  関連項目

プログラム単位を編集するには:

1	オブジェクト・ナビゲータで「プログラム単位」ノードを拡張します。

2	編集するプログラム単位の [image] （PL/SQLアイコン）をダブルクリックします。

3	PL/SQLエディタで、プログラム単位のPL/SQLを編集します。


プログラム単位の削除

  次のステップ	  関連項目

プログラム単位を削除するには:

1	オブジェクト・ナビゲータで「プログラム単位」ノードを拡張します。

2	削除するプログラム単位をクリックします。

3	ツールバーの [image] をクリックします。

4	メッセージ・ボックスで、「はい」をクリックします。


テキスト・ファイルからのソース・コードのインポート

  次のステップ	  関連項目

テキスト・ファイルからソース・コードをインポートするには:

1	オブジェクト・ナビゲータで「プログラム単位」ノードをクリックします。

2	ツールバーの [image] をクリックします。

3	ダイアログ・ボックスで、「名前」テキスト・ボックスにプログラム単位名を入力します。

4	プログラム単位がプロシージャでない場合は、「ファンクション」または「パッケージ仕様部」、「パッケージ本体」ラジオ・ボタンをクリックします。「OK」をクリックします。

5	PL/SQLエディタで、テキスト・ファイルを挿入するソース・ペイン内にカーソルを移します。

6	「ファイル」 [image] 「テキスト・インポート」を選択します。

7	ダイアログ・ボックスで、インポートするテキスト・ファイルの名前と場所を指定します。「OK」をクリックします。

8	（オプション）必要に応じてテキスト・ファイルを編集します。

9	「コンパイル」をクリックします。

10	必要に応じてエラーをクリックし、ソース・コード内のエラー位置にナビゲートします。ヒント

11	コードが正常にコンパイルされたら、「クローズ」をクリックします。


レポート・トリガーの作成

  関連項目

レポート・トリガーを作成するには:

1	オブジェクト・ナビゲータで「レポート・トリガー」ノードを拡張します。

2	作成するトリガーの [image] をダブルクリックします。

3	PL/SQLエディタで、レポート・トリガーのPL/SQLを定義します。


レポート・トリガーの削除

  関連項目

レポート・トリガーを削除するには:

1	オブジェクト・ナビゲータで「レポート・トリガー」ノードを拡張します。

2	削除するトリガーの [image] （PL/SQLアイコン）をダブルクリックします。

3	PL/SQLエディタで、 PL/SQLコードをドラッグして選択します。

4	「編集」 [image] 「消去」を選択します。


PL/SQLを実行するボタンの作成

  例	  関連項目

レポート・レイアウト内にPL/SQLを実行するボタンを作成するには:

1	「レイアウト・モデル」で、ツール・パレットの [image] をクリックします。注意

2	クリック・アンド・ドラッグで四角形を描きます。

3	ボタン・オブジェクトをダブルクリックして、プロパティ・パレットを表示します。

4	「ボタン･ラベル」ノードで、「ラベルの型」プロパティを「テキスト」または「アイコン」に設定します。

•	「ボタン・ラベル」が「テキスト」の場合、「テキスト」プロパティに、ボタン上に表示するテキストを設定します。

•	「ボタン・ラベル」が「アイコン」であれば、「アイコン名」プロパティに、アイコンが含まれたファイル名を設定します（ファイルは、UI_ICON環境変数で指定されたディレクトリ内にある必要があります）。

5	「ボタン動作」ノードで、「型」プロパティを「PL/SQL」に設定します。

6	「PL/SQLトリガー」プロパティの値フィールドをダブルクリックします。

7	PL/SQLエディタで、フォーマットされたレポート内でのボタンのクリックによって起動されるアクション・トリガーまたはフォーマット・トリガーのPL/SQLを定義します。

8	その他のプロパティを、目的に応じて設定します。

9	ボタンをアクティブにするには、レポートを実行し、ランタイム・プレビューアに表示します。


テキスト・ファイルへのソース・コードのエクスポート

  関連項目

ファイルにソース・コードを保存するには:

1	オブジェクト・ナビゲータで「プログラム単位」ノードを拡張します。

2	ファイルに保存するプログラム単位の [image] （PL/SQLアイコン）をダブルクリックします。

3	プログラム単位の一部をエクスポートするには、エクスポートするテキストを選択します。 テキストを選択しない場合は、プログラム単位の内容全体がエクスポートされます。

4	「ファイル」 [image] 「テキスト・エクスポート」を選択します。

5	ダイアログ・ボックスで、エクスポートされるプログラム単位のテキスト・ファイルの名前とディレクトリの場所を入力します。デフォルトでは、エクスポートされたプログラム単位には.plsというファイル拡張子が付きます。

6	「OK」をクリックします。


グループ・フィルタの作成または編集

  制限 	  関連項目

グループ・フィルタを作成または編集するには:

1	データ・モデル表示で、グループのタイトル・バーをダブルクリックして、プロパティ・パレットを表示します。

2	「グループ」ノードを拡張します。

3	グループの最初のnレコードを表示するには、「フィルタ・タイプ」プロパティを「最初」に設定し、「レコード数」プロパティをnに設定します。

4	グループの最後のnレコードを表示するには、「フィルタ・タイプ」プロパティを「最後」に設定し、「レコード数」プロパティをnに設定します。

5	PL/SQLを使用して独自のフィルタを作成するには、「フィルタ・タイプ」プロパティを「PL/SQL」に設定し、「PL/SQLフィルタ」プロパティの値フィールドをダブルクリックします。PL/SQLエディタで、フィルタのPL/SQLを定義します。

6	その他のプロパティを、目的に応じて設定します。


フォーマット・トリガーの作成または編集

  例	  関連項目

プロパティ・パレットを使用してフォーマット・トリガーを作成または編集するには:

1	ライブ・プレビューア表示で、フォーマット・トリガーを作成または編集するオブジェクトをダブルクリックし、プロパティ・パレットを表示します。注意

2	「拡張レイアウト」ノードで、値フィールド（?というラベル）をクリックしてPL/SQLエディタを表示し、フォーマット・トリガーのプロパティを設定します。

3	PL/SQLエディタで、フォーマット・トリガーのPL/SQLを定義します。

オブジェクト・ナビゲータを使用してフォーマット・トリガーを作成または編集するには:

1	オブジェクト・ナビゲータで「レイアウト・モデル」ノードを拡張した後、フォーマット・トリガーを作成または編集するオブジェクトが含まれたノードを拡張します。注意.

2	フォーマット・トリガーを作成または編集するオブジェクトの横にある [image] （PL/SQLアイコン）をダブルクリックします。

3	PL/SQLエディタで、フォーマット・トリガーのPL/SQLを定義します。


アクション・トリガーの作成または編集

  例	  関連項目

プロパティ・パレットを使用してアクション・トリガーを作成または編集するには:

1	レイアウト・モデル表示で、アクション・トリガーを作成または編集するボタン・オブジェクトをダブルクリックし、プロパティ・パレットを表示します。

2	「ボタン動作」ノードで、次の操作を行います。

•	PL/SQLに「型」プロパティを設定します。

•	値フィールド（?というラベル）をクリックしてPL/SQLエディタを表示し、「PL/SQLトリガー」プロパティを設定します。

3	PL/SQLエディタで、「名前」ドロップダウン・リストに「アクション・トリガー」が指定されていることを確認します。

オブジェクト・ナビゲータを使用してアクション・トリガーを作成または編集するには:

1	オブジェクト・ナビゲータで「レイアウト・モデル」ノードを拡張した後、アクション・トリガーを作成または編集するボタン・オブジェクトが含まれたノードを拡張します。注意.

2	フォーマット・トリガーを作成または編集するボタン・オブジェクトの横にある [image] (PL/SQLアイコン)をダブルクリックします。

3	PL/SQLエディタで、アクション・トリガーのPL/SQLを定義します。


PL/SQLインタプリタでのプログラム単位の実行

  次のステップ	 関連項目

PL/SQLインタプリタでプログラム単位を実行するには:

1	PL/SQLインタプリタが表示されていない場合は、「プログラム」 [image] 「PL/SQLインタプリタ」を選択し表示します。

2	インタプリタのPL/SQL> プロンプトからプログラム単位名を入力し、その後に終了を示すセミコロン（;）を付けます。プログラム単位に引数が必要な場合は、必ず引数をカッコで囲んで指定してください。次に例を示します。getdata(SCOTT);

3	[Enter]キーまたは[Return]キーを押すと、次のいずれかの結果になります。

•	プログラム単位によって生成された出力がコマンド・ラインに表示され、正常に実行されたことを示すPL/SQL> プロンプトが戻されます。

•	実行可能文の入力が完了していないことを示す二次プロンプト（+>）が表示されます。文末に終了のセミコロンを入力していなかった場合は入力し、[Enter]キーまたは[Return]キーを押します。それ以外の場合は、右マウスをクリックし、ポップアップ・メニューから「新規プロンプト」を選択します。

•	ランタイム・エラーがコマンド・ラインに表示された後に、PL/SQL>プロンプトが表示されます。この場合、プログラム単位の編集またはデバッグが必要です。

•	プログラム単位内にブレークポイントまたはデバッグ・トリガーを設定している場合、実行が中断され、新規プロンプトが(debug n)PL/SQL>のように表示されます。


クライアントとサーバー間のプログラム単位の移動

  関連項目

プログラム単位をサーバーに移動するには:

  デモ

1	オブジェクト・ナビゲータで、「データベース・オブジェクト」ノードをダブル・クリックします。このノードが使用不可の場合は、「接続」ダイアログが表示されるので、データベースとの接続を確立します。

2	データベースへのログインに使用したデータベース・ユーザー名に対応するサブノードを拡張し、「ストアド・プログラム単位」ノードを表示します。

3	オブジェクト・ナビゲータの「レポート」セクションで、「プログラム単位」ノードを拡張します。

4	データベースに格納するプログラム単位をクリックして、「プログラム単位」ノードから「ストアド・プログラム単位」サブノードへドラッグします。

5	マウス・ボタンを放すと、サーバー上にプログラム単位のコピーが挿入されます。

プログラム単位をクライアントに移動するには:

1	オブジェクト・ナビゲータで、「データベース・オブジェクト」ノードをクリックします。このノードが使用不可の場合は、「接続」ダイアログが表示されるので、データベースとの接続を確立します。

2	データベースへのログインに使用したデータベース・ユーザー名に対応するサブノードを拡張します。

3	「ストアド・プログラム単位」ノードを拡張します。

4	クライアントに移動するストアド・プログラム単位をクリックして、「ストアド・プログラム単位」ノードから、オブジェクト・ナビゲータの「レポート」セクションにある「プログラム単位」ノードへドラッグします。

5	マウス・ボタンを放すと、クライアント上にプログラム単位のコピーが挿入されます。


外部PL/SQLライブラリの作成

  次のステップ	  関連項目

外部PL/SQLライブラリを作成するには:

1	オブジェクト・ナビゲータで、「PL/SQLライブラリ」ノードをクリックします。

2	ツールバーの [image] をクリックします。

新しく作成したライブラリ（初期名は、LIB_xxx）が自動的にオープンします。ライブラリは、作成後、プログラム単位を挿入または削除したり、他のライブラリに連結するなどして、内容を変更することができます。


ライブラリへのプログラム単位の追加

  次のステップ	  関連項目

ライブラリにプログラム単位を追加するには:

  デモ

1	現行の状態に応じて、オブジェクト・ナビゲータで次のいずれかのステップを実行します。

•	ライブラリがオープンしている場合は、ライブラリ・ノードを拡張します。

•	ライブラリが現在オープンしていない場合は、「PL/SQLライブラリ」ノードをクリックし、「ファイル」 [image] 「オープン」を選択してライブラリをオープンします。

2	「レポート」ノードで、「プログラム単位」ノードを拡張します。

3	ライブラリの「プログラム単位」ノードの下に、ライブラリに追加するプログラム単位をドラッグします。

4	マウス・ボタンを放すと、ライブラリ内にプログラム単位のコピーが挿入されます。


ライブラリからのプログラム単位の削除

  次のステップ	  関連項目

ライブラリからプログラム単位を削除するには:

1	現行の状態に応じて、次のいずれかのステップを実行します。

•	オブジェクト・ナビゲータで、ライブラリがオープンしている場合は、ライブラリ・ノードを拡張します。

•	ライブラリが現在オープンしていない場合は、「PL/SQLライブラリ」ノードをクリックし、「ファイル」 [image] 「オープン」を選択してライブラリをオープンします。

2	ライブラリの「プログラム単位」ノードで、削除するライブラリのプログラム単位をクリックします。

3	ツールバーの [image] をクリックします。

4	メッセージ・ボックスで、「はい」をクリックします。


ライブラリ内のプログラム単位の編集

  次のステップ	  関連項目

ライブラリ内のプログラム単位を編集するには:

1	現行の状態に応じて、次のいずれかのステップを実行します。

•	オブジェクト・ナビゲータで、ライブラリがオープンしている場合は、ライブラリ・ノードを拡張します。

•	ライブラリが現在オープンしていない場合は、「PL/SQLライブラリ」ノードをクリックし、「ファイル」 [image] 「オープン」を選択してライブラリをオープンします。

2	ライブラリの「プログラム単位」ノードで、編集する [image] （ライブラリ・プログラム単位アイコン）をダブルクリックします。

3	PL/SQLエディタで、プログラム単位のPL/SQLを編集します。


ライブラリの連結

  制限	  関連項目

ライブラリを連結するには:

1	オブジェクト・ナビゲータで、「接続ライブラリ」ノードをクリックします。

2	ツールバーの [image] をクリックします。

3	ダイアログ・ボックスで、「ライブラリ」テキスト・ボックスに外部PL/SQLライブラリ名を入力するかまたは「参照」をクリックして参照する外部PL/SQLライブラリを検索します。

4	「連結」をクリックします。


すべてのプログラム単位のコンパイル

  関連項目

すべてのプログラム単位をコンパイルするには:

1	オブジェクト・ナビゲータで、すべてのプログラム単位（PL/SQLサブプログラム、レポート・トリガー、計算式、グループ・フィルタ、フォーマット・トリガーおよび妥当性チェック・トリガーを含む）をコンパイルするレポートまたはライブラリをクリックします。

2	「プログラム」 [image] 「コンパイル」 [image] 「すべて」を選択し、現行のコンパイル状態に関係なく、すべてのプログラム単位をコンパイルします。

3	「コンパイル」ダイアログ・ボックスで、任意のエラーをクリックした後、「エラーへジャンプ」をクリックしてプログラム単位内のエラー・ソースにナビゲートします。ヒント


1つのプログラム単位のコンパイル

  関連項目

1つのプログラム単位をコンパイルするには：

  デモ

1	オブジェクト・ナビゲータで、コンパイルするプログラム単位（PL/SQLサブプログラム、レポート・トリガー、計算式、グループ・フィルタ、フォーマット・トリガーおよび妥当性チェック・トリガー）をクリックします。

2	「プログラム」 [image] 「コンパイル選択」を選択し、現行のコンパイル状態に関係なく、選択したプログラム単位をコンパイルします。

3	「コンパイル」ダイアログ・ボックスで、任意のエラーをクリックした後、「エラーへジャンプ」をクリックしてプログラム単位内のエラー・ソースにナビゲートします。ヒント


すべての未コンパイル・プログラム単位のコンパイル

  関連項目

すべての未コンパイル・プログラム単位をコンパイルするには:

1	オブジェクト・ナビゲータで、すべての未コンパイル・プログラム単位（PL/SQLサブプログラム、レポート・トリガー、計算式、グループ・フィルタ、フォーマット・トリガーおよび妥当性チェック・トリガー）をコンパイルするレポートまたはライブラリをクリックします。

2	「プログラム」 [image] 「コンパイル」 [image] 「変更分」を選択し、すべての未コンパイル・プログラム単位をコンパイルします。

3	「コンパイル」ダイアログ・ボックスで、任意のエラーをクリックした後、「エラーへジャンプ」をクリックしてプログラム単位内のエラー・ソースにナビゲートします。ヒント


プログラム単位内のテキストの検索および置換

  次のステップ	  関連項目

プログラム単位内のテキストを検索および置換するには:

1	オブジェクト・ナビゲータで「プログラム単位」ノードを拡張します。

2	編集するプログラム単位の [image] （PL/SQLアイコン）をダブルクリックします。

3	PL/SQLエディタで、検索を開始する位置にカーソルを移します。

4	「編集」 [image] 「検索と置換」を選択します。

5	ダイアログ・ボックスで、検索基準を入力し、必要に応じて置換文字列を入力します。検索テキストには、テキスト文字列または正規表現のどちらかを指定できます。

6	「検索」をクリックします。

7	検索基準のインスタンスが見つかったら、「置換」をクリックして1つのインスタンスを置換する、「すべて置換」をクリックしてすべてのインスタンスを置換するまたはPL/SQLエディタにテキストを直接入力する、のいずれかを行います。

8	「検索」をクリックして次のインスタンスに進むかまたは「キャンセル」をクリックしてダイアログをクローズします。

9	プログラム単位内のすべてのテキストの置換を終了したら、「コンパイル」をクリックしてプログラム単位を再コンパイルします。ヒント

10	コードが正常にコンパイルされたら、「クローズ」をクリックします。ヒント


?


WebリンクおよびWebレポートの制限

HTMLまたはPDFファイルへのレポート出力では、OLEオブジェクトはサポートされません。


ハイパーリンクの制限

（PDF出力のみ）Webリンクのソースであるオブジェクトは、アプリケーション・コマンド・ライン・リンクに関係付けることはできません。


アプリケーション・コマンド・ライン・リンクの制限

アプリケーション・コマンド・ライン・リンクに関係付けられたオブジェクトは、Webリンク（ハイパーリンク）のソースとしては兼用できません。


?


複数の宛先へのレポートの配布

  関連項目

レポートを複数の宛先へ配布するには、次のいずれかの方法を使用して配布を定義します。

•	「配布」ダイアログ・ボックスを使用して、レポート全体またはレポートのセクション（あるいはその両方）について配布リストを定義します。

•	コマンド・ラインから、DESTINATIONキーワードを使用して.DSTファイルを指定します。注意:  .DSTファイルを使用してセクションを配布するには、出力定義でLEVELキーワードを使用する必要があります。

レポートを配布するために、次のいずれかの操作を選択できます。

•	コマンド・ラインからDISTRIBUTE=YESを指定します。

•	「ファイル」 [image] 「配布」を選択します。


ビットマップ・レポートの実行および出力

  例	  関連項目

ビットマップ式レポートを実行し送信するには:

1	レポートを選択またはオープンします。

2	まだ接続していない場合は、データベースに接続します。

3	ツールバーの [image] をクリックします。

4	ランタイム・パラメータ・フォームで、希望する出力に対する設定を指定します:  ヒント

•	スクリーン・フォントを使用したライブ・プレビューア内のプレビュー

•	プリンタ・フォントを使用したライブ・プレビューア内のプレビュー

•	スタイル・シート拡張を含めた、HTMLファイルへの出力  注意

•	HTMLファイルへの出力  注意

•	PDFファイルへの出力  注意

•	XMLファイルへの出力

•	RTFファイルへの出力  注意

•	ファイルへの出力

•	プリンタへの出力

•	他のアプリケーション（Microsoft Excelなど）にインポートするためのデリミタ付き出力

•	（Windows 95とWindows NTのみ）MAPI準拠のメール・クライアント・アプリケーションを使用した電子メール経由での出力

•	（UNIXのみ）固有のUNIXメール・アプリケーションを使用した電子メール経由での出力

•	Webブラウザによる出力の表示

5	ツールバーの [image] をクリックします。

6	ダイアログ・ボックスが表示されたら、必要な情報を入力します。

注意:

•	キャラクタ・モード環境でビットマップ式レポートを実行し印刷するには、コマンド・ラインでRWRUN60を使用します。BATCH=YESを指定して、ファイルに印刷するかまたはPostScriptプリンタなどのビットマップ式デバイスに印刷します。

•	レポート出力をPDFまたはHTMLで生成すると、「Webウィザード」プロパティまたは「チャート・ハイパーリンク」プロパティを使用して、チャートのセクションをレポート出力内の任意のオブジェクト、別のレポートまたは他の有効なハイパーリンクの宛先と関連付けることができます。


ASCII （キャラクタ・モード）レポートの実行および出力

  例	  関連項目

ビットマップ式Report Builderで、ASCII（キャラクタ・モード）レポートを実行し出力するには:

1	レポートを選択またはオープンします。

2	まだ接続していない場合は、データベースに接続します。

3	ツールバーの [image] をクリックします。

4	ランタイム・パラメータ・フォームが表示されたら、希望の出力に対する設定を指定します:  ヒント

•	スクリーン・フォントを使用したプレビュー出力

•	プリンタ・フォントを使用したプレビュー出力

•	ファイルへの出力

•	プリンタへの出力

•	他のアプリケーション（Microsoft ExcelまたはXML対応ブラウザなど）にインポートするためのデリミタ付き出力またはXMLへの出力

•	（UNIXのみ）Oracle*Mailを使用した電子メール経由での出力

•	 （Windows 95とWindows NTのみ）MAPIを使用した電子メール経由での出力

5	ランタイム・パラメータ・フォームで、ツールバー内の [image] をクリックします。

6	ダイアログ・ボックスが表示されたら、必要な情報を入力します。

注意:

•	キャラクタ・モード環境でキャラクタ・モード・レポートを実行し印刷するには、コマンド・ラインでRWRUN60を使用します。

•	レポートの印刷方向を横向きにする場合、レポートに対してプロパティ・パレット内に、ページ・サイズを設定する必要があります。ただし、使用しているプリンタで、指定したページ・サイズがサポートされていない場合、印字が欠けることがあります。横向き（または他のページ・サイズ）をサポートするキャラクタ・モード・プリンタを使用可能にするため、プリンタ定義ファイルにプリンタ・エスケープ・シーケンスを設定できます。エスケープ・シーケンスを使用する場合は、使用しているプリンタのマニュアルを参照してください。


「宛先タイプ」に「画面」を設定します。


「宛先タイプ」に「プレビュー画面」を設定します。「宛先名」には、プリンタ・ドライバの名前を入力します。


「宛先タイプ」に「ファイル」を設定します。「宛先名」には、パスおよびファイル名を入力します。「宛先フォーマット」には、HTMLCSSと入力します。MODEシステム・パラメータにBITMAPと設定されていることを確認してください。


「宛先タイプ」に「ファイル」を設定します。「宛先名」には、パスおよびファイル名を入力します。「宛先フォーマット」には、HTMLと入力します。MODEシステム・パラメータにBITMAPと設定されていることを確認してください。


「宛先タイプ」に「ファイル」を設定します。「宛先名」には、パスおよびファイル名を入力します。「宛先フォーマット」には、PDFと入力します。MODEシステム・パラメータにBITMAPと設定されていることを確認してください。


「宛先タイプ」に「ファイル」を設定します。「宛先名」には、パスおよびファイル名を入力します。「宛先フォーマット」には、RTFと入力します。MODEシステム・パラメータにBITMAPと設定されていることを確認してください。


「宛先タイプ」に「ファイル」を設定します。「宛先名」には、ファイル名を入力します。「宛先フォーマット」には、プリンタ・ドライバの名前を入力します。


「宛先タイプ」に「ファイル」を設定します。「宛先名」には、ファイル名を入力します。「宛先フォーマット」には、.prtファイルの名前を入力します。


「宛先タイプ」に「ファイル」を設定します。「宛先名」には、ファイル名を入力します。「宛先フォーマット」には、.xmlファイルの名前を入力します。


「宛先タイプ」に「プリンタ」を設定します。「宛先名」には、プリンタ・ドライバの名前を入力します。


「宛先タイプ」に「プリンタ」を設定します。「宛先名」には、プリンタ名を入力します。「宛先フォーマット」には、.prtファイルの名前を入力します。


「宛先タイプ」に「Mail」を設定します。「宛先名」には、電子メールID（例を参照）を入力します。「宛先フォーマット」には、プリンタ・ドライバの名前を入力します。


「宛先タイプ」に「Mail」を設定します。「宛先名」には、電子メールID（例を参照）を入力します。「宛先フォーマット」には、.prtファイルの名前を入力します。


「宛先タイプ」に「Mail」を設定します。「宛先名」はブランクにしておきます。「MAPI Send Mail」ダイアログで、受信者および題名（例を参照）を指定します。


コマンド・ラインからのレポートの実行

  関連項目

コマンド・ラインからrepファイル（実行ファイル）またはrdfファイル（レポート定義ファイル）を実行するには:

1	ORACLE_HOME\BIN\RWRUN60を入力した後、テキスト・ファイルを指定します。

2	バッチ･モードでレポートを実行し、ファイルに出力を送信した場合（DESTYPE=file DESNAME=filename BATCH=yes）は、そのファイルをオープンまたは印刷して出力を確認します。


コマンド・ファイルを使ったレポートの実行

  関連項目

コマンド・ファイルを使用してレポートを実行するには:

1	選択したワード・プロセッサを使用して、レポート名と希望する引数を指定したテキスト・ファイルを作成します。

2	ORACLE_HOME\BIN\RWRUN60を入力した後、テキスト・ファイルを指定します。

3	バッチ・モードでレポートを実行し、ファイルに出力を送信する場合（DESTYPE=file DESNAME=filenameBATCH=yes）は、そのファイルをオープンまたは印刷して出力を確認します。


リモートReports Serverへのレポートの実行

  関連項目

リモートのReports Server（RWMTS60）に対してレポートを実行するには:

  ORACLE_HOME\BIN\RWCLI60に続けて、レポート名、サーバー名および必要な引数を入力します。

『パブリッシング・レポート』にはさらに詳しい情報が記載されています。この文書のHTML版を表示するには:

•	Oracle Information Navigatorで、「ヘルプ」 [image] 「マニュアル」を選択します。


Form BuilderまたはGraphics Builderからのレポートの実行

次のいずれかを使用し、必要に応じてデータおよびパラメータをレポートに送って、Form BuilderまたはGraphics Builderからレポートを実行できます。

•	Reports Server実行可能プログラム（RWMTS60）。これにより、リモート・サーバー上でのレポートの実行をスケジューリングしたり、管理したりすることが可能になります。Reports Serverにレポートを送るには、RWCLI60を使用します。

•	（Windows環境のみ）Reports Background Engine（RWRBE60）。レポートをローカルで実行するためのコマンド・ラインを待ち、キューに並べます。一般に、Reports Background Engineでは、RUN_PRODUCTパッケージ・プロシージャからまたはSRW.RUN_REPORTを使用してレポートからコマンド・ラインを受け取ります。

複数のレポート・オブジェクトを1つのフォーム内で作成し、そこでレポートの実行に使用するコマンド・ライン引数を指定することもできます。詳細は、Form Builderオンライン・ヘルプを参照してください。


バッチ・モードでのレポートの電子メール送信（Windows上）

  例	 関連項目

バッチ・モードでレポートを電子メール送信するには:  注意

1	MAPI準拠のメール・クライアント・アプリケーションを使用して、メール・システムにログインします。

2	BATCH =yes、DESTYPE=mail、そして DESNAME=recipient1、recipient2、recipient3等を指定して、コマンド・ラインからレポートを実行します。


Report Builderからのレポートの電子メール送信（Windows上）

  例	 関連項目

最初にプレビューをしないで、Report Builderからレポートをメール送信するには:

1	MAPI準拠のメール・クライアント・アプリケーションを使用して、メール・システムにログインします。

2	レポートを選択またはオープンします。

3	まだ接続していない場合は、データベースに接続します。

4	「ファイル」 [image] 「メール」を選択します。

5	ランタイム・パラメータ・フォームで、「宛先タイプ」を「Mail」に設定します。「宛先名」の値はブランクのままにしておきます。

6	ツールバーの [image] をクリックします。

7	「メール」ダイアログ・ボックスで、電子メール・レポートの受信者および題名を指定します。

プレビュー後にReports Builderからレポートをメール送信するには:

1	MAPI準拠のメール・クライアント・アプリケーションを使用して、メール・システムにログインします。

2	レポートを選択またはオープンします。

3	まだ接続していない場合は、データベースに接続します。

4	ツールバーの [image] をクリックします。

5	ランタイム・パラメータ・フォームで、「宛先タイプ」を「プレビュー画面」に設定します。「宛先名」の値はブランクのままにしておきます。ヒント

6	ツールバー内の [image] をクリックして、ライブ・プレビューア内にレポートを表示します。

7	（オプション） ランタイム・プレビューア内にレポートの出力を表示します。

8	ツールバー内の [image] をクリックします。

9	ダイアログ・ボックス内で、レポートの受取人と題目を指定します。


印刷方向の変更

  関連項目

レポート・セクションの方向（縦または横）を変更するには:

1	オブジェクト・ナビゲータ内で、「レイアウト・モデル」ノードを拡張し、セクションのノード（デフォルトでは、レポートはメイン・セクションで定義されています）をクリックします。次に、「ツール」 [image] 「プロパティ・パレット」を選択します。

2	プロパティ・パレットの「セクション」ノードで、次の操作を行います。

•	「幅」プロパティおよび「高さ」プロパティを目的に応じて設定します（たとえば、横向きで幅11（または15）×高さ8.5または縦向きで幅8.5×高さ11（または15））。

•	「印刷方向」プロパティに希望の値を設定します。

3	実行時に印刷方向を変更する場合は、「ツール」 [image] 「Parameter Form Builder」を選択して、パラメータ・フォーム作成を表示します。

•	「印刷方向」システム・パラメータをクリックします。

•	「OK」をクリックし、「パラメータ・フォーム表示」を表示します。

•	「印刷方向」値フィールド（PF_ORIENTATION）をダブルクリックして、プロパティ・パレットを表示します。

•	「パラメータ」ノードの「初期値」プロパティを「縦」または「横」に設定します。

•	ツールバーの [image] をクリックします。

•	「印刷方向」ドロップダウン・リストで、必要に応じて方向を変更します。


印刷済みフォームへのレポート印刷

  関連項目

印刷済みフォームにレポートを印刷するには:

1	フォーム上のフィールドの位置と長さを正確に計測します。

2	まだ計測していなければ、データ・モデルを使用して、フォーム上に出力するプライマリ・データ用のレポートを生成します。

3	レイアウト・モデル内で、 ツールバーの [image] をクリックしてマージン領域を表示します。注意

4	マージンの境界線をクリックした後、上下の枠へハンドルをドラッグし、上下のマージンを削除します。

5	ツールバー内の [image] をクリックして、レポートのボディ領域をアクティブにします。

6	フォームに別のデータ・フォーマット（たとえば、メール・ラベル・フォーマットの後に表フォーマットが付いたもの）が必要な場合は、追加するフォーマットごとに別のレイアウトを作成します。

7	フォーム上のフィールドに収まるようにするには、列幅を変更します。

8	フォームのフォーマットにオブジェクトを移動し、サイズ変更します。


ランタイム・プレビューアでのレポート出力の表示

  関連項目

ランタイム・プレビューアにレポート出力を表示するには:

1	ライブ・プレビューア内で、「表示」 [image] 「ランタイム・プレビュー表示」を選択します。

2	ランタイム・プレビューアで、次のいずれかの機能を使用します。

•	スクロールおよびページング

•	水平方向および垂直方向の分割

•	出力の拡大または縮小

•	複数ランタイム・プレビューアのオープン


ライブ・プレビューアでのレポート出力の表示

  関連項目

ライブ・プレビューアにレポート出力を表示するには:

  ライブ・プレビューア表示内で、次の機能を使用します。

•	スクロールおよびページング

•	水平方向および垂直方向の分割

•	出力の拡大または縮小


スクロールおよびページング

スクロール・バーおよびページング・ボタンを使用して、レポートのページ間を移動するには:

•	マウス・カーソルを使用して、水平および垂直スクロール・バーをドラッグし、現行のページ内を移動します。

•	ツールバーで [image] および [image] 、 [image] 、 [image] をクリックして、レポートの指定したページを表示します。

•	特定のページを表示するには、「ページ」フィールドにページ番号を入力します。


ランタイム・プレビューア表示領域の分割

ライブ･プレビューアの表示領域で、水平、垂直の方向に表示領域を分割し、レポート出力を2つ表示するには:  注意

1	垂直スクロール・バーの上のボックスをドラッグ（水平に分割）するかまたは水平スクロール・バーの左のボックスをドラッグ（垂直に分割）します。

2	表示領域を分割する位置で、マウス・ボタンを放します。

各表示内でスクロールおよびページングができるので、他方の表示を変えずに、一方の表示の内容を動かせます。


表示領域を、水平と垂直の両方向に同時に分割することはできません。


ライブ・プレビューアの表示領域の分割

ライブ・プレビューアの表示領域を、水平または垂直の両方向（あるいはそのいずれかの方向）に分割して、レポート出力を2つ表示するには:

1	垂直スクロール・バーの最下部にある「黒いバー」を、垂直スクロール・バー（水平に分割する場合）の上にドラッグするか、または水平スクロール・バー（垂直に分割する場合）の左にドラッグします。

2	表示領域を分割する位置で、マウス・ボタンを放します。

各表示内でスクロールおよびページングができるので、他方の表示を変えずに、一方の表示の内容を動かせます。


出力の拡大または縮小

レポートの見づらい部分を拡大したり、レポート全体のレイアウトの印象を見るために縮小するには:

•	表示領域に表示された出力を拡大するには、ツールバーの [image] をクリックします。

•	出力の表示サイズを縮小するには、ツールバーの [image] をクリックします。


複数のランタイム・プレビューアのオープン

現行のランタイム・プレビューアと同じ内容で、新しいランタイム・プレビューアをオープンするには:

•	ツールバーの [image] をクリックします。


ランタイム・プレビューアからのレポートの印刷

  関連項目

ランタイム・プレビューアからレポートを印刷するには:

1	プリンタの設定を調べるには、ランタイム・プレビューア内で、ツールバーの [image] をクリックします。

2	ツールバー内の [image] をクリックします。

3	ダイアログ・ボックスで、印刷範囲と印刷部数を入力します。

DESTYPE=SCREENでレポートを実行すると、印刷前にレポートをDESTYPE=PREVIEWで実行するように求める警告が表示されます。DESTYPE=PREVIEWでは、PostScript出力が生成されます。これは、ビットマップ・レポートには特に必要になります。

4	「OK」をクリックします。


ライブ・プレビューアからのレポートの印刷

  関連項目

ライブ・プレビューアからレポートを印刷するには:

1	ライブ・プレビューア表示内で、ツールバーの [image] をクリックします。

2	ダイアログ・ボックスで、印刷範囲と印刷部数を入力します。

ランタイム・パラメタ・フォームで「DESTYPE」に画面を指定しレポートを実行した場合、「印刷する前に、プレビュー画面の「DESTYPE」でレポートを実行してください」という警告が表示されます。DESTYPE=PREVIEWでは、PostScript出力が生成されます。これは、ビットマップ・レポートには特に必要になります。

3	「OK」をクリックします。


Webブラウザからのレポートの印刷

  関連項目

Webブラウザからレポートを印刷するには:

1	レポートがHTMLスタイル・シート拡張(HTMLCSS)でフォーマットされている場合は、レポートの割付方法と同じ方法でHTMLドキュメントを印刷するようにブラウザを設定します:注意

•	ブラウザ内で、「ファイル」 [image] 「ページ設定」を選択して、マージン設定を適宜設定します。

•	プロパティ・パレット.を表示するには、オブジェクト・ナビゲータでレポートの [image] （プロパティ・アイコン）をダブルクリックします。

•	マージンの大きさ以外の、「幅」および「高さ」のプロパティを適宜設定します（たとえば、左右上下のマージンが25で、8.5×11のページの場合は、「幅」を8、「高さ」を10.5に設定）。

2	ブラウザでレポート出力を表示します。

3	「ファイル」 [image] 「印刷」を選択します。


プリンタ・トレイの切替え

  関連項目	  例

プリンタ・トレイを切り替えるには:

1	「ファイル」 [image] 「Page Setup」を選択し、プリンタに定義しているプリンタ・トレイの名前を書き込みます。

2	希望するトリガーを定義するには、SRW.SET_PRINTER_TRAYを使用します。

•	レポートがフォーマッティングを開始する前に、プリンタ・トレイを変更するには、Report前トリガーを作成します。注意

•	レポートのページ間でプリンタ・トレイを変更するには、Between Pagesトリガーを作成します。

•	特定のオブジェクトでのぺージ印刷には、そのオブジェクトに対してフォーマット・トリガーを作成して、プリンタ・トレイを変更します。


Webブラウザでのレポート出力の表示

  関連項目

Webブラウザでレポート出力を表示するには:

1	レポートを選択するかオープンし、続いてツールバーの [image] をクリックしてレポートを実行します。

2	ライブ・プレビューア表示で、次の方法で出力形式を指定します。

•	HTML出力用にレポートをフォーマットするには、「表示」 [image] 「Webプレビュー」 [image] 「HTMLを使用」を選択します。

•	スタイル・シート拡張（HTMLCSS）を含めてHTML出力用にレポートをフォーマットするには、「表示」 [image] 「Webプレビュー」 [image] 「HTMLスタイル・シートを使用」を選択します。注意

•	PDFファイルに出力するには、「表示」 [image] 「Webプレビュー」 [image] 「PDFを使用」を選択します。

•	XML出力用にレポートをフォーマットするには、「表示」 [image] 「Webプレビュー」 [image] 「XMLを使用」を選択します。

3	次の方法で、表示する出力範囲を指定します。

•	レポートの現在のページのみを表示するには、「表示」 [image] 「Webプレビュー」 [image] 「現在のページを表示」を選択します。

•	すべてのページを表示するには、「表示」 [image] 「Webプレビュー」 [image] 「すべてのページを表示」を選択します。注意: レポート出力のすべてのページを表示することを選択し、HTMLページ・ストリームを変更可能にした場合、最初のページがWebブラウザに表示され、レポート内の他のページにすばやく移動できるようになります。

4	「表示」 [image] 「Webプレビュー」 [image] 「Webブラウザへの生成」を選択します。注意

5	レポート出力をHTMLまたはPDFファイルとして保存するには、Webブラウザで「ファイル」 [image] 「別名で保存」を選択します。


スタイル・シート拡張を含むフォーマットは、HTMLドキュメントをレポートのページ割付と同じ方法で割り付けます。スタイル・シート拡張のないフォーマットは、レポートのページ間を分割しないHTML出力を生成します。


HTMLレポート出力の個別ページの表示

 関連項目

レポートのHTML出力ページをストリーム化するには:

1	次のいずれかの方法を使用して、HTMLページ・ストリーム出力のナビゲーション・コントロールを指定します。

•	Reportプロパティ・パレットの使用

•	PL/SQLの使用

2	コマンド・ラインからPAGESTREAM=YESを指定してレポートを実行することにより、HTMLページ・ストリームを使用可能にします。


?


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


「ページ後値」は、文書の1つのページまたは全てのページの最後に表示させる任意のテキスト、グラフィックス、あるいはHTMLコマンドを指定する属性です。


「レポート後値」は、文書の最後に表示させる任意のテキスト、グラフィックス、あるいはHTMLコマンドを指定する属性です。


「レポート後値」は、「Before Reportトリガー」のように、レポートがフォーマットされる前に起動するトリガー内で設定される必要があります。


「フォーム後値」は、HTMLパラメータ・フォームの下に表示させる任意のテキスト、グラフィックスまたはHTMLコマンドを指定する属性です。


「フォーム後値」は、「パラメータ前フォーム・トリガー」のように、パラメータ・フォームがフォーマットされる前に起動するトリガー内で設定される必要があります。


オブジェクトは、1個に限り他のオブジェクトにアンカーされることがあります。


編集が膨大な場合、コンパイルする必要はなく、「適用」をクリックして、変更分を保存することができます。


プラットフォーム間での移植性を良くするために、PostScriptバーコード・フォントを使用することによって、レポートをPostScriptの使用可能な任意の出力装置で印刷できます。


「ページ前値」は、文書の最初に表示させる任意のテキスト、グラフィックス、あるいはHTMLコマンドを指定する属性です。


エスケープ（ページ前値やページ後値）をレポートのすべてのページに適用する場合は、「Before Reportトリガー」のように、レポートがフォーマットを開始する前に、起動するトリガーの中でエスケープを指定する必要があります。1ページにのみエスケープを使用する場合は、「フォーマット・トリガー」内で設定します。


「レポート前値」は、文書の最初に表示させる任意のテキスト、グラフィックス、あるいはHTMLコマンドを指定する属性です。


「レポート前値」は、「Before Reportトリガー」のように、レポートがフォーマットを開始する前に起動するトリガー内で設定される必要があります。


「フォーム前値」は、HTMLパラメータ・フォームの上に表示させる任意のテキスト、グラフィックスまたはHTMLコマンドを指定する属性です。


「フォーム前値」は、「パラメータ前フォーム・トリガー」のように、パラメータ・フォームがフォーマットを開始する前に、起動するトリガー内で設定される必要があります。


サブプログラムの本体は、仕様と同じ情報を含んでいます。 さらにまた、サブプログラムの実際の実現内容（たとえば、アクションのシーケンス）も含んでいます。ほとんどの場合、1つのサブプログラムには、本体を1つのみ定義する必要があります。


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


その数値と#は、ブックマーク領域には表示されません。


コンパイルされなかったプログラム単位は、名前の後にアスタリスク（*）を付けて示されます。


複数のプログラム単位内のテキストを置換する場合、置換を終了した後すぐにそれらを再コンパイルできます。


レポートを作成するとき、ランタイム・パラメータ・フォームに表示させるシステム・パラメータを選択するには、Parameter Form Builder（「ツール」 [image] 「Parameter Form Builder」）を使用する必要があります。


テンプレート内でパラメータを定義する場合、ランタイム・パラメータ・フォームに対するそのパラメータを選択するためには、レポートに対してテンプレートを適用する必要があります。


ツールをダブルクリックすると、キャンバス上でクリックするたびに新しいオブジェクトが生成されます。他のツールをクリックするまで、そのツールが選択されたままになります。をクリックしてモードをリセットします。


文の最後のセミコロンの付け忘れまたは綴りの誤った構文をチェックします。


アイコンをクリックして、ノードを拡張します。アイコンをクリックしてノードを縮小します。


ファンクションは、指定された一連のアクションを実行して、値を返すPL/SQLサブプログラムです。


ハイパーテキスト・リンクをテストするには、レポートの出力結果をHTMLファイルに送り、Webブラウザ内に表示させます。


ハイパーリンクは、次の宛先のどちらかへのリンクを指定する、オブジェクトの属性です。

•	同じレポート内のハイパーリンク先によって識別されるオブジェクト

•	同じマシン上か、リモートWebサーバー上にある別のHTMLドキュメントまたはPDFドキュメント

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


ハイパーテキスト・リンクをテストするには、レポートの出力結果をHTMLまたはPDFファイルに送り、Webブラウザ内に表示させます。


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


レイアウト・モデル表示内で、このタスクを実行することも可能です。


ライブ・プレビューア表示とパラメータ・フォーム表示内で、作図ツールを使用することも可能です。


レイアウト・モデル表示内で、このタスクを実行することも可能です。マージンを表示させるには、ツールバー内の [image] をクリックします。ツールバー内の [image] をクリックして、レポートのボディ領域をアクティブにします。


このタスクは、レイアウト・モデル表示またはパラメータ・フォーム表示内で実行することも可能です。


このタスクは、ライブ・プレビューア表示またはパラメータ・フォーム表示内で実行することも可能です。


また、パラメータ・フォーム表示内で、このタスクを実行することも可能です。


BATCH=yesを使用すると、Report Builderはブランクの題名とccリストを使用します。題名およびccリストを指定するには、BATCH=noを使用して（対話的に）実行する必要があります。


電子メールのIDをダブル・クオートで囲み、それらをカンマで区切ります。


"O'Hara"のように2個のシングル・クオートを使用します。


マージン領域は、それをボディから区分している太い黒線で定義されます。マージン領域を表示しながら、レポートのボディ部分にオブジェクトを作成する場合、マージン領域が表示されているときには、これらのオブジェクトの編集しかできません。


パッケージは、関連するプロジージャ、関数、変数、そして他のパッケージ・コンストラクトをデータベース内で1つのユニットとして、一括してカプセル化して格納する手法です。パッケージにより、データベース管理者やアプリケーション開発者の、編集作業が容易になると同時に、機能性とデータベースのパフォーマンスも向上します。


Adobe Acrobat Readerのように、PDFファイルを表示できるスタンドアロンまたはプラグインの読取り装置です。


PDF形式のレポート出力は、ハイパーリンクとアプリケーション・コマンド・ライン・リンクの両方をインクルードできます。「アプリケーション・コマンド・ライン」プロパティがオブジェクトに設定されている場合は、そのプロパティがオブジェクトに適用されます。それ以外の場合は、「ハイパーリンク」プロパティが適用されます。


さらに、オブジェクト・ナビゲータを介して、グループ・フィルタに対するPL/SQLにアクセスすることも可能です（「グループ」ノードまたは「プログラム単位」ノードの下で）。


プロパティ・パレット内でプロパティについてのヘルプを見るには、プロパティをクリックして[F1]を押します。


プロジージャは、指定された一連のアクションを実行するPL/SQLサブプログラムです。


問合せ、グループ、繰返し枠、枠、フィールド、マトリクス・オブジェクト、そしてボイラープレートのサイズを変更することが可能です。アンカーするオブジェクトの1つを移動すると、アンカーは自動的にサイズ変更されます。


複数のオブジェクトを選択するには、1個のオブジェクトをクリックして、次に他のすべてのオブジェクトを[SHIFT]キーを押しながらクリックします。すべてのオブジェクトを選択するには、「編集」 [image] 「すべて選択」を選択します。


レポート出力に表示させる順に、列を選択します。


名前によって繰返し枠を選択するには、オブジェクト・ナビゲータ内の「レイアウト・モデル」ノードの下で、「ボディ」ノードを拡張します。


名前によってフィールド選択するには、オブジェクト・ナビゲータ内の「レイアウト・モデル」ノードの下で、「ボディ」ノードを拡張します。


プログラム単位仕様は、サブプログラムの名前、パラメータ、そしてReturnタイプ（関数のみに適用される）を定義します。


すべてのオブジェクトから境界線を削除するために「編集」 [image] 「すべて選択」を選択する場合、列ヘッダーの下の下線も一緒に削除することになります。下線を追加するには、下線オブジェクト（この時点では非表示）をクリックし、線カラー・ツール・パレットを使用して下線のカラーを選択します。


テンプレートを定義する場合、マージン内のオブジェクトを選択できます。ボディ内のオブジェクトは、テンプレートがレポートに適用されるまでは不明です。


テンプレートを定義する場合、マージン内のレイアウト・オブジェクトを作成できます。テンプレートのこれらの領域を表示させるには、 [image] 、 [image] または [image] をクリックします。


電子メールのIDをダブル・クオートで囲み、それらをカンマで区切ります。


HTML 3.0準拠のブラウザ（たとえば、Netscape 2.2）。


開始、終了、NULLまたはコメントの上にブレークポイントは置けません。


開始、終了、NULLまたはコメントの上に「デバッグ・トリガー」は置けません。


終了のセミコロン（;）および任意の引数を忘れないでください。


複数のプログラム単位をバッチでコンパイルするには、「ナビゲータ」 [image] 「コンパイル」または「プログラム」 [image] 「コンパイル」を使用します。


ライブラリの位置と名前がはっきりしない場合は、「検索」を選択して、ディレクトリ構成またはデータベース・ネームスペースを参照します。


コマンド行で二次プロンプト（+>）が表示される場合、コマンド行の最後のセミコロンを忘れている可能性があります。二次プロンプトでそれを入力してから、もう一度[Return]キーまたは[Enter]キーを押してください。


ブロックは、PL/SQLにおける基本的なプログラム単位であり、DECLARE、BEGIN、EXCEPTION、ENDといったキーワードによって定義されます。


ソース・プログラムを、バイナリの実行可能な形式に変換すること。PL/SQLプログラム単位は、実行する前にコンパイルする必要があります。


レイアウトは、エディタの領域であり、その中でオブジェクトのグラフィック表示を見ながら、オブジェクトを生成、変更、配置または削除することができます。


ライブラリは、ファイルまたはデータベース内にまとめて格納される1個または複数のPL/SQLプログラム単位の集合体であり、複数のアプリケーションから同時に参照可能です。


ロード・パスは、Procedure Builderが検索パスとして使用するディレクトリ位置の集合です。


ネストされたのサブプログラムは、他のプログラム単位の内部からコールされるプログラム単位です。


ノードは、「オブジェクト・ナビゲータ」オブジェクト階層内の特別な位置です。ノードは、他のオブジェクトへのクロス・リファレンスなどのオブジェクトの情報を表示するために拡張できます。


ペインは、その中で作業が行われるエディタの特別な部分で、通常、サイズが可変です。


PL/SQLは、条件分岐のような手続き型プログラム構造を提供するSQLの拡張言語です。


プログラム単位は、パッケージのようにPL/SQLを使用して生成することが可能なコード構造、あるいはプロシージャまたは関数のようなサブプログラムです。


問合せは、1つ以上の表、あるいはデータベースのビューから検索するデータを指定するSQL SELECT文です。


レコードは、SELECT文によってフェッチされるデータの集合です。


スキーマは、関連づけられたオブジェクトの集合です。データベースの各ユーザーは、同じ名前のスキーマを持っています。


セッションは、実行可能ファイルの起動から停止までの時間です。


ソースは、サブプログラムまたはパッケージで提供されるPL/SQL文から構成されています。プログラム単位のソース・コードを持っていなければ、それを実行可能な形にコンパイルすることはできません。


文は、条件分岐、宣言、シーケンス制御、エラー処理に対応するPL/SQL構造です。各PL/SQL文の最後には、必ずセミコロン（;）を付ける必要があります。


格納されたプログラム単位は、Oracle7 Server内で実行されるプロシージャ、関数またはパッケージです。


表、フォーム形式、メール・ラベル、フォーム・レター


左グループ、上グループ、マトリックス、グループのマトリックス


プロパティ・パレット内で、

•	「スタイル」ノードで、選択された枠ノードのプロパティを設定します。

•	「ラベル」ノードで、選択されたラベル・ノードのプロパティを設定します。

•	「フィールド」ノードで、選択されたフィールド・ノードのプロパティを設定します。


トリガーは、特別なイベントと同時に実行または"起動"されるPL/SQLプロシージャです。


変数は、値が割り当てられて、さらに割り当てられた値が時間がたつと変化する、名前付きのオブジェクトです。


リンクは常に、親グループから子の問合せに対して設定されます。


レポートのデータ・モデル・ウィンドウを表示するには、オブジェクト・ナビゲータ内で、 [image] （「データ・モデル」ノード・アイコン）をダブルクリックします。他のウィンドウ内では、「表示」 [image] 「データ・モデル」を選択するかまたはツールバー内の [image] をクリックします。


レポートのレイアウト・モデル・ウィンドウを表示するには、オブジェクト・ナビゲータ内で [image] （「レイアウト・モデル」ノード・アイコン）をダブルクリックします。他のウィンドウ内では、「表示」 [image] 「レイアウト・モデル」を選択するか、ツールバー内の [image] をクリックします。


テンプレートのレイアウト・モデル・ウィンドウを表示するには、オブジェクト・ナビゲータ内で [image] （「レイアウト・モデル」ノード・アイコン）をダブルクリックします。


レポートのライブ・プレビューアを表示するには、オブジェクト・ナビゲータ内で、 [image] （「ライブ・プレビューア」ノード・アイコン）をダブルクリックします。他のウィンドウ内では、「表示」 [image] 「ライブ・プレビューア」を選択するかまたはツールバー内の [image] をクリックします。


レポートのパラメータ・フォーム表示を表示するには、オブジェクト・ナビゲータ内で、 [image] （「パラメータ・フォーム」ノード・アイコン）をダブルクリックします。他のウィンドウ内では、「表示」 [image] 「パラメータ・フォーム」を選択するかまたはツールバー内の [image] をクリックします。


ランタイム・プレビューアを表示するには、ライブ・プレビューア表示内で、「表示」 [image] 「ランタイム・プレビューア」を選択します。


生成した任意のパラメータは、自動的に選択されます。 ランタイム・パラメータ・フォーム内にシステム・パラメータを表示する場合は、パラメータ・フォーム内でそれらを選択する必要があります。


ページ設定内で指定されたプリンタ・トレイが、デフォルトのプリンタ・トレイとして使用されます。 このデフォルトを変更するには、「Before Reportトリガー」を生成します。


タイプしたテキストは、HTML出力用としてのみフォーマットされます。 他の出力形式に対しては、レポート内にテキスト・オブジェクトが表示されます。


レポート・ウィザードとデータ・ウィザードは、グループ・レポートに対し、ユーザーが定義する各サマリー列のデータ・モデル内にn個のサマリー・フィールドを作成します。集計中の列の上にあるグループ・レベルごとに1つおよびレポート・レベルに1つ作成します。たとえば、レポートが部署別にグループ分けられ、さらに課別にグループ分けられる場合、給与合計について定義されたサマリー列によって、各部署および各課グループの給与小計（グループ・レベル・サマリー）および全給与の小計（レポート・レベル・サマリー）のフィールドが作成されます。


このオプションがすでにチェックされていると、Report Builderはユーザーがレポートを実行する際にデフォルトのWebブラウザ内にレポートを自動的に表示します。


レポート出力をOffice 95のMicrosoft Wordに表示する場合、レポート内のすべての描画とオブジェクトを見るには「表示」 [image] 「ページ・レイアウト」を選択する必要があります。


また、レポート出力をWebブラウザに自動的に表示し、その後一時ファイルをHTMLまたはPDFファイルとして保存できます。この項目の最上部の「関連項目」ボタンをクリックすると、「Webブラウザでのレポート出力の表示」にリンクします。


ノードは、選択されたレポート・スタイルに必要な最低数まで削除することができます。


セクションはレポート内でグループにマップされています。詳細は、この項目の最上部の「関連項目」ボタンをクリックし、リンク先の「テンプレート属性について」を参照してください。テンプレートの属性について


Oracle Reportsでは、列オブジェクトを含む問合せ間のデータ・リンクはサポートしていません。そのようなリンクを作成しようとすると、メッセージ・ダイアログ・ボックスが表示され、グループ間の問合せ（親グループを使用して）を代わりに作成するか、操作を取り消すかを選択します。任意のタイプの列と列オブジェクトの間でリンクを作成する場合は、適切な列エイリアスを使用してSQL文を手動で入力できます。


列間のリンクを作成すると、Report BuilderによってWHERE句が問合せに追加されます。


グループ間のリンクを作成すると、Report BuilderによってWHERE句が問合せに追加されることはありません。


「デリミタ付き出力出力」ダイアログ・ボックスを表示するには、「ファイル」 [image] 「ファイル出力」 [image] 「デリミタ付き出力」を選択します。


レポート出力内のデータは、ボイラープレート・オブジェクトまたはフィールド・オブジェクトのインスタンスです。


イメージ、チャートおよびOLEの各オブジェクトは、デリミタ付き出力には表示されません。


チャート・ハイパーリンク機能を使用するには、チャートが繰返し枠内にあることを確認する必要があります。


Webウィザードを使用してチャート・ハイパーリンクを指定すると、Report Builderによって、関連のあるオブジェクトに対して「ハイパーリンクの宛先」プロパティが自動的に設定されます。このハイパーリンクの宛先を変更する場合は、「チャート・ハイパーリンク」プロパティを更新して、宛先とオブジェクト間のリレーションを維持する必要があります（詳細は「チャート・ハイパーリンク」プロパティのヘルプを参照してください）。


「配布」ダイアログ・ボックスを表示するには、レポートまたはセクションのプロパティ・パレットの「標準レイアウト」ノードで、「配布」値フィールド（...ラベル）をダブルクリックします。


「ランタイム・トレース設定」ダイアログ・ボックスを表示するには、「ツール」 [image] 「トレース」を選択します。


「作業環境」ダイアログ・ボックスを表示するには、「ツール」 [image] 「作業環境」を選択します。


デフォルトのページ・ナビゲーション・コントロール値を変更しない場合、出力ページ間のナビゲーションをインプリメントするための、デフォルトのビルトインJavaScriptが、Report Builderによって使用されます。


パラメータの値を設定するのに式列は使用できません。


?


Developer/2000 Reports Taskのヘルプ


キュー・カード

  キュー・カードのトピック


テンプレートの作成

  関連項目

テンプレートを作成するには:

1	オブジェクト・ナビゲータ内で「テンプレート」ノードをクリックし、次にツールバー内の [image] をクリックします。

2	すべてのレポート・スタイルに対してデフォルト・テンプレート属性を定義します。

3	（オプション）選択されたレポート・スタイルに対してオーバーライド・テンプレート属性を定義します。

4	テンプレートのシステム・パラメータ、ユーザー・パラメータ、プログラム単位、連結ライブラリおよびレポート・トリガーを定義するには、オブジェクト・ナビゲータ内で関連するノードをダブルクリックします。


デフォルト・テンプレートの属性の定義

  関連項目

すべてのレポート・スタイルに適用されるテンプレート内のレポート・オブジェクトに、デフォルト属性を定義するには:

1	オブジェクト・ナビゲータで「レイアウト・モデル」ノードを拡張した後、順次「ボディ」ノード、「デフォルト」ノードを拡張します。

2	レポート・スタイルの全般的なレイアウトおよび間隔に対するデフォルト・プロパティを変更するには、「デフォルト」ノードの横の [image] （プロパティ・アイコン）をダブルクリックして、プロパティ・パレットを表示します。

3	枠、フィールドのラベル/ヘッダー、フィールド、サマリー・ラベルおよびサマリーのデフォルト・プロパティを変更するには、「デフォルト」ノードを最大に拡張し、プロパティ・アイコンをダブルクリックしてプロパティ・パレットを表示します。

注意:  レイアウト・モデル表示は、オブジェクト・ナビゲータと同期をとっています。 レイアウト・オブジェクトを選択すると、関連するノードがオブジェクト・ナビゲータ内で強調表示されます。レイアウト・オブジェクトの親枠を選択するには、オブジェクトをクリックし、続いてツールバーの [image] （「親枠を選択」）をクリックします。

4	テンプレート定義を表示するには、テンプレート・エディタのレイアウト・モデル表示を表示します。個々のレポート・スタイルのレイアウトを表示するには、「レポート・スタイル」ドロップダウン・リストから選択します。

5	現在表示されているレポート・スタイルをさらに変更するには、オブジェクト・ナビゲータに戻るか、またはオブジェクトをダブルクリックしてプロパティ・パレットを表示します。個々のレポート・スタイルに加える変更は、「デフォルト」ノードで定義されている属性を上書きすることに注意してください。


上書きテンプレートの属性の定義

  関連項目

選択されたレポート・スタイルに、上書きテンプレート属性を定義するには:

1	オブジェクト・ナビゲータで「レイアウト・モデル」ノードを拡張した後、順次「ボディ」ノード、「上書き」ノード、上書きを定義するレポート・スタイルのノード（たとえば、「表」、「グループ左」）を拡張します。

2	選択されたレポート・スタイルのセクションの全般的なレイアウトと間隔のデフォルト・プロパティを変更するには、「セクション（レベルn）」ノードの横の [image] （プロパティ・アイコン）をダブルクリックし、「プロパティ・パレット」を表示します。

3	特定のレポート・スタイルに対しデフォルトの数より多いセクションを作成するには、「セクション（レベルn）」ノードをクリックし、続いてツールバーの [image] をクリックします。

4	特定のレポートのあるセクションを削除するには、「セクション（レベルn）」ノードをクリックし、続いてツールバーの [image] をクリックします。注意

5	上書きを定義するセクションごとに、「セクション（レベルn）」ノードを最大に拡張し、プロパティ・アイコンをダブルクリックして、枠、フィールドのラベル/ヘッダー、フィールド、サマリー・ラベルおよびサマリーのプロパティ・パレットを表示します。

注意:  レイアウト・モデル表示は、オブジェクト・ナビゲータと同期をとっています。 レイアウト・オブジェクトを選択すると、関連するノードがオブジェクト・ナビゲータ内で強調表示されます。レイアウト・オブジェクトの親枠を選択するには、オブジェクトをクリックし、続いてツールバーの [image] （「親枠を選択」）をクリックします。

6	テンプレート定義を表示するには、テンプレート・エディタのレイアウト・モデル表示を表示します。個々のレポート・スタイルのレイアウトを表示するには、「レポート・スタイル」ドロップダウン・リストから選択します。

7	現在表示されているレポート・スタイルをさらに変更するには、オブジェクト・ナビゲータに戻るか、またはレイアウト・オブジェクトをダブルクリックしてプロパティ・パレットを表示します。個々のレポート・スタイルに加える変更は、「デフォルト」ノードで定義されている属性を上書きすることに注意してください。


テンプレートへの項目およびオブジェクトの追加

  次へ	  関連項目

テンプレートに項目およびオブジェクトを追加するには:

1	テンプレート・エディタのレイアウト・モデル表示内で、ツールバーの [image] をクリックします。

2	「次へ」の項目を参照して、テンプレートのマージンにオブジェクトを作成します。テンプレートのボディでは、オブジェクトを作成できません。


テンプレート内のオブジェクトの変更

  次へ	  関連項目

テンプレートのマージン内でオブジェクトを変更するには:

1	テンプレート・エディタのレイアウト・モデル表示で、ツールバーの [image] をクリックします。

2	「次へ」の項目を参照して、テンプレートのマージンのオブジェクトを変更します。


テンプレート内のボディ・オブジェクトのカラー、パターンまたは境界線の変更

  次へ	  関連項目

テンプレートのマージン内でオブジェクトを変更するには:

1	テンプレート・エディタのレイアウト・モデル表示で、「レポート・スタイル」ドロップダウン・リストから次のものを選択します。

•	すべてのレポート・スタイルを変更するには、「デフォルト」を選択

•	個々のレポート・スタイルのみを変更するには、そのスタイルのみを選択

2	変更するオブジェクトをダブルクリックし、プロパティ・パレットを表示し、オブジェクトのカラー、パターンまたは境界線を変更します。


レポートへのテンプレートの適用

  関連項目

レポートにテンプレートを適用するには:

1	オブジェクト・ナビゲータで、テンプレートを適用するレポートまたはレポート・セクションをクリックします。注意

2	「ツール」 [image] 「レポート・ウィザード」を選択します。

3	希望するテンプレートをオープンするには、「テンプレート」タブ上で既に定義されたテンプレートを選択するか、または「テンプレート・ファイル」ラジオ・ボタンをクリックします。 そして「参照」をクリックします。

4	「完了」をクリックして、テンプレートを現行のレポート・セクションに適用します。


定義済みテンプレート・リストへのテンプレートの追加

  関連項目

テンプレートをレポート・ウィザード内の定義済みテンプレートのリストへ追加するには:

1	テキスト・エディタ（たとえば、Wordpad）内で、作業環境ファイルをオープンします。

2	Reports.xxx_Template_Descによって識別されるテンプレート記述まで移動します（ここでxxxは、レポート・スタイルを指定しています）。

3	テンプレートが定義されている各レポート・スタイルに対して:

•	Reports.xxx_Template_Descリストにおいて、 レポート・ウィザードのテンプレート・ページ上に表示する記述を追加

•	Reports.xxx_Template_Fileリストにおいて、記述リストに追加したのと同じ位置に、テンプレートのファイル名を追加

4	REPORTS30_PATH環境変数によって指定されるディレクトリに、テンプレート・ファイル（ファイル名.tdf）をコピーします。

レポート・ウィザード内に、テンプレートのサンプル・イメージをインクルードするには:

1	テンプレートが定義されている各レポート・スタイル（表、グループ左など）に対して、サンプル・レポートにテンプレートを適用します。

2	以下の名前規約に従うBMPファイルに各サンプル・レポートの一部（横2インチ、縦3インチ未満）をキャプチャするには、画面キャプチャ・ツールを使用します。

yyyz.bmp

ここで

yyy	Reports.xxx_Template_Fileで指定されたファイル名に一致します。
リスト

z	レポートのスタイルを識別します。
a	上のグループ
f	フォーム形式
g	グループのマトリックス
l	左のグループ
m	メール・ラベル
r	フォーム・レター
t	表
x	マトリックス

3	デフォルトとして使用する.BMPファイル（すなわち特別なレポート・スタイルに対してビットマップが1つもない場合に表示される）をコピーまたは作成して、それにyyy.BMPの名称を付与します。

4	REPORTS30_PATH環境変数によって指定されるディレクトリに、各.BMPファイルをコピーします。


Windows上で、存在すれば、ORACLE_HOME\CAUPREFS.ORA（USER作業環境）をオープンします。 存在しなければ、ORACLE_HOME\CAGPREFS.ORA（グローバル作業環境）をオープンします。

UNIX上で、存在すれば、your_home_directory/prefs.ora（USER作業環境）をオープンします。 存在しなければ、$ORACLE_HOME/tools/admin/prefs.ora（グローバル作業環境）をオープンします。


表, ブレーク上, ブレーク左,フォーム・レター,フォーム形式, メール・ラベル, マトリックス, マトリックス・ブレーク。


オブジェクト・ナビゲータでレポート全体のノードを選択すると、テンプレートはデフォルトでレポートのメイン・セクションに適用されます。レポートの特定のセクションにテンプレートを適用するには、オブジェクト・ナビゲータで、そのセクションのノードを選択します。


?


2つの問合せをリンクする場合の条件

たとえば、次のように指定します。

問合せ1	deptno,ename,sal

問合せ2	salgrade,hisal,losal

salとhisalの間にリンクを指定した後salとlosalの間にもう1つのリンクを指定した場合、次の条件の結果を表示するレポートが設定されます。

WHERE SAL >= LOSAL AND SAL <= HISAL

しかし、実際にはレポートに次の条件の結果を表示するとします。

WHERE SAL <= LOSAL OR SAL >= HISAL

単に符号を変更しても、次のようになってしまいます。

WHERE SAL <= LOSAL AND SAL >= HISAL

これにより、戻される行はありません。どのように終了すればよいのでしょう?

Report Builder問合せ間の結合条件は、"データ・リンク"（つまり、データ・モデル・ペインタ内で2つの列の間に描かれた矢印）を介して指定できるものに限られません。結合条件が1つ以上のデータ・リンクで組み立てられない場合、次の方法があります。

1	"ダミー･リンク"を作成（データ・リンク・ツールを選択して、親グループ、子グループの順にクリック）して、2つのグループ間に希望する親子関係を確立します。

2	子問合せのWHERE句に結合条件を入力し、親問合せの列をバインド変数として参照します。この場合、WHERE句に次のように追加します。
"WHERE :SAL <=LOSAL OR :SAL >=HISAL"

これでできあがりです。親問合せに属する列は、子問合せ内のどこからでも参照できますが、結合条件が複雑になる可能性があることに注意してください。


問合せ間のリンク

Report Builder リリース3.0以降では、=、<、<=、<> 、>、 >=、LIKE、NOT LIKEを使用してリンクできます。


字句パラメータとバインド・パラメータ間の違い

バインド参照は、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


ブレーク・グループおよびその作成方法

ブレーク・グループは、連続する行の同一値がその関連レコードについて一度だけ印刷される、レポートを作成する場合に使用されます（つまり、ブレーク・グループは、問合せ列を集合に分割します）。

ブレーク・グループを作成するには、次の手順に従います。

1	レポート・エディタの「データ・モデル」内で、レポートをブレークする列を含むグループを問合せオブジェクトから外にドラッグします。

2	レポートの分割に使用する列を選択（たとえば、部門番号によって従業員データのリストをグループ化する場合は部門番号列を選択）して、その列をそのグループの上の方にドラッグし、新規グループを作成します。

3	新規グループ・オブジェクトのタイトル・バーをダブルクリックして、プロパティ・パレットを表示します。デフォルトを使用しない場合は、「一般情報:」名前フィールドの名前を置換します。必要に応じて、プロパティ・パレットの残りの項目に入力して、確定します。


グループ・フィルタと最大取出し行との違い

「最大取出し行」プロパティでは、問合せによってフェッチされる実際のレコード数を制限します。問合せによってすべてのレコードがフェッチされた後、グループ・フィルタによってどのレコードを挿入または除外するかが決まります。「最大取出し行」プロパティでは取り出されるデータ量が実際に制限されるため、ほとんどの場合グループ・フィルタよりも高速になります。「最後」または「PL/SQL」の「フィルタ」を使用する場合は、フィルタを適用する前に、Report Builderではグループ内のすべてのレコードを取り出す必要があります。また、問合せで最大取出し行を使用する場合、それを知っている必要があります。この問合せに依存する他のグループ内の集計に影響があります。たとえば、「最大取出し行」を8に設定した場合、その問合せに基づいた集計では取り出された8レコードしか使用されません。


ページの上からではなく下半分から印刷を開始するグループの固定

問合せが多数あり、各問合せにそれぞれ関係付けられたグループ枠がある場合、この問題がよく発生します。2番目以降の枠は、暗黙的にページにアンカーされているため、レイアウト上のそれぞれの絶対位置まで押し下げられます。これを避けるには、最初の枠がなくなると2番目以降の枠が引き上げられるように、2番目以降の枠が必ずその上の枠に暗黙的にアンカーされるようにします。その方法の1つは、最初の枠が縦方向に伸びるようにし（可変）、後続の枠を最初に置くことです。


奇数ページ番号を右側に、偶数ページ番号を左側に設定

フィールドを2つ、つまり右側および左側に1つずつ作成する必要があります。各フィールドの「フォーマット・トリガー」では、SRW.GET_PAGE_NUMを使って、奇数ページか偶数ページかをテストします。その後、そのフィールドを表示または非表示にします。


マスター/ディテール・レポート内でのディテール・オブジェクトの左側へのわずかな移動

オブジェクト位置の中央揃えを解除するために変更可能な設定はありませんが、リリース3.0以降ではフレックス・モードによってディテール・オブジェクトを左側に移動できます。この新しいレイアウト・モードは、速くて簡単です。


マトリックス・レポートのセル内の値の動的な数

実行時には、セルに対応する数によって、マトリックス（セル）の高さを調整できます。これは、リリース2.0では不可能でしたが、Report Builder 3.0以降では、垂直方向に可変のセルが処理されます。


多数のフィールドの書式マスクの一括変更

次の手順に従います。

1	レポート・エディタの「レイアウト・モデル」を表示します。

2	変更するフィールドを選択します。

3	「ツール」 [image] 「プロパティ・パレット」を選択します。

4	「書式マスク」プロパティで書式マスクを指定します。


印刷可能領域およびその表示方法

印刷可能領域は、プリンタが物理ページに印刷できる物理的な領域です。たいていのプリンタは、通常、ページの端までは印刷できず、ブランクの「印刷不可能」な領域が残ります。Report Builder 3.0以降では、次の手順によって印刷可能な領域を表示できます。

1	「ファイル」 [image] 「ページ設定」で、プリンタを選択します。

2	レポート・エディタの「レイアウト・モデル」を表示し、ツール・バーの [image] （マージン・ツール）をクリックします。

印刷可能領域が、マージン領域に点線内の領域として表示されます。

3	縮小するには、「表示」 [image] 「ズームアウト」を選択します。


オブジェクト変更または移動時のパフォーマンス

この問題は、オブジェクトを多数持つ非常に大きなレポートに限って当てはまります。パフォーマンスを改善するには、次の手順に従います。

1	「表示」 [image] 「タイプ」を選択するかまたはオブジェクト・ナビゲータを最小化します。

2	制限モードを「オフ」にします。


レイアウト・エディタ内の暗黙的アンカーの表示

レポート・エディタの「レイアウト・モデル」からは、作成された明示的アンカーしか見えません。しかし、「アンカー情報」を表示するオプションが「ナビゲータ・オプション」の下にあります。このオプションが選択されると、オブジェクト・ナビゲータから明示的アンカーと暗黙的アンカーの両方の情報をすべて見ることができます。


Before Reportトリガーの正確な起動のタイミング

Before Reportトリガーが起動するのは、レポート実行前ですが、問合せの解析後です。

このような順序が考えられます。

1	問合せが解析されます。

2	Before Reportトリガーが起動します。

3	レポートが実行されます（つまり、データをフェッチし、出力をフォーマットします）。

AFTER PARAMETER FORMトリガーで（またはその前に）DMLおよびDDLを実行した場合は、一貫性が保証されます。Before Reportトリガーでは、一貫性は保証できません。それは、レポート定義に基づくそのトリガーが起動する前に、データ・カーソル上でなんらかの処理を開始する必要がある可能性があるからです。Before Reportトリガーの実行前に必ずする必要があるのは、関連する表にアクセスし、カーソルをオープンすることです。その後に行われた表に対する変更は、レポートではいっさい表示されません。


レポート・トリガーの起動順序

1	BEFORE PARAMETER FORM

2	AFTER PARAMETER FORM

3	BEFORE REPORT

4	BETWEEN PAGES

5	AFTER REPORT


タイマー

現在Report Builderリリース3.0以降では、Graphic Builderのようなタイマーはサポートされていません。必要があれば、Report Builderを使用して、データベース・パイプおよびタイマーをアクティブにしたり、表示したりできます。レポートの実行にReports Serverを使っている場合には、RWCLI60またはReports Queue Managerを使用してジョブをスケジュールできます。


連結ライブラリとローカルPL/SQLの比較

ローカルPL/SQLの実行は、外部PL/SQLライブラリ内のプロシージャまたはファンクションに対する参照よりも高速です。そのため、外部PL/SQLを使用するのは、多数のアプリケーション間でコードを共有する利点の方がパフォーマンス・オーバーヘッドより重要な場合に限るべきです。


クライアントまたはサーバー上のSQLを多用するプログラム単位

SQLを非常に多用するプログラム単位がある場合には、それらのプログラム単位をサーバー上でパーティションに分割すれば、必ずパフォーマンスが向上します。他の方法として、可能な場合はデータ・モデルにそれらのプログラム単位を追加できます。このようにすると、データ・モデルは単なる新しい問合せとして処理されます。


SQL*Reportのレポートからの移行

両製品の間には製品固有の違いがあるため、SQL*Report（RPT）から直接変換することはできません。移行するには、次のような項目を考慮してください。

•	ほとんどの主要なSELECTマクロは問合せに変換されます。これらをファイルに保存し、保存したテキストを「編集」->「インポート」で問合せプロパティ・シートにインポートします。その際、INTO句を削除することを忘れないでください。

•	.ASK文はすべてパラメータに変換されます。

•	条件論理はレポート中のPL/SQLに変換されます。

•	.TELL文はすべてSRW.MESSAGEに変換されます。

•	問合せ生成後にReport Builderのデフォルト・ツールを使ってデフォルト・レイアウトを生成します。

•	必要な条件論理を追加し、必要に応じてデフォルト・レイアウトを修正します。

他の方法としては、RPTレポートをリバース・エンジニアリングによってOracle Desingerへ移行し、同様の方法でReport Builderレポートを生成する方法が考えられます。


SQL*ReportWriter 1.1からリリース2.5への直接アップグレード

R25MREP実行プログラムを使用するのみです。詳細は、『Report Builder 2.5移行マニュアル』を参照してください。R25MREPは、Reportsリリース2.5に含まれていますが、Report Builderリリース3.0以降には含まれていないことに注意してください。リリース2.5のレポートはリリース3.0以降でオープンできるため、リリース3.0用に実行プログラムをアップグレードする必要はありません。


リリース2.5からリリース3.0以降へのアップグレード

リリース2.5レポートはリリース3.0以降でオープンできるため、アップグレードは必要ありません。


自分のレポート（rdf、repファイル、SQLファイルまたはイメージ・ファイルなど）で外部ファイル検索に使用されるWindows上のORACLE.INIパラメータ

ファイルの検索に使用されるReport Builderアルゴリズムまたはパラメータ

リリース番号	検索アルゴリズム
2.0.12.x	ORACLE.INIファイル内のRW20_PATH
2.0.13.x	ORACLE.INIファイル内のRW20_PATH
2.0.14.x	作業ディレクトリを検索した後、ORACLE.INIファイルまたはレジストリ内のREPORTS_PATHによって指定されたディレクトリ、ORACLE.INIファイルまたはレジストリ内のORACLE_PATHによって指定されたディレクトリの順に検索します。
2.5.x	作業ディレクトリを検索した後、ORACLE.INIファイルまたはレジストリ内のREPORTS25_PATHによって指定されたディレクトリ、ORACLE.INIファイルまたはレジストリ内のORACLE_PATHによって指定されたディレクトリの順に検索します。
3.0.x	作業ディレクトリを検索した後、ORACLE.INIファイルまたはレジストリ内のREPORTS30_PATHによって指定されたディレクトリ、ORACLE.INIファイルまたはレジストリ内のORACLE_PATHによって指定されたディレクトリの順に検索します。
注意:

•	前述のパラメータでは、複数のディレクトリをセミコロンで区切って指定できます。たとえば、次の構文は有効です。

REPORTS60_PATH=C:\ORAWIN\APPS;C:\APPS;D:\TEST

•	リリース6.0以降では、ORACLE.INIではなく、Registryを使用して環境を設定します。REPORTST60_PATHは、外部ファイルを検索する場合のディレクトリを設定します。


一時ファイルが作成された場所へのリダイレクトに使用されるWindows上のORACLE.INIパラメータ

リリース番号	一時ファイルのリダイレクション
2.0.12.x	DOS環境でのTMP変数。SET TMP=<有効なディレクトリ>をAUTOEXEC.BATファイルに追加。
2.0.13.x	ORACLE.INI内の%TMP%パラメータおよびDOS環境でのTMPパラメータ。%TMP%=<有効なディレクトリ>をORACLE.INIファイルに追加。SET TMP=<有効なディレクトリ>をAUTOEXEC.BATファイルに追加。
2.0.14.x	ORACLE.INIファイル内のREPORTS_TMPパラメータ。これが設定されていない場合、作業ディレクトリを使用。
2.5.x	ORACLE.INIファイルまたはレジストリ内のREPORTS25_TMPパラメータ。これが設定されていない場合、作業ディレクトリを使用。
3.0.x	ORACLE.INIファイルまたはレジストリ内のREPORTS30_TMPパラメータ。これが設定されていない場合、作業ディレクトリを使用。
注意:  リリース6.0以降では、ORACLE.INIではなく、Registryを使用して環境変数を設定します。REPORTS60_TMPは、Report Builder一時ファイルを格納するディレクトリを設定します。


OLE2サポート

Report Builderは、リリース3.0以降、OLE2コンテナとして機能します。静的または動的OLE2オブジェクトを埋め込むことができます。これらのオブジェクトは、データベースとファイル・システムのどちらにも格納できます。

OLE2自動化も可能です。OLE2自動化の実行方法の例は、デモ・レポートOLEX.RDFを参照してください。


横方向に印刷されるASCIIレポートの作成

他のASCIIレポートと同様にレポートを設計します。重要なのは、レポートによって使用されるプリンタ定義ファイル（PRTファイル）を必ず変更して、プリンタが紙の印刷方向へ切り替わるのに必要な適切なエスケープ・シーケンスを組み込むことです。これらのエスケープ・シーケンスは、プリンタによって異なります。

適切なエスケープ・シーケンスに関しては、各プリンタのマニュアルを参照してください。また、PRTファイルの高さと幅がレポート定義のものと一致することを確認してください。


PCL5サポート

Motif版とWindows 95/NT版のリリース2.5.5.2以降では、Hewlett-PackardのPCL言語（レベル5）をサポートしています。これより前のバージョンでは、Windows 95/NT版のPCLのみをサポートしています。


PostScriptコードの生成

Report Builderでは、MS-Windows 95/NTおよびMotif上でPostScriptレベル1および2が作成されます。Windows上では他のプリンタ・ドライバもサポートし、Motif上ではPCL5をサポートします。


PostScriptプリンタへの画面表示どおりの出力

出力は、プレビューアの表示どおりになります（プレビュー表示されたレポートのレイアウトよりも高品質にはなりません）。


RUN_PRODUCT用の処理中ダイアログ・ボックス

MODEが同期の場合、RUN_PRODUCTコールの処理中ダイアログが表示されます。


Form Builderからの実行中のパラメータ値設定

Report Builderのパラメータ・フォームを表示しないで、そのレポートでDESTYPEにデフォルト値を割り当てる場合、DESTYPEおよびPARAMFORMの値を明示的に渡すために、リスト・パラメータを作成する必要があります。


読込み不可能なGraphics Builder図表

Graphics Builderオブジェクトを作成する場合、通常は、そのオブジェクトを保持するNxNサイズの領域をドラッグします。デフォルトでは、このオブジェクトの「水平拡張度」および「垂直拡張度」プロパティは、ともに「固定」です。

Graphics Builderでチャートを作成する場合、その図表にもNxNサイズの領域が定義されます。Report Builder内で作成されたGraphics Builderオブジェクトが同じNxNサイズであることまたは「水平拡張度」および「垂直拡張度」プロパティが「固定」ではないことを確認する必要があります。

たとえば、Graphics Builderではチャートをサイズ3x5に定義済みであり、Report BuilderではGraphics Builderオブジェクトが3x3に定義されているとします。実行時に、Report Builderでは、レポート内で定義された3x3のサイズに収まるように、3x5の図表をスケーリングする必要があります。この結果、一部のGraphics Builderオブジェクトでは、埋め込まれた図形が読込み不可能になることがあります。この問題は、オブジェクトの「水平拡張度」および「垂直拡張度」プロパティを「可変」に変更するのみで解決します。

それでも、なんらかの理由からこの問題が解決しない場合、図表のレイアウト・サイズも定義されたチャートと同じサイズになるように変更できます。

注意: 通常、問題を解決するには、Report Builderで「水平拡張度」および「垂直拡張度」プロパティを変更するのみで十分です。


バッチで実行中のReport Builderへのパラメータ（たとえば、データ範囲）の引渡し

問合せ内でバインド変数を使って問合せを制限し、コマンド・ライン・パラメータを使用するのみで、問合せに値を渡すことができます。

問合せ：

SELECT * FROM EMP WHERE HIREDATE BETWEEN
:FROM_DATE AND :END_DATE

実行時：

RWRUN60 REP1 SCOTT/TIGER FROM_DATE='92-06-12'
END_DATE='92-06-12'


無限レポート・エラー

リリース2.5では、オブジェクトの境界線がページの境界の外に出てしまう場合に、無限レポート・エラーが発生します。Report Builderリリース3.0以降では、そのようなオブジェクトは、自動的にページ境界内に収められ、無限レポート・エラーを回避できます。リリース2.5にはこの機能がないため、Report Builderリリース3.0以降ではエラーなく実行されるレポートをリリース2.5で実行すると、無限レポート・エラーが発生する可能性があることに注意してください。


予約語

Report Builderの予約語には、コマンド・ラインの引数および、Report Builderのパッケージ・プロシージャ、ファンクション、例外があります。RWCON60、RWBLD60、RWRUN60およびThe Report Builder PL/SQLパッケージ(SRW)を参照してください。


問合せの制限

Reportsランタイムでは、あるユーザーについて出力できるページ数を制限できます。PRODUCT_PROFILE表にそのユーザーのレコードを挿入します。


処理中に停止したレポートの再起動

処理中に停止したレポートを再起動する機能はありません。


プログラムによるプレビューア内印刷ボタンの使用不可への変更

現在、これは行えません。


プログラムによる実行時のプレビューア最大化および画面上の位置指定

現在、これは行えません。


自分のエラー・メッセージを表示するためすべてのエラーの検出（ON-ERRORおよびON-MESSAGEフォーム・トリガーと同様）

現在、これは行えません。


Report Builderへの製品固有の表のインストール

Report Builderリリース3.0以降では、製品固有の表をインストールする必要はありません。このような表が必要なのは、「Reportsに関するレポート」が特定のレポートについて実行する必要がある場合のみです。「Reportsに関するレポート」のレポートでは、記述されるレポートがデータベースに格納されている必要があります。


レイアウト・モデル表示内のオブジェクトの移動およびレイヤー化

  関連項目

レポート・エディタのレイアウト・モデル表示では、囲まれているオブジェクトは、囲む側のオブジェクトより上のレイヤー上になければなりません。たとえば、繰返し枠に属するフィールドは、レイアウト・モデル表示内の繰返し枠より少なくとも1つ上のレイヤーにあることが必要です。それ以外の場合、それらのフィールドは、繰返し枠によって囲まれていないと考えられ、実行時には回数エラーが発生します。レイアウト・モデル表示内のオブジェクトを移動またはグループ化すると、レイヤーが変更される可能性があるので、レポート実行時に回数エラーを受け取ります。この問題を回避するには、レイアウト・モデル表示内のオブジェクトの移動時に制限モードまたはフレックス・モードを利用する必要があります。


Oracle Net 8接続時間

接続時間が長い場合の共通の原因は、ネットワーク上で使用不可またはうまく機能していないドメイン・ネーム・サービスの使用にあります。TCP/IPのインプリメントに、デフォルトでドメイン・ネーム・サービスが使用されるものがあります。その場合にネットワーク上でドメイン・ネーム・サーバーを使用できないまたはうまく動作しなければ、接続に1分以上かかることがあります。たとえば、ホスト名を解決するためにドメイン・ネーム・サーバーが要求に応答しない場合、その要求は、各再試行間の待ち時間を2倍にして、再試行されます。数回再試行した後でもまだ応答がない場合、ローカルのホスト・ファイルで名前を探します。

このように、ローカルのホスト・ファイルを使用しているのに接続にかなり時間がかかることに気付いた場合、まずTCPがドメイン・ネーム・サービスを使用しないようにインプリメントされていることを確認してください。これを簡単に行うには、接続文字列内のホスト名を接続しようとしているサーバーのIPアドレスに変更します。


SQL*Net TCP/IP V1からNet8へ

SQL*Net TCP/IP V1の接続時間よりSQL*Net TCP/IP V2の接続時間の方が長いことがありますが、接続時間が非常に長くなるべきではありません。バージョンの古いSQL*Net TCP/IP V1製品の一部では、ローカルのホスト・ファイルを使用するようハードコードされており、IPアドレスをプロトコル・スタックに渡して実際の名前を自分で参照するコードがありました。このように、プロトコル・スタックでは、名前の解決は不要でした。

一方、Net8では、名前は解決されません。Net8では、TNSNAMES.ORAから名前解決用のプロトコル・スタックに取得した値が渡されるのみです。プロトコル・スタックがまずドメイン名の解決を試みるよう構成されており、正しく動作しているドメイン・ネーム・サーバーがない場合、V1からNet8へ移行すると接続時間が大幅に長くなります。

このケースに当てはまると考えられる場合、TNSアドレスの構成時にホスト名のかわりにIPアドレスを使用し、接続時間が大幅に短縮されたかどうか確認します。


 Net8デフォルト・タイムアウト

最初の接続試行のタイムアウトは、基礎となるプロトコルによって制御され、デッド接続検出（または、それについてはNet8の場合でも）は処理されません。非ブロック化接続（7.2 OCIまたはそれ以降）を使って書かれたアプリケーションがあれば、このような状況にはなりません（接続試行がブロックされそうなことが検出された場合、停止してその他の処理を実行するよう判断できるため）。


レポートのトレース

レポートのパフォーマンスを監視する最良の方法は、レポートの実行をトレースすることです。


SQL TRACE

TRACEファンクションによって、解析されている正確な文が提供されます。文を解析した後は、SQL*Plusでその文の時間を計ることができ、データベースから取り出される見積り行数によって、時間を計算できます（比較対象は必ず同じにします。つまり、ファイルに出力し、画面に出力しないでください。SQL文をSQL*Plusに移す場合に、SQL文内の要素を変えないでください。WHERE句を少しでも変更すると、パフォーマンスに大きな差異が生じることがあります）。

レポートをトレースする方法は次の2つです。ユーザー・レベルでのトレースおよびシステムレベルでのトレースです。次にどちらの方法も示しますが、ユーザー・レベルをお薦めします（必要な情報をより簡単に入手できるため）。SQL TRACEの詳細は、『Oracle8 Server SQLリファレンス』を参照してください。

ユーザー・レベル・トレースの実行

1	希望するパフォーマンス・データのレポートをオープンします。

2	次の式を持つSQL-TRACEという名のレポート・レベルの式列を作成します。

SRW.DO_SQL ('ALTER SESSION SETSQL_TRACE=TRUE');
return(1);  --Formulas must return a value.

注意: BEFORE PARAMETER FORMトリガーからSQL TRACEをコールすることもできます。

3	レポートを実行します。新規ファイル<some_number>.trcは、ORACLE_HOME/rdbms/logまたはinit.oraパラメータUSER_DUMP_DESTによって示された宛先に作成されます(ファイルの日付スタンプは、どの.trcファイルが自分のものか判別するのに役立ちます)。

4	TKPROFコマンドを使って、トレース出力ファイルをフォーマットします。

RWBLD60セッション中に複数のトレースを発行する場合、トレース出力は1つのファイルに連結されます。

システム・レベル・トレースの実行

1	init.oraファイルにSQL_TRACE=TRUEおよびTIMED_STATISTICS=TRUEの2つの文を挿入します。

2	データベースを停止した後、再起動します。

注意:  データベースとの対話はすべてトレースされるので、ORACLE_HOME/rdbms/logはかなり大きいファイルになります。


作業環境の設計

次の作業環境を使用すると、レポートの開発をより速く行うことができます。

•	オープン時のレポート・エディタを抑止

•	ダイアログ・ボックス・エントリでのリスト取出しを抑止

•	（ファイル・システムの）オブジェクト・アクセス

理由: 「オープン時のレポート・エディタを抑止」は、Report Builderでレポートをオープンするたびにレポート・エディタがオープンされないようにします。「ダイアログ・ボックス・エントリでのリスト取出しを隠す」により、Report Builderでダイアログ・ボックス内のリストを取り出す必要がなくなるため、ダイアログボックスを起動する時間が短縮されます。ファイルまたはデータベースへの「オブジェクト・アクセス」を設定すると、ファイル、他のモジュールまたはデータベース・オブジェクトにアクセスするときにダイアログ・ボックスを表示しません。


テンプレート

ある決まったレポート要素が、作成する多くのレポートで何度も繰返される場合、レポート用テンプレートの作成を考えるとよいでしょう。

理由: テンプレートを使用すると、新規レポートを作成するたびに同じオブジェクトおよび設定を再作成する必要がないため、時間を節約できます。


問合せ数

できる限りレポート内の問合せ数を削減します。一般に、問合せが少ないほどレポートの実行速度は上がります。複数問合せデータ・モデルの方がわかりやすいことが多いのですが、1つの問合せデータ・モデルの方が速く実行できる傾向にあります。

複数問合せデータ・モデルを使用するのは次の場合のみです。

•	親から多数の大きな列および子からいくつかの小さい列のみをフェッチしている場合

•	SELECT文によって直接サポートされていないことを行おうとした場合（たとえば、複数方式の外部結合）

•	複雑なビュー（たとえば、分散問合せまたはGROUP BY問合せ）がある場合

•	ビューが必要だが、ビューを持っていないまたは使用しない場合

理由:  1つの問合せレポートの場合、すべてのマスターおよびディテール・レコードをフェッチするためにReport Builderによってカーソルが1つのみオープンされます。2つの問合せレポートの場合、Report Builderによって、ディテール問合せのWHERE句に対してディテール問合せがリンクされた後で、各問合せに1つずつ、つまり2つのカーソルがオープンされます。その結果、マスター問合せ内でフェッチされた各マスター・レコードについて、Report Builderがディテール問合せからデータを再バインドおよび実行、フェッチします。


SQL文

SQLで操作を実行した方が、Report BuilderまたはPL/SQLでの実行よりも高速です。次のリストでは、SQLを使用することによってパフォーマンスが改善される最も一般的なケースが説明されています。

•	式またはサマリーではなく問合せ内で直接計算する。

•	グループ・フィルタまたはフォーマット・トリガーによってレコードを除外するのではなく、WHERE句を使用する。

•	Report Builder内で文字列を切り捨てるのではなく、SUBSTRファンクションで切りつめる。

理由: SQLでは、サマリーまたは式よりも速く計算できます。WHEREおよびSUBSTRはデータの取出し後ではなくデータの取出し中にデータを操作するため、不要なフェッチを削減できます。パフォーマンスの向上は、少ないレコードを取り出す場合よりも、多数のレコードを取り出す場合により明らかになります。


問合せの変更

次の場合、Report Builderでは問合せが変更されます。

•	作成した各リンクについて、Report Builderによって、リンクで指定された子問合せに句が追加されます。たとえば、次のような問合せがあるとします。

     SELECT DEPTNO, ENAME, SAL FROM EMP
     WHERE SAL > 1000

子列としてDEPTNOおよびSQL句のWHERE、=（等しい）条件を使って、この問合せへのリンクを作成する場合、この問合せは次のように変更されます。

     SELECT DEPTNO, ENAME, SAL FROM EMP
     WHERE (SAL > 1000) AND (DEPTNO = :DEPTNO)

注意: これは、複数問合せのマトリックス・レポート・データ・モデルには当てはまりません。

•	ブレーク順序が設定された各データベースの列の場合、Report Builderによってその問合せのORDER BY句が修正されます。たとえば、次のような問合せがあるとします。

     SELECT DEPTNO, ENAME, SAL FROM EMP
     ORDER BY SAL

DEPTNOをブレーク列としてブレーク・グループを作成する場合、問合せは次のように変更されます。

     SELECT DEPTNO, ENAME, SAL FROM EMP
     ORDER BY 1, SAL

これらのSQL文は、データベースに送信され、SQLオプティマイザのジョブになり、データベースからデータを取得してReport Builderへ戻す最適な方法が判別されます。オプティマイザによって、索引を使用するか、問合せ内で「駆動表」としてどの表を使用するかなどが判別されます。

SQL文の調整の詳細は、『Oracle8 Serverアプリケーション開発者ガイド』を参照してください。SQLオプティマイザの詳細は、『Oracle8 Serverチューニング』を参照してください。


索引

SELECT文のWHERE句で使用される列およびデータベース・キー列、ディテール問合せの表に、索引を付けます。マスター問合せはデータベースに一度のみしかアクセスしないので、索引によるマスター問合せへの影響はほとんどありません。ただし、索引はマスター/ディテール・レポートのパフォーマンスを大幅に改善します。ディテール・レコードに対するマスターの割合が低いほど、ディテール問合せの索引は2つの問合せレポートにとって重要になります。

理由:索引は、Report Builderによって親子リレーションからWHERE句が暗黙的に作成されてディテール問合せに追加されるため、ディテール問合せの表にお薦めします。


SRW.DO_SQL文

必要な場合のみ、パッケージ・プロシージャSRW.DO_SQLを使用します。必要な場合には、少量のレコードをフェッチするグループまたはレポート・レベル・オブジェクトにSRW.DO_SQLを割り当てます（一度のみ解析およびカーソルのオープン、実行が可能です）。SRW.DO_SQLによって、レポートにDDLまたはDML操作を追加できます。この機能は、とても便利ですが、使用法に注意する必要があります。

理由: 問合せと同じで、SRW.DO_SQL文が解析されてデータベースに対するカーソルがオープンされ、文が実行されます。しかし、SRW.DO_SQL文は、所有者（たとえば、グループ）がデータをフェッチするたびにSRW.DO_SQLを実行する点が問合せと異なります（たとえば、SRW.DO_SQL文が10レコードをフェッチするグループによって所有されている場合、その文は10回解析され、カーソルが10個オープンされ、文が10回実行されます）。このため、計算（たとえば:sal + :com）は、グループによって所有されるSRW.DO_SQLによってではなく、問合せまたはPL/SQLによって実行されます。


最大行およびグループ・フィルタ

レポートの問合せによって取り出されるレコード数を減らすには、問合せの「最大取出し行」プロパティ（または、SRW.SET_MAXROWパッケージ・プロシージャ）を使用します。多数のレコードをフェッチするまたはトラフィックの多いネットワーク上の情報にアクセスするレポートを設計する場合、テスト中により速くレポートを実行できるよう取り出されるデータ量を制限することがあります。

理由: 「最大取出し行」では、問合せによってフェッチされるレコード数が制限されます。グループ・フィルタによって、どのレコードを挿入または除外するかが決まります。「最大取出し行」プロパティによって実際に制限されるのは取り出されるデータ量なので、通常、グループ・フィルタよりも高速です。「フィルタ・タイプ」として「最後」または「PL/SQL」を使用する場合は、フィルタ基準を適用する前に、Report Builderによってグループ内のすべてのレコードを検索する必要があります。結局、「最大取出し行」または「最初」の「フィルタ・タイプ」がより高速です。

あるグループに対して、「フィルタ・タイプ」を「最初」、「レコード数」をnで指定した場合、Report Builderによってグループの最初のnレコードを取得するために必要な配列ができる限り多く取り出されます。取り出される配列サイズは、ARRAYSIZEパラメータによって決まります。その結果、「最初」の「フィルタ・タイプ」は、必要以上にレコードを取り出すことがあります。たとえば、「フィルタ・タイプ」を「最初」、「レコード数」を5に指定し、各配列に10レコードを含むようなARRAYSIZEを指定した場合、レポートによって使用されない5レコードが取り出されます。問合せの「最大取出し行」を指定した場合、Report Builderによって、指定した数のレコードのみが取り出されます。「最大取出し行」を5に設定すると、5レコードのみが取り出されます。

一般に、「最大取出し行」は、必要なレコード数のみを取り出すので、「最初」の「フィルタ・タイプ」より高速です。しかし、パフォーマンスの違いは、指定したARRAYSIZEによって異なります。

注意: グループが依存する問合せの「最大取出し行」を使用する場合は注意してください。たとえば、子問合せで「最大取出し行」を5に設定した場合、その親グループに含まれる子のサマリーには、その問合せによって取り出される5レコードのみが使用されます。


未使用のデータ・モデル・オブジェクト

レポート内で実際には使用されていないすべてのデータ・モデル・オブジェクトを削除または非表示にするようにしてください。あるケースでのみ使用される問合せがデータ・モデルに組み込まれている（つまり、パラメータがある値に対して設定されている）場合、SRW.SET_MAXROWパッケージ・プロシージャによって条件付きで問合せを非表示にすることができます。SRW.SET_MAXROW (queryname, 0)によって、問合せではレコードがフェッチされなくなります。

理由: Report Builderによって、データ・モデル表示の項目がすべて処理されます。このため、不要な問合せを削除または非表示にしなければ、不必要にレポートが遅くなることがあります。


ブレーク列

ブレーク・グループを作成する場合、グループに配置する列をできるだけ少なくします。可能ならば、ブレーク・グループごとにブレーク列数を1に保ちます。

さらに、ブレーク列ができるだけ小さくなるようにしてください。短いブレーク列では、一般に、長いブレーク列よりもパフォーマンスが向上します。より大きなブレーク列の場合、列を短くするには、SUBSTRファンクションを使ってパフォーマンスを改善します。

理由: ブレーク・グループごとに、Report Builderは問合せのORDER BY句の前にそのブレーク列を付けます(このルールの唯一の例外は、ブレーク列が式列である場合です)。ブレーク・グループ内でブレーク列の数を最小化するには、ORDER BY句に追加される列の数を最小にします。ORDER BY句に追加される列が少ないほど、問合せの実行時に行う必要がある処理は少なくなります。Report Builderによって索引作成に内部的に使用されるキーのサイズも、小さくすれば、パフォーマンスが改善されます。


複数のレイアウトおよび1つのソース

Report Builderでは、1つのソースから同じデータを複数回レポート出力に表示できます。出力に同じデータを複数回表示する場合、すべてのレイアウト・オブジェクトのソースとして、同じデータ・モデル・オブジェクトを使用します。

たとえば、給与が2000ドル以上のすべての従業員を1つのリストに表示し、2000ドル未満のすべての従業員を別のリストに表示するとします。これを完成するには、すべてのデータを選択する問合せを1つ作成します。その後、同じデータに基づく2種類のレイアウトを作成します。つまり、繰返し枠の中にSALが2000ドル以上の場合のインスタンスのみを表示するフォーマット・トリガーが含まれるレイアウトを1つ作成します。そして、もう1つのレイアウトでは、繰返し枠の中にSALが2000ドル未満の場合のインスタンスのみを表示するフォーマット・トリガーを含めます。

理由: データを1回フェッチし、複数回配置するレポートは、それぞれのデータの異なるレイアウトごとに1回取り出すレポートよりも速く実行できます。


マトリックス

マトリックス・レポートのパフォーマンスは、次の方法によって改善できます。

問合せを減らす

WHERE句

注意: クロス積グループでは、必ず「事前フェッチ」が発生します。この原因は、クロス積グループ内のデータをクロス表にするためにReport Builderによってすべてのデータが最初にフェッチされるためです。


問合せを少なくする

別のタイプのレポートでも、問合せを減らせば高速になります。可能ならば、マトリックス・レポートに1つの問合せを使用してパフォーマンスを改善します。

理由: 1つの問合せレポートの場合、すべてのマスターおよびディテール・レコードをフェッチするためにReport Builderによってカーソルが1つのみオープンされます。複数問合せのレポートの場合、Report Builderによって複数のカーソルがオープンされます。


WHERE句

複数問合せデータ・モデル内のマトリックス（セル）問合せ用にWHERE句を追加するとします。複数問合せのデータ・モデルを使用しており、問合せのサイズがWHERE句によって制限される場合、WHERE句をマトリックス（セル）問合せに追加すれば、必要以上に多くのレコードが取り出されることはありません。たとえば、サイズについて次のような問合せがあるとします。

Q_Dept:

SELECT DEPTNO FROM DEPT
            WHERE DEPTNO < 100

Q_Job:

SELECT DISTINCT JOB FROM EMP
            WHERE DEPTNO < 100

セル問合せによって必要なレコードのみが取り出されるようにするには、次のSELECT文を書きます。

Q_Filler:

SELECT DEPTNO, JOB, SUM(SAL) FROM EMP
             WHERE DEPTNO IN (SELECT DEPTNO FROM DEPT
             WHERE DEPTNO < 100) AND JOB IN (SELECT
             DISTINCT JOB FROM EMP WHERE DEPTNO < 100)
             GROUP BY DEPTNO, JOB

この問合せにWHERE句を追加しなければ、Q_DeptおよびQ_Jobで何を選択したかに関係なく、すべての行がデータベースから検索されます。

注意: 副問合せを使用しないWHERE句（たとえば、WHERE EMP.DEPTNO = DEPT.DEPTNO）を追加した場合、その問合せは、クロス積内の値の各組合せごとに1回実行されます。これによって、クロス積が多数の組合せを持っている場合、内容の問合せを過度に実行することがあります。

理由: Report Builderでは、複数問合せのマトリックス・データ・モデル内の内容の問合せにWHERE句を追加できません。この理由は、内容の問合せが1回だけ実行されるようにするためです（それ以外の場合、その問合せは、クロス積内の値の各組合せごとに1回実行されます）。しかし、サイズの問合せが取り出されるレコード数をかなり制限する場合、内容の問合せのWHERE句がないために、不要なレコードを多数フェッチすることになります。これを避けるには、WHERE句自体を追加します。ただし、この方法では、副問合せでさらにオーバーヘッドが起こるため、不要なレコードを多数取り出すのを避ける場合にのみ使用します。


未使用の枠

レイアウトから不要な枠をすべて削除します。Report Builderによってデフォルト・レイアウトが作成される場合、ほとんどすべてのオブジェクトの周りに枠が設定されます。これは、出力の際に、枠内のオブジェクトが他のオブジェクトによって上書きされないように保護するためです。経験から枠内のオブジェクトが上書きされる危険性がないことがわかっている場合は、レポート出力に悪影響を及ぼすことなく、枠を排除できます。

理由: レイアウト内のオブジェクトが少なければ、Report Builderによって実行時にフォーマットする必要があるオブジェクトが少なくなります。そのため、レイアウト内のオブジェクト数を減らすと、パフォーマンスが向上します。


透明なオブジェクト

レイアウト・オブジェクト（たとえば、枠および繰返し枠）に透明な境界線および塗りパターンを付けます。

理由: 透明なオブジェクトはPostScriptファイルで描く必要はありません。そのため、オブジェクトが透明な場合、処理が高速になります。


非図形オブジェクトのサイズ設定

図形以外のレイアウト・オブジェクト（たとえば、ボイラープレート・テキストまたはテキスト・フィールド）のサイズを固定、つまり「垂直拡張度」および「水平拡張度」を「固定」にします。特に、繰返し枠とその内容のサイズを固定すると、パフォーマンスを改善できます。

理由: サイズが変わる非図形オブジェクトは、Report Builderがフォーマットする前にサイズを決める必要があるため、処理が増えます。サイズが固定された非図形オブジェクトは、サイズがわかっているため、この余分な処理は不要です。


図形オブジェクトのサイズ設定

図形レイアウト・オブジェクト（たとえば、イメージおよびOracleチャート・オブジェクト）のサイズを可変、つまり「垂直拡張度」および「水平拡張度」を「可変」にします。

理由: サイズを固定した図形オブジェクトでは、通常、内容がその中に収まるようにスケーリングする必要があります。オブジェクトの内容のスケーリングには、より多くの処理が必要です。オブジェクト・サイズが可変の場合、内容と一緒に拡張または縮小できるため、スケーリングの必要はありません。


イメージ解像度の減少

サイズを縮小するイメージ・オブジェクトで「書式」 [image] 「描画オプション」 [image] 「イメージ解像度の減少」を使用します。

理由: イメージのサイズを縮小すると、縮小前よりも表示に必要な情報が少なくなります。「イメージ解像度の減少」によって不要な情報が排除され、イメージを格納するのに必要な領域が減少します。これは、特に大きいカラー・イメージに役立ちます。


ワード・ラップ

1行の長さに合せてテキストを入れるフィールドにするには、その内容が必ず指定された幅に収まるようにします（たとえば、SUBSTRファンクションを使用）。

理由: テキストのあるフィールドが複数行にわたる場合、Report Builderでは、フィールドをフォーマットするワードラップ・アルゴリズムを使用する必要があります。フィールド内にフォーマットする行が1行しかなければ、ワードラップ・アルゴリズムの処理は不要になります。


フォーマット属性

同じフィールドまたはボイラープレート・テキスト内で使用するフォーマット属性（たとえば、フォント）の種類を最小限度にとどめます。

理由: フィールドまたはボイラープレート・オブジェクト内のテキストに異なる属性が多数含まれている場合、フォーマットに時間がかかります。


「フォーマット・トリガー」

PL/SQLを、頻度のできるだけ少ないオブジェクトの「フォーマット・トリガー」内に配置します。たとえば、フィールドではなく枠の「フォーマット・トリガー」内のPL/SQLの方が、一般に、レポートを高速に実行できます。

理由: フォーマット・トリガーによるPL/SQLは、そのオブジェクトのインスタンスごとに実行されます。オブジェクトの頻度を少なくするほど、PL/SQLの実行回数が減り、レポートの実行速度が上がります。

使用上の注意

•	特定のオブジェクトに対する「フォーマット・トリガー」の起動回数はわからないので、「フォーマット・トリガー」内での計算やDMLの使用は避けてください。


ページの総数

フィールドのソースとしてのページの総数（たとえば、論理ページの総数）の使用を制限します。

理由: ページの総数フィールドのソースを使用する場合、Report Builderでは、ページの総数を決めるために一時記憶に全ページを保存する必要があります。このため、Report Builderによって使用される一時的なディスク領域が大幅に増加し、ファイルにさらに書込みをすると、パフォーマンスが低下することがあります。


Graphics Builderの統合

レポートによって参照されるGraphics Builderの図表が、レポートと同じデータの全部または一部が使用される場合、レポートから図表へデータを渡します。Report Builder内の図表のプロパティ・パレットに、渡されるデータを指定できます。

理由: レポートと図表が同じデータを使用する場合、データを渡すことによって必要なフェッチ量が減ります。レポートから図表にデータを渡さない場合、データは実際2回（レポート用に1回および図表用に1回）フェッチされます。


PL/SQLとユーザー・イグジットの比較

環境によって、PL/SQLまたはユーザー・イグジットのどちらを使用するかによってパフォーマンスが異なります。次に、PL/SQLとユーザー・イグジットのどちらを使用するかを決める場合に考慮する必要がある項目を示します。

•	Report Builderオブジェクトを多数参照する必要がある場合、一般にPL/SQLの方が高速です。

•	レポートに移植性が必要な場合またはアクションがグループまたはレポート・レベルで実行される場合は、PL/SQLを使用します。

•	レポートに移植性が不要な場合、DMLの実行には、PL/SQLではなくユーザー・イグジットを使用します。

•	アクションが大きいレポート内でレコードごとに実行される場合またはそのアクションで多数の複雑な計算をする必要がある場合は、ユーザー・イグジットが特に有効です。

理由: PL/SQLは、コードが手続き型で、さらに移植性があるため、ご使用を強くお薦めします。また、PL/SQLでは、レポート・レベル・オブジェクトの参照時によいパフォーマンスが得られます。ユーザー・イグジットのパフォーマンスは優れていますが、リンクが必要で、移植性がありません。必要なアクションが非常に大きなレポート内でレコードごとに実行される場合または多数の計算を行う場合は、ユーザー・イグジットを組み込むと効果があります。

アクションがグループごとまたはグループ・レベル単位にのみ実行されるのなら、PL/SQLプロシージャがより効果的です。なお、PL/SQLですべて実行できるわけではありません。外部デバイスの制御などの一部のアクションは、Cプログラム内で行う必要があります。

注意: パフォーマンスに差がなく、他にユーザー・イグジットを使用するべき理由がない場合は、簡単で移植性があるPL/SQLを使用してください。


DMLでのPL/SQLとSRW.DO_SQLの比較

DML文にパラメータを渡す場合以外は、DMLにはPL/SQLを使用します。

理由: PL/SQLでDML文を作成すると、同じ文が含まれるSRW.DO_SQLのコールより高速になります。DML文にSRW.DO_SQLを使用する理由は、DML文を構成するためにバインド・パラメータを連結できるからです。たとえば、SRW.DO_SQLを使って、ランタイム・パラメータ・フォームに入力したパラメータによって名前が判別される表を作成できます。

SRW.DO_SQL ('CREATE TABLE' || :tname || '(ACOUNT NUMBER
           NOT NULL PRIMARY KEY, COMP NUMBER (10,2))');

使用上の注意

•	DMLには、Oracle7.1またはそれ以降のバージョンに含まれるdbms_sqlパッケージも使用できます。詳細は、Oracle7のマニュアルを参照してください。


ストアド・プロシージャとローカルPL/SQLの比較

データベースを操作するPL/SQLには、ストアド・プロシージャを使用します。データベース操作に関係ないPL/SQLには、ローカルPL/SQLを使用します。

理由: ストアド・プロシージャはOracleで実行されるので、レポートに対してローカルなPL/SQLよりもデータベースを高速に操作できます。

例外: 負荷が高く応答時間がかなり長くかかるネットワークの場合、ストアド・プロシージャを使用しても、データベース操作が速くならないことがあります。同様に、サーバーがローカル・マシンよりもはるかに高速である場合、データベース以外の操作にローカルPL/SQLを使っても、高速にはならないことがあります。


ローカルPL/SQLと外部PL/SQLライブラリの比較

できる限り"ローカル"なPL/SQLを書きます。外部PL/SQLライブラリのかわりに、オブジェクト・ナビゲータ内の自分のレポートの「プログラム単位」ノードを使用します。

理由: ローカルPL/SQLの実行は、外部PL/SQLライブラリ内のプロシージャまたはファンクションに対する参照よりも高速です。そのため、外部PL/SQLライブラリを使用するのは、パフォーマンスのオーバーヘッドよりも、多数のアプリケーション間でコードを共有する利点の方が重要な場合に限ります。


SRW.SET_ATTR

1回のコールで複数の属性を指定して、SRW.SET_ATTRのコール回数を最小限に抑えます。属性ごとに個別に呼び出すのではなく、SRW.SET_ATTRを1回呼び出すことで、複数の属性を指定できます。

理由: SRW.SET_ATTRに対するコール回数が少ないほど、PL/SQLの実行速度は向上します。


ARRAYSIZE

Report BuilderのARRAYSIZE実行引数（たとえば、ARRAYSIZE=10）には、できる限り大きい値を入力します（特に、クライアント/サーバー環境でReport Builderを使用している場合）。配列サイズは行ではなく、KB単位です。つまり、Report Builderでは、レポートの実行で、問合せごとにARRAYSIZEで指定されたKB数のメモリーを使用できるということです。

Report Builderでは、1度に1レコードではなく、バッチで複数レコードをフェッチするOracleの配列処理が使用されます。これにより、バッチ処理によってフェッチされるデータ量を制御できます。

理由: 配列サイズが大きいほど、1度にフェッチできる行数も多くなります。その結果、データベースのコール回数も減ります。配列サイズを拡大する利点は、通常ネットワーク・トラフィックがボトルネックになり、ネットワークで送信されるパケット数に関連するオーバーヘッドの影響が大きい分散環境でより明白にわかります。


LONGCHUNK

Report BuilderのLONGCHUNK実行引数（たとえば、LONGCHUNK=1）には、できるだけ大きな値を入力します。LONGCHUNKは、Report BuilderがLONG値を取り出す増分のサイズを決定します。LONGCHUNKのサイズはKB単位です。

理由: LONGCHUNKをできる限り増やすことによって、Report BuilderがLONG型の値を取り出すのに必要な増加分の数を削減できます。


RUNDEBUG

RUNDEBUG実行引数はオフにします。RUNDEBUGを使用すると、レポートの実行時にReport Builderによるエラー・チェックが増えます。この余分なエラー・チェックは、レポート設計時には役立ちますが、レポートを実際に使用する段階ではおそらく不要になります。

理由: RUNDEBUGによる余分なエラー・チェックのために、レポートの実行速度が低下します。


COPIES

PostScriptに出力する場合、COPIES=1と指定します。

理由: COPIESに設定した値がPostScriptレポートの値より大きい場合、Report Builderは、ページ順を揃えるためにそのページを一時記憶に保存する必要があります。このため、Report Builderによって使用される一時的なディスク領域が大幅に増加し、ファイルにさらに書込みをすると、パフォーマンスが低下することがあります。


プレビューア

プレビューアまたはライブ・プレビューアにレポート出力を送る場合には、"事前フェッチ"を回避します。こうすると、事前フェッチを行った場合よりも最初のページが速く表示されます。

理由: プレビューアまたはライブ・プレビューアは、事前フェッチが必要な処理によって速度が落ちることがあります。たとえば、レポートのページの総数がレポートの最初のページに表示される場合、まずレポート全体が処理されなければ、最初のページはプレビューアまたはライブ・プレビューアに表示できません。

次の項目は、依存するデータの前に参照された時点で、すべて事前フェッチになる可能性があります。

•	ページ/パネルの総数

•	総合計

•	式であるブレーク列

•	NULL時の値が指定されたブレーク列

クロス積グループでも、事前フェッチが起こります。クロス積グループ内のデータをクロス集計するために、Report Builderではすべてのデータを最初にフェッチする必要があるからです。

これらの項目は、実際にはパフォーマンス上の"問題"にはならないことに注意してください。プレビューアまたはライブ・プレビューアの速度が落ちますが、ファイルまたはその他の宛先に書き込む場合には、パフォーマンスへの影響はありません。

注意: 列が表示されていない場合でも、事前フェッチが起こることがあります。たとえば、総合計はレポート出力には表示されない場合がありますが、レポート内にあるので、Report Builderによる総合計の算出時には事前フェッチが起こることがあります。


ファイルまたはデータベースへの保存

パフォーマンスを重視するならば、モジュールはファイルに保存してください。また、機密性を重視するならば、それらをデータベースに保存してください。データベースからレポートをオープンまたはデータベースにレポートを保存する場合、Report Builderの一部の表は、メモリー中に置かれます。そのため、これらの表をキャッシュに入れるのに十分なリソースを確保する必要があります。

理由: ドキュメントの場合、書込みおよび読込みは、データベースよりもファイルの方が高速になる傾向があります。

例外: ファイルにアクセスする場合に、通信量の多いネットワークまたは処理速度の遅いマシンを使用する必要がある場合は、ファイルに保存してもパフォーマンスの向上は実感できません。


ファイル検索

ファイルの検索および一時ファイルの作成とアクセスを高速にするには、パス変数を指定します（Report Builderには、ファイルの検索場所と一時ファイルの格納先を管理する2つの環境変数REPORTS60_PATHおよびREPORTS60_TMPが提供されていることを思い出してください）。

REPORTS60_PATHの場合、レポートによって参照されるファイルがあるパスを指定します。REPORTS30_TMPの場合、一時ファイル用に十分な空き領域があり、応答時間の速いデバイス（たとえば、RAMディスク）上のパスを指定します。

理由: REPORTS60_PATHは、Report Builderでファイル（たとえば、リンク・ファイル・ボイラープレート）を検索するデフォルト・パスです。レポートによって参照されるファイルがあるパスを指定することによって、ファイルを取り出すためにReport Builderが実行する必要がある検索の量を削減できます（レポート定義にパスをハードコードするかわりにREPORTS60_PATHを使用することによって、レポートの移植性を維持することもできます）。REPORTS60_TMPは、Report Builderによって一時ファイルが作成されるパスです。


表の共有

複数のレポート設計者用に1組の表を使用します。Oracleでは、複数のレポート設計者が1組のReport Builderの表を共有できます。

理由: 表を共有すると、開発者の間でレポートを共有でき、1組の表をキャッシュに入れるのみで済みます。これによって、データベースからのレポートのオープンまたはデータベースへのレポート保存時のパフォーマンスが改善され、メモリーを節約できます。


クライアント/サーバー

強力なサーバーと高速なネットワークがある場合、Report Builderをサーバー上で実行したくなることがあります。多くの対話形式のレポート（たとえば、ドリルダウン）を行うつもりならば、ローカル・マシンにReport Builderを置くことを考えます。どちらの配置が最善かについては、システム管理者に問い合わせてください。

理由: クライアント/サーバー環境では、次の項目がReport Builderのパフォーマンスに重大な影響を与える可能性があります。

•	クライアント・マシンとサーバー・マシンの速度および負荷

•	ネットワーク・トラフィック


「レポート・トリガー」およびライブ・プレビューア

ライブ・プレビューアでは、「レポート・トリガー」が、ランタイム・プレビューア内とまったく同じようには起動しない場合があります。「レポート・トリガー」を正確にテストするには、ランタイム・プレビューアを使用します。


ライブ・プレビューアのリフレッシュ

場合によっては、プロパティ・パレットでオブジェクトを変更しても、その変更がライブ・プレビューアにすぐに反映されないことがあります。この場合は、変更の結果を見るためにレポートを再実行します。


HTML出力における切捨て

HTMLでは、7つのテキスト用サイズがあります。したがって、Report Builderはその7種類のテキスト・サイズに相当するフォントの範囲をマップすることになります。HTML出力のレポートを設計する際は、このようなフォントの範囲をマップすることにより発生するサイズの拡張に、フィールドとボイラープレート･テキストが対応できるものであることを確認してください。確認するためには、フォントの各範囲の中の一番大きなサイズを選択します（例8, 9, 12, 15, 20, 30）。また、単にフィールドとボイラープレート･テキストをどのような拡張にも対応できるサイズにしておく、という方法もあります。

レポートのフォント・サイズは、次の表に従ってマップされます。HTMLファイルで指定したサイズは、ブラウザから上書きできる点に注意してください。

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


HTML出力のマージン

ブラウザからレポートを出力するとき、レポートのページが途中で切れたように見えることがあります（例：切捨て）。これは、ブラウザのページ設定にマージンの指定が含まれている場合に起こり得ます。印刷するとき、そのマージンがレポート出力で指定されたマージンに追加されるため、切捨てが生じるわけです。正しく印刷するためには、ブラウザのページ設定におけるマージンをゼロにします。


グループ・フィルタ

  制限 	  例	  関連項目

説明  グループ・フィルタは「フィルタ・タイプ」プロパティが「PL/SQL」である場合に、グループにどのレコードを挿入するかを判断するPL/SQLファンクションです。ファンクションは、ブール値（TRUEまたはFALSE）を戻す必要があります。ファンクションがTRUEまたはFALSEのどちらを戻すかによって、レポートに対して現行のレコードが挿入されたり除外されたりします。グループ・フィルタには、オブジェクト・ナビゲータまたはプロパティ・パレット（「PL/SQLフィルタ」プロパティ）、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;


グループ・フィルタの制限

•	「フィルタ・タイプ」が「最初」または「最後」の場合、グループ・フィルタはグループに追加できません。

•	グループ・フィルタは、クロス積グループに追加できません。

•	グループ・フィルタでは、Report Builderの正しい頻度の列およびパラメータの値を読み込むことができますが（次のルールを参照）、これらの値を直接設定することはできません。たとえば、ある条件（IF :COUNT1 = 10 など）でCOUNT1というパラメータの値を使用することはできますが、代入文（:COUNT1 = 10など）に直接その値を設定することはできません。PL/SQLのグローバル変数を使って、間接的に列やパラメータの値を設定することもできない点にも注意してください。これを行うと、予期しない結果になる可能性があります。ページ依存の列（つまり、「リセット位置」が「ページ」に設定されている列）や、グループ・フィルタのページ依存の列に依存する列を参照することもできません。

•	グループ・フィルタに入力するファンクションは、次の列にのみ依存できます。

•	グループの問合せまたはデータ・モデル階層でそれより上のレベルにある問合せが所有するデータベース列。

•	関係付けられていない問合せ（つまり、グループおよびその上位グループ、下位グループの列に依存しない計算列）に依存する計算列（式またはサマリー）。


式

  例	  制限 	  関連項目

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

データ型がNumberである列には、データ型Numberの値を戻す式のみを使用できます。データ型がDateである列には、データ型Dateの値を戻す式のみを使用できます。データ型がCharacterである列には、データ型CharacterまたはVARCHAR、VARCHAR2の値を戻す式のみを使用できます。

定義レベル  列

失敗時  列に値が戻されません。


値を追加する式の例

  関連項目	 	  すべての例

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


条件付き式の例

  関連項目 	  すべての例

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;


式の制限

•	式では、正しい頻度の列およびプレースホルダ列、パラメータ（次のルールを参照）を読み込み、値を割り当てることができます。たとえば、ある条件（IF :COMP = 10など）でCOMPという列の値を使用し、代入文（:COMP := 15など）に直接その値を設定できます。

•	式は、グループ階層においてその列と同じか、それより高いレベルの列のみを参照できます。たとえば、レポート・レベルの列の式は、その他のレポート・レベルの列のみを参照できます。

•	式は、式で最初に参照される列が最初に計算されるように実行されます。そのために、Report Builderは依存性リストを作成し、計算が正しい順序で行われることを保証します。参照している列によって参照される循環依存は、直接、間接を問わず許されていないことに注意してください。

•	ユーザー・イグジットが変更できるのは、プレースホルダ列の値のみです。

•	SRW.DO_SQLを使っている場合、同じレポートで更新または挿入されたデータベースの値を読み込むことはお薦めしません。出力のフォーマットのためにReport Builderがデータベースからレコードをフェッチする正確な時刻は、保証されていません。Report Builderは、パフォーマンスを最適化するために、内部で「データの先取り」を行います。このように、特定のレコードに対して更新を発行する前に、すでにそのレコードにアクセスしている場合があります。Report Builderは、ユーザー・イグジットの起動やサマリーの計算などのイベントが正しい順序で発生することを保証する内部依存性リストを作成します。ただし、Report Builderでは、これらのイベントが内部データ・アクセスやデータのフォーマットと同期して発生するかどうかは保証できません。


妥当性チェック・トリガー

  例	  制限 	  関連項目

説明  妥当性チェック・トリガーは、パラメータ値をコマンド・ラインで指定する際およびランタイム・パラメータ・フォームを確定する際に実行されるPL/SQLファンクションです(これは、各妥当性チェック・トリガーが、レポート実行時に2回起動する可能性があるということを示しています)。妥当性チェック・トリガーは、パラメータの「初期値」プロパティの妥当性チェックにも使用されます。ファンクションは、ブール値（TRUEまたはFALSE）を戻す必要があります。ファンクションがTRUEまたはFALSEのどちらを戻すかによって、ユーザーはランタイム・パラメータ・フォームに戻ります。妥当性チェック・トリガーには、オブジェクト・ナビゲータまたはPL/SQLエディタ、プロパティ・パレット（「妥当性チェック・トリガー」プロパティ）からアクセスできます。

定義レベル  パラメータ

失敗時  ユーザーは、ランタイム・パラメータ・フォームのパラメータ値に戻り、値を変更するか、ランタイム・パラメータ・フォームを取り消すことができます。


妥当性チェック・トリガーの例

  関連項目 	  すべての例

/* This function prevents the runtime user from
** sending report output anywhere except a printer.
** The user will be returned to the Runtime Parameter
** Form unless PRINTER is specified as the destination
** type (DESTYPE).
*/

function DESTYPEValidTrigger return boolean is
begin
  IF UPPER(:DESTYPE) = 'PRINTER' THEN
  RETURN(TRUE);
ELSE
  RETURN(FALSE);
END IF;
end;


妥当性チェック・トリガーの制限

•	妥当性チェック・トリガーのPL/SQLには、最大32Kバイトまでの文字を使用できます。上限は、オペレーティング・システムによって異なる場合があります。

•	妥当性チェック・トリガーでは、Report Builderパラメータを読み込み、値を割り当てることができます。列を読み込んで値を割り当てることはできません。たとえば、ある条件（IF :COUNT1 = 10など）でCOUNT1というパラメータの値を使用することができ、代入文（:COUNT1 = 15など）に直接その値を設定できます。場合によっては、1つのパラメータで、何回も妥当性チェック・トリガーを起動させることができます。このため、通常は、After Parameter Form トリガーで、パラメータ値を割り当てるのが最善の方法です。PL/SQLのグローバル変数を使って、間接的に列の値を設定することはできない点にも注意してください。これを行うと、予期しない結果になる可能性があります。

•	妥当性チェック・トリガーでは、DDLは使用しないでください。

•	他のレポートから発生したプロセスであるレポート（BACKGROUND=YESで実行した場合など）では、レポートを実行する前に、BEFORE PARAMETER FORMトリガーおよびAFTER PARAMETER FORMトリガー、妥当性チェック・トリガーで行ったデータベースの変更をコミットする必要があります。発生したプロセスは、その親プロセスのデータベース接続をBEFORE PARAMETER FORMトリガーおよびAFTER PARAMETER FORMトリガー、妥当性チェック・トリガーに使用します。発生したプロセスがレポートを実行する場合には、個々のデータベース接続が確立されます。したがって、子レポートの実行時までにコミットされなかったデータベースの変更は失われます。


フォーマット・トリガー

  制限 	  例	  関連項目

説明  フォーマット・トリガーは、オブジェクトがフォーマットされる前に実行されるPL/SQLファンクションです。トリガーは、オブジェクトのフォーマット属性を動的に変更するのに使用できます。ファンクションは、ブール値（TRUEまたはFALSE）を戻す必要があります。ファンクションがTRUEまたはFALSEのどちらを戻すかによって、オブジェクトの現行のインスタンスがレポート出力に対して挿入されたり除外されたりします。フォーマット・トリガーには、オブジェクト・ナビゲータまたはプロパティ・パレット、PL/SQLエディタからアクセスできます。

定義レベル  レイアウト・オブジェクト

失敗時  出力からオブジェクトの現行のインスタンスを除外します。

使用上の注意

•	フォーマット・トリガーは、レポートによって取り出されるデータには影響しません。たとえば、フォーマット・トリガーがフィールドにFALSEを戻すと、出力にはフィールドは表示されませんが、フィールドのデータは取り出されます。

•	フォーマット・トリガーによってレポートの最終ページでレポート出力が非表示になる場合でも、最終ページはフォーマット設定され、適切な出力に送信されます。ページは合計ページ数に含まれます。


フォーマット・トリガーの例（値をハイライト表示する）

  関連項目 	  すべての例

/* Suppose that you are building a banking report and
** would like it to indicate if a customer is overdrawn.
** To do so, you give the repeating frame around the
** customer information a format trigger that causes
** it to have a border only if a customer's account
** balance is less than 0 (or the required minimum
**balance).
*/

function my_formtrig return BOOLEAN is
begin
if :bal < 0 then
   srw.attr.mask := SRW.BORDERWIDTH_ATTR;
   srw.attr.borderwidth := 1;
   srw.set_attr (0, srw.attr);
end if;
return (true);
end;


フォーマット・トリガーの例（ラベルを非表示にする）

  関連項目 	  すべての例

/* Suppose that you are building a master/detail report
** and, if no detail records are retrieved for a master
** record, you do not want the boilerplate labels to
** appear.To do this, you first create a summary
** column called MYCOUNT with a Function of Count in
** the source group of the master repeating frame.
** In the format trigger for the group frame that
** surrounds the detail repeating frame and its labels,
** you enter the following:
*/

function my_formtrig return BOOLEAN is
begin
if :mycount = 0 then
   return (false);
else
   return (true);
end if;
end;


フォーマット・トリガーの例（値を非表示にする）

  関連項目 	  すべての例

/* Suppose that you are building a salary report and
** you only want to see salaries above $2500. In the
** report summary of all salaries, however, you want all
** salaries to be included.To do this, you create a
** data model for the report without restricting the records
** retrieved.Then, you enter the following format trigger
** for the repeating frame.The report output will only
** show salaries greater than $2500, but the summary that
** calculates the sum of all salaries will include all the
** salaries retrieved from the database.
*/

function my_formtrig return BOOLEAN is
begin
if :sal > 2500 then
   return (true);
else
   return (false);
end if;
end;


フォーマット・トリガーの例（フィールド間にカンマを配置する）

  関連項目 	  すべての例

/* Suppose that you want to create a comma-separated
** list for the names of employees.First, you create
** a field inside a repeating frame with a Print
** Direction of Across.Next to the field, you create
** a boilerplate text object that contains a comma
** followed by a space.To ensure that the comma does
** not appear after the last name in the list, enter the
** following format trigger for the boilerplate object.
** LASTNAME is a summary column with a Source of ENAME,
** a Function of Last, and Reset At of Report.
*/

function my_formtrig return BOOLEAN is
begin
if :ename <> :lastname then
   return (true);
else
   return (false);
end if;
end;


フォーマット・トリガーの制限

注意: フォーマット・トリガーのPL/SQLは、Report Builderがレイアウト・オブジェクトをフォーマットするたびに実行されます。このため、フォーマット・トリガーには、フォーマット属性（カラーやハイライト表示など）を設定するPL/SQLプログラム単位のみが含まれている必要があります。トリガーがいつ、何回起動するかは予測できないので、表へのデータの挿入など、その他の操作を実行しないでください。たとえば、オブジェクトに「ページ保護」が設定されている場合、そのオブジェクトは、トリガーが起動される論理ページ上にフォーマットされない可能性があります。さらに、トリガーが2回以上実行される可能性があります。

•	フォーマット・トリガーがレポートの最終ページのオブジェクトについて偽を返し、最終ページ上の他のオブジェクトが書式設定されない場合、最終ページはブランク・ページになります。

•	PL/SQLコードに直接挿入するコメントには、PL/SQLコメント・デリミタを使用してください。

•	フォーマット・トリガーでは、Report Builderの正しい頻度の列およびパラメータの値を読み込むことができますが（次のルールを参照）、これらの値を直接設定することはできません。たとえば、ある条件（IF :COUNT1 = 10 など）でCOUNT1というパラメータの値を使用することはできますが、代入文（:COUNT1 = 10など）に直接その値を設定することはできません(この制限は、フォーマット・トリガーからコールされたユーザー・イグジットにも適用されます)。PL/SQLのグローバル変数を使って、間接的に列やパラメータの値を設定することもできない点にも注意してください。これを行うと、予期しない結果になる可能性があります。

•	オブジェクトのフォーマット・トリガー内の列または変数の頻度が、オブジェクトの頻度と異なる場合、参照できません。たとえば、マスター/ディテール・レポートを作成する場合、親グループの繰返し枠は、子グループの値に依存するフォーマット・トリガーを持つことはできません。各親に対して複数の子がある場合があります。そのため、親のレコード・レベルでは、Report Builderは、どの子レコードを使ったらよいかを判断できません。また、ページ依存の列（つまり、「リセット位置」が「Page」に設定されている列）や、フォーマット・トリガーのページ依存の列に依存する列を参照することもできません。これを行うと、結果として依存性が循環するためです。つまり、ページ依存の列はレポートがフォーマットされるまで計算できず、レポートは、フォーマット・トリガーが実行されるまでフォーマットできません。

•	フォーマット・トリガーがFALSEを戻し、オブジェクトがフォーマットされない場合、その他のオブジェクトは印刷されません。たとえば、繰返し枠がフォーマットされない場合、それが囲んでいるオブジェクト（フィールドまたはボイラープレート、枠、その他の繰り返し枠）もフォーマットされません。

•	繰返し枠では、フォーマット・トリガーは繰返し枠の各インスタンスに対して実行されます。繰返し枠のすべてのインスタンス上で一度に動作するフォーマット・トリガーを作成するには、繰返し枠の周囲に枠を作成し、その枠のフォーマット・トリガーを入力します。フォーマット・トリガーが、論理ページの繰返し枠のすべてのインスタンスにFALSEを戻した場合、繰返し枠は、論理ページ上に印刷されず、その他のオブジェクトへのアンカーは縮小します（指定した場合）。

•	フォーマット・トリガーのPL/SQLは、同じオブジェクトに対して首尾一貫した結果を戻す必要があります。たとえば、ある条件を満たした場合に、FALSEを戻すフォーマット・トリガーを持つ枠があるとします。枠が2ページにまたがっている場合、フォーマット・トリガーは、実際には2回起動します（枠がフォーマットされる各ページにつき1回ずつ）。PL/SQLの条件は、フォーマット・トリガーが起動する2回とも同じ結果を戻す必要があります。値が異なっていると、枠の一部しかフォーマットされません（最初のページの枠部分はフォーマットされても、2ページ目の枠部分はフォーマットされないなど）。

•	マトリックス・レポートの繰返し枠にあるフォーマット・トリガーがFALSEを戻した場合、マトリックスの行または列はまったくフォーマットされません。たとえば、横方向繰返し枠のインスタンスがフォーマットされない場合、マトリックスの列はまったくフォーマットされません。

•	マトリックスのセルを条件付きで変更する場合、マトリックス内のフィールドの周囲に枠を配置し、その枠に対してフォーマット・トリガーを使用してください。


アクション・トリガー

  例 	  関連項目

説明  アクション・トリガーは、ランタイム・プレビューアでボタンが選択されたときに実行されるPL/SQLプロシージャです。トリガーは、別のレポートを動的にコール（ドリルダウン）したり、他のPL/SQLを実行するのに使用できます。アクション・トリガーには、オブジェクト・ナビゲータまたはプロパティ・パレット（「PL/SQLトリガー」プロパティ）、PL/SQLエディタからアクセスできます。

定義レベル  ボタン

使用上の注意

•	PL/SQLアクション・トリガーは、ライブ・プレビューアではテストできません。これは、ライブ・プレビューアのボタンがアクティブではないためです。ランタイム・プレビューアを使用する必要があります（ライブ・プレビューアから「表示」 [image] 「ランタイム・プレビューア」を選択）。

•	PL/SQLインタプリタを使ってアクション・トリガーをデバッグできません。PL/SQLインタプリタはランタイム・プレビューアから使用できず、ライブ・プレビューアのボタンをアクティブにできないためです。別の方法として、アクション・トリガー・コードをレポート・トリガーに移動して、ライブ・プレビューアからそのコードをテストできます。


アクション・トリガーの例

  関連項目 	  すべての例

/* When the button is clicked, the action trigger
** defined by this procedure displays the Parameter
** Form for a report named web4.rdf, then displays
** the resulting report output on your screen.
*/

procedure U_1ButtonAction is
begin
  srw.run_report('module=web4.rdf destype=Screen paramform=yes');
end;


参照カーソル問合せ

  例 	  関連項目

説明  参照カーソル問合せは、レポートに対するデータをフェッチするためにPL/SQLを使用します。参照カーソル問合せでは、カーソル変数からカーソル値を返すPL/SQL関数を指定します。

定義レベル  問合せ

失敗時  問合せにデータは返されません。

使用上の注意

•	参照カーソル問合せをデータ・リンクの子に指定すると、グループ間のみでリンクされます。列間ではリンクされません。

•	参照カーソルをインプリメントするのにストアド・プログラム単位を使用すると、Oracleデータベースにプログラム単位で格納されるという利点もあります。


参照カーソルを使用したパッケージの例

  関連項目 	  すべての例

/* 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;


参照カーソルと関数を使用したパッケージ例

  関連項目 	  すべての例

/* 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;


参照カーソル問合せの例

  関連項目 	  すべての例

/* 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;


関数をコールする参照カーソル問合せの例

  関連項目 	  すべての例

/* 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 (e.g.,
** 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;


?


「After Parameter Formトリガー」

  関連項目

説明  「AFTER PARAMETER FORMトリガー」は、ランタイム・パラメータ・フォームが表示された後に起動します。このトリガーから、パラメータへアクセスし、その値を確認できます。このトリガーは、パラメータ値を変更したり、エラーが発生した場合にランタイム・パラメータ・フォームに戻るのにも使用できます。このトリガーから、データ・モデルの列にはアクセスできません。ランタイム・パラメータ・フォームが非表示であっても、「AFTER PARAMETER FORMトリガー」は起動します。したがって、このトリガーは、コマンド・ライン・パラメータやその他のデータの妥当性チェックに使用できます。

定義レベル  レポート

失敗時

ランタイム・パラメータ・フォームに戻ります。フォームが非表示の場合は、レポートを実行した場所に戻ります。


「After Reportトリガー」

  関連項目

説明  「After Reportトリガー」は、ランタイム・プレビューアを終了した後、あるいはレポート出力がファイル、プリンタ、メールIDなどの指定した宛先に送られた後に起動します。このトリガーは、表の削除などの完了した初期処理をクリーン・アップするのに使用できます。ただし、このトリガーは、レポートが正常に完了したかどうかにかかわらず、必ず起動することに注意してください。

定義レベル  レポート

失敗時

レポートが完了しているので、フォーマットの実行には影響しません。しかし、メッセージを呼び出して、レポートが正しく実行されなかったことを示すことができます。たとえば、「Before Reportトリガー」の変数にシステム時間を入れ、「After Reportトリガー」のシステム時間と比較できます。レポートの実行にかかった時間が一定の時間を超えた場合に、エラーを呼び出すことができます。

使用上の注意

•	ライブ・プレビューアでは、「After Reportトリガー」は起動されません。


「Before Parameter Formトリガー」

  関連項目

説明  「BEFORE PARAMETER FORMトリガー」は、ランタイム・パラメータ・フォームが表示される前に起動します。このトリガーから、パラメータおよびPL/SQLグローバル変数、レポート・レベルの列の値にアクセスし、変更できます。ランタイム・パラメータ・フォームが非表示であっても、このトリガーは起動します。したがって、このトリガーは、コマンド・ライン・パラメータの妥当性チェックに使用できます。

定義レベル  レポート

失敗時

エラー・メッセージを表示してから、レポートを実行した場所に戻ります。


「Before Reportトリガー」

  関連項目

説明  「BEFORE REPORTトリガー」は、問合せが解析されデータがフェッチされた後、レポートが実行される前に起動します。

定義レベル  レポート

失敗時

エラー・メッセージを表示してから、レポートを実行した場所に戻ります。


Between Pagesトリガー

  関連項目

説明  「BETWEEN PAGESトリガー」は、レポートの最初のページを除く各ページがフォーマットされる前に起動します。このトリガーは、カスタマイズされたページのフォーマットにも使用できます。ランタイム・プレビューアまたはライブ・プレビューアでは、このトリガーは、あるページに初めて進むときにのみ起動します。後からそのページに戻っても、トリガーは起動しません。

定義レベル  レポート

失敗時

トリガーがFALSEを戻したページに進もうとすると、エラー・メッセージが表示されます。FALSEが戻されたページに続くページはフォーマットされません。トリガーが最後のページでFALSEを戻しても、レポートのフォーマットは完了しているので何も起こりません。「BETWEEN PAGESトリガー」は、最初のページより前には起動しません。トリガーが最初のページでFALSEを戻すと、最初のページは表示されますが、2ページ目に進もうとすると、エラー・メッセージが表示されます。


使用する「レポート・トリガー」の選択

  例	  関連項目

一般的なルールとして、レポートによって取り出されるデータに影響する処理は、「BEFORE PARAMETER FORMトリガー」または「AFTER PARAMETER FORMトリガー」で実行する必要があります。（これら2つは、解析やフェッチが行われる前に起動する「レポート・トリガー」です。）レポートによって取り出されたデータに影響しない処理は、その他のトリガー内で実行できます。

Report Builderには、5つの「グローバル・レポート・トリガー」があります。新規の「グローバル・レポート・トリガー」作成はできません。トリガー名は、どの時点でトリガーが起動するかを示しています。

レポート前	問合せが解析された後、レポートが実行される前に起動します。
レポート後	プレビューアを終了した後、またはレポート出力がファイル、プリンタなどの指定した宛先に送られた後に起動します。このトリガーは、表の削除などの完了した初期処理をクリーン・アップするのに使用できます。ただし、このトリガーは、レポートが正常に完了したかどうかにかかわらず、必ず起動することに注意してください。
BETWEEN PAGES	レポートの最初のページを除く各ページがフォーマットされる前に起動します。このトリガーは、カスタマイズされたページのフォーマットにも使用できます。プレビューアでは、このトリガーは、あるページに初めて進むときにのみ起動します。後からそのページに戻っても、トリガーは起動しません。
BEFORE PARAMETER FORM	ランタイム・パラメータ・フォームが表示される前に起動します。このトリガーから、パラメータおよびPL/SQLグローバル変数、レポート・レベルの列の値にアクセスし、変更できます。ランタイム・パラメータ・フォームが非表示であっても、このトリガーは起動します。したがって、このトリガーは、コマンド・ライン・パラメータの妥当性チェックに使用できます。
AFTER PARAMETER FORM	ランタイム・パラメータ・フォームが表示される前に起動します。このトリガーから、パラメータへアクセスし、その値を確認できます。このトリガーは、パラメータ値を変更したり、エラーが発生した場合にランタイム・パラメータ・フォームに戻るのにも使用できます。このトリガーから、データ・モデルの列にはアクセスできません。ランタイム・パラメータ・フォームが非表示であっても、「AFTER PARAMETER FORMトリガー」は起動します。したがって、このトリガーは、コマンド・ライン・パラメータやその他のデータの妥当性チェックに使用できます。


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

  関連項目

レポートが実行される際のイベントの順序は次のようになります。

1	「BEFORE PARAMETER FORMトリガー」が起動されます。

2	ランタイム・パラメータ･フォームが表示されます（非表示でない場合）。

3	「AFTER PARAMETER FORMトリガー」が起動されます（ユーザーがランタイム・パラメータ・フォームから取り消さない場合）。

4	レポートが"コンパイル"されます。

5	問合せが解析されます。

6	「Before Reportトリガー」が起動されます。

7	SET TRANSACTION READONLYが実行されます（READONLY引数または設定によって指定した場合）。

8	レポートが実行され、最終ページ以外の各ぺ-ジに対してBetween Pagesトリガーが起動されます（レポートのフォーマット中にはいつでもデータをフェッチすることができます）。この間ユーザー・イグジットでDDLを使用している場合、またはSRW.DO_SQLでDDLを使っている場合、ONFAILURE=COMMITと指定されていてレポートが失敗した場合、のうちいずれかの場合にCOMMITが発生します。

9	COMMITが実行されて、（READONLYが指定されている場合は）トランザクションが終了します。

10	「After Reportトリガー」が起動されます。

11	ONSUCCESS引数または設定に指定した内容に基づいて、COMMIT、ROLLBACK、NOACTIONのいずれかが実行されます。

注意

•	ステップ4から9では、レポートの基になる表を変更するようなDDL文は避けてください。ステップ3で表のスナップショットが取られ、これはレポートの実行中ずっと有効である必要があります。ステップ7から9では、レポートの基になる表の内容を変更するようなDML文は避けてください。問合せは、どのような順序で実行してもかまいませんが、（そのレポートで使用されていない表で実行されない限り）DML文は信頼できないものになります。

•	READONLYを指定した場合、DDLを一緒に指定しないでください。DDL文を実行すると（たとえば、SRW.DO_SQLまたはユーザー・イグジットを介して）、COMMITが自動的に発行されます。READONLYを使っている場合は、SET TRANSACTION READONLYで開始されたトランザクションを途中で終了してしまいます。


「レポート・トリガー」の制限

•	レポート出力をランタイム・プレビューアまたはライブ・プレビューアに送っている場合、レポート出力が表示される前に、「レポート・トリガー」のいくつかまたはすべてが起動される場合があることに注意してください。たとえば、SRW.MESSAGEを使って、ある条件が満たされた場合に「BETWEEN PAGESトリガー」でメッセージを発行するとします。レポートに前方参照がある場合（最終ページまでに表示されるページの総数など）、Report Builderは前方参照を計算する前にフォーマットを行う必要がある場合があります。そのため、まだページが表示されていなくても、そのページはすでにフォーマットされ、トリガーが起動している可能性があります。

•	「レポート・トリガー」では、レポート・レベルの列およびパラメータの値を使用できます。たとえば、ある条件（IF :COUNT1 = 10など）でCOUNT1というパラメータの値を使用する必要がある場合があります。しかし、ページ依存の列（「リセット位置」が「Page」に設定されている列）またはページ依存の列に依存する列を参照できないことに注意してください。

•	「BEFORE PARAMETER FORMトリガー」および「AFTER PARAMETER FORMトリガー」と「Before Reportトリガー」および「After Reportトリガー」では、パラメータの値を設定できます（例 代入文:COUNT1 = 15で値を指定）。「Before Reportトリガー」および「After Reportトリガー」では、レポート・レベル、プレースホルダなどの列の値も設定できます。

•	「BETWEEN PAGESトリガー」には、データ・モデル・オブジェクトの値を設定できません。PL/SQLのグローバル変数を使って、間接的に列やパラメータの値を設定することもお薦めしません。これを行うと、予期しない結果になる可能性があります。

•	Report Builderランタイムからレポートを実行する場合（つまり、コマンド・ラインやSRW.RUN_REPORTではなく）、レポートを実行する前に、「BEFORE PARAMETER FORMトリガー」および「AFTER PARAMETER FORMトリガー」、妥当性チェック・トリガーで行ったデータベースの変更をコミットする必要があります。この方法で実行している場合、これらのトリガーは、親プロセスのデータベース接続を共有します。ただし、レポートが実際に実行されると、個々のデータベース接続が確立されます。

•	「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


?


プロシージャ・コールの構文

  関連項目

Report Builder付属のプロシージャには、次の2つのタイプがあります。

•	1つのパラメータ（コールされる実行プログラムに有効なReport Builderコマンド･ライン）を指定するプロシージャ

•	2つのパラメータ（コールされる実行プログラムに有効なReport Builderコマンド･ラインとその文字列の長さ）を指定するプロシージャ

（ご使用のプログラム言語がNULLで終了する文字列に対応していない場合は、2つのパラメータを指定するプロシージャが便利です。)

Report BuilderのCプロシージャ名は、次のとおりです。

実行プログラム	プロシージャ（1パラメータ）	プロシージャ（2パラメータ）

RWCON60	RWCCON	RW2CON

RWRUN60（ビットマップ）	RWCRRB	RW2RRB

RWRUN60（キャラクタ・モード）	RWCRUN	RW2RUN

RWBLD60（ビットマップ）	RWCSRB	RW2SRB

Cの例

RWRUN60プロシージャ・コールの例（Cで記述）は、次のとおりです。

実行プログラム	プロシージャ名	プロシージャ・コールの構文

RWRUN60	RWCRRB	long rwcrrb
（ビット・マップ）	( /*_ char _*/ )

RWRUN60	RWCRUN	long rwcrun
（キャラクタ・モード）	( /*_ char _*/ )

RWRUN60	RW2RRB	long rw2rrb
（ビット・マップ）	( /*_ char *, long * _*/ )

RWRUN60	RW2RUN	long rw2run
（キャラクタ・モード）	( /*_ char *, long * _*/ )

Report BuilderのRWRUN60プロシージャ・コールの例（一般的なCプログラム）は、次のとおりです。

1つのパラメータ・コール

long ret, rwcrun (); if (ret = rwcrun ("report=areport userid=scott/tiger myparam=AB") )	goto error;

2つのパラメータ・コール

long len, ret, rw2run (); len = 44;  if (ret = rw2run ("report=areport userid=scott/tiger myparam=AB", &len) ) 	goto error;

使用上の注意

•	ライブラリRWOCI60.LIBは、Windowsの32ビット・プラットフォーム(Windows95またはNT)用に用意されています。OCIライブラリのコール方法を示すサンプルのCプログラム(ocismp.c)は、SAMPLESディレクトリに含まれています。このCプログラムのメークファイルであるocismp.mak (Microsoft Visual C++用)は、参照用に含まれています。

•	新しいプロジェクトを作成する場合、Cファイルと共にプロジェクトに追加する必要のある標準OCIファイル(%ORACLE_HOME%\REPORT30\OCIに格納されている)を次に示します。

rwbld60.res	Report Builderのリソース・ファイル
rwoci.h	ヘッダー・ファイル
rwoci60.lib	Report Builderのライブラリ
•	RWOCI60.DLLを現行のPATH設定でアクセス可能な状態にしておく必要があります。


プロシージャ・コールのエラー・チェック

  関連項目

プロシージャ・コールでエラーが発生すると、プログラムに正の整数が戻されます。エラーがなければ、ゼロ（0）が戻されます。


プロシージャ・コールの制限

  関連項目

•	上の例のように、ユーザーIDとパスワードがコマンド･ラインで指定されている場合、Report BuilderではそのOracleアカウントへのログオンが試みられます。

•	コール側のプログラムがすでにOracleにログオンしている場合は、すでにアクティブになっているログオンがReport Builderで使えるように、コマンド･ラインにユーザーIDとパスワードを指定しないようにしてください。

•	Report Builderは、Oracleにログオンしている場合のみ、Oracleからログオフします。コール側のプログラムがログオン済みであれば、そのログオンはReport Builderを終了してもアクティブのままです。

•	RWBLD60とRWRUN60用のONSUCCESSキーワードとONFAILUREキーワードによって、レポートが正しく実行された後または失敗した後に、Report BuilderでCOMMITするか、ROLLBACKするかまたは何もしないかを指定します。

•	プロシージャ・コールの最大長は、英数字で2,047字です。

•	Report Builderのプロシージャ・コール（RWCRUNなど）は、Cで書かれています。ご使用のホスト言語（AdaまたはC、COBOL、FORTRAN、Pascal、PL/1）のコンパイラによって、プログラムからCのサブルーチンに引数を渡す方法が異なることがあります。Cプロシージャ・コールとのインタフェースの詳細は、コンパイラのマニュアルを参照してください。

•	実行プログラムがコールされると、そのプログラムは、SERVERおよびBACKGROUNDのコマンド・ライン引数の種類に応じて、レポートを別のプロセスまたは同一プロセスとして実行します。SERVERおよびBACKGROUNDにNOを指定した場合、レポートはReports Serverによって同期的に実行されます。SERVERおよびBACKGROUNDにYESを指定した場合、レポートはReports Serverによって非同期的に実行されます。SERVERおよびBACKGROUNDにNOを指定しない場合、レポートはユーザーのアプリケーションで実行されます。SERVERおよびBACKGROUNDにYESを指定しない場合、レポートはReportsバックグラウンド・エンジンによって実行されます。


プロシージャ・コールのプログラム例

  関連項目

コール･インタフェースの例は、$ORACLE_HOME/REPORT60/OCI/Samplesを参照してください。$ORACLE_HOME/REPORT60/OCIにあるoci_info.txtというファイルも参照してください。

次に、RWRUN60実行プログラムに対するプロシージャ・コールの例を示します。各プログラムは、異なるOracleプログラム・インタフェース・ホスト言語で書かれています。

Ada

C

COBOL

FORTRAN

Pascal

PL/l

これらのサンプル・プログラムは、標準のVAXコンパイラを使用してVMS上で実行され、Report Builderライブラリとリンクされました。

注意: サブルーチン・コールの正確な構文は、使用しているホスト言語のコンパイラによって異なる場合があります。


Adaの例

  関連項目 	  すべての例

with TEXT_IO; use TEXT_IO ;
procedure srwada  is

usr	: : STRING(1..11) := "Scott/Tiger";
S	: : STRING(1..160);
RES 	: : STRING(1..10);
LEN 	: INTEGER;

function rwcrun ( S :string) return Integer;
pragma interface (C,rwcrun);
pragma import_function ( internal = RWCRUN ,
PARAMETER_TYPES = (STRING),
MECHANISM = (REFERENCE),
RESULT_MECHANISM = VALUE,
RESULT_TYPE = INTEGER);

package INT_IO is new INTEGER_IO (INTEGER); use INT_IO;
ret_code	: : INTEGER;

begin
S(1..79) := "REPORT=T USERID=SCOTT/TIGER PARAMFORM=NO
  DESNAME=ADA.TXT DESTYPE=FILE BATCH=YES";
S(80) := standard.ASCII.nul;	-- null terminating
-- the string

PUT_LINE (" About to call rwcrun #1 ");
ret_code := rwcrun (S);
if ret_code = 0 then
  PUT_LINE(" Rwcrun was called successfully ");
else
  PUT_LINE(" the returned code is ");
put (ret_code);new_line;
  PUT_LINE (" Error occurred when Runform was called");
end if;

end srwada;


Cの例

  関連項目 	  すべての例

#include <stdio.h>
long  ret,
rwcrun (),
rwcsql ();
main()
{
  char options[132];
  long len;
  strcpy(options,"userid=scott/tiger report=t batch=yes
  paramform=no destype=file desname=report.txt");
  printf("\nOptions are:%s", options);
  len=strlen (options);
  ret=rw2run(options);
  printf ("\nValue of return code is %d", ret);
  exit();
}


COBOLの例

  関連項目 	  すべての例

IDENTIFICATION DIVISION.
PROGRAM-ID. COBREP.
ENVIRONMENT DIVISION.
DATA DIVISION.
WORKING-STORAGE SECTION.
*
01  OPTIONS.
  02  OPTION-TEXT	PIC X(132) VALUE "REPORT=SAMPLE1
USERID=SCOTT/TIGER BATCH=YES PARAMFORM=NO DESTYPE=FILE
DESNAME=SAMPLE1.TXT".
  02  FILLER 	PIC S9(4) COMP VALUE 0.
*
01  RETURN-CODE 	PIC S9(9) COMP.
PROCEDURE DIVISION.
MAIN-PROGRAM.
CALL "RWCRUN"
  USING BY REFERENCE OPTIONS
  GIVING RETURN-CODE.
DISPLAY "Return code after first call to rwcrun is "
RETURN-CODE
STOP RUN.


FORTRANの例

  関連項目 	  すべての例

program fortran
 integer*4 status
 integer*4 rwcrun
 character*100 command
 command = 'report=test userid=system/manager batch=yes
1 destype=file desname=fortran.txt paramform=no'
 status = rwcrun (%REF(command))
 write(*,1) status
1 format(1x,I4)
 end


Pascalの例

  関連項目 	  すべての例

PROGRAM srwpas(input,output);
Type
short = [WORD]  -32768..32767;
OptType = packed array[1..256] of char;
[external] function rwcrun (var options :OptType) :
  short Extern;
Var
Options :OptType;
RetCode :short;
Begin
Options := 'USERID=SCOTT/TIGER BATCH=YES REPORT=PASCAL 	PARAMFORM=NO';
Options[56] := CHR(0);
RetCode := rwcrun(options);
Writeln ('Return code from first call is ', RetCode);
End.


PL/l例

  関連項目 	  すべての例

PLI:PROCEDURE OPTIONS(MAIN);
DECLARE OPTIONS CHAR(100),
 PART1   CHARACTER(79) DEFINED OPTIONS,
 ENDCHAR CHARACTER(1) DEFINED OPTIONS POSITION (100);
DECLARE RWCRUN ENTRY (CHARACTER(100))  RETURNS (FIXED
 BINARY(15));
DECLARE RETCODE FIXED BINARY(15);
 PART1='USERID=SCOTT/TIGER BATCH=YES REPORT=T
 DESNAME=PLI.TXT DESTYPE=FILE PARAMFORM=NO';
 ENDCHAR = LOW(1);
PUT SKIP EDIT('Options are:', OPTIONS) (A,A);
RETCODE = RWCRUN(OPTIONS);
PUT SKIP EDIT('Return Code is ', RETCODE) (A, B(15));
PUT SKIP(2) LIST('************');
END PLI;


ユーザー・イグジットのタイプ

  関連項目

次のタイプのユーザー・イグジットを作成できます。

Oracleプリコンパイラ・ユーザー・イグジット

OCI（Oracleコール・インタフェース）ユーザー・イグジット

非Oracleユーザー・イグジット

Oracleプリコンパイラ・インタフェースとOCIを結合するユーザー・イグジットを作成することもできます。


Oracleプリコンパイラ・ユーザー・イグジット

Oracleプリコンパイラ・ユーザー・イグジットでは、Oracleプリコンパイラ・インタフェースを組込みます。このインタフェースは、次の機能をサポートしています。

•	ホスト言語（Ada、C、COBOL、FORTRAN、Pascal、PL/1）の1つでサブルーチンを作成し、SQLコマンドを埋め込むことができます。

•	ユーザー・イグジットにより、Oracle（埋め込みSQLコマンドを介して）とReport Builder変数およびパラメータ、列にアクセスできます。

これらの機能があるため、ほとんどのユーザー・イグジットはOracleプリコンパイラ・ユーザー・イグジットとして作成します。

Oracleプリコンパイラ・インタフェースの詳細は、『Oracleプリコンパイラ・プログラマーズ・ガイド』を参照してください。

注意: オペレーティング・システムによっては、前述の言語をすべてサポートするわけではありません。


OCI（Oracleコール・インタフェース）ユーザー・イグジット

OCIユーザー・イグジットでは、Oracleコール・インタフェースを組み込みます。このインタフェースによって、Oracleへのコールを含むサブルーチンを作成できます。（Oracleプリコンパイラ・インタフェースを組み込まず）OCIのみを組み込むユーザー・イグジットでは、Report Builder変数およびパラメータ、列にアクセスできません。

OCIの詳細は、『Oracleコール・インタフェース・プログラマーズ・ガイド』を参照してください。


非Oracleユーザー・イグジット

非Oracleユーザー・イグジットでは、Oracleプリコンパイラ・インタフェースもOCIも組み込まれません。たとえば、非Oracleユーザー・イグジットを、C言語のみで書くこともできます。非Oracleユーザー・イグジットでは、OracleまたはReport Builder変数、パラメータおよび列にアクセスできません。


ユーザー・イグジットの作成

ユーザー・イグジットを作成するには、ユーザー・イグジットに関する次の知識が必要になります。

  サポートされているファンクション

  渡されるユーザー・イグジット・コールの構文

  エラーのチェックと呼出し

使用上の注意

•	Oracleプリコンパイラ・ユーザー・イグジットから、ホスト言語画面I/Oを実行することはできません。この制限があるのは、ホスト言語が画面I/Oを実行するのに使用するランタイム・ルーチンと、Report Builderが画面I/Oを実行するのに使用するルーチンが競合するからです。

•	この項は、特にOracleプリコンパイラ・ユーザー・イグジットについて説明します。ユーザー・イグジットは最もよく使用されるもので（Report Builder変数、パラメータおよび列と、Oracleのデータにアクセスできます）、ほとんどの作業にご使用をお薦めします。

•	この項では、ユーザー・イグジットのコールの作成方法（つまり、Report Builder内でのユーザー・イグジットの起動方法）は説明しません。ユーザー・イグジットのコールの作成方法の詳細は、「ユーザー・イグジットのコール」を参照してください。


サポートされているファンクション

Oracleプリコンパイラのホスト言語の1つを使用してユーザー・イグジットを作成する場合、そのユーザー・イグジットで、ホスト言語の文を介して手続き操作を、また次のタイプの文を介してさらに別のファンクションを実行できます。

文のタイプ	機能
EXEC SQL	SQLコマンドを実行します。
EXEC IAF GET	Report Builderからユーザー・イグジットへ値を渡します。
EXEC IAF PUT	ユーザー・イグジットからReport Builderへ値を渡します。
EXEC ORACLE	Oracleプリコンパイラのオプションを実行します。


EXEC SQL文

EXEC SQL文は、"EXEC SQL"を前に付けたSQLコマンドです。EXEC SQL文を使用すると、Oracleプリコンパイラ・ユーザー・イグジットで任意のSQLコマンドを実行できます。これは、ユーザー・イグジットからデータベースのデータを選択または操作する手段です。

構文

EXEC SQL sql_statement;

この場合:

sql_statement	この項で説明している制限付きコマンドを除く、任意の有効なOracle SQL文です。

Report Builderでは、接続が自動的に確立されるので、Oracleプリコンパイラ・ユーザー・イグジットで明示的にCONNECTを実行する必要はありません。ただし、Oracleでは同時接続がサポートされていません。詳細は、『Oracleプリコンパイラ・プログラマーズ・ガイド』を参照してください。

注意: READONLYを指定する場合、データ定義言語（DDL）は使用しないでください。DDL文を実行すると（たとえば、SRW.DO_SQLまたはユーザー・イグジットを介して）、COMMITが自動的に発行されます。READONLYを使っている場合は、SET TRANSACTION READONLYで開始されたトランザクションを途中で終了してしまいます。詳細は、「READONLY」を参照してください。

使用上の注意

•	RWBLD60とRWRUN60用のONSUCCESSキーワードとONFAILUREキーワードによって、レポートが正しく実行された後または失敗した後に、Report BuilderでCOMMITするか、ROLLBACKするかまたは何もしないかを指定します。これ以外のときにCOMMITする場合は、ユーザー・イグジットまたはPL/SQL（ユーザー・イグジットのコールの後に、SRW.DO_SQL('commit');を追加）を使用できます。


EXEC IAF GET

EXEC IAF GET文は、Report BuilderからOracleプリコンパイラ・ユーザー・イグジットに値を渡します。具体的には、Report Builderパラメータまたは列の値を、ホスト言語の変数に入れます。Report Builderからユーザー・イグジットへ値が渡されると、ユーザー・イグジットではその値を使用して計算または操作、更新を行うことができます。

構文

EXEC IAF GET report_variable_1[, report_variable_2, ...]INTO :host_variable_1[, :host_variable_2, ...];

この場合:

report_ variable_n	値を読み込むReport Builderパラメータまたは列の名前が入ります。

host_variable_n	値を入れるホスト言語変数の名前です。

使用上の注意

•	report_variable_nは、次の項目を参照できます。

•	明確なReport Builderパラメータまたは列の名前（現在の日付を知るには、ソースを&DATEにしてパラメータを作成し、そのパラメータの値をGETします。現在の論理ページ番号を知るには、SRW.GET_PAGE_NUMパッケージ・ファンクションをコールし、その値をユーザー・イグジットのコールを介してユーザー・イグジットに渡します。

•	値が前述の2項目のいずれかである（コロンが前に付いた）ホスト言語変数。

•	渡される列にNULLの場合の値が指定されていると、EXEC IAF GETはその列のNULL値のかわりにこの値を使用します。NULLの場合の値が指定されていないと、EXEC IAF GETによって戻される値はありません。値が戻されるようにするには、EXEC IAF GETを実行する前に、ホスト言語の変数の値を設定する必要があります。そうすれば、変数の値が実際にEXEC IAF GETによって変更されたかどうかがわかります。

•	ホスト言語変数の制限の詳細は、『Oracleプリコンパイラ・プログラマーズ・ガイド』を参照してください。

•	Report Builderオブジェクトのデータが64,000バイトより長い場合、EXEC IAF GETから戻される値は左揃え64,000バイトに切り捨てられます。


EXEC IAF PUT

EXEC IAF PUT文は、Oracleプリコンパイラ・ユーザー・イグジットからReport Builderに値を渡します。具体的には、定数の値またはホスト言語変数の値を、Report Builderパラメータまたは列に入れます。

構文

EXEC IAF PUT report_variable[, ...]VALUES ({:host_variable | constant}[, ...]);

この場合:

report_variable	値を入れるReport Builderパラメータまたは列の名前、あるいはその値がReport Builderパラメータまたは列の名前である（コロンが前に付いた）ホスト言語変数です。

host_variable	値を読み込むホスト言語変数の名前です。

constant	読み込む定数です。

使用上の注意

•	64,000バイトより長いデータは、EXEC IAF PUTでは、Report BuilderのオブジェクトにEXEC IAF PUTすることはできません（データは左揃えの64,000バイトに切り捨てられます）。

•	ホスト変数と定数は、次の標準的なSQL書式で表す必要があります。

•	文字列と定数はそのまま渡します。

•	日付はYYYYMMDDHH24MISSの書式で渡します。

•	ホスト変数の前には、コロン（:）を付けます。

•	次の表に例を示します。

値	結果

Summit Sporting 	定数文字列値Summit
Goods	Sporting Goodsが渡されます。

413.60	定数数値413.60が
渡されます。

19910414083000	日付1991年4月14日 8:30
A.M.が渡されます。

:holder1	ホスト変数値holder1
が渡されます。


EXEC ORACLE文

EXEC ORACLE文は、標準的なSQLではなく、Oracleプリコンパイラのオプションを実行するのに使用される文です。詳細は、『Oracleプリコンパイラ・プログラマーズ・ガイド』を参照してください。

使用上の注意

注意: READONLYを指定する場合、データ定義言語（DDL）は使用しないでください。DDL文を実行すると（たとえば、SRW.DO_SQLまたはユーザー・イグジットを介して）、COMMITが自動的に発行されます。"READONLY"を使用している場合は、SET TRANSACTION READONLYで開始されたトランザクションを途中で終了してしまいます。

•	RWBLD60とRWRUN60用のONSUCCESSキーワードとONFAILUREキーワードによって、レポートが正しく実行された後または失敗した後に、Report BuilderでCOMMITするか、ROLLBACKするかまたは何もしないかを指定します。これ以外のときにCOMMITする場合は、ユーザー・イグジットを使用できます。

•	ユーザー・イグジットからホスト言語ファイルI/Oを実行できます。


渡されるユーザー・イグジット・コールの構文

ユーザー・イグジット・プログラムは、1つの文字列としてユーザー・イグジット・コールを受け取ります。この文字列にはuser_exit_name、オプションとしてargument_listが入ります。argument_list中の引数は、スペース1つで区切られます。

例

次のコール

SRW.USER_EXIT('quota 10 20 Q4');

は、ユーザー・イグジットに次のように渡されます。

'quota 10 20 Q4'

次のコール

SRW.USER_EXIT('quota');

は、ユーザー・イグジットに次のように渡されます。

'quota'

使用上の注意

•	ユーザー・イグジットのコール文字列を解析するのは、Report Builderではなく、ユーザー・イグジットです。

•	ユーザー・イグジット名と一緒に渡される引数の間に2つ以上のスペースがある場合、Report Builderでは、余分なスペースを削除してから、ユーザー・イグジットにその文字列を渡します。

たとえば、次のコール

   'quota 10 20 Q4'

は、ユーザー・イグジットに次のように渡されます。

   'quota 10 20 Q4'


ユーザー・イグジットからのエラーの呼出し

ユーザー・イグジット・プログラムでは、エラー・メッセージを定義し、そのエラー文字列をSRWERBエラー・バッファにコピーすることで、Report Builderのメッセージ領域に呼び出すことができます。

注意: Report Builderでは、PL/SQLを使ってエラー・メッセージを定義し、呼び出すことができます。詳細は、「ユーザー・イグジットのコール」を参照してください。

SRWERBエラー・バッファの使用

指定された256バイトのバッファSRWERBにエラー文字列を書き込むことにより、ユーザー・イグジットでエラー・メッセージを定義できます。Report Builderでは、レポートの実行時にSRWERBバッファが初期化されます。Report Builderがユーザー・イグジットから戻されたときに、バッファが空でなければ（つまり、バッファの最初の文字がNULLでなければ）、Report Builderでは、バッファ内にあるものがエラー・メッセージとして表示されます。


ユーザー・イグジットのインプリメント

次の2つのうちのいずれかの方法で、ユーザー・イグジットをインプリメントできます。

•	サンプル・ソース・ファイルの変更（最も簡単な方法）

•	IAPXTB表からのソース・ファイルの作成

注意: サンプル・ソース・ファイルの変更が最も簡単な方法です。


サンプル・ソース・ファイルの変更

ユーザー・イグジットのインプリメントは、各ユーザー・イグジットのサンプル・ソース・ファイルue_xtb.cにエントリを追加するのみでできます。オペレーティング・システムによって、このファイルの場所は異なります。

次にサンプル・ソース・ファイルを示します。

/* Define the user exit table */
extern exitr iapxtb[] =  {  /* Holds exit routine pointers */     "UE_OK",         ue_ok, XITCC,
"UE_ERR",        ue_err, XITCC,
"UE_MB",         ue_mb,  XITCC,
"UE_EMP_PLAN",   ue_emp_plan,  XITCC,
(char *) 0, 0, 0         /* zero entry marks the end */
};

/* end iapxtb */

エントリの最初の項目は、Report Builderでユーザー・イグジットを参照するのに使用する名前（二重引用符の中）です。2番目の項目は、ユーザー・イグジット・ルーチンの実際の名前です。最後の項目（XITCC）は、C言語を使ってユーザー・イグジットがコールされることを示します。その他の言語については、この最後の項目に次のものを使用します。

XITCOB /* COBOL */

XITFOR /* FORTRAN */

XITPLI /* PL/I */

XITPAS /* PASCAL */

XITAda /* ADA */

ソース・ファイルを変更したら、ソース・ファイルとユーザー・イグジット・プログラムをコンパイルします。次に、その結果できたIAPXTBオブジェクト・ファイルを、RWBLD60またはRWRUN60実行可能プログラムの一方、あるいは両方にリンクします。


IAPXTB表からのソース・ファイルの作成

IAPXTB表からソース・ファイルを作成するには、次の作業を行います。

1	IAPXTB表を作成します。

2	各ユーザー・イグジット名（ユーザー・イグジットごとに1行）をIAPXTB表に挿入します。

3	IAPXTB表からソース・ファイルを生成し、作成したプログラムと一緒にコンパイルします。その結果できたオブジェクト・モジュールをRWBLD60およびRWRUN60にリンクします。

どのオペレーティング・システムでユーザー・イグジットをインプリメントする場合にも、GENXTBプログラムとGENXTB Form Builderフォームを使用可能にする必要があります。

注意: ユーザー・イグジットをインプリメントするプロセスは、オペレーティング・システムによって異なります。


IAPXTB表の作成

GENXTBプログラムを使って、GENXTB Form Builderフォームで使用される実表となるIAPXTB表を作成します。Form Builderがない場合は、SQL*Plusを使ってIAPXTB表を作成してください。表の作成方法の詳細は、『Oracle8 Server SQLリファレンス』を参照してください。

構文

IAPXTB表では、Report Builderにリンクするすべてのユーザー・イグジットをリストします。次にIAPXTB表の各列について説明します。

列名	説明	使用方法
XTB$XNM	NAME	この列では、ユーザー・イグジットの名前を指定します。(必ずしもユーザー・イグジットを含むファイルの名前である必要はありません)。ホスト言語によっては、大/小文字の区別があるので注意してください。
XTB$XTY	TYPE	この列では、ユーザー・イグジットの作成に使用した言語を指定します。
XTB$REM	REMARKS	この列では、ユーザー・イグジットの用途を記述するテキスト文字列を指定します。この文字列の最大長は80文字です。
XTB$CRE	CREATION	この列では、IAPXTB表でレコードを作成した日付を指定します。レコードをコミットすると、GENXTBフォームでは、この列に値が自動的に入力されます。
XTB$MOD	MODIFY	この列では、IAPXTB表でレコードを最後に変更した日付を指定します。レコードをコミットすると、GENXTBフォームでは、この列に値が自動的に入力されます。
注意: 表が誤って削除された場合のために、別のIAPXTB表にテキスト形式のユーザー・イグジットを保存しておいてください。


IAPXTB表への行の挿入

Form Builderフォームの1種であるGENXTBフォームを使用し、IAPXTB表にユーザー・イグジットの記述を挿入します。Form Builderがない場合は、SQL*Plusを使用して行を挿入します（表に行を挿入する方法の詳細は、SQL*Plusのマニュアルを参照してください）。

各ユーザー・イグジット名に対して、IAPXTB表に1行挿入する必要があります（ユーザー・イグジットが、プリコンパイルおよびコンパイルを単独で行うファイルにあるか、または他のユーザー・イグジットと一緒にコンパイルするファイルにあるかにかかわらず、この条件はすべてのOracleプリコンパイラ・ユーザー・イグジットに当てはまります）。また、システム用のすべての本番ユーザー・イグジットは、1つのIAPXTB表でメンテナンスする必要があります。

使用上の注意

•	GENXTB表には、使用するすべてのユーザー・イグジット名を入れる必要があります。たとえば、Form Builderユーザー・イグジットが入っているGENXTB表がすでにある場合、Report Builderパッケージ・ユーザー・イグジット（つまり、RWECPF、RWEPLS、RWEATS、RWECAT、RWECTY）と、新規に作成したすべてのユーザー・イグジットを追加する必要があります。


ソース・ファイルの生成とコンパイル

GENXTBプログラムを使って、IAPXTB表の情報を読み込み、そのソース・ファイルを生成します。このソース・ファイルは、ユーザー・イグジットをリンクするのに必要なエントリ・ポイント・ファイルです。

IAPXTBソース・ファイルとユーザー・イグジット・プログラムをコンパイルします。次に、その結果できたIAPXTBオブジェクト・ファイルを、RWBLD60またはRWRUN60実行可能プログラムの一方、あるいは両方にリンクします。


Windows NTおよびWindows 95でのユーザー・イグジットDLLの作成

Windows NTおよびWindows 95でユーザー・イグジットを作成するには、R60XTB32.DLLという名前のDLLを作成する必要があります(作成する場合、コンパイラのマニュアルにある標準ガイドライン従ってください)。

例

次の例では、Windows 32ビット・プラット・フォーム用Microsoft Visual C++を使ったDLLの作成方法を説明します（この例で挙げられているファイルは、すべて$ORACLE_HOME\REPORT60\USEREXITにあります）。

1	R60XTB32.MAKで、LINK32_OBJSマクロを更新して、ユーザー・イグジット・オブジェクト・ファイルのリストを組み込みます。埋込みPRO/C構成体またはEXEC IAFへのコールを使用している場合、SQLLIB18.LIBとSQXLIB18.LIBもリンクする必要があります。

2	各ユーザー・イグジットのエントリを追加して、サンプル・ソース・ファイルの変更（ue_xtb.c）を行います。

3	サンプル・ファイルRWXTB60.DEFのコピーを編集してエントリを追加し、ユーザー・イグジット・ファンクションをエクスポートします。

4	次のコマンドを使って、新しい実行プログラムを作成します。

NMAKE -f RWXTB60.MAK all CFG="rwxtb60 - Win32 Debug"
\INCLUDE=.;\msdev\include

\msdev\includeはディレクトリの例で、MSVCインクルード・ディレクトリのパスを使用する必要があります。

CFGは、リリースDLLを作成するために"rwxtb60 - Win32 Release"とすることもできます。

5	新しいRWXTB60.DLLを適切なディレクトリ（%ORACLE_HOME%\binなど）に移動します。

使用上の注意

•	ユーザー・イグジットDLLの名前と保存場所は、デフォルト（%ORACLE_HOME%\binのrwxtb60.dll）以外でもかまいません。そのためには、新しい値をレジストリ・ファイルのHKEY_LOCAL_MACHINE\SOFTWARE\ORACLEキーに追加します。

•	値名   REPORTS60_USEREXIT

•	データ型   REG_SZ

•	値文字列   ユーザー・イグジットDLLのフル・パスと名前

•	DLLのフル・パスと名前をREP60_USEREXITの値文字列に追加し、セミコロンで区切ることによって、複数のユーザー・イグジットDLLを使用できます。


ユーザー・イグジットのコール

Report Builderからユーザー・イグジットをコールするには、次の作業を行います。

1	ユーザー・イグジットのコールの作成

2	エラーのチェックと呼出し


ユーザー・イグジット・コールの作成

Report Builder内で、PL/SQLを入力できる場所であればどこからでも、ユーザー・イグジットをコールできます。次の構文を使用します。

構文

[SRW.REFERENCE(:object_name_1);] [SRW.REFERENCE(:object2_name_2); ...]; SRW.USER_EXIT('user_exit_name [argument_list]');

この場合:

object_name_n	Report Builderパラメータまたは列の名前です。このパラメータまたは列の値がユーザー・イグジット名の文字列で指定したユーザー・イグジットに渡されます。名前を指定すると、Report Builderでは依存性リストが作成されます。このリストによって、値がユーザー・イグジットに渡される前に、参照される各オブジェクトには必ず最後に計算またはフェッチされた値が入ります。注意: 各パラメータまたは列は、個別に参照する必要があります。詳細は、"SRW.REFERENCE"を参照してください。

user_exit_name	制御を渡すユーザー・イグジットの名前です。ユーザー・イグジット名の長さは任意です（一部のオペレーティング・システムでは、最大6文字です。システム管理者に確認してください）。

argument_list	ユーザー・イグジットに渡すパラメータおよび列、定数、文字列の名前またはその任意の組合せを指定できます。引数リストの長さは任意です。注意: 前述の構文は、PL/SQLプログラム単位に埋め込む必要があります。

ユーザー・イグジット・コールを、Form Builderでのユーザー・イグジット・コールと同じ書式にする場合、SRW.USER_EXITのかわりにSRW.USER_EXIT20を使用することができます。

例

曲線上の2点を基準として、曲線より下の面積を計算する（INTEGRALという名前の）ユーザー・イグジットを作成したと仮定します。また、値としてその2点のx座標とy座標が入っている（POINT1とPOINT2という）2つのReport Builder列があると仮定します。ユーザー・イグジットにこれらの列値のコピーを渡すには、SRW.REFERENCEを使って列名を参照する必要があります。SRW.REFERENCEを使用すると、値は必ずユーザー・イグジットに渡される前に計算されます。

ここまでのPL/SQLは、次のようになります。

srw.reference(:point1);

srw.reference(:point2);

次に、ユーザー・イグジット・コールを定義する必要があります。定義するには、SRW.USER_EXITプロシージャを使って、次の引数を渡します。

•	ユーザー・イグジット名（この例では、INTEGRAL）

•	任意の引数（この例では、Report Builder列POINT1とPOINT2）

これで、ユーザー・イグジット・コールのPL/SQLは、次のようになります。

srw.reference(:point1);

srw.reference(:point2);

srw.user_exit('integral point1 point2');

最後に、ユーザー・イグジット・プログラムを使って、計算した面積をAREAというReport Builder列に戻す（EXEC IAF PUT）と仮定します。それには、PL/SQLファンクションを作成し、そのRETURN引数としてAREAを参照します。

これで、ユーザー・イグジット・コールは、次のようになります。

   function compute_area return char is

   begin

      srw.reference(:point1);

      srw.reference(:point2);

      srw.user_exit('integral point1 point2');

   return(:area);

   end;

注意: RETURN引数としてAREAを参照することにより、INTEGRALを実行した後に、別のユーザー・イグジットが別の値をAREA列にPUTする（つまり、INTEGRALユーザー・イグジットが起動する前に、他のすべてのユーザー・イグジットのこの列に対するEXEC IAF PUTが発生する）ことがないようにしてください。列式は必ず値を戻す必要があるので、プロシージャではなく、ファンクションを作成する必要があります。

使用上の注意

•	ユーザー・イグジット名は、ご使用のオペレーティング・システムとホスト言語のルールに従ってください。これらのルールには、大/小文字の区別に関するものが含まれる場合があるので注意してください。

•	user_exit_nameの最大長は10文字です（オペレーティング・システムによっては、6文字に制限されている場合があります）。argument_listの最大長は230文字です。スペースも文字数に含まれます。これらの制限は、オペレーティング・システムにより異なる場合があります。詳細は、システム管理者に問い合せてください。

•	引数は必ずスペースのみで区切ります。argument_listの引数の間に2つ以上のスペースがある場合、Report Builderでは、余分なスペースを削除してからユーザー・イグジットに文字列を渡します。

たとえば、次のコール

   'quota 10 20 Q4'

は、ユーザー・イグジットに次のように渡されます。

   'quota 10 20 Q4'

•	引数リスト内で二重引用符を普通の文字として参照するには、\"を使用します。\は、引数が渡される前に削除されます。

•	argument_listに（その値をユーザー・イグジットに渡す）Report Builderオブジェクトの名前が指定されている場合、PL/SQLプロシージャSRW.REFERENCEを使って、そのオブジェクト名を参照する必要があります。SRW.REFERENCEを使用すると、値がユーザー・イグジットに渡される前に、オブジェクトには必ず最後に計算またはフェッチされた値が入ります。ただし、レイアウト・オブジェクト用のユーザー・イグジットは、そのレイアウト・オブジェクトが印刷されるページ上で計算されるとは限りません。

•	ユーザー・イグジットのコールが、値を他のオブジェクトに入れるPL/SQL値構成体の一部である場合、この値構成体はPL/SQLコードを所有するReport BuilderオブジェクトをRETURNします。たとえば、EMP列の「式」フィールドでPL/SQLファンクションを作成すると、そのファンクションは、EMP列をRETURNします（RETURN(:EMP);）（これにより、ユーザー・イグジットが値をオブジェクトに戻した後に、別のユーザー・イグジットがそのオブジェクトに別の値をPUTすることがなくなります）。


PL/SQLでのユーザー・イグジット・エラーのチェックと定義

PL/SQLのコードで、エラーのチェックと、エラー・メッセージの定義と呼出しができます。

SRW.USER_EXIT_FAILURE

SRW.MESSAGE

注意: ユーザー・イグジット・プログラムでも、メッセージの定義と呼出しができます。詳細は、「ユーザー・イグジットからのエラーの呼出し」を参照してください。


SRW.USER_EXIT_FAILUREを使ったエラーのチェック

PL/SQLでは、PL/SQLパッケージ例外「SRW.USER_EXIT_FAILURE」を使用して、ユーザー・イグジットが失敗したかどうかを知ることができます。この例外は、SRWERBバッファが空でない場合、TRUEの値になります。 空の場合は、FALSEになります。SRWERBバッファの詳細は、「ユーザー・イグジットからのエラーの呼出し」を参照してください。

例

MYEXITというユーザー・イグジットがあり、これが失敗したかどうかをチェックすると仮定します。この場合、ユーザー・イグジット・コールは、次のようになります。

begin
   srw.user_exit('myexit');
exception
   when srw.user_exit_failure then
   srw.message(2000, 'The user exit MYEXIT failed.');
   when others then
   srw.message (3000, 'Report error occurred before
user exit MYEXIT returned.');
end;

注意: この例では、エラー・チェックはPL/SQLコードの本体部分にあります。エラー・チェックをPL/SQLコードのEXCEPTIONの部分に持ってくることもできます。


SRW.MESSAGEを使ったエラー・メッセージの定義

PL/SQLでは、PL/SQLパッケージ・プロシージャSRW.MESSAGEを使ってエラー・メッセージを定義し、Report Builderのメッセージ領域に呼び出すことができます。注意:   ユーザー・イグジット・プログラムでも、エラーの定義と呼出しができます。詳細は、「ユーザー・イグジットからのエラーの呼出し」を参照してください。

SRW.MESSAGE構文は次のとおりです。

SRW.MESSAGE (msg_number NUMBER, msg_text CHAR);

つまり、任意のエラー番号と文字列でSRW.MESSAGEを参照するのみです。次に、SRW.MESSAGEを使用してエラーを呼び出す例を示します。

例

STOREというユーザー・イグジットがあり、そこにReport Builderから給与値を渡すと仮定します。値を渡すには、次のような式を作成します。

   function foo return boolean is
   begin
   if :sal >= 0 then
      srw.reference(:sal);
      srw.user_exit('store sal');
   else
      srw.message(100, 'Found a negative salary.Check
        the EMP table.');
   end if;
   exception
   when srw.unknown_user_exit then
      srw.message(200, 'STORE user exit was unknown.
        Check if it''s linked.');
   when srw.user_exit_failure then
      srw.message(200, 'STORE user exit failed.Check
         its code.');
   return(true);
   end;

ユーザー・イグジットが失敗しても、ユーザー・イグジット・プログラムがSRWERBバッファにメッセージを書き込まなければ、SRW.USER_EXIT_FAILUREはFALSEとなり、Report Builderではエラー・メッセージが呼び出されません。ユーザー・イグジット・プログラムがSRWERBバッファにメッセージを書き込むと、SRW.USER_EXIT_FAILUREはTRUEとなり、Report Builderでは「STORE user exit failed.Check its code.」というメッセージが呼び出されます。

BIG_EXITというユーザー・イグジットがあると仮定します。BIG_EXITには、3つの異なる場所でエラーを自らチェックするコードがあると仮定します。エラーがあると、次の値の1つを戻す（EXEC IAF PUTする）とします。BIG_EXITのA部が失敗した場合はAまたはBIG_EXITのB部が失敗した場合はB、BIG_EXITのC部が失敗した場合はCです。ユーザー・イグジット・コールは次のようになります。

  Procedure multi_errors is
     function inner return char is
     begin
        srw.user_exit('big_exit');
     return(:error);
     end;
  begin
  if :error='A'
     srw.message(100, 'Portion A of BIG_EXIT failed.');
  elsif :error='B'
     srw.message(200, 'Portion B of BIG_EXIT failed.');
  else
     srw.message(300, 'Portion C of BIG_EXIT failed.');
  end if;
  end;


パッケージReport Builderユーザー・イグジット

  関連項目

RWEATS

RWECAT

RWECPF

RWECTY

RWEPLS


RWEATS

このユーザー・イグジットは、Report Builderの内部フォーマットで格納されている属性値を、Report Builder内で使用される文字列に変換します。このユーザー・イグジットは、「ファイル」 [image] 「管理」 [image] 「Reportsに関するレポート....」を選択して、データベースに格納されたレポートに、Report Builderで注釈を付けるのに使用されます。

構文

SRW.USER_EXIT('rweats source destination attribute_num');

この場合:

source	変換対象の表列の値です。指定したソースに値が入っていない場合、宛先の列はブランクになります。

destination	変換した値が入るReport Builderオブジェクトの名前です。

attribute_num	Report Builderのデータベース表列の属性番号です。

表	列	属性	説明
SRW2_LAYOUT	UNITS	1	レポートのサイズの単位
SRW2_PARAM_FORM	UNITS	1	パラメータ・フォームのサイズの単位
SRW2_LAYOUT	ORIENT	2	パネルの印刷順序
SRW2_LAYOUT	RUN_FLAGS	3	デザイナでキャラクタ単位を使用
SRW2_LAYOUT	RUN_FLAGS	4	ブラウザでキャラクタ単位を使用
SRW2_LAYOUT	RUN_FLAGS	5	ホストの使用不可
SRW2_LAYOUT	RUN_FLAGS	6	分割の使用不可
SRW2_LAYOUT	RUN_FLAGS	7	ズームの使用不可
SRW2_LAYOUT	RUN_FLAGS	8	ズーム開始
SRW2_LAYOUT	RUN_FLAGS	9	ブラウザのタイトルを表示
SRW2_LAYOUT	RUN_FLAGS	10	ブラウザのヒント行を表示
SRW2_LAYOUT	RUN_FLAGS	11	ブラウザの状態を表示
TOOL_PLSQL	TYPE	12	「レポート・トリガー」型
SRW2_LAYOUT	SETTINGS	13	表示設定 - レポート・セクション
SRW2_LAYOUT	SETTINGS	14	表示設定 - フィールド表示
SRW2_LAYOUT	SETTINGS	15	表示設定 - コメント・アイコン一覧
SRW2_LAYOUT	SETTINGS	16	表示設定 - 名前一覧
SRW2_LAYOUT	SETTINGS	18	表示設定 - フィールド・アウトライン一覧
SRW2_LAYOUT	SETTINGS	19	表示設定 - ボイラープレート・アウトライン一覧
SRW2_LAYOUT	SETTINGS	20	表示設定 - 枠アウトライン一覧
SRW2_LAYOUT	SETTINGS	21	表示設定 - 改ページ・アイコン一覧
SRW2_LAYOUT	SETTINGS	22	表示設定 - ページ保護アイコン一覧
SRW2_LAYOUT	SETTINGS	23	表示設定 - アンカー連動アイコン一覧
SRW2_LAYOUT	SETTINGS	24	設定の表示 - アンカー一覧
SRW2_COLUMN	SOURCE_ID	25	列ソース
SRW2_COLUMN	COMPUTE_ID	25	列の計算
SRW2_COLUMN	RESET_ID	25	列のリセット
SRW2_FRAME	GROUP_ID	25	繰返し枠グループ
SRW2_FIELD	SOURCE_ID	25	フィールド・ソース
SRW2_FIELD	PGN_RESET	25	フィールドのページ番号付け、リセット位置、繰返し枠
SRW2_COLUMN	DATA_TYPE	26	列/パラメータのデータ型
SRW2_COLUMN	FILE_TYPE	27	列のフォーマット・タイプ
SRW2_BOILERPLATE	GRAPH_TYPE	27	ボイラープレートのフォーマット・タイプ
SRW2_FRAME	FORMATFLAG	28	枠/繰返し枠領域
SRW2_FIELD	FORMATFLAG	28	フィールド領域
SRW2_BOILERPLATE	FORMATFLAG	28	ボイラープレート領域
SRW2_OG_DOCUMENT	FORMATFLAG	28	Oracle Graphics図表領域
SRW2_FRAME	FORMATFLAG	29	枠/繰返し枠の垂直サイズ設定
SRW2_FIELD	FORMATFLAG	29	フィールドの垂直サイズ設定
SRW2_BOILERPLATE	FORMATFLAG	29	ボイラープレートの垂直サイズ設定
SRW2_OG_DOCUMENT	FORMATFLAG	29	Oracle Graphics図表の垂直サイズ設定
SRW2_FRAME	FORMATFLAG	30	枠/繰返し枠の水平サイズ設定
SRW2_FIELD	FORMATFLAG	30	フィールドの水平サイズ設定
SRW2_BOILERPLATE	FORMATFLAG	30	ボイラープレートの水平サイズ設定
SRW2_OG_DOCUMENT	FORMATFLAG	30	Oracle Graphics図表の水平サイズ設定
SRW2_FRAME	FORMATFLAG	31	枠/繰返し枠の印刷条件タイプ
SRW2_FIELD	FORMATFLAG	31	フィールドの印刷条件タイプ
SRW2_BOILERPLATE	FORMATFLAG	31	ボイラープレートの印刷条件タイプ
SRW2_OG_DOCUMENT	FORMATFLAG	31	Oracle Graphics図表の印刷条件タイプ
SRW2_FRAME	FORMATFLAG	32	枠/繰返し枠の印刷条件オブジェクト
SRW2_FIELD	FORMATFLAG	32	フィールドの印刷条件オブジェクト
SRW2_BOILERPLATE	FORMATFLAG	32	ボイラープレートの印刷条件オブジェクト
SRW2_OG_DOCUMENT	FORMATFLAG	32	Oracle Graphics図表の印刷条件オブジェクト
SRW2_FRAME	FORMATFLAG	33	枠/繰返し枠の印刷条件のデフォルト
SRW2_FIELD	FORMATFLAG	33	フィールドの印刷条件のデフォルト
SRW2_BOILERPLATE	FORMATFLAG	33	ボイラープレートの印刷条件のデフォルト
SRW2_OG_DOCUMENT	FORMATFLAG	33	Oracle Graphics図表の印刷条件、デフォルト
SRW2_FRAME	FORMATFLAG	34	前で枠/繰返し枠の改ページ
SRW2_FIELD	FORMATFLAG	34	前でフィールドの改ページ
SRW2_BOILERPLATE	FORMATFLAG	34	前でボイラープレートの改ページ
SRW2_OG_DOCUMENT	FORMATFLAG	34	前でOracle Graphics図表の改ページ
SRW2_FRAME	FORMATFLAG	35	後で枠/繰り返し枠の改ページ
SRW2_FIELD	FORMATFLAG	35	後でフィールドの改ページ
SRW2_BOILERPLATE	FORMATFLAG	35	後でボイラープレートの改ページ
SRW2_OG_DOCUMENT	FORMATFLAG	35	後でOracle Graphics図表の改ページ
SRW2_FRAME	FORMATFLAG	36	枠/繰返し枠のページ保護
SRW2_FIELD	FORMATFLAG	36	フィールドのページ保護
SRW2_BOILERPLATE	FORMATFLAG	36	ボイラープレートのページ保護
SRW2_OG_DOCUMENT	FORMATFLAG	36	Oracle Graphics図表のページ保護
SRW2_FRAME	FORMATFLAG	37	枠/繰返し枠、アンカー・オブジェクトと連動
SRW2_FIELD	FORMATFLAG	37	フィールド、アンカーオブジェクトと連動
SRW2_BOILERPLATE	FORMATFLAG	37	ボイラープレート、アンカーオブジェクトと連動
SRW2_OG_DOCUMENT	FORMATFLAG	37	Oracle Graphics図表、アンカー・オブジェクトと連動
SRW2_FIELD	ALIGNMENT	38	フィールドの整列
SRW2_BOILERPLATE	ALIGNMENT	38	ボイラープレートの整列
SRW2_QUERY	MAX_ROWS	39	問合せの最大行
SRW2_GROUP	GLF_TYPE	40	グループ・フィルタ
SRW2_GROUP	CROSS_PROD	41	グループ・クロス積
SRW2_GROUP	PRODUCT_ID	42	クロス積内グループ
SRW2_COLUMN	FLAGS	43	ブレークでの列の使用
SRW2_COLUMN	FLAGS	44	ファイルからの列の読込み
SRW2_COLUMN	OPERATOR	45	列のファンクション
SRW2_FRAME	DIRECTION	46	繰返し枠の印刷方向
SRW2_FRAME	DIRECTION	47	繰返し枠の列モード
SRW2_FIELD	FORMATFLAG	48	非表示フィールド
SRW2_FIELD	PGN_FLAGS	49	フィールドのページ番号付け、ヘッダーをインクルード
SRW2_FIELD	PGN_FLAGS	50	フィールドのページ番号付け、ボディをインクルード
SRW2_FIELD	PGN_FLAGS	51	フィールドのページ番号付け、トレーラをインクルード
SRW2_BOILERPLATE	TYPE	52	ボイラープレート・タイプ（キャラクタ・モード）
SRW_DISPLAY_TAG	FONTSTYLE	53	フォント・スタイル
SRW_DISPLAY_TAG	FONTWEIGHT	54	フォントの太さ
SRW_DISPLAY_TAG	FONTSIZE	55	フォント・サイズ
SRW_DISPLAY_TAG	DASHSTYLE	56	線種の外観
SRW_DISPLAY_TAG	CAPSTYLE	57	大文字のスタイル
SRW_DISPLAY_TAG	JOINSTYLE	58	線の接続スタイル
SRW_DISPLAY_TAG	LINEPAT	59	線のパターン
SRW_DISPLAY_TAG	FILLPAT	59	塗りパターン


RWECAT

このユーザー・イグジットは、ソースを宛先の末尾に追加して、文字列を連結します。

構文

SRW.USER_EXIT('rwecat source destination');

この場合:

source	連結される文字列です。

destination	文字列が追加されるReport Builderオブジェクトの名前です。


RWECPF

このユーザー・イグジットは、ソースにあるデータをコピーして、宛先に入れます。

構文

SRW.USER_EXIT('rwecpf source destination');

この場合:

source	値をコピーするReport Builderオブジェクトの名前です。

destination	値を入れるReport Builderオブジェクトの名前です。

注意: PL/SQLでは256文字までの制限があるので、RWECPFは、LONG、LONG RAWおよびRAWのデータ型に使用すると便利です。RWECPFは64KBまでサポートします。


RWECTY

このユーザー・イグジットは、列プロパティとソース情報を、Report Builder内で使用される文字列に変換します。入力値は、SRW2_COLUMN表のFLAGS列およびSOURCE列とします。このユーザー・イグジットは、「ファイル」 [image] 「管理」 [image] 「Reportsに関するレポート....」を選択して、データベースに格納されたレポートに、Report Builderで注釈を付けるのに使用されます。

構文

SRW.USER_EXIT('rwecty flag source destination');

この場合:

flag	値をコピーするオブジェクト用のSRW2_COLUMN表のFLAGS列値です。

source	値をコピーするReport Builderオブジェクトの名前です。

destination	値を入れるReport Builderオブジェクトの名前です。


RWEPLS

このユーザー・イグジットは、LONG RAW列に格納されているPL/SQLソースを、PL/SQLソース・テキストに変換します。このユーザー・イグジットは、「ファイル」 [image] 「管理」 [image] 「Reportsに関するレポート....」を選択して、データベースに格納されたレポートに、Report Builderで注釈を付けるのに使用されます。

構文

SRW.USER_EXIT('rwepls source1 source2 destination');

この場合:

source1	Report Builder表のソース・オブジェクト（フィールドなど）のMODIDです。

source2	Report Builder表のソース・オブジェクト（フィールドなど）のIDです。

destination	PL/SQLソース・テキストが割り当てられる、データ型がCharacterである式列です。


完全なユーザー・イグジットの例

  関連項目 	  すべての例

この例では、次のことを説明します。

  ユーザー・イグジットへのコール

  ユーザー・イグジット

ユーザー・イグジットを使用するサンプル・レポートは、Report Builderに付属しています。サンプル・レポートの名前はuserexit.rdf.です。レポートの場所は、使用しているオペレーティング・システムによって異なる場合があります。


ユーザー・イグジット・コールの例

  関連項目 	  すべての例

UE_EMP_PLANユーザー・イグジットをコールすると仮定します。式列から、次のファンクションを入力します。

function CF_Set_PlanFormula return Number is
begin
/* Call User Exit to set the CP_PLAN Placeholder */
srw.user_exit('UE_EMP_PLAN CP_PLAN');
  return 1;
exception
  when srw.user_exit_failure then
/* User Exit did not return a string for this */
/* EMPNO value                                */     srw.message(1000,
       ' User Exit did not return plan for Empno:'||
       to_char(:Empno));
  :CP_Plan := 'No Plan';
  return 1;
end;


ユーザー・イグジットの例

  関連項目 	  すべての例

次に、ユーザー・イグジットの例を示します。このユーザー・イグジットは、ファイルue_samp1.pcにあります。

EXEC SQL INCLUDE SQLCA;

/* Define some local variables to be used in the testexit routine      below.*/
EXEC SQL BEGIN DECLARE SECTION;
     varchar  targetcol[250];    /* name of target OR col */
     varchar  empid[50];         /* value of Empno OR col */
     varchar  plan[250];         /* Plan string */
EXEC SQL END DECLARE SECTION;#include <string.h>
#include <ue.h>
/*--------------------------------------------------------------+
 | ue_emp_plan:
 | ------------
 |
 | This is a PCC user exit that is meant to demonstrate on a very
 | simple level the interaction between a PCC user exit and an
 | Report Builder document.It demonstrates the following
 | functionality:
 |  * Reading an Report Builder Column from within a User Exit
 |  * Setting an Report Builder Column from within a User Exit
 |  * Returning an error to Report Builder
 | The only assumptions it makes are that it is called
 | from an Report Builder document having the following columns:
 |
 |   empno  NUMBER    (Value read in User Exit)
 |
 | This (somewhat contrived) example looks up a predefined table
 | "ue_samp_plan", which associates different employees with a
 | text string that indicates their plans, a favorite quote or
 | personal philosophy.For example,
 |       Employee #                   Plan
 |       ----------                   ----
 |       7856            "Vacationing in Hawaii until Jan 1, 1995"
 |
 | In this user exit, we get the Employee Id from the report
 | column EMPNO, look up the "ue_samp_plan" table, get the
 | associated "plan" and set the <target> column specified in the
 | parameter string.To illustrate error handling,  we'll return
 | an error if the Employee Id does not exist in our table.
 |
 | The parameter string to this user exit should specify exactly
 | 1 identifier which specifies the Target (Report Builder) column
 | into which the "plan" is to be copied.(This ilustrates the
 | use of EXEC IAF PUT with host variables)
 |
 | For e.g, SRW.USER_EXIT('ue_emp_plan PLAN') will result in
 |
 |    + Report Builder col EMPNO will be read into "Empld"
 |    + Report Builder col PLAN will be set with the "plan" string
 |      associated with the EmpId value.
 |    + If no match found, we raise an error.
 |
 | The Employee Ids in ue_samp_plan table match those in the
 | SCOTT/TIGER DEMO tables.
 |
 +--------------------------------------------------------------*/
typedef struct empplan
{
  int empid;
  char   *plan;
} empplan;
empplan ue_samp_plan[] =
{
  { 7369, "Vacationing in Hawaii from Jan 1, 1995"},
  { 7499, "Say No to Guns!"},
  { 7521, "Help starving musicians.Learn music!"},
  { 7566, "Electrons are 100% recyclable."},
  { 7654, "Impress CHRISTIE BRINKLEY w/ witty repartee on
           NP-Completeness"},
  { 7698, "Working on Production"},
  { 7782, "Desktop - Oracle 7 for Windows"},
  { 7788, "Because Its There"},
  { 7839, "Goal:Retire At 45"},
  { 7844, "Go Badgers!"},
  { 7876, "Famous Last Words - It Should Work!"},
  { 7900, "Attending IOUW - send email"}
  /* 7902 & 7934 not included to demonstrate error handling */
};

int ue_emp_plan(ue_options, ue_strlen)
char    *ue_options;        /* command line */
int     *ue_strlen;         /* length of cmd line */
{
    int i;
    char *sep = " "; /* Token separators for parsing ue_options */
    char *token;
   /*----------------------------------------------------------+
    | Set up name of target Oracle Report col into which we move
    | plan string
    |
    | Parm string gives us this name
    +-----------------------------------------------------------*/
    token = strtok(ue_options, sep);  /* Name of UE */
    token = strtok((char*) 0, sep);   /* Parameter - Target Col */

    (void) strcpy(targetcol.arr, token);
    targetcol.len = strlen(ue_options);

   /*------------------------------------------------------------+
    | Get EMPNO value - EXEC IAF GET.Note:empid is declared a
    | VARCHAR so implicit conversion of NUMBER to VARCHAR happens.
    +-----------------------------------------------------------*/

    EXEC IAF GET EMPNO INTO :empid;
    /*-------------------------------------------------+
     | Look up empid in ue_samp_plan table
     +-------------------------------------------------*/
    for (i=0; i<sizeof(ue_samp_plan)/sizeof(empplan); i++)
    {
        if (ue_samp_plan[i].empid == atoi(empid.arr))
        {
           /*
            | Found the empid, copy plan into target column.
            | Target col name is in host variable "targetcol"
            */
           plan.len = strlen(ue_samp_plan[i].plan);
           (void) strcpy(plan.arr, ue_samp_plan[i].plan);

           EXEC IAF PUT :targetcol VALUES (:plan);

           return 0;      /* successful return */
        }
    }
/*-------------------------------------------------------------+
 | Error Case:We didn't find a match
 |
 | Set SRWERB to raise SRW.USER_EXIT_FAILURE exception.See ue.h
 | for explanation.
 +-------------------------------------------------------------*/
    (void) strcpy(SRWERB, "Error - No Plan found");
    return 1;             /* Unsuccessful return */
}


HTML属性

  制限 	  関連項目

HTML出力用にレポートを設計する場合、レポートにWeb属性を割り当てることができます。Web属性を割り当てるには、SRW.SET_ATTRまたは設定属性プロシージャを使用します。古いリリースとの互換性を保つため、SRW.SET_ATTRもサポートされています。しかし、この新しく簡単になったプロシージャの使用を強くお薦めします。

HTML出力には、SRW.SET_ATTRを介して次のWeb属性を使用できます。

  HYPERLINK

  BOOKMARK

  BOOKMARK

  LINKTAG

  BEFREPORT_ESCAPE

  AFTREPORT_ESCAPE

  BEFPAGE_ESCAPE

  AFTPAGE_ESCAPE

  BEFFORM_ESCAPE

  AFTFORM_ESCAPE


PDF属性

  制限 	  関連項目

PDF出力用にレポートを設計する場合、レポートにWeb属性を割り当てることができます。レポートのオブジェクトにWeb属性を割り当てるには、任意の印刷可能なオブジェクトの「フォーマット・トリガー」内でSRW.SET_ATTRを使用します。古いリリースとの互換性を保つため、SRW.SET_ATTRもサポートされています。しかし、この新しく簡単になったプロシージャの使用を強くお薦めします。

PDF出力には、SRW.SET_ATTRを介して次のWeb属性を使用できます。

  HYPERLINK

  BOOKMARK

  ACTION

  LINKTAG


HTML使用上の注意

•	ライブ・プレビューア表示内でWebブレビュー・ツールをクリックして、Webブラウザ内でレポート出力を自動的に表示できるように、Report Builderを設定できます。

•	ブックマークを使用すると、複数のHTMLファイルが作成されます。ブックマーク用とレポート出力用の2つの枠を持つマスター・ファイルが作成されます。これらの枠のそれぞれについてHTMLファイルが1つ作成されます。マスター文書ファイル名は、DESNAMEパラメータで指定した名前です。ブックマーク・ファイル名は、desnameb.htmです。レポート出力ファイル名は、desnamed.htmです。

•	レポートに、リンクされたイメージおよびイメージ・フィールド、チャートがあると、GIFファイルが作成され、これをHTML文書から参照します。リンクされたボイラープレートまたはイメージ・フィールドが外部のGIFファイルを指していても、新規のGIFファイルが生成されることに注意してください。

•	イメージがデータベースに格納されている場合、レポートでそのイメージが出現するたびに、GIFファイルが1つ生成されます。イメージがファイルに格納されている場合（インポートされたイメージまたはリンクされたボイラープレート、ファイルを参照するイメージ・フィールドなど）は、レポートでそれが何回出現しても、GIFファイルは1つのイメージに1つしか生成されません。

•	HTML出力用に生成されたGIFイメージ・ファイルには、数列の番号（desname0.gif ...desname17.gifなど）が付いています。

•	テキスト・ラベルを持つボタンは、テキストに変換されます。アイコンを持つボタンはGIFファイルに変換されます。いずれの場合も、リンク情報は保たれます。

•	マスター文書のコメント・ブロックには、そのマスター文書に関係付けられたすべてのファイル名が含まれています。

•	HTMLでは、7つのテキスト用サイズがあります。レポートのフォント・サイズは、次の表に従ってマップされます。HTMLファイルで指定したサイズは、ブラウザから上書きできる点に注意してください。

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

•	レポートで使用されているフォントがプロポーショナルでない場合、生成されたHTMLファイルに対してTrueTypeモードがオンになります。

•	HTMLにはページの概念がありません。レポートの各ページの間に区切り線が入ります。ブラウザによっては、レポートのページ全体を参照するのにスクロールが必要な場合があります。さらに、ブラウザからHTML文書を印刷する場合、プリンタで区切り線が必ず各ページの一番下に印刷されるとは限りません。区切り線が必要ない場合または別の区切り線を使用する場合は、SRW.SET_AFTER_PAGE_HTMLを使用して変更できます。


HTMLの制限

•	オブジェクトを互いにオーバーラップさせることはできません。たとえば、イメージの上にテキストを配置することはできません。

•	オブジェクトのオーバーラップする部分がわずか（2文字以下）な場合は、下にあるオブジェクトはオーバーラップを防ぐためにその部分が切り捨てられます。

•	オブジェクトのオーバーラップする部分が大きい（または一方のオブジェクトが他方の上に完全に重なる）場合は、下にあるオブジェクト全体が削除されます。この場合でも、削除されるオブジェクトのリンク情報は、枠の場合と同じルールを使用して渡されます（次の枠についてのルールを参照）。

•	どちらが上にあっても、テキストは常に水平線よりも優先されます。したがって、列ラベルの下にある線によって、ラベル・テキストが削除されることはありません。

•	複数の出力ファイルが生成される場合（ブックマークが使用される場合など）、マスター・ファイルを除くファイルは、確認なしに上書きされます。たとえば、GIFファイルとブックマーク・ファイルは、確認の要求なしに上書きされます。「HTML使用上の注意」では、複数のファイルが生成される場合について説明しています。

•	レポートの枠は、HTML出力に表示されません。枠の塗り属性または境界線属性は、HTML出力に表示されません。

•	レポートの枠にLINKTAG（リンクタグ）またはBOOKMARK（ブックマーク）が指定されている場合、その属性は枠の左上に最も近い可視オブジェクトに渡されます。枠オブジェクトにHYPERLINK（ハイパーリンク）が指定されている場合、その属性はHYPERLINK（ハイパーリンク）が指定されていないすべての子（内部）オブジェクトに渡されます。HYPERLINK属性を子オブジェクトに渡すことができない場合、その枠のHYPERLINK（ハイパーリンク）は失われます。

•	HTMLでサポートされる描画オブジェクトは、黒の水平の実線のみです。ブラウザによっては、レポートで指定した線幅が使用されます。レポート・レイアウトの他のすべての描画オブジェクト（四角形や円など）は、HTML出力に表示されません。これらの描画オブジェクト用のスペースは確保されますが、HTML出力には表示されません。

•	テキストのバックグラウンド（塗り）および境界線（線）のカラーまたはパターンは、HTMLで使用できません。太字、イタリック、下線およびフォアグラウンド（テキスト）・カラーは、ブラウザがこれらをサポートしていれば表示されます。

•	ACTION属性は、HTML出力では無視されます。

•	OLEオブジェクトは、PDFまたはHTMLの生成時には無視されますが、出力ではこれらのオブジェクト用のスペースが確保されます。

•	ブラウザをカスタマイズすると、生成されたHTMLの表示方法に影響を与えます。


PDFの制限

•	PDF出力には、現在選択されているプリンタのビットマップ・ドライバ（PostScriptなど）が使用されます。レポートを実行しているマシン用に、ビットマップ・プリンタを構成する必要があります。

•	OLEオブジェクトは、PDFまたはHTMLの生成時には無視されますが、出力ではこれらのオブジェクト用のスペースが確保されます。

•	Adobe Acrobat Readerでは、最大ページ幅は45インチです。レポートのページ幅が45インチよりも大きいPDF出力を生成する場合、Acrobat Readerでそのページは表示されません。


デフォルト HtmlWinHelp URL トピック