Autonomous DatabaseからMicrosoft Teams通知を送信

Autonomous DatabaseからMicrosoft Teamsチャネルに問合せのメッセージ、アラートまたは出力を送信できるようにMicrosoft Teamsを構成する方法について説明します。また、Microsoft Teams通知の送信に使用する手順についても説明します。

「Autonomous DatabaseからMicrosoft Teams通知を送信する準備」
まず、Microsoft Teamsアプリケーションでボットを構成します。次に、DBMS_CLOUD_NOTIFICATIONプロシージャとともに使用する資格証明を作成して、Autonomous DatabaseからMicrosoft Teams通知を送信します。
「Microsoft Teamsチャネルへのメッセージの送信」
「問合せ結果をMicrosoft Teamsチャネルに送信」

親トピック: Autonomous Databaseで電子メールと通知を送信

Autonomous DatabaseからMicrosoft Teams通知を送信する準備

まず、Microsoft Teamsアプリケーションでボットを構成します。次に、DBMS_CLOUD_NOTIFICATIONプロシージャとともに使用する資格証明を作成して、Autonomous DatabaseからMicrosoft Teams通知を送信します。

Microsoft Teams通知を構成するには:

Microsoft Teamsアプリケーションを作成し、そこにボットを追加します。アプリケーションの設定の詳細は、「チーム向け開発者ポータル」を参照してください。
「ボット管理」セクションで、ボットに秘密キー、スコープが「チーム」に設定され、通知を送信する権限があることを確認します。
アプリを組織に公開して、組織内のユーザーが利用できるようにします。
IT管理者が管理センターからアプリを承認したら、Teamsの「アプリ」セクションからアプリをインストールします。
次の手順を使用して、AzureポータルからグラフAPI用のアプリケーションに対するFiles.ReadWrite.AllおよびChannelSettings.Read.All権限をリクエストします:
1. Azureポータルにログインし、左側のパネルを使用してAzure Active Directoryに移動し、「アプリケーション」オプションを選択します。
2. 「アプリケーション」ページには、所有しているアプリケーションとそのアプリケーションに追加されたボットが表示されます。ボットをクリックして詳細を表示します。
3. 後で使用するために、ボット概要ページから「ディレクトリ/テナントID」をコピーします。
4. 次に、左側のパネルの「APIパーミッション」に移動します。「APIパーミッション」で、「権限の追加」をクリックし、「Microsoft Graph」、「アプリケーション権限」の順に選択します。
5. Files.ReadWrite.AllおよびChannelSettings.Read.All権限を検索して追加します。
次のステップに従って、Azureポータルから前述のリクエストされた権限をIT管理者に承認させます:
1. Azureポータルにログインし、左側のパネルを使用してAzure Active Directoryに移動し、「アプリケーション」オプションを選択します。
2. 「アプリケーション」ページから「すべてのアプリケーション」を選択します。
3. 名前でapplication/botを検索し、APIパーミッションに移動して、リクエストされた権限に対するADMINの同意を付与: Files.ReadWrite.AllおよびChannelSettings.Read.All。
ヒント:
アプリがIT管理者によって承認されたら、ボットIDと秘密キーを他のユーザーに提供して、組織内のTeams内にアプリをインストールできます。
アプリケーションがIT管理者によって許可され、前述のリクエストされた権限が付与された後、アプリケーションのボットIDおよび秘密キーを使用して資格証明オブジェクトを作成し、ボット・トークンを生成できます。
問合せ結果をMicrosoft Teamsチャネルに送信するには、team idおよびtenant idを取得します。

ヒント:
team idは、/team/と /conversationsの間のチーム・リンクにあります。 tenant idは、チーム・リンクの最後にある"tenantId="の後に配置されます。このリンクは、チーム名の横にある3つのドットをクリックし、「チームへのリンクの取得」を選択することで見つかります。

たとえば:

https://teams.microsoft.com/l/team/teamID/conversations?groupId=groupid%tenantId=tenantid
channelIDを取得します。

ヒント:
channelIDは、/team/とチャネル名の間のチャネル・リンクにあります。このリンクは、チャネル名の横にある3つのドットをクリックし、「チャネルへのリンクの取得」を選択することで見つかります。

たとえば:

https://teams.microsoft.com/l/channel/channelID/channel_name?groupId=groupid&tenantId=tenantid
Autonomous DatabaseからMicrosoft Teamsアプリケーションにアクセスするための資格証明オブジェクトを作成します。
ヒント:
CREATE_CREDENTIALプロシージャを正常に使用できない場合は、ADMINユーザーに問い合せて、DBMS_CLOUDパッケージに対する実行アクセス権を付与します。

資格証明のユーザー名はbot_idで、パスワードはボット・キーです。

たとえば:
```
BEGIN     
    DBMS_CLOUD.CREATE_CREDENTIAL(credential_name => 'TEAMS_CRED',       
        username        => 'bot_id', 
        password        => 'bot_secret');
END;
/
 
```
詳細については、「CREATE_CREDENTIALプロシージャ」を参照してください。

親トピック: Autonomous DatabaseからMicrosoft Teams通知を送信

Microsoft Teamsチャネルへのメッセージの送信

「Autonomous DatabaseからMicrosoft Teams通知を送信する準備」の説明に従ってMicrosoft Teams資格証明オブジェクトを作成した後、DBMS_CLOUD_NOTIFICATION.SEND_MESSAGEプロシージャを使用して、Microsoft Teamsチャネルにメッセージを送信できます。

例:

BEGIN
     DBMS_CLOUD_NOTIFICATION.SEND_MESSAGE(
        provider        => 'msteams',
        credential_name => 'TEAMS_CRED',
        message         => 'text from new teams api',
        params          => json_object('channel' value 'channelID'));
END;
/

paramsパラメータを使用してチャネルを指定します。

channel: Autonomous DatabaseからMicrosoft Teams通知を送信する準備のステップ10から取得したチャネルIDを指定します。

詳細については、「SEND_MESSAGEプロシージャ」を参照してください。

親トピック: Autonomous DatabaseからMicrosoft Teams通知を送信

問合せ結果をMicrosoft Teamsチャネルに送信

「Autonomous DatabaseからMicrosoft Teams通知を送信する準備」の説明に従ってMicrosoft Teams資格証明オブジェクトを作成した後、DBMS_CLOUD_NOTIFICATION.SEND_DATAプロシージャを使用して、問合せの出力をMicrosoft Teamsチャネルに送信できます。

例:

BEGIN
     DBMS_CLOUD_NOTIFICATION.SEND_DATA(provider => 'msteams',
        credential_name => 'TEAMS_CRED',
        query           => 'SELECT tablespace_name FROM dba_tablespaces',
        params          => json_object('tenant'value '5b743bc******c0286',
                                       'team'value '0ae401*********5d2bd',
                                       'channel'value '19%3a94be023*****%40thread.tacv2',
                                       'title'value 'today',
                                       'type'value 'csv'));
END;
/

paramsパラメータを使用して、テナント、チーム、チャネル、タイトルおよびデータ型をstring値で指定します。

tenant: Autonomous DatabaseからMicrosoft Teams通知を送信する準備のステップ8から取得したテナントIDを指定します。
チーム: Autonomous DatabaseからMicrosoft Teams通知を送信する準備のステップ8から取得したチームIDを指定します。
channel: Autonomous DatabaseからMicrosoft Teams通知を送信する準備のステップ9から取得したチャネルIDを指定します。
title: ファイルのタイトルを指定します。タイトルには、アルファベット、数字、アンダースコアおよびハイフンのみを含めることができます。 Microsoft Teamsに表示されるファイル名には、一意性を確保するためのタイトル・パラメータとタイムスタンプが連結されます。最大タイトル・サイズは50文字です。

たとえば: 'title'_'timestamp'.'format'
type: 出力形式を指定します。有効な値はCSVまたはJSONです。

ノート:

Microsoft TeamsにDBMS_CLOUD_NOTIFICATION.SEND_DATAを使用するときにサポートされる最大ファイル・サイズは4MBです。

詳細については、「SEND_DATAプロシージャ」を参照してください。

親トピック: Autonomous DatabaseからMicrosoft Teams通知を送信