Bamboo サーバ・ビルドでの UFT One テストの実行

Bamboo サーバ・ビルド・プロセスに UFT One テストを追加するには，ビルド・ジョブからビルド・タスクとしてテストを追加します。手順を開始する前に，ビルド・プロジェクト，プラン，ジョブがすでに作成されている必要があります。

ローカルの UFT One テストの実行

Bamboo からローカルの UFT One テスト実行をトリガします。

次の手順を実行します。

  1. Bamboo ビルド・プランで，タスクを追加します。

  2. ［Task types］ウィンドウで，［Tests］表示枠を開き，［UFT One File System Execution］タスクを選択します。

    ビルド・プランの一部として，新しい空のタスクが追加されます。

  3. UFT OneFile System Execution タスクに次の詳細情報を設定します。

    Task description（オプション） タスクの目的を理解するための説明。
    Tests

    テスト，テスト・バッチ・ファイル，または実行するテストが格納されたフォルダ。

    このフィールドでは，1 行につき，テスト，テスト・バッチ・ファイル（.MTB ファイル名），またはテストを実行するマシン上のフォルダへのパスを 1 つ入力します。

    必要に応じて複数のテストを入力できます。

    オプションで，テスト・バッチ・ファイル内の各テストに渡すテスト・パラメータを指定します。

    同じテストをパラメータを変えて複数回入力することもできます。

    バッチ・ファイルに .mtbx という拡張子を付けます。以下は，構文の例です。

    <Mtbx>
 <Test name="test1" path="c:\tests\APITest1">
 <Parameter name="A" value="abc" type="string"/>
 ….
 </Test>
 <Test name="test2" path="${WORKSPACE}\test2">
  <Parameter name="p1" value="123" type="int"/>
  <Parameter name="p4" value="123.4" type="float"/>
  ….
 </Test>
</Mtbx>
    Timeout

    テストの開始または実行に問題がある場合に待機する時間（秒単位）。

    フィールドを空白のままにすると，タイムアウトは発生しません。
    Archive and publish test run results

    テスト実行が完了した後，テスト実行結果をどのように処理するかをサーバに指示します。次のいずれかを選択します。

    • Always archive test reports：成功したテストと失敗したテストの実行結果をすべて保存します。

    • Do not archive test reports：テスト・ステータスに関係なく，実行結果は保存されません。

    • Archive test reports for failed tests：失敗したテストの結果のみが保存されます。

    注: Digital Lab（UFT Mobile） を介してテストを実行する場合は，UFT One ヘルプセンターのモバイル・テストと Bamboo の統合セクションを参照してください。

  4. 完了したら，設定を保存します。

    ビルドが実行されると，テストは指定された設定でビルド・タスクとして実行されます。ビルド・プロジェクトの［Artifacts］タブに新しいアーティファクトが追加されます。

    テストの実行後，関連するビルド・ログがビルド実行結果の［Logs］タブに保存されます。テスト実行の詳細と実行結果へのリンクを表示できます。

    実行結果ファイルの名前には実行のタイムスタンプが含まれており，それは Bamboo システム変数 bamboo.buildTimeStamp と一致します。これにより，特定の結果ファイルをオートメーション・スクリプトでより簡単に参照できます。

UFT One のテスト実行結果の表示

テストの実行後，UFT One は，指定された場所に実行結果を自動的に保存します。UFT One［オプション］ダイアログ・ボックスの［実行セッション］表示枠で実行結果固有の設定を指定します（［ツール］＞［オプション］＞［一般］タブ＞［実行セッション］ノード）。

実行結果を表示するには，次の手順を実行します。

  1. ［Artifacts］タブで，該当するアーティファクトのリンクをクリックしてレポートをダウンロードします。

  2. 実行結果ファイルを展開して開き，次のいずれかのオプションを実行します。

    • run_results.html ファイルを開いて，実行結果を表示します。

    • Run Results Viewer で，Results.xml ファイルを選択して開きます。

    実行結果ファイルの名前には実行のタイムスタンプが含まれており，それは Bamboo システム変数 bamboo.buildTimeStamp と一致します。これにより，特定の結果ファイルをオートメーション・スクリプトでより簡単に参照できます。

複数のテスト・タスクを追加した場合，タスクの先頭にある 3 桁の ID でそれぞれのタスクを区別します。これらの ID は，［Artifacts］タブでアーティファクトを表示すると確認できます。

例：

先頭に戻る

ALM からの UFT One テストの実行

Bamboo を使用して，ALM に格納されているテストの UFT One テスト実行をトリガします。

次の手順を実行します。

  1. ビルド・プランで，タスクを追加します。

  2. ［Task types］ウィンドウで，［Tests］表示枠を開き，［UFT One ALM Execution］タスクを選択します。

    ビルド・プランの一部として，新しい空のタスクが追加されます。

  3. タスクについて，次の情報を入力します。

    Task description（オプション） タスクの目的を理解するための説明。

    ALM Server

    テストの実行元となる ALM サーバ。

    ALM サーバ・アドレスは，http://<ALM サーバ名または IP>:<port>/qcbin の形式で指定する必要があります。
    ALM Connectivity

    ALM サーバに必要な認証タイプに応じて，資格情報はユーザ名とパスワード，または SSO 認証用の API キーになります。

    • ユーザ名とパスワード：

      User name：サーバへのアクセスに使用する ALM ユーザ名。

      Password：上で指定した ALM ユーザのパスワード。

    • SSO 認証（ALM 15.0 以降，UFT One Bamboo アドオン・バージョン 1.6 以降）：

      ［SSO enabled］を選択します。

      ALM サイト管理者から入手したクライアント ID と API キー・シークレットを入力します。

    このタスクで指定した ALM ユーザまたはクライアントが，UFT One テストを開いて実行するための適切な権限を持っていることを確認します。

    権限の詳細については，ALM ヘルプセンターを参照してください。
    Domain テストを含むプロジェクトが格納されている ALM サーバのドメイン。
    Project テストが格納されたプロジェクト。
    Test sets

    このビルド・タスクで実行するテスト・セット。テスト・セットへの完全な ALM パスを提供する必要があります。

    1 つの行に入力できるテスト名またはフォルダは，1 つだけです。
    Timeout

    テストの開始または実行に問題がある場合に待機する時間（秒単位）。

    フィールドを空白のままにすると，タイムアウトは発生しません。
    詳細設定

    次のいずれかの場所から Run mode を指定できます。

    • Run locally：ビルドと同じコンピュータでテストを実行します。

    • Run on planned host：リモートの UFT One コンピュータで（スケジュールされたテスト実行の一部として）テストを実行します。

    • Run remotely：リモートの UFT One コンピュータでテストを実行します（スケジュールされた実行ではありません）。

    リモート・コンピュータ・オプションのいずれかを選択する場合は，テストを実行するホストを指定します。

    リモート・コンピュータで実行するには，［オプション］ダイアログ・ボックスの［テスト実行］表示枠（［ツール］＞［オプション］＞［GUI テスト］タブ＞［テスト実行］タブ）で［他の Micro Focus 製品でテストおよびコンポーネントを実行可能にする］オプションを設定する必要があります。

    機能テスト・セットは，ALM ラボ管理から実行することをお勧めします。ALM から実行する場合，以下の制限があります。

    • 機能テスト・セットは，予定ホストでの実行はサポートされていません。

    • 各テストの実行結果を取得できるのは，機能テスト・セットをローカルまたはリモート・ホストで実行する場合のみです。

  4. 既存の設定を保存します。

    ビルドが実行されると，テストは指定された設定でビルド・タスクとして実行されます。

    テストの実行後，テスト実行タスクに関連するビルド・ログは，ビルド実行結果の［Logs］タブで確認できます。テスト実行の詳細と実行結果へのリンクを表示できます。

    実行結果ファイルの名前には実行のタイムスタンプが含まれており，それは Bamboo システム変数 bamboo.buildTimeStamp と一致します。これにより，特定の結果ファイルをオートメーション・スクリプトでより簡単に参照できます。

  5. テスト実行結果を表示します。

    テストの実行後，UFT One は実行結果を Bamboo サーバに自動的に保存します。ビルドの［Artifacts］タブでは，ALM プロジェクトのテスト実行へのリンクを含む html ファイルを表示できます。

先頭に戻る

ALM テスト・ラボからの UFT One テストの実行

Bamboo を使用して，ALM テスト・ラボ内のテストの UFT One テスト実行をトリガします。

次の手順を実行します。

  1. （オプション）テストを実行する前に，テスト対象のアプリケーションの環境の詳細を設定することをお勧めします。これを行うには，ビルド・プランにビルド・タスクを追加します。

    詳細については，アプリケーション環境の設定を参照してください。

  2. ビルド・プランで，タスクを追加します。

    ［Task types］ウィンドウで，［Tests］表示枠を開き，［UFT One ALM ラボ管理］タスクを選択します。

    ビルド・プランの一部として，新しい空のタスクが追加されます。

  3. タスクについて，次の情報を入力します。

    Task description（オプション） タスクの目的を理解するための説明。
    ALM Server

    テストの実行元となる ALM サーバ。

    ALM サーバ・アドレスは，http://<ALM サーバ名または IP>:<port>/qcbin の形式で指定する必要があります。
    ALM Connectivity

    ALM サーバに必要な認証タイプに応じて，資格情報はユーザ名とパスワード，または SSO 認証用の API キーになります。

    • ユーザ名とパスワード：

      User name：サーバへのアクセスに使用する ALM ユーザ名。

      Password：上で指定した ALM ユーザのパスワード。

    • SSO 認証（ALM 15.5 以降，UFT One Bamboo アドオン・バージョン 1.6 以降）：

      ［SSO enabled］を選択します。

      ALM サイト管理者から入手したクライアント ID と API キー・シークレットを入力します。

    このタスクで指定した ALM ユーザまたはクライアントが，UFT One テストを開いて実行するための適切な権限を持っていることを確認します。

    権限の詳細については，ALM ヘルプセンターを参照してください。
    Domain テストを含むプロジェクトが格納されている ALM サーバのドメイン。
    Project

    テストが格納されたプロジェクト。

    選択したプロジェクトは，UFT One テストのサーバ側の実行が有効になっている必要があります。

    サーバ側の実行の詳細については，Application Lifecycle Management ユーザーズ・ガイドを参照してください。
    Run type

    次のいずれかの実行タイプを選択します。

    • Test set

    • Build verification suite

    テスト・ステップとビルド検証スイートの詳細については，Application Lifecycle Management ユーザーズ・ガイドを参照してください。
    Test Set/Build Verification Suite ID

    選択したテスト・セットの ALM ID またはビルド検証スイート ID。

    テスト・セットの場合は，機能テスト・セットを選択し，サーバ側で実行できるように準備する必要があります。

    詳細については，『Application Lifecycle Management ユーザーズ・ガイド』を参照してください。
    Description テスト・セットまたはビルド検証スイートの説明（ALM に入力されている値）。
    Timeslot Duration テスト・セットまたはビルド検証スイートをスケジュールに基づいて実行するために予約されたスロットの期間。
    Environment Configuration ID

    ALM に入力されたアプリケーション環境設定の ID。

    ALM でこの ID を見つけるには，エンティティを右クリックし，URL をコピーして，テキスト・エディタに貼り付けます。

    URL の最後にある EntityID に関連付けられた番号を使用します。

  4. 設定を保存します。

    ビルドが実行されると，テストは指定された設定でビルド・タスクとして実行されます。

    テストの実行後，関連するビルド・ログがビルド実行結果の［Logs］タブに保存されます。テスト実行の詳細と実行結果へのリンクを表示できます。

    実行結果ファイルの名前には実行のタイムスタンプが含まれており，それは Bamboo システム変数 bamboo.buildTimeStamp と一致します。これにより，特定の結果ファイルをオートメーション・スクリプトでより簡単に参照できます。

先頭に戻る

セキュリティ上の注意

機密情報は暗号化とエンコーディングが施されますが，Micro Focus は，Bamboo ジョブによって生成された不要な設定ファイルを定期的に削除することをお勧めします。これらのファイルが，Micro Focus の Bamboo CI プラグインによって削除されることはありません。

これらのファイルは，<Bamboo ホームディレクトリ>\xml-data\build-dir\<ジョブ名> フォルダに格納されています。

ファイルを削除しない場合，システムのセキュリティ・リスクが増大する可能性があります。お客様は，関連するすべてのリスクを引き受け，Micro Focus を免責することに同意するものとします。

お客様側の規制およびビジネス要件の評価は，常にお客様の責任になります。Micro Focus は，Micro Focus の製品がお客様のビジネスを遂行する上でお客様に適用される特定の法的基準または規制基準に準拠していることを表明も保証もしません。

先頭に戻る