付録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 クラスを指定します。
- 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.rcp.transform.widgets.name
- com.ibm.hats.rcp.ui.views.ToolBarSettings
- com.ibm.hats.transform
- com.ibm.hats.transform.components.name
- com.ibm.hats.transform.DefaultRendering
<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 つの設定値があります。
- autoConvertSDBCtoDBCS 属性の有効な値は以下のとおりです。
- true
- 3270 および 3270E G タイプまたは 5250 G タイプおよび J タイプ・フィールドの場合、1 バイト文字を 2 バイト文字に自動変換します。
- false
- 3270 および 3270E G タイプまたは 5250 G タイプおよび J タイプ・フィールドの場合、1 バイト文字を 2 バイト文字に自動変換しません。
デフォルトは false です。詳しくは、「HATS ユーザーと管理者のガイド」のセクション『プロジェクト設定エディター』を参照してください。
- setATOKDefaultModetoRoman 属性の有効な値は以下のとおりです。
- true
- ATOK のデフォルトの入力モードを Roman に設定します。
- false
- ATOK のデフォルトの入力モードを Hanji に設定します。
デフォルトは false です。
- 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 です。
- 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 つの行から別の行にまたがる長いホスト・フィールドは複数の入力フィールドとしてレンダリングされ、更新前に自動的にはクリアされません。
- この設定は、プロジェクト・レベルでのみ指定可能です。単一の変換に対して指定することはできません。
- enableArrowKeyNavigation
- true に設定されている場合、レンダリングされたホスト画面内のフィールド間をキーボードの矢印キーでナビゲートできます。デフォルトは false です。
- enableAutoAdvance
- カーソルが入力フィールドの終わりにきたとき (つまり、入力フィールドが完全に入力されたとき) に、カーソルが次の入力フィールドに移動するかどうかを指定します。
true の場合、カーソルが入力フィールドの終わりにきたときに、カーソルが次の入力フィールドに移動します。
false の場合、ユーザーが明示的に移動させない限り、カーソルは次の入力フィールドに移動しません。
デフォルトは false です。
- enableAutoTabOn
- カーソルが入力フィールドの終わりにきたとき (つまり、入力フィールドが完全に入力されたとき) に、タブ・キーによってカーソルを次の入力フィールドに移動させるかどうかを指定します。
true に設定されている場合、カーソルの位置が現行フィールドの終わりにきたときに、ブラウザーでの表示フィールドの順序に基づいて、タブ・キーによって現行フィールド内のカーソルを次のフィールドに移動させます。
false に設定されている場合、ユーザーが明示的に移動しない限り、タブ・キーがカーソルを次の入力フィールドに移動させることはありません。
デフォルトは false です。
- enableOverwriteMode
- true の場合、入力フィールドに入力されたテキストにより、カーソル位置にあるテキストが上書きされます (1 文字が 1 文字に置き換わる)。false の場合、入力フィールドに入力されたテキストがカーソル位置に挿入され、既存のテキストが前に押し出されます。ユーザーは、Insert キーを使用して、この初期設定を切り替えることができます。デフォルトは true です。
- includeLabelsInTabOrder
- true の場合、保護された読み取り専用ラベルがデフォルトのタブ移動順序に組み込まれます。
デフォルトでは、タブ移動順序にはパネル上の入力フィールドのみが組み込まれます。
この設定は、読み取り専用ラベルも組み込む必要があることを意味します。
- selectAllOnFocus
- true の場合、フィールドがフォーカスを受け取ったときに、フィールド内のすべてのテキストが選択されます。これは、Web アプリケーションの通常の動作です。false の場合、フィールドがフォーカスを受け取ったときに、テキストは選択されません。これは、端末エミュレーターの通常の動作です。
注:
- Web アプリケーションの場合:
- デフォルトは true です。
- この設定は、enableOverwriteMode 設定の動作には影響しません。
- この設定は、アプリケーションのブラウザーとして Internet Explorer が使用される場合に限り有効です。
- リッチ・クライアント アプリケーションの場合:
- デフォルトは 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
- パターン・タイプ・コンポーネントのカスタマイズ可能な設定の名前を指定します。使用可能な設定はコンポーネントによって異なります。
接続ファイル (.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 の有効な値は以下のとおりです。
- 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 です。
- 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 用拡張ネゴシエーションで使用されます。値はストリング・フォーマットです。小文字はすべて大文字に変換されます。デフォルト値はありません。
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 クラスを指定します。
- 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 プリンター出力ウィンドウの 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> タグの属性には以下のものがあります。
- 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 でイベントを指定しなかった場合、プロジェクト設定の通常のイベント優先順位リストが使用されます。有効な値は以下のとおりです。
- 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/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 のプロパティー・シート表示によって、欠落情報を追加し、フィールドの内容を手動で設定できます。フィールドの内容を変更することによって、単一のマップを複数の画面キャプチャーに使用することができます。
注:
- HATS Toolkit でマップ・ファイルをプレビューする際、プロパティー・シート表示に表示されているフィールドは、「HATS プロジェクト表示」で強調表示されているマップ・ファイルのフィールドであり、プレビュー・ウィンドウに表示されているマップ・ファイルのフィールドではありません。
- 画面キャプチャー・ファイルが 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 表示からアクセスする「ホスト・シミュレーション」 フォルダーの以下のに格納されます。
- RCP プロジェクト - Project_name/profiles/hostsimulations
ホスト・シミュレーション・トレース・ファイルの作成の詳細については、「HATS ユーザーと管理者のガイド」を参照してください。
ComponentWidget.xml
ComponentWidget.xml ファイルには、HATS で提供されるすべてのホスト・コンポーネントおよびウィジェットの定義が格納されています。独自のホスト・コンポーネントまたはウィジェットを追加したときは、このファイルを更新する必要があります。このファイルの説明と簡単なサンプルについては、コンポーネントまたはウィジェットの登録を参照してください。ComponentWidget.xml ファイルは、「ナビゲーター」ビューでプロジェクトの最後の項目として表示されます。このファイルを編集するには、「ナビゲーター」ビューでファイル名をダブルクリックして、「ソース」タブを選択します。
このファイルの内容の説明と使用方法については、コンポーネントまたはウィジェットの登録を参照してください。