Поделиться через

Карточки

  • Статья

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

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

  • Адаптивная карточка
  • Карточка главного имиджевого баннера
  • Карточка списка
  • Карта соединителя для Группы Microsoft 365
  • Карточка квитанции
  • Карточка входа
  • Карточка эскиза
  • Коллекции карточек
  • Меню переполнения на адаптивных карточках

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

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

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

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

Важно!

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

Как создать веб-перехватчик в Teams?

Если вы уже создали соединители Office 365:

Известные проблемы

  • Приложение workflows не может публиковать в частных каналах в качестве бота потока. Однако он может публиковаться от имени пользователя.
  • Рабочие процессы поддерживают только адаптивные карточки. Он не поддерживает более старый формат карта сообщений, используемый Office 365 соединителями. Рабочие процессы не поддерживают использование формата карта сообщений. Дополнительные сведения см. в статье Преобразование сообщений соединителя карта формат в адаптивную карточку.
  • Рабочие процессы не предлагают сторонние соединители, такие как DataDog и Jenkins.
  • Рабочие процессы можно создавать только в среде по умолчанию.

Ограничения

Рабочие процессы связаны только с определенными пользователями (которые называются владельцами рабочего процесса), а не с командой Или каналом Teams. Рабочие процессы могут стать потерянными потоками при отсутствии владельца, если совладельцы не назначены. Чтобы обеспечить непрерывность бизнес-процесса, автоматизированного потоком, администраторы могут добавить одного или нескольких совладельцев и предоставить им полный контроль над рабочим процессом. Они также могут добавить проверку подлинности для подключений (если таковые имеются) и включить поток, если он был отключен. Дополнительные сведения см. в разделе Управление потерянными потоками.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

значок Люди в адаптивной карточке

Люди значок в адаптивной карточке помогает пользователям просматривать изображения пользователей в адаптивной карточке в Teams. Вы можете просмотреть изображение одного или нескольких пользователей. значок Люди поддерживается в мобильных и настольных клиентах Teams.

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

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

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

Адаптивные карточки можно создавать в Teams, где значение входных данных зависит от значения другого. Например, рассмотрим адаптивную карточку с двумя Input.ChoiceSet раскрывающимися списками: один для выбора страны, а другой для выбора определенного города в этой стране. Первый раскрывающийся список должен фильтровать города, отображаемые во втором раскрывающемся списке. Это можно сделать, создав раскрывающийся Input.ChoiceSet список с динамическим поиском typeahead, который зависит от одного или нескольких других входных данных в карта. Дополнительные сведения см. в разделе Зависимые входные данные.

Элементы мультимедиа в адаптивных карточках

Элементы мультимедиа в адаптивной карточке обеспечивают расширенные возможности мультимедиа и повышают вовлеченность с адаптивной карточкой. Вы можете добавлять в адаптивную карточку файлы мультимедиа, такие как аудио- или видеоклипы, видео с YouTube, Vimeo или Dailymotion. Дополнительные сведения см. в разделе Элементы мультимедиа в адаптивной карточке.

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

Примечание.

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

CodeBlock в адаптивных карточках

Делитесь фрагментами кода в виде полноформатных адаптивных карточек в чатах, каналах и собраниях Teams с CodeBlock помощью элемента . Адаптивные карточки с элементом CodeBlock упрощают чтение фрагмента кода, так как отступ, нумерация и выделение синтаксиса соответствуют языку программирования. Дополнительные сведения см. в разделе CodeBlock в адаптивных карточках.

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

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

Границы и скругленные углы

Вы можете добавить границы к Containerэлементам , ColumnSet, Columnи Table в адаптивных карточках, чтобы очертить различные разделы карта. Вы можете добавить скругленные углы к Containerэлементам , ColumnSet, Column, Tableи Image в адаптивных карточках, чтобы дизайн карта выглядел современным и визуально привлекательным. Дополнительные сведения см. в разделе Границы и скругленные углы в адаптивных карточках.

Прокручиваемые контейнеры

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

Составная кнопка

Составная кнопка — это специальный тип кнопки со значком, заголовком и описанием. Вы можете добавить кнопку Составные с помощью CompoundButton элемента . Этот элемент позволяет реплицировать внешний вид начальных строк запроса в адаптивной карточке. Дополнительные сведения см. в разделе Составная кнопка адаптивных карточек.

Значки Fluent

Адаптивные карточки поддерживают добавление значков из библиотеки значков Fluent с помощью Icon элемента . Дополнительные сведения см. в разделе Значки адаптивной карточки.

Рейтинги звезд

Вы можете добавить входные данные оценки star в адаптивную карточку Input.Rating с помощью элемента . Вы также можете добавить оценку только для чтения star с помощью Rating элемента . Дополнительные сведения см. в разделе оценки адаптивных карточек.

Условное включение кнопок действий

Свойство можно использовать для conditionallyEnabled отключения кнопок действий до тех пор, пока пользователь не изменит значение хотя бы одного из необходимых входных данных. Это свойство можно использовать только с Action.Submit действиями и Action.Execute . Дополнительные сведения см. в разделе Условное включение кнопок действий.

Меню переполнения на адаптивных карточках

Адаптивная карточка в Teams поддерживает меню переполнения. Вы можете заполнить меню переполнения для всех дополнительных действий в адаптивной карточке.

Поддержка идентификатора объекта Microsoft Entra и имени участника-пользователя в пользовательском упоминание

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

Диаграммы в адаптивных карточках

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

Макеты контейнеров в адаптивных карточках

Вы можете создавать адаптивные контейнеры для различных ширин адаптивных карточек с Layout.Stackпомощью макетов , Layout.Flowи Layout.AreaGrid . Дополнительные сведения см. в разделе Макеты контейнеров.

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

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

См. также