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

Примечание.

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

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

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

Ниже приведен пример компонента цикла на основе адаптивной карточки:

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

Предварительные условия

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

1. Создайте расширение сообщения с помощью команды поиска.

2. Добавьте поддержку распаковки ссылок в расширение сообщений.

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

4. Расширение расширения сообщений Teams в Microsoft 365.

Создание компонента цикла на основе адаптивных карточек

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

1. Убедитесь, что адаптивная карточка соответствует рекомендациям по проектированию , чтобы создать практический и согласованный интерфейс на основе адаптивных карточек для конечных пользователей.
2. Чтобы включить компонент Loop, добавьте URL-адрес, который однозначно идентифицирует карта в свойстве metadata.webUrlсхемы адаптивной карточки. Свойство metadata.webUrl поддерживает переносимость с помощью кнопки Копировать в заголовке компонента цикла.

Пример

Ниже приведен пример json компонента цикла на основе адаптивных карточек со свойствами metadata и webUrl :

{
  "type": "AdaptiveCard",
  "version": "1.6",
  "metadata": {
    "webUrl": "https://contoso.com/tab"
  },
  "body": [
    {
      ....
    },
  ]
  }

Параметры запроса

Свойство	Тип	Описание	Обязательный
metadata	Metadata	Определяет различные свойства метаданных, которые обычно не используются для отрисовки карта.	Нет
webUrl	String	URL-адрес, который однозначно идентифицирует карта и служит резервным вариантом браузера, который может использоваться некоторыми узлами.	Нет

Тестирование компонента цикла

Компонент Цикл можно протестировать в средах разработчиков Teams и Outlook для Интернета.

Тестирование в Microsoft Teams

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

• Страница "Обзор". На странице Обзор в разделе Проверка магазина Teams вы увидите snapshot конфигурации приложения и проверка, если пакет приложения проверяет тестовые случаи Microsoft Teams Store.
• Предварительный просмотр в Teams. Кнопка "Предварительный просмотр" в Teams позволяет быстро запустить приложение в клиенте Teams для отладки.

Тестирование в Outlook для Интернета

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

1. Create расширение для сообщений на основе поиска с помощью Teams App Camp.
2. Create клиент разработчика Microsoft 365 или войдите с учетными данными тестового клиента.

Адаптивная карточка, созданная приложением, отображается как компонент цикла.

Пример кода

Название примера	Описание	Node.js	.NET	Манифест
Расширение сообщения с компонентом цикла на основе адаптивной карточки	В этом примере показано, как создать расширение сообщения с помощью компонента цикла на основе адаптивной карточки.	Просмотр	Просмотр	Просмотр

См. также

Проектирование компонента цикла