最新のカード

アダプティブ カードでユーザーに最新情報を提供できます。 更新とメッセージの編集の組み合わせを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 のプロパティの一覧に表示されます。

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

  1. Alex は、スレッド内で資産承認要求をTeamsし、それを Megan と Nestor に割り当てる。

  2. ボットは、会話で承認ベース カードを送信します。

  3. 会話内の他のすべてのユーザーには、ボットから送信されたカードが表示されます。 Megan と Nestor で自動更新がトリガーされ、アダプティブ カードのプロパティの一覧にユーザーの MRIs userIds refresh が追加されると、[承認] ボタンまたは [拒否] ボタンが表示されるユーザー固有のカードが表示されます。

    ユーザー固有のビュー

  4. Nestor は [承認] ボタンを選択 します。Action.Execute ボットは、応答で adaptiveCard/action アダプティブ カードを返す呼び出し要求を取得します。

  5. ボットは、更新されたカードでメッセージ編集をトリガーします。これは、Megan の承認が保留されている間に Nestor が要求を承認したとします。

  6. ボット メッセージの編集では、Megan の自動更新がトリガーされ、更新されたユーザー固有のカードが表示され、Nestor は要求を承認しましたが、[承認] または [拒否] ボタンも表示されます。 Nestor のユーザーの MRI は、userIds``refresh手順 4 と 5 のこのアダプティブ カード JSON のプロパティのリストから削除されます。 これで、自動更新は Megan でのみトリガーされます。

    最新のユーザー固有のビュー

  7. これで、Megan は [承認] ボタンを選択 します。このボタンの電源 Action.Executeは . ボットは、応答で adaptiveCard/action アダプティブ カードを返す呼び出し要求を取得します。

  8. ボットは、更新されたカードを使用してメッセージ編集をトリガーします。このカードでは、Nestor と Megan が要求を承認しました。

  9. ボット メッセージの編集では、自動更新はトリガーされません。 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
シーケンシャル ワークフローアダプティブ カード シーケンシャル ワークフロー、ユーザー固有のビュー、最新のアダプティブ カードをボットに実装する方法を示します。 表示 表示

関連項目