Regression Suite Automation Tool のインストールと構成
この記事では、Regression Suite Automation Tool (RSAT) のインストールと構成の方法について説明します。
前提条件
Excel
テスト パラメーターを生成および編集するには、Microsoft Excel をインストールする必要があります。
Azure DevOps (前提条件)
テスト ケース、テスト計画、およびテストケースの結果を保存および管理するには、 Azure DevOps プロジェクトが必要です。 Azure DevOps テスト マネージャーまたはテスト計画ライセンスが必要です。 たとえば、 Visual Studio エンタープライズ サブスクリプションを所有している場合は、既にテスト計画に対するライセンスを取得しています。 詳細については、Azure DevOps サービス の価格設定、または Azure DevOps サーバーの価格設定 を参照してください。
証明書ベースまたはユーザーベースの認証
RSAT は、任意の Windows 10 以降のコンピュータにインストールされ、Web ブラウザを介して環境にリモート接続するように設計されています。
メモ
クラウド ホスト環境 (CHE) または VHD 開発イメージで RSAT を使用している場合、ツールは Windows Server 2019 以降で実行されます。
安全な認証を有効にするには、RSAT はテストされている Dynamics 365 財務と運用アプリ環境へのアクセスを認証する必要があります。 アクセスの認証には、証明書ベースの認証とユーザーベースの認証の 2 つのオプションがあります。
証明書ベースの認証を有効にするには、RSAT クライアント コンピューターに証明書をインストールする必要があります。 RSAT 設定 ダイアログ ボックスでは、認証証明書を自動的に作成およびインストールできます。 また、接続を信頼するように仮想マシン (VM) を構成する必要があります。 RSATをインストールして構成するには、次のセクションの指示に従ってください。
ユーザーベースの認証には、いくつかの設定手順が必要です。 詳細については、ユーザーベースの認証 を参照してください。
インストール
インストーラー
Regression Suite Automation Tool ダウンロード からマシンに .msi ファイルをダウンロードし、ダブルクリックしてインストーラーを実行します。
Selenium およびブラウザー ドライバー
RSATには、Selenium および Web ブラウザー ドライバー ライブラリが必要です。 RSAT は、必要なライブラリが不足している場合にプロンプトを表示し、それらを自動的にインストールします。 次の (または類似の) メッセージが表示されたら、はい を選択します。
RSAT は Selenium 3.13.1 を使用します。 Web ドライバー ライブラリおよびブラウザー固有のドライバーは C:\Program Files (x86)\Regression Suite Automation Tool\Common\External\Selenium にダウンロードされます。
構成
デスクトップ アイコンから Regression Suite Automation Tool アプリケーションを開きます。
右上にある設定ボタンを選択して、RSAT を構成します。
一般設定
これらの設定は必須です。
Azure DevOps (一般設定)
Azure DevOps プロジェクトおよびテスト計画への接続をコンフィギュレーションします。
Azure DevOps URL – これは、Azure DevOps 組織の URL です。 たとえば、
https://yourAzureDevOpsUrlHere.visualStudio.com。ノート
Azure DevOps サーバーを使用している場合は、/DefaultCollection を Azure DevOps URL の末尾に追加します。
アクセス トークン – ツールが Azure DevOps に接続できるようにするアクセス トークン。 個人用アクセス トークンを作成するか、保存した既存のアクセス トークンを使用する必要があります。 フル アクセスとして選択したスコープで作成することをお勧めします。 詳細については、個人用アクセス トークンを使用したアクセスの認証 を参照してください。
プロジェクト名 – Azure DevOps プロジェクトの名前。 RSAT は、指定した Azure DevOps URL に基づいたプロジェクト名と利用可能なテスト計画を自動的に検出します。 その後、テスト プロジェクトおよびテスト計画を選択できます。
テスト計画 – テスト ケースを含む Azure DevOps テスト計画。 詳細についてはテスト計画およびテスト スイートの作成 を参照してください。
接続のテスト を選択し、 Azure DevOps への接続をテストします。
テスト環境 (一般設定)
テスト環境への接続をコンフィギュレーションします。
ホスト名 – myhost.cloudax.dynamics.com. などのテスト環境のホスト名。 https:// または http:// の接頭語を含めないでください。
SOAP ホスト名 – テスト環境の SOAP ホスト名。
- テスト環境が、リモート デスクトップ アクセスがないユーザー受け入れテスト (user acceptance testing: UAT) または上位層サンドボックス環境である場合、この SOAP ホスト名はホスト名と等しくなります。
- テスト環境の SOAP ホスト名がわからない場合は、Infrastructure.SoapServicesUrl の AOS サーバーの web.config ファイルで検索できます。
管理者ユーザー名 ー テスト環境の管理者ユーザーの電子メール アドレス。 管理者ユーザー名は、RSAT が接続している財務と運用テスト環境でのシステム管理者ロールに属しているユーザーの電子メール アドレスである必要があります。 また、ユーザー アカウント (電子メール アドレス) は、テスト環境と同じテナントに属している必要があります。 たとえば、テスト環境の既定のテナントが contoso.com である場合、管理ユーザーは @constoso.com で終了する必要があります。
認証方法 – ホスト名へのアクセスを認証する方法を選択します。 このオプションは 証明書 と ユーザーベース です。 どちらのオプションにも、完了するための手順が含まれています。 Microsoft が推奨する方法はユーザー ベースの認証であり、Dynamics 365 財務と運用アプリでは証明書ベースの認証のオプションが削除される予定です。
拇印 – 使用している認証証明書の拇印。 使用している環境にリモート デスクトップ プロトコル (RDP) でアクセスできない場合は、この記事で後述する手順に従って、Lifecycle Services から証明書をダウンロードし、拇印をここに貼り付けます。 環境に RDP でアクセスできる場合は、次の手順に従って自己署名証明書を生成します。
新しい証明書を作成してインストールするには、 新規 を選択します。 プロンプトが表示されたら .cer ファイルをどこかに配置して、記録用に保存します。
プロセスが完了すると、新しい証明書がローカル マシンの信頼されたルート店舗にインストールされます。
新しく作成された証明書の拇印が、このフォームに自動的に挿入されます。 この拇印をコピーし、次のセクションで使用して、接続を信頼するように AOS をコンフィギュレーションします。
KeyVault URL、テナント ID、クライアント ID、クライアント シークレット – これらのフィールドは、ユーザー ベースの認証を設定するときに使用されます。 ユーザーベースの認証を設定する方法については、ユーザーベースの認証 を参照してください。
会社名 – Excel パラメーター ファイルの作成時に、既定の会社として使用する会社名を指定します。 後でExcelファイルを編集して変更できます。
実行設定
ローカル設定をコンフィギュレーションします。
- 作業ディレクトリ - Excel テスト データ ファイルを含むテスト自動化ファイルを格納するフォルダの場所。 たとえば、 C:\Temp\RegressionTool のようになります。
- 既定のブラウザー - テストの実行に使用するブラウザーを選択します。 RSAT は (新しい) Microsoft Edge、Microsoft Internet Explorer、 および Google Chrome をサポートします。 新しい Microsoft Edge の概要から Microsoft Edge ダウンロードすることをお勧めします。
OK を選択して設定を適用し、ダイアログ ボックスを閉じます。 キャンセル を選択して変更をキャンセルし、ダイアログ ボックスを閉じます。 名前を付けて保存 と 開く ボタンを使用すると、後で再利用するために設定を保存できます。 名前を付けて保存 を選択して、コンピューターの構成ファイルに現在の設定を保存します。 開く を選択して、構成ファイルから設定を復元します。
オプション設定
オプション タブを選択して、オプションの設定をコンフィギュレーションします。
テストの実行の接頭語 – RSATはテストの実行結果を Azure DevOps に報告します。 テストの実行には、次の規則に従って名前が付けられます: <Run ID><Prefix><Test Suite>。 この設定を使用して、<接頭語>を設定します。
テストの実行タイムアウト – テストの実行のタイムアウト (分単位)。 このタイムアウトに達すると、すべてのアクティブなウィンドウが閉じられ、保留中のテスト ケースは失敗します。
テスト アクションのタイムアウト – 個々のテスト ステップのタイムアウト (分単位)。 テストステップがタイムアウトになると、テスト ケースは失敗します。
ステップ間の一時停止 – テストケースの自動実行中にテスト ステップ間で一時停止する秒数。 既定値は 0 (ゼロ) です。 監査または調査のために、テストの実行中に強制的に一時停止するには、この値を設定します。 テスト ケースの Excel パラメーター ファイルの全般タブにある、ステップ間の一時停止 (秒) パラメーターを変更することで、個々のテスト ケースに対して一時停止を指定することもできます。
最初の検証エラーでテストに失敗 – 既定では、テスト ケースに複数の検証ステップがあり、検証に失敗した場合は、最初の失敗が発生するとテスト ケースの実行が停止します。 テスト ケースは失敗としてマークされます。 すべての検証が完了するまでテスト ケースを実行する場合は、このオプションをオフにします。 その後、テスト ケースですべての検証を評価できます。
情報ログのエラーでテストに失敗 - このオプションをチェックし、テスト ケースの実行中に財務と運用情報ログでエラーが発生した場合、テスト ケースが強制的に失敗するようにします。
失敗時にテスト スイートの実行を中止する – 既定では、テスト ケースのいずれかが失敗した場合でもテスト スイートの実行が続行されます。 この設定をチェックすると、テスト ケースが失敗した場合にテストの実行が中止されます。 残りのすべてのテスト ケースのステータスは 未実行 になります。
ローカル ファイルの検証ルールを有効にする - この設定をチェックして、テスト ケースの実行準備が整っているかどうかを検証します。 詳細については、テスト自動化ファイルの準備状況の検証 を参照してください。
Azure DevOps へのアップロードを有効にする - Azure DevOps へ偶発的にアップロードされる (したがってプロジェクト全体の記録と自動化ファイルが上書きされます) のを回避するために、この設定をオフにすることができます。 これは、RSAT が実行目的でのみクライアント マシンに配置されていて、ユーザーがテスト ケースを永続的に変更することを回避したい場合に特に便利です。
クラウド プロバイダー – テスト環境のクラウド テナントのプロバイダーを選択します。 サポートされているプロバイダーは、グローバル (パブリッククラウド) および中国 (主権クラウド) です。
重要
財務と運用アプリが 21Vianet で展開された場合、クラウド プロバイダーの設定が必要となり、選択された値は中国である必要があります。
接続を信頼するようにテスト環境を構成する
次のサブセクションは、証明書ベースの認証を使用する場合にのみ関係します。 ユーザーベースの認証を設定する方法については、ユーザーベースの認証 の情報を参照してください。
AOS がリモート デスクトップ接続を許可している場合
証明書を作成した後、テスト自動化接続を信頼するよう AOS をコンフィギュレーションします。 マルチAOS環境では、すべてのAOSマシンに対して次の手順を繰り返します。
AOSマシンへのリモート デスクトップ接続を開きます。
IIS を開き、サイトの一覧で AOSService を見つけます。
AOSService を右クリックし、エクスプローラーを選択します。
ファイル wif.config を開き、検索します。
新しい機関のエントリを追加して、wif.config ファイルを更新します。 機関名に 127.0.0.1 を使用し、証明書の拇印を貼り付けます。
wif.config のこの行の後に次のセクションを貼り付けます:
<issuerNameRegistry type="Microsoft.Dynamics.AX.Security.SharedUtility.AxIssuerNameRegistry, Microsoft.Dynamics.AX.Security.SharedUtility"><authority name="CN=127.0.0.1"> <keys> <add thumbprint="ccbc124d0a119xxxxxxxxxxxxxxxxxxxx841e797" /> </keys> <validIssuers> <add name="CN=127.0.0.1" /> </validIssuers> </authority>
サーバーへのリモート デスクトップ アクセス権がない場合
Microsoft が管理するサンドボックス、またはセルフ サービス タイプ サンドボックスなど、リモート デスクトップ プロトコル (RDP) アクセスが削除された場合、Microsoft は環境に応じた証明書を生成し、事前に構成します。 次の手順に従って RSAT 証明書を取得し、LCS ユーザー インターフェイスを使用します。 自動化については、ZIP ファイルで RSAT 証明書をフェッチする API 参照ページに情報があります。
Lifecycle Services の環境詳細ページの メンテナンス の下に、2 つの新しいオプションが表示されます。
- RSAT 証明書のダウンロード
- RSAT 証明書を再生成する
ダウンロード ボタンを使用して、証明書バンドルを .zip ファイルとして取得します。
クリアテキスト パスワードが画面に表示されるという警告が表示されます。 後の手順でパスワードが必要になります。 はい を選択して続行します。
クリアテキスト パスワードを後で使用できるようにコピーします。 .zip ファイルがダウンロードされていることを確認します。 .zip ファイルの内部には、証明書 (.cer) と個人情報交換 (.pfx) ファイルがあります。 ファイルを解凍します。
ローカル コンピューターの信頼されたルート ストアに証明書をインストールします。
- 証明書 (.cer) をダブルクリックして開き、証明書のインストールを選択します。
- ローカル コンピューターを選択し、信頼済ルート証明機関ストアを参照して、信頼されたルート ストアにインストールします。
ローカル コンピューターの個人ストアに pfx ファイルをインストールします。
- 個人情報交換 (.pfx) ファイルをダブルクリックして開き、ローカル コンピューターを選択します。
- 手順 2 で保存したパスワードを入力し、個人ストアを参照します。
証明書ファイルをダブルクリックして、開きます。 詳細タブを参照し、拇印セクションが表示されるまで下にスクロールします。 拇印を選択し、テキスト ボックスの ID に注意します。 この捺印を選択するか、RSAT 設定に貼り付けます。
これで、この証明書を使用して環境に対してテストを実行できます。 証明書は期限が切れる前に Microsoft によって自動的にローテーションされます。その後、上記の手順 1 からこの証明書の新しいバージョンをダウンロードする必要があります。 セルフ サービス環境では、有効期限に最も近いダウンタイム ウィンドウで 60 日ごとにローテーションされます。 これらのダウンタイム ウィンドウには、顧客が開始したパッケージ展開、および環境を対象とするデータベース移動操作が含まれます。