Teams の [ビルド] タブ
タブとは、Microsoft Teams に組み込まれている Teams 対応 Web ページです。 これらは、アプリ マニフェストで宣言されたドメインを指す単純な HTML <iframe/>
タグであり、個々のユーザーのチーム、グループ チャット、または個人用アプリ内のチャネルの一部として追加できます。 アプリにカスタム タブを含めて独自の Web コンテンツを Teams に埋め込んだり、Teams 固有の機能を Web コンテンツに追加したりできます。 詳細については、「 Teams JavaScript クライアント ライブラリ」を参照してください。
重要
現在、カスタム タブは Government Community Cloud (GCC)、GCC-High、国防総省 (DOD) で使用できます。
次の画像は、個人用タブを示しています:
次の画像は、Contoso チャネル タブを示しています:
タブを操作する前に実行する必要がある前提条件はほとんどありません。
Teams には、個人用タブとチャネル タブ、またはグループ タブの 2 種類があります。 個人用タブは、個人を対象としたボットと共に、個人用アプリの一部であり、1 人のユーザーを対象としています。 簡単にアクセスできるように、左側のナビゲーション バーにピン留めすることができます。 チャネル/グループ タブは、コンテンツをチャネルやグループのチャットに配信します。また、専用の Web ベースのコンテンツまわりに関する共同作業スペースを作成するのに優れた方法です。
コンテンツ ページの作成は、個人用タブ、チャネルまたはグループ タブ、またはタスク モジュールの一部として行えます。 ユーザーが Microsoft Teams アプリを構成し、それを使用してチャネルまたはグループ チャット タブ、メッセージング拡張機能、またはコネクタ カードをMicrosoft 365 グループ用に構成できるようにする構成ページを作成できます。 インストール後にユーザーがタブを再構成することを許可し、アプリケーションのタブ削除ページを作成できます。 タブを含む Teams アプリをビルドする場合は、Android と iOS の両方の Teams クライアントでタブが機能する方法をテストする必要があります。 タブは、基本情報、ロケールとテーマ情報、および entityId
または タブにあるものを特定する subEntityId
を通してコンテンツを取得する必要があります。
アダプティブ カードを使用してタブを構築し、ボットとタブに別のバックエンドを必要としなくても、すべての Teams アプリ機能を一元化できます。 ステージ ビューは、Teams で全画面表示で開かれ、タブとしてピン留めされるコンテンツをレンダリングできる新しい UI コンポーネントです。既存のリンク展開サービスが更新され、アダプティブ カードとチャット サービスを使用して URL をタブに変換するために使用されます。 タブ全体について話し合うのではなく、特定のタスク、患者、営業案件など、タブ内のサブエンティティに関する会話を行うことができる会話型サブエンティティを使用して会話タブを作成できます。タブ マージン に変更を加えると、アプリのビルド時の開発者エクスペリエンスを向上させることができます。 タブをドラッグして目的の位置に配置すると、個人用アプリやチャネルまたはグループ チャット内のタブ位置を交換できます。
注:
投稿とファイルの位置は移動できません。
タブ機能
タブ機能は次のとおりです。
- タブがボットも含まれるアプリに追加されると、ボットもチームに追加されます。
- 現在のユーザーの Microsoft Azure Active Directory (Azure AD) ID の認識。
- 言語が
en-us
であることを示すユーザーのロケール認識。 - サポートされている場合、シングル サインオン (SSO) 機能があります。
- ボットやアプリの通知を使用して、タブや、個々の作業項目などのサービス内のサブ エンティティにディープ リンクできます。
- タブ内のリンクからタスク モジュールを開くことができます。
- タブ内で SharePoint Web パーツを再利用できます。
タブのユーザー シナリオ
シナリオ: Teams 内に既存の Web ベース リソースを取得します。
例: 情報提供企業の Web サイトをユーザーに提供する Teams アプリに [個人] タブを作成します。
シナリオ: Teams ボットまたはメッセージング拡張機能にサポート ページを追加します。
例:作成する個人タブはについてとヘルプのを、Web ページ コンテンツをユーザーに提供します。
シナリオ: 協力対話と共同作業のためにユーザーが定期的にやり取りするアイテムへのアクセスを提供します。
例: 個々のアイテムにディープ リンクを設定したチャネルまたはグループ タブを作成します。
タブのしくみを理解する
次のいずれかの方法を使用してタブを作成できます:
アプリ マニフェストでカスタム タブを宣言する
カスタム タブは、アプリ パッケージのアプリ マニフェストで宣言されます。 アプリのタブとして含める Web ページごとに、URL と範囲を定義します。 さらに、 Teams JavaScript クライアント ライブラリ をページに追加し、ページの読み込み後にを呼び出 microsoftTeams.initialize()
すことができます。 Teams はページを表示し、Teams 固有の情報 (Teams クライアントがダーク テーマを実行しているなど) へのアクセスを提供します。
チャネルまたはグループ内でタブを公開する場合も、個人用スコープでも、タブに iframe> HTML コンテンツ ページを<表示する必要があります。個人用タブの場合、コンテンツ URL は Teams アプリ マニフェストで配列内の contentUrl
プロパティによって直接設定されますstaticTabs
。 タブの内容は、すべてのユーザーに対して同じになります。
注:
Teams アプリはサブ iframe を認識しません。 そのため、タブ アプリ内に iframe がある場合は読み込まれません。
チャネル タブまたはグループ タブの場合は、追加の構成ページを作成することもできます。 このページでは、コンテンツ ページの URL を構成できます。通常、URL クエリ文字列パラメーターを使用して、そのコンテキストに適したコンテンツを読み込みます。 これは、チャネル/グループ タブを複数のチームまたはグループ チャットに追加できるためです。 以降にインストールが行われるたびに、ユーザーはタブを構成して、必要に応じてエクスペリエンスを調整することが出来ます。 ユーザーがタブを追加またはタブを構成すると、Teams ユーザー インターフェイス (UI) に表示されているタブに URL が関連付けられます。 タブを構成すると、その URL にパラメーターが追加されます。 たとえば、Azure Boards タブを追加すると、構成ページで、タブにロードするボードを選択することができます。 構成ページ URL は、アプリ マニフェストの configurationUrl
配列の configurableTabs
プロパティによって指定されます。
複数のチャネルまたはグループ タブと、アプリごとに最大 16 個の個人用タブを使用できます。