When data reaches selected condition, data-driven notification automatically sends an email or push notification to the people you specify. You can set data-driven notifications in the data sets.

Creating notification

Notifications can be created from the data set details. Click the option Notification in the section Data to create new notification and list existing notifications from the selected data set.

Click the button New notification to open the Notification wizard.

The notification wizard will guide you through the steps required for creating a new notification. Each step is displayed as a separate tab.

Use the navigation at the top of the screen to navigate in the notification wizard:

• Button Back will display the previous tab
• Button Continue will move you to the next tab
• Tab name will display the details of the selected tab

1. Elements

The elements are columns which will be used for the evaluation of the designated condition. The tab elements is used to select the columns will be used for the evaluation of the designated condition. You can add attributes, indicators, formula indicators or filters. Attributes define the aggregation of the condition. For example, if the user selects column Country, the data will be aggregated for each country (one row = one country). The condition will be checked for every country.

The filter can also work with the actual date. To use this function, the data set has to contain a DateTime attribute. Then, users can configure a filter that will return only values from the selected interval, e.g. from last one day and five minutes:"nowTnownow-1dTnow-5M".

Users can also create formula indicators (the process is the same as when creating formula indicators in the report). The preview of the table which will be used for the evaluation of the condition is displayed below the panel for adding the elements. Please note that the preview is built on the data sample only, which means that it can be empty, although some data will be validated. It is possible to change the order of the attributes and dates by using the arrows displayed next to the names of the columns in the header of the preview.

Click the button Continue to proceed to the next step of the Notification configuration:

2. Notifications condition

The condition defined on the tab Notification condition will be used for the notification evaluation. Elements available for the condition evaluation:

• No condition - notification will be always sent
• Indicator element selected on the tab Elements

Click the button Continue to proceed to the next step of the Notification configuration:

3. Action

Selected action will be used to send the notification in case the Notification condition is met.

1. Click the button Add notification action to start creating a new notification
2. Select notification action:
   1. Send email - email notification will be sent to the selected users
   2. Send FCM notification - push notification will be sent to the smartphones of the selected users (make sure that Firebase configuration is correctly set and Device IDs of the users' smartphones are available in the elements)
   3. System notification - is used to display notification inside Map view in report. This notification needs to be also set with that specific view.
3. Define message and recipients (the setup is the same for both, email and FCM all notifications):
   1. Subject - Custom message sent in the notification
   2. Message for recipients - Custom message sent to the notification recipients
   3. Merge notifications - All evaluated rows will be included in one email only. Variables should be wraped with three at signs example: @@@ ${L_ATT_CODE}  ${L_ATT_CODE_2}@@@ . This L_ATT_CODE and L_ATT_CODE_2 variables will be replaced with all values in loop. See also example in picture bellow.
      
   4. Recipients - select BellaDati users who will receive the notification
   5. Recipients groups - select BellaDati user groups which will receive the notification
   6. Take recipients from element - if some element contains the recipients who should be notified when the condition is met, select the column which contains the recipient's contact
   7. Variables - the Subject and Message for recipients can contain dynamic values based on the actual row value. Following variables are available:
      1. ${compare_value} - row value based on the aggregation defined in the Elements
      2. ${operation} - the operation selected in the Notification condition 
      3. ${condition_value} - condition value defined in the Notification condition
      4. ${L_ATTRIBUTE_CODE} - code of the attribute selected in the Elements
      5. ${indicator_name} - name of the indicator defined in the Elements

   8. Recipient formula -You can define your recipients using formula, you can also read data from different dataset.
      here is example of formula 

      Code Block
      result = [] List allUsers = readDataset(940) allUsers.each { user ->  result.add(user.getValues()['L_ID']) } return result

      
      

4. Click the button Continue to proceed to the next step of the Notification configuration

Image RemovedImage Added

4. Schedule

The notification schedule defines the date interval in which the notification will be executed. Following options are available:

• Execute on data change - the notification will be executed everytime the data is changed
• When - time of the notification - the notification will be scheduled to the predefined time
• Schedule - select the interval in which the notification will be repeated
• Allow once in interval [min] - this parameter defines the limit (in minutes) of how often the notification can be sent. If the limit is set to 60 and the condition is reached in less than 60 minutes after the first notification was sent, the next notification is ignored.
• Dry run - click the button Dry run to see the results of the notification evaluation

Click the button Continue to schedule the notification.

Managing notifications

Notifications associated with the selected data set

Notifications associated with the data set can be accessed from the data set details. Click the option Notification in the section Data to create new notification and list existing notifications from the selected data set.

The notifications overview provides the details of the notification and the following actions:

• Check now - will execute the notification manually
• Show log - Will display the overview of the notifications checks and the results
• Delete - will delete the notification

All notifications

All the notifications can be managed from the screen Data sets - click the action Notifications to open the list of all the Notifications.

Screen Notifications provides details about:

• Notification Name - clicking will redirect to the list of the data set notifications
• Name of the associated Data set - clicking will redirect to the data set summary
• Selected Notification action applied in the notification
• Execution on data change - enabled/disabled
• Owner - the user who create the notification
• Created  - date and time when the notification has been created
• Last event - last time when the notification condition has been met and the notification has been sent
• Button Show log - Will display the overview of the notifications checks

データが選択された条件に達すると、データ駆動型通知は、指定したユーザーに電子メールまたはプッシュ通知を自動的に送信します。データセットにデータ駆動型通知を設定できます。

通知の作成

通知は、データセットの詳細から作成できます。 [データ]セクションの[通知]オプションをクリックして、選択したデータセットから新しい通知を作成し、既存の通知を一覧表示します。

[新規通知]ボタンをクリックして、通知ウィザードを開きます。

通知ウィザードは、新しい通知の作成に必要な手順をガイドします。各ステップは個別のタブとして表示されます。

画面上部のナビゲーションを使用して、通知ウィザードでナビゲートします:

• 戻るボタンは前のタブを表示します

• 続行次へボタンをクリックすると、次のタブに移動します

• 各タブ名には、選択したタブの詳細が表示されますをクリックすると、選択したタブの詳細が表示されます

1. 要素(エレメント)

要素は、指定された条件の評価に使用される列です。タブ要素は、指定された条件の評価に使用される列を選択するために使用されます。属性、インジケータ、数式インジケータ、フィルターを追加できます。属性は、条件の集約を定義します。例えば、ユーザーが国列を選択すると、データは国ごとに集計されます（1行要素は、指定された条件の評価に使用される列です。要素タブは、指定された条件の評価に使用される列を選択するために使用されます。属性、インジケータ、数式インジケータ、フィルターを追加できます。属性は、条件の集約を定義します。例えば、ユーザーが国列を選択すると、データは国ごとに集計されます（1行= 1国）。条件はすべての国でチェックされます。

フィルターは実際の日付でも機能します。この関数を使用するには、データセットに日付時刻属性が含まれている必要があります。次に、ユーザーは、選択した間隔の値のみを返すフィルターを構成できます。例：直近1日と5分："nowTnownow-1dTnow-5M"。

Image Added

ユーザーは、数式インジケータを作成することもできます（プロセスはレポートで数式インジケータを作成する時と同じです）。条件の評価に使用されるテーブルのプレビューは、要素を追加するためのパネルの下に表示されます。プレビューはデータサンプルのみに基づいて作成されます。つまり、一部のデータは検証されますが、空にすることができます。プレビューのヘッダーの列の名前の横に表示される矢印を使用して、属性と日付の順序を変更できます。

[続行次へ]ボタンをクリックして、通知設定の次の手順に進みます:

2. 通知条件

タブ通知条件で定義された条件は、通知評価に使用されます。条件評価に使用できる要素:

• 条件なし - 通知は常に送信されます
• タブ要素で選択されたインジケータ要素

[続行次へ]ボタンをクリックして、通知設定の次の手順に進みます:

3. アクション

選択したアクションは、通知条件が満たされた場合に通知を送信するために使用されます。

1. [通知アクションを追加]ボタンをクリックして、新しい通知の作成を開始します。
2. 通知アクションを選択:
   1. メールをeメール送信 - 選択したユーザーにメール通知が送信されます。
   2. FCM通知を送信 FCM通知送信 - プッシュ通知は選択したユーザーのスマートフォンに送信されます（Firebaseの構成が正しく設定され、ユーザーのスマートフォンのデバイスIDが要素で利用可能であることを確認してください）。
      
   3. システム通知 - レポートの地図ビューの中に通知を表示するために使用されます。この通知は、その特定のビューでも設定される必要があります。
3. メッセージと受信者を定義します（セットアップは電子メールとFCM通知の両方で同じです）メッセージと受信者を定義します（セットアップはすべて同じです）:
   1. 件名 - 通知で送信されるカスタムメッセージ
   2. 受信者へのメッセージ - 通知の受信者に送信されるカスタムメッセージ
   3. マージ通知 - 評価されたすべての行は、1つのメールにのみ含まれます。変数は3つの記号で囲んでください（例）。@@@ ${l_att_code}とします。 このL_ATT_CODEとL_ATT_CODE_2の変数は、ループの中ですべての値に置き換えられます。下の図の例も参照してください。
   4. 受信者 - 通知を受け取るBellaDatiユーザーを選択します
   5. 受信者グループ - 通知を受け取るBellaDatiユーザーグループを選択します
   6. 要素から受信者を取得 - 一部の要素に条件が満たされたときに通知する受信者が含まれる場合、受信者の連絡先を含む列を選択します
   7. 変数 - 受信者の件名とメッセージには、実際の行の値に基づいた動的な値を含めることができます。次の変数を使用できます:
      1. ${compare_value} - 要素で定義された集計に基づく行の値
      2. ${operation} - 通知条件で選択された操作 
      3. ${condition_value} - 通知条件で定義された条件値
      4. ${L_ATTRIBUTE_CODE} - 要素で選択された属性のコード
      5. ${indicator_name} - 要素で定義されたインジケータの名前
   [続行
   1. 受信者の数式 -数式を使用して受信者を定義することができ、異なるデータセットからデータを読み込むこともできます。
      以下は数式の例です。

result = []

List allUsers = readDataset(940)
allUsers.each { user -> 
  result.add(user.getValues()['L_ID'])
}
return result

4. [次へ]ボタンをクリックして、通知構成の次の手順に進みます。

Image RemovedImage Added

4. スケジュール

通知スケジュールは、通知が実行される日付間隔を定義します。次のオプションが利用可能です:

• データ変更時に実行 - データが変更されるたびに通知が実行されます
• いつ - 通知の時間 - 通知は事前定義された時間にスケジュールされます
• スケジュール - 通知を繰り返す間隔を選択します
• 間隔間隔 [分]で1回許可毎に許可 - このパラメーターは、通知を送信できる頻度の制限（分単位）を定義します。制限が60に設定され、最初の通知が送信されてから60分以内に条件に到達した場合、次の通知は無視されます
• 予行演習 テスト実行 - [予行演習テスト実行]ボタンをクリックして、通知評価の結果を確認します

[続行次へ]ボタンをクリックして、通知をスケジュールします。

通知の管理

選択したデータセットに関連付けられた通知

データセットに関連付けられた通知には、データセットの詳細からアクセスできます。 [データ]セクションの[通知]オプションをクリックして、選択したデータセットから新しい通知を作成し、既存の通知を一覧表示します。

通知の概要には、通知の詳細と次のアクションが記載されています:

• 今すぐ確認 今チェックする - 通知を手動で実行します
• ログを表示 ログを表示する - 通知チェックと結果の概要を表示します
• 削除 削除する - 通知を削除します

すべての通知

すべての通知は、画面の[データセット]から管理できます - [通知]アクションをクリックして、すべての通知のリストを開きます。

通知画面は、次に関する詳細を提供します:

• 通知名 - クリックすると、データセット通知のリストにリダイレクトされます
• 関連するデータセットの名前 - クリックすると、データセットの概要にリダイレクトされます
• 通知に適用される選択された通知アクション
• データ変更時の実行 - 有効/無効
• 所有者 - 通知を作成するユーザー
• 作成済み  - 通知が作成された日時
• 最後のイベント - 通知条件が満たされ、通知が送信された最後の時間
• ログを表示ボタン - 通知チェックの概要を表示します