付録A. HATS Toolkit のファイル

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

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

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

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

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

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

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

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

<application> タグ

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

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

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

<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 は リッチ・クライアント アプリケーションの非同期更新機能のカスタマイズ可能な設定を指定します。

enable
true の場合は、リッチ・クライアント アプリケーションの非同期更新機能が使用可能になります。デフォルトは true です。

com.ibm.hats.common.ApplicationKeypadTag

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

show
true の場合、アプリケーションの中でキーパッドを表示します。
showDefault
true の場合、表示をデフォルトの変換に変更するためのキーをアプリケーション・キーパッドに表示します。
showDisconnect
true の場合、ホストから切断するためのキーをキーパッドに表示します。
showKeyboardToggle
true の場合、アプリケーション・キーパッドの中に、ホスト・キーボードの表示を切り替えるためのキーを表示します。
showRefresh
true の場合、ブラウザー・ウィンドウの内容をオリジナルの変換を使用して最新表示し、入力フィールドを元の値に復元するキーを、キーパッドに表示します。
showReverse
true の場合、双方向サポート用のキーをアプリケーション・キーパッドに表示します。

com.ibm.hats.common.ClientLocale

com.ibm.hats.common.ClientLocale クラスの場合、name は常に locale です。 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 ヘッダーから取得されます。

com.ibm.hats.common.DBCSSettings

com.ibm.hats.common.DBCSSettings クラスの場合、autoConvertSBCStoDBCS、setATOKDefaultModetoRoman、および 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 です。
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 です。
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. 複数の入力フィールドとしてレンダリングされるホスト・フィールドは、自動的にはクリアされません。例えば、1 つの行から別の行にまたがる長いホスト・フィールドは複数の入力フィールドとしてレンダリングされ、更新前に自動的にはクリアされません。
  2. この設定は、プロジェクト・レベルでのみ指定可能です。単一の変換に対して指定することはできません。
enableArrowKeyNavigation
true に設定されている場合、レンダリングされたホスト画面内のフィールド間をキーボードの矢印キーでナビゲートできます。デフォルトは false です。
enableAutoAdvance
カーソルが入力フィールドの終わりにきたとき (つまり、入力フィールドが完全に入力されたとき) に、カーソルが次の入力フィールドに移動するかどうかを指定します。 true の場合、カーソルが入力フィールドの終わりにきたときに、カーソルが次の入力フィールドに移動します。 false の場合、ユーザーが明示的に移動させない限り、カーソルは次の入力フィールドに移動しません。 デフォルトは false です。
enableAutoTabOn
カーソルが入力フィールドの終わりにきたとき (つまり、入力フィールドが完全に入力されたとき) に、タブ・キーによってカーソルを次の入力フィールドに移動させるかどうかを指定します。 true に設定されている場合、カーソルの位置が現行フィールドの終わりにきたときに、ブラウザーでの表示フィールドの順序に基づいて、タブ・キーによって現行フィールド内のカーソルを次のフィールドに移動させます。 false に設定されている場合、ユーザーが明示的に移動しない限り、タブ・キーがカーソルを次の入力フィールドに移動させることはありません。 デフォルトは false です。
enableOverwriteMode
true の場合、入力フィールドに入力されたテキストにより、カーソル位置にあるテキストが上書きされます (1 文字が 1 文字に置き換わる)。false の場合、入力フィールドに入力されたテキストがカーソル位置に挿入され、既存のテキストが前に押し出されます。ユーザーは、Insert キーを使用して、この初期設定を切り替えることができます。デフォルトは true です。
includeLabelsInTabOrder
true の場合、保護された読み取り専用ラベルがデフォルトのタブ移動順序に組み込まれます。 デフォルトでは、タブ移動順序にはパネル上の入力フィールドのみが組み込まれます。 この設定は、読み取り専用ラベルも組み込む必要があることを意味します。
selectAllOnFocus
true の場合、フィールドがフォーカスを受け取ったときに、フィールド内のすべてのテキストが選択されます。これは、Web アプリケーションの通常の動作です。false の場合、フィールドがフォーカスを受け取ったときに、テキストは選択されません。これは、端末エミュレーターの通常の動作です。
注:
  1. Web アプリケーションの場合:
    • デフォルトは true です。
    • この設定は、enableOverwriteMode 設定の動作には影響しません。
    • この設定は、アプリケーションのブラウザーとして Internet Explorer が使用される場合に限り有効です。
  2. リッチ・クライアント アプリケーションの場合:
    • デフォルトは false です。
    • 選択すると、文字がフィールドへのユーザー入力として上書きされるという点で、この設定は enableOverwriteMode 設定と同様に機能します。
    • キーボードを使用してフィールドに Tab で移動した場合に限り、テキストが選択されます。フィールド内でマウスをクリックしても、テキストは選択されません。
suppressUnchangedData
true の場合、内容がフォームのレンダリング時と変わらないすべてのフィールドを使用不可にします。 false の場合、ブラウザーから受信したフィールドの内容と現在の表示スペースの内容が同一であっても、そのフィールドの内容をホストに送信します。 デフォルトは false です。

com.ibm.hats.rcp.transform.widgets.name

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

com.ibm.hats.rcp.ui.views.ToolBarSettings

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

displayAs
メイン変換ビュー・ツールバーの項目の表示方法を指定します。有効な値は、TEXT、IMAGE、および BOTH です。デフォルトは TEXT です。
show
メイン変換ビュー・ツールバーを表示するかどうかを指定します。 有効な値は true および false です。デフォルトは true です。

com.ibm.hats.transform

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

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 属性の値と一致しなければなりません。

<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 の有効な値と、それぞれの場所または使用目的キーは以下のとおりです。
表 18. コード・ページと使用目的キー
コード・ページ 使用目的キー
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 です。
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 用拡張ネゴシエーションで使用されます。値はストリング・フォーマットです。小文字はすべて大文字に変換されます。デフォルト値はありません。

Kerberos チケットのサポート

Kerberos チケットのサポート (5250 を使用するリッチ・クライアント・プロジェクトの場合のみ) を有効にするには、application.hap ファイルの <otherParameters> タグの内側に以下の行を追加します。

<parameter name="ssoEnabled" value="true"/>

<parameter name="ssoType" value="ssoAcquireKerberosTicket"/>

<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 プリンター出力ウィンドウの 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 です。

<userconfig> タグ

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

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

画面組み合わせファイルは、ホスト画面をどのように認識するかを定義するほか、画面が認識されたときに HATS が実行するアクション、画面組み合わせの終了を定義する方法、および画面間をナビゲートする方法も定義します。 画面組み合わせ (.evnt) ファイルは project_name/profiles/events/screencombinations ディレクトリーに格納されています。画面組み合わせファイルのソースを表示および編集するには、HATS Projects 表示で目的の画面組み合わせの名前をダブルクリックして、画面組み合わせエディターを開きます。そして、「ソース」タブをクリックして、ファイルのソースを表示することができます。エディターで、「開始画面」、「レンダリング (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/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 は、このグローバル変数を同じリッチ・クライアント環境内で稼働するアプリケーション間で共用するかどうかを指定します。

<extract> タグ

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

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

<set> タグ

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

enabled
このアクションが使用可能かどうかを表します。デフォルトは true です。
name
設定するグローバル変数の名前を指定します。これは、既存のグローバル変数でも新規のグローバル変数でも構いません。
shared
設定するグローバル変数を同じリッチ・クライアント環境内で稼働するアプリケーション間で共用するかどうかを指定します。
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 は、このグローバル変数を同じリッチ・クライアント環境内で稼働するアプリケーション間で共用するかどうかを指定します。
op
計算される値の第 1 オペランドと第 2 オペランドの間で行う演算のタイプを指定します。有効な値は、+ (加算)、- (減算)、* (乗算)、/ (除算)、% (モジュロ) などの演算を連結したものです。
op2
計算される値の第 2 オペランドが、定数か、既存のグローバル変数の値かを指定します。有効な値は、定数、またはグローバル変数の名前です。
op2_type
計算される値の第 2 オペランドを、定数として設定するか、既存のグローバル変数からの値として設定するかを指定します。有効な値は string および variable です。
op2_index
計算される値の第 2 オペランドの値のソースが索引付きグローバル変数である場合、op2_index は、計算対象の値として使用する索引の番号を指定します。
op2_shared
op2 の値がグローバル変数である場合、shared は、このグローバル変数を同じリッチ・クライアント環境内で稼働するアプリケーション間で共用するかどうかを指定します。
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/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
抽出するグローバル変数を同じリッチ・クライアント環境内で稼働するアプリケーション間で共用するかどうかを指定します。
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 プロジェクト内の 1 つの独立した 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 でプロジェクトのユーザーに表示するページを作成するために、テンプレート・ファイルの中で使用されます。

イメージ・ファイルは、project_name/images ディレクトリーに格納されます。イメージ・ファイルを表示するには、イメージの名前をダブルクリックします。

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

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

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

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

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

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

ComponentWidget.xml

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

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