21 XMLによるレポートのカスタマイズ

Extensible Markup Language(XML)は、情報をより詳細に識別する方法を実現することにより、Webの機能を向上させることを目的として設計された言語です。これはメタ言語(他の言語を定義するための言語)です。XMLを使用して、様々なタイプのドキュメント用にカスタマイズされたマークアップ言語を設計できます。

XMLドキュメントは、マークアップとその内容の両方で構成されます。

要素は、XMLのビルディング・ブロックです。要素インスタンスは、タグ(メインのタグと適切にネストされたタグ)、属性、タグとタグの間にネストされた要素内容からなる構造を持ちます。
タグは、要素とその内容を定義するために使用されます。
属性は、各タグの追加情報を提供するものです。

XMLカスタマイズを使用すると、実行時に元のレポートを変更することなくレポートをカスタマイズできます。ランタイム・コマンドラインに CUSTOMIZEキーワードを追加し、カスタマイズ・ファイルを呼び出して、レポートのレイアウトやデータ・モデルへの追加や変更を実行できます。1つのXMLカスタマイズ・ファイルで、これらすべての作業または任意の作業の組合せを実行できます。XMLを使用して、カスタムのJSPベース・レポートに取り込むレポート・データ・モデルを作成することも可能です。

様々なXMLカスタマイズを作成して適用すると、レポート出力をユーザー単位またはユーザー・グループ単位で変更できます。同じレポートを使用して、利用対象者ごとに異なる出力を生成できます。

XMLカスタマイズをレポートに適用するときに、結合した定義をファイルに保存することができます。このため、XMLカスタマイズを使用して、既存のレポート定義をバッチ更新できます。Oracle Reports Builderで1つずつファイルを開くことなく、大量のレポートをすばやく更新できます。

Oracle Reports Servicesでは、XMLでレポート・データ・モデル全体を作成できるようになり、Oracle Reports XMLによるカスタマイズのタイプが強化されました。これには、複数データソースの作成、データソース間のリンク、および各データソース内でのグループ階層が含まれます。Oracle Reports XMLカスタマイズによるデータ・モデルのサポートにより、Oracle Reports Builderで作成可能なすべてのデータ・モデルを、XMLを指定して作成できるようになりました。さらに、データ・モデル・オブジェクトに設定可能なすべてのプロパティを、XMLで設定できるようになりました。

この章では、XMLを使用して実行中にレポートをカスタマイズする方法、およびXMLでデータ・モデルを作成する方法について説明します。ここには次の項があります。

この章では、reports.dtdファイルでサポートされる要素を紹介し、その例を示します。ただし、これらの要素の属性については、一部のみを紹介します。

追加属性や、Oracle Reports XMLの要素、タグおよび属性の詳細は、次を参照してください。

reports.dtdファイルには、Oracle Reports XMLのすべての要素、タグと属性、そして存在する場合は属性のデフォルト値が含まれます。reports.dtdファイルは、WindowsとUNIXどちらの場合も、ORACLE_HOME\reports\dtd\にあります。サブ要素の多くは、使用時の規則を示す記号を含んでいます。例:
- プラス記号(+)は、XMLファイルでそのタイプの要素を1つ以上使用できることを意味します。
- アスタリスク(*)は、XMLファイルでそのタイプの要素を0から多数の範囲で使用できることを意味します。
- 疑問符(?)は、XMLファイルでそのタイプの要素を0または1つだけ使用できることを意味します。
- 記号が付いていない場合は、XMLファイルでそのタイプの要素を1つだけ使用する必要がある(必須である)ことを意味します。
複数のサブ要素が括弧で囲まれ、その直後に記号が付いている場合は、その記号が括弧内のすべてのサブ要素に適用されます。
選択したOracle Reports XMLタグの詳細は、Oracle Reportsのオンライン・ヘルプのリファレンスにあるOracle Reports XMLタグに関するトピックを参照してください。

作成しようとするカスタマイズのタイプを含んだレポートを作成し、レポートをXMLとして保存し、さらにテキスト・エディタで保存したファイルを表示します。これは、実際のOracle Reports XMLを参照する優れた手段であると同時に、より複雑なモデルを構築する場合の参考になります。

注意:

Oracle Reports 10g リリース2(10.1.2)パッチ2より前のリリースで開発されたレポートでは、XMLレポートを開くと、PL/SQLパッケージ仕様または本体が欠落している場合があります。その場合、次のいずれかを実行します。

RDFが存在する場合、Oracle Reports 10g リリース2(10.1.2)パッチ2以降を使用して、XML出力ファイルを再生成します。

または、次のようにXMLを編集して、function要素にtype="packageSpec"またはtype="packageBody"(あるいはその両方)を追加します。

<programUnits>
  <function name="a" type="packageSpec">
    <textSource>
      <![CDATA[PACKAGE a IS
          function lire return date ;
        END a;]]>
    </textSource>
  </function>
  <function name="a" type="packageBody">
    <textSource>
      <![CDATA[PACKAGE BODY a IS
          function lire return date is
            c2 date;
          ...
        END;]]>
    </textSource>
  </function>
  <function name="cf_1formula" returnType="date">
    ...
  </function>
</programUnits>