Обзор адаптивных карточек для Microsoft Teams
Адаптивные карточки — это независимый от платформы метод совместного использования и отображения блоков информации без необходимости сложной настройки CSS или HTML для их визуализации. Разработка адаптивных карточек выполняется в формате JSON с интеграциями, которыми могут открыто обмениваться облачные приложения и службы. При доставке на определенный узел, например Microsoft Teams, файл JSON преобразуется в собственный пользовательский интерфейс, который автоматически адаптируется к своему узлу. Таким образом, проектировщики процессов теперь могут предлагать последовательные шаблоны пользовательского интерфейса всякий раз, когда им нужно показать информацию как часть бизнес-процесса или автоматизации.
Так как адаптивные карточки адаптируются к своим узлам, они являются идеальным средством для обмена информацией между Microsoft Teams и другими службами.
Доступные в настоящее время действия для потоков
Следующие действия позволяют разработчикам создавать адаптивные карточки для Microsoft Teams. По мере развития сценариев интеграции Power Automate будет поддерживать другие узлы, что расширяет возможности использования адаптивных карточек в облачных подписках Майкрософт.
Заметка
Адаптивные карточки недоступны в среде DoD (Министерство обороны).
Направление содержимого участникам Teams или пользователям Microsoft Entra
Публикация адаптивной карты в качестве бота Flow для пользователя
Это действие отправляет адаптивную карту в качестве бота потока конкретному пользователю. В этом случае вам необходимо указать адрес электронной почты получателя. Затем карточка отображается в чате и/или лентах новостей этого получателя во время выполнения потока. Для получения этих типов адаптивных карточек пользователь не должен быть частью экземпляра Teams. В этом случае функционируют только кнопки URL-адреса путем перенаправления на URL-адрес, настроенный в потоке.
Публикация адаптивной карты как бота Flow пользователю Teams и ожидание ответа
Это действие отправляет адаптивную карту в качестве бота Flow для определенного пользователя, как в случае, описанном ранее в этой статье. Однако в этом случае потоковое выполнение не будет продолжаться после отправки, пока получатель не ответит на входные данные, необходимые в карте. Последовательность продолжит выполняться после ответа получателя. Последовательность возвращает динамическое содержимое для одного (1) ответа на каждого получателя и на карту.
Направление содержимого в каналы Teams
Публикация адаптивной карты в качестве бота потока на канале
Это действие отправляет адаптивную карту в качестве бота потока в конкретный канал Teams. В этом случае вам предлагается указать экземпляр Teams и канал, где будет размещена карточка. Создатель потока должен иметь доступ к экземпляру Teams, чтобы разместить там адаптивную карточку. В этом случае функционируют только кнопки URL-адреса путем перенаправления на URL-адрес, настроенный в потоке.Публикация адаптивной карты как бота потока в канале Teams и ожидание ответа
Это действие отправляет адаптивную карту в качестве бота потока в конкретный канал Teams, как и в случае выше. В этом случае поток не продолжается до тех пор, пока кто-то в канале не ответит на входные данные, необходимые в карточке. Поток продолжает работу, когда любой пользователь в канале Teams ответит, но возвращает только динамическое содержимое для одного (1) ответа на каждое отвечающее устройство и на карточку. При использовании этой карты поток ожидает ответ от любого участника Teams.
Известные проблемы
Невозможно выполнить накопление данных из адаптивных карточек, если они не созданы с помощью одного из действий ожидания отклика. Адаптивные карточки, которые не ожидают отклика, возвращают ошибку для всех действий кнопки, кроме команды OpenURL. Дополнительные сведения о кнопках OpenURL.
При выборе кнопок Action.Submit на карточке, которая не содержит суффикс ожидания ответа, отобразится ошибка.
Адаптивные карточки, созданные с помощью действий ожидания ответа, можно отправить только один раз для каждой карточки. Выполнение потока продолжается после первого ответа, и любые дальнейшие представления игнорируются.
Только информация в поле ввода Сообщение обновления отображается на сменной карточке после того, как потребители отправят карточку.
Дополнительные сведения, такие как идентификатор пользователя, отправившего карточку, будут доступны в динамическом содержимом в действиях, следующих за действием ожидания ответа. Однако может потребоваться включить соединитель пользователей Office 365 для заполнения требуемых сведений профиля пользователя, отправившего карту.
После отправки адаптивных карточек ожидания ответа карточка сбрасывается, а затем отображается точно так же, если не настроена область замены или сообщения обновления. Сообщения об обновлениях — это лучшая практика. Они рекомендуются для обновления других и для предотвращения попыток потребителей отправить карточку более одного раза.
Входные данные Сообщения обновления и Требуется обновление карты должны быть настроены, если требуется карта замены.
- Power Automate использует уникальные особенности адаптивных карточек Майкрософт и службы для работы с карточками в любом узле. Эта статья призвана прояснить любые особенности, связанные с потоковыми действиями. Кроме того, для создания адаптивных карточек можно использовать полную документацию.