Работа с универсальными действиями для адаптивных карточек

Универсальные действия для адаптивных карт предоставляют способ реализации сценариев, основанных на адаптивной карте, как для Teams, так и для Outlook. В этом документе описывается следующее:

Руководство по быстрому началу использования универсальных действий для адаптивных карт в Teams

  1. Замените все Action.Submit экземпляры, Action.Execute чтобы обновить существующий сценарий в Teams.

  2. Добавьте пункт в адаптивную карту, если вы хотите использовать модель автоматического обновления или если для сценария refresh требуются пользовательские представления.

    Примечание

    Укажите userIds свойство для определения, какие пользователи получают автоматические обновления.

  3. Обработка adaptiveCard/action запросов вызова в боте.

  4. Используйте контекст запроса на вызов, чтобы ответить на них картами, специально созданными для пользователя.

    Примечание

    Всякий раз, когда бот возвращает новую карту в результате обработки, ответ должен Action.Execute соответствовать формату ответа.

Схема универсальных действий для адаптивных карт

Универсальные действия для адаптивных карт представлены в схеме адаптивных карт версии 1.4. Для эффективного использования адаптивной карты необходимо установить свойство адаптивной карты version 1.4.

Примечание

Настройка свойства 1.4 делает адаптивную карту несовместимой со старыми клиентами платформ или приложений, таких как Outlook и Teams, так как они не поддерживают универсальные действия для адаптивных version карт.

Если вы установите версию карты меньше 1.4 и используете свойство или оба свойства, и refresh Action.Execute произойдет следующее:

Клиент Поведение
Teams Карта перестает работать. Карта не обновляется и не отрисовка в зависимости от версии Teams Action.Execute клиента. Чтобы обеспечить максимальную совместимость Teams, Action.Execute определите с Action.Submit свойством отката.

Дополнительные сведения о поддержке старых клиентов см. в обратной совместимости.

Action.Exeмило

При авторе адаптивных карт замените Action.Submit и Action.Http с помощью Action.Execute . Схема похожа на схему Action.Execute Action.Submit .

Дополнительные сведения см. вAction.Exeсхеме и свойствах.

Теперь модель обновления позволяет автоматически обновлять адаптивные карты.

Модель обновления

Чтобы автоматически обновить адаптивную карту, определите ее свойство, в которое встраиваться действие refresh типа Action.Execute и userIds массива.

Дополнительные сведения см. в обновленной схеме и свойствах.

Пользовательские ID в обновлении

Ниже представлены функции UserIds в обновлении:

  • UserIds — это массив МРТ пользователя, который входит в свойство refresh адаптивных карт.

  • Если свойство списка указывается как в разделе обновления карты, карта не обновляется userIds userIds: [] автоматически. Вместо этого пользователю в меню тройной точки в интернете или на рабочем столе отображается параметр "Карточка обновления", а в меню контекста длинного пресса в мобильном телефоне, то есть Android или iOS, чтобы вручную обновить карту.

  • Свойство UserIds добавляется, так как каналы в Teams могут включать большое количество участников. Если все участники одновременно просматривают канал, безусловное автоматическое обновление приводит к много одновечерным вызовам бота. Чтобы избежать этого, свойство всегда должно быть включено, чтобы определить, какие пользователи должны получать автоматическое обновление с максимальным userIds количеством 60 (шестидесяти) пользовательских МРИС.

  • Дополнительные сведения о том, как можно Teams пользовательские МРИ участника беседы, чтобы добавить в список userIds в разделе обновление адаптивной карты, см. в статье Fetch roster or user profile.

  • Пример Teams МРТ пользователя29:1bSnHZ7Js2STWrgk6ScEErLk1Lp2zQuD5H2qQ960rtvstKp8tKLl-3r8b6DoW0QxZimuTxk_kupZ1DBMpvIQQUAZL-PNj0EORDvRZXy8kvWk

Примечание

Свойство игнорируется в Outlook, и свойство всегда userIds refresh автоматически активируется. Проблема масштабирования в Outlook, так как пользователи просматривают карту в разное время.

Следующий шаг — использование действия вызова, чтобы понять, какой запрос должен быть выполнен после adaptiveCard/action Action.Execute выполнения.

adaptiveCard/action вызов активности

При выполнении в клиенте для бота выполняется новый тип действия Action.Execute adaptiveCard/action Invoke.

Дополнительные сведения см. в примере формата запросов и свойств типичной активности adaptiveCard/action вызова.

Дополнительные сведения см. в примере формата отклика и свойств типичной активности вызова с adaptiveCard/action поддерживаемых типов откликов.

Далее можно применить обратную совместимость к старым клиентам на разных платформах и сделать адаптивную карту совместимой.

Обратная совместимость

Универсальные действия для адаптивных карт позволяют устанавливать свойства, которые позволяют обратной совместимости со старыми версиями Outlook и Teams.

Teams

Чтобы обеспечить обратную совместимость адаптивных карт с более старыми версиями Teams, необходимо включить свойство и установить fallback его значение Action.Submit . Кроме того, код бота должен обрабатывать и Action.Execute Action.Submit .

Дополнительные сведения см. в Teams.

Пример кода

Пример имени Описание . NETCore
Teams питания бот Создайте простой бот, который принимает порядок питания с помощью адаптивных карт. View

См. также