Azure DevOps Server または Azure DevOps Services を使用したローカル・テストのトリガ

このトピックでは，Azure DevOps Server（旧称 TFS）からローカル・マシンに保存されている UFT One テストをトリガする方法について説明します。

注: このトピックでは，UFT One Azure DevOps 拡張機能 バージョン 5.* を使った作業について説明します。最新の機能を活用するため，既存のタスクのバージョンを 5.* に更新することをお勧めします。この拡張機能バージョンを使用する場合は，ADM-TFS-Extension GitHub リポジトリから，対応する UFT.zip ファイルをインストールしたことを確認してください。

ローカル・マシンに保存されたテストの実行

Azure DevOps Server で，次の手順を実行します。

  1. パイプラインを作成します（注：TFS を使用している場合は，この手順をスキップしてください）。

    1. 空のジョブ・テンプレートを使用して，ビルド・パイプラインまたはリリース・パイプラインを作成します。

      注：ビルド・パイプラインは，リリース・パイプラインを明示的に作成しない場合に作成されるパイプライン・タイプです。

    2. テストを実行するエージェントが含まれているエージェント・プールを選択します。

    3. パイプライン変数に，UFT_LAUNCHER 変数を追加します。変数の値には，UFTWorking フォルダへの完全パスを指定します。

    詳細については，Microsoft Azure のドキュメントを参照してください。

  2. UFT Oneタスクを追加し，ビルド順序の適切な位置にステップを配置します。

    注: リリース・パイプラインを使用している場合は，関連するステージにタスクを追加してから，ビルドにステップを配置します。

    1. ［Task catalog］領域で，［Test］タブを選択します。利用可能なすべてのテスト・タスクのリストが表示されます。

    2. ［Test］タブから，［UFT One File System Run］タスクを選択し，［Add］をクリックします。ビルド・パイプラインの一部として，新しい空のタスクが追加されます。

      注: リリース・パイプラインを使用している場合は，タスクはデプロイメント・プロセスの一部として追加されます。

  3. ビルド・ステップについて，次の情報を入力します。

    Display name

    Azure DevOps Server CI システムの標準設定では，設定済みの記述子がタスクに使用されます。ステップにわかりやすい名前を付けます。

    Testsテスト，テスト・バッチ・ファイル，または実行するテストが格納されたフォルダ。複数のテストの場合，テストのパス，名前，またはテスト結果のパスをコンマで区切る必要があります。
    Timestamp pattern

    ［Extensions］タブでレポートに使用されるタイムスタンプ・フィールドの値の形式を定義します。

    標準設定値は yyyy- MM-dd HH:mm:ss です。

    Timeout

    テストの開始または実行に問題がある場合に待機する時間（秒単位）。フィールドを空白のままにすると，タイムアウトは発生しません。

    Cancel run on first failure

    テスト実行の 1 つのテストが失敗した場合にジョブ全体をキャンセルするかどうかを選択します。

    Generate 'Failed Tests' report

    失敗したテスト・ステップに関する情報を提供するレポートを生成するかどうかを選択します。実行後，レポートは［Extensions］タブにあります。

    別の方法として，テストとそのパラメータのリストを含むバッチ・ファイルを示します。

    • 複数のテストを指定するか，同じテストをパラメータを変えて複数回指定します。
    • reportPath パラメータを使用して，テスト結果のパスを定義します。

    バッチ・ファイルは，拡張子を .mtbx にして，次の構文を使用します。

    <Mtbx>
 <Test name="test1" path="c:\tests\APITest1">
 <Parameter name="A" value="abc" type="string"/>
 ....
 </Test>
 <Test name="test2" path="c:\tests\test2">
  <Parameter name="p1" value="123" type="int"/>
  <Parameter name="p4" value="123" type="float"/>
   ....
 </Test>
 <Test name="test3" path="c:\tests\APITest3" reportPath="c:\reports\APITest3">
</Mtbx>

  4. （オプション）UFT One のテスト結果情報を Azure Storage の場所にアップロードするように実行ステップを設定します。

    UFT One の結果を Azure Storage にアップロードすると，テストの実行後に Azure DevOps ポータルから結果にアクセスできます。

    Azure Storage を UFT One テスト結果用にセットアップで説明されている手順を実行したことを確認します。

    次に，UFT One File System Run ビルド・ステップで次のオプションを入力します。

    Do you want to upload the UFT report to the storage account?

    ［Yes］を選択します。

    Artifacts to upload

    html 実行結果レポートのみをアップロードするか，すべての UFT One 結果ファイルのアーカイブをアップロードするか，またはその両方をアップロードするかを選択します。

    注: API テストを実行するときは，アーカイブをアップロードすることをお勧めします。これは，スタンドアロンの html 実行結果レポートには，キャプチャされたデータに関する情報が含まれていないためです。RequestBody および HttpRawRequest ステップの内容は，アーカイブに含まれている html ファイルにあります。

    Report file name

    パイプライン名とビルド番号に基づいた標準設定のファイル名をそのまま使用するか，任意の名前を入力します。

  5. ローカル・モバイル・テストを実行するために，Digital Lab（UFT Mobile） のオプションを設定します。

    ServerDigital Lab（UFT Mobile） サーバのアドレスを，http[s]://<サーバ名>:<ポート> の形式で指定します。
    Authentication type

    Digital Lab（UFT Mobile） への接続に使用する認証モードを選択します。

    • Basic authentication：ユーザ名とパスワードを使用して認証します。

    • Access key authentication：Digital Lab（UFT Mobile） から受け取ったアクセス・キーを使用して認証します。

    ［Basic authentication］を選択した場合：

    • User name と Password：Digital Lab（UFT Mobile） サーバのログイン資格情報を入力します。

    • Tenant Id：Digital Lab（UFT Mobile） サーバのテナント ID を入力します。

    ［Access key authentication］を選択した場合：

    • Access key：Digital Lab（UFT Mobile） から受け取ったアクセス・キーを入力します。

    • Use proxy settings：プロキシを使用した接続を選択します。

      Proxy Server：プロキシ・サーバのアドレスを，<プロキシ・サーバ名>:<ポート> の形式で指定します。

      Use proxy credentials：特定のアカウントを使用して Digital Lab（UFT Mobile） サーバに接続できるようにします。

      プロキシ・ユーザ名とパスワード：［Use proxy credentials］が選択されている場合に，Digital Lab（UFT Mobile） サーバへの接続に使用される資格情報です。

    Device

    モバイル・テストのデバイス情報を指定します（DeviceID，Manufacturer，Model，OSType，OSVersion など）。

    これらのフィールドの値を取得するには，UFT Mobile Get Resources タスクを実行します。

    DeviceID の値が指定されている場合，他のフィールドは無視されます。

    例：

    DeviceID: "123456789"

    Manufacturer: "Samsung", Model: "SM-G920F"

    OSType: "ANDROID", OSVersion: "7.0"

    Launch on start

    テストの開始時に自動的に起動するアプリを選択します。

    • Home Screen：デバイスのホーム画面。

    • System App：カメラなど，デバイスにプリインストールされたシステム・アプリケーション。

    • UFT Mobile App：Digital Lab（UFT Mobile） でホストされるアプリケーション。

    System Application：デバイス上でテストするシステム・アプリケーションを指定します。

    Main UFT Mobile Application：［UFT Mobile App］を選択した場合，テストするメイン・アプリケーションを指定します。

    値の形式は，「Identifier: "<アプリ識別子>", Packaged: "<Yes/No>"」とする必要があります。Identifier は必須で，Packaged はオプションです。アプリ識別子を取得するには，UFT Mobile Get Resources タスクを実行します。

    Additional UFT Mobile Applications

    テストする追加のアプリケーションを指定します。

    値の形式は，「Identifier: "<アプリ識別子>", Packaged: "<Yes/No>"」とする必要があります。Identifier は必須で，Packaged はオプションです。アプリ識別子を取得するには，UFT Mobile Get Resources タスクを実行します。

    Install選択すると，テストの開始時にアプリケーションがインストールされます。
    Restart選択すると，テストの開始時にアプリケーションが再起動されます。
    Uninstall選択すると，テストの終了時にアプリケーションがアンインストールされます。

  6. このステップについて，次のような CI システムの制御オプションを設定します。

    Enabledステップをこのビルドの一部として実行するかどうかを指定します。
    Continue on errorこのステップでエラーが発生した場合に，ビルドを停止するか，続行するかを CI システムに指示します。

  7. パイプラインを実行するように設定します。

    ビルド・パイプライン：パイプラインを保存してキューに格納します。

    リリース・パイプライン：リリースを作成してパイプラインをデプロイします。

    パイプラインが実行されると，UFT One テストは追加したタスクの一部として実行されます。

先頭に戻る

テスト結果の表示

テストの実行後，次の方法で実行結果を表示できます。

ビジュアル・レポート

実行結果の［Extensions］タブに，次の要素が含まれるレポートが表示されます。 

  • ［UFT Report］セクションに，テストの実行ステータスが表示されます。また，UFT One レポートおよびアーカイブが Azure Storage にアップロードされている場合は，そのリンクも表示されます。

  • ［Run Summary］に，実行したテストの数および各ステータスの割合が表示されます。

  • ［Generate ‘Failed Tests’ report］オプションを選択した場合は，［Failed Tests］セクションに，失敗したステップの詳細な内訳が表示されます。

注:  

  • リリース・パイプラインを使用している場合，これらの結果はステージ・レベルで利用できます。

  • テスト実行の途中でジョブを中止すると，［Extensions］タブが表示されないことがあります。［Extensions］タブが利用可能で，［Generate 'Failed Tests' report］オプションを選択した場合でも，［Failed Tests］セクションは表示されません。

実行結果ファイルの取得

  • 失敗結果の詳細は，UFTWorking/res/Report_<ビルド実行番号> フォルダにある junitreport.xml ファイルに JUnit 形式で保存されます。

  • UFT One html レポートとアーカイブ・ファイルが Azure Storage にアップロードされている場合は，ストレージ・コンテナでアクセスできます。

  • テスト実行の途中でジョブを中止すると，ジョブが停止するまでに実行されたすべてのテストの結果が，%UFT_LAUNCHER%\res\Report_###\ フォルダの Results###.xml ファイルに保存されます。

Team Foundation Server（TFS）から UFT One テストを実行する場合

UFT One の実行結果を，TFS ビルドの実行結果の［Summary］タブで確認することもできます。

例：

先頭に戻る

その他の参照項目：