カード

  • [アーティクル]

カードは、短い情報や関連する情報のユーザー インターフェイス (UI) コンテナーです。 カードには複数のプロパティと添付ファイルを含めることができます。また、ボタンを含めることができます。このボタンは、カードアクションをトリガーします。 カードを使用すると、情報をグループに整理し、ユーザーが情報の特定の部分を操作する機会を与えることができます。

Microsoft Teams用のボットでは、次の種類のカードがサポートされています。

  • アダプティブ カード
  • ヒーロー カード
  • リスト カード
  • Microsoft 365 グループのコネクタ カード
  • レシート カード
  • サインイン カード
  • サムネイル カード
  • カード コレクション
  • アダプティブ カードのオーバーフロー メニュー

カードの種類に応じて、Markdown または HTML を使用して、カードにリッチ テキストの書式設定を追加できます。 Teams でボットとメッセージ拡張機能によって使用されるカードは、これらのカードアクション、 openUrl、 messageBack、 imBack、 invoke、 signinを追加して応答します。

Teams では、次の 3 つの異なる場所でカードが使用されます。

  • コネクタ
  • ボット
  • メッセージ拡張機能

コネクタ内のカード

カードは最初に Outlook と Microsoft 365 の一部として定義され、Microsoft 365 グループのコネクタの一部として使用されるようになりました。 多くの Microsoft 365 アプリケーションと同様に、Teams ではコネクタがサポートされています。 詳細については、「 Microsoft 365 グループのコネクタを作成する」を参照してください。 コネクタ内のカードの仕様は、アクション可能なメッセージ カードリファレンス にあります。

ボット内のカード

このMicrosoft Bot Framework、ボットがボット メッセージの一部として使用できる定義済みのカードのセットを追加することで、カードの仕様を拡張します。 Teams ではBot Frameworkを使用するボットがサポートされていますが、これらのカードの異なるセットがサポートされています。 Bot Framework のカードに関する一般的な情報については、「メッセージにリッチ カードの添付ファイルを追加」を参照してください。 これらのカードは、Teams では単純なカードと呼ばれます。

Teams のボットでは、単純なカード、コネクタ カード、またはアダプティブ カードを使用できます。 カードの種類は Teams のボットでサポートされているカードに関する情報を提供します。

メッセージ拡張機能のカード

メッセージ拡張機能は、 カードを返す場合もあります。 メッセージ拡張機能では、単純なカード、コネクタ カード、またはアダプティブ カードを使用できます。 これらのカードは、 カードの種類の中にあります。

カードの種類

Teams で使用されるすべてのカードは、 カードの種類に一覧表示されます。 このリファレンスでは、Teams のBot Framework カードとカードの違いについても説明します。

アダプティブ カード

アダプティブ カード は、ボット、Cortana、Outlook、Windows など、Microsoft 製品のカードの新しいクロス製品仕様です。 これらは、新しい Teams 開発に推奨されるカードの種類です。 アダプティブ カード チームからの一般的な情報については、「 アダプティブ カード概要」を参照してください。 アダプティブ カードは、既存のヒーロー カード、Microsoft 365 カード、サムネイル カードを使用する任意の場所で使用できます。

Teams では、アダプティブ カードに加えて、他の 2 種類のカードもサポートされています。

  • コネクタ カード: Microsoft 365 グループのコネクタの一部として使用されます。
  • シンプル カード: サムネイルカードやヒーロー カードなど、Bot Frameworkから使用されます。

アダプティブ カードでのユーザー ピッカー

ユーザー ピッカー 入力コントロールとして追加アダプティブ カード、ユーザーの検索と選択を有効にします。 チャット、チャネル、ダイアログ (TeamsJS v1.x のタスク モジュールと呼ばれます)、タブで使用できます。 モバイル クライアントとデスクトップ クライアントは、インライン入力エクスペリエンスを提供するユーザー ピッカーをサポートします。

アダプティブ カードの [ユーザー] アイコン

アダプティブ カードの [ユーザー] アイコンは、 ユーザーが Teams のアダプティブ カードでユーザーの画像を表示するのに役立ちます。 1 人のユーザーまたは複数のユーザーの画像を表示できます。 ユーザー アイコンは、Teams モバイル クライアントとデスクトップ クライアントでサポートされています。

アダプティブ カードの先行入力検索

アダプティブ カードの入力コントロールとして追加された型検索では、動的に読み込まれたデータセットからの 動的検索 エクスペリエンスが有効になります。 また、ユーザーは、選択肢の数が限られたリスト内で型指定された静的検索を実行することもできます。 モバイル クライアントとデスクトップ クライアントは、typeahead 動的検索エクスペリエンスをサポートします。

アダプティブ カードのメディア要素

アダプティブ カードのメディア要素は、強化されたメディア エクスペリエンスを提供し、アダプティブ カードとのエンゲージメントを高めます。 オーディオ クリップやビデオ クリップなどのメディア ファイルをアダプティブ カードに追加できます。 詳細については、「 アダプティブ カードのメディア要素」を参照してください。

アダプティブ カードと受信 Webhook

注:

受信 Webhook でアダプティブ カードすると、アダプティブ カードの豊富で柔軟な機能を使用できます。 Teams の受信 Webhook を使用して、Web サービスからデータを送信します。

アダプティブ カードの CodeBlock

CodeBlock要素を使用して、Teams チャット、チャネル、会議で、リッチフォーマットのアダプティブ カードとしてコード スニペットを共有します。 CodeBlock要素を持つアダプティブ カードを使用すると、インデント、番号付け、構文の強調表示がプログラミング言語と一致するため、コード スニペットを読みやすくなります。 詳細については、「 アダプティブ カードの CodeBlock」を参照してください。

アダプティブ カードの応答性の高いレイアウト

アダプティブ カードは、チャット、チャネル、会議チャット全体で強化されたユーザー エクスペリエンスを提供するために、どのデバイスでも見栄えの良いカードを設計する必要があります。 アダプティブ カードの応答性の高いレイアウトを使用すると、カードの幅が異なる異なるレイアウトのカードを設計できます。 詳細については、「 アダプティブ カードの応答性の高いレイアウト」を参照してください。

アダプティブ カードのオーバーフロー メニュー

Teams のアダプティブ カードでは、オーバーフロー メニューがサポートされています。 アダプティブ カード内のすべてのセカンダリ アクションのオーバーフロー メニューを設定できます。

ユーザーメンションでの Microsoft Entra オブジェクト ID と UPN のサポート

アダプティブ カードを使用するボットでは、既存の ID に加えて、Microsoft Entra オブジェクト ID やユーザー プリンシパル名 (UPN) などのユーザーメンション ID がサポートされます。 受信 Webhook は、Microsoft Entra オブジェクト ID と UPN を使用したアダプティブ カードでのユーザーメンションのサポートを開始します。

次のステップ

カードの種類

関連項目