ヒートマップを使用する

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

次の 2 つのレベルのヒートマップ ビューを使用します。

• アプリケーション コンポーネント: 関連する SAP トランザクションを特定のコンポーネントまたはモジュールの下にグループ化する視覚的なコンテナーです。
• トランザクション: 個々の SAP トランザクションまたはプログラムを表す、コンポーネント内のボックスです。各ボックスには、以下のようなトランザクション データが表示されます。
  • トランザクション名
  • SAP コード
  • テストのステータスとカバレッジ

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

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

ヒートマップは、5 つの SAP 属性の値に基づいて生成されます。割り当て比率を設定して、自身のテスト戦略との関連性が最も高い属性を優先させることができます。

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

重要:

すべての割り当て比率の合計は 100と等しくなければなりません。#### SAP Fiori のランディング ページ さらに、ヒートマップで SAP Fiori のランディング ページの表示を有効化または無効化できます。

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

1. 右上の歯車アイコン を選択して、[ヒートマップの設定] を開きます。
2. ユース ケースに従って割り当て比率を変更します。

For example, to highlight the most intense transactions (of type Create), rather than the most used ones, change the User ratio to 10, and then the Intensity ratio to 60. 3. Under Visibility, select the Display SAP FIORI landing pages toggle, to display SAP FIORI landing pages in the heatmap.

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

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

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

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

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

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

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

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

1. テスト結果が合格のトランザクションを表示するには、ヒートマップで [合格] を選択します。

2. テスト結果が不合格のトランザクションを表示するには、ヒートマップで [不合格] を選択します。

3. テスト ケースが実行されていないトランザクションを表示するには、ヒートマップで [実行されたテスト ケースはありません。] を選択します。

4. テスト ケースが割り当てられていないトランザクションを表示するには、ヒートマップで [テスト ケースが割り当てられていません。] を選択します。

5. 上記のトランザクションをすべて表示するには、ヒートマップで [すべて表示] を選択します (既定で選択されています)。

   

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

1. ヒートマップを開き、[すべてのトランザクション] ドロップダウンから、表示するトランザクションの数を選択します。
   1. すべてのトランザクション (既定)
   2. トランザクション トップ 10
   3. トランザクション トップ 20
2. [過去 1 週間] ドロップダウンから、トランザクションの開始時刻を選択します。
   1. 過去 1 か月間 (既定)
   2. 過去 1 週間
   3. 過去 1 日

The start and end time of transactions is displayed next to the Time Period dropdown. 3. Select the types of transactions that you want to appear from the All transaction types dropdown:

1. 標準トランザクション
2. カスタム トランザクション
3. [すべてのインターフェイスの種類] ドロップダウンから、トランザクションを表示するインターフェイスの種類を選択します。
   1. [T] - SAP WinGui のトランザクション
   2. [R] - SAP WinGui のレポート/プログラム
   3. [W] - SAP WebGUI のトランザクション
   4. [F] - SAP Fiori のアプリケーション

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

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

トランザクションの SAP コードを使用して、一意のラベルを生成します。

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

注:

Feature availability depends on the cloud platform you use. For details, refer to the Test Manager feature availability page.

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

• autopilot-generated
• TRAN:<transactionCode>

Prerequisites: (For Cloud Commercial only) 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. [テストを生成] を選択します。 [追加のコンテキストを提供する] ウィンドウが開いて [ドキュメントを追加] セクションがフォーカスされ、テスト ケースの生成に必要な添付ファイルなどのドキュメントを追加するよう求められます。 図 1.選択したトランザクションの [テストを生成] ボタンの例

   

   1. [ドキュメントを追加] セクションで、追加の添付ファイルを選択します。 添付ファイルはテストを生成する際に使用されます。他のファイルを自身でアップロードすることもできます。

Figure 2. The Add documents section for generating tests (For Cloud Commercial only)

2. (For Cloud Commercial only) In the Leverage RAG section of the Provide additional context window, select an index which stores your data uploaded to Context Grounding. 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. :::note For best practices on working with Context Grounding, visit Best practices. ::: 1. From the Select folder dropdown list, select the folder where you store the indexes storing the desired information you want to share with Autopilot. 2. From the Select index dropdown list, select the specific index that you want Autopilot to reference. 3. For Number of results, enter the number of tests you want Autopilot to generate based on the referenced information.

Figure 3. The Leverage RAG section for generating tests

3. 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. These are some of the instructions that Autopilot can follow:

• 生成するテスト ケースの数を 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

1. (任意) [モデル] ドロップダウン リストから、Autopilot が使用する AI モデルを選択します。 Autopilot は、テストの生成時に既定で Claude 3.7 Sonnet を使用します。これは推奨されるモデルでもあります。
   注:

   [ モデル ] ドロップダウン リストで利用可能なモデルは、組織とテナントに適用されている AI Trust Layer ポリシー によって異なります。サポートされているすべてのモデルが有効になっている場合は、Claude 3.7 Sonnet が推奨オプションとして表示されます。有効化されているモデルの種類が 1 つだけ (Azure OpenAI など) 場合は、GPT 4o モデルのみが表示され、自動的に推奨されます。

2. [テストを生成] を選択してプロセスを開始します。 生成が完了すると、「テスト ケースの生成の完了」という通知が表示されます。通知の設定に応じて、アプリ内とメールの両方で通知を受信できます。
3. 「テスト ケースの生成の完了」の通知を選択して、生成されたテスト ケースを確認します。
   1. [テストを生成] パネルで各テスト ケースを展開し、生成されたテスト ケースを確認します。
   2. 内容に問題がなければ、[テストを作成] を選択します。

Figure 5. Selecting the tests that you want to create and expanding a test case

6. If you are not satisfied with the generated test cases, select Refine tests, and provide additional details about your use case.

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

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

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

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

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

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

注:

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

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

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

テスト ケースに既に割り当てられているラベルの横に、別のラベルを追加できます。

重要:

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

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

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

2. テスト ケースを作成したトランザクションを選択します。

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

   ヒント:

   テスト セットをトランザクションに簡単にリンクするには、リンクするテスト セットにトランザクションのラベルを追加します。これにより、その特定のラベルを使用して、作成したテスト セットを検索できます。 この例では、テスト ケースの作成に使用したラベルと同じラベル (TRAN:SE16) をテスト セットに追加しています。

   

4. テスト セットの作成後、Test Manager で [テスト セット] に移動します。

5. 作成したテスト セットを検索して開きます。

You can search for the test set using the label that you added at Step 3. 6. Select Tasks > Assign Test Cases > Static Assignment. 7. Search for the test cases that you created at Step 1 and assign them to this test set.

8. Navigate back to the Heatmap page, select the transaction, and check out the test set assigned to it.

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

1. テスト セットをトランザクションにリンクします。
2. Select More Options inline with the test set that you want to execute.
3. 以下のいずれかを選択します。
   • 手動で実行
   • 自動テストを実行
4. テスト結果をヒートマップで確認します。

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

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

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