条件付きタグ。このタグを使用すると、Domino カスタムタグライブラリに新しく導入された機能を、アプリケーションに組み込むことができます。このため、古いバージョンのライブラリを使用するサーバーにアプリケーションが複製されている場合でも、動作を中断する必要がありません。

このタグを使用して、より新しいタグを直接囲むことはできません。タグの評価は実行時まで処理されないため、古いライブラリを使用しているサーバーがアクセスするページにある新しいタグは参照されず、エラーを生じる可能性があります。代わりに、この ifcapability タグで、<jsp:include> タグや、より新しいタグを参照するページへの標準の HTML リンクを囲みます。

<jsp:include> タグは、生成されるページにファイルを挿入する定義済み JSP アクションです。このアクションは、ページがサーブレットに変換される際にページを挿入する include 命令とは異なります。<jsp:include> アクションは、ページが要求されたときにファイルを挿入します。構文は、次のようになります。

<jsp:include page="relative URL" flush="true">

コンテキスト
次のタグで有効です。

すべてのコンテキスト

<domino:ifcapability
is="true|false"
tag="name of the tag to test"
taglibversion="tag library version number to test"
dominoversion="domino version number to test"
debug="true|false"
onfailure="inline|exception"
time="true|false">

dominoversion

確認する Domino のバージョン。Domino Server の現在のバージョンを調べるには、次の Notes の式を formula タグのボディで使用します。

<domino:formula>@Version</domino:formula>

たとえば、Release 6 のベータ版以降のバージョン番号は 177 です。dominoversion の値として指定する数値も、同様の形式にする必要があります。

タグのボディを評価するか、しないかを指定する論理値。タグのボディには、リンク、または新しいタグがあるページを含めるための <jsp:include> アクションが含まれます。true の場合は、タグのボディを評価します。デフォルトは true です。省略可能。

現在のタグライブラリに含まれているかを確認するタグの名前。たとえば、tag="form" と指定すると、現在のタグライブラリに form タグがあるかを確認します。

確認するタグのバージョン。たとえば、domtags ライブラリの最初のバージョンは 1.0 で、これ以降 Domino のバージョンアップに依存せずにアップデートされます。

例
関連項目

Domtags タグライブラリ