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

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

  • Статья

Примечание.

Компоненты Loop на основе адаптивных карточек недоступны в Microsoft Teams и Microsoft Outlook в macOS и мобильных клиентах.

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

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

Снимок экрана: компонент Loop на основе адаптивных карточек.

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

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

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

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

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

  4. Расширение расширения сообщений в Microsoft 365. Этот шаг включает в себя следующие действия:

    1. Обновите манифест приложения до версии 1.13 или более поздней.
    2. Добавьте канал Microsoft 365 для бота.
    3. Обновите регистрацию приложения Microsoft Entra для единого входа.

  5. Добавьте URL-адрес, однозначно определяющий карта в свойстве metadata.webUrl. Свойство metadata.webUrl поддерживает переносимость с помощью кнопки Копировать компонент в заголовке компонента Loop.

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

    Снимок экрана: страница обзора портала разработчика с выделенной красной кнопкой

Примечание.

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

Пример

Следующие полезные данные JSON являются примером компонента Loop на основе адаптивной карточки со свойствами metadata иwebUrl:

{
  "type": "AdaptiveCard",
  "version": "1.6",
  "metadata": {
    "webUrl": "https://contoso.com/tab"
  },
  "refresh": {
    "action": {
      "type": "Action.Execute",
      "title": "Submit",
      "verb": "personalDetailsCardRefresh"
    },
    "userIds": []
  },
  "body": [
    {
      ....
    },
  ]
  }

Схема

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

Примечание.

  • При копировании компонента Loop на основе адаптивной карточки копируется URL-адрес компонента Loop. При вставке URL-адреса в чате Teams или в приложении Loop ссылка разворачивается в компоненте Loop адаптивной карточки.
  • Компоненты Loop адаптивных карточек используют тот же механизм обновления, что и обычные адаптивные карточки. Содержимое компонента Loop на основе адаптивной карточки обновляется только тогда, когда пользователь открывает компонент Loop.

Пример кода

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

См. также