ユニバーサル アクション モデルの概要

アダプティブ カードはプラットフォームに依存しない UI スニペットであり、軽量の JSON 形式を使用して作成され、アプリやサービスで共有できます。 アダプティブ カードは、ホストの外観に適応するだけでなく、豊富な対話機能も提供します。

アダプティブ カードの人気が高まるにつれて、さまざまなホストがさまざまなアクション モデルをサポートし始め、断片化が発生しました。 この問題を解決するために、Teams、Outlook、アダプティブ カードの各チームは、ホスト間で互換性のある新しいユニバーサル ボット アクション モデルの作成に取り組んだ。 この取り組みにより、次のことが行われます。

• Outlook (アクション可能メッセージ) と Teams (Bots) の両方にアダプティブ カード ベースのシナリオを実装する方法としてのボットと Bot Framework の一般化
• Action.Execute(現在はアクション可能メッセージで使用されています) と Action.Submit (現在ボットで使用されている) の両方Action.Httpの代替として使用されます。

Schema

Action.Execute

Outlook 用アダプティブ カードを作成する場合は、 のAction.Http代わりに を使用Action.Executeします。 JSON ペイロードで を使用Action.Executeするアダプティブ カードの例を次に示します。

{
  "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
  "type": "AdaptiveCard",
  "originator":"c9b4352b-a76b-43b9-88ff-80edddaa243b",
  "version": "1.4",
  "body": [
    {
      "type": "TextBlock",
      "text": "Present a form and submit it back to the originator"
    },
    {
      "type": "Input.Text",
      "id": "firstName",
      "placeholder": "What is your first name?"
    },
    {
      "type": "Input.Text",
      "id": "lastName",
      "placeholder": "What is your last name?"
    },
    {
      "type": "ActionSet",
      "actions": [
        {
          "type": "Action.Execute",
          "title": "Submit",
          "verb": "personalDetailsFormSubmit"
        }
      ]
    }
  ]
}

プロパティ

更新メカニズム

と共 Action.Executeに、新しい更新メカニズムがサポートされるようになりました。そのため、表示時に自動的に更新されるアダプティブ カードを作成できるようになりました。 これにより、ユーザーに常に最新のデータが確実に表示されます。 アダプティブ カードが Outlook で自動的に更新されるようにするには、 型を埋め込むプロパティをaction定義refreshしますAction.Execute。

サンプル JSON

{
  "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
  "type": "AdaptiveCard",
  "originator":"c9b4352b-a76b-43b9-88ff-80edddaa243b",
  "version": "1.4",
  "refresh": {
    "action": {
      "type": "Action.Execute",
      "title": "Submit",
      "verb": "personalDetailsCardRefresh"
    },
    "userIds": []
  },
  "body": [
    {
      "type": "TextBlock",
      "text": "Present a form and submit it back to the originator"
    },
    {
      "type": "Input.Text",
      "id": "firstName",
      "placeholder": "What is your first name?"
    },
    {
      "type": "Input.Text",
      "id": "lastName",
      "placeholder": "What is your last name?"
    },
    {
      "type": "ActionSet",
      "actions": [
        {
          "type": "Action.Execute",
          "title": "Submit",
          "verb": "personalDetailsFormSubmit",
          "fallback": "Action.Submit"
        }
      ]
    }
  ]
}

下位互換機能

新しいAction.Executeユニバーサル アクション モデルは、アダプティブ カード バージョン 1.4 より下で使用されるアクション モデルからのAction.Http逸脱であり、アクションはアダプティブ カードで明示的な HTTP 呼び出しとしてエンコードされます。 Action.Execute モデルを使用すると、開発者は Outlook と Teams の両方で動作するシナリオを実装できます。 アクション可能なメッセージ シナリオでは、モデルまたは新しいAction.ExecuteモデルをAction.Http使用できますが、両方を使用することはできません。 ユニバーサル Action.Execute モデルを使用するシナリオは、ボットとして実装し、 Outlook アクション可能メッセージ チャネルをサブスクライブする必要があります。

コード サンプル

ドキュメントを確認したら、いくつかの例を試す準備が整います。

• 経費の承認
• プロジェクト管理