アダプティブ カード ベースのループ コンポーネント

アダプティブ カード ベースのループ コンポーネントを使用すると、Microsoft 365 全体で動作するMicrosoft Teams メッセージ拡張機能 内でコラボレーション エクスペリエンスを構築できます。 アダプティブ カード ベースのループ コンポーネントには実用的なコンテンツがあり、ユーザーは Teams や Outlook などの Microsoft 365 アプリ間でコンテキストを切り替えることなくライブ更新を行うことができます。

ループ コンポーネント は Teams で最初にリリースされ、次に Outlook、Whiteboard、Loop アプリなどの他の Microsoft 365 アプリがリリースされました。 ループ コンポーネントを使用すると、ユーザーはチャット、メール、会議、ホワイトボード、またはループ アプリでライブ コンテンツを共同作業したり、他のユーザーと共有したりできます。 ループ コンポーネントはさまざまな Microsoft 365 アプリ間で同期を維持するため、ユーザーはコンテンツを共同編集し、コンテンツをリアルタイムで更新できます。 詳細については、「 Microsoft 365 エコシステムのループ コンポーネントの概要」を参照してください。

アダプティブ カード ベースのループ コンポーネントの例を次に示します。

この記事では、アダプティブ カード ベースのループ コンポーネントをビルドしてテストする方法の概要について説明します。

前提条件

アダプティブ カード ベースのループ コンポーネントを構築する前に、次の前提条件を満たしていることを確認してください。

1. 検索コマンドを使用してメッセージ拡張機能を構築します。

2. メッセージ拡張機能に リンク展開 サポートを追加します。

3. アダプティブ カードにユニバーサル アクションを使用します。

4. Microsoft 365 全体で Teams メッセージ拡張機能を拡張します。

アダプティブ カード ベースのループ コンポーネントを構築する

アダプティブ カード ベースのループ コンポーネントを構築するには、次の手順に従います。

1. アダプティブ カードが 設計ガイドライン に準拠していることを確認して、エンド ユーザーに対して実用的で一貫性のあるアダプティブ カード ベースのエクスペリエンスを構築します。
2. ループ コンポーネントを有効にするには、アダプティブ カード スキーマの metadata.webUrl プロパティでカードを一意に識別する URL を追加します。 metadata.webUrl プロパティは、ループ コンポーネント ヘッダーに存在する [コピー] ボタンを使用した移植性をサポートします。

例

metadataプロパティとwebUrl プロパティを持つアダプティブ カード ベースのループ コンポーネントの JSON の例を次に示します。

{
  "type": "AdaptiveCard",
  "version": "1.6",
  "metadata": {
    "webUrl": "https://contoso.com/tab"
  },
  "body": [
    {
      ....
    },
  ]
  }

クエリ パラメーター

ループ コンポーネントをテストする

Teams と Outlook for Web の開発環境でループ コンポーネントをテストできます。

Microsoft Teamsでテストする

アプリケーションを構成、配布、管理するには、 Teams 用開発者ポータルを使用します。 次のオプションを使用して、開発者ポータルでアプリをテストおよびデバッグできます。

• [概要] ページの [ 概要] ページの [Teams ストアの検証] で、アプリの構成のスナップショットを確認し、アプリ パッケージが Microsoft Teams Store テスト ケースに対して検証されているかどうかを確認できます。
• Teams でのプレビュー: [Teams のプレビュー ] ボタンをクリックすると、デバッグのために Teams クライアントでアプリがすぐに起動されます。

Outlook for Web でテストする

Outlook for Web でアダプティブ カード ベースのループ コンポーネントを有効にするには、次の手順に従います。

1. Teams App Camp を使用して検索ベースのメッセージ拡張機能を作成します。
2. Microsoft 365 開発者テナントを作成 するか、テスト テナントの資格情報を使用してサインインします。

アプリによって生成されたアダプティブ カードは、ループ コンポーネントとしてレンダリングされます。

コード サンプル

関連項目

ループ コンポーネントを設計する