HOST モジュールを作成する

この章では、独自の HOST モジュールを作成する方法と、これらの HOST コントロールをスキャンする方法を説明します。

標準サブセットには、 HOST Engine 3.0 の特定のタスクを実行するモジュールが含まれています。詳細情報については、 see chapter "HOSTModules" 。

HOST コントロールの操縦方法については、 see chapter "ホストエンジン3,0 コントロールを操縦" 。

HOSTアプリケーションをスキャンする

HOST モジュールを作成するには、アクティブで接続されている HOST セッションをTosca  XScan でスキャンします。

これを行うには、「モジュール」フォルダを右クリックして、「スキャン」->;「リモートターミナル」の順に選択してください。または、ダイナミックメニュー「モジュール」をクリックして、 ="" ctype="x-Xpt" equiv-text='lt;span class="UI_Element"gt;' id="4"> 「スキャン」-;「リモートターミナル」の順に選択するか、キーボードのショートカット Ctrl + Shift + T を使用します。

HOST セッションモードを選択する

HOST Engine 3.0 では、エミュレータおよびヘッドレスのセッションモードでモジュールを作成できます。

HOST エミュレータセッション

エミュレータセッションは、アクティブな HOST エミュレータ接続を使用して、エミュレータ経由でメインフレームアプリケーションをナビゲートします。

エミュレータセッションは、ASCIIと日本語の文字セットにサポートしています。日本語の文字については、まず、プロジェクト設定でサポートを有効にしてください。エミュレータでは見えない文字がスキャンに表示される可能性があります。

エミュレータセッションを開始するには、以下の手順に従ってください。

  1. エミュレータがセッションに接続されていることを確認します。

  2. 「 ホストスキャン」ウィンドウで、「接続設定」のドロップダウンリストから「エミュレータセッションに接続」を選択します。

  3. 「 接続」をクリックします。

  4. エミュレータに移動して、メインフレームアプリケーションをナビゲートします。

HOST ヘッドレスセッション

ヘッドレスセッションは、アクティブな HOST ヘッドレス接続を使用して、「ホストスキャン」ウィンドウでメインフレームアプリケーションをナビゲートします。ヘッドレスセッションはASCIIの文字セットのみをサポートしています。

ヘッドレスセッションを開始するには、以下の手順に従ってください。

  1. 「 ホストスキャン」ウィンドウで、「接続設定」に接続名を入力します。

  2. HOST のポートを追加します。

  3. HOST Engine3.0 と HOST サーバー間の通信に許可される最大時間を設定します。

  4. HOST のエンドポイントを指定します。

  5. 「 接続」をクリックします。

  6. メインフレームアプリケーションをスキャンする準備が整いました。

    パスワードやユーザークレデンシャルのような機密情報を入力する予定がある場合は、リボンメニューの「パスワードを入力」ボタンを使用してください。これにより、機密データを別のフィールドに入力することができ、入力内容を画面に表示されずに、メインフレームに安全に送信されます。

「Hostスキャン」ウィンドウ

HOST コントロールの文字

Toscaは HOST コントロールのすべての高さと幅を文字単位で測定します。

「 Hostスキャン」ウィンドウでコントロール領域を選択する場合は、全角文字で区切らないでください。全角文字は、標準の1文字単位ではなく、2文字単位を占めます。Host コントロールを正確にスキャンするには、この点に注意することが重要です。

日本語の文字サポートを有効にする

HOST エミュレータセッションで日本語の文字サポートを使用するには、以下の手順に従ってください。

  1. 「 プロジェクト」->;「設定」の順に進み、ワークスペース内の「設定」ダイアログを開きます。

  2. 「 設定」->「TBox」->;「エンジン」に、「ホスト」という新しいカテゴリを作成します。

  3. 「CodePage 」という名前で「 932 」という値を持つ新しい設定を作成します。

日本語文字サポートを有効にする新しい設定を作成

これでエミュレータセッションを開始できます。

HOST ラベル をスキャンする

コントロールラベルを使用すると、 HOST アプリケーション内のメッセージ操縦することができます。

このコントロールを作成するには、以下の手順に従ってください。

  1. 「 HOST スキャン」ウィンドウで、  ラベルを選択します。

  2. 「 コンテンツプレビュー」領域で、テキストのある行を強調表示します。Tricentis Toscaは自動的に以下のプロパティを使用して制御するを定義します：

    • Height はラベルの高さを指定します。

    • Width はラベルの幅を指定します。

    • Column は、ラベルの開始列の画面上の位置を指定します。

    • Row は、ラベルの開始行の画面上の位置を指定します。

  3. 「  画面を終了」をクリックしてから、「

HOST テキストボックス をスキャンする

コントロール「テキストボックス」を使用すると、 HOST アプリケーションでテキストを操縦したり、キーボードコマンドを実行したりできます。

このコントロールを作成するには、以下の手順に従ってください。

  1. 「 HOST スキャン」ウィンドウで、「  テキストボックス」を選択します。

  2. 「 テキストボックスを検索」をクリックしてテキストボックスを検索するか、「コンテンツプレビュー」領域でコンテンツを強調表示します。Tricentis Toscaは、以下のプロパティを自動的に使用して、テキストボックスの定義と配置を行います。

    • Height は、コントロール全体の高さを指定します。

    • Width は、コントロール全体の幅を指定します。

    • Column は、コントロールの開始列の画面上の位置を指定します。

    • Row は、コントロールの開始行の画面上の位置を指定します。

  3. 「  画面を終了」をクリックしてから、「

HOST テーブルをスキャン する

テーブルを操縦するためのモジュールを作成するには、以下の手順に従ってください。

  1. 「 HOST スキャン」ウィンドウで、「  テーブル」を選択します。

  1. デフォルトでは、Tricentis Toscaはすべての行を1行として数えます。テーブルの各行に異なる高さを選択したい場合は、次のプロパティを使用します：

    • RowHeigh は行の高さを指定します。デフォルト値は 1 です。

  2. 「  領域」を選択し、「コンテンツプレビュー」領域でテーブルの外側の領域を強調表示します。または、「プロパティ」ペインでこの領域を手動で定義することもできます。

    Tricentis Toscaは、以下のプロパティを使用してテーブルを定義し、配置します：

    • Height は、テーブル全体の高さを指定します。

    • Width は、テーブル全体の幅を指定します。

    • Column は、テーブルの開始列の画面上の位置を指定します。

    • Row は、テーブルの開始行の画面上の位置を指定します。

    • NoScroll は、テーブルが複数の画面にまたがるかどうかを指定します。デフォルト値は False です。

    • ScrollForwardKey は、テーブルを前方にスクロールするキーを指定します。デフォルト値は {F8} です。

    • ScrollBackwardsKey は、テーブルを後方にスクロールするキーを指定します。デフォルト値は {F7} です。

  3. 「  列」を選択し、「コンテンツプレビュー」領域でテーブルの列を定義します。または、「プロパティ」ペインでこの列を手動で定義することもできます。

    Tricentis Toscaは、テーブルのカラムを識別するために以下のプロパティを使用します：

    • ColStartList は、コントロール座標を基準に各列の最初の文字を表すカンマで区切られたリストです。このプロパティは常に 1 で始まります。

  4. デフォルトでは、Tricentis Toscaは最初の行をテーブルのヘッダーとして使用します。異なる行をヘッダーとして使用する場合は、「  ヘッダー」を選択し、「コンテンツプレビュー」領域で定義します。または、「プロパティ」ペインでヘッダーを手動で定義することもできます。

    Tricentis Toscaは、以下のプロパティを使用してテーブルのヘッダーを識別します：

    • HeaderRow は、テーブルにヘッダーがあるかどうかを指定します。ヘッダーのないテーブルの場合、デフォルト値は -1 です。ヘッダーを定義すると、この値は 1 に変わります。

    • HeaderHeight は、テーブルの最上部から数えたヘッダーの高さを指定します。デフォルト値は 0 です。

  5. 「  画面を終了」をクリックしてから、「

間違ったスクリーンショットとともにHOSTモジュールを保存しない

Tricentis Toscaは、 HOST Engine 3.0 で作成したモジュールを、添付のスクリーンショットとともに保存します。添付の画像は、「画面を終了」をクリックした際にプレビュー画面に表示されていたコンテンツです。

HOST エミュレータで別の画面に移動した場合、 HOSTスキャンのコンテンツプレビューの画像は自動的には変更されません。その結果、間違った画像でモジュールを保存してしまうことがあります。

間違ったスクリーンショットのファイルが添付されたモジュールを保存するのを避けるには、以下の手順に従ってください。

  1. エミュレータの別の画面に移動する前に、「画面を終了」をクリックします。

  2. HOST エミュレータで希望の画面に移動します。

  3. 「 画面をスキャン」をクリックし、その画面でスキャンしたいコントロールを選択します。HOSTスキャンのコンテンツプレビューの画像が、正しいエミュレータ画面の表示に切り替わります。