Visual Macro Editor

Visual Macro Editor (VME) により、HATS マクロを視覚的に開発できます。VME は、HATS ホスト端末、基本マクロ・エディター、および拡張マクロ・エディターの多くの機能を結合し、マクロのオフライン開発を可能にします。また、マクロ間でのフローのコピーを許可するとともに、新規画面を追加するためのドラッグ・アンド・ドロップをサポートします。

VME は HATS マクロのデフォルト・エディターです。

マクロ・エディターは従来どおり、マクロを右クリックして、「オープン先を指定 > マクロ・エディター」を選択することにより、開くことができます。拡張マクロ・エディターは従来どおり、マクロ・エディターの「概要」ページから開くことができます。また、「プロンプトおよび抽出」もマクロ・エディターから編集できます。

注:
HATS V7.5.1 ではマクロ・エディターおよび 拡張マクロ・エディターのサポートは推奨されていません。現在までサポートされていましたが、 IBM は、これ以降の製品リリースで この機能を削除することができます。このサポートは Visual Macro Editor により置き換えられます。

新規マクロの作成

ホスト端末の使用に加え、VME を使用すると、「新規マクロ」ウィザードにより、新規マクロを作成できます。

HATS パースペクティブで、以下の手順のいずれかを使用して、「新規マクロ」ウィザードを開始します。

ウィザードには以下の操作を実行できるパネルが 1 つ含まれています。

エディターの使用

VME は HATS マクロのデフォルト・エディターです。 マクロ・オブジェクト (.hma ファイル) をダブルクリックすると、VME が開きます。

VME は次のパーツから構成されています。

  1. 設計タブ
  2. パレット・ビュー
  3. 統合端末
  4. ソース・タブ
図 49. Visual Macro Editor のパーツ
Visual Macro Editor のパーツ

設計タブ

設計タブ (すなわち、キャンバス) が、VME の主な作業領域です。マクロ・オブジェクト (マクロ画面、アクション、次画面接続) がグラフィカルに表示され、各オブジェクトの変更およびグローバル・マクロ・プロパティーの変更を行うことができます。

図 50. Visual Macro Editor の設計タブ
Visual Macro Editor の設計タブ

オブジェクトのポップアップ・メニュー (オブジェクトを右クリックします) を使用することにより、オブジェクトごとに、さまざまなアクションが使用可能になります。すべてのアクションは、ポップアップ・メニューまたはメニュー・バーの「編集」メニューから「元に戻す」を選択することにより、元に戻すことができます。すべてのアクションは、ポップアップ・メニューまたは「編集」メニューから「やり直し」を選択することにより、やり直すことができます。マクロは、保存してしまうと、変更を元に戻すことはできません。ソース・タブで変更を行うと、設計タブで行ったそれ以前のアクションは元に戻すことはできません。設計タブで行われた変更はソース・タブに反映され、その逆も同様です。

「マクロ」メニュー

以下のアクションはマクロのポップアップ・メニューで使用可能になります (白いマクロ・キャンバスを右クリックします)。

保存
マクロをファイルに保存します。「元に戻す」アクションと「やり直し」アクションが無効になります。
イメージとしてコピー
マクロのイメージ全体をシステムのクリップボードにコピーします。この機能はマクロのイメージを電子メールまたは設計文書に貼り付けるのに役立ちます。
貼り付け
画面コピーまたは切り取り後のみに使用可能になります。
レイアウトのリセット
マクロ画面を、次の画面間の相互接続回線の数を最小化するよう試行することにより、リセットします。エントリー画面は上部に配置されます。終了画面は下部に配置されます。デフォルトでは、レイアウトは画面が統合端末を使用して追加されたときリセットされます。HATS の以前のバージョンで作成されたマクロのレイアウトは、マクロが最初に VME で開かれたときに自動的に設定されます (同じアルゴリズムが使用されます)。
プロパティー
マクロ・レベルの設定の編集を許可します。

「画面」メニュー

以下のアクションを、画面のポップアップ・メニューから実行できます (マクロの画面オブジェクトを右クリック)。

切り取り
マクロ画面を削除およびコピーします。詳しくは、画面の切り取り、削除、コピー、貼り付けを参照してください。
コピー
マクロ画面をコピーし、同じマクロまたは別のマクロに貼り付けを許可します。詳しくは、画面の切り取り、削除、コピー、貼り付けを参照してください。
貼り付け
画面コピーまたは切り取り後のみに使用可能になります。
削除
マクロからマクロ画面を削除します。詳しくは、画面の切り取り、削除、コピー、貼り付けを参照してください。
名前変更
マクロ画面の名前変更を許可します。複数の画面が選択されている場合は使用不可になります。
プロパティー
マクロの画面レベルの設定の編集を許可します。複数の画面が選択されている場合は使用不可になります。

「アクション」メニュー

以下のアクションを、画面アクションのポップアップ・メニューから実行できます (画面アクションを右クリック)。

編集
画面アクションの編集を許可します。アクションが 1 つ選択されているときのみ使用可能になります。 詳しくは、アクションの追加と編集を参照してください。
除去
マクロ画面からアクションを除去します。
上に移動
画面アクションのリスト内のアクションを上に移動します。最初のアクションに対しては使用不可になります。
下に移動
画面アクションのリスト内のアクションを下に移動します。最後のアクションに対しては使用不可になります。

「次の画面接続」メニュー

以下のアクションを、次の画面接続のポップアップ・メニューから実行できます (次の画面接続オブジェクトを右クリック)。

削除
マクロから次の画面接続を削除します。
再配列
次の画面接続に対して、同じ画面から発生する他の次の画面接続が存在する場合に、使用可能になります。複数の次の画面が選択されている場合は使用不可になります。詳しくは、次の画面接続の再配列と変更を参照してください。

パレット・ビュー

パレット・ビューを使用して、以下の操作ができます。

図 51. Visual Macro Editor のパレット・ビュー
Visual Macro Editor のパレット・ビュー

統合端末

統合端末のツールバーにより以下のアクションが許可されます。

接続
ホストに接続します。
切断
ホストから切断します。
画面の追加
統合端末から画面を追加するを参照してください。
マクロの実行
マクロの実行を参照してください。
マクロの停止
マクロの実行を参照してください。
ホスト・キーパッド
ホスト・キーパッド・プルダウンを使用して、ホストと対話します。
注:
統合端末でホスト・アプリケーションをナビゲートする場合、 F12 キーは IBM® Rational® Software Delivery Platform (Rational SDP) により中断され、フォーカスは VME の 設計ペインに移動されます。F12 キーがホスト・アプリケーションに 送信されることはありません。この問題を回避するため、および 他のホスト・キーが必要な場合は、ホスト・キーパッド・プルダウンを ツールバーから使用します。
図 52. Visual Macro Editor の統合端末
Visual Macro Editor の統合端末

ソース・タブ

ソース・タブでマクロの XML ソースの変更が使用可能になります。これは、カスタム画面認識基準の追加などの拡張編集で必要です。

VME では、Host On-Demand <comment> タグを使用して、キャンバス上のマクロ画面の位置や関連する画面キャプチャーのような情報を保持します。

<comment> タグは、開発者がコメントを画面に追加するために使用することもできます。コメントを追加する方法は他に、形式「<!- ここにコメントを記述 ->」を使用する方法があります。前から存在する開発者のコメントを失うのを回避するために、VME は、<comment> タグ内で検出した、VME が認識しない (例えば、visualinfo のようなキーワードをまったく含まない)テキストを、<!- -> 形式を使用して画面のコメントに変換します。

マクロに構文エラーがある場合は、マクロを保存するときにエラー・マーカーが表示されます。マーカーはソース内および問題ビュー内に表示されます。ソース・エラーの場合はマクロ・キャンバスは表示されず、代わりにエラー・メッセージが表示されます。この場合は、ソース・タブに切り替え、エラーを訂正します。

マクロの操作

マクロのプロパティーの編集

すべてのマクロ・レベルの設定は、マクロ・プロパティーのパネルに含まれています。 マクロ・レベルのプロパティーを編集するには、マクロ・キャンバスをダブルクリックするか右クリックして、「プロパティー」を選択します。

「プロパティー」パネルには、「一般」タブと「変数およびタイプ」タブが含まれます。

「一般」タブ

「一般」タブは、以下のマクロ・プロパティーの表示と変更を許可します。

名前
マクロ名 (表示のみ)。
説明
マクロの説明。オプション。
作成者
マクロの作成者。オプション。
作成日
マクロが作成された日時。オプション。
アクション間の一時停止
マクロ再生エンジンがマクロ画面のアクションの実行後次の実行までの間待機する時間 (ミリ秒単位)。
画面間のタイムアウト
マクロ再生エンジンが次の画面が表示されるのを待つ時間 (ミリ秒単位)。
マクロの開始時にすべてのプロンプトを処理
マクロ開始時に、マクロのすべてのプロンプトに関して、ユーザーにプロンプトを出すかどうかを指定します。
接続
プロジェクト内で使用する接続名。単一の接続を持つ HATS プロジェクトの場合は、接続は通常 main という名前です。 この値が、IO の作成時に生成される IO にハードコーディングされ、使用する接続を選択するのに実行時に使用されるために、この設定は、マクロが統合オブジェクト (IO) で使用される場合、重要です。
マクロを開くときに端末を自動的に接続
マクロを開いたときに統合端末を自動的に接続するかどうかを指定します。

「変数およびタイプ」タブ

「変数およびタイプ」タブは、マクロ変数とユーザー定義 (インポート済み) タイプを定義するのを許可します。

「変数および演算式の サポート可能」チェック・ボックスは、デフォルトではクリアされています。 一度のみ選択でき、その後、使用不可になります。このチェック・ボックスが選択されていると、マクロは拡張マクロ形式に変換されます。この操作は元に戻せないため、警告メッセージが発行されます。

「はい」をクリックして、警告メッセージをクリアすると、変数とユーザー定義のタイプのテーブルが使用可能になり、テーブルに対して項目の「追加」、「編集」、「除去」が可能になります。

VME では、変数名をドル記号 ($) の間に含める必要はありません。エディターにより、ドル記号 ($) は、マクロ・ソース内では変数名の前後に追加され、変数名を表示するときは除去されます。

詳しくは、データ・タイプ、演算子、および式および 変数とインポートした Java クラスを参照してください。

マクロの実行

統合端末の「マクロの実行」ボタンはマクロのテストを許可します。マクロが端末で再生されているときは、そのパスがキャンバス内に強調表示されます。マクロは、キャンバス上で選択されている現行の画面とは関係なく、常に最初から開始されます。

画面の操作

マクロ画面のプロパティーの編集

マクロ画面のプロパティーを編集するには、マクロ・キャンバス内のオブジェクトをダブルクリックするか右クリックして、「プロパティー」を選択します。

画面プロパティーのパネルには、「一般」タブ、「画面認識」タブ、およびアクション・タブが含まれます。

「一般」タブ

「一般」タブは以下のプロパティーの変更を許可します。

名前
マクロ画面名
画面キャプチャー
画面キャプチャーがマクロ画面に関連付けられている場合は、画面キャプチャー領域にプレビューが表示されます。画面キャプチャーがマクロ画面に関連付けられていない場合は、画面キャプチャー領域にメッセージが表示されます。

「参照」ボタンを使用すると、新規画面キャプチャーを選択でき、「クリア」ボタンを使用すると、画面キャプチャーに対する関連付けを除去できます。詳しくは、マクロ画面を画面キャプチャーに関連付けるを参照してください。

エントリー画面
マクロが開始できる画面を指定します。
終了
マクロが終了できる画面を指定します。
一時画面
任意の時点で表示される可能性がある予測不可能な画面を指定します。

「画面認識」タブ

「画面認識」タブは、画面キャプチャーがマクロ画面と関連付けられている場合にのみ使用可能になります。マクロ機能の画面記述について詳しくは、画面記述を参照してください。

アクション・タブ

アクション・タブによって、画面が認識されたときに実行するようアクションを構成できます。

「上へ」ボタンと「下へ」ボタンを使用して、「追加」、「編集」、「除去」、およびアクションの順序の変更ができます。詳しくは、アクションの追加と編集を参照してください。

マクロ画面の追加

画面キャプチャーをドラッグして画面を追加する

任意のプロジェクトから画面キャプチャーをドラッグすることにより、新規画面をキャンバスに追加できます。

マクロを含むプロジェクトとは異なるプロジェクトからドラッグすると、画面キャプチャー・ファイルをターゲット・プロジェクトにインポートするかどうかを選択するようプロンプトが表示されます。「はい」をクリックすると、ファイルが (マクロ固有のフォルダーではなく) プロジェクトのメイン画面キャプチャー・フォルダーにコピーされ、キャンバス上の新規マクロ画面と関連付けられます。「いいえ」をクリックすると、ファイルはインポートされず、画面キャプチャーはキャンバス上の新規マクロ画面に関連付けられません。

デフォルトの認識基準が定義されている場合は (デフォルト画面認識基準を参照)、その基準が新規画面認識基準に適用され、選択した画面キャプチャーに合わせて調整されます。

新規画面をダブルクリックすることによって完全に画面を構成でき、パレット上の「次の画面接続」ツールを使用してマクロ内の他の画面にそれをワイヤー接続できます。

統合端末から画面を追加する

統合端末の「画面の追加」ボタンは、端末の現行画面をマクロに追加し、適切に構成することを許可します。

「画面の追加」ウィザードを使用して、以下の操作ができます。

パレットから画面を追加する

パレットの「画面」ツールは、新規画面をマクロに追加することを許可します。

画面を追加するには、パレットの「画面」をクリックして、それからキャンバス上をクリックします。この操作により、統合端末から画面を追加するで説明されているように、「画面の追加」ウィザードが開始します。ウィザードにより、画面の構成を許可される前に、マクロ画面を画面キャプチャーに関連付けるで説明されているように、「画面キャプチャー」パネルを使用して画面キャプチャーを選択するよう強制されます。

マクロ画面を画面キャプチャーに関連付ける

画面プロパティーのパネルの「一般」タブにある「参照」ボタン (マクロ画面のプロパティーの編集を参照) は、プロジェクトから画面キャプチャーを選択してマクロ画面に関連付けるのに使用されます。「画面キャプチャー」パネルに、プロジェクトのすべての画面キャプチャー (画面キャプチャー・マクロのフォルダーの中または外にあります) のプレビューが表示されます。

「画面キャプチャー」パネルは、ユーザーが画面をパレットから追加したときにも表示されます。

画面のプレビュー

マウスをキャンバス上の画面の上に置くと、画面に関連付けられた画面キャプチャーのプレビューが表示されます (存在する場合)。

デフォルト画面認識基準

パレットまたは統合端末から「画面の追加」ウィザードを使用して画面をマクロに追加する場合は、その画面認識基準を、パレットまたは統合端末から、あるいは画面キャプチャーのドラッグからマクロに追加される、すべての画面のデフォルト認識基準として保存するオプションがあります。このオプションを指定するには、「画面認識基準」パネルの「次回のために基準を記憶」チェック・ボックスを選択します。

この機能は多くの画面で同じ認識基準を共用するときに役立ちます。 例えば、すべての画面の左上隅に画面を一意的に識別する 5 文字の名前またはコードがある場合、デフォルトの認識基準を構成して、マクロに記録または追加された新規画面のすべてで、画面のその領域のストリング認識を使用するようにできます。この方法では画面ごとに認識基準を構成する必要がなくなるため、時間を節約できます。

保存されるデフォルトの認識基準は、プロジェクト全体で 1 つのみです。この基準がプロジェクト内のすべてのマクロに適用されます。

デフォルトの認識基準は、「次回のために基準を記憶」チェック・ボックスを選択した状態で定義された最新の画面認識基準によりオーバーライドされます。

デフォルトの認識基準が定義されていると、「画面の追加」ウィザードが開始されるたびに適用され、さらに新規画面に関連付けられた画面キャプチャーに合わせて調整されます。

画面の切り取り、削除、コピー、貼り付け

1 つ以上の画面を切り取りまたはコピーして、同じマクロまたは他のマクロに貼り付けることができます。この操作は元に戻すことができます。

1 つ以上の画面を選択し、「切り取り」または「削除」のいずれかを実行すると、選択した画面と送信および受信の次の画面接続のすべてがマクロのキャンバスから除去されます。この操作により、除去されなかった画面を開始点とした、次の画面接続の再配列が強制される場合があります。以下の例で、CelDialCommunications 画面には DisplayProgramMessages 画面からの接続と MainMenu 画面への接続があります。また、SignOn 画面からの次の画面接続の順序では 2 番目でもあります。

図 53. 画面の削除の例 - 切り取りまたは削除前
画面の削除の例 - 切り取りまたは削除前

CelDialCommunications 画面を切り取りまたは削除した後、その画面に対して出入りするすべての次の画面接続が除去され、SignOn 画面からの次の画面接続の順序で、MainMenu 画面が (3 番目ではなく) 2 番目になります。

図 54. 画面の削除の例 - 切り取りまたは削除後
画面の削除の例 - 切り取りまたは削除後

「コピー」または「切り取り」の後、「 貼り付け 」が実行されると、操作中は、内部的な次の画面接続 (他の選択した画面への次の画面接続) が保持されます。以下の例で、SignOn、DisplayProgramMessages、および MainMenu 画面はコピーするために選択されています。

図 55. 画面コピーの例
画面コピーの例

コピーした画面を同じマクロのキャンバスに貼り付けて戻すと、選択した 3 つの画面の間のすべての次の画面接続もコピーされることに注意してください。MainMenu 画面から CelDialCommunications 画面への次の画面接続のみがコピーされません。

図 56. 画面の貼り付けの例
画面の貼り付けの例

拡張マクロ形式のマクロから、または拡張マクロ形式のマクロへ 1 つ以上の画面を貼り付ける場合は、多少の検討を必要とします。

アクションの操作

アクションの追加と編集

マクロ画面のプロパティーからアクションを追加および編集する

アクションは、マクロ画面のプロパティーのアクション・タブからマクロ画面に追加できます (マクロ画面のプロパティーの編集を参照)。「アクションの追加」ウィザードに、マクロ画面への追加および編集が可能なアクションのリストが表示されます。

図 57. Visual Macro Editor のアクション
Visual Macro Editor のアクション

パレットからアクションを画面に追加する

パレットの「アクション」ツールは、新規アクションをマクロ画面に追加するのを許可します。

アクションを追加するには、パレット内のアクションをクリックして、そのアクションを追加するマクロ画面をクリックします。

アクションのプロパティーを編集できるように、選択したアクション・タイプに適用できるパネルが表示されます。

アクションの非表示および表示

画面アクションは、画面図形の右上角にあるトグルをクリックすることにより、非表示にしたり、表示することができます。

図 58. 画面アクションを非表示にする
画面アクションを非表示にする

画面が表示が許されているアクション数よりも多いアクションを持つ場合 (VME の設定の操作を参照) は、「nnn アクションが続く」と読み取れる行が表示されます。

図 59. 画面アクションの表示
画面アクションの表示

アクション

次のセクションで、VME を使用して追加および編集が可能なすべてのアクションについて説明をします。マクロ・アクションおよび各アクションについて詳しくは、マクロ・アクションを参照してください。

カスタム・アクション

カスタム・アクションは、Java™ プログラムをマクロ・アクションとして呼び出し、必要に応じてプログラムに引数を受け渡すことを許可します。

指定できるフィールドは以下のとおりです。

ID
実行する Java プログラムを識別する任意のストリング。
引数
オプション。Java プログラムに受け渡す引数。

詳しくは、<custom> エレメントを参照してください。

Evaluate (If) アクション

Evaluate (If) アクションは、if ステートメントまたは if-else ステートメントの機能を提供します。

条件
「条件」フィールドに、マクロ・ランタイムに評価させる条件式を指定します。条件式には論理演算子と条件演算子を指定でき、 また演算式、即時値、変数、および Java メソッドの呼び出しを含む 項を指定できます。 詳しくは、条件演算子と論理演算子および式を参照してください。
If True
このタブをクリックし、「追加」をクリックして、「条件」が true の場合に実行するアクションを追加します。
If False
このタブをクリックし、「追加」をクリックして、「条件」が false の場合に実行するアクションを追加します。

アクションを「追加」「編集」、「除去」「上へ」移動、または「下へ」移動し、それぞれの場合に対して実行できます。

注:

「If True」および「If False」条件に対して多くのアクションが定義されている場合でも、「条件の評価 (Evaluate condition)」のみがマクロ・キャンバス上の画面オブジェクトのアクションとしてリストされます。

詳しくは、条件アクション (<if> エレメントおよび <else> エレメント)を参照してください。

抽出アクション

抽出アクションは、ホスト端末からデータを抽出し、 オプションでそのデータを変数に格納します。このアクションは非常に有用で、アプリケーション・データの読み取り用にマクロ・オブジェクトが提供する基本的な方法です (ツールキットのプログラミング API の使用に代わるものです)。

名前
抽出名を指定します。

同じ名前の抽出が既に存在する場合は、警告メッセージが表示され、続行すると既存の抽出の設定がオーバーライドされることが通知されます。

「領域」セクションを使用して抽出するホスト画面の領域を指定します。

開始行、開始列、終了行、終了列
抽出するホスト画面の領域の行座標と列座標を指定します。マウスを使用してホスト画面の領域をマークすると、これらのフィールドに値が塗りつぶされます。

「抽出形式」セクションを使用して、抽出データの形式を指定します。 テキスト平面からの抽出データは、 選択された抽出形式をベースに単一ストリングまたはストリングのリストに 格納されて戻されます。他 (テキスト以外) の平面からの抽出データは、 選択された抽出形式をベースに文字配列の形式で 戻されます。

この領域を 1 つのストリングとして抽出
テキスト平面から抽出する場合、 抽出したテキストを文字が横に並んだ単一のストリングとして 保存することを指定します。このオプションは、統合オブジェクト、マクロ・ハンドラー、 グローバル変数、およびマクロ変数でサポートされます。

他 (テキスト以外) の平面からの抽出の場合、抽出したデータを 2 次元の文字配列形式で 単一オブジェクトとしてグローバル変数に保存することを 指定します。このオプションは、 グローバル変数でのみサポートされます。

この領域をストリングのリストとして抽出
テキスト平面から抽出する場合、抽出したテキストを ストリングの縦方向のリストとして保存することを指定します。 このオプションは、マクロ・ハンドラー、グローバル変数、およびマクロ変数でサポートされます。統合オブジェクトの場合は、ストリングのリストは 1 つの連続したストリングとして扱われます。

他 (テキスト以外) の平面からの抽出の場合、 2 次元の文字配列として抽出したデータを 個別の 1 次元の配列に分解 (それぞれの配列が抽出された 単一行を表す) し、それぞれの行がグローバル変数内の インデックスに格納されることを指定します。 このオプションは、グローバル変数でのみサポートされます。

この領域をテーブルとして抽出
テキスト平面から抽出する場合、 抽出したテキストを行および列を持つ、横方向および縦方向のストリングのテーブルとして 保存することを指定します。このオプションは、統合オブジェクト、 マクロ・ハンドラー、およびマクロ変数でサポートされます。グローバル変数の場合は、テーブルとして抽出されたストリングは 1 つの連続したストリングになります。
注:
他 (テキスト以外) の平面からの 抽出の場合、このテキスト以外のデータはユーザーへの 直接表示向けではないため、このオプションは 使用不可です。代わりに、このオプションは、特定のホスト画面の表示方法または 処理方法を識別するのに特別なデータが必要な開発者向けです。

「定義」をクリックして、テーブルを定義します。

テーブル抽出の構成
このページを使用してテーブルの列の形式を設定します。
  • 列名

    このフィールドを使用して、選択した列の見出しを変更します。

  • 列の展開

    列の展開は、文字を列間で移動させます。ある列を強調表示した状態にします。「左方」ボタンにより、その列の各行の最後の文字が強調表示した列の左側に移動し、強調表示した列の各行の最初の文字になります。「右方」ボタンにより、その列の各行の最初の文字が強調表示した列の右側に移動し、強調表示した列の各行の最後の文字になります。

  • 列の削減

    列の削減は、文字を列間で移動させます。ある列を強調表示した状態にします。「左方」ボタンにより、強調表示した列の各行の最初の文字が移動して、強調表示した列の左隣の列の各行の最後の文字になります。「右方」ボタンにより、強調表示した列の各行の最後の文字が移動して、強調表示した列の右隣の列の各行の最初の文字になります。

  • マージ

    このボタンは、2 つの強調表示した列を単一の列にマージするために使用します。強調表示した列の文字列は 1 つの列内で結合されます。

  • 分割

    このボタンは、強調表示した 1 つの列を 2 つの別々の列に分割するために使用します。強調表示した列の文字列は 2 つの新規の列間で等しく分割されます。文字数が偶数でない場合は、左側の列が右側の列より 1 文字多く含みます。

    注:

    「分割」をクリックすると、HATS によって、選択した列が分割されます。列に 2 バイト文字 (DBCS) が含まれている場合は、その文字は 2 つの列にまたがって分割されてしまう可能性があります。 この場合は、その文字はどちらの列にも表示されません。抽出アクションの編集中にこのことが発生していると気付いた場合は、「右方」および「左方」ボタンを使用して、列を調整してください。 その分割された文字は、単一の列に含まれると、再表示されるようになります。

「ハンドラー」セクションを使用して、 テキスト平面から抽出されたテキストの処理方法を指定します。

注:
他 (テキスト以外) の平面からの 抽出の場合、このテキスト以外のデータはユーザーへの直接表示向けではないため、 このオプションは使用不可です。代わりに、このオプションは、特定のホスト画面の 表示方法または処理方法を識別するのに特別なデータが必要な 開発者向けです。
ハンドラーを表示
HATS Web アプリケーションの場合、.jsp ファイルを選択して、抽出した情報をユーザーに表示できます。デフォルトのマクロ・ハンドラーが HATS とともに出荷され、名前は default.jsp です。このハンドラーは、HATS プロジェクト 表示で、プロジェクト名を展開し、「Web コンテンツ > マクロ・イベント・ハンドラー」を展開することにより、見つけることができます。独自のハンドラーを作成する場合は、制御を必ず 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 Reference」のセクションを参照してください。

グローバル変数として保存
グローバル変数の名前は「名前」フィールドに入力できます。または、ドロップダウン・メニューを使用して既存の変数を選択することもできます。「名前」フィールドで既存のグローバル変数を選択した場合は、「拡張」をクリックして、次のラジオ・ボタンのいずれかを選択することにより、既存の変数の取り扱い方法を指定します。 「共用」チェック・ボックスを選択することにより、この変数を共用するかどうかを指定することもできます。

抽出データをグローバル変数として保存することを選択すると、「抽出する平面」設定の「テキスト」オプションが自動的に選択されます。

注:
値を抽出して、抽出によって設定されているグローバル変数に割り当て、その グローバル変数の値をプロンプトに使用するには、promptall 属性を false に設定する必要があります。 promptall 属性が true に設定されていると、プロンプトの値が取り出されるまで 抽出アクションは実行されません。 このため、プロンプトによって使用されるグローバル変数には値が入っていません。 HATS で記録されるマクロは、デフォルトで promptall=true になっています。promptall 属性について詳しくは、promptall 属性を参照してください。

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

マクロ変数として保存
抽出データを保存するマクロ変数を指定する場合、このボックスを選択します。このオプションはマクロ変数がマクロに使用可能になっている場合のみ、表示されます。

抽出データをマクロ変数として保存することを選択すると、「抽出する平面」設定の「テキスト」オプションが自動的に選択されます。マクロ変数に保存できるのは、 テキスト平面からのデータのみです。

変数
抽出データを保存する変数を選択します。ドロップダウン・メニューには、マクロで定義されているすべての変数が取り込まれています。

「拡張」セクションを使用して以下のオプションを設定します。

1 つの連続領域として抽出
長方形のテキスト・ブロックを取り込む場合は、このボックスをクリアします。詳しくは、ホスト端末上の長方形領域のキャプチャーを参照してください。行から行に折り返すテキストの連続シーケンスを取り込む場合は、このボックスを選択します。詳しくは、ホスト端末からのテキスト・シーケンスのキャプチャーを参照してください。
アンラップ
指定した抽出領域内で始まる任意のフィールドの内容全体を取り込む場合は、このボックスを選択します。詳しくは、unwrap 属性を参照してください。
抽出する平面
データを抽出する平面を選択します。オプションは、 以下にリストされています。デフォルトは、テキストです。

いずれの平面から抽出したデータも、グローバル変数に 保存できます。1 回の「抽出」アクションにつき抽出できるのは、1 つの平面からのデータのみです。 マクロ変数に保存できるか、統合オブジェクトで使用できるのは、 テキスト平面からのデータのみです。

注:
  1. Host Access Class Library (HACL) 表示スペース・モデル 内のさまざまなデータ平面の形式および 内容について詳しくは、http://publib.boulder.ibm.com/infocenter/hodhelp/v10r0/topic/com.ibm.hod.doc/doc/hacl/DWYL0M88.HTML を参照してください。
  2. 統合オブジェクト内でテキスト以外の平面データを使用する方法の 例については、「HATS Web アプリケーション・プログラマーズ・ガイド」にある『非テキスト平面からデータの抽出』セクションを参照してください。

詳しくは、抽出アクション (<extract> エレメント)を参照してください。

「すべて抽出」アクション

「すべて抽出」アクションは、画面上のすべてのフィールドに対して、一度に複数の抽出アクションを追加することを使用可能にします。

簡単に、単一のフィールド、空のすべての保護フィールド、またはすべての入力フィールドを除外し、抽出名を設定できます。

同じ名前の抽出が既に存在する場合は、警告メッセージが表示され、続行すると既存の抽出の設定がオーバーライドされることが通知されます。

「グローバル変数として保存」オプションを選択すると、「抽出名とグローバル変数名を同期化する」かどうかを選択することもできます。選択した場合は、名前の同期が維持されます。選択しない場合は、グローバル変数を編集して、抽出名とは異なる名前にすることができます。

このアクションに関する VME のその他の設定については、抽出アクションを参照してください。一般的な情報について詳しくは、抽出アクション (<extract> エレメント)を参照してください。

「入力」アクション

「入力」アクションは、実際のユーザーからのキーボード入力をシミュレートします。このアクションは、キー・ストロークのシーケンスをホスト端末に送ります。 このシーケンスには、文字 (a、b、c、#、& など) を表示するキーのみでな く、アクション・キー ( [enter] など) も含めることができます。

現行カーソル位置に挿入
このボックスを選択すると、マクロ・ランタイムは、ホスト端末の現行カーソル位置に入力を挿入します。カーソルの「行」と「列 (Column)」フィールドを自身で設定する場合は、このボックスをクリアします。入力を挿入するカーソル行および列を入力します。画面キャプチャーが使用可能な場合は、その上をクリックすることにより、カーソルの行と列を設定できます。「行」フィールドと「列」フィールドに変数名を $var$ の形式で入力することもできます。
ストリング
このフィールドに、ホスト端末に送信するストリングを入力します。AID キー をこのフィールドに入力することができます。例えば、キーボード上の F12 キーを押すと [pf12] が挿入されます。その他の AID キーは、フィールドの隣のドロップダウン・メニューを使用して挿入できます。TAB キーを押すと [tab] が挿入されるため、マウスを使用してフィールドから出る必要があります。
ホスト・アクション・キーを変換
このボックスを選択すると (デフォルト値)、マクロ・ランタイムは、アクション・キーのストリング ([enter] など) を、リテラル・ストリングではなく、アクション・キーとして解釈します。
入力の末尾へカーソルを移動
このボックスを選択すると、マクロ・ランタイムはテキスト・カーソルを入力の末尾に移動します。
暗号化ストリング
このボックスを選択すると、マクロ・エディターは、「ストリング」フィールドに含まれるキーのシーケンスを暗号化します。

詳しくは、入力アクション (<input> エレメント)を参照してください。

「一時停止」アクション

一時停止アクションは、指定されたミリ秒数の間だけ待機した後、終了します。

具体的には、マクロ・ランタイムは <pause> エレメントを検出し、 期間の値を読み取って、指定されたミリ秒数だけ待機します。 その後、マクロ・ランタイムは次の項目の実行に進みます。

このアクションは次の場合に使用します。

期間 (ミリ秒)

待機するミリ秒数を指定します。デフォルトは 10000 ミリ秒 (10 秒) です。

詳しくは、<pause> エレメントを参照してください。

「実行」アクション

「実行」アクションは、実行する Java メソッドを指定することを許可します。このアクションは、拡張マクロ形式のマクロの場合にのみ追加できます。

このアクションは、ユーザー定義タイプとしてインポートした Java クラスに所属するメソッドを呼び出します。 (「変数およびタイプ」タブを参照)。

Java メソッド
実行するメソッドを指定します。変数と同じように、メソッド呼び出しをドル記号 ($) で囲む必要があります (メソッド呼び出しの構文を参照)。 マクロ・ランタイムがメソッドを呼び出します。 マクロ・ランタイムが呼び出し先メソッドを検索する方法も参照してください。

詳しくは、実行アクション (<perform> エレメント)を参照してください。

「マクロを実行」アクション

「マクロを実行」アクションは別のマクロを実行します。

マクロ
このリスト・ボックスから実行するマクロを選択します。リスト・ボックスには、プロジェクトのすべてのマクロが取り込まれています。
開始画面
このリスト・ボックスから、マクロ・ランタイムに最初に処理させるターゲット・マクロ内のマクロ画面を選択します。通常の開始画面でターゲット・マクロを開始する場合は、「(デフォルト)」を選択します。
マクロ変数の転送
このボックスを選択すると、マクロ・ランタイムは、呼び出し側マクロに属するすべての変数 (変数の内容を含む) を ターゲット・マクロに転送します。

詳しくは、PlayMacro アクション (<playmacro> エレメント)を参照してください。

「プロンプト」アクション

プロンプト・アクションは、ユーザーによる直接のキーボード入力を 3270 また は 5250 アプリケーションに送るか、変数に格納するための強力な機能を 備えています。

名前
プロンプト名を指定します。この名前はユーザーに対するプロンプト内に表示されます。そのため、この名前を使用して、プロンプト・フィールドに関係する説明を提供できます。

同じ名前のプロンプトが既に存在する場合は、警告メッセージが表示され、続行すると既存のプロンプトの設定がオーバーライドされることが通知されます。

デフォルト値
プロンプト・フィールド用に使用するデフォルト値を指定します。
パスワード非表示
ユーザーにより入力されるプロンプトの入力を暗号化する場合、このボックスを選択します。
注:
プロンプト用に指定したデフォルト値はマクロ・ファイルに暗号化されないで保管されます。デフォルト値は、マクロ・エディターを使用してプロンプトを編集しているときは、暗号化されない状態で表示されます。したがって、プロンプトを使用してパスワードを指定する方法を実行するのは適切ですが、セキュリティー上の理由から、パスワードのデフォルト値は指定しないようにします。
マクロ変数に値を保存
プロンプト入力を保存するマクロ変数を指定する場合、このボックスを選択します。このオプションはマクロ変数がマクロに使用可能になっている場合のみ、表示されます。「マクロ変数に値を保存」が選択されている場合は、「このフィールドに値を挿入しない」オプションのみが使用可能になります。
変数
プロンプト入力を保存する変数を選択します。ドロップダウン・メニューには、マクロで定義されているすべての変数が取り込まれています。
このフィールドに値を挿入しない
このボックスを選択すると、マクロ・ランタイムは、入力フィールドにプロンプト入力を表示しません。このフィールドは、「マクロ変数に値を保存」ボックスが選択されている場合にのみ、使用可能になります。
値の挿入前にフィールドをクリア
このボックスを選択すると、マクロ・ランタイムは、入力開始前に、入力フィールドの内容をクリアします。
現行カーソル位置に挿入
このボックスを選択すると、マクロ・ランタイムは、ホスト端末の現行カーソル位置にプロンプト入力を挿入します。カーソルの「行」と「列 (Column)」フィールドを自身で設定する場合は、このボックスをクリアします。プロンプト入力を挿入するカーソル行および列を入力します。画面キャプチャーが使用可能な場合は、その上をクリックすることにより、カーソルの行と列を設定できます。「行」フィールドと「列」フィールドに変数名を $var$ の形式で入力することもできます。
ホスト・アクション・キーを変換
このボックスを選択すると (デフォルト値)、マクロ・ランタイムは、アクション・キーのストリング ([enter] など) を、リテラル・ストリングではなく、アクション・キーとして解釈します。
入力の末尾へカーソルを移動
このボックスを選択すると、マクロ・ランタイムはテキスト・カーソルを入力の末尾に移動します。

「ハンドラー」セクションにより、プロンプトを処理する方法の決定が可能になります。次のラジオ・ボタンのいずれかを選択できます。

ハンドラーを表示
HATS Web プロジェクトの場合は、ユーザーに必要な情報の入力を求めるプロンプト (その情報をユーザーが送信するボタン付き) を出力するために、.jsp ファイルを選択することができます。default.jsp という名前のデフォルトのマクロ・ハンドラーが HATS とともに出荷されます。 このファイルは、Toolkit の「HATS プロジェクト」表示をクリックして、プロジェクト名を展開し、「Web コンテンツ > マクロ・イベント・ハンドラー」を展開することにより、見つけることができます。独自のハンドラーを作成する場合は、制御を必ず HATS ランタイムに戻してください。
注:
統合オブジェクトでは、選択した .jsp ハンドラーは無視されます。代わりに、統合オブジェクト用の入力ページが作成され、その入力ページに値の入力を求めるプロンプトが配置されます。入力ページを使用して入力された値は、統合オブジェクトが実行される前に、生成された出力ページにより統合オブジェクトにコピーされます。

HATS リッチ・クライアント プロジェクトの場合は、ユーザーに必要な情報の入力を求めるプロンプト (その情報をユーザーが送信するボタン付き) を出力するために、カスタム・マクロ・ハンドラーを指定するか、リッチ・クライアント プロジェクト内に定義されているカスタム・マクロハンドラーのリストを参照して選択できます。DefaultMacroHandler という名前のデフォルトのマクロ・ハンドラーが HATS とともに出荷されます。 このファイルは、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 Reference」のセクションを参照してください。

プロンプトをストリングに設定
プロンプトから戻す値がわかっている場合は、そのストリングを「ストリング」フィールドに入力できます。
プロンプトをグローバル変数に設定
プロンプトの値をグローバル変数により入力する場合は、そのグローバル変数の名前を「名前」フィールドに入力するか、「グローバル変数」フィールドの隣のドロップダウン・メニューを使用して既存の変数を選択します。「拡張」ボタンをクリックすると、変数が共用または索引付きであるかどうかを指定できます。索引付き変数の場合は、すべての索引を表示するのか、単一の索引を表示するのかを指定する必要があります。グローバル変数についての詳細は、「Host Access Transformation Services ユーザーと管理者のガイド」の章『グローバル変数との対話』を参照してください。
注:

プロンプトの値が抽出によって設定されたグローバル変数に基づいていて、 promptall 属性が true に設定されている場合、プロンプトの値が取り出されるまで 抽出アクションは実行されません。 このため、プロンプトによって使用されるグローバル変数には値が入っていません。 グローバル変数を抽出およびプロンプトで使用する場合、promptall 属性を false に設定しなければなりません。 promptall 属性について詳しくは、promptall 属性を参照してください。

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

プロンプトをユーザー・リストからのプロパティーに設定
プロンプトでユーザー・リストにアクセスするには、ドロップダウン・リストから「ユーザー・プロファイル 」を選択します。ユーザー・プロファイルは、「ユーザー・リスト・プロパティー」として、ユーザー ID または パスワードを使用するかどうかの決定に関するキーになります。ユーザー・リストについて詳しくは、「Host Access Transformation Services ユーザーと管理者のガイド」の『ユーザー・リスト』のセクションを参照してください。
注:
ユーザー・リストのプロンプトは、接続マクロ内でのみ使用できます。
Web 高速ログオンを使用する
HATS アプリケーションを Web 高速ログオンを使用するように構成してある場合は、ユーザー ID またはパスワードとしてプロンプト・タイプを「プロンプト・タイプ」ドロップダウン・リストで入力し、アプリケーション ID を「アプリケーション ID」フィールドに入力します。
注:
「プロンプト・タイプ」には正しい値が事前に入力されている必要があります。

詳しくは、プロンプト・アクション (<prompt> エレメント)を参照してください。

「すべてにプロンプト」アクション

「すべてにプロンプト」アクションは、画面上のすべてのフィールドに対して、一度に複数のプロンプト・アクションを追加することを使用可能にします。

簡単に、フィールドを除外することやプロンプト名を設定することが可能です。

同じ名前のプロンプトが既に存在する場合は、警告メッセージが表示され、続行すると既存のプロンプトの設定がオーバーライドされることが通知されます。

「プロンプトをグローバル変数に設定」オプションを選択すると、「プロンプト名とグローバル変数名を同期化する」かどうかを選択することもできます。選択した場合は、名前の同期が維持されます。選択しない場合は、グローバル変数名を編集して、プロンプト名とは異なる名前にすることができます。

このアクションに関する VME のその他の設定については、「プロンプト」アクションを参照してください。一般的な情報について詳しくは、プロンプト・アクション (<prompt> エレメント)を参照してください。

「カーソル位置を設定」アクション

「カーソル位置を設定」アクションは、ホスト端末上のユーザーのマウス・クリックをシミュレートします。実際のマウス・クリックと同様に、クリックが行われたときに マウス・アイコンが指していた行と列の位置にテキスト・カーソルがジャンプします。

マウス・クリックを発生させる「行」と「列」の位置を指定します。画面キャプチャーが、使用可能であれば、表示されます。その場合、その上をクリックすることにより、「行」フィールドと「列」フィールドを設定できます。「行」フィールドと「列」フィールドに変数名を $var$ の形式で入力することもできます。

詳しくは、<mouseclick> エレメントを参照してください。

「変数の更新」アクション

「変数の更新」アクションは、マクロ変数の値を更新するのを許可します。 このアクションは、拡張マクロ形式のマクロの場合にのみ追加できます。

変数
このリスト・ボックスから更新する変数の名前を選択します。リスト・ボックス・ドロップダウンには、マクロ用に定義されているすべての変数が取り込まれています。
タイプ
選択した変数のタイプを表示します。
値
変数を更新する値を指定します。値は、そのタイプの正しい形式である必要があります。

詳しくは、変数更新アクション (<varupdate> エレメント)を参照してください。

次の画面接続の操作

次の画面接続をパレットから追加する

パレットの「次の画面接続」ツールは、新規の次の画面接続の定義を許可します。

2 つの画面間の次の画面接続を追加するには、パレットで「次の画面接続」をクリックし、ソース画面をクリックして次にターゲット画面をクリックします。

同じソース画面から発生する他の接続が存在する場合、新規接続は最上位の順序または優先順位度を持つことになります。順序は、次の画面接続のポップアップ・メニューの「再配列アクション」を使用して変更できます。

ループ (つまり、ソースとターゲットが同じ次の画面接続) を作成するには、同じ画面を 2 回クリックします。ループは、その画面に他の次の画面接続が定義されていない場合は、矢印として表示され、1 つ以上定義されている場合は、順序を表示する円として表示されています。

次の画面接続の再配列と変更

次の画面接続のポップアップ・メニューの「再配列」アクションは、接続の順序 (または優先順位) の変更を許可します。これは、同じ画面から発生する他の次の画面接続すべての順序に影響を与えます。

「再配列」アクションは、「上へ」および「下へ」と同じように機能します。つまり、順序 2 の接続を順序 3 に変更すると (1 つ下げる) 、順序 3 であった接続は順序 2 になります (1 つ上がる)。

次の画面接続のソースまたはターゲットは、その接続の適切な端を新しいソースまたはターゲットの画面にドラッグすることにより変更できます。

VME の設定の操作

VME の設定を操作するには、メニュー・バーから「ウィンドウ > 設定 > HATS > Visual Macro Editor」を選択します。以下の設定を変更できます。

デフォルトで画面アクションを表示
この設定を選択すると、デフォルトで、マクロ画面オブジェクト上にアクションを表示します。 この設定をクリアすると、デフォルトで、アクションを非表示にします。マクロ画面上のアクションをトグルでクリックすると、特定の画面のアクションを表示/非表示にします。 この設定は VME で始めて開いたマクロのみに影響します。 デフォルトが選択されています。
表示する画面アクション数の制限
1 つのマクロ画面オブジェクトに対して表示されるアクションの最大数を指定します。これは、すべてのアクションを表示するとインターフェースが複雑すぎる、複雑なマクロの場合、有用です。デフォルトは「5」です。