Karty adaptacyjne CardPlatform (wersja zapoznawcza)
Karta CardPlatform umożliwia wysyłanie kart adaptacyjnych do użytkowników. Może służyć do obsługi zawartości akcji, takiej jak zatwierdzenia, przechwytywanie formularzy i ogólne komunikaty. Obsługuje tworzenie szablonów i karty niestandardowe.
Ten łącznik jest dostępny w następujących produktach i regionach:
| Usługa | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Logic Apps | Standard | Wszystkie regiony usługi Logic Apps z wyjątkiem następujących: — Regiony platformy Azure Government — Regiony platformy Azure (Chiny) - Departament Obrony USA (DoD) |
| Power Apps | Premium | Wszystkie regiony usługi Power Apps z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Power Automate | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Kontakt | |
|---|---|
| Name | Obsługa platformy CardPlatform |
| adres URL | https://cardplatform.app/support |
| support@cardplatform.app |
| Metadane łącznika | |
|---|---|
| Publisher | CardPlatform |
| Witryna internetowa | https://cardplatform.app/ |
| Zasady ochrony prywatności | https://cardplatform.app/privacy/ |
| Kategorie | Kolaboracja; Komunikacja |
KartaPlatform umożliwia wysyłanie kart adaptacyjnych i zawartości z możliwością działania bezpośrednio do użytkowników.
Pre-requisites
Aby użyć elementu CardPlatform, należy wykonać następujące czynności:
- Utwórz subskrypcję CardPlatform, aby rozpocząć wybieranie planu;
- Dostępna jest subskrypcja bezpłatnej wersji próbnej, z którą można korzystać w wersji próbnej i eksperymentować.
Jak uzyskać poświadczenia
Po zakończeniu rejestracji otrzymasz klucz interfejsu API w wiadomości e-mail.
Po utworzeniu klucza interfejsu API utwórz nowe połączenie, wprowadź klucz interfejsu API i zacznij wysyłać karty.
Wprowadzenie do łącznika
Aby rozpocząć, najpierw wyślij wiadomość:
Wybierz akcję Wyślij wiadomość
Wypełnij trzy pola
Adresaci — podaj swój adres e-mail;
Nagłówek — pisanie nagłówka, np. Hello World
Wstaw kartę adaptacyjną, w tym przykładzie zostanie wysłana aplikacja Hello World na karcie, np.
{ "$schema": "http://adaptivecards.io/schemas/adaptive-card.json", "type": "AdaptiveCard", "version": "1.0", "body": [ { "type": "TextBlock", "size": "Large", "isSubtle": true, "wrap": true, "text": "Hello World" } ] }
Uruchom przepływ, a karta zostanie wyświetlona w programie Outlook
Znane problemy i ograniczenia
Jeśli karty adaptacyjne nie są wyświetlane w programie Outlook, istnieje wtyczka programu Outlook o nazwie Actionnable Message Debugger , która może pomóc w rozwiązaniu problemu.
Zainstaluj z poziomu lokacji Debugera komunikatów z możliwością działania .
Dodatkowa pomoc techniczna jest dostępna w witrynie pomocy technicznej CardPlatform.
Często zadawane pytania
Jak wysłać zatwierdzenie?
Użyj akcji Wyślij zatwierdzenie ;
Jak wysłać wiadomość bez oczekiwania na odpowiedź?
Użyj akcji Wyślij wiadomość ;
Jak zaprojektować karty adaptacyjne?
Użyj projektanta kart adaptacyjnych , aby utworzyć karty adaptacyjne;
Gdzie można znaleźć schemat i przykłady dla kart adaptacyjnych?
Schemat i przykłady można znaleźć w następujących tematach:
Co to są szablony?
Szablon umożliwia zaprojektowanie karty adaptacyjnej, a następnie zastosowanie do niej danych, oddzielając dane od układu karty adaptacyjnej.
Co to są szablony publiczne?
Szablony publiczne są tworzone przez społeczność i są dostępne dla wszystkich do użycia. Wszystkie szablony publiczne można wyświetlić przy użyciu akcji Wyświetl szablony publiczne ;
Co to są szablony prywatne?
Prywatne szablony to prywatna kolekcja szablonów, które mogą być przechowywane i używane ponownie.
Tworzenie połączenia
Łącznik obsługuje następujące typy uwierzytelniania:
| Wartość domyślna | Parametry tworzenia połączenia. | Wszystkie regiony | Nie można udostępniać |
Domyślny
Dotyczy: Wszystkie regiony
Parametry tworzenia połączenia.
Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja Power App zostanie udostępniona innemu użytkownikowi, inny użytkownik zostanie poproszony o jawne utworzenie nowego połączenia.
| Name | Typ | Description | Wymagane |
|---|---|---|---|
| Klucz interfejsu API | securestring | Klucz interfejsu API z elementu CardPlatform | Prawda |
Limity ograniczania
| Nazwa | Wywołania | Okres odnowienia |
|---|---|---|
| Wywołania interfejsu API na połączenie | 100 | 60 sekund |
Akcje
| Aktualizowanie szablonu prywatnego |
Aktualizuje zawartość szablonu prywatnego. |
| Pobieranie szablonu prywatnego |
Pobiera prywatny szablon według nazwy. |
| Pobieranie szablonu publicznego |
Pobiera zawartość szablonu publicznego. |
| Przekształcanie szablonu prywatnego |
Wypełnia prywatny szablon danymi i zwraca w pełni wypełniona karta adaptacyjna. |
| Przekształcanie szablonu publicznego |
Wypełnia szablon publiczny danymi i zwraca w pełni wypełniona karta adaptacyjna. |
| Tworzenie szablonu prywatnego |
Utwórz nowy szablon prywatny. |
| Usuwanie szablonu prywatnego |
Usuwa szablon prywatny z zestawu szablonów prywatnych. |
| Wyślij kartę adaptacyjną |
Wysyła kartę adaptacyjną i zwraca odpowiedź z wprowadzonymi polami i wybranymi polami. |
| Wyślij wiadomość |
Wysyła kartę adaptacyjną jako komunikat (bez akcji). |
| Wyślij zatwierdzenie |
Wysyła kartę adaptacyjną zatwierdzenia i zwraca odpowiedź z wybranymi polami i wprowadzonymi polami. |
| Wyświetlanie listy szablonów prywatnych |
Pobiera listę wszystkich szablonów prywatnych. |
| Wyświetlanie listy szablonów publicznych |
Pobiera listę wszystkich szablonów publicznych. |
| Znajdowanie szablonu publicznego |
Znajdź szablon publiczny, analizując strukturę danych. |
Aktualizowanie szablonu prywatnego
Aktualizuje zawartość szablonu prywatnego.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Nazwa szablonu
|
name | True | string |
Nazwa szablonu |
|
|
object |
Pobieranie szablonu prywatnego
Pobiera prywatny szablon według nazwy.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Nazwa szablonu prywatnego
|
name | True | string |
Nazwa szablonu prywatnego |
Zwraca
- response
- object
Pobieranie szablonu publicznego
Pobiera zawartość szablonu publicznego.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Ścieżka szablonu publicznego
|
path | True | string |
Ścieżka szablonu publicznego |
Zwraca
Lista szablonów
- Lista szablonów
- TemplateListSchema
Przekształcanie szablonu prywatnego
Wypełnia prywatny szablon danymi i zwraca w pełni wypełniona karta adaptacyjna.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Nazwa szablonu
|
name | True | string |
Nazwa szablonu |
|
|
object |
Zwraca
- response
- object
Przekształcanie szablonu publicznego
Wypełnia szablon publiczny danymi i zwraca w pełni wypełniona karta adaptacyjna.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Publiczna ścieżka szablonu
|
path | True | string |
Ścieżka szablonu publicznego |
|
|
object |
Zwraca
- response
- object
Tworzenie szablonu prywatnego
Utwórz nowy szablon prywatny.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Nazwa szablonu
|
name | True | string |
Nazwa szablonu |
|
|
object |
Zwraca
- response
- object
Usuwanie szablonu prywatnego
Usuwa szablon prywatny z zestawu szablonów prywatnych.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Nazwa szablonu
|
name | True | string |
Nazwa szablonu |
Wyślij kartę adaptacyjną
Wysyła kartę adaptacyjną i zwraca odpowiedź z wprowadzonymi polami i wybranymi polami.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Adresatów
|
recipients | True | array of string |
Adres e-mail adresatów |
|
Heading
|
heading | True | string |
Heading |
|
Karta adaptacyjna
|
card | True | string |
Karta adaptacyjna |
|
identyfikator
|
id | string |
Identyfikator identyfikujące kartę |
|
|
Nazwa karty
|
cardname | string |
Nazwa karty |
Zwraca
Odpowiedź z poprzedniej karty
- Odpowiedź
- ResponseSchema
Wyślij wiadomość
Wysyła kartę adaptacyjną jako komunikat (bez akcji).
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Adresatów
|
recipients | True | array of string |
Adres e-mail adresatów |
|
Heading
|
heading | True | string |
Heading |
|
Karta adaptacyjna
|
card | True | string |
Karta adaptacyjna |
Zwraca
- response
- CardResponseSchema
Wyślij zatwierdzenie
Wysyła kartę adaptacyjną zatwierdzenia i zwraca odpowiedź z wybranymi polami i wprowadzonymi polami.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Adresatów
|
recipients | True | array of string |
Adresaci e-mail |
|
Heading
|
heading | True | string |
Heading |
|
Instrukcje
|
instructions | True | string |
Instrukcje |
|
Czynności
|
actions | True | array of string |
Lista akcji |
|
Typ wyboru
|
choiceType | True | string |
Typ wyboru |
|
Wybór domyślny dla zatwierdzenia
|
approvalChoice | True | string |
Wybór domyślny dla zatwierdzenia |
|
Wybór domyślny do odrzucenia
|
rejectionChoice | True | string |
Wybór domyślny do odrzucenia |
Zwraca
Odpowiedź z poprzedniej karty
- Odpowiedź
- ResponseSchema
Wyświetlanie listy szablonów prywatnych
Pobiera listę wszystkich szablonów prywatnych.
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
|
array of string |
Wyświetlanie listy szablonów publicznych
Znajdowanie szablonu publicznego
Znajdź szablon publiczny, analizując strukturę danych.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
|
object |
Zwraca
- response
- object
Definicje
ResponseSchema
Odpowiedź z poprzedniej karty
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Pozwany
|
respondent | string | |
|
respondentName
|
respondentName | string | |
|
respondentEmail
|
respondentEmail | string | |
|
choice
|
choice | string | |
|
komentarz
|
comment | string | |
|
responseDate
|
responseDate | string |
TemplateListSchema
Lista szablonów
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
list
|
list | array of object | |
|
klucz
|
list.key | string | |
|
templates
|
list.templates | array of object | |
|
plik
|
list.templates.file | string | |
|
fullPath
|
list.templates.fullPath | string |
CardResponseSchema
obiekt
Jest to typ 'obiekt'.