自動グルーピング

Auto grouping は、プロジェクト全体のテストから重複したステップ列を検出し、再利用可能なグループに置き換える機能です。テストもコードと同様に、DRY（Don't Repeat Yourself）原則に従ってテストアーキテクチャから重複を減らすことでメンテナンスが容易になります。グループ内のステップを 1 箇所更新すると、そのグループに依存するすべてのテストへ変更が波及します。Auto Grouping 画面では、他のグループや他テストのステップ列と一致するステップ列の候補を確認でき、どれを共有グループに変換するかを判断できます。新しく共有グループを含むテストは新規ブランチに保存されるため、master ブランチへマージする前に変更内容をレビューできます。

重複レベルスコア（Duplication level scoring）

重複レベルスコアは、プロジェクト内にどれだけ重複したステップが残っているかを 0〜100 の数値で表します。スコアが高いほど重複が多い状態です。自動グルーピングの候補を適用していくと、このスコアを下げて重複を減らせます。 スコアは次の 3 色で表示されます。

• Green – 重複が少なく、良好な状態
• Yellow – 中程度の重複あり。自動グルーピングの適用を推奨
• Red – 重複が多い状態。自動グルーピングの適用が強く推奨されます

自動グルーピング候補の確認（Reviewing auto-grouping suggestion）

自動グルーピング候補を確認するには:

1. メインメニューで Auto-grouping をクリックします。
   画面右側の Auto Grouping ペイン（黒いペイン）に候補一覧が表示されます。ここには次の情報が含まれます。

• Project duplication level – プロジェクト全体の重複レベル。これは、master ブランチ内でグループ化できるもののまだグループ化されていない重複ステップの量を 0〜100 のスコアで表したものです。重複レベルを下げるには、一覧の候補を採用していきます。詳細は 重複レベルスコア を参照してください。

• The number of duplicate steps – 他のテストで見つかった同一ステップ列の数。
• Duplication level reduction – 候補を採用したときに重複レベルがどれだけ下がるか（例: 現在 14% で 1% と表示されている場合、採用後は 13% になる）。
• The number tests and groups – 同じステップ列が見つかったテスト／グループの数。

2. 候補をクリックして詳細を表示します。
   重複ステップを含むテスト／グループの詳細リストが Test List ペインに表示されます。

3. 対象のテスト／グループをクリックすると、重複しているステップ列がハイライト表示されます。

4. テスト全体のコンテキストの中で重複ステップ列を確認したい場合は、Open Test アイコンをクリックします。エディター画面が新しいタブで開き、重複ステップ列がハイライトされます。

自動グルーピング候補の編集（Editing the auto-grouping suggestion）

自動グルーピング候補を編集するには:

1. Auto-Grouping ペインで任意の候補を選択し、Edit アイコンをクリックします。

2. 候補に含めるステップを次のように編集します。

• グループに含めたい／含めたくないステップを選択・解除して調整します。

• Clear all をクリックすると選択をすべてクリアし、改めて含めたいステップだけを選択できます。

いつでも Select original をクリックすれば、元の提案内容に戻せます。
候補を編集すると、新しいグループ候補には Edited ラベルが付き、テスト一覧も編集内容に応じて更新されます。

自動グルーピング候補のフィルタリング（Filtering auto-grouping suggestions）

自動グルーピング候補が多い場合は、条件で絞り込むことができます。 候補をフィルタリングするには:

1. Auto Grouping ペイン（黒いペイン）でフィルターアイコンをクリックします。

FILTER & SORT STEPS DUPLICATIONS 画面が表示され、次のフィルターオプションを利用できます。

• Test owner – 選択したテストオーナーのテストのみ表示
• Test Name – 選択したテストのみ表示
• Suite Name – 選択したスイートに含まれるテストのみ表示
• Group Name – 選択したグループを含むテストのみ表示

2. いずれかのフィルター項目をクリックします。
   対象の一覧が表示されます。

3. Show all をクリックしてすべての項目を表示します。
4. 関連する項目を選択します。
5. Number of Steps で、重複ステップ数の範囲を指定したい場合は Min. Steps と Max Steps を入力します。
6. Apply をクリックしてフィルターを適用します。

自動グルーピング候補のソート（Sorting auto-grouping suggestions）

同じ画面で候補の並び順も変更できます。ソートオプション:

• Duplication Level - Descending (default) – 重複レベルの削減効果が大きい候補から表示
• Duplication level - Ascending – 重複レベルの削減効果が小さい候補から表示
• Number of steps - Ascending – 重複ステップ数が少ない候補から表示
• Number of steps - Descending – 重複ステップ数が多い候補から表示
• Number of matches - Ascending – 影響を受けるテスト／共有ステップ数が少ない候補から表示
• Number of matches - Descending – 影響を受けるテスト／共有ステップ数が多い候補から表示

候補から共有グループを作成する（Creating the shared group based on the suggestion）

候補から共有グループを作成するには:

1. Test List ペインで、自動グルーピングを適用したいテスト／グループを選択または解除します。
2. Create Shared Group をクリックします。
3. Shared group name フィールドに共有グループ名を入力します。
4. Branch で次のいずれかを選択します。

• New Branch – 新しいブランチを作成し、ブランチ名を入力します。
• Current Branch – master 以外のブランチで作業している場合、そのブランチに新しい共有グループ入りのテストを保存します。

5. Next をクリックします。
6. グループがパラメーターを使用している場合、自動グルーピング機能はグループ用に新しいパラメーターを作成します。この場合、追加のステップとしてパラメーター名を入力する画面が表示されます。

7. Create をクリックします。
   自動グルーピングが完了すると、完了メッセージが表示され、続けて次のグループ候補を処理できます。