Компоненты цикла на основе адаптивных карточек
Примечание.
Для компонентов цикла на основе адаптивных карточек требуются адаптивные карточки версии 1.6 или более поздней.
Компоненты цикла на основе адаптивных карточек позволяют создавать возможности совместной работы в расширениях сообщений Microsoft Teams, которые работают в Microsoft 365. Компоненты цикла на основе адаптивных карточек содержат активное содержимое, позволяющее пользователям вносить активные обновления без переключения контекста между приложениями Microsoft 365, такими как Teams и Outlook.
Компоненты цикла были сначала выпущены в Teams, а затем другие приложения Microsoft 365, такие как Outlook, доска и приложение Loop. Компоненты цикла позволяют пользователям совместно работать и делиться динамическим содержимым с другими пользователями в чате, электронной почте, собрании, доске или приложении Loop. Так как компоненты цикла синхронизируются в разных приложениях Microsoft 365, они позволяют пользователям совместно редактировать содержимое и вносить обновления в режиме реального времени. Дополнительные сведения см. в статье Общие сведения о компонентах цикла в экосистеме Microsoft 365.
Ниже приведен пример компонента цикла на основе адаптивной карточки:
В этой статье содержится обзор создания и тестирования компонентов цикла на основе адаптивных карточек.
Предварительные условия
Перед созданием компонента цикла на основе адаптивных карточек убедитесь, что выполнены следующие предварительные требования:
Добавьте поддержку распаковки ссылок в расширение сообщений.
Используйте универсальные действия для адаптивных карточек.
Создание компонента цикла на основе адаптивных карточек
Чтобы создать компонент цикла на основе адаптивных карточек, выполните следующие действия.
- Убедитесь, что адаптивная карточка соответствует рекомендациям по проектированию , чтобы создать практический и согласованный интерфейс на основе адаптивных карточек для конечных пользователей.
- Чтобы включить компонент 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 можно увидеть моментальный снимок конфигурации приложения и проверить, проверяет ли пакет приложения тестовые случаи Microsoft Teams Store.
- Предварительный просмотр в Teams. Кнопка "Предварительный просмотр" в Teams позволяет быстро запустить приложение в клиенте Teams для отладки.
Тестирование в Outlook для Интернета
Чтобы включить компонент цикла на основе адаптивных карточек в Outlook для Интернета, выполните следующие действия.
- Создайте расширение для сообщений на основе поиска с помощью Teams App Camp.
- Создайте клиент разработчика Microsoft 365 или войдите с помощью учетных данных тестового клиента.
Адаптивная карточка, созданная приложением, отображается как компонент цикла.
Пример кода
Название примера | Описание | Node.js | .NET | Манифест |
---|---|---|---|---|
Расширение сообщения с компонентом цикла на основе адаптивной карточки | В этом примере показано, как создать расширение сообщения с помощью компонента цикла на основе адаптивной карточки. | Просмотр | Просмотр | Просмотр |
См. также
Platform Docs