Przegląd kart adaptacyjnych dla aplikacji Microsoft Teams
Karty adaptacyjne to niezależna od platformy metoda udostępniania i wyświetlania bloków informacji bez konieczności skomplikowanego dostosowywania kodu CSS lub HTML w celu ich renderowania. Karty adaptacyjne tworzy się w formacie JSON, z integracjami, które umożliwiają otwartą wymianę między aplikacjami i usługami w chmurze. Po dostarczeniu do określonego hosta, takiego jak Microsoft Teams, plik JSON jest przekształcany w natywny interfejs użytkownika, który jest automatycznie dostosowywany do hosta. W związku z tym projektanci procesów mogą teraz oferować spójne wzorce interfejsu użytkownika wszędzie tam, gdzie potrzebne jest pokazywanie informacji w ramach procesu biznesowego/automatyzacji.
Ponieważ karty adaptacyjne dostosowują się do swoich hostów, są idealnym rozwiązaniem do udostępniania informacji między usługą Microsoft Teams a innymi usługami.
Aktualnie dostępne akcje dla przepływów
Poniższe akcje umożliwiają twórcom tworzenie kart adaptacyjnych dla usługi Microsoft Teams. W miarę rozwoju scenariuszy integracji usługa Power Automate będzie również obsługiwać inne hosty, co zapewni szersze możliwości korzystania z kart adaptacyjnych w ramach subskrypcji usług firmy Microsoft w chmurze.
Uwaga
Karty adaptacyjne nie są dostępne w środowisku DoD (Department of Defense).
Kierowanie zawartości do członków zespołów w usłudze Teams lub użytkowników usługi Microsoft Entra
Opublikuj własną kartę adaptacyjną dla użytkownika jako bot usługi Flow
Ta akcja spowoduje opublikowanie karty adaptacyjnej jako bota przepływu do określonego użytkownika. W tym przypadku należy podać adres e-mail odbiorcy. Podczas przebiegu przepływu karta będzie wyświetlana na czacie adresata i/lub w źródłach działania. Nie jest wymagane, aby użytkownik należał do wystąpienia usługi Teams w celu otrzymywania tych typów kart adaptacyjnych. W tym przypadku tylko przyciski adresu URL działają przez przekierowanie do adresu URL, który jest skonfigurowany w ramach przepływu.
Opublikuj kartę adaptacyjną jako bota usługi Flow dla użytkownika usługi Teams i czekaj na odpowiedź
Ta akcja powoduje opublikowanie karty adaptacyjnej jako bota usługi Flow dla określonego użytkownika, podobnie jak w przypadku przedstawionym wcześniej w tym artykule. Jednak w tym przypadku po opublikowaniu przebieg przepływu nie będzie kontynuowany, dopóki odbiorca nie odpowie na dane wejściowe, które są wymagane na karcie. Przepływ jest kontynuowany po udzieleniu odpowiedzi przez odbiorcę. Przepływ zwraca zawartość dynamiczną dla jednej (1) odpowiedzi na odbiorcę i na kartę.
Kierowanie zawartości do kanałów usługi Teams
Opublikuj własną kartę adaptacyjną jako bota przepływu w kanale
Ta akcja spowoduje opublikowanie karty adaptacyjnej jako bota przepływu w określonym kanale usługi Teams. W takim przypadku zostanie wyświetlony monit o podanie wystąpienia usługi Teams i kanału, w którym karta jest opublikowana. Twórca przepływu będzie musiał mieć dostęp do wystąpienia usługi Teams, aby móc opublikować w nim kartę adaptacyjną. W tym przypadku tylko przyciski adresu URL działają przez przekierowanie do adresu URL skonfigurowanego w ramach przepływu.Opublikuj kartę adaptacyjną jako bota przepływu w kanale usługi Teams i czekaj na odpowiedź
Ta akcja spowoduje opublikowanie karty adaptacyjnej jako bota przepływu w określonym kanale usługi Teams, tak jak w poprzednim przypadku. Jednak w tym przypadku przepływ nie będzie kontynuowany, dopóki ktoś w kanale nie odpowie na dane wejściowe wymagane na karcie. Przepływ będzie kontynuowany, gdy odpowie ktoś w kanale usługi Teams, ale zwróci zawartość dynamiczną tylko dla jednej (1) odpowiedzi na osobę odpowiadającą i na kartę. Gdy używasz tej karty, przepływ czeka na odpowiedź od dowolnego członka zespołu usługi Teams.
Znane problemy
Nie jest możliwe zbieranie danych z kart adaptacyjnych, o ile nie są one tworzone przy użyciu jednej z akcji czekaj na odpowiedź. Karty adaptacyjne, które nie czekają, zwracają błąd dla wszystkich akcji przycisków, z wyjątkiem OpenURL. Dowiedz się więcej na temat przycisków OpenURL.
Wybranie przycisków Action.Submit na karcie, która nie zawiera sufiksu czekaj na odpowiedź, spowoduje zgłoszenie błędu.
Kartę adaptacyjną utworzoną przy użyciu akcji czekaj na odpowiedź można przesłać tylko raz. Przebieg przepływu będzie kontynuowany po pierwszej odpowiedzi i wszelkie dalsze zgłoszenia zostaną zignorowane.
Po przesłaniu karty przez użytkownika na karcie zamiennej będą wyświetlane tylko informacje podane w polu wejściowym Komunikat aktualizacji.
Dodatkowe szczegóły, takie jak identyfikator użytkownika osoby przesyłającej kartę, będą dostępne w ramach zawartości dynamicznej w akcjach następujących po akcji czekaj na odpowiedź. Jednak może być konieczne uwzględnienie łącznika Użytkownicy usługi Office 365 w celu uzupełnienia wymaganych informacji o profilu użytkownika, który przesłał kartę.
Karta adaptacyjna typu czekaj na odpowiedź po przesłaniu zostanie zresetowana, a następnie wyświetlona dokładnie tak samo, o ile nie został skonfigurowany obszar zastąpienia/komunikatu aktualizacji. Aktualizowanie wiadomości jest najlepszym rozwiązaniem. Jest to zalecane w celu aktualizacji innych i zapobiegania próbom przesłania karty więcej niż jeden raz.
Dane wejściowe Komunikat aktualizacji oraz Czy aktualizować kartę muszą być skonfigurowane, jeśli pożądane jest zastępowanie karty.
- Usługa Power Automate korzysta z unikatowych funkcji i usług kart adaptacyjnych firmy Microsoft w celu obsługi kart na dowolnym hoście. Ten artykuł ma na celu wyjaśnienie szczegółów związanych z akcjami przepływu. Można też skorzystać z pełnej dokumentacji dotyczącej tworzenia kart adaptacyjnych.