5. 通知管理

5.1. はじめに

本書では、Exastro システム における 通知管理 について説明します。

5.2. 通知先設定の登録

通知管理では、IT AutomationやOASEで利用するイベントごとの通知を受け取るための設定を行うことが出来ます。

5.2.1. 通知先設定の登録手順

通知先設定は、下記の手順で行ないます。
  1. Exastro システムにオーガナイゼーション管理者でログインします。
  2. メニューより 通知管理 をクリックします。
    ../../_images/platform_menu.png

    注釈

    OASE機能について
    OASE機能の詳細につきましては OASE共通 をご参照ください。
  3. 通知先ワークスペース一覧 画面が表示されるので、通知先設定を行いたいワークスペースを選択、または 通知先設定 をクリックします。
    ../../_images/%E9%80%9A%E7%9F%A5%E5%85%88%E3%83%AF%E3%83%BC%E3%82%AF%E3%82%B9%E3%83%9A%E3%83%BC%E3%82%B9%E4%B8%80%E8%A6%A7%E7%94%BB%E9%9D%A2.png

    注釈

    アクセス権限のあるワークスペースのみ表示されます。
  4. 通知先設定一覧 画面が表示されるので、 作成 をクリックします。
    ../../_images/%E9%80%9A%E7%9F%A5%E5%85%88%E8%A8%AD%E5%AE%9A%E4%B8%80%E8%A6%A7%E7%94%BB%E9%9D%A2.png
  5. 新規通知先設定 画面が表示されるので、通知先の情報を入力し、 登録 をクリックします。

    • 新規通知先設定画面（共通部、送信設定）

      ../../_images/%E6%96%B0%E8%A6%8F%E9%80%9A%E7%9F%A5%E5%85%88%E8%A8%AD%E5%AE%9A%E7%94%BB%E9%9D%A2_%E5%85%B1%E9%80%9A_v2-7.png
      表 5.22 新規通知先設定登録 - 共通部、送信設定

      項目名

      説明

      通知先ID
      通知先に割り当てる一意のIDを指定します。
      ここで指定した ID を使ってシステム間の連携を行います。
      初期値として自動的にIDが付与されます。

      通知先名
      通知先に割り当てる名前を指定します。

      通知方法
      通知方法を指定します。
      選択した通知方法に応じて、以下の各設定項目が表示されます。

      送信設定
      OASEで利用できるイベント種別ごとの通知有無を選択します。

    • 通知方法がMailの時の画面

      ../../_images/%E6%96%B0%E8%A6%8F%E9%80%9A%E7%9F%A5%E5%85%88%E8%A8%AD%E5%AE%9A%E7%94%BB%E9%9D%A2_Mail_v2-7.png
      表 5.23 新規通知先設定登録 - Mail

      項目名

      説明
      通知先(to, cc, bcc)
      Mailで通知するメールアドレスを指定します。

    • 通知方法がTeams(Workflows)の時の画面

      ../../_images/%E6%96%B0%E8%A6%8F%E9%80%9A%E7%9F%A5%E5%85%88%E8%A8%AD%E5%AE%9A%E7%94%BB%E9%9D%A2_TeamsWF_v2-7.png
      表 5.24 新規通知先設定登録 - Teams(Workflows)

      項目名

      説明

      通知先(URL)
      Teamsのワークフローの「Webhook要求を受信するとチャネルに投稿する」で発行したURLを指定します。

    • 通知方法がWebhookの時の画面

      ../../_images/%E6%96%B0%E8%A6%8F%E9%80%9A%E7%9F%A5%E5%85%88%E8%A8%AD%E5%AE%9A%E7%94%BB%E9%9D%A2_Webhook_v2-7.png
      表 5.25 新規通知先設定登録 - Webhook

      項目名

      説明

      通知先(URL)
      Webhookを送信するURLを指定します。

      通知先(Header)
      Webhookを送信する際のHTTP HeaderをJSON形式で指定します。

    • 通知方法がServiceNow(レコード登録)の時の画面

      ../../_images/%E6%96%B0%E8%A6%8F%E9%80%9A%E7%9F%A5%E5%85%88%E8%A8%AD%E5%AE%9A%E7%94%BB%E9%9D%A2_ServiceNow_v2-7.png
      表 5.26 新規通知先設定登録 - ServiceNow(レコード登録)

      項目名

      説明

      通知先(ServiceNow API URL (個別登録用))
      ServiceNow テーブルAPIのURLを入力します。

      通知先(ServiceNow ユーザー)
      ServiceNowに送信する際のユーザーを指定します。

      通知先(ServiceNow パスワード)
      ServiceNowに送信する際のユーザーパスワードを指定します。

      通知先(一括登録)
      バッチAPIを利用して一括で登録を行いたい場合は「一括登録」にチェックを入れます。

      通知先(ServiceNow API URL (一括登録用))
      ServiceNow バッチAPIのURLを入力します。

      通知先(送信間隔 (秒))
      一括登録を実行する間隔を指定します。ここで指定した秒数毎にバッチAPIがコールされます。

      通知先(一回に送信する最大件数)
      一括登録を実行する際に送信されるメッセージの最大件数を指定します。

    Tip

    通知のテンプレートについて
    ServiceNow (レコード登録)の通知方法を利用する場合は、テンプレートのフォーマット調整が必須です。
    通知のテンプレートについては、 通知テンプレート（共通） を参照してください。
    設定変更、設定例については、 ServiceNow(レコード登録)の設定例 を参照してください。

5.2.2. 通知先設定の詳細確認

通知先設定の詳細確認は、下記の手順で行ないます。
  1. Exastro システムにオーガナイゼーション管理者でログインします。
  2. メニューより 通知管理 をクリックします。
    ../../_images/platform_menu.png
  3. 通知先ワークスペース一覧 画面が表示されるので、通知先設定の詳細確認を行いたいワークスペースを選択、または 通知先設定 をクリックします。
    ../../_images/%E9%80%9A%E7%9F%A5%E5%85%88%E3%83%AF%E3%83%BC%E3%82%AF%E3%82%B9%E3%83%9A%E3%83%BC%E3%82%B9%E4%B8%80%E8%A6%A7%E7%94%BB%E9%9D%A2.png

    Tip

    アクセス権限のあるワークスペースのみ表示されます。
  4. 通知先設定一覧 画面が表示されるので、詳細確認を行いたい通知先設定をクリックします。
    ../../_images/%E9%80%9A%E7%9F%A5%E5%85%88%E8%A8%AD%E5%AE%9A%E4%B8%80%E8%A6%A7_v2-7.png
  5. 通知先設定詳細 画面が表示されます。
    詳細確認の他、編集、削除、通知テストが実施できます。
    ../../_images/%E9%80%9A%E7%9F%A5%E5%85%88%E8%A8%AD%E5%AE%9A%E8%A9%B3%E7%B4%B0%E7%94%BB%E9%9D%A2_v2-7.png

    Tip

    通知テストについて
    登録されている通知先設定の内容で、メッセージの通知テストを行う場合は、通知テスト ボタンを押下して、メッセージ通知を確認できます。
    通知テスト ボタン押下後、確認画面が表示され、応答後、メッセージが指定された通知先に送信されます。
    送信されるタイトル・本文は"notification test"となります。

5.2.3. 通知先設定編集

通知先設定の編集は、下記の手順で行ないます。
  1. Exastro システムにオーガナイゼーション管理者でログインします。
  2. メニューより 通知管理 をクリックします。
    ../../_images/platform_menu.png
  3. 通知先ワークスペース一覧 画面が表示されるので、通知先設定の編集を行いたいワークスペースを選択、または 通知先設定 をクリックします。
    ../../_images/%E9%80%9A%E7%9F%A5%E5%85%88%E3%83%AF%E3%83%BC%E3%82%AF%E3%82%B9%E3%83%9A%E3%83%BC%E3%82%B9%E4%B8%80%E8%A6%A7%E7%94%BB%E9%9D%A2.png

    注釈

    アクセス権限のあるワークスペースのみ表示されます。
  4. 通知先設定一覧 画面が表示されるので、 編集 をクリックします。
    ../../_images/%E9%80%9A%E7%9F%A5%E5%85%88%E8%A8%AD%E5%AE%9A%E4%B8%80%E8%A6%A7%E7%94%BB%E9%9D%A2_edit_v2-7.png
  5. 通知先設定編集 画面が表示されるので、通知先の情報を編集し、 登録 をクリックします。
    ../../_images/%E7%B7%A8%E9%9B%86%E9%80%9A%E7%9F%A5%E5%85%88%E8%A8%AD%E5%AE%9A%E7%94%BB%E9%9D%A2_Mail_v2-7.png
    表 5.27 通知先設定編集

    項目名

    説明
    通知先ID
    通知先IDは変更出来ません。
    通知先名
    通知先に割り当てる名前を指定します。
    通知方法
    通知方法を指定します。
    通知先
    指定した通知方法によって設定が異なります。
    詳細は 通知先設定の登録手順 を参照ください。

5.2.4. 通知先設定削除

  1. Exastro システムにオーガナイゼーション管理者でログインします。
  2. メニューより 通知管理 をクリックします。
    ../../_images/platform_menu.png
  3. 通知先ワークスペース一覧 画面が表示されるので、通知先設定の編集を行いたいワークスペースを選択、または 通知先設定 をクリックします。
    ../../_images/%E9%80%9A%E7%9F%A5%E5%85%88%E3%83%AF%E3%83%BC%E3%82%AF%E3%82%B9%E3%83%9A%E3%83%BC%E3%82%B9%E4%B8%80%E8%A6%A7%E7%94%BB%E9%9D%A2.png

    注釈

    アクセス権限のあるワークスペースのみ表示されます。
  4. 通知先設定一覧 画面が表示されるので、 削除 をクリックします。
    ../../_images/%E9%80%9A%E7%9F%A5%E5%85%88%E8%A8%AD%E5%AE%9A%E4%B8%80%E8%A6%A7%E7%94%BB%E9%9D%A2_delete_v2-7.png
  5. 確認メッセージが表示されるので、ワークスペースID/通知先ID を入力し、 はい、削除します をクリックします。
    ../../_images/%E9%80%9A%E7%9F%A5%E5%85%88%E8%A8%AD%E5%AE%9A%E5%89%8A%E9%99%A4%E5%AE%9F%E8%A1%8C%E7%A2%BA%E8%AA%8D%E7%94%BB%E9%9D%A2.png

    Tip

    一度削除した通知先設定を復元することは出来ません。