HATS イベントは、到達する特定の状態に基づいて、一連のアクションを実行するリソースです。 HATS イベントには、アプリケーション・イベントと画面イベントの 2 種類があります。アプリケーション・イベントの詳細については、アプリケーション・イベントを参照してください。 画面イベントは、特定の画面認識基準と突き合わせることによってホスト画面が認識されると起動する HATS イベントです。画面イベントには、画面カスタマイズと画面組み合わせの 2 種類があります。
画面カスタマイズは、ホスト画面を認識したら一連のアクションを実行するように設計されている HATS 画面イベントです。画面カスタマイズの例としては、画面の認識、ユーザーの GUI への画面の変換、マクロの再生による画面のスキップなどがあります。画面カスタマイズ定義には、画面認識基準のセットと、ホスト画面が画面認識基準に一致した場合に実行するアクションのリストが含まれています。画面レベルのグローバル規則とテキスト置換設定も含まれます。新規の画面カスタマイズを作成するには、「画面カスタマイズの作成」ウィザードを使用してください。
画面組み合わせは、連続した類似のホスト画面から出力データを収集し、そのデータを結合して単一の出力ページ内に表示するように設計されている HATS 画面イベントです。画面組み合わせの例としては、部分的な出力データのみが含まれている画面を認識したり、残りのデータをすべて収集してユーザーに表示するために後続のすべての画面をナビゲートするなどがあります。画面組み合わせ定義には、組み合わせる開始画面と終了画面の画面認識基準のセット、画面間のナビゲート方法、および各画面から収集したデータを認識してレンダリングするために使用するコンポーネントとウィジェットが含まれています。また、画面カスタマイズと同様、実行するアクションのリスト、画面レベルのグローバル規則、およびテキスト置換設定も含まれています。 新規の画面組み合わせを作成するには、「画面組み合わせを作成」ウィザードを使用してください。
HATS プロジェクトで、画面カスタマイズを定義するには、「画面カスタマイズの作成」ウィザードを使用します。画面カスタマイズ・ウィザードを使用する前に、ホスト端末を開いたままにしておくか、画面キャプチャーを用意しておく必要があります。BMS マップは、画面カスタマイズに使用する画面キャプチャーの作成にも使用できます。BMS マップ・セットの詳細については、BMS マップ・セットのインポートを参照してください。
次のいずれかのアクションを実行して、ウィザードにアクセスできます。
ウィザードで使用可能な設定の詳細については、画面イベントの編集を参照してください。
画面カスタマイズを対象に定義した設定は、画面カスタマイズ (.evnt) ファイルに保存されます。このファイルを参照するには、「HATS プロジェクト」ビューの「画面カスタマイズ」フォルダーを展開します。 画面カスタマイズ・ファイルの表示および変更を行う場合は、画面イベント・エディターを使用してください。
HATS プロジェクトで、画面組み合わせを定義するには、「画面組み合わせを作成」ウィザードを使用します。「画面組み合わせを作成」ウィザードを使用する前に、ホスト端末か画面キャプチャーを開いておく必要があります。 BMS マップは、画面組み合わせに使用する画面キャプチャーの作成にも使用できます。 BMS マップ・セットの詳細については、BMS マップ・セットのインポートを参照してください。
次のいずれかのアクションを実行して、ウィザードにアクセスできます。
ウィザードで使用可能な設定の詳細については、画面イベントの編集を参照してください。
画面組み合わせを対象に定義した設定は、画面組み合わせ (.evnt) ファイルに保存されます。このファイルを参照するには、「HATS プロジェクト」ビューの「画面組み合わせ」フォルダーを展開します。 画面組み合わせファイルの表示および変更を行う場合は、画面イベント・エディターを使用してください。
画面イベント・エディターは、画面カスタマイズ .evnt ファイルまたは画面組み合わせ .evnt ファイルの名前をダブルクリックすれば起動できます。以下のセクションでは、画面イベント・エディターの各タブについて説明します。
画面イベント・エディターの「概要」タブには、画面イベントを作成したときに指定したすべての情報が要約されています。このタブには、画面イベントの名前と説明、画面認識基準の作成に使用された画面の名前と画像、実行されるアクションの要約、および画面認識基準の要約が収容されています。画面組み合わせの場合、このタブには、ナビゲーション、コンポーネント、終了画面認識基準設定の要約も収められています。 このタブで、画面イベントの説明を変更したり、画面イベントに関連付ける別の画面を選択したりすることができます。選択した画面は、画面認識基準の変更やアクションの追加など、画面イベントに変更を加えるときに使用されます。
画面カスタマイズ・イベントの編集時には、「画面認識基準」タブが表示されます。 画面組み合わせイベントの編集時には、「開始画面」タブが表示されます。 いずれの場合にも、タブには、画面イベントを起動するホスト画面に一致するように設定した画面認識基準が表示されます。基準を組み合わせてホスト画面を認識させることができます。基準には、画面上のフィールドまたは入力フィールドの総数、カーソル位置の座標、および画面上の定義済み長方形の内部または画面上の任意の場所にあるテキスト・ストリングなどが含まれます。このタブで、画面認識基準を追加、編集、または削除できます。
DBCS サポートを使用する場合の考慮事項については、画面認識基準/開始画面を参照してください。
このオプションが表示されるのは、画面組み合わせイベントの「開始画面」タブの場合に限られます。 別の画面キャプチャーを選択して画面組み合わせの開始画面と関連付けるには、「変更」ボタンをクリックします。
画面の「フィールドの総数」、画面の「入力フィールドの数」、またはこれら両方を画面認識基準として使用できます。「フィールドの総数」設定には、入力フィールド、保護テキスト・フィールド、および隠しフィールドが含まれます。これらは、このタブに表示される最初の 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 コンポーネントおよびウィジェットの使用の詳細については、ホスト・コンポーネントを挿入を参照してください。
「領域の変更」ボタンをクリックすると、画面キャプチャーの領域と、コンポーネントによってみなされる画面の領域を変更できます。
ポートレット以外のプロジェクトでは、以下の設定を使用すると、画面組み合わせの結果がユーザーに対して初めて表示される時刻を、画面組み合わせが完了する時刻と関連させて制御することもできます。
「ナビゲーション」タブは、画面組み合わせイベントの場合にのみ表示されます。このタブには、画面組み合わせの開始画面から中間画面を経由して終了画面までナビゲートするために必要なコマンドが表示されます。 「追加」、「編集」、 「除去」の各ボタンを使用して、「上へ移動」および「下へ移動」の 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 プリファレンスの使用を参照してください。
「次へ」をクリックし、適切なラジオ・ボタンをクリックしてデータがストリングであるかグローバル変数であるかを選択します。ストリングを挿入するには、提供された入力フィールドにテキストを入力します。グローバル変数を挿入するには、既存のグローバル変数の名前をドロップダウン・リストから選択するか、グローバル変数の名前を入力します。異なるアプリケーションからの共用グローバル変数を使用する場合は、名前をフィールドに入力する必要があります。
グローバル変数の値に索引が付いている (ストリングのリストが含まれる) 場合は、「拡張」をクリックします。ラジオ・ボタンのいずれかをクリックして、指定した場所にすべてのストリングを並べて挿入するか、または画面の長方形領域に個別の行としてストリングを挿入するかを選択する必要があります。
「共用」チェック・ボックスを選択すると、グローバル変数が共用されるようになります。
グローバル変数の詳細については、グローバル変数との対話を参照してください。
プロジェクト内の他のオブジェクトのほか、.ear の他のプロジェクトで使用するグローバル変数を設定できます。グローバル変数を設定する際、「名前」フィールドに名前を指定するか、ドロップダウン・リストから既存のグローバル変数名を選択できます。既存の索引付きグローバル変数を選択した場合、「拡張」をクリックして、設定値の処理方法を指定する必要があります。以下のオプションを使用できます。
指定の索引を使用する 2 つのオプションでは、「索引」フィールドに索引番号を入力する必要があります。
選択したオプションに基づいて変数値を設定する方法の例については、「グローバル変数を抽出」アクションを参照してください。
グローバル変数を固定値に設定する場合は、入力フィールドに値を入力します。
グローバル変数を計算値に設定する場合は、使用するオペランドおよび計算オペレーションを指定します。オペランドは、フィールドに固定値として入力するか、または既存のグローバル変数値を計算に使用できます。既存の索引付きグローバル値を使用し、使用する変数の索引をオペランドとして指定する場合は、「拡張」をクリックします。「索引」フィールドに索引の数を入力します。
「共用」チェック・ボックスを選択すると、グローバル変数が共用されるようになります。
グローバル変数の詳細については、グローバル変数との対話を参照してください。
このアクションを使用して、1 つ以上のグローバル変数を除去します。1 つのローカルまたは共用グローバル変数、すべてのローカル・グローバル変数、すべての共用グローバル変数、またはすべてのローカルおよび共用グローバル変数を除去できます。「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 エディターを使用してプロパティーを除去できます。
このアクションは、「変換」ビューの変換領域に Web ページまたは SWT コンポジットを表示する場合に使用します。Web ページを表示する場合は、Web ページの URL (Uniform Resource Locator) アドレスを「URL」フィールドに指定します。 SWT コンポジットを表示する場合は、そのクラス名を「コンポジット・クラス」フィールドに入力するか、「参照」ボタンを使用して、リッチ・クライアント・プロジェクト内から SWT コンポジットを選択します。 Web ページまたは SWT コンポジットは、テンプレートのリストから選択したテンプレートに囲まれて表示されます。 Web ページまたは SWT コンポジットが読み込まれたら、ユーザーはいずれかの「続行」ボタンをクリックして、HATS アプリケーションに戻る必要があります。
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 に転送」アクションにより、変換指向 HATS Web アプリケーションから 1 つ以上のチェーン統合オブジェクトを起動する JSP に制御を渡すことができます。これにより、作成済みの統合オブジェクトを使用できます。統合オブジェクトは既存の接続またはバックグラウンド接続を使用できます。
このアクションは、HATS Web および HATS 標準ポートレット・プロジェクトでサポートされていますが、HATS IBM® ポートレット・プロジェクトではサポートされていません。
転送アクションをイベントに追加するには、以下のパラメーターを指定する必要があります。
<%@ taglib uri="http://java.sun.com/portlet" prefix="portletAPI" %> <portletAPI:defineObjects/>
URL への転送により、JSP/統合オブジェクト・ロジックが使用する接続を複数の方法で管理できます。例えば、次のようになります。
ExampleIO.setHPubLinkKey ((String)request.getAttribute(CommonConstants.HPUB_LINK_KEY));
接続がチェーンの最初の統合オブジェクトによって確立されると、チェーンの最初の統合オブジェクトによって作成されたリンクを使用して保存されます。
両方のシナリオで、後続の統合オブジェクトは同じリンクを再使用する必要があります。そのリンクは getHPubLinkKey() メソッドを呼び出す最初の統合オブジェクトから取り出すことができます。必要に応じて、リンクを要求オブジェクトのパラメーターとして、後続の JSP に受け渡すことができます。これは非表示入力パラメーターを、以下に示す形式に追加することによって実行できます。
<INPUT NAME="<%= CommonConstants.HPUB_LINK_KEY %>"
VALUE="<%= ExampleIO.getHPubLinkKey() %> "TYPE="hidden">後続の JSP は、processRequest() メソッドを呼び出す前にキーを取り出しそれを IO に設定するために、以下のステートメントを使用します。
ExampleIO_2.setHPubLinkKey ((String)request.getParameter(CommonConstants.HPUB_LINK_KEY));
転送アクションを使用する場合は、統合オブジェクトの実行後に制御が自動的に 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 ステートメントを省略できます。
マクロを記録した場合は、そのマクロをドロップダウン・ボックスから選択して実行できます。このマクロは、このイベントが選択されたときに実行を開始します。「マクロを実行」アクションは現行接続でマクロを実行することに注意してください。これに対し、「マクロ・トランザクションを実行」は新規接続を作成してその接続でマクロを実行します。
マクロを実行するには、「アクションの追加」リストから 「マクロを実行」項目を選択し、実行するマクロの名前をドロップダウン・リストから選択します。実行するマクロをこの画面イベントのアクションとして定義した場合は、そのマクロは最後に適用されます。対象の画面を認識するために、必ずきわめて明確な基準を使用し、他の画面ではマクロが実行されないようにします。例えば、ストリング基準を使用する場合は、画面の任意の場所ではなく、正確な場所で検出されなければならないことを指定してください。マクロが終了する画面が、マクロを開始する基準を満たしてはなりません。マクロを記録する場合は、画面イベントによって認識される画面が最終画面にならないようにしてください。認識された画面がマクロの最終画面である場合、ループが作成され、マクロ実行の実行時に画面の強制変更するキーを送信するオプションは実行されません。
通常、変換を適用した後に同じ画面でアクションとしてマクロを実行することはありません。両方のアクションを指定すると、変換が適用され、ユーザーが変換された画面と対話した後のみにマクロが実行されます。マクロの実行は、常に最後のアクションとなります。画面が認識された場合にマクロを実行する場合は、その画面に変換を適用しないでください。その画面に画面イベントを作成する場合は、必ずウィザードの「アクション」ページにある「変換を適用」チェック・ボックスをクリアしてください。マクロがナビゲートする最後のホスト画面で使用する別の画面イベントを作成し、変換を適用して最終画面から派生する Web ページの外観を制御できます。
変換にマクロ・ボタンを挿入して、ユーザーが変換された画面からマクロを実行できるようできます。この場合ユーザーは、変換された画面と対話することも、マクロ・ボタンをクリックして現在のホスト画面でマクロの稼働を開始することもできます。
マクロは、ホスト端末を使用して HATS Toolkit に記録できます。マクロのインポートの詳細については、マクロとホスト端末を参照してください。
このアクションを選択すると、指定した接続 (別のホストへ接続でも可) の新規インスタンスの記録済みのマクロを実行できます。「マクロ・トランザクションを実行」 ボタンをクリックした後、「マクロを実行」ドロップダウン・リストから実行するマクロを選択し、使用する接続を「接続時に実行」ドロップダウン・リストから選択します。
このアクションは、ホスト画面に指定のキーを送信します。画面上でアクションを適用する場所を選択したら、ホスト画面に送信するキーを選択します。
黒丸付きリストから「PF および PA キー」 または「他のホスト・キー」のいずれかを選択します。その後、選択した項目のドロップダウン・メニューをクリックしてキーを選択します。
選択したキーによってホスト画面が変化したり、アクションが無限ループに入ったりする場合があることに注意してください。
アクション・リストの順序を考慮する場合は、必ず「キーを送信」アクションを最後に実行してください。
「切断」アクションでは、すぐに切断イベントが実行されます。デフォルトでは、切断イベントによって、デフォルトの接続が切断および解放されます。
「一時停止」アクションでは、通常処理を続行するまでの時間 (ミリ秒単位) を指定できます。
「ポートレットのプレプレゼンテーション (Portlet Prepresentation)」を使用する場合は、「アクション」タブの「ブロック区切り文字を追加」ボタンを使用して、「プレプレゼンテーション開始」区切り文字と「プレプレゼンテーション終了 (End)」区切り文字を追加できます。
このアクションは、HATS 標準ポートレットではサポートされていません。
「プレプレゼンテーション開始」と 「プレプレゼンテーション終了 (End)」を使用して、ポートレット処理のプレプレゼンテーション・フェーズで実行する必要のあるアクションを囲むことができます。ポートレットのメッセージングまたは連携ポートレットをインプリメントする場合は、「ブロック区切り文字を追加」ボタンを使用します。プレプレゼンテーション開始区切り文字を挿入するには「ブロック区切り文字を追加」ボタンを 1 度クリックします。プレプレゼンテーション終了区切り文字を挿入するには、「ブロック区切り文字を追加」を再度クリックします。ブロック区切り文字で囲まれた、実行する必要があるアクションを、リスト内で上下に移動するには、「上へ」ボタンと「下へ」ボタンを使用します。アクションを起動するタイミングに応じて、プレプレゼンテーション・ブロックの場所が決定されます。画面イベントを実行する場合、最初に、または「アクション」リストの先頭でプレプレゼンテーション・アクションを起動できます。画面でユーザーが対話した後にプレプレゼンテーション・アクションを実行する場合、「アクション」リストの下部でイベントを起動します。ポートレットでのブロック区切り文字の使用方法の詳細については、「HATS Web アプリケーション・プログラマーズ・ガイド」を参照してください。
グローバル規則を使用すると、ホスト入力フィールドのパターン認識と変換が可能になります。また、 グローバル規則では、カスタマイズした画面、およびカスタマイズしていない (デフォルト・レンダリングの) 画面が処理されます。グローバル規則は、プロジェクト・レベルと、画面レベルの両方で定義できます。このタブは、画面レベルのグローバル規則を指定するときに使用します。グローバル規則を定義する方法の詳細については、グローバル規則を参照してください。
画面レベルのグローバル規則を適用すると、画面に対してデフォルトのレンダリングを使用できるだけでなく、画面上の入力フィールドをカスタマイズできます。例えば、画面レベルのグローバル規則で、「指定した領域内で入力フィールドを検索」パターン・タイプを使用すると、ある画面上でカスタマイズする入力フィールドを正確に特定する (例えば、ある特定のテーブル内のデータ) ことができる一方で、その画面に対して引き続きデフォルト・レンダリングを使用できます。
プロジェクト・レベルと画面レベルの両方のグローバル規則が同じ入力フィールドに定義されている場合は、画面レベルの規則が優先されます。
「テキスト置換」タブにはテーブルが表示されますが、ここでは、置換の対象にする元のホスト画面の保護テキストと、置き換えとして使用するテキスト、HTML コンテンツ Web のみ 、またはイメージを合わせて指定できます。さらに、テキスト検索で大文字と小文字を区別するかどうか、正規表現サポートを使用するかどうかも表示されます。 「追加」ボタンをクリックして、テキスト置換パラメーターを新規作成します。
選択ウィンドウから置換するテキストを選択するか、「置換」テキスト・ボックスにテキストを入力します。
「大文字と小文字を区別」チェック・ボックスを選択すると、「置換」テキスト・ボックスに入力したテキストに完全に一致するもののみが検索されます。
テキストで置換するには、置換されるテキストを下のウィンドウに入力します。
HTML コード Web のみ を入力すると、コードは HATS よって赤で強調表示されるため、コードが有効かどうかが分かります。
「挿入」アイコンをクリックすると、ボタンやリンクを追加できます。「ボタンの挿入」と「リンクの挿入」の設定は、以下のとおりです。
また、「イメージ」ラジオ・ボタンをクリックしてドロップダウン・リストからイメージを選択するか、「インポート」 ボタンをクリックすることによって、テキストをイメージで置換することもできます。
「正規表現」チェック・ボックスを選択すると、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> タグは正常に機能しなくなります。この状態を回避するには、テキスト置換項目の順序を変更するか、より具体的な指定を行って、前のストリングが誤って置換されないようにします。
ソース設定の truncateToPreserveLength を追加することにより、短ストリングを長ストリングで置換するテキスト置換を使用可能にすることができます。この設定の値は、true および false です。設定を指定しなかった場合のデフォルト値は true で、プロジェクトに対する影響はありません。false を指定すると、長いテキスト置換が使用可能になります。この設定を使用する場合は、デフォルト・レンダリングを使用してはなりません。デフォルト・レンダリングを使用すると、設定が無視されます。
truncateToPreserveLength 設定は、プロジェクト・レベル設定です。プロジェクト内のテキスト置換すべてに作用します。この設定を使用するときは、すべてのレンダリングが思ったとおりに表示されること、および位置合わせの問題が発生したとしてもそれが問題でないことを確認してください。
プロジェクト全体の設定を有効にするには、application.hap ファイルのソース・ビューを開きます。変換のクラスを見つけ、次の例に示す強調表示された設定を追加してください。
<class name="com.ibm.hats.transform"> <setting name="truncateToPreserveLength" value="false" /> </class>
「次の画面」タブでは、現在表示中の画面の後に表示する次の画面を指定できます。
「追加」ボタンをクリックして、リストに画面を追加します。上矢印ボタンまたは 下矢印ボタンを使用して画面の比較順序を変更したり、「除去」ボタンを使用して画面を除去したりできます。
リスト内で次に表示する画面が一致しない場合、アプリケーションで「アプリケーション・イベント優先順位リストの検索 (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 に変更してください。
ホスト画面が実際に使用禁止になっているかロックされている場合、Ctrl+R (ホストのリセット) または エスケープ (ホストのクリア) などの特定のキーまたはキー組み合わせを押して、画面をアンロックするかまたは次の画面に移動してください。
使用禁止またはロックされている画面を HATS が自動的に認識し処理できるように、そのための特別な画面カスタマイズを作成して、これを実現できます。このためには、以下の手順に従います。
<oia invertmatch="true" optional="false" status="NOTINHIBITED"/>
場合によっては、複数の使用禁止またはロックされた画面があり、その条件をクリアするにはそれぞれ異なるアクションが必要である可能性があります。そのため、そのようなケースを処理するために複数の特別な画面カスタマイズを作成し使用する必要がある可能性があります。「ソース」タブの OIA 行の invertmatch を true に変更するのに加えて、「画面認識基準」タブに他の基準を追加し、各画面カスタマイズが固有で、該当するときにのみ起動されるようにする必要がある場合があります。
例えば、ユーザーが保護フィールドにテキストを入力しようとすると、ホスト画面がロックされる可能性があります。この場合はおそらく、表示の保護領域上にカーソルがありますというメッセージが表示されます。この条件をクリアするには、ユーザーは無保護領域にカーソルを移動しなければなりません。これを自動化するために、特別な画面カスタマイズを作成できます。OIA 領域に invertmatch="true" を設定するのに加えて、メッセージ・テキスト 表示の保護領域上にカーソルがあります の検索も行います。一致するものが存在すれば、そのカスタマイズは、カーソルを保護領域から移動し OIA 状況をクリアするマクロを実行するアクションを持つことができます。
同じシステム上で、例えばユーザーが無効なファンクション・キーを押した場合に画面がロックされるという、2 つ目の条件があることがあります。この場合、エラー画面上に 無効なファンクション・キーが押されました のテキストが表示されます。この条件をクリアするには、ユーザーは Enter キーを押す必要がある可能性があります。これを自動化するために、別の特別な画面カスタマイズを作成できます。ここでも OIA 領域に invertmatch="true" を設定しますが、テキスト 無効なファンクション・キーが押されました と突き合わせます。このアクションのため、この画面カスタマイズは Enter キーをホストに送信します。
特定の環境によっては、単に OIA 基準を DONTCARE に設定し、端末エミュレーターを使用して処理するように、ユーザーがその状態を処理できるようにすることによって、使用禁止画面を処理することが、最も容易である場合があります。しかし上記で示したように、1 つ以上の特別な画面カスタマイズを作成すれば、HATS が使用禁止画面を自動的に認識し処理できるようにすることも可能です。
HATS では、顧客情報管理システム (CICS®) の基本マッピング・サポート (BMS) マップ・セットから画面キャプチャーを作成できます。BMS マップは、CICS の画面定義ファイルです。各マップでは、画面のすべてまたは一部を定義します。CICS アプリケーションは、通常、1 つ以上のマップを表示して完全な画面イメージを作成します。マップには、静的または動的な区域またはフィールドの両方が含まれます。
BMS マップのソースは、マップ・セットというグループに編成されます。1 つのマップ・セットには、1 つ以上のマップが含まれています。マップ・セットは、ソース形式で存在します。各ソース・ファイルに 1 つのマップ・セットが含まれます。HATS で BMS マップをインポートする場合、マップ・セット・レベルでインポートが発生します。個別のマップをインポートすることはできません。
マップは、最初、ホスト・システムに存在するので、ご使用のローカル・ファイル・システムに配置する (またはローカル・ファイル・システムに表示されるようにする) 必要があります。HATS にインポートする前のマップの拡張子は、.bms です。
まず、ホストからローカル・ファイル・システムに BMS マップ・セットをコピーします。この操作は、HATS の外部で手動で行います。具体的には、ファイルをファイル・システムに物理的にコピーするか、またはネットワーキング・ソフトウェアを使用してファイル・システムをホストに接続します。ファイルは、バイナリー・ファイルとして転送しないでください。ファイルは、ワークステーションでローカルに読み取ることができる必要があります。
BMS キャプチャー・ファイルは、HATS プロジェクト内の独立した Maps フォルダーに保管されます。デフォルトでは、インポートされたマップがない場合、「HATS プロジェクト」ビューに Maps フォルダーは表示されません。Maps フォルダー内には、各マップ・セットに対する個別のフォルダーが含まれます。各フォルダー内には、各マップに対する別個のファイル (拡張子は .bmc) が含まれます。また、元のソースはファイル・システムに保管され (拡張子は .bms)、関連付けられたマップを含むフォルダー内に表示されます。ソースを編集するには、ファイルをダブルクリックします。ソースを編集して保存すると、マップが自動的に再生成されて上書きされます。ただし、「プロパティー」ビューから変更されたマップを除きます。
「ナビゲーター」ビューで BMS ソース・ファイルを <project>/bmsmaps フォルダーにドラッグして、BMS マップをインポートすることもできます。ファイルは、サブフォルダーではなく、bmsmaps フォルダーに直接格納してください。この方法でマップをインポートしている間にエラーが発生した場合、「問題」ビューにメッセージが表示されます。
BMS マップのインポート後には、「HATS プロジェクト」ビューから実行できる複数のアクションがあります。
画面キャプチャーの作成が完了したら、HATS 画面イベントの作成を開始できます。