Jakartaプロジェクト: 再利用可能なダイアログコンポーネント (RDC) タグライブラリ

バージョン: 1.0.0

概要

JSP-2.0 再利用可能なダイアログコンポーネント (RDC) --- 音声およびマルチモーダルアプリケーションの迅速な開発を支援するJSPタグライブラリ作成用フレームワーク

Strutsなどのサーバーサイドアプリケーションフレームワークを使用して実装されるビジュアルWebアプリケーションのユーザーインターフェースを生成する効果的な方法として、HTMLのサーバーサイド生成が確立されています。時間が経つにつれて、HTMLマークアップの詳細を抽象化する様々なJSPタグライブラリの登場により、そのようなHTML生成にかかる労力は削減されてきました。RDCプロジェクトの目標は、JSPタグライブラリがビジュアルWebアプリケーションの世界で既に達成したことを、音声アプリケーションにおいても実現することです。

音声アプリケーションの分野は、音声技術の成熟と、W3C VoiceXML 2.0 RECで定義されている安定した堅牢な音声プログラミングモデルの登場により、急速な成長を遂げています。Tomcatのような環境でサーバーサイド音声アプリケーションの開発を主流にするための次なる必要なステップは、JSP開発者を音声対話の複雑さから隔離する適切なタグライブラリの利用可能性です。目標は、JSP開発者がWebアプリケーションを容易に音声対応できるようにするJSPタグライブラリの形で、専門的な音声設計スキルをパッケージ化することです。

要件

このカスタムタグライブラリを使用するには、JavaServer Pages Specification バージョン2.0以降をサポートするサーブレットコンテナが必要です。さらに、Apacheプロジェクトのjstl.jarとstandard.jar、遅延EL評価のためのcommons-el.jar、struts.jar、commons-beanutils.jar、commons-digester.jar（Strutsサポートの構築用）が必要です。

設定

このタグライブラリを使用してWebアプリケーションを設定するには、以下の手順に従ってください

タグライブラリディスクリプタファイルをWebアプリケーションの/WEB-INFサブディレクトリにコピーします。
タグライブラリJARファイルをWebアプリケーションの/WEB-INF/libサブディレクトリにコピーします。

Webアプリケーションのデプロイメントディスクリプタ（/WEB-INF/web.xml）に、以下のように<taglib>要素を追加します。

        <taglib>
        <taglib-uri>https://tomcat.dokyumento.jp/taglibs/rdc-1.0</taglib-uri>
        <taglib-location>/WEB-INF/taglibs-rdc.tld</taglib-location>
        </taglib>

このライブラリのタグをJSPページで使用するには、各ページの上部に以下のディレクティブを追加します。

      <%@ taglib uri="https://tomcat.dokyumento.jp/taglibs/rdc-1.0" prefix="rdc" %>

ここで、"rdc" はこのライブラリのタグに使用するタグ名プレフィックスです。この値は好きなプレフィックスに変更できます。

タグの概要

アトミックコンポーネント

date	日付を収集する
time	時刻を収集する
duration	期間を収集する
creditcardAmount	クレジットカードの請求金額を収集する
creditcardExpiry	クレジットカードの有効期限を収集する
creditcardNumber	クレジットカード番号を収集する
creditcardType	クレジットカードの種類を収集する
zipCode	郵便番号を収集する
usMajorCity	米国の主要都市名を収集する
usState	米国州名を収集する
alpha	アルファベット文字列を収集する
currency	通貨値を収集する
alphanum	英数字文字列を収集する
select1	オプションリストから一つ選択肢を収集する
country	国名を収集する
ssn	社会保障番号を収集する
isbn	国際標準図書番号を収集する
percent	パーセンテージを収集する
number	数値を収集する
digits	数字文字列を収集する
mortgageType	住宅ローンの種類を収集する
template	アトミックRDCの迅速な開発用テンプレート

複合コンポーネント

mortgage	住宅ローン情報を収集する: 住宅ローンの種類と頭金率を含む
creditcardInfo	クレジットカード情報を収集する: カードの種類、カード番号、有効期限、セキュリティコードを含む

フレームワークタグ

task	RDCに必要な足場を提供する
group	複数のRDCをホスティングし、プラグイン可能なダイアログ管理戦略を使用してそれらの間のダイアログを管理するためのコンテナとして機能する
push	要素をスタックにプッシュする。
pop	スタックの最上位要素をポップする。
peek	スタックの最上位要素を覗き見る。

ヘルパータグ

comment	RDCコメント
pause	アプリケーションを一時停止するための可能なハンドラ
hello	RDCハローワールドタグ
fsm-input	デフォルトのRDC FSMを使用するコンポーネントの入力を収集するためのVoiceXMLを生成するヘルパータグ。
fsm-confirm	デフォルトのRDC FSMを使用するコンポーネントの入力を確認するためのVoiceXMLを生成するヘルパータグ。
fsm-run	デフォルトのRDC FSMを定義するヘルパータグ。
extract-params	ブラウザから送信されたHTTPリクエストから必要なパラメータを抽出する。
setup-results	ブラウザが結果をどのように、どこに送信するかに影響を与えるこのコンポーネントのプロパティを設定する。
set-config-composite	複合コンポーネントでページコンテキストと設定を設定する。
set-grammar	リソースバンドルから指定されたプロパティを文法URIとして使用して、文法を設定する。
configure	このコンポーネントのプロンプト、プロパティなどを設定する。ユーザーが設定を提供しない場合、事前に指定されたデフォルト設定が使用される。
expand	カスタム構文「#{...}」を使用する式を含むテキストをJSP 2.0 EL式として評価する
include-fsm-fragment	このRDCテンプレートインスタンスのタグフラグメントを含める。
struts-submit	namelistで指定されたRDCの値をStrutsレイヤーに送信する。
struts-errors	先行するStrutsアクションからのすべてのエラーメッセージを再生する。
get-configuration	このRDCの設定ファイルから、指定されたXPathに対応する要素を取得する
get-resource	リソースバンドルからキーで指定されたリソースを取得する。
getDefaultConfig	このコンポーネントのデフォルト設定を取得する。

タグリファレンス

date - 日付
日付を収集する
属性	名前	値	必須	実行時式評価	概要
	id	任意の名前	はい	いいえ	コンポーネントID

	minDate	xxxxxxxx	いいえ	はい	許容される最小日付

	maxDate	xxxxxxxx	いいえ	はい	許容される最大日付

	initial	xxxxxx	いいえ	はい	日付のデフォルト値

	confirm	true/false	いいえ	はい	確認オプション

	echo	true/false	いいえ	はい	再生オプション

	locale	[language](-[country])?	いいえ	はい	RDCロケール

	maxNoInput	[0-9]*	いいえ	はい	無入力時の正常終了

	maxNoMatch	[0-9]*	いいえ	はい	不一致時の正常終了

	config	xxx-cfg.xml	いいえ	はい	コンポーネントの設定ファイル

	numNBest	[0-9]*	いいえ	はい	要求されるN-best値の最大数

	minConfidence	[0-9][0-9].[0-9]*F	いいえ	はい	認識された出力の最小信頼度

	submit	自己URI	いいえ	はい	結果が送信される場所

使用法	<rdc:date id="myDate" minDate="01012004" maxDate="12312005" echo="true" />
使用例	rdc-examplesアプリケーションのdate-test.jspを参照してください。

time - 時刻
時刻を収集する
属性	名前	値	必須	実行時式評価	概要
	id	任意の名前	はい	いいえ	コンポーネントID

	minTime	xxxxxx	いいえ	はい	許容される最小時刻

	maxTime	xxxxxx	いいえ	はい	許容される最大時刻

	initial	xxxxxx	いいえ	はい	時刻のデフォルト値

	confirm	true/false	いいえ	はい	確認オプション

	echo	true/false	いいえ	はい	再生オプション

	locale	[language](-[country])?	いいえ	はい	RDCロケール

	config	xxx-cfg.xml	いいえ	はい	コンポーネントの設定ファイル

	numNBest	[0-9]*	いいえ	はい	要求されるN-best値の最大数

	minConfidence	[0-9][0-9].[0-9]*F	いいえ	はい	認識された出力の最小信頼度

	maxNoInput	[0-9]*	いいえ	はい	無入力時の正常終了

	maxNoMatch	[0-9]*	いいえ	はい	不一致時の正常終了

	submit	自己URI	いいえ	はい	結果が送信される場所

使用法	<rdc:time id="myTime" minTime="xx30x" maxTime="xx60x" confirm="true" />
使用例	rdc-examplesアプリケーションのtime-test.jspを参照してください。

duration - 期間
期間を収集する
属性	名前	値	必須	実行時式評価	概要
	id	任意の名前	はい	いいえ	コンポーネントID

	minDuration	P([0-9]{2}Y)?([0-9]{2}M)?([0-9]{2}D)?	いいえ	はい	許容される最小期間

	maxDuration	P([0-9]{2}Y)?([0-9]{2}M)?([0-9]{2}D)?	いいえ	はい	許容される最大期間

	initial	P([0-9]{2}Y)?([0-9]{2}M)?([0-9]{2}D)?	いいえ	はい	期間のデフォルト値

	confirm	true/false	いいえ	はい	確認オプション

	locale	[language](-[country])?	いいえ	はい	RDCロケール

	echo	true/false	いいえ	はい	再生オプション

	maxNoInput	[0-9]*	いいえ	はい	無入力時の正常終了

	maxNoMatch	[0-9]*	いいえ	はい	不一致時の正常終了

	config	xxx-cfg.xml	いいえ	はい	コンポーネントの設定ファイル

	numNBest	[0-9]*	いいえ	はい	要求されるN-best値の最大数

	minConfidence	[0-9][0-9].[0-9]*F	いいえ	はい	認識された出力の最小信頼度

	submit	自己URI	いいえ	はい	結果が送信される場所

使用法	<rdc:duration id="myDuration" echo="true" />
使用例	rdc-examplesアプリケーションのduration-test.jspを参照してください。

creditcardAmount - クレジットカード金額
クレジットカードの請求金額を収集する
属性	名前	値	必須	実行時式評価	概要
	id	任意の名前	はい	いいえ	コンポーネントID

	config	xxx-cfg.xml	いいえ	はい	コンポーネントの設定ファイル

	numNBest	[0-9]*	いいえ	はい	要求されるN-best値の最大数

	locale	[language](-[country])?	いいえ	はい	RDCロケール

	minConfidence	[0-9][0-9].[0-9]*F	いいえ	はい	認識された出力の最小信頼度

	echo	true/false	いいえ	はい	再生オプション

	maxNoInput	[0-9]*	いいえ	はい	無入力時の正常終了

	maxNoMatch	[0-9]*	いいえ	はい	不一致時の正常終了

	initial	クレジットカード金額	いいえ	はい	クレジットカード金額のデフォルト値

	confirm	true/false	いいえ	はい	確認オプション

	submit	自己URI	いいえ	はい	送信URL

使用法	<rdc:creditcardAmount id="myCCAmount" minAmount="USD20.00" balance="USD123.45" />
使用例	rdc-examplesアプリケーションのcreditcardAmount-test.jspを参照してください。

creditcardExpiry - クレジットカード有効期限
クレジットカードの有効期限を収集する
属性	名前	値	必須	実行時式評価	概要
	id	任意の名前	はい	いいえ	コンポーネントID

	config	xxx-cfg.xml	いいえ	はい	コンポーネントの設定ファイル

	numNBest	[0-9]*	いいえ	はい	要求されるN-best値の最大数

	locale	[language](-[country])?	いいえ	はい	RDCロケール

	minConfidence	[0-9][0-9].[0-9]*F	いいえ	はい	認識された出力の最小信頼度

	echo	true/false	いいえ	はい	再生オプション

	maxNoInput	[0-9]*	いいえ	はい	無入力時の正常終了

	maxNoMatch	[0-9]*	いいえ	はい	不一致時の正常終了

	initial	クレジットカード有効期限	いいえ	はい	クレジットカード有効期限のデフォルト値

	confirm	true/false	いいえ	はい	確認オプション

	submit	自己URI	いいえ	はい	送信URL

使用法	<rdc:creditcardExpiry id="myCCExpiry" />
使用例	rdc-examplesアプリケーションのcreditcardExpiry-test.jspを参照してください。

creditcardNumber - クレジットカード番号
クレジットカード番号を収集する
属性	名前	値	必須	実行時式評価	概要
	id	任意の名前	はい	いいえ	コンポーネントID

	config	xxx-cfg.xml	いいえ	はい	コンポーネントの設定ファイル

	numNBest	[0-9]*	いいえ	はい	要求されるN-best値の最大数

	locale	[language](-[country])?	いいえ	はい	RDCロケール

	minConfidence	[0-9][0-9].[0-9]*F	いいえ	はい	認識された出力の最小信頼度

	echo	true/false	いいえ	はい	再生オプション

	maxNoInput	[0-9]*	いいえ	はい	無入力時の正常終了

	maxNoMatch	[0-9]*	いいえ	はい	不一致時の正常終了

	initial	クレジットカード番号	いいえ	はい	クレジットカード番号のデフォルト値

	confirm	true/false	いいえ	はい	確認オプション

	submit	自己URI	いいえ	はい	送信URL

使用法	<rdc:creditcardNumber id="myCCNumber" confirm="true" />
使用例	rdc-examplesアプリケーションのcreditcardNumber-test.jspを参照してください。

creditcardType - クレジットカード種類
クレジットカードの種類を収集する
属性	名前	値	必須	実行時式評価	概要
	id	任意の名前	はい	いいえ	コンポーネントID

	config	xxx-cfg.xml	いいえ	はい	コンポーネントの設定ファイル

	numNBest	[0-9]*	いいえ	はい	要求されるN-best値の最大数

	locale	[language](-[country])?	いいえ	はい	RDCロケール

	minConfidence	[0-9][0-9].[0-9]*F	いいえ	はい	認識された出力の最小信頼度

	echo	true/false	いいえ	はい	再生オプション

	maxNoInput	[0-9]*	いいえ	はい	無入力時の正常終了

	maxNoMatch	[0-9]*	いいえ	はい	不一致時の正常終了

	initial	クレジットカード種類	いいえ	はい	クレジットカード種類のデフォルト値

	confirm	true/false	いいえ	はい	確認オプション

	submit	自己URI	いいえ	はい	送信URL

使用法	<rdc:creditcardType id="myCCType" initial="Visa" echo="true" />
使用例	rdc-examplesアプリケーションのcreditcardType-test.jspを参照してください。

zipCode - 郵便番号
郵便番号を収集する
属性	名前	値	必須	実行時式評価	概要
	id	任意の名前	はい	いいえ	コンポーネントID

	config	xxx-cfg.xml	いいえ	はい	コンポーネントの設定ファイル

	numNBest	[0-9]*	いいえ	はい	要求されるN-best値の最大数

	minConfidence	[0-9][0-9].[0-9]*F	いいえ	はい	認識された出力の最小信頼度

	echo	true/false	いいえ	はい	再生オプション

	locale	[language](-[country])?	いいえ	はい	RDCロケール

	maxNoInput	[0-9]*	いいえ	はい	無入力時の正常終了

	maxNoMatch	[0-9]*	いいえ	はい	不一致時の正常終了

	confirm	true/false	いいえ	はい	確認オプション

	長さ	正の整数	いいえ	はい	郵便番号の桁数

	パターン	正規表現	いいえ	はい	有効な郵便番号のセットを表す正規表現

	submit	submit-uri	いいえ	はい	JSPページのURI

使用法	<rdc:zipCode id="myZip" confirm="true" echo="true" />
使用例	rdc-examplesアプリケーションのzipCode-test.jspを参照してください。

usMajorCity - 米主要都市
米国の主要都市名を収集する
属性	名前	値	必須	実行時式評価	概要
	id	任意の名前	はい	いいえ	コンポーネントID

	config	xxx-cfg.xml	いいえ	はい	コンポーネントの設定ファイル

	numNBest	[0-9]*	いいえ	はい	要求されるN-best値の最大数

	minConfidence	[0-9][0-9].[0-9]*F	いいえ	はい	認識された出力の最小信頼度

	echo	true/false	いいえ	はい	再生オプション

	locale	[language](-[country])?	いいえ	はい	RDCロケール

	maxNoInput	[0-9]*	いいえ	はい	無入力時の正常終了

	maxNoMatch	[0-9]*	いいえ	はい	不一致時の正常終了

	confirm	true/false	いいえ	はい	確認オプション

	submit	submit-uri	いいえ	はい	JSPページのURI

使用法	<rdc:usMajorCity id="myCity" echo="true" />
使用例	rdc-examplesアプリケーションのusMajorCity-test.jspを参照してください。

usState - 米国州
米国州名を収集する
属性	名前	値	必須	実行時式評価	概要
	id	任意の名前	はい	いいえ	コンポーネントID

	config	xxx-cfg.xml	いいえ	はい	コンポーネントの設定ファイル

	numNBest	[0-9]*	いいえ	はい	要求されるN-best値の最大数

	minConfidence	[0-9][0-9].[0-9]*F	いいえ	はい	認識された出力の最小信頼度

	echo	true/false	いいえ	はい	再生オプション

	locale	[language](-[country])?	いいえ	はい	RDCロケール

	maxNoInput	[0-9]*	いいえ	はい	無入力時の正常終了

	maxNoMatch	[0-9]*	いいえ	はい	不一致時の正常終了

	confirm	true/false	いいえ	はい	確認オプション

	submit	submit-uri	いいえ	はい	JSPページのURI

使用法	<rdc:usState id="myState" />
使用例	rdc-examplesアプリケーションのusState-test.jspを参照してください。

alpha - アルファベット
アルファベット文字列を収集する
属性	名前	値	必須	実行時式評価	概要
	id	任意の名前	はい	いいえ	コンポーネントID

	submit	自己URI	いいえ	はい	結果が送信される場所

	config	xxx-cfg.xml	いいえ	はい	コンポーネントの設定ファイル

	numNBest	[0-9]*	いいえ	はい	要求されるN-best値の最大数

	minConfidence	[0-9][0-9].[0-9]*F	いいえ	はい	認識された出力の最小信頼度

	echo	true/false	いいえ	はい	再生オプション

	locale	[language](-[country])?	いいえ	はい	RDCロケール

	maxNoInput	[0-9]*	いいえ	はい	無入力時の正常終了

	maxNoMatch	[0-9]*	いいえ	はい	不一致時の正常終了

	initial	[a-zA-Z ']*	いいえ	はい	アルファベットのデフォルト値

	confirm	true/false	いいえ	はい	確認オプション

	minLength	[0-9]*	いいえ	はい	許容される最小長

	maxLength	[0-9]*	いいえ	はい	許容される最大長

	パターン	regular-expression	いいえ	はい	許容される値のパターン

使用法	<rdc:alpha id="myAlpha" echo="true" />
使用例	rdc-examplesアプリケーションのalpha-test.jspを参照してください。

currency - 通貨
通貨値を収集する
属性	名前	値	必須	実行時式評価	概要
	id	任意の名前	はい	いいえ	コンポーネントID

	minValue	[0-9]*.?[0-9]{0,2}	いいえ	はい	許容される最小金額

	maxValue	[0-9]*.?[0-9]{0,2}	いいえ	はい	許容される最大金額

	currencyCode	[A-Za-z][A-Za-z][A-Za-z]	いいえ	はい	ISO 4217通貨コード

	initial	xxxxxx	いいえ	はい	デフォルト金額

	confirm	true/false	いいえ	はい	確認オプション

	echo	true/false	いいえ	はい	再生オプション

	locale	[language](-[country])?	いいえ	はい	RDCロケール

	maxNoInput	[0-9]*	いいえ	はい	無入力時の正常終了

	maxNoMatch	[0-9]*	いいえ	はい	不一致時の正常終了

	config	xxx-cfg.xml	いいえ	はい	コンポーネントの設定ファイル

	numNBest	[0-9]*	いいえ	はい	要求されるN-best値の最大数

	minConfidence	[0-9][0-9].[0-9]*F	いいえ	はい	認識された出力の最小信頼度

	submit	自己URI	いいえ	はい	送信URL

使用法	<rdc:currency id="myCurrency" minValue="100" echo="true" />
使用例	rdc-examplesアプリケーションのcurrency-test.jspを参照してください。

alphanum - 英数字
英数字文字列を収集する
属性	名前	値	必須	実行時式評価	概要
	id	任意の名前	はい	いいえ	コンポーネントID

	submit	自己URI	いいえ	はい	結果が送信される場所

	config	xxx-cfg.xml	いいえ	はい	コンポーネントの設定ファイル

	numNBest	[0-9]*	いいえ	はい	要求されるN-best値の最大数

	minConfidence	[0-9][0-9].[0-9]*F	いいえ	はい	認識された出力の最小信頼度

	echo	true/false	いいえ	はい	再生オプション

	locale	[language](-[country])?	いいえ	はい	RDCロケール

	maxNoInput	[0-9]*	いいえ	はい	無入力時の正常終了

	maxNoMatch	[0-9]*	いいえ	はい	不一致時の正常終了

	initial	[a-z0-9]*	いいえ	はい	英数字のデフォルト値

	confirm	true/false	いいえ	はい	確認オプション

	minLength	[0-9]*	いいえ	はい	許容される最小長

	maxLength	[0-9]*	いいえ	はい	許容される最大長

	パターン	regular-expression	いいえ	はい	許容される値のパターン

使用法	<rdc:alphanum id="myAlphanum" minLength="5" maxLength="5" pattern="[0-9]" confirm="true" echo="true"/>*
使用例	rdc-examplesアプリケーションのalphanum-test.jspを参照してください。

select1 - 一つ選択
オプションリストから一つ選択肢を収集する
属性	名前	値	必須	実行時式評価	概要
	id	任意の名前	はい	いいえ	コンポーネントID

	optionList	*-opt.xml	はい	はい	ユーザーが選択するリスト

	initial	任意のオプション	いいえ	はい	デフォルトの選択肢

	confirm	true/false	いいえ	はい	確認オプション

	echo	true/false	いいえ	はい	再生オプション

	locale	[language](-[country])?	いいえ	はい	RDCロケール

	config	xxx-cfg.xml	いいえ	はい	コンポーネントの設定ファイル

	numNBest	[0-9]*	いいえ	はい	要求されるN-best値の最大数

	minConfidence	[0-9][0-9].[0-9]*F	いいえ	はい	認識された出力の最小信頼度

	maxNoInput	[0-9]*	いいえ	はい	無入力時の正常終了

	maxNoMatch	[0-9]*	いいえ	はい	不一致時の正常終了

	submit	自己URI	いいえ	はい	送信URL

使用法	<rdc:select1 id="myChoice" config="myConfig.xml" optionsList="myOptions.xml" echo="true" />
使用例	rdc-examplesアプリケーションのselect1-test.jspを参照してください。

country - 国
国名を収集する
属性	名前	値	必須	実行時式評価	概要
	id	任意の名前	はい	いいえ	コンポーネントID

	initial	India	いいえ	はい	国のデフォルト値

	confirm	true/false	いいえ	はい	確認オプション

	echo	true/false	いいえ	はい	再生オプション

	locale	[language](-[country])?	いいえ	はい	RDCロケール

	maxNoInput	[0-9]*	いいえ	はい	無入力時の正常終了

	maxNoMatch	[0-9]*	いいえ	はい	不一致時の正常終了

	config	xxx-cfg.xml	いいえ	はい	コンポーネントの設定ファイル

	numNBest	[0-9]*	いいえ	はい	要求されるN-best値の最大数

	minConfidence	[0-9][0-9].[0-9]*F	いいえ	はい	認識された出力の最小信頼度

	submit	自己URI	いいえ	はい	結果が送信される場所

使用法	<rdc:country id="myCountry" />
使用例	rdc-examplesアプリケーションのcountry-test.jspを参照してください。

ssn - 社会保障番号
社会保障番号を収集する
属性	名前	値	必須	実行時式評価	概要
	id	任意の名前	はい	いいえ	コンポーネントID

	パターン	正規表現	いいえ	はい	有効な社会保障番号のセットを表す正規表現

	config	xxx-cfg.xml	いいえ	はい	コンポーネントの設定ファイル

	echo	true/false	いいえ	はい	再生オプション

	confirm	true/false	いいえ	はい	確認オプション

	locale	[language](-[country])?	いいえ	はい	RDCロケール

	initial	xxxxxxxxxx	いいえ	はい	社会保障番号のデフォルト値

	numNBest	[0-9]*	いいえ	はい	要求されるN-best値の最大数

	minConfidence	[0-9][0-9].[0-9]*F	いいえ	はい	認識された出力の最小信頼度

	maxNoInput	[0-9]*	いいえ	はい	無入力時の正常終了

	maxNoMatch	[0-9]*	いいえ	はい	不一致時の正常終了

	submit	submit-uri	いいえ	はい	JSPページのURI

使用法	<rdc:ssn id="mySSN" />
使用例	rdc-examplesアプリケーションのssn-test.jspを参照してください。

isbn - ISBN
国際標準図書番号を収集する
属性	名前	値	必須	実行時式評価	概要
	id	任意の名前	はい	いいえ	コンポーネントID

	パターン	正規表現	いいえ	はい	有効な国際標準図書番号のセットを表す正規表現

	config	xxx-cfg.xml	いいえ	はい	コンポーネントの設定ファイル

	echo	true/false	いいえ	はい	再生オプション

	confirm	true/false	いいえ	はい	確認オプション

	locale	[language](-[country])?	いいえ	はい	RDCロケール

	maxNoInput	[0-9]*	いいえ	はい	無入力時の正常終了

	maxNoMatch	[0-9]*	いいえ	はい	不一致時の正常終了

	initial	xxxxxxxxxxx	いいえ	はい	デフォルトISBN値

	numNBest	[0-9]*	いいえ	はい	要求されるN-best値の最大数

	minConfidence	[0-9][0-9].[0-9]*F	いいえ	はい	認識された出力の最小信頼度

	submit	submit-uri	いいえ	はい	JSPページのURI

使用法	<rdc:isbn id="myISBN" confirm="true" echo="true" />
使用例	rdc-examplesアプリケーションのisbn-test.jspを参照してください。

percent - パーセント
パーセンテージを収集する
属性	名前	値	必須	実行時式評価	概要
	id	任意の名前	はい	いいえ	コンポーネントID

	minValue	[0-9]{1,2}	いいえ	はい	許容される最小パーセンテージ

	maxValue	[0-9]{1,2}	いいえ	はい	許容される最大パーセンテージ

	initial	[0-9]{1,2}	いいえ	はい	パーセンテージのデフォルト値

	locale	[language](-[country])?	いいえ	はい	RDCロケール

	confirm	true/false	いいえ	はい	確認オプション

	echo	true/false	いいえ	はい	再生オプション

	maxNoInput	[0-9]*	いいえ	はい	無入力時の正常終了

	maxNoMatch	[0-9]*	いいえ	はい	不一致時の正常終了

	config	xxx-cfg.xml	いいえ	はい	コンポーネントの設定ファイル

	numNBest	[0-9]*	いいえ	はい	要求されるN-best値の最大数

	minConfidence	[0-9][0-9].[0-9]*F	いいえ	はい	認識された出力の最小信頼度

	submit	自己URI	いいえ	はい	結果が送信される場所

使用法	<rdc:percent id="myPercent" minPercent="10" maxPercent="75" />
使用例	rdc-examplesアプリケーションのpercent-test.jspを参照してください。

number - 数値
数値を収集する
属性	名前	値	必須	実行時式評価	概要
	id	任意の名前	はい	いいえ	コンポーネントID

	submit	自己URI	いいえ	はい	結果が送信される場所

	config	xxx-cfg.xml	いいえ	はい	コンポーネントの設定ファイル

	numNBest	[0-9]*	いいえ	はい	要求されるN-best値の最大数

	minConfidence	[0-9][0-9].[0-9]*F	いいえ	はい	認識された出力の最小信頼度

	echo	true/false	いいえ	はい	再生オプション

	locale	[language](-[country])?	いいえ	はい	RDCロケール

	maxNoInput	[0-9]*	いいえ	はい	無入力時の正常終了

	maxNoMatch	[0-9]*	いいえ	はい	不一致時の正常終了

	initial	[0-9].[0-9]	いいえ	はい	アルファベットのデフォルト値

	confirm	true/false	いいえ	はい	確認オプション

	minValue	[0-9].[0-9]	いいえ	はい	許容される最小値

	maxValue	[0-9].[0-9]	いいえ	はい	許容される最大値

使用法	<rdc:number id="myNumber" minValue="0" maxValue="100" />
使用例	rdc-examplesアプリケーションのnumber-test.jspを参照してください。

digits - 数字
数字文字列を収集する
属性	名前	値	必須	実行時式評価	概要
	id	任意の名前	はい	いいえ	コンポーネントID

	minDigit	[0-9]*	いいえ	はい	許容される最小桁数

	maxDigit	[0-9]*	いいえ	はい	許容される最大桁数

	initial	[0-9]*	いいえ	はい	数字のデフォルト値

	confirm	true/false	いいえ	はい	確認オプション

	echo	true/false	いいえ	はい	再生オプション

	locale	[language](-[country])?	いいえ	はい	RDCロケール

	maxNoInput	[0-9]*	いいえ	はい	無入力時の正常終了

	maxNoMatch	[0-9]*	いいえ	はい	不一致時の正常終了

	config	xxx-cfg.xml	いいえ	はい	コンポーネントの設定ファイル

	numNBest	[0-9]*	いいえ	はい	要求されるN-best値の最大数

	minConfidence	[0-9][0-9].[0-9]*F	いいえ	はい	認識された出力の最小信頼度

	submit	自己URI	いいえ	はい	結果が送信される場所

使用法	<rdc:digits id="myDigits" minLength="3" maxLength="7" />
使用例	rdc-examplesアプリケーションのdigits-test.jspを参照してください。

mortgageType - 住宅ローン種類
住宅ローンの種類を収集する
属性	名前	値	必須	実行時式評価	概要
	id	任意の名前	はい	いいえ	コンポーネントID

	minTerm	[0-9]{1,2}Y(fixed\|adjustable)	いいえ	はい	許容される最小の住宅ローン種類

	maxTerm	[0-9]{1,2}Y(fixed\|adjustable)	いいえ	はい	許容される最大の住宅ローン種類

	locale	[language](-[country])?	いいえ	はい	RDCロケール

	initial	[0-9]{1,2}Y(fixed\|adjustable)	いいえ	はい	住宅ローン種類のデフォルト値

	confirm	true/false	いいえ	はい	確認オプション

	maxNoInput	[0-9]*	いいえ	はい	無入力時の正常終了

	maxNoMatch	[0-9]*	いいえ	はい	不一致時の正常終了

	echo	true/false	いいえ	はい	再生オプション

	config	xxx-cfg.xml	はい	はい	コンポーネントの設定ファイル

	numNBest	[0-9]*	いいえ	はい	要求されるN-best値の最大数

	minConfidence	[0-9][0-9].[0-9]*F	いいえ	はい	認識された出力の最小信頼度

	submit	自己URI	いいえ	はい	結果が送信される場所

使用法	<rdc:mortgageType id="myMortgageType" echo="true" />
使用例	rdc-examplesアプリケーションのmortgageType-test.jspを参照してください。

template - RDCテンプレート
アトミックRDCの迅速な開発用テンプレート
属性	名前	値	必須	実行時式評価	概要
	id	任意の名前	はい	いいえ	コンポーネントID

	grammar	xxx.grxml	はい	はい	このインスタンスに必要な1つ以上の文法

	config	xxx-cfg.xml	はい	はい	コンポーネントの設定ファイル

	constraints	インスタンス固有マップ	いいえ	はい	このインスタンスの戻り値に対する制約

	bean	完全修飾データモデルクラス	いいえ	はい	このインスタンスのデータモデル

	data	インスタンス固有オブジェクト	いいえ	はい	このインスタンスに必要な外部データ

	initial	インスタンス固有	いいえ	はい	このインスタンスのデフォルト値

	confirm	true/false	いいえ	はい	確認オプション

	echo	true/false	いいえ	はい	再生オプション

	numNBest	[0-9]*	いいえ	はい	要求されるN-best値の最大数

	minConfidence	[0-9][0-9].[0-9]*F	いいえ	はい	認識された出力の最小信頼度

	maxNoInput	[0-9]*	いいえ	はい	無入力時の正常終了

	maxNoMatch	[0-9]*	いいえ	はい	不一致時の正常終了

	submit	自己URI	いいえ	はい	結果が送信される場所

使用法	<rdc:template id="myTemplate" grammar="grammar/myGrammar.grxml" config="config/myConfig.xml" />
使用例	rdc-examplesアプリケーションのsimple-template-test.jspを参照してください。

mortgage - 住宅ローン
住宅ローン情報を収集する: 住宅ローンの種類と頭金率を含む
属性	名前	値	必須	実行時式評価	概要
	id	任意の名前	はい	いいえ	コンポーネントID

	submit	自己URI	いいえ	はい	結果が送信される場所

	subdialog	true/false	いいえ	はい	このRDCがサブダイアログとして呼び出されるかどうか

使用法	<rdc:mortgage id="myMortgage" />
使用例	rdc-examplesアプリケーションのmortgage-test.jspを参照してください。

creditcardInfo - クレジットカード情報
クレジットカード情報を収集する: カードの種類、カード番号、有効期限、セキュリティコードを含む
属性	名前	値	必須	実行時式評価	概要
	id	任意の名前	はい	いいえ	コンポーネントID

	submit	自己URI	いいえ	はい	結果が送信される場所

	subdialog	true/false	いいえ	はい	このRDCがサブダイアログとして呼び出されるかどうか

	mode	FULL	いいえ	はい	このクレジットカード情報複合コンポーネントが動作するモード

使用法	<rdc:creditcardInfo id="myCCInfo" mode="short" />
使用例	rdc-examplesアプリケーションのcreditcardInfo-test.jspを参照してください。

group
複数のRDCをホスティングし、プラグイン可能なダイアログ管理戦略を使用してそれらの間のダイアログを管理するためのコンテナとして機能する
タグボディ	スクリプトレス
属性	名前	必須	実行時式評価	利用可能性
	id	はい	はい
	このグループの一意の識別子。
	strategy	はい	いいえ
	プラグイン可能なダイアログ管理戦略の完全修飾クラス名。
	config	いいえ	いいえ
	戦略固有の設定属性。
	submit	いいえ	はい
	このコンテナがその中間結果を送信するURI。
変数	なし
使用法	<rdc:group id="myDateTime" strategy="org.apache.taglibs.rdc.dm.SimpleDirectedDialog"> <rdc:date id="myDate" /> <rdc:time id="myTime" /> </rdc:group>
使用例	rdc-examplesアプリケーションは、複数の<rdc:group>使用例を提供しています。サンプルには以下のダイアログ管理戦略が含まれていますシンプルな直接対話 - 子はドキュメント順に実行されます。参照： group-test.jsp nested-group-test.jsp ルールベースの直接対話 - 子はXMLナビゲーションルールセットで定義されたルールに従って実行されます。参照： rulebased-nested.jsp rulebased-conditions.jsp

push
要素をスタックにプッシュする。
タグボディ	空
属性	名前	必須	実行時式評価	利用可能性
	stack	はい	はい
	ターゲットスタックを保持する変数。
	element	はい	はい
	プッシュされる値を保持する変数。
変数	なし
使用法	<rdc:push stack="${rdcStack}" element="${dialogMap}"/>

pop
スタックの最上位要素をポップする。
タグボディ	空
属性	名前	必須	実行時式評価	利用可能性
	var	はい	いいえ
	ポップされる値を保持する変数。
	stack	はい	はい
	ターゲットスタックを保持する変数。
変数	名前		スコープ	利用可能性
	var属性値		タグの開始からページの終了まで

	プロパティ	なし
使用法	<rdc:pop var="discard" stack="${rdcStack}"/>

peek
スタックの最上位要素を覗き見る。
タグボディ	空
属性	名前	必須	実行時式評価	利用可能性
	var	はい	いいえ
	ピーク操作の結果を保持する変数。
	stack	はい	はい
	ターゲットスタックを保持する変数。
変数	名前		スコープ	利用可能性
	var属性値		タグの開始からページの終了まで

	プロパティ	なし
使用法	<rdc:peek var="stateMap" stack="${requestScope.rdcStack}"/>

task - タスクタグ
RDCに必要な足場を提供する
使用法	<rdc:task map="${taskmap}"> <rdc:date id="myDate" confirm="true" /> </rdc:task>
使用例	rdc-examplesアプリケーションのtask-test.jspを参照してください。

expand
カスタム構文「#{...}」を使用する式を含むテキストをJSP 2.0 EL式として評価する
タグボディ	スクリプトレス
属性	なし
変数	なし
使用法	<rdc:expand>#{model.utterance} </rdc:expand>

include-fsm-fragment
このRDCテンプレートインスタンスのタグフラグメントを含める。
タグボディ	空
属性	名前	必須	実行時式評価	利用可能性
	template	はい	はい
	このテンプレートインスタンスのデータモデル。
	context	はい	はい
	ホストタグファイルのpageContext。
変数	なし
使用法	<rdc:include-fsm-fragment template="${model}" context="${pageContext}" />

struts-submit
namelistで指定されたRDCの値をStrutsレイヤーに送信する。
タグボディ	空
属性	名前	必須	実行時式評価	利用可能性
	submit	はい	はい
	結果を送信するURI（Strutsマッピング）。
	context	はい	はい
	ホストJSPのpageContext。
	namelist	いいえ	はい
	値が送信されるべきRDCのリスト。
	clearlist	いいえ	はい
	値がクリアされるべきRDCのリスト。リストの項目はコンポーネントまたはコンテナであることができます。
	dialogMap	いいえ	はい
	ホストJSPで使用されるRDCダイアログマップ。
変数	なし
使用法	<rdc:struts-submit submit=${self}" context="${pageContext}" namelist="myDate myTime"/>

struts-errors
先行するStrutsアクションからのすべてのエラーメッセージを再生する。
タグボディ	空
属性	なし
変数	なし
使用法	<rdc:struts-errors />

get-configuration
このRDCの設定ファイルから、指定されたXPathに対応する要素を取得する
タグボディ	空
属性	名前	必須	実行時式評価	利用可能性
	xml	はい	はい
	このコンポーネントの解析済み設定ファイル。
	locator	はい	はい
	関心のある要素へのXPath。
変数	なし
使用法	<rdc:get-configuration xml="${parsedDoc}" locator="/config/input/property-list/property" />

get-resource
リソースバンドルからキーで指定されたリソースを取得する。
タグボディ	空
属性	名前	必須	実行時式評価	利用可能性
	bundle	はい	はい
	参照するResourceBundle。
	key	はい	はい
	取得するプロパティのキー。
	var	はい	はい
	プロパティ値を保持する変数。
	isGrammarURI	いいえ	はい
	RDC文法URIに固有の処理をエスケープする機能。
変数	なし
使用法	<rdc:get-resource bundle="${rdcResourceBundle}" key="my.property.key" var="myResourceString" />

getDefaultConfig
このコンポーネントのデフォルト設定を取得する。
タグボディ	空
属性	名前	必須	実行時式評価	利用可能性
	name	はい	はい
	このコンポーネントのデフォルト設定ファイルのURI。
	model	はい	はい
	このコンポーネントのデータモデル。
変数	なし
使用法	<rdc:getDefaultConfig name="${defaultConfig}" model="${model}" />

comment - コメントタグ
RDCコメント
使用法	<rdc:comment> これはRDCコメントです </rdc:comment>

pause - 一時停止タグ
アプリケーションを一時停止するための可能なハンドラ
属性	名前	値	必須	実行時式評価	概要
	id	任意の名前	はい	いいえ	コンポーネントID

	locale	[language](-[country])?	いいえ	はい	RDCロケール

	config	xxx-cfg.xml	いいえ	はい	コンポーネントの設定ファイル

	minConfidence	[0-9][0-9].[0-9]*F	いいえ	はい	認識された出力の最小信頼度

使用法	<rdc:pause id="myPause" />

hello - ハローワールドタグ
RDCハローワールドタグ
使用法	<rdc:hello name="全世界" />

fsm-input - FSM入力タグ
デフォルトのRDC FSMを使用するコンポーネントの入力を収集するためのVoiceXMLを生成するヘルパータグ。
使用法	<rdc:fsm-input model="${model}" />

fsm-confirm - FSM確認タグ
デフォルトのRDC FSMを使用するコンポーネントの入力を確認するためのVoiceXMLを生成するヘルパータグ。
使用法	<rdc:fsm-confirm model="${model}" />

fsm-run - FSM実行タグ
デフォルトのRDC FSMを定義するヘルパータグ。
使用法	<rdc:fsm-run model="${model}" />

extract-params - パラメータ抽出タグ
ブラウザから送信されたHTTPリクエストから必要なパラメータを抽出する。
使用法	<rdc:extract-params target="${model}" parameters="${model.paramsMap}"/>

setup-results - 結果設定タグ
ブラウザが結果をどのように、どこに送信するかに影響を与えるこのコンポーネントのプロパティを設定する。
使用法	<rdc:setup-results model="${model}" submit="${submit}" minConfidence="${minConfidence}" numNBest="${numNBest}" />

set-config-composite - 複合コンポーネント設定タグ
複合コンポーネントでページコンテキストと設定を設定する。
使用法	<rdc:set-config-composite model="${model}" context="${pageContext}" config="${config}" />

set-grammar - 文法設定タグ
リソースバンドルから指定されたプロパティを文法URIとして使用して、文法を設定する。
使用法	<rdc:set-grammar model="${model}" bundle="${rdcResourceBundle}" key="my.property.key" />

configure - 設定タグ
このコンポーネントのプロンプト、プロパティなどを設定する。ユーザーが設定を提供しない場合、事前に指定されたデフォルト設定が使用される。
使用法	<rdc:configure model="${model}" config="${config}" defaultConfig="META-INF/tags/rdc/config/date.xml" />

使用例

このカスタムタグライブラリのタグの使用例については、サンプルアプリケーション rdc-examples.war を参照してください。

Jakartaプロジェクト: 再利用可能なダイアログコンポーネント (RDC) タグライブラリ

バージョン: 1.0.0

目次

概要

要件

設定

タグの概要

タグリファレンス

使用例