> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 可視化カードにアラートを作成する

export const InlineImage = ({src, alt = '', height = '1.6em'}) => {
  return <img noZoom src={src} alt={alt} style={{
    display: 'inline',
    verticalAlign: 'start',
    height: height,
    margin: '0'
  }} />;
};

## はじめに

可視化カードにアラートを設定すると、（指定した）特定の条件が満たされたとき（例えば、数値が特定の限界値を超えたり低くなったりしたとき）に通知が届きます。アラートは、 **［新しいアラートを作成］** ダイアログで設定します。

<Note>
  **注記：** アラートは、メンバーになっているPDP（Personalized Data Permission）ポリシーに対してのみ設定できます。例えば、ポリシーのメンバーが西部の州のデータのみを表示する権限を持っている場合、作成されたアラートは西部の州にのみ適用されます。詳細については、「 [PDPとアラート](/s/article/360042934634 "PDPとアラート") 」を参照してください。
</Note>

アラートをメールまたはテキストメッセージのどちらで受け取るかを指定できます。詳細については、「 [通知とアラート設定を構成する](/s/article/360042925814 "通知とアラート設定をカスタマイズする") 」を参照してください。

## アラートを作成

**［アラート］** タブにアクセスし、次のいずれかの方法でアラートを作成できます。

* <InlineImage src="/images/kb/ja/ka0Vq000000DY79-00N5w00000Ri7BU-0EM5w000005vObn.png" /> **［カードのオプション］** メニューから **［アラートの設定］** を選択する。

* カードの **詳細** ビューを開き、 <InlineImage src="/images/kb/ja/ka0Vq000000DY79-00N5w00000Ri7BU-0EM5w000005vObp.png" /> をクリックして **［アラート］** タブを開く。

詳細ビューで **［アラート］** タブを開いたら、 **［新規アラート］** をクリックしてアラートを作成できます。次に、アラートを作成する3ステップの［新規アラート］ウィザードが表示されます。このウィザードのステップは次の通りです。

1. **カードを開く＞［アラートを表示］アイコン＞［＋新規アラート］ボタン＞［アラートのルールを設定］ダイアログ** 。アラートが発生する条件を指定します。また、Domoがアラート条件を満たしているかどうかを確認する頻度を指定することもできます。

   <Note>
     **注記：** カードにまとめ数字がある場合は、まとめ数字にもとづいてアラートを作成できます。一部のグラフタイプではまとめ数字のアラートのみを許可しています。つまり、これらのグラフタイプにまとめ数字がない場合、そのカードのアラートを作成することはできません。
   </Note>

2. **［お知らせメッセージを作成］** 。利用可能なメトリクスを表示するために、様々なマクロを使用してアラートのメッセージをカスタマイズできます。

3. **［このアラートをシェア］** 。アラートが発生したときに通知を受け取るユーザー、グループ、Buzzチャットを指定します。

引き続き、これらのステップについてより詳細に説明します。

### アラートのルールを設定

ウィザードのステップ1では、アラートが発生する条件を指定します。アラートが発生したかどうかをDomoがチェックする頻度を指定することもできます。

カードのDataSetにPDPポリシーが設定されている場合は、ウィザードのステップ1でPDPをアラートに適用する方法を指定できます。詳細については、「 [PDPとアラート](/s/article/360042934634 "PDPとアラート") 」を参照してください。

カードのデータにページフィルターまたはカードフィルターのいずれかが適用されている場合は、フィルターされているカードとフィルターされていないカードのどちらにアラートを適用するかを指定できます。

### アラート条件を指定

アラートは、以下で構成されています。

* 測定されるアイテム（「メトリクス」）。これには、チャート内の特定のカテゴリーや系列、チャートの現在の数値、チャート内のすべてのアイテムの合計があります。また、特定のカテゴリーや系列に適用される計算も含まれます。例えば、特定のカテゴリーに「平均」計算を適用し、その値が指定したしきい値を下回るとアラートが発生するように設定できます。Domoでは、「合計」のような単純な算術演算から「歪度」や「尖度」などの高度な統計演算まで、様々な計算を用意しています。
* 測定したものを数値または割合に関連付け、アラートの送信時期を決定する条件文。Domoでは、様々な条件文が用意されており、「～よりも大きい」、「～よりも小さい」、「～と等しい」などの条件文やそれらの組み合わせを使用できます。 **［次で変化］** 、 **［次で増加］** 、 **［減少：］** の条件文を使用して特定の変化の程度を指定することもできます。
* アラートのしきい値として使用される数値または割合。

アラートを作成するには、これらのコンポーネントをアラートウィザードのステップ1（「ルール」）の3つのフィールドに指定します。

<Frame>
  <img alt="alert_creation_new.png" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/8E3HpyZujsEhQGNi/images/kb/ka0Vq000000CmnF-00N5w00000Ri7BU-0EM5w000005vOcE.png?fit=max&auto=format&n=8E3HpyZujsEhQGNi&q=85&s=59596d667600cd5f7337455b0583ce71" width="500" height="122" data-path="images/kb/ka0Vq000000CmnF-00N5w00000Ri7BU-0EM5w000005vOcE.png" />
</Frame>

上記のスクリーンショットでは、測定に **［Poor Customer Service (Most recent month)］** 、条件文に **［次で増率（+ ％）］** を選択し、数値に「 `5` 」を入力しました。このアラートは、［Poor Customer Service (Most recent month)］の割合が5％増加すると発生します。

### アラートの頻度を指定

このタブでは、アラートの発生をチェックする頻度も指定できます。これを行うには、設定オプションの右下にある矢印をクリックし、目的のオプションを選択します。

<Frame>
  <img alt="alert_wizard_step1_arrow.png" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/8E3HpyZujsEhQGNi/images/kb/ka0Vq000000CmnF-00N5w00000Ri7BU-0EM5w000005vOc9.png?fit=max&auto=format&n=8E3HpyZujsEhQGNi&q=85&s=701823c37afd1af1833b7f94fecad430" width="600" height="243" data-path="images/kb/ka0Vq000000CmnF-00N5w00000Ri7BU-0EM5w000005vOc9.png" />
</Frame>

オプションには、 **［データが更新されるたび］** 、 **［毎時］** 、 **［毎日］** 、 **［毎週］** 、 **［毎月］** があります。

* **［データが更新されるたび］** を選択すると、Domoはカード内のデータが更新されるたびにアラートを確認します。
* **［毎時］** または **［毎日］** を選択すると、評価に週末を含めるかどうかを選択できます。 **［毎日］** を選択した場合は、特定の時刻を設定することもできます。
* **［毎週］** を選択すると、特定の曜日と時刻を選択できます。
* **［毎月］** を選択すると、特定の日付または月の初日/末日と時刻を選択できます。

選択したアラート条件によっては、 **［発生している状態の間は通知を送信し続ける］** チェックボックスが表示される場合があります。このボックスをオンにすると、アラートが発生した時点で1回だけ通知が送信される（デフォルトの機能）のではなく、 *アラート条件が満たされなくなるまで* 選択された頻度で通知が送信されます。例えば、Gusというユーザーが「まとめ数字が500よりも大きい」というアラートルールを作成し、頻度に **［毎週］** を選択して、このボックスをオンにしたとします。まとめ数字が500を超えるとすぐに通知が送信されます。その後、まとめ数字が500を超えている限り、指定した曜日の指定した時刻に新しい通知が送信されます。この数が500を下回ると、通知は送信されなくなります。一方、Gusがこのボックスをオンにしない場合は、アラート発生時の最初の通知のみが送信されます。

特定の変化の程度を満たすと発生する1回限りのアラートとは対照的に、 **［発生している状態の間は通知を送信し続ける］** チェックボックスはしきい値ベースのアラートの場合のみ表示されます。例えば、［次よりも大きい（>）］アラート（値が1000を超えると発生するアラートなど）では、値がしきい値を超えている間はアラートが適用されるため、このボックスは使用可能になります。一方、［次で変化］アラートでは、指定した値に達すると、1通の通知のみが送信され、アラートの処理は完了するため、このボックスは使用できません。

#### フィルターを受け入れるかどうかを決定

このカードにダッシュボードまたはカードのいずれかのレベルでフィルターが設定されている場合、そのフィルターをアラートで受け入れるかどうかを切り替えるオプションが表示されます。ボックスをオンにしない場合は、フィルターなしのバージョンのカードにアラートが適用されます。 **［フィルターを表示］** オプションを選択すると、現在適用されているフィルターが表示されます。

### アラートメッセージをカスタマイズ

ウィザードのステップ2では、アラートが発生するたびに送信される通知メッセージをカスタマイズできます。様々なマクロから選択してメッセージに含めることができます。マクロは、アラート名、以前または現在の値、アラート所有者、アラート値の変更など、アラートに関連する様々な変数を参照するために使用されます。例えば、ステップ2を入力したときに表示されるデフォルトの通知メッセージでは、ウィザードのステップ1で設定したアラートルール、アラートが検出されたカードの名前、前のアラート値、現在のアラート値を示すためにマクロが使用されています。

<Frame>
  <img alt="alert_wizard_step2.png" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/EpEQaVXeYQJOgZLs/images/kb/ka0Vq000000DY79-00N5w00000Ri7BU-0EM5w000005vOcA.png?fit=max&auto=format&n=EpEQaVXeYQJOgZLs&q=85&s=f08878502e11a1415abe683189412b16" width="500" height="163" data-path="images/kb/ka0Vq000000DY79-00N5w00000Ri7BU-0EM5w000005vOcA.png" />
</Frame>

ウィザードの左のパネルの「メッセージ」の下には、マクロに変換された変数を含む通知メッセージが表示されます。したがって、上記のデフォルトの通知メッセージの場合、このメッセージは次のように表示されます。

<Frame>
  <img alt="alert_wizard_step2_variables.png" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/8E3HpyZujsEhQGNi/images/kb/ka0Vq000000CmnF-00N5w00000Ri7BU-0EM5w000005vObq.png?fit=max&auto=format&n=8E3HpyZujsEhQGNi&q=85&s=adbc39b40f60102eddf2ec08e7801753" width="350" height="114" data-path="images/kb/ka0Vq000000CmnF-00N5w00000Ri7BU-0EM5w000005vObq.png" />
</Frame>

この例では、［完全なルール］は「1 - 非常に不満の合計が50以上」に、［カード名］は「顧客満足度」に、［前のアラート値］は（このアラートの前の値がないため）「空」に、［現在のアラート値］は「653」にそれぞれ置き換えられました。

テンプレートの上にある **［メトリクス］** ボタンをクリックすると、マクロのリストが表示されます。このリストには、マクロごとにアラート内の対応する変数の名前が表示されるため、正しい情報を取得しているかどうかを確認できます。

<Frame>
  <img alt="alert_wizard_step2_macros_list.png" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/8E3HpyZujsEhQGNi/images/kb/ka0Vq000000CmnF-00N5w00000Ri7BU-0EM5w000005vObr.png?fit=max&auto=format&n=8E3HpyZujsEhQGNi&q=85&s=06cf525d312ff1e3d309c53687c7bf01" style={{width: 307, height: 631}} width="400" height="822" data-path="images/kb/ka0Vq000000CmnF-00N5w00000Ri7BU-0EM5w000005vObr.png" />
</Frame>

カスタムメッセージを編集した後にデフォルトに戻す場合は、アラートメッセージフィールドの右上隅にある <InlineImage src="/images/kb/ja/ka0Vq000000DY79-00N5w00000Ri7BU-0EM5w000005vObv.png" /> をクリックします。

### 別の操作を追加

アラートアクションは、サードパーティシステムとのWebhookの統合やDomoのプロジェクトとタスクの統合などのイベントをトリガーすることにより、ビジネスの強力なアクションを推進します。メッセージプレビューペインの下にある **［別の操作を追加］** ボタンをクリックし、アクションタイプを選択し（Webhookまたはタスク）、アクションを構成することで、アクションをアラートに追加することができます。

#### Webhookアクション

Webhookアクションをアラートに追加することで、アラートのしきい値に到達したときにサードパーティシステムでイベントをトリガーできます。例えば、CFOは、株価が特定の価格に到達したときに祝賀メッセージを会社のFacebookページに投稿するWebhookを作成することができます。

Webhookアクションを作成するには、必要な手順は、Webhook URLを入力し、HTTP APIメソッド（POST、DELETE、PATCH、GET、およびPUTを利用可能）を選択して、必要に応じてシークレット認証キーを入力するだけです。以前に説明したカスタマイズ済みのアラートメッセージは別として、Webhook本文を編集することはできません。

アクションを構成した後に、 **［テストを送信］** をクリックするとテストできます。

**動画 - アラートアクションの概要**

<iframe allowfullscreen="" frameborder="1" height="315" src="//www.youtube-nocookie.com/embed/8zXKGYuGd64" width="560" />

Webhookアクションを構成するには、次の手順を実行します。

1. **［別の操作を追加］** ボタンをクリックします。このボタンは、アラートウィザードの **［メッセージ］** ペインにあります。

   <Frame>
     <img alt="alert_actions_kpi_attach_button.png" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/EpEQaVXeYQJOgZLs/images/kb/ka0Vq000000DY79-00N5w00000Ri7BU-0EM5w000005vObm.png?fit=max&auto=format&n=EpEQaVXeYQJOgZLs&q=85&s=702ddd7b3065b2c62881ea8272d0365d" width="700" height="435" data-path="images/kb/ka0Vq000000DY79-00N5w00000Ri7BU-0EM5w000005vObm.png" />
   </Frame>
2. **［Domo Webhook］** を選択します。
3. 目的のWebhookのURLを入力します。
4. **［方法］** メニューで目的のHTTPメソッドを選択します（デフォルトは **［POST］** ）。
5. （条件付き）認証に必要な場合は、 **［シークレット］** フィールドに認証キーを入力します。
6. （条件付き）あらかじめアラートメッセージをカスタマイズしていなかった場合は、 **［Webhook本文］** の隣にある矢印をクリックして、本文の内容まで下にスクロールし、鉛筆をクリックしてメッセージエディターを開くことで、カスタマイズできます。こちらのオプションの詳細については、「 [アラートメッセージをカスタマイズする](/s/article/360042925994 "DataSetのアラートを作成する") 」を参照してください。
7. （オプション）構成をテストする場合は、 **［テストを送信］** をクリックします。
8. **［次へ］** をクリックして、ウィザードの次のステップに進みます。

#### タスク作成アクション

アラートがトリガーされたときのタスクを作成することができます。新しいタスクが追加されるプロジェクトを選択し、まだの場合はカスタマイズ済みのアラートメッセージを編集して、新しいタスクの所有者を選択することができます。アラートのしきい値に到達するとすぐに、新しいタスクがDomoに追加され、選択した所有者に割り当てられます。プロジェクトとタスクの詳細については、「 [プロジェクトとタスク](/s/topic/0TO5w000000Zao5GAC "プロジェクトとタスク") 」を参照してください。

タスクアクションを構成するには、次の手順を実行します。

1. **［別の操作を追加］** ボタンをクリックします。このボタンは、アラートウィザードの **［メッセージ］** ペインにあります。

   <Frame>
     <img alt="alert_actions_kpi_attach_button.png" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/EpEQaVXeYQJOgZLs/images/kb/ka0Vq000000DY79-00N5w00000Ri7BU-0EM5w000005vObm.png?fit=max&auto=format&n=EpEQaVXeYQJOgZLs&q=85&s=702ddd7b3065b2c62881ea8272d0365d" width="700" height="435" data-path="images/kb/ka0Vq000000DY79-00N5w00000Ri7BU-0EM5w000005vObm.png" />
   </Frame>
2. **［タスク］** を選択します。
3. **［プロジェクト］** メニューで、このタスクが存在しているはずのプロジェクトを選択します。

   目的の親プロジェクトがまだ存在していない場合、作成する必要があります。詳細については、「 [プロジェクトを作成する](/s/article/360043430333 "プロジェクトを作成する") 」を参照してください。
4. （条件付き）あらかじめアラートメッセージをカスタマイズしていなかった場合は、必要に応じて **［タスク名］** エリアでこのフィールドを更新することでカスタマイズできます。こちらのオプションの詳細については、「 [アラートメッセージをカスタマイズする](/s/article/360042925994 "DataSetのアラートを作成する") 」を参照してください。
5. **［所有者］** メニューで目的のタスク所有者を選択します。
6. **［次へ］** をクリックして、ウィザードの次のステップに進みます。

### アラートをシェア

ウィザードのステップ3では、Domoのほかのユーザーやグループとアラートをシェアして、アラートが発生するたびに通知を受け取ることができます。また、カスタムメッセージを作成して何が発生しているかをユーザーに知らせたり、アラートを閲覧すべきではないユーザーやグループを削除することもできます。ユーザーとグループを削除できるのは、「管理者」のデフォルトセキュリティプロフィールまたは「全てのグループを管理」が有効なカスタマイズされた権限を持つユーザーのみです。デフォルトのセキュリティプロフィールの詳細については、「 [カスタマイズされた権限を管理する](/s/article/360043438973 "セキュリティ権限リファレンス") 」を参照してください。

Buzzチャットでアラートをシェアすることもできます。その場合は、そのチャットをフォローしているすべてのユーザーが通知を受け取ります。チャットを検索して、シェアするアラートのチャットを選択できます。この検索では、チャット名からキーワードのみを検索し、チャットの内容は検索しません 。

アラートは、ユーザープロフィールで指定されたメールアドレスおよび電話番号に送信されます。詳細については、「 [プロフィールページ](/s/topic/0TO5w000000ZaoLGAS "プロフィールページ") 」を参照してください。

通知の設定の詳細については、「 [通知とアラート設定を構成する](/s/article/360042925814 "通知とアラート設定を構成する") 」を参照してください。

Domoのほかのユーザーとアラートをシェアすると、そのユーザーはアラートが関連付けられているカードへのアクセスを自動的に取得します（まだ取得していない場合）。

ユーザーやグループとアラートをシェアするには、次の手順を実行します。

1. シェアするユーザーまたはグループを追加するには、アラート作成ウィザードの **［このアラートをシェア］** ステップで、 **［ユーザー、グループ、またはメールアドレスを入力…］** フィールドをクリックし、目的のユーザー、グループ、メールを選択します。

   <Note>
     **注記：** カードを作成するDataSetにPDPポリシーが適用されている場合にアラートをグループとシェアするには、PDPポリシーがそのグループに明確に設定されている必要があります。
   </Note>

   ユーザーまたはグループを選択すると、そのユーザーまたはグループの名前がフィールドに表示されます。複数のユーザーやグループとシェアする場合は、対象となるすべての名前を選択してフィールドに追加します。
2. （オプション）［お疲れ様です。共有しますのでご確認ください。］フィールドにメッセージを入力し、最新情報をユーザーに知らせます。
3. **［保存］** をクリックします。

アラートは選択したユーザーとシェアされます。通知メッセージを入力した場合、そのメッセージがシェアしたユーザーに送信されます。

このアラートのシェアリストからユーザーまたはグループを削除するには、次の手順を実行します。

1. アラートが発生しているカードの詳細ビューで
   <InlineImage src="/images/kb/ja/ka0Vq000000DY79-00N5w00000Ri7BU-0EM5w000005vObp-1.png" /> アイコンをクリックして、このカードのアラートを表示させます。
2. ユーザーを削除するアラートの **［シェア］** ボタンをクリックします。
3. 「既に［ユーザー］とシェア中」というメッセージをクリックして、ダイアログの下部にあるセクションを展開します。

   アラートをシェアしているすべてのユーザーやグループの行が表示されます。
4. 削除するユーザーまたはグループの［x］をクリックして、シェアリストからユーザーまたはグループを削除します。

ユーザーまたはグループがシェアリストから削除され、このアラートの発生時に通知を受信しなくなります。

Buzzチャンネルでアラートをシェアするには、次の手順を実行します。

1. アラート作成ウィザードの **［このアラートをシェア］** で、 **［Buzz］** タブをクリックします。
2. （オプション） **［Buzzチャンネルとチャットをフィルター］** フィールドを使用して、このアラートをシェアするチャットを検索します。
3. アラートをシェアするチャットのボックスをすべてオンにします。
4. **［シェア］** をクリックします。

選択したチャットでアラートがシェアされます。これらのチャットをフォローしているユーザーは、アラートが発生するたびに通知を受け取るようになります。

## アラートを保存

目的のアラートコンポーネントを選択して値を入力したら、 **［保存］** をクリックします。

新しいアラートが、 **詳細** ビューの **［アラート］** タブに表示されます。このアラートでは以下のいずれかを実行できます。

* 開いて編集する。
* 「サブスクライブ解除」し、アラートが発生しても通知を受け取ら *ない* ようにする。デフォルトでは、アラートを作成したときにフォローするように設定されています。
* アラートが発生した回数を確認する。
* アラートを削除する。
* アラートの通知を即時、毎日、毎週に設定する。
* アラートイベントのリストを表示する。
* フォロワーのリストを表示する。

## アラートを編集

アラートは、次のいずれかの方法で開いて編集することができます。

* カードページにあるカードの
  <InlineImage src="/images/kb/ja/ka0Vq000000DY79-00N5w00000Ri7BU-0EM5w000005vObn-1.png" /> メニューから **［アラートの設定］** を選択し、そのアラートカードの上部をクリックしてから **［編集］** をクリックする。
* カードページのカードの
  <InlineImage src="/images/kb/ja/ka0Vq000000DY79-00N5w00000Ri7BU-0EM5w000005vObo.png" /> をクリックし、そのアラートカードの上部をクリックしてから **［編集］** をクリックする（このアイコンは、カードで1つ以上のアラートが発生した場合 *のみ* 表示されます）。
* 画面上部のAppツールバーで **［アラート］** を選択し、編集するアラートを探してクリックしてから［ルール］または［メッセージのプレビュー］の横にある **［編集］** ボタンをクリックして、必要な変更を加える。
* カードの詳細ビューを開き、
  <InlineImage src="/images/kb/ja/ka0Vq000000DY79-00N5w00000Ri7BU-0EM5w000005vObp-2.png" /> をクリックして **［アラート］** タブを開き、そのアラートカードの上部をクリックしてから **［編集］** をクリックする。

**動画 - アラートの概要**

<iframe allowfullscreen="" frameborder="1" height="315" src="//www.youtube-nocookie.com/embed/rrRDjC_prWA" width="560" />

日本語
