画面のセットを定義する XML スクリプトをマクロといいます。各画面には、画面の説明、画面に対して実行するアクション、およびアクションが実行された後で表示される 1 つまたは複数の画面セットが含まれる。
HATS は、ホスト・アプリケーション・プロセスの速度およびカスタマイズを高めるためのマクロ・ベースのカスタマイズをサポートしています。マクロは、次の機能で使用できます。
マクロを使用して、次の機能のいずれかまたはすべてを実行できます。
プロンプト・マクロは、開発者が定数の値、またはグローバル変数から取得した値を提供するために使用することもできます。
HATS Toolkit に記録またはインポートされているマクロは、HATS マクロ・ファイル (.hma) に保存されます。プロジェクト内で定義されているマクロを見るには、HATS Toolkit の 「HATS プロジェクト」ビュー内の 「マクロ」ノードを展開します。
HATS には、HATS マクロの表示と変更に使用できる 3 つの異なるエディターが用意されています。マクロ・エディター、拡張マクロ・エディター、および Visual Macro Editor です。 Visual Macro Editor が HATS マクロのデフォルト・エディターです。マクロ名をダブルクリックすると、Visual Macro Editor が開きます。 Visual Macro Editor の詳細については、「HATS 拡張マクロ・ガイド」の『Visual Macro Editor』の章を参照してください。
マクロ・エディターを開くには、マクロの名前を右クリックして、「アプリケーションから開く」>「マクロ・エディター」を選択します。
拡張マクロ・エディターは、マクロ・エディターの「概要」ページから開きます。拡張マクロ・エディターの詳細については、「HATS 拡張マクロ・ガイド」の『拡張マクロ・エディター (Advanced Macro Editor)』の章を参照してください。
以下のセクションでは、マクロ・エディターの各タブについて説明します。
マクロ・エディターの「概要」タブには、名前、説明、最終変更日時など、マクロに関する一般情報が表示されます。このタブで変更できる項目は、マクロの説明、一時停止時間、タイムアウト、および接続です。
「一時停止時間」は、各アクションの実行後の遅延のミリ秒数です。「タイムアウト」は、マクロを終了するまでに待つミリ秒数です。「接続」では、使用する接続をドロップダウン・メニューから選択できます。
「ホスト端末をオープン」ボタンと 「拡張エディター」ボタンについては、以下で説明します。

ホスト端末を使用してマクロを作成または処理するには、「ホスト端末をオープン」をクリックします。端末が開いたら、ツールバー上のアイコンを使用してマクロを記録および作成します。
「ホスト端末」を使用して、マクロ・ツリー内のノードを右クリックし、「編集」を選択することによって、前に記録したマクロを編集することもできます。編集する画面を選択すると、画面認識基準エディターが起動し、画面を変更できます。画面に入力したデータを編集する場合は、起動したウィンドウで入力データを変更します。「次の画面」ノードを編集すると、次の画面として選択可能な画面のリストが表示されます。リストから、画面に表示する順に選択します。
「ホスト端末」ツールバーには、マクロの実行エラーをデバッグするためのアイコンが 4 つあります。アイコンはマクロをステップごとに実行できるよう設計されています。マクロでは、ステップが 1 つのアクションを実行したり 1 つの画面を認識したりするように定義されています。アイコンは、「ステップイントゥ」、「ステップオーバー」、「ステップ・リターン」、および「再開」です。
各アイコンには、ファンクション・キーが関連付けられています。そのときアクティブなビュー (「マクロ・ナビゲーター」または「ホスト端末」のいずれか) によって、F5、F6、F7、および F8 キーの機能が異なります。例えば、「マクロ・ナビゲーター」がアクティブである場合、F5 を押すと「ステップイントゥ」、F6 を押すと「ステップオーバー」となります。「ホスト端末」がアクティブである場合、F5 または F6 を押すと、ホストに AID キーが送信されます。上記およびその他のマクロ関連アイコンについて詳しくは、マクロ関連アイコンを参照してください。
表 4 に、ホスト端末画面ツールバーに表示されるマクロ・アイコンを示します。
HATS ホスト端末を使用して、HATS Toolkit にマクロを記録することができます。そのためには、HATS ホスト端末画面で、「マクロの記録」アイコンをクリックします。「マクロの記録」ウィザードが表示され、ターゲット・プロジェクトの選択、マクロの名前の指定、マクロの説明の入力、およびマクロの保存場所の確認を行うことができます。「記録中に自動的に画面キャプチャーを作成」オプションにより、マクロの記録中にナビゲートする各画面の画面キャプチャーを自動作成するよう指定できます。こうして作成されたこれらの画面キャプチャーは、後でマクロに変更を加える必要があるときに、 Visual Macro Editor で使用できます。このオプションはデフォルトで選択されています。 これらの項目を指定したら、「完了」をクリックします。
次に、「画面認識基準の定義」ウィンドウが表示されます。HATS では、最初の画面に、明示的に定義された画面認識がなくてはならないためです。これで、HATS ホスト端末画面を使用して、ホスト・アプリケーション内の任意の画面にナビゲートできるようになります。
マクロが HATS ホスト端末内で既に開いている場合、「マクロの記録」アイコンが、新規マクロを記録するか開いているマクロに追加するかを尋ねます。開いているマクロに追加すると、マクロの記録が開始され、現在のマクロにアクションが追加されます。記録を開始するマクロ内の位置は、左側の「マクロ・ナビゲーター」ツリーで選択された内容と、選択されたノードの画面認識基準に現在の端末画面が一致するかどうかによって異なります。以下に具体例を示します。
抽出を挿入するステップまたはプロンプトを追加するステップのみのマクロは作成しないでください。作成すると、ユーザーが値を指定したときにページが変更されず、ユーザーが別のページへ移動することができなくなります。マクロがホストに戻らない場合、タイムアウトになるまで滞留します。
HATS がホスト画面の突き合わせに使用する画面認識基準を設定できます。画面上の入力フィールド数または合計フィールド数、カーソル位置の座標、および、画面上に定義された長方形枠内または画面の任意の場所にあるテキスト・ストリングなどの基準を任意に組み合わせて、ホスト画面を認識させることができます。詳しくは、画面認識基準または開始画面を参照してください。
ユーザーに情報の入力を求めるマクロが必要な場合は、「プロンプト・アクションを追加」をクリックして「プロンプト・アクションを追加」ウィザードを表示します。ここで、プロンプトの名前とデフォルト値を指定できます。パスワードのようなユーザーが入力する情報が、ホスト画面に表示してはならない情報である場合は、「パスワード非表示」チェック・ボックスをクリックします。
このウィザードの「位置」セクションの「行」および「列」フィールドは、ユーザーが入力したプロンプト情報をホスト画面上のどこに配置するかを定義します。マクロの記録を開始する前に、ホスト画面上の特定の場所 (例えばパスワード用のフィールド) にカーソルを置いた場合は、「行」および「列」フィールドにはそのカーソル位置の値が入っています。ウィザードの「マクロ・プロンプトを処理」セクションでは、プロンプトをどのように処理するかを指定できます。次のいずれかのラジオ・ボタンを選択できます。
HATS リッチ・クライアント・プロジェクトの場合、ユーザーに必要な情報の入力を求めるために、カスタム・マクロ・ハンドラーを指定するか、リッチ・クライアント・プロジェクトに定義されたカスタム・マクロ・ハンドラーのリストを参照して選択することができ、さらにユーザーが情報を送信するためのボタンを組み込むことができます。HATS には DefaultMacroHandler という名前のデフォルトのマクロ・ハンドラーが付属しています。「HATS プロジェクト」ビューでこのファイルを見つけるには、プロジェクト名を展開して、「リッチ・クライアント・コンテンツ」>「マクロ・イベント・ハンドラー」の順に展開します。 独自のハンドラーを作成する場合は、ご使用のカスタム・マクロ・ハンドラーの render() メソッド内の createButtonArea() と createButtons() メソッドを呼び出して、必ず HATS ランタイムに制御を戻してください。これらのメソッドは、RcpMacroHandler.render() メソッドのデフォルトのインプリメンテーションで呼び出されます。RcpMacroHandler について詳しくは、HATS インフォメーション・センター (http://publib.boulder.ibm.com/infocenter/hatshelp/v75/index.jsp?topic=/com.ibm.hats.doc/doc/rcpjavadoc/index.html) の『HATS RCP API 参照 (HATS RCP API Reference)』セクションを参照してください。
プロンプトの値が、抽出によって設定されたグローバル変数に基づいていて、promptall が true に設定されている場合、プロンプトの値が取り出されるまで抽出アクションは実行されません。このため、プロンプトで使用されるグローバル変数には値がありません。抽出とプロンプトにグローバル変数を使用する場合は、promptall を false に設定する必要があります。
統合オブジェクトではグローバル変数に直接アクセスしません。代わりに、統合オブジェクト用の入力ページおよび出力ページはグローバル変数の値を取得し、実行前に統合オブジェクトに設定します。統合オブジェクトからアクセスできるのは、共用グローバル変数のみです。
選択を終えたら「OK」をクリックします。
ホスト画面から情報を抽出するマクロが必要な場合は、ホスト画面上の領域を選択し、「抽出アクションを追加」をクリックして「抽出アクションを追加」ウィザードを表示します。 ここでは抽出の名前を指定できます。このウィザードの「位置」セクションの「開始行」、「開始列」、「終了行」、および「終了列」フィールドは、ホスト画面上のどこから情報を抽出するかを定義します。長方形でホスト画面上の領域を指定してから 「抽出アクションを追加」をクリックすると、「位置」セクションのフィールドに、「抽出アクションを追加」ウィザードが表示されたときの値が入ります。
「抽出形式」は、以下のいずれかに設定できます。
抽出されたテキストを 1 行の文字ストリングとして保存することを指定します。このオプションは、統合オブジェクト、グローバル変数、およびマクロ・ハンドラーに対してサポートされます。
抽出されたテキストを複数行のストリングのリストとして保存することを指定します。このオプションは、グローバル変数およびマクロ・ハンドラーに対してサポートされます。統合オブジェクトでは、ストリングのリストは 1 つの連続するストリングとして扱われます。
抽出されたテキストを、縦横に広がりを持つ (行と列がある) ストリングのテーブルとして保存することを指定します。このオプションは、統合オブジェクトおよびマクロ・ハンドラーに対してサポートされます。グローバル変数の場合、テーブルとして抽出されたストリングは 1 つの連続するストリングとなります。
このフィールドを使用して、選択された列の見出しを変更します。
列の展開では、列間で複数の文字を移動します。列を強調表示すると、「左」ボタンは、強調表示した列の左側にある列の各行の最終文字を移動して、強調表示した列の各行の先頭文字にします。「右」ボタンは、強調表示した列の右側にある列の各行から先頭の 1 文字を移動して、強調表示した列の各行の最終文字にします。
列の削除では、列間で複数の文字を移動します。列を強調表示すると、「左」ボタンは、強調表示した列の各行から先頭の 1 文字を移動して、強調表示した列の左側にある列の各行の最終文字にします。「右」ボタンは、強調表示した列の各行から最終の 1 文字を移動して、強調表示した列の右側にある列の各行の先頭文字にします。
このボタンを使用して、強調表示された 2 つの列を単一の列にマージします。強調表示された列の文字は、1 列に結合されます。
このボタンを使用して、強調表示された 1 列を 2 つの別個の列に分割します。強調表示された列の文字は、2 つの新規列間で均等に分割されます。文字数が奇数の場合、左の列が右の列よりも 1 文字多くなります。
DBCS サポートとともにこの機能を使用する場合の考慮事項については、マクロの記録を参照してください。
ウィザードの「マクロ抽出を処理」セクションでは、プロンプトをどのように処理するかを指定できます。次のチェック・ボックスを選択できます。
HATS リッチ・クライアント・プロジェクトの場合、ユーザーに必要な情報の入力を求めるために、カスタム・マクロ・ハンドラーを指定するか、リッチ・クライアント・プロジェクトに定義されたカスタム・マクロ・ハンドラーのリストを参照して選択することができ、さらにユーザーが情報を送信するためのボタンを組み込むことができます。HATS では、DefaultMacroHandler という名前のデフォルトのマクロ・ハンドラーが提供されています。「HATS プロジェクト」ビューでこのファイルを見つけるには、プロジェクト名を展開して、「リッチ・コンテンツ (Rich Content)」>「マクロ・イベント・ハンドラー」の順に展開します。 独自のハンドラーを作成する場合は、ご使用のカスタム・マクロ・ハンドラーの render() メソッド内の createButtonArea() と createButtons() メソッドを呼び出して、必ず HATS ランタイムに制御を戻してください。これらのメソッドは、RcpMacroHandler.render() メソッドのデフォルトのインプリメンテーションで呼び出されます。RcpMacroHandler について詳しくは、HATS インフォメーション・センター (http://publib.boulder.ibm.com/infocenter/hatshelp/v75/index.jsp?topic=/com.ibm.hats.doc/doc/rcpjavadoc/index.html) の『HATS RCP API 参照 (HATS RCP API Reference)』セクションを参照してください。
統合オブジェクトではグローバル変数に直接抽出しません。代わりに、統合オブジェクトの出力ページでは、実行後の統合オブジェクトからデータを取得して、グローバル変数を設定します。統合オブジェクトからアクセスできるのは、共用グローバル変数のみです。
選択を終えたら「OK」をクリックします。
マクロ内でループを記録する場合は、「ループの記録」をクリックしてから、ループが開始された画面に移動します。「次へ」をクリックし、最初の画面の画面認識基準を定義します。「次へ」をクリックして追加の基準を定義するか、 「完了」をクリックしてメインの端末に戻ります。メインの端末で、ループの各サイクルで実行されるアクションを実行し、「次へ」を押します。「固有の画面が認識されたときに終了します」 または「一定の反復回数の後に終了します」を選択してループの終了方法を決定し、後者の場合はその下にループの数を入力します。「次へ」をクリックしてループの最後の画面へ移動し、「完了」を押してループを終了します。
このアイコンでは、端末キーパッドを表示または非表示にすることができます。
「テキスト OIA の表示」 (オペレーター情報域) アイコンを使用すると、端末画面上のカーソルの正確な行と列の位置が示されます。また、入力が禁止されているかいないかも示されます。
サーバーによる変換後、現在のホスト画面がどのような外観になるかを確認するには、「ホスト端末」ウィンドウの上部にある「ホスト画面のプレビュー (Host Screen Preview)」タブをクリックします。プレビュー画面では、現在のホスト画面を Web ページとして表示します。
ホスト画面のプレビューでは、最初に、現在の画面に定義された画面のすべてのカスタマイズを適用します。現在の画面に画面カスタマイズが定義されていない場合、プロジェクト・レベルのテンプレートとデフォルトのレンダリング規則が画面に適用されます。
ホスト画面のプレビューでは、「プロジェクト設定」の「イベント」タブにリストされた画面カスタマイズの順序を適用します。一致する画面認識を検出すると、即座に画面カスタマイズに定義された変換によって変換された画面を表示します。一致するものが見つからない場合、デフォルトの変換が表示されます。
ホスト画面のプレビューは、次の画面のリストに定義された画面のカスタマイズを処理しません。次の画面はホスト画面プレビューで処理されません。詳しくは、次の画面を参照してください。
「概要」タブの「拡張エディター」をクリックすると、HATS マクロ・エディターの拡張機能を起動し、マクロの設定を変更することができます。マクロ・エディター専用のウィンドウが開き、次のタブが表示されます。
マクロ・エディターの拡張エディター機能の詳細については、「HATS 拡張マクロ・ガイド」を参照してください。
マクロ・エディターの「プロンプトおよび抽出」タブには、構成されているマクロ・プロンプトと抽出のリストと、マクロの実行時にそれらがどのように処理されるかが示されます。テーブル内のプロンプトまたは抽出のいずれかを選択し「編集」をクリックすると、そのプロンプトまたは抽出の HATS 固有のプロパティーを編集することができます。
「ソース」タブには、macro-name.hma ファイルでマクロのすべての属性と値に関して使用されるタグが表示されます。macro-name は、マクロの作成またはインポート時にマクロに付けた名前です。プロジェクト・エディターの他のタブで変更を行うと、ソース・ファイルに表示されるタグと属性もそれに合わせて変更されます。ソース・ファイル内でタグおよび属性を変更することもでき、その場合は、マクロ・エディターの該当タブに変更が反映されます。
プロンプトおよび抽出は、記録された順番でマクロ・ソース・ファイルに表示されます。また、エディターでマクロを開くと、カーソルは、マクロ・ファイルの一番上に表示されるのではなく、最後にマクロを保存したときに置かれていた行と同じ行に表示されます。
マクロのエラーは、マクロ・エディター、テキスト・エディター、または XML エディターのいずれを使用している場合にも、「問題」 ビューに要約されます。マクロのソース・コードは、エラーのあるすべての行に、赤い円の中に白の X が付いたマーカーを表示します。
マクロはエラーがある場合でも保存することができ、ユーザーは後で必要に応じてエラーを見つけて修正することができます。ただし、エラーのあるマクロは、実行時またはホスト端末で実行することはできません。
他のプログラム (IBM® WebSphere® Host Publisher や IBM Host On-Demand など) で記録されているマクロをインポートすることもできます。このようなマクロをインポートするには、「ファイル」>「インポート」>「HATS」>「Host Publisher/HOD マクロ」を選択し、「次へ」をクリックして、「Host Publisher/HOD マクロをインポート」ダイアログを表示します。「追加」をクリックし、ファイル・システム上の該当マクロの場所へナビゲートします。
HATS マクロだけでなく、IBM WebSphere Host Publisher マクロや IBM Host On-Demand マクロもエクスポートできます。これらのマクロをエクスポートするには、「ファイル」>「エクスポート」>「HATS」>「HATS マクロ」または「ファイル」>「エクスポート」>「HATS」>「Host Publisher/HOD マクロ」を選択し、「次へ」をクリックします。通常、Host Publisher マクロはディレクトリー・パス ¥hostpub¥Studio¥IntegrationObjects にあります。これらのマクロは、.macro ファイルとしてエクスポートされます。このファイル拡張子は Host Publisher と Host On-Demand の両方で機能しますが、Host On-Demand は .mac ファイルをデフォルトとして使用し、検索します。*.macro または *.* を検索するには、Host On-Demand フィルターを変更する必要があります。
宛先を指定して「エクスポートするマクロ・ファイル」 を選択します。「警告して既存のリソースを上書き (Overwrite existing resources with warning)」チェック・ボックスをオンにすることによって、既存のリソースの上書きを選択できます。
実行したら「完了」をクリックします。
DBCS サポートを使用する場合の考慮事項については、マクロの記録を参照してください。
マクロの実行は、ホスト画面が画面カスタマイズの認識基準に一致した場合に実行するように指定できるアクションの 1 つです。マクロを記録する際は、最終画面が、そのマクロがアクションとして定義されている画面カスタマイズによって認識される画面とは別の画面であることを確認してください。認識された画面がマクロの最終画面である場合は、ループが作成されてしまいます。
マクロに対して非一時画面とともに一時画面を定義できます。ただし、実行時に、一時画面の 1 つが予期せずに認識されることがあります。
次の画面記述子のマクロを比較する場合、非一時画面記述子が最初に比較され、その後一時画面記述子が比較されます。非一時画面記述子の比較開始後に現行画面情報が更新されると、更新された画面情報が一時画面記述子の比較に使用されます。したがって、非一時画面の比較の開始時に画面がロックされ (OIA は入力禁止)、一時画面の比較が開始される前にその他の変更なしでアンロックされると、非一時画面が認識されなくなり、後続の一時画面を認識できる可能性がありますが、これは予期される動作ではありません。
この予期されない動作を回避するために、非一時画面と一時画面の記述子を比較するときに同じ画面情報を使用するかどうかを制御できます。これを行うには、拡張接続設定 screenRecoUseOIASnapshot を追加し、値を true に設定します。拡張接続設定の設定方法については、オプションの拡張接続設定を構成してくださいを参照してください。