画面記述

この章では、次の内容を取り上げます。

画面の説明および画面の認識のトピックは相互に関連し合っています。この章では、画面について記述することによって画面を認識できるようにするプロセスに主な焦点を当てます。また、2 つの機能どうしの基本的な関係について理解できるようにするため、画面認識についても十分な情報を提供します。画面認識プロセスの詳細については、画面認識で説明されています。

用語の定義

記述子
マクロ画面の <description> エレメントで発生し、マクロ画面が対応するアプリケーション画面の独特の特性について記述する、XML エレメント。

例えば、ScreenB という名前のマクロ画面に、アプリケーション画面の行 3 にストリング ISPF Primary Option Menu が入っていることを示すストリング記述子 (<string> エレメント) が含まれているとします。 マクロの再生時に、マクロ・ランタイムが次に処理するマクロ画面を決定するとき、および ScreenB が候補である場合、マクロ・ランタイムは、ScreenB の記述子を実際のアプリケーション画面と比較します。 その記述子が実際のアプリケーション画面と一致する場合 (アプリケーション画面の行 3 に、そのストリングが含まれている場合)、マクロ・ランタイムは、次に処理するマクロ画面として ScreenB を選択します。

画面記述
マクロ画面の <description> エレメントに記述子を追加するプロセス。画面記述を行うのは、マクロ・エディターを使用してマクロ画面の記述子 (上記の例のストリング記述子など) を作成または編集する場合です。同様にマクロ・オブジェクトは、マクロの記録中 (説明の記録を参照) に作成する新しいマクロ画面ごとに 1 つ以上の記述子を作成します。
画面認識
マクロ画面候補と現行のアプリケーション画面の突き合わせを試みるときに、マクロ・ランタイムが実行するプロセス。

マクロ・ランタイムによるマクロ画面の処理方法で詳しく説明されているとおり、マクロ・ランタイムが次に処理するマクロ画面を決定する必要がある場合、そのマクロ・ランタイムは、マクロ画面候補 (通常は、現行マクロ画面の <nextscreens> エレメントに存在) の名前を有効な次画面のリストに加えます。次に、ホスト・アプリケーションがホスト端末を新しいアプリケーション画面で 更新するので、マクロ・ランタイムは、リスト上の各マクロ画面の記述子を 新しいアプリケーション画面と比較します。 最終的に、マクロ・ランタイムがリスト上のマクロ画面のいずれかをアプリケーション画面と一致させることができる (例えば、ストリング ISPF Primary Option Menu が行 3 に表示される) まで、アプリケーション画面が更新されます。 一致したマクロ画面は、次に処理されるマクロ画面になります (プロセス全体の 3 ステージすべての概要を参照)。

画面記述については、VME を使用する場合は「画面認識」タブを、AME を使用する場合は説明タブを参照してください。

説明の記録

HATS ホスト端末でのマクロ記録中、作成される新しいマクロ画面それぞれの新しい <description> エレメントに 1 つ以上の記述子が追加されます。

記録するマクロの最初のマクロ画面を定義する必要があります。 HATS は、最初の画面の記述子に OIA 記述子を追加します。

最初のアプリケーション画面以降のマクロの他のすべてのアプリケーション画面に 対して、画面を定義するか、HATS で画面を自動的に定義するかを選択できます。 HATS で画面を定義する場合は、次の 3 つの記述子が作成されます。

したがって、マクロ・ランタイムは、記録されたマクロが (改訂なく) 再生されると、最初のマクロ画面に続くマクロ画面に関しては、 入力禁止標識がクリアされているかどうか、カーソル 位置がアプリケーション画面のカーソル位置と一致するかどうか、 およびマクロ画面の記述内の入力フィールド数が アプリケーション画面内の入力フィールド数と一致するかどうかに基づいて、 マクロ画面を対応するアプリケーション画面に一致させます。

記録された説明が機能する理由

HATS によって自動的に作成され、記録された説明は、少なくとも次の 3 つの理由で適切に機能します。

第一に、OIA 記述子、カーソル位置、および入力フィールド数は、 考えられるすべてのアプリケーション画面に適用できます。つまり、 どのアプリケーション画面にも、いくつかの入力フィールド (おそらくその数は 0)、 カーソルの開始位置、および入力禁止標識 (設定またはクリア) があります。

第二に、入力フィールド数とカーソル位置の組み合わせにより、 アプリケーション画面の説明の信頼性が高まることです。これは、 アプリケーション画面には、一般に多数のフィールドが含まれているからです。 ただし、入力フィールドの数はそのうちのいくつかのみです。 カーソル位置は常に最初の入力フィールドになります。

第三に、おそらくこれが最も重要ですが、画面認識時に、マクロ・ランタイムは、新しいアプリケーション画面を、有効な次画面と呼ばれる、マクロ画面の短いリスト (通常、非常に短いリスト) と比較することです (マクロ画面の処理ステージを参照)。 したがって、1 つのマクロ画面を、マクロ内の他のすべてのマクロ画面と区別する必要はありません。有効な次画面のリスト内の他の画面と区別するだけです。 多くの場合、このリストは、1 つのマクロ画面から構成されます。

記録された記述子が提供するフレームワーク

一部のマクロ画面の場合、記録された 説明では、マクロ・ランタイムが 1 つのアプリケーション画面を別の類似した アプリケーション画面と確実に区別することができないことがあります。 マクロの記録は、 マクロのフレームワークを迅速に提供するため、 今もなお非常に便利な機能です。ここでは、記録された記述を改善することができます。

多くの場合、記録された記述を改善する最も簡単な方法は、ストリング記述子を追加することです。 例えば、マクロ画面を「Utility Selection Panel」で使用する場合は、3 行目のどこかでアプリケーション画面に「Utility Selection Panel」というストリングが含まれていることを指定するストリング記述子を追加できます。ただし、必ずストリング記述子を使用しなければならないわけではありません。一部の状況では、アプリケーション画面が正しく認識されることを確実にするために、1 つ以上の他の記述子を使用する必要があります。

記述子の評価

ここでは、マクロ画面がアプリケーション画面と一致するかどうかをマクロ・ランタイムが判別する方法を詳しく説明します。

以降のサブセクションを読み進めるときには、次の点を留意してください。

プロセスの概要

次に、プロセスの概要を説明します。

  1. マクロ・ランタイムは、各記述子を個々に評価し、その記述子のブール結果 (true または false) を得ます。
  2. マクロ・ランタイムは、個々の記述子のブール結果を結合して、記述全体が true であるか (マクロ画面がアプリケーション画面と一致する)、false であるかを判別します。 個々の記述子の結果を結合するために、マクロ・ランタイムは、デフォルトの結合メソッドまたは uselogic メソッドを使用します。

個々の記述子の評価

マクロ記述内の個々の記述子ごとに、マクロ・ランタイムは記述子を評価し、ブール結果 (true または false) を得ます。

例えば、記述子がストリング記述子である場合、マクロ・ランタイムは、アプリケーション画面でその記述子が指定する行と列を調べ、その位置にあるストリングを、記述子が指定するストリングと比較します。 この 2 つのストリングが一致する場合、マクロ・ランタイムは、値 true をストリング記述子に割り当てます。 この 2 つのストリングが一致しない場合、マクロ・ランタイムは、値 false をストリング記述子に割り当てます。

通常、マクロ画面には複数の記述子が含まれています。 ただし、マクロ画面に記述子が 1 つのみ含まれる場合は (その記述子の invertmatch 属性が true に設定されていないことを前提とすると)、そのただ 1 つの記述子が true のときは、説明全体も true になり、マクロ・ランタイムは、マクロ画面をアプリケーション画面に一致するものと認識します。一方、その 1 つの記述子が false である場合、説明全体が false であり、マクロ画面は認識されません。

デフォルト結合メソッド

<description> エレメントに複数の記述子がある場合、このセクションで説明されているデフォルト結合メソッドを使用するか、uselogic 属性で説明されている uselogic 属性を使用する必要があります。

デフォルト結合メソッドの用途

デフォルト結合メソッドが適しているのは、次の 2 つのシナリオだけです。

デフォルト結合メソッドの働きを十分理解している場合を除いて、他のシナリオにデフォルトのメソッドを使用しないでください。

デフォルト結合メソッドは、次のものを使用します。

Invertmatch 属性

すべての記述子は invertmatch 属性を持ちます。

記述子の評価に影響がないように、デフォルトでは、この属性は false です。

この設定値が true である場合、マクロ・ランタイムは、記述子の評価から得るブール結果を逆転させます。つまり、true を false にするか、false を true にします。

例えば、ストリング記述子が true である (記述子内のストリングが、 アプリケーション・ウィンドウの画面と一致する) が、 ストリング記述子の invertmatch 属性が true に設定されていると、マクロ・ランタイムが判断する場合、 マクロ・ランタイムは、ストリング記述子の結果を true から false に変えます。

Optional 属性

すべての記述子は Optional 属性を持ち、この属性は false (デフォルト) または true に設定されます。

Optional 属性は、マクロ・ランタイムがデフォルト結合規則を使用して記述子のブール結果を結合する場合に、個々の記述子の結果を取り扱う方法を提示します。デフォルトでは、この属性は、false に設定されます。これは、記述子の結果が、オプションではなく必須であることを示します。

デフォルト結合規則

前述のように、デフォルト結合規則が適しているのは、次の 2 つのシナリオだけです。

すべての記述子が true である場合にのみ記述全体を true にする場合は、説明内のすべての記述子のOptional 属性を false (デフォルト設定) に設定してください。

一方、記述子の少なくとも 1 つが true である場合に記述全体を true にする場合は、記述内のすべての記述子の Optional 属性を true に設定してください。

デフォルト結合規則とその意味を十分に理解している場合を除いて、1 つのマクロ画面に複数の記述子があるその他のシナリオで、デフォルト結合規則を使用しないでください。 詳しくは、1 つのマクロ画面における複数の記述子のデフォルト規則を参照してください。

また、規則とその意味を十分に理解している場合を除いて、1 つのマクロ画面内の複数の記述子のオプション属性に異なる値を設定 (一部を true とし、残りを false と設定) しないでください。

uselogic 属性

<description> エレメントの uselogic 属性を使用すると、上記のセクションで説明したデフォルト結合メソッドで使用可能な複数の記述子間で、より複雑な論理関係を定義できます。

HATS では、マクロを記録すると、デフォルトの uselogic 属性が <description> タグに追加されます。この属性は、マクロをホスト端末またはマクロ・エディターで編集すると、再生成されます。ソース表示でマクロを編集した場合には、再生成されません。

注:
uselogic 属性を使用すると、マクロ・ランタイムは、 個々の記述子の invertmatch 属性と Optional 属性を無視します。

uselogic 属性の値は、単純化された論理式であり、その条件は、後続の記述子の 1 ベースのインデックスです。図 9 は、uselogic 属性を含む <description> エレメントの例を示しています (分かりやすくするために、<string> エレメントの属性の一部が省略されています)。

図 9. <description> エレメントの uselogic 属性の例
<description uselogic="(1 and 2) or (!1 and 3)" />
   <oia status="NOTINHIBITED" optional="false" invertmatch="false"/>
   <string value="&apos;Foreground&apos; row="5" col="8"/>
   <cursor row="18" col="19" optional="false" invertmatch="false"/>
</description>

図 9 において、uselogic 属性の値は次のとおりです。

(1 and 2) or (!1 and 3)

この論理式は、正規の論理式ではなく (条件演算子と論理演算子および式を参照)、uselogic 属性のみで使用される、単純化されたスタイルの論理式です。このスタイルの論理式の規則は、次のとおりです。

図 9 の例では、次のいずれかの状態が発生すると、マクロ・ランタイムは記述子が全体として true かどうかを判別します。

uselogic 属性を使用すると、マクロ・ランタイムは、 個々の記述子の invertmatch 属性と Optional 属性を 無視することに留意してください。

記述子

各タイプの記述子は、1 つのマクロ画面の <description> エレメント内にある個々の XML エレメントとして保管されます。

初めは、すべてのタイプの記述子を理解する必要はありません。 その代わりに、次のタイプのみを理解することから始めてください。

これらのタイプの記述子だけで、多くの、おそらく大部分のアプリケーション画面を確実に記述できます。 しかし、これらのタイプでは十分ではない場合は、他のタイプの記述子のいずれかを使用する必要があります。

表 10 は、すべてのタイプの記述子をリストし、1 つのマクロ画面 (具体的には、1 つの <screen> エレメントに属する 1 つの <description> エレメント) に存在できる、各タイプの記述子数を示しています。

表 10. 記述子のタイプ、各タイプで使用できる数
記述子のタイプ: マクロ画面ごとに使用できるこのタイプの記述子数
OIA 1 (必須)
フィールド数 0 または 1
入力フィールド数 0 または 1
ストリング記述子 0 またはそれ以上
カーソル記述子 0 または 1
属性記述子 0 またはそれ以上
条件記述子 0 またはそれ以上

以下のサブセクションでは、各タイプの記述子を詳しく説明しています。

OIA 記述子 (<oia> エレメント)

ほぼすべてのシナリオで、この記述子のデフォルト設定を受け入れることができます。デフォルト設定は NOTINHIBITED です。画面認識時には、次のことが行われます。

これらは、予期した結果です。 通常、入力禁止標識が設定されている間に、マクロ・ランタイムがマクロ画面を認識して、アクションの処理をただちに開始することを、ユーザーは希望しません。 (タイミングについて詳しくは、画面の完了を参照してください)。ただし、その問題の解決方法にかかわらず、ほとんどの場合、この記述子はデフォルト設定 (NOTINHIBITED) のままにしておく必要があります。

しかし、マクロ・ランタイムに入力禁止状態を無視させるシナリオの場合は、この記述子を DONTCARE に設定してください。

「フィールド数」記述子 (<numfields> エレメント)

「フィールド数」記述子は、3270 または 5250 フィールドという特定の数を指定します。「フィールド数」入力フィールドには、整数、または整数に評価される任意のエンティティー (例えば、変数、演算式、または外部 Java メソッドの呼び出し) を使用できます。

画面認識時にマクロ・ランタイムは次のことを行います。

  1. この記述子を評価し、整数の結果を取得する。
  2. アプリケーション画面 (現在の状態) 内のフィールド数をカウントする。
  3. この 2 つの数字を比較する。

2 つの数字が等しい場合、マクロ・ランタイムはこの記述子を true と評価します。 等しくない場合、マクロ・ランタイムはこの記述子を false として評価します。

マクロ・ランタイムがホスト端末上のフィールドをカウントするときには、入力フィールドを含む、すべてのタイプの 3270 または 5250 フィールドをカウントします。

この記述子を使用したくない場合は、「フィールド数」入力フィールドをブランクに設定してください。

「入力フィールド数 (Number of Input Fields)」記述子 (<numinputfields> エレメント)

「入力フィールド数」記述子は、上記のセクションで説明した「フィールド数」記述子と非常によく似ています。 違いは、「入力フィールド数」記述子が 3270 または 5250 入力フィールドの数を指定するのに対して、「フィールド数」記述子は、(入力フィールドを含む) すべてのタイプのフィールドの数を指定することです。

「入力フィールド数」フィールドには、整数、または整数に評価される任意のエンティティー (例えば、変数、演算式、または外部 Java メソッドの呼び出し) を使用できます。

画面認識時にマクロ・ランタイムは次の処理を行います。

  1. この記述子を評価し、整数の結果を取得する。
  2. アプリケーション画面 (現在の状態) 内の入力フィールド数をカウントする。
  3. この 2 つの数字を比較する。

2 つの数字が等しい場合、マクロ・ランタイムはこの記述子を true と評価します。 等しくない場合、マクロ・ランタイムはこの記述子を false として評価します。

この記述子を使用したくない場合は、「入力フィールド数」フィールドをブランクに設定してください。

ストリング記述子 (<string> エレメント)

ストリング記述子は、次の情報を指定します。

マクロ・ランタイムは、長方形のテキスト域全体を検索して、指定されたストリングを見つけます。 マクロ・ランタイムが長方形のテキスト域内でそのストリングを検出すると、ストリング記述子を true と評価します。 検出しない場合、ストリング記述子を false と評価します。

長方形域の指定

長方形のテキスト域を定義するには、対角戦場の隅の行と列の座標を指定します。これらの座標のデフォルト値は (1,1) と (-1,-1) です。これは、ホスト端末のテキスト域全体を示します。 -1,-1 などの負の値の意味については、行または列の負の値の意味を参照してください。 整数、または整数に評価される任意のエンティティー (例えば、変数、演算式、または外部 Java メソッドの呼び出し) を使用できます。

長方形の領域は、ストリングが入る大きさにするか、ストリングより大きくすることができます。 例えば、マクロ画面と一致させたいアプリケーション画面の長方形域 (6,20)、(6,37) に、ストリング 'Terminal and user parameters' があるとします。 この長方形域は、そのストリングがちょうど入る大きさです。 アプリケーション画面のこの位置に常にこのストリングがある場合、正確な長方形域を指定できます。

ただし、マクロ画面に突き合わせるアプリケーション画面のその領域内に同じストリング 'Terminal and user parameters' があっても、アプリケーション画面のどの行にそのストリングが含まれているかについては予測できないとします。この場合、長方形域 (1,1)、(-1,-1) を指定できます。これは、マクロ・ランタイムがアプリケーション画面のすべての行を検索して、その識別ストリングを見つけることを示します。

ストリング値の場合、ストリング、またはストリングに評価される任意のエンティティー (例えば、変数、式、または外部 Java メソッドの呼び出し) を使用できます。このストリングは、選択したマクロのフォーマット (基本または拡張) に必須な形式である必要があります。

画面認識時にマクロ・ランタイムは次のことを行います。

  1. 行と列の値を評価し、値ごとに整数の結果を取得する。
  2. ストリング値を評価し、ストリングの結果を取得する。
  3. 行と列の値によって指定されたアプリケーション画面 (現在の状態) 内の長方形のテキスト・ブロック内の任意の場所で、ストリングを探す。

マクロ・ランタイムが長方形のテキスト・ブロック内でストリングを見つけると、マクロ・ランタイムは、この記述子を true と評価します。見つからない場合、マクロ・ランタイムはこの記述子を false と評価します。

マクロ・ランタイムが長方形域を検索する方法 (Wrap 属性)

Wrap 属性が「false」(デフォルト設定) に設定されている場合、マクロ・ランタイムは、長方形域の各行を別々に検索します。このメソッドが有効なのは、ストリング全体が 1 つの行に入っている場合です。例えば、ストリングが Utility Selection Panel であり、長方形域が (1,1)、(24,80) である場合、マクロ・ランタイムは次のようにこのストリングを検索します。

  1. 長方形域の最初の行を取得する。 ストリングがこの行にあるかどうかを判別します。 ない場合は、次の行を検索します。
  2. 長方形域の 2 番目の行を取得する。 ストリングがこの行にあるかどうかを判別します。 ない場合は、次の行を検索します。
  3. 以降も同様です。

一方、Wrap 属性が「true」に設定されている場合、マクロ・ランタイムは、次のようにストリングを検索します。

  1. 長方形域のすべての行を取得し、それらを、順に連結する。
  2. 連結された行内にストリングがあるかどうかを判別する。

検索対象のストリングが、ホスト端末上のある行から次の行に折り返される可能性がある場合は、Wrap 属性を「true」に設定してください。この属性を、抽出アクションの Unwrap 属性と混同しないください。抽出アクションの Unwrap 属性は、テキスト・ブロックではなく、フィールドに基づきます (unwrap 属性を参照)。

次の記述は、Wrap 属性が「true」に設定されている例を示しています。

図 10 は、アプリケーション画面の行 14 から 18 を示しています。

図 10. アプリケーション画面の行 14 から 18
 6  Hardcopy    ハードコピー出力の開始
 7  Transfer    ISPF クライアント/サーバーまたは転送データ・セットのダウンロード
 8  Outlist     保留ジョブ出力の表示、削除、印刷
 9  Commands    アプリケーション・コマンド・テーブルの作成/変更
 *  Reserved    This option reserved for future expansion

図 10 では、各行の最初の文字がブランク・スペースになっています。例えば、行 14 では、先頭の 2 文字は ' 6' です。つまり、ブランクのスペースの後に数表示 6 が続いたものです。このアプリケーション画面で、次の長方形のテキスト・ブロックがあるかどうか検査するストリング記述子をセットアップするものとします。

Hardcopy
Transfer
Outlist
Commands
Reserved

この複数行のブロックのストリング記述子をセットアップする手順は、次のとおりです。

  1. 新規ストリング記述子を作成する。
  2. テキスト長方形の左上隅の行と列の位置を (14, 5) に、右下隅の行と列の位置を (18, 12) に設定する。
  3. ストリング値を設定する。 ストリング値は次のとおりです。
    'HardcopyTransferOutlist CommandsReserved'
  4. Wrap 属性を「true」に設定する。
  5. その他のすべての属性をデフォルト設定のままにする。

上記のステップ 3 では、5 つの行が 1 つのストリングに連結され、充てん文字 (例えば、改行や末尾のスペース) は追加されないことに注意してください。 しかし、このストリングには、'Outlist' の後のブランクのスペースが含まれます。これは、そのブランクのスペースが、長方形の境界内に含まれるからです。

ストリング記述子における抽出ストリングの使用

抽出アクションを使用して、画面からのテキストをストリング変数に読み取る場合 (抽出アクション (<extract> エレメント)を参照)、以降の画面で、ストリング記述子の「ストリング」入力フィールドでそのストリング変数を使用できます。

例えば、ScreenA で、抽出アクションを使用して、ホスト端末から $strTmp$ という名前のストリング変数に、会社名を読み取ることができます。その後、ScreenB では、ストリング記述子で検索されるストリングとして $strTmp$ を使用できます。

これを実行できるのは、Wrap 属性が「true」に設定されている場合に、複数行のテキストを抽出するときです。

同じ <description> エレメント内の複数のストリング記述子

同じ <description> エレメント内に複数のストリング記述子を作成できます。信頼性の高い記述を作成するには、必要な数のストリング記述子を使用する必要があります。

同じ <description> エレメントで、同じ長方形のテキスト・ブロックに対して 2 つの異なるストリングを定義することもできます。 これを実行できるのは、マクロ画面に対応するアプリケーション画面が、同じロケーションに異なるストリングを、異なる時間に表示する場合です。 しかし、同じ長方形のテキスト・ブロックに 2 つの異なるストリングを定義する場合、両方のストリングが必須でない (両方ともオプションである) ことを指定するように注意してください。

カーソル記述子 (<cursor> エレメント)

カーソル記述子は、アプリケーション画面上の行と列の位置 (例えば、行 10 と列 50) を指定します。 行の値と列の値のどちらにも、整数、または整数に評価される任意のエンティティー (例えば、変数、演算式、または外部 Java メソッドの呼び出し) を使用できます。

画面認識時にマクロ・ランタイムは次のことを行います。

  1. 行の値を評価し、整数の結果を取得する。
  2. 列の値を評価し、整数の結果を取得する。
  3. アプリケーション画面 (現在の状態) 内のテキスト・カーソルの行と列の位置を調べる。
  4. 記述子内の行と列の位置を、アプリケーション画面のテキスト・カーソルの行と列の位置と比較する。

2 つの位置が同じである場合、マクロ・ランタイムはこの記述子を true と評価します。 条件式が false に評価される場合、マクロ・ランタイムはこの記述子を false と評価します。

属性記述子 (<attrib> エレメント)

属性記述子は、3270 または 5250 属性、およびアプリケーション・ウィンドウ上の行と列の位置を指定します。

画面認識時に、マクロ・ランタイムは、指定された属性 (例えば、0x3) を、指定された行と列にある実際の属性と比較します。 これらの属性が同じである場合、マクロ・ランタイムはこの記述子を true と評価します。 異なる場合、マクロ・ランタイムはこの記述子を false と評価します。

属性以外は非常によく似ている 2 つのアプリケーション画面を区別しようとするときに、この記述子は便利です。

条件記述子 (<condition> エレメント)

条件記述子は、マクロ・ランタイムが画面認識時に評価する条件式 (例えば、$intNumVisits$ == 0) を指定します。条件式の詳細については、条件演算子と論理演算子および式を参照してください。

画面認識時にマクロ・ランタイムは、条件式を評価し、ブール結果を得ます。

条件式が true に評価される場合、マクロ・ランタイムはこの記述子を true と評価します。 条件式が true に評価されない場合、 マクロ・ランタイムはこの記述子を false と評価します。

条件記述子は、マクロ・ランタイムが、1 つ以上の変数の値、または Java メソッドの呼び出しの結果に基づいて、次に処理されるマクロ画面を判別できるようにすることによって、画面認識の柔軟性と能力を向上させます。

カスタム記述子 (<customreco> エレメント)

カスタム記述子では、カスタム記述コードを呼び出すことができます。

カスタム記述子を作成するには、ソース表示を使用して、<customreco> エレメントを 1 つマクロ画面の <description> エレメントに追加する必要があります。このエレメントについて詳しくは、<customreco> エレメントを参照してください。

注:
HATS マクロの画面記述子でカスタム画面認識を使用している場合で、そのマクロが <playmacro> アクションを介して別のマクロ内から呼び出されている場合は、そのカスタム画面認識のロジックは正しく機能しません。

HATS は、チェーンの先頭のマクロ内のカスタム認識イベントに対するリスナーとしてのみ登録できます。HATS は、そのチェーン内の後続のマクロに対するリスナーとしては登録できません。

この問題を解決するには、HATS カスタム画面認識を使用する際は、チェーンされていないマクロを使用します。

変数更新アクション (<varupdate> エレメント)

変数更新項目は記述子ではありません。マクロ言語により <description> エレメント内で発生するのを許可されているアクションです。

<description> エレメント内の変数更新アクションは、<actions> エレメントで実行するのと同じタイプの操作を実行します。つまり、指定された値を指定された変数に保管します。

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

説明内の変数更新アクションの処理

変数更新アクションが <description> エレメント内にあるときに、マクロ・ランタイムが 1 つ以上の変数更新アクションを処理する方法に注意してください。

  1. マクロ・ランタイムは、すべての変数更新アクションの順番が先頭であるかのように、これらのアクションをただちに実行する。
  2. その後、マクロ・ランタイムは、説明内の残りの項目 (記述子) を通常どおりに評価し、全体的なブール結果を得る。 変数更新アクションは、ブール結果に影響しません。

上記で説明したように、マクロ・ランタイムは、マクロ画面をアプリケーション画面と一致させる前に、画面認識プロセスを複数回実行する場合があります (繰り返し画面評価を参照)。 したがって、<description> エレメントに 1 つ以上の変数更新アクションが含まれている場合、マクロ・ランタイムは、<description> エレメントを評価するたびに、変数更新アクションを実行します。

例えば、マクロが再生中であり、画面名 ScreenB が有効な次画面のリスト上にあり、図 11 に表示されているような <description> エレメントが ScreenB に含まれているとします。

図 11. ScreenB の <description> エレメント
<description>
   <oia status="NOTINHIBITED" optional="false" invertmatch="false" />
   <varupdate name="$intUpdate$" value="$intUpdate$+1" />
   <attrib value="0x4" row="1" col="1" plane="COLOR_PLANE" optional="false"
               invertmatch="false" />
</description>

マクロ・ランタイムが ScreenB を現行のアプリケーション画面と突き合わせようとするたびに、次のことを行います。

  1. マクロ・ランタイムは <varupdate> アクションを見てそのアクションを実行し、$intUpdate$ の値を 1 つ大きくします。
  2. マクロ・ランタイムは、<oia> 記述子と <attrib> 記述子を評価し、<description> エレメント全体のブール結果を得る。

uselogic 属性を使用した変数更新

<description> エレメント内の変数更新アクションを、先頭以外の順序でマクロ・ランタイムに実行させたい場合は、デフォルト結合規則ではなく、<description> エレメントの uselogic 属性を使用して、実行の順序を変更できます (uselogic 属性を参照)。

uselogic 属性で変数更新アクションが使用される場合は、次のようになります。