Microsoft Teamsインテグレーション

ワークスペースでの重大な失敗やテストのインサイトについてのアラート機能は、自動テストで検出された問題やリグレッションの影響を最小限に抑えるうえで極めて重要です。このため、mablは、チームがコミュニケーションや調整に使用しているMicrosoft Teamsなどのツールと統合することができます。

選択したTeamsのチャネルに通知を直接送信するようにmablを設定することで、次のことが可能になります。

• 重大な失敗に関するアラートを設定することで、問題を迅速にトリアージできる

• 自動修復、リンク切れ、視覚的な変化のインサイトなど、チームが最も重視しているインサイトをモニタリングするようにフィルターを設定できる

• mablアプリケーションにログインすることなく、テスト出力のコメントを常に把握できる

このガイドでは、Microsoft Teamsインテグレーションのセットアップと設定方法について説明します。

セットアップ

Teamsインテグレーションをセットアップするには、通知を受け取るTeams内のチャネルにWebhook URLを追加します。このWebhook URLは、mablのTeamsインテグレーションセットアップフォームで使用します。

📘

セットアップの権限

Microsoft Teamsインテグレーションでは、Teamsの着信Webhook機能を使用して、mablなどのアプリケーションがチャネルに最新情報を直接送信できるようにします。このため、選択したチャネルにWebhookを追加できるTeamsの権限が必要です。Webhookを追加する権限をお持ちでない場合は、チーム内で適切な権限を持つ別のユーザーを見つけてください。

mablでTeamsインテグレーションを設定するには、ワークスペースの編集者または所有者である必要があります。

Teamsでのセットアップ

mablからの通知を追加するTeamsのチャネルに移動し、以下の手順を実行します。

1. 上部のナビゲーションバーで •••をクリックします。

2. ドロップダウンメニューから [Connectors] を選択します。

3. "Incoming Webhook" を検索し、[Add] を選択します。
4. [Configure]を選択します。

5. 名前に「mabl」と入力します。
6. 簡単に識別できるように、アイコンとしてこの画像をダウンロードすることをお勧めします。リンクを開き、右クリックして、[名前を付けて画像を保存]を選択してダウンロードします。
7. ダイアログウィンドウに、チャネルにマッピングされた一意のURLが表示されます。このWebhook URLをコピーします。これは、mablでインテグレーションをセットアップする際に必要になります。

8. [Done] を選択します。

mablでのセットアップ

mablアプリケーションで、[Settings] >[Integration]に移動して、Teamsインテグレーションのセットアップを実行します。

1. Microsoft Teamsのインテグレーションカードを見つけて、[+ Setup]ボタンをクリックします。

2. Teamsセットアップフォームで、次の必須情報を入力します。

• Name:
  インテグレーションには、データの送信先となるチャネルの名前など、識別しやすい名前を付けます。

• Webhook URL: TeamsのWebhook設定からコピーしたWebhook URLを貼り付けます。

3. それぞれのニーズに合わせて設定オプションを変更します。設定オプションの詳細については、次のセクションを参照してください。
4. [Save] をクリックします。

保存すると、インテグレーションが[Settings] > [Integrations]の[Active integrations] セクションに表示されます。

設定

トグルとドロップダウンを使用して、ニーズに合わせたTeamsインテグレーションを設定します。

基本設定 (The basics):

• Action buttons in cards:このオプションがオンの場合、失敗したプランの再実行をTeamsから直接トリガーできます。

プランの通知 (Plan notifications)

• Plan run passed

• Plan run failed:このオプションでは、プラン実行中に最初に発生したエラー、テストを最後に変更したユーザー、およびテストの更新日時に関する情報が通知されます。

• Plan run started

• Plan run status changed:このオプションでは、以前のプラン実行に失敗していたが、その後のプラン実行が成功している場合、または、以前のプラン実行に成功していたが、その後のプラン実行が失敗している場合に通知が送信されます。ステータスが失敗に変わった場合、通知には、テストを最後に変更したユーザーとテストの更新日時に関する情報が含まれます。

その他の通知 (Other notifications)

その他のタイプのインサイトに関する設定通知:

• Comments:テスト出力ページに追加されたコメント。

• Application broken:ホームページ読み込みの失敗と自動ログインの失敗に関するインサイトが含まれます。

• Timing:ページ読み込みとテスト実行のタイミングに関するインサイト。

• Broken links: リンク切れと修正されたリンクのURL

• [Autoheal]:ブラウザーテストでページ要素を見つけるためのmablの適応修正

• Visual changes:テスト実行中に見つかった視覚的な差異に関するインサイト。これらのインサイトを受け取るには、プランで視覚的変化の学習を有効にします。

• JavaScript errors:テスト実行中に発生した新しいJavaScriptのエラーと修正されたJavaScriptのエラー。

• Integration events: mablとのインテグレーションイベント(新しいOAuth (Slack)インテグレーションの追加など)、最初に成功したデプロイメント、最初のプラン実行に関するインサイト。

次の場合にのみ通知 (Only notify for)

インサイトステータス (Insight statuses)

[Plan notifications] および [Other notifications]セクションで設定した通知にフィルターを設定して、特定のタイプのインサイトを表示します。

たとえば、スケジュールされたプランのステータスが成功から失敗に変わったときにのみ通知を受け取りたい場合は、[Plan run status changed] をオンにして、インサイトフィルターを "Alert"に設定します。このように設定すると、プラン実行に成功のインサイトは除外され、プラン実行に失敗のインサイトが存在する場合にのみ通知が行われます。

テストでJavaScriptのエラーが見つかった場合に通知を受け取り、JavaScriptのエラーが修正された場合の通知を受け取らない場合は、[JavaScript errors] をオンにし、インサイトフィルターを "Warning"に設定します。このように設定すると、JavaScriptの修正のインサイトは除外され、JavaScriptの不具合のインサイトが存在する場合にのみ通知が行われます。

プランラベル (Plan labels)

プランラベルフィルターを使用して、特定のラベルを持つプランの通知のみを受け取ります。複数のラベルが選択されている場合、一致するプランにいずれかのラベルがタグ付けされている場合に通知が届きます。