Azure DevOps

UiPath Azure DevOps 拡張機能を介した Azure DevOps と Test Manager との連携により、作業項目を要件、不具合、および必要に応じてテスト ケースとして同期できます。

Azure DevOps を Test Manager と連携させることで、テスト管理作業、アジャイル計画、不具合追跡に対応できるようになります。この連携により、作業項目を Test Manager に同期できます。

お使いの Test Manager インスタンスを Azure DevOps プロジェクトに接続するには、以下の手順を実行します。

1. Azure DevOps にプロジェクトを作成する
2. Azure DevOps 接続を設定する

前提条件

• Azure DevOps のアカウント
• サービス フックと連携するための権限の割り当て
• Test Manager の管理者アカウント
• UiPath® Test Manager Azure DevOps 拡張機能
• Azure Test Plans - テスト項目を Test Manager と同期します。連携シナリオを徹底的に検証してください。以下の制限事項を考慮してください。
  • アサーションを同期することはできません。
  • 手動テスト ステップは同期できません。Azure DevOps では、REST API では構造化データとして公開されない XML フィールド (Microsoft.VSTS.TCM.Steps) にテスト ステップが格納されます。これは Azure DevOps API の制約であり、Test Manager の制限ではありません。
  • テスト実行は Azure DevOps でロックされるため、ステータスを [ 完了] に設定することはできません。テスト実行は Azure DevOps でロックされ、結果を並行して同期するためです。
  • Test Manager と Azure DevOps のプロジェクトの範囲は大きく異なるため、オブジェクトのルーティングを綿密に計画する必要があります。

Azure DevOps にプロジェクトを作成する

Azure DevOps プロジェクトを作成して [Work item process] を [Agile] に設定することで、アジャイル計画をサポートし、作業項目を Test Manager と同期するためのターゲットを提供します。

1. Azure DevOps にログインします。
2. [Create new project] を選択して、プロジェクトの設定を構成します。
   • Project name: プロジェクトの名前を入力します。
   • Description: 各プロジェクトの用途を簡単に把握できるように説明を入力します。
   • Version control: バージョン管理を選択します。
   • Work item process: ドロップダウンから既定のプロセスとして、開発やテスト アクティビティなどのアジャイル計画法をサポートする、[Agile] を選択します。
3. [作成] を選択します。

プロジェクトがコレクションに追加されます。

Azure DevOps 接続を設定する

Test Manager と UiPath® Azure DevOps 拡張機能の両方で連携設定を構成することにより、Test Manager と Azure DevOps プロジェクト間の接続を設定します。

前提条件: Azure DevOps に UiPath® Test Manager 拡張機能を保存するには、Azure 管理者ユーザーである必要があります。1. Test Manager に管理者としてログインします。2. プロジェクトを開きます。3. [プロジェクト設定] > [連携] に移動します。4.

[新しい接続] を選択して、ドロップダウンから [Azure DevOps] を選択します。5. 次の接続設定を構成します。

• 名前: Azure DevOps 接続の名前を入力します。* 説明 (任意): 参考になる説明を入力します。* サーバー URL: Azure DevOps サーバーの URL を入力します。例: https://company-name-serverRegion.cloudapp.azure.com。

• 個人用アクセス トークン: Test Manager によるアクションの実行を許可するために、個人用アクセス トークン (PAT) を作成してこのフィールドに貼り付けます。:::warning Azure DevOps 接続を作成する場合、PAT が Azure DevOps サービスに対するフル アクセスを持っている必要があります。

このためには、PAT を作成または編集するときに、[Scopes] で [Full access] を選択します。接続が完了したら、PAT のスコープを [Test Management] - Read & Write、[Work Items] - Read & Write に減らすことができます。詳細については、「個人用アクセス トークンを使用する」をご覧ください。

:::

• 不具合の種類: Azure DevOps でバグの報告に使用するオブジェクトの種類を入力します。不具合の連携を使用しない場合は、空欄のままにします。

不具合の種類は、新規作成した Azure DevOps プロジェクト用に選択したオブジェクトの種類に基づいて入力します。例: Bug または Issue

• プロジェクト名: Azure DevOps のプロジェクト名を入力します。

6. 接続を選択してパネルを展開し、後で必要になる [API キー] をコピーします。7. Azure DevOps でプロジェクトを開き、[Project settings] に移動します。8. [Extensions] の [UiPath® Test Manager] に移動します。9. 以下の拡張設定を構成します。

• 要件の種類: テストを割り当てるオブジェクトの種類を選択します。これらは、Test Manager に要件として表示されます。詳細については、「要件」をご覧ください。
• Server URL: Test Manager の URL を入力します。URL の形式は https://cloud.uipath.com/{organizationName}/{tenantName}/testmanager_ です。
• API: API キーを貼り付けます。
• Manage Tests with Azure DevOps: テストを Azure DevOps で管理する場合は、このオプションを選択します。それ以外の場合は、このオプションをオフのままにして、テストを Test Manager で管理します。

10. [保存] を選択します。

    

Azure DevOps と連携して作業する

連携の動作については、以下の方法で試してみてください。

• 作業項目を同期する
• Azure DevOps でテストを管理する

作業項目を同期する

Azure DevOps で作業項目 (エピックなど) を作成し、それらを Test Manager と同期できます。作業項目は [要件] ページに表示されます。

1. Azure DevOps にログインしてプロジェクトを開きます。
2. プラス ボタン を選択して、ドロップダウンから [New work item] を選択します。
3. 作業項目を設定した後、[Save & Close] を選択します。詳細については、「作業項目を追加および更新する」をご覧ください。
4. Test Manager にログインして [要件] に移動すると、同期された作業項目が表示されます。ページを更新するには、階層リンク要素 [要件] を選択します。
   注:

   連携前に作成された作業項目を同期するには、個々の項目を開き、[Actions] ボタン を選択して、ドロップダウンから [Push to Test Manager] を選択します。

Azure DevOps でテストを管理する

テスト オートメーションには Test Cloud を使用し、テスト管理には Azure DevOps を使用することができます。両方のソリューションを同時に使用するには、まず連携の設定時に [ Azure DevOps でテストを管理 ] を選択しておく必要があります。詳細については、「 Azure DevOps 接続を設定する」をご覧ください。

Azure DevOps から Test Manager にテスト ケースをプッシュすることで、テストを管理できるようになります。つまり、種類が「テスト ケース」の Azure 作業項目が、すべて Test Manager にプッシュされるようになります。Azure のテスト計画にテスト ケースが追加されていることを確認してください。そこに結果がプッシュされるからです。詳細については、「テスト計画とテスト スイートを作成する」をご覧ください。

同期が完了すると、Studio でテスト ケースを自動化できるようになります。その後 Orchestrator を使用してテスト ケースを実行すると、結果が Azure のテスト計画にプッシュされます。

Azure DevOps データ フロー マトリックス

以下の表は、ネイティブの UiPath Azure DevOps 拡張機能を介して Azure DevOps と Test Manager 間で、どのデータがどの方向に同期されるかをまとめたものです。このマトリクスは、Planview® Hub を介した個別の同期メカニズムを使用する Test Manager Connect には適用されません。

Azure DevOps オブジェクト/データ	方向	同期メカニズム	注意事項/制限事項
作業項目 (エピック、ユーザー ストーリーなど)	Azure DevOps → Test Manager	保存時に自動で実行されます。[ 要件 ] ページに表示されます	連携前に作成されたアイテムは、手動で [Test Manager にプッシュ ] アクションを行う必要があります
テスト ケースの作業項目	Azure DevOps → Test Manager	接続で [Azure DevOps でテストを管理 ] を有効化する必要があります	Azure のテスト計画に追加する必要がある、そうしないと実行結果を同期する場所がありません
手動テスト ステップ ([Microsoft.VSTS.TCM.Steps フィールド])	同期されていません。	—	Azure DevOps では、テスト ステップは XML フィールドとして格納されますが、REST API では構造化データとして公開されません。これは Azure DevOps API の制約であり、Test Manager の制限ではありません
アサーション	同期されていません。	—	Azure Test Plans の前提条件に従って同期できません
Test execution results	Test Manager/Orchestrator → Azure DevOps のテスト計画	自動化された実行は Orchestrator を介して実行され、リンクされた Azure Test Plan に結果がプッシュされます	Azure DevOps では、実行を [完了] に設定することはできません。実行はロックされたままなので、結果を並列で同期し続けることができます
Defects	Test Manager → Azure DevOps	[実行] ページのログから手動で作成 ([不具合を作成])	プロジェクトごとに一度に不具合の同期に有効化できるコネクタは 1 つだけです

Azure DevOps 接続を管理する

Azure DevOps 接続を編集する

接続設定を編集します。

1. Test Manager に管理者としてログインします。
2. プロジェクトを開きます。
3. [設定] ボタンを選択してプロジェクトの設定を開きます。
4. 連携のリストで Azure DevOps 接続を選択し、パネルを展開します。
5. [編集] を選択して接続を設定します。
6. [保存] を選択して確定します。

Azure DevOps 接続を削除する

選択した接続および関連する要件を削除します。

1. Test Manager に管理者としてログインします。
2. プロジェクトを開きます。
3. [設定] ボタンを選択してプロジェクトの設定を開きます。
4. 連携のリストで Azure DevOps 接続を選択し、パネルを展開します。
5. [削除] を選択して、接続を削除します。
6. [OK] を選択して確定します。

関連記事

不具合の同期

結果

Azure DevOps プロジェクトが Test Manager に接続されます。作業項目が要件として同期され、Test Manager で作成した不具合が Azure DevOps に同期されます。