Универсальные действия для адаптивных карточек

Универсальные действия для адаптивных карточек эволюционировали на основе отзывов разработчиков о том, что, несмотря на то, что макет и отрисовка адаптивных карточек были универсальными, обработка действий не была. Даже если разработчик хочет отправить одну и ту же карточку в разные места, он должен обрабатывать действия по-разному.

Универсальные действия для адаптивных карточек позволяют использовать бота в качестве общей серверной части для обработки действий, а также новый тип действия , Action.Executeкоторый работает в разных приложениях, таких как Teams и Outlook.

Этот документ поможет вам понять, как использовать модель универсальных действий для улучшения взаимодействия пользователей с адаптивными карточками на разных платформах и в приложениях.

Примечание.

Поддержка универсальных действий для адаптивных карточек версии 1.4 доступна только для карточек, отправленных ботом. В ближайшее время будет добавлена поддержка карточек, отправляемых через поле создания и раскупорки ссылок.

Улучшение взаимодействия с пользователем с помощью универсальных действий для адаптивных карточек

Универсальные действия для адаптивных карточек улучшают взаимодействие с пользователем, включив следующие сценарии:

Универсальные действия

До универсальных действий для адаптивных карточек разные узлы предоставляли различные модели действий следующим образом:

  • Команды или боты использовали Action.Submit, подход, который откладывает фактическую модель коммуникации в базовый канал.
  • Outlook используется для Action.Http взаимодействия с серверной службой, явно указанной в полезных данных адаптивной карточки.

На следующем рисунке показана текущая модель несогласованных действий:

Несогласованная модель действий

С помощью универсальных действий для адаптивных карточек можно использовать Action.Execute для обработки действий на разных платформах.

Action.Execute работает во всех центрах, включая Teams и Outlook, и не является заменой Action.Submit. Например, если вы хотите, чтобы внешняя система делала действие, а результат действия должен быть отправлен обратно в беседу с помощью расширения обмена сообщениями, Action.Execute не поддерживается.

Для распаковки ссылок, таких как карточки с изображением и эскизами, необходимо вызвать .Action.Submit

Кроме того, адаптивная карточка может быть возвращена в качестве ответа для активированного Action.Execute запроса вызова.

На следующем рисунке показана новая модель универсального действия:

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

Теперь вы можете отправить одну и ту же карточку в Teams и Outlook и поддерживать их синхронизацию друг с другом с помощью базового бота. Любое действие, выполняемое на любой платформе, отражается на другой с этой сборкой один раз, разверните в любом месте (универсальные действия для адаптивных карточек).

На следующем рисунке показаны универсальные действия для адаптивных карточек для Teams и Outlook:

Пользовательские просмотры

Сегодня каждый пользователь в чате или канале Teams видит одно и то же представление и действия кнопок на адаптивной карточке. Однако в некоторых сценариях требуется, чтобы некоторые пользователи действовали по-разному и имели доступ к разным сведениям в одном чате или канале.

Например, если вы отправляете карточку отчета об инциденте в чате или канале, только пользователь, которому назначен инцидент, должен увидеть кнопку Разрешить . С другой стороны, создатель инцидента должен видеть кнопку Изменить , а все остальные пользователи должны иметь возможность просматривать только сведения об инциденте. Это становится возможным с помощью представлений для конкретных пользователей, включенных свойством refresh .

На следующем рисунке показан пример расширения сообщений с запросами (ME), где разные пользователи в чате отображают различные действия в зависимости от требования:

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

Поддержка последовательных рабочих процессов

Благодаря поддержке последовательных рабочих процессов пользователи могут выполнять ряд рабочих процессов, не отправляя разные карточки отдельно. Это становится возможным благодаря возможности Action.Execute возвращать адаптивную карточку в ответ на действие. Кроме того, любой пользователь в чате или канале может выполнять свой рабочий процесс, не изменяя карточку для других пользователей в чате.

На следующем рисунке показан пример бота по заказу продуктов питания:

Последовательный рабочий процесс

На следующем рисунке показаны различные состояния для разных пользователей в чате или канале:

Состояния бота общественного питания

Дополнительные сведения см. в разделе Пример последовательного рабочего процесса.

Актуальные представления

Вы можете создать адаптивные карточки, которые обновляются автоматически. Например, это может быть запрос на утверждение, отправленный пользователем. После утверждения карточка должна автоматически отображать сведения о времени утверждения запроса и о том, кто одобрил запрос. Модель обновления позволяет предоставлять такие актуальные представления. На следующем рисунке показан поток многофакторного утверждения и отображение представлений для разных пользователей.

Актуальные пользовательские представления

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

Теперь вы можете понять, как можно преобразовать адаптивные карточки с помощью новой модели универсальных действий, чтобы обеспечить уникальный и улучшенный пользовательский интерфейс.

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

Адаптивные карточки — это сочетание содержимого, например текста и графики, а также действий, которые могут выполняться пользователем. Дополнительные сведения см. в разделе Адаптивные карточки. Новые универсальные действия для адаптивных карточек обеспечивают общую обработку действий адаптивной карточки на разных платформах и в приложениях. Дополнительные сведения см. в разделе Модель универсального действия.

Вы можете начать, обновив сценарии с помощью [краткого руководства по началу работы]. (Work-with-universal-actions-for-adaptive-cards.md) и используйте универсальные действия.

Следующий этап

См. также