付録A. HATS Toolkit のファイル

HATS Toolkit を使用してプロジェクトをビルドするときに、プロジェクトの各コンポーネント用のファイルが作成されます。この付録では、システム内での各ファイルの位置、ファイルのソースを表示および編集する方法、および各ファイルを形成するタグについて説明します。

注:
これらのソース・ファイルを編集する場合は、HATS Toolkit エディターを使用します。

HATS Toolkit で作成するすべてのファイルは、ご使用のシステム上の、Rational® SDP プログラム (Rational Application Developer など) によって管理される 1 つ以上のワークスペースに格納されます。ワークスペース・ディレクトリーは選択可能であり、複数のワークスペース・ディレクトリーを持つことができます。ワークスペースの選択の詳細については、Rational SDP で提供されている情報を参照してください。

この付録に示すファイルの場所はすべて、ご使用のプロジェクトと同じ名前のディレクトリー (ご使用のワークスペース内に作成される) からの相対パスを表しています。

注:
HATS EJB (Enterprise JavaBeans™) プロジェクトに含まれるファイルは、 HATS プロジェクトに含まれるフィルとは異なります。HATS EJB プロジェクトの内容の説明については、HATS EJB アプリケーションの作成と使用を参照してください。

アプリケーション・ファイル (.hap)

アプリケーション・ファイルには、プロジェクトを作成するときに選択した設定を定義する XML タグが含まれています。

アプリケーション・ファイル (.hap) は、project_name/Web Content/WEB-INF/profiles ディレクトリーに格納されます。ここで、project_name は、プロジェクトを作成するときに付けた名前です。 HATS EJB プロジェクトのアプリケーション・ファイル (.hap) は、project_name/ejbModule ディレクトリーに格納されます。HATS プロジェクトのアプリケーション・ファイルのソースを表示したり編集したりするには、「HATS プロジェクト」ビューでプロジェクトを展開し、「プロジェクト設定」をダブルクリックしてプロジェクト・エディターを開きます。ソースを表示するには、「ソース」タブをクリックします。

アプリケーション・ファイルは、プロジェクト・エディターのタブをどれでも使用して変更できます。いずれかのタブで変更を行うと、HATS Toolkit はその他のタブ上で該当情報を更新します。

<application> タグ

<application> タグは、プロジェクトを囲むタグです。

<application> タグの属性には以下のものがあります。

active
この属性は、HATS では使用しません。HATS 限定版との互換性のために含まれています。
configured
この属性は、HATS では使用しません。HATS 限定版との互換性のために含まれています。
description
プロジェクトを作成するときに入力する説明を指定します。
template
プロジェクトの作成時にプロジェクト用として選択したテンプレートの名前を指定します。デフォルト・テンプレートは Swirl.jsp です。

<connections> タグ

<connections> タグは、このプロジェクトの接続を定義するすべての connection タグのコンテナーです。

<connections> タグの属性には以下のものがあります。

default
デフォルト接続の名前を指定します。デフォルトでは、デフォルト接続の名前は新規 HATS プロジェクト・ウィザードで指定した接続値を使用して作成される main の名前に設定されます。

<connection> タグ

<connection> タグは、プロジェクトに対して定義されている接続を識別し、接続が定義されている接続ファイル (.hco) を指し示します。

<connection> タグの属性には以下のものがあります。

name
接続の作成時に入力した名前を指定します。

<eventPriority> タグ

<eventPriority> タグは、プロジェクトについて定義した画面イベントを囲むタグです。<eventPriority> タグ内のイベント・タグの順序は、新規ホスト画面が検出されたときにチェックされる画面イベントにおける順序です。このタグには属性はありません。

<event> タグ

<event> タグは、プロジェクトに定義した画面イベントを指定します。

<event> タグの属性には以下のものがあります。

enabled
新規ホスト画面が検出されたときに画面イベントの画面認識基準をチェックするかどうかを指定します。有効な値は true および false です。デフォルト値は true です。
name
画面イベントを定義したときに付けた名前を指定します。画面イベント・ファイルをフォルダー (またはグループ) の下に格納する場合は、そのフォルダーの名前がファイル名の前に付加されます。
type
これが画面組み合わせイベントであることを指定します。使用可能な属性は screenCombination です。

<classSettings> タグ

<classSettings> タグは、プロジェクトに含める Java™ クラスを囲むタグです。このタグには属性はありません。

<class> タグ

<class> タグは、<setting> タグで囲まれた属性を持つクラスを指定します。

<class> タグの属性には以下のものがあります。

name
次のいずれかの Java クラスを指定します。

<setting> タグ

<setting> タグは、<setting> タグを囲んでいるクラスに関連する設定を指定します。<setting> タグは、クラスごとの name と value のペアを含みます。以降のセクションでは、各クラスの name と value のペアについて説明します。

com.ibm.hats.common.AppletSettings

com.ibm.hats.common.AppletSettings クラスの場合、name は、Web アプリケーション自動切断と最新表示の実装メソッド、クライアント・プル (Ajax)、およびサーバー・プッシュ (アプレット) のカスタマイズ可能な設定を指定します。以下の設定を使用して、自動切断機能および自動最新表示機能を含むクライアント・プル (Ajax) メソッドを構成できます。

browserDisconnectDelay
enable の設定が ajax で、browserDisconnectEnabled の設定が true の場合に有効です。自動切断機能を実行するまでの待機時間 (ミリ秒単位) です。最小値は 2000 ミリ秒 (2 秒) です。デフォルトは 15000 ミリ秒 (15 秒) です。
browserDisconnectEnabled
enable の設定が ajax で、この設定が true の場合は、自動切断機能が有効です。有効な場合、HATS Web アプリケーションでは、browserDisconnectDelay 設定に指定されている時間内にクライアントが Web アプリケーションをポーリングしなかった場合、切断アクションを開始します。
browserPollInterval
enable の設定が ajax の場合に有効です。browserDisconnectDelay タイマーが有効にされている場合に、ブラウザーが HATS Web アプリケーションをポーリングすることによりこのタイマーを再開し、ホスト画面の更新を検査する間隔 (ミリ秒単位) です。最小値は 1000 ミリ秒 (1 秒) です。browserDisconnectEnabled が true の場合、ポーリング間隔値は、browserDisconnectDelay 設定の値より少なくとも 1000 ミリ秒 (1 ミリ秒) 小さい必要があります。デフォルトは 5000 ミリ秒 (5 秒) です。
注:
HTTP セッション・アイドル・タイムアウトが構成されている場合は、HATS Web アプリケーションのブラウザー・ポーリングによって、HTTP セッション・アイドル・タイムアウト機能が事実上無効になります。このため、HATS ランタイムが HTTP セッション・アイドル・タイムアウト期間をモニターし、アイドル時間を超えるまでにユーザー・アクティビティーがなかった場合は HATS セッションの切断を開始します。
browserRefreshEnabled
enable の設定が ajax で、この設定が true の場合は、自動最新表示機能が有効です。使用可能にした場合、ユーザー入力がなく、ポーリング応答でホスト画面の変更が通知されたときに、ブラウザーが画面の最新表示を開始します。
enable
この設定を使用して、使用する自動切断方式および自動最新表示方式を構成します。クライアント・プル (Ajax) 方式、自動切断、および自動最新表示を構成するには、ajax を指定します。非同期アプレット更新方式とも呼ばれるサーバー・プッシュ (アプレット) 方式を構成するには、true を指定します。両方の方式を無効にするには、false を指定します。デフォルトは false です。
サーバー・プッシュ (アプレット) 方式

の設定の説明については、「HATS ユーザーと管理者のガイド」の『サーバー・プッシュ (アプレット) メソッドの使用』セクションを参照してください。

注:
サーバー・プッシュ (アプレット) 方式による切断の検出とホスト最新表示は非推奨です。代わりに、クライアント・プル (Ajax) メソッドの使用をお勧めします。アプレット方式は現在サポートされていますが、IBM は、製品の将来のリリースでこの機能を削除する権利を持っています。

com.ibm.hats.common.ApplicationKeypadTag

com.ibm.hats.common.ApplicationKeypadTag クラスの場合、name は以下のカスタマイズ可能な設定を指定します。

show
true の場合、アプリケーションの中でキーパッドを表示します。
showDefault
true の場合、表示をデフォルトの変換に変更するためのキーをアプリケーション・キーパッドに表示します。
showDisconnect
true の場合、ホストから切断するためのキーをキーパッドに表示します。
showKeyboardToggle
true の場合、アプリケーション・キーパッドの中に、ホスト・キーボードの表示を切り替えるためのキーを表示します。
showPrintJobs
true の場合、アプリケーション・キーパッドの中に、印刷ジョブを示すキーを表示します。
showRefresh
true の場合、ブラウザー・ウィンドウの内容をオリジナルの変換を使用して最新表示し、入力フィールドを元の値に復元するキーを、キーパッドに表示します。
showReset
true の場合、ブラウザー・ページ上のすべてのフィールドからエンド・ユーザーが行った入力をクリアするキーを、アプリケーション・キーパッドに表示します。
showReverse
true の場合、双方向サポート用のキーをアプリケーション・キーパッドに表示します。
style
値属性に応じて、value=buttons または links と定義されているキーをアプリケーション・キーパッドに表示します。

com.ibm.hats.common.ClientLocale

com.ibm.hats.common.ClientLocale クラスの場合、name は常に locale です。 ロケール設定の値は、ボタンの表題やメッセージの表示に使用する言語を指定します。値は次のいずれかです。デフォルトは accept-language です。

ロケールの国別コードを示す文字
cs
チェコ語
de
ドイツ語
en
英語
es
スペイン語
fr
フランス語
hu
ハンガリー語
it
イタリア語
ja
日本語
ko
韓国語
pl
ポーランド語
pt_BR
ブラジル・ポルトガル語
ru
ロシア語
tr
トルコ語
zh
中国語 (簡体字)
zh_TW
中国語 (繁体字)
accept-language
言語はユーザーのブラウザーの Accept-Language HTTP ヘッダーから取得します。
primaryLocale
言語は HATS アプリケーションを実行している WebSphere® Application Server の基本ロケールから取得します。

com.ibm.hats.common.DBCSSettings

com.ibm.hats.common.DBCSSettings クラスの場合、autoConvertSBCStoDBCS、eliminateMaxlengthInIdeographic、および showUnprotectedSISOSpace という、3 つの設定値があります。

com.ibm.hats.common.DefaultConnectionOverrides

com.ibm.hats.common.DefaultConnectionOverrides クラスの場合、allowAll という name 属性の <setting> タグが少なくとも 1 つは常に存在します。この <setting> タグは、接続パラメーターのオーバーライドに関して選択されたデフォルトのセキュリティー・ポリシーを示しています。接続のオーバーライドに関して選択されたセキュリティー・ポリシーに対するすべての例外は、追加の <setting> タグを使用して記録され、その name 属性は、例外接続パラメーターの名前に設定されます。

name 属性の有効な値は以下のとおりです。

true
エンド・ユーザーは、指定された接続パラメーターをオーバーライドできます。指定された接続パラメーターが allowAll である場合、これは、指定されていないすべての接続パラメーターをクライアント要求でオーバーライドできるという意味になります。
false
エンド・ユーザーは、指定された接続パラメーターをオーバーライドできません。指定された接続パラメーターが allowAll である場合、これは、指定されていないいずれの接続パラメーターもオーバーライドできないという意味になります。

allowAll のデフォルト設定は、false です。

com.ibm.hats.common.DefaultGVOverrides

com.ibm.hats.common.DefaultGVOverrides クラスの場合、allowAll という name 属性の <setting> タグが少なくとも 1 つは常に存在します。この <setting> タグは、グローバル変数のオーバーライドに関して選択されたデフォルトのセキュリティー・ポリシーを示しています。選択されたセキュリティー・ポリシーに対するすべての例外が追加の <setting> タグを使用して記録され、その name 属性は、hatsgv_variableName (通常のグローバル変数例外の場合) または hatssharedgv_variableName (共用グローバル変数例外の場合) に設定されます。

name 属性の有効な値は以下のとおりです。

true
エンド・ユーザーは、指定された接続パラメーターをオーバーライドできます。指定された接続パラメーターが allowAll である場合、これは、指定されていないすべての接続パラメーターをクライアント要求でオーバーライドできるという意味になります。
false
エンド・ユーザーは、指定された接続パラメーターをオーバーライドできません。指定された接続パラメーターが allowAll である場合、これは、指定されていないいずれの接続パラメーターもオーバーライドできないという意味になります。

allowAll のデフォルト設定は、false です。

com.ibm.hats.common.HostKeypadTag

com.ibm.hats.common.HostKeypadTag クラスの場合、name は以下のカスタマイズ可能な設定を指定します。

show
true の場合、アプリケーションの中でホスト・キーパッドを表示します。
ホスト・キーパッド
showAltView
true の場合、AltView キーをホスト・キーパッドに表示します。
showAttention
true の場合、ATTN キーをホスト・キーパッドに表示します。
showClear
true の場合、CLEAR キーをホスト・キーパッドに表示します。
showEnter
true の場合、Enter キーをホスト・キーパッドに表示します。
showF1 から showF24
true の場合、対応する番号の付いたファンクション・キーをホスト・キーパッドに表示します。
showFieldExit
true の場合、フィールド出口キーをホスト・キーパッドに表示します。
showFieldMinus
true の場合、「フィールドのマイナス」キーをホスト・キーパッドに表示します。
showFieldPlus
true の場合、フィールドのプラス・キーをホスト・キーパッドに表示します。
showHelp
true の場合、Help キーをホスト・キーパッドに表示します。
showPA1
true の場合、PA1 キーをホスト・キーパッドに表示します。
showPA2
true の場合、PA2 キーをホスト・キーパッドに表示します。
showPA3
true の場合、PA3 キーをホスト・キーパッドに表示します。
showPageDown
true の場合、Page Down キーをホスト・キーパッドに表示します。
showPageUp
true の場合、Page Up キーをホスト・キーパッドに表示します。
showPrint
true の場合、出力を印刷するための PRINT キーをホスト・キーパッドに表示します。
showReset
true の場合、RESET キーをホスト・キーパッドに表示します。
showSystemRequest
true の場合、SYSREQ キーをホスト・キーパッドに表示します。
style
value=true として定義したキーをホスト・キーパッドにどのように表示するのかを指定します。有効な値は buttons または links です。デフォルトは buttons です。

com.ibm.hats.common.KeyboardSupport

com.ibm.hats.common.KeyboardSupport クラスの場合、name は以下のカスタマイズ可能な設定を指定します。

enable
プロジェクトでキーボード・サポートが使用可能かどうかを指定します。キーボード・サポートが使用可能の場合、エンド・ユーザーは物理的なキーボードのキーを使用してホストと対話できます。エンド・ユーザーは、F1、SYSREQ、RESET、ATTN キーなどホストの補助キーに特定の物理的なキーをマップして押すことができます。エンド・ユーザーは、マップされた物理的なキーボードのキーを使用してブラウザーと対話する場合、キーボード・サポートを切り替えて使用不可にできます。
注:
HATS テーマをデフォルトのエミュレーター・スタイルから最新のアプリケーション・スタイルに変更できるウィザードを表示するには、これを true に設定する必要があります。
initialState
true の場合、ホスト・キーボードの初期状態はオン (ユーザーは物理的なキーボードを使用してアプリケーションと対話できる) になります。
supportAllKeys
true の場合は、表示されているボタンやリンクに関係なく、すべてのマップされたキーがサポートされます。false の場合は、以下のいずれかになります。

com.ibm.hats.common.OIA

com.ibm.hats.common.OIA クラスの場合、name は以下のカスタマイズ可能な設定を指定します。

active
true の場合、オペレーター情報域 (OIA) はプロジェクトで可視の状態にあります。デフォルトは true です。
注:
HATS テーマをデフォルトのエミュレーター・スタイルから変更したり、最新のアプリケーション・スタイルに変更したりできるウィザードを表示するには、これを true に設定する必要があります。
appletActive
true の場合、非同期更新サポートが使用可能であれば、標識が OIA に表示されます。デフォルトは false です。
autoAdvanceIndicator
true の場合、ブラウザーでサポートしていれば、自動拡張が使用可能かどうか、OIA に表示されます。デフォルトは false です。
bidiControls
true の場合、ブラウザーでサポートしていれば、現在の双方向制御を OIA に表示し編集状況を示すことができます。デフォルトは true です。
cssClass
OIA の外観を制御する Cascading Style Sheet (CSS) のクラス名を指定します。デフォルトは statusArea です。
cursorPosition
true の場合、1391 など、ホストの絶対カーソル位置が OIA に表示されます。デフォルトは false です。
cursorRowColumn
true の場合、18/031 など、ホストのカーソルの行とカラムが OIA に表示されます。デフォルトは true です。
fieldData
true の場合、numeric only や field exit required などのフィールド拡張データが OIA に表示されます。デフォルトは false です。
inputInhibited
true の場合、キーボードがロックされ、キーボードから入力不可となっているかどうか、OIA に表示されます。デフォルトは true です。
insertMode
true の場合、ブラウザーがサポートしていれば、上書きモードが使用可能になっているかどうか、OIA に表示されます。デフォルトは true です。
layout
値の属性によって、水平表示 (ページの最下部に表示) か、縦表示 (ページの横のフレームに表示) か、OIA の表示方法が決まります。デフォルトは horizontal です。
msgWaiting
true の場合、ホスト・システムにセッションについての 1 つ以上のメッセージがあれば、標識が表示されます。設定は 5250 ホスト・システムにのみ適用されます。
sslCheck
true の場合、Host On-Demand 接続が SSL で保護されているかどうか、OIA に表示されます。デフォルトは true です。
systemWait
true の場合、データの戻りを待つ間にシステムをロックするかどうか、OIA に表示されます。デフォルトは true です。

com.ibm.hats.common.RuntimeSettings

com.ibm.hats.common.RuntimeSettings クラスの場合、name は以下のカスタマイズ可能な設定を指定します。

autoEraseFields
変更された入力フィールドに変更されたデータが入力される前に、そのフィールドに [erasefld] を適用するかどうかを指定します。デフォルト値は true です。この値が false に設定されている場合は、スペース文字を使用して、ホストが以前にそのフィールドに入力したデータを置き換えることができます。
注:
  1. 複数の入力フィールドとしてレンダリングされるホスト・フィールドはいずれも、自動でクリアされません。例えば、行から行へと折り返す長いホスト・フィールドは、複数の入力フィールドとしてレンダリングされ、更新前に自動でクリアされることはありません。
  2. この設定は、プロジェクト・レベルでのみ指定できます。ただし、単一変換に対しては指定できません。
enableAutoAdvance
カーソルが入力フィールドの終わりにきたとき (つまり、入力フィールドが完全に入力されたとき) に、カーソルが次の入力フィールドに移動するかどうかを指定します。 true の場合、カーソルが入力フィールドの終わりにきたときに、カーソルが次の入力フィールドに移動します。 false の場合、ユーザーが明示的に移動させない限り、カーソルは次の入力フィールドに移動しません。デフォルトは false です。
enableAutoTabOn
カーソルが入力フィールドの終わりにきたとき (つまり、入力フィールドが完全に入力されたとき) に、タブ・キーによってカーソルを次の入力フィールドに移動させるかどうかを指定します。 true に設定されている場合、カーソルの位置が現行フィールドの終わりにきたときに、ブラウザーでの表示フィールドの順序に基づいて、タブ・キーによって現行フィールド内のカーソルを次のフィールドに移動させます。 false に設定されている場合、ユーザーが明示的に移動しない限り、タブ・キーがカーソルを次の入力フィールドに移動させることはありません。デフォルトは false です。
enableBusyPage
true に設定されている場合、複数の要求を送信すると、ページが使用中の場合の動作にリダイレクトされます。false に設定されている場合、複数の要求を送信するとクライアント・サイドでブロックされ、使用中のページは表示されません。デフォルトは false です。
enableCompression
true に設定されている場合、 HATS ランタイム (WebSphere Application Server 上で実行される) とユーザーのブラウザー間で転送されるバイト数を減らすために HTTP 圧縮フィルターが使用されます。デフォルトは false です。
escapeHTMLTags
ホスト画面のデータについて HTML タグ解釈を実行する必要があるかどうかを指定します。true の場合は、すべてのデータが単純なテキストとして解釈されます。false の場合は、有効な HTML タグとみなすことができるデータは、HTML タグであると扱われます。例えば、画面に <S>elect などのデータが含まれており、この設定が true である場合、データは単純なテキストであり、<S>elect であるとして解釈されます。この設定が false の場合、<S> は、HTML の打ち消し線タグであると解釈されます。デフォルトは false です。
注:
true の場合、テキスト置換機能を使用して指定されたデータであり、有効な HTML タグと一致するデータは、単純データとして扱われます。
enableOverwriteMode
true の場合は、入力フィールドに入力されるテキストによって、カーソル位置にあるテキストが 1 文字ずつ上書きされます。false の場合は、入力フィールドに入力されるテキストがカーソル位置に挿入され、既存のテキストが押しやられます。ユーザーは、Insert (挿入) キーを使用してこの初期設定を切り替えることができます。デフォルトは true です。
nextFieldForDropDown
true の場合は、ドロップダウン・リストから選択した場合に、カーソル位置は、次の入力フィールドに移動されます。 HATS V7.5.0.2 以降で作成される新規プロジェクトのデフォルトは true です。HATS V7.5.0.2 より前に作成されたプロジェクトのデフォルトは、false です。
注:
この設定は、enableAutoAdvance が true の場合のみ有効です。
selectAllOnFocus
true の場合は、フィールドがフォーカスを受け取ったときに、フィールド内のすべてのテキストが選択されます。Web アプリケーションの場合は、これが標準的な動作です。false の場合は、フィールドがフォーカスを受け取ったときに、いずれのテキストも選択されません。端末エミュレーターの場合は、これが標準的な動作です。
注:
  1. Web アプリケーションの場合:
    • デフォルトは true です。
    • この設定は、enableOverwriteMode 設定の動作に影響しません。
    • この設定は、アプリケーションのブラウザーに Internet Explorer が使用されている場合のみ有効です。
  2. リッチ・クライアント・アプリケーションの場合:
    • デフォルトは false です。
    • 選択した場合、この設定は、ユーザーがフィールドに入力するときに文字が上書きされる点で enableOverwriteMode 設定のように機能します。
    • テキストは、キーボードを使用して Tab キーによりフィールドに移動した場合のみ選択されます。マウスでフィールド内をクリックした場合は、テキストは選択されません。
suppressUnchangedData
true の場合、内容がフォームのレンダリング時と変わらないすべてのフィールドを使用不可にします。 false の場合、ブラウザーから受信したフィールドの内容と現在の表示スペースの内容が同一であっても、そのフィールドの内容をホストに送信します。デフォルトは false です。

com.ibm.hats.transform

com.ibm.hats.transform クラスの場合、カスタマイズ可能な設定を指定します。

alternate
alternateRenderingSet が指定されている場合、値は DEFAULT です。その他の場合は指定されません。
alternateRenderingSet
HATS コンポーネント・タグの変換中にレンダリングする対象が見つからない場合、使用するレンダリング・セットの名前をデフォルト・レンダリングに指定します。

com.ibm.hats.transform.components.name

コンポーネント設定の詳細については、「HATS ユーザーと管理者のガイド」を参照してください。

com.ibm.hats.transform.DefaultRendering

com.ibm.hats.transform.DefaultRendering クラスの場合、name は常に applicationDefaultRenderingSetName です。 value は、プロジェクトのデフォルトのレンダリング・セットとして定義するレンダリング・セットの名前を指定します。 value 設定で指定したレンダリング・セット名は、<defaultRendering> タグに指定した default 属性の値と一致しなければなりません。

com.ibm.hats.transform.widgets.name

ウィジェットの設定の詳細については、「HATS ユーザーと管理者のガイド」を参照してください。

<textReplacement> タグ

<textReplacement> タグは、プロジェクトの中で定義するテキスト置換値を囲むタグです。このタグには属性はありません。

<replace> タグ

<replace> タグは、プロジェクト内のテキスト置換値を指定します。

注:
双方向コード・ページを使用している場合は、「HATS ユーザーと管理者のガイド」を参照してください。

<replace> タグの属性には以下のものがあります。

caseSensitive
テキスト置換値の大文字小文字の区別が一致した場合のみテキスト置換を行うかどうかを指定します。有効な値は true および false です。デフォルトは false です。
from
置換するテキストを指定します。from 属性に指定するテキストは引用符で囲む必要があります。
to
テキストをテキストまたは HTML コード (Web のみ) で置き換える場合に、from 属性で指定した値の代わりに挿入する置き換えストリングを指定します。 to 属性の置き換えストリングは引用符で囲む必要があります。テキストをボタンまたはリンクと置換する場合、引用符の中にボタンやリンク用のコードを追加しなければなりません。
regularExpression
テキスト置換アルゴリズムの一部として、Java 正規表現のサポート機能を使用するかどうかを指定します。正規表現はストリングのセットを記述する文字のパターンです。正規表現を使用してパターンのオカレンスを検索、変更できます。有効な値は true および false です。デフォルトは false です。
toImage
テキストをイメージと置換する場合、from 属性で指定した値の代わりに挿入するイメージのパスと名前を指定します。toImage 属性で指定するイメージのパスと名前は引用符で囲む必要があります。
matchLTR
双方向コード・ページを使用する場合、from 属性で指定した値を LTR 画面で置換するかどうかを指定します。有効な値は true および false です。デフォルトは true です。
matchRTL
双方向コード・ページを使用する場合、from 属性で指定した値を RTL 画面で置換するかどうかを指定します。有効な値は true および false です。デフォルトは false です。
matchReverse
双方向コード・ページを使用する場合、表示される画面のセクションが元のページの方向から反転した際、from 属性で指定した値を置換するかどうかを指定します。有効な値は true および false です。デフォルトは false です。
注:
テキスト置換を使用するときは、注意が必要です。ストリングの文字数が異なるテキスト置換を行うと、画面の表示が変化することがあります。画面上の領域を提示するために使用されるウィジェットによっては、画面上の 1 行に収められているテキストが、縮小または拡張されたり、次の行に継続したりすることがあります。

<defaultRendering> タグ

<defaultRendering> タグは、プロジェクトの中で定義するすべてのレンダリング・セットを囲むタグです。

<defaultRendering> タグの属性は次のとおりです。

default
プロジェクトの中でデフォルトのレンダリングに使用するレンダリング・セットの名前を指定します。default 属性で指定したレンダリング・セット名は、com.ibm.hats.transform.DefaultRendering という名前のクラス設定の value 属性に指定した値と一致していなければなりません。

<renderingSet> タグ

<renderingSet> タグは、レンダリング・セットで定義したレンダリング項目を囲むタグです。

<renderingSet> タグの属性には以下のものがあります。

name
レンダリング・セットの作成時に指定した名前。
description
レンダリング・セットの作成時に指定した説明。
layout
変換された画面のフィールドおよびテキスト内にある不要なブランクを除去するコンパクト・レンダリングを使用するかどうかを示します。この属性は、コンパクト・レンダリングをデフォルトにする場合にのみ使用するようにしてください。 COMPACT が、layout に有効な唯一の値です。デフォルトではレンダリング・セットにこの属性は指定されておらず、コンパクト・レンダリングは使用されません。
separated
各フィールドを区別し、HTML およびブランク・スペースの量を削減するために、変換された画面でインラインの span タグを使用して出力をレンダリングするかどうかを示します。モバイル装置用に最適化された Web アプリケーションの場合、これがデフォルトです。デフォルトでは、この属性はレンダリング・セットで指定されません。
table
出力を表でレンダリングして、元のホスト画面のレイアウトを保持するようにするかどうかを示します。モバイル装置用に最適化されていない Web アプリケーションの場合、これがデフォルトです。

<renderingItem> タグ

<renderingItem> タグは、特定のレンダリング項目を囲むタグです。

<renderingItem> タグの属性には以下のものがあります。

componentIdentifier
コンポーネント情報を変換と調整するために使用するレンダリング項目の名前。デフォルト設定は、画面組み合わせイベントの名前です。
associatedScreen
このレンダリング項目の作成に使用したキャプチャーされた画面の名前。
description
レンダリングの作成時に入力した説明。
enabled
レンダリングが使用可能かどうかを表します。プロジェクト設定の「レンダリング」ページのチェック・ボックスの状態を反映します。
endCol
このレンダリング項目を適用するホスト画面の最後のカラムです。-1 は、ホスト画面の右端のカラムを意味します。
endRow
このレンダリング項目を適用するホスト画面の最後の行です。-1 は、ホスト画面の最後の行を意味します。
startCol
このレンダリング項目を適用するホスト画面の最初のカラムです。
startRow
このレンダリング項目を適用するホスト画面の最初の行です。
type
変換する対象となる内容を持つホスト・コンポーネント。この属性の値は、ホスト・コンポーネントの完全なクラス名です。この属性は必須であり、デフォルト値はありません。
widget
ホスト・コンポーネントは、このタグに指定したウィジェットに変換されます。

それぞれ固有のレンダリング項目には、次のタグも含まれています。

componentSettings
<componentSettings> タグは、このレンダリング項目のコンポーネント用に変更された設定を囲むタグです。このタグには属性はありません。
setting
<setting> タグは、このレンダリング項目のコンポーネント用に変更された設定を囲むタグです。

<setting> タグの属性には以下のものがあります。

name
コンポーネントのカスタマイズ可能な設定の名前を指定します。使用可能な設定はコンポーネントによって異なります。

コンポーネントの設定の詳細については、「HATS ユーザーと管理者のガイド」を参照してください。

value
コンポーネントのカスタマイズ可能な設定の値を指定します。デフォルト値は、設定により異なります。
widgetSettings
<widgetSettings> タグは、このレンダリング項目のウィジェット用に変更された設定を囲むタグです。このタグには属性はありません。
setting
<setting> タグは、このレンダリング項目のウィジェット用に変更された設定を囲むタグです。

<setting> タグの属性には以下のものがあります。

name
ウィジェットのカスタマイズ可能な設定の名前を指定します。使用可能な設定は、ウィジェットによって異なります。

ウィジェットの設定の詳細については、「HATS ユーザーと管理者のガイド」を参照してください。

value
ウィジェットのカスタマイズ可能な設定の値を指定します。デフォルト値は、設定により異なります。
textReplacements
<textReplacements> タグは、このレンダリング項目に指定されたテキスト置換を囲むタグです。このタグには属性はありません。
replace
<replace> タグは、このレンダリング項目のテキスト置換値を指定します。

<replace> タグの属性には以下のものがあります。

caseSensitive
テキスト置換値の大文字小文字の区別が一致した場合のみテキスト置換を行うかどうかを指定します。有効な値は true および false です。デフォルトは false です。
from
置換するテキストを指定します。from 属性に指定するテキストは引用符で囲む必要があります。
to
from 属性で指定した値の代わりに挿入する置き換えストリングを指定します。to 属性の置き換えストリングは引用符で囲む必要があります。
regularExpression
テキスト置換アルゴリズムの一部として、Java 正規表現のサポート機能を使用するかどうかを指定します。正規表現はストリングのセットを記述する文字のパターンです。正規表現を使用してパターンのオカレンスを検索、変更できます。有効な値は true および false です。デフォルトは false です。
toImage
テキストをイメージと置換する場合、from 属性で指定した値の代わりに挿入するイメージのパスと名前を指定します。toImage 属性で指定するイメージのパスと名前は引用符で囲む必要があります。
matchLTR
双方向コード・ページを使用する場合、from 属性で指定した値を LTR 画面で置換するかどうかを指定します。有効な値は true および false です。デフォルトは true です。
matchRTL
双方向コード・ページを使用する場合、from 属性で指定した値を RTL 画面で置換するかどうかを指定します。有効な値は true および false です。デフォルトは false です。
matchReverse
双方向コード・ページを使用する場合、表示される画面のセクションが元のページの方向から反転した際、from 属性で指定した値を置換するかどうかを指定します。有効な値は true および false です。デフォルトは false です。
注:
テキスト置換を使用するときは、注意が必要です。ストリングの文字数が異なるテキスト置換を行うと、画面上の HTML 表現が変化することがあります。画面上の領域を提示するために使用されるウィジェットによっては、画面上の 1 行に収められているテキストが、縮小または拡張されたり、次の行に継続したりすることがあります。

<globalRules> タグ

<globalRules> タグは、プロジェクトの中で定義するグローバル規則を囲むタグです。このタグには属性はありません。

<rule> タグ

<rule> タグは、グローバル規則を定義します。

プロジェクト・レベル規則用の <rule> タグの属性は、画面カスタマイズ・レベルのグローバル規則用の属性と同じです。しかし、同じ入力フィールドを使用してプロジェクト・レベルと画面カスタマイズ・レベルのグローバル規則を作成すると、画面カスタマイズ・レベル規則の優先順位の方が高くなります。 <rule> タグの属性には以下のものがあります。

associatedScreen
グローバル規則を定義する際の基準となる、プロジェクトの中の画面キャプチャーの名前。
description
グローバル規則の作成時に入力した説明。
enabled
グローバル規則が使用可能かどうかを表します。プロジェクト設定の「レンダリング」ページのチェック・ボックスの状態を反映します。
endCol
このグローバル規則を適用するべきホスト画面の最後のカラムです。-1 は、ホスト画面の右端のカラムを意味します。
endRow
このグローバル規則を適用するべきホスト画面の最後の行です。-1 は、ホスト画面の最後の行を意味します。
name
「プロジェクト設定」の「レンダリング」ページのグローバル規則のリストに表示される名前。
startCol
このグローバル規則を適用するべきホスト画面の最初のカラムです。
startRow
このグローバル規則を適用するべきホスト画面の最初の行です。
transformationFragment
グローバル規則に関連付けられた変換フラグメント・ファイルの名前。このファイルには、ホスト・コンポーネントの変換方法を指定する情報が含まれています。該当するフィールドがホスト画面に存在する場合、この情報は変換に組み込まれます。
type
このグローバル規則のパターン・タイプ・コンポーネントで、「グローバル規則の作成」ウィザードの最初のページで取得します。タイプは次のいずれかです。
com.ibm.hats.transform.components. InputFieldByTextPatternComponent
このパターン・コンポーネントは、フィールド近くのテキストを基にしてホスト画面上の入力フィールドを認識します。
com.ibm.hats.transform.components. AllInputFieldsPatternComponent
このパターン・コンポーネントは、ホスト画面上のすべての入力フィールドを認識します。
com.ibm.hats.transform.components. InputFieldBySizePatternComponent
このパターン・コンポーネントは、入力フィールドのサイズを基にしてホスト画面上の入力フィールドを認識します。
com.ibm.hats.transform.components. InputFieldByPositionPatternComponent
このパターン・コンポーネントは、ホスト画面上のフィールドの位置により、ホスト画面上の入力フィールドを認識します。

それぞれ固有のグローバル規則には、次のタグも含まれています。

componentSettings
<componentSettings> タグは、<rule> タグの型属性で指定したパターン・タイプ・コンポーネント用に定義された設定を囲むタグです。このタグには属性はありません。
setting
<setting> タグは、<rule> タグの型属性で指定したパターン・タイプ・コンポーネント用に定義された設定を囲むタグです。

<setting> タグの属性には以下のものがあります。

name
パターン・タイプ・コンポーネントのカスタマイズ可能な設定の名前を指定します。使用可能な設定はコンポーネントによって異なります。
  • com.ibm.hats.transform.components.InputFieldByTextPattern Component の場合、name 属性の設定は以下のとおりです。
    caseSensitive
    パターンを認識する前に、テキスト設定で大文字小文字の区別を一致させる必要があるかどうかを指定します。有効な値は true および false です。デフォルトは true です。
    immediatelyNextTo
    変換する入力フィールドを指定します。有効な値は以下のとおりです。
    true
    最も近い入力フィールドのみ変換の必要があることを指定します。
    false
    すべての入力フィールドを変換する必要があることを指定します。
    デフォルトは false です。
    location
    テキスト設定で指定した保護フィールドのテキストを、適用するグローバル規則の入力フィールドに対してどの位置に置くかを指定します。有効な値は以下のとおりです。
    ABOVE
    入力フィールドの上に表示するテキストを指定します。
    BELOW
    入力フィールドの下に表示するテキストを指定します。
    LEFT
    入力フィールドの左に表示するテキストを指定します。
    RIGHT
    入力フィールドの右に表示するテキストを指定します。
    デフォルトは RIGHT です。
    text
    ホスト画面の保護フィールドに表示するテキストを指定します。有効な値は、ホスト画面上の保護フィールドの中の任意のテキストです。
  • com.ibm.hats.transform.components.AllInputFieldsPattern Component の場合、コンポーネント設定はありません。
  • com.ibm.hats.transform.components.InputFieldBySizePattern Component の場合、name 属性の設定は fieldSize です。 有効な値は、ホスト画面上の任意の入力フィールドのサイズです。
  • com.ibm.hats.transform.components. InputFieldByPositionPatternComponent の場合、name 属性の設定は enableFieldLength です。 有効な値は true および false です。
    注:
    enableFieldLength が指定される場合、フィールドが認識されるためには、そのフィールド全体 (fieldSize 属性で指定されたもの) が定義された領域の境界内になければなりません。領域の境界は、startRow、endRow、startCol、および endCol 属性の値によって定義されます。

接続ファイル (.hco)

HATS プロジェクトで定義するそれぞれの接続は、接続ファイルによって表現されます。接続ファイル (.hco) は、project_name/Connections フォルダーに格納されます。ここで、project_name は、プロジェクトを作成したときに付けた名前です。新規 HATS プロジェクト・ウィザードで指定した接続値を使用して作成されるデフォルト接続は、main.hco に保管されます。

<hodconnection> タグ

<hodconnection> タグは、接続定義の始まりであり、接続に関するいくつかの特性を指定します。

<hodconnection> タグの属性には以下のものがあります。

certificateFile
プロジェクトの SSL 証明書をインポートした場合は、インポート元のファイルの名前を指定します。
codePage
この接続で使用するコード・ページの数値を指定します。デフォルト値は、プロジェクトの作成時に選択した値です。接続ごとに、別のコード・ページを使用できます。コード・ページ番号については、codePageKey 属性の説明を参照してください。
codePageKey
数字コード・ページに対応する使用目的キーを指定します。デフォルト値は KEY_US です。codePage の有効な値と、それぞれの場所または使用目的キーは以下のとおりです。
表 7. コード・ページと使用目的キー
コード・ページ 使用目的キー
037
KEY_BELGIUM
KEY_BRAZIL
KEY_CANADA
KEY_NETHERLANDS
KEY_PORTUGAL
KEY_US
273
KEY_AUSTRIA
KEY_GERMANY
274
KEY_BELGIUM_OLD
275
KEY_BRAZIL_OLD
277
KEY_DENMARK
KEY_NORWAY
278
KEY_FINLAND
KEY_SWEDEN
280
KEY_ITALY
284
KEY_SPAIN
KEY_LATIN_AMERICA
285
KEY_UNITED_KINGDOM
297
KEY_FRANCE
420
KEY_ARABIC
424
KEY_HEBREW
500
KEY_MULTILINGUAL
803
KEY_HEBREW_OLD
838
KEY_THAI
870
KEY_BOSNIA_HERZEGOVINA
KEY_CROATIA
KEY_CZECH
KEY_HUNGARY
KEY_POLAND
KEY_ROMANIA
KEY_SLOVAKIA
KEY_SLOVENIA
871
KEY_ICELAND
875
KEY_GREECE
924
KEY_MULTILINGUAL_ISO_EURO
930
KEY_JAPAN_KATAKANA
933
KEY_KOREA_EX
937
KEY_ROC_EX
939
KEY_JAPAN_ENGLISH_EX
1025
KEY_BELARUS
KEY_BULGARIA
KEY_MACEDONIA
KEY_RUSSIA
KEY_SERBIA_MONTEGRO
1026
KEY_TURKEY
1047
KEY_OPEN_EDITION
1112
KEY_LATVIA
KEY_LITHUANIA
1122
KEY_ESTONIA
1123
KEY_UKRAINE
1137
KEY_HINDI
1140
KEY_BELGIUM_EURO
KEY_BRAZIL_EURO
KEY_CANADA_EURO
KEY_NETHERLANDS_EURO
KEY_PORTUGAL_EURO
KEY_US_EURO
1141
KEY_AUSTRIA_EURO
KEY_GERMANY_EURO
1142
KEY_DENMARK_EURO
KEY_NORWAY_EURO
1143
KEY_FINLAND_EURO
KEY_SWEDEN_EURO
1144
KEY_ITALY_EURO
1145
KEY_LATIN_AMERICA_EURO
KEY_SPAIN_EURO
1146
KEY_UNITED_KINGDOM_EURO
1147
KEY_FRANCE_EURO
1148
KEY_MULTILINGUAL_EURO
1149
KEY_ICELAND_EURO
1153
KEY_BOSNIA_HERZEGOVINA_EURO
KEY_CROATIA_EURO
KEY_CZECH_EURO
KEY_HUNGARY_EURO
KEY_POLAND_EURO
KEY_ROMANIA_EURO
KEY_SLOVAKIA_EURO
KEY_SLOVENIA_EURO
1154
KEY_BELARUS_EURO
KEY_BULGARIA_EURO
KEY_MACEDONIA_EURO
KEY_RUSSIA_EURO
KEY_SERBIA_MONTEGRO_EURO
1155
KEY_TURKEY_EURO
1156
KEY_LATVIA_EURO
KEY_LITHUANIA_EURO
1157
KEY_ESTONIA_EURO
1158
KEY_UKRAINE_EURO
1160
KEY_THAI_EURO
1166
KEY_KAZAKHSTAN_EURO
1364
KEY_KOREA_EURO
1371
KEY_ROC_EURO
1388
KEY_PRC_EX_GBK
1390
KEY_JAPAN_KATAKANA_EX_EURO
1399
KEY_JAPAN_ENGLISH_EX_EURO
connecttimeout
HATS がホストに接続を試みる時間を指定します。1 から 2147483647 までの秒数を指定します。初期デフォルト値は 120 秒です。
description
作成したときの接続の説明を指定します。
disableFldShp
双方向コード・ページを使用する場合、パスワード・フィールドのアラビア語データを別個の形式または整形された形式でホストに送信するかどうか指定します。有効な値は true および false です。初期デフォルト値はありません。
disableNumSwapSubmit
双方向ページ・コードを使用する場合、アラビア (西洋) 数字の入力を無効にするかどうか (つまり、 RTL 画面で、アラビア (インド) 数字のみの入力を許可すること) を指定します。これを指定すると、送信時にすべての数字はアラビア (西洋) 数字として送信されます。有効な値は true および false です。初期デフォルト値はありません。
disconnecttimeout
HATS がホストとの接続の切断を試みる時間を指定します。秒数を 1 から 2147483647 の範囲で指定します。初期デフォルト値は 120 秒です。
enableScrRev
双方向コード・ページを使用する場合、表示テキストおよび入力フィールドの方向を反転するのに必要な「画面を反転」ボタンを表示するアプリケーションのページを指定します。有効な値は以下のとおりです。
(blank)
「画面を反転」ボタンはどの画面にも配置されません。
Customized
「画面を反転」ボタンは、画面カスタマイズに一致する画面および画面カスタマイズに一致しない画面に配置されます。つまり、すべての画面に配置されます。画面カスタマイズに一致する画面にのみ「画面を反転」ボタンを配置するオプションはありません。
Non-customized
「画面を反転」ボタンは、画面カスタマイズに一致しない画面にのみ配置されます。
初期デフォルト値はありません。
host
接続先ホストの名前を指定します。
hostSimulationName
ライブ接続の代わりに使用するためのホスト・シミュレーション・トレース・ファイルの名前を指定します。
LUName
拡張 3270 セッションのみ有効 (TNEnhanced="true")。LUName プロパティー (拡張ネゴシエーションで使用する LU 名) を設定します。値はストリング・フォーマットです。LUName の最大長は 17 文字です。デフォルト値はありません。3270 HATS プロジェクトに対して印刷サポートを構成するには、ホスト・タイプとして 3270E を指定する必要があります。接続設定のリストに LUName パラメーターを追加するときは、プリンター LU 名ではなく、ご使用のディスプレイ LU 名またはディスプレイ LU のプールを使用してください。
LUNameSource
拡張 3270 セッションのみ有効 (TNEnhanced="true")。接続の LU 名のソースを指定します。有効な値は以下のとおりです。
automatic
LU 名は、接続が確立された際、自動的に割り当てられます。
prompt
エンド・ユーザーに LU 名の入力を求めるプロンプトが表示されます。プールが使用可能な場合、プロンプトは使用できません。
session
HTTP セッション変数を使用して LU 名を定義します。LUName 属性がセッション変数の名前を表します。プールが使用可能な場合、セッションは使用できません。
value
LU 名は LUName 属性で定義します。
初期デフォルト値はありません。
port
ホストへの接続に使用するポートの番号を指定します。有効なポートの範囲は、0 から 65535 です。初期デフォルト値は 23 です。
screenSize
ホスト端末に表示する行数とカラム数を指定します。screenSize の有効な値は以下のとおりです。 初期デフォルトの画面サイズは、24 x 80 です。
sessionType
ホスト端末に表示する端末のタイプを指定します。type の有効な値は以下のとおりです。 初期デフォルト値は 3270 です。
singlelogon
プロジェクトにユーザー・リストが定義されている場合、1 つのユーザー ID を一度に複数回使用可能にするかどうかを指定します。有効な値は以下のとおりです。
true
ユーザー ID は、一度に 1 回しか使用できません。
false
ユーザー ID は、同時に複数回接続することができます。
初期デフォルト値は false です。
SSL
SSL を使用可能にするかどうかを指定します。有効な値は以下のとおりです。
true
このプロジェクトに対して SSL が使用可能にされます。
false
このプロジェクトに対して SSL は使用可能にされません。
TNEnhanced
3270 接続でのみ有効です。接続が TN3270E 接続かどうかを指定します。有効な値は true および false です。初期デフォルト値は true です。
VTTerminalType
VT 接続でのみ有効です。VT 端末のタイプを表します。有効な値は以下のとおりです。
WFEnabled
5250 接続でのみ有効です。その接続が 5250W 接続であるかどうかを指定します。有効な値は true および false です。初期デフォルト値は false です。
workstationID
5250 および 5250W 接続でのみ有効です。workstationIDSource 属性が session または value に設定されている場合は、接続用に HTTP セッション変数またはワークステーション ID を指定します。初期デフォルト値はありません。
workstationIDSource
5250 および 5250W 接続でのみ有効です。接続用のワークステーション ID のソースを指定します。有効な値は以下のとおりです。
automatic
ワークステーション ID は、接続が確立された際、自動的に割り当てられます。
prompt
エンド・ユーザーにワークステーション ID の入力を求めるプロンプトが表示されます。プールが使用可能な場合、プロンプトは使用できません。
session
HTTP セッション変数を使用してワークステーション ID を定義します。ワークステーション ID の属性がセッション変数の名前を表します。プールが使用可能な場合、セッションは使用できません。
value
ワークステーション ID は workstationID 属性で定義します。
初期デフォルト値はありません。

<otherParameters> タグ

<otherParameters> タグは、その他の Host On-Demand セッション・パラメーターを指定します。

HATS がサポートする Host On-Demand セッション・パラメーターには以下のものがあります。

ENPTUI
5250 ホストに接続したプロジェクトで、拡張非プログラマブル端末ユーザー・インターフェース (ENPTUI) 用の表示データ・ストリーム (DDS) のキーワードを使用できるかどうかを決めます。有効な値は true および false です。デフォルト値は false です。
HTMLDDS
5250 ホストへの接続を使用するプロジェクトで、5250 ディスプレイ・データ・ストリーム (DDS) と共に HTML フラグメントを使用できるかどうかを決定します。この機能は、標準エミュレーション・プログラムでの表示を目的としたものではありません。HTML フラグメントは、ブラウザー内でこの HTML データを表示するように拡張された 5250 Workstation Gateway 装置、および HATS などのホスト・アクセス製品にのみ送信されます。HTML DDS は、ホスト・タイプが 5250 に指定されている場合に、コンポーネントとして使用できます。このコンポーネントの使用はデフォルト・レンダリングの一部ではないため、デフォルト・レンダリングまたはカスタム変換に追加する必要があります。有効な値は以下のとおりです。 詳しくは、「HATS ユーザーと管理者のガイド」または HATS インフォメーション・センター (http://publib.boulder.ibm.com/infocenter/hatshelp/v75/index.jsp) を参照してください。
Lamalef
LamAlef プロパティー (LamAlef を展開するか圧縮するか) を設定します。このプロパティーはアラビア語セッションのみに適用されます。値はストリング・フォーマットです。有効な値は以下のとおりです。 デフォルト値は LAMALEF_OFF です。
numeralShape
numeralShape プロパティーを設定します。このプロパティーは双方向セッションのみに適用されます。値はストリング・フォーマットです。デフォルト値は NOMINAL です。
numericSwapEnabled
数値スワッピング・プロパティーを設定します。このプロパティーはアラビア語 3270 セッションのみに適用されます。有効な値は true および false です。デフォルト値は true です。
roundTrip
roundTrip プロパティーを設定します。このプロパティーは双方向セッションのみに適用されます。値はストリング・フォーマットです。有効な値は以下のとおりです。 デフォルトは ROUNDTRIP_ON です。
SecurityProtocol
SecurityProtocol プロパティーを設定します。このプロパティーは、セキュリティー確保のために TLS v1.0 プロトコルまたは SSL プロトコルのどちらを使用するかを示します。値はストリング・フォーマットです。デフォルト値は TLS です。
SSLServerAuthentication
SSLServerAuthentication プロパティーを設定します。このプロパティーは、SSL サーバーを使用可能にするかどうかを示します。有効な値は true および false です。デフォルト値は false です。
symmetricSwapEnabled
対称スワッピングのプロパティーを設定します。このプロパティーはアラビア語 3270 セッションのみに適用されます。有効な値は true および false です。デフォルト値は true です。
textOrientation
textOrientation プロパティーを設定します。このプロパティーは双方向セッションのみに適用されます。値はストリング・フォーマットです。有効な値は以下のとおりです。 デフォルト値は LEFT_TO_RIGHT です。
ThaiDisplayMode
タイ語表示モード・プロパティーを設定します。このプロパティーはタイ語セッションのみに適用されます。値はストリング・フォーマットです。デフォルト値は THAI_MODE_5 です。
workstationID
workstationID プロパティーを設定します。このプロパティーは、5250 用拡張ネゴシエーションで使用されます。値はストリング・フォーマットです。小文字はすべて大文字に変換されます。デフォルト値はありません。

<classSettings> タグ

<classSettings> タグは、接続定義に含める Java クラスを囲むタグです。

<class> タグ

<class> タグは、<settings> タグで囲まれた属性を持つクラスを指定します。

<class> タグの属性には以下のものがあります。

name
次のいずれかの Java クラスを指定します。 name 属性に指定するクラス名は引用符で囲む必要があります。

<setting> タグ

<setting> タグは、<setting> タグを囲んでいるクラスに関連する設定を指定します。

<setting> タグの属性には以下のものがあります。

name
<class> タグの name 属性によって定義したクラスのカスタマイズ可能な設定の名前を指定します。使用可能な設定は、クラスによって異なります。

com.ibm.hats.common.HATSPrintSettings クラスの場合、カスタマイズ可能な設定は以下のとおりです。

printFontName
出力の印刷に使用するフォントを指定します。有効な値は、codePage 属性の値によって異なります。
printNumSwapSupport
数値スワッピングを使用可能にするかどうかを指定します。printRTLSupport が使用可能な場合、このプロパティーはアラビア語 3270 セッションのみに適用されます。英語の数表示は RTL 画面でアラビア数字に置き換わり、アラビア数字は RTL 画面で英語の数表記に置き換わります。有効な値は true および false です。デフォルト値は true です。
printOrientation
印刷出力をページ上にどのように配置するかを指定します。printOrientation の有効な値は以下のとおりです。
PDF_ORIENTATION_PORTRAIT
用紙を縦に使用します。
PDF_ORIENTATION_LANDSCAPE
用紙を 90 度右回転します。
printPaperSize
出力を印刷する用紙のサイズを指定します。printPaperSize の有効な値は以下のとおりです。
ISO_A3
ISO/DN & JIS A4、297 x 420 mm
ISO_A4
ISO/DN & JIS A4、210 x 297 mm
ISO_A5
ISO/DN & JIS A4、148 x 210 mm
ISO_B4
ISO/DN B4、250 x 353 mm
ISO_B5
ISO/DN B5、176 x 250 mm
JIS_B4
JIS B4、257 x 364 mm
JIS_B5
JIS B5、182 x 257 mm
ISO_C5
ISO/DN C5、162 x 229 mm
ISO_DESIGNATED_LONG
ISO/DN Designated Long、110 x 220 mm
EXECUTIVE
Executive、7 1/4 x 10 1/2 in
LEDGER
Ledger、11 x 17 in
NA_LETTER
North American Letter、8 1/2 x 11 in
NA_LEGAL
North American Legal、8 1/2 x 14 in
NA_NUMBER_9_ENVELOPE
North American #9 Business Envelope、3 7/8 x 8 7/8 in
NA_NUMBER_10_ENVELOPE
North American #10 Business Envelope、4 1/8 x 9 1/2 in
MONARCH_ENVELOPE
Monarch Envelope、3 7/8 x 7 1/2 in
CONTINUOUS_80_COLUMNS
Data Processing 80 Columns Continuous Sheet、8 x 11 in
CONTINUOUS_132_COLUMNS
Data Processing 132 Columns Continuous Sheet、13 1/5 x 11 in
printRTLSupport
RTL 印刷のサポートを使用可能にするかどうかを指定します。このプロパティーはアラビア語 3270 セッションのみに適用されます。双方向ファイルは RTL ファイルまたは LTR ファイルのどちらでもかまいません。有効な値は true および false です。デフォルト値は true です。
printSupport
プロジェクトに印刷機能が含まれているかどうかを指定します。printSupport の有効な値は、true および false です。初期デフォルト値は false です。
printSymSwapSupport
対称スワッピングが使用可能かどうかを指定します。スワッピング文字は RTL 画面でスワップされます。printRTLSupport が使用可能な場合、このプロパティーはアラビア語 3270 セッションのみに適用されます。有効な値は true および false です。デフォルト値は true です。
printURL
5250 サーバーの System i® Access for Web Printer Output ウィンドウの URL を指定します。デフォルトの URL は、http://hostname/webaccess/iWASpool です。hostname は 5250 サーバーの名前です。

com.ibm.hats.common.NextScreenSettings クラスの場合、カスタマイズ可能な設定は以下のとおりです。

default.appletDelayInterval
非同期更新モードで実行中のセッションについて、フル・ホスト画面が到達するまでにサーバーが待機する最大時間 (ミリ秒単位) を指定します。初期デフォルト値は 400 ミリ秒です。
default.blankScreen
接続開始時に受信するブランク画面の取り扱い方法を指定します。有効な値は以下のとおりです。
normal
ブランク画面を表示します。
sendkeys
default.blankScreen.keys 設定に定義されたホスト・キーを送信します。
timeout
接続がタイムアウトになり、エラー・メッセージが発行されるまで待機します。
デフォルトは normal です。
default.blankScreen.keys
default.blankScreen に sendkeys を設定した場合、送信するホスト・キーを指定します。
default.delayInterval
初期画面更新後に次の画面更新に到達するまでにサーバーが待機する最大時間 (ミリ秒単位) を指定します。初期デフォルト値は 1200 ミリ秒です。
default.delayStart
ホスト接続の準備が完了してから最初のフル・ホスト画面が到達するまでにサーバーが待機する最小時間 (ミリ秒単位) を指定します。初期デフォルト値は 2000 ミリ秒です。
nextScreenClass
正確性を重視する場合に、速度が最適化されたデフォルトのアルゴリズムをオフにするクラスを指定します。value 属性のクラスは、com.ibm.hats.runtime.TimingNextScreenBean です。その結果、画面遷移が遅くなる可能性があります。default.delayInterval 設定では、画面遷移に要する時間は最小 (ミリ秒単位) に設定されています。default.delayInterval のデフォルト値は 1200 ミリ秒ですが、ネットワークやホスト・アプリケーションに合わせてカスタマイズできます。この値を大きくした場合、HATS はホスト画面が安定するまで最低でもこの時間待機することに注意してください。
oiaLockMaxWait
ホスト画面が安定し、OIA システム・ロックの状況が確実にリリースされた後 HATS が待機する最大時間 (ミリ秒単位) を指定します。値の範囲は、0 ミリ秒から 600000 ミリ秒です。初期デフォルト値は 300000 ミリ秒です。
value
この設定の値は、個別の設定の記述に組み込まれています。

<poolsettings> タグ

<poolsettings> タグは、接続のプール・パラメーターを定義します。

<poolsettings> タグの属性には以下のものがあります。

enabled
この接続でプールが有効かどうかを指定します。enabled の有効な値は、true および false です。初期デフォルト値は false です。
maxbusytime
エンド・ユーザーが使用している接続が終了するまでの秒数。アクティブ接続を終了させない場合は、このフィールドを -1 に設定します。この設定は、プール可能な接続と、プール不能な接続の両方で有効です。プール可能な接続の場合、プール内の有効接続数が、接続状態のまま保持するように指定した最小接続数よりも少なくなると、接続がプールに戻ります。そうでない場合、この接続は廃棄されます。プール不能な接続の場合、接続は廃棄されます。有効な秒数は -1 または 60 から 2147483647 の範囲です。デフォルトは -1 (最大使用中時間なし) です。
maxconnections
プール内でアクティブにすることのできる接続の最大数。この設定は、プール可能な接続でのみ有効です。有効な接続の数は 1 から 2147483647 の範囲です。デフォルトは、1 です。指定した最大値に達した場合、追加の接続要求を受け取ると、HATS では、次の有効な接続を待機するか、新しい接続を作成することができます。
maxidletime
エンド・ユーザーが使用していない接続が、終了してプールから除去されるまでの秒数。非アクティブ接続を終了させない場合は、このフィールドを -1 に設定します。この設定は、プール可能な接続でのみ有効です。最小接続数に指定した数の接続は、使用中かどうかに関係なく、接続状態のまま保たれます。有効な秒数は -1 または 60 から 2147483647 の範囲です。デフォルトは -1 (最大アイドル時間なし) です。
minconnections
プール内、接続状態のまま保持するアイドル接続の数。この設定は、接続がプール可能であり、かつ、切断までの最大アイドル時間が -1 以外の値に設定されている場合にのみ有効です。有効な接続数は、0 から 2147483647 です。デフォルトは 0 (接続を接続状態のまま保持しない) です。
overflowallowed
最大接続数に達した場合に、非プール接続を新たに作成するかどうかを指定します。この値が false の場合は、プール接続が使用可能になるまでに待機する秒数を指定する必要があります。待機時間が経過しても接続が使用可能にならない場合、HATS からエラーが戻ります。この値が true の場合は、非プール接続が新たに作成されます。エンド・ユーザーがこのタイプの接続の使用を終了したとき、接続はプールに戻されずに廃棄されます。
waittimeout
最大接続数に達した場合、別の接続要求が到着したときに、プール接続が使用可能になるまでに待機する秒数。有効な秒数は、0 から 2147483647 までか、-1 (いつまでも待機する) です。デフォルト値は 120 です。

<webexpresslogon> タグ

<webexpresslogon> タグは、この接続に対して Web 高速ログオン機能が使用可能かどうかを示します。

<webexpresslogon> タグの属性は以下のとおりです。

enabled
この接続に対して Web 高速ログオン機能が使用可能かどうかを指定します。enabled の有効な値は、true および false です。初期デフォルト値は false です。

<userconfig> タグ

<userconfig> タグは、接続のユーザー・リストを定義します。 <userconfig> タグの内側のタグおよびデータは複雑であるため、手動編集を行うと破損する可能性があります。ユーザー・リストの整合性を保護するために、<userconfig> データは手動編集しないでください。ユーザー・リストを作成または変更する場合には、代わりに接続エディターの「ユーザー・リスト」タブを使用してください。デフォルトではホスト接続にこのタグは指定されておらず、ユーザー・リストはありません。

テンプレート・ファイルと変換ファイル (.jsp)

これらの JavaServer Page (JSP) ファイルには、エンド・ユーザーのブラウザーにプロジェクトをどのように表示するかを定義する HTML および JSP タグ設定が含まれています。

テンプレート .jsp ファイルは、project_name/Web Content/Templates ディレクトリーに格納されています。変換 .jsp ファイルは、project_name/Web Content/Transformations ディレクトリーに格納されています。 .jsp ファイルのソースを表示および編集するには、「HATS プロジェクト表示」でテンプレートまたは変換の名前をダブルクリックして、JSP エディターをオープンします。そして、「ソース」タブをクリックして、ファイルのソースを表示することができます。

JSP エディターで「設計 (Design)」タブまたは「ソース」タブを使用して、テンプレート・ファイルおよび変換ファイルを変更することができます。一方のタブで変更を行うと、もう一方のタブで影響のある情報が更新されます。

テンプレート .jsp ファイルには、プロジェクト・ページ用のリンクおよびイメージを定義する HTML タグ設定が含まれています。テンプレート .jsp ファイルには、<HATS:Transform> タグも含まれています。このタグは、プロジェクトのページを提示するためにテンプレートと共に使用する変換を定義します。

変換 .jsp ファイルには、Web ブラウザーでプロジェクトのユーザーに提示する情報のレイアウトを記述する HTML タグが含まれています。変換 .jsp ファイルには、<HATS:Component> タグも含まれていることがあります。このタグは、プロジェクトのページを提示するために使用する HATS コンポーネントおよびウィジェットを定義します。<HATS:Component> タグの詳細については、HATS のコンポーネント・タグおよび属性を参照してください。

画面組み合わせファイル (.evnt)

画面組み合わせファイルは、ホスト画面をどのように認識するかを定義するほか、画面が認識されたときに HATS が実行するアクション、画面組み合わせの終了を定義する方法、および画面間をナビゲートする方法も定義します。画面組み合わせ (.evnt) ファイルは project_name/Web Content/WEB-INF/profiles/events/screencombinations ディレクトリーに格納されています。画面組み合わせファイルのソースを表示および編集するには、「HATS プロジェクト」ビューで目的の画面組み合わせの名前をダブルクリックして、画面組み合わせエディターを開きます。そして、「ソース」タブをクリックして、ファイルのソースを表示することができます。エディターで、「開始画面」、「レンダリング (Render)」、「ナビゲーション」、「終了画面」、「アクション」、「テキスト置換」、または「ソース」タブを使用して、画面組み合わせファイルを変更することができます。いずれかのタブで変更を行うと、HATS Toolkit はその他のタブ上で該当情報を更新します。画面組み合わせイベント・ファイルには、ホスト画面をどのように認識するか、およびホスト画面が認識されたときに行うアクションとナビゲーションを定義するタグが含まれています。

画面組み合わせにより、いくつかのタグが画面カスタマイズ (.evnt) ファイルで検出されたタグに追加されます。

<combinations> タグ

これは、組み合わせ情報のコンテナーです。 type 属性および画面組み合わせコンポーネントの詳細を説明するレンダリング項目で構成されます。

type
type パラメーターにより、画面変換が集約される方法を判別します。

文字列値が dynamic に設定されている場合、ユーザーが画面変換を使用している間、画面変換によって、結合領域に画面を追加できます。

文字列値が normal に設定されているか、または欠落している場合、ユーザーが画面変換と相互作用できるようになる前に、個々の画面が結合します。リッチ・クライアント画面結合は通常処理に制限されます。

<enddescription> タグ

これは、画面結合終了画面に達したかどうかを判別するために使用する画面基準について説明します。タグおよび詳細は description タグと一致します。終了画面に関連した画面には、属性 associatedScreen があります。

associatedScreen
これは、終了画面に関連した画面キャプチャーです。

<navigation> タグ

ナビゲーションには、データの収集および配置を行うために、画面間を移動するのに必要なコマンドが含まれます。 screenUp および screenDown タグで構成されます。

<screenUp> タグ

組み合わせ内で画面を逆方向にトラバースするのに必要なコマンド。これは、データを画面組み合わせ内の正しい位置に戻すために使用されます。 keyPress、setCursor、および sendText タグで構成されます。

<screenDown> タグ

組み合わせ内で画面を順方向にトラバースするのに必要なコマンド。これは、データを画面組み合わせ内の正しい位置に戻すと同時に、画面組み合わせビューを作成するために使用されます。 keyPress、setCursor、および sendText タグで構成されます。

<keyPress> タグ

このナビゲーション・コマンドは sendKey に相当します。 HOD コマンド送信用の value 属性があります。これは、有効な HOD キー・コマンドでなければなりません。

value
keyPress タグの value 属性は、有効な HOD キー・コマンドでなければなりません。

<setCursor> タグ

このナビゲーション・コマンドにより、カーソルを画面上に配置できます。カーソル配置用の row および column 属性があります。

row
row 属性は、画面上の位置に相当する、1 を基準とした整数でなければなりません。これは、カーソル位置の垂直コンポーネントを位置決めします。
column
column 属性は、画面上の位置に相当する、1 を基準とした整数でなければなりません。これは、カーソル位置の水平コンポーネントを位置決めします。

<sendText>

このナビゲーション・コマンドは sendKey に相当します。テキスト送信用の value 属性があります。これは、ホスト・フィールドの有効なテキストでなければなりません。

value
sendText タグの value 属性は、ホスト・フィールドの有効なテキストでなければなりません。

画面カスタマイズ・ファイル (.evnt)

画面カスタマイズ・ファイルは、ホスト画面をどのように認識するかを定義するほか、画面が認識されたときに HATS が行うアクションも定義します。

画面カスタマイズ (.evnt) ファイルは、project_name/Web Content/WEB-INF/profiles/events/screencustomizations ディレクトリーに格納されています。画面カスタマイズ・ファイルのソースを表示および編集するには、「HATS プロジェクト表示」で目的の画面カスタマイズの名前をダブルクリックして、画面カスタマイズ・エディターを開きます。そして、「ソース」タブをクリックして、ファイルのソースを表示することができます。

エディターで、「画面認識基準」、「アクション」、「テキスト置換」、または「ソース」タブを使用して、画面カスタマイズ・ファイルを変更することができます。いずれかのタブで変更を行うと、HATS Toolkit はその他のタブ上で該当情報を更新します。

画面カスタマイズ・イベント・ファイルには、ホスト画面をどのように認識するか、およびホスト画面が認識されたときに行うアクションを定義するタグが入っています。

<event> タグ

画面カスタマイズの定義を開始します。event タグには以下の属性があります。

description
画面カスタマイズを作成するときに説明を付加してある場合は、この属性でその説明が定義されます。
type
画面カスタマイズの場合は、type は常に screenRecognize です。結合画面の場合、type は screenCombination です。

<actions> タグ

これは、画面カスタマイズ用に定義されたすべてのアクションを囲むタグです。このタグには属性はありません。

<apply> タグ

変換を適用するためのアクションを定義します。<apply> タグの属性には以下のものがあります。

applyGlobalRules
ホスト画面で HATS がグローバル規則を検索するかどうかを指定します。デフォルトは true です。
applyTextReplacement
このホスト画面で HATS がテキスト置換を検索するかどうかを指定します。デフォルトは true です。テキスト置換の使用方法について詳しくは、<replace> タグを参照してください。
enabled
このアクションが使用可能かどうかを表します。デフォルトは true です。
immediateKeyset
プロジェクトのエンド・ユーザーが押すと同時にホストに送られるホスト・キーを定義します。ホストにただちに送信するホスト・キーを定義していない場合は、この属性の値は空です。
template
適用する変換を囲むテンプレート・ファイルの名前を示します。デフォルトのテンプレートを使用して変換を囲む場合は、この属性の値は空です。
transformation
このアクション用として適用する変換ファイルの名前を示します。

<insert> タグ

グローバル変数またはストリングを挿入するためのアクションを定義します。<insert> タグの属性には以下のものがあります。

enabled
このアクションが使用可能かどうかを表します。デフォルトは true です。
row
ホスト画面上で値を挿入する位置の開始行を定義します。
col
ホスト画面上で値を挿入する位置の開始カラムを定義します。
source
挿入する値が、ストリングか、グローバル変数の値かを指定します。有効な値は string および variable です。
value
ホスト画面に挿入するストリングか、値がとられるグローバル変数の名前を指定します。
fill
挿入する値のソースが索引付きグローバル変数である場合、fill は、グローバル変数の索引を連結して指定位置に挿入するか、ホスト画面上の長方形の領域に挿入するかを指定します。有効な値は concatenate および rectangular です。
index
挿入する値のソースが索引付きグローバル変数である場合に、index は、ホスト画面に挿入する値として使用する索引の番号を指定します。
shared
挿入する値のソースがグローバル変数である場合、shared は、このグローバル変数を同じ EAR ファイル内のすべてのアプリケーション間で共用するかどうかを指定します。

<extract> タグ

グローバル変数を抽出するためのアクションを定義します。<extract> タグの属性には以下のものがあります。

enabled
このアクションが使用可能かどうかを表します。デフォルトは true です。
srow
ホスト画面上から抽出するテキストの開始行を定義します。
erow
ホスト画面上から抽出するテキストの終了行を定義します。
scol
ホスト画面上から抽出するテキストの開始カラムを定義します。
ecol
ホスト画面上から抽出するテキストの終了カラムを定義します。
name
抽出したテキストを入れるグローバル変数の名前を指定します。これは、既存のグローバル変数でも新規のグローバル変数でも構いません。
overwrite
既存のグローバル変数の値を抽出したテキストで上書きするかどうかを指定します。有効な値は true および false です。
indexed
抽出するテキストが単一のストリングか、ストリングのリストかを指定します。リストの場合、各ストリングは抽出された領域内の 1 行のテキストに対応します。有効な値は true および false です。
index
既存のグローバル変数に索引が付いている場合は、この属性は、抽出した値が書き込まれる索引番号を指定します。この属性の効果は、overwrite 属性の値によって異なります。overwrite=true であれば、既存の変数内の指定された索引位置から始まる部分が、抽出された値で上書きされます。overwrite=false であれば、既存の変数内の指定された索引位置に、抽出された値が挿入されます。
shared
shared は、グローバル変数を同じ EAR ファイル内のすべてのアプリケーション間で共用するかどうかを指定します。

<set> タグ

グローバル変数を設定するためのアクションを定義します。<set> タグの属性には以下のものがあります。

enabled
このアクションが使用可能かどうかを表します。デフォルトは true です。
name
設定するグローバル変数の名前を指定します。これは、既存のグローバル変数でも新規のグローバル変数でも構いません。
shared
設定するグローバル変数を同じ EAR ファイル内のすべてのアプリケーション間で共用するかどうかを指定します。
type
設定するグローバル変数の値を、定数からとるか計算値からとるかを指定します。有効な値は string および calculate です。
value
このグローバル変数に割り当てる値を指定します。
overwrite
既存のグローバル変数の値を、設定した値で上書きするかどうかを指定します。有効な値は true および false です。
index
設定した値を既存の索引付きグローバル変数に書き込む場合、この属性は、設定した値を書き込む索引の番号を指定します。この属性の効果は、overwrite 属性の値によって異なります。overwrite=true であれば、既存の変数内の指定された索引位置から始まる部分が、設定した値で上書きされます。overwrite=false であれば、既存の変数内の指定された索引位置に、設定した値が挿入されます。
op1
計算される値の第 1 オペランドが、定数か、既存のグローバル変数の値かを指定します。有効な値は、定数、またはグローバル変数の名前です。
op1_type
計算される値の第 1 オペランドを、定数として設定するか、既存のグローバル変数からの値として設定するかを指定します。有効な値は string および variable です。
op1_index
計算される値の第 1 オペランドの値のソースが索引付きグローバル変数である場合、op1_index は、計算対象の値として使用する索引の番号を指定します。
op1_shared
op1 の値がグローバル変数である場合、shared は、このグローバル変数を同じ EAR ファイル内のすべてのアプリケーション間で共用するかどうかを指定します。
op
計算される値の第 1 オペランドと第 2 オペランドの間で行う演算のタイプを指定します。有効な値は、+ (加算)、- (減算)、* (乗算)、/ (除算)、% (モジュロ) などの演算を連結したものです。
op2
計算される値の第 2 オペランドが、定数か、既存のグローバル変数の値かを指定します。有効な値は、定数、またはグローバル変数の名前です。
op2_type
計算される値の第 2 オペランドを、定数として設定するか、既存のグローバル変数からの値として設定するかを指定します。有効な値は string および variable です。
op2_index
計算される値の第 2 オペランドの値のソースが索引付きグローバル変数である場合、op2_index は、計算対象の値として使用する索引の番号を指定します。
op2_shared
op2 の値がグローバル変数である場合、shared は、このグローバル変数を同じ EAR ファイル内のすべてのアプリケーション間で共用するかどうかを指定します。
dec
計算された値を丸めた後に残す小数点以下の桁数を指定します。有効な値は 0 から 999 です。

<execute> タグ

ビジネス・ロジックを実行するためのアクションを定義します。<execute> タグの属性には以下のものがあります。

enabled
このアクションが使用可能かどうかを表します。デフォルトは true です。
class
ビジネス・ロジックを含める Java クラスの名前を指定します。class 値は必須です。
method
クラス内の、ビジネス・ロジックを実行するメソッドの名前を指定します。method 値は必須です。
package
ファイル・システム内でこの Java クラスが入っているパッケージの名前を指定します。package 値はオプションです。

<show> タグ

URL を表示するためのアクションを定義します。<show> タグには以下の属性があります。

enabled
このアクションが使用可能かどうかを表します。デフォルトは true です。
template
このアクションに使用するテンプレートを指定します。
url
表示する Web ページの URL を示します。この属性は必須です。

<forwardtoURL> タグ

プロジェクトから統合オブジェクトを呼び出す JSP に制御を引き渡すためのアクションを定義します。<forwardtoURL> タグには以下の属性があります。

enabled
このアクションが使用可能かどうかを表します。デフォルトは true です。
startStateLabel
統合オブジェクト・チェーンを持つ JSP に制御を転送する場合、実行するチェーンの中の最初の統合オブジェクトの開始状態ラベルを指定します。
url
統合オブジェクト JSP の URL を指定します。

<disconnect> タグ

デフォルト接続を切断します。このアクションを使用する場合は注意が必要です。このアクションは、回復できないイベントに対してのみ使用してください。<disconnect> タグには以下の属性があります。

enabled
このアクションが使用可能かどうかを表します。デフォルトは true です。

<play> タグ

マクロを実行するためのアクションを定義します。<play> タグには以下の属性があります。

enabled
このアクションが使用可能かどうかを表します。デフォルトは true です。
macro
実行するマクロの名前を指定します。この属性は必須です。

<perform> タグ

任意の接続 (デフォルト接続でなくてもよい) に対してマクロを実行するためのアクションを定義します。このアクションは、現在のホスト画面には影響しません。<perform> タグには以下の属性があります。

connection
マクロを実行する接続。デフォルトは main です。
enabled
このアクションが使用可能かどうかを表します。デフォルトは true です。
macro
実行するマクロの名前。

<pause> タグ

通常処理を続行するまでの待ち時間のアクションを定義します。<pause> タグには以下の属性があります。

enabled
このアクションが使用可能かどうかを表します。デフォルトは true です。
time
通常処理を続行するまでの一時停止時間 (ミリ秒単位) を指定します。

<sendkey> タグ

アクションを実行するためにホスト画面に指定したキーを送信するアクションを定義します。<sendkey> タグには以下の属性があります。

enabled
このアクションが使用可能かどうかを表します。デフォルトは true です。
key
ホスト画面に送信するキーを示します。
row
ホスト画面上でキーを挿入する開始行を定義します。
col
ホスト画面上でキーを挿入する開始カラムを定義します。

<globalRules> タグ

<globalRules> タグは、画面イベントに定義するグローバル規則を囲むタグです。このタグには属性はありません。

<rule> タグ

<rule> タグは、グローバル規則を定義します。

画面カスタマイズ・レベル規則用の <rule> タグの属性は、プロジェクト・レベルのグローバル規則用の属性と同じです。しかし、同じ入力フィールドを使用して画面カスタマイズ・レベルとプロジェクト・レベルのグローバル規則を作成すると、画面カスタマイズ・レベル規則の優先順位の方が高くなります。 <rule> タグの属性には以下のものがあります。

associatedScreen
グローバル規則を定義する際の基準となる、プロジェクトの中の画面キャプチャーの名前。
componentSettings
グローバル規則に対して構成する設定 (例えば、認識基準)。
description
グローバル規則の作成時に入力した説明。
enabled
グローバル規則が使用可能かどうかを表します。プロジェクト設定の「レンダリング」ページのチェック・ボックスの状態を反映します。
endCol
このグローバル規則を適用するべきホスト画面の最後のカラムです。-1 は、ホスト画面の右端のカラムを意味します。
endRow
このグローバル規則を適用するべきホスト画面の最後の行です。-1 は、ホスト画面の最後の行を意味します。
name
「プロジェクト設定」の「レンダリング」ページのグローバル規則のリストに表示される名前。
startCol
このグローバル規則を適用するべきホスト画面の最初のカラムです。
startRow
このグローバル規則を適用するべきホスト画面の最初の行です。
transformationFragment
グローバル規則に関連付けられた変換フラグメント・ファイルの名前。このファイルには、ホスト・コンポーネントの変換方法を指定する情報が含まれています。該当するフィールドがホスト画面に存在する場合、この情報は変換に組み込まれます。
type
このグローバル規則のパターン・タイプ・コンポーネントで、「グローバル規則の作成」ウィザードの最初のページで取得します。タイプは次のいずれかです。
com.ibm.hats.transform.components.InputFieldByTextPatternComponent
このパターン・コンポーネントは、フィールド近くのテキストを基にしてホスト画面上の入力フィールドを認識します。
com.ibm.hats.transform.components.AllInputFieldsPatternComponent
このパターン・コンポーネントは、ホスト画面上のすべての入力フィールドを認識します。
com.ibm.hats.transform.components.InputFieldBySizePatternComponent
このパターン・コンポーネントは、入力フィールドのサイズを基にしてホスト画面上の入力フィールドを認識します。

それぞれ固有のグローバル規則には、次のタグも含まれています。

componentSettings
<componentSettings> タグは、<rule> タグの型属性で指定したパターン・タイプ・コンポーネント用に定義された設定を囲むタグです。このタグには属性はありません。
setting
<setting> タグは、<rule> タグの型属性で指定したパターン・タイプ・コンポーネント用に定義された設定を囲むタグです。

<setting> タグの属性には以下のものがあります。

name
パターン・タイプ・コンポーネントのカスタマイズ可能な設定の名前を指定します。使用可能な設定はコンポーネントによって異なります。
  • com.ibm.hats.transform.components.InputFieldByTextPattern Component の場合、name 属性の設定は以下のとおりです。
    caseSensitive
    パターンを認識する前に、テキスト設定で大文字小文字の区別を一致させる必要があるかどうかを指定します。有効な値は true および false です。デフォルトは true です。
    immediatelyNextTo
    変換する入力フィールドを指定します。有効な値は以下のとおりです。
    true
    最も近い入力フィールドのみ変換の必要があることを指定します。
    false
    すべての入力フィールドを変換する必要があることを指定します。
    デフォルトは false です。
    location
    テキスト設定で指定した保護フィールドのテキストを、適用するグローバル規則の入力フィールドに対してどの位置に置くかを指定します。有効な値は以下のとおりです。
    ABOVE
    入力フィールドの上に表示するテキストを指定します。
    BELOW
    入力フィールドの下に表示するテキストを指定します。
    LEFT
    入力フィールドの左に表示するテキストを指定します。
    RIGHT
    入力フィールドの右に表示するテキストを指定します。
    デフォルトは RIGHT です。
    text
    ホスト画面の保護フィールドに表示するテキストを指定します。有効な値は、ホスト画面上の保護フィールドの中の任意のテキストです。
  • com.ibm.hats.transform.components.AllInputFieldsPattern Component の場合、コンポーネント設定はありません。
  • com.ibm.hats.transform.components.InputFieldBySizePattern Component の場合、name 属性の設定は fieldSize です。 有効な値は、ホスト画面上の任意の入力フィールドのサイズです。

<associatedScreens> タグ

<associatedScreens> タグは、その後に続く screen タグを囲むタグです。

<screen> タグ

画面カスタマイズに関連した画面を定義します。<screen> タグには以下の属性があります。

name
取り込んだ画面 (画面認識基準およびアクションが定義されているもの) の名前を指定します。

<description> タグ

<description> タグは、画面カスタマイズに関連した説明を囲むためのタグで、<oia> タグと <string> タグから成っています。 description タグには属性はありません。

<oia> タグ

画面カスタマイズ .evnt ファイルの中の <oia> タグは、一致する必要があるオペレーター情報域 (OIA) 条件を指定します。このタグはオプションです。デフォルトでは、禁止状況になるまで待機します。<oia> タグの属性には以下のものがあります。

status
NOTINHIBITED の場合は、OIA の禁止を解除しなければ一致は起こりません。DONTCARE の場合は、OIA 禁止状況は無視されます。これは、OIA をまったく指定しない場合と同じ振る舞いとなります。有効な値は NOTINHIBITED および DONTCARE です。これは必須属性です。
optional
false の場合は、画面認識時にこの記述子は非オプションと見なされます。記述子に複数の非オプションの記述子および複数のオプション記述子が含まれる場合は、非オプション記述子が最初に検査されます。非オプション記述子がすべて一致する場合は、画面が一致します。一致しない非オプション記述子が 1 つでも存在する場合は、オプション記述子が検査されます。オプション記述子のいずれかが一致すると、画面が一致します。それ以外の場合は画面は一致しません。値は true または false でなければなりません。この属性はオプションです。デフォルトは false です。
invertmatch
true の場合は、画面がこの記述エレメントに一致しない (ブール not 演算) 場合にのみ、認識比較を通過します。値は true または false でなければなりません。この属性はオプションです。デフォルトは false です。

<string> タグ

<string> タグは、ストリングに基づいて画面を記述します。<string> タグの属性には以下のものがあります。

value
ストリング値。この値は、任意の有効な Unicode 文字を含むことができます。これは必須属性です。
row
ストリングの開始行の位置 (絶対位置または長方形の中の位置)。値は数値または数値に評価される式でなければなりません。この値はオプションです。指定しない場合は、マクロ・ロジックは画面全体でストリングを検索します。指定する場合は、カラム位置も指定する必要があります。<erow> 属性および <ecol> 属性を指定して、長方形の領域内のストリングを指定することもできます。
注:
負の値も有効です。負の値は、画面の最下部を基準とする相対位置を示します (例えば、-1 は最終行です)。
col
ストリングの開始カラムの位置 (絶対位置または長方形の中の位置)。値は数値または数値に評価される式でなければなりません。この属性はオプションです。
erow
長方形の中でのストリングの終了行位置。値は数値または数値に評価される式でなければなりません。この属性はオプションです。erow と ecol の両方を指定する場合は、ストリングは長方形の内側に位置します。
ecol
長方形の中でのストリングの終了カラム位置。値は数値または数値に評価される式でなければなりません。この属性はオプションです。erow と ecol の両方を指定する場合は、ストリングは長方形の内側に位置します。
casesense
true の場合は、ストリングの比較時に大文字と小文字を区別します。この値は、true、false、または true か false に評価される式でなければなりません。この属性はオプションです。デフォルトは false です。
optional
false の場合は、画面認識時にこの記述子は非オプションと見なされます。記述子に複数の非オプションの記述子および複数のオプション記述子が含まれる場合は、非オプション記述子が最初に検査されます。非オプション記述子がすべて一致する場合は、画面が一致します。一致しない非オプション記述子が 1 つでも存在する場合は、オプション記述子が検査されます。オプション記述子のいずれかが一致すると、画面が一致します。それ以外の場合は画面は一致しません。この値は、true、false、または true か false に評価される式でなければなりません。この属性はオプションです。デフォルトは false です。
invertmatch
true の場合は、画面がこの記述エレメントに一致しない (ブール not 演算) 場合にのみ、認識比較を通過します。この値は、true、false、または true か false に評価される式でなければなりません。この属性はオプションです。デフォルトは false です。

<nextEvents> タグ

<nextEvents> タグは、その後に続く <event> タグを囲むタグです。<nextEvents> タグには以下の属性があります。

defaultEvent
event タグで指定された画面カスタマイズに一致するものがない場合、表示する次の画面として使用するデフォルトの画面カスタマイズ (イベント) を指定します。defaultEvent でイベントを指定しなかった場合、プロジェクト設定の通常のイベント優先順位リストが使用されます。有効な値は以下のとおりです。

<event> タグ

発生が予想される次の画面の画面カスタマイズをプロジェクトにもう 1 つ定義します。<event> タグには以下の属性があります。

enabled
name 属性で定義した画面カスタマイズ (イベント) が使用可能かどうかを示します。デフォルトは true です。
name
発生が予想される次の画面の画面カスタマイズの名前を指定します。

<remove> タグ

<remove> タグは、画面カスタマイズ (イベント) に以前追加されたグローバル変数を除去します。 <remove> タグには以下の属性があります。

enabled
name 属性に定義されたグローバル変数で除去操作が使用可能になっているかどうかを示します。デフォルトは true です。
name
除去するグローバル変数の名前を指定します。
remove Type
除去するグローバル変数の型を指定します。型には、oneLocal、oneShared、allLocal、allShared、および all などがあります。

マクロ・ファイル (.hma)

マクロ・ファイルは、project_name/Web Content/WEB-INF/profiles/macros ディレクトリーに格納されます。マクロ・ファイルのソースを表示および編集するには、「HATS プロジェクト表示」で目的のマクロの名前をダブルクリックして、マクロ・エディターをオープンします。そして、「ソース」タブをクリックして、ファイルのソースを表示することができます。マクロについて詳しくは、「拡張マクロ・ガイド」を参照してください。

マクロ・ファイルには、一組の画面を定義するタグが含まれています。タグについては、この後のセクションで説明されます。

<macro> タグ

マクロの定義を開始します。macro タグには属性はありません。

<associatedConnections> タグ

<associatedConnections> タグは、<connection> タグを囲みます。 <associatedConnections> タグの属性は次のとおりです。

default
このマクロのデフォルト接続を識別します。

<connection> タグ

<connection> タグは、このマクロが関連付けられている接続を識別します。connection タグの属性は以下のとおりです。

name
このマクロが関連付けられている接続の名前を識別します。

<extracts> タグ

<extracts> タグは、その後に続く extract タグを囲むタグです。<extracts> タグには属性はありません。

<extract> タグ

<extract> タグは、実行する抽出を定義します。extract タグの属性には以下のものがあります。

name
抽出の名前を指定します。
handler
抽出した情報をエンド・ユーザーに対して表示するための .jsp ファイルを選択できます。HATS には、default.jsp という名前のデフォルトのマクロ・ハンドラーが組み込まれています。このファイルを見付けるには、HATS Toolkit の「HATS プロジェクト表示」タブをクリックし、プロジェクト名を展開し、次に「マクロ」>「マクロ・イベント・ハンドラー」の順に展開します。独自のハンドラーを作成する場合は、必ず HATS ランタイムに制御を戻してください。
showHandler
抽出した情報をエンド・ユーザーに提示するかどうかを指定します。有効な値は true および false です。
shared
抽出するグローバル変数を同じ EAR ファイル内のすべてのアプリケーション間で共用するかどうかを指定します。
save
抽出した情報をグローバル変数に保存するかどうかを指定します。有効な値は true および false です。
variableName
抽出した情報をグローバル変数に保存する場合に、variableName は新規または既存のグローバル変数の名前を指定します。
overwrite
抽出した情報を既存のグローバル変数に保存する場合に、overwrite は、既存のグローバル変数の現行値を抽出した情報で上書きするのか、抽出した情報を現行値に追加するのかを指定します。有効な値は true および false です。True は、既存のグローバル変数の値を上書きすることを指定します。
index
抽出した値を既存の索引付きグローバル変数に書き込む場合、この属性は、設定した値を書き込む索引の番号を指定します。この属性の効果は、overwrite 属性の値によって異なります。overwrite=true であれば、既存の変数内の指定された索引位置から始まる部分が、抽出した値で上書きされます。overwrite=false であれば、既存の変数内の指定された索引位置から始まる部分に、抽出した値が挿入されます。
indexed
抽出する情報が、単一のストリングか、ストリングのリストかを指定します。有効な値は true および false です。True は、抽出する情報がストリングのリストであることを指定します。

<prompts> タグ

<prompts> タグは、その後に続く prompt タグを囲むタグです。prompts タグには属性はありません。

<prompt> タグ

<prompt> タグは、表示するプロンプトを定義します。<prompt> タグの属性には以下のものがあります。

name
プロンプトの名前を指定します。
handler
エンド・ユーザーに必要な情報の入力を求めるための .jsp ファイルを選択し、ユーザーが情報を送信するためのボタンを組み込むことができます。HATS には、default.jsp という名前のデフォルトのマクロ・ハンドラーが組み込まれています。このファイルを見つけるには、HATS Toolkit の「HATS プロジェクト表示」タブをクリックし、プロジェクト名を展開し、「マクロ」>「マクロ・イベント・ハンドラー」の順に展開します。独自のハンドラーを作成する場合は、必ず HATS ランタイムに制御を戻してください。
source
プロンプトの値をストリングに設定するのか、グローバル変数の値に設定するのかを指定します。有効な値は string および variable です。
variableName
プロンプトの値をグローバル変数に保存する場合に、variableName は新規または既存のグローバル変数の名前を指定します。
variableIndex
プロンプトの値を索引付きグローバル変数に保存する場合に、variableIndex は、値を割り当てる索引を指定します。この値は常に 0 です。
variableIndexed
プロンプトの情報を索引付きグローバル変数から取得するかどうかを指定します。有効な値は true および false です。True はグローバル変数が索引付きであることを示します。
value
プロンプトに使用するストリングか、値がとられるグローバル変数の名前を指定します。

<HAScript> タグ

<HAScript> タグは、他のマクロ・タグおよび属性を囲むメイン・タグです。マクロ・タグの詳細については、「HATS 拡張マクロ・ガイド」を参照してください。

画面キャプチャー・ファイル (.hsc)

画面キャプチャー・ファイルはホスト画面の XML 表現で、画面カスタマイズまたは変換を作成またはカスタマイズするために使用されます。

画面キャプチャー・ファイルは、project_name/Screen Captures ディレクトリーに格納されます。これらのファイルを表示するには、「HATS プロジェクト表示」で目的の画面キャプチャーの名前をダブルクリックします。画面キャプチャー・ファイルは編集できません。

BMS マップ・ファイル (.bms および .bmc)

基本マッピング・サポート (BMS) のマップは、顧客情報管理システム (CICS®) の画面定義ファイルです。各マップが 1 つの画面の全体または一部を定義しており、通常 CICS アプリケーションが 1 つ以上のマップを表示して、完全な画面イメージを作成します。BMS マップのソースは、マップ・セットというグループに編成されます。1 つのマップ・セットには、1 つ以上のマップが含まれています。マップ・セットは、1 つのソース・ファイルに対して 1 つのマップ・セットというようにソース形式で存在します。

BMS マップ・セット・ファイルは HATS Toolkit のプロジェクトにインポートできます。HATS が BMS マップをインポートする際、インポートはマップ・セットのレベルで行われます。マップ単位で個別にインポートすることはできません。HATS Toolkit では、インポートされた BMS マップ・セット・ファイルのファイル拡張子は .bms で、個々のマップのファイル拡張子は .bmc になります。

マップ・セット・ファイル (.bms) とマップ・ファイル (.bmc) は両方とも、HATS プロジェクト内の個別の Maps フォルダーに格納されます。デフォルトでは、マップがインポートされるまで、「HATS プロジェクト表示」では Maps フォルダーは見えません。

HATS によってマップ・ファイルから画面キャプチャーを生成することができます。画面キャプチャーは、マップ・セットをインポートする際に生成することもでき、Maps フォルダーに入れた後、マップから生成することもできます。マップから画面キャプチャーを生成するには、マップ・ファイル上で右マウス・ボタンをクリックしてポップアップ・メニューを表示し、「画面キャプチャーの生成」を選択します。選択した BMS マップごとに個別の画面キャプチャーを作成することもでき、選択した複数の BMS マップを 1 つの画面キャプチャーにマージすることもできます。フィールドがオーバーラップしている場合は、マップをマージすることはできません。画面キャプチャーを作成すれば、HATS 画面カスタマイズの作成を開始できます。

「HATS プロジェクト表示」内のファイルをダブルクリックすることで、HATS Toolkit エディターでマップ・セット・ファイルを開くことができます。ファイルの内容の詳細については、「CICS アプリケーション・プログラミング・リファレンス」を参照してください。マップ・セット・ファイルをテキスト・エディターで変更し保存した場合、そのファイルを構成するマップは再生成されますが、1 つ例外があります。マップ・セット・ファイル内でラベル定義されたフィールドの内容が変更されたマップ・ファイルの場合です。このようなマップを再生成するには、「BMS マップ・セットのインポート (BMS map set import)」ウィザードを使用してソース・ファイルを再度インポートする必要があります。

CICS アプリケーションは、ラベル定義されたフィールドの内容を実行中に変更することができます。CICS アプリケーションの実行時に表示されるフィールドを含む画面キャプチャーを作成する必要がある場合があります。ラベル定義されたフィールドはアプリケーション実行時に変更可能なため、マップ・セット・ファイル (およびマップ・セット内にあるマップ・ファイル) に、実際の画面キャプチャーの生成に必要な情報のすべてが含まれているとは限りません。マップ・ファイルの編集はできませんが、ファイルをダブルクリックすることで、ファイル・プレビューが開きます。HATS Toolkit のプロパティー・シート表示によって、欠落情報を追加し、フィールドの内容を手動で設定できます。フィールドの内容を変更することによって、単一のマップを複数の画面キャプチャーに使用することができます。

注:
  1. HATS Toolkit でマップ・ファイルをプレビューする際、プロパティー・シート表示に表示されているフィールドは、「HATS プロジェクト表示」で強調表示されているマップ・ファイルのフィールドであり、プレビュー・ウィンドウに表示されているマップ・ファイルのフィールドではありません。
  2. 画面キャプチャー・ファイルが BMS マップ・ファイルから生成されている場合は、HATS Toolkit のプロパティー・シート表示を使用して画面キャプチャー・ファイルを表示することも可能です。

イメージ・ファイル (.gif、.jpg、または .png)

イメージ・ファイルは、HATS Toolkit でプロジェクトのユーザーに表示する Web ページを作成するために、テンプレート・ファイルの中で使用されます。

イメージ・ファイルは、project_name/Web Content/common/images ディレクトリーに格納されます。イメージの名前をダブルクリックすることにより、イメージ・ファイルを表示できます。

スタイルシート・ファイル (.css)

HATS Toolkit では、Cascading Style Sheet (スタイル・シート) をテンプレート・ファイルで使用して、色、フォント、境界線、空白、イメージ、マージン、および行間などの外観項目を指定します。

HATS が提供するスタイルシート・ファイルはいくつかのカテゴリーにグループ化できます。

固有テンプレート
一部の HATS テンプレートでは、個別化されたスタイル・シートを使用しています。以下のスタイル・シートは、それぞれ金融 (Finance) テンプレートおよび工業 (Industry) テンプレートで使用されています。 さらに、これらのスタイル・シートは、下にリストする「Font」スタイル・シートおよび「Unique」スタイル・シートと組み合わせて使用できます。例えば、Font スタイル・シートを使用すると、デフォルトの定義済みフォントをオーバーライドできます。これらの固有テンプレート・スタイル・シートと、下にリストしてある「Main」スタイル・シートや「Reverse video」スタイル・シートを組み合わせて使用することはできません。
Main
一部の HATS テンプレートでは、汎用スタイル・シートを組み合わせて使用しています。これらの汎用 main スタイル・シートによって決定されるのは、テンプレートの全体の外観とプロジェクトに追加するその他の制御です。これらの制御の例として、ボタン、入力フィールド、テーブル、フィールド、およびリンクがあります。これらの スタイル・シートは、blacktheme、whitetheme、monochrometheme、および tantheme というように名前の最後に theme が付きます。プロジェクトにおけるコントロールの外観は、例えば HATSCHECKBOX、HATSRADIOBUTTON、HATSDROPDOWN というように、スタイル・シートで名付けられたクラスによって決まります。
Reverse video
汎用 main スタイル・シートを使用するテンプレートでは、2 次的なスタイル・シートも使用します。このスタイル・シートにより、プロジェクトのあらゆる反転表示項目のカラー・スキームが決定されます。これらの reverse video スタイル・シートには、reverseVideoGray、reverseVideoTan、reverseVideoBlack、および reverseVideoWhite などのように名前の先頭に reverseVideo が付きます。 スタイル・シートで名付けられたクラスの中には、RHBLUE、RHGREEN、RHMAGENTA などの名前もあります。
Font
HATS が提供するスタイル・シートの中には、デフォルトでテンプレート内で名前がないものがあります。ただし、これらのスタイル・シートをテンプレートに適用し、フォント・ファミリー (Arial や Tahoma) や、テキストのフォント・サイズを変更できます。スタイル・シートの名前でその目的がわかります。
Unique
HATS が提供する 4 つの追加スタイル・シートにはそれぞれ固有の目的があります。以下に示します。
calendar.css
このスタイル・シートは、新規ブラウザー・ウィンドウで起動されたときのカレンダー・ウィジェット日付ピッカーの外観を制御します。このスタイル・シートは、カレンダー・ウィジェットの「インライン・カレンダーの使用 (Use inline calendar)」設定を使用して、現行 Web ページに日付ピッカーが起動される場合には、効果がありません。
inlinecalendar.css
このスタイル・シートは、現行 Web ページで起動されたときのカレンダー・ウィジェット日付ピッカーの外観の一部を制御します。同じページにカレンダーを表示させるには、カレンダー・ウィジェットの「インライン・カレンダーの使用 (Use inline calendar)」設定を選択します。このスタイル・シートは、日付ピッカーが新規ブラウザー・ウィンドウで起動される場合、つまり「インライン・カレンダーの使用 (Use inline calendar)」設定を使用していない場合には、効果がありません。
PrintJobWindow.css
このスタイル・シートは、PrintJobHeading、ListHeader、および ListEntry を含む、プロジェクトの印刷ジョブの外観を制御します。
slickWhiteBackground.css
このスタイル・シートは、「Main」スタイル・シートで定義された場合のある特定のテンプレート項目の外観を変更します。変更できる特性には、フォント・ファミリー、フォント・サイズ、色、テキスト位置合わせ、リンク、およびテーブルが含まれます。

スタイル・シート・ファイルは、project_name/Web Content/common/stylesheets ディレクトリーに格納されています。スタイル・シート・ファイルを編集するには、「HATS プロジェクト表示」で目的のスタイル・シートの名前をダブルクリックして、スタイル・シート・エディターをオープンします。

カスケーディング・スタイルシートの編集の詳細については、「HATS ユーザーと管理者のガイド」の『スタイル・シートの使用』を参照してください。

スプレッドシート・ファイル (.csv または .xls)

.csv (コンマ区切りの値) または .xls (Microsoft® Excel) フォーマットのスプレッドシート・ファイルは、TableWidget 内で定義されたホスト画面データから自動的に生成することができます。スプレッドシート・ファイルは HATS SpreadsheetGeneratorServlet によって作成され、ユーザーが定義済みのボタンまたはリンクをクリックすると、実行時に表示できます。ダイアログ・ポップアップが表示され、ユーザーはスプレッドシート・ファイルを格納するディレクトリーおよびファイル名を入力できます。

スプレッドシート・ファイルの作成の詳細については、「HATS ユーザーと管理者のガイド」の『「テーブル」ウィジェット』を参照してください。

ホスト・シミュレーション・トレース・ファイル (.hhs)

ホスト・シミュレーション・トレース・ファイルはシミュレートされたホスト接続環境に保存され、ライブ・ホスト接続を使用するのではなく、このファイルを使用して HATS を実行します。シミュレーションは Host Simulator Recorder によって作成されます。これは、実際のホストと HATS 端末の間のプロキシーとして動作します。ホスト・シミュレーション・トレース・ファイルは、ファイル拡張子 .hhs を付けて XML フォーマットで作成され、「HATS プロジェクト」ビューからアクセスする「ホスト・シミュレーション」 フォルダーの以下のディレクトリーに格納されます。

ホスト・シミュレーション・トレース・ファイルの作成の詳細については、「HATS ユーザーと管理者のガイド」を参照してください。

ComponentWidget.xml

ComponentWidget.xml ファイルには、HATS で提供されるすべてのホスト・コンポーネントおよびウィジェットの定義が格納されています。独自のホスト・コンポーネントまたはウィジェットを追加したときは、このファイルを更新する必要があります。このファイルの説明と簡単なサンプルについては、コンポーネントまたはウィジェットの登録を参照してください。ComponentWidget.xml ファイルは、「ナビゲーター」ビューでプロジェクトの最後の項目として表示されます。このファイルを編集するには、「ナビゲーター」ビューでファイル名をダブルクリックして、「ソース」タブを選択します。

このファイルの内容の説明と使用方法については、コンポーネントまたはウィジェットの登録を参照してください。

Web 高速ログオン構成ファイル (hatswelcfg.xml)

Web 高速ログオン (WEL) 信任状マッピングは、hatswelcfg.xml という名前の XML ファイルで構成します。このファイルは、HATS サーブレット・プロジェクトの EAR プロジェクトのルート・ディレクトリーおよび HATS ポートレット・プロジェクトの WEB-INF ディレクトリーに格納されています。WEL 構成のソースを表示するには、接続エディターの「セキュリティー」タブから WEL エディターを開き、「ソース」タブをクリックします。ただし、構成を変更する場合は、WEL エディターの「ネットワーク・セキュリティー・プラグイン」タブおよび「信任状マッパー・プラグイン」タブを使用する必要があります。

<credentialmapper> タグ

<credentialmapper> タグは、Web 高速ログオン構成を囲むタグです。 <credentialmapper> タグの属性は以下のとおりです。

class
WEL 信任状マッパーとして使用する Java クラスを指定します。この値は、WEL エディターの 2 つのプラグイン・タブ上では編集できません。この値は、IBM® サービスからの指示がない限りは変更しないでください。

<networksecurity> タグ

<networksecurity> タグは、0 個または 1 個のネットワーク・セキュリティー・プラグイン・タグ (<plugin>) のコンテナーであり、属性はありません。

<cmplugins> タグ

<cmplugins> タグは、複数の信任状マッパー・プラグイン・タグ (<plugin>) のコンテナーであり、属性はありません。

<plugin> タグ

<plugin> タグは、ネットワーク・セキュリティー・プラグインまたは信任状マッパー・プラグインを識別し、プラグイン・パラメーターのタグを囲みます。<plugin> タグの属性には以下のものがあります。

class
プラグイン・コードを含む Java クラスを指定します。
authenticationtype
プラグインが信任状をマップできるホストのタイプを指定します。Web 高速ログオンは、この属性を使用して、要求の処理に使用するプラグインを決定します。有効な値は、AuthType_All、AuthType_3270Host、AuthType_5250Host、および AuthType_VTHost です。縦線 (|) で区切ることにより、複数の値を使用できます。この属性は、<plugin> タグが <cmplugins> タグで囲まれているときに、信任状マッパー・プラグインでのみ有効です。
hostmask
プラグインが信任状をマップできるホストの名前を指定します。Web 高速ログオンは、この属性を使用して、要求の処理に使用するプラグインを決定します。この属性の値には、1 つ以上のホスト・アドレスを指定できます。複数の値を指定するには、複数のアドレスを縦線 (|) で結合するか、ホスト・アドレスの最初か最後 (またはその両方) にアスタリスク (*) をワイルドカードとして使用します。この属性は、<plugin> タグが <cmplugins> タグで囲まれているときに、信任状マッパー・プラグインでのみ有効です。

<param> タグ

<param> タグは、プラグイン・パラメーターの名前と値を識別します。<param> タグの属性には以下のものがあります。

name
プラグイン・パラメーターの名前を指定します。各プラグイン Java クラスは、そのクラスが受け入れるパラメーター名のセットを定義します。
value
プラグイン・パラメーターの値を指定します。パラメーターが、暗号化されたパラメーターとしてプラグイン Java クラスで定義されている場合、この値を暗号化する必要があります。