Adaptive CardPlatform-Karten (Vorschau)
CardPlatform ermöglicht es Ihnen, adaptive Karten an Benutzer zu senden. Kann für Aktionsinhalte verwendet werden, z. B. Genehmigungen, Formularerfassung und allgemeine Nachrichten. Es unterstützt Vorlagen und benutzerdefinierte Karten.
Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:
| Dienstleistung | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Logik-Apps | Norm | Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche: – Azure Government-Regionen - Azure China-Regionen - US Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps-Regionen mit Ausnahme der folgenden: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Name | CardPlatform-Unterstützung |
| URL | https://cardplatform.app/support |
| support@cardplatform.app |
| Connectormetadaten | |
|---|---|
| Herausgeber | CardPlatform |
| Webseite | https://cardplatform.app/ |
| Datenschutzrichtlinie | https://cardplatform.app/privacy/ |
| Kategorien | Zusammenarbeit; Kommunikation |
CardPlatform ermöglicht es Ihnen, adaptive Karten und Aktionen erfordernde Inhalte direkt an Ihre Benutzer zu senden.
Voraussetzungen
Um CardPlatform zu verwenden, müssen Sie:
- Erstellen Sie ein CardPlatform-Abonnement, um mit der Auswahl des Plans zu beginnen;
- Es gibt ein kostenloses Testabonnement, mit dem Sie testen und experimentieren können.
So erhalten Sie Anmeldeinformationen
Nachdem die Registrierung abgeschlossen ist, erhalten Sie Ihren API-Schlüssel in einer E-Mail.
Nachdem Sie über den API-Schlüssel verfügen, erstellen Sie eine neue Verbindung, geben Sie den API-Schlüssel ein, und beginnen Sie mit dem Senden von Karten.
Erste Schritte mit Ihrem Connector
Um zu beginnen, senden Sie zuerst eine Nachricht:
Auswählen der Aktion "Nachricht senden"
Füllen Sie die drei Felder aus.
Empfänger – Geben Sie Ihre E-Mail-Adresse ein;
Überschrift - Schreiben einer Überschrift, z. B. Hello World
Fügen Sie die adaptive Karte ein, in diesem Beispiel wird Hello World in der Karte gesendet, z. B.
{ "$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" } ] }
Führen Sie den Fluss aus, und die Karte wird in Outlook angezeigt.
Bekannte Probleme und Einschränkungen
Wenn Ihre adaptiven Karten in Outlook nicht angezeigt werden, gibt es ein Outlook-Plug-In namens Actionnable Message Debugger , das ihnen bei der Behebung des Problems helfen kann.
Installieren sie auf der Website mit Aktionen erfordernden Nachrichtendebugger .
Zusätzliche Unterstützung steht auf der CardPlatform Support-Website zur Verfügung.
Häufig gestellte Fragen
Wie sende ich eine Genehmigung?
Verwenden Sie die Aktion "Genehmigung senden" ;
Wie sende ich eine Nachricht, ohne auf eine Antwort zu warten?
Verwenden Sie die Aktion " Nachricht senden" ;
Wie konzipiere ich meine adaptiven Karten?
Verwenden Sie den Designer für adaptive Karten , um Ihre adaptiven Karten zu erstellen.
Wo finde ich das Schema und beispiele für adaptive Karten?
Das Schema und die Beispiele finden Sie unter:
Was sind Vorlagen?
Mit einer Vorlage können Sie die adaptive Karte entwerfen und dann die Daten auf sie anwenden und Daten aus dem Layout der adaptiven Karte trennen.
Was sind öffentliche Vorlagen?
Öffentliche Vorlagen werden von der Community erstellt und stehen allen zur Verfügung. Alle öffentlichen Vorlagen können mithilfe der Aktion "Öffentliche Vorlagen auflisten" aufgelistet werden.
Was sind private Vorlagen?
Bei privaten Vorlagen handelt es sich um eine eigene private Sammlung von Vorlagen, die gespeichert und wiederverwendet werden können.
Erstellen einer Verbindung
Der Connector unterstützt die folgenden Authentifizierungstypen:
| Vorgabe | Parameter zum Erstellen einer Verbindung. | Alle Regionen | Nicht teilbar |
Vorgabe
Anwendbar: Alle Regionen
Parameter zum Erstellen einer Verbindung.
Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.
| Name | Typ | Description | Erforderlich |
|---|---|---|---|
| API-Schlüssel | securestring | API-Schlüssel aus CardPlatform | Richtig |
Drosselungsgrenzwerte
| Name | Aufrufe | Verlängerungszeitraum |
|---|---|---|
| API-Aufrufe pro Verbindung | 100 | 60 Sekunden |
Aktionen
| Abrufen einer privaten Vorlage |
Ruft eine private Vorlage anhand des Namens ab. |
| Abrufen einer öffentlichen Vorlage |
Ruft den Inhalt einer öffentlichen Vorlage ab. |
| Adaptive Karte senden |
Sendet eine adaptive Karte und gibt die Antwort mit den eingegebenen Auswahl- und Feldern zurück. |
| Aktualisieren einer privaten Vorlage |
Aktualisiert den Inhalt einer privaten Vorlage. |
| Erstellen einer privaten Vorlage |
Erstellen Sie eine neue private Vorlage. |
| Genehmigung senden |
Sendet eine adaptive Genehmigungskarte und gibt die Antwort mit den eingegebenen Auswahl- und Feldern zurück. |
| Nachricht senden |
Sendet eine adaptive Karte als Nachricht (keine Aktionen). |
| Private Vorlage löschen |
Entfernt eine private Vorlage aus der Gruppe privater Vorlagen. |
| Private Vorlage transformieren |
Füllt eine private Vorlage mit den Daten auf und gibt eine vollständig ausgefüllte adaptive Karte zurück. |
| Private Vorlagen auflisten |
Ruft eine Liste aller privaten Vorlagen ab. |
| Suchen einer öffentlichen Vorlage |
Suchen Sie eine öffentliche Vorlage, indem Sie die Struktur Ihrer Daten analysieren. |
| Öffentliche Vorlage transformieren |
Füllt eine öffentliche Vorlage mit den Daten auf und gibt eine vollständig ausgefüllte adaptive Karte zurück. |
| Öffentliche Vorlagen auflisten |
Ruft eine Liste aller öffentlichen Vorlagen ab. |
Abrufen einer privaten Vorlage
Ruft eine private Vorlage anhand des Namens ab.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Name der privaten Vorlage
|
name | True | string |
Name der privaten Vorlage |
Gibt zurück
- response
- object
Abrufen einer öffentlichen Vorlage
Ruft den Inhalt einer öffentlichen Vorlage ab.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Pfad der öffentlichen Vorlage
|
path | True | string |
Pfad der öffentlichen Vorlage |
Gibt zurück
Vorlagenliste
- Vorlagenliste
- TemplateListSchema
Adaptive Karte senden
Sendet eine adaptive Karte und gibt die Antwort mit den eingegebenen Auswahl- und Feldern zurück.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Empfänger
|
recipients | True | array of string |
E-Mail-Adresse der Empfänger |
|
Heading
|
heading | True | string |
Heading |
|
Adaptive Karte
|
card | True | string |
Adaptive Karte |
|
ID
|
id | string |
ID zum Identifizieren der Karte |
|
|
Name der Karte
|
cardname | string |
Name der Karte |
Gibt zurück
Antwort von vorheriger Karte
- Antwort
- ResponseSchema
Aktualisieren einer privaten Vorlage
Aktualisiert den Inhalt einer privaten Vorlage.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Vorlagenname
|
name | True | string |
Vorlagenname |
|
|
object |
Erstellen einer privaten Vorlage
Erstellen Sie eine neue private Vorlage.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Vorlagenname
|
name | True | string |
Vorlagenname |
|
|
object |
Gibt zurück
- response
- object
Genehmigung senden
Sendet eine adaptive Genehmigungskarte und gibt die Antwort mit den eingegebenen Auswahl- und Feldern zurück.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Empfänger
|
recipients | True | array of string |
Empfänger-E-Mail |
|
Heading
|
heading | True | string |
Heading |
|
Anweisungen
|
instructions | True | string |
Anweisungen |
|
Aktionen
|
actions | True | array of string |
Liste der Aktionen |
|
Art der Auswahl
|
choiceType | True | string |
Art der Auswahl |
|
Standardauswahl für die Genehmigung
|
approvalChoice | True | string |
Standardauswahl für die Genehmigung |
|
Standardauswahl für Ablehnung
|
rejectionChoice | True | string |
Standardauswahl für Ablehnung |
Gibt zurück
Antwort von vorheriger Karte
- Antwort
- ResponseSchema
Nachricht senden
Sendet eine adaptive Karte als Nachricht (keine Aktionen).
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Empfänger
|
recipients | True | array of string |
E-Mail-Adresse der Empfänger |
|
Heading
|
heading | True | string |
Heading |
|
Adaptive Karte
|
card | True | string |
Adaptive Karte |
Gibt zurück
- response
- CardResponseSchema
Private Vorlage löschen
Entfernt eine private Vorlage aus der Gruppe privater Vorlagen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Vorlagenname
|
name | True | string |
Vorlagenname |
Private Vorlage transformieren
Füllt eine private Vorlage mit den Daten auf und gibt eine vollständig ausgefüllte adaptive Karte zurück.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Vorlagenname
|
name | True | string |
Vorlagenname |
|
|
object |
Gibt zurück
- response
- object
Private Vorlagen auflisten
Ruft eine Liste aller privaten Vorlagen ab.
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
|
array of string |
Suchen einer öffentlichen Vorlage
Suchen Sie eine öffentliche Vorlage, indem Sie die Struktur Ihrer Daten analysieren.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
|
object |
Gibt zurück
- response
- object
Öffentliche Vorlage transformieren
Füllt eine öffentliche Vorlage mit den Daten auf und gibt eine vollständig ausgefüllte adaptive Karte zurück.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Pfad für öffentliche Vorlagen
|
path | True | string |
Pfad der öffentlichen Vorlage |
|
|
object |
Gibt zurück
- response
- object
Öffentliche Vorlagen auflisten
Definitionen
ResponseSchema
Antwort von vorheriger Karte
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
befragter
|
respondent | string | |
|
respondentName
|
respondentName | string | |
|
respondentEmail
|
respondentEmail | string | |
|
choice
|
choice | string | |
|
Kommentar
|
comment | string | |
|
responseDate
|
responseDate | string |
TemplateListSchema
Vorlagenliste
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Liste
|
list | array of object | |
|
key
|
list.key | string | |
|
templates
|
list.templates | array of object | |
|
file
|
list.templates.file | string | |
|
fullPath
|
list.templates.fullPath | string |
CardResponseSchema
Objekt
Dies ist der Typ „Objekt“.