はじめに
Microsoft Teamsは、持続的なワークプレイスチャット、ビデオミーティング、ファイルストレージ(ファイルのコラボレーションを含む)、およびアプリケーションの統合を組み合わせたコミュニケーションとコラボレーションのプラットフォームです。Webhookは、Webアプリケーションが相互に通信する方法の1つです。Microsoft Teams Webhookを使用すると、WebサービスをMicrosoft Teams内のチャンネルとチームに簡単に接続できます。DomoのMicrosoft Team Webhookコネクターを使用して、WebサービスからリアルタイムのデータをMicrosoft Teamsのチャンネルとチームに送信します。Microsoft Teams APIの詳細については、https://docs.microsoft.com/en-us/graph/teams-concept-overviewにアクセスしてください。
Microsoft Teamsアカウントには、Data Centerから接続します。このトピックでは、Microsoft Teamesコネクターユーザーインターフェースに固有のフィールドとメニューについて説明します。DataSetの追加や更新スケジュールの設定、DataSet情報の編集に関する一般的な情報については、「データコネクターを使用してDataSetを追加する」を参照してください。
必要条件
Microsoft Teamsアカウントに接続してDataSetを作成するには以下が必要です。
-
Microsoft Azure Appのインストール。
-
Azure AppのクライアントIDとクライアントシークレット
-
Azure AppのテナントID。これは、Azure Appを作成するときに生成されます。
クライアントIDを探すには、
-
https://portal.azure.comにアクセスし、お使いのMicrosoft認証情報を使用してサインインします。
-
[Azure Active Directory]、[アプリの登録]の順に選択します。
-
お使いのAppを探し、クリックします。
-
Web Appの [アプリケーションID]を確認します。これがクライアントIDです。
新しいクライアントシークレットを生成するには、
-
https://portal.azure.comにアクセスし、お使いのMicrosoft認証情報を使用してサインインします。
-
[Azure Active Directory]、[アプリの登録]の順に選択します。
-
お使いのAppを探し、クリックします。
-
[証明書とシークレット]を開きます。
-
「クライアントシークレット」セクションで[+新規クライアントシークレット]をクリックします。
テナントIDを取得するには
- Azure Portal(https://protal.azure.com)にログインします。
- [Azure Active Directory]、[プロパティ]の順に選択します。
- ディレクトリIDをコピーします。ディレクトリID はお使いのテナントIDです。
エンタープライズOAuth用Azure Appを作成する
Microsoft Azure Appを作成するには、次の手順を実行してください。
1. https://portal.azure.comにログインします。
2. [アプリの登録]をクリックします。
3. [新規登録]をクリックします。
4. アプリケーション名を入力し、サポートされているアカウントタイプを選択します。ここでは、サポートされているアカウントはマルチテナントでなければなりません。
5. リダイレクト URI をhttps://oauth.domo.com/api/data/v1/oauth/providers/sharepointonline-sdk-writeback/exchangeとして入力します。
6. [登録]をクリックします。
7. アプリケーションが登録されたら、必要なAPIの権限をアプリケーションに割り当てます。
8. [API権限]>[+権限を追加]の順に選択します。
9. API権限要求ページが表示され、よく使われるMicrosoft APIが表示されます。
10. 目的のAPIを選択し、必要に応じてユーザーに委任されたアプリケーションの権限を追加します。
11.[管理者の同意を許可]をクリックし、[はい]をクリックすると、権限に対する管理者の同意が得られます。 追加された権限は、詳細とともに「構成された権限」セクションに表示されます。
12. 次に、[証明書とシークレット]をクリックします。証明書は、トークンを要求するときにアプリケーションの識別情報を証明するためのシークレットとして使用できます。また、パブリックキーと呼ばれることもあります。
13. [+新しいクライアントシークレット]ボタンをクリックします。
14. クライアントシークレットの説明と有効期限を指定し、[追加]をクリックします。
15. 値をコピーし、Domoの[コネクター認証]セクションの[クライアントシークレット]フィールドに貼り付けます。
Microsoft Teamsアカウントのアカウントに接続する
このセクションでは、Microsoft Teams Webhookコネクターページの [認証情報] および [詳細]ペインのオプションについて説明します。このページのほかのペインの項目である[スケジュール設定]や[DataSetに名前を付け、説明を入力]に関しては、ほとんどのタイプのコネクターで共通しています。詳細については「データコネクターを使用してDataSetを追加する」を参照してください。
[認証情報] ペイン
このペインには、Microsoft Teamsアカウントに接続するための認証情報を入力するフィールドがあります。下表では、各フィールドに必要な内容を説明しています。
フィールド |
説明 |
---|---|
クライアントID | Azure Web AppのクライアントIDを入力します。詳しくは、 「必要条件」を参照してください。 |
クライアントシークレット | Appを作成したときに生成されるクライアントシークレットを入力します。詳しくは、「必要条件」を参照してください。 |
テナントID | テナントIDを入力します。詳細は、「必要条件」を参照してください。 |
有効なMicrosoft Teams認証情報を一度入力しておくと、随時同じアカウントを使用して新しいMicrosoft Teams WebhookDataSetを作成できます。コネクターアカウントは、Data Centerの[アカウント]タブで管理できます。このタブの詳細については、「コネクターのユーザーアカウントを管理する」を参照してください。
[詳細] ペイン
このペインで、応答でリストを展開するかどうかを指定します。Microsoft Teams Appのデータが更新されると、デフォルトでは[追加]メソッドを使用してデータを更新します。[更新設定を変更]をクリックして、データの更新モードを変更できます。
メニュー |
説明 |
---|---|
フラット化を有効にする | 応答のリストを展開するにはチェックボックスを選択します。 |
その他のペイン
スケジュール設定、再試行、更新に関するオプションなど、コネクターインターフェースのその他のペインに表示されるオプションについては、「データコネクターを使用してDataSetを追加する」を参照してください。
コメント
0件のコメント
サインインしてコメントを残してください。