Cognito Forms

A Cognito Forms egy online űrlapszerkesztő a beküldési adatok gyűjtéséhez és kezeléséhez. Ez az összekötő lehetővé teszi az automatizált folyamatok aktiválását a bejegyzések létrehozásakor, frissítésekor vagy törlésekor, és műveleteket biztosít a bejegyzések létrehozásához, frissítéséhez és lekéréséhez. A Cognito Forms integrálása más szolgáltatásokkal az adatok átirányításához, a feltöltött fájlok feldolgozásához és az üzleti munkafolyamatok automatizálásához.

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

Service Class Régiók
Copilot Studio Standard 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 Kína régiói
     - Amerikai Védelmi Minisztérium (DoD)
Power Apps Standard 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 Standard 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 A Cognito Forms támogatása
URL https://www.cognitoforms.com/support
Email support@cognitoforms.com
Összekötő metaadatai
Publisher Cognito Forms, LLC
Webhely https://www.cognitoforms.com
Adatvédelmi irányelvek https://www.cognitoforms.com/legal/privacy
Kategóriák Termelékenység; Együttműködés

Cognito Forms

A Cognito Forms segítségével egyszerűen készíthet hatékony online űrlapokat, például felméréseket, rendelési űrlapokat, regisztrációs űrlapokat stb. Ingyenesen. A support dokumentációjában vagy a talál segítséget a nyilvános Power Automate-összekötővel kapcsolatban.

Publisher: Cognito Forms

Előfeltételek

Fizetős előfizetésre van szükség.

Támogatott műveletek

Kiváltó okok

Az eseményindítók röviddel az előfizetett esemény bekövetkezése után lesznek elküldve.

NewEntry

Ez akkor aktiválódik, ha új bejegyzés jön létre a megadott űrlaphoz. A kimenet a belépési adatok lesznek, beleértve a fájladatokat és a fájlokra, aláírásokra és belépési dokumentumokra mutató ideiglenes hivatkozásokat.

Paraméterek:
  • form: Annak az űrlapnak a neve, amelyre az új bejegyzésesemények elő lesznek előfizetve.

UpdateEntry

Ez akkor aktiválódik, ha egy bejegyzés frissül a megadott űrlaphoz. A kimenet a belépési adatok lesznek, beleértve a fájladatokat és a fájlokra, aláírásokra és belépési dokumentumokra mutató ideiglenes hivatkozásokat.

Paraméterek:
  • form: Annak az űrlapnak a neve, amelyre a frissített bejegyzésesemények elő lesznek előfizetve.

Bejegyzés törölve

Ez akkor aktiválódik, ha egy bejegyzést töröl a megadott űrlaphoz. A kimenet a belépési adatok lesznek, a hivatkozások kivételével.

Paraméterek:
  • form: Annak az űrlapnak a neve, amelyre a bejegyzés törölt eseményeit előfizetik.

Műveletek

CreateEntry

Ez a művelet létrehoz egy bejegyzést a megadott űrlaphoz. A művelet az egyes beviteli mezők beállítási tulajdonságait tartalmazza, bizonyos mezőtípusok kivételével. A kimenet a belépési adatok lesznek.

Paraméterek:
  • form: A belső űrlap neve vagy azonosítója

EditEntry

Ez a művelet frissíti a megadott űrlap egy meglévő bejegyzését. A művelet az egyes beviteli mezők beállítási tulajdonságait tartalmazza, bizonyos mezőtípusok kivételével. Ez a művelet sikertelen lesz, ha a bejegyzés fizetős megrendelést tartalmaz, vagy a entryId nem létezik. A kimenet a frissített belépési adatok lesznek.

Paraméterek:
  • form: A belső űrlap neve vagy azonosítója
  • entryId: A frissíteni kívánt bejegyzés bejegyzésszáma vagy bejegyzésazonosítója

A SetFormAvailability beállítása

Ez a művelet beállítja az űrlap rendelkezésre állási korlátjának beállításait. A start paramétereknek üresnek end kell lenniük ahhoz, hogy az űrlap mindig elérhető legyen. A kimenet a frissített rendelkezésre állási beállítások lesznek.

Paraméterek:
  • form: A belső űrlap neve vagy azonosítója
  • start: Az az időpont, amikor az űrlap elérhetővé válik.
  • end: Az a dátum, amikor az űrlap már nem érhető el.
  • message: Ez az üzenet jelenik meg azoknak a felhasználóknak, akik a rendelkezésre állási időszakon kívül próbálják elérni az űrlapot.

GetFile

Ez a művelet lekéri a fájlt a tárolóból. A kimenet egy olyan objektum lesz, amely tartalmazza a fájladatokat, a metaadatokat és a fájlra mutató ideiglenes hivatkozást.

Paraméterek:
  • id: A lekérni kívánt fájl fájlazonosítója.

GetDocument

Ez a művelet létrehoz és lekér egy belépési dokumentumot a megadott űrlap, bejegyzés és sablon használatával. A kimenet egy objektum lesz, amely a dokumentum fájladatait, metaadatait és a dokumentumra mutató ideiglenes hivatkozást tartalmazza.

Paraméterek:
  • form: A belső űrlap neve vagy azonosítója
  • entry: Annak a bejegyzésnek a bejegyzésazonosítója vagy bejegyzésszáma, amelyhez a dokumentumot létre kell hozni
  • templateNumber: A belépési dokumentum létrehozásához használandó sablon száma

GetEntry

Ez a művelet egy meglévő bejegyzést kap a megadott űrlaphoz. Ez a művelet sikertelen lesz, ha a bejegyzés nem létezik. A kimenet a belépési adatok lesznek.

Paraméterek:
  • form: A belső űrlap neve vagy azonosítója
  • entryId: A beolvasandó bejegyzés belépési száma vagy belépési azonosítója

DeleteEntry

Ez a művelet törli a megadott űrlap egy meglévő bejegyzését. Ez a művelet sikertelen lesz, ha a bejegyzés nem létezik. Nem lesz kimenet.

Paraméterek:
  • form: A belső űrlap neve vagy azonosítója
  • entryId: A törölni kívánt bejegyzés bejegyzésszáma vagy bejegyzésazonosítója

ImportEntries

Ez a művelet a megadott fájltartalommal (.xlsx vagy .csv) hoz létre, frissít vagy töröl bejegyzéseket. A kimenet egy olyan objektum lesz, amely az importálási azonosítót és az állapotot tartalmazza.

Paraméterek:
  • form: A belső űrlap neve vagy azonosítója
  • File: Az importálandó bejegyzéseket tartalmazó fájl (.xlsx vagy .csv)
  • ImportMode: Az importálás módja (CreateNew, UpdateExisting vagy SyncEntries)
  • Email: Az importálási értesítések fogadásához szükséges e-mail-cím (nem kötelező)
  • MatchEntriesUsing: Egy bejegyzésazonosító helyettesítője (nem kötelező)

GetImportStatus

Ez a művelet lekéri az importálás aktuális állapotát, és visszaadja a sikeres és sikertelen bejegyzések számát. A kimenet egy objektum lesz, amely tartalmazza az importálási állapotot, a darabszámokat és a hibainformációkat, ha vannak ilyenek.

Paraméterek:
  • form: A belső űrlap neve vagy azonosítója
  • importId: Az importálás azonosítója az állapot ellenőrzéséhez

UploadFile

Ez a művelet feltölt egy fájlt a Cognito Formsba.

Paraméterek:
  • fileContent: A fájl bináris adatai
  • fileName: A fájl neve

GetEntryViewEntries

Ez a művelet egy adott nézet összes bejegyzését lekéri. A kimenet a bemeneti adatok lesznek a nézetkonfiguráció alapján.

Paraméterek:
  • form: A belső űrlap neve vagy azonosítója
  • viewId: A nézet azonosítója
  • $count: Bejegyzések teljes számának belefoglalása (nem kötelező)
  • $select: A nézetben szereplő bejegyzésazonosítók listáját adja vissza, ha $select=Azonosító van megadva (nem kötelező)

Privát műveletek

Ezek a műveletek a nyilvános eseményindítók és műveletek engedélyezői.

Űrlapok lekérése

Ez a művelet az űrlapok listáját adja vissza olyan objektumként, amely tartalmazza az és Ida Name . Ha a form műveletek és eseményindítók paraméteréhez használják, a felhasználónak látnia kell a Name, de az Id API-nak kell elküldenie. Az archivált űrlapok nem szerepelnek a válaszban.

GetFormSchema

Ez a művelet a megadott űrlap sémáját adja vissza. A input paraméternek igaznak kell lennie az írásvédett tulajdonságok kizárására szolgáló műveleteknél, és hamisnak kell lennie az összes tulajdonságot tartalmazó eseményindítók esetében. A includeLinks paraméternek igaznak kell lennie az összes műveletre és eseményindítóra a EntryDeleted kivételével.

Paraméterek:
  • form: A belső űrlap neve vagy azonosítója
  • input: Logikai érték, amely azt jelzi, hogy a visszaadott séma kizárja-e a nem állítható tulajdonságokat. Alapértelmezés szerint hamis.
  • includeLinks: Logikai érték, amely azt jelzi, hogy a fájlok, aláírások és dokumentumok hivatkozástulajdonságainak szerepelnie kell-e a sémában. Alapértelmezés szerint igaz.

LeiratkozásWebhook

Ez a művelet leiratkozza a megadott webhookot. A webhook a jelenleg várólistára helyezett események elküldése után már nem kap eseményeket.

Paraméterek:
  • id: A leiratkozni kívánt webhook azonosítója.
  • module: A webhook modulja. Ezt "forms" (űrlapok) értékre kell állítani, mivel ez az összekötő csak ezt a modult támogatja.

Hitelesítő adatok beszerzése

A szervezet tulajdonosának be kell jelentkeznie a Cognito Formsba, és engedélyeznie kell a kapcsolatot.

Ismert problémák

None

Üzembe helyezési utasítások

A Cognito Forms használatához érvényes Client id és Client secret összekötőt kell létrehozni. Ezek a tulajdonságok a kulcstartóban találhatók, és csak az egyéni összekötő hitelesítési beállításaiban állíthatók be.

  1. Run:

     paconn create --api-def apiDefinition.swagger.json --api-prop apiProperties.json

  2. Bejelentkezés a PowerAutomate szolgáltatásba

  3. Ugrás az új összekötőre

  4. A "Biztonság" területen frissítse a Client idClient secret

  5. Az összekötő frissítése

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

Bejegyzés frissítése

Egy bejegyzés frissítése.
Bejegyzés lekérése

Beolvas egy bejegyzést.
Bejegyzés létrehozása

Új bejegyzést hoz létre.
Bejegyzés törlése

Bejegyzés törlése.
Bejegyzések importálása

Bejegyzéseket hoz létre, frissít vagy töröl a megadott fájltartalommal.
Dokumentum lekérése

Dokumentum lekéri
Fájl feltöltése

Feltölt egy űrlapbejegyzésekben használandó fájlt.
Fájl lekérése

Lekéri a fájlt azonosító alapján.
Importálási állapot lekérése

Lekéri az importálás aktuális állapotát, és visszaadja a sikeres és sikertelen bejegyzések számát.
Űrlap rendelkezésre állásának beállítása

Az űrlapok rendelkezésre állását állítja be.
Űrlapbejegyzések lekérése

Adott nézet összes bejegyzésének lekérése

Bejegyzés frissítése

Műveletazonosító:
EditEntry

Egy bejegyzés frissítése.

Paraméterek

Name Kulcs Kötelező Típus Description
Form
 form True string

Az űrlap neve
Bejegyzés azonosítója
 entryId True string

A bejegyzés azonosítója
Entry
 entry True dynamic

A frissített bejegyzésadatok

Válaszok

Ennek a műveletnek a kimenetei dinamikusak.

Bejegyzés lekérése

Műveletazonosító:
GetEntry

Beolvas egy bejegyzést.

Paraméterek

Name Kulcs Kötelező Típus Description
Form
 form True string

Az űrlap neve
Bejegyzés azonosítója
 entryId True string

A bejegyzés azonosítója

Válaszok

Ennek a műveletnek a kimenetei dinamikusak.

Bejegyzés létrehozása

Műveletazonosító:
CreateEntry

Új bejegyzést hoz létre.

Paraméterek

Name Kulcs Kötelező Típus Description
Form
 form True string

Az űrlap neve
Entry
 entry True dynamic

Az űrlaphoz létrehozandó bejegyzés

Válaszok

Ennek a műveletnek a kimenetei dinamikusak.

Bejegyzés törlése

Műveletazonosító:
DeleteEntry

Bejegyzés törlése.

Paraméterek

Name Kulcs Kötelező Típus Description
Form
 form True string

Az űrlap neve
Bejegyzés azonosítója
 entryId True string

A bejegyzés azonosítója

Bejegyzések importálása

Műveletazonosító:
ImportEntries

Bejegyzéseket hoz létre, frissít vagy töröl a megadott fájltartalommal.

Paraméterek

Name Kulcs Kötelező Típus Description
Form
 form True string

Az űrlap neve
Fájl importálása
 File True file

Az importálni kívánt bejegyzéseket tartalmazó fájl (.xlsx vagy .csv).
Importálási mód
 ImportMode True string

Az importálás módja
Értesítési email
 Email email

Az importálási értesítések fogadásához szükséges e-mail-cím
Mező egyeztetése
 MatchEntriesUsing string

Bejegyzésazonosító helyettesítője

Válaszok

Name Elérési út Típus Description
Azonosító
 Id string

Az importálás azonosítója
Status
 Status string

Az importálás állapota
Hibaüzenet
 ErrorMessage string

Üzenet, amely leírja, hogy miért nem sikerült az importálás

Dokumentum lekérése

Műveletazonosító:
GetDocument

Dokumentum lekéri

Paraméterek

Name Kulcs Kötelező Típus Description
Form
 form True string

Az űrlap neve
Bejegyzés azonosítója
 entry True string

A bejegyzés azonosítója
Sablon száma
 templateNumber True integer

A sablon száma

Válaszok

Fájlhivatkozás fájladatokkal és metaadatokkal

Törzs
FileDataRef

Fájl feltöltése

Műveletazonosító:
UploadFile

Feltölt egy űrlapbejegyzésekben használandó fájlt.

Paraméterek

Name Kulcs Kötelező Típus Description
File
 File True file

A feltöltendő fájl.

Válaszok

Name Elérési út Típus Description
Fájlazonosító
 Id string

A fájl egyedi azonosítója.
Fájlnév
 Name string

A fájl neve
Fájltartalom típusa
 ContentType string

A fájl tartalomtípusa.
Fájlméret
 Size integer

A fájl mérete bájtban.

Fájl lekérése

Műveletazonosító:
GetFile

Lekéri a fájlt azonosító alapján.

Paraméterek

Name Kulcs Kötelező Típus Description
Fájlazonosító
 id True string

A fájl egyedi azonosítója

Válaszok

Fájlhivatkozás fájladatokkal és metaadatokkal

Törzs
FileDataRef

Importálási állapot lekérése

Műveletazonosító:
GetImportStatus

Lekéri az importálás aktuális állapotát, és visszaadja a sikeres és sikertelen bejegyzések számát.

Paraméterek

Name Kulcs Kötelező Típus Description
Form
 form True string

Az űrlap neve
Importálási azonosító
 importId True string

Az importálási azonosító

Válaszok

Name Elérési út Típus Description
Azonosító
 Id string

Az importálás azonosítója
Status
 Status string

Az importálás állapota
Hibaüzenet
 ErrorMessage string

Üzenet, amely leírja, hogy miért nem sikerült az importálás
Sikeres próbálkozások
 SuccessfulEntries integer

A sikeresen importált bejegyzések száma
Sikertelen próbálkozások
 UnsuccessfulEntries integer

Az importálni nem sikerült bejegyzések száma
TotalEntries
 TotalEntries integer

Az importálásban szereplő bejegyzések teljes száma
ImportLink
 ImportLink string

A bejegyzésoldalra mutató hivatkozás a jegyzetekkel ellátott fájl letöltéséhez

Űrlap rendelkezésre állásának beállítása

Műveletazonosító:
SetFormAvailability

Az űrlapok rendelkezésre állását állítja be.

Paraméterek

Name Kulcs Kötelező Típus Description
Form
 form True string

Az űrlap neve
Rendelkezésre állás kezdete
 start date-time

Rendelkezésre állás kezdő dátuma
Rendelkezésre állás vége
 end date-time

Rendelkezésre állás záró dátuma
Nem érhető el üzenet
 message string

Nem érhető el üzenet

Válaszok

Űrlap rendelkezésre állási információi, például a start/end rendelkezésre állás és a nem elérhető üzenet.

Törzs
FormAvailability

Űrlapbejegyzések lekérése

Műveletazonosító:
GetEntryViewEntries

Adott nézet összes bejegyzésének lekérése

Paraméterek

Name Kulcs Kötelező Típus Description
Form
 form True string

Az űrlap neve
Nézet azonosítója
 viewId True string

A nézet azonosítója
Darabszám belefoglalása
 $count string

Bejegyzések teljes számának belefoglalása
Azonosítók kiválasztása
 $select string

A $select=Azonosító megadásakor a nézetben szereplő bejegyzésazonosítók listáját adja vissza

Válaszok

response
object

Triggerek

Bejegyzés frissítésekor

Eseményindítók, amikor valaki frissít egy bejegyzést.
Bejegyzés törlésekor

Akkor aktiválódik, ha valaki töröl egy bejegyzést.
Új bejegyzés létrehozásakor

Akkor aktiválódik, ha valaki új bejegyzést hoz létre.

Bejegyzés frissítésekor

Műveletazonosító:
UpdateEntry

Eseményindítók, amikor valaki frissít egy bejegyzést.

Paraméterek

Name Kulcs Kötelező Típus Description
Form
 publisher True string

Az űrlap neve

Válaszok

Ennek a műveletnek a kimenetei dinamikusak.

Bejegyzés törlésekor

Műveletazonosító:
EntryDeleted

Akkor aktiválódik, ha valaki töröl egy bejegyzést.

Paraméterek

Name Kulcs Kötelező Típus Description
Form
 publisher True string

Az űrlap neve

Válaszok

Ennek a műveletnek a kimenetei dinamikusak.

Új bejegyzés létrehozásakor

Műveletazonosító:
NewEntry

Akkor aktiválódik, ha valaki új bejegyzést hoz létre.

Paraméterek

Name Kulcs Kötelező Típus Description
Form
 publisher True string

Az űrlap neve

Válaszok

Ennek a műveletnek a kimenetei dinamikusak.

Definíciók

FileDataRef

Fájlhivatkozás fájladatokkal és metaadatokkal

Name Elérési út Típus Description
Fájlazonosító
 Id string

A fájl egyedi azonosítója.
Fájlnév
 Name string

A fájl neve
Fájltartalom típusa
 ContentType string

A fájl tartalomtípusa.
Fájlméret
 Size integer

A fájl mérete.
Fájl URL-címe
 File string

A fájl URL-címe.
Fájl tartalma
 Content byte

A fájl tartalma

FormAvailability

Űrlap rendelkezésre állási információi, például a start/end rendelkezésre állás és a nem elérhető üzenet.

Name Elérési út Típus Description
Űrlap rendelkezésre állásának kezdete
 availabilityStart date-time

Űrlap rendelkezésre állásának kezdete
Űrlap rendelkezésre állásának vége
 availabilityEnd date-time

Űrlap rendelkezésre állásának vége
Nem érhető el üzenet
 notAvailableMessage string

Nem érhető el üzenet

objektum

Ez az "objektum" típus.