CardPlatform adaptív kártyák (előzetes verzió)

A CardPlatform lehetővé teszi, hogy adaptív kártyákat küldjön a felhasználóknak. Használható műveletalapú tartalmakhoz, például jóváhagyásokhoz, űrlapok rögzítéséhez és általános üzenetküldéshez. Támogatja a templating és az egyéni kártyákat.

Ez az összekötő a következő termékekben és régiókban érhető el:

Service	Class	Régiók
Copilot Studio	prémium	Az összes Power Automate-régió, kivéve a következőket: - USA kormánya (GCC) - Amerikai kormány (GCC High) - A 21Vianet által üzemeltetett China Cloud - Amerikai Védelmi Minisztérium (DoD)
Logikai alkalmazások	Standard	Az összes Logic Apps-régió , kivéve a következőket: - Azure Government-régiók - Azure China-régiók - Amerikai Védelmi Minisztérium (DoD)
Power Alkalmazások	prémium	Az összes Power Apps-régió , kivéve a következőket: - USA kormánya (GCC) - Amerikai kormány (GCC High) - A 21Vianet által üzemeltetett China Cloud - Amerikai Védelmi Minisztérium (DoD)
Power Automate	prémium	Az összes Power Automate-régió, kivéve a következőket: - USA kormánya (GCC) - Amerikai kormány (GCC High) - A 21Vianet által üzemeltetett China Cloud - Amerikai Védelmi Minisztérium (DoD)

Érintkezés
Név	CardPlatform-támogatás
URL	https://cardplatform.app/support
Email	support@cardplatform.app

Összekötő metaadatai
Kiadó	CardPlatform
Webhely	https://cardplatform.app/
Adatvédelmi irányelvek	https://cardplatform.app/privacy/
Kategóriák	Együttműködés; Kommunikáció

A CardPlatform lehetővé teszi, hogy adaptív kártyákat és végrehajtható tartalmakat küldjön közvetlenül a felhasználóknak.

Pre-requisites

A CardPlatform használatához a következőkre lesz szüksége:

Hozzon létre egy CardPlatform-előfizetést a csomag kiválasztásához;
Van egy ingyenes próbaverziós előfizetés, amely elérhető a próbaverzióhoz és kísérletezéshez.

Hitelesítő adatok lekérése

A regisztráció befejezése után e-mailben megkapja az API-kulcsot.

Miután megkapta az API-kulcsot, hozzon létre egy új kapcsolatot, írja be az API-kulcsot, és kezdjen el kártyákat küldeni.

Az összekötő használatának első lépései

Első lépésként küldjön egy üzenetet:

Az Üzenet küldése művelet kiválasztása

A három mező kitöltése

Válassza ki az Üzenet küldése műveletet

Címzettek – adja meg az e-mail-címét;
Címsor – Címsor írása, pl. Hello World

Szúrja be az adaptív kártyát, ez a példa a Hello World-et küldi a kártyára, például:

{
    "$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"
        }
    ]
}

Futtassa a folyamatot, és a kártya megjelenik az Outlookban

Ismert problémák és korlátozások

Ha az adaptív kártyák nem jelennek meg az Outlookban, van egy Actionnable Message Debugger nevű Outlook beépülő modul, amely segíthet a probléma megoldásában.

Telepítés a végrehajtható üzenetkereső webhelyről.

További támogatás érhető el a CardPlatform támogatási webhelyén.

GYIK

Hogyan küldhetek jóváhagyást?

Használja a Jóváhagyás küldése műveletet;
Hogyan küldhetek üzenetet anélkül, hogy a válaszra várnék?

Az Üzenet küldése művelet használata;
Hogyan tervezhetem meg az adaptív kártyákat?

Adaptív kártyák létrehozása az Adaptív kártyatervező használatával ;
Hol találom az adaptív kártyák sémáját és mintáit?

A séma és a minták a következő oldalon találhatók:
- adaptivecards.io
- madewithcards.io
Mik azok a sablonok?

A sablon lehetővé teszi az adaptív kártya tervezését, majd az adatok alkalmazását az adaptív kártya elrendezésébőlelválasztva.
1. Mik azok a nyilvános sablonok?
  
  A nyilvános sablonokat a közösség hozza létre, és mindenki számára elérhető. Az összes nyilvános sablon a Nyilvános sablonok listázása művelet használatával listázható;
2. Mik azok a privát sablonok?
  
  A privát sablonok saját sablongyűjtemények, amelyek tárolhatók és újra felhasználhatók.

Kapcsolat létrehozása

Az összekötő a következő hitelesítési típusokat támogatja:


Alapértelmezett	A kapcsolat létrehozásának paraméterei.	Minden régió	Nem osztható meg

Alapértelmezett

Alkalmazható: Minden régió

A kapcsolat létrehozásának paraméterei.

Ez nem megosztható kapcsolat. Ha a power app meg van osztva egy másik felhasználóval, a rendszer kérni fogja, hogy hozzon létre új kapcsolatot.

Név	Típus	Description	Kötelező
API-kulcs	securestring	API-kulcs a CardPlatformból	True

Szabályozási korlátok

Name	Hívások	Megújítási időszak
API-hívások kapcsolatonként	100	60 másodperc

Műveletek

Adaptív kártya küldése	Adaptív kártyát küld, és visszaadja a választ a megadott választási lehetőséggel és mezőkkel.
Jóváhagyás küldése	Jóváhagyási adaptív kártyát küld, és visszaadja a választ a megadott választási lehetőséggel és mezőkkel.
Nyilvános sablon keresése	Nyilvános sablon keresése az adatok szerkezetének elemzésével.
Nyilvános sablon lekérése	Lekéri egy nyilvános sablon tartalmát.
Nyilvános sablon átalakítása	Feltölt egy nyilvános sablont az adatokkal, és egy teljesen kitöltött adaptív kártyát ad vissza.
Nyilvános sablonok listázása	Lekéri az összes nyilvános sablon listáját.
Privát sablon frissítése	Frissíti egy privát sablon tartalmát.
Privát sablon lekérése	Egy privát sablont kér le név alapján.
Privát sablon létrehozása	Hozzon létre egy új privát sablont.
Privát sablon törlése	Eltávolít egy privát sablont a privát sablonok készletéből.
Privát sablon átalakítása	Feltölt egy privát sablont az adatokkal, és egy teljesen kitöltött adaptív kártyát ad vissza.
Privát sablonok listázása	Lekéri az összes privát sablon listáját.
Üzenet küldése	Adaptív kártyát küld üzenetként (műveletek nélkül).

Adaptív kártya küldése

Műveletazonosító:: SendCard

Adaptív kártyát küld, és visszaadja a választ a megadott választási lehetőséggel és mezőkkel.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Címzettek	recipients	True	array of string	Címzettek e-mail-címe
Heading	heading	True	string	Heading
Adaptív kártya	card	True	string	Adaptív kártya
azonosító	id		string	Azonosító a kártya azonosításához
Kártya neve	cardname		string	Kártya neve

Válaszok

Válasz az előző kártyáról

Válasz: ResponseSchema

Jóváhagyás küldése

Műveletazonosító:: SendApproval

Jóváhagyási adaptív kártyát küld, és visszaadja a választ a megadott választási lehetőséggel és mezőkkel.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Címzettek	recipients	True	array of string	Címzettek e-mailjei
Heading	heading	True	string	Heading
Utasítások	instructions	True	string	Utasítások
Műveletek	actions	True	array of string	Műveletek listája
A választható lehetőségek típusa	choiceType	True	string	A választható lehetőségek típusa
Alapértelmezett beállítás a jóváhagyáshoz	approvalChoice	True	string	Alapértelmezett beállítás a jóváhagyáshoz
Alapértelmezett elutasítási lehetőség	rejectionChoice	True	string	Alapértelmezett elutasítási lehetőség

Válaszok

Válasz az előző kártyáról

Válasz: ResponseSchema

Nyilvános sablon keresése

Műveletazonosító:: PublicTemplate_Find

Nyilvános sablon keresése az adatok szerkezetének elemzésével.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
			object

Válaszok

response: object

Nyilvános sablon lekérése

Műveletazonosító:: PublicTemplate_Get

Lekéri egy nyilvános sablon tartalmát.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Nyilvános sablon elérési útja	path	True	string	Nyilvános sablon elérési útja

Válaszok

Sablonok listája

Sablonok listája: TemplateListSchema

Nyilvános sablon átalakítása

Műveletazonosító:: PublicTemplate_Transform

Feltölt egy nyilvános sablont az adatokkal, és egy teljesen kitöltött adaptív kártyát ad vissza.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Nyilvános sablon elérési útja	path	True	string	Nyilvános sablon elérési útja
			object

Válaszok

response: object

Nyilvános sablonok listázása

Műveletazonosító:: PublicTemplate_GetAll

Lekéri az összes nyilvános sablon listáját.

Válaszok

response: object

Privát sablon frissítése

Műveletazonosító:: PrivateTemplates_Update

Frissíti egy privát sablon tartalmát.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Sablon neve	name	True	string	Sablon neve
			object

Privát sablon lekérése

Műveletazonosító:: PrivateTemplate_Get

Egy privát sablont kér le név alapján.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Magánsablon neve	name	True	string	Magánsablon neve

Válaszok

response: object

Privát sablon létrehozása

Műveletazonosító:: PrivateTemplates_Create

Hozzon létre egy új privát sablont.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Sablon neve	name	True	string	Sablon neve
			object

Válaszok

response: object

Privát sablon törlése

Műveletazonosító:: PrivateTemplates_Delete

Eltávolít egy privát sablont a privát sablonok készletéből.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Sablon neve	name	True	string	Sablon neve

Privát sablon átalakítása

Műveletazonosító:: PrivateTemplate_Transform

Feltölt egy privát sablont az adatokkal, és egy teljesen kitöltött adaptív kártyát ad vissza.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Sablon neve	name	True	string	Sablon neve
			object

Válaszok

response: object

Privát sablonok listázása

Műveletazonosító:: PrivateTemplate_GetAll

Lekéri az összes privát sablon listáját.

Válaszok

Name	Elérési út	Típus	Description
		array of string

Üzenet küldése

Műveletazonosító:: SendMessage

Adaptív kártyát küld üzenetként (műveletek nélkül).

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Címzettek	recipients	True	array of string	Címzettek e-mail-címe
Heading	heading	True	string	Heading
Adaptív kártya	card	True	string	Adaptív kártya

Válaszok

response: CardResponseSchema

Definíciók

ResponseSchema

Válasz az előző kártyáról

Name	Elérési út	Típus
alperes	respondent	string
válaszadónév	respondentName	string
respondentEmail	respondentEmail	string
choice	choice	string
hozzászólás	comment	string
responseDate	responseDate	string

TemplateListSchema

Sablonok listája

Name	Elérési út	Típus
list	list	array of object
kulcs	list.key	string
templates	list.templates	array of object
fájl	list.templates.file	string
fullPath	list.templates.fullPath	string

CardResponseSchema

: string

objektum

Ez az "objektum" típus.