最新のカード

[アーティクル]
03/12/2022

アダプティブカードでユーザーに最新情報を提供できます。更新とメッセージの編集の組み合わせをTeams。サービスに変更がある場合と同様に、ユーザー固有のビューを最新の状態に動的に更新します。たとえば、プロジェクト管理カードやチケットカードの場合は、コメントとタスクの状態を更新します。承認の場合、最新の状態が反映され、区別された情報とアクションも提供されます。

たとえば、ユーザーは、スレッド内にアセット承認要求をTeamsできます。 Alex は承認要求を作成し、それを Megan と Nestor に割り当てる。承認要求を作成する 2 つの部分を次に示します。

アダプティブカードのプロパティを使用して、ユーザー固有 refresh のビューを適用できます。ユーザー固有のビューを使用すると、一連のユーザーに [承認] または [拒否] ボタンを含むカードを表示し、他のユーザーにこれらのボタンのないカードを表示できます。
カードの状態を常に更新するために、Teams編集メカニズムを使用できます。たとえば、承認ごとにボットは、すべてのユーザーに対してメッセージの編集をトリガーできます。このボットメッセージの編集は、 adaptiveCard/action 更新されたユーザー固有のカードでボットが応答できる、すべての自動更新ユーザーに対する呼び出し要求をトリガーします。

詳細については、「ボットメッセージの編集方法」を参照してください。

承認ベースカード

次のコードは、承認ベースカードの例を示しています。

{
  "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
  "type": "AdaptiveCard",
  "version": "1.4",
  "refresh": {
    "action": {
      "type": "Action.Execute",
      "title": "Refresh",
      "verb": "acceptRejectView"
    },
    "userIds": ["<Megan's user MRI>", "<Nestor's user MRI>"]
  },
  "body": [
    {
      "type": "TextBlock",
      "text": "Asset Request B12"
    },
    {
      "type": "TextBlock",
      "text": "Submitted by **Alex**"
    },
    {
      "type": "TextBlock",
      "text": "Approval pending from **Megan and Nestor**"
    }
  ]
}

[承認] ボタンと [拒否] ボタンを含む承認カード

次のコードは、[承認] ボタンと [拒否] ボタンを含 む承認 カード の例を 示しています。

{
  "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
  "type": "AdaptiveCard",
  "version": "1.4",
  "refresh": {
    "action": {
      "type": "Action.Execute",
      "title": "Refresh",
      "verb": "acceptRejectView"
    },
    "userIds": ["<Nestor's user MRI>", "<Megan's user MRI>"]
  },
  "body": [
    {
      "type": "TextBlock",
      "text": "Approval Request B12"
    },
    {
      "type": "TextBlock",
      "text": "Submitted by **Alex**"
    },
    {
      "type": "TextBlock",
      "text": "Approval pending from **Megan and Nestor**"
    }
  ],
  "actions": [
    {
      "type": "Action.Execute",
      "title": "Approve",
      "verb": "approve",
      "data": {
            "more info": "<more info>"
      }
    },
    {
      "type": "Action.Execute",
      "title": "Reject",
      "verb": "reject",
      "data": {
            "more info": "<more info>"
      }
    }
  ]
}

承認要求に応じてユーザーに表示される 2 つの役割を次に示します。

承認基本カード: userIds refresh 承認者リストの一部ではなく、要求がまだ承認または拒否されていないユーザーに表示され、アダプティブカード JSON のプロパティのリストの一部ではありません。
[承認] または [ 拒否] ボタンを持つ承認カード: userIds refresh 承認者リストの一部であるユーザーとアダプティブカード JSON のプロパティの一覧に表示されます。

アセット承認要求を送信するには、次の方法を実行します。

Alex は、スレッド内で資産承認要求をTeamsし、それを Megan と Nestor に割り当てる。
ボットは、会話で承認ベースカードを送信します。
会話内の他のすべてのユーザーには、ボットから送信されたカードが表示されます。 Megan と Nestor で自動更新がトリガーされ、アダプティブカードのプロパティの一覧にユーザーの MRIs userIds refresh が追加されると、[承認] ボタンまたは [拒否] ボタンが表示されるユーザー固有のカードが表示されます。
Nestor は [承認] ボタンを選択 します。Action.Execute ボットは、応答で adaptiveCard/action アダプティブカードを返す呼び出し要求を取得します。
ボットは、更新されたカードでメッセージ編集をトリガーします。これは、Megan の承認が保留されている間に Nestor が要求を承認したとします。
ボットメッセージの編集では、Megan の自動更新がトリガーされ、更新されたユーザー固有のカードが表示され、Nestor は要求を承認しましたが、[承認] または [拒否] ボタンも表示されます。 Nestor のユーザーの MRI は、userIds``refresh手順 4 と 5 のこのアダプティブカード JSON のプロパティのリストから削除されます。これで、自動更新は Megan でのみトリガーされます。
これで、Megan は [承認] ボタンを選択 します。このボタンの電源 Action.Executeは . ボットは、応答で adaptiveCard/action アダプティブカードを返す呼び出し要求を取得します。
ボットは、更新されたカードを使用してメッセージ編集をトリガーします。このカードでは、Nestor と Megan が要求を承認しました。
ボットメッセージの編集では、自動更新はトリガーされません。 Megan のユーザーの MRI は、userIds``refresh手順 7 と 8 のこのアダプティブカード JSON のプロパティのリストから削除されます。

アダプティブカードの応答として送信され、adaptiveCard/action``message edit

次のコードは、手順 adaptiveCard/action message edit 4 と 5 の応答として送信されるアダプティブカードの例を示しています。

{
  "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
  "type": "AdaptiveCard",
  "version": "1.4",
  "refresh": {
    "action": {
      "type": "Action.Execute",
      "title": "Refresh",
      "verb": "acceptRejectView"
    },
    "userIds": ["<Megan's user MRI>"]
  },
  "body": [
    {
      "type": "TextBlock",
      "text": "Asset Request B12"
    },
    {
      "type": "TextBlock",
      "text": "Submitted by **Alex**"
    },
    {
      "type": "TextBlock",
      "text": "Approval pending from **Megan**"
    },
    {
      "type": "TextBlock",
      "text": "Approved by **Nestor**"
    }
  ]
}

次のコードは、手順 adaptiveCard/action 6 の自動更新を介して呼び出しの応答として送信されるアダプティブカードの例を示しています。

{
  "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
  "type": "AdaptiveCard",
  "version": "1.4",
  "refresh": {
    "action": {
      "type": "Action.Execute",
      "title": "Refresh",
      "verb": "acceptRejectView"
    },
    "userIds": ["<Megan's user MRI>"]
  },
  "body": [
    {
      "type": "TextBlock",
      "text": "Approval Request B12"
    },
    {
      "type": "TextBlock",
      "text": "Submitted by **Alex**"
    },
    {
      "type": "TextBlock",
      "text": "Approval pending from **Megan**"
    },
    {
      "type": "TextBlock",
      "text": "Approved by **Nestor**"
    }
  ],
  "actions": [
    {
      "type": "Action.Execute",
      "title": "Approve",
      "verb": "approve",
      "data": {
            "more info": "<more info>"
      }
    },
    {
      "type": "Action.Execute",
      "title": "Reject",
      "verb": "reject",
      "data": {
            "more info": "<more info>"
      }
    }
  ]
}

次のコードは、手順 adaptiveCard/action message edit 7 と 8 の応答として送信されるアダプティブカードの例を示しています。

{
  "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
  "type": "AdaptiveCard",
  "version": "1.4",
  "refresh": {
    "action": {
      "type": "Action.Execute",
      "title": "Refresh",
      "verb": "acceptRejectView"
    },
    "userIds": []
  },
  "body": [
    {
      "type": "TextBlock",
      "text": "Asset Request B12"
    },
    {
      "type": "TextBlock",
      "text": "Submitted by **Alex**"
    },
    {
      "type": "TextBlock",
      "text": "Approved by **Nestor and Megan**"
    }
  ]
}

コードサンプル

サンプルの名前	説明	.NETCore	Node.js
シーケンシャルワークフローアダプティブカード	シーケンシャルワークフロー、ユーザー固有のビュー、最新のアダプティブカードをボットに実装する方法を示します。	表示	表示

最新のカード

このページはお役に立ちましたか?

承認ベース カード

[承認] ボタンと [拒否] ボタンを含む承認カード

アダプティブ カードの応答として送信され、adaptiveCard/action``message edit

コード サンプル

関連項目

承認ベースカード

アダプティブカードの応答として送信され、adaptiveCard/action``message edit

コードサンプル