グローバル変数との対話

グローバル変数には、1 つの HATS オブジェクトから他のオブジェクトに情報を渡すために使用できる値が入っています。例えば、ホスト画面上の複数の場所から情報を取り出し、計算を行い、その結果を現行画面または以後の画面に挿入することができます。1 つまたは複数のホスト画面からストリングの配列を作成し、変換に挿入することもできます。ユーザーが GUI 上のフィールドに入力したストリングを抽出して、別の場所で使用することもできます。

単一の HATS アプリケーションの有効範囲内でのみ可視であるグローバル変数は、ローカル・グローバル変数と呼ばれます。同じ .ear ファイルにあるすべての HATS Web アプリケーション、または同じリッチ・クライアント環境内で実行されているすべての HATS リッチ・クライアント・アプリケーションから可視であり、使用可能なグローバル変数は、共用グローバル変数と呼ばれます。グローバル変数を使用または作成する場合は、必ずこの変数がローカル変数または共用変数のいずれであるかを指定する必要があります。「拡張」設定セクションで共用を指定できます。すべてのグローバル変数のデフォルト設定は「ローカル」です。

注:
同じ名前を持つ 2 つのグローバル変数がある場合、1 つがローカルでもう 1 つが共用であれば共存が可能です。

HATS Web アプリケーションの場合は、単一 HTTP セッション中に同一 .ear ファイル 内のアプリケーション間でグローバル変数を共用できます。HATS リッチ・クライアント・アプリケーションの場合は、同一のリッチ・クライアント環境で実行されるアプリケーション間でグローバル変数を共用できます。リッチ・クライアント環境を閉じて再始動すると、以前に共用されていたグローバル変数値は保持されません。

グローバル変数の値は、数値、ストリング、またはストリングの索引付き配列です。グローバル変数にストリングの配列を含める場合は、配列全体を使用するか、特定の索引を使用するか、または特定の索引から始まるすべての値を使用するかを指定することができます。グローバル変数に対するすべての操作で、大文字と小文字が区別されます。グローバル変数には、「HATS」、「hats」、または「Hats」で始まる名前は使用しないでください。

グローバル変数の値を設定するには、次の方法があります。

グローバル変数に値が入っている場合、その値は以下の目的に使用できます。

ホスト画面にグローバル変数を挿入する場合は、変換を適用する前にこのアクションをリストして、ホスト画面から作成された GUI にそのグローバル変数が表示されるようにする必要があります。ただし、変換が戻されてからホスト画面がホストに戻されるまでの間にグローバル変数を挿入した方が良い場合もあります。画面イベントのアクションを指定する方法の詳細については、アクションを参照してください。グローバル変数を変換およびテンプレートに挿入する方法については、グローバル変数を挿入を参照してください。

グローバル変数をプロンプト・マクロおよび抽出マクロで使用して、プロンプトに値を入力したり、ホスト画面から抽出した値を保管することができます。グローバル変数をマクロと連動して使用して、1 つの GUI で複数のホスト画面を結合できます。マクロでグローバル変数を使用する方法の詳細については、マクロとホスト端末 および 画面の結合を参照してください。

データを GUI からアプリケーションに受け渡すようにグローバル変数をオーバーライドすることができます。ローカル変数および共用グローバル変数は、オーバーライドできます。詳しくは、グローバル変数のオーバーライドを参照してください。

これらは、画面認識にも使用できます。詳細については、画面認識基準または開始画面を参照してください。

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

グローバル変数を使用して複数の画面からのストリングまたは数値を累算する場合は、開始また接続アプリケーション・イベントに「グローバル変数を設定」アクションを追加することによって、そのグローバル変数を初期化することができます。

「HATS プロジェクト」ビューで HATS プロジェクトの「プロジェクト設定」をダブルクリックします。「イベント」タブに進みます。

接続イベントのグローバル変数を設定するには、「接続」をダブルクリックして、イベント・エディターを開きます。次に、「アクション」タブでグローバル変数を追加できます。このようにして、実行されるアクションとグローバル変数をリンクできます。

同じ操作を開始イベントにも実行できます。

画面イベントまたはアプリケーション・イベントで「グローバル変数を除去」アクションを使用することにより、ローカルおよび共用グローバル変数を除去することができます。詳しくは、「グローバル変数を除去」アクションを参照してください。

グローバル変数の名前変更

グローバル変数の各インスタンスは名前変更できます。特定の HATS プロジェクトにあるすべてのグローバル変数のリストを取得するには、以下のステップを実行します。

  1. HATS メニュー・バーから「ウィンドウ」>「ビューの表示」>「HATS グローバル変数」を選択します。「パレット」ビューの直下に「HATS グローバル変数」ビューが配置されます。
  2. 「HATS プロジェクト」ビュー内のプロジェクトをクリックして、選択されたプロジェクトのマクロおよびイベント内にあるすべてのグローバル変数を「HATS グローバル変数」ビューに取り込みます。別のプロジェクトを選択すると、「HATS グローバル変数」ビューが更新されます。選択されたプロジェクトのマクロまたはイベントが追加、削除、または編集されると、内容が最新表示されます。
  3. グローバル変数名を変更するには、「HATS グローバル変数」ビューでグローバル変数を右クリックし、変数名を編集します。マクロまたはイベントを開くには、各グローバル変数の下にリストされているマクロまたはイベントをダブルクリックします。マクロまたはイベントを作成または編集すると、「HATS グローバル変数」ビューが自動的に更新されます。
注:
グローバル変数の名前変更は、マクロおよびイベント内で定義されたグローバル変数でのみサポートされます。したがって、「HATS グローバル変数」ビューにはこのようなグローバル変数のみが表示されます。グローバル変数を名前変更しても、ビジネス・ロジック、変換、または HATS プロジェクト内のほかの場所にあるグローバル変数は名前変更されません。

グローバル変数とマクロ変数の違い

HATS では、主に 2 つのタイプの変数があります。グローバル変数とマクロ変数です。ここでは 2 つの変数の違いを説明します。

グローバル変数

グローバル変数は、HATS Toolkit で作成され、HATS プロジェクトで使用される変数です。グローバル変数は、HATS の .hma ソース・ファイル内のマクロ・スクリプトの外部に格納されます。HATS ランタイムによって管理され、更新されます。グローバル変数には 2 つのタイプがあります。

ローカル
ローカル・グローバル変数は、HATS プロジェクト内で作成され、プロジェクトからのみ可視であるグローバル変数です。
共用
共用グローバル変数は、.ear ファイル内のすべての Web アプリケーション、またはリッチ・クライアント環境のすべてのリッチ・クライアント・アプリケーションから可視であり、使用可能なグローバル変数です。

グローバル変数がローカル変数または共用変数のいずれであるかは、グローバル変数の作成時に GUI の「共用」チェック・ボックスが選択されたかどうか、または HATS の .hma ソース・ファイル内で set、prompt、または extract タグの共用属性の値が yes または no のいずれに指定されているかどうかによって決まります。

マクロ変数

マクロ変数は、 Visual Macro Editor または拡張マクロ・エディターで作成される変数です。マクロ変数はマクロ内部で使用されます。マクロの外部で使用されることはありません。マクロ変数は、マクロ・エンジンにより作成、保管、使用され、マクロ・スクリプトにリストされます。マクロ変数の詳細については、「HATS 拡張マクロ・ガイド」の『変数とインポートした Java™クラス』の章を参照してください。

HATS プロンプトを使用し、グローバル変数を抽出する HATS マクロ (.hma) ファイルのソースでは、プロンプトおよび抽出は、ソース・ファイル内のマクロ・スクリプトの前に組み込まれます。マクロ・スクリプトの構文は、<HAScript> タグと </HAScript> タグで囲みます。