Microsoft Teams への接続を追加

Microsoft Teams への接続を追加するには：

1. アプリケーションコンソールで、接続ページに移動します。
2. 接続の追加パネルで、追加したい接続のアイコンを選択します。
3. Microsoft Teams アイコンが利用できない場合は、Add More アイコンをクリックしてCData サイトからMicrosoft Teams コネクタをダウンロードおよびインストールします。

必須プロパティについては、設定タブを参照してください。

通常必須ではない接続プロパティについては、高度な設定タブを参照してください。

Microsoft Teams への接続

Microsoft Teams は、以下の認証メソッドをサポートします。

Entra ID（Azure AD）

Note：Microsoft はAzure AD をEntra ID にリブランドしました。ユーザーがEntra ID 管理サイトを操作する必要があるトピックでは、Microsoft が使用している名称と同じものを使用します。ただし、名前または値が"Azure AD" を参照しているCData 接続プロパティは、依然として存在します。

Microsoft Entra ID は、マルチテナント型のクラウドベースのID およびアクセス管理プラットフォームです。 OAuth ベースの認証フローに対応しており、ドライバーによるMicrosoft Teams エンドポイントへのセキュアなアクセスを実現します。

Web アプリケーションを介したEntra ID への認証には、必ずはじめにカスタムOAuth アプリケーションを作成して登録する必要があります。 これにより、アプリケーションは独自のリダイレクトURI を定義し、クレデンシャルのスコープを管理し、組織固有のセキュリティポリシーに準拠することができるようになります。

カスタムOAuth アプリケーションの作成および登録方法の詳細については、Entra ID（Azure AD）アプリケーションの作成 を参照してください。

AuthScheme をAzureAD に設定した後の認証手順は、環境によって異なります。 デスクトップアプリケーション、Web ベースのワークフロー、またはヘッドレスシステムから接続する方法の詳細については、以下のセクションを参照してください。

Azure サービスプリンシパル

Note：Microsoft はAzure AD をEntra ID にリブランドしました。ユーザーがEntra ID 管理サイトを操作する必要があるトピックでは、Microsoft が使用している名称と同じものを使用します。ただし、名前または値が"Azure AD" を参照しているCData 接続プロパティは、依然として存在します。

Azure サービスプリンシパルは、ロールに基づいたアプリケーションベースの認証です。これは、認証がユーザーごとではなく、アプリケーションごとに行われることを意味します。 アプリケーションで実行されるすべてのタスクは、デフォルトユーザーコンテキストなしで、割り当てられたロールに基づいて実行されます。 リソースへのアプリケーションのアクセスは、割り当てられたロールの権限によって制御されます。

Azure サービスプリンシパル認証の設定方法については、Entra ID（Azure AD）でのサービスプリンシパルアプリの作成 を参照してください。

Managed Service Identity (MSI)

Azure VM 上でMicrosoft Teams を実行しており、マネージドID（MSI）認証情報を自動的に取得して接続したい場合は、AuthScheme を AzureMSI に設定します。

User-Managed Identities

マネージドID のトークンを取得するには、OAuthClientId プロパティを使用してマネージドID のclient_id を指定します。

VM に複数のユーザーが割り当てられたマネージドID がある場合は、OAuthClientId も指定する必要があります。

Entra ID（Azure AD）アプリケーションの作成

Note：Microsoft はAzure AD をEntra ID にリブランドしました。ユーザーがEntra ID 管理サイトを操作する必要があるトピックでは、Microsoft が使用している名称と同じものを使用します。ただし、名前または値が"Azure AD" を参照しているCData 接続プロパティは、依然として存在します。

Microsoft Teams は、Microsoft Entra ID を使用したOAuth ベースの認証をサポートします。 Web アプリケーション経由で接続してEntra ID で認証したい場合は、以下に説明するように、まずEntra 管理センターでカスタムOAuth アプリケーションを登録する必要があります。

デスクトップアプリケーションまたはヘッドレスマシン経由で接続する場合は、CData ブランドを使用したMicrosoft Teams の組み込みアプリケーション認証情報を使用して認証できます。 ただし、カスタムOAuth アプリケーションもデスクトップおよびヘッドレス認証フローに対応しており、本番環境への導入や厳格なポリシー制御が求められる環境では、こちらの方が望ましい場合があります。

アプリケーションの登録

Microsoft Entra ID でOAuth アプリケーションを登録するには、次の手順に従います。

1. https://portal.azure.com に移動します。
2. 左側のナビゲーションペインでMicrosoft Entra ID ->アプリの登録を選択します。
3. 新規登録をクリックします。
4. アプリケーションの名前を入力します。
5. このアプリケーションがサポートすべきアカウントの種類を指定します。
   • 個人使用のアプリケーションの場合は、この組織ディレクトリ内のアカウントのみを選択します。
   • 配布アプリケーションの場合は、マルチテナントオプションのいずれかを選択します。

   Note：この組織ディレクトリ内のアカウントのみを選択する場合は、 CData Sync App への接続の際にAzureTenant をテナントのId（GUID または検証済みドメイン）に設定する必要があります。 そうでない場合、認証は失敗します。

6. Select a platform をWeb に設定し、リダイレクトURI をhttp://localhost:33333（デフォルト）、またはデプロイに適した別のURI に設定してください。 カスタムのリダイレクトURI を使用する場合は、CallbackURL 接続プロパティを設定してください。その際、このURI と正確に一致するように設定する必要があります。
7. 登録をクリックします。アプリケーション管理画面が開きます。 後で使用するために、表示される値を控えておきます。
   • アプリケーション（クライアント）ID は、OAuthClientId に使用されます。
   • ディレクトリ（テナント）ID は、AzureTenant に使用されます。
8. 証明書とシークレットに移動します。新しいクライアントシークレットをクリックし、希望する有効期限を設定して、生成された値を保存します。 この値は一度しか表示されないため、OAuthClientSecret で使用するために記録しておいてください。

9. Select Required Permissions and then click Add. Under Select an API, select the Microsoft Graph and specifically select the following permissions:

   • Group.ReadWrite.All
   • AppCatalog.ReadWrite.All
   • User.Read.All
   • ChannelMessage.Read.All
   • Chat.Read
   • Chat.ReadBasic
   • Chat.ReadWrite
   • Group.Read.All
   • Presence.Read.All

10. 確認のため、アクセス許可の追加をクリックします。

Entra ID（Azure AD）アプリケーションの作成

Note：Microsoft はAzure AD をEntra ID にリブランドしました。ユーザーがEntra ID 管理サイトを操作する必要があるトピックでは、Microsoft が使用している名称と同じものを使用します。ただし、名前または値が"Azure AD" を参照しているCData 接続プロパティは、依然として存在します。

Microsoft Teams は、Microsoft Entra ID を使用したOAuth ベースの認証をサポートします。 Web アプリケーション経由で接続してEntra ID で認証したい場合は、以下に説明するように、まずEntra 管理センターでカスタムOAuth アプリケーションを登録する必要があります。

デスクトップアプリケーションまたはヘッドレスマシン経由で接続する場合は、CData ブランドを使用したMicrosoft Teams の組み込みアプリケーション認証情報を使用して認証できます。 ただし、カスタムOAuth アプリケーションもデスクトップおよびヘッドレス認証フローに対応しており、本番環境への導入や厳格なポリシー制御が求められる環境では、こちらの方が望ましい場合があります。

アプリケーションの登録

Microsoft Entra ID でOAuth アプリケーションを登録するには、次の手順に従います。

1. https://portal.azure.com に移動します。
2. 左側のナビゲーションペインでMicrosoft Entra ID ->アプリの登録を選択します。
3. 新規登録をクリックします。
4. アプリケーションの名前を入力します。
5. このアプリケーションがサポートすべきアカウントの種類を指定します。
   • 個人使用のアプリケーションの場合は、この組織ディレクトリ内のアカウントのみを選択します。
   • 配布アプリケーションの場合は、マルチテナントオプションのいずれかを選択します。

   Note：この組織ディレクトリ内のアカウントのみを選択する場合は、 CData Sync App への接続の際にAzureTenant をテナントのId（GUID または検証済みドメイン）に設定する必要があります。 そうでない場合、認証は失敗します。

6. Select a platform をWeb に設定し、リダイレクトURI をhttp://localhost:33333（デフォルト）、またはデプロイに適した別のURI に設定してください。 カスタムのリダイレクトURI を使用する場合は、CallbackURL 接続プロパティを設定してください。その際、このURI と正確に一致するように設定する必要があります。
7. 登録をクリックします。アプリケーション管理画面が開きます。 後で使用するために、表示される値を控えておきます。
   • アプリケーション（クライアント）ID は、OAuthClientId に使用されます。
   • ディレクトリ（テナント）ID は、AzureTenant に使用されます。
8. 証明書とシークレットに移動します。新しいクライアントシークレットをクリックし、希望する有効期限を設定して、生成された値を保存します。 この値は一度しか表示されないため、OAuthClientSecret で使用するために記録しておいてください。

9. Select Required Permissions and then click Add. Under Select an API, select the Microsoft Graph and specifically select the following permissions:

   • Group.ReadWrite.All
   • AppCatalog.ReadWrite.All
   • User.Read.All
   • ChannelMessage.Read.All
   • Chat.Read
   • Chat.ReadBasic
   • Chat.ReadWrite
   • Group.Read.All
   • Presence.Read.All

10. 確認のため、アクセス許可の追加をクリックします。

Entra ID（Azure AD）でのサービスプリンシパルアプリの作成

Note：Microsoft はAzure AD をEntra ID にリブランドしました。ユーザーがEntra ID 管理サイトを操作する必要があるトピックでは、Microsoft が使用している名称と同じものを使用します。ただし、名前または値が"Azure AD" を参照しているCData 接続プロパティは、依然として存在します。

Microsoft Teams はサービスプリンシパルベースの認証をサポートしており、これはロールベースです。 つまり、サービスプリンシパルの権限は、割り当てられたロールによって決まります。 ロールは、サービスプリンシパルがアクセスできるリソースと実行可能な操作を指定します。

Microsoft Teams に対してサービスプリンシパルを使用して認証を行いたい場合は、Microsoft Entra ID でカスタムアプリケーションを作成する必要があります。

サービスプリンシパル認証を有効にするには：

• テナント内でアプリケーションの登録とロールの割り当てを行う権限があることを確認します。
• Entra 管理センターで新しいアプリケーションを登録し、認証情報とアクセス許可を構成してください。

アプリケーションの登録

1. https://portal.azure.com に移動します。
2. 左側のナビゲーションペインでMicrosoft Entra ID ->アプリの登録を選択します。
3. 新規登録をクリックします。
4. アプリケーションの名前を入力します。
5. 希望するテナント設定を選択します。このカスタムアプリケーションはサービスプリンシパル用であるため、任意のMicrosoft Entra ID テナント - マルチテナントを選択します。

6. 登録をクリックします。アプリケーション管理画面が開きます。OAuthClientId としてアプリケーション（クライアント）ID の値、AzureTenant としてディレクトリ（テナント）ID の値をメモします。

7. Select Required Permissions and then click Add. Under Select an API, select the Microsoft Graph and specifically select the following permissions:

   • Group.ReadWrite.All
   • AppCatalog.ReadWrite.All
   • User.Read.All
   • ChannelMessage.Read.All
   • Chat.Read
   • Chat.ReadBasic
   • Chat.ReadWrite
   • Group.Read.All
   • Presence.Read.All

8. 証明書とシークレットセクションに移動して、アプリケーションの認証タイプを定義します。証明書（推奨）とクライアントシークレットの2種類の認証方法が利用可能です。
   • 証明書による認証： 証明書とシークレットで証明書のアップロードを選択し、ローカルマシンから証明書をアップロードします。 自己署名証明書の作成についての詳細は、自己署名証明書の作成 を参照してください。
   • 新しいクライアントシークレットの作成： 証明書とシークレットで新しいクライアントシークレットを選択し、有効期限を指定します。クライアントシークレットが保存されると、Microsoft Teams はキーの値を表示します。この値は一度しか表示されないので、後で使用するために記録しておきます。この値をOAuthClientSecret に使用します。

9. 認証に移動し、アクセストークンオプションを選択します。
10. 変更を保存します。

クライアント資格情報の同意

OAuth は、認証のためのクライアント資格情報の使用をサポートします。 クライアント資格情報の認証フローでは、認証するアプリケーション自身の資格情報が作成されます。 認証フローは通常の認証フローと同じように動作しますが、関連するユーザーに対して資格情報の提供を求めるプロンプトは表示されません。 アプリケーションで受理されるすべてのタスクは、デフォルトユーザーコンテキストなしで実行されます。

Note： 埋め込まれたOAuth 資格情報はユーザーごとに認証されるため、 クライアント認証フローで使用することはできません。クライアント資格情報を使用するには、必ずカスタムOAuth アプリケーションを作成する必要があります。

1. https://portal.azure.com にログインします。
2. 前述のように、カスタムOAuth アプリケーションを作成します。
3. アプリの登録に移動します。
4. 作成したアプリケーションを探し、API のアクセス許可を開きます。
5. Microsoft Graph アクセス許可を選択します。アクセス許可には2つの異なるアクセス許可セットがあります。委任されたアクセス許可とアプリケーションの許可です。
6. サービスプリンシパルで使用する場合は、アプリケーションの許可を指定します。
7. インテグレーションに必要な追加のアクセス許可を選択します。

Entra ID（Azure AD）でのサービスプリンシパルアプリの作成

Note：Microsoft はAzure AD をEntra ID にリブランドしました。ユーザーがEntra ID 管理サイトを操作する必要があるトピックでは、Microsoft が使用している名称と同じものを使用します。ただし、名前または値が"Azure AD" を参照しているCData 接続プロパティは、依然として存在します。

Microsoft Teams はサービスプリンシパルベースの認証をサポートしており、これはロールベースです。 つまり、サービスプリンシパルの権限は、割り当てられたロールによって決まります。 ロールは、サービスプリンシパルがアクセスできるリソースと実行可能な操作を指定します。

Microsoft Teams に対してサービスプリンシパルを使用して認証を行いたい場合は、Microsoft Entra ID でカスタムアプリケーションを作成する必要があります。

サービスプリンシパル認証を有効にするには：

• テナント内でアプリケーションの登録とロールの割り当てを行う権限があることを確認します。
• Entra 管理センターで新しいアプリケーションを登録し、認証情報とアクセス許可を構成してください。

アプリケーションの登録

1. https://portal.azure.com に移動します。
2. 左側のナビゲーションペインでMicrosoft Entra ID ->アプリの登録を選択します。
3. 新規登録をクリックします。
4. アプリケーションの名前を入力します。
5. 希望するテナント設定を選択します。このカスタムアプリケーションはサービスプリンシパル用であるため、任意のMicrosoft Entra ID テナント - マルチテナントを選択します。

6. 登録をクリックします。アプリケーション管理画面が開きます。OAuthClientId としてアプリケーション（クライアント）ID の値、AzureTenant としてディレクトリ（テナント）ID の値をメモします。

7. Select Required Permissions and then click Add. Under Select an API, select the Microsoft Graph and specifically select the following permissions:

   • Group.ReadWrite.All
   • AppCatalog.ReadWrite.All
   • User.Read.All
   • ChannelMessage.Read.All
   • Chat.Read
   • Chat.ReadBasic
   • Chat.ReadWrite
   • Group.Read.All
   • Presence.Read.All

8. 証明書とシークレットセクションに移動して、アプリケーションの認証タイプを定義します。証明書（推奨）とクライアントシークレットの2種類の認証方法が利用可能です。
   • 証明書による認証： 証明書とシークレットで証明書のアップロードを選択し、ローカルマシンから証明書をアップロードします。 自己署名証明書の作成についての詳細は、自己署名証明書の作成 を参照してください。
   • 新しいクライアントシークレットの作成： 証明書とシークレットで新しいクライアントシークレットを選択し、有効期限を指定します。クライアントシークレットが保存されると、Microsoft Teams はキーの値を表示します。この値は一度しか表示されないので、後で使用するために記録しておきます。この値をOAuthClientSecret に使用します。

9. 認証に移動し、アクセストークンオプションを選択します。
10. 変更を保存します。

クライアント資格情報の同意

OAuth は、認証のためのクライアント資格情報の使用をサポートします。 クライアント資格情報の認証フローでは、認証するアプリケーション自身の資格情報が作成されます。 認証フローは通常の認証フローと同じように動作しますが、関連するユーザーに対して資格情報の提供を求めるプロンプトは表示されません。 アプリケーションで受理されるすべてのタスクは、デフォルトユーザーコンテキストなしで実行されます。

Note： 埋め込まれたOAuth 資格情報はユーザーごとに認証されるため、 クライアント認証フローで使用することはできません。クライアント資格情報を使用するには、必ずカスタムOAuth アプリケーションを作成する必要があります。

1. https://portal.azure.com にログインします。
2. 前述のように、カスタムOAuth アプリケーションを作成します。
3. アプリの登録に移動します。
4. 作成したアプリケーションを探し、API のアクセス許可を開きます。
5. Microsoft Graph アクセス許可を選択します。アクセス許可には2つの異なるアクセス許可セットがあります。委任されたアクセス許可とアプリケーションの許可です。
6. サービスプリンシパルで使用する場合は、アプリケーションの許可を指定します。
7. インテグレーションに必要な追加のアクセス許可を選択します。

このセクションでは、Microsoft Teams Sync App の高度な機能を厳選して説明します。

ユーザー定義ビュー

Sync App はユーザー定義ビューの使用をサポートします。これは事前設定されたユーザー定義クエリによって内容が決定される仮想テーブルです。 このビューは、ドライバーに発行されるクエリを直接制御できない場合に有効です。 カスタムビューの作成と設定の概要については、ユーザー定義ビュー を参照してください。

SSL の設定

SSL の設定 を使用して、Sync App が証明書のネゴシエーションをどのように扱うかを調整します。さまざまな証明書形式を選択できます。詳しくは、「接続文字列オプション」にあるSSLServerCert プロパティを参照してください。

ファイアウォールとプロキシ

Windows プロキシとHTTP プロキシを含むファイアウォールとプロキシ に合致するようSync App を設定します。トンネル接続を設定することもできます。

クエリ処理

Sync App は、Microsoft Teams にできるだけ多くのSELECT ステートメント処理をオフロードし、残りのクエリをクライアント側のインメモリで処理します。

詳しくは、クエリ処理 を参照してください。

ログ

CData ログを調整するために使用可能な設定の概要については、ログ を参照してください。基本的なロギングに必要なのは2つの接続プロパティだけですが、より詳細なロギングをサポートする多くの機能があり、LogModules 接続プロパティを使用してロギングする情報のサブセットを指定することができます。

SSL 設定のカスタマイズ

デフォルトでは、Sync App はサーバーとのTLS のネゴシエーションを試みます。サーバー証明書は、デフォルトのシステム信頼済み証明書ストアで検証されます。SSLServerCert 接続プロパティを使用して、証明書の検証方法をオーバーライドできます。

別の証明書を指定するには、SSLServerCert 接続プロパティを参照してください。

Firewall またはProxy 経由の接続

HTTP プロキシ

HTTP プロキシへの認証には、以下のように設定します。

• ProxyServer：HTTP トラフィックをルートするプロキシサーバーのホストネームもしくはIP アドレス。
• ProxyPort：プロキシサーバーが起動しているTCP ポート。
• ProxyAuthScheme：プロキシサーバーに対して認証する際にSync App が使用する認証方法。
• ProxyUser：プロキシサーバーに登録されているユーザーアカウントのユーザー名。
• ProxyPassword：ProxyUser に紐付けられたパスワード。

その他のプロキシ

次のプロパティを設定します。

• プロキシベースのファイヤーウォールを使用するには、FirewallType、FirewallServer、およびFirewallPort を設定します。
• 接続をトンネルするには、FirewallType をTUNNEL に設定します。
• 認証するには、FirewallUser とFirewallPassword を設定します。
• SOCKS プロキシへの認証には、さらにFirewallType をSOCKS5 に設定します。

CData Sync App は、テーブル、ビュー、ストアドプロシージャを使用してMicrosoft Teams オブジェクトを使いやすいSQL データベースとしてモデル化します。これらは、スキーマファイルで定義されます。スキーマファイルは、データの構造と構成を定義する、シンプルで読みやすいテキストファイルです。

Microsoft Teams オブジェクトは、テーブル内の他のオブジェクトとリレーションを持ちます。これらのリレーションは外部キーを使用して表されます。

テーブル

テーブル セクションには標準SQL テーブルの詳細が、ビュー セクションには読み取り専用SQL テーブルの一覧が記載されています。これらには、Microsoft Teams アカウントでのアクセスを想定したサンプルが含まれています。

一般的なテーブルには以下のものが含まれます。

テーブル	説明
Teams	Maintains records of Microsoft Teams instances, including team names, visibility settings, and associated group metadata.
Channels	Tracks Microsoft Teams channel instances, capturing names, privacy settings, types (standard, private), and team associations.
Users	Contains detailed profile, organizational, and directory synchronization information for users in Microsoft Teams, including contact details, licensing, job roles, and Active Directory mappings.
Groups	Holds core metadata about Microsoft 365 Groups, including properties required for provisioning and maintaining Teams.
GroupMembers	Represents the relationship between Microsoft 365 Groups and their members, including user identifiers and membership roles.
GroupOwners	Identifies users assigned as owners of Microsoft 365 Groups that support Teams functionality, enabling management actions.
TeamMembers	Retrieves the list of users who are members of a specific Microsoft Teams team.
ChannelMembers	Retrieves a list of members belonging to a specific Microsoft Teams channel.
Chats	Provides a list of chat threads within Microsoft Teams, including group and one-on-one chats.
ChatMessages	Returns messages sent and received in Microsoft Teams chat threads.
ChannelMessages	Returns messages and replies exchanged within a Microsoft Teams channel.
ChatMembers	Retrieves details of participants in Microsoft Teams chat conversations.
TeamsInstalledApps	Maintains records of Microsoft Teams instances, including team names, visibility settings, and associated group metadata.
Apps	Contains metadata for third-party and internal apps integrated into Microsoft Teams, including installation details, permissions, and usage metrics.
TeamTabs	Documents tabs added to Teams channels, including tab type (Planner, Website, custom app) and configuration data.
Schedules	Defines the overarching containers used in Teams Shifts for organizing shifts, time-off requests, and schedule groups.
Shifts	Captures detailed shift assignments, including assigned user, start and end times, and optional shift notes.
OpenShifts	Stores reusable shift templates created by managers in the Teams Shifts app, used to build individual shift schedules.
TimesOff	Logs time-off entries requested by users through the Microsoft Teams Shifts interface, with reason codes and date ranges.
TimeOffReasons	Contains predefined labels for time-off requests in Teams Shifts, such as vacation, sick leave, or training.

ストアドプロシージャ

ストアドプロシージャ は、標準的なCRUD 操作を超える機能を持つSQL スクリプトです。パラメータを受け取り、関数を実行し、OAuth 認証トークンを管理し、サービスからデータを返すことで、処理の成功または失敗を示します。

Sync App はMicrosoft Teams のデータを、標準のSQL ステートメントを使用してクエリできるリレーショナルデータベースのテーブルのリストとしてモデル化します。

Microsoft Teams Connector for CData Sync テーブル

Name	Description
Apps	Contains metadata for third-party and internal apps integrated into Microsoft Teams, including installation details, permissions, and usage metrics.
Channels	Tracks Microsoft Teams channel instances, capturing names, privacy settings, types (standard, private), and team associations.
GroupMembers	Represents the relationship between Microsoft 365 Groups and their members, including user identifiers and membership roles.
GroupOwners	Identifies users assigned as owners of Microsoft 365 Groups that support Teams functionality, enabling management actions.
Groups	Holds core metadata about Microsoft 365 Groups, including properties required for provisioning and maintaining Teams.
OnlineMeetings	Usage information for the operation OnlineMeetings.rsd.
OpenShifts	Stores reusable shift templates created by managers in the Teams Shifts app, used to build individual shift schedules.
Schedules	Defines the overarching containers used in Teams Shifts for organizing shifts, time-off requests, and schedule groups.
SchedulingGroups	Segments users into groups within a Teams schedule to streamline shift assignments and reporting.
Shifts	Captures detailed shift assignments, including assigned user, start and end times, and optional shift notes.
Teams	Maintains records of Microsoft Teams instances, including team names, visibility settings, and associated group metadata.
TeamsInstalledApps	Tracks which apps are installed in each Microsoft Team, detailing installation context such as user, group, or channel level.
TeamTabs	Documents tabs added to Teams channels, including tab type (Planner, Website, custom app) and configuration data.
TimeOffReasons	Contains predefined labels for time-off requests in Teams Shifts, such as vacation, sick leave, or training.
TimesOff	Logs time-off entries requested by users through the Microsoft Teams Shifts interface, with reason codes and date ranges.

Contains metadata for third-party and internal apps integrated into Microsoft Teams, including installation details, permissions, and usage metrics.

テーブル固有の情報

Select

この操作は、Microsoft Teams ストアと組織のアプリカタログ（テナントアプリカタログ）のアプリを両方含みます。組織のアプリカタログのみからアプリを取得する場合は、distributionMethod にOrganization を指定してください。 Sync App はMicrosoft Teams API を使って、次のカラムと演算子で作成したWHERE 句の条件を処理します。その他のフィルタはクライアントサイドでSync App 内部で処理されます。

• displayName、Id、externalId は、'='、'!='、IN、LIKE、IS、IS NOT 演算子をサポートします。

例えば、次のクエリはサーバーサイドで処理されます。

SELECT * FROM Apps WHERE DisplayName = 'MailChimp'

SELECT * FROM Apps WHERE DisplayName IN ('OneNote', 'Teams')

SELECT * FROM Apps WHERE Id LIKE '%-3b58-%'

SELECT * FROM Apps WHERE externalId IN (123, 156)

Delete

アプリは自身の組織のアプリカタログ（テナントアプリカタログ）からのみ削除できます。アプリレコードを削除するには、WHERE 句にId を指定する必要があります。

DELETE FROM Apps WHERE Id = 'ffdb7239-3b58-46ba-b108-7f90a6d8799b'

Columns

Name	Type	ReadOnly	Description
Id [KEY]	String	False	A unique identifier automatically assigned to the app when it is added to the Teams app catalog.
displayName	String	False	The human-readable name of the app as defined by the app developer for display in Microsoft Teams.
distributionMethod	String	False	Specifies how the app is made available to users, such as via store listing, side-loading, or organization-wide deployment.
externalId	String	False	The custom identifier defined by the app developer within the Teams app package, used for linking or internal tracking.

Tracks Microsoft Teams channel instances, capturing names, privacy settings, types (standard, private), and team associations.

テーブル固有の情報

Select

すべてのチーム内のすべてのチャネルを取得するかTeamId を指定することで、Channels テーブルをクエリします。 Sync App は Microsoft Teams API を使用して、以下のカラムと演算子で作成されたWHERE 句条件を処理します。

• TeamId は、'=' およびIN 演算子をサポートします。 他のカラムは、'='、'!='、IN、LIKE、IS、IS NOT 演算子をサポートします。

その他のフィルタはクライアントサイドでSync App 内部で処理されます。 例えば、次のクエリはサーバーサイドで処理されます。

SELECT * FROM Channels WHERE TeamId IN ('da838338-4e77-4c05-82a6-79d9f0274511', 'da838338-4e77-4c05-82a6-79d9f0274555')

SELECT * FROM Channels WHERE TeamId = 'da838338-4e77-4c05-82a6-79d9f0274511' AND Id = '19:[email protected]'

SELECT * FROM Channels WHERE description != 'desc'

Note：テーブルがId カラムでフィルタリングされた場合にのみ、summary カラムに値が入力されます。また、このテーブルのsummary カラムではフィルタリングはできません。

Insert

最低でもTeamId およびDisplayName は、チームに新しいチャネルを追加するために必須です。他のフィールドもすべて指定できます。

INSERT INTO Channels (displayName, description, TeamId) VALUES ('a new channel', 'top tasks channel', 'da838338-4e77-4c05-82a6-79d9f0274511')

Columns

Name	Type	ReadOnly	Description
Id [KEY]	String	False	The unique identifier assigned to the channel by Microsoft Teams.
TeamId	String	False	The identifier of the Team to which this channel belongs, used to associate the channel with its parent Team.
CreatedDateTime	Datetime	False	The date and time when the channel was initially created, in UTC format.
Description	String	False	An optional user-defined description that provides context or purpose for the channel.
DisplayName	String	False	The name of the channel as shown in the Microsoft Teams interface to users.
Email	String	False	The email address assigned to the channel for message forwarding, available in channels with email integration. Read-only.
IsArchived	Bool	False	Indicates whether the channel is currently in a read-only, archived state.
IsFavoriteByDefault	Bool	False	Specifies whether the channel is automatically pinned as a favorite for all team members upon creation. Only configurable via API during team creation.
MembershipType	String	False	Defines the access type of the channel, such as standard, private, or shared. Set at creation time and cannot be changed later.
WebUrl	String	False	The deep link URL to access the channel in Microsoft Teams. This link is generated via the 'Get link to channel' option and should be treated as an opaque identifier.

Represents the relationship between Microsoft 365 Groups and their members, including user identifiers and membership roles.

テーブル固有の情報

Select

チームからすべてを取得するか、GroupId を'=' とIN 演算子で指定することでGroupMembers テーブルをクエリします。デフォルトでは、自身がメンバーであるグループのメンバーのみ返されます。組織の全グループのメンバーを取得するには、IncludeAllGroups プロパティをtrue に設定してください。 Sync App は Microsoft Teams API を使用して、以下のカラムと演算子で作成されたWHERE 句条件を処理します。その他のフィルタはクライアントサイドでSync App 内部で処理されます。

• GroupId は、'=' およびIN 演算子をサポートします。

例えば、次のクエリはサーバーサイドで処理されます。

SELECT * FROM GroupMembers WHERE GroupId IN ('4729c5e5-f923-4435-8a41-44423d42ea79', 'acabe397-8370-4c31-aeb7-2d7ae6b8cda1')

SELECT * FROM GroupMembers WHERE GroupId = '4729c5e5-f923-4435-8a41-44423d42ea79'

Insert

GroupId およびMemberId フィールドは新しいメンバーをグループに挿入する際には必須です。MemberId はユーザーのId に対応し、Users テーブルをクエリすることでメンバーとして追加したいユーザーのId を取得できます。

INSERT INTO GroupMembers (GroupId, MemberId) VALUES ('acabe397-8370-4c31-aeb7-2d7ae6b8cda1', 'ad9de185-a7af-4ae5-946e-17fc1bf596f0')

Delete

GroupId およびMemberId を指定することでグループメンバーを削除できます。

DELETE FROM GroupMembers WHERE GroupId = 'e557c6d9-3d9a-4658-b51a-4f242c2f8ec8' AND MemberId = 'ba074a2a-69be-45d2-8519-2cc5688bca1e'

Columns

Name	Type	ReadOnly	Description
GroupId [KEY]	String	False	The unique identifier of the Microsoft 365 Group to which the member belongs. Used to link the member to a specific group.
MemberId [KEY]	String	False	The unique identifier of the user who is a member of the specified group. Represents the user's presence in the group membership list.

Identifies users assigned as owners of Microsoft 365 Groups that support Teams functionality, enabling management actions.

テーブル固有の情報

Select

チームからすべてを取得するか、GroupId を'=' とIN 演算子で指定することでGroupOwners テーブルをクエリします。デフォルトでは、自身がメンバーであるグループの所有者のみ返されます。組織の全グループの所有者を取得するには、IncludeAllGroups プロパティをtrue に設定してください。 Sync App は Microsoft Teams API を使用して、以下のカラムと演算子で作成されたWHERE 句条件を処理します。その他のフィルタはクライアントサイドでSync App 内部で処理されます。

• GroupId は、'=' およびIN 演算子をサポートします。

例えば、次のクエリはサーバーサイドで処理されます。

SELECT * FROM GroupOwners WHERE GroupId IN ('4729c5e5-f923-4435-8a41-44423d42ea79', 'acabe397-8370-4c31-aeb7-2d7ae6b8cda1')

SELECT * FROM GroupOwners WHERE GroupId = '4729c5e5-f923-4435-8a41-44423d42ea79'

Insert

ユーザーをグループの所有者に追加できます。所有者とは、グループオブジェクトを変更できる管理者ではないユーザーのことです。GroupId およびOwnerId フィールドは、新しいメンバーをグループに挿入するために必須です。OwnerId はユーザーのId に対応し、Users テーブルをクエリすることで所有者として追加したいユーザーのId を取得できます。

INSERT INTO GroupOwners (GroupId, OwnerId) VALUES ('acabe397-8370-4c31-aeb7-2d7ae6b8cda1', 'ad9de185-a7af-4ae5-946e-17fc1bf596f0')

Delete

GroupId およびOwnerId を指定することでグループメンバーを削除できます。

DELETE FROM GroupOwners WHERE GroupId = 'e557c6d9-3d9a-4658-b51a-4f242c2f8ec8' AND OwnerId = 'ba074a2a-69be-45d2-8519-2cc5688bca1e'

Columns

Name	Type	ReadOnly	Description
GroupId [KEY]	String	False	The unique identifier of the Microsoft 365 Group for which the user has ownership responsibilities.
OwnerId [KEY]	String	False	The unique identifier of the user who is designated as an owner of the specified group. Owners have elevated permissions such as managing membership and settings.

Holds core metadata about Microsoft 365 Groups, including properties required for provisioning and maintaining Teams.

テーブル固有の情報

Select

デフォルトでは、自身がメンバーであるグループのみ返されます。組織の全グループを取得するには、IncludeAllGroups プロパティをtrue に設定してください。Sync App は Microsoft Teams API を使用して、以下のカラムと演算子で作成されたWHERE 句条件を処理します。その他のフィルタはクライアントサイドでSync App 内部で処理されます。

• Idは、'=' 演算子をサポート。

例えば、次のクエリはサーバーサイドで処理されます。

SELECT * FROM Groups WHERE Id = 'aee54826-eedb-4145-8e6b-4ec1ac4d82c6'

Insert

最低でもDisplayName、MailEnabled、MailNickname、SecurityEnabled が新しいグループを挿入するには必須です。他のフィールドもすべて指定できます。

INSERT INTO Groups (DisplayName, Description, MailEnabled, MailNickname, SecurityEnabled) VALUES ('Test Group', 'Group created from Api', false, 'test123', true)

Update

グループのレコードを更新するには、WHERE 句にId を指定してください。

UPDATE Groups SET Description = 'updated description from api' WHERE Id = 'bc48eaf7-0dc6-45d1-b17a-5b5397466ee1'

Delete

グループのレコードを削除するには、WHERE 句にId を指定してください。

DELETE FROM Groups WHERE Id = 'bc48eaf7-0dc6-45d1-b17a-5b5397466ee1'

Columns

Name	Type	ReadOnly	Description
Id [KEY]	String	False	A globally unique identifier for the Microsoft 365 group.
DeletedDateTime	Datetime	False	The date and time when the group was deleted, if applicable.
AllowExternalSenders	Bool	False	Indicates whether users outside the organization are allowed to send emails to the group. Default is false.
AssignedLabels	String	False	A list of sensitivity labels assigned to the group, shown as pairs of label ID and label name.
AssignedLicenses	String	False	The licenses that are currently assigned to the group, used for managing feature availability.
AutoSubscribeNewMembers	Bool	False	Specifies whether newly added members will automatically receive email notifications for group conversations. Settable only via PATCH requests. Default is false.
Classification	String	False	A business impact level label such as low, medium, or high, used to describe the group's sensitivity classification.
CreatedDateTime	Datetime	False	The timestamp representing when the group was originally created.
Description	String	False	A text field to describe the group's purpose or usage within the organization.
DisplayName	String	False	The user-friendly name shown in interfaces like Outlook and Teams for the group.
ExpirationDateTime	Datetime	False	The date and time when the group is scheduled to expire, if expiration policies are applied.
GroupTypes	String	False	Indicates the type of group (such as unified or dynamic) and how its membership is managed.
HideFromAddressLists	Bool	False	If true, hides the group from address books, recipient pickers, and search dialogs in Outlook.
HideFromOutlookClients	Bool	False	If true, hides the group from appearing in Outlook clients like Outlook for Windows and Outlook on the web.
IsSubscribedByMail	Bool	False	Indicates whether the currently signed-in user is subscribed to receive group emails.
LicenseProcessingState_state	String	False	The current state of license processing for group members. Reflects how licensing is being applied.
Mail	String	False	The primary SMTP email address associated with the group's shared mailbox.
MailEnabled	Bool	False	Indicates whether the group supports mail functionality and has an associated mailbox.
MailNickname	String	False	The email alias for the group, unique within the organization's namespace.
MembershipRule	String	False	For dynamic groups, this contains the rule used to determine membership automatically.
MembershipRuleProcessingState	String	False	Shows whether the membership rule engine is actively processing (On) or paused (Paused).
OnPremisesDomainName	String	False	The fully qualified domain name (FQDN) from on-premises directory, if synchronized via Azure AD Connect.
OnPremisesLastSyncDateTime	Datetime	False	The timestamp of the last successful synchronization of the group from on-premises to Azure Active Directory.
OnPremisesNetBiosName	String	False	The NetBIOS name for the group, synchronized from the on-premises directory.
OnPremisesProvisioningErrors	String	False	Describes any synchronization errors that occurred during on-premises provisioning.
OnPremisesSamAccountName	String	False	The SAM account name from on-premises directory. Available only when directory sync is configured.
OnPremisesSecurityIdentifier	String	False	The security identifier (SID) from on-premises directory, used to represent the group in Windows security models.
OnPremisesSyncEnabled	Bool	False	Indicates whether the group is currently being synchronized from on-premises Active Directory. Null means it has never been synced.
PreferredDataLocation	String	False	Specifies the desired Microsoft data center region for storing this group's content.
PreferredLanguage	String	False	The default language preference for the group's communications and user interface.
ProxyAddresses	String	False	A list of proxy email addresses that route messages to the group mailbox.
RenewedDateTime	Datetime	False	The last time the group's expiration policy was renewed, either manually or automatically.
SecurityEnabled	Bool	False	Indicates whether the group functions as a security group for controlling access to resources.
SecurityIdentifier	String	False	The Windows security identifier for the group, used in authorization checks.
Theme	String	False	The color theme assigned to the group in Microsoft 365. Possible values include Teal, Purple, Green, Blue, Pink, Orange, or Red.
UnseenCount	Int	False	The number of group conversations with new posts since the user last viewed the group.
UniqueName	String	False	An alternate, organization-wide unique name used to reference the group.
Visibility	String	False	Defines whether the group is public, private, or hidden, affecting how users can discover and join it.
Members	String	False	A list of unique identifiers representing the users who are members of the group.
Owners	String	False	A list of user IDs representing the individuals who manage the group and have administrative permissions.
UserId	String	False	The unique identifier of a user related to this group record, typically for context-specific queries.

Usage information for the operation OnlineMeetings.rsd.

Table Specific Information

Select

The Sync App uses the Microsoft Teams API to process WHERE clause conditions built with the columns and operator shown below. The rest of the filter is executed client-side within the Sync App.

• Id supports '=' operator.
• UserId supports '=' operator.

Note: UserId and Id are required columns to get results from this table, and must both be specified in the WHERE clause. The data cannot be retrieved by the Sync App using UserId alone.

Example Queries

This query uses the Id from Microsoft Teams API to obtain the UserId:

SELECT * FROM OnlineMeetings WHERE Id = 'MSphMjIxNGQwZS0zMDlkLTQ4YTAtYjRiMi1kMzI3MmNkNmZjMjQqMCoqMTk6bWVldGluZ19aREZqTXpjNFpERXRObUkyTWkwME9EYzVMVGxqWkRVdFlqY3lNVEF5WkRjMFlXTTFAdGhyZWFkLnYy'

SELECT * FROM OnlineMeetings WHERE UserId = '4729c5e5-f923-4435-8a41-44423d42ea79' AND Id = 'MSphMjIxNGQwZS0zMDlkLTQ4YTAtYjRiMi1kMzI3MmNkNmZjMjQqMCoqMTk6bWVldGluZ19aREZqTXpjNFpERXRObUkyTWkwME9EYzVMVGxqWkRVdFlqY3lNVEF5WkRjMFlXTTFAdGhyZWFkLnYy'

Columns

Name	Type	ReadOnly	Description
id [KEY]	String	False
allowAttendeeToEnableCamera	Bool	False
allowAttendeeToEnableMic	Bool	False
allowBreakoutRooms	Bool	False
allowCopyingAndSharingMeetingContent	Bool	False
allowedLobbyAdmitters	String	False
allowedPresenters	String	False
allowLiveShare	String	False
allowMeetingChat	String	False
allowParticipantsToChangeName	Bool	False
allowPowerPointSharing	Bool	False
allowRecording	Bool	False
allowTeamworkReactions	Bool	False
allowTranscription	Bool	False
allowWhiteboard	Bool	False
audioConferencing_conferenceId	String	False
audioConferencing_dialinUrl	String	False
audioConferencing_tollFreeNumber	String	False
audioConferencing_tollFreeNumbers	String	False
audioConferencing_tollNumber	String	False
audioConferencing_tollNumbers	String	False
chatInfo_messageId	String	False
chatInfo_replyChainMessageId	String	False
chatInfo_threadId	String	False
chatRestrictions_allowTextOnly	Bool	False
isEndToEndEncryptionEnabled	Bool	False
isEntryExitAnnounced	Bool	False
joinInformation_content	String	False
joinInformation_contentType	String	False
joinMeetingIdSettings_isPasscodeRequired	Bool	False
joinMeetingIdSettings_joinMeetingId	String	False
joinMeetingIdSettings_passcode	String	False
joinWebUrl	String	False
lobbyBypassSettings_isDialInBypassEnabled	Bool	False
lobbyBypassSettings_scope	String	False
recordAutomatically	Bool	False
shareMeetingChatHistoryDefault	String	False
subject	String	False
videoTeleconferenceId	String	False
watermarkProtection_isEnabledForContentSharing	Bool	False
watermarkProtection_isEnabledForVideo	Bool	False
attendeeReport	String	False	This field can not be updated directly.
broadcastSettings_allowedAudience	String	False
broadcastSettings_captions_isCaptionEnabled	Bool	False
broadcastSettings_captions_spokenLanguage	String	False
broadcastSettings_captions_translationLanguages	String	False
broadcastSettings_isAttendeeReportEnabled	Bool	False
broadcastSettings_isQuestionAndAnswerEnabled	Bool	False
broadcastSettings_isRecordingEnabled	Bool	False
broadcastSettings_isVideoOnDemandEnabled	Bool	False
creationDateTime	Datetime	False
endDateTime	Datetime	False
externalId	String	False
isBroadcast	Bool	False
meetingTemplateId	String	False
participants_attendees	String	False
participants_organizer_identity_application_displayName	String	False
participants_organizer_identity_application_id	String	False
participants_organizer_role	String	False
participants_organizer_upn	String	False
startDateTime	Datetime	False
UserId	String	False

Stores reusable shift templates created by managers in the Teams Shifts app, used to build individual shift schedules.

テーブル固有の情報

Select

チームからすべてを取得するか、GroupId を'=' とIN 演算子で指定することでOpenShifts テーブルをクエリします。デフォルトでは、自身がメンバーであるグループのチームの空のシフトのみ返されます。組織の全グループのチームの空のシフトアイテムを取得するには、IncludeAllGroups プロパティをtrue に設定してください。 Sync App は Microsoft Teams API を使用して、以下のカラムと演算子で作成されたWHERE 句条件を処理します。その他のフィルタはクライアントサイドでSync App 内部で処理されます。

• TeamId は、'=' およびIN 演算子をサポートします。
• Id は、'=' 演算子をサポートします。

例えば、次のクエリはサーバーサイドで処理されます。

SELECT * FROM OpenShifts WHERE TeamId IN ('da838338-4e77-4c05-82a6-79d9f0274511', 'da834568-4df7-4c05-82a6-79d9f0274515')
SELECT * FROM OpenShifts WHERE Id = 'OPNSHFT_2d49e6dd-d965-4ea2-a399-37f2a082852c' AND TeamId = 'da838338-4e77-4c05-82a6-79d9f0274511'

Insert

チームスケジュールに空のシフトを挿入するにはTeamId と、startDateTime およびendDateTime を含むDraftOpenShift またはSharedOpenShift の情報の、どちらか1つを含む必要があります。

INSERT INTO OpenShifts (TeamId, draftopenshift_openslotcount, draftopenshift_startDateTime, draftopenshift_endDateTime) VALUES ('da838338-4e77-4c05-82a6-79d9f0274511', 4, '2020-09-16T10:00:00.000Z', '2020-09-16T18:00:00.000Z')

Update

空のシフトを更新するには、WHERE 句にレコードId とTeamId が必要です。TeamId、Id、CreatedDateTime 以外のすべてのフィールドを更新できます。

UPDATE OpenShifts SET draftOpenShift_theme = 'blue' WHERE Id = 'OPNSHFT_2d49e6dd-d965-4ea2-a399-37f2a082852c' AND TeamId = 'da838338-4e77-4c05-82a6-79d9f0274511'

Delete

シフトレコードを削除するには、WHERE 句にId とTeamId が必要です。

DELETE FROM OpenShifts WHERE TeamId = 'da838338-4e77-4c05-82a6-79d9f0274511' AND Id = 'OPNSHFT_2d49e6dd-d965-4ea2-a399-37f2a082852c'

Columns

Name	Type	ReadOnly	Description
Id [KEY]	String	False	The unique identifier for the scheduling group that this open shift is associated with.
CreatedDateTime	Datetime	False	The date and time when the open shift was initially created.
IsStagedForDeletion	Bool	False	Indicates whether the open shift is marked for future deletion but has not yet been removed.
LastModifiedBy_application_displayName	String	False	The name of the application that most recently modified the open shift record.
LastModifiedBy_application_id	String	False	The unique application ID of the system or app that last updated the open shift.
LastModifiedDateTime	Datetime	False	The timestamp of the most recent update to the open shift.
DraftOpenShift_openSlotCount	Int	False	The number of available slots for the draft version of the open shift, which has not yet been shared with the team.
SchedulingGroupId	String	False	The unique identifier for the scheduling group under which this open shift is organized.
SharedOpenShift_openSlotCount	Int	False	The number of available slots in the shared version of the open shift, visible to team members.
TeamId	String	False	The identifier of the Microsoft Team where the open shift is being managed.
DraftOpenShift_displayName	String	False	The label or title assigned to the draft version of the open shift for display purposes.
DraftOpenShift_notes	String	False	Optional notes associated with the draft open shift, such as instructions or shift context.
DraftOpenShift_StartDateTime	Datetime	False	The start time of the draft open shift, before it has been published.
DraftOpenShift_EndDateTime	Datetime	False	The end time of the draft open shift, before it has been published.
SharedOpenShift_displayName	String	False	The label or title assigned to the shared version of the open shift for display to users.
SharedOpenShift_notes	String	False	Optional notes for the shared open shift, visible to team members when selecting shifts.
SharedOpenShift_StartDateTime	Datetime	False	The start time of the shared open shift, which is published and available for team use.
SharedOpenShift_EndDateTime	Datetime	False	The end time of the shared open shift, which is published and available for team use.

Defines the overarching containers used in Teams Shifts for organizing shifts, time-off requests, and schedule groups.

テーブル固有の情報

Select

チームからすべてを取得するか、TeamId を'=' とIN 演算子で指定することでSchedules テーブルをクエリします。デフォルトでは、自身がメンバーであるグループのチームのスケジュールアイテムのみ返されます。組織の全グループのチームからスケジュールを取得するには、IncludeAllGroups プロパティをtrue に設定してください。 Sync App は Microsoft Teams API を使用して、以下のカラムと演算子で作成されたWHERE 句条件を処理します。その他のフィルタはクライアントサイドでSync App 内部で処理されます。

• TeamId は、'=' およびIN 演算子をサポートします。

例えば、次のクエリはサーバーサイドで処理されます。

SELECT * FROM Schedules WHERE TeamId = 'da838338-4e77-4c05-82a6-79d9f0274511'

Update

スケジュールのレコードを更新するには、WHERE 句にId とTeamId が必要です。

UPDATE Schedules SET timeZone = 'Africa/Casablanca', enabled = true WHERE Id = '4729c5e5-f923-4435-8a41-44423d42ea79' AND TeamId = '4729c5e5-f923-4435-8a41-44423d42ea79'

Columns

Name	Type	ReadOnly	Description
Id [KEY]	String	False	A unique identifier representing the schedule instance within Microsoft Teams.
TeamId [KEY]	String	False	The identifier of the Microsoft Team that this schedule is associated with.
Enabled	Bool	False	Specifies whether the schedule is currently active and usable by the associated team.
OfferShiftRequestsEnabled	Bool	False	Indicates whether team members are allowed to offer their scheduled shifts to others.
OpenShiftsEnabled	Bool	False	Indicates whether open shifts are supported, allowing managers to post available shifts for pickup.
ProvisionStatus	String	False	Shows the current state of schedule provisioning. Valid values include notStarted, running, completed, and failed.
ProvisionStatusCode	String	False	Provides additional details explaining why the schedule provisioning could have failed.
SwapShiftsRequestsEnabled	Bool	False	Indicates whether team members are permitted to request a shift swap with another member.
TimeClockEnabled	Bool	False	Specifies whether the time clock feature is enabled, allowing users to clock in and out through Teams.
TimeOffRequestsEnabled	Bool	False	Indicates whether team members are allowed to submit time off requests through the schedule.
TimeZone	String	False	Defines the time zone for the schedule, using IANA tz database format (for example, America/New_York).
WorkforceIntegrationIds	String	False	A comma-separated list of integration identifiers linked to external workforce systems that sync with this schedule.

Segments users into groups within a Teams schedule to streamline shift assignments and reporting.

テーブル固有の情報

Select

チームからすべてを取得するか、TeamId を'=' とIN 演算子で指定することでSchedulingGroups テーブルをクエリします。デフォルトでは、自身がメンバーであるグループのチームのスケジュールグループのみ返されます。組織の全グループのチームからスケジュールグループを取得するには、IncludeAllGroups プロパティをtrue に設定してください。 Sync App は Microsoft Teams API を使用して、以下のカラムと演算子で作成されたWHERE 句条件を処理します。その他のフィルタはクライアントサイドでSync App 内部で処理されます。

• TeamId は、'=' およびIN 演算子をサポートします。
• Id は、'=' 演算子をサポートします。

例えば、次のクエリはサーバーサイドで処理されます。

SELECT * FROM SchedulingGroups WHERE TeamId = 'da838338-4e77-4c05-82a6-79d9f0274511' AND Id = 'TAG_357350ce-2fa2-498d-9967-494296509c32'

Insert

チームにスケジュールグループを挿入するには、TeamId と最低でもDisplayName、IsActive、iconType の内1つのフィールドを指定する必要があります。

INSERT INTO SchedulingGroups (TeamId, DisplayName, IsActive) VALUES ('da838338-4e77-4c05-82a6-79d9f0274511', 'Cashiers', 'true')

Update

スケジュールグループを更新するには、WHERE 句にId とTeamId が必要です。DisplayName およびIsActive フィールドは更新できます。

UPDATE SchedulingGroups SET DisplayName = 'Supervisors' WHERE Id = 'TAG_357350ce-2fa2-498d-9967-494296509c32' AND TeamId = 'da838338-4e77-4c05-82a6-79d9f0274511'

Delete

スケジュールグループを削除するには、WHERE 句にId とTeamId が必要です。

DELETE FROM SchedulingGroups WHERE TeamId = 'acabe397-8370-4c31-aeb7-2d7ae6b8cda1' AND Id = 'TAG_101f11df-e7c0-49f2-8d5c-a9ad085c97aa'

Columns

Name	Type	ReadOnly	Description
Id [KEY]	String	False	The unique identifier for the scheduling group within the team.
TeamId	String	False	The identifier of the Microsoft Team to which this scheduling group belongs.
CreatedDateTime	Datetime	False	The date and time when the scheduling group was initially created.
LastModifiedBy_application_displayName	String	False	The display name of the application that most recently modified the scheduling group.
LastModifiedBy_application_id	String	False	The application ID of the app that last updated the scheduling group.
LastModifiedDateTime	Datetime	False	The date and time when the scheduling group was last modified.
DisplayName	String	False	The name displayed for the scheduling group in Microsoft Teams.
IsActive	Bool	False	Indicates whether the scheduling group is currently active and available for use when creating or modifying shifts and schedules.
UserIds	String	False	A comma-separated list of user IDs who are members of this scheduling group. Each ID represents a user assigned to this group.

Captures detailed shift assignments, including assigned user, start and end times, and optional shift notes.

テーブル固有の情報

Select

チームからすべてを取得するか、TeamId を'=' とIN 演算子で指定することでShifts テーブルをクエリします。デフォルトでは、自身がメンバーであるグループのチームのシフトのみ返されます。組織の全グループのチームのシフトアイテムを取得するには、IncludeAllGroups プロパティをtrue に設定してください。 Sync App は Microsoft Teams API を使用して、以下のカラムと演算子で作成されたWHERE 句条件を処理します。その他のフィルタはクライアントサイドでSync App 内部で処理されます。

• TeamId は、'=' およびIN 演算子をサポートします。
• Id は、'=' 演算子をサポートします。

例えば、次のクエリはサーバーサイドで処理されます。

SELECT * FROM Shifts WHERE TeamId IN ('da838338-4e77-4c05-82a6-79d9f0274511', 'da834568-4df7-4c05-82a6-79d9f0274515')
SELECT * FROM Shifts WHERE Id = 'SHFT_aac21ce9-82b3-4ad1-a841-dadb570c8ebf' AND TeamId = 'da838338-4e77-4c05-82a6-79d9f0274511'

Insert

チームスケジュールにシフトを挿入するには、TeamId とこの休暇が付与される人のUserId に加えて、休暇のstartDateTime およびendDateTime を含むDraftShift またはSharedShift の情報の、どちらか1つを含む必要があります。

INSERT INTO Shifts (TeamId, UserId, draftShift_startDateTime, draftShift_endDateTime) VALUES ('da838338-4e77-4c05-82a6-79d9f0274511', '0409f710-2aa9-4f05-8944-ef382160f1d1', '2019-07-17T07:00:00Z', '2019-07-17T15:00:00Z')
INSERT INTO Shifts (TeamId, UserId, sharedShift_startDateTime, sharedShift_endDateTime) VALUES ('da838338-4e77-4c05-82a6-79d9f0274511', '0409f710-2aa9-4f05-8944-ef382160f1d1', '2019-07-17T07:00:00Z', '2019-07-17T15:00:00Z')

Update

シフトのレコードを更新するには、WHERE 句にId とTeamId が必要です。TeamId、Id、CreatedDateTime 以外のすべてのフィールドを更新できます。

UPDATE Shifts SET draftShift_theme = 'blue', draftShift_displayname = 'somename' WHERE Id = 'SHFT_aac21ce9-82b3-4ad1-a841-dadb570c8ebf' AND TeamId = 'da838338-4e77-4c05-82a6-79d9f0274511'

Delete

シフトのレコードを削除するには、WHERE 句にId とTeamId が必要です。

DELETE FROM Shifts WHERE TeamId = 'da838338-4e77-4c05-82a6-79d9f0274511' AND Id = 'SHFT_aac21ce9-82b3-4ad1-a841-dadb570c8ebf'

Columns

Name	Type	ReadOnly	Description
Id [KEY]	String	False	A unique identifier for the shift record.
TeamId	String	False	The identifier of the Microsoft Team to which this shift belongs.
UserId	String	False	The unique identifier of the user assigned to this shift.
CreatedDateTime	Datetime	False	The date and time when the shift was first created.
IsStagedForDeletion	Bool	False	Indicates whether the shift is marked for deletion but has not yet been removed.
LastModifiedBy_application_displayName	String	False	The name of the application that most recently modified the shift.
LastModifiedBy_application_id	String	False	The unique application ID of the system or app that last updated the shift.
LastModifiedDateTime	Datetime	False	The date and time of the last update to the shift.
DraftShift_activities	String	False	A list of segments in the draft version of the shift, such as work assignments, breaks, or lunches, specifying what the employee is doing and when.
DraftShift_displayName	String	False	A label assigned to the draft version of the shift for easier identification in the schedule.
DraftShift_notes	String	False	Optional notes added to the draft shift, such as instructions or important reminders.
DraftShift_startDateTime	Datetime	False	The scheduled start time of the draft shift.
DraftShift_endDateTime	Datetime	False	The scheduled end time of the draft shift.
SchedulingGroupId	String	False	The identifier of the scheduling group to which this shift is assigned.
SharedShift_activities	String	False	A list of activities in the published (shared) version of the shift, such as assignments, breaks, or other scheduled duties.
SharedShift_displayName	String	False	A label assigned to the shared version of the shift for users to see on the calendar.
SharedShift_notes	String	False	Optional notes attached to the shared version of the shift for team member reference.
SharedShift_startDateTime	Datetime	False	The published start time of the shift that is visible to the user.
SharedShift_endDateTime	Datetime	False	The published end time of the shift that is visible to the user.

Maintains records of Microsoft Teams instances, including team names, visibility settings, and associated group metadata.

テーブル固有の情報

Select

チームからすべてを取得するか、GroupId を'=' とIN 演算子で指定することでTeams テーブルをクエリします。デフォルトでは、自身がメンバーであるグループのチームのみ返されます。組織の全グループのチームを取得するには、IncludeAllGroups プロパティをtrue に設定してください。 Sync App は Microsoft Teams API を使用して、以下のカラムと演算子で作成されたWHERE 句条件を処理します。その他のフィルタはクライアントサイドでSync App 内部で処理されます。

• GroupId は、'=' およびIN 演算子をサポートします。

例えば、次のクエリはサーバーサイドで処理されます。

SELECT * FROM Teams WHERE GroupId IN ('4729c5e5-f923-4435-8a41-44423d42ea79', 'acabe397-8370-4c31-aeb7-2d7ae6b8cda1')

SELECT * FROM Teams WHERE GroupId = '4729c5e5-f923-4435-8a41-44423d42ea79'

Insert

最低でもGroupId およびDisplayName は、グループに新しいチームを追加するために必須です。他のフィールドもすべて指定できます。

INSERT INTO Teams (DisplayName, GroupId, funSettings_allowGiphy) VALUES ('Cool team', 'acabe397-8370-4c31-aeb7-2d7ae6b8cda1', false)

Update

チームのレコードを更新するには、WHERE 句にId を指定してください。アーカイブされていないチームのみ更新できます。

UPDATE Teams SET DisplayName = 'My Team', funSettings_allowGiphy = false, funSettings_allowGiphy = true, funSettings_allowStickersAndMemes = true, funSettings_allowCustomMemes = false, guestSettings_allowCreateUpdateChannels = true, guestSettings_allowDeleteChannels = false, memberSettings_allowCreateUpdateChannels = false, memberSettings_allowDeleteChannels = true, Description = 'some desc' WHERE Id = '4729c5e5-f923-4435-8a41-44423d42ea79'

Columns

Name	Type	ReadOnly	Description
Id [KEY]	String	False	The unique identifier for the Microsoft Team.
GroupId	String	False	The unique identifier for the Microsoft 365 Group backing the Team.
DisplayName	String	False	The user-friendly name of the Team as shown in Microsoft Teams.
Description	String	False	An optional description providing context or purpose for the Team.
Classification	String	False	An optional label that describes the data or business sensitivity level of the Team, based on predefined classifications in the organization's directory.
CreatedDateTime	Datetime	False	The date and time when the Team was created.
FunSettings_allowCustomMemes	Bool	False	Indicates whether users are allowed to upload and use custom memes in the Team chat.
FunSettings_allowGiphy	Bool	False	Indicates whether users are allowed to search and share Giphy images within the Team.
FunSettings_allowStickersAndMemes	Bool	False	Indicates whether users can use pre-built stickers and memes in the Team.
FunSettings_giphyContentRating	String	False	Specifies the Giphy content rating for the Team. Acceptable values include moderate and strict.
GuestSettings_allowCreateUpdateChannels	Bool	False	Indicates whether guest users are allowed to create and update channels within the Team.
GuestSettings_allowDeleteChannels	Bool	False	Indicates whether guest users are allowed to delete channels within the Team.
InternalId	String	False	A system-level internal identifier used for auditing and integrations such as Office 365 Management Activity API.
IsArchived	Bool	False	Indicates whether the Team is archived, meaning it is in read-only mode and no changes can be made.
MemberSettings_allowAddRemoveApps	Bool	False	If true, Team members are allowed to install or remove apps within the Team.
MemberSettings_allowCreatePrivateChannels	Bool	False	If true, Team members can create and manage private channels.
MemberSettings_allowCreateUpdateChannels	Bool	False	If true, Team members are permitted to create new channels or update existing ones.
MemberSettings_allowCreateUpdateRemoveConnectors	Bool	False	If true, Team members can configure connectors, including creating, updating, or removing them.
MemberSettings_allowCreateUpdateRemoveTabs	Bool	False	If true, Team members can add, update, or remove tabs in Team channels.
MemberSettings_allowDeleteChannels	Bool	False	If true, Team members have permission to delete channels.
MessagingSettings_allowChannelMentions	Bool	False	If true, allows users to use @channel mentions to notify all members of a channel.
MessagingSettings_allowOwnerDeleteMessages	Bool	False	If true, allows Team owners to delete any message posted in the Team.
MessagingSettings_allowTeamMentions	Bool	False	If true, allows users to use @team mentions to notify all members of the Team.
MessagingSettings_allowUserDeleteMessages	Bool	False	If true, allows users to delete their own messages.
MessagingSettings_allowUserEditMessages	Bool	False	If true, allows users to edit their own messages after sending.
Specialization	String	False	Indicates whether the Team is configured for a special use case (such as education or healthcare), which affects available features.
Visibility	String	False	Specifies whether the Team is public or private. Public teams can be discovered and joined by anyone in the organization.
WebUrl	String	False	A deep link to open the Team directly in the Microsoft Teams client. This link should not be parsed or altered.
summary_guestsCount	Integer	True	The number of guest users who are part of the Team.
summary_membersCount	Integer	True	The number of members in the Team, excluding guests and owners.
summary_ownersCount	Integer	True	The number of users who have owner-level permissions in the Team.

Tracks which apps are installed in each Microsoft Team, detailing installation context such as user, group, or channel level.

Columns

Name	Type	ReadOnly	Description
TeamId	String	False	The unique identifier of the Microsoft Team where the app is installed.
TeamsAppId	String	False	The identifier of the Teams app instance installed in the Team.
TeamsAppDefinitionDescription	String	False	A detailed description of the app as defined in the app's manifest or Teams App Catalog.
TeamsAppDefinitionDisplayName	String	False	The name of the Teams app as shown to users in the Microsoft Teams client.
TeamsAppDefinitionLastModifiedDateTime	Datetime	False	The timestamp indicating when the app definition was last updated in the Teams App Catalog.
TeamsAppDefinitionPublishingState	String	False	The current publishing state of the app definition, such as submitted, published, or rejected.
TeamsAppDefinitionShortDescription	String	False	A brief summary of the app's functionality or purpose, taken from the app manifest.
TeamsAppDefinitionVersion	String	False	The version number of the app definition currently installed in the Team.

Documents tabs added to Teams channels, including tab type (Planner, Website, custom app) and configuration data.

テーブル固有の情報

Select

TeamTabs テーブルをクエリするには、特定のチームに属する特定のチャネルのタブを取得するために、TeamId およびChannelId フィルタを指定する必要があります。 Sync App は Microsoft Teams API を使用して、以下のカラムと演算子で作成されたWHERE 句条件を処理します。その他のフィルタはクライアントサイドでSync App 内部で処理されます。

• TeamId およびChannelId は、'=' およびIN 演算子をサポートします。 他のカラムは、'='、'!='、IN、LIKE、IS、IS NOT 演算子をサポートします。

例えば、次のクエリはサーバーサイドで処理されます。

SELECT * FROM TeamTabs WHERE TeamId = 'da838338-4e77-4c05-82a6-79d9f0274511' AND ChannelId = '19:[email protected]'
SELECT * FROM TeamTabs WHERE TeamId = '12d95e4d-f90f-434c-b280-dd7f8b8615e5' AND ChannelId IN (SELECT Id FROM Channels WHERE TeamId = '12d95e4d-f90f-434c-b280-dd7f8b8615e5') AND Id LIKE '%-ade1-400a-a82b-e7a435199b7a'
SELECT * FROM TeamTabs WHERE TeamId = '12d95e4d-f90f-434c-b280-dd7f8b8615e5' AND ChannelId IN (SELECT Id FROM Channels WHERE TeamId = '12d95e4d-f90f-434c-b280-dd7f8b8615e5') AND configuration_entityId IS NOT NULL

Insert

最低でもTeamId、ChannelId、およびAppId は、チームに新しいタブを追加するために必須です。他のフィールドもすべて指定できます。

INSERT INTO TeamTabs (TeamId, ChannelId, DisplayName, AppID) VALUES ('4729c5e5-f923-4435-8a41-44423d42ea79', '19:[email protected]', 'new tab for test', '0d820ecd-def2-4297-adad-78056cde7c78')

Update

タブのレコードを更新するには、WHERE 句にId、ChannelId、TeamId を指定してください。

UPDATE TeamTabs SET DisplayName = 'updatetabname' WHERE Id = 'c41cbfe0-7713-44d6-96dd-b692569f1766' AND ChannelId = '19:[email protected]' AND TeamId = '4729c5e5-f923-4435-8a41-44423d42ea79'

Delete

タブのレコードを削除するには、WHERE 句にId、ChannelId、TeamId を指定してください。

DELETE FROM TeamTabs WHERE TeamId = 'da838338-4e77-4c05-82a6-79d9f0274511' AND ChannelId = '19:[email protected]' AND Id = '16ba49df-d7e1-4dc7-b6c3-ea721d327d38'

Columns

Name	Type	ReadOnly	Description
id [KEY]	String	False	A unique identifier for the specific tab instance within a channel.
AppId	String	False	The identifier of the app associated with the tab.
ChannelId	String	False	The identifier of the channel where the tab is located.
Configuration_contentUrl	String	False	The URL used by Teams to render the tab content inside the Teams client. This is required for the tab to function.
Configuration_entityId	String	False	A custom identifier for the entity represented by the tab, used by the app to load specific data or context.
Configuration_removeUrl	String	False	The callback URL invoked by the Teams client when a tab is removed. Used for cleanup or telemetry.
Configuration_websiteUrl	String	False	A publicly accessible URL used to view the tab's contents outside of Microsoft Teams.
DisplayName	String	False	The display name of the tab, shown in the channel tab navigation.
WebUrl	String	False	A deep link URL that opens the tab instance directly in the Teams client.
TeamsApp_id	String	True	The unique identifier for the Teams app definition used by the tab.
TeamId	String	False	The identifier of the Team that contains the tab and its associated channel.

Contains predefined labels for time-off requests in Teams Shifts, such as vacation, sick leave, or training.

テーブル固有の情報

Select

チームからすべてを取得するか、TeamId を指定することでTimeOffReasons テーブルをクエリします。デフォルトでは、自身がメンバーであるグループのチームの休暇理由のみ返されます。組織の全グループのチームから休暇理由を取得するには、IncludeAllGroups プロパティをtrue に設定してください。 Sync App は Microsoft Teams API を使用して、以下のカラムと演算子で作成されたWHERE 句条件を処理します。その他のフィルタはクライアントサイドでSync App 内部で処理されます。

• TeamId は、'=' およびIN 演算子をサポートします。
• Id は、'=' 演算子をサポートします。

例えば、次のクエリはサーバーサイドで処理されます。

SELECT * FROM TimeOffReasons WHERE TeamId IN ('da838338-4e77-4c05-82a6-79d9f0274511', 'da834568-4df7-4c05-82a6-79d9f0274515')
SELECT * FROM TimeOffReasons WHERE TeamId = 'da838338-4e77-4c05-82a6-79d9f0274511' AND Id = 'SHFT_0aee55c3-2bac-4ede-9792-26838fc8bb01'

Insert

チームに休暇理由を挿入するには、TeamId と最低でもDisplayName、IsActive、iconType の内1つのフィールドを指定する必要があります。

INSERT INTO TimeOffReasons (TeamId, DisplayName, IsActive) VALUES ('acabe397-8370-4c31-aeb7-2d7ae6b8cda1', 'a new reason', 'true')

Delete

休暇理由のレコードを削除するには、WHERE 句にId とTeamId が必要です。

DELETE FROM TimeOffReasons WHERE Id = 'SHFT_dd50b99a-e2d8-44ad-a445-53ad58bfc37b' AND TeamId = 'acabe397-8370-4c31-aeb7-2d7ae6b8cda1'

Columns

Name	Type	ReadOnly	Description
Id [KEY]	String	False	The unique identifier for the time off reason entry.
TeamId	String	False	The identifier of the Microsoft Team that this time off reason is associated with.
CreatedDateTime	Datetime	False	The date and time when the time off reason was initially created.
LastModifiedBy_application_displayName	String	False	The name of the application that most recently modified this time off reason.
LastModifiedBy_application_id	String	False	The application ID of the service or app that last updated this time off reason.
LastModifiedDateTime	Datetime	False	The timestamp of the most recent update to the time off reason entry.
DisplayName	String	False	The display name for the time off reason, such as Vacation, Sick Leave, or Jury Duty. Required field.
IconType	String	False	The icon representing the time off reason. Supported values: none, car, calendar, running, plane, firstAid, doctor, notWorking, clock, juryDuty, globe, cup, phone, weather, umbrella, piggyBank, dog, cake, trafficCone, pin, sunny.
IsActive	Bool	False	Indicates whether this time off reason is currently active and available for use in new or updated time off requests.

Logs time-off entries requested by users through the Microsoft Teams Shifts interface, with reason codes and date ranges.

テーブル固有の情報

Select

チームからすべてを取得するか、TeamId を指定することでTimesOff テーブルをクエリします。デフォルトでは、自身がメンバーであるグループのチームの休暇のみ返されます。組織の全グループのチームから休暇を取得するには、IncludeAllGroups プロパティをtrue に設定してください。 Sync App は Microsoft Teams API を使用して、以下のカラムと演算子で作成されたWHERE 句条件を処理します。その他のフィルタはクライアントサイドでSync App 内部で処理されます。

• TeamId は、IN および'=' 演算子をサポートします。
• Id は、'=' 演算子をサポートします。

例えば、次のクエリはサーバーサイドで処理されます。

SELECT * FROM TimesOff WHERE TeamId IN ('da838338-4e77-4c05-82a6-79d9f0274511', 'da834568-4df7-4c05-82a6-79d9f0274515')
SELECT * FROM TimesOff WHERE TeamId = 'da838338-4e77-4c05-82a6-79d9f0274511'

Insert

チームスケジュールに休暇を挿入するには、TeamId とこの休暇が付与される人のUserId に加えて、休暇のstartDateTime、endDateTime およびtimeOff_ReasonId を含むDraftTimeOff またはSharedTimeOff の情報の、どちらかを含む必要があります。

INSERT INTO TimesOff (TeamId, UserId, sharedTimeOff_startDateTime, sharedTimeOff_endDateTime, SharedTimeOff_TimeOffReasonId) VALUES ('da838338-4e77-4c05-82a6-79d9f0274511', '0409f710-2aa9-4f05-8944-ef382160f1d1', '2019-03-11T07:00:00Z', '2019-03-12T07:00:00Z', 'TOR_97de5f58-462b-4bde-8a95-038b4073bffb')

Update

休暇のレコードを更新するには、WHERE 句にId とTeamId が必要です。TeamId、Id、CreatedDateTime 以外のすべてのフィールドを更新できます。

UPDATE Timesoff SET draftTimeOff_timeOffReasonId = 'TOR_97de5f58-462b-4bde-8a95-038b4073bffb' WHERE Id = 'SHFT_dd50b99a-e2d8-44ad-a445-53ad58bfc37b' AND TeamId = 'da838338-4e77-4c05-82a6-79d9f0274511'

Delete

休暇のレコードを削除するには、WHERE 句にId とTeamId が必要です。

DELETE FROM TimesOff WHERE Id = 'SHFT_dd50b99a-e2d8-44ad-a445-53ad58bfc37b' AND TeamId = 'da838338-4e77-4c05-82a6-79d9f0274511'

Columns

Name	Type	ReadOnly	Description
Id [KEY]	String	False	A unique identifier for the time off entry.
UserId	String	False	The unique identifier of the user who submitted or was assigned this time off request.
TeamId	String	False	The identifier of the Microsoft Team associated with the time off request.
CreatedDateTime	Datetime	False	The date and time when the time off request was first created.
IsStagedForDeletion	Bool	False	Indicates whether the time off entry is marked for deletion but has not yet been removed.
LastModifiedBy_application_displayName	String	False	The name of the application that most recently modified the time off entry.
LastModifiedBy_application_id	String	False	The unique application ID of the system or service that last modified the entry.
LastModifiedDateTime	Datetime	False	The date and time when the time off entry was last updated.
DraftTimeOff_timeOffReasonId	String	False	The identifier for the reason associated with the draft version of the time off request.
SharedTimeOff_timeOffReasonId	String	False	The identifier for the reason associated with the shared (published) version of the time off request.
DraftTimeOff_StartDateTime	Datetime	False	The scheduled start date and time for the draft version of the time off.
DraftTimeOff_EndDateTime	Datetime	False	The scheduled end date and time for the draft version of the time off.
SharedTimeOff_StartDateTime	Datetime	False	The scheduled start date and time for the published version of the time off.
SharedTimeOfft_EndDateTime	Datetime	False	The scheduled end date and time for the published version of the time off.

ビューは、データを示すという点でテーブルに似ていますが、ビューは読み取り専用です。

クエリは、ビューに対して通常のテーブルと同様に実行することができます。

Microsoft Teams Connector for CData Sync ビュー

Name	Description
CallRecordParticipants	Details of call sessions on MS Teams.
CallRecords	Provides an overview of call activity in Microsoft Teams, including metadata such as call duration and type.
CallRecordSessions	Lists sessions within Microsoft Teams calls, with details on session start and end times.
CallRecordSessionSegments	Breaks down call sessions in Microsoft Teams into smaller segments for granular tracking of media streams.
ChannelMembers	Retrieves a list of members belonging to a specific Microsoft Teams channel.
ChannelMessages	Returns messages and replies exchanged within a Microsoft Teams channel.
ChatMembers	Retrieves details of participants in Microsoft Teams chat conversations.
ChatMessageAttachments	Get Chat Message Attachments.
ChatMessageMentions	Get Chat Message Mentions.
ChatMessages	Returns messages sent and received in Microsoft Teams chat threads.
Chats	Provides a list of chat threads within Microsoft Teams, including group and one-on-one chats.
DirectRoutingCalls	Displays direct routing call records in Microsoft Teams for telephony integration analysis.
PstnCalls	Displays Public Switched Telephone Network (PSTN) call records in Microsoft Teams.
TeamMembers	Retrieves the list of users who are members of a specific Microsoft Teams team.
UserPresence	Stores real-time presence information for Microsoft Teams users.
Users	Contains detailed profile, organizational, and directory synchronization information for users in Microsoft Teams, including contact details, licensing, job roles, and Active Directory mappings.

Details of call sessions on MS Teams.

Table Specific Information

Select

Query the CallRecordParticipants table to get details of PeerToPeer and Group Call session information on Teams. The CallRecordsId should be acquired by following instructions in Get callRecord. Custom App and Client Credentials should be used. See Entra ID（Azure AD）アプリケーションの作成

• CallRecordParticipants supports '=' operator.

The following is an example query:

SELECT * FROM CallRecordParticipants WHERE CallRecordsId = 'b6ee7caa-f730-451f-b6bd-24592a3429a7'

Columns

Name	Type	Description
Id [KEY]	String	Call record Id
CallRecordsId	String	Call record Id. Mandatory internal column to be used in WHERE clause
displayName	String
userId	String
tenantId	String
userPrincipalName	String

Provides an overview of call activity in Microsoft Teams, including metadata such as call duration and type.

テーブル固有の情報

Select

CallRecord テーブルをクエリして、Teams のピアツーピアおよびグループ通話セッションセグメントの詳細を取得します。 CallRecordsId は、callRecord の取得の説明に従って取得してください。 カスタムアプリおよびクライアントクレデンシャルを使用する必要があります。Entra ID（Azure AD）アプリケーションの作成 を参照してください。

• CallRecordsId は、'=' 演算子をサポートします。

次にクエリの例を示します。

SELECT * FROM CallRecords WHERE CallRecordsId = 'b6ee7caa-f730-451f-b6bd-24592a3429a7'

Columns

Name	Type	Description
Id [KEY]	String	Unique identifier for the call record in Microsoft Teams.
EndDateTime	Datetime	Timestamp indicating when the call ended.
JoinWebUrl	String	Web URL that participants used to join the meeting.
LastModifiedDateTime	Datetime	Timestamp of the most recent modification to this call record.
Modalities	String	Communication modes used during the call, which can include audio, video, videoBasedScreenSharing, data, and screenSharing.
StartDateTime	Datetime	Timestamp indicating when the call or meeting started.
Type	String	Specifies whether the call was peerToPeer or groupCall.
Version	Long	Version number of the call record for internal tracking.
organizer_v2_id	String	Unique identifier for the meeting organizer in Microsoft Teams.
organizer_v2_displayName	String	Full display name of the user who organized the meeting.
organizer_v2_userId	String	User ID of the meeting organizer within Microsoft Teams.
organizer_v2_tenantId	String	Tenant ID associated with the meeting organizer's Microsoft 365 account.
organizer_v2_userPrincipalName	String	User Principal Name (UPN) of the meeting organizer.
CallRecordsId	String	Mandatory internal column representing the call record ID, used in WHERE clauses to filter records.

Lists sessions within Microsoft Teams calls, with details on session start and end times.

テーブル固有の情報

Select

CallRecordSessions テーブルをクエリして、Teams のピアツーピアおよびグループ通話セッションセグメントの情報を取得します。 CallRecordsId は、callRecord の取得の説明に従って取得してください。 カスタムアプリおよびクライアントクレデンシャルを使用する必要があります。Entra ID（Azure AD）アプリケーションの作成 を参照してください。

• CallRecordSessions は、'=' 演算子をサポートします。

次にクエリの例を示します。

SELECT * FROM CallRecordSessions WHERE CallRecordsId = 'b6ee7caa-f730-451f-b6bd-24592a3429a7'

Columns

Name	Type	Description
Id [KEY]	String	Unique identifier for the call record session in Microsoft Teams.
Callee_UserAgent_ApplicationVersion	String	Version of the application used by the callee's user agent during the session.
Callee_UserAgent_HeaderValue	String	Header value from the callee's user agent during the session.
Caller_UserAgent_ApplicationVersion	String	Version of the application used by the caller's user agent during the session.
Caller_UserAgent_HeaderValue	String	Header value from the caller's user agent during the session.
EndDateTime	Datetime	Timestamp indicating when the call session ended.
FailureInfo_Reason	String	Reason for the call session failure, if applicable.
FailureInfo_Stage	String	Stage at which the call session failure occurred, if applicable.
Modalities	String	Communication modes used in the session, which can include audio, video, videoBasedScreenSharing, data, and screenSharing.
StartDateTime	Datetime	Timestamp indicating when the call session started.
CallRecordsId	String	Mandatory internal column representing the call record ID, used in WHERE clauses to filter records.

Breaks down call sessions in Microsoft Teams into smaller segments for granular tracking of media streams.

テーブル固有の情報

Select

CallRecordSessionSegments テーブルをクエリして、Teams のピアツーピアおよびグループ通話セッションセグメントの詳細を取得します。 CallRecordsId は、callRecord の取得の説明に従って取得してください。 カスタムアプリおよびクライアントクレデンシャルを使用する必要があります。Entra ID（Azure AD）アプリケーションの作成 を参照してください。

• CallRecordSessionSegments は、'=' 演算子をサポートします。

次にクエリの例を示します。

SELECT * FROM CallRecordSessionSegments WHERE CallRecordsId = 'b6ee7caa-f730-451f-b6bd-24592a3429a7'

Columns

Name	Type	Description
Id [KEY]	String	Unique identifier for the call record session segment in Microsoft Teams.
Callee_UserAgent_ApplicationVersion	String	Version of the application used by the callee's user agent during this session segment.
Callee_UserAgent_HeaderValue	String	Header value from the callee's user agent during this session segment.
Caller_UserAgent_ApplicationVersion	String	Version of the application used by the caller's user agent during this session segment.
Caller_UserAgent_HeaderValue	String	Header value from the caller's user agent during this session segment.
EndDateTime	Datetime	Timestamp indicating when the session segment ended.
FailureInfo_Reason	String	Reason for failure during the session segment, if applicable.
FailureInfo_Stage	String	Stage of the call session where the failure occurred, if applicable.
Media	String	Details about media streams used during the session segment, such as audio or video.
StartDateTime	Datetime	Timestamp indicating when the session segment started.
CallRecordsId	String	Mandatory internal column representing the call record ID, used in WHERE clauses to filter records.

Retrieves a list of members belonging to a specific Microsoft Teams channel.

Table Specific Information

SELECT

The Sync App uses the Microsoft Teams API to process WHERE clause conditions built with the following columns and operators:

• ChannelId supports the '=' operator.
• TeamId supports the '=,IN' operators.

Note: ChannelId and TeamId must be included in the WHERE clause to retrieve any data from the ChannelMembers view. These filters are required by the API and are evaluated server-side.

The rest of the filter is executed client-side within the Sync App.

For example, the following queries are processed server-side:

SELECT * FROM ChannelMembers WHERE ChannelId = '19:[email protected]' AND TeamId = 'f7985bee-7fb4-404d-a954-5ba68ae7c8db'

SELECT * FROM ChannelMembers WHERE ChannelId = '19:[email protected]' AND TeamId IN ('f7985bee-7fb4-404d-a954-5ba68ae7c8db', 'da838338-4e77-4c05-82a6-79d9f0274511')

Columns

Name	Type	Description
Id [KEY]	String	Unique identifier for the channel member in Microsoft Teams.
TeamId	String	Identifier of the team to which the channel belongs.
DisplayName	String	Full display name of the channel member.
email	String	Email address of the channel member.
Roles	String	Roles assigned to the channel member, such as owner or member.
TenantId	String	Identifier of the Microsoft 365 tenant associated with the member.
UserId	String	Unique user identifier for the channel member.
StartDateTime	Datetime	Timestamp indicating when the membership history for the channel started.
ChannelId	String	Identifier of the Microsoft Teams channel where the member is assigned.

Returns messages and replies exchanged within a Microsoft Teams channel.

Table Specific Information

Select

The Sync App uses the Microsoft Teams API to process WHERE clause conditions built with the columns and operator shown below. The rest of the filter is executed client-side within the Sync App.

• TeamId supports '=' operator.
• ChannelId supports '=' operator.
• Id supports '=' operator.
• ReplyToId supports '=' operator.

Note: ChannelId and TeamId are required columns to get results from this view, and must both be specified in the WHERE clause. The data cannot be retrieved by the Sync App using ChannelId alone.

Example Queries

The Sync App executes this by fetching ChannelID and TeamId from Microsoft Teams API:

SELECT * FROM ChannelMessages

This query uses the TeamID from Microsoft Teams API to obtain the ChannelID:

SELECT * FROM ChannelMessages WHERE TeamId = '4729c5e5-f923-4435-8a41-44423d42ea79'

SELECT * FROM ChannelMessages WHERE TeamId = '4729c5e5-f923-4435-8a41-44423d42ea79' AND ChannelId = '19:[email protected]'

SELECT * FROM ChannelMessages WHERE TeamId = '4729c5e5-f923-4435-8a41-44423d42ea79' AND ChannelId = '19:[email protected]' AND Id='1688061957561'

To get all the replies in a message:

SELECT * FROM ChannelMessages WHERE TeamId = '4729c5e5-f923-4435-8a41-44423d42ea79' AND ChannelId = '19:[email protected]' AND ReplyToId='1688061957561'

SELECT * FROM ChannelMessages WHERE TeamId = '4729c5e5-f923-4435-8a41-44423d42ea79' AND ChannelId = '19:[email protected]' AND Id='1688061957562' AND ReplyToId='1688061957561'

Columns

Name	Type	Description
Id [KEY]	String	Unique identifier for the channel message in Microsoft Teams.
BodyContent	String	Plaintext or rich text content of the message body.
BodyContentType	String	Specifies the format of the message body content, such as text or HTML.
ChannelId	String	Identifier of the Microsoft Teams channel where the message was posted.
TeamId	String	Identifier of the team associated with the channel.
Mentions	String	List of entities mentioned in the message. Supported entities include user, bot, team, and channel.
Reactions	String	List of reactions applied to the channel message, such as like or heart.
Attachments	String	References to objects attached to the message, such as files, tabs, or meetings.
Importance	String	Priority level of the message, such as normal, high, or urgent.
CreatedDateTime	Datetime	Timestamp indicating when the message was created.
LastEditedDateTime	Datetime	Timestamp indicating when the message was last edited.
LastModifiedDateTime	Datetime	Timestamp indicating when the message was last updated.
DeletedDateTime	Datetime	Timestamp indicating when the message was deleted, or null if it has not been deleted.
MessageType	String	Type of message, such as standard or system notification.
ChatId	String	Identifier of the chat thread when the message is part of a threaded conversation.
Etag	String	Version identifier for the message used for concurrency control.
FromUserDisplayName	String	Display name of the user who sent the message.
FromUserId	String	Unique identifier of the user who sent the message.
FromUserUserIdentityType	String	Specifies the identity type of the user who sent the message.
FromApplication	String	Name of the application that sent the message, if applicable.
FromDevice	String	Name of the device used to send the message, if available.
Locale	String	Locale setting of the message as defined by the client application, typically en-us.
PolicyViolation	String	Details about any policy violations associated with the message.
ReplyToId	String	Identifier of the parent message when the current message is part of a reply thread.
Subject	String	Subject line of the message in plaintext, if provided.
Summary	String	Summary text of the message for use in notifications, previews, or fallback views. Applies only to channel messages.
WebUrl	String	Direct link to view the message in Microsoft Teams.
EventDetail	String	Details about the event associated with the message, if applicable.

Retrieves details of participants in Microsoft Teams chat conversations.

Table Specific Information

SELECT

The Sync App use the Microsoft Teams API to process WHERE clause conditions built with the following columns and operators:

• UserId supports the '=' operator.
• ChatId supports the '=,IN' operators.

Note: UserId and ChatId must be included in the WHERE clause to retrieve any data from the ChatMembers view. These filters are required by the API and are evaluated server-side.

The rest of the filter is executed client-side within the Sync App.

For example, the following queries are processed server-side:

SELECT * FROM ChatMembers WHERE UserId = 'e4ea490e-b30c-4b1e-92b0-337117920315' AND ChatId = '19:92dfdfc6-f1d4-4965-9f71-30e4da4fa7fe_90a27c51-5c74-453b-944a-134ba86da790@unq.gbl.spaces'

SELECT * FROM ChatMembers WHERE UserId = 'e4ea490e-b30c-4b1e-92b0-337117920315' AND ChatId IN ('19:92dfdfc6-f1d4-4965-9f71-30e4da4fa7fe_90a27c51-5c74-453b-944a-134ba86da790@unq.gbl.spaces', '19:92dfdfc6-f1d4-4965-9f71-30e4da4fa7fe_b62067c0-8314-42f8-9d02-d1c2051dfcdc@unq.gbl.spaces')

Columns

Name	Type	Description
Id [KEY]	String	Unique identifier for the chat member in Microsoft Teams.
ChatId	String	Identifier of the chat to which the member belongs.
DisplayName	String	Full display name of the chat member.
email	String	Email address of the chat member.
Roles	String	Roles assigned to the chat member, such as owner or participant.
TenantId	String	Identifier of the Microsoft 365 tenant associated with the chat member.
UserId	String	Unique user identifier for the chat member.
StartDateTime	Datetime	Timestamp indicating when the membership history for the chat started.

Get Chat Message Attachments.

Table Specific Information

Select

The Sync App uses the Microsoft Teams API to process WHERE clause conditions built with the following column and operator:

• ChatId supports '=' operator.

The rest of the filter is executed client side within the Sync App.

The following is an example query:

SELECT * FROM ChatMessageAttachments WHERE ChatId = '19:92dfdfc6-f1d4-4965-9f71-30e4da4fa7fe_e4ea490e-b30c-4b1e-92b0-337117920315@unq.gbl.spaces'

Columns

Name	Type	Description
Id	String	The Chat Messages Id.
ChatId	String	The Chat Id.
Attachments_Id	String	The Id of the attachment.
Content	String	The Content of the attachment.
ContentType	String	The ContentType of the attachment.
ContentUrl	String	The ContentUrl of the attachment.
Name	String	The Name of the attachment.
TeamsAppId	String	The TeamsAppId of the attachment.
ThumbnailUrl	String	The ThumbnailUrl of the attachment.

Get Chat Message Mentions.

Table Specific Information

Select

The Sync App uses the Microsoft Teams API to process WHERE clause conditions built with the following column and operator:

• ChatId supports '=' operator.

The rest of the filter is executed client side within the Sync App.

The following is an example query:

SELECT * FROM ChatMessageMentions WHERE ChatId = '19:92dfdfc6-f1d4-4965-9f71-30e4da4fa7fe_e4ea490e-b30c-4b1e-92b0-337117920315@unq.gbl.spaces'

Columns

Name	Type	Description
Id	String	The Chat Messages Id.
ChatId	String	The Chat Id.
Mentions_Id	Int	The Id of the mention.
MentionText	String	The MentionText of the mention.
User_Id	String	The User_Id of the mention.
User_DisplayName	String	The User_DisplayName of the mention.
User_TenantId	String	The User_TenantId of the mention.
Application_Id	String	The Application_Id of the mention.
Application_DisplayName	String	The Application_DisplayName of the mention.
Application_TenantId	String	The Application_TenantId of the mention.
Device_Id	String	The Device_Id of the mention.
Device_DisplayName	String	The Device_DisplayName of the mention.
Device_TenantId	String	The Device_TenantId of the mention.
Conversation_Id	String	The Conversation_Id of the mention.
Conversation_DisplayName	String	The Conversation_DisplayName of the mention.
Conversation_ConversationIdentityType	String	The Conversation_ConversationIdentityType of the mention.

Returns messages sent and received in Microsoft Teams chat threads.

Table Specific Information

Select

The Sync App uses the Microsoft Teams API to process WHERE clause conditions built with the following column and operator:

• ChatId supports '=' operator.

The rest of the filter is executed client side within the Sync App.

The following is an example query:

SELECT * FROM ChatMessages WHERE ChatId = '19:92dfdfc6-f1d4-4965-9f71-30e4da4fa7fe_e4ea490e-b30c-4b1e-92b0-337117920315@unq.gbl.spaces'

Columns

Name	Type	Description
Id [KEY]	String	Unique identifier for the chat message in Microsoft Teams.
ChatId	String	Identifier of the chat thread containing the message.
BodyContent	String	Plaintext or rich text content of the chat message body.
BodyContentType	String	Specifies the format of the message body content, such as text or HTML.
MessageType	String	Type of chat message, such as standard or system notification.
CreatedDateTime	Datetime	Timestamp indicating when the chat message was created.
LastEditedDateTime	Datetime	Timestamp indicating when the chat message was last edited.
LastModifiedDateTime	Datetime	Timestamp indicating when the chat message was last updated.
DeletedDateTime	Datetime	Timestamp indicating when the chat message was deleted, or null if it has not been deleted.
Reactions	String	List of reactions applied to the chat message, such as like or heart.
Mentions	String	List of entities mentioned in the chat message. Supported entities include user, bot, team, and channel.
Attachments	String	References to objects attached to the message, such as files, tabs, or meetings.
Importance	String	Priority level of the chat message, such as normal, high, or urgent.
FromUserDisplayName	String	Display name of the user who sent the message.
FromUserId	String	Unique identifier of the user who sent the message.
FromUserIdentityType	String	Specifies the identity type of the user who sent the message.
ChannelIdentity	String	Identifier of the Microsoft Teams channel associated with the message, if applicable.
Locale	String	Locale setting of the message as defined by the client application, typically en-us.
ReplyToId	String	Identifier of the parent chat message if this message is part of a reply thread.
Subject	String	Subject line of the chat message, in plaintext.
Summary	String	Summary text of the chat message for use in notifications, previews, or fallback views. Applies only to channel chat messages.
PolicyViolation	String	Details about any policy violations associated with the chat message.
Etag	String	Version identifier for the chat message used for concurrency control.
FromApplication	String	Name of the application that sent the message, if applicable.
FromDevice	String	Name of the device used to send the message, if available.
WebUrl	String	Direct link to view the message in Microsoft Teams.
EventDetail	String	Details about the event associated with the chat message, if applicable.

Provides a list of chat threads within Microsoft Teams, including group and one-on-one chats.

Table Specific Information

Select

The Sync App use the Microsoft Teams API to process WHERE clause conditions built with the following column and operator:

• Id supports '=' operator.

The rest of the filter is executed client side within the Sync App.

The following is an example query:

SELECT * FROM Chats WHERE Id = '19:32caef50-395c-425a-a994-e3fa4569b23b_92dfdfc6-f1d4-4965-9f71-30e4da4fa7fe@unq.gbl.spaces'

Columns

Name	Type	Description
Id [KEY]	String	Unique identifier for the chat in Microsoft Teams.
ChatType	String	Specifies the type of chat, such as one-on-one, group, or meeting chat.
UserId	String	Identifier of the user associated with the chat.
CreatedDateTime	Datetime	Timestamp indicating when the chat was created.
LastUpdatedDateTime	Datetime	Timestamp indicating when the chat was last updated.
Topic	String	Subject or topic of the chat, if specified.
IsHiddenForAllMembers	Bool	Indicates whether the chat is hidden for all members.

Displays direct routing call records in Microsoft Teams for telephony integration analysis.

テーブル固有の情報

Select

カスタムアプリおよびクライアントクレデンシャルを使用する必要があります。Entra ID（Azure AD）アプリケーションの作成 を参照してください。 Sync App は Microsoft Teams API を使用して、以下のカラムと演算子で作成されたWHERE 句条件を処理します。その他のフィルタはクライアントサイドでSync App 内部で処理されます。

• FromDate は、'=' 演算子をサポートします。
• ToDate は、'=' 演算子をサポートします。

次にクエリの例を示します。

SELECT * FROM DirectRoutingCalls WHERE FromDate = '2021-01-01'

SELECT * FROM DirectRoutingCalls WHERE FromDate = '2021-01-01' AND ToDate = '2021-02-09'

Note：FromDate とToDate は必須パラメータであり、指定されていない場合はデフォルトの日付を日付範囲90日で使用します。

Columns

Name	Type	Description
Id	String	Unique identifier for the direct routing call in Microsoft Teams.
CorrelationId	String	Correlation identifier used to track related call and session data.
UserId	String	Unique identifier of the user associated with the call.
UserPrincipalName	String	User Principal Name (UPN) of the user who participated in the call.
UserDisplayName	String	Display name of the user who participated in the call.
StartDateTime	Edm.DateTimeOffset	Timestamp indicating when the call started.
InviteDateTime	Edm.DateTimeOffset	Timestamp indicating when the call invitation was sent.
FailureDateTime	Edm.DateTimeOffset	Timestamp indicating when the call failed, if applicable.
EndDateTime	Edm.DateTimeOffset	Timestamp indicating when the call ended.
Duration	Integer	Duration of the call in seconds.
CallType	String	Type of call, such as inbound or outbound.
SuccessfulCall	String	Indicates whether the call was successfully completed.
CallerNumber	String	Phone number of the caller.
CalleeNumber	String	Phone number of the callee.
MediaPathLocation	String	Location of the media path used during the call.
SignalingLocation	String	Location of the signaling server handling the call.
FinalSipCode	Integer	Final SIP (Session Initiation Protocol) response code for the call.
CallEndSubReason	Integer	Detailed subreason code explaining why the call ended.
FinalSipCodePhrase	String	Description of the final SIP code.
MediaBypassEnabled	Boolean	Indicates whether Media Bypass was enabled for the call.
FromDate	Edm.Date	Start date for filtering calls to retrieve.
ToDate	Edm.Date	End date for filtering calls to retrieve.

Displays Public Switched Telephone Network (PSTN) call records in Microsoft Teams.

テーブル固有の情報

Select

カスタムアプリおよびクライアントクレデンシャルを使用する必要があります。Entra ID（Azure AD）アプリケーションの作成 を参照してください。 Sync App は Microsoft Teams API を使用して、以下のカラムと演算子で作成されたWHERE 句条件を処理します。その他のフィルタはクライアントサイドでSync App 内部で処理されます。

• FromDate は、'=' 演算子をサポートします。
• ToDate は、'=' 演算子をサポートします。

次にクエリの例を示します。

SELECT * FROM PstnCalls WHERE FromDate = '2021-01-01'

SELECT * FROM PstnCalls WHERE FromDate = '2021-01-01' AND ToDate = '2021-02-09'

Note：FromDate およびToDate は必須パラメータであり、指定されていない場合はデフォルトの日付を日付範囲90日で使用します。

Columns

Name	Type	Description
Id	String	Unique identifier for the PSTN (Public Switched Telephone Network) call record.
CallId	String	Identifier for the specific call within Microsoft Teams.
UserId	String	Unique identifier of the user associated with the call.
UserPrincipalName	String	User Principal Name (UPN) of the user who made or received the call.
UserDisplayName	String	Display name of the user involved in the call.
StartDateTime	Edm.DateTimeOffset	Timestamp indicating when the PSTN call started.
EndDateTime	Edm.DateTimeOffset	Timestamp indicating when the PSTN call ended.
Duration	Integer	Total duration of the call in seconds.
Charge	Edm.Double	Monetary charge for the PSTN call.
CallType	String	Type of call, such as inbound or outbound.
Currency	String	Currency in which the charge is calculated.
CallerNumber	String	Phone number of the caller.
CalleeNumber	String	Phone number of the callee.
UsageCountryCode	String	Country code representing where the PSTN usage occurred.
TenantCountryCode	String	Country code for the Microsoft 365 tenant associated with the call.
ConnectionCharge	Edm.Double	One-time connection charge for the PSTN call.
DestinationName	String	Name of the call destination, such as a city or region.
ConferenceId	String	Identifier for the conference when the call is part of a conference session.
LicenseCapability	String	License capability of the user at the time of the call.
InventoryType	String	Type of inventory resource used for the call, such as service numbers or user numbers.
FromDate	Edm.Date	Start date for filtering PSTN call records to retrieve.
ToDate	Edm.Date	End date for filtering PSTN call records to retrieve.

Retrieves the list of users who are members of a specific Microsoft Teams team.

Table Specific Information

Select

The Sync App will use the Microsoft Teams API to process WHERE clause conditions built with the following columns and operators. The rest of the filter is executed client side within the Sync App.

• TeamId supports the '=,IN' operators.

For example, the following query is processed server side:

SELECT * FROM TeamMembers WHERE TeamId = 'f7985bee-7fb4-404d-a954-5ba68ae7c8db'

SELECT * FROM TeamMembers WHERE TeamId IN ('f7985bee-7fb4-404d-a954-5ba68ae7c8db', 'da838338-4e77-4c05-82a6-79d9f0274511')

Columns

Name	Type	Description
Id [KEY]	String	Unique identifier for the team member in Microsoft Teams.
TeamId	String	Identifier of the team to which the member belongs.
DisplayName	String	Full display name of the team member.
email	String	Email address of the team member.
Roles	String	Roles assigned to the team member, such as owner or member.
TenantId	String	Identifier of the Microsoft 365 tenant associated with the team member.
UserId	String	Unique user identifier for the team member.
StartDateTime	Datetime	Timestamp indicating when the membership history for the team started.

Stores real-time presence information for Microsoft Teams users.

Table Specific Information

Select

The Sync App will use the Microsoft Teams API to process WHERE clause conditions built with the following column and operator. The rest of the filter is executed client side within the Sync App.

• Id supports '=' operator.

Following is an example query:

SELECT * FROM UserPresence WHERE Id = '142478877'

SELECT * FROM UserPresence WHERE Id IN ('0409f710-2aa9-4f05-8944-ef382160f1d1', '04a54c2f-2402-4cee-ac8e-9eee05d0dd30')

Columns

Name	Type	Description
Id	String	Unique identifier for the Microsoft Teams user.
Availability	String	The user's current availability status, such as Available, Away, Busy, or Do Not Disturb.
Activity	String	The user's current activity state in Microsoft Teams, such as In a call, In a meeting, or Presenting.
StatusMessage_ExpiryDateTime_DateTime	String	The date and time when the user's custom status message is set to expire.
StatusMessage_ExpiryDateTime_TimeZone	String	The time zone associated with the expiration date and time of the user's status message.
StatusMessage_Message_Content	String	The text content of the user's custom status message in Microsoft Teams.
StatusMessage_PublishedDateTime	Datetime	The date and time when the user's custom status message was published.

Contains detailed profile, organizational, and directory synchronization information for users in Microsoft Teams, including contact details, licensing, job roles, and Active Directory mappings.

テーブル固有の情報

Select

Users テーブルをクエリします。Sync App は Microsoft Teams API を使用して、以下のカラムと演算子で作成されたWHERE 句条件を処理します。その他のフィルタはクライアントサイドでSync App 内部で処理されます。

• Id は、'=' 演算子をサポートします。

例えば、次のクエリはサーバーサイドで処理されます。

SELECT * FROM Users WHERE Id = '08d30c14-2775-45c9-8809-3eca47340959'

Columns

Name	Type	Description
id [KEY]	String	Unique identifier for the user in Microsoft Teams.
deletedDateTime	Datetime	Timestamp indicating when the user account was deleted, if applicable.
accountEnabled	Bool	Indicates whether the user's account is currently enabled.
assignedLicenses	String	List of product licenses currently assigned to the user.
businessPhones	String	Collection of the user's business phone numbers.
city	String	City listed in the user's organizational profile.
companyName	String	Name of the company the user is associated with.
country	String	Country or region specified in the user's profile.
createdDateTime	Datetime	Timestamp when the user account was created.
department	String	Department name listed in the user's organizational information.
displayName	String	Full name displayed for the user in Teams and other services.
employeeHireDate	Datetime	Date the user was hired, according to their employee record.
employeeId	String	Identifier assigned to the user in the employee directory.
employeeOrgData_costCenter	String	Cost center code associated with the user's organizational unit.
employeeOrgData_division	String	Division in which the user is employed within the organization.
employeeType	String	Classification of the user's employment, such as Full-time or Contractor.
givenName	String	The user's first name.
identities	String	Collection of identity records used for sign-in and directory purposes.
imAddresses	String	List of Instant Messaging (IM) addresses associated with the user.
isManagementRestricted	Bool	Indicates whether the user is restricted from being managed by others.
isResourceAccount	Bool	Specifies whether the user account is a resource account.
jobTitle	String	Job title listed in the user's profile.
lastPasswordChangeDateTime	Datetime	Timestamp of the user's most recent password change.
mail	String	Primary email address associated with the user.
mailNickname	String	Nickname used to generate the user's email address.
mobilePhone	String	User's mobile phone number.
officeLocation	String	Office building or physical location assigned to the user.
onPremisesDistinguishedName	String	User's distinguished name in the on-premises Active Directory.
onPremisesDomainName	String	Name of the on-premises domain the user is associated with.
onPremisesExtensionAttributes_extensionAttribute1	String	Custom extension attribute 1 from the on-premises Active Directory for the user.
onPremisesExtensionAttributes_extensionAttribute10	String	Custom extension attribute 10 from the on-premises Active Directory for the user.
onPremisesExtensionAttributes_extensionAttribute11	String	Custom extension attribute 11 from the on-premises Active Directory for the user.
onPremisesExtensionAttributes_extensionAttribute12	String	Custom extension attribute 12 from the on-premises Active Directory for the user.
onPremisesExtensionAttributes_extensionAttribute13	String	Custom extension attribute 13 from the on-premises Active Directory for the user.
onPremisesExtensionAttributes_extensionAttribute14	String	Custom extension attribute 14 from the on-premises Active Directory for the user.
onPremisesExtensionAttributes_extensionAttribute15	String	Custom extension attribute 15 from the on-premises Active Directory for the user.
onPremisesExtensionAttributes_extensionAttribute2	String	Custom extension attribute 2 from the on-premises Active Directory for the user.
onPremisesExtensionAttributes_extensionAttribute3	String	Custom extension attribute 3 from the on-premises Active Directory for the user.
onPremisesExtensionAttributes_extensionAttribute4	String	Custom extension attribute 4 from the on-premises Active Directory for the user.
onPremisesExtensionAttributes_extensionAttribute5	String	Custom extension attribute 5 from the on-premises Active Directory for the user.
onPremisesExtensionAttributes_extensionAttribute6	String	Custom extension attribute 6 from the on-premises Active Directory for the user.
onPremisesExtensionAttributes_extensionAttribute7	String	Custom extension attribute 7 from the on-premises Active Directory for the user.
onPremisesExtensionAttributes_extensionAttribute8	String	Custom extension attribute 8 from the on-premises Active Directory for the user.
onPremisesExtensionAttributes_extensionAttribute9	String	Custom extension attribute 9 from the on-premises Active Directory for the user.
onPremisesImmutableId	String	Unique, immutable identifier used to map the user to an on-premises Active Directory object.
onPremisesLastSyncDateTime	Datetime	Timestamp of the last directory synchronization from on-premises Active Directory to Microsoft 365.
onPremisesProvisioningErrors	String	Collection of errors encountered during the on-premises provisioning process for the user.
onPremisesSamAccountName	String	Security Account Manager (SAM) account name of the user in the on-premises Active Directory.
onPremisesSecurityIdentifier	String	Security Identifier (SID) associated with the user's on-premises Active Directory account.
onPremisesSyncEnabled	Bool	Indicates whether synchronization with the on-premises directory is enabled for the user.
onPremisesUserPrincipalName	String	User Principal Name (UPN) of the user in the on-premises environment.
otherMails	String	Collection of additional email addresses associated with the user.
passwordProfile_forceChangePasswordNextSignIn	Bool	Indicates whether the user must change their password at the next sign-in.
passwordProfile_forceChangePasswordNextSignInWithMfa	Bool	Indicates whether the user must change their password at the next sign-in using multi-factor authentication.
passwordProfile_password	String	Password value to set during user creation.
postalCode	String	Postal code or ZIP code listed in the user's address information.
preferredLanguage	String	The user's preferred language, typically used for localization and communication settings.
serviceProvisioningErrors	String	List of errors encountered during the provisioning of services for the user.
state	String	State or province listed in the user's address details.
streetAddress	String	Street-level address of the user's physical or mailing location.
surname	String	User's family name or last name.
userPrincipalName	String	The user's sign-in name, usually formatted as an email address.
userType	String
Authentication_id	String	Unique identifier for the user's authentication container.
Calendar_id	String	Unique identifier for the user's calendar.
Drive_id	String	Unique identifier for the user's OneDrive drive.
InferenceClassification_id	String	Unique identifier for the user's email classification preferences.
Insights_id	String	Unique identifier for insights related to the user, such as activity and collaboration data.
Manager_id	String	Identifier for the user's manager in the organizational directory.
Onenote_id	String	Unique identifier for the user's OneNote data container.
Outlook_id	String	Unique identifier for the user's Outlook data container.
Photo_id	String	Identifier for the user's profile photo resource.
Planner_id	String	Identifier for the user's Microsoft Planner resource.
Presence_id	String	Identifier for the user's presence data in Microsoft Teams.
Settings_id	String	Identifier for the user's settings container.
Teamwork_id	String	Identifier for the user's Microsoft Teams collaboration container.
Todo_id	String	Identifier for the user's Microsoft To Do task list.

ストアドプロシージャはファンクションライクなインターフェースで、Microsoft Teams の単純なSELECT/INSERT/UPDATE/DELETE 処理にとどまらずSync App の機能を拡張します。

ストアドプロシージャは、パラメータのリストを受け取り、目的の機能を実行し、プロシージャが成功したか失敗したかを示すとともにMicrosoft Teams から関連するレスポンスデータを返します。

Microsoft Teams Connector for CData Sync ストアドプロシージャ

Name	Description
ArchiveTeam	Archives a specified Microsoft Team, preserving content in read-only mode while preventing further edits or changes.
CreateChat	Initiates a one-on-one or group chat in Teams by specifying participants and chat metadata.
DeleteChat	Permanently removes a Teams chat thread, including all associated messages and metadata.
DeleteChatMessage	Deletes a specific message from a Teams chat, identified by message ID and chat context.
DeleteMessage	Removes a message from a Teams channel conversation, typically used for moderation or compliance.
FetchAdditionalUserFields	Pulls extended profile data (T1, T2, T3 fields) for a specific Teams user for reporting or personalization.
GetAdminConsentURL	Creates a secure admin authorization link for granting delegated or application permissions to Teams-based apps.
GetAttachmentContentUrl	Retrieves a direct-access URL for a file attachment from a Teams chat message for downloading or embedding.
GetChannelFile	Returns the contents of a file when provided the file URL or the ID information to find the file. Can be returned as either a BASE64 blob or a file
GetUserActivityCount	Returns statistics on user engagement in Teams, broken down by activities like chat messages, meeting participation, and calls.
SendChatMessage	Sends a new message to a specified chat thread in Microsoft Teams, supporting text and rich content.
SendMessage	Posts a message to a Teams channel, optionally including formatting, mentions, and embedded content.
ShareSchedule	Publishes pending changes in a Teams schedule, such as shifts or time-off entries, making them visible to team members.
UnArchiveTeam	Reactivates an archived Microsoft Team, restoring full editing capabilities and collaboration access.
UpdateChat	Modifies properties of a Teams chat, such as adding participants or changing the topic name.
UpdateChatMessage	Updates the content of an existing Teams chat message, allowing corrections or content changes.
UpdateMessage	Revises an existing message in a Teams channel to reflect new information or correct errors.

Archives a specified Microsoft Team, preserving content in read-only mode while preventing further edits or changes.

Input

Name	Type	Required	Description
TeamId	String	True	Unique identifier of the Microsoft Team that will be archived.
ShouldSetSPOSiteReadOnlyForMembers	String	False	Optional flag indicating whether to restrict team members' access to read-only on the associated SharePoint Online site. If set to false or omitted, permissions remain unchanged.

Result Set Columns

Name	Type	Description
Status	String	Indicates the result of the archive operation, such as success or failure.

Initiates a one-on-one or group chat in Teams by specifying participants and chat metadata.

Input

Name	Type	Required	Description
ChatType	String	True	Defines the type of chat to create. Valid values are group for multi-user conversations and oneOnOne for direct messages between two users.
Members	String	True	Comma-separated list of user IDs to include in the chat. Ensure each user ID is valid and separated by a comma and a space.
Topic	String	False	Optional title for the chat. Only applicable if the chat type is group; ignored for oneOnOne chats.

Result Set Columns

Name	Type	Description
Success	String	Indicates whether the chat creation process completed successfully.

Permanently removes a Teams chat thread, including all associated messages and metadata.

Input

Name	Type	Required	Description
ChatId	String	True	Unique identifier of the chat to be deleted. This must reference an existing oneOnOne or group chat.

Result Set Columns

Name	Type	Description
Success	String	Indicates whether the chat deletion was completed successfully.

Deletes a specific message from a Teams chat, identified by message ID and chat context.

Input

Name	Type	Required	Description
UserId	String	True	Unique identifier of the user attempting to delete the message. Used to verify permissions and track audit logs.
ChatId	String	True	Unique identifier of the chat where the message was posted. Helps locate the message within the correct conversation.
MessageId	String	True	Unique identifier of the message to be deleted. Required to accurately target the message within the chat.

Result Set Columns

Name	Type	Description
Success	String	Indicates whether the message was successfully deleted from the chat. Returns true if successful, false otherwise.

Removes a message from a Teams channel conversation, typically used for moderation or compliance.

Input

Name	Type	Required	Description
TeamId	String	True	Unique identifier of the team where the message exists. Used to ensure the operation targets the correct Microsoft Teams environment.
ChannelId	String	True	Unique identifier of the channel within the team where the message is posted. Required to locate the message contextually.
MessageId	String	True	Unique identifier of the message to be deleted. Ensures precise targeting of the message in the specified channel.

Result Set Columns

Name	Type	Description
Success	String	Indicates whether the message was successfully deleted. Returns true if the deletion was successful, otherwise false.

Pulls extended profile data (T1, T2, T3 fields) for a specific Teams user for reporting or personalization.

Input

Name	Type	Required	Description
UserId	String	True	Unique identifier of the user whose additional information is being requested. Required to scope the data fetch.
IncludeFields	String	False	Comma-separated list of specific user fields to include in the result. Example: jobTitle, department, location.
ExcludeFields	String	False	Comma-separated list of specific user fields to exclude from the result. Example: mobilePhone, officeLocation.

Result Set Columns

Name	Type	Description
*	String	Complete set of user data returned by the query, shaped according to the include and exclude filters applied.

Creates a secure admin authorization link for granting delegated or application permissions to Teams-based apps.

Input

Name	Type	Required	Description
CallbackUrl	String	False	The URL to which the user is redirected after granting admin consent. This must exactly match the Reply URL configured in the Azure Active Directory app registration.
State	String	False	Opaque string value used to maintain state between the request and callback. Useful for preventing cross-site request forgery attacks and preserving user session.
Scope	String	False	Space-separated list of permissions the application is requesting admin consent for. Example: User.Read Group.ReadWrite.All Directory.Read.All. デフォルト値はhttps://graph.microsoft.com/group.read.all https://graph.microsoft.com/group.readwrite.all https://graph.microsoft.com/user.read.all https://graph.microsoft.com/appcatalog.readwrite.all https://graph.microsoft.com/presence.read.all https://graph.microsoft.com/chat.read https://graph.microsoft.com/channelmessage.read.all https://graph.microsoft.com/chat.readbasic https://graph.microsoft.com/chat.readwriteです。

Result Set Columns

Name	Type	Description
URL	String	Generated authorization URL that must be opened in a browser to prompt the admin for consent and obtain the verifier token.

Retrieves a direct-access URL for a file attachment from a Teams chat message for downloading or embedding.

Input

Name	Type	Required	Description
ChatId	String	True	Unique identifier of the chat that contains the message with the attachment. Used to locate the context of the request.
AttachmentId	String	False	Unique identifier of the attachment whose content URL is being retrieved. This field is not server-side filterable.

Result Set Columns

Name	Type	Description
ContentUrl	String	Direct URL to access the attachment content that was shared in the specified chat.
Success	String	Indicates whether the operation to retrieve the attachment content URL was successful. Returns true if successful, false otherwise.

Returns the contents of a file when provided the file URL or the ID information to find the file. Can be returned as either a BASE64 blob or a file

Input

Name	Type	Required	Description
DownloadUrl	String	False	The URL provided by the ChannelFiles table as DownloadUrl. If not available, the drive ID and channel ID can be provided instead
DriveId	String	False	The ID of the drive containing the file that can be retrieved from the ChannelDrive table. Must be provided in combination with the Item ID if the DownloadURL is not provided. If provided in combination with DownloadURL and ItemId, a new DownLoadURL can be procured if the old link expires
FileId	String	False	The ID of the file to download that can be retrieved from the ChannelFiles table. Must be provided in combination with the Drive ID if the DownloadURL is not provided. If provided in combination with DownloadURL and DriveId, a new DownLoadURL can be procured if the old link expires.
DownloadTo	String	False	Full path where the downloaded file is saved. If not specified, the file content is returned as output.
Encoding	String	False	Encoding format used for the FileData input, such as Base64. 使用できる値は次のとおりです。NONE, BASE64 デフォルト値はBASE64です。

Result Set Columns

Name	Type	Description
Status	String	Indicates whether the report was generated successfully. Returns true if successful, false otherwise.
FileData	String	Contains the full contents of the file as either a BASE64 blob or a file.

Gets an authentication token from MSTeams.

Input

Name	Type	Required	Description
AuthMode	String	False	The type of authentication mode to use. Select App for getting authentication tokens via a desktop app. Select Web for getting authentication tokens via a Web app. 使用できる値は次のとおりです。APP, WEB デフォルト値はAPPです。
Scope	String	False	A space-separated list of permissions to request from the user when OAuthGrantType='CODE'. Please check the Microsoft Graph API for a list of available permissions. When OAuthGrantType='CLIENT', a scope of 'https://graph.microsoft.com/.default' is used. '/.default' picks up whatever permissions your app already has. デフォルト値はoffline_access https://graph.microsoft.com/.defaultです。
CallbackUrl	String	False	The URL the user will be redirected to after authorizing your application. This value must match the Reply URL you have specified in the Azure AD app settings.
Verifier	String	False	The verifier returned from Azure AD after the user has authorized your app to have access to their data. This value will be returned as a parameter to the callback URL.
State	String	False	An arbitrary string of your choosing that is returned to your app; a successful roundtrip of this string helps ensure that your app initiated the request.
Prompt	String	False	Defaults to 'select_account' which prompts the user to select account while authenticating. Set to 'None', for no prompt, 'login' to force user to enter their credentials or 'consent' to trigger the OAuth consent dialog after the user signs in, asking the user to grant permissions to the app.

Result Set Columns

Name	Type	Description
OAuthAccessToken	String	The access token used for communication with MSTeams.
ExpiresIn	String	The remaining lifetime on the access token. A -1 denotes that it will not expire.
OAuthRefreshToken	String	Refresh token to renew the access token.

Gets the authorization URL that must be opened separately by the user to grant access to your application. Only needed when developing Web apps. You will request the auth token from this URL.

Input

Name	Type	Required	Description
CallbackUrl	String	False	The URL the user will be redirected to after authorizing your application. This value must match the Reply URL in the Azure AD app settings.
State	String	False	The same value for state that you sent when you requested the authorization code.
Scope	String	False	A space-separated list of permissions to request from the user when OAuthGrantType='CODE'. Please check the Microsoft Graph API for a list of available permissions. When OAuthGrantType='CLIENT', a scope of 'https://graph.microsoft.com/.default' is used. '/.default' picks up whatever permissions your app already has. デフォルト値はoffline_access https://graph.microsoft.com/.defaultです。
Prompt	String	False	Defaults to 'select_account' which prompts the user to select account while authenticating. Set to 'None', for no prompt, 'login' to force user to enter their credentials or 'consent' to trigger the OAuth consent dialog after the user signs in, asking the user to grant permissions to the app.

Result Set Columns

Name	Type	Description
URL	String	The authorization URL, entered into a Web browser to obtain the verifier token and authorize your app.

Returns statistics on user engagement in Teams, broken down by activities like chat messages, meeting participation, and calls.

Input

Name	Type	Required	Description
Duration	String	True	Number of days to include in the user activity report. Determines the reporting period for activity data. 使用できる値は次のとおりです。D7, D30, D90, D180
FileLocation	String	False	Full path where the downloaded CSV report should be saved. Used when writing the report directly to disk.
Encoding	String	False	Text encoding format used for the output report file. Examples include UTF-8, ASCII, or UTF-16. 使用できる値は次のとおりです。NONE, BASE64 デフォルト値はBASE64です。

Result Set Columns

Name	Type	Description
Success	String	Indicates whether the report was generated successfully. Returns true if successful, false otherwise.
FileData	String	Contains the full contents of the generated report file if FileLocation and FileStream are not provided.

Refreshes the OAuth access token used for authentication with various MSTeams services.

Input

Name	Type	Required	Description
OAuthRefreshToken	String	True	The refresh token returned from the original authorization code exchange.

Result Set Columns

Name	Type	Description
OAuthAccessToken	String	The authentication token returned from Azure AD. This can be used in subsequent calls to other operations for this particular service.
OAuthRefreshToken	String	A token that may be used to obtain a new access token.
ExpiresIn	String	The remaining lifetime on the access token.

Sends a new message to a specified chat thread in Microsoft Teams, supporting text and rich content.

Input

Name	Type	Required	Description
ChatId	String	True	Unique identifier of the chat where the message is sent. Required to route the message to the correct conversation.
ContentType	String	False	Format of the message content to be sent. Common values include text, html, and markdown.
Content	String	True	Main body of the message to be sent in the chat, formatted according to the specified ContentType.
Importance	String	False	Priority level of the message. Default is normal. 使用できる値は次のとおりです。normal, high, urgent
Mention	String	False	Comma-separated MentionText and MentionUserId pairs. For multiple mentions, use semicolons to separate pairs. Example: MentionText1, MentionUserId1; MentionText2, MentionUserId2.
Attachment	String	False	Comma-separated AttachmentContentType and AttachmentContentUrl pairs. For multiple attachments, use semicolons to separate pairs. Example: AttachmentContentType1, AttachmentContentUrl1; AttachmentContentType2, AttachmentContentUrl2.

Result Set Columns

Name	Type	Description
Success	String	Indicates whether the message was successfully sent to the chat. Returns true if successful, false otherwise.

Posts a message to a Teams channel, optionally including formatting, mentions, and embedded content.

Input

Name	Type	Required	Description
TeamId	String	True	Unique identifier of the team where the message is sent. Required to route the message to the correct Microsoft Teams group.
ChannelId	String	True	Unique identifier of the channel within the team where the message is posted.
MessageId	String	False	Unique identifier of the message to be updated. Used when modifying an existing message.
ContentType	String	False	Format of the message content. Common values include text, html, and markdown.
Content	String	True	Body of the message to be sent or updated in the specified channel, formatted according to the ContentType.
Importance	String	False	Priority level of the message. The default value is normal. 使用できる値は次のとおりです。normal, high, urgent
Mention	String	False	Comma-separated MentionText and MentionUserId pairs. For multiple mentions, use semicolons to separate each pair. Example: MentionText1, MentionUserId1; MentionText2, MentionUserId2.
Attachment	String	False	Comma-separated AttachmentContentType and AttachmentContentUrl pairs. For multiple attachments, use semicolons to separate each pair. Example: AttachmentContentType1, AttachmentContentUrl1; AttachmentContentType2, AttachmentContentUrl2.

Result Set Columns

Name	Type	Description
Success	String	Indicates whether the message was successfully sent or updated. Returns true if the operation completed successfully, otherwise false.

Publishes pending changes in a Teams schedule, such as shifts or time-off entries, making them visible to team members.

Input

Name	Type	Required	Description
TeamId	String	True	Unique identifier of the team whose schedule is being shared. Required to target the correct Microsoft Teams group.
NotifyTeam	String	True	Specifies whether to notify the entire team or only the users with assigned shifts. If true, all team members receive a visible notification.
StartDateTime	String	True	Start date and time from which to share shifts on the team's schedule. Defines the beginning of the sharing window.
EndDateTime	String	True	End date and time until which shifts are shared on the schedule. Defines the end of the sharing window.

Result Set Columns

Name	Type	Description
Success	String	Indicates whether the schedule was successfully shared. Returns true if successful, otherwise false.

Reactivates an archived Microsoft Team, restoring full editing capabilities and collaboration access.

Input

Name	Type	Required	Description
TeamId	String	True	Unique identifier of the Microsoft Teams team that should be restored from an archived state.

Result Set Columns

Name	Type	Description
Status	String	Indicates whether the unarchive operation was successful. Returns a status message or code reflecting the result.

Modifies properties of a Teams chat, such as adding participants or changing the topic name.

Input

Name	Type	Required	Description
ChatId	String	True	Unique identifier of the chat to be updated. Required to locate the chat instance.
Topic	String	True	New title for the chat. This value can only be set if the chat is a group chat, not a one-on-one conversation.

Result Set Columns

Name	Type	Description
Success	String	Indicates whether the chat update operation was successful. Returns true if the update completed without errors.

Updates the content of an existing Teams chat message, allowing corrections or content changes.

Input

Name	Type	Required	Description
ChatId	String	True	Unique identifier of the chat that contains the message to be updated. Required to locate the correct conversation.
MessageId	String	True	Unique identifier of the message to be updated within the specified chat.
ContentType	String	False	Format of the message content. Supported values include text, html, and markdown.
Content	String	False	New content to replace the existing message body. Must match the specified ContentType.
Importance	String	False	Priority level of the message. Accepted values include low, normal, and high.
Mention	String	False	Comma-separated MentionText and MentionUserId pairs. For multiple mentions, use semicolons to separate pairs. Example: MentionText1, MentionUserId1; MentionText2, MentionUserId2.
PolicyViolation	String	False	JSON object defining the properties of a policy violation. Only applicable when the update is performed using application permissions.

Result Set Columns

Name	Type	Description
Success	String	Indicates whether the message update operation was successful. Returns true if completed without errors.

Revises an existing message in a Teams channel to reflect new information or correct errors.

Input

Name	Type	Required	Description
TeamId	String	True	Unique identifier of the Microsoft Teams team that contains the message to be updated.
ChannelId	String	True	Unique identifier of the channel within the specified team where the message is located.
MessageId	String	True	Unique identifier of the message to be updated within the specified channel.
ContentType	String	False	Format of the message content. Accepted values include text, html, and markdown.
Content	String	False	New content that replaces the current message body. Must be compatible with the specified ContentType.
Importance	String	False	Priority level of the message. Valid values include low, normal, and high.
Mention	String	False	Comma-separated MentionText and MentionUserId pairs. For multiple mentions, use semicolons to separate pairs. Example: MentionText1, MentionUserId1; MentionText2, MentionUserId2.
PolicyViolation	String	False	JSON object describing the properties of a policy violation. Required only when using application permissions and enforcing compliance rules.

Result Set Columns

Name	Type	Description
Success	String	Indicates whether the message update operation completed successfully. Returns true if the update was successful, otherwise false.

接続文字列プロパティは、接続を確立するために使用できるさまざまなオプションです。このセクションでは、本プロバイダーの接続文字列で設定できるオプションの一覧を示します。詳細については各リンクをクリックしてください。

接続を確立する方法について詳しくは、接続の確立を参照してください。

Authentication

---

プロパティ	説明
AuthScheme	Microsoft Teams に接続する際に使用する認証の種類を指定します。このプロパティが空白の場合は、デフォルトの認証が使用されます。
MsAppActsAsUserId	Specifies the Microsoft Entra ID (GUID) of the user the application should impersonate when authenticating with a service principal.

Azure Authentication

---

プロパティ	説明
AzureTenant	データにアクセスするために使用されているMicrosoft Teams テナントを識別します。テナントのドメイン名（例： contoso.onmicrosoft.com ）またはディレクトリ（テナント）ID のいずれかを受け付けます。
AzureEnvironment	接続するAzure ネットワーク環境を指定します。Azure アカウントが追加されたネットワークと同じである必要があります。

OAuth

---

プロパティ	説明
OAuthClientId	カスタムOAuth アプリケーションに割り当てられたクライアントID（コンシューマーキーとも呼ばれます）を指定します。このID は、認証時にOAuth 認可サーバーにアプリケーションを識別させるために必要です。
OAuthClientSecret	カスタムOAuth アプリケーションに割り当てられたクライアントシークレットを指定します。この機密情報は、OAuth 認可サーバーに対してアプリケーションを認証するために使用されます。（カスタムOAuth アプリケーションのみ）
Scope	データへの適切なアクセスを確実にするために、認証ユーザーのアプリケーションへのアクセス範囲を指定します。 カスタムOAuth アプリケーションが必要な場合は、通常、アプリケーションの作成時に指定します。

JWT OAuth

---

プロパティ	説明
OAuthJWTCert	クライアント証明書のJWT 証明書ストアの名前を指定します。
OAuthJWTCertType	JWT 証明書を格納しているキーストアの種類を指定します。
OAuthJWTCertPassword	パスワードで保護された証明書ストアにアクセスするために使用されるOAuth JWT 証明書のパスワードを指定します。証明書ストアがパスワードを必要としない場合は、このプロパティを空白のままにします。
OAuthJWTCertSubject	ストアで一致する証明書を検索するために使用される、OAuth JWT 証明書のサブジェクトを指定します。部分一致と、先頭の証明書を選択するためのワイルドカード '*' をサポートします。

SSL

---

プロパティ	説明
SSLServerCert	TLS/SSL を使用して接続する際に、サーバーが受け入れ可能な証明書を指定します。

Firewall

---

プロパティ	説明
FirewallType	provider がプロキシベースのファイアウォールを介してトラフィックをトンネリングするために使用するプロトコルを指定します。
FirewallServer	ファイアウォールを通過し、ユーザーのクエリをネットワークリソースに中継するために使用されるプロキシのIP アドレス、DNS 名、またはホスト名を識別します。
FirewallPort	プロキシベースのファイアウォールで使用するTCP ポートを指定します。
FirewallUser	プロキシベースのファイアウォールに認証するアカウントのユーザーID を識別します。
FirewallPassword	プロキシベースのファイアウォールで認証するユーザーアカウントのパスワードを指定します。

Proxy

---

プロパティ	説明
ProxyAutoDetect	provider が、手動で指定されたプロキシサーバーを使用するのではなく、既存のプロキシサーバー構成についてシステムプロキシ設定をチェックするかどうかを指定します。
ProxyServer	HTTP トラフィックをルートするプロキシサーバーのホストネームもしくはIP アドレスを指定します。
ProxyPort	クライアントとの間でHTTP トラフィックをルーティングするために予約された、指定されたプロキシサーバーのTCP ポートを指定します。
ProxyAuthScheme	ProxyServer 接続プロパティで指定されたプロキシサーバーに対して認証する際にprovider が使用する認証方法を指定します。
ProxyUser	ProxyServer 接続プロパティで指定されたプロキシサーバーに登録されているユーザーアカウントのユーザー名を提供します。
ProxyPassword	ProxyUser 接続プロパティで指定されたユーザーのパスワードを指定します。
ProxySSLType	ProxyServer 接続プロパティで指定されたプロキシサーバーに接続する際に使用するSSL タイプを指定します。
ProxyExceptions	ProxyServer 接続プロパティで設定されたプロキシサーバー経由での接続が免除される宛先ホスト名またはIP のセミコロン区切りのリストを指定します。

Logging

---

プロパティ	説明
LogModules	ログファイルに含めるコアモジュールを指定します。セミコロンで区切られたモジュール名のリストを使用します。デフォルトでは、すべてのモジュールがログに記録されます。

Schema

---

プロパティ	説明
Location	テーブル、ビュー、およびストアドプロシージャを定義するスキーマファイルを格納するディレクトリの場所を指定します。サービスの要件に応じて、これは絶対パスまたは相対パスのいずれかで表されます。
BrowsableSchemas	レポートされるスキーマを利用可能なすべてのスキーマのサブセットに制限するオプション設定。例えば、 BrowsableSchemas=SchemaA,SchemaB,SchemaC です。
Tables	レポートされるテーブルを利用可能なすべてのテーブルのサブセットに制限するオプション設定。例えば、 Tables=TableA,TableB,TableC です。
Views	レポートされたビューを使用可能なテーブルのサブセットに制限するオプション設定。例えば、 Views=ViewA,ViewB,ViewC です。

Miscellaneous

---

プロパティ	説明
DefaultGroups	Determines whether to use the /me/memberOf or /groups endpoint for user authentication.
DefaultUser	Determines whether to use the /me or /users endpoint for user authentication.
GroupId	Specify a default GroupId.
IncludeAllGroups	Specifies whether the provider returns all Microsoft 365 Groups in your organization or only those the authenticated user is a member of.
MaxRows	集計やGROUP BY を含まないクエリで返される最大行数を指定します。
Other	特定の問題に対処するため、特殊なシナリオ向けの高度な接続プロパティを指定します。このプロパティは、サポートチームの指示がある場合にのみ使用してください。
Pagesize	Specifies the maximum number of records the provider retrieves per page when querying Microsoft Teams data.
PseudoColumns	テーブルカラムとして公開する擬似カラムを、'TableName=ColumnName;TableName=ColumnName' の形式の文字列で指定します。
Timeout	provider がタイムアウトエラーを返すまでにサーバーからの応答を待機する最大時間を秒単位で指定します。
UserDefinedViews	カスタムビューを定義するJSON 構成ファイルへのファイルパスを指定します。provider は、このファイルで指定されたビューを自動的に検出して使用します。
UserId	Specify a default UserId.

このセクションでは、本プロバイダーの接続文字列で設定可能なAuthentication プロパティの全リストを提供します。

---

プロパティ	説明
AuthScheme	Microsoft Teams に接続する際に使用する認証の種類を指定します。このプロパティが空白の場合は、デフォルトの認証が使用されます。
MsAppActsAsUserId	Specifies the Microsoft Entra ID (GUID) of the user the application should impersonate when authenticating with a service principal.

Microsoft Teams に接続する際に使用する認証の種類を指定します。このプロパティが空白の場合は、デフォルトの認証が使用されます。

解説

AuthScheme には以下が含まれます。

• AzureAD（デフォルト）：Azure Active Directory（ユーザーベース）のOAuth 認証を実行します。
• AzureMSI：Azure VM で実行している際に、Azure AD マネージドサービスID の資格情報を自動的に取得します。
• AzureServicePrincipal：クライアントシークレットを使用してAzure サービスプリンシパル（ロールベース、アプリケーションベース）として認証します。
• AzureServicePrincipalCert：証明書を使用してAzure サービスプリンシパル（ロールベース、アプリケーションベース）として認証します。

Azure AD で認証するためのカスタムアプリケーションの作成方法については、Entra ID（Azure AD）アプリケーションの作成 を参照してください。

Azure AD サービスプリンシパルで認証するためのカスタムアプリケーションの作成方法については、Entra ID（Azure AD）でのサービスプリンシパルアプリの作成 を参照してください。

Specifies the Microsoft Entra ID (GUID) of the user the application should impersonate when authenticating with a service principal.

解説

This property is required when using the AzureServicePrincipal or AzureServicePrincipalCert authentication schemes and the Sync App needs to act on behalf of a specific user.

Set this property to the Microsoft Entra ID object ID (GUID) of the user whose schedule data the application needs to access.

You must specify this property when querying the following tables:

• OpenShifts
• SchedulingGroups
• Shifts
• Schedules
• TimeOffReasons
• TimesOff

You must also specify this property when executing the ShareSchedule stored procedure.

Use this property when your application requires delegated access to user-specific Teams scheduling data in an Azure service principal authentication context.

このセクションでは、本プロバイダーの接続文字列で設定可能なAzure Authentication プロパティの全リストを提供します。

---

プロパティ	説明
AzureTenant	データにアクセスするために使用されているMicrosoft Teams テナントを識別します。テナントのドメイン名（例： contoso.onmicrosoft.com ）またはディレクトリ（テナント）ID のいずれかを受け付けます。
AzureEnvironment	接続するAzure ネットワーク環境を指定します。Azure アカウントが追加されたネットワークと同じである必要があります。

データにアクセスするために使用されているMicrosoft Teams テナントを識別します。テナントのドメイン名（例： contoso.onmicrosoft.com ）またはディレクトリ（テナント）ID のいずれかを受け付けます。

解説

テナントとは、Microsoft Entra ID（旧称：Azure AD）を通じて管理される、組織のユーザーやリソースのためのデジタルコンテナです。 各テナントには一意のディレクトリID が関連付けられており、多くの場合、カスタムドメイン（例：microsoft.com やcontoso.onmicrosoft.com）も関連付けられています。

Microsoft Entra 管理センターでディレクトリ（テナント）ID を確認するには、Microsoft Entra ID -> プロパティに移動し、「ディレクトリ（テナント）ID」と表示されている値をコピーします。

このプロパティは以下の場合に必要です。

• AuthScheme がAzureServicePrincipal またはAzureServicePrincipalCert に設定されている場合
• AuthScheme がAzureAD で、ユーザーアカウントが複数のテナントに属している場合

テナントの値は、2つの形式のいずれかで指定できます。

• ドメイン名（例：contoso.onmicrosoft.com）
• GUID 形式のディレクトリ（テナント）ID（例：c9d7b8e4-1234-4f90-bc1a-2a28e0f9e9e0）

テナントを明示的に指定することで、認証リクエストが正しいディレクトリにルーティングされるようになります。これは、ユーザーが複数のテナントに所属している場合や、サービスプリンシパルベースの認証を使用する場合に特に重要です。

この値が必要な場面で省略されると、認証に失敗したり、誤ったテナントに接続されたりする可能性があります。その結果、認可されていないまたはリソースが見つからないといったエラーが発生する可能性があります。

接続するAzure ネットワーク環境を指定します。Azure アカウントが追加されたネットワークと同じである必要があります。

解説

Azure アカウントがGlobal ネットワークとは異なるネットワーク（China、USGOVT、USGOVTDOD など）の一部である場合は、必要です。

このセクションでは、本プロバイダーの接続文字列で設定可能なOAuth プロパティの全リストを提供します。

---

プロパティ	説明
OAuthClientId	カスタムOAuth アプリケーションに割り当てられたクライアントID（コンシューマーキーとも呼ばれます）を指定します。このID は、認証時にOAuth 認可サーバーにアプリケーションを識別させるために必要です。
OAuthClientSecret	カスタムOAuth アプリケーションに割り当てられたクライアントシークレットを指定します。この機密情報は、OAuth 認可サーバーに対してアプリケーションを認証するために使用されます。（カスタムOAuth アプリケーションのみ）
Scope	データへの適切なアクセスを確実にするために、認証ユーザーのアプリケーションへのアクセス範囲を指定します。 カスタムOAuth アプリケーションが必要な場合は、通常、アプリケーションの作成時に指定します。

カスタムOAuth アプリケーションに割り当てられたクライアントID（コンシューマーキーとも呼ばれます）を指定します。このID は、認証時にOAuth 認可サーバーにアプリケーションを識別させるために必要です。

解説

このプロパティは2つのケースで必要となります：

• カスタムOAuth アプリケーションを使用する場合。たとえば、Web ベースの認証フロー、サービスベースの認証、またはアプリケーションの登録が必要な証明書ベースのフローなどが該当します。
• ドライバーが埋め込みOAuth 資格情報を提供しない場合。

（ドライバーが埋め込みOAuth 資格情報を提供する場合、この値はすでにSync App によって設定されており、手動で入力する必要がないことがあります。）

OAuthClientId は、認証付きの接続を構成する際に、OAuthClientSecret やOAuthSettingsLocation などの他のOAuth 関連プロパティと一緒に使用されるのが一般的です。

OAuthClientId は、ユーザーがOAuth 経由で認証を行う前に設定する必要がある、主要な接続パラメータの1つです。 この値は、通常、ID プロバイダーのアプリケーション登録設定で確認できます。 Client ID、Application ID、Consumer Key などとラベル付けされた項目を探してください。

クライアントID は、クライアントシークレットのような機密情報とは見なされませんが、アプリケーションの識別情報の一部であるため、慎重に取り扱う必要があります。公開リポジトリや共有設定ファイルでこの値を露出させないようにしてください。

接続設定時にこのプロパティを使用する方法の詳細については、接続の確立 を参照してください。

カスタムOAuth アプリケーションに割り当てられたクライアントシークレットを指定します。この機密情報は、OAuth 認可サーバーに対してアプリケーションを認証するために使用されます。（カスタムOAuth アプリケーションのみ）

解説

このプロパティ（アプリケーションシークレットまたはコンシューマシークレットとも呼ばれます）は、安全なクライアント認証を必要とするすべてのフローでカスタムOAuth アプリケーションを使用する場合に必要です。たとえば、Web ベースのOAuth、サービスベースの接続、証明書ベースの認可フローなどが該当します。 組み込みOAuth アプリケーションを使用する場合は必要ありません。

クライアントシークレットは、OAuth フローのトークン交換ステップで使用されます。このステップでは、ドライバーが認可サーバーにアクセストークンを要求します。 この値が欠落しているか正しくない場合、認証はinvalid_client またはunauthorized_client エラーで失敗します。

OAuthClientSecret は、ユーザーがOAuth 経由で認証を行う前に設定する必要がある、主要な接続パラメータの1つです。この値は、OAuth アプリケーションを登録する際にID プロバイダーから取得できます。

Notes：

• この値は安全に保管し、公開リポジトリやスクリプト、安全でない環境では決して公開しないようにしてください。
• クライアントシークレットは、一定期間が経過すると有効期限が切れる場合もあります。 アクセスを中断させないために、有効期限を常に監視し、必要に応じてシークレットをローテーションするようにしてください。

接続設定時にこのプロパティを使用する方法の詳細については、接続の確立 を参照してください。

データへの適切なアクセスを確実にするために、認証ユーザーのアプリケーションへのアクセス範囲を指定します。 カスタムOAuth アプリケーションが必要な場合は、通常、アプリケーションの作成時に指定します。

解説

スコープは、認証ユーザーがどのようなアクセス権を持つかを定義するために設定されます。例えば、読み取り、読み取りと書き込み、機密情報への制限付きアクセスなどです。システム管理者は、スコープを使用して機能またはセキュリティクリアランスによるアクセスを選択的に有効化できます。

InitiateOAuth がGETANDREFRESH に設定されている場合、要求するスコープを変更したい場合はこのプロパティを使用する必要があります。

InitiateOAuth がREFRESH またはOFF のいずれかに設定されている場合、このプロパティまたはScope 入力を使用して、要求するスコープを変更できます。

このセクションでは、本プロバイダーの接続文字列で設定可能なJWT OAuth プロパティの全リストを提供します。

---

プロパティ	説明
OAuthJWTCert	クライアント証明書のJWT 証明書ストアの名前を指定します。
OAuthJWTCertType	JWT 証明書を格納しているキーストアの種類を指定します。
OAuthJWTCertPassword	パスワードで保護された証明書ストアにアクセスするために使用されるOAuth JWT 証明書のパスワードを指定します。証明書ストアがパスワードを必要としない場合は、このプロパティを空白のままにします。
OAuthJWTCertSubject	ストアで一致する証明書を検索するために使用される、OAuth JWT 証明書のサブジェクトを指定します。部分一致と、先頭の証明書を選択するためのワイルドカード '*' をサポートします。

クライアント証明書のJWT 証明書ストアの名前を指定します。

解説

OAuthJWTCertType フィールドは、OAuthJWTCert により指定された証明書ストアの種類を指定します。 ストアがパスワードで保護されている場合は、OAuthJWTCertPassword を使用してパスワードを指定します。

OAuthJWTCert は、OAuthJWTCertSubject フィールドとともにクライアント証明書を指定するために使われます。 OAuthJWTCert に値が設定され、かつOAuthJWTCertSubject が設定されている場合、CData Sync App は証明書の検索を開始します。 詳しくは、OAuthJWTCertSubject を参照してください。

証明書ストアの指定はプラットフォームに依存します。

注記

• Windows の共通のユーザーとシステム証明書ストアは以下のとおりです。
  • MY：個人証明書と関連付けられた秘密キーを 格納している証明書ストア。
  • CA：証明機関の証明書。
  • ROOT：ルート証明書。
  • SPC：ソフトウェア発行元証明書。
• Javaでは、証明書ストアは通常、証明書および 任意の秘密キーを含むファイルです。
• 証明書ストアの種類がPFXFile の場合は、 このプロパティにファイル名を設定します。
• PFXBlob の場合は、このプロパティをPFX ファイルのバイナリコンテンツ（例えば、PKCS12証明書ストア）に設定する必要があります。

JWT 証明書を格納しているキーストアの種類を指定します。

解説

値	説明	注記
USER	現在のユーザーが所有する証明書ストア。	Windows のみ使用可能です。
MACHINE	マシンストア。	Java やその他の非Windows 環境では使用できません。
PFXFILE	証明書を含むPFX（PKCS12）ファイル。
PFXBLOB	PFX（PKCS12）形式の証明書ストアをbase-64 でエンコードした文字列。
JKSFILE	証明書を含むJava キーストア（JKS）ファイル。	Java 専用。
JKSBLOB	Java キーストア（JKS）形式の証明書ストアをbase-64 でエンコードした文字列。	Java 専用。
PEMKEY_FILE	秘密鍵とオプションの証明書を含むPEM でエンコードされたファイル。
PEMKEY_BLOB	秘密鍵とオプションの証明書をbase-64 でエンコードした文字列。
PUBLIC_KEY_FILE	PEM またはDER でエンコードされた公開鍵証明書を含むファイル。
PUBLIC_KEY_BLOB	PEM またはDER でエンコードされた公開鍵証明書をbase-64 でエンコードした文字列。
SSHPUBLIC_KEY_FILE	SSH 形式の公開鍵を含むファイル。
SSHPUBLIC_KEY_BLOB	SSH 形式の公開鍵ををbase-64 でエンコードした文字列。
P7BFILE	証明書を含むPKCS7 ファイル。
PPKFILE	PuTTY 秘密キー（PPK）を含むファイル。
XMLFILE	XML 形式の証明書を含むファイル。
XMLBLOB	XML 形式の証明書を含む文字列。
BCFKSFILE	Bouncy Castle キーストアを含むファイル。
BCFKSBLOB	Bouncy Castle キーストアを含む文字列（base-64エンコード）。