Udostępnij przez


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
Email 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ść:

  1. Wybierz akcję Wyślij wiadomość

    Wybierz akcję Wyślij wiadomość

  2. Wypełnij trzy pola

    Wybierz akcję Wyślij wiadomość

    • 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"
              }
          ]
      }
      
  3. Uruchom przepływ, a karta zostanie wyświetlona w programie Outlook

    Karta adaptacyjna 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

  1. Jak wysłać zatwierdzenie?

    Użyj akcji Wyślij zatwierdzenie ;

  2. Jak wysłać wiadomość bez oczekiwania na odpowiedź?

    Użyj akcji Wyślij wiadomość ;

  3. Jak zaprojektować karty adaptacyjne?

    Użyj projektanta kart adaptacyjnych , aby utworzyć karty adaptacyjne;

  4. Gdzie można znaleźć schemat i przykłady dla kart adaptacyjnych?

    Schemat i przykłady można znaleźć w następujących tematach:

  5. 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.

    1. 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 ;

    2. 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

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

Pobiera listę wszystkich szablonów publicznych.

Zwraca

response
object

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'.