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

バージョン: 1.1 スナップショット

目次

概要

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

Strutsなどのサーバーサイドアプリケーションフレームワークを使用して実装される視覚的なWebアプリケーションのユーザーインターフェースを生成する方法として、HTMLのサーバーサイド生成が効果的であることが証明されています。時間の経過とともに、HTMLマークアップの詳細を抽象化するさまざまなJSPタグライブラリの利用可能性により、HTML生成にかかる労力は削減されてきました。RDCプロジェクトの目標は、視覚的なWebアプリケーションの世界でJSPタグライブラリがすでに達成したことを、音声アプリケーションにおいても実現することです。

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

要件

このカスタムタグライブラリは、JavaServer Pages Specificationバージョン2.0以降をサポートするサーブレットコンテナを必要とします。依存関係は次のとおりです。

ここで引用されているものよりも古いCommonsライブラリバージョンを使用することも可能です。

設定

このタグライブラリを使用してWebアプリケーションを設定するには、次の手順に従います。

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

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

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

タグの概要

アトミックコンポーネント
alpha アルファベット文字列を収集する
alphanum 英数字文字列を収集する
color 色を収集する
country 国名を収集する
creditcardAmount クレジットカードの請求額を収集する
creditcardExpiry クレジットカードの有効期限を収集する
creditcardNumber クレジットカード番号を収集する
creditcardType クレジットカードの種類を収集する
currency 通貨値を収集する
date 日付を収集する
digits 数字の文字列を収集する
duration 期間を収集する
isbn 国際標準図書番号を収集する
mortgageType 住宅ローンの種類を収集する
number 数値を収集する
percent パーセンテージを収集する
select1 オプションのリストから1つの選択肢を収集する
ssn 社会保障番号を収集する
time 時刻を収集する
usMajorCity 米国の主要都市名を収集する
usState 米国の州名を収集する
zipCode 郵便番号を収集する
複合コンポーネント
creditcardInfo クレジットカード情報を収集する:カードの種類、カード番号、有効期限、セキュリティコードを含む
dateRange 期間の開始日と終了日を示す日付範囲を収集する。
mortgage 住宅ローン情報を収集する:住宅ローンの種類と頭金の割合を含む
フレームワークタグ
group 複数のRDCをホストし、プラグイン可能なダイアログ管理戦略を使用してそれらの間のダイアログを管理するためのコンテナとして機能する
peek スタックの最上位要素を覗き見する。
pop スタックの最上位要素をポップする。
push 要素をスタックにプッシュする。
task RDCに必要な足場を提供する
ヘルパータグ
comment RDCコメント
configure このコンポーネントのプロンプト、プロパティなどを設定する。ユーザーが設定を提供しない場合、事前に指定されたデフォルト設定が使用される。
expand カスタム構文「`#{...}`」を使用する式を含むテキストをJSP 2.0 EL式として評価する
extract-params ブラウザから送信されたHTTPリクエストから必要なパラメータを抽出する。
fsm-confirm デフォルトのRDC FSMを使用するコンポーネントの入力を確認するためのVoiceXMLを生成するヘルパータグ。
fsm-input デフォルトのRDC FSMを使用するコンポーネントの入力を収集するためのVoiceXMLを生成するヘルパータグ。
fsm-run デフォルトのRDC FSMを定義するヘルパータグ。
get-configuration このRDCの設定ファイルから、指定されたXPathに対応する要素を取得する
get-default-config このコンポーネントのデフォルト設定を取得する。
get-resource リソースバンドルからキーで指定されたリソースを取得する。
hello RDCハローワールドタグ
include-fsm-fragment RDCテンプレートのこのインスタンスのタグフラグメントを含める。
pause アプリケーションを一時停止するための可能なハンドラ
set-config-composite 複合コンポーネントでページコンテキストと設定を設定する。
set-grammar リソースバンドルから指定されたプロパティをグラマーURIとして使用して、グラマーを設定する。
setup-results ブラウザが結果を送信する方法と場所を影響する、このコンポーネントのプロパティを設定する。
struts-errors 前のStrutsアクションからのすべてのエラーメッセージを表示する。
struts-submit namelistで指定されたRDCの値をStrutsレイヤーに送信する。
subdialog-return サブダイアログとして呼び出された場合、適切なVoiceXMLのreturn文を生成する。RDCの値は、ホストダイアログ(または呼び出し元)で意味のあるデシリアライズが行われるように、標準の公開契約に従ってシリアライズされなければならない。
template アトミックRDCの迅速な開発のためのテンプレート

タグのリファレンス

alpha - alpha

アルファベット文字列を収集する

属性 名前 必須 実行時式の評価 概要
id some-name はい いいえ コンポーネントID
submit self-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 ']* いいえ はい alphaのデフォルト値
confirm true/false いいえ はい 確認オプション
minLength [0-9]* いいえ はい 最小許容長
maxLength [0-9]* いいえ はい 最大許容長
pattern regular-expression いいえ はい 許容される値のパターン
subdialog true/false いいえ はい サブダイアログオプション
使用法 <rdc:alpha id="myAlpha" echo="true" />

rdc-examplesアプリケーションのalpha-test.jspを参照してください。

alphanum - alphanum

英数字文字列を収集する

属性 名前 必須 実行時式の評価 概要
id some-name はい いいえ コンポーネントID
submit self-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]* いいえ はい alphanumのデフォルト値
confirm true/false いいえ はい 確認オプション
minLength [0-9]* いいえ はい 最小許容長
maxLength [0-9]* いいえ はい 最大許容長
pattern regular-expression いいえ はい 許容される値のパターン
subdialog true/false いいえ はい サブダイアログオプション
使用法 <rdc:alphanum id="myAlphanum" minLength="5" maxLength="5" pattern="[0-9]*" confirm="true" echo="true"/>

rdc-examplesアプリケーションのalphanum-test.jspを参照してください。

color - color

色を収集する

属性 名前 必須 実行時式の評価 概要
id some-name はい いいえ コンポーネントID
submit self-URI いいえ はい 結果が送信される場所
config xxx-cfg.xml いいえ はい コンポーネントの設定ファイル
initial red いいえ はい デフォルトの色
numNBest [0-9]* いいえ はい 要求されるN-best値の最大数
minConfidence [0-9][0-9].[0-9]*F いいえ はい 認識された出力の最小信頼度
maxNoInput [0-9]* いいえ はい 入力なしでの正常終了
maxNoMatch [0-9]* いいえ はい 不一致での正常終了
locale [language](-[country])? いいえ はい RDCロケール
echo true/false いいえ はい 再生オプション
confirm true/false いいえ はい 確認オプション
subdialog true/false いいえ はい サブダイアログオプション
使用法 <rdc:color id="myColor" confirm="true" echo="true" />

rdc-examplesアプリケーションのcolor-test.jspを参照してください。

country - country

国名を収集する

属性 名前 必須 実行時式の評価 概要
id some-name はい いいえ コンポーネントID
initial India いいえ はい countryのデフォルト値
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 self-URI いいえ はい 結果が送信される場所
subdialog true/false いいえ はい サブダイアログオプション
使用法 <rdc:country id="myCountry" />

rdc-examplesアプリケーションのcountry-test.jspを参照してください。

creditcardAmount - クレジットカード金額

クレジットカードの請求額を収集する

属性 名前 必須 実行時式の評価 概要
id some-name はい いいえ コンポーネントID
config xxx-cfg.xml いいえ はい コンポーネントの設定ファイル
numNBest [0-9]* いいえ はい 要求されるN-best値の最大数
locale [language](-[country])? いいえ はい RDCロケール
minConfidence [0-9][0-9].[0-9]*F いいえ はい 認識された出力の最小信頼度
balance [0-9]*.[0-9]{2} いいえ はい この支払いの残高
minAmount [0-9]*.[0-9]{2} いいえ はい 最低支払額
maxAmount [0-9]*.[0-9]{2} いいえ はい 支払可能な最大金額
maxDenials [0-9]* いいえ はい このRDCを終了させる最大拒否確認回数
currencyCode [A-Za-z][A-Za-z][A-Za-z] いいえ はい ISO 4217通貨コード
echo true/false いいえ はい 再生オプション
maxNoInput [0-9]* いいえ はい 入力なしでの正常終了
maxNoMatch [0-9]* いいえ はい 不一致での正常終了
initial クレジットカード金額 いいえ はい クレジットカード金額のデフォルト値
confirm true/false いいえ はい 確認オプション
submit self-URI いいえ はい isubmit URL
subdialog true/false いいえ はい サブダイアログオプション
使用法 <rdc:creditcardAmount id="myCCAmount" minAmount="USD20.00" balance="USD123.45" />

rdc-examplesアプリケーションのcreditcardAmount-test.jspを参照してください。

creditcardExpiry - クレジットカード有効期限

クレジットカードの有効期限を収集する

属性 名前 必須 実行時式の評価 概要
id some-name はい いいえ コンポーネント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 クレジットカード有効期限 いいえ はい クレジットカード有効期限のデフォルト値
maxDenials [0-9]* いいえ はい このRDCを終了させる最大拒否確認回数
confirm true/false いいえ はい 確認オプション
submit self-URI いいえ はい isubmit URL
subdialog true/false いいえ はい サブダイアログオプション
使用法 <rdc:creditcardExpiry id="myCCExpiry" />

rdc-examplesアプリケーションのcreditcardExpiry-test.jspを参照してください。

creditcardNumber - クレジットカード番号

クレジットカード番号を収集する

属性 名前 必須 実行時式の評価 概要
id some-name はい いいえ コンポーネント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 クレジットカード番号 いいえ はい クレジットカード番号のデフォルト値
maxDenials [0-9]* いいえ はい このRDCを終了させる最大拒否確認回数
confirm true/false いいえ はい 確認オプション
submit self-URI いいえ はい isubmit URL
subdialog true/false いいえ はい サブダイアログオプション
使用法 <rdc:creditcardNumber id="myCCNumber" confirm="true" />

rdc-examplesアプリケーションのcreditcardNumber-test.jspを参照してください。

creditcardType - クレジットカード種類

クレジットカードの種類を収集する

属性 名前 必須 実行時式の評価 概要
id some-name はい いいえ コンポーネント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 creditcard-type いいえ はい クレジットカード種類のデフォルト値
confirm true/false いいえ はい 確認オプション
submit self-URI いいえ はい isubmit URL
subdialog true/false いいえ はい サブダイアログオプション
使用法 <rdc:creditcardType id="myCCType" initial="Visa" echo="true" />

rdc-examplesアプリケーションのcreditcardType-test.jspを参照してください。

currency - 通貨

通貨値を収集する

属性 名前 必須 実行時式の評価 概要
id some-name はい いいえ コンポーネント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 self-URI いいえ はい isubmit URL
subdialog true/false いいえ はい サブダイアログオプション
使用法 <rdc:currency id="myCurrency" minValue="100" echo="true" />

rdc-examplesアプリケーションのcurrency-test.jspを参照してください。

date - 日付

日付を収集する

属性 名前 必須 実行時式の評価 概要
id some-name はい いいえ コンポーネントID
minDate xxxxxxxx いいえ はい 最小許容日付
maxDate xxxxxxxx いいえ はい 最大許容日付
initial xxxxxx いいえ はい dateのデフォルト値
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 self-URI いいえ はい 結果が送信される場所
format date-format いいえ はい 日付文字列が返される形式
subdialog true/false いいえ はい サブダイアログオプション
使用法 <rdc:date id="myDate" minDate="01012004" maxDate="12312005" echo="true" />

rdc-examplesアプリケーションのdate-test.jspを参照してください。

digits - 数字

数字の文字列を収集する

属性 名前 必須 実行時式の評価 概要
id some-name はい いいえ コンポーネントID
minLength [0-9]* いいえ はい 最小許容桁数
maxLength [0-9]* いいえ はい 最大許容桁数
initial [0-9]* いいえ はい digitのデフォルト値
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 self-URI いいえ はい 結果が送信される場所
subdialog true/false いいえ はい サブダイアログオプション
使用法 <rdc:digits id="myDigits" minLength="3" maxLength="7" />

rdc-examplesアプリケーションのdigits-test.jspを参照してください。

duration - 期間

期間を収集する

属性 名前 必須 実行時式の評価 概要
id some-name はい いいえ コンポーネント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)? いいえ はい durationのデフォルト値
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 self-URI いいえ はい 結果が送信される場所
subdialog true/false いいえ はい サブダイアログオプション
使用法 <rdc:duration id="myDuration" echo="true" />

rdc-examplesアプリケーションのduration-test.jspを参照してください。

isbn - isbn

国際標準図書番号を収集する

属性 名前 必須 実行時式の評価 概要
id some-name はい いいえ コンポーネントID
pattern a-regular-expression いいえ はい 有効な国際標準図書番号のセットを表す正規表現
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
subdialog true/false いいえ はい サブダイアログオプション
使用法 <rdc:isbn id="myISBN" confirm="true" echo="true" />

rdc-examplesアプリケーションのisbn-test.jspを参照してください。

mortgageType - 住宅ローンの種類

住宅ローンの種類を収集する

属性 名前 必須 実行時式の評価 概要
id some-name はい いいえ コンポーネント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) いいえ はい mortgage typeのデフォルト値
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 self-URI いいえ はい 結果が送信される場所
subdialog true/false いいえ はい サブダイアログオプション
使用法 <rdc:mortgageType id="myMortgageType" echo="true" />

rdc-examplesアプリケーションのmortgageType-test.jspを参照してください。

number - 数値

数値を収集する

属性 名前 必須 実行時式の評価 概要
id some-name はい いいえ コンポーネントID
submit self-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]* いいえ はい alphaのデフォルト値
confirm true/false いいえ はい 確認オプション
minValue [0-9]*.[0-9]* いいえ はい 最小許容値
maxValue [0-9]*.[0-9]* いいえ はい 最大許容値
subdialog true/false いいえ はい サブダイアログオプション
使用法 <rdc:number id="myNumber" minValue="0" maxValue="100" />

rdc-examplesアプリケーションのnumber-test.jspを参照してください。

percent - パーセント

パーセンテージを収集する

属性 名前 必須 実行時式の評価 概要
id some-name はい いいえ コンポーネントID
minPercent [0-9]{1,2} いいえ はい 最小許容パーセンテージ
maxPercent [0-9]{1,2} いいえ はい 最大許容パーセンテージ
initial [0-9]{1,2} いいえ はい percentageのデフォルト値
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 self-URI いいえ はい 結果が送信される場所
subdialog true/false いいえ はい サブダイアログオプション
使用法 <rdc:percent id="myPercent" minPercent="10" maxPercent="75" />

rdc-examplesアプリケーションのpercent-test.jspを参照してください。

select1 - 1つ選択

オプションのリストから1つの選択肢を収集する

属性 名前 必須 実行時式の評価 概要
id some-name はい いいえ コンポーネントID
optionList *-opt.xml はい はい ユーザーが選択を求められるリスト
initial some-option いいえ はい デフォルトの選択肢
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 self-URI いいえ はい isubmit URL
subdialog true/false いいえ はい サブダイアログオプション
使用法 <rdc:select1 id="myChoice" config="myConfig.xml" optionsList="myOptions.xml" echo="true" />

rdc-examplesアプリケーションのselect1-test.jspを参照してください。

ssn - ssn

社会保障番号を収集する

属性 名前 必須 実行時式の評価 概要
id some-name はい いいえ コンポーネントID
pattern a-regular-expression いいえ はい 有効な社会保障番号のセットを表す正規表現
config xxx-cfg.xml いいえ はい コンポーネントの設定ファイル
echo true/false いいえ はい 再生オプション
confirm true/false いいえ はい 確認オプション
locale [language](-[country])? いいえ はい RDCロケール
initial xxxxxxxxxx いいえ はい SSNのデフォルト値
numNBest [0-9]* いいえ はい 要求されるN-best値の最大数
minConfidence [0-9][0-9].[0-9]*F いいえ はい 認識された出力の最小信頼度
maxNoInput [0-9]* いいえ はい 入力なしでの正常終了
maxNoMatch [0-9]* いいえ はい 不一致での正常終了
submit submit-uri いいえ はい JSPページのURI
subdialog true/false いいえ はい サブダイアログオプション
使用法 <rdc:ssn id="mySSN" />

rdc-examplesアプリケーションのssn-test.jspを参照してください。

time - 時刻

時刻を収集する

属性 名前 必須 実行時式の評価 概要
id some-name はい いいえ コンポーネントID
minTime xxxxxx いいえ はい 最小許容時刻
maxTime xxxxxx いいえ はい 最大許容時刻
initial xxxxxx いいえ はい timeのデフォルト値
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 self-URI いいえ はい 結果が送信される場所
subdialog true/false いいえ はい サブダイアログオプション
使用法 <rdc:time id="myTime" minTime="xx30x" maxTime="xx60x" confirm="true" />

rdc-examplesアプリケーションのtime-test.jspを参照してください。

usMajorCity - 米国の主要都市

米国の主要都市名を収集する

属性 名前 必須 実行時式の評価 概要
id a-name はい いいえ コンポーネント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]* いいえ はい 不一致での正常終了
initial 米国の主要都市 いいえ はい 都市のデフォルト値
confirm true/false いいえ はい 確認オプション
submit submit-uri いいえ はい JSPページのURI
subdialog true/false いいえ はい サブダイアログオプション
使用法 <rdc:usMajorCity id="myCity" echo="true" />

rdc-examplesアプリケーションのusMajorCity-test.jspを参照してください。

usState - 米国の州

米国の州名を収集する

属性 名前 必須 実行時式の評価 概要
id a-name はい いいえ コンポーネント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]* いいえ はい 不一致での正常終了
initial 米国の州 いいえ はい 州のデフォルト値
confirm true/false いいえ はい 確認オプション
submit submit-uri いいえ はい JSPページのURI
subdialog true/false いいえ はい サブダイアログオプション
使用法 <rdc:usState id="myState" />

rdc-examplesアプリケーションのusState-test.jspを参照してください。

zipCode - 郵便番号

郵便番号を収集する

属性 名前 必須 実行時式の評価 概要
id a-name はい いいえ コンポーネント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 いいえ はい 確認オプション
initial 郵便番号 いいえ はい 郵便番号のデフォルト値
length a-positive-integer いいえ はい 郵便番号の桁数
pattern a-regular-expression いいえ はい 有効な郵便番号のセットを表す正規表現
submit submit-uri いいえ はい JSPページのURI
subdialog true/false いいえ はい サブダイアログオプション
使用法 <rdc:zipCode id="myZip" confirm="true" echo="true" />

rdc-examplesアプリケーションのzipCode-test.jspを参照してください。

creditcardInfo - クレジットカード情報

クレジットカード情報を収集する:カードの種類、カード番号、有効期限、セキュリティコードを含む

属性 名前 必須 実行時式の評価 概要
id some-name はい いいえ コンポーネントID
submit self-URI いいえ はい 結果が送信される場所
subdialog true/false いいえ はい サブダイアログオプション
mode FULL いいえ はい このクレジットカード情報複合コンポーネントが動作するモード
locale [language](-[country])? いいえ はい RDCロケール
initial CreditCardData いいえ はい デフォルトのクレジットカードデータ
config xxx-cfg.xml いいえ はい この複合コンポーネントの設定ファイル
使用法 <rdc:creditcardInfo id="myCCInfo" mode="short" />

rdc-examplesアプリケーションのcreditcardInfo-test.jspを参照してください。

dateRange - 日付範囲

期間の開始日と終了日を示す日付範囲を収集する。

属性 名前 必須 実行時式の評価 概要
id some-name はい いいえ コンポーネントID
submit self-URI いいえ はい 結果が送信される場所
subdialog true/false いいえ はい サブダイアログオプション
initial DateRangeData いいえ はい デフォルトの日付範囲
config xxx-cfg.xml いいえ はい この複合コンポーネントの設定ファイル
locale [language](-[country])? いいえ はい RDCロケール
subdialog true/false いいえ はい サブダイアログオプション
使用法 <rdc:dateRange id="myDateRange" />

rdc-examplesアプリケーションのdateRange-test.jspを参照してください。

mortgage - 住宅ローン

住宅ローン情報を収集する:住宅ローンの種類と頭金の割合を含む

属性 名前 必須 実行時式の評価 概要
id some-name はい いいえ コンポーネントID
submit self-URI いいえ はい 結果が送信される場所
subdialog true/false いいえ はい サブダイアログオプション
initial MortgageData いいえ はい デフォルトの住宅ローンデータ
config xxx-cfg.xml いいえ はい この複合コンポーネントの設定ファイル
locale [language](-[country])? いいえ はい RDCロケール
使用法 <rdc:mortgage id="myMortgage" />

rdc-examplesアプリケーションのmortgage-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

peek

スタックの最上位要素を覗き見する。

タグ本体 EMPTY
属性 名前 必須 実行時式の評価 利用可能性
var はい いいえ

peek操作の結果を保持する変数。

stack はい はい

ターゲットスタックを保持する変数。

変数 名前 スコープ 利用可能性
var属性値 タグの開始からページの終わりまで
プロパティ なし
使用法 <rdc:peek var="stateMap" stack="${requestScope.rdcStack}"/>
pop

スタックの最上位要素をポップする。

タグ本体 EMPTY
属性 名前 必須 実行時式の評価 利用可能性
var はい いいえ

ポップされる値を保持する変数。

stack はい はい

ターゲットスタックを保持する変数。

変数 名前 スコープ 利用可能性
var属性値 タグの開始からページの終わりまで
プロパティ なし
使用法 <rdc:pop var="discard" stack="${rdcStack}"/>
push

要素をスタックにプッシュする。

タグ本体 EMPTY
属性 名前 必須 実行時式の評価 利用可能性
stack はい はい

ターゲットスタックを保持する変数。

element はい はい

プッシュされる値を保持する変数。

変数 なし
使用法 <rdc:push stack="${rdcStack}" element="${dialogMap}"/>
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>
get-configuration

このRDCの設定ファイルから、指定されたXPathに対応する要素を取得する

タグ本体 EMPTY
属性 名前 必須 実行時式の評価 利用可能性
xml はい はい

このコンポーネントの解析済み設定ファイル。

locator はい はい

対象の要素へのXPath。

変数 なし
使用法 <rdc:get-configuration xml="${parsedDoc}" locator="/config/input/property-list/property" />
get-default-config

このコンポーネントのデフォルト設定を取得する。

タグ本体 EMPTY
属性 名前 必須 実行時式の評価 利用可能性
name はい はい

このコンポーネントのデフォルト設定ファイルのURI。

model はい はい

このコンポーネントのデータモデル。

変数 なし
使用法 <rdc:get-default-config name="${defaultConfig}" model="${model}" />
get-resource

リソースバンドルからキーで指定されたリソースを取得する。

タグ本体 EMPTY
属性 名前 必須 実行時式の評価 利用可能性
bundle はい はい

参照するResourceBundle。

key はい はい

取得するプロパティのキー。

var はい はい

プロパティ値を保持する変数。

isGrammarURI いいえ はい

RDCグラマーURIに特有の処理をエスケープする機能。

変数 なし
使用法 <rdc:get-resource bundle="${rdcResourceBundle}" key="my.property.key" var="myResourceString" />
include-fsm-fragment

RDCテンプレートのこのインスタンスのタグフラグメントを含める。

タグ本体 EMPTY
属性 名前 必須 実行時式の評価 利用可能性
template はい はい

このテンプレートインスタンスのデータモデル。

context はい はい

ホストタグファイルのpageContext。

変数 なし
使用法 <rdc:include-fsm-fragment template="${model}" context="${pageContext}" />
struts-errors

前のStrutsアクションからのすべてのエラーメッセージを表示する。

タグ本体 EMPTY
属性 なし
変数 なし
使用法 <rdc:struts-errors />
struts-submit

namelistで指定されたRDCの値をStrutsレイヤーに送信する。

タグ本体 EMPTY
属性 名前 必須 実行時式の評価 利用可能性
submit はい はい

結果を送信するURI (Strutsマッピング)。

context はい はい

ホストJSPのpageContext。

namelist いいえ はい

値を送信すべきRDCのリスト。

clearlist いいえ はい

値をクリアすべきRDCのリスト。リストの項目はコンポーネントまたはコンテナである可能性があります。

dialogMap いいえ はい

ホストJSPで使用されるRDCダイアログマップ。

変数 なし
使用法 <rdc:struts-submit submit=${self}" context="${pageContext}" namelist="myDate myTime"/>
comment - コメントタグ

RDCコメント

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

このコンポーネントのプロンプト、プロパティなどを設定する。ユーザーが設定を提供しない場合、事前に指定されたデフォルト設定が使用される。

使用法 <rdc:configure model="${model}" config="${config}" defaultConfig="META-INF/tags/rdc/config/date.xml" />
extract-params - パラメータ抽出タグ

ブラウザから送信されたHTTPリクエストから必要なパラメータを抽出する。

使用法 <rdc:extract-params target="${model}" parameters="${model.paramsMap}"/>
fsm-confirm - fsm確認タグ

デフォルトのRDC FSMを使用するコンポーネントの入力を確認するためのVoiceXMLを生成するヘルパータグ。

使用法 <rdc:fsm-confirm model="${model}" />
fsm-input - fsm入力タグ

デフォルトのRDC FSMを使用するコンポーネントの入力を収集するためのVoiceXMLを生成するヘルパータグ。

使用法 <rdc:fsm-input model="${model}" />
fsm-run - fsm実行タグ

デフォルトのRDC FSMを定義するヘルパータグ。

使用法 <rdc:fsm-run model="${model}" />
hello - ハローワールドタグ

RDCハローワールドタグ

使用法 <rdc:hello name="whole wide world" />
pause - ポーズタグ

アプリケーションを一時停止するための可能なハンドラ

属性 名前 必須 実行時式の評価 概要
id some-name はい いいえ コンポーネントID
locale [language](-[country])? いいえ はい RDCロケール
config xxx-cfg.xml いいえ はい コンポーネントの設定ファイル
minConfidence [0-9][0-9].[0-9]*F いいえ はい 認識された出力の最小信頼度
使用法 <rdc:pause id="myPause" />
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" />
setup-results - 結果設定タグ

ブラウザが結果を送信する方法と場所を影響する、このコンポーネントのプロパティを設定する。

使用法 <rdc:setup-results model="${model}" submit="${submit}" minConfidence="${minConfidence}" numNBest="${numNBest}" />
subdialog-return - サブダイアログとして呼び出された場合にreturn文を生成する

サブダイアログとして呼び出された場合、適切なVoiceXMLのreturn文を生成する。RDCの値は、ホストダイアログ(または呼び出し元)で意味のあるデシリアライズが行われるように、標準の公開契約に従ってシリアライズされなければならない。

使用法 <rdc:subdialog-return model="${model}" />
template - RDCテンプレート

アトミックRDCの迅速な開発のためのテンプレート

属性 名前 必須 実行時式の評価 概要
id some-name はい いいえ コンポーネントID
grammar xxx.grxml または Grammarオブジェクトの配列 はい はい このインスタンスで必要とされる1つ以上のグラマー。URIまたはGrammarオブジェクトの配列として渡される
config xxx-cfg.xml はい はい コンポーネントの設定ファイル
constraints インスタンス固有のマップ いいえ はい このインスタンスの戻り値に対する制約。Mapとして渡される
bean 完全修飾データモデルクラス いいえ はい このインスタンスのデータモデル
data インスタンス固有のオブジェクト いいえ はい このインスタンスで必要とされる外部データ
fsmFragment FSMフラグメントへのURI いいえ はい このコンポーネントのカスタムFSM
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 self-URI いいえ はい 結果が送信される場所
subdialog true/false いいえ はい サブダイアログオプション
使用法 <rdc:template id="myTemplate" grammar="grammar/myGrammar.grxml" config="config/myConfig.xml" />

rdc-examplesアプリケーションのsimple-template-test.jspを参照してください。

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

Java Docs

Javaプログラマーは、このタグライブラリのJavaクラスドキュメントをjavadocsとして閲覧できます。

改訂履歴

このタグライブラリの完全な改訂履歴を確認してください。