付録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 クラスを指定します。
- com.ibm.hats.common.AppletSettings
- com.ibm.hats.common.ApplicationKeypadTag
- com.ibm.hats.common.ClientLocale
- com.ibm.hats.common.DBCSSettings
- com.ibm.hats.common.DefaultConnectionOverrides
- com.ibm.hats.common.DefaultGVOverrides
- com.ibm.hats.common.HostKeypadTag
- com.ibm.hats.common.KeyboardSupport
- com.ibm.hats.common.OIA
- com.ibm.hats.common.RuntimeSettings
- com.ibm.hats.transform
- com.ibm.hats.transform.components.name
- com.ibm.hats.transform.DefaultRendering
- com.ibm.hats.transform.widgets.name
<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 つの設定値があります。
- autoConvertSDBCtoDBCS 属性の有効な値は以下のとおりです。
- true
- 3270/3270E G タイプまたは 5250 G タイプ、および J タイプのフィールドについては、単一バイト文字を 2 バイト文字に自動変換します。
- false
- 3270/3270E G タイプまたは 5250 G タイプ、および J タイプのフィールドについては、単一バイト文字を 2 バイト文字に自動変換しません。
デフォルトは false です。詳しくは、「HATS ユーザーと管理者のガイド」のセクション『プロジェクト設定エディター』を参照してください。
- eliminateMaxlengthInIdeographic 属性の有効な値は以下のとおりです。
- true
- enableAutoAdvance ランタイム設定が
true の場合、DBCS フィールドの最大長を超える文字は IME に入力できます。また、ユーザーがこのフィールドに IME 候補を選択すると、超過した文字がカットされ、次のフィールド内に貼り付けられます。
enableAutoAdvance ランタイム設定が
false の場合、DBCS フィールドの長さを超える文字は IME に入力できます。しかし、ユーザーがこのフィールドに
IME 候補を選択すると、超過した文字は削除され、他のどのフィールドにも入力されません。
- false
- DBCS フィールドの最大長を超える文字は、IME に入力できません。
デフォルトは false です。詳しくは、「HATS ユーザーと管理者のガイド」のセクション『プロジェクト設定エディター』を参照してください。
- showUnprotectedSISOSpace 属性の有効な値は以下のとおりです。
- true
- 無保護のシフトイン文字またはシフトアウト文字をスペースで表示します。
- false
- 無保護のシフトイン文字またはシフトアウト文字を表示するためにスペースを使用しません。
デフォルトは true です。詳しくは、「HATS ユーザーと管理者のガイド」のセクション『プロジェクト設定エディター』を参照してください。
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 に設定されている場合は、スペース文字を使用して、ホストが以前にそのフィールドに入力したデータを置き換えることができます。
注:
- 複数の入力フィールドとしてレンダリングされるホスト・フィールドはいずれも、自動でクリアされません。例えば、行から行へと折り返す長いホスト・フィールドは、複数の入力フィールドとしてレンダリングされ、更新前に自動でクリアされることはありません。
- この設定は、プロジェクト・レベルでのみ指定できます。ただし、単一変換に対しては指定できません。
- 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 の場合は、フィールドがフォーカスを受け取ったときに、いずれのテキストも選択されません。端末エミュレーターの場合は、これが標準的な動作です。
注:
- Web アプリケーションの場合:
- デフォルトは true です。
- この設定は、enableOverwriteMode 設定の動作に影響しません。
- この設定は、アプリケーションのブラウザーに Internet Explorer が使用されている場合のみ有効です。
- リッチ・クライアント・アプリケーションの場合:
- デフォルトは 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
- パターン・タイプ・コンポーネントのカスタマイズ可能な設定の名前を指定します。使用可能な設定はコンポーネントによって異なります。
接続ファイル (.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 の有効な値は以下のとおりです。
- 2=24x80
- 3=32x80
- 4=43x80
- 5=27x132
- 6=24x132 (VT のみ)
初期デフォルトの画面サイズは、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 端末のタイプを表します。有効な値は以下のとおりです。
- 1=VT420_7
- 2=VT420_8
- 3=VT100
- 4=VT52
- 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 に指定されている場合に、コンポーネントとして使用できます。このコンポーネントの使用はデフォルト・レンダリングの一部ではないため、デフォルト・レンダリングまたはカスタム変換に追加する必要があります。有効な値は以下のとおりです。
- フィルターを使用して DDS データを無視 (Ignore DDS data using filter)
- フィルターを使用して DDS データを受け入れ (Accept DDS data using filter)
詳しくは、「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
- ROUNDTRIP_OFF
デフォルトは 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
- RIGHT_TO_LEFT
デフォルト値は LEFT_TO_RIGHT です。
- ThaiDisplayMode
- タイ語表示モード・プロパティーを設定します。このプロパティーはタイ語セッションのみに適用されます。値はストリング・フォーマットです。デフォルト値は THAI_MODE_5 です。
- workstationID
- workstationID プロパティーを設定します。このプロパティーは、5250 用拡張ネゴシエーションで使用されます。値はストリング・フォーマットです。小文字はすべて大文字に変換されます。デフォルト値はありません。
<classSettings> タグ
<classSettings> タグは、接続定義に含める Java クラスを囲むタグです。
<class> タグ
<class> タグは、<settings> タグで囲まれた属性を持つクラスを指定します。
<class> タグの属性には以下のものがあります。
- name
- 次のいずれかの Java クラスを指定します。
- com.ibm.hats.common.HATSPrintSettings
- com.ibm.hats.common.NextScreenSettings
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> タグの属性には以下のものがあります。
- 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 でイベントを指定しなかった場合、プロジェクト設定の通常のイベント優先順位リストが使用されます。有効な値は以下のとおりです。
- unmatchedScreen
- error
- disconnect
- stop
- (値なし)
<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 のプロパティー・シート表示によって、欠落情報を追加し、フィールドの内容を手動で設定できます。フィールドの内容を変更することによって、単一のマップを複数の画面キャプチャーに使用することができます。
注:
- HATS Toolkit でマップ・ファイルをプレビューする際、プロパティー・シート表示に表示されているフィールドは、「HATS プロジェクト表示」で強調表示されているマップ・ファイルのフィールドであり、プレビュー・ウィンドウに表示されているマップ・ファイルのフィールドではありません。
- 画面キャプチャー・ファイルが 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) や、テキストのフォント・サイズを変更できます。スタイル・シートの名前でその目的がわかります。
- normalFont.css
- scaleableFont.css
- nonFixedFont.css
- largeFont.css
- smallFont.css
- xlargeFont.css
- xsmallFont.css
- 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 プロジェクト」ビューからアクセスする「ホスト・シミュレーション」 フォルダーの以下のディレクトリーに格納されます。
- Web プロジェクト - Project_name/Web Content/WEB-INF/profiles/hostsimulations
- EJB プロジェクト - Project_name/ejbModule/hostsimulations
ホスト・シミュレーション・トレース・ファイルの作成の詳細については、「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 クラスで定義されている場合、この値を暗号化する必要があります。