ヒートマップを使用する

This page guides you through the user journey of interacting with the Heatmap. The page leads you through various stages, including creating test cases in Studio, setting up Heatmap ratios and configurations, examining and testing transactions, and running test sets. Check the following topics to start using the Heatmap.

Create test cases in Studio

To get started with the Heatmap, you need to create test cases for your SAP transactions with UiPath Studio. To ensure the Heatmap accurately shows which transactions are covered by tests and their status, you need to set the Studio project Enable SAP monitoring setting to True.

ヒートマップ、テスト ケース、およびトランザクション間のリンクと接続

ヒートマップ内のすべてのトランザクションには、実行時に一意のラベルが自動的に割り当てられます。ラベルの形式は、TRAN:SAP_CODE または PROG:SAPPROGRAM です。

実際に実行されたトランザクションとその依存関係に関する情報が実行時に収集されます。実行されたトランザクションにテスト ケースをリンクできるようにするには、Studio の [プロジェクト設定] に移動し、[UI Automation クラシック] の [SAP の監視を有効化] を [True] に設定します。この設定は、テスト オートメーション プロジェクトでのみ使用できます。

注: [UI Automation クラシック] で SAP の監視を有効化すると、UI Automation モダン アクティビティのテスト ケースとトランザクションもリンクされます。

たとえば、名前が Create Purchase Order で SAP コードが ME21N のトランザクションには、 TRAN:ME21N というラベルが付きます。このトランザクションのテスト ケースを作成する場合、同じラベルが [テスト ケースを作成] ダイアログ ボックスの [ラベル] フィールドに表示されます。

Configure Heatmap ratios and settings

After you create test cases in UiPath Studio for your SAP transactions, you can configure the ratios and settings based on which the Heatmap will display the test relevance and coverage.

ヒート マップの属性の割合

ヒート マップは、以下の SAP 属性の値に基づいて作成されます。

SAP 属性	説明	既定値
ユーザー	トランザクションを使用するユーザー数	40
実行	トランザクションあたりの実行数	10
Time	トランザクションの実行に要する総処理時間	10
オブジェクト	トランザクションで使用される開発オブジェクト (画面、機能モジュール、テーブルなど) の数	10
強度	トランザクションの種類: 高負荷のトランザクションは、作成のトランザクションと見なされます。 中負荷のトランザクションは、変更のトランザクションと見なされます。 低負荷のトランザクションは、表示のトランザクションと見なされます)。	30

重要:

割り当てたすべての割合の合計が 100 である必要があります。

SAP Fiori のランディング ページ

さらに、ヒートマップで SAP Fiori のランディング ページの表示を有効化または無効化できます。

SAP インスタンスへの直接接続

設定は、ヒートマップの右上隅の から顧客のニーズに基づいて調整できます。

CSV ファイルを使用した接続

これらは、SAP から CSV ファイルをダウンロードするときに [Parameters] タブで設定します。

ヒートマップの設定を変更する

ヒートマップの設定を変更するには、ヒートマップの生成に使用する SAP 属性の割り当て比率を変更し、SAP Fiori のランディング ページに関する表示を切り替える必要があります。

SAP インスタンスへの直接接続

1. 右上の歯車アイコン を選択して、[ヒートマップの設定] を開きます。
2. ユース ケースに従って割り当て比率を変更します。
   たとえば、最もよく使用されているトランザクションではなく、最も負荷の高いトランザクション (種類が作成) を強調表示するには、[ユーザー] の比率を 10 に変更してから、[強度] の比率を 60 に変更します。
3. [表示] で [SAP Fiori のランディング ページを表示] トグルを選択して、SAP Fiori のランディング ページをヒートマップに表示します。

CSV ファイルを使用した接続

Z_UIPATH_CUST_HEATMAP_DOWNLOAD プログラムの実行後、[Parameters] タブに移動して属性の割合を設定します。

SAP 属性と割り当て比率について詳しくは、「ヒートマップの属性の割合」をご覧ください。

Analyze and test transactions

After you create tests for your SAP transactions, and configure the Heatmap ratios, you can start analyzing the results and testing specific transactions. Check the following sections for information on how to leverage the Heatmap.

Understanding the Heatmap results

The analysis of Heatmap results involves viewing the test coverage of your transactions, filtering test coverage types, and reviewing transaction overviews. Explore the following topics to gain a comprehensive understanding of how to examine Heatmap results.

トランザクションのテスト カバレッジを表示する

自動テストがあるトランザクションとその結果を確認するには、以下の手順を実行します。

1. テスト結果が合格のトランザクションを表示するには、ヒートマップで [合格] を選択します。
2. テスト結果が不合格のトランザクションを表示するには、ヒートマップで [不合格] を選択します。
3. テスト ケースが実行されていないトランザクションを表示するには、ヒートマップで [実行されたテスト ケースはありません。] を選択します。
4. テスト ケースが割り当てられていないトランザクションを表示するには、ヒートマップで [テスト ケースが割り当てられていません。] を選択します。
5. 上記のトランザクションをすべて表示するには、ヒートマップで [すべて表示] を選択します (既定で選択されています)。

ヒートマップ トランザクションをフィルター処理する

1. ヒートマップを開き、[すべてのトランザクション] ドロップダウンから、表示するトランザクションの数を選択します。
   1. すべてのトランザクション (既定)
   2. トランザクション トップ 10
   3. トランザクション トップ 20
2. [過去 1 週間] ドロップダウンから、トランザクションの開始時刻を選択します。
   1. 過去 1 か月間 (既定)
   2. 過去 1 週間
   3. 過去 1 日
      トランザクションの開始時刻と終了時刻が [期間] ドロップダウンの横に表示されます。
3. [すべてのトランザクションの種類] ドロップダウンから、表示するトランザクションの種類を選択します。
   1. 標準トランザクション
   2. カスタム トランザクション
4. [すべてのインターフェイスの種類] ドロップダウンから、トランザクションを表示するインターフェイスの種類を選択します。
   1. [T] - SAP WinGui のトランザクション
   2. [R] - SAP WinGui のレポート/プログラム
   3. [W] - SAP WebGUI のトランザクション
   4. [F] - SAP Fiori のアプリケーション

トランザクションの概要を確認する

1. ヒートマップからトランザクションを選択します。
2. [選択したトランザクションの詳細: Maintain Transaction Codes] で [概要] を選択します。
3. トランザクション名とその SAP コードを確認します。
   トランザクションの SAP コードを使用して、一意のラベルを生成します。

特定のトランザクションのテスト ケースを生成する

You can generate manual tests using Autopilot^TM for transactions viewed as part of the Heatmap. The generated test cases will have the following labels assigned:

• autopilot-generated
• TRAN:<transactionCode>

1. ヒートマップで、目的のトランザクションを選択します。
2. [テストを生成] を選択します。

   [サポート ドキュメントを追加する] ウィンドウが開き、テスト ケースの生成に必要な添付ファイルなどのドキュメントを追加するよう求められます。

   図 1. 選択したトランザクションの [テストを生成] ボタンの例
   

   

   
   
3. [サポート ドキュメントを追加する] ウィンドウで、追加の添付ファイルを選択します。

   添付ファイルはテストの生成時に使用されます。他のファイルを独自にアップロードすることもできます。

   図 2. [サポート ドキュメントを追加する] ウィンドウでドキュメントを選択する
   

   

   
   
4. Select Next and provide additional instructions that Autopilot^TM should use when generating test cases. Choose from a prompt from the Prompt library or type these instructions in the Provide Additional Guidance window.

   For instance, you can specify Autopilot^TM the number of test cases that you want to generate. The maximum number of test cases is 50.

   図 3.[追加指示を出す] ウィンドウに入力された追加の指示
   

   

   
   
5. [テストを生成] を選択してプロセスを開始します。

   生成が完了すると、「テスト ケースの生成の完了」という通知が表示されます。通知の設定に応じて、アプリ内とメールの両方で通知を受信できます。

6. 「テスト ケースの生成の完了」の通知を選択して、生成されたテスト ケースを確認します。
   1. [テストを生成] パネルで各テスト ケースを展開し、生成されたテスト ケースを確認します。
   2. 内容に問題がなければ、[テストを作成] を選択します。
   図 4. 作成するテストを選択し、テスト ケースを展開する
   

   

   
   
7. 生成されたテスト ケースに問題がある場合は、[テストを調整] を選択して、ユース ケースに関する追加の詳細を入力します。
   1. Attach more relevant documents for Autopilot^TM to use.
   2. [次へ] をクリックして、[指示を入力] テキスト ボックスに詳細を入力します。
   3. 手順を調整した後、[テストを再生成] を選択します。
   4. 「テスト ケースの生成の完了」の通知をクリックして、再生成されたテスト ケースにアクセスします。
   5. 各テスト ケースを展開して確認します。
   6. 満足できるテスト ケースを選択し、[テストを作成] を選択します。

生成されるテスト ケースには、以下のラベルが付きます。

• autopilot-generated
• TRAN:<transactionCode>

たとえば、選択したトランザクションのラベルが TRAN:SE38 の場合、そのトランザクションから生成されるすべてのテスト ケースに同じラベルが適用されます。

Creating test cases and test sets

After you analyze the results displayed in the Heatmap, you can start improving your testing portfolio, by creating test cases and test sets for uncovered or failed transactions. Check the following pages for steps on creating test cases and test sets for a specific transaction.

特定のトランザクションのテスト ケースを作成する

1. ヒートマップからトランザクションを選択します。
2. [選択したトランザクションの詳細: Maintain Transaction Codes] で [テスト ケース] を選択します。
3. [テスト ケースを作成] を選択し、作成するテスト ケースを設定します。
   テスト ケースに既に割り当てられているラベルの横に、別のラベルを追加できます。

   重要:

   特定のトランザクションのテスト ケースを作成する場合、トランザクションに既に割り当てられているラベルはそのままにしておく必要があります。そうしないと、作成したテスト ケースはトランザクションにリンクされません。

   この例では、既に割り当てられているラベルは TRAN:SE16 です。

テスト ケースをトランザクションにリンクする方法について詳しくは、こちらをご覧ください。

特定のトランザクションのテスト セットを作成する

1. 特定のトランザクションのテスト ケースを作成する
2. テスト ケースを作成したトランザクションを選択します。
3. [選択したトランザクションの詳細: Maintain Transaction Codes] で [テスト セット] を選択し、作成するテスト セットを設定します。
   ヒント:

   テスト セットをトランザクションに簡単にリンクするには、リンクするテスト セットにトランザクションのラベルを追加します。これにより、その特定のラベルを使用して、作成したテスト セットを検索できます。

   この例では、テスト ケースの作成に使用したラベルと同じラベル (TRAN:SE16) をテスト セットに追加しています。
   
   

   

   
   
4. テスト セットの作成後、Test Manager で [テスト セット] に移動します。
5. 作成したテスト セットを検索して開きます。
   手順 3 で追加したラベルを使用してテスト セットを検索できます。
6. [タスク] > [テスト ケースを割り当て] > [静的割り当て] を選択します。
7. 手順 1 で作成したテスト ケースを検索し、このテスト セットに割り当てます。
   
   

   

   
   
8. [ヒートマップ] ページに戻ってトランザクションを選択し、割り当てられているテスト セットを確認します。

Orchestrator テスト セットをトランザクションにリンクする

1. トランザクションを選択し、[選択したトランザクションの詳細: Maintain Transaction Codes] で [テスト セット] を選択します。
2. [リンク] を選択し、リンクする Orchestrator テスト セットを選択して、[リンク] を選択します。

Execute test sets for a transaction

1. テスト セットをトランザクションにリンクします。
2. 実行するテスト セットの横にある [その他のオプション] を選択します。
3. 以下のいずれかを選択します。
   • 手動で実行
   • 自動テストを実行
4. テスト結果をヒートマップで確認します。

ヒートマップの添付ファイル

ヒートマップを生成する SAP データは、Test Manager の [ダッシュボード] の [添付ファイル] にあります。

• [データ ソース] として [SAP インスタンスを接続] が設定されている場合: 3 つの JSON ファイルが添付されます (日、週、月用)。
• [データ ソース] として [CSV からアップロード] が設定されている場合: アップロードした CSV ファイルが添付されます。