マクロとホスト端末

画面のセットを定義する XML スクリプトをマクロといいます。各画面には、画面の説明、画面に対して実行するアクション、およびアクションが実行された後で表示される 1 つまたは複数の画面セットが含まれる。

HATS は、ホスト・アプリケーション・プロセスの速度およびカスタマイズを高めるためのマクロ・ベースのカスタマイズをサポートしています。マクロは、次の機能で使用できます。

マクロを使用して、次の機能のいずれかまたはすべてを実行できます。

画面スキップ
画面スキップ・マクロは、途中の画面を表示せずに、1 つの画面から別の画面へとユーザーを導くナビゲーション・マクロです。

プロンプト
プロンプト・マクロには、ホスト・セッション中にユーザーに入力を要求するステップが含まれています。ユーザー・リストからプロンプトを設定することもできます。例えば、プロンプト・マクロを使用して、ホスト・アプリケーションにログインする前に、ユーザーにユーザー ID とパスワードの入力を要求することができます。
注:
ユーザー・リスト・プロンプトは、接続マクロでのみ使用できます。

プロンプト・マクロは、開発者が定数の値、またはグローバル変数から取得した値を提供するために使用することもできます。

抽出
抽出マクロには、ホスト画面情報をストリング、ストリングのリスト、またはテーブルとして抽出するイベントが含まれています。例えば、抽出マクロを使用して、ディレクトリー・タイプのホスト・アプリケーションに接続し、そのディレクトリー内での検索の結果を抽出することができます。

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)』の章を参照してください。

注:
マクロ・エディターおよび拡張マクロ・エディターのサポートは、HATS V7.5.1 では非推奨になりました。現在はサポートが継続されていますが、IBM は製品の後続リリースでこれらの機能を除去する権利を持っています。 代わって Visual Macro Editor がサポートされています。

マクロ・エディター

以下のセクションでは、マクロ・エディターの各タブについて説明します。

概要

マクロ・エディターの「概要」タブには、名前、説明、最終変更日時など、マクロに関する一般情報が表示されます。このタブで変更できる項目は、マクロの説明、一時停止時間、タイムアウト、および接続です。

「一時停止時間」は、各アクションの実行後の遅延のミリ秒数です。「タイムアウト」は、マクロを終了するまでに待つミリ秒数です。「接続」では、使用する接続をドロップダウン・メニューから選択できます。

「ホスト端末をオープン」ボタンと 「拡張エディター」ボタンについては、以下で説明します。

図 63. HATS マクロの記録
ホスト端末を使用したマクロの記録

ホスト端末をオープン

ホスト端末を使用してマクロを作成または処理するには、「ホスト端末をオープン」をクリックします。端末が開いたら、ツールバー上のアイコンを使用してマクロを記録および作成します。

ホスト端末

「ホスト端末」を使用して、マクロ・ツリー内のノードを右クリックし、「編集」を選択することによって、前に記録したマクロを編集することもできます。編集する画面を選択すると、画面認識基準エディターが起動し、画面を変更できます。画面に入力したデータを編集する場合は、起動したウィンドウで入力データを変更します。「次の画面」ノードを編集すると、次の画面として選択可能な画面のリストが表示されます。リストから、画面に表示する順に選択します。

「ホスト端末」ツールバーには、マクロの実行エラーをデバッグするためのアイコンが 4 つあります。アイコンはマクロをステップごとに実行できるよう設計されています。マクロでは、ステップが 1 つのアクションを実行したり 1 つの画面を認識したりするように定義されています。アイコンは、「ステップイントゥ」、「ステップオーバー」、「ステップ・リターン」、および「再開」です。

各アイコンには、ファンクション・キーが関連付けられています。そのときアクティブなビュー (「マクロ・ナビゲーター」または「ホスト端末」のいずれか) によって、F5、F6、F7、および F8 キーの機能が異なります。例えば、「マクロ・ナビゲーター」がアクティブである場合、F5 を押すと「ステップイントゥ」、F6 を押すと「ステップオーバー」となります。「ホスト端末」がアクティブである場合、F5 または F6 を押すと、ホストに AID キーが送信されます。上記およびその他のマクロ関連アイコンについて詳しくは、マクロ関連アイコンを参照してください。

注:

注:
  1. HATS では、一定の画面に画面認識基準を定義する必要があります。対象となる画面を以下に示します。
  2. ホスト端末では、以下のキーの組み合わせを使用することにより、切り取り、コピー、および貼り付け機能が提供されます。

表 4 に、ホスト端末画面ツールバーに表示されるマクロ・アイコンを示します。

表 4. マクロ・アイコン
アイコン 説明
マクロをオープン
マクロをオープンします。ドロップダウン・リストからマクロを選択します。
マクロを実行
マクロを再生します。ドロップダウン・リストからマクロを選択します。
マクロの記録
マクロの記録を開始します。
マクロを停止
マクロの記録を停止します。
マクロの保存
記録されたマクロを保存します。
ステップイントゥ
デバッグ目的でマクロにステップイントゥします (F5)。
ステップオーバー
デバッグ目的でマクロをステップオーバーします (F6)。
ステップ・リターン
デバッグ目的でマクロをステップ・リターンします (F7)。
再開
マクロの実行を再開します (F8)。
マクロ画面認識基準の定義
マクロ画面の画面認識基準を定義します。
プロンプト・アクションを追加
現在のマクロにプロンプト・アクションを追加します (マクロの記録時にのみ使用可能)。
抽出アクションを追加
現在のマクロに抽出アクションを追加します (マクロの記録時にのみ使用可能)。
ループ・マクロの記録
現在のマクロにループを記録します (マクロの記録時にのみ使用可能)。
すべてのフィールドにプロンプト・アクションを追加
画面上のすべてのフィールドのため、現在のマクロにプロンプト・アクションを追加します (マクロの記録時にのみ使用可能)。
すべてのフィールドに抽出アクションを追加
画面上のすべてのフィールドのため、現在のマクロに抽出アクションを追加します (マクロの記録時にのみ使用可能)。
キーパッドの表示/非表示
ホスト端末ウィンドウのキーパッドを表示または非表示にします。
テキスト OIA
テキスト・ベースのオペレーター情報域 (OIA) を表示または非表示にします。
マクロ関連アイコン

マクロの記録

HATS ホスト端末を使用して、HATS Toolkit にマクロを記録することができます。そのためには、HATS ホスト端末画面で、「マクロの記録」アイコンをクリックします。「マクロの記録」ウィザードが表示され、ターゲット・プロジェクトの選択、マクロの名前の指定、マクロの説明の入力、およびマクロの保存場所の確認を行うことができます。「記録中に自動的に画面キャプチャーを作成」オプションにより、マクロの記録中にナビゲートする各画面の画面キャプチャーを自動作成するよう指定できます。こうして作成されたこれらの画面キャプチャーは、後でマクロに変更を加える必要があるときに、 Visual Macro Editor で使用できます。このオプションはデフォルトで選択されています。 これらの項目を指定したら、「完了」をクリックします。

次に、「画面認識基準の定義」ウィンドウが表示されます。HATS では、最初の画面に、明示的に定義された画面認識がなくてはならないためです。これで、HATS ホスト端末画面を使用して、ホスト・アプリケーション内の任意の画面にナビゲートできるようになります。

マクロが HATS ホスト端末内で既に開いている場合、「マクロの記録」アイコンが、新規マクロを記録するか開いているマクロに追加するかを尋ねます。開いているマクロに追加すると、マクロの記録が開始され、現在のマクロにアクションが追加されます。記録を開始するマクロ内の位置は、左側の「マクロ・ナビゲーター」ツリーで選択された内容と、選択されたノードの画面認識基準に現在の端末画面が一致するかどうかによって異なります。以下に具体例を示します。

抽出を挿入するステップまたはプロンプトを追加するステップのみのマクロは作成しないでください。作成すると、ユーザーが値を指定したときにページが変更されず、ユーザーが別のページへ移動することができなくなります。マクロがホストに戻らない場合、タイムアウトになるまで滞留します。

注:
マクロから統合オブジェクトを作成する場合、以下の要件に従ってマクロを命名してください。
  • マクロの名前には、英字、数字、または下線文字のみを使用できます。
  • 名前の最初の文字を数字にすることはできません。
  • 2 バイト (全角) 文字は使用できません。
マクロを停止
マクロの記録を終了したら、「マクロを停止」アイコンをクリックします。
マクロの保存
マクロの記録を停止したら、「マクロを保存」アイコンをクリックしてマクロを保存する必要があります。
ステップイントゥ (Step Into) (F5)
「ステップイントゥ (Step Into) (F5)」アイコンをクリックすると、画面から、組み込まれた最初のアクションに入り、アクションを 1 つずつ実行できます。キーボードで F5 キーを使用しても、同じ機能が実行できます。これは、デバッグの目的で使用します。
ステップオーバー (Step Over) (F6)
「ステップオーバー (Step Over) (F6)」をクリックすると、画面から画面に (間にあるアクションをすべて実行しながら) 移動できます。キーボードで F6 キーを使用しても、同じ機能が実行できます。これは、デバッグの目的で使用します。
ステップ・リターン (Step Return) (F7)
「ステップ・リターン (Step Return) (F7)」をクリックすると、画面の下のアクションの実行を終了し、次の画面に移動します。キーボードで F7 キーを使用しても、同じ機能が実行できます。これは、デバッグの目的で使用します。
再開 (Resume) (F8)
マクロの実行を再開するには、「再開 (F8)」アイコンをクリックするか、キーボードで F8 キーを押します。現在、マクロを実行している場合、これによって残りのマクロをすべて実行できます。
画面認識基準の定義

HATS がホスト画面の突き合わせに使用する画面認識基準を設定できます。画面上の入力フィールド数または合計フィールド数、カーソル位置の座標、および、画面上に定義された長方形枠内または画面の任意の場所にあるテキスト・ストリングなどの基準を任意に組み合わせて、ホスト画面を認識させることができます。詳しくは、画面認識基準または開始画面を参照してください。

プロンプト・アクションを追加

ユーザーに情報の入力を求めるマクロが必要な場合は、「プロンプト・アクションを追加」をクリックして「プロンプト・アクションを追加」ウィザードを表示します。ここで、プロンプトの名前とデフォルト値を指定できます。パスワードのようなユーザーが入力する情報が、ホスト画面に表示してはならない情報である場合は、「パスワード非表示」チェック・ボックスをクリックします。

注:
プロンプトに対して指定するデフォルト値は、暗号化されずにマクロ・ファイルに保管されます。マクロ・エディターを使用してプロンプトを編集する場合、デフォルト値は平文で表示されます。したがって、プロンプトを使用してパスワードを指定することは適切ですが、セキュリティー上の理由から、パスワードのデフォルト値は指定しないでください。

このウィザードの「位置」セクションの「行」および「列」フィールドは、ユーザーが入力したプロンプト情報をホスト画面上のどこに配置するかを定義します。マクロの記録を開始する前に、ホスト画面上の特定の場所 (例えばパスワード用のフィールド) にカーソルを置いた場合は、「行」および「列」フィールドにはそのカーソル位置の値が入っています。ウィザードの「マクロ・プロンプトを処理」セクションでは、プロンプトをどのように処理するかを指定できます。次のいずれかのラジオ・ボタンを選択できます。

ハンドラーを表示
HATS Web プロジェクトの場合、ユーザーに必要な情報の入力を求めるための .jsp ファイルを選択し、ユーザーが情報を送信するためのボタンを組み込むことができます。HATS には default.jsp という名前のデフォルトのマクロ・ハンドラーが付属しています。このファイルを見つけるには、HATS Toolkit の「HATS プロジェクト」ビューをクリックし、プロジェクト名を展開して、「Web コンテンツ」>「マクロ・イベント・ハンドラー」の順に展開します。独自のハンドラーを作成する場合は、必ず HATS ランタイムに制御を戻してください。
注:
  1. 統合オブジェクトでは、選択された .jsp ハンドラーを無視します。代わりに、統合オブジェクト用の入力ページが作成され、値の入力を求めるプロンプトが入力ページ内に配置されます。生成された出力ページでは、統合オブジェクトが実行される前に、入力ページから渡された値を統合オブジェクトにコピーします。
  2. マクロがテキスト平面以外の平面から抽出する場合、「ハンドラーを表示」オプションは使用不可です。
注:

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 に設定する必要があります。

統合オブジェクトではグローバル変数に直接アクセスしません。代わりに、統合オブジェクト用の入力ページおよび出力ページはグローバル変数の値を取得し、実行前に統合オブジェクトに設定します。統合オブジェクトからアクセスできるのは、共用グローバル変数のみです。

プロンプトをユーザー・リストのプロパティーに設定
ユーザー・リストにアクセスするプロンプトが必要な場合は、ドロップダウン・リストから「ユーザー・プロファイル」を選択します。ユーザー・プロファイルは、userid と password を 「ユーザー・リスト・プロパティー」として使用するかを決定するキーになります。詳しくは、ユーザー・リストを参照してください。
注:
ユーザー・リスト・プロンプトは、接続マクロでのみ使用できます。

Web 高速ログオンの使用
Web 高速ログオンを使用するように HATS アプリケーションを設定してある場合は、「プロンプト・タイプ」ドロップダウン・リストでプロンプト・タイプをユーザー ID またはパスワードとして入力し、「アプリケーション ID」フィールドにアプリケーション ID を入力します。
注:
「プロンプト・タイプ」には、正しい値が事前に埋められます。

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

抽出アクションを追加

ホスト画面から情報を抽出するマクロが必要な場合は、ホスト画面上の領域を選択し、「抽出アクションを追加」をクリックして「抽出アクションを追加」ウィザードを表示します。 ここでは抽出の名前を指定できます。このウィザードの「位置」セクションの「開始行」、「開始列」、「終了行」、および「終了列」フィールドは、ホスト画面上のどこから情報を抽出するかを定義します。長方形でホスト画面上の領域を指定してから 「抽出アクションを追加」をクリックすると、「位置」セクションのフィールドに、「抽出アクションを追加」ウィザードが表示されたときの値が入ります。

「抽出形式」は、以下のいずれかに設定できます。

ウィザードの「マクロ抽出を処理」セクションでは、プロンプトをどのように処理するかを指定できます。次のチェック・ボックスを選択できます。

ハンドラーを表示
HATS Web アプリケーションの場合、抽出された情報をユーザーに表示するための .jsp ファイルを選択できます。HATS には、default.jsp という名前のデフォルトのマクロ・ハンドラーが組み込まれています。「HATS プロジェクト」ビューでこのファイルを見つけるには、プロジェクト名を展開して、「Web コンテンツ」>「マクロ・イベント・ハンドラー」の順に展開します。独自のハンドラーを作成する場合は、必ず HATS ランタイムに制御を戻してください。
注:
統合オブジェクトではこのオプションを使用しません。出力ページでは、代わりに、統合オブジェクトから抽出されたデータを取得して表示します。

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)』セクションを参照してください。

グローバル変数として保存
「名前」フィールドにグローバル変数の名前を入力するか、ドロップダウン・メニューを使用して既存の変数を選択することができます。「名前」フィールドで既存のグローバル変数を選択した場合は、次のいずれかのラジオ・ボタンを選択して、その既存の変数をどのように処理するのかを指定する必要があります。
  • この新しい値で既存の値を上書き
  • 特定の索引から開始して既存の値をこの新しい値で上書き
  • この新しい値を既存の値の末尾に追加
  • 特定の索引でこの新しい値を既存の値に挿入
「共用」チェック・ボックスを選択すると、この変数を共用にするかどうかも指定できます。
注:
値を抽出し、抽出によって設定されたグローバル変数にその値を割り当て、グローバル変数の値をプロンプトに使用する場合は、promptall を false に設定する必要があります。promptall が true に設定されていると、プロンプトの値が取り出されるまで抽出アクションは実行されません。このため、プロンプトで使用されるグローバル変数には値がありません。

統合オブジェクトではグローバル変数に直接抽出しません。代わりに、統合オブジェクトの出力ページでは、実行後の統合オブジェクトからデータを取得して、グローバル変数を設定します。統合オブジェクトからアクセスできるのは、共用グローバル変数のみです。

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

ループの記録

マクロ内でループを記録する場合は、「ループの記録」をクリックしてから、ループが開始された画面に移動します。「次へ」をクリックし、最初の画面の画面認識基準を定義します。「次へ」をクリックして追加の基準を定義するか、 「完了」をクリックしてメインの端末に戻ります。メインの端末で、ループの各サイクルで実行されるアクションを実行し、「次へ」を押します。「固有の画面が認識されたときに終了します」 または「一定の反復回数の後に終了します」を選択してループの終了方法を決定し、後者の場合はその下にループの数を入力します。「次へ」をクリックしてループの最後の画面へ移動し、「完了」を押してループを終了します。

注:
ループの画面を開始および終了するための画面認識基準は非常に重要です。開始画面と終了画面がほとんど同じ場合もあります。これらの画面を 1 つずつ注意深く区別する必要があります。

すべてのフィールドにプロンプト・アクションを追加
このアイコンを選択すると、「グローバル変数からすべてのフィールドを挿入」 ウィンドウが開きます。そこで、ドロップダウン・リストから 「格納済み画面名」を選択します。「画面キャプチャーを作成」 チェック・ボックスをオンにして画面キャプチャーを作成することもできます。「共用」チェック・ボックスを選択すると、共用リストからグローバル変数が取得されます。
注:
  1. プロンプトに対して指定するデフォルト値は、暗号化されずにマクロ・ファイルに保管されます。ホスト端末のマクロ・エディターまたは拡張マクロ・エディターでプロンプトを編集する場合、デフォルト値は平文で表示されます。したがって、プロンプトを使用してパスワードを指定することは適切ですが、セキュリティー上の理由から、パスワードのデフォルト値は指定しないでください。
  2. 統合オブジェクトにこのオプションを使用すると、HATS によって、定義されたグローバル変数それぞれの統合オブジェクトにフィールドが追加されます。グローバル変数の値を設定するコードを記述し、実行前の統合オブジェクトにコピーする必要があります。これは、統合オブジェクトを実行する .jsp ページで実行できます。詳しくは、統合オブジェクト・プロパティーの挿入を参照してください。統合オブジェクトからアクセスできるのは、共用グローバル変数のみです。

すべてのフィールドに抽出アクションを追加
このアイコンを選択すると、「グローバル変数からすべてのフィールドを抽出 (Extract All Fields from Global Variables)」ウィンドウが開きます。そこで、ドロップダウン・リストから 「格納済み画面名」を選択します。これは、すべてのフィールド用に作成されるグローバル変数の接頭部として使用されます。保護フィールドのテキストを実行時に取得する場合は、「全フィールド」オプションを選択します。保護フィールドのテキストを変換 JSP 内で静的にする場合は、「入力フィールド」オプションを選択します。「共用」チェック・ボックスを選択すると、共用リストからグローバル変数が取得されます。
注:
統合オブジェクトにこのオプションを使用すると、HATS によって、定義されたグローバル変数それぞれの統合オブジェクトにフィールドが追加されます。実行後の統合オブジェクトから共用グローバル変数にデータをコピーするコードを記述する必要があります。これは、統合オブジェクトを実行する .jsp ページで実行できます。詳しくは、統合オブジェクト・プロパティーの挿入を参照してください。統合オブジェクトからアクセスできるのは、共用グローバル変数のみです。

キーパッドの表示/非表示

このアイコンでは、端末キーパッドを表示または非表示にすることができます。

テキスト OIA の表示

「テキスト 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 マクロをインポート」ダイアログを表示します。「追加」をクリックし、ファイル・システム上の該当マクロの場所へナビゲートします。

注:
固定反復ループ付きの Host Publisher マクロは、同一画面を継続的に認識し、その都度異なるアクションを実行します。HATS では、1 つの画面カスタマイズにより、2 度目に同じ画面を認識し、1 度目に認識したときとは異なるアクションを行うようにすることはできません。したがって、固定反復ループ付きの Host Publisher マクロを使用しようとすると、プロジェクトが無限ループに入ってしまうことがあります。固定反復ループ付きの Host Publisher マクロかどうかは、そのマクロのソース・コードを見れば分かります。この種のマクロには、ID 属性が HPubFixedIterationLoop である customreco タグと、ID 属性が HPubIncrementLoop である custom タグが含まれています。

マクロのエクスポート

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 に設定します。拡張接続設定の設定方法については、オプションの拡張接続設定を構成してくださいを参照してください。