ヒートマップを使用する

このページでは、ヒートマップの操作のユーザー ジャーニーについて説明します。このページに従って操作を進めることで、Studio でのテスト ケースの作成、ヒートマップの属性の割合と設定、トランザクションの調査とテスト、テスト セットの実行など、さまざまな段階を実行できます。ヒートマップの使用を開始するには、以下のトピックをご覧ください。

Studio でテスト ケースを作成する

ヒートマップの使用を開始するには、UiPath Studio を使用して SAP トランザクションのテスト ケースを作成する必要があります。テストでカバーされているトランザクションとそのステータスをヒートマップに正確に表示するには、Studio プロジェクトの [SAP の監視を有効化] の設定を [True] に設定する必要があります。

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

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

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

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

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

ヒートマップの属性の割合と設定を構成する

UiPath Studio で SAP トランザクションのテスト ケースを作成したら、ヒートマップにテストの関連度とカバレッジを表示する際に基準とする属性の割合と設定を構成できます。

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

ヒート マップは、以下の 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 属性と割り当て比率について詳しくは、「ヒートマップの属性の割合」をご覧ください。

トランザクションを分析およびテストする

SAP トランザクションのテストを作成し、ヒートマップの属性の割合を設定したら、結果の分析と特定のトランザクションのテストを開始できます。ヒートマップの利用方法について詳しくは、以下のセクションをご覧ください。

ヒートマップの結果を理解する

ヒートマップの結果の分析には、トランザクションのテスト カバレッジの表示、テスト カバレッジの種類のフィルター処理、およびトランザクションの概要の確認が含まれます。ヒートマップの結果を調べる方法を包括的に理解するには、以下のトピックをご覧ください。

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

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

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 コードを使用して、一意のラベルを生成します。

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

Autopilot^TM を使用して、ヒートマップの一部として表示されるトランザクションの手動テストを生成できます。生成されたテスト ケースには、以下のラベルが割り当てられます。

• autopilot-generated
• TRAN:<transactionCode>

Prerequisites: If you want to leverage RAG when generating tests, you need to start using Context Grounding, which RAG is a component of. To get started with Context Grounding, visit the dedicated Best practices page.

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

   The Provide additional context window opens, focused on the Add documents prompting you for attachments or other documents necessary for generating test cases.

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

   

   
   
   1. In the Add documents section, select additional attachments.

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

      図 2. テストを生成するための [ドキュメントを追加] セクション
      

      

      
      
   2. [追加のコンテキストを提供する] ウィンドウの [RAG (検索拡張生成) を活用] セクションで、コンテキスト グラウンディングにアップロードしたデータを格納するインデックスを選択します。
      The selected index helps Autopilot in generating more accurate tests by giving it context about the applications that you are trying to automate. For example, you can leverage RAG when a requirement document has incomplete information or refers to additional details in other sections. In this case, you can leverage RAG to draw those details from indexed references.

      注: コンテキスト グラウンディングの使用に関するベスト プラクティスについては、「ベスト プラクティス」をご覧ください。
      1. [フォルダーを選択] ドロップダウン リストから、Autopilot と共有する、必要な情報を格納したインデックスを保存するフォルダーを選択します。
      2. [インデックスを選択] ドロップダウン リストから、Autopilot で参照する特定のインデックスを選択します。
      3. [結果の数] に、参照した情報に基づいて Autopilot で生成するテストの数を入力します。
      Figure 3. The Leverage RAG section for generating tests
      

      

      
      
3. [次へ] を選択し、Autopilot^TM がテスト ケースの生成時に使用する追加の指示を入力します。[追加指示を出す] ウィンドウで、プロンプト ライブラリからプロンプトを選択するか、追加の指示を入力します。
   Autopilot が従うことができる指示を以下にいくつか示します。

   • 生成するテスト ケースの数を Autopilot^TM に指示できます。生成できるテスト ケースの最大数は 50 件です。
   • Autopilot^TM に対し、ローン申込書の要件に記述したユーザーの手順と承認基準をすべてカバーするよう指定できます。
   • 事前条件を生成するよう Autopilot^TM に指示できます。
   • 各テスト ステップで期待される結果を生成するよう Autopilot^TM に指定できます。
   • By default, Autopilot considers existing tests linked to a requirement to prevent duplicating tests. However, you can instruct Autopilot to disregard existing tests during new test generation. You can do this by providing an instruction like: "Do not consider tests that are linked to this requirement when generating tests".
   Figure 4. Additional instructions entered in the Provide additional guidance window
   

   

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

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

5. 「テスト ケースの生成の完了」の通知を選択して、生成されたテスト ケースを確認します。
   1. [テストを生成] パネルで各テスト ケースを展開し、生成されたテスト ケースを確認します。
   2. 内容に問題がなければ、[テストを作成] を選択します。
   Figure 5. Selecting the tests that you want to create and expanding a test case
   

   

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

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

• autopilot-generated
• TRAN:<transactionCode>

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

サポートされているファイルの種類

Autopilot では、さまざまな種類のファイルを処理できます。ファイルの種類に応じて、その特定のコンテンツを処理できます。次のリストに、Autopilot に提供できるファイルの種類と、各種類で Autopilot が処理できるコンテンツの種類を示します。

• テキスト コンテンツのみを処理 – Autopilot は、次の種類のファイルのテキスト コンテンツのみを処理します。
  • TXT
  • BPMN
  • CSV
• テキストと画像の両方のコンテンツを処理 – Autopilot は、次の種類のファイルのテキストと画像の両方を処理します。
  • DOCX
  • XLSX
  • PNG
  • JPG
  • PDF

テスト ケースとテスト セットを作成する

ヒートマップに表示された結果を分析したら、カバーされていないトランザクションや失敗したトランザクションのテスト ケースとテスト セットを作成して、テスト ポートフォリオの改善を開始できます。特定のトランザクションのテスト ケースとテスト セットを作成する手順については、以下のページをご覧ください。

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

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 テスト セットを選択して、[リンク] を選択します。

トランザクションに対してテスト セットを実行する

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

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

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

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