Карточки

Карточка — это контейнер пользовательского интерфейса (UI) для коротких или связанных фрагментов информации. Карточки могут иметь множество свойств и вложений, а также кнопки, запускающие действия с карточками. С помощью карточек вы можете упорядочивать информацию по группам и предоставлять пользователям возможность взаимодействовать с определенными частями информации.

Боты для Teams поддерживают следующие типы карточек:

  • Адаптивная карточка
  • Карточка главного имиджевого баннера
  • Карточка списка
  • Карточка соединителя Office 365
  • Карточка квитанции
  • Карточка входа
  • Карточка эскиза
  • Коллекции карточек

В зависимости от типа карточки вы можете добавить в них форматирование текста с использованием Markdown или HTML. Карточки, используемые ботами и расширениями для обмена сообщениями в Microsoft Teams, добавляют и реагируют на эти действия карточки, openUrl, messageBack, imBack, invoke, и signin.

Teams использует карточки в трех разных местах:

  • Connectors
  • боты;
  • Расширения для обмена сообщениями

Карточки в соединителях

Сначала карточки определялись как часть Outlook и Office 365, а теперь они используются в соединителях Office 365. Как и многие приложения Office 365, Teams поддерживает соединители. Дополнительные сведения см. Создание соединителей Office 365. Спецификацию для карточек в соединителях можно найти в справочнике по карточкам сообщений с действиями.

Карточки в ботах

Microsoft Bot Framework расширяет спецификацию карточек, добавляя набор предопределенных карточек, которые могут использоваться ботами в сообщениях ботов. Teams поддерживает боты с помощью платформы Bot Framework, но в ней поддерживается другой набор карточек. Общие сведения о карточках в Bot Framework можно найти в разделе о добавлении форматированных карточек-вложений в сообщения. Эти карточки называются простыми карточками в Teams.

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

Карточки в расширениях для обмена сообщениями

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

Типы карточек

Все карточки, используемые Teams, перечислены в разделе Типы карточек. В этом справочнике также описываются различия между карточками Bot Framework и карточками в Teams.

Адаптивные карточки

Адаптивные карточки — это новая спецификация карточек для различных продуктов Майкрософт, в том числе ботов, Кортаны, Outlook и Windows. Это рекомендуемый тип карточки для новых разработок Teams. Общие сведения от команды разработки адаптивных карточек см. в обзоре адаптивных карточек. Адаптивные карточки можно использовать везде, где применяются существующие карточки главного имиджевого баннера, карточки Office 365 и карточки эскизов.

Помимо адаптивных карточек, Teams поддерживает два других типа карточек:

  • Карточки соединителей: используются в составе соединителей Office 365.
  • Простые карточки: используются из Bot Framework, например карточки эскизов и главного имиджевого баннера.

Выбор людей в адаптивных карточках

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

Поиск с автозавершением в адаптивных карточках

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

Адаптивные карточки и входящие веб-перехватчики

Примечание

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

Поддержка ИД объектов Azure AD и UPN в упоминании пользователя

Боты с адаптивными картами поддерживают упоминание идентификаторов пользователей, таких как ID объекта Microsoft Azure Active Directory Azure AD и основное имя пользователя (UPN) в дополнение к существующим удостоверениям. Входящие веб-перехватчики начинают поддерживать упоминание пользователя в адаптивной карточке с применением ИД объекта Azure AD и UPN.

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

См. также