画面イベントの処理

HATS イベントは、到達する特定の状態に基づいて、一連のアクションを実行するリソースです。 HATS イベントには、アプリケーション・イベントと画面イベントの 2 種類があります。アプリケーション・イベントの詳細については、アプリケーション・イベントを参照してください。 画面イベントは、特定の画面認識基準と突き合わせることによってホスト画面が認識されると起動する HATS イベントです。画面イベントには、画面カスタマイズと画面組み合わせの 2 種類があります。

画面カスタマイズは、ホスト画面を認識したら一連のアクションを実行するように設計されている HATS 画面イベントです。画面カスタマイズの例としては、画面の認識、ユーザーの GUI への画面の変換、マクロの再生による画面のスキップなどがあります。画面カスタマイズ定義には、画面認識基準のセットと、ホスト画面が画面認識基準に一致した場合に実行するアクションのリストが含まれています。画面レベルのグローバル規則とテキスト置換設定も含まれます。新規の画面カスタマイズを作成するには、「画面カスタマイズの作成」ウィザードを使用してください。

画面組み合わせは、連続した類似のホスト画面から出力データを収集し、そのデータを結合して単一の出力ページ内に表示するように設計されている HATS 画面イベントです。画面組み合わせの例としては、部分的な出力データのみが含まれている画面を認識したり、残りのデータをすべて収集してユーザーに表示するために後続のすべての画面をナビゲートするなどがあります。画面組み合わせ定義には、組み合わせる開始画面と終了画面の画面認識基準のセット、画面間のナビゲート方法、および各画面から収集したデータを認識してレンダリングするために使用するコンポーネントとウィジェットが含まれています。また、画面カスタマイズと同様、実行するアクションのリスト、画面レベルのグローバル規則、およびテキスト置換設定も含まれています。 新規の画面組み合わせを作成するには、「画面組み合わせを作成」ウィザードを使用してください。

「画面カスタマイズの作成」ウィザード

HATS プロジェクトで、画面カスタマイズを定義するには、「画面カスタマイズの作成」ウィザードを使用します。画面カスタマイズ・ウィザードを使用する前に、ホスト端末を開いたままにしておくか、画面キャプチャーを用意しておく必要があります。BMS マップは、画面カスタマイズに使用する画面キャプチャーの作成にも使用できます。BMS マップ・セットの詳細については、BMS マップ・セットのインポートを参照してください。

次のいずれかのアクションを実行して、ウィザードにアクセスできます。

ウィザードで使用可能な設定の詳細については、画面イベントの編集を参照してください。

画面カスタマイズを対象に定義した設定は、画面カスタマイズ (.evnt) ファイルに保存されます。このファイルを参照するには、「HATS プロジェクト」ビューの「画面カスタマイズ」フォルダーを展開します。 画面カスタマイズ・ファイルの表示および変更を行う場合は、画面イベント・エディターを使用してください。

「画面組み合わせを作成」ウィザード

HATS プロジェクトで、画面組み合わせを定義するには、「画面組み合わせを作成」ウィザードを使用します。「画面組み合わせを作成」ウィザードを使用する前に、ホスト端末か画面キャプチャーを開いておく必要があります。 BMS マップは、画面組み合わせに使用する画面キャプチャーの作成にも使用できます。 BMS マップ・セットの詳細については、BMS マップ・セットのインポートを参照してください。

次のいずれかのアクションを実行して、ウィザードにアクセスできます。

ウィザードで使用可能な設定の詳細については、画面イベントの編集を参照してください。

画面組み合わせを対象に定義した設定は、画面組み合わせ (.evnt) ファイルに保存されます。このファイルを参照するには、「HATS プロジェクト」ビューの「画面組み合わせ」フォルダーを展開します。 画面組み合わせファイルの表示および変更を行う場合は、画面イベント・エディターを使用してください。

画面イベントの編集

画面イベント・エディターは、画面カスタマイズ .evnt ファイルまたは画面組み合わせ .evnt ファイルの名前をダブルクリックすれば起動できます。以下のセクションでは、画面イベント・エディターの各タブについて説明します。

概要

画面イベント・エディターの「概要」タブには、画面イベントを作成したときに指定したすべての情報が要約されています。このタブには、画面イベントの名前と説明、画面認識基準の作成に使用された画面の名前と画像、実行されるアクションの要約、および画面認識基準の要約が収容されています。画面組み合わせの場合、このタブには、ナビゲーション、コンポーネント、終了画面認識基準設定の要約も収められています。 このタブで、画面イベントの説明を変更したり、画面イベントに関連付ける別の画面を選択したりすることができます。選択した画面は、画面認識基準の変更やアクションの追加など、画面イベントに変更を加えるときに使用されます。

画面認識基準または開始画面

画面カスタマイズ・イベントの編集時には、「画面認識基準」タブが表示されます。 画面組み合わせイベントの編集時には、「開始画面」タブが表示されます。 いずれの場合にも、タブには、画面イベントを起動するホスト画面に一致するように設定した画面認識基準が表示されます。基準を組み合わせてホスト画面を認識させることができます。基準には、画面上のフィールドまたは入力フィールドの総数、カーソル位置の座標、および画面上の定義済み長方形の内部または画面上の任意の場所にあるテキスト・ストリングなどが含まれます。このタブで、画面認識基準を追加、編集、または削除できます。

注:

DBCS サポートを使用する場合の考慮事項については、画面認識基準/開始画面を参照してください。

関連する画面キャプチャー

このオプションが表示されるのは、画面組み合わせイベントの「開始画面」タブの場合に限られます。 別の画面キャプチャーを選択して画面組み合わせの開始画面と関連付けるには、「変更」ボタンをクリックします。

フィールド基準

画面の「フィールドの総数」、画面の「入力フィールドの数」、またはこれら両方を画面認識基準として使用できます。「フィールドの総数」設定には、入力フィールド、保護テキスト・フィールド、および隠しフィールドが含まれます。これらは、このタブに表示される最初の 2 つの基準です。

これらの基準のチェック・ボックスを選択すると、画面の認識に使用されます。各フィールド基準の隣のフィールドは、「概要」タブで指定したフィールドと入力フィールドの総数を示します。この画面イベントに使用される画面を変更する場合、「最新表示」をクリックして、選択した画面の値を更新してください。

注:
ある数のフィールドを持つ画面を認識するためにフィールド基準を使用し、別の画面にそれと同じ数のフィールドが含まれていない場合は、別の画面は認識されません。例えば、ある画面に 10 フィールドを持つ 10 ファイルのリストがあるとします。ホストが、リスト内に 8 ファイル、および 8 フィールドのみを持つ画面を表示する場合は、2 番目の画面は、最初の画面に一致した画面イベントのフィールド数の基準に一致しません。

「オプション」および「反転」チェック・ボックスについては、オプションおよび非オプションの画面認識基準および 画面認識基準の反転一致を参照してください。

カーソル位置基準

カーソルの初期位置を画面認識基準として、単独、または他の基準とともに使用するには、「カーソル位置」チェック・ボックスを選択します。カーソル位置基準の隣のフィールドは、「概要」タブで指定した画面のカーソル位置の行と列を示します。この画面イベントに使用される画面を変更する場合、「最新表示」をクリックして、選択した画面の初期カーソル位置の行と列の値を更新してください。

「オプション」および「反転」チェック・ボックスについては、オプションおよび非オプションの画面認識基準および 画面認識基準の反転一致を参照してください。

オプションおよび非オプションの画面認識基準

設定した画面認識基準がオプションか非オプションかを選択できます。「オプション」チェック・ボックスを選択しない場合は、認識基準は非オプションと見なされます。「オプション」チェック・ボックスの使用方法は、Host On-Demand 画面記述子属性 optional に対応して決まります。

オプションの認識基準と非オプションの認識基準の両方がある場合、HATS は最初に非オプションの基準をチェックします。すべての非オプションの認識基準が一致した場合、画面が一致したことになります。少なくとも 1 つの非オプション認識基準が一致しない場合、HATS はオプションの認識基準をチェックします。画面が基準に一致するためには、すべての非オプション基準または少なくとも 1 つのオプション基準が HATS で見つかる必要があります。それ以外の場合は画面は一致しません。次の例で、この考え方について詳しく説明します。

注:
非オプションは必須という意味ではありません。

次の例に示す値を使用して、カーソル位置と 2 つのテキスト・ストリングを定義したとします。

Cursor position recognition  Optional     
                             Row: 1   Column: 1

String recognition           Non-optional   
                             String 1: Welcome
                             Start position: Row: 1   Column: 6
                             End position:   Row: 1   Column: 12

                             String 2: Username
                             Start position: Row 20   Column 10
                             End position:   Row 20   Column 17

この例では、画面が一致するためには、HATS で両方のテキスト・ストリング、またはカーソル位置が見つかる必要があります。HATS は非オプションの基準を最初にチェックするので、テキスト・ストリングがまず検索されます。HATS がホスト画面の指定領域内で両方のテキスト・ストリングを見つけることができない場合、オプションの基準 (カーソル位置) を見つけることができるかどうかをチェックします。

画面認識基準の反転一致

設定した画面認識基準がホスト画面に一致するか一致しないかを選択できます。「反転」チェック・ボックスを選択すると、認識基準が画面に一致しない場合に基準が「true」となります。

逆に、「反転」チェック・ボックスをクリアすると、認識基準が画面に一致した場合に基準が「true」となります。

「反転」チェック・ボックスの使用方法は、画面記述子属性 invertmatch に対応して決まります。

追加の基準

ストリング基準

テキスト・ストリング位置基準は、タブの「追加の基準」セクションに表示されます。 画面認識基準としてストリング位置を設定している場合は、その位置がテーブルに示されます。このテーブルでは、テキストが含まれる画面位置のタイプ、選択したテキストの文字の一部、テキストの大文字と小文字を区別するか、テキストはオプションか、またはテキストを反転するかが示されます。

ストリング基準を定義するテーブルの行を強調表示して「編集」をクリックするか、「追加」をクリックすると、「画面基準 (Screen Criterion)」ダイアログが表示されます。 このダイアログ・パネルで、テキスト・ストリング情報を変更または編集できます。ストリングの属性 (大文字小文字の区別、オプション、または反転) を選択することもできます。このパネルには、「概要」タブで選択した画面が表示されます。

テキストの周囲に長方形を描いて、画面上の任意のテキストを選択できます。カーソルを画面上の一点に置き、左マウス・ボタンをクリックして押しながら別の点に移動して長方形を描きます。ダイアログの右側のフィールドに、選択したテキスト、および長方形の開始点および終了点の行とカラムの数値が表示されます。「画面の任意の場所」、「指定位置」、または「長方形の領域内」のいずれかのラジオ・ボタンをクリックして、テキストを含む画面部分を指定できます。選択したテキストを画面認識基準にマッチングさせるときに、大文字と小文字の区別が必要な場合は、「大文字と小文字を区別」チェック・ボックスを選択します。

「オプション」および「反転」チェック・ボックスについては、オプションおよび非オプションの画面認識基準および 画面認識基準の反転一致を参照してください。

選択を終了したら、「OK」をクリックします。

グローバル変数基準

グローバル変数を使用して画面認識基準を定義するには、「追加」ボタンの横にある下矢印をクリックして、「グローバル変数基準」を選択します。 グローバル変数基準を使用する場合は、「グローバル変数」ドロップダウン・リストからグローバル変数を指定するか、値を入力する必要があります。以下の 5 項目の 1 つを選択して、「検証ロジック」を指定します。

「属性」セクションの「オプション」および 「反転」チェック・ボックスについては、オプションおよび非オプションの画面認識基準 および 画面認識基準の反転一致を参照してください。

拡張グローバル変数のプログラミングの詳細については、ご使用のアプリケーション環境に応じて、「HATS Web アプリケーション・プログラマーズ・ガイド」または「HATS リッチ・クライアント・プラットフォーム・プログラマーズ・ガイド」を参照してください。

色基準

「追加」ボタンの横にある下矢印をクリックして 「色基準」を選択することにより、色による画面認識基準を定義できます。これにより、パネルがオープンし、行およびカラムの位置と、前景色および背景色を選択できます。

「オプション」および「反転」チェック・ボックスについては、オプションおよび非オプションの画面認識基準および 画面認識基準の反転一致を参照してください。

領域と値の比較の基準

「領域と値の比較」基準により、ホスト画面の選択領域にあるテキストとハードコーディングされた値を比較できます。

まず、端末の領域を枠で囲むか、「領域の定義」セクションで認識対象とする座標を入力します。テキスト・ボックスに 「端末上の現行値」も表示されます。

次に、領域の比較対象および比較方法を指定できます。「比較の定義」セクションで、「領域」の隣にあるドロップダウン・リストから領域の比較方法を選択し、「値」テキスト・ボックスに比較対象を入力します。

「比較タイプ」は、「数値」または「テキスト」のいずれかです (「テキスト」の場合は「大文字と小文字を区別」 チェック・ボックス・オプションもあります)。

属性も定義できます。「オプション」および「反転」チェック・ボックスについては、オプションおよび非オプションの画面認識基準および 画面認識基準の反転一致を参照してください。

選択を終了したら、「OK」をクリックします。

領域を領域と比較する基準

「領域を領域と比較する」基準により、ホスト画面の特定の領域を同じホスト画面の別の領域と比較できます。

まず、「最初の領域」タブを選択し、端末の領域を枠で囲むか、「領域の定義」セクションで認識対象とする座標を入力します。テキスト・ボックスに 「端末上の現行値」も表示されます。

次に、「比較の定義」セクションで、「領域 1」と「領域 2」の間にあるドロップダウン・メニューから、これらの領域の比較方法を指定します。

「比較タイプ」は、「数値」または「テキスト」のいずれかです (「テキスト」の場合は「大文字と小文字を区別」 チェック・ボックス・オプションもあります)。

属性も定義できます。「オプション」および「反転」チェック・ボックスについては、オプションおよび非オプションの画面認識基準および 画面認識基準の反転一致を参照してください。

「2 番目の領域」タブについても同じステップを繰り返し、完了したら「OK」をクリックします。

レンダリング (画面組み合わせのみ)

「レンダリング」タブは、画面組み合わせイベントの場合にのみ表示されます。このタブは、画面組み合わせによって収集する情報を認識するためのコンポーネントを設定する場合に使用します。 また、このタブは、コンポーネントをレンダリングするときに使用するウィジェットを設定する場合にも使用します。 画面組み合わせイベントでは、HATS コンポーネントとウィジェットのサブセットがサポートされています。 HATS コンポーネントおよびウィジェットの使用の詳細については、ホスト・コンポーネントを挿入を参照してください。

「領域の変更」ボタンをクリックすると、画面キャプチャーの領域と、コンポーネントによってみなされる画面の領域を変更できます。

ポートレット以外のプロジェクトでは、以下の設定を使用すると、画面組み合わせの結果がユーザーに対して初めて表示される時刻を、画面組み合わせが完了する時刻と関連させて制御することもできます。

動的キャッシュ・コンテンツ・ロードを使用する  Web のみ 
HATS が画面組み合わせのすべての画面をナビゲートし、すべての結果を組み合わせてから結果をユーザーに表示するように指定する場合は、このボックスを未選択のままにします。最初の画面からの結果が収集されたらすぐに、ユーザーに対する結果の表示が HATS によって開始され、画面がナビゲートされるにつれて結果の表示を更新するように指定する場合は、このボックスを選択します。

ナビゲーション (画面組み合わせのみ)

「ナビゲーション」タブは、画面組み合わせイベントの場合にのみ表示されます。このタブには、画面組み合わせの開始画面から中間画面を経由して終了画面までナビゲートするために必要なコマンドが表示されます。 「追加」、「編集」、 「除去」の各ボタンを使用して、「上へ移動」および「下へ移動」の 2 つのナビゲーション方向のコマンドを設定します。表示される「追加コマンド」ダイアログまたは「編集コマンド」ダイアログには、3 つのコマンド・オプションがあります。ナビゲーション方向ごとに複数のコマンドを設定するには、「追加」ボタンを複数回クリックします。設定できる 3 つのコマンド・オプションを以下に示します。

キーを送信
このオプションを使用して、ホスト・システムに送信するホスト・キーを選択できます。
テキストを挿入
このオプションは、現在のカーソル位置にテキストを挿入するときに使用します。
カーソル位置を設定
このオプションは、現行カーソル位置をホスト画面に設定するときに使用します。

終了画面 (画面組み合わせのみ)

「終了画面」タブは、画面組み合わせイベントの場合にのみ表示されます。このタブには、画面組み合わせの終了を定義している、設定した基準が表示されます。このタブで、画面認識基準を追加、編集、または削除できます。「反復カウントのみ」、「画面記述子のみ」、「反復カウントまたは画面記述子のいずれかの最初の一致」という 3 種類の終了基準のいずれかを選択できます。

終了基準を選択

反復カウントのみ
この基準を「反復の回数」設定と組み合わせて選択すると、この画面組み合わせが固定の画面数の後に終了することを指定できます。
画面記述子のみ
この基準を他の画面認識設定 (「フィールドの総数」、「入力フィールドの数」、「カーソル位置」、「追加の基準」など) と組み合わせて選択すると、画面組み合わせの終了画面を定義できます。
反復カウントまたは画面記述子のいずれかの最初の一致
この基準をこれ以外のすべての設定と組み合わせて選択すると、この画面組み合わせが終了するタイミングを、固定の画面数の表示後と、終了画面が認識されたときのうちいずれか早い方に指定できます。

反復回数

「ナビゲーション」タブに定義されているナビゲーションの実行回数を設定する場合は、このボックスを選択します。この回数に到達すると、終了画面に到達したものとみなされます。

関連する画面キャプチャー

別の画面キャプチャーを選択して画面組み合わせの終了画面と関連付けるには、「変更」ボタンをクリックします。

画面記述子の設定

終了画面の画面記述子設定は、開始画面の認識基準設定と同じです。これらの設定の説明については、画面認識基準または開始画面を参照してください。

アクション

画面イベント・エディターの「アクション」タブには画面イベントの構成済みアクションが表示されます。

アクションの適用順序を変更するには、順序を変更するアクションをリスト内で選択し、上矢印または 下矢印をクリックして上または下に移動します。

リストに表示されるすべてのアクションを「編集」または「除去」できるだけでなく、新しいアクションを「追加」することもできます。

これらのアクションは、リストされている順に、HATS ランタイムによって実行されます。例えば、一部のフィールドに値が事前に入力された変換済みホスト画面をユーザーに対して表示するには、ホスト画面を変更してから (「データを挿入」アクションを使用するなど)、変換済みホスト画面を表示します (「変換を適用」 アクションを使用)。画面イベントで「マクロを実行」アクションまたは「キーを送信」アクションを使用する場合、そのアクションはリスト内の最後のアクションとする必要があります。

画面イベント内のすべてのアクションの実行が完了すると、HATS は変換ホストにデフォルトのコマンドを送信して、現在認識されている画面からホスト・アプリケーションをクリアします。この処理を行わないと、画面イベント内のアクションで無限ループが発生する可能性があります。 「アクション・リストの完了時にホスト・キーを送信して画面を変更」を選択すると、アクション・リストの完成後に送信するキーを判別できます。デフォルトでは、HATS ランタイムによって、アクション・リストの終わりに [enter] が変換ホストに送信されます。エイド・キーは、以下の条件をすべて満たす場合に送信されます。

アクション・リストに「変換を適用」アクションが含まれていて、変換への応答として F2 コマンドを送信した場合、デフォルトのコマンドではなく、[pf2] コマンドが送信されます。同様に、「マクロを実行」アクションを使用して画面イベントを終了した場合もデフォルトのコマンドは送信されません。

このタブで、アクションを追加、編集、または削除できます。指定可能なアクションを以下に示します。

画面イベントに定義したすべてのアクション・タイプとその説明は、「アクション」タブのテーブルに表示されます。テーブルの行を強調表示して「編集」をクリックすると、「アクションを編集」ダイアログが表示されます。

「追加」をクリックすると、「アクションを選択」ウィザードが表示されます。最初のパネルには、すべての使用可能なアクションのリストが表示されます。実行するアクションを選択するには、そのアクションのラジオ・ボタンをクリックし、「次へ」をクリックします。選択したアクションに応じて、パネルのほかの部分に、そのアクションに対して指定できる情報が表示されます。

注:
「アクションを編集」ダイアログでアクション・タイプを変更することはできません。変更できるのはアクションに適用する情報のみです。

「変換を適用」アクション

この画面イベントのアクションとして変換を適用することにした場合、HATS Web プロジェクトでは、プロジェクトで定義した変換のドロップダウン・リストから、適用する変換を選択できます。

HATS リッチ・クライアント・プロジェクトの場合は、「参照」ボタンを使用して、現行プロジェクトのクラス・パスにある画面変換のリストを表示できます。このリストの対象になるのは、通常、現行プロジェクトの変換のみですが、現行プロジェクトによって参照される他のプラグインを基にした他の変換や、現行プロジェクトによって参照される .jar ファイル内に格納されている変換を対象にすることもできます。

詳しくは、変換の処理を参照してください。

「テンプレート」フィールドには、デフォルトで選択される「(デフォルト・テンプレート)」があります。この変換に適用する別のテンプレートを選択しない限り、GUI で変換を囲むテンプレートは、プロジェクトのデフォルト・テンプレートとして指定したテンプレートとなります。ドロップダウン・リストに、プロジェクトで指定したすべてのテンプレートが含まれます。

ユーザーが押したホスト・キーが、すべてのアクションの実行が完了するまで待機するのではなくすぐにホストに送信されるようにするには、「即時ホスト・キー」をクリックします。ホストに即時送信するキーのチェック・ボックスを選択します。ホスト・キーが即時に送信されると、その他のアクションは実行されなくなります。 これらのキーの即時送信は、現在の変換にのみ適用され、プロジェクト内のすべての変換には適用されません。

プロジェクト・レベルおよび画面レベルのグローバル規則処理を使用不可に設定するには、「プロジェクト・レベルおよび画面レベルのグローバル規則を適用」チェック・ボックスのチェック・マークを外します。

「ビジネス・ロジックを実行」アクション

あるビジネス・ロジックをこの画面イベントのアクションとして実行する場合は、実行するビジネス・ロジックの完全修飾 Java™ クラス名と Java メソッドを所定のフィールドに指定する必要があります。 「クラス名」フィールドの隣の「ブラウズ」をクリックして、ビジネス・ロジック・メソッドが定義されているクラスを選択できます。HATS Toolkit の「HATS プロジェクト表示」タブにある「ソース」フォルダーの下に定義されている任意のクラスを選択できます。このビジネス・ロジック用の Java コードを作成していない場合は、「HATS プロジェクト」表示タブを右クリックし、 「新規 HATS」>「ビジネス・ロジック」をクリックして、「ビジネス・ロジックの作成」ウィザードを起動します。

ビジネス・ロジックの詳細については、ご使用のアプリケーション環境に応じて、「HATS Web アプリケーション・プログラマーズ・ガイド」または「HATS リッチ・クライアント・プラットフォーム・プログラマーズ・ガイド」を参照してください。

「グローバル変数を抽出」アクション

ホスト画面領域には、グローバル変数として割り当てる画面領域の開始および終了の行とカラムを定義します。画面から情報を抽出して、グローバル変数として定義することができます。グローバル変数を抽出する際、「名前」フィールドで名前を指定するか、ドロップダウン・リストから既存のグローバル変数名を選択することができます。

ホスト画面の複数行から抽出されたテキストをグローバル変数内に定義する方法を指定するには、「拡張」をクリックします。いずれかのラジオ・ボタンを選択して、1 つのストリングとして抽出するか、複数ストリングのリスト (索引付き) として抽出するかを指定する必要があります。「拡張」をクリックする前に 「名前」フィールドで既存のグローバル変数を選択した場合は、以下のいずれかのラジオ・ボタンを選択して HATS での抽出データの処理方法を指定する必要があります。

指定の索引を使用する 2 つのオプションでは、「索引」フィールドに索引番号を入力する必要があります。

次の例に、選択するオプションにより変数値がどのように変更されるかを示します。まず、"sample" という既存の索引付き変数について説明します。『sample』 の値は 『a b c d』 です。この値のうち、『a』 の索引は 0 であるため、『sample[0]』 の値は 『a』 になり、『b』 の索引は 1 であるため、『sample[1]』 の値は 『b』 になります (以下同様)。新しい値のセット " e f g" を抽出するとします。

「共用」チェック・ボックスを選択すると、グローバル変数が共用されるようになります。

グローバル変数の詳細については、グローバル変数との対話を参照してください。

「データを挿入」アクション

データの挿入先にするホスト画面の領域を設定する場合は、マウスを使用するか、「開始行」および「開始桁」の設定を使用します。 ホスト画面の特定のフィールドを強調表示するには、「フィールドを強調表示」の隣にある別のオプションを選択します。入力フィールドが画面上で定義されている位置を表示するには、「入力」チェック・ボックスを選択します。保護フィールドを表示する場合は、「保護」チェック・ボックスを選択します。隠しフィールドを強調表示するには、「非表示 (Hidden)」チェック・ボックスを選択します。入力フィールド、保護フィールド、または隠しフィールドの強調表示の色を変更する方法については、HATS プリファレンスの使用を参照してください。

「次へ」をクリックし、適切なラジオ・ボタンをクリックしてデータがストリングであるかグローバル変数であるかを選択します。ストリングを挿入するには、提供された入力フィールドにテキストを入力します。グローバル変数を挿入するには、既存のグローバル変数の名前をドロップダウン・リストから選択するか、グローバル変数の名前を入力します。異なるアプリケーションからの共用グローバル変数を使用する場合は、名前をフィールドに入力する必要があります。

グローバル変数の値に索引が付いている (ストリングのリストが含まれる) 場合は、「拡張」をクリックします。ラジオ・ボタンのいずれかをクリックして、指定した場所にすべてのストリングを並べて挿入するか、または画面の長方形領域に個別の行としてストリングを挿入するかを選択する必要があります。

「共用」チェック・ボックスを選択すると、グローバル変数が共用されるようになります。

グローバル変数の詳細については、グローバル変数との対話を参照してください。

注:
ホスト画面への情報の挿入は、グローバル変数の変換が実行されて GUI に表示され前に 行う必要があります。アクションの順序の変更方法については、アクションを参照してください。

「グローバル変数を設定」アクション

プロジェクト内の他のオブジェクトのほか、.ear の他のプロジェクトで使用するグローバル変数を設定できます。グローバル変数を設定する際、「名前」フィールドに名前を指定するか、ドロップダウン・リストから既存のグローバル変数名を選択できます。既存の索引付きグローバル変数を選択した場合、「拡張」をクリックして、設定値の処理方法を指定する必要があります。以下のオプションを使用できます。

指定の索引を使用する 2 つのオプションでは、「索引」フィールドに索引番号を入力する必要があります。

選択したオプションに基づいて変数値を設定する方法の例については、「グローバル変数を抽出」アクションを参照してください。

グローバル変数を固定値に設定する場合は、入力フィールドに値を入力します。

グローバル変数を計算値に設定する場合は、使用するオペランドおよび計算オペレーションを指定します。オペランドは、フィールドに固定値として入力するか、または既存のグローバル変数値を計算に使用できます。既存の索引付きグローバル値を使用し、使用する変数の索引をオペランドとして指定する場合は、「拡張」をクリックします。「索引」フィールドに索引の数を入力します。

「共用」チェック・ボックスを選択すると、グローバル変数が共用されるようになります。

グローバル変数の詳細については、グローバル変数との対話を参照してください。

「グローバル変数を除去」アクション

このアクションを使用して、1 つ以上のグローバル変数を除去します。1 つのローカルまたは共用グローバル変数、すべてのローカル・グローバル変数、すべての共用グローバル変数、またはすべてのローカルおよび共用グローバル変数を除去できます。「1 つのローカル」 または「1 つの共用」オプションのいずれかで、除去するグローバル変数の名前を入力するか、またはそれに対応するドロップダウン・リストから名前を選択します。

注:
同じ .ear ファイルで稼働する別の HATS Web アプリケーションで作成された共用グローバル変数名、または同じ リッチ・クライアント環境で稼動する別の HATS リッチ・クライアント・アプリケーションで作成された共用グローバル変数名は、共用グローバル変数のドロップダウン・リストに表示されない可能性があります。これらの共用グローバル変数の 1 つを除去するには、「1 つの共用」オプションの入力フィールドにその名前を入力します。

グローバル変数の詳細については、グローバル変数との対話を参照してください。

「グローバル変数を送信」アクション

このアクションは、HATS 標準 (JSR 168) ポートレット・プロジェクトにのみ適用されます。これは、ポートレット通信ソリューションを開発する手助けとして使用できます。詳しくは、ポートレット通信を参照してください。

このアクションを使用して、HATS JSR 168 ポートレットからポータル・サーバー上の他の JSR 168 ポートレット (HATS または非 HATS) へ、プロパティーの java.lang.String 値としてグローバル変数の値を送信します。「プロパティー」フィールドに、送信するプロパティーの名前を入力します。名前は、受信ポートレットで使用されるプロパティー名に一致する必要があります。例えば、HATS JSR 168 受信ポートレットの「その他」タブの「ポートレット」設定で定義されているプロパティー名と同じにします。グローバル変数フィールドに、グローバル変数の名前を入力します。グローバル変数の値に索引が付いている場合は、「拡張」をクリックします。その後、変数の「すべての索引を送信」し、任意にストリング区切り文字で区切るか、または送信する「索引」を含めて「単一の索引を送信」するかを指定します。グローバル変数が共用グローバル変数である場合は、「共用」チェック・ボックスを選択します。

「終了」をクリックすると、アクションは画面のイベント (.evnt) ファイルに追加されます。また、Web サービス記述言語 (WSDL) ファイルがない場合は作成され、送信プロパティーは WSDL ファイルで定義されます。WSDL ファイルの名前は <project_name>.wsdl です。 WSDL ファイルは、WebSphere® Portal ワイヤリング・ツールを使用してポートレットをワイヤリングするために必要です。 portlet.xml ファイルは、WSDL ファイルの場所を参照するように更新されます。

「除去」をクリックすると、アクションが画面のイベント・ファイルから除去されますが、プロパティーは WSDL ファイルから除去されません。WSDL ファイルを編集し、WSDL エディターを使用してプロパティーを除去できます。

注:
WSDL ファイルからプロパティーを除去しなければ、HATS ポートレットは現状のまま正常に稼働します。
注:
  1. このアクションはイベントの「変換を適用」アクションに従う必要があります。
  2. 以下のアクションは、「変換を適用」アクションと「グローバル変数を送信」アクション間でサポートされる唯一のアクションです。
  3. 上記のアクションは、他のポートレットに送信する前にグローバル変数を処理する場合に便利です。 例えば、ログイン画面で入力したユーザー ID を他のポートレットに送信する場合などです。この例では、ログイン画面を変換するために「変換を適用」アクションを追加し、ユーザー ID 入力フィールドの領域を抽出するために「グローバル変数を抽出」アクションを追加して、それをグローバル変数に保存します。その後、グローバル変数に保管されたユーザー ID を他のポートレットに送信するために、「グローバル変数を送信」アクションを追加します。
  4. 以下のアクションは、「変換を適用」アクションと「グローバル変数を送信」アクション間でサポートされていません。これらのアクションのいずれかが「変換を適用」アクションと「グローバル変数を送信」アクション間に配置されている場合、通常どおりに実行されますが、グローバル変数は送信されません。

「URL または SWT コンポジットを表示」アクション  RCP のみ 

このアクションは、「変換」ビューの変換領域に Web ページまたは SWT コンポジットを表示する場合に使用します。Web ページを表示する場合は、Web ページの URL (Uniform Resource Locator) アドレスを「URL」フィールドに指定します。 SWT コンポジットを表示する場合は、そのクラス名を「コンポジット・クラス」フィールドに入力するか、「参照」ボタンを使用して、リッチ・クライアント・プロジェクト内から SWT コンポジットを選択します。 Web ページまたは SWT コンポジットは、テンプレートのリストから選択したテンプレートに囲まれて表示されます。 Web ページまたは SWT コンポジットが読み込まれたら、ユーザーはいずれかの「続行」ボタンをクリックして、HATS アプリケーションに戻る必要があります。

注:
「続行」ボタンを含む SWT コンポジットの実装方法については、「HATS リッチ・クライアント・プラットフォーム・プログラマーズ・ガイド」を参照してください。

「URL を表示」アクション  Web のみ 

Web ページをこの画面イベントのアクションとして表示する場合、「URL」フィールドに Web ページの URL (Uniform Resource Locator) アドレスを指定する必要があります。Web ページは、変換の表示と同様にデフォルト・テンプレートで囲まれて表示されます。Web ページが読み込まれた後は、Web ページの下部にある「続行」ボタンをクリックすることにより、ユーザーは HATS アプリケーションに戻ります。

組み込みオブジェクト (例えば HTML のデータ・タイプを持つオブジェクト) が、ブラウザーによってサポートまたは許可されていない場合、このアクションは Web ページの内容の代わりに、Web ページへのリンクを表示します。サポートされる Web ブラウザーと制約事項のリストについては、HATS インフォメーション・センター (http://publib.boulder.ibm.com/infocenter/hatshelp/v75/index.jsp) の HATS 前提条件のセクションを参照してください。

「URL を表示」アクションのターゲットを指定する場合は、クライアントのワークステーションがターゲット・ページにアクセスできる必要があります。そのため、クライアント・ワークステーションにターゲット・ページへの直接のアクセス権限がない場合などは、企業のファイアウォールで保護されているターゲット Web ページは指定できません。ターゲットの完全な URL を指定してください。そうしないと、クライアントはターゲット・ページのホスト名を解決できません。HATS アプリケーションをホストする (「クロスドメイン」アクセス) アプリケーション・サーバーにターゲット・ページが存在しない場合、サーバーにないターゲット・ページをロードできるようにブラウザー設定を調整する必要があります。

例えば、Internet Explorer V6.0 以降で、「ツール」メニューに進み、「インターネット オプション」を選択して、「セキュリティ」タブを選択します。ブラウザー・ウィンドウの右下角に Web コンテンツ・ゾーンが表示されます。このページがインターネット・ゾーンにある場合、ターゲット・ページがロードできるように、インターネット・ゾーン設定を調整する必要が生じることがあります。正しいゾーンを選択し、「レベルのカスタマイズ」ボタンをクリックします。「各種」の設定にスクロールして、「ドメイン間でのデータ ソースのアクセス」の設定を選択します。ターゲット・ページをロードするには、「使用可能」を選択します。ターゲット・ページのロード前にプロンプトを出すには、「プロンプト」を選択します。「無効にする」を選択すると、ターゲット Web ページがロードされません。

「URL に転送」アクション  Web のみ 

「URL に転送」アクションにより、変換指向 HATS Web アプリケーションから 1 つ以上のチェーン統合オブジェクトを起動する JSP に制御を渡すことができます。これにより、作成済みの統合オブジェクトを使用できます。統合オブジェクトは既存の接続またはバックグラウンド接続を使用できます。

このアクションは、HATS Web および HATS 標準ポートレット・プロジェクトでサポートされていますが、HATS IBM® ポートレット・プロジェクトではサポートされていません。

転送アクションをイベントに追加するには、以下のパラメーターを指定する必要があります。

注:
大規模な JSP を実行する場合は、JVM システムのプロパティー com.sun.tools.javac.main.largebranch=true を設定し、サーバーを再始動します。JVM のプロパティーを設定するには、管理コンソールを使用するか、JVM の引数を設定するか、またはカスタム・プロパティーを作成します。

URL への転送により、JSP/統合オブジェクト・ロジックが使用する接続を複数の方法で管理できます。例えば、次のようになります。

転送アクションを使用する場合は、統合オブジェクトの実行後に制御が自動的に HATS アプリケーションに戻されることはありません。JSP は、HATS アプリケーションに明示的に制御を戻す必要があります。転送アクションより前にデフォルト接続が確立されていない場合に統合オブジェクトがデフォルト接続を使用する場合は、デフォルト接続として使用する接続を HATS アプリケーションに渡す必要があります。この場合、必ず HttpServletRequest で要求パラメーターを設定してから、その要求を HATS アプリケーションに転送してください。パラメーターは CommonConstants.HATS_EXISTING_CONN です。このパラメーターに必要な値を取得するには、チェーンの最後の統合オブジェクトで getHPubEndChainName メソッドを呼び出します。

例えば Web プロジェクトでは FORM は以下のようになる可能性があります。

<FORM NAME="exampleLink" METHOD="GET" 
ACTION='<%= response.encodeURL(request.getContextPath()+"/entry")%>'>
<INPUT TYPE="HIDDEN" NAME="<%= CommonConstants.HATS_EXISTING_CONN %>" 
VALUE="<%= ExampleIO.getHPubEndChainName()%>" />
<INPUT TYPE="submit" VALUE="Return to HATS application" />
</FORM>

また、「HATS ツール」メニューを使用して 「HATS アプリケーションへの転送の挿入」を行うこともできます。このオプションは、1 つの例外を持つコードを自動的に挿入します。以下の行は含まれません。

<INPUT TYPE="HIDDEN" NAME="<%= CommonConstants.HATS_EXISTING_CONN %>"
       VALUE="<%= IntegrationObjectName.getHPubEndChainName() %>" />

HATS アプリケーションに接続を渡す場合は、JSP を編集して、「FORM NAME=」コード行の直後にコード行を追加する必要があります。

その他の場合 (デフォルト接続をオープンしてから転送アクションを起動する場合や、統合オブジェクトが転送アクションを使用しない場合) は、接続を戻す必要はありません。これらの場合、記載の例から最初の INPUT ステートメントを省略できます。

注:
JSP/統合オブジェクト・ロジックを HATS アプリケーションへの最初の入り口にすることができます。この場合、HATS アプリケーションを駆動し、JSP/統合オブジェクト・ロジックで確立した接続を HATS アプリケーションに渡し、デフォルト接続として使用させるように指定したコードを使用します (接続をデフォルト接続定義から作成した場合)。

マクロを実行

マクロを記録した場合は、そのマクロをドロップダウン・ボックスから選択して実行できます。このマクロは、このイベントが選択されたときに実行を開始します。「マクロを実行」アクションは現行接続でマクロを実行することに注意してください。これに対し、「マクロ・トランザクションを実行」は新規接続を作成してその接続でマクロを実行します。

マクロを実行するには、「アクションの追加」リストから 「マクロを実行」項目を選択し、実行するマクロの名前をドロップダウン・リストから選択します。実行するマクロをこの画面イベントのアクションとして定義した場合は、そのマクロは最後に適用されます。対象の画面を認識するために、必ずきわめて明確な基準を使用し、他の画面ではマクロが実行されないようにします。例えば、ストリング基準を使用する場合は、画面の任意の場所ではなく、正確な場所で検出されなければならないことを指定してください。マクロが終了する画面が、マクロを開始する基準を満たしてはなりません。マクロを記録する場合は、画面イベントによって認識される画面が最終画面にならないようにしてください。認識された画面がマクロの最終画面である場合、ループが作成され、マクロ実行の実行時に画面の強制変更するキーを送信するオプションは実行されません。

通常、変換を適用した後に同じ画面でアクションとしてマクロを実行することはありません。両方のアクションを指定すると、変換が適用され、ユーザーが変換された画面と対話した後のみにマクロが実行されます。マクロの実行は、常に最後のアクションとなります。画面が認識された場合にマクロを実行する場合は、その画面に変換を適用しないでください。その画面に画面イベントを作成する場合は、必ずウィザードの「アクション」ページにある「変換を適用」チェック・ボックスをクリアしてください。マクロがナビゲートする最後のホスト画面で使用する別の画面イベントを作成し、変換を適用して最終画面から派生する Web ページの外観を制御できます。

変換にマクロ・ボタンを挿入して、ユーザーが変換された画面からマクロを実行できるようできます。この場合ユーザーは、変換された画面と対話することも、マクロ・ボタンをクリックして現在のホスト画面でマクロの稼働を開始することもできます。

マクロは、ホスト端末を使用して HATS Toolkit に記録できます。マクロのインポートの詳細については、マクロとホスト端末を参照してください。

マクロ・トランザクションを実行

このアクションを選択すると、指定した接続 (別のホストへ接続でも可) の新規インスタンスの記録済みのマクロを実行できます。「マクロ・トランザクションを実行」 ボタンをクリックした後、「マクロを実行」ドロップダウン・リストから実行するマクロを選択し、使用する接続を「接続時に実行」ドロップダウン・リストから選択します。

注:
指定した接続に接続マクロが定義されている場合、選択したマクロの実行前に、その接続マクロが実行されます。

キーを送信

このアクションは、ホスト画面に指定のキーを送信します。画面上でアクションを適用する場所を選択したら、ホスト画面に送信するキーを選択します。

黒丸付きリストから「PF および PA キー」 または「他のホスト・キー」のいずれかを選択します。その後、選択した項目のドロップダウン・メニューをクリックしてキーを選択します。

選択したキーによってホスト画面が変化したり、アクションが無限ループに入ったりする場合があることに注意してください。

アクション・リストの順序を考慮する場合は、必ず「キーを送信」アクションを最後に実行してください。

切断

「切断」アクションでは、すぐに切断イベントが実行されます。デフォルトでは、切断イベントによって、デフォルトの接続が切断および解放されます。

一時停止

「一時停止」アクションでは、通常処理を続行するまでの時間 (ミリ秒単位) を指定できます。

ポートレットのプレプレゼンテーション

「ポートレットのプレプレゼンテーション (Portlet Prepresentation)」を使用する場合は、「アクション」タブの「ブロック区切り文字を追加」ボタンを使用して、「プレプレゼンテーション開始」区切り文字と「プレプレゼンテーション終了 (End)」区切り文字を追加できます。

このアクションは、HATS 標準ポートレットではサポートされていません。

「プレプレゼンテーション開始」と 「プレプレゼンテーション終了 (End)」を使用して、ポートレット処理のプレプレゼンテーション・フェーズで実行する必要のあるアクションを囲むことができます。ポートレットのメッセージングまたは連携ポートレットをインプリメントする場合は、「ブロック区切り文字を追加」ボタンを使用します。プレプレゼンテーション開始区切り文字を挿入するには「ブロック区切り文字を追加」ボタンを 1 度クリックします。プレプレゼンテーション終了区切り文字を挿入するには、「ブロック区切り文字を追加」を再度クリックします。ブロック区切り文字で囲まれた、実行する必要があるアクションを、リスト内で上下に移動するには、「上へ」ボタンと「下へ」ボタンを使用します。アクションを起動するタイミングに応じて、プレプレゼンテーション・ブロックの場所が決定されます。画面イベントを実行する場合、最初に、または「アクション」リストの先頭でプレプレゼンテーション・アクションを起動できます。画面でユーザーが対話した後にプレプレゼンテーション・アクションを実行する場合、「アクション」リストの下部でイベントを起動します。ポートレットでのブロック区切り文字の使用方法の詳細については、「HATS Web アプリケーション・プログラマーズ・ガイド」を参照してください。

グローバル規則

グローバル規則を使用すると、ホスト入力フィールドのパターン認識と変換が可能になります。また、 グローバル規則では、カスタマイズした画面、およびカスタマイズしていない (デフォルト・レンダリングの) 画面が処理されます。グローバル規則は、プロジェクト・レベルと、画面レベルの両方で定義できます。このタブは、画面レベルのグローバル規則を指定するときに使用します。グローバル規則を定義する方法の詳細については、グローバル規則を参照してください。

画面レベルのグローバル規則を適用すると、画面に対してデフォルトのレンダリングを使用できるだけでなく、画面上の入力フィールドをカスタマイズできます。例えば、画面レベルのグローバル規則で、「指定した領域内で入力フィールドを検索」パターン・タイプを使用すると、ある画面上でカスタマイズする入力フィールドを正確に特定する (例えば、ある特定のテーブル内のデータ) ことができる一方で、その画面に対して引き続きデフォルト・レンダリングを使用できます。

プロジェクト・レベルと画面レベルの両方のグローバル規則が同じ入力フィールドに定義されている場合は、画面レベルの規則が優先されます。

テキスト置換

「テキスト置換」タブにはテーブルが表示されますが、ここでは、置換の対象にする元のホスト画面の保護テキストと、置き換えとして使用するテキスト、HTML コンテンツ  Web のみ 、またはイメージを合わせて指定できます。さらに、テキスト検索で大文字と小文字を区別するかどうか、正規表現サポートを使用するかどうかも表示されます。 「追加」ボタンをクリックして、テキスト置換パラメーターを新規作成します。

選択ウィンドウから置換するテキストを選択するか、「置換」テキスト・ボックスにテキストを入力します。

「大文字と小文字を区別」チェック・ボックスを選択すると、「置換」テキスト・ボックスに入力したテキストに完全に一致するもののみが検索されます。

テキストで置換するには、置換されるテキストを下のウィンドウに入力します。

HTML コード  Web のみ  を入力すると、コードは HATS よって赤で強調表示されるため、コードが有効かどうかが分かります。

「挿入」アイコンをクリックすると、ボタンやリンクを追加できます。「ボタンの挿入」と「リンクの挿入」の設定は、以下のとおりです。

表題
レンダリングされたボタンやリンクに表示するテキスト。

アクション・キー
ボタンやリンクがクリックされたときに送信するホスト AID キー。

スタイル・クラス  Web のみ 
ボタンやリンクの外観を制御する Cascading Stylesheet (CSS) クラス名。ボタンのデフォルト値は、HATSBUTTON です。リンクのデフォルト値は、HATSLINK です。

また、「イメージ」ラジオ・ボタンをクリックしてドロップダウン・リストからイメージを選択するか、「インポート」 ボタンをクリックすることによって、テキストをイメージで置換することもできます。

「正規表現」チェック・ボックスを選択すると、Java の正規表現がテキスト置換アルゴリズムの一部としてサポートされます。正規表現は、ストリング・セットを表す文字のパターンです。正規表現は、パターンの出現の検索と変更に使用できます。例えば、以下のように指定します。

Replace: ([¥.¥-|_¥w]+)@([¥-¥_¥.¥w]+)
With: <a href="mailto:$1@$2" class="HATSLINK">$1@$2</a>

この結果、以下のように置換されるため、ホスト画面上の E メール・アドレスがリンクに変換されます。

Original host screen text: user@company.com
Replacement text: 
<a href="mailto:user@company.com" class="HATSLINK">user@company.com</a>

値のテーブルの右側にあるボタンを使用して、テキスト置換の仕様を追加、変更、または除去できます。テキストは、プロジェクト・レベル、レンダリング項目レベル、変換レベル、およびコンポーネント・レベルで置換できます。

テキスト置換リストを使用する場合、1 回のテキスト置換によって作成されたテキストまたは HTML が、後続のテキスト置換によってさらに置換されることがあります。例えば、ホスト画面上のあるストリングを <img src="yourImage.jpg"> で置換し、後続のテキスト置換で sr を別のストリングで置換すると、src パラメーターが変更されているため、<img> タグは正常に機能しなくなります。この状態を回避するには、テキスト置換項目の順序を変更するか、より具体的な指定を行って、前のストリングが誤って置換されないようにします。

注:
  1. テキスト置換を使用するときは、注意が必要です。ストリングの文字数が異なるテキスト置換を行うと、画面の GUI 表示が変わってしまうことがあります。画面領域の表示に使用されるウィジェットによって、画面の 1 行に収められているテキストが縮小または拡張されたり、次の行に強制改行されたりすることがあります。また、通常は、1 文字しかないストリング、保護フィールドが間に存在するテキストで構成されるストリングなどを置換することは、非効率的です。
  2. デフォルトでは、テキスト置換により、置換前のテキストより長いストリングが切り捨てられます。変換で、元のホスト画面のレイアウトを維持するために、テキストが切り捨てられることがあります。切り捨ては、フィールド・ウィジェット (場合によってはテーブル・ウィジェット) を使用してレンダリングされたテキストにのみ発生します。

    ソース設定の truncateToPreserveLength を追加することにより、短ストリングを長ストリングで置換するテキスト置換を使用可能にすることができます。この設定の値は、true および false です。設定を指定しなかった場合のデフォルト値は true で、プロジェクトに対する影響はありません。false を指定すると、長いテキスト置換が使用可能になります。この設定を使用する場合は、デフォルト・レンダリングを使用してはなりません。デフォルト・レンダリングを使用すると、設定が無視されます。

    truncateToPreserveLength 設定は、プロジェクト・レベル設定です。プロジェクト内のテキスト置換すべてに作用します。この設定を使用するときは、すべてのレンダリングが思ったとおりに表示されること、および位置合わせの問題が発生したとしてもそれが問題でないことを確認してください。

    プロジェクト全体の設定を有効にするには、application.hap ファイルのソース・ビューを開きます。変換のクラスを見つけ、次の例に示す強調表示された設定を追加してください。

    <class name="com.ibm.hats.transform">
       <setting name="truncateToPreserveLength" value="false" />
    </class>
  3. 選択テキスト・ウィンドウは便利ですが、実際には、「置換」フィールドに表示されるテキストが置換されます。テキスト置換を複数の行または無保護フィールドにまたがって適用することはできません。プレビュー・フィールドを使用して、複数のテキスト行を選択および置換することはできません。
  4. テキストとイメージの置換の使用と、リッチ・クライアント・アプリケーションでの特定の SWT ウィジェットの使用とを組み合わせた場合には、これに関連した制限事項が存在します。詳しくは、HATS リッチ・クライアントの考慮事項と制限を参照してください。

次の画面

「次の画面」タブでは、現在表示中の画面の後に表示する次の画面を指定できます。

「追加」ボタンをクリックして、リストに画面を追加します。上矢印ボタンまたは 下矢印ボタンを使用して画面の比較順序を変更したり、「除去」ボタンを使用して画面を除去したりできます。

リスト内で次に表示する画面が一致しない場合、アプリケーションで「アプリケーション・イベント優先順位リストの検索 (Search application event priority list)」または「アプリケーション・イベントの実行 (Execute application event)」を実行できます。

「検索アプリケーション・イベント優先順位リスト」オプションでは、次の画面のプロジェクト設定でイベント優先順位リストが検索されます。これはデフォルトです。「アプリケーション・イベントの実行 (Execute application event)」ドロップダウン・リストでは、リスト内の次の表示画面が一致しない場合に発生させるエラーなどのイベントを選択できます。イベント・リストは、以下のとおりです。

詳しくは、アプリケーション・イベントを参照してください。

次に表示される画面を予測できる場合は、「次の画面」を使用するとパフォーマンスが向上します。

ソース

「ソース」タブでは、se-name.evnt ファイル内のタグと値が表示されます。これらは画面イベント用に提供されているすべての情報です。ここで、se-name は、画面イベントを作成したときに指定した名前です。画面イベント・エディターのほかのタブを変更すると、「ソース」タブに表示されるタグと値もそれに合わせて変更されます。

ソース・ファイル内のタグと値を変更することもできます。その変更は、画面イベント・エディターの適切なタブに反映されます。

使用禁止画面

HATS 接続のオペレーター情報域 (OIA) 状況は、画面が構成済み画面イベントの 1 つに一致しているかどうかを判断するために HATS が使用する画面マッチング基準の 1 つです。 OIA 状況が一致しない場合、HATS は対応する画面イベントとは一致せず、カスタム変換またはアクションではなくデフォルトの変換が表示されます。このセクションでは、入力禁止 (キーボードがロックされている) 画面または OIA 状況が不一致の画面を処理する際に使用できる方法について説明します。

認識基準

デフォルトでは、HATS によって、OIA 状況に関する以下の認識基準がすべての画面イベントに追加されます。

<oia invertmatch="false" optional="false" status="NOTINHIBITED"/>

これは、他のマッチング基準に加えて、OIA 状況は HATS が画面を一致していると評価する NOTINHIBITED でなければならないことを意味します。 OIA 状況が他のものであれば、他の基準が満たされていても、画面は一致していると見なされません。結果として、デフォルトの変換がブラウザーに表示されます。

特定の画面イベントに関して HATS が OIA 状況を無視するようにするには、以下の手順に従って、認識基準を単に NOTINHIBITED から DONTCARE に変更してください。

  1. 「HATS プロジェクト」ビューで、ご使用のプロジェクト、および画面イベント (画面カスタマイズまたは画面組み合わせ) のリストを展開します。
  2. 画面イベントをダブルクリックして、画面イベント・エディターを開始します。
  3. エディターの下部にある「ソース」タブをクリックします。
  4. ストリング status="NOTINHIBITED" を含む行を検索します。NOTINHIBITED を DONTCARE に変更します。
  5. 「ファイル」> 「保存」をクリックするか、または「Ctrl+S」を押すことで保存します。

ホスト画面が実際に使用禁止になっているかロックされている場合、Ctrl+R (ホストのリセット) または エスケープ (ホストのクリア) などの特定のキーまたはキー組み合わせを押して、画面をアンロックするかまたは次の画面に移動してください。

使用禁止画面の自動処理

使用禁止またはロックされている画面を HATS が自動的に認識し処理できるように、そのための特別な画面カスタマイズを作成して、これを実現できます。このためには、以下の手順に従います。

  1. 画面カスタマイズの「画面認識基準」タブで、すべての基準をクリアし除去します。
  2. 画面カスタマイズの「ソース」タブで、invertmatch="true" を持つように OIA 行を変更します。これを行うと、以下のようになります。
    <oia invertmatch="true" optional="false" status="NOTINHIBITED"/>
  3. 画面カスタマイズの「アクション」タブで、OIA 状況をクリアして NOTINHIBITED に復元するアクションを追加します。状況によって、取るべき正しいアクションは異なります。例えば、OIA 状況をクリアして NOTINHIBITED に復元するには、単にホスト・キー Enter (または他のホスト・キー) を送信するだけ十分な場合があります。しかし、他の場合では、ホスト接続を OIA 状況が NOTINHIBITED であった状況に戻すために、カーソル位置を変更するか、一連のホスト・キーを送信するマクロを実行する必要がある可能性があります。
  4. 「HATS プロジェクト設定」エディターで、「イベント」タブを選択し、特別な画面カスタマイズがリストの先頭に来るように「画面イベントの優先順位」リストをソートします。これによって、他の画面イベントとのマッチングを試行する前に、HATS は最初に INHIBITED OIA 状況を使用して画面を検出および処理するようになります。

複数の使用禁止画面の処理

場合によっては、複数の使用禁止またはロックされた画面があり、その条件をクリアするにはそれぞれ異なるアクションが必要である可能性があります。そのため、そのようなケースを処理するために複数の特別な画面カスタマイズを作成し使用する必要がある可能性があります。「ソース」タブの OIA 行の invertmatch を true に変更するのに加えて、「画面認識基準」タブに他の基準を追加し、各画面カスタマイズが固有で、該当するときにのみ起動されるようにする必要がある場合があります。

例えば、ユーザーが保護フィールドにテキストを入力しようとすると、ホスト画面がロックされる可能性があります。この場合はおそらく、表示の保護領域上にカーソルがありますというメッセージが表示されます。この条件をクリアするには、ユーザーは無保護領域にカーソルを移動しなければなりません。これを自動化するために、特別な画面カスタマイズを作成できます。OIA 領域に invertmatch="true" を設定するのに加えて、メッセージ・テキスト 表示の保護領域上にカーソルがあります の検索も行います。一致するものが存在すれば、そのカスタマイズは、カーソルを保護領域から移動し OIA 状況をクリアするマクロを実行するアクションを持つことができます。

同じシステム上で、例えばユーザーが無効なファンクション・キーを押した場合に画面がロックされるという、2 つ目の条件があることがあります。この場合、エラー画面上に 無効なファンクション・キーが押されました のテキストが表示されます。この条件をクリアするには、ユーザーは Enter キーを押す必要がある可能性があります。これを自動化するために、別の特別な画面カスタマイズを作成できます。ここでも OIA 領域に invertmatch="true" を設定しますが、テキスト 無効なファンクション・キーが押されました と突き合わせます。このアクションのため、この画面カスタマイズは Enter キーをホストに送信します。

特定の環境によっては、単に OIA 基準を DONTCARE に設定し、端末エミュレーターを使用して処理するように、ユーザーがその状態を処理できるようにすることによって、使用禁止画面を処理することが、最も容易である場合があります。しかし上記で示したように、1 つ以上の特別な画面カスタマイズを作成すれば、HATS が使用禁止画面を自動的に認識し処理できるようにすることも可能です。

BMS マップ・セットのインポート

HATS では、顧客情報管理システム (CICS®) の基本マッピング・サポート (BMS) マップ・セットから画面キャプチャーを作成できます。BMS マップは、CICS の画面定義ファイルです。各マップでは、画面のすべてまたは一部を定義します。CICS アプリケーションは、通常、1 つ以上のマップを表示して完全な画面イメージを作成します。マップには、静的または動的な区域またはフィールドの両方が含まれます。

BMS マップのソースは、マップ・セットというグループに編成されます。1 つのマップ・セットには、1 つ以上のマップが含まれています。マップ・セットは、ソース形式で存在します。各ソース・ファイルに 1 つのマップ・セットが含まれます。HATS で BMS マップをインポートする場合、マップ・セット・レベルでインポートが発生します。個別のマップをインポートすることはできません。

マップは、最初、ホスト・システムに存在するので、ご使用のローカル・ファイル・システムに配置する (またはローカル・ファイル・システムに表示されるようにする) 必要があります。HATS にインポートする前のマップの拡張子は、.bms です。

まず、ホストからローカル・ファイル・システムに BMS マップ・セットをコピーします。この操作は、HATS の外部で手動で行います。具体的には、ファイルをファイル・システムに物理的にコピーするか、またはネットワーキング・ソフトウェアを使用してファイル・システムをホストに接続します。ファイルは、バイナリー・ファイルとして転送しないでください。ファイルは、ワークステーションでローカルに読み取ることができる必要があります。

  1. 「ファイル」>「インポート」>「HATS」>「HATS への BMS マップ・セット」をクリックして、「インポート」ウィザードを開きます。
  2. リストからインポートする BMS マップ・セット・ファイルとインポートするファイルの宛先を選択します。
  3. プルダウン矢印をクリックして、国別の「ホスト・コード・ページ」を選択します。 これは、ホストで BMS マップを作成したときに使用したコード・ページです。
  4. プルダウン矢印をクリックし、「BMS ファイル・コード・ページ」を選択します。これは、BMS ファイルをワークステーションに転送するときに使用したコード・ページです。
  5. 「警告せずに既存のマップを上書き (Overwrite existing maps without warning)」オプション、および「マップ名を画面キャプチャー名として使用し、マップごとに 1 つの画面キャプチャーを生成」オプションを使用できます。
    注:
    マップ同士を組み合わせて画面を作成する必要がある場合、画面キャプチャーを自動的に作成しない方がよい場合があります。
  6. 「警告せずに既存の画面キャプチャーを上書き」を選択することもできます。
  7. 「完了」をクリックします。

BMS キャプチャー・ファイルは、HATS プロジェクト内の独立した Maps フォルダーに保管されます。デフォルトでは、インポートされたマップがない場合、「HATS プロジェクト」ビューに Maps フォルダーは表示されません。Maps フォルダー内には、各マップ・セットに対する個別のフォルダーが含まれます。各フォルダー内には、各マップに対する別個のファイル (拡張子は .bmc) が含まれます。また、元のソースはファイル・システムに保管され (拡張子は .bms)、関連付けられたマップを含むフォルダー内に表示されます。ソースを編集するには、ファイルをダブルクリックします。ソースを編集して保存すると、マップが自動的に再生成されて上書きされます。ただし、「プロパティー」ビューから変更されたマップを除きます。

「ナビゲーター」ビューで BMS ソース・ファイルを <project>/bmsmaps フォルダーにドラッグして、BMS マップをインポートすることもできます。ファイルは、サブフォルダーではなく、bmsmaps フォルダーに直接格納してください。この方法でマップをインポートしている間にエラーが発生した場合、「問題」ビューにメッセージが表示されます。

注:
ソースは、参照としてだけ保存できます。エディターに表示できる以外、プロジェクトに機能はありません。ソースを表示すると、マップ・セット全体が表示されます。エディター内で表示されている特定のマップの定義が強調表示されることはありません。

BMS マップのインポート後には、「HATS プロジェクト」ビューから実行できる複数のアクションがあります。

画面キャプチャーの作成が完了したら、HATS 画面イベントの作成を開始できます。