メインコンテンツへスキップ

​
はじめに

Microsoft Teamsは、持続的なワークプレイスチャット、ビデオ会議、ファイルストレージ（ファイル上でのコラボレーションを含む）、アプリケーション統合を組み合わせた、コミュニケーションとコラボレーションのためのプラットフォームです。このサービスは、Office 365サブスクリプションのOffice生産性スイートと統合され、Microsoft以外の製品と統合できる拡張機能を備えています。Microsoft TeamsはSlackなどのビジネスコミュニケーションサービスの競合製品であり、Microsoft Skype for Businessから進化およびアップグレードしたものです。DomoのMicrosoft Teamsコネクターを使用すると、組織内のチームやグループでのチャットに関する詳細を取得できます。Microsoft Teams APIの詳細については、 https://docs.microsoft.com/ja-jp/graph/teams-concept-overview を参照してください。 Microsoft Teamsアカウントには、Data Centerから接続します。このトピックでは、Microsoft Teamesコネクターのユーザーインターフェースに固有のフィールドとメニューについて説明します。DataSetの追加や更新スケジュールの設定、DataSet情報の編集に関する一般的な情報は、「 コネクターを使用してDataSetを追加する 」を参照してください。

​
必要条件

Microsoft Teamsアカウントに接続してDataSetを作成するには、以下が必要です。
  • Microsoft Azure Appのインストール。
  • Azure AppのクライアントID。
  • Azure Appのクライアントシークレット。これは、Azure Appを作成するときに生成されます。

​
クライアントIDを調べるには、以下の手順を実行します。

  1. https://portal.azure.com にアクセスし、Microsoft認証情報を使用してサインインします。
  2. ［Azure Active Directory］>［App registrations］ を選択します。
  3. お使いのAppを探し、クリックします。
  4. Web Appの「Application ID」を確認します（これがクライアントIDです）。

​
新しいクライアントシークレットを生成するには、以下の手順を実行します。

  1. https://portal.azure.com にアクセスし、Microsoft認証情報を使用してサインインします。
  2. ［Azure Active Directory］>［App registrations］ を選択します。
  3. お使いのAppを探し、クリックします。
  4. ［Certificates and secrets］ を開きます。
  5. ［Client Secret］セクションで ［+New Client Secret］ をクリックします。

​
Enterprise OAuth用Azure Appを作成する

Microsoft Azure Appを作成するには、以下の手順を実行します。
  1. https://portal.azure.com にログインします。
  2. ［App registrations］ をクリックします。
Capture1.png
  1. ［New registration］ をクリックします。
  2. アプリケーション名を入力し、サポートされているアカウントタイプを選択します。ここでは、サポートされているアカウントはマルチテナントである必要があります。
clipboard_eb9eab104154ca1097aaf631fb1227879.png
  1. リダイレクト URI https://oauth.domo.com/api/data/v1/oauth/providers/microsoft-teams/exchange を入力します。
clipboard_e3ca801b61e568ac88bbaaf31c0352398.png
  1. ［Register］ をクリックします。
  2. アプリケーションが登録されたら、必要なAPI権限をアプリケーションに割り当てます。
  3. ［API Permissions］>［+Add a permission］ を選択します。
API_Permission-Add_Permission.png
  1. API権限要求ページが表示され、よく使われるMicrosoft APIが表示されます。
Request_API_permissions-2.png
  1. 目的のAPIを選択し、必要に応じてユーザーに委任されたアプリケーションの権限を追加します。
clipboard_e3d304305b31d867dddacb886005e89dc.png
  1. ［Grant admin consent］ をクリックし、 ［Yes］ をクリックすると、権限に対する管理者の同意が得られます。 追加された権限は、詳細とともに ［Configured permissions］ セクションに表示されます。
clipboard_e4414e0905f035dd543503e9d06485c22.png
  1. 次に、 ［Certificates & Secrets］ をクリックします。証明書は、トークンを要求するときにアプリケーションの識別情報を証明するためのシークレットとして使用できます。また、パブリックキーと呼ばれることもあります。
Capture4.PNG
  1. ［+ New Client Secret］ ボタンをクリックします。
Capture5.png
  1. クライアントシークレットの説明と有効期限を指定し、 ［Add］ をクリックします。
Capture6.PNG
  1. 値 をコピーして、Domoのコネクター認証情報セクションの ［クライアントシークレット］ フィールドに貼り付けます。
Secret.png

​
Microsoft Teamsアカウントに接続する

このセクションでは、 Microsoft Teams コネクターページの ［認証情報］ および ［詳細］ ペインのオプションについて説明します。このページのほかのペインの項目である ［スケジュール設定］ や ［DataSetに名前を付け、説明を入力］ に関しては、ほとんどのタイプのコネクターで共通しています。詳細については、「 コネクターを使用してDataSetを追加する 」を参照してください。

​
［認証情報］ペイン

このペインには、 Microsoft Teams アカウントに接続する認証情報の入力フィールドが含まれます。下表では、各フィールドに必要な内容を説明しています。

フィールド

説明

Client ID インストールしたAzure Web AppのクライアントIDを入力します。詳しくは「必要条件」を参照してください。
Client Secret Appを作成したときに生成されたクライアントシークレットを入力します。詳しくは「必要条件」を参照してください。
有効なMicrosoft認証情報を一度入力しておくと、いつでも同じアカウントを使用して、新しいMicrosoft Teams DataSetを作成することができます。コネクターアカウントは、Data Centerの ［アカウント］ タブで管理できます。このタブの詳細については、「 コネクターのユーザーアカウントを管理する 」を参照してください。

​
［詳細］ペイン

このペインには、メインとなる ［Report］ メニューのほか、選択したレポートタイプに応じて表示/非表示になる様々なメニューが含まれています。

メニュー

説明

Report

実行するMicrosoft Teamsレポートを選択します。以下のレポートが利用できます。

S. No レポート名 説明
1 All Channels 選択したチームIDのすべてのチャンネルのリストを返します。
2 All Events 指定したグループのイベントオブジェクトのリストを返します。
3 All Joined Teams ユーザーが直接メンバーであるMicrosoft Teamsのチームのリストを返します。
4 All Teams 組織内のすべてのチームのリストを返します。
5 Calendar View 指定したグループから、時間範囲で定義されたカレンダービューでのイベントの発生、例外、単一のインスタンスを返します。
6

Channel Messages

チームのチャンネルにあるメッセージのリストを取得します。
7

Channel Message Replies

チームのチャンネルにあるメッセージの全返信のリストを取得します。
8 Groups 組織内のグループのリストを返します。
9 Group Attachments 投稿に添付されている添付オブジェクトのリストを返します。
10 Group Conversations グループ内の会話のリストを返します。
11 Group Members グループの直接メンバーのリストを返します。
12 Group Owners グループ所有者のリストを返します。
13 Group Posts 指定したスレッドの投稿のリストを返します。
14 Group Threads グループのすべてのスレッドのリストを返します。
Group ID グループIDを選択します。
Team ID チームIDを選択します。
Thread ID スレッドIDを選択します。
Post ID 投稿IDを選択します。
Dates Selection データの日付形式を選択します。
Single Date レポートのデータが特定の日付か、今日から何日前までのものかを選択します。
Specific Date 日付セレクターを使用して特定の日付を選択します。
Relative Date 何日前に遡ってデータを取得したいか、 ［Days Back］ フィールドに日数を入力します。今日を指定するには「today」または「0」、昨日なら「yesterday」または「1」、過去7日間のデータを取得するには「today-7」または「7」と指定します。
Date Range 特定の日付範囲または相対的な日付範囲を選択します。
Start Date - Specific 日付セレクターを使用して、日付範囲の最初の日付を選択します。
End Date - Specific 日付セレクターを使用して、日付範囲の最後の日付を選択します。
Start Date - Relative

過去何日前からデータの取得を開始するか（開始日）を入力します。 ［End Date］ と組み合わせて、表示する日付の範囲を作成します。

例えば、 ［Start Date］ に「10」、 ［End Date］ に「5」を入力した場合、レポートには10日前から5日前のデータが含まれます。

End Date - Relative

過去何日前までのデータを取得するか（終了日）を入力します。 ［Start Date］ と組み合わせて、表示する日付の範囲を作成します。

例えば、 ［Start Date］ に「10」、 ［End Date］ に「5」を入力した場合、レポートには10日前から5日前のデータが含まれます。

Time Period データを受信する期間を指定します。
Starting Day of the Week 週を開始する曜日を選択します。

​
その他のペイン

スケジュール設定、再試行、更新に関するオプションなど、コネクターインターフェースのその他のペインに表示されるオプションについては、「 コネクターを使用してDataSetを追加する 」を参照してください。