囲まれるすべてのタグに、データベースのコンテキストを提供します。1 ページに同じデータベースからの複数のコアタグを含める場合は、スケーラビリティを上げるために、このタグの中に入れてください。このタグは、ページに 1 つのコアタグしかない場合は必要ありません。コアタグの dbserver および dbname 属性によって db タグが実装されます。異なるデータベースにある 2 つのコアタグを囲む目的では、このタグを使用しないでください。代わりに、session タグを使用してください。

ユーザー属性およびパスワード属性の値を指定しないと、データベースはユーザーを匿名ユーザーとして認識します。タグを使用してデータベースにアクセスするには、データベース ACL に最低でもデータベースへの読者レベルのアクセス権を設定する必要があります。詳しくは、『アプリケーション開発者ガイド』の「匿名アクセス」を参照してください。

データベースのすべての文書をループにするには、db タグ内で docloop タグをネストします。

コンテキスト

次のタグで有効です。

必要なし。session

view、ifdbrole、form、page、novalues、docloop、ftsearch、ifauthor、ifdepositor、ifdesigner、document、ifnoaccess、ifeditor、ifmanager、ifreader

<domino:db
id="name of object variable"
dbname="database name"
dbserver="server name"
user="login information"
password="password associated with user"
host="CORBA server name"
debug="true|false"
onfailure="inline|exception"
time="true|false">

次の属性は、省略可能です。

dbname

開くデータベースの名前。たとえばすべての Notes データベースは、Notes/Data ディレクトリに保存されます。

ヒント データベースが Data ディレクトリのサブディレクトリにある場合は、.nsf ファイルの前にスラッシュを入力します。たとえば、Sales/foo.nsf. という Lotus Notes データベースは、Data ディレクトリで始まるサブディレクトリを下っていきます。

データベースのあるサーバーの名前。デフォルトは、local です。

バックエンドクラスを保存するための Lotus Domino CORBA (Common Object Request Broker Architecture) サーバーの名前。指定される場合は、CORBA セッションが強制されます。指定した場合は、Lotus Domino サーバーを、JSP Web コンテナのあるコンピュータと同じコンピュータ上で実行する必要があります。デフォルトは Null で、CORBA ではないローカルのセッションを作成します。

id 名を指定すると、関連する lotus.domino.Database オブジェクトを含むページレベルの変数を作成します。作成される変数は、db タグのボディ内でのみ有効です。指定されない場合は、Database オブジェクトにプログラムを使用してアクセスすることはできません。

user 属性で指定された値に関連付けられるパスワード。

現在のデータベースが開かれたセッションのログイン情報。このタグが session タグのコンテキストで使用される場合、その値は無視されます。

例
関連項目

Domtags タグライブラリ

用語集