Slack DM 通知

概要

このドキュメントでは、Slack ダイレクトメッセージ（DM）を介して、QueryPie のワークフローの要求者、承認者、実行者に送信されるステップバイステップの通知の設定と管理方法、および利用可能な通知の種類について説明します。

前提条件

QueryPie でこれらの設定を構成する前に、以下の前提条件が満たされていることを確認してください：

Slack アプリの作成: Slack アプリの作成：Slack アプリを準備する必要があります。アプリを作成するには、QueryPie カスタマーポータルにお問い合わせいただくか、公式パートナーを通じてご連絡ください。
メールアドレスの一致：QueryPie に登録されているメールアドレスと Slack に登録されているメールアドレスが一致している必要があります。
- メールアドレスが一致しない場合、通知は正しく受信されません。
ネットワーク設定：ネットワーク設定で、Slack が QueryPie から送信された通知を受信できるようにしてください。必要に応じてネットワーク設定を調整してください。

注意

ACL 設定が難しい内部ネットワークに QueryPie がインストールされている場合、Proxy サーバーを設定する必要があるかもしれません。Okta を使用している場合は、以下のドキュメントを参照してください。 [内部ネットワーク] Slack DM ワークフローの結果を転送するをご参照ください。

Slack DM の設定

Slackダイレクトメッセージ（DM）通知を利用するには、ワークフロー構成で関連する設定を有効にする必要があります。

Slack DM 通知を有効にする

Workflow Notifications via Slack Direct Message オプションを切り替えて、ワークフローの Slack DM 通知を有効にします。

承認者に指定されたユーザーに Slack DM 通知を送信するかどうかを決定します。
トグルを有効にすると、「Bot User OAuth Token」フィールドが表示されます。統合したい Slack アプリのBot User OAuth Tokenを入力し、設定を保存します。
トグルを無効にすると、このフィールドは非表示になります。(保存する前に再度有効にすると、以前に入力したトークンが保持されます)。

Slackアプリの Bot User OAuth Token は、アプリ管理メニューの「OAuth > Permissions」にあります。

Slack でリクエストの承認 / 拒否を有効にする

Allow users to Approve or Reject on Slack オプションを切り替えると、ユーザーが Slack 内で直接リクエストを承認または拒否できるようになります。

有効にすると、Slack DM に承認と 拒否のボタンが表示されます。
- ユーザーはボタンをクリックし、必要に応じて理由を記入することで、簡単にリクエストを処理できます。

Slack DM 通知の種類

承認前のステータスを持つ標準的なワークフローでは、進捗に応じて4種類の通知が送信されます：

承認リクエスト通知
辞退通知
承認依頼者への承認完了通知
実行可能通知

承認後（緊急モード）の場合、以下の 4 種類の通知が送信されます：

承認依頼通知
実行可能通知
承認依頼者への承認完了通知
緊急モード未承認通知

承認リクエスト通知

QueryPie は 5種類のワークフロー（SQL Request、SQL Export Request、DB Access Request、Server Access Request、Access Role Request）をすべてサポートしています。

承認リクエストの通知は、ドラフト作成時に第一レベルの承認者が通知を受信すると即座にトリガーされます。第 1 レベルの承認が完了すると第 2 レベルの承認者に通知され、第 2 レベルの承認が完了すると第 3 レベルの承認者に通知されます。

各レベルに複数の承認者が存在する場合は、すべての承認者に通知が送信されます。また、承認者に承認委任が設定されている場合は、代理承認者にも通知が届きます。承認委譲の詳細な設定方法については、承認アドオンの「承認委譲の使用」を参照してください。 .

QueryPie 管理者の設定によっては、通知を受け取った承認者がSlack内で直接承認または却下することもできます。必要な設定については、上記の Slack DM の設定のセクションを参照してください。アクションボタンがない場合でも、一貫してDetailsボタンが用意されています。クリックするとウェブブラウザが起動し、QueryPie のログインウィンドウが表示されます。ログインに成功すると、ユーザーはワークフローの詳細ページに移動します。

承認後（緊急モード）のドラフトについては、対応するメッセージが表示されます。この場合、[アクション]ボタンを使用しても、[承認]ボタンのみが表示されます。

辞退通知

辞退通知は、5 種類のワークフローすべてに適用されます: SQL Request、SQL Export Request、DB Access Request、Server Access Request、Access Role Request です。どの承認者によってもドラフトが拒否された場合、要求者に即座に通知が送信されます。この通知には、却下の理由を詳しく説明するコメントが含まれます。

個別のアクションボタンはありませんが、詳細ボタンが用意されています。クリックするとウェブブラウザが起動し、QueryPie のログインウィンドウが表示されます。ログインに成功すると、ワークフローの詳細ページが表示されます。

承認後（緊急モード）のドラフトでは、却下ケースは適用されないため、却下メッセージは送信されません。

依頼者への承認完了通知

この通知機能は、5 種類のワークフローすべてに適用されます：SQL リクエスト、SQL エクスポートリクエスト、DB アクセスリクエスト、サーバーアクセスリクエスト、およびアクセスロールリクエストです。承認が確定すると、要求者に通知が送信されます。

個別のアクションボタンはありませんが、Detailsボタンが用意されています。クリックするとウェブブラウザが起動し、QueryPie のログインウィンドウが表示されます。ログインに成功すると、ワークフローの詳細ページが表示されます。

草稿が緊急モードの場合でも、すべての事後承認が完了すると、依頼者に通知が届きます。

実行可能通知

この通知機能は、2 つのタイプをサポートするワークフローに適用されます：SQL Request と SQL Export Request の 2 種類をサポートするワークフローに適用されます。

承認が完了すると、指定された実行者に通知が送信されます。

個別のアクションボタンはありませんが、Detailsボタンが用意されています。これをクリックするとウェブブラウザが起動し、QueryPie のログインウィンドウが表示されます。ログインに成功すると、ユーザはワークフローの詳細ページに移動し、そこから SQL Requests や SQL Export Requests を実行することができます。

草稿が Urgent Mode の場合、実行者は草稿の提出と同時に通知を受け取ります。

Urgent Mode 未承認通知

この通知機能は 2 種類のワークフローに適用されます：SQL Request と SQL Export Request です。

この通知は、Urgent Mode にエスカレーションされたドラフトが 1 日以上未承認のままである場合に、ユーザーに警告を発します。毎朝 1回送信され、1日以上経過したすべての草稿について、その段階の承認者を対象とします。

各レベルに複数の承認者がいる場合、メッセージはすべての承認者に配信されます。さらに、承認者の誰かが代理承認を設定している場合、通知はその代理承認者にも及びます。代理承認の設定方法については、承認アドオンの「代理承認の使用」セクションを参照してください。

未承認のドラフトごとに個別のメッセージが送信されます。したがって、未承認のドラフトが複数ある場合、複数の通知が生成されます。これらのメッセージは、営業日・休日の区別なく、毎朝 10時に送信されます。