Azure DevOps を使用した，OpenText Application Quality Management に保存されたテストの実行

このトピックでは，Azure DevOps Server または Azure DevOps Services を使用して，OpenText Application Quality Management に保存された OpenText Functional Testing テストを実行する方法について説明します。

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

前提条件

OpenText Application Quality Management からテストを実行できるようにするには，まず統合をセットアップする必要があります。これは 1 回限りのセットアップであり，別のバージョンに変更する場合にのみ繰り返す必要があります。

Azure DevOps Server がテストの実行に使用する Azure マシンで ALM クライアントを共通モードで登録します。登録の詳細については，OpenText Application Quality Management ヘルプセンターの ALM Client Launcher のセクションを参照してください。

先頭に戻る

OpenText Application Quality Management に保存されているテストの実行

Azure DevOps サーバで：

パイプラインを作成します（注：TFS を使用している場合は，この手順をスキップしてください）。
1. 空のジョブ・テンプレートを使用して，ビルド・パイプラインまたはリリース・パイプラインを作成します。
  注：ビルド・パイプラインは，リリース・パイプラインを明示的に作成しない場合に作成されるパイプライン・タイプです。
2. テストを実行するエージェントが含まれているエージェント・プールを選択します。
3. パイプライン変数に，UFT_LAUNCHER 変数を追加します。変数の値には，UFTWorking フォルダへの完全パスを指定します。
詳細については，Microsoft Azure のドキュメントを参照してください。
OpenText Functional Testing タスクまたはビルド・ステップを，ビルド順序の適切な位置に追加します。
1. ［Task catalog］で，［Test］タブを選択して，利用可能なすべてのテスト・タスクのリストを表示します。
2. ［OpenText™ Functional Testing ALM Run］タスクを選択し，［Add］をクリックします。ビルド・プランの一部として，新しい空のタスクが追加されます。

テストについて，次の詳細情報を入力します。

必須情報	説明
Display name（オプション）	Azure DevOps Server CI システムの標準設定では，設定済みの記述子がタスクに使用されます。ステップにわかりやすい名前を付けます。
ALM サーバ	テストが保存される ALM サーバ。次の構文を使用します。 http://<ALM サーバ名> または IP:port/qcbin 場合によっては，共通登録モードで OpenText Application Quality Management に接続する必要があります。この場合は，URL を http://<ALM サーバ名> または IP:port/qcbin/start_a.jsp?common=true の形式で入力します。
ALM 資格情報	ALM サーバに必要な認証タイプに応じて，資格情報はユーザ名とパスワード，または SSO 認証用の API キーになります。ユーザ名とパスワード： User name：サーバへのアクセスに使用する ALM ユーザ名。 Password：上で指定した ALM ユーザのパスワード。 SSO 認証［SSO enabled］を選択します。 ALM サイト管理者から入手したクライアント ID と API キー・シークレットを入力します。このタスクで指定した ALM ユーザまたはクライアントが，OpenText Functional Testing テストを開いて実行するための適切な権限を持っていることを確認します。権限の詳細については，OpenText Application Quality Management ヘルプセンターを参照してください。
Domain	テストを含むプロジェクトが格納されている ALM サーバのドメイン。
Project	テストが格納されたプロジェクト。
Test sets	このビルド・タスクで実行するテスト・セット。テスト・セットへの完全な ALM パスを提供します。 1 つの行に入力できるテスト・セットまたはフォルダは，1 つだけです。注：テスト・セットのパスを入力するときは，ルート・フォルダを指定してもしなくても構いません。
Timeout	テストの開始または実行に問題がある場合に待機する時間（秒単位）。フィールドを空白のままにすると，タイムアウトは発生しません。
Timestamp pattern	［Extensions］タブでレポートに使用されるタイムスタンプ・フィールドの値の形式を定義します。標準設定値は yyyy- MM-dd HH:mm:ss です。
Run mode	テスト・セットを実行するマシン。次のオプションがあります。 Run locally（標準設定）：エージェント・マシンでテストを実行します。 Run remotely：［Testing tool host］で指定したホストでテストを実行します。 Run on a planned host：OpenText Application Quality Management で定義されている予定ホストでテストを実行します。
Testing tool host	テスト・セットを実行するために選択されたホストの名前。注：［Run remotely］実行モードの場合は必須です。それ以外の場合は関係ありません。

Azure で機密情報を非表示にするには

ALM パスワードや SSO 資格情報などの情報を非表示にするには，次のようにこの情報の Azure タスク変数を定義してロックします。

変数を作成します。
タスクの［Variables］タブで，値を非表示にするフィールドごとに変数を追加します。
変数の値を入力し，ロック・オプションを選択します。
ヒント: 必要に応じて，［Settable at queue time］も選択して，ビルドをキューに追加するときに，この値を編集できるようにします。
たとえば，MyPassword 変数を作成し，その値として ALM パスワードを入力します。
変数をタスクの関連フィールドにリンクします。
［Tasks］タブで，［Link settings］をクリックします。
［Setting to link］で，変数にリンクするフィールドを選択し，［Value］に $(<変数名>) と入力します。［Link］をクリックしてプロセスを完了します。
たとえば，［Password］フィールドを選択し，$(MyPassword) と入力します。

（オプション）［Test］タブから，Publish Test Results タスクまたはビルド・ステップを追加して，テスト結果を Azure パイプラインに発行します。

OpenText Functional Testing の XML 実行結果レポートに基づいて JUnit レポートを作成するには，ステップに次の情報を入力します。

必須情報	説明
Display name	ステップの名前を指定します。
Test result format	`JUnit`
Test results files	`*/.xml`
Search folder	テスト結果の XML ファイルが格納されるフォルダのパスを指定します。次の形式を使用します。ビルド・パイプラインの場合：<UFTWorking\res フォルダのパス>\Report_$(Build.BuildNumber) リリース・パイプラインの場合：<UFTWorking\res フォルダのパス>\Report_$(Release.ReleaseID)
Test run title	レポートのタイトルを指定します。環境変数をタイトルで次のように使用して，パイプライン名とビルド番号またはリリース番号に基づいてレポート名を作成します。ビルド・パイプラインの場合：`$(System.DefinitionName)_$(Build.BuildNumber)` リリース・パイプラインの場合：`$(System.DefinitionName)_$(Release.ReleaseID)` これは，Azure DevOps でレポートを取得する際に役立ちます。

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

オプション	説明
Enabled	ステップをこのビルドの一部として実行するかどうかを指定します。
Continue on error	このステップでエラーが発生した場合に，ビルドを停止するか，続行するかを CI システムに指示します。
Run this task	このステップを実行する条件を CI システムに示します。テスト実行が失敗した後に結果を発行するには，［Even if a previous task has failed, unless the build was canceled］を選択します。

パイプラインを実行するように設定します。
ビルド・パイプライン：パイプラインを保存してキューに格納します。
リリース・パイプライン：リリースを作成してパイプラインをデプロイします。
パイプラインが実行されると，テストは追加したタスクの一部として実行されます。
注: Azure DevOps サーバから手動で実行を停止した場合，OpenText Functional Testing プロセスは使用中のままとなり，OpenText Application Quality Management に接続してテストの実行を続行できなくなります。
これを修正するには，UFT.exe および UFTRemoteAgent.exe プロセスを手動で停止し，Azure DevOps Server からビルドを再開します。