リクエスト定義ファイルは conf という名前のディレクトリに格納する必要があります。
conf ディレクトリはモジュール毎に作成することができます。
モジュールとはひとつのアプリケーションを格納するディレクトリ名を示します。
例えば,「http://localhost/conga/examples/t00/index.html」で表示されるアプリケーションのモジュール名は,/examples/t00 となります。
このモジュール用の conf ディレクトリは,/examples/t00 ディレクトリの直下に作成した,/examples/t00/conf となります。
ひとつの conf ディレクトリの中には複数のリクエスト定義ファイルを格納することができます。
ただし,リクエスト定義ファイルとして認識されるファイルは,以下の名前を持つファイルのみです。
ひとつの conf ファイルに複数のリクエスト定義ファイルが存在する場合や,include タグを使って,別モジュールのリクエスト定義ファイルをインクルードしている場合には,その全ての情報がマージされ,ひとつのモジュール情報として扱われます。
もし複数のリクエスト定義ファイル上に,矛盾する定義情報が含まれる場合(例えば,<template type="date"> <property format="yyyy/MM/dd" ... という定義と,<template type="date"> <property format="MM-dd" ... という定義が存在する場合)には,より後に読み込まれた情報で,前に読み込んだ情報が上書きされます。
リクエスト定義ファイルの読み込みは,以下のルールに従って行なわれます。
読み込み例:
複数の定義ファイルや,複数のモジュールを使用するアプリケーションを構築する場合には,以下のようにリクエスト定義ファイルを構成することを推奨します。